accept.2, clone.2, dup.2, fallocate.2, pipe.2, readahead.2, sched_setaffinity.2, unshare.2, CPU_SET.3, endian.3, euidaccess.3, fexecve.3, getpt.3, getpw.3, getumask.3, getutmp.3, gnu_get_libc_version.3, makedev.3, matherr.3, mbsnrtowcs.3, memfrob.3, pthread_attr_setaffinity_np.3, pthread_getattr_np.3, pthread_setaffinity_np.3, pthread_tryjoin_np.3, tcgetsid.3, wcscasecmp.3, wcsncasecmp.3, wcsnlen.3, wcsnrtombs.3, wcswidth.3, rtld-audit.7: SYNOPSIS: Add reference to feature_test_macros(7)

These pages specify feature test macros in the function
prototypes. Add a reference to feature_test_macros(7),
so that readers are pointed to the information that
feature test macros must be defined before including
*any* header file.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2010-09-10 07:06:22 +02:00
parent 090e0f8c7d
commit 86b91fdffb
32 changed files with 63 additions and 63 deletions

View File

@ -36,7 +36,7 @@
.\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com>
.\" 2008-12-04, mtk, Add documentation of accept4()
.\"
.TH ACCEPT 2 2009-02-23 "Linux" "Linux Programmer's Manual"
.TH ACCEPT 2 2010-09-10 "Linux" "Linux Programmer's Manual"
.SH NAME
accept \- accept a connection on a socket
.SH SYNOPSIS
@ -46,7 +46,7 @@ accept \- accept a connection on a socket
.BI "int accept(int " sockfd ", struct sockaddr *" addr ", socklen_t *" addrlen );
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <sys/socket.h>
.BI "int accept4(int " sockfd ", struct sockaddr *" addr ,

View File

@ -42,12 +42,12 @@
.\" FIXME . 2.6.25 marks the unused CLONE_STOPPED as obsolete, and it will
.\" probably be removed in the future.
.\"
.TH CLONE 2 2009-07-18 "Linux" "Linux Programmer's Manual"
.TH CLONE 2 2010-09-10 "Linux" "Linux Programmer's Manual"
.SH NAME
clone, __clone2 \- create a child process
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.\" Actually _BSD_SOURCE || _SVID_SOURCE
.\" See http://sources.redhat.com/bugzilla/show_bug.cgi?id=4749
.B #include <sched.h>

View File

@ -33,7 +33,7 @@
.\" details for dup2().
.\" 2008-10-09, mtk: add description of dup3()
.\"
.TH DUP 2 2008-10-09 "Linux" "Linux Programmer's Manual"
.TH DUP 2 2010-09-10 "Linux" "Linux Programmer's Manual"
.SH NAME
dup, dup2, dup3 \- duplicate a file descriptor
.SH SYNOPSIS
@ -43,7 +43,7 @@ dup, dup2, dup3 \- duplicate a file descriptor
.BI "int dup(int " oldfd );
.BI "int dup2(int " oldfd ", int " newfd );
.sp
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <unistd.h>
.sp
.BI "int dup3(int " oldfd ", int " newfd ", int " flags );

View File

@ -2,12 +2,12 @@
.\" Written by Dave Chinner <dgc@sgi.com>
.\" May be distributed as per GNU General Public License version 2.
.\"
.TH FALLOCATE 2 2009-03-13 "Linux" "Linux Programmer's Manual"
.TH FALLOCATE 2 2010-09-10 "Linux" "Linux Programmer's Manual"
.SH NAME
fallocate \- manipulate file space
.SH SYNOPSIS
.nf
#define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <fcntl.h>
.BI "int fallocate(int " fd ", int " mode ", off_t " offset \

View File

@ -33,7 +33,7 @@
.\" to EXAMPLE text.
.\" 2008-10-10, mtk: add description of pipe2()
.\"
.TH PIPE 2 2009-09-15 "Linux" "Linux Programmer's Manual"
.TH PIPE 2 2010-09-10 "Linux" "Linux Programmer's Manual"
.SH NAME
pipe, pipe2 \- create pipe
.SH SYNOPSIS
@ -42,7 +42,7 @@ pipe, pipe2 \- create pipe
.sp
.BI "int pipe(int " pipefd "[2]);"
.sp
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <unistd.h>
.sp
.BI "int pipe2(int " pipefd "[2], int " flags );

View File

@ -25,12 +25,12 @@
.\" 2004-05-40 Created by Michael Kerrisk <mtk.manpages@gmail.com>
.\" 2004-10-05 aeb, minor correction
.\"
.TH READAHEAD 2 2007-07-26 "Linux" "Linux Programmer's Manual"
.TH READAHEAD 2 2010-09-10 "Linux" "Linux Programmer's Manual"
.SH NAME
readahead \- perform file readahead into page cache
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <fcntl.h>
.sp
.BI "ssize_t readahead(int " fd ", off64_t " offset ", size_t " count );

