DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

elf_strptr(3elf)


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.

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

References

Intro(3elf), elf_getdata(3elf), elf_getshdr(3elf), elf_xlate(3elf)

Notices

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.
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004