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_begin3,
and must be a descriptor for a member inside an
ar(1)
archive.
Structure
Vt Elf_Arhdr
includes the following members:
Vt char * ar_name
A pointer to a null terminated string containing the translated
name of the archive member.
Vt char * ar_rawname
A pointer to a null terminated string containing the untranslated
name for the archive member, including all
ar(1)
formatting characters and trailing white space.
Vt time_t ar_date
The timestamp associated with the member.
Vt uid_t ar_uid
The uid of the creator of the member.
Vt gid_t ar_gid
The gid of the creator of the member.
Vt mode_t ar_mode
The file mode of the member.
Vt size_t ar_size
The size of the member in bytes.
RETURN VALUES
This function returns a valid pointer to an
Vt Elf_Arhdr
structure if successful, or NULL if an error is encountered.
ERRORS
Function
elf_getarhdr ();
may fail with the following errors:
Bq Er ELF_E_ARGUMENT
Argument
elf
was NULL.
Bq Er ELF_E_ARGUMENT
Argument
elf
was not a descriptor for a member of an
ar(1)
archive.
