The Single UNIX ® Specification, Version 2
Copyright © 1997 The Open Group

 Error Numbers

Most functions can provide an error number. The means by which each function provides its error numbers is specified in its description.

Some functions provide the error number in a variable accessed through the symbol errno. The symbol errno, defined by including the header <errno.h>, is a macro that expands to a modifiable lvalue of type int.

The value of errno should only be examined when it is indicated to be valid by a function's return value. No function in this specification sets errno to zero to indicate an error. For each thread of a process, the value of errno is not affected by function calls or assignments to errno by other threads.

Some functions return an error number directly as the function value. These functions return a value of zero to indicate success.

If more than one error occurs in processing a function call, any one of the possible errors may be returned, as the order of detection is undefined.

Implementations may support additional errors not included in this list, may generate errors included in this list under circumstances other than those described here, or may contain extensions or limitations that prevent some errors from occurring. The ERRORS section on each page specifies whether an error will be returned, or whether it may be returned. Implementations will not generate a different error number from the ones described here for error conditions described in this specification, but may generate additional errors unless explicitly disallowed for a particular function.

The following symbolic names identify the possible error numbers, in the context of the functions specifically defined in this specification; these general descriptions are more precisely defined in the ERRORS sections of the functions that return them. Only these symbolic names should be used in programs, since the actual value of the error number is unspecified. All values listed in this section are unique except as noted below. The values for all these names can be found in the header <errno.h>.

Argument list too long The sum of the number of bytes used by the new process image's argument list and environment list is greater than the system-imposed limit of {ARG_MAX} bytes.
Permission denied An attempt was made to access a file in a way forbidden by its file access permissions.
Address in use The specified address is in use.
Address not available The specified address is not available from the local system.
Address family not supported The implementation does not support the specified address family, or the specified address is not a valid address for the address family of the specified socket.
Resource temporarily unavailable This is a temporary condition and later calls to the same routine may complete normally.
Connection already in progress A connection request is already in progress for the specified socket.
Bad file descriptor A file descriptor argument is out of range, refers to no open file, or a read (write) request is made to a file that is only open for writing (reading).
Bad message During a read(), getmsg() or ioctl() I_RECVFD request to a STREAMS device, a message arrived at the head of the STREAM that is inappropriate for the function receiving the message.
  • read() - message waiting to be read on a STREAM is not a data message.
  • getmsg() - a file descriptor was received instead of a control message.
  • ioctl() - control or data information was received instead of a file descriptor when I_RECVFD was specified.
