elf_getarsym(3E)          UNIX System V(ELF Library)           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)















10/89                                                                    Page 1