elf_getident3
Return the initial bytes of a file
Usage
#include <libelf.h>
char *
elf_getident(Elf *elf, size_t *sz);
Library
library “libelf”
Overview
Function elf_getident() returns a pointer to the initial bytes of the file for descriptor elf.
If argument sz is non-null, the size of the identification area returned is written to the location pointed to by sz. This location is set to zero on errors.
Return values
Function elf_getident() will return a non-NULL pointer to the initial bytes of the file if successful, or NULL if an error condition is detected.
Errors
Function elf_getident() can fail with the following errors:
- [ELF_E_ARGUMENT]
-
A NULL value was passed in for argument elf.
- [ELF_E_SEQUENCE]
-
ELF descriptor elf was opened for writing and function
elf_getident() was called before a call to elf_update(3).
Releases
44 releases since FreeBSD 7.0-RELEASE; the text changed 20 times.