Bad Message The implementation has detected a corrupted message.
Resource busy An attempt was made to make use of a system resource that is not currently available, as it is being used by another process in a manner that would have conflicted with the request being made by this process.
Operation canceled The associated asynchronous operation was canceled before completion.
No child process A wait() or waitpid() function was executed by a process that had no existing or unwaited-for child process.
Connection aborted The connection has been aborted.
Connection refused An attempt to connect to a socket was refused because there was no process listening or because the queue of connection requests was full and the underlying protocol does not support retransmissions.
Connection reset The connection was forcibly closed by the peer.
Resource deadlock would occur An attempt was made to lock a system resource that would have resulted in a deadlock situation.
Destination address required No bind address was established.
Domain error An input argument is outside the defined domain of the mathematical function. (Defined in the ISO C standard.)
File exists An existing file was mentioned in an inappropriate context, for instance, as a new link name in the link() function.
Bad address The system detected an invalid address in attempting to use an argument of a call. The reliable detection of this error cannot be guaranteed, and when not detected may result in the generation of a signal, indicating an address violation, which is sent to the process.
File too large The size of a file would exceed the maximum file size of an implementation or offset maximum established in the corresponding file description.
Host is unreachable The destination host cannot be reached (probably because the host is down or a remote router cannot reach it).
Identifier removed Returned during interprocess communication if an identifier has been removed from the system.
Operation in progress This code is used to indicate that an asynchronous operation has not yet completed.
O_NONBLOCK is set for the socket file descriptor and the connection cannot be immediately established.
Illegal byte sequence A wide-character code has been detected that does not correspond to a valid character, or a byte sequence does not form a valid wide-character code.
Interrupted function call An asynchronous signal was caught by the process during the execution of an interruptible function. If the signal handler performs a normal return, the interrupted function call may return this condition. (See <signal.h>.)
Invalid argument Some invalid argument was supplied; (for example, specifying an undefined signal in a signal() function or a kill() function).
Input/output error Some physical input or output error has occurred. This error may be reported on a subsequent operation on the same file descriptor. Any other error-causing operation on the same file descriptor may cause the [EIO] error indication to be lost.
Socket is connected The specified socket is already connected.
Is a directory An attempt was made to open a directory with write mode specified.
Too many levels of symbolic links Too many symbolic links were encountered in resolving a pathname.
Too many open files An attempt was made to open more than the maximum number of {OPEN_MAX} file descriptors allowed in this process.
Too many links An attempt was made to have the link count of a single file exceed {LINK_MAX}.
Message too large A message sent on a transport provider was larger than an internal message buffer or some other network limit.
Inappropriate message buffer length.
Filename too long The length of a pathname exceeds {PATH_MAX}, or a pathname component is longer than {NAME_MAX} and {_POSIX_NO_TRUNC} was in effect for that file.
Network is down The local interface used to reach the destination is down.
Network unreachable No route to the network is present.
Too many files open in system Too many files are currently open in the system. The system has reached its predefined limit for simultaneously open files and temporarily cannot accept requests to open another one.
No buffer space available Insufficient buffer resources were available in the system to perform the socket operation.
No message available No message is available on the STREAM head read queue.
No such device An attempt was made to apply an inappropriate function to a device; for example, trying to read a write-only device such as a printer.
No such file or directory A component of a specified pathname does not exist, or the pathname is an empty string.
Executable file format error A request is made to execute a file that, although it has the appropriate permissions, is not in the format required by the implementation for executable files.
No locks available A system-imposed limit on the number of simultaneous file and record locks has been reached and no more are currently available.
Not enough space The new process image requires more memory than is allowed by the hardware or system-imposed memory management constraints.
No message of the desired type The message queue does not contain a message of the required type during interprocess communication.
Protocol not available The protocol option specified to setsockopt() is not supported by the implementation.
No space left on a device During the write() function on a regular file or when extending a directory, there is no free space left on the device.
No STREAM resources Insufficient STREAMS memory resources are available to perform a STREAMS related function. This is a temporary condition; one may recover from it if other processes release resources.
Not a STREAM A STREAM function was attempted on a file descriptor that was not associated with a STREAMS device.
Function not implemented An attempt was made to use a function that is not available in this implementation.
Socket not connected The socket is not connected.
Not a directory A component of the specified pathname exists, but it is not a directory, when a directory was expected.
Directory not empty A directory with entries other than dot and dot-dot was supplied when an empty directory was expected.
Not a socket The file descriptor does not refer to a socket.
Not supported The implementation does not support this feature of the Realtime Feature Group.
Inappropriate I/O control operation A control function has been attempted for a file or special file for which the operation is inappropriate.
No such device or address Input or output on a special file refers to a device that does not exist, or makes a request beyond the capabilities of the device. It may also occur when, for example, a tape drive is not on-line.
Operation not supported on socket The type of socket (address family or protocol) does not support the requested operation.
Value too large to be stored in data type The user ID or group ID of an IPC or file system object was too large to be stored into appropriate member of the caller-provided structure. This error will only occur on implementations that support a larger range of user ID or group ID values than the declared structure member can support. This usually occurs because the IPC or file system object resides on a remote machine with a larger value of the type uid_t, off_t or gid_t than the local system.
Operation not permitted An attempt was made to perform an operation limited to processes with appropriate privileges or to the owner of a file or other resource.
Broken pipe A write was attempted on a  socket,  pipe or FIFO for which there is no process to read the data.
Protocol error Some protocol error occurred. This error is device specific, but is generally not related to a hardware failure.
Protocol not supported The protocol is not supported by the address family, or the protocol is not supported by the implementation.
Socket type not supported The socket type is not supported by the protocol.
Result too large or too small The result of the function is too large (overflow) or too small (underflow) to be represented in the available space. (Defined in the ISO C standard.)
Read-only file system An attempt was made to modify a file or directory on a file system that is read only.
Invalid seek An attempt was made to access the file offset associated with a pipe or FIFO.
No such process No process can be found corresponding to that specified by the given process ID.
STREAM ioctl() timeout The timer set for a STREAMS ioctl() call has expired. The cause of this error is device specific and could indicate either a hardware or software failure, or a timeout value that is too short for the specific operation. The status of the ioctl() operation is indeterminate.
Connection timed out The connection to a remote machine has timed out. If the connection timed out during execution of the function that reported this error (as opposed to timing out prior to the function being called), it is unspecified whether the function has completed some or all of the documented behaviour associated with a successful completion of the function.
Operation timed out The time limit associated with the operation was exceeded before the operation completed.
Text file busy An attempt was made to execute a pure-procedure program that is currently open for writing, or an attempt has been made to open for writing a pure-procedure program that is being executed.
Operation would block An operation on a socket marked as non-blocking has encountered a situation such as no data available that otherwise would have caused the function to suspend execution. An XSI-conforming implementation may assign the same values for [EWOULDBLOCK] and [EAGAIN].
Improper link A link to a file on another file system was attempted.

 Additional Error Numbers

Additional implementation-dependent error numbers may be defined in <errno.h>.

UNIX ® is a registered Trademark of The Open Group.
Copyright © 1997 The Open Group
[ Main Index | XSH | XCU | XBD | XCURSES | XNS ]