elf_getarhdr(3ELF)					       ELF Library Functions						elf_getarhdr(3ELF)

NAME

       elf_getarhdr - retrieve archive member header

SYNOPSIS

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

       Elf_Arhdr *elf_getarhdr(Elf *elf);

DESCRIPTION

       elf_getarhdr()  returns a pointer to an archive member header, if one is available for the ELF descriptor elf. Otherwise, no archive member
       header exists, an error occurred, or elf was null; elf_getarhdr() then returns a null value. The header includes the following members.

	 char *ar_name;
	 time_t    ar_date;
	 uid_t	   ar_uid;
	 gid_t	   ar_gid;
	 mode_t    ar_mode;
	 off_t	   ar_size;
	 char *ar_rawname;

       An archive member name, available through ar_name, is a null-terminated string, with the ar format control characters removed. The  ar_raw-
       name  member holds a null-terminated string that represents the original name bytes in the file, including the terminating slash and trail-
       ing blanks as specified in the archive format.

       In addition to ``regular'' archive members, the archive format defines some special members. All special member names begin  with  a  slash
       (/), distinguishing them from regular members (whose names may not contain a slash). These special members have the names (ar_name) defined
       below.

       /     This is the archive symbol table. If present, it will be the first archive member. A program may  access  the  archive  symbol  table
	     through  elf_getarsym().  The  information  in  the  symbol  table  is  useful  for  random  archive  processing  (see  elf_rand() on
	     elf_begin(3ELF)).

       //    This member, if present, holds a string table for long archive member names. An archive member's header contains a 16-byte  area  for
	     the  name,  which	may be exceeded in some file systems. The library automatically retrieves long member names from the string table,
	     setting ar_name to the appropriate value.

       Under some error conditions, a member's name might not be available. Although this causes the library to set ar_name to a null pointer, the
       ar_rawname member will be set as usual.

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_getarsym(3ELF), libelf(3LIB), attributes(5)

SunOS 5.11							    11 Jul 2001 						elf_getarhdr(3ELF)