ldgetpd(3X)             LIBRARY FUNCTIONS             ldgetpd(3X)



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:


     ⊕       The procedure descriptor table cannot be found.

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

     ⊕       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).









                                                                1