elf_next(3E)                   (ELF Library)                   elf_next(3E)


   NAME
         elfnext - sequential archive member access

   SYNOPSIS
         cc [flag ...] file ...  -lelf [library ...]

         #include <libelf.h>
         ElfCmd elfnext(Elf *elf);

   DESCRIPTION
         elfnext, elfrand, and elfbegin manipulate simple object files and
         archives.  elf is an ELF descriptor previously returned from
         elfbegin.

         elfnext provides sequential access to the next archive member.  That
         is, having an ELF descriptor, elf, associated with an archive member,
         elfnext prepares the containing archive to access the following
         member when the program calls elfbegin.  After successfully
         positioning an archive for the next member, elfnext returns the
         value ELFCREAD.  Otherwise, the open file was not an archive, elf
         was null, or an error occurred, and the return value is ELFCNULL.
         In either case, the return value may be passed as an argument to
         elfbegin, specifying the appropriate action.

   SEE ALSO
         elf(3E), elfbegin(3E), elfgetarsym(3E), elfrand(3E), ar(4).



























   7/91                                                                 Page 1