mirror of
https://github.com/ipxe/ipxe
synced 2025-12-30 04:28:12 +03:00
1266d7902b
Intel's C compiler (icc) chokes on the zero-length arrays that we currently use as part of the mechanism for accessing linker table entries. Abstract away the zero-length arrays, to make a port to icc easier. Introduce macros such as for_each_table_entry() to simplify the common case of iterating over all entries in a linker table. Represent table names as #defined string constants rather than unquoted literals; this avoids visual confusion between table names and C variable or type names, and also allows us to force a compilation error in the event of incorrect table names.
120 lines
3.0 KiB
C
120 lines
3.0 KiB
C
#include <errno.h>
|
|
#include <string.h>
|
|
#include <stdio.h>
|
|
#include <gpxe/errortab.h>
|
|
|
|
/** @file
|
|
*
|
|
* Error descriptions.
|
|
*
|
|
* The error numbers used by Etherboot are a superset of those defined
|
|
* by the PXE specification version 2.1. See errno.h for a listing of
|
|
* the error values.
|
|
*
|
|
* To save space in ROM images, error string tables are optional. Use
|
|
* the ERRORMSG_XXX options in config.h to select which error string
|
|
* tables you want to include. If an error string table is omitted,
|
|
* strerror() will simply return the text "Error 0x<errno>".
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* Find error description
|
|
*
|
|
* @v errno Error number
|
|
* @v mask Mask of bits that we care about
|
|
* @ret errortab Error description, or NULL
|
|
*/
|
|
static struct errortab * find_error ( int errno, int mask ) {
|
|
struct errortab *errortab;
|
|
|
|
for_each_table_entry ( errortab, ERRORTAB ) {
|
|
if ( ( ( errortab->errno ^ errno ) & mask ) == 0 )
|
|
return errortab;
|
|
}
|
|
|
|
return NULL;
|
|
}
|
|
|
|
/**
|
|
* Find closest error description
|
|
*
|
|
* @v errno Error number
|
|
* @ret errortab Error description, or NULL
|
|
*
|
|
*
|
|
*/
|
|
static struct errortab * find_closest_error ( int errno ) {
|
|
struct errortab *errortab;
|
|
|
|
/* First, look for an exact match */
|
|
if ( ( errortab = find_error ( errno, 0x7fffffff ) ) != NULL )
|
|
return errortab;
|
|
|
|
/* Second, try masking off the gPXE-specific bit and seeing if
|
|
* we have an entry for the generic POSIX error message.
|
|
*/
|
|
if ( ( errortab = find_error ( errno, 0x4f0000ff ) ) != NULL )
|
|
return errortab;
|
|
|
|
return NULL;
|
|
}
|
|
|
|
/**
|
|
* Retrieve string representation of error number.
|
|
*
|
|
* @v errno/rc Error number or return status code
|
|
* @ret strerror Pointer to error text
|
|
*
|
|
* If the error is not found in the linked-in error tables, generates
|
|
* a generic "Error 0x<errno>" message.
|
|
*
|
|
* The pointer returned by strerror() is valid only until the next
|
|
* call to strerror().
|
|
*
|
|
*/
|
|
const char * strerror ( int errno ) {
|
|
static char errbuf[64];
|
|
struct errortab *errortab;
|
|
|
|
/* Allow for strerror(rc) as well as strerror(errno) */
|
|
if ( errno < 0 )
|
|
errno = -errno;
|
|
|
|
/* Find the error description, if one exists */
|
|
errortab = find_closest_error ( errno );
|
|
|
|
/* Construct the error message */
|
|
if ( errortab ) {
|
|
snprintf ( errbuf, sizeof ( errbuf ), "%s (%#08x)",
|
|
errortab->text, errno );
|
|
} else {
|
|
snprintf ( errbuf, sizeof ( errbuf ), "Error %#08x", errno );
|
|
}
|
|
|
|
return errbuf;
|
|
}
|
|
|
|
/* Do not include ERRFILE portion in the numbers in the error table */
|
|
#undef ERRFILE
|
|
#define ERRFILE 0
|
|
|
|
/** The most common errors */
|
|
struct errortab common_errors[] __errortab = {
|
|
{ 0, "No error" },
|
|
{ EACCES, "Permission denied" },
|
|
{ ECANCELED, "Operation cancelled" },
|
|
{ ECONNRESET, "Connection reset" },
|
|
{ EINVAL, "Invalid argument" },
|
|
{ EIO, "Input/output error" },
|
|
{ ENETUNREACH, "Network unreachable" },
|
|
{ ENODEV, "No such device" },
|
|
{ ENOENT, "File not found" },
|
|
{ ENOEXEC, "Not an executable image" },
|
|
{ ENOMEM, "Out of memory" },
|
|
{ ENOSPC, "No space left on device" },
|
|
{ ENOTSUP, "Not supported" },
|
|
{ EPERM, "Operation not permitted" },
|
|
{ ETIMEDOUT, "Connection timed out" },
|
|
};
|