elf_getphdr(3E)                DG/UX R4.11MU05               elf_getphdr(3E)


NAME
       elfgetphdr: elf32getphdr, elf32newphdr - retrieve class-dependent
       program header table

SYNOPSIS
       cc [flag ...] file ...  -lelf [library ...]

       #include <libelf.h>
       Elf32Phdr *elf32getphdr(Elf *elf);
       Elf32Phdr *elf32newphdr(Elf *elf, sizet count);

DESCRIPTION
       For a 32-bit class file, elf32getphdr returns a pointer to the
       program execution header table, if one is available for the ELF
       descriptor elf.

       elf32newphdr allocates a new table with count entries, regardless of
       whether one existed previously, and sets the ELFFDIRTY bit for the
       table [see elfflag(3E)].  Specifying a zero count deletes an
       existing table.  Note this behavior differs from that of
       elf32newehdr [see elf32getehdr(3E)], allowing a program to replace
       or delete the program header table, changing its size if necessary.

       If no program header table exists, the file is not a 32-bit class
       file, an error occurs, or elf is null, both functions return a null
       pointer.  Additionally, elf32newphdr returns a null pointer if count
       is zero.

       The table is an array of Elf32Phdr structures, each of which
       includes the following members.

                    Elf32Word      ptype;
                    Elf32Off       poffset;
                    Elf32Addr      pvaddr;
                    Elf32Addr      ppaddr;
                    Elf32Word      pfilesz;
                    Elf32Word      pmemsz;
                    Elf32Word      pflags;
                    Elf32Word      palign;

       The ELF header's ephnum member tells how many entries the program
       header table has [see elfgetehdr(3E)].  A program may inspect this
       value to determine the size of an existing table; elf32newphdr
       automatically sets the member's value to count.  If the program is
       building a new file, it is responsible for creating the file's ELF
       header before creating the program header table.

SEE ALSO
       elf(3E), elfbegin(3E), elfflag(3E), elfgetehdr(3E).


Licensed material--property of copyright holder(s)