errno.h

Go to the documentation of this file.

#ifndef ERRNO_H
#define ERRNO_H

FILE_LICENCE ( GPL2_OR_LATER );

/** @file
 *
 * Error codes
 *
 * Return status codes as used within gPXE are designed to allow for
 * maximum visibility into the source of an error even in an end-user
 * build with no debugging.  They are constructed as follows:
 *
 * Bits 7-0 : PXE error code
 *
 * This is the closest equivalent PXE error code
 * (e.g. PXENV_STATUS_OUT_OF_RESOURCES), and is the only part of the
 * error that will be returned via the PXE API, since PXE has
 * predefined error codes.
 *
 * Bits 12-8 : Per-file disambiguator
 *
 * When the same error number can be generated from multiple points
 * within a file, this field can be used to identify the unique
 * instance.
 *
 * Bits 23-13 : File identifier
 *
 * This is a unique identifier for the file generating the error
 * (e.g. ERRFILE_tcp for tcp.c).
 *
 * Bits 30-24 : POSIX error code
 *
 * This is the closest equivalent POSIX error code (e.g. ENOMEM).
 *
 * Bit 31 : Reserved
 *
 * Errors are usually return as negative error numbers (e.g. -EINVAL);
 * bit 31 is therefore unusable.
 *
 *
 * The convention within the code is that errors are negative and
 * expressed using the POSIX error code and (optionally) a per-file
 * disambiguator, e.g.
 *
 *     return -EINVAL;
 *
 * or
 *
 *     #define ETCP_BAD_CHECKSUM EUNIQ_02
 *     return -( EINVAL | ETCP_BAD_CHECKSUM )
 *
 * By various bits of preprocessor magic, the PXE error code and file
 * identifier are already incorporated into the definition of the
 * POSIX error code, which keeps the code relatively clean.
 *
 *
 * Functions that wish to return failures should be declared as
 * returning an integer @c rc "Return status code".  A return value of
 * zero indicates success, a non-zero value indicates failure.  The
 * return value can be passed directly to strerror() in order to
 * generate a human-readable error message, e.g.
 *
 *     if ( ( rc = some_function ( ... ) ) != 0 ) {
 *         DBG ( "Whatever I was trying to do failed: %s\n", strerror ( rc ) );
 *         return rc;
 *     }
 *
 * As illustrated in the above example, error returns should generally
 * be directly propagated upward to the calling function.
 *
 */

/* Get definitions for file identifiers */
#include <gpxe/errfile.h>

/* If we do not have a valid file identifier, generate a compiler
 * warning upon usage of any error codes.  (Don't just use a #warning,
 * because some files include errno.h but don't ever actually use any
 * error codes.)
 */
#if ! ERRFILE
extern char missing_errfile_declaration[] __attribute__ (( deprecated ));
#undef ERRFILE
#define ERRFILE ( 0 * ( ( int ) missing_errfile_declaration ) )
#endif

/** Derive PXENV_STATUS code from gPXE error number */
#define PXENV_STATUS( rc ) ( (-(rc)) & 0x00ff )

/**
 * @defgroup pxeerrors PXE error codes
 *
 * The names, meanings and values of these error codes are defined by
 * the PXE specification.
 *
 * @{
 */

/* Generic errors */
#define PXENV_STATUS_SUCCESS                                           0x0000
#define PXENV_STATUS_FAILURE                                           0x0001
#define PXENV_STATUS_BAD_FUNC                                          0x0002
#define PXENV_STATUS_UNSUPPORTED                                       0x0003
#define PXENV_STATUS_KEEP_UNDI                                         0x0004
#define PXENV_STATUS_KEEP_ALL                                          0x0005
#define PXENV_STATUS_OUT_OF_RESOURCES                                  0x0006

/* ARP errors (0x0010 to 0x001f) */
#define PXENV_STATUS_ARP_TIMEOUT                                       0x0011

/* Base-Code state errors */
#define PXENV_STATUS_UDP_CLOSED                                        0x0018
#define PXENV_STATUS_UDP_OPEN                                          0x0019
#define PXENV_STATUS_TFTP_CLOSED                                       0x001a
#define PXENV_STATUS_TFTP_OPEN                                         0x001b

