Проект OpenNet: MAN elf_next (3) Библиотечные вызовы (FreeBSD и Linux)

Интерактивная система просмотра системных руководств (man-ов)

elf_next (3)

>> elf_next (3) ( FreeBSD man: Библиотечные вызовы )

BSD mandoc

NAME

elf_next

 - provide sequential access to the next archive member

LIBRARY

Lb libelf

SYNOPSIS

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

DESCRIPTION

The elf_next ();
function causes the ELF archive descriptor corresponding to argument elf to be adjusted to provide access to the next member in the archive on a subsequent call to elf_begin (.);

The return value of elf_next ();
is suitable for use in a loop invoking elf_begin (.);

RETURN VALUES

If successful, function elf_next ();
returns the value ELF_C_READ Otherwise, if argument elf was not associated with an archive, or if it was NULL or if any other error occurred, the value ELF_C_NULL is returned.

EXAMPLES

To process all the members of an archive use:

Elf_Cmd cmd;
Elf *archive, *e;
...
cmd = ELF_C_READ;
archive = elf_begin(fd, cmd, NULL);
while ((e = elf_begin(fd, cmd, archive)) != (Elf *) 0)
{
        ... process `e' here ...

        cmd = elf_next(e);
        elf_end(e);
}
elf_end(archive);