View File

@ -32,13 +32,13 @@
.\" 2008-11-12, mtk, removed CPU_*() macro descriptions to a
.\" separate CPU_SET(3) page.
.\"
.TH SCHED_SETAFFINITY 2 2008-11-14 "Linux" "Linux Programmer's Manual"
.TH SCHED_SETAFFINITY 2 2010-09-10 "Linux" "Linux Programmer's Manual"
.SH NAME
sched_setaffinity, sched_getaffinity \- \
set and get a process's CPU affinity mask
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <sched.h>
.sp
.BI "int sched_setaffinity(pid_t " pid ", size_t " cpusetsize ,

View File

@ -18,12 +18,12 @@
.\" FIXME Document CLONE_NEWUTS, which is new in 2.6.19
.\" FIXME Document CLONE_SYSVSEM, which is new in 2.6.26
.\"
.TH UNSHARE 2 2008-11-20 "Linux" "Linux Programmer's Manual"
.TH UNSHARE 2 2010-09-10 "Linux" "Linux Programmer's Manual"
.SH NAME
unshare \- disassociate parts of the process execution context
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.\" Actually _BSD_SOURCE || _SVID_SOURCE
.\" See http://sources.redhat.com/bugzilla/show_bug.cgi?id=4749
.B #include <sched.h>

View File

@ -22,7 +22,7 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.TH CPU_SET 3 2010-02-21 "Linux" "Linux Programmer's Manual"
.TH CPU_SET 3 2010-09-10 "Linux" "Linux Programmer's Manual"
.SH NAME
CPU_SET, CPU_CLR, CPU_ISSET, CPU_ZERO, CPU_COUNT,
CPU_AND, CPU_OR, CPU_XOR, CPU_EQUAL,
@ -32,7 +32,7 @@ CPU_COUNT_S, CPU_AND_S, CPU_OR_S, CPU_XOR_S, CPU_EQUAL_S \-
macros for manipulating CPU sets
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <sched.h>
.sp
.BI "void CPU_ZERO(cpu_set_t *" set );

View File

@ -23,14 +23,14 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.TH ENDIAN 3 2009-01-19 "GNU" "Linux Programmer's Manual"
.TH ENDIAN 3 2010-09-10 "GNU" "Linux Programmer's Manual"
.SH NAME
htobe16, htole16, be16toh, le16toh, htobe32, htole32, be32toh, le32toh,
htobe64, htole64, be64toh, le64toh \-
convert values between host and big-/little-endian byte order
.SH SYNOPSIS
.nf
.B #define _BSD_SOURCE
.BR "#define _BSD_SOURCE" " /* See feature_test_macros(7) */"
.B #include <endian.h>
.BI "uint16_t htobe16(uint16_t " host_16bits );

View File

@ -23,12 +23,12 @@
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\"
.TH EUIDACCESS 3 2007-07-26 "" "Linux Programmer's Manual"
.TH EUIDACCESS 3 2010-09-10 "" "Linux Programmer's Manual"
.SH NAME
euidaccess, eaccess \- check effective user's permissions for a file
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <unistd.h>
.sp
.BI "int euidaccess(const char *" pathname ", int " mode );

View File

@ -22,12 +22,12 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.TH FEXECVE 3 2009-02-04 "Linux" "Linux Programmer's Manual"
.TH FEXECVE 3 2010-09-10 "Linux" "Linux Programmer's Manual"
.SH NAME
fexecve \- execute program specified via file descriptor
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <unistd.h>
.sp
.BI "int fexecve(int " fd ", char *const " argv "[], char *const " envp []);

View File

@ -2,12 +2,12 @@
.\" This man page was written by Jeremy Phelps <jphelps@notreached.net>.
.\" Redistribute and modify at will.
.\"
.TH GETPT 3 2008-06-14 "GNU" "Linux Programmer's Manual"
.TH GETPT 3 2010-09-10 "GNU" "Linux Programmer's Manual"
.SH NAME
getpt \- open the pseudo-terminal master (PTM)
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <stdlib.h>
.sp
.B "int getpt(void);"

View File

@ -27,12 +27,12 @@
.\" Modified Sat Jul 24 19:23:25 1993 by Rik Faith (faith@cs.unc.edu)
.\" Modified Mon May 27 21:37:47 1996 by Martin Schulze (joey@linux.de)
.\"
.TH GETPW 3 2007-12-12 "GNU" "Linux Programmer's Manual"
.TH GETPW 3 2010-09-10 "GNU" "Linux Programmer's Manual"
.SH NAME
getpw \- Re-construct password line entry
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <sys/types.h>
.B #include <pwd.h>
.sp