/* BIOS/system errors (0x0020 to 0x002f) */
#define PXENV_STATUS_MCOPY_PROBLEM                                     0x0020
#define PXENV_STATUS_BIS_INTEGRITY_FAILURE                             0x0021
#define PXENV_STATUS_BIS_VALIDATE_FAILURE                              0x0022
#define PXENV_STATUS_BIS_INIT_FAILURE                                  0x0023
#define PXENV_STATUS_BIS_SHUTDOWN_FAILURE                              0x0024
#define PXENV_STATUS_BIS_GBOA_FAILURE                                  0x0025
#define PXENV_STATUS_BIS_FREE_FAILURE                                  0x0026
#define PXENV_STATUS_BIS_GSI_FAILURE                                   0x0027
#define PXENV_STATUS_BIS_BAD_CKSUM                                     0x0028

/* TFTP/MTFTP errors (0x0030 to 0x003f) */
#define PXENV_STATUS_TFTP_CANNOT_ARP_ADDRESS                           0x0030
#define PXENV_STATUS_TFTP_OPEN_TIMEOUT                                 0x0032
#define PXENV_STATUS_TFTP_UNKNOWN_OPCODE                               0x0033
#define PXENV_STATUS_TFTP_READ_TIMEOUT                                 0x0035
#define PXENV_STATUS_TFTP_ERROR_OPCODE                                 0x0036
#define PXENV_STATUS_TFTP_CANNOT_OPEN_CONNECTION                       0x0038
#define PXENV_STATUS_TFTP_CANNOT_READ_FROM_CONNECTION                  0x0039
#define PXENV_STATUS_TFTP_TOO_MANY_PACKAGES                            0x003a
#define PXENV_STATUS_TFTP_FILE_NOT_FOUND                               0x003b
#define PXENV_STATUS_TFTP_ACCESS_VIOLATION                             0x003c
#define PXENV_STATUS_TFTP_NO_MCAST_ADDRESS                             0x003d
#define PXENV_STATUS_TFTP_NO_FILESIZE                                  0x003e
#define PXENV_STATUS_TFTP_INVALID_PACKET_SIZE                          0x003f

/* Reserved errors 0x0040 to 0x004f) */

/* DHCP/BOOTP errors (0x0050 to 0x005f) */
#define PXENV_STATUS_DHCP_TIMEOUT                                      0x0051
#define PXENV_STATUS_DHCP_NO_IP_ADDRESS                                0x0052
#define PXENV_STATUS_DHCP_NO_BOOTFILE_NAME                             0x0053
#define PXENV_STATUS_DHCP_BAD_IP_ADDRESS                               0x0054

/* Driver errors (0x0060 to 0x006f) */
#define PXENV_STATUS_UNDI_INVALID_FUNCTION                             0x0060
#define PXENV_STATUS_UNDI_MEDIATEST_FAILED                             0x0061
#define PXENV_STATUS_UNDI_CANNOT_INIT_NIC_FOR_MCAST                    0x0062
#define PXENV_STATUS_UNDI_CANNOT_INITIALIZE_NIC                        0x0063
#define PXENV_STATUS_UNDI_CANNOT_INITIALIZE_PHY                        0x0064
#define PXENV_STATUS_UNDI_CANNOT_READ_CONFIG_DATA                      0x0065
#define PXENV_STATUS_UNDI_CANNOT_READ_INIT_DATA                        0x0066
#define PXENV_STATUS_UNDI_BAD_MAC_ADDRESS                              0x0067
#define PXENV_STATUS_UNDI_BAD_EEPROM_CHECKSUM                          0x0068
#define PXENV_STATUS_UNDI_ERROR_SETTING_ISR                            0x0069
#define PXENV_STATUS_UNDI_INVALID_STATE                                0x006a
#define PXENV_STATUS_UNDI_TRANSMIT_ERROR                               0x006b
#define PXENV_STATUS_UNDI_INVALID_PARAMETER                            0x006c

