ELF_OPEN(3)						   BSD Library Functions Manual 					       ELF_OPEN(3)

NAME

     elf_open -- open ELF objects and ar(1) archives

LIBRARY

     ELF Access Library (libelf, -lelf)

SYNOPSIS

     #include <libelf.h>

     Elf *
     elf_open(int fd);

     Elf *
     elf_openmemory(char *image, size_t sz);

DESCRIPTION

     Important: The functions elf_open() and elf_openmemory() are extensions to the ELF(3) API, for the internal use of the Elftoolchain project.
     Portable applications should not use these functions.

     The function elf_open() returns an Elf descriptor opened with mode ELF_C_READ for the ELF object or ar(1) archive referenced by the file
     descriptor in argument fd.

     The function elf_openmemory() returns an ELF descriptor opened with mode ELF_C_READ for the ELF object or ar(1) archive contained in the mem-
     ory area pointed to by the argument image.  The argument sz specifies the size of the memory area in bytes.

COMPATIBILITY

     These functions are non-standard extensions to the ELF(3) API set.

     The behavior of these functions differs from their counterparts elf_begin(3) and elf_memory(3) in that these functions will successfully open
     malformed ELF objects and ar(1) archives, returning an Elf descriptor of type ELF_K_NONE.

RETURN VALUES

     The function returns a pointer to a ELF descriptor if successful, or NULL if an error occurred.

ERRORS

     These functions can fail with the following errors:

     [ELF_E_ARGUMENT]  The argument fd was of an unsupported file type.

     [ELF_E_ARGUMENT]  The argument sz was zero, or the argument image was NULL.

     [ELF_E_IO]        The file descriptor in argument fd was invalid.

     [ELF_E_IO]        The file descriptor in argument fd could not be read.

     [ELF_E_RESOURCE]  An out of memory condition was encountered.

     [ELF_E_SEQUENCE]  Functions elf_open() or elf_openmemory() was called before a working version was established with elf_version(3).

SEE ALSO

     elf(3), elf_begin(3), elf_errno(3), elf_memory(3), gelf(3)

BSD
								   May 31, 2012 							       BSD