NAME
elf_strptr — make a string pointer
SYNOPSIS
Invocation:
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.
Notes
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().
RETURN VALUE
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.
EXAMPLES
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)");
}