View File

@ -23,11 +23,11 @@
.\" This replaces an earlier man page written by Walter Harms
.\" <walter.harms@informatik.uni-oldenburg.de>.
.\"
.TH GETUMASK 3 2009-01-20 "GNU" "Linux Programmer's Manual"
.TH GETUMASK 3 2010-09-10 "GNU" "Linux Programmer's Manual"
.SH NAME
getumask \- get file creation mask
.SH SYNOPSIS
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.br
.B "#include <sys/types.h>"
.br

View File

@ -21,12 +21,12 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.TH GETUTMP 3 2008-07-02 "Linux" "Linux Programmer's Manual"
.TH GETUTMP 3 2010-09-10 "Linux" "Linux Programmer's Manual"
.SH NAME
getutmp, getutmpx \- copy utmp structure to utmpx, and vice versa
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <utmpx.h>
.BI " void getutmp(const struct utmpx *" ux ", struct utmp *" u );

View File

@ -21,12 +21,12 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.TH GNU_GET_LIBC_VERSION 3 2008-07-02 "Linux" "Linux Programmer's Manual"
.TH GNU_GET_LIBC_VERSION 3 2010-09-10 "Linux" "Linux Programmer's Manual"
.SH NAME
gnu_get_libc_version, gnu_get_libc_release \- get glibc version and release
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <gnu/libc-version.h>
.B const char *gnu_get_libc_version(void);

View File

@ -21,12 +21,12 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.TH MAKEDEV 3 2008-12-01 "Linux" "Linux Programmer's Manual"
.TH MAKEDEV 3 2010-09-10 "Linux" "Linux Programmer's Manual"
.SH NAME
makedev, major, minor \- manage a device number
.SH SYNOPSIS
.nf
.B #define _BSD_SOURCE
.BR "#define _BSD_SOURCE" " /* See feature_test_macros(7) */"
.B #include <sys/types.h>
.BI "dev_t makedev(int " maj ", int " min );

View File

@ -27,7 +27,7 @@
matherr \- SVID math library exception handling
.SH SYNOPSIS
.nf
.B #define _SVID_SOURCE
.BR "#define _SVID_SOURCE" " /* See feature_test_macros(7) */"
.B #include <math.h>
.BI "int matherr(struct exception *" exc );

View File

@ -10,12 +10,12 @@
.\" Dinkumware C library reference http://www.dinkumware.com/
.\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
.\"
.TH MBSNRTOWCS 3 2007-07-26 "GNU" "Linux Programmer's Manual"
.TH MBSNRTOWCS 3 2010-09-10 "GNU" "Linux Programmer's Manual"
.SH NAME
mbsnrtowcs \- convert a multibyte string to a wide-character string
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <wchar.h>
.sp
.BI "size_t mbsnrtowcs(wchar_t *" dest ", const char **" src ,

View File

@ -25,12 +25,12 @@
.\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\" 386BSD man pages
.\" Modified Sat Jul 24 18:54:45 1993 by Rik Faith (faith@cs.unc.edu)
.TH MEMFROB 3 2007-07-26 "GNU" "Linux Programmer's Manual"
.TH MEMFROB 3 2010-09-10 "GNU" "Linux Programmer's Manual"
.SH NAME
memfrob \- frobnicate (encrypt) a memory area
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <string.h>
.sp
.BI "void *memfrob(void *" s ", size_t " n );

View File

@ -21,13 +21,13 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.TH PTHREAD_ATTR_SETAFFINITY_NP 3 2009-02-01 "Linux" "Linux Programmer's Manual"
.TH PTHREAD_ATTR_SETAFFINITY_NP 3 2010-09-10 "Linux" "Linux Programmer's Manual"
.SH NAME
pthread_attr_setaffinity_np, pthread_attr_getaffinity_np \- set/get
CPU affinity attribute in thread attributes object
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <pthread.h>
.BI "int pthread_attr_setaffinity_np(pthread_attr_t *" attr ,

View File

@ -21,12 +21,12 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.TH PTHREAD_GETATTR_NP 3 2008-11-11 "Linux" "Linux Programmer's Manual"
.TH PTHREAD_GETATTR_NP 3 2010-09-10 "Linux" "Linux Programmer's Manual"
.SH NAME
pthread_getattr_np \- get attributes of created thread
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <pthread.h>
.BI "int pthread_getattr_np(pthread_t " thread ", pthread_attr_t *" attr );

View File

