STCU(3X)                                                              STCU(3X)



NAME
     stcu - routines that provide a compilation unit symbol table interface

SYNOPSIS
     #include <syms.h>

     pCHDRR stcuinit(void);

     void stsetchdr(pCHDRR pchdr);

     pCHDRR stcurrentpchdr(void);

     void stfree(void);

     long stextadd(long iss, long value, long st, long sc, long index);

     pEXTR stpextiext(long iext);

     pEXTR stpextrndx(RNDXR rndx);

     long stiextmax(void);

     long stextstradd(char *str);

     char *ststrextiss(long iss);

     long stidnindexfext(long index, long fext);

     long stidnrndx(RNDXR rndx);

     pRNDXR stpdnidn(long idn);

     RNDXR strndxidn(long idn);

     void stsetidn(long idndest, long idnsrc);

DESCRIPTION
     The stcu routines provide an interface to objects that occur once per
     object rather than once per file descriptor (for example, external
     symbols, strings, and dense numbers).  The routines provide access to the
     current chdr (compile time hdr), which represents the symbol table in
     running processes with pointers to symbol table sections rather than
     indices and offsets used in the disk file representation.

     A new symbol table can be created with st_cuinit. This routine creates
     and initializes a CHDRR (see <cmplrs/stsupport.h>).  The CHDRR is the
     current chdr and is used in all later calls.  NOTE:  A chdr can also be
     created with the read routines (see stio(3x)).  The 2st_cuinit routine
     returns a pointer to the new CHDRR record.






                                                                        Page 1

STCU(3X)                                                              STCU(3X)



     st_currentchdr
             Returns a pointer to the current chdr.

     st_setchdr
             Sets the current chdr to the pchdr argument and sets the per file
             structures to reflect a change in symbol tables.

     st_free Frees all constituent structures associated with the current
             chdr.

     st_extadd
             Lets you add to the externals table. It returns the index to the
             new external for future reference and use. The ifd field for the
             external is filled in by the current file (see stfd.3).  For more
             details on the parameters, see <sym.h>.

     st_pext_iext

     and     st_pext_rndx Returns pointers to the external, given a index
             referencing them. The latter routine requires a relative index
             where the index field should be the index in external symbols and
             the rfd field should be the constant ST_EXTIFD.  NOTE:  The
             externals contain the same structure as symbols (see the SYMR and
             EXTR definitions).

     st_iextmax
             Returns the current number of entries in the external symbol
             table.

     The iss field in external symbols (the index into string space) must
     point into external string space.

     st_extstradd
             Adds a null-terminated string to the external string space and
             returns its index.

     st_str_extiss
             Converts that index into a pointer to the external string.

     The dense number table provides a convenience to the code optimizer,
     generator, and assembler. This table lets them reference symbols from
     different files and externals with unique densely packed numbers.

     st_idn_index_fext
             Returns a new dense number table index, given an index into the
             symbol table of the current file (or if fext is set, the
             externals table).

     st_idn_rndx
             Returns a new dense number, but expects a RNDXR (see <sym.h>) to
             specify both the file index and the symbol index rather than
             implying the file index from the current file.  The RNDXR



                                                                        Page 2

STCU(3X)                                                              STCU(3X)



             contains two fields: an index into the externals table and a file
             index (rsyms can point into the symbol table, as well). The file
             index is ST_EXTIFD (see <cmplrs/stsupport.h>) for externals.

     st_rndx_idn
             Returns a RNDX, given an index into the dense number table.

     st_pdn_idn
             Returns a pointer to the RNDXR index by the `idn' argument.

     The programs must be loaded with the object file access routine library
     libmld.a.

SEE ALSO
     stfe(3x), stfd(3x)








































                                                                        Page 3