diff options
| author | Michael Kerrisk <mtk.manpages@gmail.com> | 2021-08-18 03:02:55 +0200 |
|---|---|---|
| committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2021-08-18 03:47:26 +0200 |
| commit | 90879cbd20f563af6bcc0ee9035cd59f591c29c7 (patch) | |
| tree | 3a7e477c5362c6cc857c35673fa99a5185b898af /man3 | |
| parent | 97e2d8e602d44b1271f18cd3297a5e40bed3584c (diff) | |
| download | man-pages-90879cbd20f563af6bcc0ee9035cd59f591c29c7.tar.gz | |
chmod.2, chown.2, open.2, mkdir.2, mknod.2, readlink.2, stat.2, symlink.2, mkfifo.3, scandir.3, sem_wait.3: ERRORS: combine errors into a single alphabetic list
These pages split out extra errors for some APIs into a separate
list. Probably, the pages are easier to ready if all errors are
combined into a single list.
Note that there still remain a few pages where the errors are
listed separately for different APIs. For the moment, it seems
best to leave those pages as is, since the error lists are
largely distinct in those pages.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Diffstat (limited to 'man3')
| -rw-r--r-- | man3/mkfifo.3 | 27 | ||||
| -rw-r--r-- | man3/scandir.3 | 21 | ||||
| -rw-r--r-- | man3/sem_wait.3 | 17 |
3 files changed, 30 insertions, 35 deletions
diff --git a/man3/mkfifo.3 b/man3/mkfifo.3 index 3aba5498cc..a0c5789394 100644 --- a/man3/mkfifo.3 +++ b/man3/mkfifo.3 @@ -131,6 +131,15 @@ is set to indicate the error. One of the directories in \fIpathname\fP did not allow search (execute) permission. .TP +.B EBADF +.RB ( mkfifoat ()) +.I pathname +is relative but +.I dirfd +is neither +.B AT_FDCWD +nor a valid file descriptor. +.TP .B EDQUOT The user's quota of disk blocks or inodes on the filesystem has been exhausted. @@ -160,25 +169,15 @@ The directory or filesystem has no room for the new file. A component used as a directory in \fIpathname\fP is not, in fact, a directory. .TP -.B EROFS -\fIpathname\fP refers to a read-only filesystem. -.PP -The following additional errors can occur for -.BR mkfifoat (): -.TP -.B EBADF -.I pathname -is relative but -.I dirfd -is neither -.B AT_FDCWD -nor a valid file descriptor. -.TP .B ENOTDIR +.RB ( mkfifoat ()) .I pathname is a relative pathname and .I dirfd is a file descriptor referring to a file other than a directory. +.TP +.B EROFS +\fIpathname\fP refers to a read-only filesystem. .SH VERSIONS .BR mkfifoat () was added to glibc in version 2.4. diff --git a/man3/scandir.3 b/man3/scandir.3 index f3a34db530..f010720670 100644 --- a/man3/scandir.3 +++ b/man3/scandir.3 @@ -191,6 +191,15 @@ or greater than zero if the first argument is considered to be respectively less than, equal to, or greater than the second. .SH ERRORS .TP +.B EBADF +.RB ( scandirat ()) +.I dirp +is relative but +.I dirfd +is neither +.B AT_FDCWD +nor a valid file descriptor. +.TP .B ENOENT The path in \fIdirp\fR does not exist. .TP @@ -199,19 +208,9 @@ Insufficient memory to complete the operation. .TP .B ENOTDIR The path in \fIdirp\fR is not a directory. -.PP -The following additional errors can occur for -.BR scandirat (): -.TP -.B EBADF -.I dirp -is relative but -.I dirfd -is neither -.B AT_FDCWD -nor a valid file descriptor. .TP .B ENOTDIR +.RB ( scandirat ()) .I dirp is a relative pathname and .I dirfd diff --git a/man3/sem_wait.3 b/man3/sem_wait.3 index bb86d984b8..40cedb2a37 100644 --- a/man3/sem_wait.3 +++ b/man3/sem_wait.3 @@ -113,6 +113,11 @@ on error, the value of the semaphore is left unchanged, is set to indicate the error. .SH ERRORS .TP +.B EAGAIN +.RB ( sem_trywait ()) +The operation could not be performed without blocking (i.e., the +semaphore currently has the value zero). +.TP .B EINTR The call was interrupted by a signal handler; see .BR signal (7). @@ -120,23 +125,15 @@ The call was interrupted by a signal handler; see .B EINVAL .I sem is not a valid semaphore. -.PP -The following additional error can occur for -.BR sem_trywait (): -.TP -.B EAGAIN -The operation could not be performed without blocking (i.e., the -semaphore currently has the value zero). -.PP -The following additional errors can occur for -.BR sem_timedwait (): .TP .B EINVAL +.RB ( sem_timedwait ()) The value of .I abs_timeout.tv_nsecs is less than 0, or greater than or equal to 1000 million. .TP .B ETIMEDOUT +.RB ( sem_timedwait ()) The call timed out before the semaphore could be locked. .\" POSIX.1-2001 also allows EDEADLK -- "A deadlock condition .\" was detected", but this does not occur on Linux(?). |