elf_getehdr(3E)                (ELF Library)                elf_getehdr(3E)


   NAME
         elf_getehdr: elf32_getehdr, elf32_newehdr - retrieve class-dependent
         object file header

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

         #include <libelf.h>
         Elf32_Ehdr *elf32_getehdr(Elf *elf);
         Elf32_Ehdr *elf32_newehdr(Elf *elf);

   DESCRIPTION
         For a 32-bit class file, elf32_getehdr returns a pointer to an ELF
         header, if one is available for the ELF descriptor elf.  If no header
         exists for the descriptor, elf32_newehdr allocates a ``clean'' one,
         but it otherwise behaves the same as elf32_getehdr.  It does not
         allocate a new header if one exists already.  If no header exists
         (for elf_getehdr), one cannot be created (for elf_newehdr), a system
         error occurs, the file is not a 32-bit class file, or elf is null,
         both functions return a null pointer.

         The header includes the following members.

                      unsigned char   e_ident[EI_NIDENT];
                      Elf32_Half      e_type;
                      Elf32_Half      e_machine;
                      Elf32_Word      e_version;
                      Elf32_Addr      e_entry;
                      Elf32_Off       e_phoff;
                      Elf32_Off       e_shoff;
                      Elf32_Word      e_flags;
                      Elf32_Half      e_ehsize;
                      Elf32_Half      e_phentsize;
                      Elf32_Half      e_phnum;
                      Elf32_Half      e_shentsize;
                      Elf32_Half      e_shnum;
                      Elf32_Half      e_shstrndx;

         elf32_newehdr automatically sets the ELF_F_DIRTY bit [see
         elf_flag(3E)].  A program may use elf_getident to inspect the
         identification bytes from a file.

   SEE ALSO
         elf(3E), elf_begin(3E), elf_flag(3E), elf_getident(3E).









   7/91                                                                 Page 1