toolchain/gcc/newlib/libc/stdio/setlinebuf.c

   1 /*
   2  * Copyright (c) 1990 The Regents of the University of California.
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms are permitted
   6  * provided that the above copyright notice and this paragraph are
   7  * duplicated in all such forms and that any documentation,
   8  * advertising materials, and other materials related to such
   9  * distribution and use acknowledge that the software was developed
  10  * by the University of California, Berkeley.  The name of the
  11  * University may not be used to endorse or promote products derived
  12  * from this software without specific prior written permission.
  13  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
  14  * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
  15  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  16  */
  17
  18 /*
  19 Modified copy of setbuf.c to support setlinebuf function
  20 defined as part of BSD.
  21 Modifications by Gareth Pearce, 2001.
  22 */
  23
  24 /*
  25 FUNCTION
  26
  27 <<setlinebuf>>---specify line buffering for a file or stream
  28
  29 INDEX
  30         setlinebuf
  31
  32 ANSI_SYNOPSIS
  33         #include <stdio.h>
  34         void setlinebuf(FILE *<[fp]>);
  35
  36 TRAD_SYNOPSIS
  37         #include <stdio.h>
  38         void setlinebuf(<[fp]>)
  39         FILE *<[fp]>;
  40
  41 DESCRIPTION
  42 <<setlinebuf>> specifies that output to the file or stream identified by
  43 <[fp]> should be line buffered.  This causes the file or stream to pass
  44 on output to the host system at every newline, as well as when the
  45 buffer is full, or when an input operation intervenes.
  46
  47 WARNINGS
  48 You may only use <<setlinebuf>> before performing any file operation
  49 other than opening the file.
  50
  51 RETURNS
  52 <<setlinebuf>> returns as per setvbuf.
  53
  54 PORTABILITY
  55 This function comes from BSD not ANSI or POSIX.
  56
  57 Supporting OS subroutines required: <<close>>, <<fstat>>, <<isatty>>,
  58 <<lseek>>, <<read>>, <<sbrk>>, <<write>>.
  59 */
  60
  61 #include <_ansi.h>
  62 #include <stdio.h>
  63 #include "local.h"
  64
  65 int
  66 _DEFUN (setlinebuf, (fp),
  67         FILE * fp)
  68 {
  69   return (setvbuf (fp, (char *) NULL, _IOLBF, (size_t) 0));
  70 }