LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

faccessat.2, fchmodat.2, fchownat.2, fstatat.2, futimesat.2, linkat.2, mkdirat.2, mknodat.2, openat.2, readlinkat.2, renameat.2, symlinkat.2, unlinkat.2, utimensat.2, mkfifoat.3: Update feature test macro requirements 

Starting in glibc 2.10, defining _XOPEN_SOURCE >= 700,
or _POSIX_C_SOURCE >= 200809 exposes the declarations of
these functions.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2009-12-13 22:54:45 +01:00
parent 8a8c6284f7
commit 7cc796ee52
15 changed files with 192 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
man2/faccessat.2
View File

@ -23,19 +23,30 @@
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" .\"
.\" .\"
.TH FACCESSAT 2 2008-08-21 "Linux" "Linux Programmer's Manual" .TH FACCESSAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
faccessat \- check user's permissions of a file relative to a \ faccessat \- check user's permissions of a file relative to a \
directory file descriptor directory file descriptor
.SH SYNOPSIS .SH SYNOPSIS
.nf .nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */ .B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <unistd.h> .B #include <unistd.h>
.sp .sp
.BI "int faccessat(int " dirfd ", const char *" pathname ", int " \ .BI "int faccessat(int " dirfd ", const char *" pathname ", int " \
mode ", int " flags ); mode ", int " flags );
.fi .fi
.sp
.in -4n
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.in
.sp
.BR faccessat ():
.br
Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
.br
Before glibc 2.10:
_ATFILE_SOURCE
.SH DESCRIPTION .SH DESCRIPTION
The The
.BR faccessat () .BR faccessat ()

15
man2/fchmodat.2
View File

@ -23,19 +23,30 @@
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" .\"
.\" .\"
.TH FCHMODAT 2 2008-08-21 "Linux" "Linux Programmer's Manual" .TH FCHMODAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
fchmodat \- change permissions of a file relative to a directory \ fchmodat \- change permissions of a file relative to a directory \
file descriptor file descriptor
.SH SYNOPSIS .SH SYNOPSIS
.nf .nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */ .B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <sys/stat.h> .B #include <sys/stat.h>
.sp .sp
.BI "int fchmodat(int " dirfd ", const char *" pathname ", mode_t " \ .BI "int fchmodat(int " dirfd ", const char *" pathname ", mode_t " \
mode ", int " flags ); mode ", int " flags );
.fi .fi
.sp
.in -4n
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.in
.sp
.BR fchmodat ():
.br
Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
.br
Before glibc 2.10:
_ATFILE_SOURCE
.SH DESCRIPTION .SH DESCRIPTION
The The
.BR fchmodat () .BR fchmodat ()

15
man2/fchownat.2
View File

@ -23,19 +23,30 @@
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" .\"
.\" .\"
.TH FCHOWNAT 2 2008-08-21 "Linux" "Linux Programmer's Manual" .TH FCHOWNAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
fchownat \- change ownership of a file relative to a directory \ fchownat \- change ownership of a file relative to a directory \
file descriptor file descriptor
.SH SYNOPSIS .SH SYNOPSIS
.nf .nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */ .B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <unistd.h> .B #include <unistd.h>
.sp .sp
.BI "int fchownat(int " dirfd ", const char *" pathname , .BI "int fchownat(int " dirfd ", const char *" pathname ,
.BI " uid_t " owner ", gid_t " group ", int " flags ); .BI " uid_t " owner ", gid_t " group ", int " flags );
.fi .fi
.sp
.in -4n
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.in
.sp
.BR fchownat ():
.br
Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
.br
Before glibc 2.10:
_ATFILE_SOURCE
.SH DESCRIPTION .SH DESCRIPTION
The The
.BR fchownat () .BR fchownat ()

15
man2/fstatat.2
View File

