Printed 1/15/91                   Page 1

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



NAME
     ldgetpd - retrieve procedure descriptor given a procedure
     descriptor index

SYNOPSIS
     #include <stdio.h>
     #include <filehdr.h>
     #include <sym.h>
     #include <ldfcn.h>

     long ldgetpd (ldptr, ipd, ppd)
     LDFILE ldptr;
     long ipd;
     pPDR ipd;

DESCRIPTION
     ldgetpd returns a SUCCESS or FAILURE depending on whether
     the procedure descriptor with index ipd can be accessed.  If
     it can be accessed, the structure pointed to by ppd is
     filled with the contents of the corresponding procedure
     descriptor.  The isym, iline, and iopt fields of the pro-
     cedure descriptor are updated to be used in further LD rou-
     tine calls. The adr field is updated from the symbol refer-
     enced by the isym field.

     The PDR cannot be retrieved when:

     ⊕ 8
        The procedure descriptor table cannot be found.

     ⊕ 8
        The ipd offset into the procedure descriptor table is
        beyond the end of the table.

     ⊕ 8
        The file descriptor that the ipd offset falls into cannot
        be found.


     Typically, ldgetpd is called while traversing the table that
     runs from 0 to SYMHEADER(ldptr).ipdMax - 1.

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

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







                         Printed 1/15/91                   Page 1