ldgetaux(3x) [ultrix man page]

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)

staux(3)						     Library Functions Manual							  staux(3)

Name
       st_auxbtadd,  st_auxbtsize, st_auxisymadd, st_auxrndxadd, st_auxrndxadd, st_addtq, st_tqhigh_aux, st_shifttq, st_iaux_copyty, st_changeaux,
       st_changeauxrndx  - routines that provide scalar interfaces to auxiliaries

Syntax
       #include <syms.h>

       long st_auxbtadd(bt)
       long bt;

       long st_auxbtsize(iaux,width)
       long iaux;
       long width;

       long st_auxisymadd (isym)
       long isym;

       long st_auxrndxadd (rfd,index)
       long rfd;
       long index;

       long st_auxrndxadd (idn)
       long idn;

       void st_addtq (iaux,tq)
       long iaux;
       long tq;

       long st_tqhigh_aux(iaux)
       long iaux;

       void st_shifttq (iaux, tq)
       int iaux;
       int tq;

       long st_iaux_copyty (ifd, psym)
       long ifd;
       pSYMR psym;

       void st_changeaux (iaux, aux)
       long iaux;
       AUXU aux;

       void st_changeauxrndx (iaux, rfd, index)
       long iaux;
       long rfd;
       long index;

Description
       Auxiliary entries are unions with a fixed length of four bytes per entry.  Much information is packed within the auxiliaries.  Rather  than
       have the compiler front-ends handle each type of auxiliary entry directly, the following set of routines provide a high-level scalar inter-
       face to the auxiliaries:

       st_auxbtadd	   Adds a type information record (TIR) to the auxiliaries.  It sets the basic type (bt) to the  argument  and	all  other
			   fields to zero. The index to this auxiliary entry is returned.

       st_auxbtsize	   Sets the bit in the TIR, pointed to by the iaux argument.  This argument says the basic type is a bit field and adds an
			   auxiliary with its width in bits.

       st_auxisymadd	   Adds an index into the symbol table (or any other scalar) to the auxiliaries.  It sets the value to the  argument  that
			   will occupy all four bytes. The index to this auxiliary entry is returned.

       st_auxrndxadd	   Adds  a relative index, RNDXR, to the auxiliaries.  It sets the rfd and index to their respective arguments.  The index
			   to this auxiliary entry is returned.

       st_auxrndxadd_idn   Works the same as st_auxrndxadd except that RNDXR is referenced by an index into the dense number table.

       st_iaux_copyty	   Copies the type from the specified file (ifd) for the specified symbol into the auxiliary table for the  current  file.
			   It returns the index to the new aux.

       st_shifttq	   Shifts  in the specified type qualifier, tq (see sym.h), into the auxiliary entry TIR, which is specified by the `iaux'
			   index into the current file. The current type qualifiers shift up one tq so that the first tq (tq0) is free for the new
			   entry.

       st_addtq 	   Adds a type qualifier in the highest or most significant non-tqNil type qualifier.

       st_tqhigh_iaux	   Returns the most significant type qualifier given an index into the files aux table.

       st_changeaux	   Changes the iauxth aux in the current file's auxiliary table to aux.

       st_changeauxrndx    Converts the relative index (RNDXR) auxiliary, which is specified by iaux, to the specified arguments.

See Also
       stfd(3)

								       RISC								  staux(3)