elf_getarsym(3E)                                           elf_getarsym(3E)

NAME
     elfgetarsym - retrieve archive symbol table

SYNOPSIS
     cc [flag ...] file ... -lelf [library ...]

     #include <libelf.h>

     ElfArsym *elfgetarsym(Elf *elf, sizet *ptr);

DESCRIPTION
     elfgetarsym() 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;
     elfgetarsym() then returns a null value. The symbol table is an array
     of structures that include the following members.

        char            *asname;
        sizet          asoff;
        unsigned long   ashash;

     These members have the following semantics:

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

     asoff
          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 asoff may be
          passed as arguments to elfrand() to access the desired archive
          member.

     ashash
          This is a hash value for the name, as computed by elfhash().

     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 zero when the
     return value is null. The table's last entry, which is included in the
     count, has a null asname, a zero value for asoff, and ~0UL for
     ashash.

SEE ALSO
     elf(3E), elfgetarhdr(3E), elfhash(3E), elfrand(3E), ar(4).











Page 1                       Reliant UNIX 5.44                Printed 11/98