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

View File

@ -23,19 +23,30 @@
.\" 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
faccessat \- check user's permissions of a file relative to a \
directory file descriptor
.SH SYNOPSIS
.nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <unistd.h>
.sp
.BI "int faccessat(int " dirfd ", const char *" pathname ", int " \
mode ", int " flags );
.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
The
.BR faccessat ()

View File

@ -23,19 +23,30 @@
.\" 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
fchmodat \- change permissions of a file relative to a directory \
file descriptor
.SH SYNOPSIS
.nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <sys/stat.h>
.sp
.BI "int fchmodat(int " dirfd ", const char *" pathname ", mode_t " \
mode ", int " flags );
.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
The
.BR fchmodat ()

View File

@ -23,19 +23,30 @@
.\" 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
fchownat \- change ownership of a file relative to a directory \
file descriptor
.SH SYNOPSIS
.nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <unistd.h>
.sp
.BI "int fchownat(int " dirfd ", const char *" pathname ,
.BI " uid_t " owner ", gid_t " group ", int " flags );
.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
The
.BR fchownat ()

View File

@ -23,12 +23,11 @@
.\" 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
fstatat \- get file status relative to a directory file descriptor
.SH SYNOPSIS
.nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <sys/stat.h>
.sp
@ -36,6 +35,18 @@ fstatat \- get file status relative to a directory file descriptor
buf ,
.BI " int " flags );
.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
The
.BR fstatat ()

View File

@ -23,18 +23,29 @@
.\" 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
futimesat \- change timestamps of a file relative to a \
directory file descriptor
.SH SYNOPSIS
.nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */
.sp
.BI "int futimesat(int " dirfd ", const char *" pathname ,
.BI " const struct timeval " times [2]);
.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
This system call is obsolete.
Use

View File

@ -23,18 +23,29 @@
.\" 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
linkat \- create a file link relative to directory file descriptors
.SH SYNOPSIS
.nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <unistd.h>
.sp
.BI "int linkat(int " olddirfd ", const char *" oldpath ,
.BI " int " newdirfd ", const char *" newpath ", int " flags );
.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
The
.BR linkat ()

View File

@ -23,17 +23,28 @@
.\" 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
mkdirat \- create a directory relative to a directory file descriptor
.SH SYNOPSIS
.nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <sys/stat.h>
.sp
.BI "int mkdirat(int " dirfd ", const char *" pathname ", mode_t " mode );
.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
The
.BR mkdirat ()

View File

@ -23,19 +23,30 @@
.\" 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
mknodat \- create a special or ordinary file relative to a directory
file descriptor
.SH SYNOPSIS
.nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <sys/stat.h>
.sp
.BI "int mknodat(int " dirfd ", 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 mknodat ():
.br
Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
.br
Before glibc 2.10:
_ATFILE_SOURCE
.SH DESCRIPTION
The
.BR mknodat ()

View File

@ -23,18 +23,29 @@
.\" 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
openat \- open a file relative to a directory file descriptor
.SH SYNOPSIS
.nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h>
.sp
.BI "int openat(int " dirfd ", const char *" pathname ", int " flags );
.BI "int openat(int " dirfd ", const char *" pathname ", int " flags \
", mode_t " mode );
.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
The
.BR openat ()

View File

@ -23,19 +23,30 @@
.\" 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
readlinkat \- read value of a symbolic link relative to
a directory file descriptor
.SH SYNOPSIS
.nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <unistd.h>
.sp
.BI "int readlinkat(int " dirfd ", const char *" pathname ,
.BI " char *" buf ", size_t " bufsiz );
.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
The
.BR readlinkat ()

View File

@ -23,18 +23,29 @@
.\" 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
renameat \- rename a file relative to directory file descriptors
.SH SYNOPSIS
.nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <stdio.h>
.sp
.BI "int renameat(int " olddirfd ", const char *" oldpath ,
.BI " int " newdirfd ", const char *" newpath );
.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
The
.BR renameat ()

View File

@ -23,18 +23,29 @@
.\" 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
symlinkat \- create a symbolic link relative to a directory file descriptor
.SH SYNOPSIS
.nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <stdio.h>
.sp
.BI "int symlinkat(const char *" oldpath ", int " newdirfd \
", const char *" newpath );
.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
The
.BR symlinkat ()

View File

@ -23,16 +23,27 @@
.\" 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
unlinkat \- remove a directory entry relative to a directory file descriptor
.SH SYNOPSIS
.nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h>
.sp
.BI "int unlinkat(int " dirfd ", const char *" pathname ", int " flags );
.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
The
.BR unlinkat ()

View File

@ -23,7 +23,7 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" 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
utimensat, futimens \- change file timestamps with nanosecond precision
.SH SYNOPSIS
@ -42,12 +42,18 @@ Feature Test Macro Requirements for glibc (see
.in
.sp
.BR utimensat ():
.br
Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
.br
Before glibc 2.10:
_ATFILE_SOURCE
.br
.BR futimens ():
.\" FIXME . Fix the FTM after POSIX.1-2008 changes reach glibc
_GNU_SOURCE /* Will likely change after POSIX.1-2008 changes are
incorporated into glibc */
.br
Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
.br
Before glibc 2.10:
_GNU_SOURCE
.SH DESCRIPTION
.BR utimensat ()
and

View File

@ -23,17 +23,28 @@
.\" 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
mkfifoat \- make a FIFO (named pipe) relative to a directory file descriptor
.SH SYNOPSIS
.nf
.B #define _ATFILE_SOURCE
.B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <sys/stat.h>
.sp
.BI "int mkfifoat(int " dirfd ", const char *" pathname ", mode_t " mode );
.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
The
.BR mkfifoat ()