This commit is contained in:
Michael Kerrisk 2007-06-22 17:42:06 +00:00
parent 682edefb1b
commit c3dfd2c880
16 changed files with 56 additions and 18 deletions

View File

@ -204,7 +204,9 @@ from the BSD function
Also System V has a function with the same name, but it is identical to Also System V has a function with the same name, but it is identical to
.BR setsid (2). .BR setsid (2).
.LP .LP
To get the prototypes under glibc, define both _XOPEN_SOURCE and To get the prototypes under glibc, define both
.B _XOPEN_SOURCE
and
_XOPEN_SOURCE_EXTENDED, or use "#define _XOPEN_SOURCE \fIn\fP" _XOPEN_SOURCE_EXTENDED, or use "#define _XOPEN_SOURCE \fIn\fP"
for some integer \fIn\fP larger than or equal to 500. for some integer \fIn\fP larger than or equal to 500.
.SH "SEE ALSO" .SH "SEE ALSO"

View File

@ -85,7 +85,9 @@ they also appear on HP-UX and some of the BSDs.
Under HP-UX and FreeBSD the prototype is found in Under HP-UX and FreeBSD the prototype is found in
.IR <unistd.h> . .IR <unistd.h> .
Under Linux the prototype is given by glibc since version 2.3.2 Under Linux the prototype is given by glibc since version 2.3.2
provided _GNU_SOURCE is defined. provided
.B _GNU_SOURCE
is defined.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR getresuid (2), .BR getresuid (2),
.BR getuid (2), .BR getuid (2),

View File

@ -160,7 +160,9 @@ This structure is of type
(thus, a cast is required), (thus, a cast is required),
defined in defined in
.I <sys/shm.h> .I <sys/shm.h>
if the _GNU_SOURCE feature test macro is defined: if the
.B _GNU_SOURCE
feature test macro is defined:
.nf .nf
.in +2n .in +2n
@ -194,7 +196,9 @@ structure whose fields contain information
about system resources consumed by shared memory. about system resources consumed by shared memory.
This structure is defined in This structure is defined in
.I <sys/shm.h> .I <sys/shm.h>
if the _GNU_SOURCE feature test macro is defined: if the
.B _GNU_SOURCE
feature test macro is defined:
.nf .nf
.in +2n .in +2n

View File

@ -72,7 +72,11 @@ Availability of the NAN macro can be tested using
and similarly for INFINITY, HUGE_VALF, HUGE_VALL. and similarly for INFINITY, HUGE_VALF, HUGE_VALL.
They will be defined by They will be defined by
.I <math.h> .I <math.h>
if _ISOC99_SOURCE or _GNU_SOURCE is defined, or __STDC_VERSION__ is defined if
.B _ISOC99_SOURCE
or
.B _GNU_SOURCE
is defined, or __STDC_VERSION__ is defined
and has a value not less than 199901L. and has a value not less than 199901L.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR fpclassify (3), .BR fpclassify (3),

View File

@ -82,7 +82,9 @@ The use of
.B sighandler_t .B sighandler_t
is a GNU extension; is a GNU extension;
this type is only defined if this type is only defined if
the _GNU_SOURCE feature test macro is defined. the
.B _GNU_SOURCE
feature test macro is defined.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR sigaction (2), .BR sigaction (2),
.BR signal (2), .BR signal (2),

View File

@ -372,7 +372,9 @@ and
.SH NOTES .SH NOTES
The symbols RTLD_DEFAULT and RTLD_NEXT are defined by The symbols RTLD_DEFAULT and RTLD_NEXT are defined by
.I <dlfcn.h> .I <dlfcn.h>
only when _GNU_SOURCE was defined before including it. only when
.B _GNU_SOURCE
was defined before including it.
.\" .LP .\" .LP
.\" The string returned by .\" The string returned by
.\" .BR dlerror () .\" .BR dlerror ()

View File

@ -192,7 +192,9 @@ to return immediately with the return value
Other return values could be associated with new actions in the future; Other return values could be associated with new actions in the future;
\fIfn\fP() should not return values other than those listed above. \fIfn\fP() should not return values other than those listed above.
The feature test macro _GNU_SOURCE must be defined in order to The feature test macro
.B _GNU_SOURCE
must be defined in order to
obtain the definition of \fBFTW_ACTIONRETVAL\fP from \fI<ftw.h>\fP. obtain the definition of \fBFTW_ACTIONRETVAL\fP from \fI<ftw.h>\fP.
.RE .RE
.TP .TP

View File

