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


   NAME
         elf_next - sequential archive member access

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

         #include <libelf.h>
         Elf_Cmd elf_next(Elf *elf);

   DESCRIPTION
         elf_next, elf_rand, and elf_begin manipulate simple object files and
         archives.  elf is an ELF descriptor previously returned from
         elf_begin.

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

   SEE ALSO
         elf(3E), elf_begin(3E), elf_getarsym(3E), elf_rand(3E), ar(4).



























   7/91                                                                 Page 1