Remove unneeded .Pp before .Rs in various manual pages.
[dragonfly.git] / lib / libc / stdio / priv_stdio.h
blobde4e67226c72a0d43a753557a976ae5124810c72
1 /*-
2 * Copyright (c) 1990, 1993
3 * The Regents of the University of California. All rights reserved.
4 * Copyright (c) 2005 Joerg Sonnenberger <joerg@bec.de>. All rights reserved.
6 * This code is derived from software contributed to Berkeley by
7 * Chris Torek.
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions
11 * are met:
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
14 * 2. Redistributions in binary form must reproduce the above copyright
15 * notice, this list of conditions and the following disclaimer in the
16 * documentation and/or other materials provided with the distribution.
17 * 3. Neither the name of the University nor the names of its contributors
18 * may be used to endorse or promote products derived from this software
19 * without specific prior written permission.
21 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31 * SUCH DAMAGE.
33 * $DragonFly: src/lib/libc/stdio/priv_stdio.h,v 1.3 2005/08/02 00:44:39 joerg Exp $
36 #ifndef _LIBC_PRIV_STDIO_H_
37 #define _LIBC_PRIV_STDIO_H_
39 #include <pthread.h>
41 #include "wcio.h"
44 * NB: to fit things in six character monocase externals, the stdio
45 * code uses the prefix `__s' for stdio objects, typically followed
46 * by a three-character attempt at a mnemonic.
49 /* stdio buffers */
50 struct __sbuf {
51 unsigned char *_base;
52 int _size;
56 * _ub, _up, and _ur are used when ungetc() pushes back more characters
57 * than fit in the current _bf, or when ungetc() pushes back a character
58 * that does not match the previous one in _bf. When this happens,
59 * _ub._base becomes non-nil (i.e., a stream has ungetc() data iff
60 * _ub._base!=NULL) and _up and _ur save the current values of _p and _r.
63 struct __FILE {
64 struct __FILE_public pub;
65 struct __sbuf _bf; /* the buffer (at least 1 byte, if !NULL) */
67 /* operations */
68 void *_cookie; /* cookie passed to io functions */
69 int (*_close)(void *);
70 int (*_read)(void *, char *, int);
71 fpos_t (*_seek)(void *, fpos_t, int);
72 int (*_write)(void *, const char *, int);
74 /* separate buffer for long sequences of ungetc() */
75 struct __sbuf _ub; /* ungetc buffer */
76 int _ur; /* saved _r when _r is counting ungetc data */
78 /* tricks to meet minimum requirements even when malloc() fails */
79 unsigned char _ubuf[3]; /* guarantee an ungetc() buffer */
80 unsigned char _nbuf[1]; /* guarantee a getc() buffer */
82 /* separate buffer for fgetln() when line crosses buffer boundary */
83 struct __sbuf _lb; /* buffer for fgetln() */
85 /* Unix stdio files get aligned to block boundaries on fseek() */
86 int _blksize; /* stat.st_blksize (may be != _bf._size) */
87 fpos_t _offset; /* current lseek offset (see WARNING) */
89 unsigned char *_up; /* saved _p when _p is doing ungetc data */
90 pthread_mutex_t _fl_mutex; /* used for MT-safety */
91 pthread_t _fl_owner; /* current owner */
92 int _fl_count; /* recursive lock count */
94 struct wchar_io_data _wcio;
98 * I/O descriptors for __sfvwrite().
100 struct __siov {
101 void *iov_base;
102 size_t iov_len;
104 struct __suio {
105 struct __siov *uio_iov;
106 int uio_iovcnt;
107 int uio_resid;
111 * The first few FILEs are statically allocated; others are dynamically
112 * allocated and linked in via this glue structure.
114 struct glue {
115 struct glue *next;
116 int niobs;
117 FILE *iobs;
120 extern struct glue __sglue;
122 __BEGIN_DECLS
123 int __sfvwrite(FILE *, struct __suio *);
124 int __fflush(FILE *);
125 int __ungetc(int, FILE *);
126 __END_DECLS
128 #endif /* _LIBC_PRIV_STDIO_H_ */