@ -23,12 +23,11 @@
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" .\"
.\" .\"
.TH FSTATAT 2 2008-08-21 "Linux" "Linux Programmer's Manual" .TH FSTATAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
fstatat \- get file status relative to a directory file descriptor fstatat \- get file status relative to a directory file descriptor
.SH SYNOPSIS .SH SYNOPSIS
.nf .nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */ .B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <sys/stat.h> .B #include <sys/stat.h>
.sp .sp
@ -36,6 +35,18 @@ fstatat \- get file status relative to a directory file descriptor
buf , buf ,
.BI " int " flags ); .BI " int " flags );
.fi .fi
.sp
.in -4n
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.in
.sp
.BR fstatat ():
.br
Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
.br
Before glibc 2.10:
_ATFILE_SOURCE
.SH DESCRIPTION .SH DESCRIPTION
The The
.BR fstatat () .BR fstatat ()

15
man2/futimesat.2
View File

@ -23,18 +23,29 @@
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" .\"
.\" .\"
.TH FUTIMESAT 2 2008-06-05 "Linux" "Linux Programmer's Manual" .TH FUTIMESAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
futimesat \- change timestamps of a file relative to a \ futimesat \- change timestamps of a file relative to a \
directory file descriptor directory file descriptor
.SH SYNOPSIS .SH SYNOPSIS
.nf .nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */ .B #include <fcntl.h> /* Definition of AT_* constants */
.sp .sp
.BI "int futimesat(int " dirfd ", const char *" pathname , .BI "int futimesat(int " dirfd ", const char *" pathname ,
.BI " const struct timeval " times [2]); .BI " const struct timeval " times [2]);
.fi .fi
.sp
.in -4n
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.in
.sp
.BR futimesat ():
.br
Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
.br
Before glibc 2.10:
_ATFILE_SOURCE
.SH DESCRIPTION .SH DESCRIPTION
This system call is obsolete. This system call is obsolete.
Use Use

15
man2/linkat.2
View File

@ -23,18 +23,29 @@
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" .\"
.\" .\"
.TH LINKAT 2 2008-08-21 "Linux" "Linux Programmer's Manual" .TH LINKAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
linkat \- create a file link relative to directory file descriptors linkat \- create a file link relative to directory file descriptors
.SH SYNOPSIS .SH SYNOPSIS
.nf .nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */ .B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <unistd.h> .B #include <unistd.h>
.sp .sp
.BI "int linkat(int " olddirfd ", const char *" oldpath , .BI "int linkat(int " olddirfd ", const char *" oldpath ,
.BI " int " newdirfd ", const char *" newpath ", int " flags ); .BI " int " newdirfd ", const char *" newpath ", int " flags );
.fi .fi
.sp
.in -4n
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.in
.sp
.BR linkat ():
.br
Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
.br
Before glibc 2.10:
_ATFILE_SOURCE
.SH DESCRIPTION .SH DESCRIPTION
The The
.BR linkat () .BR linkat ()

15
man2/mkdirat.2
View File

@ -23,17 +23,28 @@
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" .\"
.\" .\"
.TH MKDIRAT 2 2008-08-21 "Linux" "Linux Programmer's Manual" .TH MKDIRAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
mkdirat \- create a directory relative to a directory file descriptor mkdirat \- create a directory relative to a directory file descriptor
.SH SYNOPSIS .SH SYNOPSIS
.nf .nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */ .B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <sys/stat.h> .B #include <sys/stat.h>
.sp .sp
.BI "int mkdirat(int " dirfd ", const char *" pathname ", mode_t " mode ); .BI "int mkdirat(int " dirfd ", const char *" pathname ", mode_t " mode );
.fi .fi
.sp
.in -4n
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.in
.sp
.BR mkdirat ():
.br
Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
.br
Before glibc 2.10:
_ATFILE_SOURCE
.SH DESCRIPTION .SH DESCRIPTION
The The
.BR mkdirat () .BR mkdirat ()

15
man2/mknodat.2
View File

