ldshread(3x)               DG/UX 4.30                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).














     Licensed material--property of copyright holder(s)         Page 1