/* ROM and NBP bootstrap errors (0x0070 to 0x007f) */
#define PXENV_STATUS_BSTRAP_PROMPT_MENU                                0x0074
#define PXENV_STATUS_BSTRAP_MCAST_ADDR                                 0x0076
#define PXENV_STATUS_BSTRAP_MISSING_LIST                               0x0077
#define PXENV_STATUS_BSTRAP_NO_RESPONSE                                0x0078
#define PXENV_STATUS_BSTRAP_FILE_TOO_BIG                               0x0079

/* Environment NBP errors (0x0080 to 0x008f) */

/* Reserved errors (0x0090 to 0x009f) */

/* Miscellaneous errors (0x00a0 to 0x00af) */
#define PXENV_STATUS_BINL_CANCELED_BY_KEYSTROKE                        0x00a0
#define PXENV_STATUS_BINL_NO_PXE_SERVER                                0x00a1
#define PXENV_STATUS_NOT_AVAILABLE_IN_PMODE                            0x00a2
#define PXENV_STATUS_NOT_AVAILABLE_IN_RMODE                            0x00a3

/* BUSD errors (0x00b0 to 0x00bf) */
#define PXENV_STATUS_BUSD_DEVICE_NOT_SUPPORTED                         0x00b0

/* Loader errors (0x00c0 to 0x00cf) */
#define PXENV_STATUS_LOADER_NO_FREE_BASE_MEMORY                        0x00c0
#define PXENV_STATUS_LOADER_NO_BC_ROMID                                0x00c1
#define PXENV_STATUS_LOADER_BAD_BC_ROMID                               0x00c2
#define PXENV_STATUS_LOADER_BAD_BC_RUNTIME_IMAGE                       0x00c3
#define PXENV_STATUS_LOADER_NO_UNDI_ROMID                              0x00c4
#define PXENV_STATUS_LOADER_BAD_UNDI_ROMID                             0x00c5
#define PXENV_STATUS_LOADER_BAD_UNDI_DRIVER_IMAGE                      0x00c6
#define PXENV_STATUS_LOADER_NO_PXE_STRUCT                              0x00c8
#define PXENV_STATUS_LOADER_NO_PXENV_STRUCT                            0x00c9
#define PXENV_STATUS_LOADER_UNDI_START                                 0x00ca
#define PXENV_STATUS_LOADER_BC_START                                   0x00cb

/** @} */

/**
 * @defgroup posixerrors POSIX error codes
 *
 * The names and meanings (but not the values) of these error codes
 * are defined by POSIX.  We choose to assign unique values which
 * incorporate the closest equivalent PXE error code, so that code may
 * simply use ENOMEM, rather than having to use the cumbersome
 * (ENOMEM|PXENV_STATUS_OUT_OF_RESOURCES).
 *
 * @{
 */

/** Operation completed successfully */
#define ENOERR                  ( ERRFILE | PXENV_STATUS_SUCCESS | 0x00000000 )

/** Arg list too long */
#define E2BIG                  ( ERRFILE | PXENV_STATUS_BAD_FUNC | 0x01000000 )

/** Permission denied */
#define EACCES    ( ERRFILE | PXENV_STATUS_TFTP_ACCESS_VIOLATION | 0x02000000 )

/** Address in use */
#define EADDRINUSE             ( ERRFILE | PXENV_STATUS_UDP_OPEN | 0x03000000 )

/** Address not available */
#define EADDRNOTAVAIL          ( ERRFILE | PXENV_STATUS_UDP_OPEN | 0x04000000 )

/** Address family not supported */
#define EAFNOSUPPORT        ( ERRFILE | PXENV_STATUS_UNSUPPORTED | 0x05000000 )

/** Resource temporarily unavailable */
#define EAGAIN                  ( ERRFILE | PXENV_STATUS_FAILURE | 0x06000000 )

/** Connection already in progress */
#define EALREADY               ( ERRFILE | PXENV_STATUS_UDP_OPEN | 0x07000000 )

/** Bad file descriptor */
#define EBADF               ( ERRFILE | PXENV_STATUS_TFTP_CLOSED | 0x08000000 )

