Printed 1/15/91                   Page 1

LDSHREAD(3X-SysV)   RISC/os Reference Manual    LDSHREAD(3X-SysV)



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 <syms.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.  If sec-
     tindx is greater than the number of sections in the object
     file, ldshread fails; If there is no section name
     corresponding with sectname, ldnshread fails.  If it cannot
     read the specified section header, either function fails.

     NOTE: The first section header has an index of one.

     The program must be loaded with the object file access rou-
     tine library libmld.a.

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













                         Printed 1/15/91                   Page 1