copy_file_range.2, fanotify_mark.2, inotify_add_watch.2, ioctl_fideduperange.2, kcmp.2, prctl.2, get_robust_list.2, tkill.2, ttyname.3: ERRORS: correct alphabetical order

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
author: Michael Kerrisk <mtk.manpages@gmail.com> 2019-09-27 13:28:50 +0200
committer: Michael Kerrisk <mtk.manpages@gmail.com> 2019-09-27 14:18:08 +0200
commit: 49a2a1052b8a8d8caec29b81c698b3af29d9ccf3 (patch)
tree: 9251336aefe0c099152a8b0e7a705e682240f781
parent: 88e75e2c56a68eaf8fcf662a63b802fdf77a4017 (diff)
download: man-pages-49a2a1052b8a8d8caec29b81c698b3af29d9ccf3.tar.gz
9 files changed, 92 insertions, 93 deletions
diff --git a/man2/copy_file_range.2 b/man2/copy_file_range.2
index 05429b3c91..a005a1a4c0 100644
--- a/man2/copy_file_range.2
+++ b/man2/copy_file_range.2
@@ -153,6 +153,9 @@ or
 .I fd_out
 is not a regular file.
 .TP
+.B EIO
+A low-level I/O error occurred while copying.
+.TP
 .B EISDIR
 Either
 .I fd_in
@@ -160,23 +163,19 @@ or
 .I fd_out
 refers to a directory.
 .TP
-.B EOVERFLOW
-The requested source or destination range is too large to represent in the
-specified data types.
-.TP
-.B EIO
-A low-level I/O error occurred while copying.
-.TP
 .B ENOMEM
 Out of memory.
 .TP
 .B ENOSPC
 There is not enough space on the target filesystem to complete the copy.
 .TP
-.B EXDEV
-The files referred to by
-.IR file_in " and " file_out
-are not on the same mounted filesystem (pre Linux 5.3).
+.B EOVERFLOW
+The requested source or destination range is too large to represent in the
+specified data types.
+.TP
+.B EPERM
+.I fd_out
+refers to an immutable file.
 .TP
 .B TXTBSY
 Either
@@ -185,10 +184,10 @@ or
 .I fd_out
 refers to an active swap file.
 .TP
-.B EPERM
-.I fd_out
-refers to an immutable file.
-.TP
+.B EXDEV
+The files referred to by
+.IR file_in " and " file_out
+are not on the same mounted filesystem (pre Linux 5.3).
 .SH VERSIONS
 The
 .BR copy_file_range ()
diff --git a/man2/fanotify_mark.2 b/man2/fanotify_mark.2
index 7c21cc22b6..ef705ce993 100644
--- a/man2/fanotify_mark.2
+++ b/man2/fanotify_mark.2
@@ -373,6 +373,19 @@ and mask contains a flag for permission events
 or
 .BR FAN_ACCESS_PERM ).
 .TP
+.B ENODEV
+The filesystem object indicated by
+.I pathname
+is not associated with a filesystem that supports
+.I fsid
+(e.g.,
+.BR tmpfs (5)).
+This error can be returned only when an fanotify file descriptor returned
+by
+.BR fanotify_init (2)
+has been created with
+.BR FAN_REPORT_FID .
+.TP
 .B ENOENT
 The filesystem object indicated by
 .IR dirfd
@@ -407,38 +420,25 @@ and
 .I pathname
 do not specify a directory.
 .TP
-.B EXDEV
-The filesystem object indicated by
+.B EOPNOTSUPP
+The object indicated by
 .I pathname
-resides within a filesystem subvolume (e.g.,
-.BR btrfs (5))
-which uses a different
-.I fsid
-than its root superblock.
+is associated with a filesystem that does not support the encoding of file
+handles.
 This error can be returned only when an fanotify file descriptor returned
 by
 .BR fanotify_init (2)
 has been created with
 .BR FAN_REPORT_FID .
 .TP
-.B ENODEV
+.B EXDEV
 The filesystem object indicated by
 .I pathname
-is not associated with a filesystem that supports
+resides within a filesystem subvolume (e.g.,
+.BR btrfs (5))
+which uses a different
 .I fsid
