STIO(3X)							      STIO(3X)

NAME    [Toc]    [Back]

     stio - routines that provide a binary read/write interface	to the MIPS
     symbol table

SYNOPSIS    [Toc]    [Back]

     #include <syms.h>

     long st_readbinary(char *filename,	char how);

     long st_readst(long fn, char how, long fbase, pCHDRR pchdr, long flags);

     void st_writebinary(char *filename, long flags);

     void st_writest(long fn, long flags);

DESCRIPTION    [Toc]    [Back]

     The CHDRR structure (see <cmplrs/stsupport.h> and the stcu	manual page)
     represents	a symbol table in memory.  A new CHDRR can be created by
     reading a symbol table in from disk.  St_readbinary and st_readst read a
     symbol table in from disk.

     St_readbinary takes the file name of the symbol table and assumes the
     symbol table header (HDRR in <sym.h>) occurs at the beginning of the
     file. St_readst assumes that its file number references a file positioned
     at	the beginning of the symbol table header and that the fbase parameter
     specifies where the object	or symbol table	file is	based (for example,
     non-zero for archives).

     The second	parameter to the read routines can be `r' for read only	or `a'
     for appending to the symbol table.	Existing local symbol, line,
     procedure,	auxiliary, optimization, and local string tables can not be
     appended. If they didn't exist on disk, they can be created. This
     restriction stems from the	allocation algorithm for those symbol table
     sections when read	in from	disk and follows the standard pattern for
     building the symbol table.

     The symbol	table can be read incrementally.  If pchdr is zero, st_readst
     assumes that no symbol table has been read	yet; therefore,	it reads in
     the symbol	table header and file descriptors.  The	flags argument is a
     bit mask that defines what	other tables should be read. St_p* constants
     for each table, defined in	<cmplrs/stsupport.h>, can be ORed.  If flags
     equals `-1', all tables are read.	If pchdr is set, the tables specified
     by	flags are added	to the tables that have	already	been read.  Pchdr's
     value can be gotten from st_current_pchdr.	 See stcu(3).

     Line number entries are encoded on	disk, the read routines	expand them to
     longs.  See the MIPS System Programmer Guide.

     If	the version stamp is out of date, a warning message is issued to
     stderr.  If the magic number in the HDRR is incorrect, st_error is
     called.  All other	errors cause the read routines to read non-zero;
     otherwise,	a zero is returned.



									Page 1






STIO(3X)							      STIO(3X)



     St_writebinary and	st_writest are symmetric to the	read routines,
     excluding the how and pchdr parameters. The flags parameter is a bit mask
     that defines what table should be written.	St_p* constants	for each
     table, defined in <cmplrs/stsupport.h>, can be ORed. If flags equals `-
     1', all tables are	written.

     The write routines	write sections of the table in the approved order, as
     specified in the link editor (ld) specification.

     Line numbers are compressed on disk.  See the MIPS	System Programmer
     Guide.

     The write routines	start all sections of the symbol table on four-byte
     boundaries.

     If	the write routines encounter an	error, st_error	is called. After
     writing the symbol	table, further access to the table by other routines
     is	undefined.

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

SEE ALSO    [Toc]    [Back]

     stcu(3x), stfe(3x), stfd(3x)


									PPPPaaaaggggeeee 2222