elf_end(3E)       MISC. REFERENCE MANUAL PAGES        elf_end(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 sim-
     plify  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 descrip-
     tor is no longer valid.

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



























                    Last change: ELF Library                    1