| .\" Modified Thu Aug 17 2017 by Ben Woodard <woodard@redhat.com> |
| .\" |
| .TH ELF_GETDATA 3 2017-08-17 "Libelf" "Libelf Programmer's Manual" |
| .SH NAME |
| elf_getdata \- Get washed data of section |
| .nf |
| .SH SYNOPSIS |
| .B #include <libelf.h> |
| .sp |
| .BI "Elf_Data * elf_getdata (Elf_Scn *" scn ", Elf_Data *" data ");" |
| .fi |
| .SH DESCRIPTION |
| The |
| .BR elf_getdata () |
| function allows the user to retrieve the data buffers of the section |
| .I scn |
| . There can be more than one buffer if the user explicitly added them. |
| When a file is read the libelf library creates exactly one data buffer. |
| |
| The first buffer in the list can be obtained by passing a null pointer in the |
| parameter data. To get the next data buffer the previously returned value must |
| be passed in the data parameter. If there are no more buffer left in the list a |
| null pointer is returned. |
| |
| If the data parameter is not a null pointer it must be a descriptor for a |
| buffer associated with the section scn . If this is not the case a null pointer |
| is returned. To facilitate error handling elf_getdata also returns a null |
| pointer if the scn parameter is a null pointer. |