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.