1 #ifndef _SCSI_SCSI_CMND_H
2 #define _SCSI_SCSI_CMND_H
4 #include <linux/dma-mapping.h>
5 #include <linux/list.h>
6 #include <linux/types.h>
14 /* embedded in scsi_cmnd */
16 char *ptr
; /* data pointer */
17 int this_residual
; /* left in this buffer */
18 struct scatterlist
*buffer
; /* which buffer */
19 int buffers_residual
; /* how many buffers left */
21 dma_addr_t dma_handle
;
25 volatile int have_data_in
;
26 volatile int sent_command
;
33 struct scsi_device
*device
;
36 struct scsi_request
*sc_request
;
38 struct list_head list
; /* scsi_cmnd participates in queue lists */
40 struct list_head eh_entry
; /* entry for the host eh_cmd_q */
41 int eh_state
; /* Used for state tracking in error handlr */
42 int eh_eflags
; /* Used by error handlr */
43 void (*done
) (struct scsi_cmnd
*); /* Mid-level done function */
46 * A SCSI Command is assigned a nonzero serial_number when internal_cmnd
47 * passes it to the driver's queue command function. The serial_number
48 * is cleared when scsi_done is entered indicating that the command has
49 * been completed. If a timeout occurs, the serial number at the moment
50 * of timeout is copied into serial_number_at_timeout. By subsequently
51 * comparing the serial_number and serial_number_at_timeout fields
52 * during abort or reset processing, we can detect whether the command
53 * has already completed. This also detects cases where the command has
54 * completed and the SCSI Command structure has already being reused
55 * for another command, so that we can avoid incorrectly aborting or
56 * resetting the new command.
58 unsigned long serial_number
;
59 unsigned long serial_number_at_timeout
;
63 int timeout_per_command
;
68 * We handle the timeout differently if it happens when a reset,
69 * abort, etc are in process.
71 unsigned volatile char internal_timeout
;
73 unsigned char cmd_len
;
74 unsigned char old_cmd_len
;
75 enum dma_data_direction sc_data_direction
;
76 enum dma_data_direction sc_old_data_direction
;
78 /* These elements define the operation we are about to perform */
79 #define MAX_COMMAND_SIZE 16
80 unsigned char cmnd
[MAX_COMMAND_SIZE
];
81 unsigned request_bufflen
; /* Actual request size */
83 struct timer_list eh_timeout
; /* Used to time out the command. */
84 void *request_buffer
; /* Actual requested buffer */
86 /* These elements define the operation we ultimately want to perform */
87 unsigned char data_cmnd
[MAX_COMMAND_SIZE
];
88 unsigned short old_use_sg
; /* We save use_sg here when requesting
90 unsigned short use_sg
; /* Number of pieces of scatter-gather */
91 unsigned short sglist_len
; /* size of malloc'd scatter-gather list */
92 unsigned short abort_reason
; /* If the mid-level code requests an
93 * abort, this is the reason. */
94 unsigned bufflen
; /* Size of data buffer */
95 void *buffer
; /* Data buffer */
97 unsigned underflow
; /* Return error if less than
98 this amount is transferred */
99 unsigned old_underflow
; /* save underflow here when reusing the
100 * command for error handling */
102 unsigned transfersize
; /* How much we are guaranteed to
103 transfer with each SCSI transfer
104 (ie, between disconnect /
105 reconnects. Probably == sector
108 int resid
; /* Number of bytes requested to be
109 transferred less actual number
110 transferred (0 if not supported) */
112 struct request
*request
; /* The command we are
115 #define SCSI_SENSE_BUFFERSIZE 64
116 unsigned char sense_buffer
[SCSI_SENSE_BUFFERSIZE
]; /* obtained by REQUEST SENSE
117 * when CHECK CONDITION is
118 * received on original command
123 /* Low-level done function - can be used by low-level driver to point
124 * to completion function. Not used by mid/upper level code. */
125 void (*scsi_done
) (struct scsi_cmnd
*);
128 * The following fields can be written to by the host specific code.
129 * Everything else should be left alone.
131 struct scsi_pointer SCp
; /* Scratchpad used by some host adapters */
133 unsigned char *host_scribble
; /* The host adapter is allowed to
134 * call scsi_malloc and get some memory
135 * and hang it here. The host adapter
136 * is also expected to call scsi_free
137 * to release this memory. (The memory
138 * obtained by scsi_malloc is guaranteed
139 * to be at an address < 16Mb). */
141 int result
; /* Status code from lower level driver */
143 unsigned char tag
; /* SCSI-II queued command tag */
144 unsigned long pid
; /* Process ID, starts at 0 */
148 * These are the values that scsi_cmd->state can take.
150 #define SCSI_STATE_TIMEOUT 0x1000
151 #define SCSI_STATE_FINISHED 0x1001
152 #define SCSI_STATE_FAILED 0x1002
153 #define SCSI_STATE_QUEUED 0x1003
154 #define SCSI_STATE_UNUSED 0x1006
155 #define SCSI_STATE_DISCONNECTING 0x1008
156 #define SCSI_STATE_INITIALIZING 0x1009
157 #define SCSI_STATE_BHQUEUE 0x100a
158 #define SCSI_STATE_MLQUEUE 0x100b
161 extern struct scsi_cmnd
*scsi_get_command(struct scsi_device
*, int);
162 extern void scsi_put_command(struct scsi_cmnd
*);
163 extern void scsi_io_completion(struct scsi_cmnd
*, int, int);
165 #endif /* _SCSI_SCSI_CMND_H */