elf_rand(3) [freebsd 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(3ELF)					       ELF Library Functions						elf_getarsym(3ELF)

NAME

       elf_getarsym - retrieve archive symbol table

SYNOPSIS

       cc [ flag ... ] file ... -lelf [ library ... ]
       #include <libelf.h>

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

DESCRIPTION

       The  elf_getarsym()  function returns a pointer to the archive symbol table, if one is available for the ELF descriptor elf. Otherwise, the
       archive doesn't have a symbol table, an error occurred, or elf was null; elf_getarsym() then returns a null value. The symbol table  is	an
       array of structures that include the following members.

	 char *as_name;
	 size_t    as_off;
	 unsigned long	as_hash;

       These members have the following semantics:

       as_name	  A pointer to a null-terminated symbol name resides here.

       as_off	  This	value  is a byte offset from the beginning of the archive to the member's header. The archive member residing at the given
		  offset defines the associated symbol. Values in as_off may be passed as arguments to elf_rand(). See elf_begin(3ELF)	to  access
		  the desired archive member.

       as_hash	  This is a hash value for the name, as computed by elf_hash().

       If  ptr	is  non-null,  the library stores the number of table entries in the location to which ptr points. This value is set to 0 when the
       return value is NULL. The table's last entry, which is included in the count, has a null as_name, a zero value for  as_off,  and  ~0UL  for
       as_hash.

       The hash value returned is guaranteed not to be the bit pattern of all ones ( ~0UL).

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Stable			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       ar.h(3HEAD), elf(3ELF), elf_begin(3ELF), elf_getarhdr(3ELF), elf_hash(3ELF), libelf(3LIB), attributes(5)

SunOS 5.11							    11 Jul 2001 						elf_getarsym(3ELF)