elf_getarhdr
—
retrieve ar(1) header for an archive member
ELF Access Library (libelf, -lelf)
#include
<libelf.h>
Elf_Arhdr *
elf_getarhdr
(
Elf
*elf);
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.
This function returns a valid pointer to an
Elf_Arhdr structure if successful, or NULL if
an error is encountered.
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.
elf(3),
elf_begin(3),
elf_getarsym(3),
elf_memory(3)