summaryrefslogtreecommitdiff
path: root/man3/setbuf.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/setbuf.3')
-rw-r--r--man3/setbuf.324
1 files changed, 12 insertions, 12 deletions
diff --git a/man3/setbuf.3 b/man3/setbuf.3
index f1d61dd3..d0128484 100644
--- a/man3/setbuf.3
+++ b/man3/setbuf.3
@@ -81,7 +81,7 @@ normally does) it is line buffered. The standard error stream
is always unbuffered by default.
.PP
The
-.B setvbuf
+.BR setvbuf ()
function may be used on any open stream to change its buffer.
The
.I mode
@@ -109,14 +109,14 @@ is
.BR NULL ,
only the mode is affected; a new buffer will be allocated on the next read
or write operation. The
-.B setvbuf
+.BR setvbuf ()
function may only be used after opening a stream and before any other
operations have been performed on it.
.PP
The other three calls are, in effect, simply aliases for calls to
-.BR setvbuf .
+.BR setvbuf ().
The
-.B setbuf
+.BR setbuf ()
function is exactly equivalent to the call
.PP
.RS
@@ -124,12 +124,12 @@ setvbuf(stream, buf, buf ? _IOFBF : _IONBF, BUFSIZ);
.RE
.PP
The
-.B setbuffer
+.BR setbuffer ()
function is the same, except that the size of the buffer is up to the
caller, rather than being determined by the default
.BR BUFSIZ .
The
-.B setlinebuf
+.BR setlinebuf ()
function is exactly equivalent to the call:
.PP
.RS
@@ -137,7 +137,7 @@ setvbuf(stream, (char *)NULL, _IOLBF, 0);
.RE
.SH "RETURN VALUE"
The function
-.B setvbuf
+.BR setvbuf ()
returns 0 on success.
It can return any value on failure, but returns non-zero when
.I mode
@@ -147,18 +147,18 @@ on failure.
The other functions are void.
.SH "CONFORMING TO"
The
-.B setbuf
+.BR setbuf ()
and
-.B setvbuf
+.BR setvbuf ()
functions conform to ANSI X3.159-1989 (``ANSI C'').
.SH BUGS
The
-.B setbuffer
+.BR setbuffer ()
and
-.B setlinebuf
+.BR setlinebuf ()
functions are not portable to versions of BSD before 4.2BSD, and
are available under Linux since libc 4.5.21. On 4.2BSD and 4.3BSD systems,
-.B setbuf
+.BR setbuf ()
always uses a suboptimal buffer size and should be avoided.
.P
You must make sure that both