LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

Order ERRORS alphabetically.

This commit is contained in:
Michael Kerrisk 2007-08-27 07:56:52 +00:00
parent 0dd0df4e49
commit eab6469656
17 changed files with 202 additions and 204 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
Changes
View File

@ -12,6 +12,7 @@ been incorporated in changes in this release:
Aleksandr Koltsoff <czr@iki.fi>
Andi Kleen <ak@suse.de>
Anton Blanchard <anton@samba.org>
Ari Entlich <lmage11@twcny.rr.com>
Carsten Emde <Carsten.Emde@osadl.org>
Geoff Clare <gclare@gclare.org.uk>
Julien Cristau <jcristau@debian.org>

8
man2/create_module.2
View File

@ -40,15 +40,15 @@ The requested size is too small even for the module header information.
The kernel could not allocate a contiguous block of memory large
enough for the module.
.TP
.B ENOSYS
.BR create_module ()
is not supported in this version of the kernel.
.TP
.B EPERM
The caller was not privileged
(did not have the
.B CAP_SYS_MODULE
capability).
.TP
.B ENOSYS
.BR create_module ()
is not supported in this version of the kernel.
.SH VERSIONS
This system call is only present on Linux up until kernel 2.4;
it was removed in Linux 2.6.

16
man2/getpriority.2
View File

@ -133,14 +133,6 @@ In addition to the errors indicated above,
.BR setpriority ()
may fail if:
.TP
.B EPERM
A process was located, but its effective user ID did not match
either the effective or the real user ID of the caller,
and was not privileged (on Linux: did not have the
.B CAP_SYS_NICE
capability).
But see NOTES below.
.TP
.B EACCES
The caller attempted to lower a process priority, but did not
have the required privilege (on Linux: did not have the
@ -152,6 +144,14 @@ to set a process priority outside the range of the
soft resource limit of the target process; see
.BR getrlimit (2)
for details.
.TP
.B EPERM
A process was located, but its effective user ID did not match
either the effective or the real user ID of the caller,
and was not privileged (on Linux: did not have the
.B CAP_SYS_NICE
capability).
But see NOTES below.
.SH "CONFORMING TO"
SVr4, 4.4BSD (these function calls first appeared in 4.2BSD),
POSIX.1-2001.

18
man2/ioprio_set.2
View File

@ -158,6 +158,15 @@ On error, \-1 is returned, and
is set to indicate the error.
.SH ERRORS
.TP
.B EINVAL
Invalid value for
.I which
or
.IR ioprio .
Refer to the NOTES section for available scheduler
classes and priority levels for
.IR ioprio .
.TP
.B EPERM
The calling process does not have the privilege needed to assign this
.I ioprio
@ -171,15 +180,6 @@ No process(es) could be found that matched the specification in
.I which
and
.IR who .
.TP
.B EINVAL
Invalid value for
.I which
or
.IR ioprio .
Refer to the NOTES section for available scheduler
classes and priority levels for
.IR ioprio .
.SH VERSIONS
These system calls have been available on Linux since
kernel 2.6.13.

6
man2/mbind.2
View File

@ -185,13 +185,13 @@ and
.I nodemask
pointed to an empty set,
.TP
.B ENOMEM
System out of memory.
.TP
.B EIO
.B MPOL_MF_STRICT
was specified and an existing page was already on a node
that does not follow the policy.
.TP
.B ENOMEM
System out of memory.
.SH CONFORMING TO
This system call is Linux specific.
.SH NOTES

6
man2/sync_file_range.2
View File

@ -138,9 +138,6 @@ is set to indicate the error.
.I fd
is not a valid file descriptor.
.TP
.B EIO
I/O error.
.TP
.B EINVAL
.I flags
specifies an invalid bit; or
@ -149,6 +146,9 @@ or
.I nbytes
is invalid.
.TP
.B EIO
I/O error.
.TP
.B ENOMEM
Out of memory.
.TP

16
man2/unshare.2
View File

@ -127,6 +127,14 @@ On failure, \-1 is returned and
is set to indicate the error.
.SH ERRORS
.TP
.B EINVAL
An invalid bit was specified in
.IR flags .
.TP
.B ENOMEM
Cannot allocate sufficient memory to copy parts of caller's
context that need to be unshared.
.TP
.B EPERM
.I flags
specified
@ -134,14 +142,6 @@ specified
but the calling process was not privileged (did not have the
.B CAP_SYS_ADMIN
capability).
.TP
.B ENOMEM
Cannot allocate sufficient memory to copy parts of caller's
context that need to be unshared.
.TP
.B EINVAL
An invalid bit was specified in
.IR flags .
.SH VERSIONS
The
.BR unshare ()

22
man3/mq_open.3
View File

@ -129,6 +129,17 @@ set to indicate the error.
The queue exists, but the caller does not have permission to
open it in the specified mode.
.TP
.B EEXIST
Both
.B O_CREAT
and
.B O_EXCL
were specified in
.IR oflag ,
but a queue with this
.I name
already exists.
.TP
.B EINVAL
.B O_CREAT
was specified in
@ -161,17 +172,6 @@ limit.
.BR mq_overview (7)
for details of these limits.)
.TP
.B EEXIST
Both
.B O_CREAT
and
.B O_EXCL
were specified in
.IR oflag ,
but a queue with this
.I name
already exists.
.TP
.B EMFILE
The process already has the maximum number of files and
message queues open.

