Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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 pres-
     ence of multiple Elf_Data descriptors covering the	contents of the	sec-
     tion.

     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 exceeded the size of the string ta-
		       ble.

     [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	sec-
		       tion 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

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=elf_strptr&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help