|ELF_VERSION(3)||FreeBSD Library Functions Manual||ELF_VERSION(3)|
NAMEelf_version — retrieve or set ELF library operating version
LIBRARYELF Access Library (libelf, -lelf)
SYNOPSIS#include < libelf.h>
elf_version( unsigned int version);
DESCRIPTIONThe elf_version() function is used to query the current operating version of the ELF library, and to inform the ELF library about the application's desired operating version.
If the argument version is EV_NONE, the elf_version() function returns the currently configured operating version for the ELF library.
If the argument version is not EV_NONE, and if argument version is supported by the ELF library, function elf_version() sets the library's operating version to version, and returns the previous value of the operating version. If argument version cannot be supported, then the elf_version() function returns EV_NONE.
RETURN VALUESThe elf_version() function returns the currently configured ELF library version, or EV_NONE if an unsupported version is requested.
EXAMPLESAn application program would inform the ELF library about its desired operating version and check for an error using the following code snippet:
if (elf_version(EV_CURRENT) == EV_NONE) err(EX_SOFTWARE, "ELF library too old");
ERRORSFunction elf_version() may fail with the following error:
- [ ELF_E_VERSION]
- An unsupported library version number was requested.
|June 1, 2006||FreeBSD|