ref: 34f333404f958f8d93e8f1f582c0a347d2bfd64a
parent: 0708d34022faefa1124c618cfba3ecb0881bf44d
author: aiju <[email protected]>
date: Wed Jul 13 05:17:47 EDT 2011
updated bio(2) man page
--- a/sys/man/2/bio
+++ b/sys/man/2/bio
@@ -78,6 +78,9 @@
.B
int Bbuffered(Biobufhdr *bp)
.PP
+.B
+void Blethal(Biobufhdr *bp, void (*errorf)(char *));
+.PP
.SH DESCRIPTION
These routines implement fast buffered I/O.
I/O on different file descriptors is independent.
@@ -311,6 +314,14 @@
When reading, this is the number of bytes still available from the last
read on the file; when writing, it is the number of bytes ready to be
written.
+.PP
+.I Blethal
+arranges
+.I errorf
+to be called in case of an error happening on read/write.
+An argument of
+.B nil
+will have the program terminated in case of error.
.SH SOURCE
.B /sys/src/libbio
.SH SEE ALSO
@@ -330,6 +341,10 @@
All routines set
.I errstr
on error.
+.PP
+An error during read or write will call an error handler specified by
+.IR Blethal ,
+if any.
.SH BUGS
.I Brdline
returns an error on strings longer than the buffer associated