Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

elf_version(3) [freebsd man page]

ELF_VERSION(3)						   BSD Library Functions Manual 					    ELF_VERSION(3)

elf_version -- retrieve or set ELF library operating version LIBRARY
ELF Access Library (libelf, -lelf) SYNOPSIS
#include <libelf.h> unsigned int elf_version(unsigned int version); DESCRIPTION
The elf_version() function is used to query the current operating version of the ELF library, and to inform the ELF library about the appli- cation'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 VALUES
The elf_version() function returns the currently configured ELF library version, or EV_NONE if an unsupported version is requested. EXAMPLES
An application program would inform the ELF library about its desired operating version and check for an error using the following code snip- pet: if (elf_version(EV_CURRENT) == EV_NONE) err(EXIT_FAILURE, "ELF library too old"); ERRORS
Function elf_version() may fail with the following error: [ELF_E_VERSION] An unsupported library version number was requested. SEE ALSO
elf(3), gelf(3) BSD
November 9, 2011 BSD

Check Out this Related Man Page

elf_version(3ELF)					       ELF Library Functions						 elf_version(3ELF)

elf_version - coordinate ELF library and application versions SYNOPSIS
cc [ flag ... ] file ... -lelf [ library ... ] #include <libelf.h> unsigned elf_version(unsigned ver); DESCRIPTION
As elf(3ELF) explains, the program, the library, and an object file have independent notions of the latest ELF version. elf_version() lets a program query the ELF library's internal version. It further lets the program specify what memory types it uses by giving its own working version, ver, to the library. Every program that uses the ELF library must coordinate versions as described below. The header <libelf.h> supplies the version to the program with the macro EV_CURRENT. If the library's internal version (the highest version known to the library) is lower than that known by the program itself, the library may lack semantic knowledge assumed by the program. Accordingly, elf_version() will not accept a working version unknown to the library. Passing ver equal to EV_NONE causes elf_version() to return the library's internal version, without altering the working version. If ver is a version known to the library, elf_version() returns the previous (or initial) working version number. Otherwise, the working version remains unchanged and elf_version() returns EV_NONE. EXAMPLES
Example 1: A sample display of using the elf_version() function. The following excerpt from an application program protects itself from using an older library: if (elf_version(EV_CURRENT) == EV_NONE) { /* library out of date */ /* recover from error */ } ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Stable | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
elf(3ELF), elf32_xlatetof(3ELF), elf_begin(3ELF), libelf(3LIB), attributes(5) NOTES
The working version should be the same for all operations on a particular ELF descriptor. Changing the version between operations on a descriptor will probably not give the expected results. SunOS 5.10 11 Jul 2001 elf_version(3ELF)
Man Page