ldshread(3X)                                         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
          fails if sectindx is greater than the number of sections in
          the object file; ldnshread fails if there is no section name
          corresponding with sectname.  Either function fails 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).














     Page 1                                        (last mod. 1/14/87)