elf_end(3E)                                                     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 ter-
     minates 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 activa-
     tion. Calling elfend() removes one activation and returns the remain-
     ing 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                       Reliant UNIX 5.44                Printed 11/98