elf_strptr(3E)                 DG/UX R4.11MU05                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.


Licensed material--property of copyright holder(s)