Minix Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help 
ELF_STRPTR(3)            BSD Library Functions Manual            ELF_STRPTR(3)

NAME
     elf_strptr -- retrieve a string pointer in a string table

LIBRARY
     ELF Access Library (libelf, -lelf)

SYNOPSIS
     #include <libelf.h>

     char *
     elf_strptr(Elf *elf, size_t scndx, size_t stroffset);

DESCRIPTION
     Function elf_strptr() allows an application to convert a string table
     offset to a string pointer, correctly translating the offset in the
     presence of multiple Elf_Data descriptors covering the contents of the
     section.

     Argument elf is a descriptor for an ELF object.  Argument scndx is the
     section index for an ELF string table.  Argument stroffset is the index
     of the desired string in the string table.

RETURN VALUES
     Function elf_strptr() returns a valid pointer on success or NULL in case
     an error was encountered.

ERRORS
     [ELF_E_ARGUMENT]  Argument elf was NULL

     [ELF_E_ARGUMENT]  Argument elf was not a descriptor for an ELF object.

     [ELF_E_ARGUMENT]  Argument scndx was not the section index for a string
                       table.

     [ELF_E_ARGUMENT]  Argument stroffset exceeeded the size of the string
                       table.

     [ELF_E_ARGUMENT]  Argument stroffset index an unallocated region of the
                       string table.

     [ELF_E_DATA]      Offset stroffset indexed a region that was not covered
                       by any Elf_Data descriptor.

     [ELF_E_DATA]      An erroneous Elf_Data descriptor was part of the
                       section specified by argument scndx.

     [ELF_E_HEADER]    ELF descriptor elf contained an invalid section header.

     [ELF_E_RESOURCE]  An out of memory condition was detected.

     [ELF_E_SECTION]   Section scndx contained a malformed section header.

     [ELF_E_SECTION]   The ELF descriptor in argument elf did not adhere to
                       the conventions used for extended numbering.

SEE ALSO
     elf(3), elf32_getshdr(3), elf64_getshdr(3), elf_getdata(3),
     elf_rawdata(3), gelf(3), gelf_getshdr(3)

BSD                            December 16, 2006                           BSD
NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO