*** UNIX MANUAL PAGE BROWSER ***

ldgetaux(3) Library Functions Manual ldgetaux(3) NAME ldgetaux - Retrieves an auxiliary entry SYNOPSIS #include <stdio.h> #include <filehdr.h> #include <sym.h> #include <ld- fcn.h> pAUXU ldgetaux (ldptr, iaux ) LDFILE ldptr ; long iaux ; DESCRIPTION The ldgetaux routine returns a pointer to the auxiliary table entry (AUXU) indexed by iaux. The entry is contained in a static buffer. Because the buffer can be overwritten by later calls to ldgetaux, the entry must be copied by the caller if it is to be saved or changed. Note that auxiliary table entries are not swapped. If LDAUXSWAP(ldptr,ldf) is non-zero, a further call to swap_aux is re- quired. Before calling the swap_aux routine, the caller should copy the entry. If the auxiliary table entry cannot be retrieved, ldgetaux returns NULL. This occurs when: The auxiliary table cannot be found The iaux offset into the auxiliary table is beyond the end of the table The ltdbread routine returns a local symbol (SYMR) structure that may contain an index into the auxiliary table. If so, ldgetaux can be called with this index to retrieve data type information for the local symbol. If the data type information for a symbol is not present, ld- getaux should not be called. The program must be loaded with the object file access routine library libmld.a. RELATED INFORMATION ldclose(3), ldopen(3), ldtbseek(3), ldtbread(3), ldfcn(4) delim off ldgetaux(3)