LDSHREAD(3X)                         BSD                          LDSHREAD(3X)



NAME
     ldshread, ldnshread - read an indexed/named 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 one.

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

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