ldgetpd(3X)

NAME
     ldgetpd - Retrieves 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 ppd;

DESCRIPTION
     This routine is available for o32 ABI programs only.

     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 procedure descriptor are updated to be used in further
     LD routine calls.  The adr field is updated from the symbol referenced
     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 routine library
     libmld.a.

SEE ALSO
     ldclose(3X), ldopen(3X), ldtbread(3X), ldtbseek(3X)

     ldfcn(4)