elf_rand(3) [netbsd man page]

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

ELF_GETARSYM(3) 					   BSD Library Functions Manual 					   ELF_GETARSYM(3)

NAME

     elf_getarsym -- retrieve the symbol table of an archive

LIBRARY

     ELF Access Library (libelf, -lelf)

SYNOPSIS

     #include <libelf.h>

     Elf_Arsym *
     elf_getarsym(Elf *elf, size_t *ptr);

DESCRIPTION

     The function elf_getarsym() retrieves the symbol table for an ar(1) archive, if one is available.

     Argument elf should be a descriptor for an ar(1) archive opened using elf_begin() or elf_memory().

     If the archive elf contains a symbol table with n entries, this function returns a pointer to an array of n+1 Elf_Arsym structures.  An
     Elf_Arsym structure has the following elements:
     char * as_name
	     This structure member is a pointer to a null-terminated symbol name.
     off_t as_off
	     This structure member contains the byte offset from the beginning of the archive to the header for the archive member.  This value is
	     suitable for use with elf_rand(3).
     unsigned long as_hash
	     This structure member contains a portable hash value for the symbol name, as computed by elf_hash(3).

     The last entry of the returned array will have a NULL value for member as_name, a zero value for member as_off and an illegal value of ~0UL
     for as_hash.

     If argument ptr is non-null, the elf_getarsym() function will store the number of table entries returned (including the sentinel entry at the
     end) into the location it points to.

RETURN VALUES

     Function elf_getarsym() returns a pointer to an array of Elf_Arsym structures if successful, or a NULL pointer if an error was encountered.

     If argument ptr is non-null and there was no error, the library will store the number of archive symbol entries returned into the location it
     points to.  If argument ptr is non-null and an error was encountered, the library will set the location pointed to by it to zero.

ERRORS

     Function elf_getarsym() may fail with the following errors:

     [ELF_E_ARGUMENT]  Argument elf was NULL.

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

SEE ALSO

     elf(3), elf_begin(3), elf_getarhdr(3), elf_hash(3), elf_memory(3), elf_next(3), elf_rand(3)

BSD
								  August 15, 2006							       BSD