diff options
Diffstat (limited to 'sys/scsi/scsiconf.h')
| -rw-r--r-- | sys/scsi/scsiconf.h | 259 |
1 files changed, 188 insertions, 71 deletions
diff --git a/sys/scsi/scsiconf.h b/sys/scsi/scsiconf.h index 5738de5..856fe89 100644 --- a/sys/scsi/scsiconf.h +++ b/sys/scsi/scsiconf.h @@ -14,88 +14,179 @@ * * Ported to run under 386BSD by Julian Elischer (julian@tfs.com) Sept 1992 * - * $Id: scsiconf.h,v 1.5 1993/08/28 03:08:54 rgrimes Exp $ + * $Id: scsiconf.h,v 2.4 93/10/16 00:59:13 julian Exp Locker: julian $ */ +#ifndef SCSI_SCSICONF_H +#define SCSI_SCSICONF_H 1 +typedef int boolean; +typedef int errval; +typedef long int int32; +typedef short int int16; +typedef char int8; +typedef unsigned long int u_int32; +typedef unsigned short int u_int16; +typedef unsigned char u_int8; -#ifndef _SCSI_SCSICONF_H_ -#define _SCSI_SCSICONF_H_ 1 +#include <scsi/scsi_debug.h> -/***********************************************\ -* these calls are called by the high-end * -* drivers to get services from whatever low-end * -* drivers they are attached to * -\***********************************************/ -struct scsi_switch +/* + * The following documentation tries to describe the relationship between the + * various structures defined in this file: + * + * each adapter type has a scsi_adapter struct. This describes the adapter and + * identifies routines that can be called to use the adapter. + * each device type has a scsi_device struct. This describes the device and + * identifies routines that can be called to use the device. + * each existing device position (scsibus + target + lun) + * can be described by a scsi_link struct. + * Only scsi positions that actually have devices, have a scsi_link + * structure assigned. so in effect each device has scsi_link struct. + * The scsi_link structure contains information identifying both the + * device driver and the adapter driver for that position on that scsi bus, + * and can be said to 'link' the two. + * each individual scsi bus has an array that points to all the scsi_link + * structs associated with that scsi bus. Slots with no device have + * a NULL pointer. + * each individual device also knows the address of it's own scsi_link + * structure. + * + * ------------- + * + * The key to all this is the scsi_link structure which associates all the + * other structures with each other in the correct configuration. The + * scsi_link is the connecting information that allows each part of the + * scsi system to find the associated other parts. + */ + + +/* + * These entrypoints are called by the high-end drivers to get services from + * whatever low-end drivers they are attached to each adapter type has one of + * these statically allocated. + */ +struct scsi_adapter { - int (*scsi_cmd)(); - void (*scsi_minphys)(); - int (*open_target_lu)(); - int (*close_target_lu)(); - long int (*adapter_info)(); /* see definitions below */ - char *name; /* name of scsi bus controller */ - u_long spare[2]; +/* 04*/ int32 (*scsi_cmd)(); +/* 08*/ void (*scsi_minphys)(); +/* 12*/ int32 (*open_target_lu)(); +/* 16*/ int32 (*close_target_lu)(); +/* 20*/ u_int32 (*adapter_info)(); /* see definitions below */ +/* 24*/ char *name; /* name of scsi bus controller */ +/* 32*/ u_long spare[2]; }; -#define AD_INF_MAX_CMDS 0x000000FF /* maximum number of entries - queuable to a device by - the adapter */ -/* 24 bits of other adapter characteristics go here */ -/***********************************************\ -* The scsi debug control bits * -\***********************************************/ -extern int scsi_debug; -#define PRINTROUTINES 0x01 -#define TRACEOPENS 0x02 -#define TRACEINTERRUPTS 0x04 -#define SHOWREQUESTS 0x08 -#define SHOWSCATGATH 0x10 -#define SHOWINQUIRY 0x20 -#define SHOWCOMMANDS 0x40 - - -/********************************/ -/* return values for scsi_cmd() */ -/********************************/ +/* + * return values for scsi_cmd() + */ #define SUCCESSFULLY_QUEUED 0 #define TRY_AGAIN_LATER 1 #define COMPLETE 2 -#define HAD_ERROR 3 +#define HAD_ERROR 3 /* do not use this, use COMPLETE */ #define ESCAPE_NOT_SUPPORTED 4 +/* + * Format of adapter_info() response data + * e.g. maximum number of entries queuable to a device by the adapter + */ +#define AD_INF_MAX_CMDS 0x000000FF +/* 24 bits of other adapter characteristics go here */ + +/* + * These entry points are called by the low-end drivers to get services from + * whatever high-end drivers they are attached to. Each device type has one + * of these statically allocated. + */ +struct scsi_device +{ +/* 4*/ errval (*err_handler)(); /* returns -1 to say err processing complete */ +/* 8*/ void (*start)(); +/* 12*/ int32 (*async)(); +/* 16*/ int32 (*done)(); /* returns -1 to say done processing complete */ +/* 20*/ char *name; /* name of device type */ +/* 24*/ u_int32 flags; /* device type dependent flags */ +/* 32*/ int32 spare[2]; +}; + +/* + * This structure describes the connection between an adapter driver and + * a device driver, and is used by each to call services provided by + * the other, and to allow generic scsi glue code to call these services + * as well. + */ +struct scsi_link +{ +/* 1*/ u_int8 target; /* targ of this dev */ +/* 2*/ u_int8 lun; /* lun of this dev */ +/* 3*/ u_int8 adapter_targ; /* what are we on the scsi bus */ +/* 4*/ u_int8 adapter_unit; /* e.g. the 0 in aha0 */ +/* 5*/ u_int8 scsibus; /* the Nth scsibus */ +/* 6*/ u_int8 dev_unit; /* e.g. the 0 in sd0 */ +/* 7*/ u_int8 opennings; /* available operations */ +/* 8*/ u_int8 active; /* operations in progress */ +/* 10*/ u_int16 flags; /* flags that all devices have */ +/* 12*/ u_int8 spareb[2]; /* unused */ +/* 16*/ struct scsi_adapter *adapter; /* adapter entry points etc. */ +/* 20*/ struct scsi_device *device; /* device entry points etc. */ +/* 24*/ struct scsi_xfer *active_xs; /* operations under way */ +/* 28*/ void * fordriver; /* for private use by the driver */ +/* 32*/ u_int32 spare; +}; +#define SDEV_MEDIA_LOADED 0x01 /* device figures are still valid */ +#define SDEV_WAITING 0x02 /* a process is waiting for this */ +#define SDEV_OPEN 0x04 /* at least 1 open session */ +#define SDEV_DBX 0xF0 /* debuging flags (scsi_debug.h) */ + +/* + * One of these is allocated and filled in for each scsi bus. + * it holds pointers to allow the scsi bus to get to the driver + * That is running each LUN on the bus + * it also has a template entry which is the prototype struct + * supplied by the adapter driver, this is used to initialise + * the others, before they have the rest of the fields filled in + */ +struct scsibus_data { + struct scsi_link *adapter_link; /* prototype supplied by adapter */ + struct scsi_link *sc_link[8][8]; +}; + +/* + * Each scsi transaction is fully described by one of these structures + * It includes information about the source of the command and also the + * device and adapter for which the command is destined. + * (via the scsi_link structure) * + */ struct scsi_xfer { - struct scsi_xfer *next; /* when free */ - int flags; - u_char adapter; - u_char targ; - u_char lu; - u_char retries; /* the number of times to retry */ - long int timeout; /* in miliseconds */ - struct scsi_generic *cmd; - int cmdlen; - u_char *data; /* either the dma address OR a uio address */ - int datalen; /* data len (blank if uio) */ - int resid; - int (*when_done)(); - int done_arg; - int done_arg2; - int error; - struct buf *bp; - struct scsi_sense_data sense; - - /* Believe it or not, Some targets fall on the ground with +/*04*/ struct scsi_xfer *next; /* when free */ +/*08*/ u_int32 flags; +/*12*/ struct scsi_link *sc_link; /* all about our device and adapter */ +/*13*/ u_int8 retries; /* the number of times to retry */ +/*16*/ u_int8 spare[3]; +/*20*/ int32 timeout; /* in milliseconds */ +/*24*/ struct scsi_generic *cmd; /* The scsi command to execute */ +/*28*/ int32 cmdlen; /* how long it is */ +/*32*/ u_char *data; /* dma address OR a uio address */ +/*36*/ int32 datalen; /* data len (blank if uio) */ +/*40*/ int32 resid; /* how much buffer was not touched */ +/*44*/ int32 error; /* an error value */ +/*48*/ struct buf *bp; /* If we need to associate with a buf */ +/*80*/ struct scsi_sense_data sense; /* 32 bytes*/ + /* + * Believe it or not, Some targets fall on the ground with * anything but a certain sense length. */ - int req_sense_length; /* Explicit request sense length */ - - int status; /* SCSI status */ +/*84*/ int32 req_sense_length; /* Explicit request sense length */ +/*88*/ int32 status; /* SCSI status */ +/*100*/ struct scsi_generic cmdstore; /* stash the command in here */ }; -/********************************/ -/* Flag values */ -/********************************/ + +/* + * Per-request Flag values + */ #define SCSI_NOSLEEP 0x01 /* Not a user... don't sleep */ #define SCSI_NOMASK 0x02 /* dont allow interrupts.. booting */ #define SCSI_NOSTART 0x04 /* left over from ancient history */ +#define SCSI_USER 0x08 /* Is a user cmd, call scsi_user_done */ #define ITSDONE 0x10 /* the transfer is as done as it gets */ #define INUSE 0x20 /* The scsi_xfer block is in use */ #define SCSI_SILENT 0x40 /* Don't report errors to console */ @@ -107,18 +198,18 @@ struct scsi_xfer #define SCSI_TARGET 0x1000 /* This defines a TARGET mode op. */ #define SCSI_ESCAPE 0x2000 /* Escape operation */ -/*************************************************************************/ -/* Escape op codes. This provides an extensible setup for operations */ -/* that are not scsi commands. They are intended for modal operations. */ -/*************************************************************************/ +/* + * Escape op codes. This provides an extensible setup for operations + * that are not scsi commands. They are intended for modal operations. + */ #define SCSI_OP_TARGET 0x0001 #define SCSI_OP_RESET 0x0002 #define SCSI_OP_BDINFO 0x0003 -/********************************/ -/* Error values */ -/********************************/ +/* + * Error values an adapter driver may return + */ #define XS_NOERROR 0x0 /* there is no error, (sense is invalid) */ #define XS_SENSE 0x1 /* Check the returned sense for the error */ #define XS_DRIVER_STUFFUP 0x2 /* Driver failed to perform operation */ @@ -126,4 +217,30 @@ struct scsi_xfer #define XS_SWTIMEOUT 0x04 /* The Timeout reported was caught by SW */ #define XS_BUSY 0x08 /* The device busy, try again later? */ -#endif /* _SCSI_SCSICONF_H_ */ +void scsi_attachdevs __P((struct scsi_link *sc_link_proto)); +struct scsi_xfer *get_xs( struct scsi_link *sc_link, u_int32 flags); +void free_xs(struct scsi_xfer *xs, struct scsi_link *sc_link,u_int32 flags); +u_int32 scsi_size( struct scsi_link *sc_link,u_int32 flags); +errval scsi_test_unit_ready( struct scsi_link *sc_link, u_int32 flags); +errval scsi_change_def( struct scsi_link *sc_link, u_int32 flags); +errval scsi_inquire( struct scsi_link *sc_link, + struct scsi_inquiry_data *inqbuf, u_int32 flags); +errval scsi_prevent( struct scsi_link *sc_link, u_int32 type,u_int32 flags); +errval scsi_start_unit( struct scsi_link *sc_link, u_int32 flags); +void scsi_done(struct scsi_xfer *xs); +errval scsi_scsi_cmd( struct scsi_link *sc_link, struct scsi_generic *scsi_cmd, + u_int32 cmdlen, u_char *data_addr, + u_int32 datalen, u_int32 retries, + u_int32 timeout, struct buf *bp, + u_int32 flags); +errval scsi_do_ioctl __P((struct scsi_link *sc_link, int cmd, caddr_t addr, int f)); + +void show_scsi_xs(struct scsi_xfer *xs); +void show_scsi_cmd(struct scsi_xfer *xs); +void show_mem(unsigned char * , u_int32); + +void lto3b __P((int val, u_char *bytes)); +int _3btol __P((u_char *bytes)); + +#endif /*SCSI_SCSICONF_H*/ +/* END OF FILE */ |
