STIO(3)             RISC/os Reference Manual              STIO(3)



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

SYNOPSIS
     #include <syms.h>

     long streadbinary (filename, how)
     char *filename;
     char how;

     long streadst (fn, how, filebase, pchdr, flags)
     long fn;
     char how;
     long filebase;
     pCHDRR pchdr;
     long flags;

     void stwritebinary (filename, flags)
     char *filename;
     long flags;

     void stwritest (fn, flags)
     long fn;
     long flags;

DESCRIPTION
     The CHDRR structure (see stcu(3)) 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 sym-
     bol table in from disk.

     St_readbinary takes the file name of the symbol table and
     assumes the symbol table header HDRR occurs at the beginning
     of the file. St_readst assumes that its file number refer-
     ences a file positioned at the beginning of the symbol table
     header and that the filebase 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 sec-
     tions when read in from disk and follows the standard pat-
     tern 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



                        Printed 11/19/92                   Page 1

STIO(3)             RISC/os Reference Manual              STIO(3)



     descriptors.  The flags argument is a bit mask that defines
     what other tables should be read. St_p* constants for each
     table 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. The value
     of pchdr can be gotten from st_current_pchdr (see stcu(3)).

     Line number entries are encoded on disk, and the read rou-
     tines 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.

     St_writebinary and st_writest are symmetric to the read rou-
     tines, 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 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) specif-
     ication.

     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.

AUTHOR Mark I. Himelstein
SEE ALSO
     stcu(3),stfe(3), stfd(3).
     The MIPS System Programmer Guide.














 Page 2                 Printed 11/19/92