User`s manual

Firmware Interface
3-6 Single Board Computers SCSI Software UserÕs Manual
3
siop_cmd()
NAME
siop_cmd ÑSIOP Firmware command call
SYNOPSIS
#include "scsi.h" /* SCSI specific definitions */
#include "ncr.h" /* firmware structure definitions */
#include "ncr710.h" /* hardware/firmware specific definitions */
#include "scsi_err.h" /* error definitions */
void siop_cmd(siop_struc, siopdatap)
struct siop_struc *siop_struc;/* SIOP Firmware command structure
pointer (refer to Appendix B) */
struct siopdata *siopdatap; /* SIOP Firmware global data pointer */
DESCRIPTION
The function of the command routine is to receive a command structure from
a user and execute the requested operation.
RETURN VALUE
none
ERROR CONDITIONS
Refer to incl/scsi_err.h or Appendix D (Returned Errors) for defined error
values.
Error codes, associated with a command, are posted asynchronously through
the user supplied return status routine found in the command structure.
NOTES
Once a call is made to this routine, the user cannot modify any field within the
command structure associated with the call until the user supplied return
status routine is invoked by the Firmware. The user is responsible for making
sure the memory used for the command structure is cache coherent.
The siop data area, pointed to by siopdatap, is for use by the Firmware only and
cannot be modified at any time by the caller.