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_RAND(3)						   BSD Library Functions Manual 					       ELF_RAND(3)

NAME

     elf_rand -- provide sequential access to the next archive member

LIBRARY

     ELF Access Library (libelf, -lelf)

SYNOPSIS

     #include <libelf.h>

     off_t
     elf_rand(Elf *archive, off_t offset);

DESCRIPTION

     The elf_rand() function causes the ELF descriptor archive to be adjusted so that the next call to elf_begin(3) will provide access to the ar-
     chive member at byte offset offset in the archive.  Argument offset is the byte offset from the start of the archive to the beginning of the
     archive header for the desired member.

     Archive member offsets may be retrieved using the elf_getarsym(3) function.

RETURN VALUES

     Function elf_rand() returns offset if successful or zero in case of an error.

EXAMPLES

     To process all the members of an archive use:

	   off_t off;
	   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 ...
		   elf_end(e);

		   off = ...new value...;
		   if (elf_rand(archive, off) != off) {
			   ... process error ...
		   }
	   }
	   elf_end(archive);

     To rewind an archive, use:

	   Elf *archive;
	   ...
	   if (elf_rand(archive, SARMAG) != SARMAG) {
		   ... error ...
	   }

ERRORS

     Function elf_rand() may fail with the following errors:

     [ELF_E_ARGUMENT]  Argument archive was null.

     [ELF_E_ARGUMENT]  Argument archive was not a descriptor for an ar(1) archive.

     [ELF_E_ARCHIVE]   Argument offset did not correspond to the start of an archive member header.

SEE ALSO

     ar(1), elf(3), elf_begin(3), elf_end(3), elf_getarsym(3), elf_next(3), gelf(3)

BSD
								   June 17, 2006							       BSD