#use wml::openssl-macros area=docs page=BIO_s_null

<title>Documents, BIO_s_null(3)</title>

<h1>BIO_s_null(3)</h1>

#use wml::imp::generic

{:
## What's this? [[s|(<STRONG>[^<].+?)</A>(</STRONG><DD>)|$1$2|sg]]
[[s|<P>\s+<P>|<P>|sg]]
[[s|<P>\s+</|</|sg]]
[[s|<DD>\s*<DT>|<DD>&nbsp;<DT>|sg]]
[[s|<DD>\s*</DL>|<DD>&nbsp;</DL>|sg]]
[[s|\[|&#91;|sg]]
[[s|\]|&#93;|sg]]

<!-- INDEX BEGIN -->

<UL>

	<LI><A HREF="#NAME">NAME</A>
	<LI><A HREF="#SYNOPSIS">SYNOPSIS</A>
	<LI><A HREF="#DESCRIPTION">DESCRIPTION</A>
	<LI><A HREF="#NOTES">NOTES</A>
	<LI><A HREF="#RETURN_VALUES">RETURN VALUES</A>
	<LI><A HREF="#SEE_ALSO">SEE ALSO</A>
</UL>
<!-- INDEX END -->

<HR>
<P>
<HR>
<H1><A NAME="NAME">NAME</A></H1>
<P>
BIO_s_null - null data sink

</P>
<P>
<HR>
<H1><A NAME="SYNOPSIS">SYNOPSIS</A></H1>
<PRE> #include &lt;openssl/bio.h&gt;
</PRE>
<PRE> BIO_METHOD *   BIO_s_null(void);
</PRE>
<P>
<HR>
<H1><A NAME="DESCRIPTION">DESCRIPTION</A></H1>
<P>
<CODE>BIO_s_null()</CODE> returns the null sink BIO method. Data written to
the null sink is discarded, reads return EOF.

</P>
<P>
<HR>
<H1><A NAME="NOTES">NOTES</A></H1>
<P>
A null sink BIO behaves in a similar manner to the Unix /dev/null device.

</P>
<P>
A null bio can be placed on the end of a chain to discard any data passed
through it.

</P>
<P>
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

</P>
<P>
<HR>
<H1><A NAME="RETURN_VALUES">RETURN VALUES</A></H1>
<P>
<CODE>BIO_s_null()</CODE> returns the null sink BIO method.

</P>
<P>
<HR>
<H1><A NAME="SEE_ALSO">SEE ALSO</A></H1>
<P>
TBA
</P>
:}