/** Bad message */
#define EBADMSG                 ( ERRFILE | PXENV_STATUS_FAILURE | 0x09000000 )

/** Resource busy */
#define EBUSY          ( ERRFILE | PXENV_STATUS_OUT_OF_RESOURCES | 0x0a000000 )

/** Operation canceled */
#define ECANCELED \
             ( ERRFILE | PXENV_STATUS_BINL_CANCELED_BY_KEYSTROKE | 0x0b000000 )

/** No child processes */
#define ECHILD      ( ERRFILE | PXENV_STATUS_TFTP_FILE_NOT_FOUND | 0x0c000000 )

/** Connection aborted */
#define ECONNABORTED \
       ( ERRFILE | PXENV_STATUS_TFTP_CANNOT_READ_FROM_CONNECTION | 0x0d000000 )

/** Connection refused */
#define ECONNREFUSED \
            ( ERRFILE | PXENV_STATUS_TFTP_CANNOT_OPEN_CONNECTION | 0x0e000000 )

/** Connection reset */
#define ECONNRESET \
       ( ERRFILE | PXENV_STATUS_TFTP_CANNOT_READ_FROM_CONNECTION | 0x0f000000 )

/** Resource deadlock avoided */
#define EDEADLK                 ( ERRFILE | PXENV_STATUS_FAILURE | 0x10000000 )

/** Destination address required */
#define EDESTADDRREQ           ( ERRFILE | PXENV_STATUS_BAD_FUNC | 0x11000000 )

/** Domain error */
#define EDOM                    ( ERRFILE | PXENV_STATUS_FAILURE | 0x12000000 )

/** Reserved */
#define EDQUOT                  ( ERRFILE | PXENV_STATUS_FAILURE | 0x13000000 )

/** File exists */
#define EEXIST                  ( ERRFILE | PXENV_STATUS_FAILURE | 0x14000000 )

/** Bad address */
#define EFAULT            ( ERRFILE | PXENV_STATUS_MCOPY_PROBLEM | 0x15000000 )

/** File too large */
#define EFBIG             ( ERRFILE | PXENV_STATUS_MCOPY_PROBLEM | 0x16000000 )

/** Host is unreachable */
#define EHOSTUNREACH        ( ERRFILE | PXENV_STATUS_ARP_TIMEOUT | 0x17000000 )

/** Identifier removed */
#define EIDRM                   ( ERRFILE | PXENV_STATUS_FAILURE | 0x18000000 )

/** Illegal byte sequence */
#define EILSEQ                  ( ERRFILE | PXENV_STATUS_FAILURE | 0x19000000 )

/** Operation in progress */
#define EINPROGRESS             ( ERRFILE | PXENV_STATUS_FAILURE | 0x1a000000 )

/** Interrupted function call */
#define EINTR                   ( ERRFILE | PXENV_STATUS_FAILURE | 0x1b000000 )

/** Invalid argument */
#define EINVAL                 ( ERRFILE | PXENV_STATUS_BAD_FUNC | 0x1c000000 )

/** Input/output error */
#define EIO \
       ( ERRFILE | PXENV_STATUS_TFTP_CANNOT_READ_FROM_CONNECTION | 0x1d000000 )

/** Socket is connected */
#define EISCONN                ( ERRFILE | PXENV_STATUS_UDP_OPEN | 0x1e000000 )

/** Is a directory */
#define EISDIR                  ( ERRFILE | PXENV_STATUS_FAILURE | 0x1f000000 )

/** Too many levels of symbolic links */
#define ELOOP                   ( ERRFILE | PXENV_STATUS_FAILURE | 0x20000000 )

/** Too many open files */
#define EMFILE         ( ERRFILE | PXENV_STATUS_OUT_OF_RESOURCES | 0x21000000 )

/** Too many links */
#define EMLINK                  ( ERRFILE | PXENV_STATUS_FAILURE | 0x22000000 )

/** Inappropriate message buffer length */
#define EMSGSIZE               ( ERRFILE | PXENV_STATUS_BAD_FUNC | 0x23000000 )

/** Reserved */
#define EMULTIHOP               ( ERRFILE | PXENV_STATUS_FAILURE | 0x24000000 )

