ldshread(S)                    6 January 1993                    ldshread(S)


 Name

    ldshread, ldnshread - read an indexed/named section header of a common
    object file

 Syntax


    cc  . . .  -lld


    #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

    The ldshread function reads the section header specified by sectindx of
    the common object file currently associated with ldptr into the area of
    memory beginning at secthead.

    The ldnshread function reads the section header specified by sectname
    into the area of memory beginning at secthead.

    The ldshread and ldnshread functions 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.

 See also

    ldfcn(FP), ldsseek(S)

 Standards conformance

    ldshread and ldnshread are not part of any currently supported standard;
    they are an extension of AT&T System V provided by the Santa Cruz Opera-
    tion.