.\" Modified Wed Jul 21 23:02:38 1993 by Rik Faith <faith@cs.unc.edu>
.\" 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
.B #include <stdlib.h>
.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 ()
.\" Modified 1998-11-04 by Tigran Aivazian <tigran@sco.com>
.\" 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
.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
.\" Modified Wed Jul 21 19:52:58 1993 by Rik Faith <faith@cs.unc.edu>
.\" Modified Sun Aug 21 17:40:38 1994 by Rik Faith <faith@cs.unc.edu>
.\"
-.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
.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
.\" Modified 1997-08-21 by Joseph S. Myers <jsm28@cam.ac.uk>
.\" Modified 2004-06-23 by Michael Kerrisk <mtk-manpages@gmx.net>
.\"
-.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
.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
.\" <michael@cantor.informatik.rwth-aachen.de>: NFS details
.\" Modified 2004-06-23 by Michael Kerrisk <mtk-manpages@gmx.net>
.\"
-.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 <sys/stat.h>
.sp
.BI "int chmod(const char *" path ", mode_t " mode );
-.sp
-.BR "#define _XOPEN_SOURCE 500 " "/* or: " "#define _BSD_SOURCE " */
.br
-.B #include <sys/stat.h>
-.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
.\" Modified 2004-06-23 by Michael Kerrisk <mtk-manpages@gmx.net>
.\" 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
.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 <unistd.h>
-.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
.\" 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 <sched.h>
.BI "int clone(int (*" "fn" ")(void *), void *" child_stack ,
.\" 1996-04-12 Andries Brouwer <aeb@cwi.nl>
.\" 1996-04-13 Markus Kuhn <mskuhn@cip.informatik.uni-erlangen.de>
.\"
-.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 <unistd.h>
.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
.\" 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
.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
.\" Modified 1997-08-25 by Nicolás Lichtmaier <nick@debian.org>
.\" Modified 2004-06-17 by Michael Kerrisk <mtk-manpages@gmx.net>
.\"
-.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
.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.
.\"
.\" Modified 2002-04-15 by Roger Luethi <rl@hellgate.ch> 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 <unistd.h>
.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,
.\" Modified, 27 May 2004, Michael Kerrisk <mtk-manpages@gmx.net>
.\" 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
.B #include <grp.h>
.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 ()
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),
.\" Portions Copyright 1993 Mitchum DSouza <m.dsouza@mrc-apu.cam.ac.uk>
.\"
.\" Modified Tue Oct 22 00:22:35 EDT 1996 by Eric S. Raymond <esr@thyrsus.com>
-.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
.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
.\" 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
.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.
.\" 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 <unistd.h>
.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 ()
.\"
.\" Modified Thu Oct 31 14:18:40 1996 by Eric S. Raymond <esr@y\thyrsus.com>
.\" 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 <unistd.h>
.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.
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
.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)
.\" Modified, 2004-05-27 by Michael Kerrisk <mtk-manpages@gmx.net>
.\" 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
.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 ()
.\" 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
.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 ()
.\" 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 <signal.h>
.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
.\" Modified, 25 Feb 2002, Michael Kerrisk, <mtk-manpages@gmx.net>
.\" 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
.B #include <sys/mman.h>
.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 ()
.\" after message from <gordon.jin@intel.com>
.\" 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
.B #include <sys/mman.h>
.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
.\" Modified 2003-04-23 by Michael Kerrisk
.\" Modified 2004-06-23 by Michael Kerrisk <mtk-manpages@gmx.net>
.\"
-.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
.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 ()
.\" 1996-04-10 Markus Kuhn <mskuhn@cip.informatik.uni-erlangen.de>
.\" 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 <time.h>
.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
.BR sleep (3),
.BR timer_create (3),
.BR usleep (3),
-.BR feature_test_macros (7),
.BR time (7)
.\" Modified 2001-06-04 by aeb
.\" Modified 2004-05-27 by Michael Kerrisk <mtk-manpages@gmx.net>
.\"
-.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 <unistd.h>
.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
.\" 2004-05-40 Created by Michael Kerrisk <mtk-manpages@gmx.net>
.\" 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 <fcntl.h>
.sp
.BI "ssize_t readahead(int " fd ", off64_t *" offset ", size_t " count );
.\" 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 <unistd.h>
.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
.\" 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
.br
.B #include <unistd.h>
.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
.br
.BI "void FD_ZERO(fd_set *" set );
.sp
-.B #define _XOPEN_SOURCE 600
.B #include <sys/select.h>
.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
.BR send (2),
.BR sigprocmask (2),
.BR write (2),
-.BR epoll (7),
-.BR feature_test_macros (7)
+.BR epoll (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
.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
.\" Modified, 27 May 2004, Michael Kerrisk <mtk-manpages@gmx.net>
.\" 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
.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.
.\" 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
.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
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified, 2003-05-26, Michael Kerrisk, <mtk-manpages@gmx.net>
-.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
.SH NOTES
Under HP-UX and FreeBSD the prototype is found in
.IR <unistd.h> .
-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),
.\" 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
.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.
.\" 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 <signal.h>
.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
.\" 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 <signal.h>
.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
.\" 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
.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
.\" 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
.in
.sp
.BR lstat ():
-_BSD_SOURCE || _XOPEN_SOURCE >= 500
+_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500
.SH DESCRIPTION
.PP
These functions return information about a file.
.\" Modified 2001-03-16 by Andries Brouwer <aeb@cwi.nl>
.\" Modified 2004-05-27 by Michael Kerrisk <mtk-manpages@gmx.net>
.\"
-.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 <time.h>
.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.
privilege is required.
.SH "CONFORMING TO"
SVr4.
-.SH NOTES
-Under glibc2,
-.I <time.h>
-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)
.\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com>
.\" Modified 2004-06-23 by Michael Kerrisk <mtk-manpages@gmx.net>
.\"
-.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 <unistd.h>
.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
.\" Modified Tue Oct 22 22:27:07 1996 by Eric S. Raymond <esr@thyrsus.com>
.\" 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 <unistd.h>
.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.
.\" 2002-03-20 Christoph Hellwig <hch@infradead.org>
.\" - 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 <unistd.h>
-.B "#include <sys/syscall.h> /* For SYS_xxx definitions */"
+.BR "#include <sys/syscall.h> " "/* For SYS_xxx definitions */"
.BI "int syscall(int " number ", ...);"
.fi
first appeared in
4BSD.
.SH EXAMPLE
-
.nf
#define _GNU_SOURCE
#include <unistd.h>
}
.fi
.SH SEE ALSO
-.BT syscalls (2)
+.BR syscalls (2)
.\" Modified 2002-04-06 by Andries Brouwer <aeb@cwi.nl>
.\" Modified 2004-06-23 by Michael Kerrisk <mtk-manpages@gmx.net>
.\"
-.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
.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 ()
.\" 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 <sched.h>
.sp
.BI "int unshare(int " flags );
.\" 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
.B #include <unistd.h>
.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.)
.\" Modified, 27 May 2004, Michael Kerrisk <mtk-manpages@gmx.net>
.\" 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 <unistd.h>
.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.
.\" 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
.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
.\" 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 <sys/types.h>
.B #include <sys/time.h>
.B #include <sys/resource.h>
.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 ()
.BR sigaction (2),
.BR signal (2),
.BR wait (2),
-.BR feature_test_macros (7),
.BR signal (7)
.\" 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 <math.h>
.sp
.\"
.\" 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
.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).
.\" 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
.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 ()
.\" 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
.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 ()
.\" 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 <fmtmsg.h>
.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
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)
.\" 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 ()
.SH "SEE ALSO"
.BR adjtimex (2),
.BR gettimeofday (2),
-.BR feature_test_macros (7),
.BR time (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
.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 ()
.\" 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
.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 ()
.\" 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
.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 ()
.\" 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
.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 ()
.\" 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
/* 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
.\" 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
.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 ()
.\" 2003-08-24 aeb, large parts rewritten
.\" 2004-08-06 Christoph Lameter <clameter@sgi.com>, 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
.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 ()
.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
.\" See <bits/confname.h> 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 <unistd.h>
.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.
.SH "SEE ALSO"
.BR sh (1),
.BR exec (3),
-.BR system (3),
-.BR feature_test_macros (7)
+.BR system (3)
.\" 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
.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 ()
.\" 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
.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 <unistd.h>: _XOPEN_SOURCE
.SH DESCRIPTION
.BR ctermid ()
returns a string which is the pathname for the current
.\" 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
.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 (),
.\"
.\" @(#)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 <unistd.h>
.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 ()
.\" 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
.B #include <dirent.h>
.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 ()
.\" 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
.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 ()
.\" 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
.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.
.\"
.\" 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
.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).
.\" 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 <time.h>"
.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:
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)
.\" 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
.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 ()
.\"
.\" 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
.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 (),
.\" 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
.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 ()
.\" 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 <unistd.h>
.sp
.BI "int euidaccess(const char *" pathname ", int " mode );
.\" 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
.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 ()
.\" 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
.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'.
.\" 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
.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 ()
.\" 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 <sys/time.h>
.sp
+.B #define _GNU_SOURCE
.BI "int fexecve(int " fd ", char *const " argv "[], char *const " envp []);
.fi
.SH DESCRIPTION
.\" 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
.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 ()
.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"
.\" 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
.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 ()
.\" 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 <math.h>
.sp
.BI "int finite(double " x );
.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 ()
.BR fpclassify (3).
.\"
.\" finite* not on HP-UX; they exist on Tru64.
-
-On a glibc system, these functions are declared by
-.I <math.h>
-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)
.\" 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
.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
.\" 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
.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 ()
.\" 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
.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.
.\" 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
.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
.\" 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
.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 ()
.\"
.\" 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
.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).
.\" 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
.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 ()
.\" Modified Mon Dec 11 13:32:51 MET 2000 by aeb
.\" Modified Thu Apr 22 03:49:15 CEST 2002 by Roger Luethi <rl@hellgate.ch>
.\"
-.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 <unistd.h>
.sp
.BI "char *getcwd(char *" buf ", size_t " size );
.sp
-.B "#define _BSD_SOURCE /* Or: #define _XOPEN_SOURCE 500 */"
-.B #include <unistd.h>
-.sp
.BI "char *getwd(char *" buf );
.sp
-.B #define _GNU_SOURCE
-.B #include <unistd.h>
-.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 ()
.BR open (2),
.BR unlink (2),
.BR free (3),
-.BR malloc (3),
-.BR feature_test_macros (7)
+.BR malloc (3)
.\" 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 <time.h>"
.sp
.\" 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 <dirent.h>
.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
instead.
.SH "SEE ALSO"
.BR lseek (2),
-.BR open (2),
-.BR feature_test_macros (7)
+.BR open (2)
.\" 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
.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 ()
.\" 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 <grp.h>
.sp
.BI "int getgrent_r(struct group *" gbuf ", char *" buf ,
.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 ()
.BR getgrgid (3),
.BR getgrnam (3),
.BR putgrent (3),
-.BR group (5),
-.BR feature_test_macros (7)
+.BR group (5)
.\" 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
.B #include <grp.h>
.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 ()
.\" 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
.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 ()
.\" 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
.B #include <stdio.h>
.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
.\" 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
.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 <mntent.h>
.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
.SH "SEE ALSO"
.BR fopen (3),
.BR fstab (5),
-.BR feature_test_macros (7),
.BR mount (8)
.\" 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 <sys/types.h>
.B #include <pwd.h>
.sp
.\" 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
.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 ()
.\" 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 <pwd.h>
.sp
.BI "int getpwent_r(struct passwd *" pwbuf ", char *" buf ,
.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 ()
.BR getpwnam (3),
.BR getpwuid (3),
.BR putpwent (3),
-.BR passwd (5),
-.BR feature_test_macros (7)
+.BR passwd (5)
.\" 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
.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 ()
.\"
.\" 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,
.sp
/* GNU extension */
.br
-.BR "#define _SVID_SOURCE" " /* or _BSD_SOURCE */"
-.br
.B #include <shadow.h>
.sp
.BI "int getspent_r(struct spwd *" spbuf ,
.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.
.BR getgrnam (3),
.BR getpwnam (3),
.BR getpwnam_r (3),
-.BR shadow (5),
-.BR feature_test_macros (7)
+.BR shadow (5)
.\" This replaces an earlier man page written by Walter Harms
.\" <walter.harms@informatik.uni-oldenburg.de>.
.\"
-.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 <sys/types.h>"
.br
.B "#include <sys/stat.h>"
.\" 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
.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 ()
.\"
.\" This replaces an earlier man page written by Walter Harms
.\" <walter.harms@informatik.uni-oldenburg.de>.
-.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
.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
.\" 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
.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 ()
.\" Changed network into host byte order (for inet_network),
.\" Andreas Jaeger <aj@arthur.rhein-neckar.de>, 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
.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
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),
.\" Modified 1993-07-24 by Rik Faith <faith@cs.unc.edu>
.\" 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
.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 ()
.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),
.\"
.\" 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
.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
.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
.\" Modified Sat Sep 2 21:52:01 1995 by Jim Van Zandt <jrv@vanzandt.mv.com>
.\" 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
.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 ,
.\" 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
.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 ()
.\" 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 <math.h>
.sp
.BI "double j0(double " x );
.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 ()
and
.BR jn ()
for values of \fIx\fP between \-8 and 8.
-.SH "SEE ALSO"
-.BR feature_test_macros (7)
.\" 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 <math.h>
.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).
.\" 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 <unistd.h>
.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
.\"
.\" 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
.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)'.
.\" 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
.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 ()
.\"
.\" 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
.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
.\" 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
.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
.\" 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
.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.
.\" 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
.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.
.\" 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 <wchar.h>
.sp
.BI "size_t mbsnrtowcs(wchar_t *" dest ", const char **" src ,
.\" 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 <string.h>
.sp
.BI "void *memfrob(void *" s ", size_t " n );
.\"
.\" 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
.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 ()
.\" 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
.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 ()
.\" (prompted by Scott Burkett <scottb@IntNet.net>)
.\" 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
.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 ()
.\" 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
.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 )
.\" 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
.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 ()
.\" 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
.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 ()
.\" (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
.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 ()
.IR <stdio.h> .
.\" 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
.\" 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 <stdlib.h>
.sp
.BI "int posix_memalign(void **" memptr ", size_t " alignment ", size_t " size );
.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 ()
Everybody agrees that
.BR posix_memalign ()
is declared in \fI<stdlib.h>\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 ()
.BR brk (2),
.BR getpagesize (2),
.BR free (3),
-.BR malloc (3),
-.BR feature_test_macros (7)
+.BR malloc (3)
.\" 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 <stdlib.h>
.B #include <fcntl.h>
.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 ()
.BR ptsname (3),
.BR unlockpt (3),
.BR pts (4),
-.BR feature_test_macros (7),
.BR pty (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
.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 ()
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 (),
.\" Modified Fri Jun 23 01:35:19 1995 Andries Brouwer <aeb@cwi.nl>
.\" (prompted by Bas V. de Bakker <bas@phys.uva.nl>)
.\" 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 <unistd.h>
.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.
.\" 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
.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 ()
.\" 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
.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 ()
.\" 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
.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 ()
.\" This replaces an earlier man page written by Walter Harms
.\" <walter.harms@informatik.uni-oldenburg.de>.
.\"
-.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
.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 (),
.\" with contribution from Francesco Potorti <F.Potorti@cnuce.cnr.it>
.\" 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
.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 ()
.\" 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
.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 ()
.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
.\" 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
.B #include <stdlib.h>
.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
.\" (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
.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 ()
.\" 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 <math.h>
.sp
.BI "double remquo(double " x ", double " y ", int *" quo );
.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
.SH "SEE ALSO"
.BR fmod (3),
.BR logb (3),
-.BR remainder (3),
-.BR feature_test_macros (7)
+.BR remainder (3)
.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
.\" 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
.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 ()
.\" 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
.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
.\"
.\" 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 <stdlib.h>
\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
.BR fgets (3),
.BR getline (3),
.BR nl_langinfo (3),
-.BR setlocale (3),
-.BR feature_test_macros (7)
+.BR setlocale (3)
.\" 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
.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
.\" 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
.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 ()
.BR strcmp (3).
.SH EXAMPLE
.nf
+#define _SVID_SOURCE
/* print files in current directory in reverse order */
#include <dirent.h>
.\" 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
.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 ()
.\" 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.
.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 ()
.\" 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
.sp
.BI "int sem_wait(sem_t *" sem );
.BI "int sem_trywait(sem_t *" sem );
-.sp
-.B #define _XOPEN_SOURCE 600
-.B #include <semaphore.h>
-.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
.\" .BR clock_gettime (3),
.BR sem_getvalue (3),
.BR sem_post (3),
-.BR feature_test_macros (7),
.BR sem_overview (7)
.\" Correction, 2000-03-03, Andreas Jaeger <aj@suse.de>
.\" 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
.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.
.\" 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
.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 ()
.\" 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
.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
.\" 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
.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
.\" 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
.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 ()
.\" 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
.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 ()
.\" 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 <signal.h>
.sp
.BI "int sigvec(int " sig ", struct sigvec *" vec ", struct sigvec *" ovec );
.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.
.BR raise (3),
.BR sigpause (3),
.BR sigset (3),
-.BR feature_test_macros (7),
.BR signal (7)
.\" 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 <sys/socket.h>
.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
.\" 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 <moz@compsoc.man.ac.uk>
-.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
.sp
.BI "char *strdup(const char *" s );
.sp
-.B #define _GNU_SOURCE
-.br
-.B #include <string.h>
-.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 ()
.BR free (3),
.BR malloc (3),
.BR realloc (3),
-.BR wcsdup (3),
-.BR feature_test_macros (7)
+.BR wcsdup (3)
.\" 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
.BI "char *strerror(int " errnum );
.sp
.BI "char *strerror_r(int " errnum ", char *" buf ", size_t " buflen );
- /* GNU-specific strerror_r() */
+.fi
.sp
-.B #define _XOPEN_SOURCE 600
-.B #include <string.h>
+.in -4n
+Feature Test Macro Requirements for glibc (see
+.BR feature_test_macros (7)):
+.in
.sp
-.BI "int strerror_r(int " errnum ", char *" buf ", size_t " buflen );
- /* XSI-compliant strerror_r() */
-.fi
+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 ()
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 ()
.BR errno (3),
.BR error (3),
.BR perror (3),
-.BR strsignal (3),
-.BR feature_test_macros (7)
+.BR strsignal (3)
.\" 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
.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 ()
.\" (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 <stdlib.h>
.sp
.BI "double strtod(const char *" nptr ", char **" endptr );
-.sp
-.BR "#define _XOPEN_SOURCE 600" " /* or #define _ISOC99_SOURCE */"
.br
-.B #include <stdlib.h>
-.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 (),
.BR atoi (3),
.BR atol (3),
.BR strtol (3),
-.BR strtoul (3),
-.BR feature_test_macros (7)
+.BR strtoul (3)
.\" Updated, added strtok_r. 2000-02-13 Nicolás Lichtmaier <nick@debian.org>
.\" 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
.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 ()
.\" 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
.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 ()
.\" 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
.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 ()
.\" Modified 13 Dec 2001, Martin Schulze <joey@infodrom.org>
.\" Modified 3 Jan 2002, Michael Kerrisk <mtk-manpages@gmx.net>
.\"
-.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
.br
.BI "void closelog(void);"
.sp
-.B #define _BSD_SOURCE
-.br
.B #include <stdarg.h>
.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.
.BR logger (1),
.BR setlogmask (3),
.BR syslog.conf (5),
-.BR feature_test_macros (7),
.BR syslogd (8)
.\" 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 <termios.h>"
.sp
.BI "pid_t tcgetsid(int " fd );
.\" 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
.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 ()
.\" 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
.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 ()
.\" 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 \-
.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.
.BR stty (1),
.BR console_ioctl (4),
.BR tty_ioctl (4),
-.BR feature_test_macros (7),
.BR setserial (8)
.\" Based on glibc infopages
.\" Modified 2004-11-15, fixed error noted by Fabian Kreutz
.\" <kreutz@dbs.uni-hannover.de>
-.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
.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
.\" 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
.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 ()
.\"
.\" 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
.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
.\" 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
.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.
.\" This replaces an earlier man page written by Walter Harms
.\" <walter.harms@informatik.uni-oldenburg.de>.
.\"
-.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 <unistd.h>" " /* on BSD-like systems */"
+.BR "#include <unistd.h>" " /* on BSD-like systems, and Linux */"
.br
.BR "#include <stdlib.h>" " /* 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 ()
.\" Modified 2001-11-13, aeb
.\" Modified 2004-12-01 mtk and Martin Schulze <joey@infodrom.org>
.\"
-.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
.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 ()
.\" 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 <unistd.h>"
.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 ()
.BR select (2),
.BR setitimer (2),
.BR usleep (3),
-.BR feature_test_macros (7),
.BR time (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
.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 <stdio.h>
.sp
.BI "void clearerr_unlocked(FILE *" stream );
.\" 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 <unistd.h>"
.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 ()
.BR setitimer (2),
.BR ualarm (3),
.BR sleep (3),
-.BR feature_test_macros (7),
.BR time (7)
.\" 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 <wchar.h>
.sp
.BI "int wcscasecmp(const wchar_t *" s1 ", const wchar_t *" s2 );
.\" 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 <wchar.h>
.sp
.BI "int wcsncasecmp(const wchar_t *" s1 ", const wchar_t *" s2 ", size_t " n );
.\" 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 <wchar.h>
.sp
.BI "size_t wcsnlen(const wchar_t *" s ", size_t " maxlen );
.\" 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 <wchar.h>
.sp
.BI "size_t wcsnrtombs(char *" dest ", const wchar_t **" src ", size_t " nwc ,
.\" 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 <wchar.h>
.sp
.BI "int wcswidth(const wchar_t *" s ", size_t " n );
.\" 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
.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 ()
.\" 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
.BI "int swprintf(wchar_t *" wcs ", size_t " maxlen ,
.BI " const wchar_t *" format ", ...);"
.sp
-.B #include <stdarg.h>
-.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 ()
projects / thirdparty / man-pages.git / commitdiff
