|
|
HP-UX Reference > Eelf_cntl(3E)HP-UX 11i Version 2: December 2007 Update |
|
NAMEelf_cntl — control a file descriptor SYNOPSIScc [flag... ] file... -lelf [library] ... #include <libelf.h> int elf_cntl(Elf *elf, Elf_Cmd cmd); DESCRIPTIONelf_cntl instructs the library to modify its behavior with respect to an ELF descriptor, elf. As elf_begin(3E) describes, an ELF descriptor can have multiple activations, and multiple ELF descriptors may share a single file descriptor. Generally, elf_cntl commands apply to all activations of elf. Moreover, if the ELF descriptor is associated with an archive file, descriptors for members within the archive will also be affected as described below. Unless stated otherwise, operations on archive members do not affect the descriptor for the containing archive. The cmd argument tells what actions to take and may have the following values.
If elf_cntl succeeds, it returns zero. Otherwise, elf was null or an error occurred, and the function returns -1. NOTICESIf the program wishes to use the ``raw'' operations (see elf_rawdata, described in elf_getdata(3E), and elf_rawfile(3E)) after disabling the file descriptor with ELF_C_FDDONE or ELF_C_FDREAD, it must execute the raw operations explicitly beforehand. Otherwise, the raw file operations will fail. Calling elf_rawfile makes the entire image available, thus supporting subsequent elf_rawdata calls. |
|