LDSHREAD(3X)         INTERACTIVE UNIX System         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
               The ldshread function reads the section header specified by
               sectindx of the common object file currently associated with
               ldptr into the area of memory beginning at secthead.

               The ldnshread function reads the section header specified by
               sectname into the area of memory beginning at secthead.

               The ldshread and ldnshread functions 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 rou-
               tine library libld.a.

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













          Rev. C Software Development Set                            Page 1