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
Vt 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
Bq Er ELF_E_ARGUMENT
Argument
elf
was NULL
Bq Er ELF_E_ARGUMENT
Argument
elf
was not a descriptor for an ELF object.
Bq Er ELF_E_ARGUMENT
Argument
scndx
was not the section index for a string table.
Bq Er ELF_E_ARGUMENT
Argument
stroffset
exceeeded the size of the string table.
Bq Er ELF_E_ARGUMENT
Argument
stroffset
index an unallocated region of the string table.
Bq Er ELF_E_DATA
Offset
stroffset
indexed a region that was not covered by any Elf_Data
descriptor.
Bq Er ELF_E_DATA
An erroneous
Vt Elf_Data
descriptor was part of the section specified by argument
scndx
Bq Er ELF_E_HEADER
ELF descriptor
elf
contained an invalid section header.
Bq Er ELF_E_RESOURCE
An out of memory condition was detected.
Bq Er ELF_E_SECTION
Section
scndx
contained a malformed section header.
Bq Er ELF_E_SECTION
The ELF descriptor in argument
elf
did not adhere to the conventions used for extended numbering.