elf_getarhdr.3e (2010 09)

elf_getarhdr(3E) elf_getarhdr(3E)

NAME

elf_getarhdr - retrieve archive member header

SYNOPSIS

cc [ﬂag... ] ﬁle...

-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 descrip-

tor 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;

long ar_uid;

long ar_gid;

unsigned long 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_rawname member holds a null-terminated string that represents

the original name bytes in the ﬁle, including the terminating slash and trailing blanks as speciﬁed in the

archive format.

In addition to ‘‘regular’’ archive members, the archive format deﬁnes 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) deﬁned below.

/ This is the archive symbol table. If present, it will be the ﬁrst 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 (3E)).

// 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 ﬁle 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.

PAGE 1
elf_getarhdr(3E) elf_getarhdr(3E) NAME elf_getarhdr - retrieve archive member header SYNOPSIS cc [flag... ] file ... -lelf [library ] ... #include 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.
PAGE 2
(Notes) A (Notes) eA 2 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010