master
 1/* Functions to access FILE structure internals.
 2   Copyright (C) 2000-2025 Free Software Foundation, Inc.
 3   This file is part of the GNU C Library.
 4
 5   The GNU C Library is free software; you can redistribute it and/or
 6   modify it under the terms of the GNU Lesser General Public
 7   License as published by the Free Software Foundation; either
 8   version 2.1 of the License, or (at your option) any later version.
 9
10   The GNU C Library is distributed in the hope that it will be useful,
11   but WITHOUT ANY WARRANTY; without even the implied warranty of
12   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13   Lesser General Public License for more details.
14
15   You should have received a copy of the GNU Lesser General Public
16   License along with the GNU C Library; if not, see
17   <https://www.gnu.org/licenses/>.  */
18
19/* This header contains the same definitions as the header of the same name
20   on Sun's Solaris OS.  */
21
22#ifndef _STDIO_EXT_H
23#define _STDIO_EXT_H	1
24
25#include <stdio.h>
26
27enum
28{
29  /* Query current state of the locking status.  */
30  FSETLOCKING_QUERY = 0,
31#define FSETLOCKING_QUERY	FSETLOCKING_QUERY
32  /* The library protects all uses of the stream functions, except for
33     uses of the *_unlocked functions, by calls equivalent to flockfile().  */
34  FSETLOCKING_INTERNAL,
35#define FSETLOCKING_INTERNAL	FSETLOCKING_INTERNAL
36  /* The user will take care of locking.  */
37  FSETLOCKING_BYCALLER
38#define FSETLOCKING_BYCALLER	FSETLOCKING_BYCALLER
39};
40
41
42__BEGIN_DECLS
43
44/* Return the size of the buffer of FP in bytes currently in use by
45   the given stream.  */
46extern size_t __fbufsize (FILE *__fp) __THROW __nonnull ((1));
47
48
49/* Return non-zero value iff the stream FP is opened readonly, or if the
50   last operation on the stream was a read operation.  */
51extern int __freading (FILE *__fp) __THROW __nonnull ((1));
52
53/* Return non-zero value iff the stream FP is opened write-only or
54   append-only, or if the last operation on the stream was a write
55   operation.  */
56extern int __fwriting (FILE *__fp) __THROW __nonnull ((1));
57
58
59/* Return non-zero value iff stream FP is not opened write-only or
60   append-only.  */
61extern int __freadable (FILE *__fp) __THROW __nonnull ((1));
62
63/* Return non-zero value iff stream FP is not opened read-only.  */
64extern int __fwritable (FILE *__fp) __THROW __nonnull ((1));
65
66
67/* Return non-zero value iff the stream FP is line-buffered.  */
68extern int __flbf (FILE *__fp) __THROW __nonnull ((1));
69
70
71/* Discard all pending buffered I/O on the stream FP.  */
72extern void __fpurge (FILE *__fp) __THROW __nonnull ((1));
73
74/* Return amount of output in bytes pending on a stream FP.  */
75extern size_t __fpending (FILE *__fp) __THROW __nonnull ((1));
76
77/* Flush all line-buffered files.  */
78extern void _flushlbf (void);
79
80
81/* Set locking status of stream FP to TYPE.  */
82extern int __fsetlocking (FILE *__fp, int __type) __THROW __nonnull ((1));
83
84__END_DECLS
85
86#endif	/* stdio_ext.h */