summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/BIO_s_null.3
blob: 05008aabfc99339cb361d58c4f14b159219a5830 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
.Dd $Mdocdate: February 16 2015 $
.Dt BIO_S_NULL 3
.Os
.Sh NAME
.Nm BIO_s_null
.Nd null data sink
.Sh SYNOPSIS
.In openssl/bio.h
.Ft BIO_METHOD *
.Fo BIO_s_null
.Fa void
.Fc
.Sh DESCRIPTION
.Fn BIO_s_null
returns the null sink BIO method.
Data written to the null sink is discarded, reads return EOF.
.Sh NOTES
A null sink BIO behaves in a similar manner to the
.Xr null 4
device.
.Pp
A null bio can be placed on the end of a chain to discard any data
passed through it.
.Pp
A null sink is useful if, for example, an application wishes
to digest some data by writing through a digest bio
but not send the digested data anywhere.
Since a BIO chain must normally include a source/sink BIO,
this can be achieved by adding a null sink BIO to the end of the chain.
.Sh RETURN VALUES
.Fn BIO_s_null
returns the null sink BIO method.