V2_CHAP01(3) Library Functions Manual V2_CHAP01(3)

V2_chap01 — Introduction

The System Interfaces volume of POSIX.1-2008 describes the interfaces offered to application programs by POSIX-conformant systems.

Great care has been taken to ensure that this volume of POSIX.1-2008 is fully aligned with the following standards:


ISO/IEC 9899:1999 (“ISO C99”), Programming Languages - C, including ISO/IEC 9899:1999 (“ISO C99”)/Cor.1:2001(E), ISO/IEC 9899:1999 (“ISO C99”)/Cor.2:2004(E), and ISO/IEC 9899:1999 (“ISO C99”)/Cor.3.

Parts of the ISO/IEC 9899:1999 (“ISO C99”) standard (hereinafter referred to as the ISO C standard) are referenced to describe requirements also mandated by this volume of POSIX.1-2008. Some functions and headers included within this volume of POSIX.1-2008 have a version in the ISO C standard; in this case CX markings are added as appropriate to show where the ISO C standard has been extended (see V1_chap01(7) ). Any conflict between this volume of POSIX.1-2008 and the ISO C standard is unintentional.

This volume of POSIX.1-2008 also allows, but does not require, mathematics functions to support IEEE Std 754-1985 and IEEE Std 854-1987.

The entries in V2_chap03(3) are based on a common format as follows. The only sections relating to conformance are the SYNOPSIS, DESCRIPTION, RETURN VALUE, and ERRORS sections.


This section gives the name or names of the entry and briefly states its purpose.

This section summarizes the use of the entry being described. If it is necessary to include a header to use this function, the names of such headers are shown, for example: 
#include <stdio.h>

This section describes the functionality of the function or header.

This section indicates the possible return values, if any.

If the implementation can detect errors, "successful completion" means that no error has been detected during execution of the function. If the implementation does detect an error, the error is indicated.

For functions where no errors are defined, "successful completion" means that if the implementation checks for errors, no error has been detected. If the implementation can detect errors, and an error is detected, the indicated return value is returned and errno may be set.


This section gives the symbolic names of the error values returned by a function or stored into a variable accessed through the symbol errno if an error occurs.

``No errors are defined" means that error values returned by a function or stored into a variable accessed through the symbol errno, if any, depend on the implementation.


This section is informative.

This section gives examples of usage, where appropriate. In the event of conflict between an example and a normative part of this volume of POSIX.1-2008, the normative material is to be taken as correct.


This section is informative.

This section gives warnings and advice to application developers about the entry. In the event of conflict between warnings and advice and a normative part of this volume of POSIX.1-2008, the normative material is to be taken as correct.


This section is informative.

This section contains historical information concerning the contents of this volume of POSIX.1-2008 and why features were included or discarded by the standard developers.


This section is informative.

This section provides comments which should be used as a guide to current thinking; there is not necessarily a commitment to adopt these future directions.


This section is informative.

This section gives references to related information.


This section is informative.

This section shows the derivation of the entry and any significant changes that have been made to it.

January 1, 2008 posix.fail