st_writebinary(3) [ultrix man page]
stio(3) Library Functions Manual stio(3) Name st_readbinary, st_readst, st_writebinary, st_writest - routines that provide a binary read/write interface to the MIPS symbol table Syntax #include <syms.h> long st_readbinary (filename, how) char *filename; char how; long st_readst (fn, how, filebase, pchdr, flags) long fn; char how; long filebase; pCHDRR pchdr; long flags; void st_writebinary (filename, flags) char *filename; long flags; void st_writest (fn, flags) long fn; long flags; Description The CHDRR structure (see cmplrs/stsupport.h and the represents a symbol table in memory. A new CHDRR can be created by reading a symbol table in from disk. The st_readbinary and st_readst routines read a symbol table in from disk. The routine st_readbinary takes the file name of the symbol table and assumes the symbol table header (HDRR in sym.h occurs at the begin- ning of the file. The st_readst assumes that its file number references 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, pro- cedure, auxiliary, optimization, and local string tables cannot 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 a symbol table has not 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. The t_p* constants for each table, defined in 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. The pchdr's value can be taken from st_current_pchdr. See Line number entries are encoded on disk; the read routines expand them to longs. 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. The routines 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. The st_p* constants for each table, defined in 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 specification. Line numbers are compressed on disk. 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. See Also stcu(3), stfe(3), stfd(3), sym.h(5), sterror(5) stsupport.h(5) RISC stio(3)
Check Out this Related Man Page
stio(3) Library Functions Manual stio(3) Name st_readbinary, st_readst, st_writebinary, st_writest - routines that provide a binary read/write interface to the MIPS symbol table Syntax #include <syms.h> long st_readbinary (filename, how) char *filename; char how; long st_readst (fn, how, filebase, pchdr, flags) long fn; char how; long filebase; pCHDRR pchdr; long flags; void st_writebinary (filename, flags) char *filename; long flags; void st_writest (fn, flags) long fn; long flags; Description The CHDRR structure (see cmplrs/stsupport.h and the represents a symbol table in memory. A new CHDRR can be created by reading a symbol table in from disk. The st_readbinary and st_readst routines read a symbol table in from disk. The routine st_readbinary takes the file name of the symbol table and assumes the symbol table header (HDRR in sym.h occurs at the begin- ning of the file. The st_readst assumes that its file number references 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, pro- cedure, auxiliary, optimization, and local string tables cannot 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 a symbol table has not 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. The t_p* constants for each table, defined in 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. The pchdr's value can be taken from st_current_pchdr. See Line number entries are encoded on disk; the read routines expand them to longs. 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. The routines 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. The st_p* constants for each table, defined in 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 specification. Line numbers are compressed on disk. 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. See Also stcu(3), stfe(3), stfd(3), sym.h(5), sterror(5) stsupport.h(5) RISC stio(3)