The GNU C Library Reference Manual

1 The gnu c Library Reference ManualThe gnu c LibraryReference ManualSandra LoosemorewithRichard M. Stallman, Roland McGrath, Andrew Oram, and Ulrich Drepperfor version isThe gnu c Library Reference Manual , for version 1993 2021 Free Software Foundation, is granted to copy, distribute and/or modify this document under the terms ofthe GNU Free Documentation License, Version or any later version published by theFree Software Foundation; with the Invariant Sections being Free Software Needs FreeDocumentation and GNU Lesser General Public License , the Front-Cover texts being A GNU Manual , and with the Back-Cover Texts as in (a) below.

2 A copy of the license isincluded in the section entitled"GNU Free Documentation License".(a) The FSF s Back-Cover Text is: You have the freedom to copy and modify this GNUmanual. Buying copies from the FSF supports it in developing GNU and promoting softwarefreedom. iShort Memory Allocation And and Array Set and and Pattern Input/Output Input/Output on Low-Level File System Pipes and Low-Level Terminal Arithmetic Date and Resource Usage And Non-Local Signal The Basic Program/System Inter-Process Job System Databases and Name Service Users and System System Configuration Cryptographic Debugging Internal Language Facilities in the of Library the gnu c to the gnu c Software Needs Free Lesser General Public Free Documentation and

3 Macro and Constant Macro and File of Contents1 Getting Standards and ISO POSIX (The Portable Operating System Interface).. POSIX Safety Unsafe Conditionally Safe Other Safety Berkeley SVID (The System V Interface Description).. XPG (The X/Open Portability Guide).. Using the Header Macro Definitions of Reserved Feature Test Roadmap to the Error Checking for Error Error Virtual Memory Allocation And Process Memory Allocating Storage For Program Memory Allocation in C Dynamic Memory The GNU Unconstrained Basic Memory Examples Freeing Memory Allocated Changing the Size of a Allocating Cleared Allocating Aligned Memory Malloc Tunable Heap Consistency Statistics for Memory Allocation Summary ofmalloc-Related Allocation How to install the tracing Example

4 Program Some more or less clever Interpreting the Creating Preparing for Using Allocation in an Freeing Objects in an Obstack Functions and Growing Extra Fast Growing Status of an Alignment of Data in Obstack Summary of Obstack Automatic Storage with Variable Advantages Disadvantages gnu c Variable-Size Resizing the Data Memory Memory Protection Locking Why Lock Locked Memory Functions To Lock And Unlock Character Classification of Case Character class determination for wide Notes on using the wide character Mapping of wide String and Array Representation of String and Array String Copying Strings and Concatenating Truncating Strings while String/Array Collation Search Compatibility String Search Finding Tokens in a Erasing Sensitive Shuffling Obfuscating Encode Binary Argz and Envz Argz Envz Character Set Introduction to Extended Overview about Character Handling Restartable Multibyte Conversion Selecting the conversion and its Representing the state of the Converting Single Converting

5 Multibyte and Wide Character A Complete Multibyte Conversion Non-reentrant Conversion Non-reentrant Conversion of Single Non-reentrant Conversion of States in Non-reentrant Generic Charset Generic Character Set Conversion A Some Details about TheiconvImplementation in the gnu c Format Finding the conversion path data Locales and What Effects a Locale Choosing a Locale How Programs Set the Standard Locale Accessing Locale : It is portable but .. Generic Numeric Formatting Printing the Currency Printing the Sign of a Monetary Pinpoint Access to Locale A dedicated function to format Yes-or-No Message X/Open Message Catalog Thecatgetsfunction Format of the message catalog Generate Message Catalogs How to use Not using symbolic Using symbolic How does to this allow to The Uniforum approach to Message Thegettextfamily of What has to be done to translate a message?

6 How to determine which catalog to be Additional functions for more complicated How to specify the output character How to usegettextin GUI User influence Programs to handle message catalogs Searching and Defining the Comparison Array Search Array Sort Searching and Sorting Pattern Wildcard Flags for More Flags for Regular Expression POSIX Regular Expression Flags for POSIX Regular Matching a Compiled POSIX Regular Match Results with Complications in Subexpression POSIX Regexp Matching Shell-Style Word The Stages of Word Flags for Word Details of Tilde Details of Variable Input/Output Input/Output Streams and File File File File Name File Name Portability of File Input/Output on Standard Opening Closing Streams and Streams in Internationalized Simple Output by Characters or Character Line-Oriented What Unreading UsingungetcTo Do Block Formatted Formatted Output Output Conversion Table of Output Integer Floating-Point Other Output Formatted Output Dynamically

7 Allocating Formatted Variable Arguments Output Parsing a Template Example of Parsing a Template Registering New Conversion Specifier Defining the Output Formatted Formatted Input Input Conversion Table of Input Numeric Input String Input Dynamically Allocating String Other Input Formatted Input Variable Arguments Input End-Of-File and Recovering from Text and Binary File Portable File-Position Stream Buffering Flushing Controlling Which Kind of Other Kinds of String Programming Your Own Custom Custom Streams and Custom Stream Hook Formatted Printing Formatted Adding Severity How to Low-Level Opening and Closing Input and Output Setting the File Position of a Descriptors and Dangers of Mixing Streams and Linked Independent Cleaning Fast Scatter-Gather Copying data between two Memory-mapped Waiting for Input or Synchronizing I/O Perform I/O Operations in Asynchronous Read and Write Getting the Status of AIO Getting into a Consistent Cancellation of AIO How to optimize the AIO Control

8 Operations on Duplicating File Descriptor File Status File Access Open-time I/O Operating Getting and Setting File Status File Open File Description Open File Description Locks Interrupt-Driven Generic I/O Control File System Working Accessing Format of a Directory Opening a Directory Reading and Closing a Directory Simple Program to List a Random Access in a Directory Scanning the Content of a Simple Program to List a Directory, Mark Low-level Directory Working with Directory Hard Symbolic Deleting Renaming Creating File The meaning of the File Reading the Attributes of a Testing the Type of a File The Mode Bits for Access How Your Access to a File is Assigning File Testing Permission to Access a File File Storage Making Special Temporary Pipes and Creating a Pipe to a FIFO Special Atomicity of Pipe Socket Communication Socket Address Setting the Address of a Reading the Address of a Interface

9 The Local Local Namespace Details of Local Example of Local-Namespace The Internet Internet Socket Address Host Internet Host Host Address Data Host Address Host Internet The Services Byte Order Protocols Internet Socket Other Opening and Closing Creating a Closing a Socket Using Sockets with Making a Listening for Accepting Who is Connected to Me?.. Transferring Sending Receiving Socket Data Byte Stream Socket Byte Stream Connection Server Out-of-Band Datagram Socket Sending Receiving Datagram Socket Example of Reading Socket Socket Option Socket-Level Networks Low-Level Terminal Identifying I/O Two Styles of Input: Canonical or Terminal Terminal Mode Data Terminal Mode Setting Terminal Modes Input Output Control Local Line Special Characters for Input Charact