ELF_GETSCN(3) | Library Functions Manual | ELF_GETSCN(3) |
elf_getscn
, elf_ndxscn
,
elf_newscn
, elf_nextscn
—
#include <libelf.h>
Elf_Scn *
elf_getscn
(Elf
*elf, size_t
index);
size_t
elf_ndxscn
(Elf_Scn
*scn);
Elf_Scn *
elf_newscn
(Elf
*elf);
Elf_Scn *
elf_nextscn
(Elf
*elf, Elf_Scn
*scn);
Function elf_getscn
() will return a
section descriptor for the section at index index in
the object denoted by ELF descriptor elf. An error
will be signalled if the specified section does not exist.
Function elf_ndxscn
() returns the section
table index associated with section descriptor
scn.
Function elf_newscn
() creates a new
section and appends it to the list of sections associated with descriptor
elf. The library will automatically increment the
e_shnum field of the ELF header associated with
descriptor elf, and will set the
ELF_F_DIRTY
flag on the returned section descriptor.
For ELF descriptors opened for writing, the ELF library will automatically
create an empty section at index zero (SHN_UNDEF
) on
the first call to elf_newscn
().
Function elf_nextscn
() takes a section
descriptor scn and returns a pointer to the section
descriptor at the next higher index. Argument scn is
allowed to be NULL, in which case this function will return a pointer to the
section descriptor at index 1. If no further sections are present, function
elf_nextscn
() will return a NULL pointer.
elf_getscn
(),
elf_newscn
() and elf_nextscn
()
return a valid pointer to a section descriptor if successful, or NULL if an
error occurs.
Function elf_ndxscn
() returns a valid
section table index if successful, or SHN_UNDEF
if
an error occurs.
ELF_E_ARGUMENT
]ELF_E_ARGUMENT
]ELF_E_ARGUMENT
]ELF_E_ARGUMENT
]ELF_E_CLASS
]ELF_E_SECTION
]SHN_UNDEF
not being of type
SHT_NULL
.October 22, 2007 | NetBSD 9.2 |