User`s manual

Firmware Interface
3-8 Single Board Computers SCSI Software UserÕs Manual
3
sdt_tinit()
NAME
sdt_tinit ÑInitialize the SCSI debug trace log
SYNOPSIS
#include "scsi.h" /* SCSI specific definitions */
#include "scsi_dbg.h" /* SCSI debug defines and macros */
#include "ncr.h" /* firmware structure definitions */
void sdt_tinit(sdtptr, siopdatap)
struct sdt_tvalue *sdtptr; /* pointer to a structure which contains init
values (refer to Appendix B) */
struct siopdata *siopdatap; /* SIOP Firmware global data pointer */
DESCRIPTION
The function of this routine is to initialize debug tracing. Debug tracing is
useful when problems in the Firmware are encountered and the source of the
problem cannot be detected in any other manner. Trace entries are logged in
the memory range pointed to by the boundary addresses in the sdt_tvalue
structure.
One of the elements in the sdt_tvalue structure is a flag to enable or disable
debug tracing. If the sdt_tvalue structure is located in NVRAM, then enabling
debug tracing is done by simply setting the flag to the proper value prior to
calling this routine. Debug tracing is not normally enabled because the
associated overhead slows the performance of the Firmware. If debug tracing
is enabled, it is recommended to call this routine prior to the call to the
Firmware initialization routine (siop_init()).
RETURN VALUE
none
ERROR CONDITIONS
none
NOTES
This routine may be called any number of times with succeeding calls resetting
the debug log back to the beginning. Calling this routine is allowed prior to
calling the SIOP Firmware initialization (siop_init()) routine.
Performance of the SIOP Firmware is drastically altered when debug tracing
is enabled. For each SIOP command, many debug log entries can be made thus
significantly altering the time it takes to execute the command.