@ -23,19 +23,30 @@
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" .\"
.\" .\"
.TH MKNODAT 2 2008-08-21 "Linux" "Linux Programmer's Manual" .TH MKNODAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
mknodat \- create a special or ordinary file relative to a directory mknodat \- create a special or ordinary file relative to a directory
file descriptor file descriptor
.SH SYNOPSIS .SH SYNOPSIS
.nf .nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */ .B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <sys/stat.h> .B #include <sys/stat.h>
.sp .sp
.BI "int mknodat(int " dirfd ", const char *" pathname ", mode_t " mode \ .BI "int mknodat(int " dirfd ", const char *" pathname ", mode_t " mode \
", dev_t " dev ); ", dev_t " dev );
.fi .fi
.sp
.in -4n
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.in
.sp
.BR mknodat ():
.br
Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
.br
Before glibc 2.10:
_ATFILE_SOURCE
.SH DESCRIPTION .SH DESCRIPTION
The The
.BR mknodat () .BR mknodat ()

15
man2/openat.2
View File

@ -23,18 +23,29 @@
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" .\"
.\" .\"
.TH OPENAT 2 2008-08-21 "Linux" "Linux Programmer's Manual" .TH OPENAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
openat \- open a file relative to a directory file descriptor openat \- open a file relative to a directory file descriptor
.SH SYNOPSIS .SH SYNOPSIS
.nf .nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> .B #include <fcntl.h>
.sp .sp
.BI "int openat(int " dirfd ", const char *" pathname ", int " flags ); .BI "int openat(int " dirfd ", const char *" pathname ", int " flags );
.BI "int openat(int " dirfd ", const char *" pathname ", int " flags \ .BI "int openat(int " dirfd ", const char *" pathname ", int " flags \
", mode_t " mode ); ", mode_t " mode );
.fi .fi
.sp
.in -4n
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.in
.sp
.BR openat ():
.br
Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
.br
Before glibc 2.10:
_ATFILE_SOURCE
.SH DESCRIPTION .SH DESCRIPTION
The The
.BR openat () .BR openat ()

15
man2/readlinkat.2
View File

@ -23,19 +23,30 @@
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" .\"
.\" .\"
.TH READLINKAT 2 2008-08-21 "Linux" "Linux Programmer's Manual" .TH READLINKAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
readlinkat \- read value of a symbolic link relative to readlinkat \- read value of a symbolic link relative to
a directory file descriptor a directory file descriptor
.SH SYNOPSIS .SH SYNOPSIS
.nf .nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */ .B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <unistd.h> .B #include <unistd.h>
.sp .sp
.BI "int readlinkat(int " dirfd ", const char *" pathname , .BI "int readlinkat(int " dirfd ", const char *" pathname ,
.BI " char *" buf ", size_t " bufsiz ); .BI " char *" buf ", size_t " bufsiz );
.fi .fi
.sp
.in -4n
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.in
.sp
.BR readlinkat ():
.br
Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
.br
Before glibc 2.10:
_ATFILE_SOURCE
.SH DESCRIPTION .SH DESCRIPTION
The The
.BR readlinkat () .BR readlinkat ()

15
man2/renameat.2
View File

@ -23,18 +23,29 @@
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" .\"
.\" .\"
.TH RENAMEAT 2 2008-08-21 "Linux" "Linux Programmer's Manual" .TH RENAMEAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
renameat \- rename a file relative to directory file descriptors renameat \- rename a file relative to directory file descriptors
.SH SYNOPSIS .SH SYNOPSIS
.nf .nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */ .B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <stdio.h> .B #include <stdio.h>
.sp .sp
.BI "int renameat(int " olddirfd ", const char *" oldpath , .BI "int renameat(int " olddirfd ", const char *" oldpath ,
.BI " int " newdirfd ", const char *" newpath ); .BI " int " newdirfd ", const char *" newpath );
.fi .fi
.sp
.in -4n
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.in
.sp
.BR renameat ():
.br
Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
.br
Before glibc 2.10:
_ATFILE_SOURCE
.SH DESCRIPTION .SH DESCRIPTION
The The
.BR renameat () .BR renameat ()

15
man2/symlinkat.2
View File