@ -21,13 +21,13 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.TH PTHREAD_SETAFFINITY_NP 3 2008-11-27 "Linux" "Linux Programmer's Manual"
.TH PTHREAD_SETAFFINITY_NP 3 2010-09-10 "Linux" "Linux Programmer's Manual"
.SH NAME
pthread_setaffinity_np, pthread_getaffinity_np \- set/get
CPU affinity of a thread
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <pthread.h>
.BI "int pthread_setaffinity_np(pthread_t " thread ", size_t " cpusetsize ,

View File

@ -21,13 +21,13 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.TH PTHREAD_TRYJOIN_NP 3 2008-11-11 "Linux" "Linux Programmer's Manual"
.TH PTHREAD_TRYJOIN_NP 3 2010-09-10 "Linux" "Linux Programmer's Manual"
.SH NAME
pthread_tryjoin_np, pthread_timedjoin_np \- try to join with a
terminated thread
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <pthread.h>
.BI "int pthread_tryjoin_np(pthread_t " thread ", void **" retval );

View File

@ -20,11 +20,11 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.TH TCGETSID 3 2008-06-14 "GNU" "Linux Programmer's Manual"
.TH TCGETSID 3 2010-09-10 "GNU" "Linux Programmer's Manual"
.SH NAME
tcgetsid \- get session ID
.SH SYNOPSIS
.B #define _XOPEN_SOURCE 500
.BR "#define _XOPEN_SOURCE 500" " /* See feature_test_macros(7) */"
.br
.B "#include <termios.h>"
.sp

View File

@ -10,12 +10,12 @@
.\" Dinkumware C library reference http://www.dinkumware.com/
.\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
.\"
.TH WCSCASECMP 3 2009-02-04 "GNU" "Linux Programmer's Manual"
.TH WCSCASECMP 3 2010-09-10 "GNU" "Linux Programmer's Manual"
.SH NAME
wcscasecmp \- compare two wide-character strings, ignoring case
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <wchar.h>
.sp
.BI "int wcscasecmp(const wchar_t *" s1 ", const wchar_t *" s2 );

View File

@ -10,12 +10,12 @@
.\" Dinkumware C library reference http://www.dinkumware.com/
.\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
.\"
.TH WCSNCASECMP 3 2009-02-04 "GNU" "Linux Programmer's Manual"
.TH WCSNCASECMP 3 2010-09-10 "GNU" "Linux Programmer's Manual"
.SH NAME
wcsncasecmp \- compare two fixed-size wide-character strings, ignoring case
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <wchar.h>
.sp
.BI "int wcsncasecmp(const wchar_t *" s1 ", const wchar_t *" s2 ", size_t " n );

View File

@ -10,12 +10,12 @@
.\" Dinkumware C library reference http://www.dinkumware.com/
.\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
.\"
.TH WCSNLEN 3 2007-07-26 "GNU" "Linux Programmer's Manual"
.TH WCSNLEN 3 2010-09-10 "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
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <wchar.h>
.sp
.BI "size_t wcsnlen(const wchar_t *" s ", size_t " maxlen );

View File

@ -10,12 +10,12 @@
.\" Dinkumware C library reference http://www.dinkumware.com/
.\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
.\"
.TH WCSNRTOMBS 3 2007-07-26 "GNU" "Linux Programmer's Manual"
.TH WCSNRTOMBS 3 2010-09-10 "GNU" "Linux Programmer's Manual"
.SH NAME
wcsnrtombs \- convert a wide-character string to a multibyte string
.SH SYNOPSIS
.nf
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <wchar.h>
.sp
.BI "size_t wcsnrtombs(char *" dest ", const wchar_t **" src ", size_t " nwc ,

View File

@ -10,12 +10,12 @@
.\" Dinkumware C library reference http://www.dinkumware.com/
.\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
.\"
.TH WCSWIDTH 3 2007-07-26 "GNU" "Linux Programmer's Manual"
.TH WCSWIDTH 3 2010-09-10 "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
.BR "#define _XOPEN_SOURCE" " /* See feature_test_macros(7) */"
.B #include <wchar.h>
.sp
.BI "int wcswidth(const wchar_t *" s ", size_t " n );

View File

@ -23,11 +23,11 @@
.\"
.\" 2009-01-12, mtk, Created
.\"
.TH RTLD-AUDIT 7 2009-03-30 "Linux" "Linux Programmer's Manual"
.TH RTLD-AUDIT 7 2010-09-10 "Linux" "Linux Programmer's Manual"
.SH NAME
rtld-audit \- auditing API for the dynamic linker
.SH SYNOPSIS
.B #define _GNU_SOURCE
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <link.h>
.SH DESCRIPTION