Manual pages › ELF library (3E)
elf_strptr(3E)
make a string pointer
From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.
NAME
elf_strptr - make a string pointer
SYNOPSIS
cc [flag ...] file ... -lelf [library ...] #include <libelf.h> char *elf_strptr(Elf *elf, size_t section, size_t offset);
DESCRIPTION
This function converts a string section offset to a string pointer. elf identifies the file in which the string section resides, and section gives the section table index for the strings. elf_strptr normally returns a pointer to a string, but it returns a null pointer when elf is null, section is invalid or is not a section of type SHT_STRTAB, the section data cannot be obtained, offset is invalid, or an error occurs.
EXAMPLE
A prototype for retrieving section names appears below. The
file header specifies the section name string table in the
e_shstrndx member. The following code loops through the
sections, printing their names.
if ((ehdr = elf32_getehdr(elf)) == 0)
{
/* handle the error */
return;
}
ndx = ehdr->e_shstrndx;
scn = 0;
while ((scn = elf_nextscn(elf, scn)) != 0)
{
char *name = 0;
if ((shdr = elf32_getshdr(scn)) != 0)
name = elf_strptr(elf, ndx, (size_t)shdr->sh_name);
printf("'%s'\n", name? name: "(null)");
}
SEE ALSO
elf(3E), elf_getdata(3E), elf_getshdr(3E), elf_xlate(3E).
NOTE
A program may call elf_getdata to retrieve an entire string table section. For some applications, that would be both more efficient and more convenient than using elf_strptr.