elf_strptr(3E)                 (ELF Library)                 elf_strptr(3E)


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

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

   SEE ALSO
         elf(3E), elf_getdata(3E), elf_getshdr(3E), elf_xlate(3E).

   NOTE
         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.







   7/91                                                                 Page 1