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.

     Programs using this routine must be loaded with the object
     file access library libld.a.

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














January 1992                                                    1