ELF_END(3E)							   ELF_END(3E)

NAME    [Toc]    [Back]

     elf_end - finish using an object file

SYNOPSIS    [Toc]    [Back]

     cc	[flag ...] file	...  -lelf [library ...]

     #include <libelf.h>

     int elf_end(Elf *elf);

DESCRIPTION    [Toc]    [Back]

     A program uses elf_end to terminate an ELF	descriptor, elf, and to
     deallocate	data associated	with the descriptor.  Until the	program
     terminates	a descriptor, the data remain allocated.  elf should be	a
     value previously returned by elf_begin; a null pointer is allowed as an
     argument, to simplify error handling.  If the program wishes to write
     data associated with the ELF descriptor to	the file, it must use
     elf_update	before calling elf_end.

     As	elf_begin(3E) explains,	a descriptor can have more than	one
     activation.  Calling elf_end removes one activation and returns the
     remaining activation count.  The library does not terminate the
     descriptor	until the activation count reaches zero.  Consequently,	a zero
     return value indicates the	ELF descriptor is no longer valid.

SEE ALSO    [Toc]    [Back]

     elf(3E), elf_begin(3E), elf_update(3E).


									PPPPaaaaggggeeee 1111