@ -23,18 +23,29 @@
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" .\"
.\" .\"
.TH SYMLINKAT 2 2008-08-21 "Linux" "Linux Programmer's Manual" .TH SYMLINKAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
symlinkat \- create a symbolic link relative to a directory file descriptor symlinkat \- create a symbolic link relative to a directory file descriptor
.SH SYNOPSIS .SH SYNOPSIS
.nf .nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */ .B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <stdio.h> .B #include <stdio.h>
.sp .sp
.BI "int symlinkat(const char *" oldpath ", int " newdirfd \ .BI "int symlinkat(const char *" oldpath ", int " newdirfd \
", const char *" newpath ); ", const char *" newpath );
.fi .fi
.sp
.in -4n
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.in
.sp
.BR symlinkat ():
.br
Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
.br
Before glibc 2.10:
_ATFILE_SOURCE
.SH DESCRIPTION .SH DESCRIPTION
The The
.BR symlinkat () .BR symlinkat ()

15
man2/unlinkat.2
View File

@ -23,16 +23,27 @@
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" .\"
.\" .\"
.TH UNLINKAT 2 2008-08-21 "Linux" "Linux Programmer's Manual" .TH UNLINKAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
unlinkat \- remove a directory entry relative to a directory file descriptor unlinkat \- remove a directory entry relative to a directory file descriptor
.SH SYNOPSIS .SH SYNOPSIS
.nf .nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> .B #include <fcntl.h>
.sp .sp
.BI "int unlinkat(int " dirfd ", const char *" pathname ", int " flags ); .BI "int unlinkat(int " dirfd ", const char *" pathname ", int " flags );
.fi .fi
.sp
.in -4n
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.in
.sp
.BR unlinkat ():
.br
Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
.br
Before glibc 2.10:
_ATFILE_SOURCE
.SH DESCRIPTION .SH DESCRIPTION
The The
.BR unlinkat () .BR unlinkat ()

14
man2/utimensat.2
View File

@ -23,7 +23,7 @@
.\" Formatted or processed versions of this manual, if unaccompanied by .\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" .\"
.TH UTIMENSAT 2 2008-09-29 "Linux" "Linux Programmer's Manual" .TH UTIMENSAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
utimensat, futimens \- change file timestamps with nanosecond precision utimensat, futimens \- change file timestamps with nanosecond precision
.SH SYNOPSIS .SH SYNOPSIS
@ -42,12 +42,18 @@ Feature Test Macro Requirements for glibc (see
.in .in
.sp .sp
.BR utimensat (): .BR utimensat ():
.br
Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
.br
Before glibc 2.10:
_ATFILE_SOURCE _ATFILE_SOURCE
.br .br
.BR futimens (): .BR futimens ():
.\" FIXME . Fix the FTM after POSIX.1-2008 changes reach glibc .br
_GNU_SOURCE /* Will likely change after POSIX.1-2008 changes are Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
incorporated into glibc */ .br
Before glibc 2.10:
_GNU_SOURCE
.SH DESCRIPTION .SH DESCRIPTION
.BR utimensat () .BR utimensat ()
and and

15
man3/mkfifoat.3
View File

@ -23,17 +23,28 @@
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" .\"
.\" .\"
.TH MKFIFOAT 3 2008-08-21 "Linux" "Linux Programmer's Manual" .TH MKFIFOAT 3 2009-12-13 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
mkfifoat \- make a FIFO (named pipe) relative to a directory file descriptor mkfifoat \- make a FIFO (named pipe) relative to a directory file descriptor
.SH SYNOPSIS .SH SYNOPSIS
.nf .nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */ .B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <sys/stat.h> .B #include <sys/stat.h>
.sp .sp
.BI "int mkfifoat(int " dirfd ", const char *" pathname ", mode_t " mode ); .BI "int mkfifoat(int " dirfd ", const char *" pathname ", mode_t " mode );
.fi .fi
.sp
.in -4n
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.in
.sp
.BR mkfifoat ():
.br
Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
.br
Before glibc 2.10:
_ATFILE_SOURCE
.SH DESCRIPTION .SH DESCRIPTION
The The
.BR mkfifoat () .BR mkfifoat ()