2 * Copyright(c) 2007 Intel Corporation. All rights reserved.
3 * Copyright(c) 2008 Red Hat, Inc. All rights reserved.
4 * Copyright(c) 2008 Mike Christie
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms and conditions of the GNU General Public License,
8 * version 2, as published by the Free Software Foundation.
10 * This program is distributed in the hope it will be useful, but WITHOUT
11 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
15 * You should have received a copy of the GNU General Public License along with
16 * this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
19 * Maintained at www.Open-FCoE.org
22 #include <linux/module.h>
23 #include <linux/delay.h>
24 #include <linux/kernel.h>
25 #include <linux/types.h>
26 #include <linux/spinlock.h>
27 #include <linux/scatterlist.h>
28 #include <linux/err.h>
29 #include <linux/crc32.h>
30 #include <linux/slab.h>
32 #include <scsi/scsi_tcq.h>
33 #include <scsi/scsi.h>
34 #include <scsi/scsi_host.h>
35 #include <scsi/scsi_device.h>
36 #include <scsi/scsi_cmnd.h>
38 #include <scsi/fc/fc_fc2.h>
40 #include <scsi/libfc.h>
41 #include <scsi/fc_encode.h>
45 struct kmem_cache *scsi_pkt_cachep;
47 /* SRB state definitions */
48 #define FC_SRB_FREE 0 /* cmd is free */
49 #define FC_SRB_CMD_SENT (1 << 0) /* cmd has been sent */
50 #define FC_SRB_RCV_STATUS (1 << 1) /* response has arrived */
51 #define FC_SRB_ABORT_PENDING (1 << 2) /* cmd abort sent to device */
52 #define FC_SRB_ABORTED (1 << 3) /* abort acknowledged */
53 #define FC_SRB_DISCONTIG (1 << 4) /* non-sequential data recvd */
54 #define FC_SRB_COMPL (1 << 5) /* fc_io_compl has been run */
55 #define FC_SRB_FCP_PROCESSING_TMO (1 << 6) /* timer function processing */
57 #define FC_SRB_READ (1 << 1)
58 #define FC_SRB_WRITE (1 << 0)
61 * The SCp.ptr should be tested and set under the scsi_pkt_queue lock
63 #define CMD_SP(Cmnd) ((struct fc_fcp_pkt *)(Cmnd)->SCp.ptr)
64 #define CMD_ENTRY_STATUS(Cmnd) ((Cmnd)->SCp.have_data_in)
65 #define CMD_COMPL_STATUS(Cmnd) ((Cmnd)->SCp.this_residual)
66 #define CMD_SCSI_STATUS(Cmnd) ((Cmnd)->SCp.Status)
67 #define CMD_RESID_LEN(Cmnd) ((Cmnd)->SCp.buffers_residual)
70 * struct fc_fcp_internal - FCP layer internal data
71 * @scsi_pkt_pool: Memory pool to draw FCP packets from
72 * @scsi_queue_lock: Protects the scsi_pkt_queue
73 * @scsi_pkt_queue: Current FCP packets
74 * @last_can_queue_ramp_down_time: ramp down time
75 * @last_can_queue_ramp_up_time: ramp up time
76 * @max_can_queue: max can_queue size
78 struct fc_fcp_internal {
79 mempool_t *scsi_pkt_pool;
80 spinlock_t scsi_queue_lock;
81 struct list_head scsi_pkt_queue;
82 unsigned long last_can_queue_ramp_down_time;
83 unsigned long last_can_queue_ramp_up_time;
87 #define fc_get_scsi_internal(x) ((struct fc_fcp_internal *)(x)->scsi_priv)
91 * FC scsi I/O related functions
93 static void fc_fcp_recv_data(struct fc_fcp_pkt *, struct fc_frame *);
94 static void fc_fcp_recv(struct fc_seq *, struct fc_frame *, void *);
95 static void fc_fcp_resp(struct fc_fcp_pkt *, struct fc_frame *);
96 static void fc_fcp_complete_locked(struct fc_fcp_pkt *);
97 static void fc_tm_done(struct fc_seq *, struct fc_frame *, void *);
98 static void fc_fcp_error(struct fc_fcp_pkt *, struct fc_frame *);
99 static void fc_fcp_recovery(struct fc_fcp_pkt *);
100 static void fc_fcp_timeout(unsigned long);
101 static void fc_fcp_rec(struct fc_fcp_pkt *);
102 static void fc_fcp_rec_error(struct fc_fcp_pkt *, struct fc_frame *);
103 static void fc_fcp_rec_resp(struct fc_seq *, struct fc_frame *, void *);
104 static void fc_io_compl(struct fc_fcp_pkt *);
106 static void fc_fcp_srr(struct fc_fcp_pkt *, enum fc_rctl, u32);
107 static void fc_fcp_srr_resp(struct fc_seq *, struct fc_frame *, void *);
108 static void fc_fcp_srr_error(struct fc_fcp_pkt *, struct fc_frame *);
111 * command status codes
113 #define FC_COMPLETE 0
114 #define FC_CMD_ABORTED 1
115 #define FC_CMD_RESET 2
116 #define FC_CMD_PLOGO 3
118 #define FC_TRANS_ERR 5
119 #define FC_DATA_OVRRUN 6
120 #define FC_DATA_UNDRUN 7
122 #define FC_HRD_ERROR 9
123 #define FC_CMD_RECOVERY 10
126 * Error recovery timeout values.
128 #define FC_SCSI_ER_TIMEOUT (10 * HZ)
129 #define FC_SCSI_TM_TOV (10 * HZ)
130 #define FC_SCSI_REC_TOV (2 * HZ)
131 #define FC_HOST_RESET_TIMEOUT (30 * HZ)
132 #define FC_CAN_QUEUE_PERIOD (60 * HZ)
134 #define FC_MAX_ERROR_CNT 5
135 #define FC_MAX_RECOV_RETRY 3
137 #define FC_FCP_DFLT_QUEUE_DEPTH 32
140 * fc_fcp_pkt_alloc() - Allocate a fcp_pkt
141 * @lport: The local port that the FCP packet is for
142 * @gfp: GFP flags for allocation
144 * Return value: fcp_pkt structure or null on allocation failure.
145 * Context: Can be called from process context, no lock is required.
147 static struct fc_fcp_pkt *fc_fcp_pkt_alloc(struct fc_lport *lport, gfp_t gfp)
149 struct fc_fcp_internal *si = fc_get_scsi_internal(lport);
150 struct fc_fcp_pkt *fsp;
152 fsp = mempool_alloc(si->scsi_pkt_pool, gfp);
154 memset(fsp, 0, sizeof(*fsp));
156 atomic_set(&fsp->ref_cnt, 1);
157 init_timer(&fsp->timer);
158 INIT_LIST_HEAD(&fsp->list);
159 spin_lock_init(&fsp->scsi_pkt_lock);
165 * fc_fcp_pkt_release() - Release hold on a fcp_pkt
166 * @fsp: The FCP packet to be released
168 * Context: Can be called from process or interrupt context,
169 * no lock is required.
171 static void fc_fcp_pkt_release(struct fc_fcp_pkt *fsp)
173 if (atomic_dec_and_test(&fsp->ref_cnt)) {
174 struct fc_fcp_internal *si = fc_get_scsi_internal(fsp->lp);
176 mempool_free(fsp, si->scsi_pkt_pool);
181 * fc_fcp_pkt_hold() - Hold a fcp_pkt
182 * @fsp: The FCP packet to be held
184 static void fc_fcp_pkt_hold(struct fc_fcp_pkt *fsp)
186 atomic_inc(&fsp->ref_cnt);
190 * fc_fcp_pkt_destory() - Release hold on a fcp_pkt
191 * @seq: The sequence that the FCP packet is on (required by destructor API)
192 * @fsp: The FCP packet to be released
194 * This routine is called by a destructor callback in the exch_seq_send()
195 * routine of the libfc Transport Template. The 'struct fc_seq' is a required
196 * argument even though it is not used by this routine.
198 * Context: No locking required.
200 static void fc_fcp_pkt_destroy(struct fc_seq *seq, void *fsp)
202 fc_fcp_pkt_release(fsp);
206 * fc_fcp_lock_pkt() - Lock a fcp_pkt and increase its reference count
207 * @fsp: The FCP packet to be locked and incremented
209 * We should only return error if we return a command to SCSI-ml before
210 * getting a response. This can happen in cases where we send a abort, but
211 * do not wait for the response and the abort and command can be passing
212 * each other on the wire/network-layer.
214 * Note: this function locks the packet and gets a reference to allow
215 * callers to call the completion function while the lock is held and
216 * not have to worry about the packets refcount.
218 * TODO: Maybe we should just have callers grab/release the lock and
219 * have a function that they call to verify the fsp and grab a ref if
222 static inline int fc_fcp_lock_pkt(struct fc_fcp_pkt *fsp)
224 spin_lock_bh(&fsp->scsi_pkt_lock);
225 if (fsp->state & FC_SRB_COMPL) {
226 spin_unlock_bh(&fsp->scsi_pkt_lock);
230 fc_fcp_pkt_hold(fsp);
235 * fc_fcp_unlock_pkt() - Release a fcp_pkt's lock and decrement its
237 * @fsp: The FCP packet to be unlocked and decremented
239 static inline void fc_fcp_unlock_pkt(struct fc_fcp_pkt *fsp)
241 spin_unlock_bh(&fsp->scsi_pkt_lock);
242 fc_fcp_pkt_release(fsp);
246 * fc_fcp_timer_set() - Start a timer for a fcp_pkt
247 * @fsp: The FCP packet to start a timer for
248 * @delay: The timeout period for the timer
250 static void fc_fcp_timer_set(struct fc_fcp_pkt *fsp, unsigned long delay)
252 if (!(fsp->state & FC_SRB_COMPL))
253 mod_timer(&fsp->timer, jiffies + delay);
257 * fc_fcp_send_abort() - Send an abort for exchanges associated with a
259 * @fsp: The FCP packet to abort exchanges on
261 static int fc_fcp_send_abort(struct fc_fcp_pkt *fsp)
266 fsp->state |= FC_SRB_ABORT_PENDING;
267 return fsp->lp->tt.seq_exch_abort(fsp->seq_ptr, 0);
271 * fc_fcp_retry_cmd() - Retry a fcp_pkt
272 * @fsp: The FCP packet to be retried
274 * Sets the status code to be FC_ERROR and then calls
275 * fc_fcp_complete_locked() which in turn calls fc_io_compl().
276 * fc_io_compl() will notify the SCSI-ml that the I/O is done.
277 * The SCSI-ml will retry the command.
279 static void fc_fcp_retry_cmd(struct fc_fcp_pkt *fsp)
282 fsp->lp->tt.exch_done(fsp->seq_ptr);
286 fsp->state &= ~FC_SRB_ABORT_PENDING;
288 fsp->status_code = FC_ERROR;
289 fc_fcp_complete_locked(fsp);
293 * fc_fcp_ddp_setup() - Calls a LLD's ddp_setup routine to set up DDP context
294 * @fsp: The FCP packet that will manage the DDP frames
295 * @xid: The XID that will be used for the DDP exchange
297 void fc_fcp_ddp_setup(struct fc_fcp_pkt *fsp, u16 xid)
299 struct fc_lport *lport;
302 if ((fsp->req_flags & FC_SRB_READ) &&
303 (lport->lro_enabled) && (lport->tt.ddp_setup)) {
304 if (lport->tt.ddp_setup(lport, xid, scsi_sglist(fsp->cmd),
305 scsi_sg_count(fsp->cmd)))
311 * fc_fcp_ddp_done() - Calls a LLD's ddp_done routine to release any
312 * DDP related resources for a fcp_pkt
313 * @fsp: The FCP packet that DDP had been used on
315 static void fc_fcp_ddp_done(struct fc_fcp_pkt *fsp)
317 struct fc_lport *lport;
322 if (fsp->xfer_ddp == FC_XID_UNKNOWN)
326 if (lport->tt.ddp_done) {
327 fsp->xfer_len = lport->tt.ddp_done(lport, fsp->xfer_ddp);
328 fsp->xfer_ddp = FC_XID_UNKNOWN;
333 * fc_fcp_can_queue_ramp_up() - increases can_queue
334 * @lport: lport to ramp up can_queue
336 * Locking notes: Called with Scsi_Host lock held
338 static void fc_fcp_can_queue_ramp_up(struct fc_lport *lport)
340 struct fc_fcp_internal *si = fc_get_scsi_internal(lport);
343 if (si->last_can_queue_ramp_up_time &&
344 (time_before(jiffies, si->last_can_queue_ramp_up_time +
345 FC_CAN_QUEUE_PERIOD)))
348 if (time_before(jiffies, si->last_can_queue_ramp_down_time +
349 FC_CAN_QUEUE_PERIOD))
352 si->last_can_queue_ramp_up_time = jiffies;
354 can_queue = lport->host->can_queue << 1;
355 if (can_queue >= si->max_can_queue) {
356 can_queue = si->max_can_queue;
357 si->last_can_queue_ramp_down_time = 0;
359 lport->host->can_queue = can_queue;
360 shost_printk(KERN_ERR, lport->host, "libfc: increased "
361 "can_queue to %d.\n", can_queue);
365 * fc_fcp_can_queue_ramp_down() - reduces can_queue
366 * @lport: lport to reduce can_queue
368 * If we are getting memory allocation failures, then we may
369 * be trying to execute too many commands. We let the running
370 * commands complete or timeout, then try again with a reduced
371 * can_queue. Eventually we will hit the point where we run
372 * on all reserved structs.
374 * Locking notes: Called with Scsi_Host lock held
376 static void fc_fcp_can_queue_ramp_down(struct fc_lport *lport)
378 struct fc_fcp_internal *si = fc_get_scsi_internal(lport);
381 if (si->last_can_queue_ramp_down_time &&
382 (time_before(jiffies, si->last_can_queue_ramp_down_time +
383 FC_CAN_QUEUE_PERIOD)))
386 si->last_can_queue_ramp_down_time = jiffies;
388 can_queue = lport->host->can_queue;
392 lport->host->can_queue = can_queue;
393 shost_printk(KERN_ERR, lport->host, "libfc: Could not allocate frame.\n"
394 "Reducing can_queue to %d.\n", can_queue);
398 * fc_fcp_frame_alloc() - Allocates fc_frame structure and buffer.
399 * @lport: fc lport struct
400 * @len: payload length
402 * Allocates fc_frame structure and buffer but if fails to allocate
403 * then reduce can_queue.
405 static inline struct fc_frame *fc_fcp_frame_alloc(struct fc_lport *lport,
411 fp = fc_frame_alloc(lport, len);
416 spin_lock_irqsave(lport->host->host_lock, flags);
417 fc_fcp_can_queue_ramp_down(lport);
418 spin_unlock_irqrestore(lport->host->host_lock, flags);
423 * fc_fcp_recv_data() - Handler for receiving SCSI-FCP data from a target
424 * @fsp: The FCP packet the data is on
425 * @fp: The data frame
427 static void fc_fcp_recv_data(struct fc_fcp_pkt *fsp, struct fc_frame *fp)
429 struct scsi_cmnd *sc = fsp->cmd;
430 struct fc_lport *lport = fsp->lp;
431 struct fcoe_dev_stats *stats;
432 struct fc_frame_header *fh;
439 struct scatterlist *sg;
442 fh = fc_frame_header_get(fp);
443 offset = ntohl(fh->fh_parm_offset);
444 start_offset = offset;
445 len = fr_len(fp) - sizeof(*fh);
446 buf = fc_frame_payload_get(fp, 0);
449 * if this I/O is ddped then clear it
450 * and initiate recovery since data
451 * frames are expected to be placed
452 * directly in that case.
454 if (fsp->xfer_ddp != FC_XID_UNKNOWN) {
455 fc_fcp_ddp_done(fsp);
458 if (offset + len > fsp->data_len) {
459 /* this should never happen */
460 if ((fr_flags(fp) & FCPHF_CRC_UNCHECKED) &&
461 fc_frame_crc_check(fp))
463 FC_FCP_DBG(fsp, "data received past end. len %zx offset %zx "
464 "data_len %x\n", len, offset, fsp->data_len);
467 if (offset != fsp->xfer_len)
468 fsp->state |= FC_SRB_DISCONTIG;
470 sg = scsi_sglist(sc);
471 nents = scsi_sg_count(sc);
473 if (!(fr_flags(fp) & FCPHF_CRC_UNCHECKED)) {
474 copy_len = fc_copy_buffer_to_sglist(buf, len, sg, &nents,
475 &offset, KM_SOFTIRQ0, NULL);
477 crc = crc32(~0, (u8 *) fh, sizeof(*fh));
478 copy_len = fc_copy_buffer_to_sglist(buf, len, sg, &nents,
479 &offset, KM_SOFTIRQ0, &crc);
480 buf = fc_frame_payload_get(fp, 0);
482 crc = crc32(crc, buf + len, 4 - (len % 4));
484 if (~crc != le32_to_cpu(fr_crc(fp))) {
486 stats = per_cpu_ptr(lport->dev_stats, get_cpu());
487 stats->ErrorFrames++;
488 /* per cpu count, not total count, but OK for limit */
489 if (stats->InvalidCRCCount++ < 5)
490 printk(KERN_WARNING "libfc: CRC error on data "
491 "frame for port (%6.6x)\n",
495 * Assume the frame is total garbage.
496 * We may have copied it over the good part
498 * If so, we need to retry the entire operation.
499 * Otherwise, ignore it.
501 if (fsp->state & FC_SRB_DISCONTIG)
507 if (fsp->xfer_contig_end == start_offset)
508 fsp->xfer_contig_end += copy_len;
509 fsp->xfer_len += copy_len;
512 * In the very rare event that this data arrived after the response
513 * and completes the transfer, call the completion handler.
515 if (unlikely(fsp->state & FC_SRB_RCV_STATUS) &&
516 fsp->xfer_len == fsp->data_len - fsp->scsi_resid)
517 fc_fcp_complete_locked(fsp);
520 fc_fcp_recovery(fsp);
524 * fc_fcp_send_data() - Send SCSI data to a target
525 * @fsp: The FCP packet the data is on
526 * @sp: The sequence the data is to be sent on
527 * @offset: The starting offset for this data request
528 * @seq_blen: The burst length for this data request
530 * Called after receiving a Transfer Ready data descriptor.
531 * If the LLD is capable of sequence offload then send down the
532 * seq_blen amount of data in single frame, otherwise send
533 * multiple frames of the maximum frame payload supported by
536 static int fc_fcp_send_data(struct fc_fcp_pkt *fsp, struct fc_seq *seq,
537 size_t offset, size_t seq_blen)
540 struct scsi_cmnd *sc;
541 struct scatterlist *sg;
542 struct fc_frame *fp = NULL;
543 struct fc_lport *lport = fsp->lp;
549 size_t frame_offset, fh_parm_offset;
554 int using_sg = lport->sg_supp;
557 WARN_ON(seq_blen <= 0);
558 if (unlikely(offset + seq_blen > fsp->data_len)) {
559 /* this should never happen */
560 FC_FCP_DBG(fsp, "xfer-ready past end. seq_blen %zx "
561 "offset %zx\n", seq_blen, offset);
562 fc_fcp_send_abort(fsp);
564 } else if (offset != fsp->xfer_len) {
565 /* Out of Order Data Request - no problem, but unexpected. */
566 FC_FCP_DBG(fsp, "xfer-ready non-contiguous. "
567 "seq_blen %zx offset %zx\n", seq_blen, offset);
571 * if LLD is capable of seq_offload then set transport
572 * burst length (t_blen) to seq_blen, otherwise set t_blen
573 * to max FC frame payload previously set in fsp->max_payload.
575 t_blen = fsp->max_payload;
576 if (lport->seq_offload) {
577 t_blen = min(seq_blen, (size_t)lport->lso_max);
578 FC_FCP_DBG(fsp, "fsp=%p:lso:blen=%zx lso_max=0x%x t_blen=%zx\n",
579 fsp, seq_blen, lport->lso_max, t_blen);
583 t_blen &= ~(512 - 1); /* round down to block size */
586 remaining = seq_blen;
587 fh_parm_offset = frame_offset = offset;
589 seq = lport->tt.seq_start_next(seq);
590 f_ctl = FC_FC_REL_OFF;
593 sg = scsi_sglist(sc);
595 while (remaining > 0 && sg) {
596 if (offset >= sg->length) {
597 offset -= sg->length;
602 tlen = min(t_blen, remaining);
605 * TODO. Temporary workaround. fc_seq_send() can't
606 * handle odd lengths in non-linear skbs.
607 * This will be the final fragment only.
611 fp = fc_frame_alloc(lport, using_sg ? 0 : tlen);
615 data = fc_frame_header_get(fp) + 1;
616 fh_parm_offset = frame_offset;
617 fr_max_payload(fp) = fsp->max_payload;
620 off = offset + sg->offset;
621 sg_bytes = min(tlen, sg->length - offset);
622 sg_bytes = min(sg_bytes,
623 (size_t) (PAGE_SIZE - (off & ~PAGE_MASK)));
624 page = sg_page(sg) + (off >> PAGE_SHIFT);
627 skb_fill_page_desc(fp_skb(fp),
628 skb_shinfo(fp_skb(fp))->nr_frags,
629 page, off & ~PAGE_MASK, sg_bytes);
630 fp_skb(fp)->data_len += sg_bytes;
631 fr_len(fp) += sg_bytes;
632 fp_skb(fp)->truesize += PAGE_SIZE;
635 * The scatterlist item may be bigger than PAGE_SIZE,
636 * but we must not cross pages inside the kmap.
638 page_addr = kmap_atomic(page, KM_SOFTIRQ0);
639 memcpy(data, (char *)page_addr + (off & ~PAGE_MASK),
641 kunmap_atomic(page_addr, KM_SOFTIRQ0);
645 frame_offset += sg_bytes;
647 remaining -= sg_bytes;
649 if ((skb_shinfo(fp_skb(fp))->nr_frags < FC_FRAME_SG_LEN) &&
654 * Send sequence with transfer sequence initiative in case
655 * this is last FCP frame of the sequence.
658 f_ctl |= FC_FC_SEQ_INIT | FC_FC_END_SEQ;
660 ep = fc_seq_exch(seq);
661 fc_fill_fc_hdr(fp, FC_RCTL_DD_SOL_DATA, ep->did, ep->sid,
662 FC_TYPE_FCP, f_ctl, fh_parm_offset);
665 * send fragment using for a sequence.
667 error = lport->tt.seq_send(lport, seq, fp);
669 WARN_ON(1); /* send error should be rare */
670 fc_fcp_retry_cmd(fsp);
675 fsp->xfer_len += seq_blen; /* premature count? */
680 * fc_fcp_abts_resp() - Send an ABTS response
681 * @fsp: The FCP packet that is being aborted
682 * @fp: The response frame
684 static void fc_fcp_abts_resp(struct fc_fcp_pkt *fsp, struct fc_frame *fp)
687 struct fc_ba_rjt *brp;
688 struct fc_frame_header *fh;
690 fh = fc_frame_header_get(fp);
691 switch (fh->fh_r_ctl) {
695 brp = fc_frame_payload_get(fp, sizeof(*brp));
696 if (brp && brp->br_reason == FC_BA_RJT_LOG_ERR)
701 * we will let the command timeout
702 * and scsi-ml recover in this case,
703 * therefore cleared the ba_done flag.
709 fsp->state |= FC_SRB_ABORTED;
710 fsp->state &= ~FC_SRB_ABORT_PENDING;
712 if (fsp->wait_for_comp)
713 complete(&fsp->tm_done);
715 fc_fcp_complete_locked(fsp);
720 * fc_fcp_recv() - Reveive an FCP frame
721 * @seq: The sequence the frame is on
722 * @fp: The received frame
723 * @arg: The related FCP packet
725 * Context: Called from Soft IRQ context. Can not be called
726 * holding the FCP packet list lock.
728 static void fc_fcp_recv(struct fc_seq *seq, struct fc_frame *fp, void *arg)
730 struct fc_fcp_pkt *fsp = (struct fc_fcp_pkt *)arg;
731 struct fc_lport *lport = fsp->lp;
732 struct fc_frame_header *fh;
733 struct fcp_txrdy *dd;
738 fc_fcp_error(fsp, fp);
742 fh = fc_frame_header_get(fp);
743 r_ctl = fh->fh_r_ctl;
745 if (lport->state != LPORT_ST_READY)
747 if (fc_fcp_lock_pkt(fsp))
749 fsp->last_pkt_time = jiffies;
751 if (fh->fh_type == FC_TYPE_BLS) {
752 fc_fcp_abts_resp(fsp, fp);
756 if (fsp->state & (FC_SRB_ABORTED | FC_SRB_ABORT_PENDING))
759 if (r_ctl == FC_RCTL_DD_DATA_DESC) {
761 * received XFER RDY from the target
762 * need to send data to the target
764 WARN_ON(fr_flags(fp) & FCPHF_CRC_UNCHECKED);
765 dd = fc_frame_payload_get(fp, sizeof(*dd));
768 rc = fc_fcp_send_data(fsp, seq,
769 (size_t) ntohl(dd->ft_data_ro),
770 (size_t) ntohl(dd->ft_burst_len));
772 seq->rec_data = fsp->xfer_len;
773 } else if (r_ctl == FC_RCTL_DD_SOL_DATA) {
775 * received a DATA frame
776 * next we will copy the data to the system buffer
778 WARN_ON(fr_len(fp) < sizeof(*fh)); /* len may be 0 */
779 fc_fcp_recv_data(fsp, fp);
780 seq->rec_data = fsp->xfer_contig_end;
781 } else if (r_ctl == FC_RCTL_DD_CMD_STATUS) {
782 WARN_ON(fr_flags(fp) & FCPHF_CRC_UNCHECKED);
784 fc_fcp_resp(fsp, fp);
786 FC_FCP_DBG(fsp, "unexpected frame. r_ctl %x\n", r_ctl);
789 fc_fcp_unlock_pkt(fsp);
795 * fc_fcp_resp() - Handler for FCP responses
796 * @fsp: The FCP packet the response is for
797 * @fp: The response frame
799 static void fc_fcp_resp(struct fc_fcp_pkt *fsp, struct fc_frame *fp)
801 struct fc_frame_header *fh;
802 struct fcp_resp *fc_rp;
803 struct fcp_resp_ext *rp_ex;
804 struct fcp_resp_rsp_info *fc_rp_info;
812 fh = (struct fc_frame_header *)fr_hdr(fp);
813 if (unlikely(plen < sizeof(*fh) + sizeof(*fc_rp)))
816 fc_rp = (struct fcp_resp *)(fh + 1);
817 fsp->cdb_status = fc_rp->fr_status;
818 flags = fc_rp->fr_flags;
819 fsp->scsi_comp_flags = flags;
820 expected_len = fsp->data_len;
822 /* if ddp, update xfer len */
823 fc_fcp_ddp_done(fsp);
825 if (unlikely((flags & ~FCP_CONF_REQ) || fc_rp->fr_status)) {
826 rp_ex = (void *)(fc_rp + 1);
827 if (flags & (FCP_RSP_LEN_VAL | FCP_SNS_LEN_VAL)) {
828 if (plen < sizeof(*fc_rp) + sizeof(*rp_ex))
830 fc_rp_info = (struct fcp_resp_rsp_info *)(rp_ex + 1);
831 if (flags & FCP_RSP_LEN_VAL) {
832 respl = ntohl(rp_ex->fr_rsp_len);
833 if (respl != sizeof(*fc_rp_info))
835 if (fsp->wait_for_comp) {
836 /* Abuse cdb_status for rsp code */
837 fsp->cdb_status = fc_rp_info->rsp_code;
838 complete(&fsp->tm_done);
840 * tmfs will not have any scsi cmd so
846 if (flags & FCP_SNS_LEN_VAL) {
847 snsl = ntohl(rp_ex->fr_sns_len);
848 if (snsl > SCSI_SENSE_BUFFERSIZE)
849 snsl = SCSI_SENSE_BUFFERSIZE;
850 memcpy(fsp->cmd->sense_buffer,
851 (char *)fc_rp_info + respl, snsl);
854 if (flags & (FCP_RESID_UNDER | FCP_RESID_OVER)) {
855 if (plen < sizeof(*fc_rp) + sizeof(rp_ex->fr_resid))
857 if (flags & FCP_RESID_UNDER) {
858 fsp->scsi_resid = ntohl(rp_ex->fr_resid);
860 * The cmnd->underflow is the minimum number of
861 * bytes that must be transfered for this
862 * command. Provided a sense condition is not
863 * present, make sure the actual amount
864 * transferred is at least the underflow value
867 if (!(flags & FCP_SNS_LEN_VAL) &&
868 (fc_rp->fr_status == 0) &&
869 (scsi_bufflen(fsp->cmd) -
870 fsp->scsi_resid) < fsp->cmd->underflow)
872 expected_len -= fsp->scsi_resid;
874 fsp->status_code = FC_ERROR;
878 fsp->state |= FC_SRB_RCV_STATUS;
881 * Check for missing or extra data frames.
883 if (unlikely(fsp->xfer_len != expected_len)) {
884 if (fsp->xfer_len < expected_len) {
886 * Some data may be queued locally,
887 * Wait a at least one jiffy to see if it is delivered.
888 * If this expires without data, we may do SRR.
890 fc_fcp_timer_set(fsp, 2);
893 fsp->status_code = FC_DATA_OVRRUN;
894 FC_FCP_DBG(fsp, "tgt %6.6x xfer len %zx greater than expected, "
895 "len %x, data len %x\n",
897 fsp->xfer_len, expected_len, fsp->data_len);
899 fc_fcp_complete_locked(fsp);
903 FC_FCP_DBG(fsp, "short FCP response. flags 0x%x len %u respl %u "
904 "snsl %u\n", flags, fr_len(fp), respl, snsl);
906 fsp->status_code = FC_ERROR;
907 fc_fcp_complete_locked(fsp);
911 * fc_fcp_complete_locked() - Complete processing of a fcp_pkt with the
913 * @fsp: The FCP packet to be completed
915 * This function may sleep if a timer is pending. The packet lock must be
916 * held, and the host lock must not be held.
918 static void fc_fcp_complete_locked(struct fc_fcp_pkt *fsp)
920 struct fc_lport *lport = fsp->lp;
925 if (fsp->state & FC_SRB_ABORT_PENDING)
928 if (fsp->state & FC_SRB_ABORTED) {
929 if (!fsp->status_code)
930 fsp->status_code = FC_CMD_ABORTED;
933 * Test for transport underrun, independent of response
936 if (fsp->xfer_len < fsp->data_len && !fsp->io_status &&
937 (!(fsp->scsi_comp_flags & FCP_RESID_UNDER) ||
938 fsp->xfer_len < fsp->data_len - fsp->scsi_resid)) {
939 fsp->status_code = FC_DATA_UNDRUN;
947 if (unlikely(fsp->scsi_comp_flags & FCP_CONF_REQ)) {
948 struct fc_frame *conf_frame;
951 csp = lport->tt.seq_start_next(seq);
952 conf_frame = fc_fcp_frame_alloc(fsp->lp, 0);
954 f_ctl = FC_FC_SEQ_INIT;
955 f_ctl |= FC_FC_LAST_SEQ | FC_FC_END_SEQ;
956 ep = fc_seq_exch(seq);
957 fc_fill_fc_hdr(conf_frame, FC_RCTL_DD_SOL_CTL,
959 FC_TYPE_FCP, f_ctl, 0);
960 lport->tt.seq_send(lport, csp, conf_frame);
963 lport->tt.exch_done(seq);
969 * fc_fcp_cleanup_cmd() - Cancel the active exchange on a fcp_pkt
970 * @fsp: The FCP packet whose exchanges should be canceled
971 * @error: The reason for the cancellation
973 static void fc_fcp_cleanup_cmd(struct fc_fcp_pkt *fsp, int error)
975 struct fc_lport *lport = fsp->lp;
978 lport->tt.exch_done(fsp->seq_ptr);
981 fsp->status_code = error;
985 * fc_fcp_cleanup_each_cmd() - Cancel all exchanges on a local port
986 * @lport: The local port whose exchanges should be canceled
987 * @id: The target's ID
989 * @error: The reason for cancellation
991 * If lun or id is -1, they are ignored.
993 static void fc_fcp_cleanup_each_cmd(struct fc_lport *lport, unsigned int id,
994 unsigned int lun, int error)
996 struct fc_fcp_internal *si = fc_get_scsi_internal(lport);
997 struct fc_fcp_pkt *fsp;
998 struct scsi_cmnd *sc_cmd;
1001 spin_lock_irqsave(&si->scsi_queue_lock, flags);
1003 list_for_each_entry(fsp, &si->scsi_pkt_queue, list) {
1005 if (id != -1 && scmd_id(sc_cmd) != id)
1008 if (lun != -1 && sc_cmd->device->lun != lun)
1011 fc_fcp_pkt_hold(fsp);
1012 spin_unlock_irqrestore(&si->scsi_queue_lock, flags);
1014 if (!fc_fcp_lock_pkt(fsp)) {
1015 fc_fcp_cleanup_cmd(fsp, error);
1017 fc_fcp_unlock_pkt(fsp);
1020 fc_fcp_pkt_release(fsp);
1021 spin_lock_irqsave(&si->scsi_queue_lock, flags);
1023 * while we dropped the lock multiple pkts could
1024 * have been released, so we have to start over.
1028 spin_unlock_irqrestore(&si->scsi_queue_lock, flags);
1032 * fc_fcp_abort_io() - Abort all FCP-SCSI exchanges on a local port
1033 * @lport: The local port whose exchanges are to be aborted
1035 static void fc_fcp_abort_io(struct fc_lport *lport)
1037 fc_fcp_cleanup_each_cmd(lport, -1, -1, FC_HRD_ERROR);
1041 * fc_fcp_pkt_send() - Send a fcp_pkt
1042 * @lport: The local port to send the FCP packet on
1043 * @fsp: The FCP packet to send
1045 * Return: Zero for success and -1 for failure
1046 * Locks: Called without locks held
1048 static int fc_fcp_pkt_send(struct fc_lport *lport, struct fc_fcp_pkt *fsp)
1050 struct fc_fcp_internal *si = fc_get_scsi_internal(lport);
1051 unsigned long flags;
1054 fsp->cmd->SCp.ptr = (char *)fsp;
1055 fsp->cdb_cmd.fc_dl = htonl(fsp->data_len);
1056 fsp->cdb_cmd.fc_flags = fsp->req_flags & ~FCP_CFL_LEN_MASK;
1058 int_to_scsilun(fsp->cmd->device->lun,
1059 (struct scsi_lun *)fsp->cdb_cmd.fc_lun);
1060 memcpy(fsp->cdb_cmd.fc_cdb, fsp->cmd->cmnd, fsp->cmd->cmd_len);
1062 spin_lock_irqsave(&si->scsi_queue_lock, flags);
1063 list_add_tail(&fsp->list, &si->scsi_pkt_queue);
1064 spin_unlock_irqrestore(&si->scsi_queue_lock, flags);
1065 rc = lport->tt.fcp_cmd_send(lport, fsp, fc_fcp_recv);
1067 spin_lock_irqsave(&si->scsi_queue_lock, flags);
1068 list_del(&fsp->list);
1069 spin_unlock_irqrestore(&si->scsi_queue_lock, flags);
1076 * fc_fcp_cmd_send() - Send a FCP command
1077 * @lport: The local port to send the command on
1078 * @fsp: The FCP packet the command is on
1079 * @resp: The handler for the response
1081 static int fc_fcp_cmd_send(struct fc_lport *lport, struct fc_fcp_pkt *fsp,
1082 void (*resp)(struct fc_seq *,
1083 struct fc_frame *fp,
1086 struct fc_frame *fp;
1088 struct fc_rport *rport;
1089 struct fc_rport_libfc_priv *rpriv;
1090 const size_t len = sizeof(fsp->cdb_cmd);
1093 if (fc_fcp_lock_pkt(fsp))
1096 fp = fc_fcp_frame_alloc(lport, sizeof(fsp->cdb_cmd));
1102 memcpy(fc_frame_payload_get(fp, len), &fsp->cdb_cmd, len);
1105 fsp->max_payload = rport->maxframe_size;
1106 rpriv = rport->dd_data;
1108 fc_fill_fc_hdr(fp, FC_RCTL_DD_UNSOL_CMD, rport->port_id,
1109 rpriv->local_port->port_id, FC_TYPE_FCP,
1112 seq = lport->tt.exch_seq_send(lport, fp, resp, fc_fcp_pkt_destroy,
1118 fsp->last_pkt_time = jiffies;
1120 fc_fcp_pkt_hold(fsp); /* hold for fc_fcp_pkt_destroy */
1122 setup_timer(&fsp->timer, fc_fcp_timeout, (unsigned long)fsp);
1123 fc_fcp_timer_set(fsp,
1124 (fsp->tgt_flags & FC_RP_FLAGS_REC_SUPPORTED) ?
1125 FC_SCSI_REC_TOV : FC_SCSI_ER_TIMEOUT);
1127 fc_fcp_unlock_pkt(fsp);
1132 * fc_fcp_error() - Handler for FCP layer errors
1133 * @fsp: The FCP packet the error is on
1134 * @fp: The frame that has errored
1136 static void fc_fcp_error(struct fc_fcp_pkt *fsp, struct fc_frame *fp)
1138 int error = PTR_ERR(fp);
1140 if (fc_fcp_lock_pkt(fsp))
1143 if (error == -FC_EX_CLOSED) {
1144 fc_fcp_retry_cmd(fsp);
1149 * clear abort pending, because the lower layer
1150 * decided to force completion.
1152 fsp->state &= ~FC_SRB_ABORT_PENDING;
1153 fsp->status_code = FC_CMD_PLOGO;
1154 fc_fcp_complete_locked(fsp);
1156 fc_fcp_unlock_pkt(fsp);
1160 * fc_fcp_pkt_abort() - Abort a fcp_pkt
1161 * @fsp: The FCP packet to abort on
1163 * Called to send an abort and then wait for abort completion
1165 static int fc_fcp_pkt_abort(struct fc_fcp_pkt *fsp)
1169 if (fc_fcp_send_abort(fsp))
1172 init_completion(&fsp->tm_done);
1173 fsp->wait_for_comp = 1;
1175 spin_unlock_bh(&fsp->scsi_pkt_lock);
1176 rc = wait_for_completion_timeout(&fsp->tm_done, FC_SCSI_TM_TOV);
1177 spin_lock_bh(&fsp->scsi_pkt_lock);
1178 fsp->wait_for_comp = 0;
1181 FC_FCP_DBG(fsp, "target abort cmd failed\n");
1183 } else if (fsp->state & FC_SRB_ABORTED) {
1184 FC_FCP_DBG(fsp, "target abort cmd passed\n");
1186 fc_fcp_complete_locked(fsp);
1193 * fc_lun_reset_send() - Send LUN reset command
1194 * @data: The FCP packet that identifies the LUN to be reset
1196 static void fc_lun_reset_send(unsigned long data)
1198 struct fc_fcp_pkt *fsp = (struct fc_fcp_pkt *)data;
1199 struct fc_lport *lport = fsp->lp;
1200 if (lport->tt.fcp_cmd_send(lport, fsp, fc_tm_done)) {
1201 if (fsp->recov_retry++ >= FC_MAX_RECOV_RETRY)
1203 if (fc_fcp_lock_pkt(fsp))
1205 setup_timer(&fsp->timer, fc_lun_reset_send, (unsigned long)fsp);
1206 fc_fcp_timer_set(fsp, FC_SCSI_REC_TOV);
1207 fc_fcp_unlock_pkt(fsp);
1212 * fc_lun_reset() - Send a LUN RESET command to a device
1213 * and wait for the reply
1214 * @lport: The local port to sent the comand on
1215 * @fsp: The FCP packet that identifies the LUN to be reset
1216 * @id: The SCSI command ID
1217 * @lun: The LUN ID to be reset
1219 static int fc_lun_reset(struct fc_lport *lport, struct fc_fcp_pkt *fsp,
1220 unsigned int id, unsigned int lun)
1224 fsp->cdb_cmd.fc_dl = htonl(fsp->data_len);
1225 fsp->cdb_cmd.fc_tm_flags = FCP_TMF_LUN_RESET;
1226 int_to_scsilun(lun, (struct scsi_lun *)fsp->cdb_cmd.fc_lun);
1228 fsp->wait_for_comp = 1;
1229 init_completion(&fsp->tm_done);
1231 fc_lun_reset_send((unsigned long)fsp);
1234 * wait for completion of reset
1235 * after that make sure all commands are terminated
1237 rc = wait_for_completion_timeout(&fsp->tm_done, FC_SCSI_TM_TOV);
1239 spin_lock_bh(&fsp->scsi_pkt_lock);
1240 fsp->state |= FC_SRB_COMPL;
1241 spin_unlock_bh(&fsp->scsi_pkt_lock);
1243 del_timer_sync(&fsp->timer);
1245 spin_lock_bh(&fsp->scsi_pkt_lock);
1247 lport->tt.exch_done(fsp->seq_ptr);
1248 fsp->seq_ptr = NULL;
1250 fsp->wait_for_comp = 0;
1251 spin_unlock_bh(&fsp->scsi_pkt_lock);
1254 FC_SCSI_DBG(lport, "lun reset failed\n");
1258 /* cdb_status holds the tmf's rsp code */
1259 if (fsp->cdb_status != FCP_TMF_CMPL)
1262 FC_SCSI_DBG(lport, "lun reset to lun %u completed\n", lun);
1263 fc_fcp_cleanup_each_cmd(lport, id, lun, FC_CMD_ABORTED);
1268 * fc_tm_done() - Task Managment response handler
1269 * @seq: The sequence that the response is on
1270 * @fp: The response frame
1271 * @arg: The FCP packet the response is for
1273 static void fc_tm_done(struct fc_seq *seq, struct fc_frame *fp, void *arg)
1275 struct fc_fcp_pkt *fsp = arg;
1276 struct fc_frame_header *fh;
1280 * If there is an error just let it timeout or wait
1281 * for TMF to be aborted if it timedout.
1283 * scsi-eh will escalate for when either happens.
1288 if (fc_fcp_lock_pkt(fsp))
1292 * raced with eh timeout handler.
1294 if (!fsp->seq_ptr || !fsp->wait_for_comp) {
1295 spin_unlock_bh(&fsp->scsi_pkt_lock);
1299 fh = fc_frame_header_get(fp);
1300 if (fh->fh_type != FC_TYPE_BLS)
1301 fc_fcp_resp(fsp, fp);
1302 fsp->seq_ptr = NULL;
1303 fsp->lp->tt.exch_done(seq);
1305 fc_fcp_unlock_pkt(fsp);
1309 * fc_fcp_cleanup() - Cleanup all FCP exchanges on a local port
1310 * @lport: The local port to be cleaned up
1312 static void fc_fcp_cleanup(struct fc_lport *lport)
1314 fc_fcp_cleanup_each_cmd(lport, -1, -1, FC_ERROR);
1318 * fc_fcp_timeout() - Handler for fcp_pkt timeouts
1319 * @data: The FCP packet that has timed out
1321 * If REC is supported then just issue it and return. The REC exchange will
1322 * complete or time out and recovery can continue at that point. Otherwise,
1323 * if the response has been received without all the data it has been
1324 * ER_TIMEOUT since the response was received. If the response has not been
1325 * received we see if data was received recently. If it has been then we
1326 * continue waiting, otherwise, we abort the command.
1328 static void fc_fcp_timeout(unsigned long data)
1330 struct fc_fcp_pkt *fsp = (struct fc_fcp_pkt *)data;
1331 struct fc_rport *rport = fsp->rport;
1332 struct fc_rport_libfc_priv *rpriv = rport->dd_data;
1334 if (fc_fcp_lock_pkt(fsp))
1337 if (fsp->cdb_cmd.fc_tm_flags)
1340 fsp->state |= FC_SRB_FCP_PROCESSING_TMO;
1342 if (rpriv->flags & FC_RP_FLAGS_REC_SUPPORTED)
1344 else if (time_after_eq(fsp->last_pkt_time + (FC_SCSI_ER_TIMEOUT / 2),
1346 fc_fcp_timer_set(fsp, FC_SCSI_ER_TIMEOUT);
1347 else if (fsp->state & FC_SRB_RCV_STATUS)
1348 fc_fcp_complete_locked(fsp);
1350 fc_fcp_recovery(fsp);
1351 fsp->state &= ~FC_SRB_FCP_PROCESSING_TMO;
1353 fc_fcp_unlock_pkt(fsp);
1357 * fc_fcp_rec() - Send a REC ELS request
1358 * @fsp: The FCP packet to send the REC request on
1360 static void fc_fcp_rec(struct fc_fcp_pkt *fsp)
1362 struct fc_lport *lport;
1363 struct fc_frame *fp;
1364 struct fc_rport *rport;
1365 struct fc_rport_libfc_priv *rpriv;
1369 rpriv = rport->dd_data;
1370 if (!fsp->seq_ptr || rpriv->rp_state != RPORT_ST_READY) {
1371 fsp->status_code = FC_HRD_ERROR;
1373 fc_fcp_complete_locked(fsp);
1376 fp = fc_fcp_frame_alloc(lport, sizeof(struct fc_els_rec));
1380 fr_seq(fp) = fsp->seq_ptr;
1381 fc_fill_fc_hdr(fp, FC_RCTL_ELS_REQ, rport->port_id,
1382 rpriv->local_port->port_id, FC_TYPE_ELS,
1384 if (lport->tt.elsct_send(lport, rport->port_id, fp, ELS_REC,
1385 fc_fcp_rec_resp, fsp,
1386 jiffies_to_msecs(FC_SCSI_REC_TOV))) {
1387 fc_fcp_pkt_hold(fsp); /* hold while REC outstanding */
1391 if (fsp->recov_retry++ < FC_MAX_RECOV_RETRY)
1392 fc_fcp_timer_set(fsp, FC_SCSI_REC_TOV);
1394 fc_fcp_recovery(fsp);
1398 * fc_fcp_rec_resp() - Handler for REC ELS responses
1399 * @seq: The sequence the response is on
1400 * @fp: The response frame
1401 * @arg: The FCP packet the response is on
1403 * If the response is a reject then the scsi layer will handle
1404 * the timeout. If the response is a LS_ACC then if the I/O was not completed
1405 * set the timeout and return. If the I/O was completed then complete the
1406 * exchange and tell the SCSI layer.
1408 static void fc_fcp_rec_resp(struct fc_seq *seq, struct fc_frame *fp, void *arg)
1410 struct fc_fcp_pkt *fsp = (struct fc_fcp_pkt *)arg;
1411 struct fc_els_rec_acc *recp;
1412 struct fc_els_ls_rjt *rjt;
1416 enum dma_data_direction data_dir;
1418 struct fc_rport_libfc_priv *rpriv;
1421 fc_fcp_rec_error(fsp, fp);
1425 if (fc_fcp_lock_pkt(fsp))
1428 fsp->recov_retry = 0;
1429 opcode = fc_frame_payload_op(fp);
1430 if (opcode == ELS_LS_RJT) {
1431 rjt = fc_frame_payload_get(fp, sizeof(*rjt));
1432 switch (rjt->er_reason) {
1434 FC_FCP_DBG(fsp, "device %x unexpected REC reject "
1435 "reason %d expl %d\n",
1436 fsp->rport->port_id, rjt->er_reason,
1440 FC_FCP_DBG(fsp, "device does not support REC\n");
1441 rpriv = fsp->rport->dd_data;
1443 * if we do not spport RECs or got some bogus
1444 * reason then resetup timer so we check for
1447 rpriv->flags &= ~FC_RP_FLAGS_REC_SUPPORTED;
1448 fc_fcp_timer_set(fsp, FC_SCSI_ER_TIMEOUT);
1453 * If no data transfer, the command frame got dropped
1454 * so we just retry. If data was transferred, we
1455 * lost the response but the target has no record,
1456 * so we abort and retry.
1458 if (rjt->er_explan == ELS_EXPL_OXID_RXID &&
1459 fsp->xfer_len == 0) {
1460 fc_fcp_retry_cmd(fsp);
1463 fc_fcp_recovery(fsp);
1466 } else if (opcode == ELS_LS_ACC) {
1467 if (fsp->state & FC_SRB_ABORTED)
1470 data_dir = fsp->cmd->sc_data_direction;
1471 recp = fc_frame_payload_get(fp, sizeof(*recp));
1472 offset = ntohl(recp->reca_fc4value);
1473 e_stat = ntohl(recp->reca_e_stat);
1475 if (e_stat & ESB_ST_COMPLETE) {
1478 * The exchange is complete.
1480 * For output, we must've lost the response.
1481 * For input, all data must've been sent.
1482 * We lost may have lost the response
1483 * (and a confirmation was requested) and maybe
1486 * If all data received, send SRR
1487 * asking for response. If partial data received,
1488 * or gaps, SRR requests data at start of gap.
1489 * Recovery via SRR relies on in-order-delivery.
1491 if (data_dir == DMA_TO_DEVICE) {
1492 r_ctl = FC_RCTL_DD_CMD_STATUS;
1493 } else if (fsp->xfer_contig_end == offset) {
1494 r_ctl = FC_RCTL_DD_CMD_STATUS;
1496 offset = fsp->xfer_contig_end;
1497 r_ctl = FC_RCTL_DD_SOL_DATA;
1499 fc_fcp_srr(fsp, r_ctl, offset);
1500 } else if (e_stat & ESB_ST_SEQ_INIT) {
1503 * The remote port has the initiative, so just
1504 * keep waiting for it to complete.
1506 fc_fcp_timer_set(fsp, FC_SCSI_REC_TOV);
1510 * The exchange is incomplete, we have seq. initiative.
1511 * Lost response with requested confirmation,
1512 * lost confirmation, lost transfer ready or
1515 * For output, if not all data was received, ask
1516 * for transfer ready to be repeated.
1518 * If we received or sent all the data, send SRR to
1521 * If we lost a response, we may have lost some read
1524 r_ctl = FC_RCTL_DD_SOL_DATA;
1525 if (data_dir == DMA_TO_DEVICE) {
1526 r_ctl = FC_RCTL_DD_CMD_STATUS;
1527 if (offset < fsp->data_len)
1528 r_ctl = FC_RCTL_DD_DATA_DESC;
1529 } else if (offset == fsp->xfer_contig_end) {
1530 r_ctl = FC_RCTL_DD_CMD_STATUS;
1531 } else if (fsp->xfer_contig_end < offset) {
1532 offset = fsp->xfer_contig_end;
1534 fc_fcp_srr(fsp, r_ctl, offset);
1538 fc_fcp_unlock_pkt(fsp);
1540 fc_fcp_pkt_release(fsp); /* drop hold for outstanding REC */
1545 * fc_fcp_rec_error() - Handler for REC errors
1546 * @fsp: The FCP packet the error is on
1547 * @fp: The REC frame
1549 static void fc_fcp_rec_error(struct fc_fcp_pkt *fsp, struct fc_frame *fp)
1551 int error = PTR_ERR(fp);
1553 if (fc_fcp_lock_pkt(fsp))
1558 fc_fcp_retry_cmd(fsp);
1562 FC_FCP_DBG(fsp, "REC %p fid %6.6x error unexpected error %d\n",
1563 fsp, fsp->rport->port_id, error);
1564 fsp->status_code = FC_CMD_PLOGO;
1567 case -FC_EX_TIMEOUT:
1569 * Assume REC or LS_ACC was lost.
1570 * The exchange manager will have aborted REC, so retry.
1572 FC_FCP_DBG(fsp, "REC fid %6.6x error error %d retry %d/%d\n",
1573 fsp->rport->port_id, error, fsp->recov_retry,
1574 FC_MAX_RECOV_RETRY);
1575 if (fsp->recov_retry++ < FC_MAX_RECOV_RETRY)
1578 fc_fcp_recovery(fsp);
1581 fc_fcp_unlock_pkt(fsp);
1583 fc_fcp_pkt_release(fsp); /* drop hold for outstanding REC */
1587 * fc_fcp_recovery() - Handler for fcp_pkt recovery
1588 * @fsp: The FCP pkt that needs to be aborted
1590 static void fc_fcp_recovery(struct fc_fcp_pkt *fsp)
1592 fsp->status_code = FC_CMD_RECOVERY;
1593 fsp->cdb_status = 0;
1596 * if this fails then we let the scsi command timer fire and
1599 fc_fcp_send_abort(fsp);
1603 * fc_fcp_srr() - Send a SRR request (Sequence Retransmission Request)
1604 * @fsp: The FCP packet the SRR is to be sent on
1605 * @r_ctl: The R_CTL field for the SRR request
1606 * This is called after receiving status but insufficient data, or
1607 * when expecting status but the request has timed out.
1609 static void fc_fcp_srr(struct fc_fcp_pkt *fsp, enum fc_rctl r_ctl, u32 offset)
1611 struct fc_lport *lport = fsp->lp;
1612 struct fc_rport *rport;
1613 struct fc_rport_libfc_priv *rpriv;
1614 struct fc_exch *ep = fc_seq_exch(fsp->seq_ptr);
1616 struct fcp_srr *srr;
1617 struct fc_frame *fp;
1621 rpriv = rport->dd_data;
1622 cdb_op = fsp->cdb_cmd.fc_cdb[0];
1624 if (!(rpriv->flags & FC_RP_FLAGS_RETRY) ||
1625 rpriv->rp_state != RPORT_ST_READY)
1626 goto retry; /* shouldn't happen */
1627 fp = fc_fcp_frame_alloc(lport, sizeof(*srr));
1631 srr = fc_frame_payload_get(fp, sizeof(*srr));
1632 memset(srr, 0, sizeof(*srr));
1633 srr->srr_op = ELS_SRR;
1634 srr->srr_ox_id = htons(ep->oxid);
1635 srr->srr_rx_id = htons(ep->rxid);
1636 srr->srr_r_ctl = r_ctl;
1637 srr->srr_rel_off = htonl(offset);
1639 fc_fill_fc_hdr(fp, FC_RCTL_ELS4_REQ, rport->port_id,
1640 rpriv->local_port->port_id, FC_TYPE_FCP,
1643 seq = lport->tt.exch_seq_send(lport, fp, fc_fcp_srr_resp, NULL,
1644 fsp, jiffies_to_msecs(FC_SCSI_REC_TOV));
1648 fsp->recov_seq = seq;
1649 fsp->xfer_len = offset;
1650 fsp->xfer_contig_end = offset;
1651 fsp->state &= ~FC_SRB_RCV_STATUS;
1652 fc_fcp_pkt_hold(fsp); /* hold for outstanding SRR */
1655 fc_fcp_retry_cmd(fsp);
1659 * fc_fcp_srr_resp() - Handler for SRR response
1660 * @seq: The sequence the SRR is on
1661 * @fp: The SRR frame
1662 * @arg: The FCP packet the SRR is on
1664 static void fc_fcp_srr_resp(struct fc_seq *seq, struct fc_frame *fp, void *arg)
1666 struct fc_fcp_pkt *fsp = arg;
1667 struct fc_frame_header *fh;
1670 fc_fcp_srr_error(fsp, fp);
1674 if (fc_fcp_lock_pkt(fsp))
1677 fh = fc_frame_header_get(fp);
1679 * BUG? fc_fcp_srr_error calls exch_done which would release
1680 * the ep. But if fc_fcp_srr_error had got -FC_EX_TIMEOUT,
1681 * then fc_exch_timeout would be sending an abort. The exch_done
1682 * call by fc_fcp_srr_error would prevent fc_exch.c from seeing
1683 * an abort response though.
1685 if (fh->fh_type == FC_TYPE_BLS) {
1686 fc_fcp_unlock_pkt(fsp);
1690 fsp->recov_seq = NULL;
1691 switch (fc_frame_payload_op(fp)) {
1693 fsp->recov_retry = 0;
1694 fc_fcp_timer_set(fsp, FC_SCSI_REC_TOV);
1698 fc_fcp_recovery(fsp);
1701 fc_fcp_unlock_pkt(fsp);
1702 fsp->lp->tt.exch_done(seq);
1705 fc_fcp_pkt_release(fsp); /* drop hold for outstanding SRR */
1709 * fc_fcp_srr_error() - Handler for SRR errors
1710 * @fsp: The FCP packet that the SRR error is on
1711 * @fp: The SRR frame
1713 static void fc_fcp_srr_error(struct fc_fcp_pkt *fsp, struct fc_frame *fp)
1715 if (fc_fcp_lock_pkt(fsp))
1717 fsp->lp->tt.exch_done(fsp->recov_seq);
1718 fsp->recov_seq = NULL;
1719 switch (PTR_ERR(fp)) {
1720 case -FC_EX_TIMEOUT:
1721 if (fsp->recov_retry++ < FC_MAX_RECOV_RETRY)
1724 fc_fcp_recovery(fsp);
1726 case -FC_EX_CLOSED: /* e.g., link failure */
1729 fc_fcp_retry_cmd(fsp);
1732 fc_fcp_unlock_pkt(fsp);
1734 fc_fcp_pkt_release(fsp); /* drop hold for outstanding SRR */
1738 * fc_fcp_lport_queue_ready() - Determine if the lport and it's queue is ready
1739 * @lport: The local port to be checked
1741 static inline int fc_fcp_lport_queue_ready(struct fc_lport *lport)
1744 return (lport->state == LPORT_ST_READY) &&
1745 lport->link_up && !lport->qfull;
1749 * fc_queuecommand() - The queuecommand function of the SCSI template
1750 * @cmd: The scsi_cmnd to be executed
1751 * @done: The callback function to be called when the scsi_cmnd is complete
1753 * This is the i/o strategy routine, called by the SCSI layer. This routine
1754 * is called with the host_lock held.
1756 int fc_queuecommand(struct scsi_cmnd *sc_cmd, void (*done)(struct scsi_cmnd *))
1758 struct fc_lport *lport;
1759 struct fc_rport *rport = starget_to_rport(scsi_target(sc_cmd->device));
1760 struct fc_fcp_pkt *fsp;
1761 struct fc_rport_libfc_priv *rpriv;
1764 struct fcoe_dev_stats *stats;
1766 lport = shost_priv(sc_cmd->device->host);
1768 rval = fc_remote_port_chkready(rport);
1770 sc_cmd->result = rval;
1774 spin_unlock_irq(lport->host->host_lock);
1776 if (!*(struct fc_remote_port **)rport->dd_data) {
1778 * rport is transitioning from blocked/deleted to
1781 sc_cmd->result = DID_IMM_RETRY << 16;
1786 rpriv = rport->dd_data;
1788 if (!fc_fcp_lport_queue_ready(lport)) {
1790 fc_fcp_can_queue_ramp_down(lport);
1791 rc = SCSI_MLQUEUE_HOST_BUSY;
1795 fsp = fc_fcp_pkt_alloc(lport, GFP_ATOMIC);
1797 rc = SCSI_MLQUEUE_HOST_BUSY;
1802 * build the libfc request pkt
1804 fsp->cmd = sc_cmd; /* save the cmd */
1805 fsp->lp = lport; /* save the softc ptr */
1806 fsp->rport = rport; /* set the remote port ptr */
1807 fsp->xfer_ddp = FC_XID_UNKNOWN;
1808 sc_cmd->scsi_done = done;
1811 * set up the transfer length
1813 fsp->data_len = scsi_bufflen(sc_cmd);
1817 * setup the data direction
1819 stats = per_cpu_ptr(lport->dev_stats, get_cpu());
1820 if (sc_cmd->sc_data_direction == DMA_FROM_DEVICE) {
1821 fsp->req_flags = FC_SRB_READ;
1822 stats->InputRequests++;
1823 stats->InputMegabytes = fsp->data_len;
1824 } else if (sc_cmd->sc_data_direction == DMA_TO_DEVICE) {
1825 fsp->req_flags = FC_SRB_WRITE;
1826 stats->OutputRequests++;
1827 stats->OutputMegabytes = fsp->data_len;
1830 stats->ControlRequests++;
1834 fsp->tgt_flags = rpriv->flags;
1836 init_timer(&fsp->timer);
1837 fsp->timer.data = (unsigned long)fsp;
1840 * send it to the lower layer
1841 * if we get -1 return then put the request in the pending
1844 rval = fc_fcp_pkt_send(lport, fsp);
1846 fsp->state = FC_SRB_FREE;
1847 fc_fcp_pkt_release(fsp);
1848 rc = SCSI_MLQUEUE_HOST_BUSY;
1851 spin_lock_irq(lport->host->host_lock);
1854 EXPORT_SYMBOL(fc_queuecommand);
1857 * fc_io_compl() - Handle responses for completed commands
1858 * @fsp: The FCP packet that is complete
1860 * Translates fcp_pkt errors to a Linux SCSI errors.
1861 * The fcp packet lock must be held when calling.
1863 static void fc_io_compl(struct fc_fcp_pkt *fsp)
1865 struct fc_fcp_internal *si;
1866 struct scsi_cmnd *sc_cmd;
1867 struct fc_lport *lport;
1868 unsigned long flags;
1870 /* release outstanding ddp context */
1871 fc_fcp_ddp_done(fsp);
1873 fsp->state |= FC_SRB_COMPL;
1874 if (!(fsp->state & FC_SRB_FCP_PROCESSING_TMO)) {
1875 spin_unlock_bh(&fsp->scsi_pkt_lock);
1876 del_timer_sync(&fsp->timer);
1877 spin_lock_bh(&fsp->scsi_pkt_lock);
1881 si = fc_get_scsi_internal(lport);
1884 * if can_queue ramp down is done then try can_queue ramp up
1885 * since commands are completing now.
1887 if (si->last_can_queue_ramp_down_time)
1888 fc_fcp_can_queue_ramp_up(lport);
1891 CMD_SCSI_STATUS(sc_cmd) = fsp->cdb_status;
1892 switch (fsp->status_code) {
1894 if (fsp->cdb_status == 0) {
1898 sc_cmd->result = DID_OK << 16;
1899 if (fsp->scsi_resid)
1900 CMD_RESID_LEN(sc_cmd) = fsp->scsi_resid;
1903 * transport level I/O was ok but scsi
1904 * has non zero status
1906 sc_cmd->result = (DID_OK << 16) | fsp->cdb_status;
1910 FC_FCP_DBG(fsp, "Returning DID_ERROR to scsi-ml "
1911 "due to FC_ERROR\n");
1912 sc_cmd->result = DID_ERROR << 16;
1914 case FC_DATA_UNDRUN:
1915 if ((fsp->cdb_status == 0) && !(fsp->req_flags & FC_SRB_READ)) {
1917 * scsi status is good but transport level
1920 if (fsp->state & FC_SRB_RCV_STATUS) {
1921 sc_cmd->result = DID_OK << 16;
1923 FC_FCP_DBG(fsp, "Returning DID_ERROR to scsi-ml"
1924 " due to FC_DATA_UNDRUN (trans)\n");
1925 sc_cmd->result = DID_ERROR << 16;
1929 * scsi got underrun, this is an error
1931 FC_FCP_DBG(fsp, "Returning DID_ERROR to scsi-ml "
1932 "due to FC_DATA_UNDRUN (scsi)\n");
1933 CMD_RESID_LEN(sc_cmd) = fsp->scsi_resid;
1934 sc_cmd->result = (DID_ERROR << 16) | fsp->cdb_status;
1937 case FC_DATA_OVRRUN:
1939 * overrun is an error
1941 FC_FCP_DBG(fsp, "Returning DID_ERROR to scsi-ml "
1942 "due to FC_DATA_OVRRUN\n");
1943 sc_cmd->result = (DID_ERROR << 16) | fsp->cdb_status;
1945 case FC_CMD_ABORTED:
1946 FC_FCP_DBG(fsp, "Returning DID_ERROR to scsi-ml "
1947 "due to FC_CMD_ABORTED\n");
1948 sc_cmd->result = (DID_ERROR << 16) | fsp->io_status;
1950 case FC_CMD_RECOVERY:
1951 sc_cmd->result = (DID_BUS_BUSY << 16) | fsp->io_status;
1954 sc_cmd->result = (DID_RESET << 16);
1957 sc_cmd->result = (DID_NO_CONNECT << 16);
1960 FC_FCP_DBG(fsp, "Returning DID_ERROR to scsi-ml "
1961 "due to unknown error\n");
1962 sc_cmd->result = (DID_ERROR << 16);
1966 if (lport->state != LPORT_ST_READY && fsp->status_code != FC_COMPLETE)
1967 sc_cmd->result = (DID_TRANSPORT_DISRUPTED << 16);
1969 spin_lock_irqsave(&si->scsi_queue_lock, flags);
1970 list_del(&fsp->list);
1971 sc_cmd->SCp.ptr = NULL;
1972 spin_unlock_irqrestore(&si->scsi_queue_lock, flags);
1973 sc_cmd->scsi_done(sc_cmd);
1975 /* release ref from initial allocation in queue command */
1976 fc_fcp_pkt_release(fsp);
1980 * fc_eh_abort() - Abort a command
1981 * @sc_cmd: The SCSI command to abort
1983 * From SCSI host template.
1984 * Send an ABTS to the target device and wait for the response.
1986 int fc_eh_abort(struct scsi_cmnd *sc_cmd)
1988 struct fc_fcp_pkt *fsp;
1989 struct fc_lport *lport;
1990 struct fc_fcp_internal *si;
1992 unsigned long flags;
1994 lport = shost_priv(sc_cmd->device->host);
1995 if (lport->state != LPORT_ST_READY)
1997 else if (!lport->link_up)
2000 si = fc_get_scsi_internal(lport);
2001 spin_lock_irqsave(&si->scsi_queue_lock, flags);
2002 fsp = CMD_SP(sc_cmd);
2004 /* command completed while scsi eh was setting up */
2005 spin_unlock_irqrestore(lport->host->host_lock, flags);
2008 /* grab a ref so the fsp and sc_cmd cannot be relased from under us */
2009 fc_fcp_pkt_hold(fsp);
2010 spin_unlock_irqrestore(&si->scsi_queue_lock, flags);
2012 if (fc_fcp_lock_pkt(fsp)) {
2013 /* completed while we were waiting for timer to be deleted */
2018 rc = fc_fcp_pkt_abort(fsp);
2019 fc_fcp_unlock_pkt(fsp);
2022 fc_fcp_pkt_release(fsp);
2025 EXPORT_SYMBOL(fc_eh_abort);
2028 * fc_eh_device_reset() - Reset a single LUN
2029 * @sc_cmd: The SCSI command which identifies the device whose
2030 * LUN is to be reset
2032 * Set from SCSI host template.
2034 int fc_eh_device_reset(struct scsi_cmnd *sc_cmd)
2036 struct fc_lport *lport;
2037 struct fc_fcp_pkt *fsp;
2038 struct fc_rport *rport = starget_to_rport(scsi_target(sc_cmd->device));
2042 rval = fc_remote_port_chkready(rport);
2046 lport = shost_priv(sc_cmd->device->host);
2048 if (lport->state != LPORT_ST_READY)
2051 FC_SCSI_DBG(lport, "Resetting rport (%6.6x)\n", rport->port_id);
2053 fsp = fc_fcp_pkt_alloc(lport, GFP_NOIO);
2055 printk(KERN_WARNING "libfc: could not allocate scsi_pkt\n");
2060 * Build the libfc request pkt. Do not set the scsi cmnd, because
2061 * the sc passed in is not setup for execution like when sent
2062 * through the queuecommand callout.
2064 fsp->lp = lport; /* save the softc ptr */
2065 fsp->rport = rport; /* set the remote port ptr */
2068 * flush outstanding commands
2070 rc = fc_lun_reset(lport, fsp, scmd_id(sc_cmd), sc_cmd->device->lun);
2071 fsp->state = FC_SRB_FREE;
2072 fc_fcp_pkt_release(fsp);
2077 EXPORT_SYMBOL(fc_eh_device_reset);
2080 * fc_eh_host_reset() - Reset a Scsi_Host.
2081 * @sc_cmd: The SCSI command that identifies the SCSI host to be reset
2083 int fc_eh_host_reset(struct scsi_cmnd *sc_cmd)
2085 struct Scsi_Host *shost = sc_cmd->device->host;
2086 struct fc_lport *lport = shost_priv(shost);
2087 unsigned long wait_tmo;
2089 FC_SCSI_DBG(lport, "Resetting host\n");
2091 lport->tt.lport_reset(lport);
2092 wait_tmo = jiffies + FC_HOST_RESET_TIMEOUT;
2093 while (!fc_fcp_lport_queue_ready(lport) && time_before(jiffies,
2097 if (fc_fcp_lport_queue_ready(lport)) {
2098 shost_printk(KERN_INFO, shost, "libfc: Host reset succeeded "
2099 "on port (%6.6x)\n", lport->port_id);
2102 shost_printk(KERN_INFO, shost, "libfc: Host reset failed, "
2103 "port (%6.6x) is not ready.\n",
2108 EXPORT_SYMBOL(fc_eh_host_reset);
2111 * fc_slave_alloc() - Configure the queue depth of a Scsi_Host
2112 * @sdev: The SCSI device that identifies the SCSI host
2114 * Configures queue depth based on host's cmd_per_len. If not set
2115 * then we use the libfc default.
2117 int fc_slave_alloc(struct scsi_device *sdev)
2119 struct fc_rport *rport = starget_to_rport(scsi_target(sdev));
2121 if (!rport || fc_remote_port_chkready(rport))
2124 if (sdev->tagged_supported)
2125 scsi_activate_tcq(sdev, FC_FCP_DFLT_QUEUE_DEPTH);
2127 scsi_adjust_queue_depth(sdev, scsi_get_tag_type(sdev),
2128 FC_FCP_DFLT_QUEUE_DEPTH);
2132 EXPORT_SYMBOL(fc_slave_alloc);
2135 * fc_change_queue_depth() - Change a device's queue depth
2136 * @sdev: The SCSI device whose queue depth is to change
2137 * @qdepth: The new queue depth
2138 * @reason: The resason for the change
2140 int fc_change_queue_depth(struct scsi_device *sdev, int qdepth, int reason)
2143 case SCSI_QDEPTH_DEFAULT:
2144 scsi_adjust_queue_depth(sdev, scsi_get_tag_type(sdev), qdepth);
2146 case SCSI_QDEPTH_QFULL:
2147 scsi_track_queue_full(sdev, qdepth);
2149 case SCSI_QDEPTH_RAMP_UP:
2150 scsi_adjust_queue_depth(sdev, scsi_get_tag_type(sdev), qdepth);
2155 return sdev->queue_depth;
2157 EXPORT_SYMBOL(fc_change_queue_depth);
2160 * fc_change_queue_type() - Change a device's queue type
2161 * @sdev: The SCSI device whose queue depth is to change
2162 * @tag_type: Identifier for queue type
2164 int fc_change_queue_type(struct scsi_device *sdev, int tag_type)
2166 if (sdev->tagged_supported) {
2167 scsi_set_tag_type(sdev, tag_type);
2169 scsi_activate_tcq(sdev, sdev->queue_depth);
2171 scsi_deactivate_tcq(sdev, sdev->queue_depth);
2177 EXPORT_SYMBOL(fc_change_queue_type);
2180 * fc_fcp_destory() - Tear down the FCP layer for a given local port
2181 * @lport: The local port that no longer needs the FCP layer
2183 void fc_fcp_destroy(struct fc_lport *lport)
2185 struct fc_fcp_internal *si = fc_get_scsi_internal(lport);
2187 if (!list_empty(&si->scsi_pkt_queue))
2188 printk(KERN_ERR "libfc: Leaked SCSI packets when destroying "
2189 "port (%6.6x)\n", lport->port_id);
2191 mempool_destroy(si->scsi_pkt_pool);
2193 lport->scsi_priv = NULL;
2195 EXPORT_SYMBOL(fc_fcp_destroy);
2201 scsi_pkt_cachep = kmem_cache_create("libfc_fcp_pkt",
2202 sizeof(struct fc_fcp_pkt),
2203 0, SLAB_HWCACHE_ALIGN, NULL);
2204 if (!scsi_pkt_cachep) {
2205 printk(KERN_ERR "libfc: Unable to allocate SRB cache, "
2206 "module load failed!");
2213 void fc_destroy_fcp()
2215 if (scsi_pkt_cachep)
2216 kmem_cache_destroy(scsi_pkt_cachep);
2220 * fc_fcp_init() - Initialize the FCP layer for a local port
2221 * @lport: The local port to initialize the exchange layer for
2223 int fc_fcp_init(struct fc_lport *lport)
2226 struct fc_fcp_internal *si;
2228 if (!lport->tt.fcp_cmd_send)
2229 lport->tt.fcp_cmd_send = fc_fcp_cmd_send;
2231 if (!lport->tt.fcp_cleanup)
2232 lport->tt.fcp_cleanup = fc_fcp_cleanup;
2234 if (!lport->tt.fcp_abort_io)
2235 lport->tt.fcp_abort_io = fc_fcp_abort_io;
2237 si = kzalloc(sizeof(struct fc_fcp_internal), GFP_KERNEL);
2240 lport->scsi_priv = si;
2241 si->max_can_queue = lport->host->can_queue;
2242 INIT_LIST_HEAD(&si->scsi_pkt_queue);
2243 spin_lock_init(&si->scsi_queue_lock);
2245 si->scsi_pkt_pool = mempool_create_slab_pool(2, scsi_pkt_cachep);
2246 if (!si->scsi_pkt_pool) {
2256 EXPORT_SYMBOL(fc_fcp_init);