/** Filename too long */
#define ENAMETOOLONG            ( ERRFILE | PXENV_STATUS_FAILURE | 0x25000000 )

/** Network is down */
#define ENETDOWN            ( ERRFILE | PXENV_STATUS_ARP_TIMEOUT | 0x26000000 )

/** Connection aborted by network */
#define ENETRESET               ( ERRFILE | PXENV_STATUS_FAILURE | 0x27000000 )

/** Network unreachable */
#define ENETUNREACH         ( ERRFILE | PXENV_STATUS_ARP_TIMEOUT | 0x28000000 )

/** Too many open files in system */
#define ENFILE         ( ERRFILE | PXENV_STATUS_OUT_OF_RESOURCES | 0x29000000 )

/** No buffer space available */
#define ENOBUFS        ( ERRFILE | PXENV_STATUS_OUT_OF_RESOURCES | 0x2a000000 )

/** No message is available on the STREAM head read queue */
#define ENODATA                 ( ERRFILE | PXENV_STATUS_FAILURE | 0x2b000000 )

/** No such device */
#define ENODEV      ( ERRFILE | PXENV_STATUS_TFTP_FILE_NOT_FOUND | 0x2c000000 )

/** No such file or directory */
#define ENOENT      ( ERRFILE | PXENV_STATUS_TFTP_FILE_NOT_FOUND | 0x2d000000 )

/** Exec format error */
#define ENOEXEC                 ( ERRFILE | PXENV_STATUS_FAILURE | 0x2e000000 )

/** No locks available */
#define ENOLCK                  ( ERRFILE | PXENV_STATUS_FAILURE | 0x2f000000 )

/** Reserved */
#define ENOLINK                 ( ERRFILE | PXENV_STATUS_FAILURE | 0x30000000 )

/** Not enough space */
#define ENOMEM         ( ERRFILE | PXENV_STATUS_OUT_OF_RESOURCES | 0x31000000 )

/** No message of the desired type */
#define ENOMSG                  ( ERRFILE | PXENV_STATUS_FAILURE | 0x32000000 )

/** Protocol not available */
#define ENOPROTOOPT         ( ERRFILE | PXENV_STATUS_UNSUPPORTED | 0x33000000 )

/** No space left on device */
#define ENOSPC         ( ERRFILE | PXENV_STATUS_OUT_OF_RESOURCES | 0x34000000 )

/** No STREAM resources */
#define ENOSR          ( ERRFILE | PXENV_STATUS_OUT_OF_RESOURCES | 0x35000000 )

/** Not a STREAM */
#define ENOSTR                  ( ERRFILE | PXENV_STATUS_FAILURE | 0x36000000 )

/** Function not implemented */
#define ENOSYS              ( ERRFILE | PXENV_STATUS_UNSUPPORTED | 0x37000000 )

/** The socket is not connected */
#define ENOTCONN                ( ERRFILE | PXENV_STATUS_FAILURE | 0x38000000 )

/** Not a directory */
#define ENOTDIR                 ( ERRFILE | PXENV_STATUS_FAILURE | 0x39000000 )

/** Directory not empty */
#define ENOTEMPTY               ( ERRFILE | PXENV_STATUS_FAILURE | 0x3a000000 )

/** Not a socket */
#define ENOTSOCK                ( ERRFILE | PXENV_STATUS_FAILURE | 0x3b000000 )

/** Not supported */
#define ENOTSUP             ( ERRFILE | PXENV_STATUS_UNSUPPORTED | 0x3c000000 )

/** Inappropriate I/O control operation */
#define ENOTTY                  ( ERRFILE | PXENV_STATUS_FAILURE | 0x3d000000 )

/** No such device or address */
#define ENXIO       ( ERRFILE | PXENV_STATUS_TFTP_FILE_NOT_FOUND | 0x3e000000 )

/** Operation not supported on socket */
#define EOPNOTSUPP          ( ERRFILE | PXENV_STATUS_UNSUPPORTED | 0x3f000000 )

/** Value too large to be stored in data type */
#define EOVERFLOW               ( ERRFILE | PXENV_STATUS_FAILURE | 0x40000000 )

