elf_strptr(3E)                                        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.

       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
             elf(3E), elf_getdata(3E), elf_getshdr(3E), elf_xlate(3E)

       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.


                           Copyright 1994 Novell, Inc.               Page 1