elf_end(3E)                    DG/UX 5.4R3.00                    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).































Licensed material--property of copyright holder(s)                         1