Relocated GLIBC NOTES as subsection under NOTES

This commit is contained in:
Michael Kerrisk 2007-05-18 10:30:02 +00:00
parent ebb451fb69
commit d597239cbd
13 changed files with 57 additions and 48 deletions

View File

@ -129,9 +129,10 @@ executing the following calls:
.SH VERSIONS
.BR epoll_pwait ()
was added to Linux in kernel 2.6.19.
.SH GLIBC NOTES
.SH NOTES
.SS Glibc Notes
Support for
.BR epoll_wait ()
.BR epoll_pwait ()
is provided starting with glibc 2.6.
.SH "RETURN VALUE"
When successful,

View File

@ -119,10 +119,7 @@ See
.BR openat (2)
for an explanation of the need for
.BR faccessat ().
.SH "CONFORMING TO"
This system call is non-standard but is proposed
for inclusion in a future revision of POSIX.1.
.SH GLIBC NOTES
.SS Glibc Notes
The
.B AT_EACCESS
and
@ -135,6 +132,9 @@ to determine access permissions.
.SH VERSIONS
.BR faccessat ()
was added to Linux in kernel 2.6.16.
.SH "CONFORMING TO"
This system call is non-standard but is proposed
for inclusion in a future revision of POSIX.1.
.SH "SEE ALSO"
.BR access (2),
.BR openat (2),

View File

@ -97,7 +97,8 @@ is a file descriptor referring to a file other than a directory.
This system call is non-standard but is proposed
for inclusion in a future revision of POSIX.1.
A similar system call exists on Solaris.
.SH GLIBC NOTES
.SH NOTES
.SS Glibc Notes
If
.I pathname
is NULL, then the glibc

View File

@ -89,7 +89,7 @@ but not
SUSv2 guarantees that `Host names are limited to 255 bytes'.
POSIX.1-2001 guarantees that `Host names (not including
the terminating null byte) are limited to HOST_NAME_MAX bytes'.
.SH "GLIBC NOTES"
.SS Glibc Notes
The GNU C library implements
.BR gethostname ()
as a library function that calls

View File

@ -135,7 +135,8 @@ function was not implemented, probably because of U.S.A. export restrictions.
.\" .PP
.\" Making encrypted data computed using crypt() publicly available has
.\" to be considered insecure for the given reasons.
.SH GLIBC NOTES
.SH NOTES
.SS Glibc Notes
The glibc2 version of this function has the following additional features.
If
.I salt

View File

@ -72,7 +72,8 @@ Some other systems have an
.\" e.g., FreeBSD 6.1.
.BR eaccess ()
function.
.SH "GLIBC NOTES"
.SH NOTES
.SS Glibc Notes
The
.BR eaccess ()
function was added to glibc in version 2.4.

View File

@ -207,7 +207,8 @@ These functions return zero on success and non-zero if an error occurred.
.\" Earlier seven of these functions were listed as returning void.
.\" This was corrected in Corrigendum 1 (ISO/IEC 9899:1999/Cor.1:2001(E))
.\" of the C99 Standard.
.SH GLIBC NOTES
.SH NOTES
.SS Glibc Notes
If possible, the GNU C Library defines a macro
.B FE_NOMASK_ENV
which represents an environment where every exception raised causes a

View File

@ -236,7 +236,8 @@ functions conform to C89.
The
.BR fdopen ()
function conforms to POSIX.1-1990.
.SH "GLIBC NOTES"
.SH NOTES
.SS Glibc Notes
The GNU C library allows the following extensions for the string specified in
.IR mode :
.TP

View File

@ -110,7 +110,8 @@ and
return a pointer to a \fBstruct utmp\fP on success, and NULL on failure.
This \fBstruct utmp\fP is allocated in static storage, and may be
overwritten by subsequent calls.
.SH GLIBC NOTES
.SH NOTES
.SS Glibc Notes
The above functions are not thread-safe.
Glibc adds reentrant versions
.sp

View File

@ -141,7 +141,7 @@ be aware that each number will be interpreted as octal
if preceded by a 0 and as hexadecimal if preceded by 0x.
For example, \fBinet_aton("226.000.000.037", &t)\fP will
interpret the address as \fI226.0.0.31\fP and not \fI226.0.0.37\fP.
.SH "GLIBC NOTES"
.SS Glibc Notes
In order to expose the declaration of
.BR inet_aton (),
one of the feature test macros _BSD_SOURCE, _SVID_SOURCE, or