-(e.g.,
-.BR tmpfs (5)).
-This error can be returned only when an fanotify file descriptor returned
-by
-.BR fanotify_init (2)
-has been created with
-.BR FAN_REPORT_FID .
-.TP
-.B EOPNOTSUPP
-The object indicated by
-.I pathname
-is associated with a filesystem that does not support the encoding of file
-handles.
+than its root superblock.
 This error can be returned only when an fanotify file descriptor returned
 by
 .BR fanotify_init (2)
diff --git a/man2/get_robust_list.2 b/man2/get_robust_list.2
index a553f10c80..fa0c147c66 100644
--- a/man2/get_robust_list.2
+++ b/man2/get_robust_list.2
@@ -119,6 +119,10 @@ The
 .BR get_robust_list ()
 system call can fail with the following errors:
 .TP
+.B EFAULT
+The head of the robust futex list can't be stored at the location
+.IR head .
+.TP
 .B EPERM
 The calling process does not have permission to see the robust futex list of
 the thread with the thread ID
@@ -131,10 +135,6 @@ capability.
 No thread with the thread ID
 .I pid
 could be found.
-.TP
-.B EFAULT
-The head of the robust futex list can't be stored at the location
-.IR head .
 .SH VERSIONS
 These system calls were added in Linux 2.6.17.
 .SH NOTES
diff --git a/man2/inotify_add_watch.2 b/man2/inotify_add_watch.2
index 034d5d6b92..0ded8c66e3 100644
--- a/man2/inotify_add_watch.2
+++ b/man2/inotify_add_watch.2
@@ -89,6 +89,15 @@ Read access to the given file is not permitted.
 .B EBADF
 The given file descriptor is not valid.
 .TP
+.B EEXIST
+.I mask
+contains
+.B IN_MASK_CREATE
+and
+.I pathname
+refers to a file already being watched by the same
+.IR fd .
+.TP
 .B EFAULT
 .I pathname
 points outside of the process's accessible address space.
@@ -127,15 +136,6 @@ contains
 and
 .I pathname
 is not a directory.
-.TP
-.B EEXIST
-.I mask
-contains
-.B IN_MASK_CREATE
-and
-.I pathname
-refers to a file already being watched by the same
-.IR fd .
 .SH VERSIONS
 Inotify was merged into the 2.6.13 Linux kernel.
 .SH CONFORMING TO
diff --git a/man2/ioctl_fideduperange.2 b/man2/ioctl_fideduperange.2
index 84d20a276e..4f28b9fcf8 100644
--- a/man2/ioctl_fideduperange.2
+++ b/man2/ioctl_fideduperange.2
@@ -151,13 +151,6 @@ is set to indicate the error.
 .SH ERRORS
 Error codes can be one of, but are not limited to, the following:
 .TP
-.B ENOMEM
-The kernel was unable to allocate sufficient memory to perform the
-operation or
-.IR dest_count
-is so large that the input argument description spans more than a single
-page of memory.
-.TP
 .B EBADF
 .IR src_fd
 is not open for reading;
@@ -180,6 +173,13 @@ overlapping deduplication ranges in the same file.
 One of the files is a directory and the filesystem does not support shared
 regions in directories.
 .TP
+.B ENOMEM
+The kernel was unable to allocate sufficient memory to perform the
+operation or
+.IR dest_count
+is so large that the input argument description spans more than a single
+page of memory.
+.TP
 .B EOPNOTSUPP
 This can appear if the filesystem does not support deduplicating either file
 descriptor, or if either file descriptor refers to special inodes.
diff --git a/man2/kcmp.2 b/man2/kcmp.2
index 2e6c8eeb12..26eb0470fe 100644
--- a/man2/kcmp.2
+++ b/man2/kcmp.2
@@ -260,10 +260,20 @@ or
 .I fd2
 is not an open file descriptor.
 .TP
+.B EFAULT
+The epoll slot addressed by
+.I idx2
+is outside of the user's address space.
+.TP
 .B EINVAL
 .I type
 is invalid.
 .TP
+.B ENOENT
+The target file is not present in
+.BR epoll (7)
+instance.
+.TP
 .B EPERM
 Insufficient permission to inspect process resources.
 The
@@ -285,16 +295,6 @@ Process
 or
 .I pid2
 does not exist.
