NAME

elf_getarhdr — retrieve ar(1) header for an archive member

SYNOPSIS

ELF Access Library (libelf, -lelf)
#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 characters 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)