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

MT-LEVEL

Unsafe

DESCRIPTION

This function converts a string section offset to a string pointer.  elf identifies the file in which the string section resides, and section identifies 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. 

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. 

/∗ handle the error ∗/
if ((ehdr = elf32_getehdr(elf)) == 0) {
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), elf32_getshdr(3E), elf32_xlatetof(3E), elf_getdata(3E)

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(). 

SunOS 5.4  —  Last change: 22 Jan 1993