elf_getarhdr - Man Page

retrieve archive member header information

Synopsis

#include <libelf.h>

Elf_Arhdr *elf_getarhdr(Elf *elf);

Description

Return a Elf_Arhdr * describing the archive header of the archive member currently referred to by an ELF descriptor.

The Elf_Arhdr structure is defined as:

typedef struct {
  char *ar_name;                /* Name of archive member.  */
  time_t ar_date;               /* File date.  */
  uid_t ar_uid;                 /* User ID.  */
  gid_t ar_gid;                 /* Group ID.  */
  mode_t ar_mode;               /* File mode.  */
  int64_t ar_size;              /* File size.  */
  char *ar_rawname;             /* Original name of archive member.  */
} Elf_Arhdr;

Parameters

elf

An ELF descriptor referring to a member of an archive file.

Return Value

If elf refers to an archive member, elf_getarhdr() returns a pointer to its archive header. This pointer is valid until elf or the parent archive Elf descriptor are closed using elf_end(). If elf does not refer to an archive member or the header cannot be acquired then NULL is returned.

See Also

elf_begin(3), elf_getaroff(3), elf_next(3), elf_rand(3), libelf(3), elf(5)

Attributes

InterfaceAttributeValue
elf_getarhdr()Thread safetyMT-safe

Reporting Bugs

Report bugs to <elfutils-devel@sourceware.org> or https://sourceware.org/bugzilla/.

Referenced By

elf_getarsym(3).

2025-06-06 Libelf Programmer's Manual