From 7cc796ee529fcf86f9ee3f9dcd81e3d8586c7a53 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Sun, 13 Dec 2009 22:54:45 +0100 Subject: [PATCH] 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 --- man2/faccessat.2 | 15 +++++++++++++-- man2/fchmodat.2 | 15 +++++++++++++-- man2/fchownat.2 | 15 +++++++++++++-- man2/fstatat.2 | 15 +++++++++++++-- man2/futimesat.2 | 15 +++++++++++++-- man2/linkat.2 | 15 +++++++++++++-- man2/mkdirat.2 | 15 +++++++++++++-- man2/mknodat.2 | 15 +++++++++++++-- man2/openat.2 | 15 +++++++++++++-- man2/readlinkat.2 | 15 +++++++++++++-- man2/renameat.2 | 15 +++++++++++++-- man2/symlinkat.2 | 15 +++++++++++++-- man2/unlinkat.2 | 15 +++++++++++++-- man2/utimensat.2 | 14 ++++++++++---- man3/mkfifoat.3 | 15 +++++++++++++-- 15 files changed, 192 insertions(+), 32 deletions(-) diff --git a/man2/faccessat.2 b/man2/faccessat.2 index a556b72d9..25fec2e91 100644 --- a/man2/faccessat.2 +++ b/man2/faccessat.2 @@ -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 /* Definition of AT_* constants */ .B #include .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 () diff --git a/man2/fchmodat.2 b/man2/fchmodat.2 index ee01e46fe..497c8c159 100644 --- a/man2/fchmodat.2 +++ b/man2/fchmodat.2 @@ -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 /* Definition of AT_* constants */ .B #include .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 () diff --git a/man2/fchownat.2 b/man2/fchownat.2 index f56c13ad8..14ba64612 100644 --- a/man2/fchownat.2 +++ b/man2/fchownat.2 @@ -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 /* Definition of AT_* constants */ .B #include .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 () diff --git a/man2/fstatat.2 b/man2/fstatat.2 index 0b5743fbc..c88c986b1 100644 --- a/man2/fstatat.2 +++ b/man2/fstatat.2 @@ -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 /* Definition of AT_* constants */ .B #include .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 () diff --git a/man2/futimesat.2 b/man2/futimesat.2 index fb804c37d..5601b2504 100644 --- a/man2/futimesat.2 +++ b/man2/futimesat.2 @@ -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 /* 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 diff --git a/man2/linkat.2 b/man2/linkat.2 index 9209da484..32ee790bc 100644 --- a/man2/linkat.2 +++ b/man2/linkat.2 @@ -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 /* Definition of AT_* constants */ .B #include .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 () diff --git a/man2/mkdirat.2 b/man2/mkdirat.2 index ccccb16f1..82dfe5cf5 100644 --- a/man2/mkdirat.2 +++ b/man2/mkdirat.2 @@ -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 /* Definition of AT_* constants */ .B #include .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 () diff --git a/man2/mknodat.2 b/man2/mknodat.2 index 246bb8c04..d37da29d4 100644 --- a/man2/mknodat.2 +++ b/man2/mknodat.2 @@ -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 /* Definition of AT_* constants */ .B #include .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 () diff --git a/man2/openat.2 b/man2/openat.2 index 2bf7e7ca4..8ba7ffeee 100644 --- a/man2/openat.2 +++ b/man2/openat.2 @@ -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 .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 () diff --git a/man2/readlinkat.2 b/man2/readlinkat.2 index 71aa2ad02..d159c16b8 100644 --- a/man2/readlinkat.2 +++ b/man2/readlinkat.2 @@ -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 /* Definition of AT_* constants */ .B #include .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 () diff --git a/man2/renameat.2 b/man2/renameat.2 index f461d3a3d..5468890ee 100644 --- a/man2/renameat.2 +++ b/man2/renameat.2 @@ -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 /* Definition of AT_* constants */ .B #include .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 () diff --git a/man2/symlinkat.2 b/man2/symlinkat.2 index e3c5851ee..a39df0bcf 100644 --- a/man2/symlinkat.2 +++ b/man2/symlinkat.2 @@ -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 /* Definition of AT_* constants */ .B #include .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 () diff --git a/man2/unlinkat.2 b/man2/unlinkat.2 index 8b144017a..86bbe04ed 100644 --- a/man2/unlinkat.2 +++ b/man2/unlinkat.2 @@ -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 .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 () diff --git a/man2/utimensat.2 b/man2/utimensat.2 index a87e66efd..7d5c0084c 100644 --- a/man2/utimensat.2 +++ b/man2/utimensat.2 @@ -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 diff --git a/man3/mkfifoat.3 b/man3/mkfifoat.3 index eae5a3f7d..8e4dd26b5 100644 --- a/man3/mkfifoat.3 +++ b/man3/mkfifoat.3 @@ -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 /* Definition of AT_* constants */ .B #include .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 ()