path: root/doc/man3/BIO_s_null.pod
diff options
Diffstat (limited to 'doc/man3/BIO_s_null.pod')
1 files changed, 44 insertions, 0 deletions
diff --git a/doc/man3/BIO_s_null.pod b/doc/man3/BIO_s_null.pod
new file mode 100644
index 000000000000..dd39423db1d7
--- /dev/null
+++ b/doc/man3/BIO_s_null.pod
@@ -0,0 +1,44 @@
+=head1 NAME
+BIO_s_null - null data sink
+=head1 SYNOPSIS
+ #include <openssl/bio.h>
+ const BIO_METHOD *BIO_s_null(void);
+BIO_s_null() returns the null sink BIO method. Data written to
+the null sink is discarded, reads return EOF.
+=head1 NOTES
+A null sink BIO behaves in a similar manner to the Unix /dev/null
+A null bio can be placed on the end of a chain to discard any data
+passed through it.
+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
+BIO_s_null() returns the null sink BIO method.
+Copyright 2000-2016 The OpenSSL Project Authors. All Rights Reserved.
+Licensed under the OpenSSL license (the "License"). You may not use
+this file except in compliance with the License. You can obtain a copy
+in the file LICENSE in the source distribution or at