12
man3/mq_receive.3
View File

@ -118,12 +118,6 @@ The descriptor specified in
.I mqdes
was invalid.
.TP
.B EMSGSIZE
.IR msg_len
was less than the
.I mq_msgsize
attribute of the message queue.
.TP
.B EINTR
The call was interrupted by a signal handler.
.TP
@ -136,6 +130,12 @@ was less than zero, or because
.I tv_nsec
was less than zero or greater than 1000 million.
.TP
.B EMSGSIZE
.IR msg_len
was less than the
.I mq_msgsize
attribute of the message queue.
.TP
.B ETIMEDOUT
The call timed out before a message could be transferred.
.SH CONFORMING TO

12
man3/mq_send.3
View File

@ -123,12 +123,6 @@ The descriptor specified in
.I mqdes
was invalid.
.TP
.B EMSGSIZE
.IR msg_len
was greater than the
.I mq_msgsize
attribute of the message queue.
.TP
.B EINTR
The call was interrupted by a signal handler.
.TP
@ -141,6 +135,12 @@ was less than zero, or because
.I tv_nsec
was less than zero or greater than 1000 million.
.TP
.B EMSGSIZE
.IR msg_len
was greater than the
.I mq_msgsize
attribute of the message queue.
.TP
.B ETIMEDOUT
The call timed out before a message could be transferred.
.SH CONFORMING TO

10
man4/tty_ioctl.4
View File

@ -413,18 +413,18 @@ On error it returns \-1 and sets
appropriately.
.SH ERRORS
.TP
.B ENOIOCTLCMD
Unknown command.
.TP
.B EINVAL
Invalid command parameter.
.TP
.B EPERM
Insufficient permission.
.B ENOIOCTLCMD
Unknown command.
.TP
.B ENOTTY
Inappropriate
.IR fd .
.TP
.B EPERM
Insufficient permission.
.SH EXAMPLE
Check the condition of DTR on the serial port.

70
man7/ddp.7
View File

