summaryrefslogtreecommitdiff
path: root/lib/libcrypto/man/BIO_read.3
diff options
context:
space:
mode:
Diffstat (limited to 'lib/libcrypto/man/BIO_read.3')
-rw-r--r--lib/libcrypto/man/BIO_read.330
1 files changed, 15 insertions, 15 deletions
diff --git a/lib/libcrypto/man/BIO_read.3 b/lib/libcrypto/man/BIO_read.3
index 94a4fb14615..f19c31ecab6 100644
--- a/lib/libcrypto/man/BIO_read.3
+++ b/lib/libcrypto/man/BIO_read.3
@@ -1,12 +1,12 @@
-.\" $OpenBSD: BIO_read.3,v 1.2 2016/11/06 15:52:50 jmc Exp $
+.\" $OpenBSD: BIO_read.3,v 1.3 2016/11/07 15:52:47 jmc Exp $
.\"
-.Dd $Mdocdate: November 6 2016 $
+.Dd $Mdocdate: November 7 2016 $
.Dt BIO_READ 3
.Os
.Sh NAME
.Nm BIO_read ,
-.Nm BIO_write ,
.Nm BIO_gets ,
+.Nm BIO_write ,
.Nm BIO_puts
.Nd BIO I/O functions
.Sh SYNOPSIS
@@ -69,17 +69,6 @@ attempts to write a null terminated string
.Fa buf
to BIO
.Fa b .
-.Sh RETURN VALUES
-All these functions return either the amount of data successfully
-read or written (if the return value is positive) or that no data
-was successfully read or written if the result is 0 or -1.
-If the return value is -2, then the operation is not implemented
-in the specific BIO type.
-.Sh NOTES
-A 0 or -1 return is not necessarily an indication of an error.
-In particular when the source/sink is non-blocking or of a certain type
-it may merely be an indication that no data is currently available and that
-the application should retry the operation later.
.Pp
One technique sometimes used with blocking sockets
is to use a system call (such as
@@ -100,7 +89,7 @@ can cause several reads (and writes in the case of SSL BIOs)
on the underlying I/O structure and may block as a result.
Instead
.Xr select 2
-(or equivalent) should be combined with non blocking I/O
+(or equivalent) should be combined with non-blocking I/O
so successive reads will request a retry instead of blocking.
.Pp
See
@@ -113,5 +102,16 @@ function is not supported by a BIO then it is possible to
work around this by adding a buffering BIO
.Xr BIO_f_buffer 3
to the chain.
+.Sh RETURN VALUES
+All these functions return either the amount of data successfully
+read or written (if the return value is positive) or that no data
+was successfully read or written if the result is 0 or -1.
+If the return value is -2, then the operation is not implemented
+in the specific BIO type.
+.Pp
+A 0 or -1 return is not necessarily an indication of an error.
+In particular when the source/sink is non-blocking or of a certain type
+it may merely be an indication that no data is currently available and that
+the application should retry the operation later.
.Sh SEE ALSO
.Xr BIO_should_retry 3