STIO(3X)STIO(3X)NAMEstio - routines that provide a binary read/write interface to the MIPS
symbol table
SYNOPSIS
#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
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 ALSOstcu(3x), stfe(3x), stfd(3x)
Page 2
