ldshread(3X)                      SDK R4.11                     ldshread(3X)


NAME
       ldshread, ldnshread - read an indexednamed section header of a common
       object file

SYNOPSIS
       #include <stdio.h>
       #include <filehdr.h>
       #include <scnhdr.h>
       #include <ldfcn.h>

       int ldshread (ldptr, sectindx, secthead)
       LDFILE *ldptr;
       unsigned short sectindx;
       SCNHDR *secthead;

       int ldnshread (ldptr, sectname, secthead)
       LDFILE *ldptr;
       char *sectname;
       SCNHDR *secthead;

DESCRIPTION
       Ldshread reads the section header specified by sectindx of the common
       object file currently associated with ldptr into the area of memory
       beginning at secthead.

       Ldnshread reads the section header specified by sectname into the
       area of memory beginning at secthead.

       Ldshread and ldnshread return SUCCESS or FAILURE.  Ldshread will fail
       if sectindx is greater than the number of sections in the object
       file; ldnshread will fail if there is no section name corresponding
       with sectname.  Either function will fail if it cannot read the
       specified section header.

       Note that the first section header has an index of 1.

       The program must be loaded with the object file access routine
       library libld.a.


SEE ALSO
       ldclose(3X), ldopen(3X), ldfcn(4).


Licensed material--property of copyright holder(s)