This patch documents the values of error numbers on linux. This is something that is in the OpenBSD errno man page, which I find quite useful. Signed-off-by: Wesley Aptekar-Cassels <W.Aptekar@xxxxxxxxx> --- man3/errno.3 | 243 ++++++++++++++++++++++++++++++----------------------------- 1 file changed, 122 insertions(+), 121 deletions(-) diff --git a/man3/errno.3 b/man3/errno.3 index ff38ab256..0d6fe474e 100644 --- a/man3/errno.3 +++ b/man3/errno.3 @@ -92,222 +92,223 @@ which may be the same. .\" Amendment 1 defines the additional error number \fBEILSEQ\fP for .\" coding errors in multibyte or wide characters. .\" -Below is a list of the symbolic error names that are defined on Linux. +Below is a list of the symbolic error names that are defined on Linux, along +with their values. Some of these are marked .IR POSIX.1 , indicating that the name is defined by POSIX.1-2001, or .\" FIXME This list should be updated for POSIX.1-2008 .IR C99 , indicating that the name is defined by C99. -.TP 16 -.B E2BIG +.TP 21 +.B E2BIG (7) Argument list too long (POSIX.1). .TP -.B EACCES +.B EACCES (13) Permission denied (POSIX.1). .TP -.B EADDRINUSE +.B EADDRINUSE (98) Address already in use (POSIX.1). .TP -.B EADDRNOTAVAIL +.B EADDRNOTAVAIL (99) Address not available (POSIX.1). .\" EADV is only an error on HURD(?) .TP -.B EAFNOSUPPORT +.B EAFNOSUPPORT (97) Address family not supported (POSIX.1). .TP -.B EAGAIN +.B EAGAIN (11) Resource temporarily unavailable (may be the same value as .BR EWOULDBLOCK ) (POSIX.1). .TP -.B EALREADY +.B EALREADY (114) Connection already in progress (POSIX.1). .TP -.B EBADE +.B EBADE (52) Invalid exchange. .TP -.B EBADF +.B EBADF (9) Bad file descriptor (POSIX.1). .TP -.B EBADFD +.B EBADFD (77) File descriptor in bad state. .TP -.B EBADMSG +.B EBADMSG (74) Bad message (POSIX.1). .TP -.B EBADR +.B EBADR (53) Invalid request descriptor. .TP -.B EBADRQC +.B EBADRQC (56) Invalid request code. .TP -.B EBADSLT +.B EBADSLT (57) Invalid slot. .\" EBFONT is defined but appears not to be used by kernel or glibc. .TP -.B EBUSY +.B EBUSY (16) Device or resource busy (POSIX.1). .TP -.B ECANCELED +.B ECANCELED (125) Operation canceled (POSIX.1). .TP -.B ECHILD +.B ECHILD (10) No child processes (POSIX.1). .TP -.B ECHRNG +.B ECHRNG (44) Channel number out of range. .TP -.B ECOMM +.B ECOMM (70) Communication error on send. .TP -.B ECONNABORTED +.B ECONNABORTED (103) Connection aborted (POSIX.1). .TP -.B ECONNREFUSED +.B ECONNREFUSED (111) Connection refused (POSIX.1). .TP -.B ECONNRESET +.B ECONNRESET (104) Connection reset (POSIX.1). .TP -.B EDEADLK +.B EDEADLK (35) Resource deadlock avoided (POSIX.1). .TP .B EDEADLOCK Synonym for .BR EDEADLK . .TP -.B EDESTADDRREQ +.B EDESTADDRREQ (89) Destination address required (POSIX.1). .TP -.B EDOM +.B EDOM (33) Mathematics argument out of domain of function (POSIX.1, C99). .\" EDOTDOT is defined but appears to be unused .TP -.B EDQUOT +.B EDQUOT (122) .\" POSIX just says "Reserved" Disk quota exceeded (POSIX.1). .TP -.B EEXIST +.B EEXIST (17) File exists (POSIX.1). .TP -.B EFAULT +.B EFAULT (14) Bad address (POSIX.1). .TP -.B EFBIG +.B EFBIG (27) File too large (POSIX.1). .TP -.B EHOSTDOWN +.B EHOSTDOWN (112) Host is down. .TP -.B EHOSTUNREACH +.B EHOSTUNREACH (113) Host is unreachable (POSIX.1). .TP -.B EIDRM +.B EIDRM (43) Identifier removed (POSIX.1). .TP -.B EILSEQ +.B EILSEQ (84) Invalid or incomplete multibyte or wide character (POSIX.1, C99). .IP The text shown here is the glibc error description; in POSIX.1, this error is described as "Illegal byte sequence". .TP -.B EINPROGRESS +.B EINPROGRESS (115) Operation in progress (POSIX.1). .TP -.B EINTR +.B EINTR (4) Interrupted function call (POSIX.1); see .BR signal (7). .TP -.B EINVAL +.B EINVAL (22) Invalid argument (POSIX.1). .TP -.B EIO +.B EIO (5) Input/output error (POSIX.1). .TP -.B EISCONN +.B EISCONN (106) Socket is connected (POSIX.1). .TP -.B EISDIR +.B EISDIR (21) Is a directory (POSIX.1). .TP -.B EISNAM +.B EISNAM (120) Is a named type file. .TP -.B EKEYEXPIRED +.B EKEYEXPIRED (127) Key has expired. .TP -.B EKEYREJECTED +.B EKEYREJECTED (129) Key was rejected by service. .TP -.B EKEYREVOKED +.B EKEYREVOKED (128) Key has been revoked. .TP -.B EL2HLT +.B EL2HLT (51) Level 2 halted. .TP -.B EL2NSYNC +.B EL2NSYNC (45) Level 2 not synchronized. .TP -.B EL3HLT +.B EL3HLT (46) Level 3 halted. .TP -.B EL3RST +.B EL3RST (47) Level 3 reset. .TP -.B ELIBACC +.B ELIBACC (79) Cannot access a needed shared library. .TP -.B ELIBBAD +.B ELIBBAD (80) Accessing a corrupted shared library. .TP -.B ELIBMAX +.B ELIBMAX (82) Attempting to link in too many shared libraries. .TP -.B ELIBSCN +.B ELIBSCN (81) \&.lib section in a.out corrupted .TP -.B ELIBEXEC +.B ELIBEXEC (83) Cannot exec a shared library directly. .TP -.B ELOOP +.B ELOOP (40) Too many levels of symbolic links (POSIX.1). .\" ELNRNG is defined but appears to be unused .TP -.B EMEDIUMTYPE +.B EMEDIUMTYPE (124) Wrong medium type. .TP -.B EMFILE +.B EMFILE (24) Too many open files (POSIX.1). Commonly caused by exceeding the .BR RLIMIT_NOFILE resource limit described in .BR getrlimit (2). .TP -.B EMLINK +.B EMLINK (31) Too many links (POSIX.1). .TP -.B EMSGSIZE +.B EMSGSIZE (90) Message too long (POSIX.1). .TP -.B EMULTIHOP +.B EMULTIHOP (72) .\" POSIX says "Reserved" Multihop attempted (POSIX.1). .TP -.B ENAMETOOLONG +.B ENAMETOOLONG (36) Filename too long (POSIX.1). .\" ENAVAIL is defined, but appears not to be used .TP -.B ENETDOWN +.B ENETDOWN (100) Network is down (POSIX.1). .TP -.B ENETRESET +.B ENETRESET (102) Connection aborted by network (POSIX.1). .TP -.B ENETUNREACH +.B ENETUNREACH (101) Network unreachable (POSIX.1). .TP -.B ENFILE +.B ENFILE (23) Too many open files in system (POSIX.1). On Linux, this is probably a result of encountering the .IR /proc/sys/fs/file-max @@ -315,95 +316,95 @@ limit (see .BR proc (5)). .\" ENOANO is defined but appears to be unused. .TP -.B ENOBUFS +.B ENOBUFS (105) No buffer space available (POSIX.1 (XSI STREAMS option)). .\" ENOCSI is defined but appears to be unused. .TP -.B ENODATA +.B ENODATA (61) No message is available on the STREAM head read queue (POSIX.1). .TP -.B ENODEV +.B ENODEV (19) No such device (POSIX.1). .TP -.B ENOENT +.B ENOENT (2) No such file or directory (POSIX.1). .IP Typically, this error results when a specified pathname does not exist, or one of the components in the directory prefix of a pathname does not exist, or the specified pathname is a dangling symbolic link. .TP -.B ENOEXEC +.B ENOEXEC (8) Exec format error (POSIX.1). .TP -.B ENOKEY +.B ENOKEY (126) Required key not available. .TP -.B ENOLCK +.B ENOLCK (37) No locks available (POSIX.1). .TP -.B ENOLINK +.B ENOLINK (67) .\" POSIX says "Reserved" Link has been severed (POSIX.1). .TP -.B ENOMEDIUM +.B ENOMEDIUM (123) No medium found. .TP -.B ENOMEM +.B ENOMEM (12) Not enough space (POSIX.1). .TP -.B ENOMSG +.B ENOMSG (42) No message of the desired type (POSIX.1). .TP -.B ENONET +.B ENONET (64) Machine is not on the network. .TP -.B ENOPKG +.B ENOPKG (65) Package not installed. .TP -.B ENOPROTOOPT +.B ENOPROTOOPT (92) Protocol not available (POSIX.1). .TP -.B ENOSPC +.B ENOSPC (28) No space left on device (POSIX.1). .TP -.B ENOSR +.B ENOSR (63) No STREAM resources (POSIX.1 (XSI STREAMS option)). .TP -.B ENOSTR +.B ENOSTR (60) Not a STREAM (POSIX.1 (XSI STREAMS option)). .TP -.B ENOSYS +.B ENOSYS (38) Function not implemented (POSIX.1). .TP -.B ENOTBLK +.B ENOTBLK (15) Block device required. .TP -.B ENOTCONN +.B ENOTCONN (107) The socket is not connected (POSIX.1). .TP -.B ENOTDIR +.B ENOTDIR (20) Not a directory (POSIX.1). .TP -.B ENOTEMPTY +.B ENOTEMPTY (39) Directory not empty (POSIX.1). .\" ENOTNAM is defined but appears to be unused. .TP -.B ENOTSOCK +.B ENOTSOCK (88) Not a socket (POSIX.1). .TP -.B ENOTSUP +.B ENOTSUP (95) Operation not supported (POSIX.1). .TP -.B ENOTTY +.B ENOTTY (25) Inappropriate I/O control operation (POSIX.1). .TP -.B ENOTUNIQ +.B ENOTUNIQ (76) Name not unique on network. .TP -.B ENXIO +.B ENXIO (6) No such device or address (POSIX.1). .TP -.B EOPNOTSUPP +.B EOPNOTSUPP (95) Operation not supported on socket (POSIX.1). .IP .RB ( ENOTSUP @@ -412,67 +413,67 @@ and have the same value on Linux, but according to POSIX.1 these error values should be distinct.) .TP -.B EOVERFLOW +.B EOVERFLOW (75) Value too large to be stored in data type (POSIX.1). .TP -.B EPERM +.B EPERM (1) Operation not permitted (POSIX.1). .TP -.B EPFNOSUPPORT +.B EPFNOSUPPORT (96) Protocol family not supported. .TP -.B EPIPE +.B EPIPE (32) Broken pipe (POSIX.1). .TP -.B EPROTO +.B EPROTO (71) Protocol error (POSIX.1). .TP -.B EPROTONOSUPPORT +.B EPROTONOSUPPORT (93) Protocol not supported (POSIX.1). .TP -.B EPROTOTYPE +.B EPROTOTYPE (91) Protocol wrong type for socket (POSIX.1). .TP -.B ERANGE +.B ERANGE (34) Result too large (POSIX.1, C99). .TP -.B EREMCHG +.B EREMCHG (78) Remote address changed. .TP -.B EREMOTE +.B EREMOTE (66) Object is remote. .TP -.B EREMOTEIO +.B EREMOTEIO (121) Remote I/O error. .TP -.B ERESTART +.B ERESTART (85) Interrupted system call should be restarted. .TP -.B EROFS +.B EROFS (30) Read-only filesystem (POSIX.1). .TP -.B ESHUTDOWN +.B ESHUTDOWN (108) Cannot send after transport endpoint shutdown. .TP -.B ESPIPE +.B ESPIPE (29) Invalid seek (POSIX.1). .TP -.B ESOCKTNOSUPPORT +.B ESOCKTNOSUPPORT (94) Socket type not supported. .TP -.B ESRCH +.B ESRCH (3) No such process (POSIX.1). .\" ESRMNT is defined but appears not to be used .TP -.B ESTALE +.B ESTALE (116) Stale file handle (POSIX.1). .IP This error can occur for NFS and for other filesystems. .TP -.B ESTRPIPE +.B ESTRPIPE (86) Streams pipe error. .TP -.B ETIME +.B ETIME (62) Timer expired. (POSIX.1 (XSI STREAMS option)) .IP @@ -480,31 +481,31 @@ Timer expired. .BR ioctl (2) timeout") .TP -.B ETIMEDOUT +.B ETIMEDOUT (110) Connection timed out (POSIX.1). .\" ETOOMANYREFS is defined, but appears not to be used. .TP -.B ETXTBSY +.B ETXTBSY (26) Text file busy (POSIX.1). .TP -.B EUCLEAN +.B EUCLEAN (117) Structure needs cleaning. .TP -.B EUNATCH +.B EUNATCH (49) Protocol driver not attached. .TP -.B EUSERS +.B EUSERS (87) Too many users. .TP -.B EWOULDBLOCK +.B EWOULDBLOCK (11) Operation would block (may be same value as .BR EAGAIN ) (POSIX.1). .TP -.B EXDEV +.B EXDEV (18) Improper link (POSIX.1). .TP -.B EXFULL +.B EXFULL (54) Exchange full. .SH NOTES A common mistake is to do -- 2.14.1 -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
