HP-UX Reference (11i v2 03/08) - 3 Library Functions A-M (vol 6)

elf_next(3E) elf_next(3E)

NAME

elf_next - sequential archive member access

SYNOPSIS

cc [ﬂag... ] ﬁle...

-lelf [library ] ...

#include <libelf.h>

Elf_Cmd elf_next(Elf *elf);

DESCRIPTION

elf_next, elf_rand, and elf_begin manipulate simple object ﬁles 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 follow-

ing 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 ﬁle 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.