elf_next(3e) [hpux man page]

elf_next(3E)															      elf_next(3E)

NAME

       elf_next - sequential archive member access

SYNOPSIS

       [flag... ] file...  [library] ...

DESCRIPTION

       and manipulate simple object files and archives.  elf is an ELF descriptor previously returned from

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

SEE ALSO

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

																      elf_next(3E)

ELF_NEXT(3)						   BSD Library Functions Manual 					       ELF_NEXT(3)

NAME

     elf_next -- provide sequential access to the next archive member

LIBRARY

     ELF Access Library (libelf, -lelf)

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

ERRORS

     Function elf_next() may fail with the following error:

     [ELF_E_ARGUMENT]  Argument elf was not associated with a containing ar(1) archive.

SEE ALSO

     elf(3), elf_begin(3), elf_end(3), elf_rand(3)

BSD
								   June 17, 2006							       BSD