/** Operation not permitted */
#define EPERM     ( ERRFILE | PXENV_STATUS_TFTP_ACCESS_VIOLATION | 0x41000000 )

/** Broken pipe */
#define EPIPE                   ( ERRFILE | PXENV_STATUS_FAILURE | 0x42000000 )

/** Protocol error */
#define EPROTO                  ( ERRFILE | PXENV_STATUS_FAILURE | 0x43000000 )

/** Protocol not supported */
#define EPROTONOSUPPORT     ( ERRFILE | PXENV_STATUS_UNSUPPORTED | 0x44000000 )

/** Protocol wrong type for socket */
#define EPROTOTYPE              ( ERRFILE | PXENV_STATUS_FAILURE | 0x45000000 )

/** Result too large */
#define ERANGE                  ( ERRFILE | PXENV_STATUS_FAILURE | 0x46000000 )

/** Read-only file system */
#define EROFS                   ( ERRFILE | PXENV_STATUS_FAILURE | 0x47000000 )

/** Invalid seek */
#define ESPIPE                  ( ERRFILE | PXENV_STATUS_FAILURE | 0x48000000 )

/** No such process */
#define ESRCH       ( ERRFILE | PXENV_STATUS_TFTP_FILE_NOT_FOUND | 0x49000000 )

/** Stale file handle */
#define ESTALE                  ( ERRFILE | PXENV_STATUS_FAILURE | 0x4a000000 )

/** STREAM ioctl() timeout */
#define ETIME                   ( ERRFILE | PXENV_STATUS_FAILURE | 0x4b000000 )

/** Operation timed out */
#define ETIMEDOUT     ( ERRFILE | PXENV_STATUS_TFTP_READ_TIMEOUT | 0x4c000000 )

/** Text file busy */
#define ETXTBSY                 ( ERRFILE | PXENV_STATUS_FAILURE | 0x4d000000 )

/** Operation would block (different from EAGAIN!) */
#define EWOULDBLOCK           ( ERRFILE | PXENV_STATUS_TFTP_OPEN | 0x4e000000 )

/** Improper link */
#define EXDEV                   ( ERRFILE | PXENV_STATUS_FAILURE | 0x4f000000 )

/** @} */

/**
 * @defgroup euniq Per-file error disambiguators
 *
 * Files which use the same error number multiple times should
 * probably define their own error subspace using these
 * disambiguators.  For example:
 *
 *     #define ETCP_HEADER_TOO_SHORT    EUNIQ_01
 *     #define ETCP_BAD_CHECKSUM        EUNIQ_02
 *
 * @{
 */

#define EUNIQ_01        0x00000100
#define EUNIQ_02        0x00000200
#define EUNIQ_03        0x00000300
#define EUNIQ_04        0x00000400
#define EUNIQ_05        0x00000500
#define EUNIQ_06        0x00000600
#define EUNIQ_07        0x00000700
#define EUNIQ_08        0x00000800
#define EUNIQ_09        0x00000900
#define EUNIQ_0A        0x00000a00
#define EUNIQ_0B        0x00000b00
#define EUNIQ_0C        0x00000c00
#define EUNIQ_0D        0x00000d00
#define EUNIQ_0E        0x00000e00
#define EUNIQ_0F        0x00000f00
#define EUNIQ_10        0x00001000
#define EUNIQ_11        0x00001100
#define EUNIQ_12        0x00001200
#define EUNIQ_13        0x00001300
#define EUNIQ_14        0x00001400
#define EUNIQ_15        0x00001500
#define EUNIQ_16        0x00001600
#define EUNIQ_17        0x00001700
#define EUNIQ_18        0x00001800
#define EUNIQ_19        0x00001900
#define EUNIQ_1A        0x00001a00
#define EUNIQ_1B        0x00001b00
#define EUNIQ_1C        0x00001c00
#define EUNIQ_1D        0x00001d00
#define EUNIQ_1E        0x00001e00
#define EUNIQ_1F        0x00001f00

/** @} */

extern int errno;

#endif /* ERRNO_H */