ELF_ERRMSG(3) | Library Functions Manual | ELF_ERRMSG(3) |
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().
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.
/* 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);
June 11, 2006 | NetBSD 7.2 |