elf32_newphdr(3e) [hpux man page]

elf_getphdr(3E) 														   elf_getphdr(3E)

NAME

       elf32_getphdr,  elf32_newphdr,  elf64_getphdr,  elf64_newphdr  -  retrieve  class-dependent program header table for elf32 and elf64 files,
       respectively

SYNOPSIS

       [flag... ] file...  [library] ...

DESCRIPTION

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

       allocates a new table with count entries, regardless of whether one existed previously, and sets the bit for the table (see  elf_flag(3E)).
       Specifying  a  zero  count deletes an existing table.  Note this behavior differs from that of (see elf_getehdr(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, returns a null pointer if count is zero.

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

       The  ELF  header's  member  tells how many entries the program header table has (see elf_getehdr(3E)).  A program may inspect this value to
       determine the size of an existing table; 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.

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

       allocates  a  new  table with count entries, regardless of whether one existed previously, and sets the bit for the table (see Specifying a
       zero count deletes an existing table.  Note this behavior differs from that of (see elf_getehdr(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 64-bit class file, an error occurs, or elf is null, both functions return a null
       pointer.  Additionally, returns a null pointer if count is zero.

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

       The ELF header's e_phnum member tells how many entries the program header table has (see elf_getehdr(3E)).   A  program	may  inspect  this
       value  to  determine the size of an existing table; 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), elf_begin(3E), elf_flag(3E), elf_getehdr(3E).

																   elf_getphdr(3E)

elf32_getphdr(3ELF)					       ELF Library Functions					       elf32_getphdr(3ELF)

NAME

       elf32_getphdr, elf32_newphdr, elf64_getphdr, elf64_newphdr - retrieve class-dependent program header table

SYNOPSIS

       cc [ flag ... ] file... -lelf [ library ... ]
       #include <libelf.h>

       Elf32_Phdr *elf32_getphdr(Elf *elf);

       Elf32_Phdr *elf32_newphdr(Elf *elf, size_t count);

       Elf64_Phdr *elf64_getphdr(Elf *elf);

       Elf64_Phdr *elf64_newphdr(Elf *elf, size_t count);

DESCRIPTION

       For  a 32-bit class file, elf32_getphdr() returns a pointer to the program execution header table, if one is available for the ELF descrip-
       tor elf.

       elf32_newphdr() allocates a new table with count entries, regardless of whether one existed previously, and sets the  ELF_F_DIRTY  bit  for
       the  table.  See elf_flagdata(3ELF). Specifying a zero count deletes an existing table. Note this behavior differs from that of elf32_newe-
       hdr() allowing a program to replace or delete the program header table, changing its size if necessary.	See elf32_getehdr(3ELF).

       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, elf32_newphdr() returns a null pointer if count is 0.

       The table is an array of Elf32_Phdr structures, each of which includes the following members:

	 Elf32_Word	p_type;
	 Elf32_Off p_offset;
	 Elf32_Addr	p_vaddr;
	 Elf32_Addr	p_paddr;
	 Elf32_Word	p_filesz;
	 Elf32_Word	p_memsz;
	 Elf32_Word	p_flags;
	 Elf32_Word	p_align;

       The  Elf64_Phdr structures include the following members:

	 Elf64_Word	p_type;
	 Elf64_Word	p_flags;
	 Elf64_Off p_offset;
	 Elf64_Addr	p_vaddr;
	 Elf64_Addr	p_paddr;
	 Elf64_Xword	p_filesz;
	 Elf64_Xword	p_memsz;
	 Elf64_Xword	p_align;

       For the 64-bit class, replace 32 with 64 as appropriate.

       The  ELF  header's  e_phnum member tells how many entries the program header table has. See elf32_getehdr(3ELF). A program may inspect this
       value to determine the size of an existing table; elf32_newphdr() automatically sets the member's value to count. If the program is  build-
       ing a new file, it is responsible for creating the file's ELF header before creating the program header table.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Stable			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       elf(3ELF), elf32_getehdr(3ELF), elf_begin(3ELF), elf_flagdata(3ELF), libelf(3LIB), attributes(5)

SunOS 5.11							    11 Jul 2001 					       elf32_getphdr(3ELF)