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.0 |