@ -149,16 +149,6 @@ apply to ddp.
.\" give more uniform error returns (ENOMEM vs ENOBUFS, EPERM vs
.\" EACCES etc.)
.TP
.B ENOTCONN
The operation is only defined on a connected socket, but the socket wasn't
connected.
.TP
.B EINVAL
Invalid argument passed.
.TP
.B EMSGSIZE
Datagram is bigger than the DDP MTU.
.TP
.B EACCES
The user tried to execute an operation without the necessary permissions.
These include sending to a broadcast address without
@ -169,17 +159,6 @@ and trying to bind to a reserved port without effective user ID 0 or
.B EADDRINUSE
Tried to bind to an address already in use.
.TP
.BR ENOMEM " and " ENOBUFS
Not enough memory available.
.TP
.BR ENOPROTOOPT " and " EOPNOTSUPP
Invalid socket option passed.
.TP
.B EPERM
User doesn't have permission to set high priority,
make a configuration change,
or send signals to the requested process or group,
.TP
.B EADDRNOTAVAIL
A non-existent interface was requested or the requested source address was
not local.
@ -187,13 +166,6 @@ not local.
.B EAGAIN
Operation on a nonblocking socket would block.
.TP
.B ESOCKTNOSUPPORT
The socket was unconfigured, or an unknown socket type was requested.
.TP
.B EISCONN
.BR connect (2)
was called on an already connected socket.
.TP
.B EALREADY
A connection operation on a non-blocking socket is already in progress.
.TP
@ -201,21 +173,49 @@ A connection operation on a non-blocking socket is already in progress.
A connection was closed during an
.BR accept (2).
.TP
.B EPIPE
The connection was unexpectedly closed or shut down by the other end.
.B EHOSTUNREACH
No routing table entry matches the destination address.
.TP
.B EINVAL
Invalid argument passed.
.TP
.B EISCONN
.BR connect (2)
was called on an already connected socket.
.TP
.B EMSGSIZE
Datagram is bigger than the DDP MTU.
.TP
.B ENODEV
Network device not available or not capable of sending IP.
.TP
.B ENOENT
.B SIOCGSTAMP
was called on a socket where no packet arrived.
.TP
.B EHOSTUNREACH
No routing table entry matches the destination address.
.TP
.B ENODEV
Network device not available or not capable of sending IP.
.BR ENOMEM " and " ENOBUFS
Not enough memory available.
.TP
.B ENOPKG
A kernel subsystem was not configured.
.TP
.BR ENOPROTOOPT " and " EOPNOTSUPP
Invalid socket option passed.
.TP
.B ENOTCONN
The operation is only defined on a connected socket, but the socket wasn't
connected.
.TP
.B EPERM
User doesn't have permission to set high priority,
make a configuration change,
or send signals to the requested process or group,
.TP
.B EPIPE
The connection was unexpectedly closed or shut down by the other end.
.TP
.B ESOCKTNOSUPPORT
The socket was unconfigured, or an unknown socket type was requested.
.SH VERSIONS
Appletalk is supported by Linux 2.0 or higher.
The

73
man7/ip.7
View File

