User`s manual

Firmware Interface
3-10 Single Board Computers SCSI Software UserÕs Manual
3
sdt_alloc()
NAME
sdt_alloc ÑAllocate a SCSI debug trace entry
SYNOPSIS
#include "scsi.h" /* SCSI specific definitions */
#include "scsi_dbg.h" /* SCSI debug defines and macros */
#include "ncr.h" /* firmware structure definitions */
struct trace_entry *sdt_alloc(siopdatap)
struct siopdata *siopdatap; /* SIOP Firmware global data pointer */
DESCRIPTION
The function of this routine is to return a pointer to a debug trace entry. The
returned pointer is the next sequential entry allocated from the block of
memory which was assigned for debug logging with the call to sdt_tinit. The
entry is used to hold information that pertains to the code being traced. Debug
log entry wraparound is possible because the debug log is a circular buffer.
The size of the entry is given by sizeof(struct trace_entry).
RETURN VALUE
Pointer to the trace entry.
ERROR CONDITIONS
none
NOTES
Refer to Chapter 5, Special Topics, for more information.