ELFEND(3E)                                                        ELFEND(3E)



NAME
     elfend - finish using an object file

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

     #include <libelf.h>

     int elfend(Elf *elf);


DESCRIPTION

     A program uses elfend 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 elfbegin; 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

     elfupdate before calling elfend.


     As elfbegin(3E) explains, a descriptor can have more than one

     activation.  Calling elfend 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

     elf(3E), elfbegin(3E), elfupdate(3E).





























                                                                        Page 1