@ -837,19 +837,6 @@ Ioctls to configure generic device parameters are described in
.\" We should really fix the kernels to give more uniform
.\" error returns (ENOMEM vs ENOBUFS, EPERM vs EACCES etc.)
.TP
.B ENOTCONN
The operation is only defined on a connected socket, but the socket wasn't
connected.
.TP
.B EINVAL
Invalid argument passed.
For send operations this can be caused by sending to a
.I blackhole
route.
.TP
.B EMSGSIZE
Datagram is bigger than an MTU on the path and it cannot be fragmented.
.TP
.B EACCES
The user tried to execute an operation without the necessary permissions.
These include:
@ -869,13 +856,6 @@ capability).
.B EADDRINUSE
Tried to bind to an address already in use.
.TP
.BR ENOPROTOOPT " and " EOPNOTSUPP
Invalid socket option passed.
.TP
.B EPERM
User doesn't have permission to set high priority, change configuration,
or send signals to the requested process or group.
.TP
.B EADDRNOTAVAIL
A non-existent interface was requested or the requested source
address was
@ -884,13 +864,6 @@ not local.
.B EAGAIN
Operation on a non-blocking socket would block.
.TP
.B ESOCKTNOSUPPORT
The socket is not configured or an unknown socket type was requested.
.TP
.B EISCONN
.BR connect (2)
was called on an already connected socket.
.TP
.B EALREADY
An connection operation on a non-blocking socket is already in progress.
.TP
@ -898,29 +871,53 @@ An connection operation on a non-blocking socket is already in progress.
A connection was closed during an
.BR accept (2).
.TP
.B EPIPE
The connection was unexpectedly closed or shut down by the other end.
.TP
.B ENOENT
.B SIOCGSTAMP
was called on a socket where no packet arrived.
.TP
.B EHOSTUNREACH
No valid routing table entry matches the destination address.
This error can be caused by a ICMP message from a remote router or
for the local routing table.
.TP
.B ENODEV
Network device not available or not capable of sending IP.
.B EINVAL
Invalid argument passed.
For send operations this can be caused by sending to a
.I blackhole
route.
.TP
.B ENOPKG
A kernel subsystem was not configured.
.B EISCONN
.BR connect (2)
was called on an already connected socket.
.TP
.B EMSGSIZE
Datagram is bigger than an MTU on the path and it cannot be fragmented.
.TP
.BR ENOBUFS ", " ENOMEM
Not enough free memory.
This often means that the memory allocation is limited by the socket
buffer limits, not by the system memory, but this is not
100% consistent.
.TP
.B ENOENT
.B SIOCGSTAMP
was called on a socket where no packet arrived.
.TP
.B ENOPKG
A kernel subsystem was not configured.
.TP
.BR ENOPROTOOPT " and " EOPNOTSUPP
Invalid socket option passed.
.TP
.B ENOTCONN
The operation is only defined on a connected socket, but the socket wasn't
connected.
.TP
.B EPERM
User doesn't have permission to set high priority, change configuration,
or send signals to the requested process or group.
.TP
.B EPIPE
The connection was unexpectedly closed or shut down by the other end.
.TP
.B ESOCKTNOSUPPORT
The socket is not configured or an unknown socket type was requested.
.PP
Other errors may be generated by the overlaying protocols; see
.BR tcp (7),

40
man7/packet.7
View File

@ -239,20 +239,8 @@ while passing the packet to the device driver.
They don't have the concept of a pending error.
.SH ERRORS
.TP
.B ENETDOWN
Interface is not up.
.TP
.B ENOTCONN
No interface address passed.
.TP
.B ENODEV
Unknown device name or interface index specified in interface address.
.TP
.B EMSGSIZE
Packet is bigger than interface MTU.
.TP
.B ENOBUFS
Not enough memory to allocate the packet.
.B EADDRNOTAVAIL
Unknown multicast group address passed.
.TP
.B EFAULT
User passed invalid memory address.
@ -260,17 +248,29 @@ User passed invalid memory address.
.B EINVAL
Invalid argument.
.TP
.B EMSGSIZE
Packet is bigger than interface MTU.
.TP
.B ENETDOWN
Interface is not up.
.TP
.B ENOBUFS
Not enough memory to allocate the packet.
.TP
.B ENODEV
Unknown device name or interface index specified in interface address.
.TP
.B ENOENT
No packet received.
.TP
.B ENOTCONN
No interface address passed.
.TP
.B ENXIO
Interface address contained illegal interface index.
.TP
.B EPERM
User has insufficient privileges to carry out this operation.
.TP
.B EADDRNOTAVAIL
Unknown multicast group address passed.
.TP
.B ENOENT
No packet received.
In addition other errors may be generated by the low-level driver.
.SH VERSIONS

26
man7/raw.7
View File

