elf_end(3) [freebsd man page]

ELF_END(3)						   BSD Library Functions Manual 						ELF_END(3)

NAME

     elf_end -- release an ELF descriptor

LIBRARY

     ELF Access Library (libelf, -lelf)

SYNOPSIS

     #include <libelf.h>

     int
     elf_end(Elf *elf);

DESCRIPTION

     Function elf_end() is used to release the resources associated with an ELF descriptor pointed to by argument elf.	This descriptor must have
     been allocated by a previous call to elf_begin(3) or elf_memory(3).  For programming convenience, a NULL value is permitted for argument elf.

     A call to elf_end() decrements the activation count for descriptor elf by one.  The resources associated with the descriptor are only
     released with its activation count goes to zero.

     Once function elf_end() returns zero, the ELF descriptor elf will no longer be valid and should not be used further.

RETURN VALUES

     Function elf_end() returns the current value of the ELF descriptor elf's activation count, or zero if argument elf was NULL.

SEE ALSO

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

BSD
								   June 29, 2006							       BSD

ELF_CNTL(3)						   BSD Library Functions Manual 					       ELF_CNTL(3)

NAME

     elf_cntl -- control an elf file descriptor

LIBRARY

     ELF Access Library (libelf, -lelf)

SYNOPSIS

     #include <libelf.h>

     int
     elf_cntl(Elf *elf, Elf_Cmd cmd);

DESCRIPTION

     Function elf_cntl() controls the ELF library's subsequent use of the file descriptor used to create ELF descriptor elf.

     Argument cmd informs the library of the action to be taken:

     ELF_C_FDDONE  This value instructs the ELF library not to perform any further I/O on the file descriptor associated with argument elf.  For
		   ELF descriptors opened with mode ELF_C_WRITE or ELF_C_RDWR subsequent elf_update() operations on the descriptor will fail.

     ELF_C_FDREAD  This value instructs the ELF library to read in all necessary data associated with ELF descriptor elf into memory so that the
		   underlying file descriptor can be safely closed with command ELF_C_FDDONE.

     Argument elf must be an ELF descriptor associated with a file system object (e.g., an ar(1) archive, an ELF file, or other data file).

IMPLEMENTATION NOTES

     Due to use of mmap(2) internally, this function is a no-op for for ELF objects opened in ELF_C_READ mode.

RETURN VALUES

     Function elf_cntl() returns 0 on success, or -1 if an error was detected.

ERRORS

     [ELF_E_ARCHIVE]   Argument elf is a descriptor for an archive member.

     [ELF_E_ARGUMENT]  Argument elf was NULL.

     [ELF_E_ARGUMENT]  Argument cmd was not recognized.

     [ELF_E_MODE]      An ELF_C_FDREAD operation was requested on an ELF descriptor opened for writing.

SEE ALSO

     elf(3), elf_begin(3), elf_end(3), elf_next(3), elf_update(3), gelf(3)

BSD
								  August 9, 2006							       BSD