elf_end(3E)               UNIX System V(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)




























10/89                                                                    Page 1