access.2, chmod.2, chown.2, execveat.2, futimesat.2, link.2, mkdir.2, mknod.2, mount_...

Make the description of the EBADF error for invalid 'dirfd' more
uniform. In particular, note that the error only occurs when the
pathname is relative, and that it occurs when the 'dirfd' is
neither valid *nor* has the value AT_FDCWD.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man2/access.2 b/man2/access.2
index 3957a2ab8800fd8dc174a982440eac3a3120a6a9..0fb2a79f7f74cf9a8af896b4c7253ebf5e7eba8a 100644 (file)
--- a/man2/access.2
+++ b/man2/access.2
@@ -278,8 +278,12 @@ The following additional errors can occur for
 .BR faccessat ():
 .TP
 .B EBADF
+.I pathname
+is relative but
 .I dirfd
-is not a valid file descriptor.
+is neither
+.B AT_FDCWD
+nor a valid file descriptor.
 .TP
 .B EINVAL
 Invalid flag specified in

diff --git a/man2/chmod.2 b/man2/chmod.2
index 017aab9d63d7a84e1e39ac915ec952c2af62bd4a..6862a7e3d2b738b40760975b455fa4f56d28f8e2 100644 (file)
--- a/man2/chmod.2
+++ b/man2/chmod.2
@@ -309,8 +309,12 @@ The following additional errors can occur for
 .BR fchmodat ():
 .TP
 .B EBADF
+.I pathname
+is relative but
 .I dirfd
-is not a valid file descriptor.
+is neither
+.B AT_FDCWD
+nor a valid file descriptor.
 .TP
 .B EINVAL
 Invalid flag specified in

diff --git a/man2/chown.2 b/man2/chown.2
index e35587b28ae860c7edfdcf11a3f954f451b5c983..354193c2837bebe929c6f45b861023a86a9e705e 100644 (file)
--- a/man2/chown.2
+++ b/man2/chown.2
@@ -293,8 +293,12 @@ The following additional errors can occur for
 .BR fchownat ():
 .TP
 .B EBADF
+.I pathname
+is relative but
 .I dirfd
-is not a valid file descriptor.
+is neither
+.B AT_FDCWD
+nor a valid file descriptor.
 .TP
 .B EINVAL
 Invalid flag specified in

diff --git a/man2/execveat.2 b/man2/execveat.2
index 495617b09052af6afe326be3138685f12e1d8614..ad952631c6fbd5335db4f47e07f3f7a43f801482 100644 (file)
--- a/man2/execveat.2
+++ b/man2/execveat.2
@@ -121,9 +121,12 @@ can also occur for
 The following additional errors can occur for
 .BR execveat ():
 .TP
-.B EBADF
+.I pathname
+is relative but
 .I dirfd
-is not a valid file descriptor.
+is neither
+.B AT_FDCWD
+nor a valid file descriptor.
 .TP
 .B EINVAL
 Invalid flag specified in

diff --git a/man2/futimesat.2 b/man2/futimesat.2
index 86e941fe59675247652cbbfb04c3029eef6d5f3b..c82e4014c933a5123ebab47bf45e54e8e7ecf67d 100644 (file)
--- a/man2/futimesat.2
+++ b/man2/futimesat.2
@@ -99,8 +99,12 @@ The following additional errors can occur for
 .BR futimesat ():
 .TP
 .B EBADF
+.I pathname
+is relative but
 .I dirfd
-is not a valid file descriptor.
+is neither
+.B AT_FDCWD
+nor a valid file descriptor.
 .TP
 .B ENOTDIR
 .I pathname

diff --git a/man2/link.2 b/man2/link.2
index c285ae8962974a42b6ba997c1d8a9deae3ae2382..2c905765395a02f6a4abfee93c3b93f042aac222 100644 (file)
--- a/man2/link.2
+++ b/man2/link.2
@@ -282,10 +282,14 @@ The following additional errors can occur for
 .BR linkat ():
 .TP
 .B EBADF
+.I oldpath
+.RI ( newpath )
+is relative but
 .I olddirfd
-or
-.I newdirfd
-is not a valid file descriptor.
+.RI ( newdirfd )
+is neither
+.B AT_FDCWD
+nor a valid file descriptor.
 .TP
 .B EINVAL
 An invalid flag value was specified in

