gelf_newphdr man page on FreeBSD

Man page or keyword search:  
man Server   9747 pages
apropos Keyword Search (all sections)
Output format
FreeBSD logo
[printable version]

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 descrip‐
     tor.  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 exist‐
     ing program header table already present in the ELF descriptor elf.  A
     value of zero for argument count may be used to delete an existing pro‐
     gram 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 descrip‐
		       tor 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
[top]

List of man pages available for FreeBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net