ldshread(3X)                                         ldshread(3X)



NAME
     ldshread, ldnshread - read an indexed/named section header
     of an 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 sec-
     tion 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).














Page 1                        CX/UX Programmer's Reference Manual