-.TP
-.B EFAULT
-The epoll slot addressed by
-.I idx2
-is outside of the user's address space.
-.TP
-.B ENOENT
-The target file is not present in
-.BR epoll (7)
-instance.
 .SH VERSIONS
 The
 .BR kcmp ()
diff --git a/man2/prctl.2 b/man2/prctl.2
index d7f908f50f..a3e125f75a 100644
--- a/man2/prctl.2
+++ b/man2/prctl.2
@@ -1659,6 +1659,16 @@ and
 .IR arg3
 does not specify a valid capability.
 .TP
+.B EINVAL
+.I option
+was
+.BR PR_GET_SPECULATION_CTRL
+or
+.BR PR_SET_SPECULATION_CTRL
+and unused arguments to
+.BR prctl ()
+are not 0.
+.TP
 .B ENODEV
 .I option
 was
@@ -1763,16 +1773,6 @@ is neither
 .BR PR_SPEC_DISABLE ,
 nor
 .BR PR_SPEC_FORCE_DISABLE .
-.TP
-.B EINVAL
-.I option
-was
-.BR PR_GET_SPECULATION_CTRL
-or
-.BR PR_SET_SPECULATION_CTRL
-and unused arguments to
-.BR prctl ()
-are not 0.
 .SH VERSIONS
 The
 .BR prctl ()
diff --git a/man2/tkill.2 b/man2/tkill.2
index 9205483519..c7674f917d 100644
--- a/man2/tkill.2
+++ b/man2/tkill.2
@@ -95,17 +95,6 @@ On error, \-1 is returned, and \fIerrno\fP
 is set appropriately.
 .SH ERRORS
 .TP
-.B EINVAL
-An invalid thread ID, thread group ID, or signal was specified.
-.TP
-.B EPERM
-Permission denied.
-For the required permissions, see
-.BR kill (2).
-.TP
-.B ESRCH
-No process with the specified thread ID (and thread group ID) exists.
-.TP
 .B EAGAIN
 The
 .B RLIMIT_SIGPENDING
@@ -117,6 +106,17 @@ is a real-time signal.
 Insufficient kernel memory was available and
 .I sig
 is a real-time signal.
+.TP
+.B EINVAL
+An invalid thread ID, thread group ID, or signal was specified.
+.TP
+.B EPERM
+Permission denied.
+For the required permissions, see
+.BR kill (2).
+.TP
+.B ESRCH
+No process with the specified thread ID (and thread group ID) exists.
 .SH VERSIONS
 .BR tkill ()
 is supported since Linux 2.4.19 / 2.5.4.
diff --git a/man3/ttyname.3 b/man3/ttyname.3
index 6641894594..0e5e27e52a 100644
--- a/man3/ttyname.3
+++ b/man3/ttyname.3
@@ -64,6 +64,11 @@ returns 0 on success, and an error number upon error.
 .B EBADF
 Bad file descriptor.
 .TP
+.\" glibc commit 15e9a4f378c8607c2ae1aa465436af4321db0e23
+.B ENODEV
+File descriptor refers to a slave pseudoterminal device
+but the corresponding pathname could not be found (see NOTES).
+.TP
 .B ENOTTY
 File descriptor does not refer to a terminal device.
 .TP
@@ -71,11 +76,6 @@ File descriptor does not refer to a terminal device.
 .RB ( ttyname_r ())
 .I buflen
 was too small to allow storing the pathname.
-.TP
-.\" glibc commit 15e9a4f378c8607c2ae1aa465436af4321db0e23
-.B ENODEV
-File descriptor refers to a slave pseudoterminal device
-but the corresponding pathname could not be found (see NOTES).
 .SH ATTRIBUTES
 For an explanation of the terms used in this section, see
 .BR attributes (7).
author	Michael Kerrisk <mtk.manpages@gmail.com>	2019-09-27 13:28:50 +0200
committer	Michael Kerrisk <mtk.manpages@gmail.com>	2019-09-27 14:18:08 +0200
commit	49a2a1052b8a8d8caec29b81c698b3af29d9ccf3 (patch)
tree	9251336aefe0c099152a8b0e7a705e682240f781
parent	88e75e2c56a68eaf8fcf662a63b802fdf77a4017 (diff)
download	man-pages-49a2a1052b8a8d8caec29b81c698b3af29d9ccf3.tar.gz