Formerly stdio/stdio.h.~43~
[kopensolaris-gnu/glibc.git] / stdio / stdio.h
1 /* Copyright (C) 1991, 1992, 1993 Free Software Foundation, Inc.
2 This file is part of the GNU C Library.
3
4 The GNU C Library is free software; you can redistribute it and/or
5 modify it under the terms of the GNU Library General Public License as
6 published by the Free Software Foundation; either version 2 of the
7 License, or (at your option) any later version.
8
9 The GNU C Library is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12 Library General Public License for more details.
13
14 You should have received a copy of the GNU Library General Public
15 License along with the GNU C Library; see the file COPYING.LIB.  If
16 not, write to the Free Software Foundation, Inc., 675 Mass Ave,
17 Cambridge, MA 02139, USA.  */
18
19 /*
20  *      ANSI Standard: 4.9 INPUT/OUTPUT <stdio.h>
21  */
22
23 #ifndef _STDIO_H
24
25 #if     !defined(__need_FILE)
26 #define _STDIO_H        1
27 #include <features.h>
28
29 __BEGIN_DECLS
30
31 #define __need_size_t
32 #define __need_NULL
33 #include <stddef.h>
34
35 #define __need___va_list
36 #include <stdarg.h>
37 #ifndef __GNUC_VA_LIST
38 #define __gnuc_va_list  __ptr_t
39 #endif
40
41 #include <gnu/types.h>
42 #endif /* Don't need FILE.  */
43 #undef  __need_FILE
44
45
46 #ifndef __FILE_defined
47
48 /* The opaque type of streams.  */
49 typedef struct __stdio_file FILE;
50
51 #define __FILE_defined  1
52 #endif /* FILE not defined.  */
53
54
55 #ifdef  _STDIO_H
56
57 /* The type of the second argument to `fgetpos' and `fsetpos'.  */
58 typedef __off_t fpos_t;
59
60 /* The mode of I/O, as given in the MODE argument to fopen, etc.  */
61 typedef struct
62 {
63   unsigned int __read:1;        /* Open for reading.  */
64   unsigned int __write:1;       /* Open for writing.  */
65   unsigned int __append:1;      /* Open for appending.  */
66   unsigned int __binary:1;      /* Opened binary.  */
67   unsigned int __create:1;      /* Create the file.  */
68   unsigned int __exclusive:1;   /* Error if it already exists.  */
69   unsigned int __truncate:1;    /* Truncate the file on opening.  */
70 } __io_mode;
71
72
73 /* Functions to do I/O and file management for a stream.  */
74
75 /* Read NBYTES bytes from COOKIE into a buffer pointed to by BUF.
76    Return number of bytes read.  */
77 typedef __ssize_t __io_read __P ((__ptr_t __cookie, char *__buf,
78                                   size_t __nbytes));
79
80 /* Write N bytes pointed to by BUF to COOKIE.  Write all N bytes
81    unless there is an error.  Return number of bytes written, or -1 if
82    there is an error without writing anything.  If the file has been
83    opened for append (__mode.__append set), then set the file pointer
84    to the end of the file and then do the write; if not, just write at
85    the current file pointer.  */
86 typedef __ssize_t __io_write __P ((__ptr_t __cookie, __const char *__buf,
87                                    size_t __n));
88
89 /* Move COOKIE's file position to *POS bytes from the
90    beginning of the file (if W is SEEK_SET),
91    the current position (if W is SEEK_CUR),
92    or the end of the file (if W is SEEK_END).
93    Set *POS to the new file position.
94    Returns zero if successful, nonzero if not.  */
95 typedef int __io_seek __P ((__ptr_t __cookie, fpos_t *__pos, int __w));
96
97 /* Close COOKIE.  */
98 typedef int __io_close __P ((__ptr_t __cookie));
99
100 /* Low level interface, independent of FILE representation.  */
101 typedef struct
102 {
103   __io_read *__read;            /* Read bytes.  */
104   __io_write *__write;          /* Write bytes.  */
105   __io_seek *__seek;            /* Seek/tell file position.  */
106   __io_close *__close;          /* Close file.  */
107 } __io_functions;
108
109 /* Higher level interface, dependent on FILE representation.  */
110 typedef struct
111 {
112   /* Make room in the input buffer.  */
113   int (*__input) __P ((FILE *__stream));
114   /* Make room in the output buffer.  */
115   void (*__output) __P ((FILE *__stream, int __c));
116 } __room_functions;
117
118 extern __const __io_functions __default_io_functions;
119 extern __const __room_functions __default_room_functions;
120
121
122 /* Default close function.  */
123 extern __io_close __stdio_close;
124 /* Open FILE with mode M, return cookie or NULL to use an int in *DP.  */
125 extern __ptr_t __stdio_open __P ((__const char *__file, __io_mode __m,
126                                   int *__dp));
127 /* Put out an error message for when stdio needs to die.  */
128 extern void __stdio_errmsg __P ((__const char *__msg, size_t __len));
129 /* Generate a unique file name.  */
130 extern char *__stdio_gen_tempname __P ((__const char *__dir,
131                                         __const char *__pfx,
132                                         int __dir_search, size_t *__lenptr));
133
134 #ifndef __NORETURN
135 #ifdef  __GNUC__
136 #define __NORETURN      __volatile
137 #else /* Not GCC.  */
138 #define __NORETURN
139 #endif /* GCC.  */
140 #endif /* __NORETURN not defined.  */
141
142 /* Print out MESSAGE on the error output and abort.  */
143 extern __NORETURN void __libc_fatal __P ((__const char *__message));
144
145
146 /* The FILE structure.  */
147 struct __stdio_file
148 {
149   /* Magic number for validation.  Must be negative in open streams
150      for the glue to Unix stdio getc/putc to work.  */
151   int __magic;
152 #define _IOMAGIC        0xfedabeeb      /* Magic number to fill `__magic'.  */
153 #define _GLUEMAGIC      0xfeedbabe      /* Magic for glued Unix streams.  */
154
155   char *__bufp;                 /* Pointer into the buffer.  */
156   char *__get_limit;            /* Reading limit.  */
157   char *__put_limit;            /* Writing limit.  */
158   char *__buffer;               /* Base of buffer.  */
159   size_t __bufsize;             /* Size of the buffer.  */
160   FILE *__next;                 /* Next FILE in the linked list.  */
161   __ptr_t __cookie;             /* Magic cookie.  */
162   int __fileno;                 /* System file descriptor.  */
163   unsigned char __pushback;     /* Pushed-back character.  */
164   char *__pushback_bufp;        /* Old bufp if char pushed back.  */
165   unsigned int __pushed_back:1; /* A char has been pushed back.  */
166   unsigned int __eof:1;         /* End of file encountered.  */
167   unsigned int __error:1;       /* Error encountered.  */
168   unsigned int __userbuf:1;     /* Buffer is from user.  */
169   unsigned int __linebuf:1;     /* Flush on newline.  */
170   unsigned int __seen:1;        /* This stream has been seen.  */
171   unsigned int __ispipe:1;      /* Nonzero if opened by popen.  */
172   __io_mode __mode;             /* File access mode.  */
173   __io_functions __io_funcs;    /* I/O functions.  */
174   __room_functions __room_funcs;/* I/O buffer room functions.  */
175   fpos_t __offset;              /* Current file position.  */
176   fpos_t __target;              /* Target file position.  */
177 };
178
179
180 /* All macros used internally by other macros here and by stdio functions begin
181    with `__'.  All of these may evaluate their arguments more than once.  */
182
183
184 /* Nonzero if STREAM is a valid stream.
185    STREAM must be a modifiable lvalue (wow, I got to use that term).
186    See stdio/glue.c for what the confusing bit is about.  */
187 #define __validfp(stream)                                                     \
188   (stream != NULL && ((stream->__magic == _GLUEMAGIC &&                       \
189                        (stream = *(FILE **) ((int *) stream)[1])),            \
190                       (stream->__magic == _IOMAGIC)))                         \
191
192 /* Clear the error and EOF indicators of STREAM.  */
193 #define __clearerr(stream)      ((stream)->__error = (stream)->__eof = 0)
194
195 /* Nuke STREAM, making it unusable but available for reuse.  */
196 extern void __invalidate __P ((FILE *__stream));
197
198 /* Make sure STREAM->__offset and STREAM->__target are initialized.
199    Returns 0 if successful, or EOF on
200    error (but doesn't set STREAM->__error).  */
201 extern int __stdio_check_offset __P ((FILE *__stream));
202
203
204 /* The possibilities for the third argument to `setvbuf'.  */
205 #define _IOFBF  0x1             /* Full buffering.  */
206 #define _IOLBF  0x2             /* Line buffering.  */
207 #define _IONBF  0x4             /* No buffering.  */
208
209
210 /* Default buffer size.  */
211 #define BUFSIZ  1024
212
213
214 /* End of file character.
215    Some things throughout the library rely on this being -1.  */
216 #define EOF     (-1)
217
218
219 /* The possibilities for the third argument to `fseek'.
220    These values should not be changed.  */
221 #define SEEK_SET        0       /* Seek from beginning of file.  */
222 #define SEEK_CUR        1       /* Seek from current position.  */
223 #define SEEK_END        2       /* Seek from end of file.  */
224
225
226 #ifdef  __USE_SVID
227 /* Default path prefix for `tempnam' and `tmpnam'.  */
228 #define P_tmpdir        "/usr/tmp"
229 #endif
230
231
232 /* Get the values:
233    L_tmpnam     How long an array of chars must be to be passed to `tmpnam'.
234    TMP_MAX      The minimum number of unique filenames generated by tmpnam
235                 (and tempnam when it uses tmpnam's name space),
236                 or tempnam (the two are separate).
237    L_ctermid    How long an array to pass to `ctermid'.
238    L_cuserid    How long an array to pass to `cuserid'.
239    FOPEN_MAX    Mininum number of files that can be open at once.
240    FILENAME_MAX Maximum length of a filename.  */
241 #include <stdio_lim.h>
242
243
244 /* All the known streams are in a linked list
245    linked by the `next' field of the FILE structure.  */
246 extern FILE *__stdio_head;      /* Head of the list.  */
247
248 /* Standard streams.  */
249 extern FILE *stdin, *stdout, *stderr;
250
251
252 /* Remove file FILENAME.  */
253 extern int remove __P ((__const char *__filename));
254 /* Rename file OLD to NEW.  */
255 extern int rename __P ((__const char *__old, __const char *__new));
256
257
258 /* Create a temporary file and open it read/write.  */
259 extern FILE *tmpfile __P ((void));
260 /* Generate a temporary filename.  */
261 extern char *tmpnam __P ((char *__s));
262
263
264 #ifdef  __USE_SVID
265 /* Generate a unique temporary filename using up to five characters of PFX
266    if it is not NULL.  The directory to put this file in is searched for
267    as follows: First the environment variable "TMPDIR" is checked.
268    If it contains the name of a writable directory, that directory is used.
269    If not and if DIR is not NULL, that value is checked.  If that fails,
270    P_tmpdir is tried and finally "/tmp".  The storage for the filename
271    is allocated by `malloc'.  */
272 extern char *tempnam __P ((__const char *__dir, __const char *__pfx));
273 #endif
274
275
276 /* This performs actual output when necessary, flushing
277    STREAM's buffer and optionally writing another character.  */
278 extern int __flshfp __P ((FILE *__stream, int __c));
279
280
281 /* Close STREAM, or all streams if STREAM is NULL.  */
282 extern int fclose __P ((FILE *__stream));
283 /* Flush STREAM, or all streams if STREAM is NULL.  */
284 extern int fflush __P ((FILE *__stream));
285
286
287 /* Open a file and create a new stream for it.  */
288 extern FILE *fopen __P ((__const char *__filename, __const char *__modes));
289 /* Open a file, replacing an existing stream with it. */
290 extern FILE *freopen __P ((__const char *__filename,
291                            __const char *__modes, FILE *__stream));
292
293 /* Return a new, zeroed, stream.
294    You must set its cookie and io_mode.
295    The first operation will give it a buffer unless you do.
296    It will also give it the default functions unless you set the `seen' flag.
297    The offset is set to -1, meaning it will be determined by doing a
298    stationary seek.  You can set it to avoid the initial tell call.
299    The target is set to -1, meaning it will be set to the offset
300    before the target is needed.
301    Returns NULL if a stream can't be created.  */
302 extern FILE *__newstream __P ((void));
303
304 #ifdef  __USE_POSIX
305 /* Create a new stream that refers to an existing system file descriptor.  */
306 extern FILE *fdopen __P ((int __fd, __const char *__modes));
307 #endif
308
309 #ifdef  __USE_GNU
310 /* Create a new stream that refers to the given magic cookie,
311    and uses the given functions for input and output.  */
312 extern FILE *fopencookie __P ((__ptr_t __magic_cookie, __const char *__modes,
313                                __io_functions __io_funcs));
314
315 /* Create a new stream that refers to a memory buffer.  */
316 extern FILE *fmemopen __P ((__ptr_t __s, size_t __len, __const char *__modes));
317
318 /* Open a stream that writes into a malloc'd buffer that is expanded as
319    necessary.  *BUFLOC and *SIZELOC are updated with the buffer's location
320    and the number of characters written on fflush or fclose.  */
321 extern FILE *open_memstream __P ((char **__bufloc, size_t *__sizeloc));
322 #endif
323
324
325 /* If BUF is NULL, make STREAM unbuffered.
326    Else make it use buffer BUF, of size BUFSIZ.  */
327 extern void setbuf __P ((FILE *__stream, char *__buf));
328 /* Make STREAM use buffering mode MODE.
329    If BUF is not NULL, use N bytes of it for buffering;
330    else allocate an internal buffer N bytes long.  */
331 extern int setvbuf __P ((FILE *__stream, char *__buf,
332                          int __modes, size_t __n));
333
334 #ifdef  __USE_BSD
335 /* If BUF is NULL, make STREAM unbuffered.
336    Else make it use SIZE bytes of BUF for buffering.  */
337 extern void setbuffer __P ((FILE *__stream, char *__buf, size_t __size));
338
339 /* Make STREAM line-buffered.  */
340 extern void setlinebuf __P ((FILE *__stream));
341 #endif
342
343
344 /* Write formatted output to STREAM.  */
345 extern int fprintf __P ((FILE *__stream, __const char *__format, ...));
346 /* Write formatted output to stdout.  */
347 extern int printf __P ((__const char *__format, ...));
348 /* Write formatted output to S.  */
349 extern int sprintf __P ((char *__s, __const char *__format, ...));
350
351 /* Write formatted output to S from argument list ARG.  */
352 extern int vfprintf __P ((FILE *__s, __const char *__format,
353                           __gnuc_va_list __arg));
354 /* Write formatted output to stdout from argument list ARG.  */
355 extern int vprintf __P ((__const char *__format, __ptr_t __arg));
356 /* Write formatted output to S from argument list ARG.  */
357 extern int vsprintf __P ((char *__s, __const char *__format,
358                           __gnuc_va_list __arg));
359
360 #ifdef  __OPTIMIZE__
361 #define vprintf(fmt, arg)               vfprintf(stdout, (fmt), (arg))
362 #endif /* Optimizing.  */
363
364 #ifdef  __USE_GNU
365 /* Maximum chars of output to write in MAXLEN.  */
366 extern int snprintf __P ((char *__s, size_t __maxlen,
367                           __const char *__format, ...));
368
369 extern int vsnprintf __P ((char *__s, size_t __maxlen,
370                            __const char *__format, __gnuc_va_list __arg));
371
372 /* Write formatted output to a string dynamically allocated with `malloc'.
373    Store the address of the string in *PTR.  */
374 extern int vasprintf __P ((char **__ptr, __const char *__f,
375                            __gnuc_va_list __arg));
376 extern int asprintf __P ((char **__ptr, __const char *__fmt, ...));
377
378 /* Write formatted output to a file descriptor.  */
379 extern int vdprintf __P ((int __fd, __const char *__fmt,
380                           __gnuc_va_list __arg));
381 extern int dprintf __P ((int __fd, __const char *__fmt, ...));
382 #endif
383
384
385 /* Read formatted input from STREAM.  */
386 extern int fscanf __P ((FILE *__stream, __const char *__format, ...));
387 /* Read formatted input from stdin.  */
388 extern int scanf __P ((__const char *__format, ...));
389 /* Read formatted input from S.  */
390 extern int sscanf __P ((__const char *__s, __const char *__format, ...));
391
392 #ifdef  __USE_GNU
393 /* Read formatted input from S into argument list ARG.  */
394 extern int __vfscanf __P ((FILE *__s, __const char *__format,
395                            __gnuc_va_list __arg));
396 extern int vfscanf __P ((FILE *__s, __const char *__format,
397                          __gnuc_va_list __arg));
398
399 /* Read formatted input from stdin into argument list ARG.  */
400 extern int vscanf __P ((__const char *__format, __gnuc_va_list __arg));
401
402 /* Read formatted input from S into argument list ARG.  */
403 extern int __vsscanf __P ((__const char *__s, __const char *__format,
404                            __gnuc_va_list __arg));
405 extern int vsscanf __P ((__const char *__s, __const char *__format,
406                          __gnuc_va_list __arg));
407
408
409 #ifdef  __OPTIMIZE__
410 #define vfscanf(s, format, arg) __vfscanf((s), (format), (arg))
411 #define vscanf(format, arg)     __vfscanf(stdin, (format), (arg))
412 #define vsscanf(s, format, arg) __vsscanf((s), (format), (arg))
413 #endif /* Optimizing.  */
414 #endif /* Use GNU.  */
415
416
417 /* This does actual reading when necessary, filling STREAM's
418    buffer and returning the first character in it.  */
419 extern int __fillbf __P ((FILE *__stream));
420
421
422 /* Read a character from STREAM.  */
423 extern int fgetc __P ((FILE *__stream));
424 extern int getc __P ((FILE *__stream));
425
426 /* Read a character from stdin.  */
427 extern int getchar __P ((void));
428
429 /* The C standard explicitly says this can
430    re-evaluate its argument, so it does. */
431 #define __getc(stream)                                                        \
432   ((stream)->__bufp < (stream)->__get_limit ?                                 \
433    (int) ((unsigned char) *(stream)->__bufp++) : __fillbf(stream))
434
435 /* The C standard explicitly says this is a macro,
436    so we always do the optimization for it.  */
437 #define getc(stream)    __getc(stream)
438
439 #ifdef  __OPTIMIZE__
440 #define getchar()       __getc(stdin)
441 #endif /* Optimizing.  */
442
443
444 /* Write a character to STREAM.  */
445 extern int fputc __P ((int __c, FILE *__stream));
446 extern int putc __P ((int __c, FILE *__stream));
447
448 /* Write a character to stdout.  */
449 extern int putchar __P ((int __c));
450
451 /* The C standard explicitly says this can
452    re-evaluate its arguments, so it does.  */
453 #define __putc(c, stream)                                                     \
454   ((stream)->__bufp < (stream)->__put_limit ?                                 \
455    (int) (unsigned char) (*(stream)->__bufp++ = (unsigned char) (c)) :        \
456    ((stream)->__linebuf && (c) != '\n' &&                                     \
457     (stream)->__bufp - (stream)->__buffer < (stream)->__bufsize) ?            \
458    (*(stream)->__bufp++ = (unsigned char) (c)) :                              \
459    __flshfp((stream), (unsigned char) (c)))
460
461 /* The C standard explicitly says this can be a macro,
462    so we always do the optimization for it.  */
463 #define putc(c, stream) __putc((c), (stream))
464
465 #ifdef  __OPTIMIZE__
466 #define putchar(c)      __putc((c), stdout)
467 #endif /* Optimizing.  */
468
469
470 #if defined(__USE_SVID) || defined(__USE_MISC)
471 /* Get a word (int) from STREAM.  */
472 extern int getw __P ((FILE *__stream));
473
474 /* Write a word (int) to STREAM.  */
475 extern int putw __P ((int __w, FILE *__stream));
476 #endif
477
478
479 /* Get a newline-terminated string of finite length from STREAM.  */
480 extern char *fgets __P ((char *__s, size_t __n, FILE *__stream));
481
482 /* Get a newline-terminated string from stdin, removing the newline.
483    DO NOT USE THIS FUNCTION!!  There is no limit on how much it will read.  */
484 extern char *gets __P ((char *__s));
485
486
487 #ifdef  __USE_GNU
488 #include <sys/types.h>
489
490 /* Read up to (and including) a DELIMITER from STREAM into *LINEPTR
491    (and null-terminate it). *LINEPTR is a pointer returned from malloc (or
492    NULL), pointing to *N characters of space.  It is realloc'd as
493    necessary.  Returns the number of characters read (not including the
494    null terminator), or -1 on error or EOF.  */
495 ssize_t __getdelim __P ((char **__lineptr, size_t *__n,
496                          int __delimiter, FILE *__stream));
497 ssize_t getdelim __P ((char **__lineptr, size_t *__n,
498                        int __delimiter, FILE *__stream));
499
500 /* Like `getdelim', but reads up to a newline.  */
501 ssize_t __getline __P ((char **__lineptr, size_t *__n, FILE *__stream));
502 ssize_t getline __P ((char **__lineptr, size_t *__n, FILE *__stream));
503
504 #ifdef  __OPTIMIZE__
505 #define getdelim(l, n, d, s)    __getdelim ((l), (n), (d), (s))
506 #define getline(l, n, s)        __getline ((l), (n), (s))
507 #define __getline(l, n, stream) __getdelim ((l), (n), '\n', (stream))
508 #endif /* Optimizing.  */
509 #endif
510
511
512 /* Write a string to STREAM.  */
513 extern int fputs __P ((__const char *__s, FILE *__stream));
514 /* Write a string, followed by a newline, to stdout.  */
515 extern int puts __P ((__const char *__s));
516
517 #ifdef  __OPTIMIZE__
518 #define puts(s) ((fputs((s), stdout) || __putc('\n', stdout) == EOF) ? EOF : 0)
519 #endif /* Optimizing.  */
520
521
522 /* Push a character back onto the input buffer of STREAM.  */
523 extern int ungetc __P ((int __c, FILE *__stream));
524
525
526 /* Read chunks of generic data from STREAM.  */
527 extern size_t fread __P ((__ptr_t __ptr, size_t __size,
528                           size_t __n, FILE *__stream));
529 /* Write chunks of generic data to STREAM.  */
530 extern size_t fwrite __P ((__const __ptr_t __ptr, size_t __size,
531                            size_t __n, FILE *__s));
532
533
534 /* Seek to a certain position on STREAM.  */
535 extern int fseek __P ((FILE *__stream, long int __off, int __whence));
536 /* Return the current position of STREAM.  */
537 extern long int ftell __P ((FILE *__stream));
538 /* Rewind to the beginning of STREAM.  */
539 extern void rewind __P ((FILE *__stream));
540
541 /* Get STREAM's position.  */
542 extern int fgetpos __P ((FILE *__stream, fpos_t *__pos));
543 /* Set STREAM's position.  */
544 extern int fsetpos __P ((FILE *__stream, __const fpos_t *__pos));
545
546
547 /* Clear the error and EOF indicators for STREAM.  */
548 extern void clearerr __P ((FILE *__stream));
549 /* Return the EOF indicator for STREAM.  */
550 extern int feof __P ((FILE *__stream));
551 /* Return the error indicator for STREAM.  */
552 extern int ferror __P ((FILE *__stream));
553
554 #ifdef  __OPTIMIZE__
555 #define feof(stream)    ((stream)->__eof != 0)
556 #define ferror(stream)  ((stream)->__error != 0)
557 #endif /* Optimizing.  */
558
559
560 /* Print a message describing the meaning of the value of errno.  */
561 extern void perror __P ((__const char *__s));
562
563 #ifdef  __USE_BSD
564 extern int sys_nerr;
565 extern char *sys_errlist[];
566 #endif
567 #ifdef  __USE_GNU
568 extern int _sys_nerr;
569 extern char *_sys_errlist[];
570 #endif
571
572 #ifdef  __USE_MISC
573 /* Print a message describing the meaning of the given signal number.  */
574 extern void psignal __P ((int __sig, __const char *__s));
575 #endif /* Non strict ANSI and not POSIX only.  */
576
577
578 #ifdef  __USE_POSIX
579 /* Return the system file descriptor for STREAM.  */
580 extern int fileno __P ((__const FILE *__stream));
581
582 #ifdef  __OPTIMIZE__
583 /* The `+ 0' makes this not be an lvalue, so it can't be changed.  */
584 #define fileno(stream)  ((stream)->__fileno + 0)
585 #endif /* Optimizing.  */
586
587 #endif /* Use POSIX.  */
588
589
590 #if (defined (__USE_POSIX2) || defined(__USE_SVID) || defined(__USE_BSD) || \
591      defined(__USE_MISC))
592 /* Create a new stream connected to a pipe running the given command.  */
593 extern FILE *popen __P ((__const char *__command, __const char *__modes));
594
595 /* Close a stream opened by popen and return the status of its child.  */
596 extern int pclose __P ((FILE *__stream));
597 #endif
598
599
600 #ifdef  __USE_POSIX
601 /* Return the name of the controlling terminal.  */
602 extern char *ctermid __P ((char *__s));
603 /* Return the name of the current user.  */
604 extern char *cuserid __P ((char *__s));
605 #endif
606
607
608 #ifdef  __USE_GNU
609 struct obstack;                 /* See <obstack.h>.  */
610
611 /* Open a stream that writes to OBSTACK.  */
612 extern FILE *open_obstack_stream __P ((struct obstack *__obstack));
613
614 /* Write formatted output to an obstack.  */
615 extern int obstack_printf __P ((struct obstack *__obstack,
616                                 __const char *__format, ...));
617 extern int obstack_vprintf __P ((struct obstack *__obstack,
618                                  __const char *__format,
619                                  __gnuc_va_list __args));
620 #endif
621
622
623 __END_DECLS
624
625 #endif /* <stdio.h> included.  */
626
627 #endif /* stdio.h  */