elf_getscn(3E)															    elf_getscn(3E)

NAME

       elf_getscn(), elf_ndxscn(), elf_newscn(), elf_nextscn() - get section information for ELF files

SYNOPSIS

       Command: [flag]... file... [library]...

DESCRIPTION

       These functions provide indexed and sequential access to the sections associated with the ELF descriptor elf.  If the program is building a
       new file, it is responsible for creating the file's ELF header before creating sections; see elf_getehdr(3E).

       returns a section descriptor, given an index into the file's section header table.  Note the first "real" section has index 1.  Although  a
       program	can  get  a  section  descriptor  for the section whose index is 0 the undefined section), the section has no data and the section
       header is "empty" (though present).  If the specified section does not exist, an error occurs, or elf is null, returns a null pointer.

       creates a new section and appends it to the list for elf.  Because the section is required  and	not  "interesting"  to	applications,  the
       library	creates it automatically.  Thus the first call to for an ELF descriptor with no existing sections returns a descriptor for section
       1.  If an error occurs or elf is null, returns a null pointer.

       After creating a new section descriptor, the program can use to retrieve the newly  created,  "clean"  section  header.	 The  new  section
       descriptor  will have no associated data (see elf_getdata(3E)).	When creating a new section in this way, the library updates the member of
       the ELF header and sets the bit for the section (see elf_flag(3E)).  If the program is building a new file, it is responsible for  creating
       the file's ELF header (see elf_getehdr(3E)) before creating new sections.

       takes  an existing section descriptor, scn, and returns a section descriptor for the next higher section.  One may use a null scn to obtain
       a section descriptor for the section whose index is 1 (skipping the section whose index is If no further sections are present or  an  error
       occurs, returns a null pointer.

       takes an existing section descriptor, scn, and returns its section table index.	If scn is null or an error occurs, returns

EXAMPLES

       An example of sequential access appears below.  Each pass through the loop processes the next section in the file; the loop terminates when
       all sections have been processed.

	      scn = 0;
	      while ((scn = elf_nextscn(elf, scn)) != 0)
	      {
		      /* process section */
	      }

SEE ALSO

       elf(3E), elf_begin(3E), elf_flag(3E), elf_getdata(3E), elf_getehdr(3E), elf_getshdr(3E).

																    elf_getscn(3E)