@ -72,7 +72,9 @@ struct qelem {
.fi .fi
.RE .RE
This is still what you will get if _GNU_SOURCE is defined before This is still what you will get if
.B _GNU_SOURCE
is defined before
including \fI<search.h>\fP. including \fI<search.h>\fP.
The location of the prototypes for these functions differs among several The location of the prototypes for these functions differs among several

View File

@ -116,7 +116,9 @@ and
are defined by glibc, but in are defined by glibc, but in
.IR <stdio.h> . .IR <stdio.h> .
.\" and only when _BSD_SOURCE is defined. .\" and only when _BSD_SOURCE is defined.
.\" When _GNU_SOURCE is defined, the symbols .\" When
.B _GNU_SOURCE
is defined, the symbols
.\" .I _sys_nerr .\" .I _sys_nerr
.\" and .\" and
.\" .I _sys_errlist .\" .I _sys_errlist

View File

@ -118,7 +118,9 @@ Everybody agrees that
.BR posix_memalign () .BR posix_memalign ()
is declared in \fI<stdlib.h>\fP. is declared in \fI<stdlib.h>\fP.
In order to declare it, glibc needs In order to declare it, glibc needs
_GNU_SOURCE defined, or _XOPEN_SOURCE defined to a value not less than 600. _GNU_SOURCE defined, or
.B _XOPEN_SOURCE
defined to a value not less than 600.
On some systems On some systems
.BR memalign () .BR memalign ()

View File

@ -80,8 +80,12 @@ Libc4 and libc5 only know about the BSD version.
Glibc uses the BSD version if the _BSD_SOURCE feature test macro is Glibc uses the BSD version if the _BSD_SOURCE feature test macro is
defined and none of _POSIX_SOURCE, _POSIX_C_SOURCE, _XOPEN_SOURCE, defined and none of _POSIX_SOURCE, _POSIX_C_SOURCE, _XOPEN_SOURCE,
_GNU_SOURCE, or _SVID_SOURCE is defined. _GNU_SOURCE, or
The System V version is used if _XOPEN_SOURCE is defined. .B _SVID_SOURCE
is defined.
The System V version is used if
.B _XOPEN_SOURCE
is defined.
.\" .\"
.\" For the BSD version, one usually uses a zero .\" For the BSD version, one usually uses a zero
.\" .I sigmask .\" .I sigmask

View File

@ -93,7 +93,9 @@ is not a valid signal.
POSIX.1-2001. POSIX.1-2001.
.SH NOTES .SH NOTES
.SS Glibc Notes .SS Glibc Notes
If the _GNU_SOURCE feature test macro is defined, then \fI<signal.h>\fP If the
.B _GNU_SOURCE
feature test macro is defined, then \fI<signal.h>\fP
exposes three other functions for manipulating signal exposes three other functions for manipulating signal
sets. sets.
.TP .TP

View File

@ -74,7 +74,9 @@ thread safe.
This function is available in two versions: This function is available in two versions:
an XSI-compliant version specified in POSIX.1-2001, an XSI-compliant version specified in POSIX.1-2001,
and a GNU-specific version (available since glibc 2.0). and a GNU-specific version (available since glibc 2.0).
If _XOPEN_SOURCE is defined with the value 600, If
.B _XOPEN_SOURCE
is defined with the value 600,
then the XSI-compliant version is provided, then the XSI-compliant version is provided,
otherwise the GNU-specific version is provided. otherwise the GNU-specific version is provided.

View File

@ -288,7 +288,9 @@ field if any of the year, month, or day elements changed.
.PP .PP
This function is available since libc 4.6.8. This function is available since libc 4.6.8.
Linux libc4 and libc5 includes define the prototype unconditionally; Linux libc4 and libc5 includes define the prototype unconditionally;
glibc2 includes provide a prototype only when _XOPEN_SOURCE or _GNU_SOURCE glibc2 includes provide a prototype only when
.B _XOPEN_SOURCE
or _GNU_SOURCE
are defined. are defined.
.PP .PP
Before libc 5.4.13 whitespace (and the 'n' and 't' specifications) Before libc 5.4.13 whitespace (and the 'n' and 't' specifications)

View File

@ -79,7 +79,9 @@ The use of
.B sighandler_t .B sighandler_t
is a GNU extension; is a GNU extension;
this type is only defined if this type is only defined if
the _GNU_SOURCE feature test macro is defined. the
.B _GNU_SOURCE
feature test macro is defined.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR sigaction (2), .BR sigaction (2),
.BR signal (2), .BR signal (2),

View File

@ -317,7 +317,9 @@ Input is converted to lowercase, except for characters preceded by \\.
On output, uppercase characters are preceded by \\ and lowercase On output, uppercase characters are preceded by \\ and lowercase
characters are converted to uppercase. characters are converted to uppercase.
.\" [requires _BSD_SOURCE or _SVID_SOURCE or _XOPEN_SOURCE] .\" [requires _BSD_SOURCE or _SVID_SOURCE or _XOPEN_SOURCE]
.\" glibc is probably now wrong to allow _XOPEN_SOURCE to expose XCASE. .\" glibc is probably now wrong to allow
.B _XOPEN_SOURCE
to expose XCASE.
.TP .TP
.B ECHO .B ECHO
Echo input characters. Echo input characters.