👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

NetBSD 6.1.5 - man page for elf32_newphdr (netbsd section 3)

GELF_NEWPHDR(3) 		   BSD Library Functions Manual 		  GELF_NEWPHDR(3)

NAME
     elf32_newphdr, elf64_newphdr, gelf_newphdr -- allocate an ELF program header table

LIBRARY
     library ``libelf''

SYNOPSIS
     #include <libelf.h>

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

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

     #include <gelf.h>

     void *
     gelf_newphdr(Elf *elf, size_t count);

DESCRIPTION
     These functions allocate an ELF Program Header table for an ELF descriptor.  Elf32_Phdr and
     Elf64_Phdr descriptors are described further in elf(5).

     Functions elf32_newphdr() and elf64_newphdr() allocate a table of count Elf32_Phdr and
     Elf64_Phdr descriptors respectively, discarding any existing program header table already
     present in the ELF descriptor elf.  A value of zero for argument count may be used to delete
     an existing program header table from an ELF descriptor.

     Function gelf_newphdr() will return a table of Elf32_Phdr or Elf64_Phdr with count elements
     depending on the ELF class of ELF descriptor elf.

     The functions set the ELF_F_DIRTY flag on the program header table.  All members of the
     returned array of Phdr structures will be initialized to zero.

     After a successful call to these functions, the pointer returned by a prior call to
     elf32_getphdr() or elf64_getphdr() on the same descriptor elf will no longer be valid.

RETURN VALUES
     The functions a valid pointer if successful, or NULL in case an error was encountered.

ERRORS
     These functions may fail with the following errors:

     [ELF_E_ARGUMENT]  Argument elf was NULL.

     [ELF_E_ARGUMENT]  Argument elf was not a descriptor for an ELF object.

     [ELF_E_CLASS]     ELF descriptor elf was of an unrecognized class.

     [ELF_E_RESOURCE]  An out of memory condition was detected.

     [ELF_E_SEQUENCE]  An executable header was not allocated for ELF descriptor elf before using
		       these APIs.

SEE ALSO
     elf(3), elf32_getphdr(3), elf32_newehdr(3), elf64_getphdr(3), elf64_newehdr(3),
     elf_flagphdr(3), elf_getphnum(3), gelf(3), gelf_getphdr(3), gelf_newehdr(3), elf(5)

BSD					 October 22, 2007				      BSD


All times are GMT -4. The time now is 11:08 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password