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 .SH VERSIONS
.BR epoll_pwait () .BR epoll_pwait ()
was added to Linux in kernel 2.6.19. was added to Linux in kernel 2.6.19.
.SH GLIBC NOTES .SH NOTES
.SS Glibc Notes
Support for Support for
.BR epoll_wait () .BR epoll_pwait ()
is provided starting with glibc 2.6. is provided starting with glibc 2.6.
.SH "RETURN VALUE" .SH "RETURN VALUE"
When successful, When successful,

View File

@ -119,10 +119,7 @@ See
.BR openat (2) .BR openat (2)
for an explanation of the need for for an explanation of the need for
.BR faccessat (). .BR faccessat ().
.SH "CONFORMING TO" .SS Glibc Notes
This system call is non-standard but is proposed
for inclusion in a future revision of POSIX.1.
.SH GLIBC NOTES
The The
.B AT_EACCESS .B AT_EACCESS
and and
@ -135,6 +132,9 @@ to determine access permissions.
.SH VERSIONS .SH VERSIONS
.BR faccessat () .BR faccessat ()
was added to Linux in kernel 2.6.16. 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" .SH "SEE ALSO"
.BR access (2), .BR access (2),
.BR openat (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 This system call is non-standard but is proposed
for inclusion in a future revision of POSIX.1. for inclusion in a future revision of POSIX.1.
A similar system call exists on Solaris. A similar system call exists on Solaris.
.SH GLIBC NOTES .SH NOTES
.SS Glibc Notes
If If
.I pathname .I pathname
is NULL, then the glibc is NULL, then the glibc

View File

@ -89,7 +89,7 @@ but not
SUSv2 guarantees that `Host names are limited to 255 bytes'. SUSv2 guarantees that `Host names are limited to 255 bytes'.
POSIX.1-2001 guarantees that `Host names (not including POSIX.1-2001 guarantees that `Host names (not including
the terminating null byte) are limited to HOST_NAME_MAX bytes'. the terminating null byte) are limited to HOST_NAME_MAX bytes'.
.SH "GLIBC NOTES" .SS Glibc Notes
The GNU C library implements The GNU C library implements
.BR gethostname () .BR gethostname ()
as a library function that calls 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 .\" .PP
.\" Making encrypted data computed using crypt() publicly available has .\" Making encrypted data computed using crypt() publicly available has
.\" to be considered insecure for the given reasons. .\" 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. The glibc2 version of this function has the following additional features.
If If
.I salt .I salt

View File

@ -72,7 +72,8 @@ Some other systems have an
.\" e.g., FreeBSD 6.1. .\" e.g., FreeBSD 6.1.
.BR eaccess () .BR eaccess ()
function. function.
.SH "GLIBC NOTES" .SH NOTES
.SS Glibc Notes
The The
.BR eaccess () .BR eaccess ()
function was added to glibc in version 2.4. 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. .\" Earlier seven of these functions were listed as returning void.
.\" This was corrected in Corrigendum 1 (ISO/IEC 9899:1999/Cor.1:2001(E)) .\" This was corrected in Corrigendum 1 (ISO/IEC 9899:1999/Cor.1:2001(E))
.\" of the C99 Standard. .\" of the C99 Standard.
.SH GLIBC NOTES .SH NOTES
.SS Glibc Notes
If possible, the GNU C Library defines a macro If possible, the GNU C Library defines a macro
.B FE_NOMASK_ENV .B FE_NOMASK_ENV
which represents an environment where every exception raised causes a which represents an environment where every exception raised causes a

View File

@ -236,7 +236,8 @@ functions conform to C89.
The The
.BR fdopen () .BR fdopen ()
function conforms to POSIX.1-1990. 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 The GNU C library allows the following extensions for the string specified in
.IR mode : .IR mode :
.TP .TP

View File

@ -110,7 +110,8 @@ and
return a pointer to a \fBstruct utmp\fP on success, and NULL on failure. 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 This \fBstruct utmp\fP is allocated in static storage, and may be
overwritten by subsequent calls. overwritten by subsequent calls.
.SH GLIBC NOTES .SH NOTES
.SS Glibc Notes
The above functions are not thread-safe. The above functions are not thread-safe.
Glibc adds reentrant versions Glibc adds reentrant versions
.sp .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. if preceded by a 0 and as hexadecimal if preceded by 0x.
For example, \fBinet_aton("226.000.000.037", &t)\fP will 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. 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 In order to expose the declaration of
.BR inet_aton (), .BR inet_aton (),
one of the feature test macros _BSD_SOURCE, _SVID_SOURCE, or 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. is not a valid signal.
.SH "CONFORMING TO" .SH "CONFORMING TO"
POSIX.1-2001. POSIX.1-2001.
.SH "GLIBC NOTES" .SH NOTES
.SS Glibc Notes
If the _GNU_SOURCE feature test macro is defined, then <signal.h> If the _GNU_SOURCE feature test macro is defined, then <signal.h>
exposes three other functions for manipulating signal exposes three other functions for manipulating signal
sets. sets.

View File

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

View File

@ -295,7 +295,37 @@ main(void)
exit(EXIT_SUCCESS); exit(EXIT_SUCCESS);
} }
.fi .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 For reasons of symmetry, glibc tries to support for
.BR strptime () .BR strptime ()
the same format characters as for the same format characters as for
@ -342,36 +372,6 @@ Leap seconds are not counted unless leap second support is available.
.LP .LP
The GNU libc implementation does not require whitespace between The GNU libc implementation does not require whitespace between
two field descriptors. 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" .SH "SEE ALSO"
.BR time (2), .BR time (2),
.BR getdate (3), .BR getdate (3),