ldrseek(S)                     6 January 1993                     ldrseek(S)


 Name

    ldrseek, ldnrseek - seek to relocation entries of a section of a common
    object file

 Syntax


    cc  . . .  -lld


    #include  <filehdr.h>
    #include  <ldfcn.h>

    int ldrseek (ldptr, sectindx)
    LDFILE *ldptr;
    unsigned short sectindx;

    int ldnrseek (ldptr, sectname)
    LDFILE *ldptr;
    char *sectname;


 Description

    The ldrseek function seeks to the relocation entries of the section
    specified by sectindx of the common object file currently associated with
    ldptr.

    The ldnrseek function seeks to the relocation entries of the section
    specified by sectname.

    The ldrseek and ldnrseek functions return SUCCESS or FAILURE.  ldrseek
    fails if sectindx is greater than the number of sections in the object
    file; ldnrseek fails if there is no section name corresponding with
    sectname.  Either function fails if the specified section has no reloca-
    tion entries or if it cannot seek to the specified relocation entries.

    Note that the first section has an index of one.

 See also

    ldfcn(FP), ldshread(S), ldsseek(S)

 Standards conformance

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