HP-UX Reference (11i v2 04/09) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

321

322

323

324

325

326

327

328

329

330

elf_strptr(3E) elf_strptr(3E)

NAME

elf_strptr - make a string pointer

SYNOPSIS

Invocation:

cc [ﬂag]... ﬁle...

-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 identiﬁes the ﬁle in which the string

section resides, and section gives the section table index for the strings.

Notes

A program may call

elf_getdata()

to retrieve an entire string table section. For some applications,

that would be both more efﬁcient and more convenient than using

elf_strptr().

RETURN VALUE

elf_strptr() normally returns a pointer to a string, but it returns a null pointer when elf is null, sec-

tion 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 ﬁle header speciﬁes 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)");

}