@ -139,6 +139,16 @@ With
all network errors are saved in the error queue.
.SH ERRORS
.TP
.B EACCES
User tried to send to a broadcast address without having the
broadcast flag set on the socket.
.TP
.B EFAULT
An invalid memory address was supplied.
.TP
.B EINVAL
Invalid argument.
.TP
.B EMSGSIZE
Packet too big.
Either Path MTU Discovery is enabled (the
@ -146,28 +156,18 @@ Either Path MTU Discovery is enabled (the
socket flag) or the packet size exceeds the maximum allowed IPv4
packet size of 64KB.
.TP
.B EACCES
User tried to send to a broadcast address without having the
broadcast flag set on the socket.
.TP
.B EPROTO
An ICMP error has arrived reporting a parameter problem.
.TP
.B EFAULT
An invalid memory address was supplied.
.TP
.B EOPNOTSUPP
Invalid flag has been passed to a socket call (like
.BR MSG_OOB ).
.TP
.B EINVAL
Invalid argument.
.TP
.B EPERM
The user doesn't have permission to open raw sockets.
Only processes with a effective user ID of 0 or the
.B CAP_NET_RAW
attribute may do that.
.TP
.B EPROTO
An ICMP error has arrived reporting a parameter problem.
.SH VERSIONS
.B IP_RECVERR
and

12
man7/tcp.7
View File

@ -849,6 +849,12 @@ option with care \(em it makes TCP less tolerant to routing
changes and other normal network conditions.
.SH ERRORS
.TP
.B EAFNOTSUPPORT
Passed socket address type in
.I sin_family
was not
.BR AF_INET .
.TP
.B EPIPE
The other end closed the socket unexpectedly or a read is
executed on a shut down socket.
@ -856,12 +862,6 @@ executed on a shut down socket.
.B ETIMEDOUT
The other end didn't acknowledge retransmitted data after
some time.
.TP
.B EAFNOTSUPPORT
Passed socket address type in
.I sin_family
was not
.BR AF_INET .
.PP
Any errors defined for
.BR ip (7)

58
man7/unix.7
View File

@ -198,8 +198,9 @@ message the
option must be enabled on the socket.
.SH ERRORS
.TP
.B ENOMEM
Out of memory.
.B EADDRINUSE
Selected local address is already taken or filesystem socket
object already exists.
.TP
.B ECONNREFUSED
.BR connect (2)
@ -207,6 +208,12 @@ called with a socket object that isn't listening.
This can happen when
the remote socket does not exist or the filename is not a socket.
.TP
.B ECONNRESET
Remote socket was unexpectedly closed.
.TP
.B EFAULT
User memory address was not valid.
.TP
.B EINVAL
Invalid argument passed.
A common cause is the missing setting of AF_UNIX
@ -215,36 +222,24 @@ in the
field of passed addresses or the socket being in an
invalid state for the applied operation.
.TP
.B EOPNOTSUPP
Stream operation called on non-stream oriented socket or tried to
use the out-of-band data option.
.TP
.B EPROTONOSUPPORT
Passed protocol is not PF_UNIX.
.TP
.B ESOCKTNOSUPPORT
Unknown socket type.
.TP
.B EPROTOTYPE
Remote socket does not match the local socket type
.RB ( SOCK_DGRAM
vs.
.BR SOCK_STREAM )
.TP
.B EADDRINUSE
Selected local address is already taken or filesystem socket
object already exists.
.TP
.B EISCONN
.BR connect (2)
called on an already connected socket or a target address was
specified on a connected socket.
.TP
.B ENOMEM
Out of memory.
.TP
.B ENOTCONN
Socket operation needs a target address, but the socket is not connected.
.TP
.B ECONNRESET
Remote socket was unexpectedly closed.
.B EOPNOTSUPP
Stream operation called on non-stream oriented socket or tried to
use the out-of-band data option.
.TP
.B EPERM
The sender passed invalid credentials in the
.IR "struct ucred" .
.TP
.B EPIPE
Remote socket was closed on a stream socket.
@ -258,12 +253,17 @@ flag to
or
.BR recvmsg (2).
.TP
.B EFAULT
User memory address was not valid.
.B EPROTONOSUPPORT
Passed protocol is not PF_UNIX.
.TP
.B EPERM
The sender passed invalid credentials in the
.IR "struct ucred" .
.B EPROTOTYPE
Remote socket does not match the local socket type
.RB ( SOCK_DGRAM
vs.
.BR SOCK_STREAM )
.TP
.B ESOCKTNOSUPPORT
Unknown socket type.
.PP
Other errors can be generated by the generic socket layer or
by the filesystem while generating a filesystem socket object.