View File

@ -91,7 +91,8 @@ is not a member, and \-1 on error.
is not a valid signal.
.SH "CONFORMING TO"
POSIX.1-2001.
.SH "GLIBC NOTES"
.SH NOTES
.SS Glibc Notes
If the _GNU_SOURCE feature test macro is defined, then <signal.h>
exposes three other functions for manipulating signal
sets.

View File

@ -29,7 +29,7 @@
.\" Applied fix by Wolfgang Franke, aeb, 961011
.\" Corrected return value, aeb, 970307
.\" Added Single Unix Spec conversions and %z, aeb/esr, 990329.
.\" 2005-11-22 mtk, added GLIBC NOTES covering optional 'flag' and
.\" 2005-11-22 mtk, added Glibc Notes covering optional 'flag' and
.\" 'width' components of conversion specifications.
.\"
.TH STRFTIME 3 2005-11-23 "GNU" "Linux Programmer's Manual"
@ -273,7 +273,8 @@ In SUSv2, the %S specified allowed a range of 00 to 61,
to allow for the theoretical possibility of a minute that
included a double leap second
(there never has been such a minute).
.SH GLIBC NOTES
.SH NOTES
.SS Glibc Notes
Glibc provides some extensions for conversion specifications.
(These extensions are not specified in POSIX.1-2001, but a few other
systems provide similar features.)

View File

@ -295,7 +295,37 @@ main(void)
exit(EXIT_SUCCESS);
}
.fi
.SH GLIBC NOTES
.SH NOTES
.LP
In principle, this function does not initialize \fBtm\fP but
only stores the values specified.
This means that \fBtm\fP should be initialized before the call.
Details differ a bit between different Unix systems.
The GNU libc implementation does not touch those fields which are not
explicitly specified, except that it recomputes the
.IR tm_wday
and
.IR tm_yday
field if any of the year, month, or day elements changed.
.PP
This function is available since libc 4.6.8.
Linux libc4 and libc5 includes define the prototype unconditionally;
glibc2 includes provide a prototype only when _XOPEN_SOURCE or _GNU_SOURCE
are defined.
.PP
Before libc 5.4.13 whitespace (and the 'n' and 't' specifications)
was not handled, no 'E' and 'O' locale modifier characters were accepted,
and the 'C' specification was a synonym for the 'c' specification.
.PP
The 'y' (year in century) specification is taken to specify a year
in the 20th century by libc4 and libc5.
It is taken to be a year
in the range 1950-2049 by glibc 2.0.
It is taken to be a year in
1969-2068 since glibc 2.1.
.\" In libc4 and libc5 the code for %I is broken (fixed in glibc;
.\" %OI was fixed in glibc 2.2.4).
.SS Glibc Notes
For reasons of symmetry, glibc tries to support for
.BR strptime ()
the same format characters as for
@ -342,36 +372,6 @@ Leap seconds are not counted unless leap second support is available.
.LP
The GNU libc implementation does not require whitespace between
two field descriptors.
.SH NOTES
.LP
In principle, this function does not initialize \fBtm\fP but
only stores the values specified.
This means that \fBtm\fP should be initialized before the call.
Details differ a bit between different Unix systems.
The GNU libc implementation does not touch those fields which are not
explicitly specified, except that it recomputes the
.IR tm_wday
and
.IR tm_yday
field if any of the year, month, or day elements changed.
.PP
This function is available since libc 4.6.8.
Linux libc4 and libc5 includes define the prototype unconditionally;
glibc2 includes provide a prototype only when _XOPEN_SOURCE or _GNU_SOURCE
are defined.
.PP
Before libc 5.4.13 whitespace (and the 'n' and 't' specifications)
was not handled, no 'E' and 'O' locale modifier characters were accepted,
and the 'C' specification was a synonym for the 'c' specification.
.PP
The 'y' (year in century) specification is taken to specify a year
in the 20th century by libc4 and libc5.
It is taken to be a year
in the range 1950-2049 by glibc 2.0.
It is taken to be a year in
1969-2068 since glibc 2.1.
.\" In libc4 and libc5 the code for %I is broken (fixed in glibc;
.\" %OI was fixed in glibc 2.2.4).
.SH "SEE ALSO"
.BR time (2),
.BR getdate (3),