don't know.
[kopensolaris-gnu/glibc.git] / manual / libc.texinfo
1 \input texinfo                  @c -*- Texinfo -*-
2 @comment %**start of header (This is for running Texinfo on a region.)
3 @setfilename library.info
4 @settitle The GNU C Library
5 @setchapternewpage odd
6 @comment %**end of header (This is for running Texinfo on a region.)
7
8 @ifinfo
9 This file documents the GNU C library.
10
11 Copyright (C) 1992 Free Software Foundation, Inc.
12
13 This will be free information when it is finished, but isn't finished yet.
14 @end ifinfo
15
16 @setchapternewpage odd
17
18 @titlepage
19 @center @titlefont{The GNU C Library}
20 @sp 1
21 @center @titlefont{Reference Manual}
22 @sp 2
23 @center Sandra Loosemore
24 @center with
25 @center Roland McGrath, Andrew Oram, and Richard M. Stallman
26 @sp 3
27 @center last updated January 10, 1992
28 @sp 1
29 @center for version 0.00
30 @page
31 @vskip 0pt plus 1filll
32 Copyright @copyright{} 1992 Free Software Foundation, Inc.
33 @end titlepage
34 @page
35
36 @ifinfo
37 @node Top, Introduction, (dir), (dir)
38 @top Main Menu
39 This is the reference manual for version 0.00 of the GNU C Library.
40 @end ifinfo
41
42 @menu
43 Overview
44 * Introduction::                Purpose of the GNU C Library.
45 * Getting Started::             How this document is organized.
46 * Standards and Portability::   The functionality in the GNU C Library is
47                                  derived from various standards.
48 * Using the Library::           How to use the library facilities in
49                                  your programs.
50 * Roadmap to the Manual::       A short description of the contents of
51                                  each chapter of this manual.
52
53 Contents of the Library
54 * Error Reporting::                     How the GNU Library functions report
55                                          error conditions.
56 * Common Definitions::                  Things like @code{sizeof} and
57                                          @code{NULL}.
58 * Variable Argument Facilities::        How to process variable-length
59                                          argument lists.
60 * Memory Allocation::                   Your program can allocate memory
61                                          dynamically and manipulate it via
62                                          pointers.
63 * Character Handling::                  Character testing and conversion
64                                          functions.
65 * String and Array Utilities::          Utilities for copying and comparing
66                                          strings and arrays.
67 * Extended Characters::                 Support for extended character sets.
68 * Locales::                             The country and language can affect
69                                          the behavior of library functions.
70 * Searching and Sorting::               General searching and sorting
71                                          functions.
72 * Input/Output Overview::               Introduction to the i/o facilities.
73 * Input/Output on Streams::             High-level, portable i/o facilities.
74 * Low-Level Input/Output::              Low-level, less portable i/o.
75 * File System Interface::               Functions for manipulating files.
76 * Pipes and FIFOs::                     A simple interprocess communication
77                                          mechanism.
78 * Sockets::                             A more complicated interprocess
79                                          communication mechanism, with support
80                                          for networking.
81 * Low-Level Terminal Interface::        How to change the characteristics
82                                          of a terminal device.
83 * Consistency Checking::                A helpful debugging facility.
84 * Mathematics::                         Math functions (transcendental,
85                                           random numbers, abs value).
86 * Arithmetic::                          Low-level arithmetic functions.
87 * Date and Time::                       Functions for getting the date and
88                                          time, and conversion between formats.
89 * Non-Local Exits::                     The @code{setjmp} and @code{longjmp}
90                                          facilities.
91 * Signal Handling::                     All about signals; how to send them,
92                                          block them, and handle them.
93 * Processes::                           How to create processes and run other
94                                          programs.
95 * Job Control::                         All about process groups and sessions.
96 * System Databases::                    About the system user and group
97                                          databases.
98 * System Information::                  Getting information about the
99                                          hardware and software configuration
100                                          of the machine a program runs on.
101 * Representation Limits::               Parameters describing numeric data
102                                          type representations..
103 * System Configuration Limits::         Parameters describing operating
104                                          system limits.
105
106 Appendices
107 * Summary of Library Facilities::       A summary showing the syntax, header
108                                          file, and derivation of each library
109                                          feature.
110 * Maintenance::                         How to install and maintain the
111                                          GNU C Library.
112 * Copying::                             The GNU Library General Public License
113                                          says how you can copy and share the
114                                          GNU C Library.
115
116 Indices
117 * Concept Index::       Index of concepts and names.
118 * Type Index::          Index of types and type qualifiers.
119 * Function Index::      Index of functions and function-like macros.
120 * Variable Index::      Index of variables and variable-like macros.
121 * File Index::          Index of programs and files.
122 @end menu
123
124 @include intro.texinfo
125 @include errno.texinfo
126 @include stddef.texinfo
127 @include stdarg.texinfo
128 @include memory.texinfo
129 @include ctype.texinfo
130 @include string.texinfo
131 @include mbyte.texinfo
132 @include locale.texinfo
133 @include search.texinfo
134 @include io.texinfo
135 @include stdio.texinfo
136 @include llio.texinfo
137 @include filesys.texinfo
138 @include pipe.texinfo
139 @include socket.texinfo
140 @include terminal.texinfo
141 @include assert.texinfo
142 @include math.texinfo
143 @include math-arithmetic.texinfo
144 @c the above file was created from `math.texinfo', which contained
145 @c two @chapters and could not be updated easily.  --mew
146 @include time.texinfo
147 @include setjmp.texinfo
148 @include signal.texinfo
149 @include process.texinfo
150 @include job.texinfo
151 @include users.texinfo
152 @include sysinfo.texinfo
153 @include limits.texinfo
154 @include conf.texinfo
155
156
157 @include header.texinfo
158 @include maint.texinfo
159
160 @set lgpl-appendix
161 @node Copying, Concept Index, Maintenance, Top
162 @include lgpl.texinfo
163
164 @node Concept Index
165 @unnumbered Concept Index
166 @printindex cp
167
168 @node Type Index
169 @unnumbered Type Index
170 @printindex tp
171
172 @node Function Index
173 @unnumbered Function and Macro Index
174 @printindex fn
175
176 @node Variable Index
177 @unnumbered Variable and Constant Macro Index
178 @printindex vr
179
180 @node File Index
181 @unnumbered Program and File Index
182 @printindex pg
183
184 @shortcontents
185 @contents
186 @bye