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).