elf_strptr(3ELF)					       ELF Library Functions						  elf_strptr(3ELF)

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

       The  elf_strptr()  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

       Example 1: A sample program of calling elf_strptr() function.

       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'
", name? name: "(null)");
       }

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Stable			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       elf(3ELF), elf32_getshdr(3ELF), elf32_xlatetof(3ELF), elf_getdata(3ELF), libelf(3LIB), attributes(5)

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.10							    11 Jul 2001 						  elf_strptr(3ELF)