ldgetpd(3x) [ultrix man page]

ldgetpd(3x)															       ldgetpd(3x)

Name
       ldgetpd - retrieve procedure descriptor given a procedure descriptor index

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

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

Description
       The  function  returns  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 following occurs:

       o    The procedure descriptor table cannot be found.

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

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

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

See Also
       ldclose(3x), ldopen(3x), ldtbseek(3x), ldtbread(3x), ldfcn(5)

								       RISC							       ldgetpd(3x)

ldgetaux(3x)															      ldgetaux(3x)

Name
       ldgetaux - retrieve an auxiliary entry, given an index

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

       pAUXU ldgetaux (ldptr, iaux)
       LDFILE ldptr;
       long iaux;

Description
       The  function  returns  a pointer to an auxiliary table entry associated with iaux.  The AUXU is contained in a static buffer.  Because the
       buffer can be overwritten by later calls to it must be copied by the caller if the aux is to be saved or changed.

       Note that auxiliary entries are not swapped as this routine  cannot  detect  what  manifestation  of  the  AUXU	union  is  retrieved.	If
       LDAUXSWAP(ldptr, ldf) is non-zero, a further call to swap_aux is required.  Before calling the swap_aux routine, the caller should copy the
       aux.

       If the auxiliary cannot be retrieved, returns null (defined in <stdio.h>) for an object file.  This occurs in the following instances:

       o    The auxiliary table cannot be found

       o    The iaux offset into the auxiliary table is beyond the end of the table

       Typically, is called immediately after a successful call to to retrieve the data type information associated with the  symbol  table  entry
       filled by The index field of the symbol, pSYMR, is the iaux when data type information is required. If the data type information for a sym-
       bol is not present, the index field is indexNi and should not be called.

See Also
       intro(3x), ldclose(3x), ldopen(3x), ldtbseek(3x), ldtbread(3x), ldfcn(5).

								       RISC							      ldgetaux(3x)