| ELF_ERRMSG(3) | Library Functions Manual | ELF_ERRMSG(3) | 
elf_errmsg, elf_errno —
#include <libelf.h>
int
  
  elf_errno(void);
const char *
  
  elf_errmsg(int
    error);
Function elf_errno() is used to retrieve
    the last error recorded by the ELF library. Invoking this function has the
    side-effect of resetting the ELF library's recorded error number to
  zero.
The function elf_errmsg() returns a
    null-terminated string with a human readable description of the error
    specified in argument error. A zero value for argument
    error retrieves the most recent error encountered by
    the ELF library. An argument value of -1 behaves identically, except that it
    guarantees a non-NULL return from elf_errmsg().
elf_errno() returns a non-zero value encoding
  the last error encountered by the ELF library, or zero if no error was
  encountered.
Function elf_errmsg() returns a pointer to
    library local storage for non-zero values of argument
    error. With a zero argument, the function will return
    a NULL pointer if no error had been encountered by the library, or will
    return a pointer to library local storage containing an appropriate message
    otherwise.
elf_errno() and discarding its return value.
/* clear error */ (void) elf_errno();
Retrieving a human-readable description of the current error number can be done with the following snippet:
int err; const char *errmsg; ... err = elf_errno(); if (err != 0) errmsg = elf_errmsg(err);
elf_errmsg() is not localized.
| June 11, 2006 | NetBSD 9.3 |