diff --git a/man2/mkdir.2 b/man2/mkdir.2
index e4d7d9472f30302a092b797d98110532535bbc0d..355ba086e7df5e882eb011691416015df1be23a4 100644 (file)
--- a/man2/mkdir.2
+++ b/man2/mkdir.2
@@ -192,8 +192,12 @@ The following additional errors can occur for
 .BR mkdirat ():
 .TP
 .B EBADF
+.I pathname
+is relative but
 .I dirfd
-is not a valid file descriptor.
+is neither
+.B AT_FDCWD
+nor a valid file descriptor.
 .TP
 .B ENOTDIR
 .I pathname

diff --git a/man2/mknod.2 b/man2/mknod.2
index 1de3cd027a240a13a5061d7450ae0fc852c5abfd..f5bb0900afc9e5ceca0b6c7e87da079332b8e64e 100644 (file)
--- a/man2/mknod.2
+++ b/man2/mknod.2
@@ -229,8 +229,12 @@ The following additional errors can occur for
 .BR mknodat ():
 .TP
 .B EBADF
+.I pathname
+is relative but
 .I dirfd
-is not a valid file descriptor.
+is neither
+.B AT_FDCWD
+nor a valid file descriptor.
 .TP
 .B ENOTDIR
 .I pathname

diff --git a/man2/mount_setattr.2 b/man2/mount_setattr.2
index 81dc4856b94cff044e3046835ca5ee1861f7bd64..24cd36382409eb671075578d89580f15372b0131 100644 (file)
--- a/man2/mount_setattr.2
+++ b/man2/mount_setattr.2
@@ -408,8 +408,12 @@ is set to indicate the cause of the error.
 .SH ERRORS
 .TP
 .B EBADF
+.I pathname
+is relative but
 .I dirfd
-is not a valid file descriptor.
+is neither
+.B AT_FDCWD
+nor a valid file descriptor.
 .TP
 .B EBADF
 .I userns_fd

diff --git a/man2/open.2 b/man2/open.2
index bfc1b2f6b9561f5673aa5946d61c84620115a055..7c0e9cd2e968096e2002d78a8ede4e57cc45e63f 100644 (file)
--- a/man2/open.2
+++ b/man2/open.2
@@ -1290,8 +1290,12 @@ The following additional errors can occur for
 .BR openat ():
 .TP
 .B EBADF
+.I pathname
+is relative but
 .I dirfd
-is not a valid file descriptor.
+is neither
+.B AT_FDCWD
+nor a valid file descriptor.
 .TP
 .B ENOTDIR
 .I pathname

diff --git a/man2/open_by_handle_at.2 b/man2/open_by_handle_at.2
index f3fa2a4f44294a21fc43a8a7f4da234ae9ffc748..9e33f5753cd74f82925f0a5a52b02883ba4eab67 100644 (file)
--- a/man2/open_by_handle_at.2
+++ b/man2/open_by_handle_at.2
@@ -349,9 +349,11 @@ is not an open file descriptor.
 .TP
 .B EBADF
 .I pathname
-is relative and
+is relative but
 .I dirfd
-is not a valid file descriptor.
+is neither
+.B AT_FDCWD
+nor a valid file descriptor.
 .TP
 .B EFAULT
 .IR handle

diff --git a/man2/readlink.2 b/man2/readlink.2
index 7387ee4e01e14e93617f7eab175aa9ed889d7e95..6ae07c3852c4f5e88160b9e62871582fa5ab6bc0 100644 (file)
--- a/man2/readlink.2
+++ b/man2/readlink.2
@@ -200,8 +200,12 @@ The following additional errors can occur for
 .BR readlinkat ():
 .TP
 .B EBADF
+.I pathname
+is relative but
 .I dirfd
-is not a valid file descriptor.
+is neither
+.B AT_FDCWD
+nor a valid file descriptor.
 .TP
 .B ENOTDIR
 .I pathname

diff --git a/man2/rename.2 b/man2/rename.2
index dfde1ce6d3d35092015481ebb95cfddce6cb2242..a5dbd55bac1e7c71335647e1b64011325852a345 100644 (file)
--- a/man2/rename.2
+++ b/man2/rename.2
@@ -438,9 +438,11 @@ and
 .BR renameat2 ():
 .TP
 .B EBADF
+.I oldpath
+.RI ( newpath )
+is relative but
 .I olddirfd
-or
-.I newdirfd
+.RI ( newdirfd )
 is not a valid file descriptor.
 .TP
 .B ENOTDIR

