ELF_GETARHDR(3) BSD Library Functions Manual ELF_GETARHDR(3)NAMEelf_getarhdr — retrieve ar(1) header for an archive member
LIBRARY
library “libelf”
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 char‐
acters 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 suc‐
cessful, 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 ALSOelf(3), elf_begin(3), elf_getarsym(3), elf_memory(3)BSD August 15, 2006 BSD
