ELF_VERSION(3)

ELF_VERSION(3) | Library Functions Manual | ELF_VERSION(3)

# NAME

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 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 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 snippet:

    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)

November 9, 2011 | NetBSD 8.0