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


   NAME
         elfstrptr - make a string pointer

   SYNOPSIS
         cc [flag ...] file ...  -lelf [library ...]

         #include <libelf.h>
         char *elfstrptr(Elf *elf, sizet section, sizet 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.  elfstrptr
         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
         SHTSTRTAB, 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 eshstrndx
         member.  The following code loops through the sections, printing
         their names.

              if ((ehdr = elf32getehdr(elf)) == 0)
              {
                      /* handle the error */
                      return;
              }
              ndx = ehdr->eshstrndx;
              scn = 0;
              while ((scn = elfnextscn(elf, scn)) != 0)
              {
                      char    *name = 0;
                      if ((shdr = elf32getshdr(scn)) != 0)
                        name = elfstrptr(elf, ndx, (sizet)shdr->shname);
                      printf("'%s'\n", name? name: "(null)");
              }

   SEE ALSO
         elf(3E), elfgetdata(3E), elfgetshdr(3E), elfxlate(3E).

   NOTE
         A program may call elfgetdata to retrieve an entire string table
         section.  For some applications, that would be both more efficient
         and more convenient than using elfstrptr.







   8/91                                                                 Page 1