elf_getphdr(3E)   MISC. REFERENCE MANUAL PAGES    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 previ-
     ously, 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 creat-
     ing the program header table.

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









                    Last change: ELF Library                    1