From cc4615cc788aa749f34483abd33ba2b4a31d30f0 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Sun, 8 Jul 2007 12:11:40 +0000 Subject: [PATCH] Added/updated glibc feature test macro requirements --- man2/_exit.2 | 11 ++++++++++- man2/acct.2 | 10 +++++++++- man2/brk.2 | 13 ++++++++++++- man2/chdir.2 | 10 +++++++++- man2/chmod.2 | 14 +++++++++----- man2/chown.2 | 16 ++++++++++------ man2/clone.2 | 5 ++++- man2/fdatasync.2 | 10 +++++++++- man2/fsync.2 | 13 ++++++++++++- man2/getdomainname.2 | 13 ++++++++++++- man2/getdtablesize.2 | 10 +++++++++- man2/getgroups.2 | 16 +++++++++------- man2/gethostid.2 | 12 +++++++++++- man2/gethostname.2 | 15 ++++++++++++++- man2/getpagesize.2 | 10 +++++++++- man2/getsid.2 | 22 +++++++++++----------- man2/gettimeofday.2 | 10 +++++++++- man2/kill.2 | 10 +++++++++- man2/killpg.2 | 10 +++++++++- man2/madvise.2 | 10 +++++++++- man2/mincore.2 | 10 +++++++++- man2/mknod.2 | 10 +++++++++- man2/nanosleep.2 | 14 ++++++++++---- man2/nice.2 | 10 +++++++++- man2/readahead.2 | 3 ++- man2/readlink.2 | 12 +++++++++++- man2/select.2 | 24 +++++++++++++++--------- man2/semop.2 | 10 +++++++++- man2/seteuid.2 | 13 ++++++++++++- man2/setpgid.2 | 8 +++++--- man2/setresuid.2 | 7 ++----- man2/setreuid.2 | 11 ++++++++++- man2/sigaltstack.2 | 13 ++++++++++++- man2/sigqueue.2 | 10 +++++++++- man2/sigwaitinfo.2 | 11 ++++++++++- man2/stat.2 | 4 ++-- man2/stime.2 | 21 ++++++++++----------- man2/symlink.2 | 12 +++++++++++- man2/sync.2 | 10 +++++++++- man2/syscall.2 | 9 ++++----- man2/truncate.2 | 12 +++++++++++- man2/unshare.2 | 5 ++++- man2/vfork.2 | 10 +++++++++- man2/vhangup.2 | 12 +++++++++++- man2/wait.2 | 10 +++++++++- man2/wait4.2 | 16 ++++++++++++---- man3/INFINITY.3 | 4 ++-- man3/a64l.3 | 11 ++++++++++- man3/abs.3 | 11 ++++++++++- man3/acosh.3 | 15 ++++++++++++++- man3/addseverity.3 | 15 ++++++++++----- man3/adjtime.3 | 13 +++++++++---- man3/asinh.3 | 15 ++++++++++++++- man3/atanh.3 | 15 ++++++++++++++- man3/atoi.3 | 13 ++++++++++++- man3/cbrt.3 | 15 ++++++++++++++- man3/cfree.3 | 10 +++++++++- man3/clearenv.3 | 10 +++++++++- man3/clock_getres.3 | 20 +++++++++++++++----- man3/confstr.3 | 17 ++++++++++------- man3/copysign.3 | 15 ++++++++++++++- man3/ctermid.3 | 11 ++++++++++- man3/ctime.3 | 14 +++++++++++++- man3/daemon.3 | 10 +++++++++- man3/dirfd.3 | 10 +++++++++- man3/div.3 | 11 ++++++++++- man3/drand48.3 | 21 ++++++++++++++++++++- man3/drand48_r.3 | 21 ++++++++++++++++++++- man3/dysize.3 | 16 ++++++++++------ man3/ecvt.3 | 11 ++++++++++- man3/ecvt_r.3 | 14 +++++++++++++- man3/erf.3 | 19 ++++++++++++++++++- man3/euidaccess.3 | 3 ++- man3/exp2.3 | 17 +++++++++++++++-- man3/expm1.3 | 15 ++++++++++++++- man3/ferror.3 | 10 +++++++++- man3/fexecve.3 | 3 ++- man3/fgetgrent.3 | 20 +++++++++++++------- man3/fgetpwent.3 | 10 +++++++++- man3/finite.3 | 42 ++++++++++++++++++++++++------------------ man3/flockfile.3 | 12 +++++++++++- man3/fopen.3 | 10 +++++++++- man3/fpclassify.3 | 27 +++++++++++++++++++++++++-- man3/futimes.3 | 10 +++++++++- man3/fwide.3 | 11 ++++++++++- man3/gamma.3 | 14 +++++++++++++- man3/gcvt.3 | 10 +++++++++- man3/getcwd.3 | 24 ++++++++++++++---------- man3/getdate.3 | 6 ++---- man3/getdirentries.3 | 16 ++++++++++------ man3/getgrent.3 | 14 +++++++++++++- man3/getgrent_r.3 | 20 +++++++++++++++----- man3/getgrouplist.3 | 14 +++++++++++--- man3/gethostbyname.3 | 15 ++++++++++++++- man3/getlogin.3 | 13 ++++++++++++- man3/getmntent.3 | 12 +++++++++--- man3/getpw.3 | 3 ++- man3/getpwent.3 | 14 +++++++++++++- man3/getpwent_r.3 | 19 ++++++++++++++----- man3/getpwnam.3 | 13 ++++++++++++- man3/getspnam.3 | 20 +++++++++++++++----- man3/getumask.3 | 4 +++- man3/getusershell.3 | 14 +++++++++++++- man3/gsignal.3 | 12 +++++++++++- man3/hypot.3 | 15 ++++++++++++++- man3/inet.3 | 20 ++++++++++---------- man3/initgroups.3 | 16 +++++++++------- man3/insque.3 | 18 ++++++++++++++---- man3/isalpha.3 | 16 +++++++++++++++- man3/iswblank.3 | 13 ++++++++++++- man3/j0.3 | 15 +++++++++++---- man3/lgamma.3 | 30 +++++++++++++++++++++++++++--- man3/lockf.3 | 10 +++++++++- man3/log1p.3 | 17 +++++++++++++++-- man3/log2.3 | 17 +++++++++++++++-- man3/logb.3 | 15 ++++++++++++++- man3/longjmp.3 | 10 +++++++++- man3/lrint.3 | 15 +++++++++++++-- man3/lround.3 | 15 +++++++++++++-- man3/mbsnrtowcs.3 | 3 ++- man3/memfrob.3 | 3 ++- man3/mkdtemp.3 | 10 +++++++++- man3/mkstemp.3 | 10 +++++++++- man3/mktemp.3 | 10 +++++++++- man3/nan.3 | 13 ++++++++++++- man3/nextafter.3 | 13 ++++++++++++- man3/on_exit.3 | 10 +++++++++- man3/perror.3 | 15 ++++++++++++--- man3/posix_memalign.3 | 21 ++++++++++++--------- man3/posix_openpt.3 | 15 +++++++++++---- man3/printf.3 | 19 ++++++++++++++++--- man3/profil.3 | 10 +++++++++- man3/psignal.3 | 13 ++++++++++++- man3/putenv.3 | 10 +++++++++- man3/putpwent.3 | 10 +++++++++- man3/qecvt.3 | 13 ++++++++++++- man3/rand.3 | 10 +++++++++- man3/random.3 | 15 ++++++++++++++- man3/rcmd.3 | 2 ++ man3/realpath.3 | 11 ++++++++++- man3/remainder.3 | 20 +++++++++++++++++++- man3/remquo.3 | 22 +++++++++++++++++----- man3/rexec.3 | 1 + man3/rint.3 | 21 ++++++++++++++++++++- man3/round.3 | 17 +++++++++++++++-- man3/rpmatch.3 | 14 ++++++++++---- man3/scalb.3 | 26 +++++++++++++++++++++++++- man3/scandir.3 | 17 +++++++++++++++-- man3/scanf.3 | 15 ++++++++++++++- man3/seekdir.3 | 10 +++++++++- man3/sem_wait.3 | 17 +++++++++++------ man3/setbuf.3 | 11 ++++++++++- man3/setenv.3 | 13 ++++++++++++- man3/setjmp.3 | 10 +++++++++- man3/setnetgrent.3 | 16 +++++++++++++++- man3/siginterrupt.3 | 10 +++++++++- man3/significand.3 | 14 +++++++++++++- man3/sigvec.3 | 14 ++++++++++---- man3/sockatmark.3 | 12 +++++++++++- man3/strdup.3 | 22 +++++++++++++++------- man3/strerror.3 | 39 ++++++++++++++++++++++++--------------- man3/strsep.3 | 10 +++++++++- man3/strtod.3 | 20 +++++++++++++------- man3/strtok.3 | 12 +++++++++++- man3/strtol.3 | 13 ++++++++++++- man3/strtoul.3 | 13 ++++++++++++- man3/syslog.3 | 13 +++++++++---- man3/tcgetsid.3 | 4 +++- man3/telldir.3 | 10 +++++++++- man3/tempnam.3 | 10 +++++++++- man3/termios.3 | 13 +++++++++++-- man3/tgamma.3 | 17 +++++++++++++++-- man3/timegm.3 | 12 +++++++++++- man3/toascii.3 | 11 ++++++++++- man3/trunc.3 | 17 +++++++++++++++-- man3/ttyslot.3 | 14 ++++++++++++-- man3/tzset.3 | 19 ++++++++++++++++++- man3/ualarm.3 | 12 +++++++++--- man3/unlocked_stdio.3 | 4 ++-- man3/usleep.3 | 13 +++++++++---- man3/wcscasecmp.3 | 3 ++- man3/wcsncasecmp.3 | 3 ++- man3/wcsnlen.3 | 3 ++- man3/wcsnrtombs.3 | 3 ++- man3/wcswidth.3 | 3 ++- man3/wordexp.3 | 11 ++++++++++- man3/wprintf.3 | 21 ++++++++++++++++++--- 187 files changed, 2008 insertions(+), 426 deletions(-) diff --git a/man2/_exit.2 b/man2/_exit.2 index f4b161ef2..f0bd16cd3 100644 --- a/man2/_exit.2 +++ b/man2/_exit.2 @@ -26,7 +26,7 @@ .\" Modified Wed Jul 21 23:02:38 1993 by Rik Faith .\" Modified 2001-11-17, aeb .\" -.TH _EXIT 2 2001-11-17 "Linux" "Linux Programmer's Manual" +.TH _EXIT 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME _exit, _Exit \- terminate the current process .SH SYNOPSIS @@ -37,6 +37,15 @@ _exit, _Exit \- terminate the current process .B #include .sp .BI "void _Exit(int " status ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR _Exit (): +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 .SH DESCRIPTION The function .BR _exit () diff --git a/man2/acct.2 b/man2/acct.2 index 6d7bd143f..232e1ef13 100644 --- a/man2/acct.2 +++ b/man2/acct.2 @@ -29,7 +29,7 @@ .\" Modified 1998-11-04 by Tigran Aivazian .\" Modified 2004-05-27, 2004-06-17, 2004-06-23 by Michael Kerrisk .\" -.TH ACCT 2 2004-06-23 "Linux" "Linux Programmer's Manual" +.TH ACCT 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME acct \- switch process accounting on or off .SH SYNOPSIS @@ -40,6 +40,14 @@ acct \- switch process accounting on or off .BI "int acct(const char *" filename ); .fi .ad b +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR acct (): +_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) .SH DESCRIPTION When called with the name of an existing file as argument, accounting is turned on, records for each terminating process are appended to diff --git a/man2/brk.2 b/man2/brk.2 index dc0556473..2efaabbdf 100644 --- a/man2/brk.2 +++ b/man2/brk.2 @@ -27,7 +27,7 @@ .\" Modified Wed Jul 21 19:52:58 1993 by Rik Faith .\" Modified Sun Aug 21 17:40:38 1994 by Rik Faith .\" -.TH BRK 2 2003-11-01 "Linux" "Linux Programmer's Manual" +.TH BRK 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME brk, sbrk \- change data segment size .SH SYNOPSIS @@ -36,6 +36,17 @@ brk, sbrk \- change data segment size .BI "int brk(void *" end_data_segment ); .sp .BI "void *sbrk(intptr_t " increment ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR brk (), +.BR sbrk (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.ad b .SH DESCRIPTION .BR brk () sets the end of the data segment to the value specified by diff --git a/man2/chdir.2 b/man2/chdir.2 index 602683210..7650160fc 100644 --- a/man2/chdir.2 +++ b/man2/chdir.2 @@ -30,7 +30,7 @@ .\" Modified 1997-08-21 by Joseph S. Myers .\" Modified 2004-06-23 by Michael Kerrisk .\" -.TH CHDIR 2 2007-06-18 "Linux" "Linux Programmer's Manual" +.TH CHDIR 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME chdir, fchdir \- change working directory .SH SYNOPSIS @@ -39,6 +39,14 @@ chdir, fchdir \- change working directory .BI "int chdir(const char *" path ); .br .BI "int fchdir(int " fd ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR fchdir (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION .BR chdir () changes the current working directory pf the calling process to the diff --git a/man2/chmod.2 b/man2/chmod.2 index 6c046fd5a..888e59594 100644 --- a/man2/chmod.2 +++ b/man2/chmod.2 @@ -28,19 +28,23 @@ .\" : NFS details .\" Modified 2004-06-23 by Michael Kerrisk .\" -.TH CHMOD 2 2004-07-08 "Linux" "Linux Programmer's Manual" +.TH CHMOD 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME chmod, fchmod \- change permissions of a file .SH SYNOPSIS .B #include .sp .BI "int chmod(const char *" path ", mode_t " mode ); -.sp -.BR "#define _XOPEN_SOURCE 500 " "/* or: " "#define _BSD_SOURCE " */ .br -.B #include -.sp .BI "int fchmod(int " fildes ", mode_t " mode ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR fchmod (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION The mode of the file given by .I path diff --git a/man2/chown.2 b/man2/chown.2 index 38b0a1bc7..f95a85829 100644 --- a/man2/chown.2 +++ b/man2/chown.2 @@ -32,7 +32,7 @@ .\" Modified 2004-06-23 by Michael Kerrisk .\" 2007-07-08, mtk, added an example program; updated SYNOPSIS .\" -.TH CHOWN 2 2007-07-08 "Linux" "Linux Programmer's Manual" +.TH CHOWN 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME chown, fchown, lchown \- change ownership of a file .SH SYNOPSIS @@ -40,14 +40,18 @@ chown, fchown, lchown \- change ownership of a file .sp .BI "int chown(const char *" path ", uid_t " owner ", gid_t " group ); .br -.sp -.BR "#define _XOPEN_SOURCE 500 " "/* or: " "#define _BSD_SOURCE " */ -.br -.B #include -.sp .BI "int fchown(int " fd ", uid_t " owner ", gid_t " group ); .br .BI "int lchown(const char *" path ", uid_t " owner ", gid_t " group ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR fchown (), +.BR lchown (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION These system calls change the owner and group of the file specified by .I path diff --git a/man2/clone.2 b/man2/clone.2 index 7cc2337df..e5c2b7abe 100644 --- a/man2/clone.2 +++ b/man2/clone.2 @@ -35,11 +35,14 @@ .\" FIXME Document CLONE_NEWIPC, which is new in 2.6.18 .\" FIXME Document CLONE_NEWUTS, which is new in 2.6.19 .\" -.TH CLONE 2 2007-06-01 "Linux" "Linux Programmer's Manual" +.TH CLONE 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME clone, __clone2 \- create a child process .SH SYNOPSIS .nf +.B #define _GNU_SOURCE +.\" Actually _BSD_SOURCE || _SVID_SOURCE +.\" See http://sources.redhat.com/bugzilla/show_bug.cgi?id=4749 .B #include .BI "int clone(int (*" "fn" ")(void *), void *" child_stack , diff --git a/man2/fdatasync.2 b/man2/fdatasync.2 index d6521a3bb..043d8e228 100644 --- a/man2/fdatasync.2 +++ b/man2/fdatasync.2 @@ -28,13 +28,21 @@ .\" 1996-04-12 Andries Brouwer .\" 1996-04-13 Markus Kuhn .\" -.TH FDATASYNC 2 1996-04-13 "Linux" "Linux Programmer's Manual" +.TH FDATASYNC 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME fdatasync \- synchronize a file's in-core data with that on disk .SH SYNOPSIS .B #include .sp .BI "int fdatasync(int " fd ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR fdatasync (): +_POSIX_C_SOURCE\ >=\ 199309L || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION .BR fdatasync () flushes all data buffers of a file to disk (before the system diff --git a/man2/fsync.2 b/man2/fsync.2 index fed0f0624..d56584345 100644 --- a/man2/fsync.2 +++ b/man2/fsync.2 @@ -34,7 +34,7 @@ .\" Fix description to describe what it really does; add a few caveats. .\" 2006-04-28, mtk, substantial rewrite of various parts. .\" -.TH FSYNC 2 2006-04-28 "Linux" "Linux Programmer's Manual" +.TH FSYNC 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME fsync, fdatasync \- synchronize a file's in-core state with storage device .SH SYNOPSIS @@ -43,6 +43,17 @@ fsync, fdatasync \- synchronize a file's in-core state with storage device .BI "int fsync(int " fd ); .sp .BI "int fdatasync(int " fd ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR fsync (): +_BSD_SOURCE || _XOPEN_SOURCE +.br +.BR fdatasync (): +_POSIX_C_SOURCE\ >=\ 199309L || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION .BR fsync () transfers ("flushes") all modified in-core data of diff --git a/man2/getdomainname.2 b/man2/getdomainname.2 index 2c72fec5c..7036f8270 100644 --- a/man2/getdomainname.2 +++ b/man2/getdomainname.2 @@ -25,7 +25,7 @@ .\" Modified 1997-08-25 by Nicolás Lichtmaier .\" Modified 2004-06-17 by Michael Kerrisk .\" -.TH GETDOMAINNAME 2 2004-06-17 "Linux" "Linux Programmer's Manual" +.TH GETDOMAINNAME 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME getdomainname, setdomainname \- get/set domain name .SH SYNOPSIS @@ -34,6 +34,17 @@ getdomainname, setdomainname \- get/set domain name .BI "int getdomainname(char *" name ", size_t " len ); .br .BI "int setdomainname(const char *" name ", size_t " len ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR getdomainame (), +.BR setdomainame (): +_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) +.ad b .SH DESCRIPTION These functions are used to access or to change the domain name of the current processor. diff --git a/man2/getdtablesize.2 b/man2/getdtablesize.2 index 07d7e5f18..2b45d86f7 100644 --- a/man2/getdtablesize.2 +++ b/man2/getdtablesize.2 @@ -24,13 +24,21 @@ .\" .\" Modified 2002-04-15 by Roger Luethi and aeb .\" -.TH GETDTABLESIZE 2 2002-04-15 "Linux" "Linux Programmer's Manual" +.TH GETDTABLESIZE 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME getdtablesize \- get descriptor table size .SH SYNOPSIS .B #include .sp .B int getdtablesize(void); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR getdtablesize (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION .BR getdtablesize () returns the maximum number of files a process can have open, diff --git a/man2/getgroups.2 b/man2/getgroups.2 index 6860b3600..1dfc8f9cb 100644 --- a/man2/getgroups.2 +++ b/man2/getgroups.2 @@ -26,7 +26,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk .\" Added notes on capability requirements .\" -.TH GETGROUPS 2 2004-05-27 "Linux" "Linux Programmer's Manual" +.TH GETGROUPS 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME getgroups, setgroups \- get/set list of supplementary group IDs .SH SYNOPSIS @@ -39,6 +39,14 @@ getgroups, setgroups \- get/set list of supplementary group IDs .B #include .sp .BI "int setgroups(size_t " size ", const gid_t *" list ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR setgroups (): +_BSD_SOURCE .SH DESCRIPTION .TP .BR getgroups () @@ -124,12 +132,6 @@ The maximum number of supplementary group IDs can be found using The maximal return value of .BR getgroups () cannot be larger than one more than the value obtained this way. -.LP -The prototype for -.BR setgroups () -is only available if -.B _BSD_SOURCE -is defined. .SH "SEE ALSO" .BR getgid (2), .BR setgid (2), diff --git a/man2/gethostid.2 b/man2/gethostid.2 index 0e06bf1f0..dea1b1be3 100644 --- a/man2/gethostid.2 +++ b/man2/gethostid.2 @@ -26,7 +26,7 @@ .\" Portions Copyright 1993 Mitchum DSouza .\" .\" Modified Tue Oct 22 00:22:35 EDT 1996 by Eric S. Raymond -.TH GETHOSTID 2 2007-06-15 "Linux" "Linux Programmer's Manual" +.TH GETHOSTID 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME gethostid, sethostid \- get or set the unique identifier of the current host .SH SYNOPSIS @@ -35,6 +35,16 @@ gethostid, sethostid \- get or set the unique identifier of the current host .B long gethostid(void); .br .BI "int sethostid(long " hostid ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR sethostid (): +_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) +.ad b .SH DESCRIPTION Get or set a unique 32-bit identifier for the current machine. The 32-bit identifier is intended to be unique among all UNIX systems in diff --git a/man2/gethostname.2 b/man2/gethostname.2 index 0a981182f..76431e070 100644 --- a/man2/gethostname.2 +++ b/man2/gethostname.2 @@ -28,7 +28,7 @@ .\" Modified 2000-06-04, 2001-12-15 by aeb .\" Modified 2004-06-17 by mtk .\" -.TH GETHOSTNAME 2 2004-06-17 "Linux" "Linux Programmer's Manual" +.TH GETHOSTNAME 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME gethostname, sethostname \- get/set host name .SH SYNOPSIS @@ -37,6 +37,19 @@ gethostname, sethostname \- get/set host name .BI "int gethostname(char *" name ", size_t " len ); .br .BI "int sethostname(const char *" name ", size_t " len ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR gethostname (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.br +.BR sethostname (): +_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) +.ad b .SH DESCRIPTION These system calls are used to access or to change the host name of the current processor. diff --git a/man2/getpagesize.2 b/man2/getpagesize.2 index 1874b461a..6fa841489 100644 --- a/man2/getpagesize.2 +++ b/man2/getpagesize.2 @@ -20,13 +20,21 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH GETPAGESIZE 2 2001-12-21 "Linux" "Linux Programmer's Manual" +.TH GETPAGESIZE 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME getpagesize \- get memory page size .SH SYNOPSIS .B #include .sp .B int getpagesize(void); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR getpagesize (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION The function .BR getpagesize () diff --git a/man2/getsid.2 b/man2/getsid.2 index 515ddfb89..1d00fe24b 100644 --- a/man2/getsid.2 +++ b/man2/getsid.2 @@ -22,13 +22,21 @@ .\" .\" Modified Thu Oct 31 14:18:40 1996 by Eric S. Raymond .\" Modified 2001-12-17, aeb -.TH GETSID 2 2001-12-17 "Linux" "Linux Programmer's Manual" +.TH GETSID 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME getsid \- get session ID .SH SYNOPSIS .B #include .sp .BI "pid_t getsid(pid_t" " pid" ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR getsid (): +_XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION .I getsid(0) returns the session ID of the calling process. @@ -39,7 +47,7 @@ returns the session ID of the process with process ID session leader.) .SH RETURN VALUE On success, a session ID is returned. -On error, (pid_t) \-1 will be returned, and +On error, \fI(pid_t) \-1\fP will be returned, and .I errno is set appropriately. .SH ERRORS @@ -62,15 +70,7 @@ Linux does not return .LP Linux has this system call since Linux 1.3.44. There is libc support since libc 5.2.19. -.LP -To get the prototype under glibc, define both -.BR _XOPEN_SOURCE -and -.BR _XOPEN_SOURCE_EXTENDED , -or use "#define _XOPEN_SOURCE \fIn\fP" -for some integer \fIn\fP larger than or equal to 500. .SH "SEE ALSO" .BR getpgid (2), .BR setsid (2), -.BR credentials (7), -.BR feature_test_macros (7) +.BR credentials (7) diff --git a/man2/gettimeofday.2 b/man2/gettimeofday.2 index 8321db164..6ae7fadca 100644 --- a/man2/gettimeofday.2 +++ b/man2/gettimeofday.2 @@ -37,7 +37,7 @@ .\" Modified, 2004-05-27 by Michael Kerrisk .\" Added notes on capability requirement. .\" -.TH GETTIMEOFDAY 2 2004-05-27 "Linux" "Linux Programmer's Manual" +.TH GETTIMEOFDAY 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME gettimeofday, settimeofday \- get / set time .SH SYNOPSIS @@ -47,6 +47,14 @@ gettimeofday, settimeofday \- get / set time .br .BI "int settimeofday(const struct timeval *" tv .BI ", const struct timezone *" tz ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR settimeofday (): +_BSD_SOURCE .SH DESCRIPTION The functions .BR gettimeofday () diff --git a/man2/kill.2 b/man2/kill.2 index 2a313c389..cd669d7e2 100644 --- a/man2/kill.2 +++ b/man2/kill.2 @@ -41,7 +41,7 @@ .\" Modified 2004-06-24 by aeb .\" Modified, 2004-11-30, after idea from emmanuel.colbus@ensimag.imag.fr .\" -.TH KILL 2 2004-06-24 "Linux" "Linux Programmer's Manual" +.TH KILL 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME kill \- send signal to a process .SH SYNOPSIS @@ -52,6 +52,14 @@ kill \- send signal to a process .sp .BI "int kill(pid_t " pid ", int " sig ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR kill (): +_POSIX_C_SOURCE || _XOPEN_SOURCE .SH DESCRIPTION The .BR kill () diff --git a/man2/killpg.2 b/man2/killpg.2 index 6b53ca168..0fbe2f685 100644 --- a/man2/killpg.2 +++ b/man2/killpg.2 @@ -37,13 +37,21 @@ .\" Added notes on CAP_KILL .\" Modified 2004-06-21 by aeb .\" -.TH KILLPG 2 2007-06-18 "Linux" "Linux Programmer's Manual" +.TH KILLPG 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME killpg \- send signal to a process group .SH SYNOPSIS .B #include .sp .BI "int killpg(int " pgrp ", int " sig ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR killpg (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION .BR killpg () sends the signal diff --git a/man2/madvise.2 b/man2/madvise.2 index 460369d5c..22b546b24 100644 --- a/man2/madvise.2 +++ b/man2/madvise.2 @@ -26,7 +26,7 @@ .\" Modified, 25 Feb 2002, Michael Kerrisk, .\" Added notes on MADV_DONTNEED .\" -.TH MADVISE 2 2001-06-10 "Linux" "Linux Programmer's Manual" +.TH MADVISE 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME madvise \- give advice about use of memory .SH SYNOPSIS @@ -34,6 +34,14 @@ madvise \- give advice about use of memory .B #include .sp .BI "int madvise(void *" start ", size_t " length ", int " advice ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR madvise (): +_BSD_SOURCE .SH DESCRIPTION The .BR madvise () diff --git a/man2/mincore.2 b/man2/mincore.2 index 71a98f287..0710b23fd 100644 --- a/man2/mincore.2 +++ b/man2/mincore.2 @@ -31,7 +31,7 @@ .\" after message from .\" 2007-01-08 mtk, rewrote various parts .\" -.TH MINCORE 2 2007-01-08 "Linux" "Linux Programmer's Manual" +.TH MINCORE 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME mincore \- determine whether pages are resident in memory .SH SYNOPSIS @@ -40,6 +40,14 @@ mincore \- determine whether pages are resident in memory .B #include .sp .BI "int mincore(void *" start ", size_t " length ", unsigned char *" vec ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR mincore (): +_BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION .BR mincore () returns a vector that indicates whether pages diff --git a/man2/mknod.2 b/man2/mknod.2 index 8bd8da776..723e3af9c 100644 --- a/man2/mknod.2 +++ b/man2/mknod.2 @@ -10,7 +10,7 @@ .\" Modified 2003-04-23 by Michael Kerrisk .\" Modified 2004-06-23 by Michael Kerrisk .\" -.TH MKNOD 2 2004-06-23 "Linux" "Linux Programmer's Manual" +.TH MKNOD 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME mknod \- create a special or ordinary file .SH SYNOPSIS @@ -22,6 +22,14 @@ mknod \- create a special or ordinary file .sp .BI "int mknod(const char *" pathname ", mode_t " mode ", dev_t " dev ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR mknod (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION The system call .BR mknod () diff --git a/man2/nanosleep.2 b/man2/nanosleep.2 index b9ed23b54..acb24acf3 100644 --- a/man2/nanosleep.2 +++ b/man2/nanosleep.2 @@ -25,14 +25,21 @@ .\" 1996-04-10 Markus Kuhn .\" First version written .\" Modified, 2004-10-24, aeb -.TH NANOSLEEP 2 2004-10-24 "Linux" "Linux Programmer's Manual" +.TH NANOSLEEP 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME nanosleep \- pause execution for a specified time .SH SYNOPSIS -.B #define _POSIX_C_SOURCE 199309 .B #include .sp -\fBint nanosleep(const struct timespec *\fIreq\fB, struct timespec *\fIrem\fB); +.BI "int nanosleep(const struct timespec *" req ", struct timespec *" rem ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR nanosleep (): +_POSIX_C_SOURCE\ >=\ 199309L .SH DESCRIPTION .BR nanosleep () delays the execution of the program for at least the time specified in @@ -154,5 +161,4 @@ then the time that the process spent in the stopped state is .BR sleep (3), .BR timer_create (3), .BR usleep (3), -.BR feature_test_macros (7), .BR time (7) diff --git a/man2/nice.2 b/man2/nice.2 index 41b6736c8..7c8ec86f0 100644 --- a/man2/nice.2 +++ b/man2/nice.2 @@ -28,13 +28,21 @@ .\" Modified 2001-06-04 by aeb .\" Modified 2004-05-27 by Michael Kerrisk .\" -.TH NICE 2 2005-09-20 "Linux" "Linux Programmer's Manual" +.TH NICE 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME nice \- change process priority .SH SYNOPSIS .B #include .sp .BI "int nice(int " inc ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR getcwd (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE .SH DESCRIPTION .BR nice () adds diff --git a/man2/readahead.2 b/man2/readahead.2 index d501cef6c..aa391ba31 100644 --- a/man2/readahead.2 +++ b/man2/readahead.2 @@ -22,11 +22,12 @@ .\" 2004-05-40 Created by Michael Kerrisk .\" 2004-10-05 aeb, minor correction .\" -.TH READAHEAD 2 2004-10-05 "Linux" "Linux Programmer's Manual" +.TH READAHEAD 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME readahead \- perform file readahead into page cache .SH SYNOPSIS .nf +.B #define _GNU_SOURCE .B #include .sp .BI "ssize_t readahead(int " fd ", off64_t *" offset ", size_t " count ); diff --git a/man2/readlink.2 b/man2/readlink.2 index 4ba9490a6..6c622789f 100644 --- a/man2/readlink.2 +++ b/man2/readlink.2 @@ -35,13 +35,23 @@ .\" Modified Tue Jul 9 23:55:17 1996 by aeb .\" Modified Fri Jan 24 00:26:00 1997 by aeb .\" -.TH READLINK 2 1997-08-21 "Linux" "Linux Programmer's Manual" +.TH READLINK 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME readlink \- read value of a symbolic link .SH SYNOPSIS .B #include .sp .BI "ssize_t readlink(const char *" path ", char *" buf ", size_t " bufsiz ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR readlink (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _POSIX_C_SOURCE\ >=\ 200112L +.ad b .SH DESCRIPTION .BR readlink () places the contents of the symbolic link diff --git a/man2/select.2 b/man2/select.2 index d6e4db322..d60a332ac 100644 --- a/man2/select.2 +++ b/man2/select.2 @@ -35,7 +35,7 @@ .\" 2005-03-11, mtk, modified pselect() text (it is now a system .\" call in 2.6.16. .\" -.TH SELECT 2 2006-03-11 "Linux" "Linux Programmer's Manual" +.TH SELECT 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME select, pselect, FD_CLR, FD_ISSET, FD_SET, FD_ZERO \- synchronous I/O multiplexing @@ -53,8 +53,8 @@ synchronous I/O multiplexing .br .B #include .sp -\fBint select(int \fInfds\fB, fd_set *\fIreadfds\fB, fd_set *\fIwritefds\fB, - fd_set *\fIexceptfds\fB, struct timeval *\fItimeout\fB); +.BI "int select(int " nfds ", fd_set *" readfds ", fd_set *" writefds , +.BI " fd_set *" exceptfds ", struct timeval *" timeout ); .sp .BI "void FD_CLR(int " fd ", fd_set *" set ); .br @@ -64,13 +64,20 @@ synchronous I/O multiplexing .br .BI "void FD_ZERO(fd_set *" set ); .sp -.B #define _XOPEN_SOURCE 600 .B #include .sp -\fBint pselect(int \fInfds\fB, fd_set *\fIreadfds\fB, fd_set *\fIwritefds\fB, - fd_set *\fIexceptfds\fB, const struct timespec *\fItimeout\fB, - const sigset_t *\fIsigmask\fB); +.BI "int pselect(int " nfds ", fd_set *" readfds ", fd_set *" writefds , +.BI " fd_set *" exceptfds ", const struct timespec *" timeout , +.BI " const sigset_t *" sigmask ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR pselect (): +_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600 .SH DESCRIPTION .BR select () and @@ -515,5 +522,4 @@ For vaguely related stuff, see .BR send (2), .BR sigprocmask (2), .BR write (2), -.BR epoll (7), -.BR feature_test_macros (7) +.BR epoll (7) diff --git a/man2/semop.2 b/man2/semop.2 index 557256f00..4970791fd 100644 --- a/man2/semop.2 +++ b/man2/semop.2 @@ -30,7 +30,7 @@ .\" 2005-04-08, mtk, Noted kernel version numbers for semtimedop() .\" 2007-07-09, mtk, Added an EXAMPLE code segment. .\" -.TH SEMOP 2 2007-07-09 "Linux" "Linux Programmer's Manual" +.TH SEMOP 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME semop, semtimedop \- semaphore operations .SH SYNOPSIS @@ -47,6 +47,14 @@ semop, semtimedop \- semaphore operations .BI "int semtimedop(int " semid ", struct sembuf *" sops ", unsigned " nsops , .BI " struct timespec *" timeout ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR semtimedop (): +_GNU_SOURCE .SH DESCRIPTION Each semaphore in a semaphore set has the following associated values: .sp diff --git a/man2/seteuid.2 b/man2/seteuid.2 index 3f8761eb2..7bd8d28ea 100644 --- a/man2/seteuid.2 +++ b/man2/seteuid.2 @@ -24,7 +24,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk .\" Added notes on capability requirements .\" -.TH SETEGID 2 2004-05-27 "Linux" "Linux Programmer's Manual" +.TH SETEGID 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME seteuid, setegid \- set effective user or group ID .SH SYNOPSIS @@ -35,6 +35,17 @@ seteuid, setegid \- set effective user or group ID .BI "int seteuid(uid_t " euid ); .br .BI "int setegid(gid_t " egid ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR seteuid (), +.BR setegid (): +_BSD_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600 +.ad b .SH DESCRIPTION .BR seteuid () sets the effective user ID of the current process. diff --git a/man2/setpgid.2 b/man2/setpgid.2 index 502c55d50..32885f3d5 100644 --- a/man2/setpgid.2 +++ b/man2/setpgid.2 @@ -42,7 +42,7 @@ .\" 2007-07-25, mtk, fairly substantial rewrites and rearrangements .\" of text. .\" -.TH SETPGID 2 2007-07-25 "Linux" "Linux Programmer's Manual" +.TH SETPGID 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME setpgid, getpgid, setpgrp, getpgrp \- set/get process group .SH SYNOPSIS @@ -67,16 +67,18 @@ Feature Test Macro Requirements for glibc (see .BR feature_test_macros (7)): .in .sp +.ad l .BR getpgid (): -_XOPEN_SOURCE >= 500 +_XOPEN_SOURCE\ >=\ 500 .br .BR setpgrp () (POSIX.1): _SVID_SOURCE || _XOPEN_SOURCE >= 500 .sp .BR setpgrp "()\ (BSD)," .BR getpgrp "()\ (BSD):" -_BSD_SOURCE && ! (_POSIX_SOURCE || _POSIX_C_SOURCE || +_BSD_SOURCE && !\ (_POSIX_SOURCE || _POSIX_C_SOURCE || _XOPEN_SOURCE || _XOPEN_SOURCE_EXTENDED || _GNU_SOURCE || _SVID_SOURCE) +.ad b .SH DESCRIPTION All of these interfaces are available on Linux, and are used for getting and setting the diff --git a/man2/setresuid.2 b/man2/setresuid.2 index 537dec5f9..7f8267208 100644 --- a/man2/setresuid.2 +++ b/man2/setresuid.2 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" .\" Modified, 2003-05-26, Michael Kerrisk, -.TH SETRESUID 2 2003-05-26 "Linux" "Linux Programmer's Manual" +.TH SETRESUID 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME setresuid, setresgid \- set real, effective and saved user or group ID .SH SYNOPSIS @@ -86,10 +86,7 @@ they also appear on HP-UX and some of the BSDs. .SH NOTES Under HP-UX and FreeBSD the prototype is found in .IR . -Under Linux the prototype is given by glibc since version 2.3.2 -provided -.B _GNU_SOURCE -is defined. +Under Linux the prototype is provided by glibc since version 2.3.2. .SH "SEE ALSO" .BR getresuid (2), .BR getuid (2), diff --git a/man2/setreuid.2 b/man2/setreuid.2 index 7b326feeb..44efabd90 100644 --- a/man2/setreuid.2 +++ b/man2/setreuid.2 @@ -40,7 +40,7 @@ .\" 2004-07-04 by aeb .\" 2004-05-27 by Michael Kerrisk .\" -.TH SETREUID 2 2004-07-04 "Linux" "Linux Programmer's Manual" +.TH SETREUID 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME setreuid, setregid \- set real and/or effective user or group ID .SH SYNOPSIS @@ -51,6 +51,15 @@ setreuid, setregid \- set real and/or effective user or group ID .BI "int setreuid(uid_t " ruid ", uid_t " euid ); .br .BI "int setregid(gid_t " rgid ", gid_t " egid ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR setreuid (), +.BR setregid (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION .BR setreuid () sets real and effective user IDs of the current process. diff --git a/man2/sigaltstack.2 b/man2/sigaltstack.2 index 6df5bbd87..d6e9c988e 100644 --- a/man2/sigaltstack.2 +++ b/man2/sigaltstack.2 @@ -19,13 +19,24 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" .\" aeb, various minor fixes -.TH SIGALTSTACK 2 2001-09-27 "Linux" "Linux Programmer's Manual" +.TH SIGALTSTACK 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME sigaltstack \- set and/or get signal stack context .SH SYNOPSIS .B #include .sp .BI "int sigaltstack(const stack_t *" ss ", stack_t *" oss ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR sigaltstack (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.\" .br +.\" .BR sigstack (): +.\" _BSD_SOURCE || _XOPEN_SOURCE >= 500 .SH DESCRIPTION .BR sigaltstack () allows a process to define a new alternate diff --git a/man2/sigqueue.2 b/man2/sigqueue.2 index e3b11668f..67ccf3cbe 100644 --- a/man2/sigqueue.2 +++ b/man2/sigqueue.2 @@ -20,13 +20,21 @@ .\" added note on self-signaling, aeb, 2002-06-07 .\" added note on CAP_KILL, mtk, 2004-06-16 .\" -.TH SIGQUEUE 2 2004-06-16 "Linux" "Linux Programmer's Manual" +.TH SIGQUEUE 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME sigqueue, rt_sigqueueinfo \- queue a signal and data to a process .SH SYNOPSIS .B #include .sp .BI "int sigqueue(pid_t " pid ", int " sig ", const union sigval " value ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR sigqueue (): +_POSIX_C_SOURCE\ >=\ 199309L .SH DESCRIPTION .BR sigqueue () sends the signal specified in diff --git a/man2/sigwaitinfo.2 b/man2/sigwaitinfo.2 index 9c8aa7bf3..e33178a9d 100644 --- a/man2/sigwaitinfo.2 +++ b/man2/sigwaitinfo.2 @@ -17,7 +17,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH SIGWAITINFO 2 2002-06-07 "Linux" "Linux Programmer's Manual" +.TH SIGWAITINFO 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME sigwaitinfo, sigtimedwait \- synchronously wait for queued signals .SH SYNOPSIS @@ -29,6 +29,15 @@ sigwaitinfo, sigtimedwait \- synchronously wait for queued signals .BI "int sigtimedwait(const sigset_t *" set ", siginfo_t *" info ", " .BI " const struct timespec *" timeout ");" .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR sigwaitinfo (), +.BR sigtimedwait (): +_POSIX_C_SOURCE\ >=\ 199309L .SH DESCRIPTION .BR sigwaitinfo () suspends execution of the calling process until one of the signals in diff --git a/man2/stat.2 b/man2/stat.2 index b339c0610..6d6d6388b 100644 --- a/man2/stat.2 +++ b/man2/stat.2 @@ -37,7 +37,7 @@ .\" 2007-06-08 mtk: Added example program .\" 2007-07-05 mtk: Added details on underlying system call interfaces .\" -.TH STAT 2 2007-07-05 "Linux" "Linux Programmer's Manual" +.TH STAT 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME stat, fstat, lstat \- get file status .SH SYNOPSIS @@ -59,7 +59,7 @@ Feature Test Macro Requirements for glibc (see .in .sp .BR lstat (): -_BSD_SOURCE || _XOPEN_SOURCE >= 500 +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION .PP These functions return information about a file. diff --git a/man2/stime.2 b/man2/stime.2 index 8ab3856d1..d72b1e1a3 100644 --- a/man2/stime.2 +++ b/man2/stime.2 @@ -27,15 +27,21 @@ .\" Modified 2001-03-16 by Andries Brouwer .\" Modified 2004-05-27 by Michael Kerrisk .\" -.TH STIME 2 2004-05-27 "Linux" "Linux Programmer's Manual" +.TH STIME 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME stime \- set time .SH SYNOPSIS -.BR "#define _SVID_SOURCE" " /* glibc2 needs this */" -.br .B #include .sp .BI "int stime(time_t *" t ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR stime (): +_SVID_SOURCE .SH DESCRIPTION .BR stime () sets the system's idea of the time and date. @@ -60,14 +66,7 @@ Under Linux the privilege is required. .SH "CONFORMING TO" SVr4. -.SH NOTES -Under glibc2, -.I -only provides a prototype when -.B _SVID_SOURCE -is defined. .SH "SEE ALSO" .BR date (1), .BR settimeofday (2), -.BR capabilities (7), -.BR feature_test_macros (7) +.BR capabilities (7) diff --git a/man2/symlink.2 b/man2/symlink.2 index 85d4787c2..a65ca75ad 100644 --- a/man2/symlink.2 +++ b/man2/symlink.2 @@ -29,13 +29,23 @@ .\" Modified 1997-01-31 by Eric S. Raymond .\" Modified 2004-06-23 by Michael Kerrisk .\" -.TH SYMLINK 2 2004-06-23 "Linux" "Linux Programmer's Manual" +.TH SYMLINK 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME symlink \- make a new name for a file .SH SYNOPSIS .B #include .sp .BI "int symlink(const char *" oldpath ", const char *" newpath ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR symlink (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _POSIX_C_SOURCE\ >=\ 200112L +.ad b .SH DESCRIPTION .BR symlink () creates a symbolic link named diff --git a/man2/sync.2 b/man2/sync.2 index 1e366a4f4..2835149ae 100644 --- a/man2/sync.2 +++ b/man2/sync.2 @@ -31,13 +31,21 @@ .\" Modified Tue Oct 22 22:27:07 1996 by Eric S. Raymond .\" Modified 2001-10-10 by aeb, following Michael Kerrisk. .\" -.TH SYNC 2 2001-10-10 "Linux" "Linux Programmer's Manual" +.TH SYNC 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME sync \- commit buffer cache to disk .SH SYNOPSIS .B #include .sp .B void sync(void); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR sync (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION .BR sync () first commits inodes to buffers, and then buffers to disk. diff --git a/man2/syscall.2 b/man2/syscall.2 index 05312b2b6..888c06979 100644 --- a/man2/syscall.2 +++ b/man2/syscall.2 @@ -35,14 +35,14 @@ .\" 2002-03-20 Christoph Hellwig .\" - adopted for Linux .\" -.TH SYSCALL 2 2007-06-01 "Linux" "Linux Programmer's Manual" +.TH SYSCALL 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME syscall \- indirect system call .SH SYNOPSIS .nf -.B "#define _BSD_SOURCE /* or _GNU_SOURCE or _SVID_SOURCE */" +.BR "#define _GNU_SOURCE " " /* or _BSD_SOURCE or _SVID_SOURCE */" .B #include -.B "#include /* For SYS_xxx definitions */" +.BR "#include " "/* For SYS_xxx definitions */" .BI "int syscall(int " number ", ...);" .fi @@ -65,7 +65,6 @@ and an error code is stored in first appeared in 4BSD. .SH EXAMPLE - .nf #define _GNU_SOURCE #include @@ -80,4 +79,4 @@ main(int argc, char *argv[]) } .fi .SH SEE ALSO -.BT syscalls (2) +.BR syscalls (2) diff --git a/man2/truncate.2 b/man2/truncate.2 index 873efa429..db08be29a 100644 --- a/man2/truncate.2 +++ b/man2/truncate.2 @@ -38,7 +38,7 @@ .\" Modified 2002-04-06 by Andries Brouwer .\" Modified 2004-06-23 by Michael Kerrisk .\" -.TH TRUNCATE 2 2004-06-23 "Linux" "Linux Programmer's Manual" +.TH TRUNCATE 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME truncate, ftruncate \- truncate a file to a specified length .SH SYNOPSIS @@ -49,6 +49,16 @@ truncate, ftruncate \- truncate a file to a specified length .BI "int truncate(const char *" path ", off_t " length ); .br .BI "int ftruncate(int " fd ", off_t " length ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.ad l +.sp +.BR getdtablesize (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _POSIX_C_SOURCE\ >=\ 200112L +.ad b .SH DESCRIPTION The .BR truncate () diff --git a/man2/unshare.2 b/man2/unshare.2 index fc10e5065..bc7ec2418 100644 --- a/man2/unshare.2 +++ b/man2/unshare.2 @@ -17,11 +17,14 @@ .\" FIXME Document CLONE_NEWIPC, which is new in 2.6.18 .\" FIXME Document CLONE_NEWUTS, which is new in 2.6.19 .\" -.TH UNSHARE 2 2005-03-10 "Linux" "Linux Programmer's Manual" +.TH UNSHARE 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME unshare \- disassociate parts of the process execution context .SH SYNOPSIS .nf +.B #define _GNU_SOURCE +.\" Actually _BSD_SOURCE || _SVID_SOURCE +.\" See http://sources.redhat.com/bugzilla/show_bug.cgi?id=4749 .B #include .sp .BI "int unshare(int " flags ); diff --git a/man2/vfork.2 b/man2/vfork.2 index dd6513138..73d0c67fa 100644 --- a/man2/vfork.2 +++ b/man2/vfork.2 @@ -23,7 +23,7 @@ .\" 1999-11-10: Merged text taken from the page contributed by .\" Reed H. Petty (rhp@draper.net) .\" -.TH VFORK 2 1999-11-01 "Linux" "Linux Programmer's Manual" +.TH VFORK 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME vfork \- create a child process and block parent .SH SYNOPSIS @@ -32,6 +32,14 @@ vfork \- create a child process and block parent .B #include .sp .B pid_t vfork(void); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR vfork (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION .SS "Standard Description" (From SUSv2 / POSIX draft.) diff --git a/man2/vhangup.2 b/man2/vhangup.2 index 3d9378101..bdafa1904 100644 --- a/man2/vhangup.2 +++ b/man2/vhangup.2 @@ -24,13 +24,23 @@ .\" Modified, 27 May 2004, Michael Kerrisk .\" Added notes on capability requirements .\" -.TH VHANGUP 2 2004-05-27 "Linux" "Linux Programmer's Manual" +.TH VHANGUP 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME vhangup \- virtually hangup the current tty .SH SYNOPSIS .B #include .sp .B int vhangup(void); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR vhangup (): +_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) +.ad b .SH DESCRIPTION .BR vhangup () simulates a hangup on the current terminal. diff --git a/man2/wait.2 b/man2/wait.2 index e2ab3192e..67db0df9d 100644 --- a/man2/wait.2 +++ b/man2/wait.2 @@ -46,7 +46,7 @@ .\" Much other text rewritten .\" 2005-05-10, mtk, __W* flags can't be used with waitid() .\" -.TH WAIT 2 2004-11-11 "Linux" "Linux Programmer's Manual" +.TH WAIT 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME wait, waitpid, waitid \- wait for process to change state .SH SYNOPSIS @@ -60,6 +60,14 @@ wait, waitpid, waitid \- wait for process to change state .br .BI "int waitid(idtype_t " idtype ", id_t " id \ ", siginfo_t *" infop ", int " options ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR waitid (): +_SVID_SOURCE || _XOPEN_SOURCE .SH DESCRIPTION All of these system calls are used to wait for state changes in a child of the calling process, and obtain information diff --git a/man2/wait4.2 b/man2/wait4.2 index 2fcffece0..c8074cac0 100644 --- a/man2/wait4.2 +++ b/man2/wait4.2 @@ -31,13 +31,11 @@ .\" Rewrote much of this page, and removed much duplicated text, .\" replacing with pointers to wait.2 .\" -.TH WAIT4 2 2004-11-11 "Linux" "Linux Programmer's Manual" +.TH WAIT4 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME wait3, wait4 \- wait for process to change state, BSD style .SH SYNOPSIS .nf -.B #define _BSD_SOURCE - /* Or #define _XOPEN_SOURCE 500 for wait3() */ .B #include .B #include .B #include @@ -49,6 +47,17 @@ wait3, wait4 \- wait for process to change state, BSD style .BI "pid_t wait4(pid_t " pid ", int *" status ", int " options , .BI " struct rusage *" rusage ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR wait3 (): +_BSD_SOURCE +.br +.BR wait4 (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION The .BR wait3 () @@ -134,5 +143,4 @@ defined in .BR sigaction (2), .BR signal (2), .BR wait (2), -.BR feature_test_macros (7), .BR signal (7) diff --git a/man3/INFINITY.3 b/man3/INFINITY.3 index e02351e4f..22b2d9ddf 100644 --- a/man3/INFINITY.3 +++ b/man3/INFINITY.3 @@ -20,12 +20,12 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH INFINITY 3 2004-10-31 "" "Linux Programmer's Manual" +.TH INFINITY 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME INFINITY, NAN, HUGE_VAL, HUGE_VALF, HUGE_VALL \- floating point constants .SH SYNOPSIS .nf -#define _ISOC99_SOURCE +.BR #define _ISOC99_SOURCE .br .B #include .sp diff --git a/man3/a64l.3 b/man3/a64l.3 index 75d6ebbe1..b0b986c61 100644 --- a/man3/a64l.3 +++ b/man3/a64l.3 @@ -3,7 +3,7 @@ .\" .\" Corrected, aeb, 2002-05-30 .\" -.TH A64L 3 2002-02-15 "" "Linux Programmer's Manual" +.TH A64L 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME a64l, l64a \- convert between long and base-64 .SH SYNOPSIS @@ -12,6 +12,15 @@ a64l, l64a \- convert between long and base-64 .BI "long a64l(char *" str64 ); .sp .BI "char *l64a(long " value ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR a64l (), +.BR l64a (): +_SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION These functions provide a conversion between 32-bit long integers and little-endian base-64 ASCII strings (of length zero to six). diff --git a/man3/abs.3 b/man3/abs.3 index c8d6431b9..0ea9711b8 100644 --- a/man3/abs.3 +++ b/man3/abs.3 @@ -29,7 +29,7 @@ .\" Modified Sat Jul 24 21:45:37 1993, Rik Faith (faith@cs.unc.edu) .\" Modified Sat Dec 16 15:02:59 2000, Joseph S. Myers .\" -.TH ABS 3 2000-12-17 "GNU" "Linux Programmer's Manual" +.TH ABS 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME abs, labs, llabs, imaxabs \- compute the absolute value of an integer .SH SYNOPSIS @@ -46,6 +46,15 @@ abs, labs, llabs, imaxabs \- compute the absolute value of an integer .sp .BI "intmax_t imaxabs(intmax_t " j ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR llabs (): +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 .SH DESCRIPTION The .BR abs () diff --git a/man3/acosh.3 b/man3/acosh.3 index 81450a62f..e71b061fd 100644 --- a/man3/acosh.3 +++ b/man3/acosh.3 @@ -28,7 +28,7 @@ .\" Modified 2002-07-25 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH ACOSH 3 2002-07-25 "" "Linux Programmer's Manual" +.TH ACOSH 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME acosh, acoshf, acoshl \- inverse hyperbolic cosine function .SH SYNOPSIS @@ -43,6 +43,19 @@ acosh, acoshf, acoshl \- inverse hyperbolic cosine function .sp .fi Link with \fI-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR acosh (), +.BR acoshf (), +.BR acoshl (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION The .BR acosh () diff --git a/man3/addseverity.3 b/man3/addseverity.3 index 482310a85..510a1a805 100644 --- a/man3/addseverity.3 +++ b/man3/addseverity.3 @@ -3,18 +3,24 @@ .\" adapted glibc info page .\" .\" polished a little, aeb -.TH ADDSEVERITY 3 2002-08-07 "GNU" "Linux Programmer's Manual" +.TH ADDSEVERITY 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME addseverity \- introduce new severity classes .SH SYNOPSIS .nf .sp -.B #define _SVID_SOURCE -.br .B #include .sp .BI "int addseverity(int " severity ", const char *" s ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR addseverity (): +_SVID_SOURCE .SH DESCRIPTION This function allows the introduction of new severity classes which can be addressed by the @@ -56,5 +62,4 @@ systems. New severity classes can also be added by setting the environment variable .BR SEV_LEVEL . .SH "SEE ALSO" -.BR fmtmsg (3), -.BR feature_test_macros (7) +.BR fmtmsg (3) diff --git a/man3/adjtime.3 b/man3/adjtime.3 index 80312c9ec..c67da3e8d 100644 --- a/man3/adjtime.3 +++ b/man3/adjtime.3 @@ -17,15 +17,21 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH ADJTIME 3 2006-05-01 "Linux" "Linux Programmer's Manual" +.TH ADJTIME 3 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME adjtime \- correct the time to synchronize the system clock .SH SYNOPSIS .nf -.B #define _BSD_SOURCE -.sp .BI "int adjtime(const struct timeval *" delta ", struct timeval *" olddelta ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR adjtime (): +_BSD_SOURCE .SH DESCRIPTION The .BR adjtime () @@ -128,5 +134,4 @@ This is the result of a kernel limitation. .SH "SEE ALSO" .BR adjtimex (2), .BR gettimeofday (2), -.BR feature_test_macros (7), .BR time (7) diff --git a/man3/asinh.3 b/man3/asinh.3 index 32818301c..4735f50f5 100644 --- a/man3/asinh.3 +++ b/man3/asinh.3 @@ -28,7 +28,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH ASINH 3 2002-07-27 "GNU" "Linux Programmer's Manual" +.TH ASINH 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME asinh, asinhf, asinhl \- inverse hyperbolic sine function .SH SYNOPSIS @@ -43,6 +43,19 @@ asinh, asinhf, asinhl \- inverse hyperbolic sine function .fi .sp Link with \fI-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR asinh (), +.BR asinhf (), +.BR asinhl (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION The .BR asinh () diff --git a/man3/atanh.3 b/man3/atanh.3 index 6be573884..38f0ef95c 100644 --- a/man3/atanh.3 +++ b/man3/atanh.3 @@ -28,7 +28,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH ATANH 3 2002-07-27 "" "Linux Programmer's Manual" +.TH ATANH 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME atanh, atanhf, atanhl \- inverse hyperbolic tangent function .SH SYNOPSIS @@ -43,6 +43,19 @@ atanh, atanhf, atanhl \- inverse hyperbolic tangent function .sp .fi Link with \fI-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR atanh (), +.BR atanhf (), +.BR atanhl (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION The .BR atanh () diff --git a/man3/atoi.3 b/man3/atoi.3 index 5ad6bffdf..7440b9799 100644 --- a/man3/atoi.3 +++ b/man3/atoi.3 @@ -28,7 +28,7 @@ .\" Modified Sat Jul 24 21:38:42 1993, Rik Faith (faith@cs.unc.edu) .\" Modified Sun Dec 17 18:35:06 2000, Joseph S. Myers .\" -.TH ATOI 3 2000-12-17 "GNU" "Linux Programmer's Manual" +.TH ATOI 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME atoi, atol, atoll, atoq \- convert a string to an integer .SH SYNOPSIS @@ -43,6 +43,17 @@ atoi, atol, atoll, atoq \- convert a string to an integer .br .BI "long long atoq(const char *" nptr ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR atoll (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION The .BR atoi () diff --git a/man3/cbrt.3 b/man3/cbrt.3 index 65437988a..95b2fd0ad 100644 --- a/man3/cbrt.3 +++ b/man3/cbrt.3 @@ -25,7 +25,7 @@ .\" Modified 2002-07-27 Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH CBRT 3 2002-07-27 "GNU" "Linux Programmer's Manual" +.TH CBRT 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME cbrt, cbrtf, cbrtl \- cube root function .SH SYNOPSIS @@ -40,6 +40,19 @@ cbrt, cbrtf, cbrtl \- cube root function .fi .sp Link with \fI-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR cbrt (), +.BR cbrtf (), +.BR cbrtl (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION The .BR cbrt () diff --git a/man3/cfree.3 b/man3/cfree.3 index 6c69b2d11..380ce3bb4 100644 --- a/man3/cfree.3 +++ b/man3/cfree.3 @@ -20,7 +20,7 @@ .\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, .\" USA. .\" -.TH CFREE 3 2003-11-18 "" "Linux Programmer's Manual" +.TH CFREE 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME cfree \- free allocated memory .SH SYNOPSIS @@ -40,6 +40,14 @@ cfree \- free allocated memory /* In Solaris watchmalloc.so.1 */ .BI "void cfree(void *" ptr ", size_t " nelem ", size_t " elsize ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR cfree (): +_BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION This function should never be used. Use diff --git a/man3/clearenv.3 b/man3/clearenv.3 index b58340a15..204f9fd8e 100644 --- a/man3/clearenv.3 +++ b/man3/clearenv.3 @@ -21,7 +21,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" .\" Additions, aeb, 2001-10-17. -.TH CLEARENV 3 2001-10-17 "Linux" "Linux Programmer's Manual" +.TH CLEARENV 3 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME clearenv \- clear the environment .SH SYNOPSIS @@ -30,6 +30,14 @@ clearenv \- clear the environment .sp .BI "int clearenv(void);" .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR clearenv (): +_SVID_SOURCE || _XOPEN_SOURCE .SH DESCRIPTION The .BR clearenv () diff --git a/man3/clock_getres.3 b/man3/clock_getres.3 index 998b5b194..8f51ba9de 100644 --- a/man3/clock_getres.3 +++ b/man3/clock_getres.3 @@ -27,7 +27,7 @@ .\" 2003-08-24 aeb, large parts rewritten .\" 2004-08-06 Christoph Lameter , SMP note .\" -.TH CLOCK_GETRES 3 2003-08-24 "" "Linux Programmer's Manual" +.TH CLOCK_GETRES 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME clock_getres, clock_gettime, clock_settime \- clock and time functions .SH SYNOPSIS @@ -38,6 +38,18 @@ clock_getres, clock_gettime, clock_settime \- clock and time functions .BI "int clock_gettime(clockid_t " clk_id ", struct timespec *" tp ); .br .BI "int clock_settime(clockid_t " clk_id ", const struct timespec *" tp ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR clock_getres (), +.BR clock_gettime (), +.BR clock_settime (): +_POSIX_C_SOURCE\ >=\ 199309L +.ad b .SH DESCRIPTION The function .BR clock_getres () @@ -76,10 +88,8 @@ structs, as specified in .sp .nf struct timespec { -.in +8 -time_t tv_sec; /* seconds */ -long tv_nsec; /* nanoseconds */ -.in -8 + time_t tv_sec; /* seconds */ + long tv_nsec; /* nanoseconds */ }; .fi .PP diff --git a/man3/confstr.3 b/man3/confstr.3 index c338e9edd..c3cd0e23a 100644 --- a/man3/confstr.3 +++ b/man3/confstr.3 @@ -26,19 +26,23 @@ .\" See for the rest. .\" These should all be added to this page. .\" See also the POSIX.1-2001 specification of confstr() -.TH CONFSTR 3 1993-04-17 "GNU" "Linux Programmer's Manual" +.TH CONFSTR 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME confstr \- get configuration dependent string variables .SH SYNOPSIS .nf -.B #define _POSIX_C_SOURCE 2 -or -.B #define _XOPEN_SOURCE -.br .B #include .sp .BI "size_t confstr(int " "name" ", char *" buf ", size_t " len ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR getcwd (): +_POSIX_C_SOURCE\ >=\ 2 || _XOPEN_SOURCE .SH DESCRIPTION .BR confstr () gets the value of configuration-dependent string variables. @@ -138,5 +142,4 @@ confstr(_CS_PATH, pathbuf, n); .SH "SEE ALSO" .BR sh (1), .BR exec (3), -.BR system (3), -.BR feature_test_macros (7) +.BR system (3) diff --git a/man3/copysign.3 b/man3/copysign.3 index 27ae856f1..62381efd9 100644 --- a/man3/copysign.3 +++ b/man3/copysign.3 @@ -26,7 +26,7 @@ .\" 386BSD man pages .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) .\" Modified 2002-08-10 by Walter Harms (walter.harms@informatik.uni-oldenburg.de) -.TH COPYSIGN 3 2007-03-31 "GNU" "Linux Programmer's Manual" +.TH COPYSIGN 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME copysign, copysignf, copysignl \- copy sign of a number .SH SYNOPSIS @@ -41,6 +41,19 @@ copysign, copysignf, copysignl \- copy sign of a number .fi .sp Link with \fI-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR copysign (), +.BR copysignf (), +.BR copysignl (): +_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION The .BR copysign () diff --git a/man3/ctermid.3 b/man3/ctermid.3 index 9f3c24fd9..be0494fc0 100644 --- a/man3/ctermid.3 +++ b/man3/ctermid.3 @@ -21,7 +21,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" License. .\" Modified Sat Jul 24 19:51:06 1993 by Rik Faith (faith@cs.unc.edu) -.TH CTERMID 3 1993-04-06 "GNU" "Linux Programmer's Manual" +.TH CTERMID 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME ctermid \- get controlling terminal name .SH SYNOPSIS @@ -30,6 +30,15 @@ ctermid \- get controlling terminal name .sp .BI "char *ctermid(char *" "s" ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR ctermid (): +_POSIX_C_SOURCE || _XOPEN_SOURCE +.\" From : _XOPEN_SOURCE .SH DESCRIPTION .BR ctermid () returns a string which is the pathname for the current diff --git a/man3/ctime.3 b/man3/ctime.3 index aeb60c871..f05a9ad33 100644 --- a/man3/ctime.3 +++ b/man3/ctime.3 @@ -30,7 +30,7 @@ .\" Modified 2001-12-13, joey, aeb .\" Modified 2004-11-16, mtk .\" -.TH CTIME 3 2004-11-16 "" "Linux Programmer's Manual" +.TH CTIME 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME asctime, ctime, gmtime, localtime, mktime, asctime_r, ctime_r, gmtime_r, localtime_r \- transform date and time to broken-down time or ASCII @@ -56,6 +56,18 @@ localtime_r \- transform date and time to broken-down time or ASCII .sp .BI "time_t mktime(struct tm *" tm ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR asctime_r (), +.BR ctime_r (), +.BR gmtime_r (), +.BR localtime_r (): +.br +_POSIX_C_SOURCE || _XOPEN_SOURCE || _BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION The .BR ctime (), diff --git a/man3/daemon.3 b/man3/daemon.3 index 9636f4941..bea3b4b5c 100644 --- a/man3/daemon.3 +++ b/man3/daemon.3 @@ -31,13 +31,21 @@ .\" .\" @(#)daemon.3 8.1 (Berkeley) 6/9/93 .\" Added mentioning of glibc weirdness wrt unistd.h. 5/11/98, Al Viro -.TH DAEMON 3 1993-06-09 "GNU" "Linux Programmer's Manual" +.TH DAEMON 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME daemon \- run in the background .SH SYNOPSIS .B #include .sp .BI "int daemon(int " nochdir ", int " noclose ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR daemon (): +_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) .SH DESCRIPTION The .BR daemon () diff --git a/man3/dirfd.3 b/man3/dirfd.3 index bda36a7a0..bda821134 100644 --- a/man3/dirfd.3 +++ b/man3/dirfd.3 @@ -20,7 +20,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH DIRFD 3 2002-01-05 "Linux" "Linux Programmer's Manual" +.TH DIRFD 3 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME dirfd \- get directory stream file descriptor .SH SYNOPSIS @@ -29,6 +29,14 @@ dirfd \- get directory stream file descriptor .B #include .sp .BI "int dirfd(DIR *" dir ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR dirfd (): +_BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION The function .BR dirfd () diff --git a/man3/div.3 b/man3/div.3 index 0cca8cfbf..c314dc89c 100644 --- a/man3/div.3 +++ b/man3/div.3 @@ -29,7 +29,7 @@ .\" Modified 1993-07-24, Rik Faith (faith@cs.unc.edu) .\" Modified 2002-08-10, 2003-11-01 Walter Harms, aeb .\" -.TH DIV 3 2003-11-01 "" "Linux Programmer's Manual" +.TH DIV 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME div, ldiv, lldiv, imaxdiv \- compute quotient and remainder of an integer division @@ -47,6 +47,15 @@ an integer division .sp .BI "imaxdiv_t imaxdiv(intmax_t " numerator ", intmax_t " denominator ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR lldiv (): +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 .SH DESCRIPTION The .BR div () diff --git a/man3/drand48.3 b/man3/drand48.3 index 4b278fced..3005101da 100644 --- a/man3/drand48.3 +++ b/man3/drand48.3 @@ -25,7 +25,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:46:03 1993 by Rik Faith (faith@cs.unc.edu) -.TH DRAND48 3 1993-07-02 "" "Linux Programmer's Manual" +.TH DRAND48 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME drand48, erand48, lrand48, nrand48, mrand48, jrand48, srand48, seed48, lcong48 \- generate uniformly distributed pseudo-random numbers @@ -51,6 +51,25 @@ lcong48 \- generate uniformly distributed pseudo-random numbers .sp .BI "void lcong48(unsigned short " param [7]); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +All functions described on this page: +.\" .BR drand48 (), +.\" .BR erand48 (), +.\" .BR lrand48 (), +.\" .BR nrand48 (), +.\" .BR mrand48 (), +.\" .BR jrand48 (), +.\" .BR srand48 (), +.\" .BR seed48 (), +.\" .BR lcong48 (): +_SVID_SOURCE || _XOPEN_SOURCE +.ad b .SH DESCRIPTION These functions generate pseudo-random numbers using the linear congruential algorithm and 48-bit integer arithmetic. diff --git a/man3/drand48_r.3 b/man3/drand48_r.3 index e47e450dd..6210aaba1 100644 --- a/man3/drand48_r.3 +++ b/man3/drand48_r.3 @@ -22,7 +22,7 @@ .\" .\" Created 2004-10-31. Text taken from a page by Walter Harms, 2003-09-08 .\" -.TH DRAND48_R 3 2004-10-31 "GNU" "Linux Programmer's Manual" +.TH DRAND48_R 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME drand48_r, erand48_r, lrand48_r, nrand48_r, mrand48_r, jrand48_r, srand48_r, seed48_r, lcong48_r @@ -59,6 +59,25 @@ srand48_r, seed48_r, lcong48_r .br .BI " struct drand48_data *" buffer ");" .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +All functions described on this page: +.\" .BR drand48_r (), +.\" .BR erand48_r (), +.\" .BR lrand48_r (), +.\" .BR nrand48_r (), +.\" .BR mrand48_r (), +.\" .BR jrand48_r (), +.\" .BR srand48_r (), +.\" .BR seed48_r (), +.\" .BR lcong48_r (): +_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE +.ad b .SH DESCRIPTION These functions are the reentrant analogs of the functions described in .BR drand48 (3). diff --git a/man3/dysize.3 b/man3/dysize.3 index 591c6a69c..881034452 100644 --- a/man3/dysize.3 +++ b/man3/dysize.3 @@ -21,16 +21,21 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" .\" aeb: some corrections -.TH DYSIZE 3 2001-11-12 "GNU" "Linux Programmer's Manual" +.TH DYSIZE 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME dysize \- get number of days for a given year .SH SYNOPSIS -.sp -.BR "#define _BSD_SOURCE" " /* or: #define _SVID_SOURCE */" -.br .BR "#include " .sp .BI "int dysize(int " year ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR dysize (): +_BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION The function returns 365 for a normal year and 366 for a leap year. The calculation for leap year is based on: @@ -48,5 +53,4 @@ This is a compatibility function only. Don't use it in new programs. The SCO version of this function had a year-2000 problem. .SH "SEE ALSO" -.BR strftime (3), -.BR feature_test_macros (7) +.BR strftime (3) diff --git a/man3/ecvt.3 b/man3/ecvt.3 index 59fc0ac02..324116a7d 100644 --- a/man3/ecvt.3 +++ b/man3/ecvt.3 @@ -27,7 +27,7 @@ .\" Modified Sat Jul 24 19:40:39 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Fri Jun 25 12:10:47 1999 by Andries Brouwer (aeb@cwi.nl) .\" -.TH ECVT 3 1999-06-25 "" "Linux Programmer's Manual" +.TH ECVT 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME ecvt, fcvt \- convert a floating-point number to a string .SH SYNOPSIS @@ -38,6 +38,15 @@ ecvt, fcvt \- convert a floating-point number to a string .sp .BI "char *fcvt(double " number ", int " ndigits ", int *" decpt , .BI "int *" sign ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR ecvt (), +.BR fcvt (): +_SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION The .BR ecvt () diff --git a/man3/ecvt_r.3 b/man3/ecvt_r.3 index feac0ebd6..ea2ad3198 100644 --- a/man3/ecvt_r.3 +++ b/man3/ecvt_r.3 @@ -25,7 +25,7 @@ .\" .\" Corrected return types; from Fabian; 2004-10-05 .\" -.TH ECVT_R 3 2004-10-05 "GNU" "Linux Programmer's Manual" +.TH ECVT_R 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME ecvt_r, fcvt_r, qecvt_r, qfcvt_r \- convert a floating-point number to a string .SH SYNOPSIS @@ -44,6 +44,18 @@ ecvt_r, fcvt_r, qecvt_r, qfcvt_r \- convert a floating-point number to a string .BI "int qfcvt_r(long double " number ", int " ndigits ", int *" decpt , .BI " int *" sign ", char *" buf ", size_t " len ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR ecvt_r (), +.BR fcvt_r (), +.BR qecvt_r (), +.BR qfcvt_r (): +.br +_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION The functions .BR ecvt_r (), diff --git a/man3/erf.3 b/man3/erf.3 index 571f7a35a..4392787ec 100644 --- a/man3/erf.3 +++ b/man3/erf.3 @@ -28,7 +28,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH ERF 3 2002-07-27 "GNU" "Linux Programmer's Manual" +.TH ERF 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME erf, erff, erfl, erfc, erfcf, erfcl \- error function and complementary error function @@ -50,6 +50,23 @@ complementary error function .sp .fi Link with \fI-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +All functions described on this page: +.\" .BR erf (), +.\" .BR erff (), +.\" .BR erfl (), +.\" .BR erfc (), +.\" .BR erfcf (), +.\" .BR erfcl (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION The .BR erf () diff --git a/man3/euidaccess.3 b/man3/euidaccess.3 index fba042a8c..6368b12e7 100644 --- a/man3/euidaccess.3 +++ b/man3/euidaccess.3 @@ -23,11 +23,12 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" .\" -.TH EUIDACCESS 3 2007-05-18 "" "Linux Programmer's Manual" +.TH EUIDACCESS 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME euidaccess, eaccess \- check effective user's permissions for a file .SH SYNOPSIS .nf +.B #define _GNU_SOURCE .B #include .sp .BI "int euidaccess(const char *" pathname ", int " mode ); diff --git a/man3/exp2.3 b/man3/exp2.3 index 2ca2cc42b..b5013f255 100644 --- a/man3/exp2.3 +++ b/man3/exp2.3 @@ -29,7 +29,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH EXP2 3 2002-07-27 "" "Linux Programmer's Manual" +.TH EXP2 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME exp2, exp2f, exp2l \- base-2 exponential function .SH SYNOPSIS @@ -43,7 +43,20 @@ exp2, exp2f, exp2l \- base-2 exponential function .BI "long double exp2l(long double " x ); .fi .sp -Compile with \fI\-std=c99\fP; link with \fI\-lm\fP. +Link with \fI\-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR exp2 (), +.BR exp2f (), +.BR exp2l (): +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION The .BR exp2 () diff --git a/man3/expm1.3 b/man3/expm1.3 index d778174cb..d5df08f45 100644 --- a/man3/expm1.3 +++ b/man3/expm1.3 @@ -23,7 +23,7 @@ .\" Modified 2002-07-27 Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH EXPM1 3 2002-07-27 "" "Linux Programmer's Manual" +.TH EXPM1 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME expm1, expm1f, expm1l \- exponential minus 1 .SH SYNOPSIS @@ -38,6 +38,19 @@ expm1, expm1f, expm1l \- exponential minus 1 .sp .fi Link with \fI-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR expm1 (), +.BR expm1f (), +.BR expm1l (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION .BI expm1( x ) returns a value equivalent to `exp (\fIx\fP) \- 1'. diff --git a/man3/ferror.3 b/man3/ferror.3 index 6faed8253..43443095f 100644 --- a/man3/ferror.3 +++ b/man3/ferror.3 @@ -39,7 +39,7 @@ .\" Converted for Linux, Mon Nov 29 14:24:40 1993, faith@cs.unc.edu .\" Added remark on EBADF for fileno, aeb, 2001-03-22 .\" -.TH FERROR 3 2001-10-16 "" "Linux Programmer's Manual" +.TH FERROR 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME clearerr, feof, ferror, fileno \- check and reset stream status .SH SYNOPSIS @@ -52,6 +52,14 @@ clearerr, feof, ferror, fileno \- check and reset stream status .BI "int ferror(FILE *" stream ); .br .BI "int fileno(FILE *" stream ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR fileno (): +_POSIX_C_SOURCE || _XOPEN_SOURCE .SH DESCRIPTION The function .BR clearerr () diff --git a/man3/fexecve.3 b/man3/fexecve.3 index 3321ad86d..b8c0577d4 100644 --- a/man3/fexecve.3 +++ b/man3/fexecve.3 @@ -22,13 +22,14 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH FEXECVE 3 2006-03-06 "Linux" "Linux Programmer's Manual" +.TH FEXECVE 3 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME fexecve \- execute program specified via file descriptor .SH SYNOPSIS .nf .B #include .sp +.B #define _GNU_SOURCE .BI "int fexecve(int " fd ", char *const " argv "[], char *const " envp []); .fi .SH DESCRIPTION diff --git a/man3/fgetgrent.3 b/man3/fgetgrent.3 index 9b913013e..9ea2bb9e1 100644 --- a/man3/fgetgrent.3 +++ b/man3/fgetgrent.3 @@ -25,7 +25,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:38:44 1993 by Rik Faith (faith@cs.unc.edu) -.TH FGETGRENT 3 1993-04-04 "GNU" "Linux Programmer's Manual" +.TH FGETGRENT 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME fgetgrent \- get group file entry .SH SYNOPSIS @@ -36,6 +36,14 @@ fgetgrent \- get group file entry .sp .BI "struct group *fgetgrent(FILE *" stream ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR fgetgrent (): +_SVID_SOURCE .SH DESCRIPTION The .BR fgetgrent () @@ -49,14 +57,12 @@ The \fIgroup\fP structure is defined in \fI\fP as follows: .sp .RS .nf -.ta 8n 16n 32n struct group { - char *gr_name; /* group name */ - char *gr_passwd; /* group password */ - gid_t gr_gid; /* group ID */ - char **gr_mem; /* group members */ + char *gr_name; /* group name */ + char *gr_passwd; /* group password */ + gid_t gr_gid; /* group ID */ + char **gr_mem; /* group members */ }; -.ta .fi .RE .SH "RETURN VALUE" diff --git a/man3/fgetpwent.3 b/man3/fgetpwent.3 index 182b66f73..704260d1f 100644 --- a/man3/fgetpwent.3 +++ b/man3/fgetpwent.3 @@ -28,7 +28,7 @@ .\" Modified Sat Jul 24 19:37:37 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Mon May 27 22:40:48 1996 by Martin Schulze (joey@linux.de) .\" -.TH FGETPWENT 3 1996-05-17 "GNU" "Linux Programmer's Manual" +.TH FGETPWENT 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME fgetpwent \- get password file entry .SH SYNOPSIS @@ -39,6 +39,14 @@ fgetpwent \- get password file entry .sp .BI "struct passwd *fgetpwent(FILE *" stream ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR fgetpwent (): +_SVID_SOURCE .SH DESCRIPTION The .BR fgetpwent () diff --git a/man3/finite.3 b/man3/finite.3 index 88f2136d7..81efe51c2 100644 --- a/man3/finite.3 +++ b/man3/finite.3 @@ -20,14 +20,12 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH FINITE 3 2004-10-31 "" "Linux Programmer's Manual" +.TH FINITE 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME finite, finitef, finitel, isinf, isinff, isinfl, isnan, isnanf, isnanl \- BSD floating point classification functions .SH SYNOPSIS .nf -#define _BSD_SOURCE -.br .B #include .sp .BI "int finite(double " x ); @@ -48,6 +46,28 @@ BSD floating point classification functions .br .BI "int isnanl(long double " x ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR finite (), +.BR finitef (), +.BR finitel (): +_BSD_SOURCE || _SVID_SOURCE +.br +.BR isinf (), +.BR isinff (), +.BR isinfl (): +_BSD_SOURCE || _SVID_SOURCE +.br +.BR isnan (), +.BR isnanf (), +.BR isnanl (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE +.ad b .SH DESCRIPTION The .BR finite () @@ -72,24 +92,10 @@ See .BR fpclassify (3). .\" .\" finite* not on HP-UX; they exist on Tru64. - -On a glibc system, these functions are declared by -.I -when -.B _BSD_SOURCE -or -.B _SVID_SOURCE -or -.B _GNU_SOURCE -is defined. -The isnan() functions will also be declared when -.B _XOPEN_SOURCE -is defined. .\" .SH HISTORY .\" The .\" .BR finite () .\" function occurs in 4.3BSD. .\" see IEEE.3 in the 4.3BSD manual .SH "SEE ALSO" -.BR fpclassify (3), -.BR feature_test_macros (7) +.BR fpclassify (3) diff --git a/man3/flockfile.3 b/man3/flockfile.3 index de0763df0..f590997d3 100644 --- a/man3/flockfile.3 +++ b/man3/flockfile.3 @@ -20,7 +20,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH LOCKFILE 3 2001-10-18 "" "Linux Programmer's Manual" +.TH LOCKFILE 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME flockfile, ftrylockfile, funlockfile \- lock FILE for stdio .SH SYNOPSIS @@ -33,6 +33,16 @@ flockfile, ftrylockfile, funlockfile \- lock FILE for stdio .br .BI "void funlockfile(FILE *" filehandle ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.ad l +.sp +All of the functions described on this page: +_POSIX_C_SOURCE || _XOPEN_SOURCE || _BSD_SOURCE || _SVID_SOURCE +.ad b .SH DESCRIPTION The stdio functions are thread-safe. This is achieved by assigning diff --git a/man3/fopen.3 b/man3/fopen.3 index 1071a8c86..34db7051e 100644 --- a/man3/fopen.3 +++ b/man3/fopen.3 @@ -39,7 +39,7 @@ .\" Modified, aeb, 960421, 970806 .\" Modified, joey, aeb, 2002-01-03 .\" -.TH FOPEN 3 2006-05-04 "GNU" "Linux Programmer's Manual" +.TH FOPEN 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME fopen, fdopen, freopen \- stream open functions .SH SYNOPSIS @@ -50,6 +50,14 @@ fopen, fdopen, freopen \- stream open functions .BI "FILE *fdopen(int " fildes ", const char *" mode ); .br .BI "FILE *freopen(const char *" path ", const char *" mode ", FILE *" stream ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR fdopen (): +_POSIX_C_SOURCE || _XOPEN_SOURCE .SH DESCRIPTION The .BR fopen () diff --git a/man3/fpclassify.3 b/man3/fpclassify.3 index c20dabea7..26e0fb4ac 100644 --- a/man3/fpclassify.3 +++ b/man3/fpclassify.3 @@ -3,7 +3,7 @@ .\" This was done with the help of the glibc manual. .\" .\" 2004-10-31, aeb, corrected -.TH FPCLASSIFY 3 2004-10-31 "" "Linux Programmer's Manual" +.TH FPCLASSIFY 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME fpclassify, isfinite, isnormal, isnan, isinf \- floating-point classification macros @@ -22,7 +22,30 @@ classification macros .BI "int isinf(" x ); .fi .sp -Compile with \fI\-std=c99\fP; link with \fI\-lm\fP. +Link with \fI\-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.\" I haven't fully grokked the source to determine the FTM requirements; +.\" in part, the following has been tested by experiment. +.ad l +.BR fpclassify (), +.BR isfinite (), +.BR isnormal (): +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.br +.BR isnan (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.br +.BR isinf (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION Floating point numbers can have special values, such as infinite or NaN. diff --git a/man3/futimes.3 b/man3/futimes.3 index ac7f004b4..644a22554 100644 --- a/man3/futimes.3 +++ b/man3/futimes.3 @@ -22,7 +22,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH FUTIMES 3 2006-03-06 "Linux" "Linux Programmer's Manual" +.TH FUTIMES 3 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME futimes \- change access and/or modification times of an open file .SH SYNOPSIS @@ -31,6 +31,14 @@ futimes \- change access and/or modification times of an open file .sp .BI "int futimes(int " fd ", const struct timeval " tv [2]); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR futimes (): +_BSD_SOURCE .SH DESCRIPTION .BR futimes () changes the access and modification times of a file in the same way as diff --git a/man3/fwide.3 b/man3/fwide.3 index 39a05fd60..b46ace722 100644 --- a/man3/fwide.3 +++ b/man3/fwide.3 @@ -11,7 +11,7 @@ .\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH FWIDE 3 1999-11-17 "GNU" "Linux Programmer's Manual" +.TH FWIDE 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME fwide \- set and determine the orientation of a FILE stream .SH SYNOPSIS @@ -20,6 +20,15 @@ fwide \- set and determine the orientation of a FILE stream .sp .BI "int fwide(FILE *" stream ", int " mode ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR fwide (): +_XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE; or +.I cc\ -std=c99 .SH DESCRIPTION When \fImode\fP is zero, the .BR fwide () diff --git a/man3/gamma.3 b/man3/gamma.3 index 4522fea3a..dd0cf474e 100644 --- a/man3/gamma.3 +++ b/man3/gamma.3 @@ -3,7 +3,7 @@ .\" .\" Modified 2003-11-18, aeb: historical remarks .\" -.TH GAMMA 3 2002-08-10 "GNU" "Linux Programmer's Manual" +.TH GAMMA 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME gamma, gammaf, gammal \- (logarithm of the) gamma function .SH SYNOPSIS @@ -16,6 +16,18 @@ gamma, gammaf, gammal \- (logarithm of the) gamma function .BI "long double gammal(long double " x ");" .sp Link with \fI-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR gamma (), +.BR gammaf (), +.BR gammal (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE +.ad b .SH DESCRIPTION For the definition of the Gamma function, see .BR tgamma (3). diff --git a/man3/gcvt.3 b/man3/gcvt.3 index 02e0795bc..d80198d0a 100644 --- a/man3/gcvt.3 +++ b/man3/gcvt.3 @@ -25,7 +25,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:32:25 1993 by Rik Faith (faith@cs.unc.edu) -.TH GCVT 3 1993-03-29 "" "Linux Programmer's Manual" +.TH GCVT 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME gcvt \- convert a floating-point number to a string .SH SYNOPSIS @@ -34,6 +34,14 @@ gcvt \- convert a floating-point number to a string .sp .BI "char *gcvt(double " number ", size_t " ndigit ", char *" buf ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR gcvt (): +_SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION The .BR gcvt () diff --git a/man3/getcwd.3 b/man3/getcwd.3 index ae9347a83..604d8c2df 100644 --- a/man3/getcwd.3 +++ b/man3/getcwd.3 @@ -27,25 +27,30 @@ .\" Modified Mon Dec 11 13:32:51 MET 2000 by aeb .\" Modified Thu Apr 22 03:49:15 CEST 2002 by Roger Luethi .\" -.TH GETCWD 3 2002-04-22 "GNU" "Linux Programmer's Manual" +.TH GETCWD 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME -getcwd, get_current_dir_name, getwd \- Get current working directory +getcwd, getwd, get_current_dir_name \- Get current working directory .SH SYNOPSIS .nf .B #include .sp .BI "char *getcwd(char *" buf ", size_t " size ); .sp -.B "#define _BSD_SOURCE /* Or: #define _XOPEN_SOURCE 500 */" -.B #include -.sp .BI "char *getwd(char *" buf ); .sp -.B #define _GNU_SOURCE -.B #include -.sp .B "char *get_current_dir_name(void);" .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR getcwd (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.br +.BR get_current_dir_name (): +_GNU_SOURCE .SH DESCRIPTION The .BR getcwd () @@ -184,5 +189,4 @@ many file descriptors are available, especially on platforms other than Linux. .BR open (2), .BR unlink (2), .BR free (3), -.BR malloc (3), -.BR feature_test_macros (7) +.BR malloc (3) diff --git a/man3/getdate.3 b/man3/getdate.3 index 8d378781a..b3d45b113 100644 --- a/man3/getdate.3 +++ b/man3/getdate.3 @@ -21,13 +21,11 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" .\" Modified, 2001-12-26, aeb -.TH GETDATE 3 2001-12-26 "" "Linux Programmer's Manual" +.TH GETDATE 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME getdate \- convert a string to struct tm .SH SYNOPSIS -.B "#define _XOPEN_SOURCE" -.br -.B "#define _XOPEN_SOURCE_EXTENDED +.B "#define _XOPEN_SOURCE 500" .br .B "#include " .sp diff --git a/man3/getdirentries.3 b/man3/getdirentries.3 index 6a8f02eca..36dd3e4ba 100644 --- a/man3/getdirentries.3 +++ b/man3/getdirentries.3 @@ -24,18 +24,23 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH GETDIRENTRIES 3 1993-07-22 "GNU" "Linux Programmer's Manual" +.TH GETDIRENTRIES 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME getdirentries \- get directory entries in a filesystem independent format .SH SYNOPSIS -.B #define _BSD_SOURCE -or -.B #define _SVID_SOURCE .br .B #include .sp .BI "ssize_t getdirentries(int " fd ", char *" buf ", size_t " nbytes .BI ", off_t *" basep ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR getdirentries (): +_BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION Read directory entries from the directory specified by .I fd @@ -67,5 +72,4 @@ and instead. .SH "SEE ALSO" .BR lseek (2), -.BR open (2), -.BR feature_test_macros (7) +.BR open (2) diff --git a/man3/getgrent.3 b/man3/getgrent.3 index 6c95b651b..4b934cb86 100644 --- a/man3/getgrent.3 +++ b/man3/getgrent.3 @@ -25,7 +25,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:29:54 1993 by Rik Faith (faith@cs.unc.edu) -.TH GETGRENT 3 1993-04-04 "" "Linux Programmer's Manual" +.TH GETGRENT 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME getgrent, setgrent, endgrent \- get group file entry .SH SYNOPSIS @@ -39,6 +39,18 @@ getgrent, setgrent, endgrent \- get group file entry .sp .B void endgrent(void); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR getgrent (), +.BR setgrent (), +.BR endgrent (): +_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.ad b .SH DESCRIPTION The .BR getgrent () diff --git a/man3/getgrent_r.3 b/man3/getgrent_r.3 index e67d0c346..8242f6049 100644 --- a/man3/getgrent_r.3 +++ b/man3/getgrent_r.3 @@ -20,13 +20,11 @@ .\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, .\" USA. .\" -.TH GETGRENT 3 2003-11-15 "GNU" "Linux Programmer's Manual" +.TH GETGRENT 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME getgrent_r, fgetgrent_r \- get group file entry reentrantly .SH SYNOPSIS .nf -.B "#define _GNU_SOURCE" -.br .B #include .sp .BI "int getgrent_r(struct group *" gbuf ", char *" buf , @@ -36,6 +34,19 @@ getgrent_r, fgetgrent_r \- get group file entry reentrantly .BI "int fgetgrent_r(FILE *" fp ", struct group *" gbuf ", char *" buf , .br .BI " size_t " buflen ", struct group **" gbufp ); +.fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR getgrent_r (): +_GNU_SOURCE +.\" FIXME . The FTM requirements seem inconsistent here. File a glibc bug? +.br +.BR fgetgrent_r (): +_SVID_SOURCE .SH DESCRIPTION The functions .BR getgrent_r () @@ -173,5 +184,4 @@ main(void) .BR getgrgid (3), .BR getgrnam (3), .BR putgrent (3), -.BR group (5), -.BR feature_test_macros (7) +.BR group (5) diff --git a/man3/getgrouplist.3 b/man3/getgrouplist.3 index b32a2750b..a94c11752 100644 --- a/man3/getgrouplist.3 +++ b/man3/getgrouplist.3 @@ -3,7 +3,7 @@ .\" Thanks to glibc info pages .\" .\" Modified 2003-11-18, aeb: glibc is broken -.TH GETGROUPLIST 3 2003-11-18 "GNU" "Linux Programmer's Manual" +.TH GETGROUPLIST 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME getgrouplist \- list of groups a user belongs to .SH SYNOPSIS @@ -11,8 +11,16 @@ getgrouplist \- list of groups a user belongs to .B #include .sp .BI "int getgrouplist(const char *" user ", gid_t " group , -.in 24 -.BI "gid_t *" groups ", int *" ngroups ); +.br +.BI " gid_t *" groups ", int *" ngroups ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR getgrouplist (): +_BSD_SOURCE .SH DESCRIPTION The .BR getgrouplist () diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3 index 296dbf1a5..427bb444f 100644 --- a/man3/gethostbyname.3 +++ b/man3/gethostbyname.3 @@ -33,7 +33,7 @@ .\" Modified 2002-08-05, Michael Kerrisk .\" Modified 2004-10-31, Andries Brouwer .\" -.TH GETHOSTBYNAME 3 2004-10-31 "" "Linux Programmer's Manual" +.TH GETHOSTBYNAME 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME gethostbyname, gethostbyaddr, sethostent, gethostent, endhostent, herror, hstrerror \- get network host entry @@ -76,6 +76,19 @@ herror, hstrerror \- get network host entry .BI " struct hostent *" ret ", char *" buf ", size_t " buflen , .BI " struct hostent **" result ", int *" h_errnop ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR gethostbyname2 (), +.BR gethostent_r (), +.BR gethostbyname_r (), +.BR gethostbyname2_r (): +_BSD_SOURCE || _SVID_SOURCE +.ad b .SH DESCRIPTION The .BR gethostbyname () diff --git a/man3/getlogin.3 b/man3/getlogin.3 index 80d961571..b2fb5e696 100644 --- a/man3/getlogin.3 +++ b/man3/getlogin.3 @@ -25,7 +25,7 @@ GNU.\" Hey Emacs! This file is -*- nroff -*- source. .\" Changed Tue Sep 19 01:49:29 1995, aeb: moved from man2 to man3 .\" added ref to /etc/utmp, added BUGS section, etc. .\" modified 2003 Walter Harms, aeb - added getlogin_r, note on stdin use -.TH GETLOGIN 3 2003-08-24 "GNU" "Linux Programmer's Manual" +.TH GETLOGIN 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME getlogin, getlogin_r, cuserid \- get user name .SH SYNOPSIS @@ -38,6 +38,17 @@ getlogin, getlogin_r, cuserid \- get user name .B #include .sp .BI "char *cuserid(char *" string ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR getlogin_r (): +_REENTRANT || _POSIX_C_SOURCE\ >=\ 199506L +.br +.BR cuserid (): +_XOPEN_SOURCE .SH DESCRIPTION .BR getlogin () returns a pointer to a string containing the name of diff --git a/man3/getmntent.3 b/man3/getmntent.3 index aea7a20b4..46e41a897 100644 --- a/man3/getmntent.3 +++ b/man3/getmntent.3 @@ -27,7 +27,7 @@ .\" Modified Sat Jul 24 21:46:57 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 961109, 031115, aeb .\" -.TH GETMNTENT 3 2003-11-15 "" "Linux Programmer's Manual" +.TH GETMNTENT 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME getmntent, setmntent, addmntent, endmntent, hasmntopt, getmntent_r \- get file system descriptor file entry @@ -47,12 +47,19 @@ getmntent_r \- get file system descriptor file entry .BI "char *hasmntopt(const struct mntent *" mnt ", const char *" opt ); .sp /* GNU extension */ -.BR "#define _GNU_SOURCE" " /* or _SVID_SOURCE or _BSD_SOURCE */" .B #include .sp .BI "struct mntent *getmntent_r(FILE *" fp ", struct mntent *" mntbuf , .BI " char *" buf ", int " buflen ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR gemntent_r (): +_BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION These routines are used to access the file system description file \fI/etc/fstab\fP and the mounted file system description file @@ -183,5 +190,4 @@ a wrapper around the system call .SH "SEE ALSO" .BR fopen (3), .BR fstab (5), -.BR feature_test_macros (7), .BR mount (8) diff --git a/man3/getpw.3 b/man3/getpw.3 index bcd7d978c..08861abd9 100644 --- a/man3/getpw.3 +++ b/man3/getpw.3 @@ -27,11 +27,12 @@ .\" Modified Sat Jul 24 19:23:25 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Mon May 27 21:37:47 1996 by Martin Schulze (joey@linux.de) .\" -.TH GETPW 3 1996-05-27 "GNU" "Linux Programmer's Manual" +.TH GETPW 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME getpw \- Re-construct password line entry .SH SYNOPSIS .nf +.B #define _GNU_SOURCE .B #include .B #include .sp diff --git a/man3/getpwent.3 b/man3/getpwent.3 index d4cc777b3..8ed2a16dd 100644 --- a/man3/getpwent.3 +++ b/man3/getpwent.3 @@ -28,7 +28,7 @@ .\" Modified Sat Jul 24 19:22:14 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Mon May 27 21:37:47 1996 by Martin Schulze (joey@linux.de) .\" -.TH GETPWENT 3 1996-05-27 "GNU" "Linux Programmer's Manual" +.TH GETPWENT 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME getpwent, setpwent, endpwent \- get password file entry .SH SYNOPSIS @@ -42,6 +42,18 @@ getpwent, setpwent, endpwent \- get password file entry .sp .B void endpwent(void); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR getpwent (), +.BR setpwent (), +.BR endpwent (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE > = 500 +.ad b .SH DESCRIPTION The .BR getpwent () diff --git a/man3/getpwent_r.3 b/man3/getpwent_r.3 index 0b332aa05..376bdc91f 100644 --- a/man3/getpwent_r.3 +++ b/man3/getpwent_r.3 @@ -20,13 +20,11 @@ .\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, .\" USA. .\" -.TH GETPWENT_R 3 2003-11-15 "GNU" "Linux Programmer's Manual" +.TH GETPWENT_R 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME getpwent_r, fgetpwent_r \- get passwd file entry reentrantly .SH SYNOPSIS .nf -.B "#define _GNU_SOURCE" -.br .B #include .sp .BI "int getpwent_r(struct passwd *" pwbuf ", char *" buf , @@ -36,6 +34,18 @@ getpwent_r, fgetpwent_r \- get passwd file entry reentrantly .BI "int fgetpwent_r(FILE *" fp ", struct passwd *" pwbuf ", char *" buf , .br .BI " size_t " buflen ", struct passwd **" pwbufp ); +.fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR getpwent_r (), +_BSD_SOURCE || _SVID_SOURCE +.br +.BR fgetpwent_r (): +_SVID_SOURCE .SH DESCRIPTION The functions .BR getpwent_r () @@ -171,5 +181,4 @@ main(void) .BR getpwnam (3), .BR getpwuid (3), .BR putpwent (3), -.BR passwd (5), -.BR feature_test_macros (7) +.BR passwd (5) diff --git a/man3/getpwnam.3 b/man3/getpwnam.3 index c335a2ab0..4aea9ca18 100644 --- a/man3/getpwnam.3 +++ b/man3/getpwnam.3 @@ -29,7 +29,7 @@ .\" Modified 1996-05-27 by Martin Schulze (joey@linux.de) .\" Modified 2003-11-15 by aeb .\" -.TH GETPWNAM 3 1996-05-27 "GNU" "Linux Programmer's Manual" +.TH GETPWNAM 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME getpwnam, getpwnam_r, getpwuid, getpwuid_r \- get password file entry .SH SYNOPSIS @@ -49,6 +49,17 @@ getpwnam, getpwnam_r, getpwuid, getpwuid_r \- get password file entry .br .BI " char *" buf ", size_t " buflen ", struct passwd **" pwbufp ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR getpwnam_r (), +.BR getpwuid_r (): +_POSIX_C_SOURCE || _XOPEN_SOURCE || _BSD_SOURCE || _SVID_SOURCE +.ad b .SH DESCRIPTION The .BR getpwnam () diff --git a/man3/getspnam.3 b/man3/getspnam.3 index 16bc54773..693d12619 100644 --- a/man3/getspnam.3 +++ b/man3/getspnam.3 @@ -3,7 +3,7 @@ .\" .\" Distributed under GPL .\" -.TH GETSPNAM 3 2003-11-15 "GNU" "Linux Programmer's Manual" +.TH GETSPNAM 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME getspnam, getspnam_r, getspent, getspent_r, setspent, endspent, fgetspent, fgetspent_r, sgetspent, sgetspent_r, putspent, @@ -34,8 +34,6 @@ lckpwdf, ulckpwdf \- get shadow password file entry .sp /* GNU extension */ .br -.BR "#define _SVID_SOURCE" " /* or _BSD_SOURCE */" -.br .B #include .sp .BI "int getspent_r(struct spwd *" spbuf , @@ -54,6 +52,19 @@ lckpwdf, ulckpwdf \- get shadow password file entry .br .BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR getspent_r (), +.BR getspnam_r (), +.BR fgetspent_r (), +.BR sgetspent_r (): +_BSD_SOURCE || _SVID_SOURCE +.ad b .SH DESCRIPTION Long ago it was considered safe to have encrypted passwords openly visible in the password file. @@ -231,5 +242,4 @@ However, many other systems provide a similar API. .BR getgrnam (3), .BR getpwnam (3), .BR getpwnam_r (3), -.BR shadow (5), -.BR feature_test_macros (7) +.BR shadow (5) diff --git a/man3/getumask.3 b/man3/getumask.3 index eeff3b3e9..93833804c 100644 --- a/man3/getumask.3 +++ b/man3/getumask.3 @@ -23,10 +23,12 @@ .\" This replaces an earlier man page written by Walter Harms .\" . .\" -.TH GETUMASK 3 2002-08-25 "GNU" "Linux Programmer's Manual" +.TH GETUMASK 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME getumask \- get file creation mask .SH SYNOPSIS +.B #define _GNU_SOURCE +.br .B "#include " .br .B "#include " diff --git a/man3/getusershell.3 b/man3/getusershell.3 index f2dc3d3cf..7f7a6e063 100644 --- a/man3/getusershell.3 +++ b/man3/getusershell.3 @@ -25,7 +25,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:17:53 1993 by Rik Faith (faith@cs.unc.edu) -.TH GETUSERSHELL 3 1993-07-04 "GNU" "Linux Programmer's Manual" +.TH GETUSERSHELL 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME getusershell, setusershell, endusershell \- get legal user shells .SH SYNOPSIS @@ -38,6 +38,18 @@ getusershell, setusershell, endusershell \- get legal user shells .sp .B void endusershell(void); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR getusershell (), +.BR setusershell (), +.BR endusershell (): +_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) +.ad b .SH DESCRIPTION The .BR getusershell () diff --git a/man3/gsignal.3 b/man3/gsignal.3 index cb4899a38..c27a3decd 100644 --- a/man3/gsignal.3 +++ b/man3/gsignal.3 @@ -22,7 +22,7 @@ .\" .\" This replaces an earlier man page written by Walter Harms .\" . -.TH GSIGNAL 3 2002-08-25 "" "Linux Programmer's Manual" +.TH GSIGNAL 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME gsignal, ssignal \- software signal facility .SH SYNOPSIS @@ -34,6 +34,16 @@ gsignal, ssignal \- software signal facility .BI "int gsignal(" signum ); .sp .BI "sighandler_t ssignal(int " signum ", sighandler_t " action ); +.fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR gsignal (), +.BR ssignal (): +_SVID_SOURCE .SH DESCRIPTION Don't use these functions under Linux. Due to a historical mistake, under Linux these functions are diff --git a/man3/hypot.3 b/man3/hypot.3 index 852e94f83..c209394b9 100644 --- a/man3/hypot.3 +++ b/man3/hypot.3 @@ -28,7 +28,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH HYPOT 3 2002-07-27 "" "Linux Programmer's Manual" +.TH HYPOT 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME hypot, hypotf, hypotl \- Euclidean distance function .SH SYNOPSIS @@ -43,6 +43,19 @@ hypot, hypotf, hypotl \- Euclidean distance function .fi .sp Link with \fI-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR hypot (), +.BR hypotf (), +.BR hypotl (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION The .BR hypot () diff --git a/man3/inet.3 b/man3/inet.3 index 6be9fcff4..001f45618 100644 --- a/man3/inet.3 +++ b/man3/inet.3 @@ -32,7 +32,7 @@ .\" Changed network into host byte order (for inet_network), .\" Andreas Jaeger , 980130. .\" -.TH INET 3 2001-07-25 "GNU" "Linux Programmer's Manual" +.TH INET 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME inet_aton, inet_addr, inet_network, inet_ntoa, inet_makeaddr, inet_lnaof, inet_netof \- Internet address manipulation routines @@ -56,6 +56,15 @@ inet_netof \- Internet address manipulation routines .sp .BI "in_addr_t inet_netof(struct in_addr " in ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR inet_aton (), +.BR inet_ntoa (): +_BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION .BR inet_aton () converts the Internet host address \fIcp\fP from the @@ -150,15 +159,6 @@ 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. -.SS Glibc Notes -In order to expose the declaration of -.BR inet_aton (), -one of the feature test macros -.BR _BSD_SOURCE , -.BR _SVID_SOURCE , -or -.B _GNU_SOURCE -must be defined. .SH "SEE ALSO" .BR gethostbyname (3), .BR getnetent (3), diff --git a/man3/initgroups.3 b/man3/initgroups.3 index bf1956032..7f7fe84be 100644 --- a/man3/initgroups.3 +++ b/man3/initgroups.3 @@ -27,7 +27,7 @@ .\" Modified 1993-07-24 by Rik Faith .\" Modified 2004-10-10 by aeb .\" -.TH INITGROUPS 3 2004-10-10 "GNU" "Linux Programmer's Manual" +.TH INITGROUPS 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME initgroups \- initialize the supplementary group access list .SH SYNOPSIS @@ -37,6 +37,14 @@ initgroups \- initialize the supplementary group access list .sp .BI "int initgroups(const char *" user ", gid_t " group ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR initgroups (): +_BSD_SOURCE .SH DESCRIPTION The .BR initgroups () @@ -71,12 +79,6 @@ See the underlying system call .fi .SH "CONFORMING TO" SVr4, 4.3BSD -.SH NOTES -The prototype for -.BR initgroups () -is only available if -.B _BSD_SOURCE -is defined. .SH "SEE ALSO" .BR getgroups (2), .BR setgroups (2), diff --git a/man3/insque.3 b/man3/insque.3 index 974b1860a..615e1b430 100644 --- a/man3/insque.3 +++ b/man3/insque.3 @@ -28,7 +28,7 @@ .\" .\" Changed to POSIX, 2003-08-11, aeb+wh .\" -.TH INSQUE 3 2003-08-11 "" "Linux Programmer's Manual" +.TH INSQUE 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME insque, remque \- insert/remove an item from a queue .SH SYNOPSIS @@ -37,6 +37,16 @@ insque, remque \- insert/remove an item from a queue .sp .BI "void insque(void *" elem ", void *" prev ); .BI "void remque(void *" elem ); +.fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR insque (), +.BR remque (): +_SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION .BR insque () and @@ -65,9 +75,9 @@ is defined as .RS .nf struct qelem { - struct qelem *q_forw; - struct qelem *q_back; - char q_data[1]; + struct qelem *q_forw; + struct qelem *q_back; + char q_data[1]; }; .fi .RE diff --git a/man3/isalpha.3 b/man3/isalpha.3 index a07514a06..45a321186 100644 --- a/man3/isalpha.3 +++ b/man3/isalpha.3 @@ -26,7 +26,7 @@ .\" Modified Sat Sep 2 21:52:01 1995 by Jim Van Zandt .\" Modified Mon May 27 22:55:26 1996 by Martin Schulze (joey@linux.de) .\" -.TH ISALPHA 3 1995-09-02 "GNU" "Linux Programmer's Manual" +.TH ISALPHA 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME isalnum, isalpha, isascii, isblank, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper, isxdigit \- character @@ -61,6 +61,20 @@ classification routines .br .BI "int isxdigit(int " "c" ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR isascii (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE +.br +.BR isblank (): +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION These functions check whether .IR c , diff --git a/man3/iswblank.3 b/man3/iswblank.3 index 535ddf6d5..366507d8d 100644 --- a/man3/iswblank.3 +++ b/man3/iswblank.3 @@ -11,7 +11,7 @@ .\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH ISWBLANK 3 1999-07-25 "GNU" "Linux Programmer's Manual" +.TH ISWBLANK 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME iswblank \- test for whitespace wide character .SH SYNOPSIS @@ -20,6 +20,17 @@ iswblank \- test for whitespace wide character .sp .BI "int iswblank(wint_t " wc ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR iswblank (): +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION The .BR iswblank () diff --git a/man3/j0.3 b/man3/j0.3 index 5233aa545..973ae6b2b 100644 --- a/man3/j0.3 +++ b/man3/j0.3 @@ -28,13 +28,12 @@ .\" Modified 2002-08-25, aeb .\" Modified 2004-11-12 as per suggestion by Fabian Kreutz/AEB .\" -.TH J0 3 2002-08-25 "" "Linux Programmer's Manual" +.TH J0 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME j0, j0f, j0l, j1, j1f, j1l, jn, jnf, jnl, y0, y0f, y0l, y1, y1f, y1l, yn, ynf, ynl \- Bessel functions .SH SYNOPSIS .nf -.B #define _GNU_SOURCE .B #include .sp .BI "double j0(double " x ); @@ -75,6 +74,16 @@ y0, y0f, y0l, y1, y1f, y1l, yn, ynf, ynl \- Bessel functions .fi .sp Link with \fI-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +For all of these functions: +_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE +.ad b .SH DESCRIPTION The .BR j0 () @@ -130,5 +139,3 @@ There are errors of up to 2e\-16 in the values returned by and .BR jn () for values of \fIx\fP between \-8 and 8. -.SH "SEE ALSO" -.BR feature_test_macros (7) diff --git a/man3/lgamma.3 b/man3/lgamma.3 index de55739b4..199ecad01 100644 --- a/man3/lgamma.3 +++ b/man3/lgamma.3 @@ -2,9 +2,10 @@ .\" Distributed under GPL .\" based on glibc infopages .\" -.TH LGAMMA 3 2002-08-10 "" "Linux Programmer's Manual" +.TH LGAMMA 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME -lgamma, lgammaf, lgammal, lgamma_r, lgammaf_r, lgammal_r \- log gamma function +lgamma, lgammaf, lgammal, lgamma_r, lgammaf_r, lgammal_r, signgam \- +log gamma function .SH SYNOPSIS .nf .B #include @@ -20,9 +21,32 @@ lgamma, lgammaf, lgammal, lgamma_r, lgammaf_r, lgammal_r \- log gamma function .BI "float lgammaf_r(float " x ", int *" signp ); .br .BI "long double lgammal_r(long double " x ", int *" signp ); +.br +.BI "extern int " signgam ; .fi .sp -Compile with \fI\-std=c99\fP; link with \fI\-lm\fP. +Link with \fI\-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR lgamma (), +.BR lgammaf (), +.BR lgammal (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.br +.BR lgamma_r (), +.BR lgammaf_r (), +.BR lgammal_r (): +_BSD_SOURCE || _SVID_SOURCE +.br +.IR signgam : +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE +.ad b .SH DESCRIPTION For the definition of the Gamma function, see .BR tgamma (3). diff --git a/man3/lockf.3 b/man3/lockf.3 index 9531686a0..827e4a50c 100644 --- a/man3/lockf.3 +++ b/man3/lockf.3 @@ -19,13 +19,21 @@ .\" Added section stuff, aeb, 2002-04-22. .\" Corrected include file, drepper, 2003-06-15. .\" -.TH LOCKF 3 2002-04-22 "GNU" "Linux Programmer's Manual" +.TH LOCKF 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME lockf \- apply, test or remove a POSIX lock on an open file .SH SYNOPSIS .B #include .sp .BI "int lockf(int " fd ", int " cmd ", off_t " len ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR lockf (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION Apply, test or remove a POSIX lock on a section of an open file. The file is specified by diff --git a/man3/log1p.3 b/man3/log1p.3 index 1c9d85faa..213839dae 100644 --- a/man3/log1p.3 +++ b/man3/log1p.3 @@ -22,7 +22,7 @@ .\" .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) -.TH LOG1P 3 2002-07-27 "" "Linux Programmer's Manual" +.TH LOG1P 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME log1p \- logarithm of 1 plus argument .SH SYNOPSIS @@ -36,7 +36,20 @@ log1p \- logarithm of 1 plus argument .BI "long double log1pl(long double " x ); .sp .fi -Compile with \fI\-std=c99\fP; link with \fI\-lm\fP. +Link with \fI\-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR log1p (), +.BR log1pf (), +.BR log1pl (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION .BI log1p( x ) returns a value equivalent to `log (1 + \fIx\fP)'. diff --git a/man3/log2.3 b/man3/log2.3 index 7a7d5e384..128b4638e 100644 --- a/man3/log2.3 +++ b/man3/log2.3 @@ -29,7 +29,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH LOG2 3 2002-07-27 "" "Linux Programmer's Manual" +.TH LOG2 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME log2, log2f, log2l \- base-2 logarithmic function .SH SYNOPSIS @@ -43,7 +43,20 @@ log2, log2f, log2l \- base-2 logarithmic function .BI "long double log2l(long double " x ); .fi .sp -Compile with \fI\-std=c99\fP; link with \fI\-lm\fP. +Link with \fI\-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR log2 (), +.BR log2f (), +.BR log2l (): +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION The .BR log2 () diff --git a/man3/logb.3 b/man3/logb.3 index 08e63b77f..50617ec3f 100644 --- a/man3/logb.3 +++ b/man3/logb.3 @@ -22,7 +22,7 @@ .\" .\" Inspired by a page by Walter Harms created 2002-08-10 .\" -.TH LOGB 3 2004-10-31 "" "Linux Programmer's Manual" +.TH LOGB 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME logb, logbf, logbl \- get exponent of a floating point value .SH SYNOPSIS @@ -35,6 +35,19 @@ logb, logbf, logbl \- get exponent of a floating point value .BI "long double logbl(long double " x ); .sp Link with \fI-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR logb (), +.BR logbf (), +.BR logbl (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION These functions extract the exponent of .I x diff --git a/man3/longjmp.3 b/man3/longjmp.3 index b8c4b6cae..42cd7d0b8 100644 --- a/man3/longjmp.3 +++ b/man3/longjmp.3 @@ -23,7 +23,7 @@ .\" Added siglongjmp, Sun Mar 2 22:03:05 EST 1997, jrv@vanzandt.mv.com .\" Modifications, Sun Feb 26 14:39:45 1995, faith@cs.unc.edu .\" " -.TH LONGJMP 3 1997-03-02 "" "Linux Programmer's Manual" +.TH LONGJMP 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME longjmp, siglongjmp \- non-local jump to a saved stack context .SH SYNOPSIS @@ -35,6 +35,14 @@ longjmp, siglongjmp \- non-local jump to a saved stack context .BI "void siglongjmp(sigjmp_buf " env ", int " val ); .fi .ad b +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR siglongjmp (): +_POSIX_C_SOURCE || _XOPEN_SOURCE .SH DESCRIPTION .BR longjmp () and diff --git a/man3/lrint.3 b/man3/lrint.3 index eb8d8e456..3de530c22 100644 --- a/man3/lrint.3 +++ b/man3/lrint.3 @@ -20,7 +20,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH LRINT 3 2001-05-31 "" "Linux Programmer's Manual" +.TH LRINT 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME lrint, lrintf, lrintl, llrint, llrintf, llrintl \- round to nearest integer .SH SYNOPSIS @@ -40,7 +40,18 @@ lrint, lrintf, lrintl, llrint, llrintf, llrintl \- round to nearest integer .BI "long long int llrintl(long double " x ); .fi .sp -Compile with \fI\-std=c99\fP; link with \fI\-lm\fP. +Link with \fI\-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +All functions shown above: +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION These functions round their argument to the nearest integer value, using the current rounding direction. diff --git a/man3/lround.3 b/man3/lround.3 index 71cb789a3..b4893c660 100644 --- a/man3/lround.3 +++ b/man3/lround.3 @@ -20,7 +20,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH LROUND 3 2001-05-31 "" "Linux Programmer's Manual" +.TH LROUND 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME lround, lroundf, lroundl, llround, llroundf, llroundl \- round to nearest integer, away from zero @@ -41,7 +41,18 @@ nearest integer, away from zero .BI "long long int llroundl(long double " x ); .fi .sp -Compile with \fI\-std=c99\fP; link with \fI\-lm\fP. +Link with \fI\-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +All functions shown above: +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION These functions round their argument to the nearest integer value, rounding away from zero, regardless of the current rounding direction. diff --git a/man3/mbsnrtowcs.3 b/man3/mbsnrtowcs.3 index 17f90ed3d..46231fb37 100644 --- a/man3/mbsnrtowcs.3 +++ b/man3/mbsnrtowcs.3 @@ -10,11 +10,12 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html .\" -.TH MBSNRTOWCS 3 1999-07-25 "GNU" "Linux Programmer's Manual" +.TH MBSNRTOWCS 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME mbsnrtowcs \- convert a multibyte string to a wide-character string .SH SYNOPSIS .nf +.B #define _GNU_SOURCE .B #include .sp .BI "size_t mbsnrtowcs(wchar_t *" dest ", const char **" src , diff --git a/man3/memfrob.3 b/man3/memfrob.3 index ce0fcd6ce..316e583e8 100644 --- a/man3/memfrob.3 +++ b/man3/memfrob.3 @@ -25,11 +25,12 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:54:45 1993 by Rik Faith (faith@cs.unc.edu) -.TH MEMFROB 3 1993-04-12 "GNU" "Linux Programmer's Manual" +.TH MEMFROB 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME memfrob \- frobnicate (encrypt) a memory area .SH SYNOPSIS .nf +.B #define _GNU_SOURCE .B #include .sp .BI "void *memfrob(void *" s ", size_t " n ); diff --git a/man3/mkdtemp.3 b/man3/mkdtemp.3 index b8aa2ba16..642b1ae25 100644 --- a/man3/mkdtemp.3 +++ b/man3/mkdtemp.3 @@ -21,7 +21,7 @@ .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. -.TH MKDTEMP 3 2001-10-07 "GNU" "Linux Programmer's Manual" +.TH MKDTEMP 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME mkdtemp \- create a unique temporary directory .SH SYNOPSIS @@ -30,6 +30,14 @@ mkdtemp \- create a unique temporary directory .sp .BI "char *mkdtemp(char *" template ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR mkdtemp (): +_BSD_SOURCE .SH DESCRIPTION The .BR mkdtemp () diff --git a/man3/mkstemp.3 b/man3/mkstemp.3 index aeb58d780..634656fe6 100644 --- a/man3/mkstemp.3 +++ b/man3/mkstemp.3 @@ -28,7 +28,7 @@ .\" Modified 980310, aeb .\" Modified 990328, aeb .\" -.TH MKSTEMP 3 2001-12-23 "GNU" "Linux Programmer's Manual" +.TH MKSTEMP 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME mkstemp \- create a unique temporary file .SH SYNOPSIS @@ -37,6 +37,14 @@ mkstemp \- create a unique temporary file .sp .BI "int mkstemp(char *" template ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR mkstemp (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION The .BR mkstemp () diff --git a/man3/mktemp.3 b/man3/mktemp.3 index ed13ab4ae..886073147 100644 --- a/man3/mktemp.3 +++ b/man3/mktemp.3 @@ -29,7 +29,7 @@ .\" (prompted by Scott Burkett ) .\" Modified Sun Mar 28 23:44:38 1999 by Andries Brouwer (aeb@cwi.nl) .\" -.TH MKTEMP 3 1993-04-03 "GNU" "Linux Programmer's Manual" +.TH MKTEMP 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME mktemp \- make a unique temporary filename .SH SYNOPSIS @@ -38,6 +38,14 @@ mktemp \- make a unique temporary filename .sp .BI "char *mktemp(char *" template ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR mktemp (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION The .BR mktemp () diff --git a/man3/nan.3 b/man3/nan.3 index c80750d55..ec78471cd 100644 --- a/man3/nan.3 +++ b/man3/nan.3 @@ -3,7 +3,7 @@ .\" Based on glibc infopages .\" .\" Corrections by aeb -.TH NAN 3 2002-08-10 "GNU" "Linux Programmer's Manual" +.TH NAN 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME nan, nanf, nanl \- return 'Not a Number' .SH SYNOPSIS @@ -16,6 +16,17 @@ nan, nanf, nanl \- return 'Not a Number' .BI "long double nanl(const char *" tagp ); .sp Compile with \fI\-std=c99\fP; link with \fI\-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR nan (), +.BR nanf (), +.BR nanl (): +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 .SH DESCRIPTION These functions return a representation (determined by .IR tagp ) diff --git a/man3/nextafter.3 b/man3/nextafter.3 index bfc260f72..6683f7c2e 100644 --- a/man3/nextafter.3 +++ b/man3/nextafter.3 @@ -1,7 +1,7 @@ .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de) .\" Distributed under GPL .\" Based on glibc infopages -.TH NEXTAFTER 3 2002-08-10 "GNU" "Linux Programmer's Manual" +.TH NEXTAFTER 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME nextafter, nextafterf, nextafterl, nexttoward, nexttowardf, nexttowardl \- floating point number manipulation @@ -21,6 +21,17 @@ floating point number manipulation .BI "long double nexttowardl(long double " x ", long double " y ); .sp Link with \fI-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +All functions shown above: +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION The .BR nextafter () diff --git a/man3/on_exit.3 b/man3/on_exit.3 index f0aa4f49e..3741be8e3 100644 --- a/man3/on_exit.3 +++ b/man3/on_exit.3 @@ -26,7 +26,7 @@ .\" 386BSD man pages .\" Modified 1993-04-02, David Metcalfe .\" Modified 1993-07-25, Rik Faith (faith@cs.unc.edu) -.TH ON_EXIT 3 1993-04-02 "GNU" "Linux Programmer's Manual" +.TH ON_EXIT 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME on_exit \- register a function to be called at normal process termination .SH SYNOPSIS @@ -35,6 +35,14 @@ on_exit \- register a function to be called at normal process termination .sp .BI "int on_exit(void (*" function ")(int , void *), void *" arg ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR on_exit (): +_BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION The .BR on_exit () diff --git a/man3/perror.3 b/man3/perror.3 index 99b824b89..458237108 100644 --- a/man3/perror.3 +++ b/man3/perror.3 @@ -27,7 +27,7 @@ .\" (msmith@falcon.mercer.peachnet.edu) and various other changes. .\" Modified 1996-05-16 by Martin Schulze (joey@infodrom.north.de) .\" -.TH PERROR 3 2001-12-14 "" "Linux Programmer's Manual" +.TH PERROR 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME perror \- print a system error message .SH SYNOPSIS @@ -42,6 +42,15 @@ perror \- print a system error message .BI "int " sys_nerr ; .br .BI "int " errno ; +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.IR sys_errlist , +.IR sys_nerr : +_BSD_SOURCE .SH DESCRIPTION The routine .BR perror () @@ -117,8 +126,8 @@ are defined by glibc, but in .IR . .\" and only when _BSD_SOURCE is defined. .\" When -.B _GNU_SOURCE -is defined, the symbols +.\" .B _GNU_SOURCE +.\" is defined, the symbols .\" .I _sys_nerr .\" and .\" .I _sys_errlist diff --git a/man3/posix_memalign.3 b/man3/posix_memalign.3 index 4e4e663ff..c231ef456 100644 --- a/man3/posix_memalign.3 +++ b/man3/posix_memalign.3 @@ -23,12 +23,11 @@ .\" License. .\" .\" 2001-10-11, 2003-08-22, aeb, added some details -.TH POSIX_MEMALIGN 3 2003-08-22 "GNU" "Linux Programmer's Manual" +.TH POSIX_MEMALIGN 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME posix_memalign, memalign, valloc \- Allocate aligned memory .SH SYNOPSIS .nf -.B #define _XOPEN_SOURCE 600 .B #include .sp .BI "int posix_memalign(void **" memptr ", size_t " alignment ", size_t " size ); @@ -38,6 +37,16 @@ posix_memalign, memalign, valloc \- Allocate aligned memory .BI "void *valloc(size_t " size ); .BI "void *memalign(size_t " boundary ", size_t " size ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR posix_memalign (): +_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600 +.ad b .SH DESCRIPTION The function .BR posix_memalign () @@ -117,11 +126,6 @@ comes from POSIX.1d. Everybody agrees that .BR posix_memalign () is declared in \fI\fP. -In order to declare it, glibc needs -.B _GNU_SOURCE -defined, or -.B _XOPEN_SOURCE -defined to a value not less than 600. On some systems .BR memalign () @@ -195,5 +199,4 @@ needed if you require larger alignment values. .BR brk (2), .BR getpagesize (2), .BR free (3), -.BR malloc (3), -.BR feature_test_macros (7) +.BR malloc (3) diff --git a/man3/posix_openpt.3 b/man3/posix_openpt.3 index 99b1ca4f8..56ceeac0a 100644 --- a/man3/posix_openpt.3 +++ b/man3/posix_openpt.3 @@ -22,18 +22,26 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH POSIX_OPENPT 3 2007-01-08 "" "Linux Programmer's Manual" +.TH POSIX_OPENPT 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME posix_openpt \- open a pseudo-terminal device .SH SYNOPSIS .nf -.B #define _XOPEN_SOURCE 600 -.br .B #include .B #include .sp .BI "int posix_openpt(int " flags ");" .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR posix_openpt (): +_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600 +.ad b .SH DESCRIPTION The .BR posix_openpt () @@ -93,5 +101,4 @@ posix_openpt(int flags) .BR ptsname (3), .BR unlockpt (3), .BR pts (4), -.BR feature_test_macros (7), .BR pty (7) diff --git a/man3/printf.3 b/man3/printf.3 index 18e4b74a8..de581f954 100644 --- a/man3/printf.3 +++ b/man3/printf.3 @@ -31,7 +31,7 @@ .\" 2000-07-26 jsm28@hermes.cam.ac.uk - three small fixes .\" 2000-10-16 jsm28@hermes.cam.ac.uk - more fixes .\" -.TH PRINTF 3 2000-10-16 "GNU" "Linux Programmer's Manual" +.TH PRINTF 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME printf, fprintf, sprintf, snprintf, vprintf, vfprintf, vsprintf, vsnprintf \- formatted output conversion .SH SYNOPSIS @@ -54,6 +54,19 @@ printf, fprintf, sprintf, snprintf, vprintf, vfprintf, vsprintf, vsnprintf \- fo .BI "int vsprintf(char *" str ", const char *" format ", va_list " ap ); .br .BI "int vsnprintf(char *" str ", size_t " size ", const char *" format ", va_list " ap ); +.ad +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR snprintf (), +.BR vsnprintf (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE; or +.I "cc -std=c99" +.ad b .SH DESCRIPTION The functions in the .BR printf () @@ -878,9 +891,9 @@ Use and .BR vsnprintf () instead (or -.BR asprintf () +.BR asprintf (3) and -.BR vasprintf (). +.BR vasprintf (3). .PP Linux libc4.[45] does not have a .BR snprintf (), diff --git a/man3/profil.3 b/man3/profil.3 index 6364a2ad8..790d1c9cd 100644 --- a/man3/profil.3 +++ b/man3/profil.3 @@ -25,13 +25,21 @@ .\" Modified Fri Jun 23 01:35:19 1995 Andries Brouwer .\" (prompted by Bas V. de Bakker ) .\" Corrected (and moved to man3), 980612, aeb -.TH PROFIL 3 1993-07-23 "Linux" "Linux Programmer's Manual" +.TH PROFIL 3 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME profil \- execution time profile .SH SYNOPSIS .B #include .sp .BI "int profil(u_short *" buf ", size_t " bufsiz ", size_t " offset ", u_int " scale ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR profil (): +_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) .SH DESCRIPTION This routine provides a means to find out in what areas your program spends most of its time. diff --git a/man3/psignal.3 b/man3/psignal.3 index de8eb85ca..c441c09ad 100644 --- a/man3/psignal.3 +++ b/man3/psignal.3 @@ -25,7 +25,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:45:17 1993 by Rik Faith (faith@cs.unc.edu) -.TH PSIGNAL 3 1993-04-13 "GNU" "Linux Programmer's Manual" +.TH PSIGNAL 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME psignal \- print signal message .SH SYNOPSIS @@ -36,6 +36,17 @@ psignal \- print signal message .sp .BI "extern const char *const " sys_siglist []; .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR psignal (): +_SVID_SOURCE || _BSD_SOURCE +.br +.IR sys_siglist : +_BSD_SOURCE .SH DESCRIPTION The .BR psignal () diff --git a/man3/putenv.3 b/man3/putenv.3 index 046a716fc..331a7ff52 100644 --- a/man3/putenv.3 +++ b/man3/putenv.3 @@ -31,7 +31,7 @@ .\" Modified Mon Oct 11 11:11:11 1999 by Andries Brouwer (aeb@cwi.nl) .\" Modified Wed Nov 10 00:02:26 1999 by Andries Brouwer (aeb@cwi.nl) .\" Modified Sun May 20 22:17:20 2001 by Andries Brouwer (aeb@cwi.nl) -.TH PUTENV 3 1993-04-08 "GNU" "Linux Programmer's Manual" +.TH PUTENV 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME putenv \- change or add an environment variable .SH SYNOPSIS @@ -41,6 +41,14 @@ putenv \- change or add an environment variable .BI "int putenv(char *" string ); .\" Not: const char * .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR putenv (): +_SVID_SOURCE || _XOPEN_SOURCE .SH DESCRIPTION The .BR putenv () diff --git a/man3/putpwent.3 b/man3/putpwent.3 index 7e1239ab5..342963219 100644 --- a/man3/putpwent.3 +++ b/man3/putpwent.3 @@ -25,7 +25,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:43:46 1993 by Rik Faith (faith@cs.unc.edu) -.TH PUTPWENT 3 1993-04-09 "GNU" "Linux Programmer's Manual" +.TH PUTPWENT 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME putpwent \- write a password file entry .SH SYNOPSIS @@ -36,6 +36,14 @@ putpwent \- write a password file entry .sp .BI "int putpwent(const struct passwd *" p ", FILE *" stream ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR putpwent (): +_SVID_SOURCE .SH DESCRIPTION The .BR putpwent () diff --git a/man3/qecvt.3 b/man3/qecvt.3 index 7bb9965e8..0654c74c0 100644 --- a/man3/qecvt.3 +++ b/man3/qecvt.3 @@ -23,7 +23,7 @@ .\" This replaces an earlier man page written by Walter Harms .\" . .\" -.TH QECVT 3 2002-08-25 "GNU" "Linux Programmer's Manual" +.TH QECVT 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME qecvt, qfcvt, qgcvt \- convert a floating-point number to a string .SH SYNOPSIS @@ -36,6 +36,17 @@ qecvt, qfcvt, qgcvt \- convert a floating-point number to a string .BI "int *" sign ); .sp .BI "char *qgcvt(long double " number ", int " ndigit ", char *" buf ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR qecvt (), +.BR qfcvt (), +.BR qgcvt (): +.br +_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION The functions .BR qecvt (), diff --git a/man3/rand.3 b/man3/rand.3 index 6839a1cea..9a11b14db 100644 --- a/man3/rand.3 +++ b/man3/rand.3 @@ -35,7 +35,7 @@ .\" with contribution from Francesco Potorti .\" Modified 2003-11-15, aeb, added rand_r .\" -.TH RAND 3 2003-11-15 "" "Linux Programmer's Manual" +.TH RAND 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME rand, rand_r, srand \- pseudo-random number generator .SH SYNOPSIS @@ -48,6 +48,14 @@ rand, rand_r, srand \- pseudo-random number generator .sp .BI "void srand(unsigned int " seed ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR rand_r (): +_POSIX_C_SOURCE || _XOPEN_SOURCE .SH DESCRIPTION The .BR rand () diff --git a/man3/random.3 b/man3/random.3 index bcf683fdb..d136b8eac 100644 --- a/man3/random.3 +++ b/man3/random.3 @@ -28,7 +28,7 @@ .\" Modified Sat Jul 24 18:13:39 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Sun Aug 20 21:47:07 2000, aeb .\" -.TH RANDOM 3 2000-08-20 "GNU" "Linux Programmer's Manual" +.TH RANDOM 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME random, srandom, initstate, setstate \- random number generator .SH SYNOPSIS @@ -43,6 +43,19 @@ random, srandom, initstate, setstate \- random number generator .br .BI "char *setstate(char *" state ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR random (), +.BR srandom (), +.BR initstate (), +.BR setstate (): +_SVID_SOURCE || |_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.ad b .SH DESCRIPTION The .BR random () diff --git a/man3/rcmd.3 b/man3/rcmd.3 index a331762cb..b492cb1a9 100644 --- a/man3/rcmd.3 +++ b/man3/rcmd.3 @@ -54,6 +54,8 @@ .Fn iruserok "u_int32_t raddr" "int superuser" "const char *ruser" "const char *luser" .Ft int .Fn ruserok "const char *rhost" "int superuser" "const char *ruser" "const char *luser" +.\" These functions require _BSD_SOURCE on Linux +.\" FIXME: . does iruserok() really exits on Linux? .Sh DESCRIPTION The .Fn rcmd diff --git a/man3/realpath.3 b/man3/realpath.3 index b3ea07e8a..4f503c2ed 100644 --- a/man3/realpath.3 +++ b/man3/realpath.3 @@ -23,7 +23,7 @@ .\" Rewritten old page, 990824, aeb@cwi.nl .\" 2004-12-14, mtk, added discussion of resolved_path == NULL .\" -.TH REALPATH 3 2004-12-14 "" "Linux Programmer's Manual" +.TH REALPATH 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME realpath \- return the canonicalized absolute pathname .SH SYNOPSIS @@ -32,6 +32,15 @@ realpath \- return the canonicalized absolute pathname .B #include .sp .BI "char *realpath(const char *" path ", char *" resolved_path ); +.fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR realpath (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION .BR realpath () expands all symbolic links and resolves references diff --git a/man3/remainder.3 b/man3/remainder.3 index 2f5d1a6c2..6d89a1e66 100644 --- a/man3/remainder.3 +++ b/man3/remainder.3 @@ -30,7 +30,7 @@ .\" (walter.harms@informatik.uni-oldenburg.de) .\" Modified 2003-11-18, 2004-10-05 aeb .\" -.TH REMAINDER 3 2003-11-18 "" "Linux Programmer's Manual" +.TH REMAINDER 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME drem, dremf, dreml, remainder, remainderf, remainderl \- \ floating-point remainder function @@ -50,6 +50,24 @@ floating-point remainder function .sp .fi Link with \fI-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR remainder (), +.BR remainderf (), +.BR remainderl (): +_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.br +.BR drem (), +.BR dremf (), +.BR dreml (): +_SVID_SOURCE || _BSD_SOURCE +.ad b .SH DESCRIPTION The .BR remainder () diff --git a/man3/remquo.3 b/man3/remquo.3 index 53366bf04..7cf0efb04 100644 --- a/man3/remquo.3 +++ b/man3/remquo.3 @@ -2,13 +2,11 @@ .\" Distributed under GPL .\" based on glibc infopages .\" polished, aeb -.TH REMQUO 3 2002-08-10 "GNU" "Linux Programmer's Manual" +.TH REMQUO 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME remquo, remquof, remquol \- remainder and part of quotient .SH SYNOPSIS .nf -#define _ISOC99_SOURCE -.br .B #include .sp .BI "double remquo(double " x ", double " y ", int *" quo ); @@ -17,6 +15,21 @@ remquo, remquof, remquol \- remainder and part of quotient .br .BI "long double remquol(long double " x ", long double " y ", int *" quo ); .fi +.sp +Link with \fI\-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR remquo (), +.BR remquof (), +.BR remquol (): +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION These functions compute the remainder and part of the quotient upon division of @@ -50,5 +63,4 @@ C99 .SH "SEE ALSO" .BR fmod (3), .BR logb (3), -.BR remainder (3), -.BR feature_test_macros (7) +.BR remainder (3) diff --git a/man3/rexec.3 b/man3/rexec.3 index b6f57920a..ba61a83ad 100644 --- a/man3/rexec.3 +++ b/man3/rexec.3 @@ -45,6 +45,7 @@ .Sh SYNOPSIS .Ft int .Fn rexec "char **ahost" "int inport" "char *user" "char *passwd" "char *cmd" "int *fd2p" +.\" This function requires _BSD_SOURCE on Linux .Sh DESCRIPTION .Bf -symbolic This interface is obsoleted by diff --git a/man3/rint.3 b/man3/rint.3 index 6ef90ce5b..4243ef5ce 100644 --- a/man3/rint.3 +++ b/man3/rint.3 @@ -20,7 +20,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH RINT 3 2001-05-31 "" "Linux Programmer's Manual" +.TH RINT 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME nearbyint, nearbyintf, nearbyintl, rint, rintf, rintl \- round to nearest integer .SH SYNOPSIS @@ -41,6 +41,25 @@ nearbyint, nearbyintf, nearbyintl, rint, rintf, rintl \- round to nearest intege .fi .sp Link with \fI-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR nearbyint (), +.BR nearbyintf (), +.BR nearbyintl (): +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.br +.BR rint (), +.BR rintf (), +.BR rintl (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION The .BR nearbyint () diff --git a/man3/round.3 b/man3/round.3 index be176903c..ddd0f89a4 100644 --- a/man3/round.3 +++ b/man3/round.3 @@ -20,7 +20,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH ROUND 3 2001-05-31 "" "Linux Programmer's Manual" +.TH ROUND 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME round, roundf, roundl \- round to nearest integer, away from zero .SH SYNOPSIS @@ -34,7 +34,20 @@ round, roundf, roundl \- round to nearest integer, away from zero .BI "long double roundl(long double " x ); .fi .sp -Compile with \fI\-std=c99\fP; link with \fI\-lm\fP. +Link with \fI\-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR round (), +.BR roundf (), +.BR roundl (): +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION These functions round \fIx\fP to the nearest integer, but round halfway cases away from zero (regardless of the current rounding diff --git a/man3/rpmatch.3 b/man3/rpmatch.3 index c369e38fc..0b5ee1a4b 100644 --- a/man3/rpmatch.3 +++ b/man3/rpmatch.3 @@ -24,16 +24,23 @@ .\" .\" 2006-05-19, mtk, various edits and example program .\" -.TH RPMATCH 3 2006-05-17 "GNU" "Linux Programmer's Manual" +.TH RPMATCH 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME rpmatch \- determine if the answer to a question is affirmative or negative .SH SYNOPSIS .nf -\fB#define _SVID_SOURCE \fB#include \fBint rpmatch(const char *\fIresponse\fB); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR rpmatch (): +_SVID_SOURCE .SH DESCRIPTION .BR rpmatch () handles a user response to yes or no questions, with @@ -122,5 +129,4 @@ main(int argc, char *argv[]) .BR fgets (3), .BR getline (3), .BR nl_langinfo (3), -.BR setlocale (3), -.BR feature_test_macros (7) +.BR setlocale (3) diff --git a/man3/scalb.3 b/man3/scalb.3 index 978fd9cd0..f0776b15f 100644 --- a/man3/scalb.3 +++ b/man3/scalb.3 @@ -20,7 +20,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH SCALB 3 2004-10-31 "" "Linux Programmer's Manual" +.TH SCALB 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME scalb, scalbf, scalbl, scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl \- multiply floating-point number by integral power of radix @@ -46,6 +46,30 @@ multiply floating-point number by integral power of radix .BI "long double scalblnl(long double " x ", long int " exp ); .sp Link with \fI-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR scalb (), +.BR scalbf (), +.BR scalbl (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.br +.BR scalbn (), +.BR scalbnf (), +.BR scalbnl (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.br +.BR scalbln (), +.BR scalblnf (), +.BR scalblnl (): +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION These functions multiply their first argument .I x diff --git a/man3/scandir.3 b/man3/scandir.3 index 99c9fa353..82c9ad3ee 100644 --- a/man3/scandir.3 +++ b/man3/scandir.3 @@ -31,7 +31,7 @@ .\" Modified Sun Sep 24 20:15:46 2000 by aeb, following Petter Reinholdtsen. .\" Modified 2001-12-26 by aeb, following Joey. Added versionsort. .\" -.TH SCANDIR 3 2001-12-26 "GNU" "Linux Programmer's Manual" +.TH SCANDIR 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME scandir, alphasort, versionsort \- scan a directory for matching entries .SH SYNOPSIS @@ -45,9 +45,21 @@ scandir, alphasort, versionsort \- scan a directory for matching entries .RE .sp .BI "int alphasort(const void *" a ", const void *" b ); -.br +.sp .BI "int versionsort(const void *" a ", const void *" b ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR scandir (), +.BR alphasort (): +_BSD_SOURCE || _SVID_SOURCE +.br +.BR versionsort (): +_GNU_SOURCE .SH DESCRIPTION The .BR scandir () @@ -125,6 +137,7 @@ earlier it used .BR strcmp (3). .SH EXAMPLE .nf +#define _SVID_SOURCE /* print files in current directory in reverse order */ #include diff --git a/man3/scanf.3 b/man3/scanf.3 index aa220b39a..2c7a26a75 100644 --- a/man3/scanf.3 +++ b/man3/scanf.3 @@ -43,7 +43,7 @@ .\" incorporated from the GNU C library documentation ((C) The .\" Free Software Foundation); other parts substantially rewritten. .\" -.TH SCANF 3 1995-11-01 "GNU" "Linux Programmer's Manual" +.TH SCANF 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME scanf, fscanf, sscanf, vscanf, vsscanf, vfscanf \- input format conversion .SH SYNOPSIS @@ -63,6 +63,19 @@ scanf, fscanf, sscanf, vscanf, vsscanf, vfscanf \- input format conversion .br .BI "int vfscanf(FILE *" stream ", const char *" format ", va_list " ap ); .ad +.fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR vscanf (), +.BR vsscanf (), +.BR vfscanf (): +.br +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I "cc -std=c99" .SH DESCRIPTION The .BR scanf () diff --git a/man3/seekdir.3 b/man3/seekdir.3 index c0cef79c2..daa0bb44c 100644 --- a/man3/seekdir.3 +++ b/man3/seekdir.3 @@ -25,7 +25,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:25:21 1993 by Rik Faith (faith@cs.unc.edu) -.TH SEEKDIR 3 1993-03-31 "" "Linux Programmer's Manual" +.TH SEEKDIR 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME seekdir \- set the position of the next readdir() call in the directory stream. @@ -35,6 +35,14 @@ stream. .sp .BI "void seekdir(DIR *" dir ", off_t " offset ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR seekdir (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE .SH DESCRIPTION The .BR seekdir () diff --git a/man3/sem_wait.3 b/man3/sem_wait.3 index ae195d95d..bf9536866 100644 --- a/man3/sem_wait.3 +++ b/man3/sem_wait.3 @@ -20,7 +20,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH SEM_WAIT 3 2006-03-25 "Linux" "Linux Programmer's Manual" +.TH SEM_WAIT 3 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME sem_wait, sem_timedwait, sem_trywait \- lock a semaphore .SH SYNOPSIS @@ -29,12 +29,18 @@ sem_wait, sem_timedwait, sem_trywait \- lock a semaphore .sp .BI "int sem_wait(sem_t *" sem ); .BI "int sem_trywait(sem_t *" sem ); -.sp -.B #define _XOPEN_SOURCE 600 -.B #include -.sp .BI "int sem_timedwait(sem_t *" sem ", const struct timespec *" abs_timeout ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR sem_timedwait (): +_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600 +.ad p .SH DESCRIPTION .BR sem_wait () decrements (locks) the semaphore pointed to by @@ -252,5 +258,4 @@ main(int argc, char *argv[]) .\" .BR clock_gettime (3), .BR sem_getvalue (3), .BR sem_post (3), -.BR feature_test_macros (7), .BR sem_overview (7) diff --git a/man3/setbuf.3 b/man3/setbuf.3 index f29f1f577..7ade96230 100644 --- a/man3/setbuf.3 +++ b/man3/setbuf.3 @@ -43,7 +43,7 @@ .\" Correction, 2000-03-03, Andreas Jaeger .\" Added return value for setvbuf, aeb, .\" -.TH SETBUF 3 2001-06-09 "Linux" "Linux Programmer's Manual" +.TH SETBUF 3 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME setbuf, setbuffer, setlinebuf, setvbuf \- stream buffering operations .SH SYNOPSIS @@ -59,6 +59,15 @@ setbuf, setbuffer, setlinebuf, setvbuf \- stream buffering operations .BI "int setvbuf(FILE *" stream ", char *" buf ", int " mode .BI ", size_t " size ); .ad +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR setbuffer(), +.BR setlinebuf (): +_BSD_SOURCE .SH DESCRIPTION The three types of buffering available are unbuffered, block buffered, and line buffered. diff --git a/man3/setenv.3 b/man3/setenv.3 index c16194628..5e1cedc3a 100644 --- a/man3/setenv.3 +++ b/man3/setenv.3 @@ -31,7 +31,7 @@ .\" Noted non-standard behavior of setenv() if name contains '=' .\" 2005-08-12, mtk, glibc 2.3.4 fixed the "name contains '='" bug .\" -.TH SETENV 3 2004-05-09 "GNU" "Linux Programmer's Manual" +.TH SETENV 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME setenv \- change or add an environment variable .SH SYNOPSIS @@ -42,6 +42,17 @@ setenv \- change or add an environment variable .sp .BI "int unsetenv(const char *" name ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR setenv (), +.BR unsetenv (): +_BSD_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600 +.ad b .SH DESCRIPTION The .BR setenv () diff --git a/man3/setjmp.3 b/man3/setjmp.3 index cad2104af..9d37473a7 100644 --- a/man3/setjmp.3 +++ b/man3/setjmp.3 @@ -23,7 +23,7 @@ .\" Added sigsetjmp, Sun Mar 2 22:03:05 EST 1997, jrv@vanzandt.mv.com .\" Modifications, Sun Feb 26 14:39:45 1995, faith@cs.unc.edu .\" " -.TH SETJMP 3 1997-03-02 "" "Linux Programmer's Manual" +.TH SETJMP 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME setjmp, sigsetjmp \- save stack context for non-local goto .SH SYNOPSIS @@ -35,6 +35,14 @@ setjmp, sigsetjmp \- save stack context for non-local goto .BI "int sigsetjmp(sigjmp_buf " env ", int " savesigs ); .fi .ad b +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR sigsetjmp (): +_POSIX_C_SOURCE || _XOPEN_SOURCE .SH DESCRIPTION .BR setjmp () and diff --git a/man3/setnetgrent.3 b/man3/setnetgrent.3 index bb06f2d4e..b00762ccf 100644 --- a/man3/setnetgrent.3 +++ b/man3/setnetgrent.3 @@ -2,7 +2,7 @@ .\" Distributed under GPL .\" based on glibc infopages .\" polished - aeb -.TH SETNETGRENT 3 2002-08-20 "GNU" "Linux Programmer's Manual" +.TH SETNETGRENT 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME setnetgrent, endnetgrent, getnetgrent, getnetgrent_r, innetgr \- handle network group entries @@ -24,6 +24,20 @@ handle network group entries .in +12 .BI "const char *" user ", const char *" domain ); .in -12 +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR setnetgrent (), +.BR endnetgrent (), +.BR getnetgrent (), +.BR getnetgrent_r (), +.BR innetgr (): +_BSD_SOURCE || _SVID_SOURCE +.ad b .SH DESCRIPTION The .I netgroup diff --git a/man3/siginterrupt.3 b/man3/siginterrupt.3 index 498942bdc..315d245c3 100644 --- a/man3/siginterrupt.3 +++ b/man3/siginterrupt.3 @@ -26,7 +26,7 @@ .\" 386BSD man pages .\" Modified Sun Jul 25 10:40:51 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Sun Apr 14 16:20:34 1996 by Andries Brouwer (aeb@cwi.nl) -.TH SIGINTERRUPT 3 1993-04-13 "" "Linux Programmer's Manual" +.TH SIGINTERRUPT 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME siginterrupt \- allow signals to interrupt system calls .SH SYNOPSIS @@ -35,6 +35,14 @@ siginterrupt \- allow signals to interrupt system calls .sp .BI "int siginterrupt(int " sig ", int " flag ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR siginterrupt (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION The .BR siginterrupt () diff --git a/man3/significand.3 b/man3/significand.3 index 6ccf5dfb4..4e9db649b 100644 --- a/man3/significand.3 +++ b/man3/significand.3 @@ -1,7 +1,7 @@ .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de) .\" Distributed under GPL .\" based on glibc infopages -.TH SIGNIFICAND 3 2002-08-10 "GNU" "Linux Programmer's Manual" +.TH SIGNIFICAND 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME significand, significandf, significandl \- get mantissa of floating point number @@ -15,6 +15,18 @@ get mantissa of floating point number .BI "long double significandl(long double " x ); .sp Link with \fI-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR significand (), +.BR significandf (), +.BR significandl (): +_SVID_SOURCE || _BSD_SOURCE +.ad b .SH DESCRIPTION The .BR significand () diff --git a/man3/sigvec.3 b/man3/sigvec.3 index 207973b70..13e0bb715 100644 --- a/man3/sigvec.3 +++ b/man3/sigvec.3 @@ -18,12 +18,10 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH SIGVEC 3 2005-12-01 "Linux" "Linux Programmer's Manual" +.TH SIGVEC 3 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME sigvec, sigblock, sigsetmask, siggetmask, sigmask \- BSD signal API .SH SYNOPSIS -.B #define _BSD_SOURCE -.br .B #include .sp .BI "int sigvec(int " sig ", struct sigvec *" vec ", struct sigvec *" ovec ); @@ -35,6 +33,15 @@ sigvec, sigblock, sigsetmask, siggetmask, sigmask \- BSD signal API .BI "int sigsetmask(int " mask ); .sp .B int siggetmask(void); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +All of the functions described on this page: +_BSD_SOURCE +.br .SH DESCRIPTION These functions are provided in glibc as a compatibility interface for programs that make use of the historical BSD signal API. @@ -245,5 +252,4 @@ for details. .BR raise (3), .BR sigpause (3), .BR sigset (3), -.BR feature_test_macros (7), .BR signal (7) diff --git a/man3/sockatmark.3 b/man3/sockatmark.3 index a146c0ad3..4b50ca316 100644 --- a/man3/sockatmark.3 +++ b/man3/sockatmark.3 @@ -17,13 +17,23 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH SOCKATMARK 3 2006-04-24 "Linux" "Linux Programmer's Manual" +.TH SOCKATMARK 3 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME sockatmark \- determine whether socket is at out-of-band mark .SH SYNOPSIS .B #include .sp .BI "int sockatmark(int " fd ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR sockatmark (): +_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600 +.ad b .SH DESCRIPTION .BR sockatmark () returns a value indicating whether or not the socket referred diff --git a/man3/strdup.3 b/man3/strdup.3 index 2ee0d8f36..c45135fb9 100644 --- a/man3/strdup.3 +++ b/man3/strdup.3 @@ -26,7 +26,7 @@ .\" 386BSD man pages .\" Modified Sun Jul 25 10:41:34 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Wed Oct 17 01:12:26 2001 by John Levon -.TH STRDUP 3 1993-04-12 "GNU" "Linux Programmer's Manual" +.TH STRDUP 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME strdup, strndup, strdupa, strndupa \- duplicate a string .SH SYNOPSIS @@ -35,16 +35,25 @@ strdup, strndup, strdupa, strndupa \- duplicate a string .sp .BI "char *strdup(const char *" s ); .sp -.B #define _GNU_SOURCE -.br -.B #include -.sp .BI "char *strndup(const char *" s ", size_t " n ); .br .BI "char *strdupa(const char *" s ); .br .BI "char *strndupa(const char *" s ", size_t " n ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR strdup (): +_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.br +.BR strndup (), +.BR strdupa (), +.BR strndupa (): +_GNU_SOURCE .SH DESCRIPTION The .BR strdup () @@ -96,5 +105,4 @@ are GNU extensions. .BR free (3), .BR malloc (3), .BR realloc (3), -.BR wcsdup (3), -.BR feature_test_macros (7) +.BR wcsdup (3) diff --git a/man3/strerror.3 b/man3/strerror.3 index 8186a4673..8dd8edad4 100644 --- a/man3/strerror.3 +++ b/man3/strerror.3 @@ -34,7 +34,7 @@ .\" 2005-12-13, mtk, Substantial rewrite of strerror_r() description .\" Addition of extra material on portability and standards. .\" -.TH STRERROR 3 2005-12-13 "" "Linux Programmer's Manual" +.TH STRERROR 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME strerror, strerror_r \- return string describing error number .SH SYNOPSIS @@ -44,14 +44,18 @@ strerror, strerror_r \- return string describing error number .BI "char *strerror(int " errnum ); .sp .BI "char *strerror_r(int " errnum ", char *" buf ", size_t " buflen ); - /* GNU-specific strerror_r() */ -.sp -.B #define _XOPEN_SOURCE 600 -.B #include -.sp -.BI "int strerror_r(int " errnum ", char *" buf ", size_t " buflen ); - /* XSI-compliant strerror_r() */ .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +The XSI-compliant version of +.BR strerror_r () +is provided if: +.br +(_POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE >= 600) && !\ _GNU_SOURCE .SH DESCRIPTION The .BR strerror () @@ -72,13 +76,19 @@ function is similar to but is thread safe. 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 +(available since glibc 2.3.4), and a GNU-specific version (available since glibc 2.0). -If -.B _XOPEN_SOURCE -is defined with the value 600, -then the XSI-compliant version is provided, +The XSI-compliant version is provided with the feature test macros +settings shown in the SYNOPSIS; otherwise the GNU-specific version is provided. +If no feature test macros are explicitly defined, +then (since glibc 2.4) +.BR _POSIX_SOURCE +is defined by default with the value +200112L, so that the XSI-compliant version of +.BR strerror_r () +is provided by default. The XSI-compliant .BR strerror_r () @@ -161,5 +171,4 @@ if the error number is unknown. .BR errno (3), .BR error (3), .BR perror (3), -.BR strsignal (3), -.BR feature_test_macros (7) +.BR strsignal (3) diff --git a/man3/strsep.3 b/man3/strsep.3 index 60e9ba113..04afa0699 100644 --- a/man3/strsep.3 +++ b/man3/strsep.3 @@ -28,7 +28,7 @@ .\" Modified Mon Jan 20 12:04:18 1997 by Andries Brouwer (aeb@cwi.nl) .\" Modified Tue Jan 23 20:23:07 2001 by Andries Brouwer (aeb@cwi.nl) .\" -.TH STRSEP 3 1993-04-12 "GNU" "Linux Programmer's Manual" +.TH STRSEP 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME strsep \- extract token from string .SH SYNOPSIS @@ -37,6 +37,14 @@ strsep \- extract token from string .sp .BI "char *strsep(char **" stringp ", const char *" delim ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR strsep (): +_BSD_SOURCE .SH DESCRIPTION If *\fIstringp\fP is NULL, the .BR strsep () diff --git a/man3/strtod.3 b/man3/strtod.3 index bed012205..34194155d 100644 --- a/man3/strtod.3 +++ b/man3/strtod.3 @@ -40,21 +40,28 @@ .\" (michael@cantor.informatik.rwth-aachen.de) .\" Added strof, strtold, aeb, 2001-06-07 .\" -.TH STRTOD 3 2001-06-07 "Linux" "Linux Programmer's Manual" +.TH STRTOD 3 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME strtod, strtof, strtold \- convert ASCII string to floating point number .SH SYNOPSIS .B #include .sp .BI "double strtod(const char *" nptr ", char **" endptr ); -.sp -.BR "#define _XOPEN_SOURCE 600" " /* or #define _ISOC99_SOURCE */" .br -.B #include -.sp .BI "float strtof(const char *" nptr ", char **" endptr ); .br .BI "long double strtold(const char *" nptr ", char **" endptr ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR strtof (), +.BR strtold (): +.br +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 .SH DESCRIPTION The .BR strtod (), @@ -163,5 +170,4 @@ the use of the functions described in this manual page is similar. .BR atoi (3), .BR atol (3), .BR strtol (3), -.BR strtoul (3), -.BR feature_test_macros (7) +.BR strtoul (3) diff --git a/man3/strtok.3 b/man3/strtok.3 index 2721475f3..1ee69952c 100644 --- a/man3/strtok.3 +++ b/man3/strtok.3 @@ -25,7 +25,7 @@ .\" Updated, added strtok_r. 2000-02-13 Nicolás Lichtmaier .\" 2005-11-17, mtk: Substantial parts rewritten .\" -.TH STRTOK 3 2000-02-13 "GNU" "Linux Programmer's Manual" +.TH STRTOK 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME strtok, strtok_r \- extract tokens from strings .SH SYNOPSIS @@ -36,6 +36,16 @@ strtok, strtok_r \- extract tokens from strings .sp .BI "char *strtok_r(char *" str ", const char *" delim ", char **" saveptr ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR strtok_r (): +_SVID_SOURCE || _BSD_SOURCE || _POSIX_C_SOURCE || _XOPEN_SOURCE +.ad b .SH DESCRIPTION The .BR strtok () diff --git a/man3/strtol.3 b/man3/strtol.3 index 29e04cb36..1768c22d5 100644 --- a/man3/strtol.3 +++ b/man3/strtol.3 @@ -26,7 +26,7 @@ .\" 386BSD man pages .\" Modified Sun Jul 25 10:53:39 1993 by Rik Faith (faith@cs.unc.edu) .\" Added correction due to nsd@bbc.com (Nick Duffek) - aeb, 950610 -.TH STRTOL 3 2002-05-30 "GNU" "Linux Programmer's Manual" +.TH STRTOL 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME strtol, strtoll, strtoq \- convert a string to a long integer .SH SYNOPSIS @@ -39,6 +39,17 @@ strtol, strtoll, strtoq \- convert a string to a long integer .BI "long long int" .BI "strtoll(const char *" nptr ", char **" endptr ", int " base ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR strtoll (): +XOPEN_SOURCE >= 600 || _BSD_SOURCE || _SVID_SOURCE || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION The .BR strtol () diff --git a/man3/strtoul.3 b/man3/strtoul.3 index ab5f9d3ea..dac282622 100644 --- a/man3/strtoul.3 +++ b/man3/strtoul.3 @@ -28,7 +28,7 @@ .\" Fixed typo, aeb, 950823 .\" 2002-02-22, joey, mihtjel: Added strtoull() .\" -.TH STRTOUL 3 2002-05-30 "GNU" "Linux Programmer's Manual" +.TH STRTOUL 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME strtoul, strtoull, strtouq \- convert a string to an unsigned long integer .SH SYNOPSIS @@ -41,6 +41,17 @@ strtoul, strtoull, strtouq \- convert a string to an unsigned long integer .BI "unsigned long long int" .BI "strtoull(const char *" nptr ", char **" endptr ", int " base ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR strtoull (): +XOPEN_SOURCE >= 600 || _BSD_SOURCE || _SVID_SOURCE || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION The .BR strtoul () diff --git a/man3/syslog.3 b/man3/syslog.3 index a517cbe3d..5e9c233bb 100644 --- a/man3/syslog.3 +++ b/man3/syslog.3 @@ -31,7 +31,7 @@ .\" Modified 13 Dec 2001, Martin Schulze .\" Modified 3 Jan 2002, Michael Kerrisk .\" -.TH SYSLOG 3 2002-01-03 "Linux" "Linux Programmer's Manual" +.TH SYSLOG 3 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME closelog, openlog, syslog \- send messages to the system logger .SH SYNOPSIS @@ -43,11 +43,17 @@ closelog, openlog, syslog \- send messages to the system logger .br .BI "void closelog(void);" .sp -.B #define _BSD_SOURCE -.br .B #include .sp .BI "void vsyslog(int " priority ", const char *" format ", va_list " ap ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR vsyslog (): +_BSD_SOURCE .SH DESCRIPTION .BR closelog () closes the descriptor being used to write to the system logger. @@ -299,5 +305,4 @@ the following instead: .BR logger (1), .BR setlogmask (3), .BR syslog.conf (5), -.BR feature_test_macros (7), .BR syslogd (8) diff --git a/man3/tcgetsid.3 b/man3/tcgetsid.3 index cd0259867..56e6679f9 100644 --- a/man3/tcgetsid.3 +++ b/man3/tcgetsid.3 @@ -20,11 +20,13 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH TCGETSID 3 2003-01-30 "GNU" "Linux Programmer's Manual" +.TH TCGETSID 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME tcgetsid \- get session ID .SH SYNOPSIS .sp +.B #define _XOPEN_SOURCE 500 +.br .BR "#include " .sp .BI "pid_t tcgetsid(int " fd ); diff --git a/man3/telldir.3 b/man3/telldir.3 index 9ccb5a914..0d1076cc3 100644 --- a/man3/telldir.3 +++ b/man3/telldir.3 @@ -25,7 +25,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 17:48:42 1993 by Rik Faith (faith@cs.unc.edu) -.TH TELLDIR 3 1993-03-31 "" "Linux Programmer's Manual" +.TH TELLDIR 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME telldir \- return current location in directory stream .SH SYNOPSIS @@ -34,6 +34,14 @@ telldir \- return current location in directory stream .sp .BI "off_t telldir(DIR *" dir ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR telldir (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE .SH DESCRIPTION The .BR telldir () diff --git a/man3/tempnam.3 b/man3/tempnam.3 index a8158e46e..5deb96254 100644 --- a/man3/tempnam.3 +++ b/man3/tempnam.3 @@ -20,7 +20,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH TEMPNAM 3 1999-06-14 "" "Linux Programmer's Manual" +.TH TEMPNAM 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME tempnam \- create a name for a temporary file .SH SYNOPSIS @@ -29,6 +29,14 @@ tempnam \- create a name for a temporary file .sp .BI "char *tempnam(const char *" dir ", const char *" pfx ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR tempnam (): +_BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION The .BR tempnam () diff --git a/man3/termios.3 b/man3/termios.3 index 874be6116..c84ba1f7d 100644 --- a/man3/termios.3 +++ b/man3/termios.3 @@ -38,7 +38,7 @@ .\" Enhanced the discussion of "raw" mode for cfmakeraw(). .\" Document CMSPAR. .\" -.TH TERMIOS 3 2004-10-31 "Linux" "Linux Programmer's Manual" +.TH TERMIOS 3 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME termios, tcgetattr, tcsetattr, tcsendbreak, tcdrain, tcflush, tcflow, cfmakeraw, cfgetospeed, cfgetispeed, cfsetispeed, cfsetospeed, cfsetspeed \- @@ -72,6 +72,16 @@ get and set terminal attributes, line control, get and set baud rate .sp .BI "int cfsetospeed(struct termios *" termios_p ", speed_t " speed ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.br +.BR cfsetspeed (), +.BR cfmakeraw (): +_BSD_SOURCE .SH DESCRIPTION The termios functions describe a general terminal interface that is provided to control asynchronous communications ports. @@ -953,5 +963,4 @@ behaves like .BR stty (1), .BR console_ioctl (4), .BR tty_ioctl (4), -.BR feature_test_macros (7), .BR setserial (8) diff --git a/man3/tgamma.3 b/man3/tgamma.3 index 0e2d85eb9..21ca6b9c8 100644 --- a/man3/tgamma.3 +++ b/man3/tgamma.3 @@ -3,7 +3,7 @@ .\" Based on glibc infopages .\" Modified 2004-11-15, fixed error noted by Fabian Kreutz .\" -.TH TGAMMA 3 2004-11-15 "GNU" "Linux Programmer's Manual" +.TH TGAMMA 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME tgamma, tgammaf, tgammal \- true gamma function .SH SYNOPSIS @@ -15,7 +15,20 @@ tgamma, tgammaf, tgammal \- true gamma function .br .BI "long double tgammal(long double " x ); .sp -Compile with \fI\-std=c99\fP; link with \fI\-lm\fP. +Link with \fI\-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR tgamma (), +.BR tgammaf (), +.BR tgammal (): +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION The Gamma function is defined by .sp diff --git a/man3/timegm.3 b/man3/timegm.3 index 887ef26b4..c74c6f703 100644 --- a/man3/timegm.3 +++ b/man3/timegm.3 @@ -20,7 +20,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH TIMEGM 3 2007-06-18 "GNU" "Linux Programmer's Manual" +.TH TIMEGM 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME timegm, timelocal \- inverses of gmtime and localtime .SH SYNOPSIS @@ -30,6 +30,16 @@ timegm, timelocal \- inverses of gmtime and localtime .BI "time_t timelocal(struct tm *" tm ); .sp .BI "time_t timegm(struct tm *" tm ); +.sp +.fi +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR timelocal (), +.BR timegm (): +_BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION The functions .BR timelocal () diff --git a/man3/toascii.3 b/man3/toascii.3 index cf6f6cc7f..57ce1a524 100644 --- a/man3/toascii.3 +++ b/man3/toascii.3 @@ -24,7 +24,7 @@ .\" .\" Added BUGS section, aeb, 950919 .\" -.TH TOASCII 3 1995-09-16 "GNU" "Linux Programmer's Manual" +.TH TOASCII 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME toascii \- convert character to ASCII .SH SYNOPSIS @@ -33,6 +33,15 @@ toascii \- convert character to ASCII .sp .BI "int toascii(int " "c" ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.br +.BR toascii (): +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE .SH DESCRIPTION .BR toascii () converts \fIc\fP to a 7-bit \fIunsigned char\fP value diff --git a/man3/trunc.3 b/man3/trunc.3 index 30b9e89a0..1861ff6ed 100644 --- a/man3/trunc.3 +++ b/man3/trunc.3 @@ -20,7 +20,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH TRUNC 3 2001-05-31 "" "Linux Programmer's Manual" +.TH TRUNC 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME trunc, truncf, truncl \- round to integer, towards zero .SH SYNOPSIS @@ -34,7 +34,20 @@ trunc, truncf, truncl \- round to integer, towards zero .BI "long double truncl(long double " x ); .fi .sp -Compile with \fI\-std=c99\fP; link with \fI\-lm\fP. +Link with \fI\-lm\fP. +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR trunc (), +.BR truncf (), +.BR truncl (): +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION These functions round \fIx\fP to the nearest integer not larger in absolute value. diff --git a/man3/ttyslot.3 b/man3/ttyslot.3 index 04d0e0700..2e3c585d9 100644 --- a/man3/ttyslot.3 +++ b/man3/ttyslot.3 @@ -23,16 +23,26 @@ .\" This replaces an earlier man page written by Walter Harms .\" . .\" -.TH TTYSLOT 3 2002-07-20 "GNU" "Linux Programmer's Manual" +.TH TTYSLOT 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME ttyslot \- find the slot of the current user's terminal in some file .SH SYNOPSIS .sp -.BR "#include " " /* on BSD-like systems */" +.BR "#include " " /* on BSD-like systems, and Linux */" .br .BR "#include " " /* on System V-like systems */" .sp .B "int ttyslot(void);" +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +.BR ttyslot (): +_BSD_SOURCE || (_XOPEN_SOURCE_EXTENDED && !\ _XOPEN_SOURCE\ >=\ 500) +.ad b .SH DESCRIPTION The legacy function .BR ttyslot () diff --git a/man3/tzset.3 b/man3/tzset.3 index 3ab7f74a0..4e6a60b7a 100644 --- a/man3/tzset.3 +++ b/man3/tzset.3 @@ -28,7 +28,7 @@ .\" Modified 2001-11-13, aeb .\" Modified 2004-12-01 mtk and Martin Schulze .\" -.TH TZSET 3 2001-11-13 "" "Linux Programmer's Manual" +.TH TZSET 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME tzset, tzname, timezone, daylight \- initialize time conversion information .SH SYNOPSIS @@ -41,6 +41,23 @@ tzset, tzname, timezone, daylight \- initialize time conversion information .BI "extern long " timezone ; .BI "extern int " daylight ; .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR tzset (): +_POSIX_C_SOURCE || _XOPEN_SOURCE +.br +.IR tzname : +_POSIX_C_SOURCE || _XOPEN_SOURCE +.br +.IR timezone : +_SVID_SOURCE || _XOPEN_SOURCE +.br +.IR daylight : +_SVID_SOURCE || _XOPEN_SOURCE .SH DESCRIPTION The .BR tzset () diff --git a/man3/ualarm.3 b/man3/ualarm.3 index 0263e67bd..766a4620e 100644 --- a/man3/ualarm.3 +++ b/man3/ualarm.3 @@ -20,16 +20,23 @@ .\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, .\" USA. .\" -.TH UALARM 3 2003-07-24 "" "Linux Programmer's Manual" +.TH UALARM 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME ualarm \- schedule signal after given number of microseconds .SH SYNOPSIS .nf -.B "#define _XOPEN_SOURCE 500 /* Or: #define _BSD_SOURCE */" .B "#include " .sp .BI "useconds_t ualarm(useconds_t " usecs ", useconds_t " interval ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR ualarm (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION The .BR ualarm () @@ -112,5 +119,4 @@ instead. .BR select (2), .BR setitimer (2), .BR usleep (3), -.BR feature_test_macros (7), .BR time (7) diff --git a/man3/unlocked_stdio.3 b/man3/unlocked_stdio.3 index d3070187f..50933a757 100644 --- a/man3/unlocked_stdio.3 +++ b/man3/unlocked_stdio.3 @@ -20,7 +20,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" -.TH UNLOCKED_STDIO 3 2001-10-18 "" "Linux Programmer's Manual" +.TH UNLOCKED_STDIO 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME getc_unlocked, getchar_unlocked, putc_unlocked, putchar_unlocked, \- non-locking stdio functions @@ -33,7 +33,7 @@ putchar_unlocked, \- non-locking stdio functions .BI "int putc_unlocked(int " c ", FILE *" stream ); .BI "int putchar_unlocked(int " c ); .sp -.BR "#define _BSD_SOURCE" " /* or _SVID_SOURCE or _GNU_SOURCE */" +.BR "#define _BSD_SOURCE" " /* or _SVID_SOURCE */" .B #include .sp .BI "void clearerr_unlocked(FILE *" stream ); diff --git a/man3/usleep.3 b/man3/usleep.3 index 879e9284d..88a3cfe1a 100644 --- a/man3/usleep.3 +++ b/man3/usleep.3 @@ -28,17 +28,23 @@ .\" Modified 2001-04-01 by aeb .\" Modified 2003-07-23 by aeb .\" -.TH USLEEP 3 2007-02-01 "" "Linux Programmer's Manual" +.TH USLEEP 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME usleep \- suspend execution for microsecond intervals .SH SYNOPSIS .nf -.B "#define _XOPEN_SOURCE 500 /* Or: #define _BSD_SOURCE */" -.br .B "#include " .sp .BI "int usleep(useconds_t " usec ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR usleep (): +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION The .BR usleep () @@ -115,5 +121,4 @@ is unspecified. .BR setitimer (2), .BR ualarm (3), .BR sleep (3), -.BR feature_test_macros (7), .BR time (7) diff --git a/man3/wcscasecmp.3 b/man3/wcscasecmp.3 index c3ea9121b..5d594ca6e 100644 --- a/man3/wcscasecmp.3 +++ b/man3/wcscasecmp.3 @@ -10,11 +10,12 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html .\" -.TH WCSCASECMP 3 1999-07-25 "GNU" "Linux Programmer's Manual" +.TH WCSCASECMP 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME wcscasecmp \- compare two wide-character strings, ignoring case .SH SYNOPSIS .nf +.B #define _GNU_SOURCE .B #include .sp .BI "int wcscasecmp(const wchar_t *" s1 ", const wchar_t *" s2 ); diff --git a/man3/wcsncasecmp.3 b/man3/wcsncasecmp.3 index cadb86b32..4a70fd61b 100644 --- a/man3/wcsncasecmp.3 +++ b/man3/wcsncasecmp.3 @@ -10,11 +10,12 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html .\" -.TH WCSNCASECMP 3 1999-07-25 "GNU" "Linux Programmer's Manual" +.TH WCSNCASECMP 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME wcsncasecmp \- compare two fixed-size wide-character strings, ignoring case .SH SYNOPSIS .nf +.B #define _GNU_SOURCE .B #include .sp .BI "int wcsncasecmp(const wchar_t *" s1 ", const wchar_t *" s2 ", size_t " n ); diff --git a/man3/wcsnlen.3 b/man3/wcsnlen.3 index d1793b6ab..33c591e89 100644 --- a/man3/wcsnlen.3 +++ b/man3/wcsnlen.3 @@ -10,11 +10,12 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html .\" -.TH WCSNLEN 3 1999-07-25 "GNU" "Linux Programmer's Manual" +.TH WCSNLEN 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME wcsnlen \- determine the length of a fixed-size wide-character string .SH SYNOPSIS .nf +.B #define _GNU_SOURCE .B #include .sp .BI "size_t wcsnlen(const wchar_t *" s ", size_t " maxlen ); diff --git a/man3/wcsnrtombs.3 b/man3/wcsnrtombs.3 index 852340a2e..2697210d3 100644 --- a/man3/wcsnrtombs.3 +++ b/man3/wcsnrtombs.3 @@ -10,11 +10,12 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html .\" -.TH WCSNRTOMBS 3 1999-07-25 "GNU" "Linux Programmer's Manual" +.TH WCSNRTOMBS 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME wcsnrtombs \- convert a wide-character string to a multibyte string .SH SYNOPSIS .nf +.B #define _GNU_SOURCE .B #include .sp .BI "size_t wcsnrtombs(char *" dest ", const wchar_t **" src ", size_t " nwc , diff --git a/man3/wcswidth.3 b/man3/wcswidth.3 index dd7a9b2f9..0d4131e41 100644 --- a/man3/wcswidth.3 +++ b/man3/wcswidth.3 @@ -10,11 +10,12 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html .\" -.TH WCSWIDTH 3 1999-07-25 "GNU" "Linux Programmer's Manual" +.TH WCSWIDTH 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME wcswidth \- determine columns needed for a fixed-size wide-character string .SH SYNOPSIS .nf +.B #define _XOPEN_SOURCE .B #include .sp .BI "int wcswidth(const wchar_t *" s ", size_t " n ); diff --git a/man3/wordexp.3 b/man3/wordexp.3 index 9baf00452..dbc6492cc 100644 --- a/man3/wordexp.3 +++ b/man3/wordexp.3 @@ -20,7 +20,7 @@ .\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, .\" USA. .\" -.TH WORDEXP 3 2003-11-11 "" "Linux Programmer's Manual" +.TH WORDEXP 3 2007-07-26 "" "Linux Programmer's Manual" .SH NAME wordexp, wordfree \- perform word expansion like a posix-shell .SH SYNOPSIS @@ -29,6 +29,15 @@ wordexp, wordfree \- perform word expansion like a posix-shell .BI "int wordexp(const char *" s ", wordexp_t *" p ", int " flags ); .sp .BI "void wordfree(wordexp_t *" p ); +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR wordexp (), +.BR wordfree (): +_XOPEN_SOURCE .SH DESCRIPTION The function .BR wordexp () diff --git a/man3/wprintf.3 b/man3/wprintf.3 index 34b1e2727..70ccdd62b 100644 --- a/man3/wprintf.3 +++ b/man3/wprintf.3 @@ -11,7 +11,7 @@ .\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH WPRINTF 3 1999-11-20 "GNU" "Linux Programmer's Manual" +.TH WPRINTF 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME wprintf, fwprintf, swprintf, vwprintf, vfwprintf, vswprintf \- formatted wide-character output conversion @@ -25,13 +25,28 @@ wide-character output conversion .BI "int swprintf(wchar_t *" wcs ", size_t " maxlen , .BI " const wchar_t *" format ", ...);" .sp -.B #include -.sp .BI "int vwprintf(const wchar_t *" format ", va_list " args ); .BI "int vfwprintf(FILE *" stream ", const wchar_t *" format ", va_list " args ); .BI "int vswprintf(wchar_t *" wcs ", size_t " maxlen , .BI " const wchar_t *" format ", va_list " args ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.ad l +All functions described on this page: +.\" .BR wprintf (), +.\" .BR fwprintf (), +.\" .BR swprintf (), +.\" .BR vwprintf (), +.\" .BR vfwprintf (), +.\" .BR vswprintf (): +_XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE; or +.I cc\ -std=c99 +.ad b .SH DESCRIPTION The .BR wprintf ()