freebsd man page for elf_getarhdr

ELF_GETARHDR(3) 					   BSD Library Functions Manual 					   ELF_GETARHDR(3)

NAME
     elf_getarhdr -- retrieve ar(1) header for an archive member

LIBRARY
     ELF Access Library (libelf, -lelf)

SYNOPSIS
     #include <libelf.h>

     Elf_Arhdr *
     elf_getarhdr(Elf *elf);

DESCRIPTION
     The elf_getarhdr() function returns a pointer to an archive member header for a descriptor elf.  This descriptor must have been returned by a
     prior call to elf_begin(3), and must be a descriptor for a member inside an ar(1) archive.

     Structure Elf_Arhdr includes the following members:

     char * ar_name
	     A pointer to a null terminated string containing the translated name of the archive member.

     char * ar_rawname
	     A pointer to a null terminated string containing the untranslated name for the archive member, including all ar(1) formatting charac-
	     ters and trailing white space.

     time_t ar_date
	     The timestamp associated with the member.

     uid_t ar_uid
	     The uid of the creator of the member.

     gid_t ar_gid
	     The gid of the creator of the member.

     mode_t ar_mode
	     The file mode of the member.

     size_t ar_size
	     The size of the member in bytes.

RETURN VALUES
     This function returns a valid pointer to an Elf_Arhdr structure if successful, or NULL if an error is encountered.

ERRORS
     Function elf_getarhdr() may fail with the following errors:

     [ELF_E_ARGUMENT]  Argument elf was NULL.

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

SEE ALSO
     elf(3), elf_begin(3), elf_getarsym(3), elf_memory(3)

BSD
								  August 15, 2006							       BSD