elf_end(3E)                    (ELF Library)                    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 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).



























   8/91                                                                 Page 1