diff options
Diffstat (limited to 'gpxe/src/include/errno.h')
-rw-r--r-- | gpxe/src/include/errno.h | 510 |
1 files changed, 0 insertions, 510 deletions
diff --git a/gpxe/src/include/errno.h b/gpxe/src/include/errno.h deleted file mode 100644 index 56095ecb..00000000 --- a/gpxe/src/include/errno.h +++ /dev/null @@ -1,510 +0,0 @@ -#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 */ |