elf_getehdr(3E)                                      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.

       REFERENCES
             elf(3E), elf_begin(3E), elf_flag(3E), elf_getident(3E)




                           Copyright 1994 Novell, Inc.               Page 1