SETBUF(3S)              GENIX Programmer's Manual              SETBUF(3S)



      NAME
           setbuf - assign buffering to a stream

      SYNOPSIS
           #include <stdio.h>

           setbuf(stream, buf)
           FILE *stream;
           char *buf;

      DESCRIPTION
           Setbuf is used after a stream has been opened but before it is  read
           or written.  It causes the character array buf to be used instead of
           an automatically allocated buffer.  If buf is the  constant  pointer
           NULL, input/output will be completely unbuffered.

           A manifest constant BUFSIZ tells how big an array is needed:

                char buf[BUFSIZ];

           A buffer is normally obtained from malloc(3) upon the first getc  or
           putc(3)  on  the  file, except that the standard output is line buf-
           fered when directed to a terminal.  Other output streams directed to
           terminals,  and  the  standard  error stream stderr are normally not
           buffered.  If the standard output  is  line  buffered,  then  it  is
           flushed each time data is read from the standard input by read(2).

      SEE ALSO
           fopen(3), getc(3), putc(3), malloc(3)

      BUGS
           The standard error stream should be line buffered by default.























      Printed 11/16/83                                                        1