diff --git a/man2/stat.2 b/man2/stat.2
index 339920d711d7d0dc850b2f8d2639c2961507c451..e5859abaff387dfd813dd6c61623be301239cc9b 100644 (file)
--- a/man2/stat.2
+++ b/man2/stat.2
@@ -434,8 +434,12 @@ The following additional errors can occur for
 .BR fstatat ():
 .TP
 .B EBADF
+.I pathname
+is relative but
 .I dirfd
-is not a valid file descriptor.
+is neither
+.B AT_FDCWD
+nor a valid file descriptor.
 .TP
 .B EINVAL
 Invalid flag specified in

diff --git a/man2/statx.2 b/man2/statx.2
index 62e86fb1b5d266c563492ca19f65e6089c4b6a9a..85b23dd59ce944b6813a913693237d93bcd7eb76 100644 (file)
--- a/man2/statx.2
+++ b/man2/statx.2
@@ -505,8 +505,12 @@ in the path prefix of
 .BR path_resolution (7).)
 .TP
 .B EBADF
+.I pathname
+is relative but
 .I dirfd
-is not a valid open file descriptor.
+is neither
+.B AT_FDCWD
+nor a valid file descriptor.
 .TP
 .B EFAULT
 .I pathname

diff --git a/man2/symlink.2 b/man2/symlink.2
index 87c25d5f483d86de187101b4b0ffc1d3bb52c38f..83d29d3e94ddfa81b073cf892bd517ec45e87902 100644 (file)
--- a/man2/symlink.2
+++ b/man2/symlink.2
@@ -203,8 +203,12 @@ The following additional errors can occur for
 .BR symlinkat ():
 .TP
 .B EBADF
+.I linkpath
+is relative but
 .I newdirfd
-is not a valid file descriptor.
+is neither
+.B AT_FDCWD
+nor a valid file descriptor.
 .TP
 .B ENOENT
 .I linkpath

diff --git a/man2/unlink.2 b/man2/unlink.2
index 6f4c187f8a9d29ddd79d505b785a1ee5a956efe8..dbb17ea7561806eafec9c52813616a91ca50e3b3 100644 (file)
--- a/man2/unlink.2
+++ b/man2/unlink.2
@@ -246,8 +246,12 @@ The following additional errors can occur for
 .BR unlinkat ():
 .TP
 .B EBADF
+.I pathname
+is relative but
 .I dirfd
-is not a valid file descriptor.
+is neither
+.B AT_FDCWD
+nor a valid file descriptor.
 .TP
 .B EINVAL
 An invalid flag value was specified in

diff --git a/man2/utimensat.2 b/man2/utimensat.2
index 006677db8873b03cf635b2bc49d6d3a741955503..4ef7be7b8a71ed4e467195b0b3e77923667e9930 100644 (file)
--- a/man2/utimensat.2
+++ b/man2/utimensat.2
@@ -269,7 +269,7 @@ is not a valid file descriptor.
 .B EBADF
 .RB ( utimensat ())
 .I pathname
-is a relative pathname, but
+is relative but
 .I dirfd
 is neither
 .BR AT_FDCWD

diff --git a/man3/mkfifo.3 b/man3/mkfifo.3
index e98c3488e2b585c2830e7aed537dc23ac5bdea20..85622b239d01cdc34684620d98c41cd8ace4e3fb 100644 (file)
--- a/man3/mkfifo.3
+++ b/man3/mkfifo.3
@@ -162,8 +162,12 @@ The following additional errors can occur for
 .BR mkfifoat ():
 .TP
 .B EBADF
+.I pathname
+is relative but
 .I dirfd
-is not a valid file descriptor.
+is neither
+.B AT_FDCWD
+nor a valid file descriptor.
 .TP
 .B ENOTDIR
 .I pathname

diff --git a/man3/scandir.3 b/man3/scandir.3
index 0ea295ce33f3ef1bb1c7b508a35005af6c2f7855..ba7ef58caef0e1e882e58e1386ad83598dd6c161 100644 (file)
--- a/man3/scandir.3
+++ b/man3/scandir.3
@@ -204,8 +204,12 @@ The following additional errors can occur for
 .BR scandirat ():
 .TP
 .B EBADF
+.I dirp
+is relative but
 .I dirfd
-is not a valid file descriptor.
+is neither
+.B AT_FDCWD
+nor a valid file descriptor.
 .TP
 .B ENOTDIR
 .I dirp