You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

strerror.c 3.1KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121
  1. #include <errno.h>
  2. #include <string.h>
  3. #include <stdio.h>
  4. #include <gpxe/errortab.h>
  5. /** @file
  6. *
  7. * Error descriptions.
  8. *
  9. * The error numbers used by Etherboot are a superset of those defined
  10. * by the PXE specification version 2.1. See errno.h for a listing of
  11. * the error values.
  12. *
  13. * To save space in ROM images, error string tables are optional. Use
  14. * the ERRORMSG_XXX options in config.h to select which error string
  15. * tables you want to include. If an error string table is omitted,
  16. * strerror() will simply return the text "Error 0x<errno>".
  17. *
  18. */
  19. static struct errortab errortab_start[0]
  20. __table_start ( struct errortab, errortab );
  21. static struct errortab errortab_end[0]
  22. __table_end ( struct errortab, errortab );
  23. /**
  24. * Find error description
  25. *
  26. * @v errno Error number
  27. * @v mask Mask of bits that we care about
  28. * @ret errortab Error description, or NULL
  29. */
  30. static struct errortab * find_error ( int errno, int mask ) {
  31. struct errortab *errortab;
  32. for ( errortab = errortab_start ; errortab < errortab_end ;
  33. errortab++ ) {
  34. if ( ( ( errortab->errno ^ errno ) & mask ) == 0 )
  35. return errortab;
  36. }
  37. return NULL;
  38. }
  39. /**
  40. * Find closest error description
  41. *
  42. * @v errno Error number
  43. * @ret errortab Error description, or NULL
  44. *
  45. *
  46. */
  47. static struct errortab * find_closest_error ( int errno ) {
  48. struct errortab *errortab;
  49. /* First, look for an exact match */
  50. if ( ( errortab = find_error ( errno, 0x7fffffff ) ) != NULL )
  51. return errortab;
  52. /* Second, try masking off the gPXE-specific bit and seeing if
  53. * we have an entry for the generic POSIX error message.
  54. */
  55. if ( ( errortab = find_error ( errno, 0x4f0000ff ) ) != NULL )
  56. return errortab;
  57. return NULL;
  58. }
  59. /**
  60. * Retrieve string representation of error number.
  61. *
  62. * @v errno/rc Error number or return status code
  63. * @ret strerror Pointer to error text
  64. *
  65. * If the error is not found in the linked-in error tables, generates
  66. * a generic "Error 0x<errno>" message.
  67. *
  68. * The pointer returned by strerror() is valid only until the next
  69. * call to strerror().
  70. *
  71. */
  72. const char * strerror ( int errno ) {
  73. static char errbuf[64];
  74. struct errortab *errortab;
  75. /* Allow for strerror(rc) as well as strerror(errno) */
  76. if ( errno < 0 )
  77. errno = -errno;
  78. /* Find the error description, if one exists */
  79. errortab = find_closest_error ( errno );
  80. /* Construct the error message */
  81. if ( errortab ) {
  82. snprintf ( errbuf, sizeof ( errbuf ), "%s (%#08x)",
  83. errortab->text, errno );
  84. } else {
  85. snprintf ( errbuf, sizeof ( errbuf ), "Error %#08x", errno );
  86. }
  87. return errbuf;
  88. }
  89. /* Do not include ERRFILE portion in the numbers in the error table */
  90. #undef ERRFILE
  91. #define ERRFILE 0
  92. /** The most common errors */
  93. struct errortab common_errors[] __errortab = {
  94. { 0, "No error" },
  95. { ENOMEM, "Out of memory" },
  96. { EINVAL, "Invalid argument" },
  97. { ENOSPC, "No space left on device" },
  98. { EIO, "Input/output error" },
  99. { EACCES, "Permission denied" },
  100. { ENOENT, "File not found" },
  101. { ENETUNREACH, "Network unreachable" },
  102. { ETIMEDOUT, "Connection timed out" },
  103. { EPIPE, "Broken pipe" },
  104. { ECANCELED, "Operation cancelled" },
  105. };