.TH ELF32_OFFSCN 3 2024-07-18 "Libelf" "Libelf Programmer's Manual"

.SH NAME
elf32_offscn \- retrieve a section descriptor by file offset for a 32-bit ELF file

.SH SYNOPSIS
.B #include <libelf.h>

.BI "Elf_Scn *elf32_offscn(Elf *" elf ", off_t " offset ");"

.SH DESCRIPTION
The
.B elf32_offscn
function retrieves the section descriptor for the non-empty section at the specified file offset in the ELF32 object referred to by
.I elf.

.SH PARAMETERS
.TP
.I elf
An
.I Elf pointer to the ELF object from which the section descriptor is to be retrieved.

.TP
.I offset
An
.I off_t
value representing the file offset of the section whose descriptor is to be retrieved.

.SH RETURN VALUE
The
.B elf32_offscn
function returns a pointer to the
.I Elf_Scn
of the non-empty section with a sh_offset matching
.I offset.
If an error occurs, it returns NULL and sets an appropriate libelf error code.

.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
.TS
allbox;
lbx lb lb
l l l.
Interface	Attribute	Value
T{
.na
.nh
.BR elf32_offscn ()
T}	Thread safety	MT-Safe
.TE

.SH SEE ALSO
.BR elf64_offscn (3),
.BR libelf (3),
.BR elf (5),

.SH REPORTING BUGS
Report bugs to <elfutils-devel@sourceware.org> or https://sourceware.org/bugzilla/.

.SH HISTORY
.B elf32_offscn
first appeared in elfutils 0.112. This elfutils libelf function may not be found in other libelf implementations.