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>
31 #include <scsi/scsi_tcq.h>
32 #include <scsi/scsi.h>
33 #include <scsi/scsi_host.h>
34 #include <scsi/scsi_device.h>
35 #include <scsi/scsi_cmnd.h>
37 #include <scsi/fc/fc_fc2.h>
39 #include <scsi/libfc.h>
40 #include <scsi/fc_encode.h>
42 MODULE_AUTHOR("Open-FCoE.org");
43 MODULE_DESCRIPTION("libfc");
44 MODULE_LICENSE("GPL v2");
46 unsigned int fc_debug_logging
;
47 module_param_named(debug_logging
, fc_debug_logging
, int, S_IRUGO
|S_IWUSR
);
48 MODULE_PARM_DESC(debug_logging
, "a bit mask of logging levels");
50 static struct kmem_cache
*scsi_pkt_cachep
;
52 /* SRB state definitions */
53 #define FC_SRB_FREE 0 /* cmd is free */
54 #define FC_SRB_CMD_SENT (1 << 0) /* cmd has been sent */
55 #define FC_SRB_RCV_STATUS (1 << 1) /* response has arrived */
56 #define FC_SRB_ABORT_PENDING (1 << 2) /* cmd abort sent to device */
57 #define FC_SRB_ABORTED (1 << 3) /* abort acknowleged */
58 #define FC_SRB_DISCONTIG (1 << 4) /* non-sequential data recvd */
59 #define FC_SRB_COMPL (1 << 5) /* fc_io_compl has been run */
60 #define FC_SRB_FCP_PROCESSING_TMO (1 << 6) /* timer function processing */
61 #define FC_SRB_NOMEM (1 << 7) /* dropped to out of mem */
63 #define FC_SRB_READ (1 << 1)
64 #define FC_SRB_WRITE (1 << 0)
67 * The SCp.ptr should be tested and set under the host lock. NULL indicates
68 * that the command has been retruned to the scsi layer.
70 #define CMD_SP(Cmnd) ((struct fc_fcp_pkt *)(Cmnd)->SCp.ptr)
71 #define CMD_ENTRY_STATUS(Cmnd) ((Cmnd)->SCp.have_data_in)
72 #define CMD_COMPL_STATUS(Cmnd) ((Cmnd)->SCp.this_residual)
73 #define CMD_SCSI_STATUS(Cmnd) ((Cmnd)->SCp.Status)
74 #define CMD_RESID_LEN(Cmnd) ((Cmnd)->SCp.buffers_residual)
76 struct fc_fcp_internal
{
77 mempool_t
*scsi_pkt_pool
;
78 struct list_head scsi_pkt_queue
;
82 #define fc_get_scsi_internal(x) ((struct fc_fcp_internal *)(x)->scsi_priv)
86 * FC scsi I/O related functions
88 static void fc_fcp_recv_data(struct fc_fcp_pkt
*, struct fc_frame
*);
89 static void fc_fcp_recv(struct fc_seq
*, struct fc_frame
*, void *);
90 static void fc_fcp_resp(struct fc_fcp_pkt
*, struct fc_frame
*);
91 static void fc_fcp_complete_locked(struct fc_fcp_pkt
*);
92 static void fc_tm_done(struct fc_seq
*, struct fc_frame
*, void *);
93 static void fc_fcp_error(struct fc_fcp_pkt
*fsp
, struct fc_frame
*fp
);
94 static void fc_timeout_error(struct fc_fcp_pkt
*);
95 static void fc_fcp_timeout(unsigned long data
);
96 static void fc_fcp_rec(struct fc_fcp_pkt
*);
97 static void fc_fcp_rec_error(struct fc_fcp_pkt
*, struct fc_frame
*);
98 static void fc_fcp_rec_resp(struct fc_seq
*, struct fc_frame
*, void *);
99 static void fc_io_compl(struct fc_fcp_pkt
*);
101 static void fc_fcp_srr(struct fc_fcp_pkt
*, enum fc_rctl
, u32
);
102 static void fc_fcp_srr_resp(struct fc_seq
*, struct fc_frame
*, void *);
103 static void fc_fcp_srr_error(struct fc_fcp_pkt
*, struct fc_frame
*);
106 * command status codes
108 #define FC_COMPLETE 0
109 #define FC_CMD_ABORTED 1
110 #define FC_CMD_RESET 2
111 #define FC_CMD_PLOGO 3
113 #define FC_TRANS_ERR 5
114 #define FC_DATA_OVRRUN 6
115 #define FC_DATA_UNDRUN 7
117 #define FC_HRD_ERROR 9
118 #define FC_CMD_TIME_OUT 10
121 * Error recovery timeout values.
123 #define FC_SCSI_ER_TIMEOUT (10 * HZ)
124 #define FC_SCSI_TM_TOV (10 * HZ)
125 #define FC_SCSI_REC_TOV (2 * HZ)
126 #define FC_HOST_RESET_TIMEOUT (30 * HZ)
128 #define FC_MAX_ERROR_CNT 5
129 #define FC_MAX_RECOV_RETRY 3
131 #define FC_FCP_DFLT_QUEUE_DEPTH 32
134 * fc_fcp_pkt_alloc - allocation routine for scsi_pkt packet
135 * @lp: fc lport struct
136 * @gfp: gfp flags for allocation
138 * This is used by upper layer scsi driver.
139 * Return Value : scsi_pkt structure or null on allocation failure.
140 * Context : call from process context. no locking required.
142 static struct fc_fcp_pkt
*fc_fcp_pkt_alloc(struct fc_lport
*lp
, gfp_t gfp
)
144 struct fc_fcp_internal
*si
= fc_get_scsi_internal(lp
);
145 struct fc_fcp_pkt
*fsp
;
147 fsp
= mempool_alloc(si
->scsi_pkt_pool
, gfp
);
149 memset(fsp
, 0, sizeof(*fsp
));
151 atomic_set(&fsp
->ref_cnt
, 1);
152 init_timer(&fsp
->timer
);
153 INIT_LIST_HEAD(&fsp
->list
);
154 spin_lock_init(&fsp
->scsi_pkt_lock
);
160 * fc_fcp_pkt_release() - release hold on scsi_pkt packet
161 * @fsp: fcp packet struct
163 * This is used by upper layer scsi driver.
164 * Context : call from process and interrupt context.
165 * no locking required
167 static void fc_fcp_pkt_release(struct fc_fcp_pkt
*fsp
)
169 if (atomic_dec_and_test(&fsp
->ref_cnt
)) {
170 struct fc_fcp_internal
*si
= fc_get_scsi_internal(fsp
->lp
);
172 mempool_free(fsp
, si
->scsi_pkt_pool
);
176 static void fc_fcp_pkt_hold(struct fc_fcp_pkt
*fsp
)
178 atomic_inc(&fsp
->ref_cnt
);
182 * fc_fcp_pkt_destory() - release hold on scsi_pkt packet
183 * @seq: exchange sequence
184 * @fsp: fcp packet struct
186 * Release hold on scsi_pkt packet set to keep scsi_pkt
187 * till EM layer exch resource is not freed.
188 * Context : called from from EM layer.
189 * no locking required
191 static void fc_fcp_pkt_destroy(struct fc_seq
*seq
, void *fsp
)
193 fc_fcp_pkt_release(fsp
);
197 * fc_fcp_lock_pkt() - lock a packet and get a ref to it.
200 * We should only return error if we return a command to scsi-ml before
201 * getting a response. This can happen in cases where we send a abort, but
202 * do not wait for the response and the abort and command can be passing
203 * each other on the wire/network-layer.
205 * Note: this function locks the packet and gets a reference to allow
206 * callers to call the completion function while the lock is held and
207 * not have to worry about the packets refcount.
209 * TODO: Maybe we should just have callers grab/release the lock and
210 * have a function that they call to verify the fsp and grab a ref if
213 static inline int fc_fcp_lock_pkt(struct fc_fcp_pkt
*fsp
)
215 spin_lock_bh(&fsp
->scsi_pkt_lock
);
216 if (fsp
->state
& FC_SRB_COMPL
) {
217 spin_unlock_bh(&fsp
->scsi_pkt_lock
);
221 fc_fcp_pkt_hold(fsp
);
225 static inline void fc_fcp_unlock_pkt(struct fc_fcp_pkt
*fsp
)
227 spin_unlock_bh(&fsp
->scsi_pkt_lock
);
228 fc_fcp_pkt_release(fsp
);
231 static void fc_fcp_timer_set(struct fc_fcp_pkt
*fsp
, unsigned long delay
)
233 if (!(fsp
->state
& FC_SRB_COMPL
))
234 mod_timer(&fsp
->timer
, jiffies
+ delay
);
237 static int fc_fcp_send_abort(struct fc_fcp_pkt
*fsp
)
242 fsp
->state
|= FC_SRB_ABORT_PENDING
;
243 return fsp
->lp
->tt
.seq_exch_abort(fsp
->seq_ptr
, 0);
248 * An abort isn't needed.
250 static void fc_fcp_retry_cmd(struct fc_fcp_pkt
*fsp
)
253 fsp
->lp
->tt
.exch_done(fsp
->seq_ptr
);
257 fsp
->state
&= ~FC_SRB_ABORT_PENDING
;
259 fsp
->status_code
= FC_ERROR
;
260 fc_fcp_complete_locked(fsp
);
264 * fc_fcp_ddp_setup - calls to LLD's ddp_setup to set up DDP
265 * transfer for a read I/O indicated by the fc_fcp_pkt.
266 * @fsp: ptr to the fc_fcp_pkt
268 * This is called in exch_seq_send() when we have a newly allocated
269 * exchange with a valid exchange id to setup ddp.
273 void fc_fcp_ddp_setup(struct fc_fcp_pkt
*fsp
, u16 xid
)
281 if ((fsp
->req_flags
& FC_SRB_READ
) &&
282 (lp
->lro_enabled
) && (lp
->tt
.ddp_setup
)) {
283 if (lp
->tt
.ddp_setup(lp
, xid
, scsi_sglist(fsp
->cmd
),
284 scsi_sg_count(fsp
->cmd
)))
290 * fc_fcp_ddp_done - calls to LLD's ddp_done to release any
291 * DDP related resources for this I/O if it is initialized
293 * @fsp: ptr to the fc_fcp_pkt
297 static void fc_fcp_ddp_done(struct fc_fcp_pkt
*fsp
)
304 if (fsp
->xfer_ddp
== FC_XID_UNKNOWN
)
308 if (lp
->tt
.ddp_done
) {
309 fsp
->xfer_len
= lp
->tt
.ddp_done(lp
, fsp
->xfer_ddp
);
310 fsp
->xfer_ddp
= FC_XID_UNKNOWN
;
316 * Receive SCSI data from target.
317 * Called after receiving solicited data.
319 static void fc_fcp_recv_data(struct fc_fcp_pkt
*fsp
, struct fc_frame
*fp
)
321 struct scsi_cmnd
*sc
= fsp
->cmd
;
322 struct fc_lport
*lp
= fsp
->lp
;
323 struct fcoe_dev_stats
*stats
;
324 struct fc_frame_header
*fh
;
331 struct scatterlist
*sg
;
334 fh
= fc_frame_header_get(fp
);
335 offset
= ntohl(fh
->fh_parm_offset
);
336 start_offset
= offset
;
337 len
= fr_len(fp
) - sizeof(*fh
);
338 buf
= fc_frame_payload_get(fp
, 0);
340 /* if this I/O is ddped, update xfer len */
341 fc_fcp_ddp_done(fsp
);
343 if (offset
+ len
> fsp
->data_len
) {
344 /* this should never happen */
345 if ((fr_flags(fp
) & FCPHF_CRC_UNCHECKED
) &&
346 fc_frame_crc_check(fp
))
348 FC_FCP_DBG(fsp
, "data received past end. len %zx offset %zx "
349 "data_len %x\n", len
, offset
, fsp
->data_len
);
350 fc_fcp_retry_cmd(fsp
);
353 if (offset
!= fsp
->xfer_len
)
354 fsp
->state
|= FC_SRB_DISCONTIG
;
357 if (fr_flags(fp
) & FCPHF_CRC_UNCHECKED
)
358 crc
= crc32(~0, (u8
*) fh
, sizeof(*fh
));
360 sg
= scsi_sglist(sc
);
363 while (remaining
> 0 && sg
) {
368 if (offset
>= sg
->length
) {
369 offset
-= sg
->length
;
373 sg_bytes
= min(remaining
, sg
->length
- offset
);
376 * The scatterlist item may be bigger than PAGE_SIZE,
377 * but we are limited to mapping PAGE_SIZE at a time.
379 off
= offset
+ sg
->offset
;
380 sg_bytes
= min(sg_bytes
, (size_t)
381 (PAGE_SIZE
- (off
& ~PAGE_MASK
)));
382 page_addr
= kmap_atomic(sg_page(sg
) + (off
>> PAGE_SHIFT
),
385 break; /* XXX panic? */
387 if (fr_flags(fp
) & FCPHF_CRC_UNCHECKED
)
388 crc
= crc32(crc
, buf
, sg_bytes
);
389 memcpy((char *)page_addr
+ (off
& ~PAGE_MASK
), buf
,
392 kunmap_atomic(page_addr
, KM_SOFTIRQ0
);
395 remaining
-= sg_bytes
;
396 copy_len
+= sg_bytes
;
399 if (fr_flags(fp
) & FCPHF_CRC_UNCHECKED
) {
400 buf
= fc_frame_payload_get(fp
, 0);
402 crc
= crc32(crc
, buf
+ len
, 4 - (len
% 4));
403 len
+= 4 - (len
% 4);
406 if (~crc
!= le32_to_cpu(fr_crc(fp
))) {
408 stats
= fc_lport_get_stats(lp
);
409 stats
->ErrorFrames
++;
410 /* FIXME - per cpu count, not total count! */
411 if (stats
->InvalidCRCCount
++ < 5)
412 printk(KERN_WARNING
"libfc: CRC error on data "
413 "frame for port (%6x)\n",
414 fc_host_port_id(lp
->host
));
416 * Assume the frame is total garbage.
417 * We may have copied it over the good part
419 * If so, we need to retry the entire operation.
420 * Otherwise, ignore it.
422 if (fsp
->state
& FC_SRB_DISCONTIG
)
423 fc_fcp_retry_cmd(fsp
);
428 if (fsp
->xfer_contig_end
== start_offset
)
429 fsp
->xfer_contig_end
+= copy_len
;
430 fsp
->xfer_len
+= copy_len
;
433 * In the very rare event that this data arrived after the response
434 * and completes the transfer, call the completion handler.
436 if (unlikely(fsp
->state
& FC_SRB_RCV_STATUS
) &&
437 fsp
->xfer_len
== fsp
->data_len
- fsp
->scsi_resid
)
438 fc_fcp_complete_locked(fsp
);
442 * fc_fcp_send_data() - Send SCSI data to target.
443 * @fsp: ptr to fc_fcp_pkt
444 * @sp: ptr to this sequence
445 * @offset: starting offset for this data request
446 * @seq_blen: the burst length for this data request
448 * Called after receiving a Transfer Ready data descriptor.
449 * if LLD is capable of seq offload then send down seq_blen
450 * size of data in single frame, otherwise send multiple FC
451 * frames of max FC frame payload supported by target port.
453 * Returns : 0 for success.
455 static int fc_fcp_send_data(struct fc_fcp_pkt
*fsp
, struct fc_seq
*seq
,
456 size_t offset
, size_t seq_blen
)
459 struct scsi_cmnd
*sc
;
460 struct scatterlist
*sg
;
461 struct fc_frame
*fp
= NULL
;
462 struct fc_lport
*lp
= fsp
->lp
;
467 size_t frame_offset
, fh_parm_offset
;
471 int using_sg
= lp
->sg_supp
;
474 WARN_ON(seq_blen
<= 0);
475 if (unlikely(offset
+ seq_blen
> fsp
->data_len
)) {
476 /* this should never happen */
477 FC_FCP_DBG(fsp
, "xfer-ready past end. seq_blen %zx "
478 "offset %zx\n", seq_blen
, offset
);
479 fc_fcp_send_abort(fsp
);
481 } else if (offset
!= fsp
->xfer_len
) {
482 /* Out of Order Data Request - no problem, but unexpected. */
483 FC_FCP_DBG(fsp
, "xfer-ready non-contiguous. "
484 "seq_blen %zx offset %zx\n", seq_blen
, offset
);
488 * if LLD is capable of seq_offload then set transport
489 * burst length (t_blen) to seq_blen, otherwise set t_blen
490 * to max FC frame payload previously set in fsp->max_payload.
492 t_blen
= fsp
->max_payload
;
493 if (lp
->seq_offload
) {
494 t_blen
= min(seq_blen
, (size_t)lp
->lso_max
);
495 FC_FCP_DBG(fsp
, "fsp=%p:lso:blen=%zx lso_max=0x%x t_blen=%zx\n",
496 fsp
, seq_blen
, lp
->lso_max
, t_blen
);
499 WARN_ON(t_blen
< FC_MIN_MAX_PAYLOAD
);
501 t_blen
&= ~(512 - 1); /* round down to block size */
502 WARN_ON(t_blen
< FC_MIN_MAX_PAYLOAD
); /* won't go below 256 */
505 remaining
= seq_blen
;
506 fh_parm_offset
= frame_offset
= offset
;
508 seq
= lp
->tt
.seq_start_next(seq
);
509 f_ctl
= FC_FC_REL_OFF
;
512 sg
= scsi_sglist(sc
);
514 while (remaining
> 0 && sg
) {
515 if (offset
>= sg
->length
) {
516 offset
-= sg
->length
;
521 tlen
= min(t_blen
, remaining
);
524 * TODO. Temporary workaround. fc_seq_send() can't
525 * handle odd lengths in non-linear skbs.
526 * This will be the final fragment only.
531 fp
= _fc_frame_alloc(lp
, 0);
535 fp
= fc_frame_alloc(lp
, tlen
);
539 data
= (void *)(fr_hdr(fp
)) +
540 sizeof(struct fc_frame_header
);
542 fh_parm_offset
= frame_offset
;
543 fr_max_payload(fp
) = fsp
->max_payload
;
545 sg_bytes
= min(tlen
, sg
->length
- offset
);
547 get_page(sg_page(sg
));
548 skb_fill_page_desc(fp_skb(fp
),
549 skb_shinfo(fp_skb(fp
))->nr_frags
,
550 sg_page(sg
), sg
->offset
+ offset
,
552 fp_skb(fp
)->data_len
+= sg_bytes
;
553 fr_len(fp
) += sg_bytes
;
554 fp_skb(fp
)->truesize
+= PAGE_SIZE
;
556 size_t off
= offset
+ sg
->offset
;
559 * The scatterlist item may be bigger than PAGE_SIZE,
560 * but we must not cross pages inside the kmap.
562 sg_bytes
= min(sg_bytes
, (size_t) (PAGE_SIZE
-
563 (off
& ~PAGE_MASK
)));
564 page_addr
= kmap_atomic(sg_page(sg
) +
567 memcpy(data
, (char *)page_addr
+ (off
& ~PAGE_MASK
),
569 kunmap_atomic(page_addr
, KM_SOFTIRQ0
);
573 frame_offset
+= sg_bytes
;
575 remaining
-= sg_bytes
;
577 if ((skb_shinfo(fp_skb(fp
))->nr_frags
< FC_FRAME_SG_LEN
) &&
582 * Send sequence with transfer sequence initiative in case
583 * this is last FCP frame of the sequence.
586 f_ctl
|= FC_FC_SEQ_INIT
| FC_FC_END_SEQ
;
588 ep
= fc_seq_exch(seq
);
589 fc_fill_fc_hdr(fp
, FC_RCTL_DD_SOL_DATA
, ep
->did
, ep
->sid
,
590 FC_TYPE_FCP
, f_ctl
, fh_parm_offset
);
593 * send fragment using for a sequence.
595 error
= lp
->tt
.seq_send(lp
, seq
, fp
);
597 WARN_ON(1); /* send error should be rare */
598 fc_fcp_retry_cmd(fsp
);
603 fsp
->xfer_len
+= seq_blen
; /* premature count? */
607 static void fc_fcp_abts_resp(struct fc_fcp_pkt
*fsp
, struct fc_frame
*fp
)
610 struct fc_ba_rjt
*brp
;
611 struct fc_frame_header
*fh
;
613 fh
= fc_frame_header_get(fp
);
614 switch (fh
->fh_r_ctl
) {
618 brp
= fc_frame_payload_get(fp
, sizeof(*brp
));
619 if (brp
&& brp
->br_reason
== FC_BA_RJT_LOG_ERR
)
624 * we will let the command timeout
625 * and scsi-ml recover in this case,
626 * therefore cleared the ba_done flag.
632 fsp
->state
|= FC_SRB_ABORTED
;
633 fsp
->state
&= ~FC_SRB_ABORT_PENDING
;
635 if (fsp
->wait_for_comp
)
636 complete(&fsp
->tm_done
);
638 fc_fcp_complete_locked(fsp
);
643 * fc_fcp_reduce_can_queue() - drop can_queue
644 * @lp: lport to drop queueing for
646 * If we are getting memory allocation failures, then we may
647 * be trying to execute too many commands. We let the running
648 * commands complete or timeout, then try again with a reduced
649 * can_queue. Eventually we will hit the point where we run
650 * on all reserved structs.
652 static void fc_fcp_reduce_can_queue(struct fc_lport
*lp
)
654 struct fc_fcp_internal
*si
= fc_get_scsi_internal(lp
);
658 spin_lock_irqsave(lp
->host
->host_lock
, flags
);
663 can_queue
= lp
->host
->can_queue
;
667 lp
->host
->can_queue
= can_queue
;
668 shost_printk(KERN_ERR
, lp
->host
, "libfc: Could not allocate frame.\n"
669 "Reducing can_queue to %d.\n", can_queue
);
671 spin_unlock_irqrestore(lp
->host
->host_lock
, flags
);
675 * fc_fcp_recv() - Reveive FCP frames
676 * @seq: The sequence the frame is on
678 * @arg: The related FCP packet
681 * Context : called from Soft IRQ context
682 * can not called holding list lock
684 static void fc_fcp_recv(struct fc_seq
*seq
, struct fc_frame
*fp
, void *arg
)
686 struct fc_fcp_pkt
*fsp
= (struct fc_fcp_pkt
*)arg
;
687 struct fc_lport
*lport
= fsp
->lp
;
688 struct fc_frame_header
*fh
;
689 struct fcp_txrdy
*dd
;
696 fh
= fc_frame_header_get(fp
);
697 r_ctl
= fh
->fh_r_ctl
;
699 if (!(lport
->state
& LPORT_ST_READY
))
701 if (fc_fcp_lock_pkt(fsp
))
703 fsp
->last_pkt_time
= jiffies
;
705 if (fh
->fh_type
== FC_TYPE_BLS
) {
706 fc_fcp_abts_resp(fsp
, fp
);
710 if (fsp
->state
& (FC_SRB_ABORTED
| FC_SRB_ABORT_PENDING
))
713 if (r_ctl
== FC_RCTL_DD_DATA_DESC
) {
715 * received XFER RDY from the target
716 * need to send data to the target
718 WARN_ON(fr_flags(fp
) & FCPHF_CRC_UNCHECKED
);
719 dd
= fc_frame_payload_get(fp
, sizeof(*dd
));
722 rc
= fc_fcp_send_data(fsp
, seq
,
723 (size_t) ntohl(dd
->ft_data_ro
),
724 (size_t) ntohl(dd
->ft_burst_len
));
726 seq
->rec_data
= fsp
->xfer_len
;
727 else if (rc
== -ENOMEM
)
728 fsp
->state
|= FC_SRB_NOMEM
;
729 } else if (r_ctl
== FC_RCTL_DD_SOL_DATA
) {
731 * received a DATA frame
732 * next we will copy the data to the system buffer
734 WARN_ON(fr_len(fp
) < sizeof(*fh
)); /* len may be 0 */
735 fc_fcp_recv_data(fsp
, fp
);
736 seq
->rec_data
= fsp
->xfer_contig_end
;
737 } else if (r_ctl
== FC_RCTL_DD_CMD_STATUS
) {
738 WARN_ON(fr_flags(fp
) & FCPHF_CRC_UNCHECKED
);
740 fc_fcp_resp(fsp
, fp
);
742 FC_FCP_DBG(fsp
, "unexpected frame. r_ctl %x\n", r_ctl
);
745 fc_fcp_unlock_pkt(fsp
);
750 fc_fcp_error(fsp
, fp
);
751 else if (rc
== -ENOMEM
)
752 fc_fcp_reduce_can_queue(lport
);
755 static void fc_fcp_resp(struct fc_fcp_pkt
*fsp
, struct fc_frame
*fp
)
757 struct fc_frame_header
*fh
;
758 struct fcp_resp
*fc_rp
;
759 struct fcp_resp_ext
*rp_ex
;
760 struct fcp_resp_rsp_info
*fc_rp_info
;
768 fh
= (struct fc_frame_header
*)fr_hdr(fp
);
769 if (unlikely(plen
< sizeof(*fh
) + sizeof(*fc_rp
)))
772 fc_rp
= (struct fcp_resp
*)(fh
+ 1);
773 fsp
->cdb_status
= fc_rp
->fr_status
;
774 flags
= fc_rp
->fr_flags
;
775 fsp
->scsi_comp_flags
= flags
;
776 expected_len
= fsp
->data_len
;
778 /* if ddp, update xfer len */
779 fc_fcp_ddp_done(fsp
);
781 if (unlikely((flags
& ~FCP_CONF_REQ
) || fc_rp
->fr_status
)) {
782 rp_ex
= (void *)(fc_rp
+ 1);
783 if (flags
& (FCP_RSP_LEN_VAL
| FCP_SNS_LEN_VAL
)) {
784 if (plen
< sizeof(*fc_rp
) + sizeof(*rp_ex
))
786 fc_rp_info
= (struct fcp_resp_rsp_info
*)(rp_ex
+ 1);
787 if (flags
& FCP_RSP_LEN_VAL
) {
788 respl
= ntohl(rp_ex
->fr_rsp_len
);
789 if (respl
!= sizeof(*fc_rp_info
))
791 if (fsp
->wait_for_comp
) {
792 /* Abuse cdb_status for rsp code */
793 fsp
->cdb_status
= fc_rp_info
->rsp_code
;
794 complete(&fsp
->tm_done
);
796 * tmfs will not have any scsi cmd so
803 if (flags
& FCP_SNS_LEN_VAL
) {
804 snsl
= ntohl(rp_ex
->fr_sns_len
);
805 if (snsl
> SCSI_SENSE_BUFFERSIZE
)
806 snsl
= SCSI_SENSE_BUFFERSIZE
;
807 memcpy(fsp
->cmd
->sense_buffer
,
808 (char *)fc_rp_info
+ respl
, snsl
);
811 if (flags
& (FCP_RESID_UNDER
| FCP_RESID_OVER
)) {
812 if (plen
< sizeof(*fc_rp
) + sizeof(rp_ex
->fr_resid
))
814 if (flags
& FCP_RESID_UNDER
) {
815 fsp
->scsi_resid
= ntohl(rp_ex
->fr_resid
);
817 * The cmnd->underflow is the minimum number of
818 * bytes that must be transfered for this
819 * command. Provided a sense condition is not
820 * present, make sure the actual amount
821 * transferred is at least the underflow value
824 if (!(flags
& FCP_SNS_LEN_VAL
) &&
825 (fc_rp
->fr_status
== 0) &&
826 (scsi_bufflen(fsp
->cmd
) -
827 fsp
->scsi_resid
) < fsp
->cmd
->underflow
)
829 expected_len
-= fsp
->scsi_resid
;
831 fsp
->status_code
= FC_ERROR
;
835 fsp
->state
|= FC_SRB_RCV_STATUS
;
838 * Check for missing or extra data frames.
840 if (unlikely(fsp
->xfer_len
!= expected_len
)) {
841 if (fsp
->xfer_len
< expected_len
) {
843 * Some data may be queued locally,
844 * Wait a at least one jiffy to see if it is delivered.
845 * If this expires without data, we may do SRR.
847 fc_fcp_timer_set(fsp
, 2);
850 fsp
->status_code
= FC_DATA_OVRRUN
;
851 FC_FCP_DBG(fsp
, "tgt %6x xfer len %zx greater than expected, "
852 "len %x, data len %x\n",
854 fsp
->xfer_len
, expected_len
, fsp
->data_len
);
856 fc_fcp_complete_locked(fsp
);
860 FC_FCP_DBG(fsp
, "short FCP response. flags 0x%x len %u respl %u "
861 "snsl %u\n", flags
, fr_len(fp
), respl
, snsl
);
863 fsp
->status_code
= FC_ERROR
;
864 fc_fcp_complete_locked(fsp
);
868 * fc_fcp_complete_locked() - complete processing of a fcp packet
871 * This function may sleep if a timer is pending. The packet lock must be
872 * held, and the host lock must not be held.
874 static void fc_fcp_complete_locked(struct fc_fcp_pkt
*fsp
)
876 struct fc_lport
*lp
= fsp
->lp
;
881 if (fsp
->state
& FC_SRB_ABORT_PENDING
)
884 if (fsp
->state
& FC_SRB_ABORTED
) {
885 if (!fsp
->status_code
)
886 fsp
->status_code
= FC_CMD_ABORTED
;
889 * Test for transport underrun, independent of response
892 if (fsp
->xfer_len
< fsp
->data_len
&& !fsp
->io_status
&&
893 (!(fsp
->scsi_comp_flags
& FCP_RESID_UNDER
) ||
894 fsp
->xfer_len
< fsp
->data_len
- fsp
->scsi_resid
)) {
895 fsp
->status_code
= FC_DATA_UNDRUN
;
903 if (unlikely(fsp
->scsi_comp_flags
& FCP_CONF_REQ
)) {
904 struct fc_frame
*conf_frame
;
907 csp
= lp
->tt
.seq_start_next(seq
);
908 conf_frame
= fc_frame_alloc(fsp
->lp
, 0);
910 f_ctl
= FC_FC_SEQ_INIT
;
911 f_ctl
|= FC_FC_LAST_SEQ
| FC_FC_END_SEQ
;
912 ep
= fc_seq_exch(seq
);
913 fc_fill_fc_hdr(conf_frame
, FC_RCTL_DD_SOL_CTL
,
915 FC_TYPE_FCP
, f_ctl
, 0);
916 lp
->tt
.seq_send(lp
, csp
, conf_frame
);
919 lp
->tt
.exch_done(seq
);
924 static void fc_fcp_cleanup_cmd(struct fc_fcp_pkt
*fsp
, int error
)
926 struct fc_lport
*lp
= fsp
->lp
;
929 lp
->tt
.exch_done(fsp
->seq_ptr
);
932 fsp
->status_code
= error
;
936 * fc_fcp_cleanup_each_cmd() - Cleanup active commads
940 * @error: fsp status code
942 * If lun or id is -1, they are ignored.
944 static void fc_fcp_cleanup_each_cmd(struct fc_lport
*lp
, unsigned int id
,
945 unsigned int lun
, int error
)
947 struct fc_fcp_internal
*si
= fc_get_scsi_internal(lp
);
948 struct fc_fcp_pkt
*fsp
;
949 struct scsi_cmnd
*sc_cmd
;
952 spin_lock_irqsave(lp
->host
->host_lock
, flags
);
954 list_for_each_entry(fsp
, &si
->scsi_pkt_queue
, list
) {
956 if (id
!= -1 && scmd_id(sc_cmd
) != id
)
959 if (lun
!= -1 && sc_cmd
->device
->lun
!= lun
)
962 fc_fcp_pkt_hold(fsp
);
963 spin_unlock_irqrestore(lp
->host
->host_lock
, flags
);
965 if (!fc_fcp_lock_pkt(fsp
)) {
966 fc_fcp_cleanup_cmd(fsp
, error
);
968 fc_fcp_unlock_pkt(fsp
);
971 fc_fcp_pkt_release(fsp
);
972 spin_lock_irqsave(lp
->host
->host_lock
, flags
);
974 * while we dropped the lock multiple pkts could
975 * have been released, so we have to start over.
979 spin_unlock_irqrestore(lp
->host
->host_lock
, flags
);
982 static void fc_fcp_abort_io(struct fc_lport
*lp
)
984 fc_fcp_cleanup_each_cmd(lp
, -1, -1, FC_HRD_ERROR
);
988 * fc_fcp_pkt_send() - send a fcp packet to the lower level.
992 * This is called by upper layer protocol.
993 * Return : zero for success and -1 for failure
994 * Context : called from queuecommand which can be called from process
996 * Locks : called with the host lock and irqs disabled.
998 static int fc_fcp_pkt_send(struct fc_lport
*lp
, struct fc_fcp_pkt
*fsp
)
1000 struct fc_fcp_internal
*si
= fc_get_scsi_internal(lp
);
1003 fsp
->cmd
->SCp
.ptr
= (char *)fsp
;
1004 fsp
->cdb_cmd
.fc_dl
= htonl(fsp
->data_len
);
1005 fsp
->cdb_cmd
.fc_flags
= fsp
->req_flags
& ~FCP_CFL_LEN_MASK
;
1007 int_to_scsilun(fsp
->cmd
->device
->lun
,
1008 (struct scsi_lun
*)fsp
->cdb_cmd
.fc_lun
);
1009 memcpy(fsp
->cdb_cmd
.fc_cdb
, fsp
->cmd
->cmnd
, fsp
->cmd
->cmd_len
);
1010 list_add_tail(&fsp
->list
, &si
->scsi_pkt_queue
);
1012 spin_unlock_irq(lp
->host
->host_lock
);
1013 rc
= lp
->tt
.fcp_cmd_send(lp
, fsp
, fc_fcp_recv
);
1014 spin_lock_irq(lp
->host
->host_lock
);
1016 list_del(&fsp
->list
);
1021 static int fc_fcp_cmd_send(struct fc_lport
*lp
, struct fc_fcp_pkt
*fsp
,
1022 void (*resp
)(struct fc_seq
*,
1023 struct fc_frame
*fp
,
1026 struct fc_frame
*fp
;
1028 struct fc_rport
*rport
;
1029 struct fc_rport_libfc_priv
*rp
;
1030 const size_t len
= sizeof(fsp
->cdb_cmd
);
1033 if (fc_fcp_lock_pkt(fsp
))
1036 fp
= fc_frame_alloc(lp
, sizeof(fsp
->cdb_cmd
));
1042 memcpy(fc_frame_payload_get(fp
, len
), &fsp
->cdb_cmd
, len
);
1045 fsp
->max_payload
= rport
->maxframe_size
;
1046 rp
= rport
->dd_data
;
1048 fc_fill_fc_hdr(fp
, FC_RCTL_DD_UNSOL_CMD
, rport
->port_id
,
1049 fc_host_port_id(rp
->local_port
->host
), FC_TYPE_FCP
,
1050 FC_FC_FIRST_SEQ
| FC_FC_END_SEQ
| FC_FC_SEQ_INIT
, 0);
1052 seq
= lp
->tt
.exch_seq_send(lp
, fp
, resp
, fc_fcp_pkt_destroy
, fsp
, 0);
1057 fsp
->last_pkt_time
= jiffies
;
1059 fc_fcp_pkt_hold(fsp
); /* hold for fc_fcp_pkt_destroy */
1061 setup_timer(&fsp
->timer
, fc_fcp_timeout
, (unsigned long)fsp
);
1062 fc_fcp_timer_set(fsp
,
1063 (fsp
->tgt_flags
& FC_RP_FLAGS_REC_SUPPORTED
) ?
1064 FC_SCSI_REC_TOV
: FC_SCSI_ER_TIMEOUT
);
1066 fc_fcp_unlock_pkt(fsp
);
1071 * transport error handler
1073 static void fc_fcp_error(struct fc_fcp_pkt
*fsp
, struct fc_frame
*fp
)
1075 int error
= PTR_ERR(fp
);
1077 if (fc_fcp_lock_pkt(fsp
))
1080 if (error
== -FC_EX_CLOSED
) {
1081 fc_fcp_retry_cmd(fsp
);
1086 * clear abort pending, because the lower layer
1087 * decided to force completion.
1089 fsp
->state
&= ~FC_SRB_ABORT_PENDING
;
1090 fsp
->status_code
= FC_CMD_PLOGO
;
1091 fc_fcp_complete_locked(fsp
);
1093 fc_fcp_unlock_pkt(fsp
);
1097 * Scsi abort handler- calls to send an abort
1098 * and then wait for abort completion
1100 static int fc_fcp_pkt_abort(struct fc_fcp_pkt
*fsp
)
1104 if (fc_fcp_send_abort(fsp
))
1107 init_completion(&fsp
->tm_done
);
1108 fsp
->wait_for_comp
= 1;
1110 spin_unlock_bh(&fsp
->scsi_pkt_lock
);
1111 rc
= wait_for_completion_timeout(&fsp
->tm_done
, FC_SCSI_TM_TOV
);
1112 spin_lock_bh(&fsp
->scsi_pkt_lock
);
1113 fsp
->wait_for_comp
= 0;
1116 FC_FCP_DBG(fsp
, "target abort cmd failed\n");
1118 } else if (fsp
->state
& FC_SRB_ABORTED
) {
1119 FC_FCP_DBG(fsp
, "target abort cmd passed\n");
1121 fc_fcp_complete_locked(fsp
);
1128 * Retry LUN reset after resource allocation failed.
1130 static void fc_lun_reset_send(unsigned long data
)
1132 struct fc_fcp_pkt
*fsp
= (struct fc_fcp_pkt
*)data
;
1133 struct fc_lport
*lp
= fsp
->lp
;
1134 if (lp
->tt
.fcp_cmd_send(lp
, fsp
, fc_tm_done
)) {
1135 if (fsp
->recov_retry
++ >= FC_MAX_RECOV_RETRY
)
1137 if (fc_fcp_lock_pkt(fsp
))
1139 setup_timer(&fsp
->timer
, fc_lun_reset_send
, (unsigned long)fsp
);
1140 fc_fcp_timer_set(fsp
, FC_SCSI_REC_TOV
);
1141 fc_fcp_unlock_pkt(fsp
);
1146 * Scsi device reset handler- send a LUN RESET to the device
1147 * and wait for reset reply
1149 static int fc_lun_reset(struct fc_lport
*lp
, struct fc_fcp_pkt
*fsp
,
1150 unsigned int id
, unsigned int lun
)
1154 fsp
->cdb_cmd
.fc_dl
= htonl(fsp
->data_len
);
1155 fsp
->cdb_cmd
.fc_tm_flags
= FCP_TMF_LUN_RESET
;
1156 int_to_scsilun(lun
, (struct scsi_lun
*)fsp
->cdb_cmd
.fc_lun
);
1158 fsp
->wait_for_comp
= 1;
1159 init_completion(&fsp
->tm_done
);
1161 fc_lun_reset_send((unsigned long)fsp
);
1164 * wait for completion of reset
1165 * after that make sure all commands are terminated
1167 rc
= wait_for_completion_timeout(&fsp
->tm_done
, FC_SCSI_TM_TOV
);
1169 spin_lock_bh(&fsp
->scsi_pkt_lock
);
1170 fsp
->state
|= FC_SRB_COMPL
;
1171 spin_unlock_bh(&fsp
->scsi_pkt_lock
);
1173 del_timer_sync(&fsp
->timer
);
1175 spin_lock_bh(&fsp
->scsi_pkt_lock
);
1177 lp
->tt
.exch_done(fsp
->seq_ptr
);
1178 fsp
->seq_ptr
= NULL
;
1180 fsp
->wait_for_comp
= 0;
1181 spin_unlock_bh(&fsp
->scsi_pkt_lock
);
1184 FC_SCSI_DBG(lp
, "lun reset failed\n");
1188 /* cdb_status holds the tmf's rsp code */
1189 if (fsp
->cdb_status
!= FCP_TMF_CMPL
)
1192 FC_SCSI_DBG(lp
, "lun reset to lun %u completed\n", lun
);
1193 fc_fcp_cleanup_each_cmd(lp
, id
, lun
, FC_CMD_ABORTED
);
1198 * Task Managment response handler
1200 static void fc_tm_done(struct fc_seq
*seq
, struct fc_frame
*fp
, void *arg
)
1202 struct fc_fcp_pkt
*fsp
= arg
;
1203 struct fc_frame_header
*fh
;
1207 * If there is an error just let it timeout or wait
1208 * for TMF to be aborted if it timedout.
1210 * scsi-eh will escalate for when either happens.
1215 if (fc_fcp_lock_pkt(fsp
))
1219 * raced with eh timeout handler.
1221 if (!fsp
->seq_ptr
|| !fsp
->wait_for_comp
) {
1222 spin_unlock_bh(&fsp
->scsi_pkt_lock
);
1226 fh
= fc_frame_header_get(fp
);
1227 if (fh
->fh_type
!= FC_TYPE_BLS
)
1228 fc_fcp_resp(fsp
, fp
);
1229 fsp
->seq_ptr
= NULL
;
1230 fsp
->lp
->tt
.exch_done(seq
);
1232 fc_fcp_unlock_pkt(fsp
);
1235 static void fc_fcp_cleanup(struct fc_lport
*lp
)
1237 fc_fcp_cleanup_each_cmd(lp
, -1, -1, FC_ERROR
);
1241 * fc_fcp_timeout: called by OS timer function.
1243 * The timer has been inactivated and must be reactivated if desired
1244 * using fc_fcp_timer_set().
1248 * If REC is supported, just issue it, and return. The REC exchange will
1249 * complete or time out, and recovery can continue at that point.
1251 * Otherwise, if the response has been received without all the data,
1252 * it has been ER_TIMEOUT since the response was received.
1254 * If the response has not been received,
1255 * we see if data was received recently. If it has been, we continue waiting,
1256 * otherwise, we abort the command.
1258 static void fc_fcp_timeout(unsigned long data
)
1260 struct fc_fcp_pkt
*fsp
= (struct fc_fcp_pkt
*)data
;
1261 struct fc_rport
*rport
= fsp
->rport
;
1262 struct fc_rport_libfc_priv
*rp
= rport
->dd_data
;
1264 if (fc_fcp_lock_pkt(fsp
))
1267 if (fsp
->cdb_cmd
.fc_tm_flags
)
1270 fsp
->state
|= FC_SRB_FCP_PROCESSING_TMO
;
1272 if (rp
->flags
& FC_RP_FLAGS_REC_SUPPORTED
)
1274 else if (time_after_eq(fsp
->last_pkt_time
+ (FC_SCSI_ER_TIMEOUT
/ 2),
1276 fc_fcp_timer_set(fsp
, FC_SCSI_ER_TIMEOUT
);
1277 else if (fsp
->state
& FC_SRB_RCV_STATUS
)
1278 fc_fcp_complete_locked(fsp
);
1280 fc_timeout_error(fsp
);
1281 fsp
->state
&= ~FC_SRB_FCP_PROCESSING_TMO
;
1283 fc_fcp_unlock_pkt(fsp
);
1287 * Send a REC ELS request
1289 static void fc_fcp_rec(struct fc_fcp_pkt
*fsp
)
1291 struct fc_lport
*lp
;
1292 struct fc_frame
*fp
;
1293 struct fc_rport
*rport
;
1294 struct fc_rport_libfc_priv
*rp
;
1298 rp
= rport
->dd_data
;
1299 if (!fsp
->seq_ptr
|| rp
->rp_state
!= RPORT_ST_READY
) {
1300 fsp
->status_code
= FC_HRD_ERROR
;
1302 fc_fcp_complete_locked(fsp
);
1305 fp
= fc_frame_alloc(lp
, sizeof(struct fc_els_rec
));
1309 fr_seq(fp
) = fsp
->seq_ptr
;
1310 fc_fill_fc_hdr(fp
, FC_RCTL_ELS_REQ
, rport
->port_id
,
1311 fc_host_port_id(rp
->local_port
->host
), FC_TYPE_ELS
,
1312 FC_FC_FIRST_SEQ
| FC_FC_END_SEQ
| FC_FC_SEQ_INIT
, 0);
1313 if (lp
->tt
.elsct_send(lp
, rport
->port_id
, fp
, ELS_REC
, fc_fcp_rec_resp
,
1314 fsp
, jiffies_to_msecs(FC_SCSI_REC_TOV
))) {
1315 fc_fcp_pkt_hold(fsp
); /* hold while REC outstanding */
1319 if (fsp
->recov_retry
++ < FC_MAX_RECOV_RETRY
)
1320 fc_fcp_timer_set(fsp
, FC_SCSI_REC_TOV
);
1322 fc_timeout_error(fsp
);
1326 * Receive handler for REC ELS frame
1327 * if it is a reject then let the scsi layer to handle
1328 * the timeout. if it is a LS_ACC then if the io was not completed
1329 * then set the timeout and return otherwise complete the exchange
1330 * and tell the scsi layer to restart the I/O.
1332 static void fc_fcp_rec_resp(struct fc_seq
*seq
, struct fc_frame
*fp
, void *arg
)
1334 struct fc_fcp_pkt
*fsp
= (struct fc_fcp_pkt
*)arg
;
1335 struct fc_els_rec_acc
*recp
;
1336 struct fc_els_ls_rjt
*rjt
;
1340 enum dma_data_direction data_dir
;
1342 struct fc_rport_libfc_priv
*rp
;
1345 fc_fcp_rec_error(fsp
, fp
);
1349 if (fc_fcp_lock_pkt(fsp
))
1352 fsp
->recov_retry
= 0;
1353 opcode
= fc_frame_payload_op(fp
);
1354 if (opcode
== ELS_LS_RJT
) {
1355 rjt
= fc_frame_payload_get(fp
, sizeof(*rjt
));
1356 switch (rjt
->er_reason
) {
1358 FC_FCP_DBG(fsp
, "device %x unexpected REC reject "
1359 "reason %d expl %d\n",
1360 fsp
->rport
->port_id
, rjt
->er_reason
,
1364 FC_FCP_DBG(fsp
, "device does not support REC\n");
1365 rp
= fsp
->rport
->dd_data
;
1367 * if we do not spport RECs or got some bogus
1368 * reason then resetup timer so we check for
1371 rp
->flags
&= ~FC_RP_FLAGS_REC_SUPPORTED
;
1372 fc_fcp_timer_set(fsp
, FC_SCSI_ER_TIMEOUT
);
1377 * If no data transfer, the command frame got dropped
1378 * so we just retry. If data was transferred, we
1379 * lost the response but the target has no record,
1380 * so we abort and retry.
1382 if (rjt
->er_explan
== ELS_EXPL_OXID_RXID
&&
1383 fsp
->xfer_len
== 0) {
1384 fc_fcp_retry_cmd(fsp
);
1387 fc_timeout_error(fsp
);
1390 } else if (opcode
== ELS_LS_ACC
) {
1391 if (fsp
->state
& FC_SRB_ABORTED
)
1394 data_dir
= fsp
->cmd
->sc_data_direction
;
1395 recp
= fc_frame_payload_get(fp
, sizeof(*recp
));
1396 offset
= ntohl(recp
->reca_fc4value
);
1397 e_stat
= ntohl(recp
->reca_e_stat
);
1399 if (e_stat
& ESB_ST_COMPLETE
) {
1402 * The exchange is complete.
1404 * For output, we must've lost the response.
1405 * For input, all data must've been sent.
1406 * We lost may have lost the response
1407 * (and a confirmation was requested) and maybe
1410 * If all data received, send SRR
1411 * asking for response. If partial data received,
1412 * or gaps, SRR requests data at start of gap.
1413 * Recovery via SRR relies on in-order-delivery.
1415 if (data_dir
== DMA_TO_DEVICE
) {
1416 r_ctl
= FC_RCTL_DD_CMD_STATUS
;
1417 } else if (fsp
->xfer_contig_end
== offset
) {
1418 r_ctl
= FC_RCTL_DD_CMD_STATUS
;
1420 offset
= fsp
->xfer_contig_end
;
1421 r_ctl
= FC_RCTL_DD_SOL_DATA
;
1423 fc_fcp_srr(fsp
, r_ctl
, offset
);
1424 } else if (e_stat
& ESB_ST_SEQ_INIT
) {
1427 * The remote port has the initiative, so just
1428 * keep waiting for it to complete.
1430 fc_fcp_timer_set(fsp
, FC_SCSI_REC_TOV
);
1434 * The exchange is incomplete, we have seq. initiative.
1435 * Lost response with requested confirmation,
1436 * lost confirmation, lost transfer ready or
1439 * For output, if not all data was received, ask
1440 * for transfer ready to be repeated.
1442 * If we received or sent all the data, send SRR to
1445 * If we lost a response, we may have lost some read
1448 r_ctl
= FC_RCTL_DD_SOL_DATA
;
1449 if (data_dir
== DMA_TO_DEVICE
) {
1450 r_ctl
= FC_RCTL_DD_CMD_STATUS
;
1451 if (offset
< fsp
->data_len
)
1452 r_ctl
= FC_RCTL_DD_DATA_DESC
;
1453 } else if (offset
== fsp
->xfer_contig_end
) {
1454 r_ctl
= FC_RCTL_DD_CMD_STATUS
;
1455 } else if (fsp
->xfer_contig_end
< offset
) {
1456 offset
= fsp
->xfer_contig_end
;
1458 fc_fcp_srr(fsp
, r_ctl
, offset
);
1462 fc_fcp_unlock_pkt(fsp
);
1464 fc_fcp_pkt_release(fsp
); /* drop hold for outstanding REC */
1469 * Handle error response or timeout for REC exchange.
1471 static void fc_fcp_rec_error(struct fc_fcp_pkt
*fsp
, struct fc_frame
*fp
)
1473 int error
= PTR_ERR(fp
);
1475 if (fc_fcp_lock_pkt(fsp
))
1480 fc_fcp_retry_cmd(fsp
);
1484 FC_FCP_DBG(fsp
, "REC %p fid %x error unexpected error %d\n",
1485 fsp
, fsp
->rport
->port_id
, error
);
1486 fsp
->status_code
= FC_CMD_PLOGO
;
1489 case -FC_EX_TIMEOUT
:
1491 * Assume REC or LS_ACC was lost.
1492 * The exchange manager will have aborted REC, so retry.
1494 FC_FCP_DBG(fsp
, "REC fid %x error error %d retry %d/%d\n",
1495 fsp
->rport
->port_id
, error
, fsp
->recov_retry
,
1496 FC_MAX_RECOV_RETRY
);
1497 if (fsp
->recov_retry
++ < FC_MAX_RECOV_RETRY
)
1500 fc_timeout_error(fsp
);
1503 fc_fcp_unlock_pkt(fsp
);
1505 fc_fcp_pkt_release(fsp
); /* drop hold for outstanding REC */
1509 * Time out error routine:
1510 * abort's the I/O close the exchange and
1511 * send completion notification to scsi layer
1513 static void fc_timeout_error(struct fc_fcp_pkt
*fsp
)
1515 fsp
->status_code
= FC_CMD_TIME_OUT
;
1516 fsp
->cdb_status
= 0;
1519 * if this fails then we let the scsi command timer fire and
1522 fc_fcp_send_abort(fsp
);
1526 * Sequence retransmission request.
1527 * This is called after receiving status but insufficient data, or
1528 * when expecting status but the request has timed out.
1530 static void fc_fcp_srr(struct fc_fcp_pkt
*fsp
, enum fc_rctl r_ctl
, u32 offset
)
1532 struct fc_lport
*lp
= fsp
->lp
;
1533 struct fc_rport
*rport
;
1534 struct fc_rport_libfc_priv
*rp
;
1535 struct fc_exch
*ep
= fc_seq_exch(fsp
->seq_ptr
);
1537 struct fcp_srr
*srr
;
1538 struct fc_frame
*fp
;
1542 rp
= rport
->dd_data
;
1543 cdb_op
= fsp
->cdb_cmd
.fc_cdb
[0];
1545 if (!(rp
->flags
& FC_RP_FLAGS_RETRY
) || rp
->rp_state
!= RPORT_ST_READY
)
1546 goto retry
; /* shouldn't happen */
1547 fp
= fc_frame_alloc(lp
, sizeof(*srr
));
1551 srr
= fc_frame_payload_get(fp
, sizeof(*srr
));
1552 memset(srr
, 0, sizeof(*srr
));
1553 srr
->srr_op
= ELS_SRR
;
1554 srr
->srr_ox_id
= htons(ep
->oxid
);
1555 srr
->srr_rx_id
= htons(ep
->rxid
);
1556 srr
->srr_r_ctl
= r_ctl
;
1557 srr
->srr_rel_off
= htonl(offset
);
1559 fc_fill_fc_hdr(fp
, FC_RCTL_ELS4_REQ
, rport
->port_id
,
1560 fc_host_port_id(rp
->local_port
->host
), FC_TYPE_FCP
,
1561 FC_FC_FIRST_SEQ
| FC_FC_END_SEQ
| FC_FC_SEQ_INIT
, 0);
1563 seq
= lp
->tt
.exch_seq_send(lp
, fp
, fc_fcp_srr_resp
, NULL
,
1564 fsp
, jiffies_to_msecs(FC_SCSI_REC_TOV
));
1568 fsp
->recov_seq
= seq
;
1569 fsp
->xfer_len
= offset
;
1570 fsp
->xfer_contig_end
= offset
;
1571 fsp
->state
&= ~FC_SRB_RCV_STATUS
;
1572 fc_fcp_pkt_hold(fsp
); /* hold for outstanding SRR */
1575 fc_fcp_retry_cmd(fsp
);
1579 * Handle response from SRR.
1581 static void fc_fcp_srr_resp(struct fc_seq
*seq
, struct fc_frame
*fp
, void *arg
)
1583 struct fc_fcp_pkt
*fsp
= arg
;
1584 struct fc_frame_header
*fh
;
1587 fc_fcp_srr_error(fsp
, fp
);
1591 if (fc_fcp_lock_pkt(fsp
))
1594 fh
= fc_frame_header_get(fp
);
1596 * BUG? fc_fcp_srr_error calls exch_done which would release
1597 * the ep. But if fc_fcp_srr_error had got -FC_EX_TIMEOUT,
1598 * then fc_exch_timeout would be sending an abort. The exch_done
1599 * call by fc_fcp_srr_error would prevent fc_exch.c from seeing
1600 * an abort response though.
1602 if (fh
->fh_type
== FC_TYPE_BLS
) {
1603 fc_fcp_unlock_pkt(fsp
);
1607 fsp
->recov_seq
= NULL
;
1608 switch (fc_frame_payload_op(fp
)) {
1610 fsp
->recov_retry
= 0;
1611 fc_fcp_timer_set(fsp
, FC_SCSI_REC_TOV
);
1615 fc_timeout_error(fsp
);
1618 fc_fcp_unlock_pkt(fsp
);
1619 fsp
->lp
->tt
.exch_done(seq
);
1622 fc_fcp_pkt_release(fsp
); /* drop hold for outstanding SRR */
1625 static void fc_fcp_srr_error(struct fc_fcp_pkt
*fsp
, struct fc_frame
*fp
)
1627 if (fc_fcp_lock_pkt(fsp
))
1629 fsp
->lp
->tt
.exch_done(fsp
->recov_seq
);
1630 fsp
->recov_seq
= NULL
;
1631 switch (PTR_ERR(fp
)) {
1632 case -FC_EX_TIMEOUT
:
1633 if (fsp
->recov_retry
++ < FC_MAX_RECOV_RETRY
)
1636 fc_timeout_error(fsp
);
1638 case -FC_EX_CLOSED
: /* e.g., link failure */
1641 fc_fcp_retry_cmd(fsp
);
1644 fc_fcp_unlock_pkt(fsp
);
1646 fc_fcp_pkt_release(fsp
); /* drop hold for outstanding SRR */
1649 static inline int fc_fcp_lport_queue_ready(struct fc_lport
*lp
)
1652 return (lp
->state
== LPORT_ST_READY
) && lp
->link_up
&& !lp
->qfull
;
1656 * fc_queuecommand - The queuecommand function of the scsi template
1657 * @cmd: struct scsi_cmnd to be executed
1658 * @done: Callback function to be called when cmd is completed
1660 * this is the i/o strategy routine, called by the scsi layer
1661 * this routine is called with holding the host_lock.
1663 int fc_queuecommand(struct scsi_cmnd
*sc_cmd
, void (*done
)(struct scsi_cmnd
*))
1665 struct fc_lport
*lp
;
1666 struct fc_rport
*rport
= starget_to_rport(scsi_target(sc_cmd
->device
));
1667 struct fc_fcp_pkt
*fsp
;
1668 struct fc_rport_libfc_priv
*rp
;
1671 struct fcoe_dev_stats
*stats
;
1673 lp
= shost_priv(sc_cmd
->device
->host
);
1675 rval
= fc_remote_port_chkready(rport
);
1677 sc_cmd
->result
= rval
;
1682 if (!*(struct fc_remote_port
**)rport
->dd_data
) {
1684 * rport is transitioning from blocked/deleted to
1687 sc_cmd
->result
= DID_IMM_RETRY
<< 16;
1692 rp
= rport
->dd_data
;
1694 if (!fc_fcp_lport_queue_ready(lp
)) {
1695 rc
= SCSI_MLQUEUE_HOST_BUSY
;
1699 fsp
= fc_fcp_pkt_alloc(lp
, GFP_ATOMIC
);
1701 rc
= SCSI_MLQUEUE_HOST_BUSY
;
1706 * build the libfc request pkt
1708 fsp
->cmd
= sc_cmd
; /* save the cmd */
1709 fsp
->lp
= lp
; /* save the softc ptr */
1710 fsp
->rport
= rport
; /* set the remote port ptr */
1711 fsp
->xfer_ddp
= FC_XID_UNKNOWN
;
1712 sc_cmd
->scsi_done
= done
;
1715 * set up the transfer length
1717 fsp
->data_len
= scsi_bufflen(sc_cmd
);
1721 * setup the data direction
1723 stats
= fc_lport_get_stats(lp
);
1724 if (sc_cmd
->sc_data_direction
== DMA_FROM_DEVICE
) {
1725 fsp
->req_flags
= FC_SRB_READ
;
1726 stats
->InputRequests
++;
1727 stats
->InputMegabytes
= fsp
->data_len
;
1728 } else if (sc_cmd
->sc_data_direction
== DMA_TO_DEVICE
) {
1729 fsp
->req_flags
= FC_SRB_WRITE
;
1730 stats
->OutputRequests
++;
1731 stats
->OutputMegabytes
= fsp
->data_len
;
1734 stats
->ControlRequests
++;
1737 fsp
->tgt_flags
= rp
->flags
;
1739 init_timer(&fsp
->timer
);
1740 fsp
->timer
.data
= (unsigned long)fsp
;
1743 * send it to the lower layer
1744 * if we get -1 return then put the request in the pending
1747 rval
= fc_fcp_pkt_send(lp
, fsp
);
1749 fsp
->state
= FC_SRB_FREE
;
1750 fc_fcp_pkt_release(fsp
);
1751 rc
= SCSI_MLQUEUE_HOST_BUSY
;
1756 EXPORT_SYMBOL(fc_queuecommand
);
1759 * fc_io_compl() - Handle responses for completed commands
1762 * Translates a error to a Linux SCSI error.
1764 * The fcp packet lock must be held when calling.
1766 static void fc_io_compl(struct fc_fcp_pkt
*fsp
)
1768 struct fc_fcp_internal
*si
;
1769 struct scsi_cmnd
*sc_cmd
;
1770 struct fc_lport
*lp
;
1771 unsigned long flags
;
1773 /* release outstanding ddp context */
1774 fc_fcp_ddp_done(fsp
);
1776 fsp
->state
|= FC_SRB_COMPL
;
1777 if (!(fsp
->state
& FC_SRB_FCP_PROCESSING_TMO
)) {
1778 spin_unlock_bh(&fsp
->scsi_pkt_lock
);
1779 del_timer_sync(&fsp
->timer
);
1780 spin_lock_bh(&fsp
->scsi_pkt_lock
);
1784 si
= fc_get_scsi_internal(lp
);
1785 spin_lock_irqsave(lp
->host
->host_lock
, flags
);
1787 spin_unlock_irqrestore(lp
->host
->host_lock
, flags
);
1792 * if a command timed out while we had to try and throttle IO
1793 * and it is now getting cleaned up, then we are about to
1794 * try again so clear the throttled flag incase we get more
1797 if (si
->throttled
&& fsp
->state
& FC_SRB_NOMEM
)
1803 if (!sc_cmd
->SCp
.ptr
) {
1804 spin_unlock_irqrestore(lp
->host
->host_lock
, flags
);
1808 CMD_SCSI_STATUS(sc_cmd
) = fsp
->cdb_status
;
1809 switch (fsp
->status_code
) {
1811 if (fsp
->cdb_status
== 0) {
1815 sc_cmd
->result
= DID_OK
<< 16;
1816 if (fsp
->scsi_resid
)
1817 CMD_RESID_LEN(sc_cmd
) = fsp
->scsi_resid
;
1820 * transport level I/O was ok but scsi
1821 * has non zero status
1823 sc_cmd
->result
= (DID_OK
<< 16) | fsp
->cdb_status
;
1827 sc_cmd
->result
= DID_ERROR
<< 16;
1829 case FC_DATA_UNDRUN
:
1830 if ((fsp
->cdb_status
== 0) && !(fsp
->req_flags
& FC_SRB_READ
)) {
1832 * scsi status is good but transport level
1835 sc_cmd
->result
= (fsp
->state
& FC_SRB_RCV_STATUS
?
1836 DID_OK
: DID_ERROR
) << 16;
1839 * scsi got underrun, this is an error
1841 CMD_RESID_LEN(sc_cmd
) = fsp
->scsi_resid
;
1842 sc_cmd
->result
= (DID_ERROR
<< 16) | fsp
->cdb_status
;
1845 case FC_DATA_OVRRUN
:
1847 * overrun is an error
1849 sc_cmd
->result
= (DID_ERROR
<< 16) | fsp
->cdb_status
;
1851 case FC_CMD_ABORTED
:
1852 sc_cmd
->result
= (DID_ERROR
<< 16) | fsp
->io_status
;
1854 case FC_CMD_TIME_OUT
:
1855 sc_cmd
->result
= (DID_BUS_BUSY
<< 16) | fsp
->io_status
;
1858 sc_cmd
->result
= (DID_RESET
<< 16);
1861 sc_cmd
->result
= (DID_NO_CONNECT
<< 16);
1864 sc_cmd
->result
= (DID_ERROR
<< 16);
1868 list_del(&fsp
->list
);
1869 sc_cmd
->SCp
.ptr
= NULL
;
1870 sc_cmd
->scsi_done(sc_cmd
);
1871 spin_unlock_irqrestore(lp
->host
->host_lock
, flags
);
1873 /* release ref from initial allocation in queue command */
1874 fc_fcp_pkt_release(fsp
);
1878 * fc_fcp_complete() - complete processing of a fcp packet
1881 * This function may sleep if a fsp timer is pending.
1882 * The host lock must not be held by caller.
1884 void fc_fcp_complete(struct fc_fcp_pkt
*fsp
)
1886 if (fc_fcp_lock_pkt(fsp
))
1889 fc_fcp_complete_locked(fsp
);
1890 fc_fcp_unlock_pkt(fsp
);
1892 EXPORT_SYMBOL(fc_fcp_complete
);
1895 * fc_eh_abort() - Abort a command
1896 * @sc_cmd: scsi command to abort
1898 * From scsi host template.
1899 * send ABTS to the target device and wait for the response
1900 * sc_cmd is the pointer to the command to be aborted.
1902 int fc_eh_abort(struct scsi_cmnd
*sc_cmd
)
1904 struct fc_fcp_pkt
*fsp
;
1905 struct fc_lport
*lp
;
1907 unsigned long flags
;
1909 lp
= shost_priv(sc_cmd
->device
->host
);
1910 if (lp
->state
!= LPORT_ST_READY
)
1912 else if (!lp
->link_up
)
1915 spin_lock_irqsave(lp
->host
->host_lock
, flags
);
1916 fsp
= CMD_SP(sc_cmd
);
1918 /* command completed while scsi eh was setting up */
1919 spin_unlock_irqrestore(lp
->host
->host_lock
, flags
);
1922 /* grab a ref so the fsp and sc_cmd cannot be relased from under us */
1923 fc_fcp_pkt_hold(fsp
);
1924 spin_unlock_irqrestore(lp
->host
->host_lock
, flags
);
1926 if (fc_fcp_lock_pkt(fsp
)) {
1927 /* completed while we were waiting for timer to be deleted */
1932 rc
= fc_fcp_pkt_abort(fsp
);
1933 fc_fcp_unlock_pkt(fsp
);
1936 fc_fcp_pkt_release(fsp
);
1939 EXPORT_SYMBOL(fc_eh_abort
);
1942 * fc_eh_device_reset() Reset a single LUN
1943 * @sc_cmd: scsi command
1945 * Set from scsi host template to send tm cmd to the target and wait for the
1948 int fc_eh_device_reset(struct scsi_cmnd
*sc_cmd
)
1950 struct fc_lport
*lp
;
1951 struct fc_fcp_pkt
*fsp
;
1952 struct fc_rport
*rport
= starget_to_rport(scsi_target(sc_cmd
->device
));
1954 struct fc_rport_libfc_priv
*rp
;
1957 rval
= fc_remote_port_chkready(rport
);
1961 rp
= rport
->dd_data
;
1962 lp
= shost_priv(sc_cmd
->device
->host
);
1964 if (lp
->state
!= LPORT_ST_READY
)
1967 FC_SCSI_DBG(lp
, "Resetting rport (%6x)\n", rport
->port_id
);
1969 fsp
= fc_fcp_pkt_alloc(lp
, GFP_NOIO
);
1971 printk(KERN_WARNING
"libfc: could not allocate scsi_pkt\n");
1972 sc_cmd
->result
= DID_NO_CONNECT
<< 16;
1977 * Build the libfc request pkt. Do not set the scsi cmnd, because
1978 * the sc passed in is not setup for execution like when sent
1979 * through the queuecommand callout.
1981 fsp
->lp
= lp
; /* save the softc ptr */
1982 fsp
->rport
= rport
; /* set the remote port ptr */
1985 * flush outstanding commands
1987 rc
= fc_lun_reset(lp
, fsp
, scmd_id(sc_cmd
), sc_cmd
->device
->lun
);
1988 fsp
->state
= FC_SRB_FREE
;
1989 fc_fcp_pkt_release(fsp
);
1994 EXPORT_SYMBOL(fc_eh_device_reset
);
1997 * fc_eh_host_reset() - The reset function will reset the ports on the host.
1998 * @sc_cmd: scsi command
2000 int fc_eh_host_reset(struct scsi_cmnd
*sc_cmd
)
2002 struct Scsi_Host
*shost
= sc_cmd
->device
->host
;
2003 struct fc_lport
*lp
= shost_priv(shost
);
2004 unsigned long wait_tmo
;
2006 FC_SCSI_DBG(lp
, "Resetting host\n");
2008 lp
->tt
.lport_reset(lp
);
2009 wait_tmo
= jiffies
+ FC_HOST_RESET_TIMEOUT
;
2010 while (!fc_fcp_lport_queue_ready(lp
) && time_before(jiffies
, wait_tmo
))
2013 if (fc_fcp_lport_queue_ready(lp
)) {
2014 shost_printk(KERN_INFO
, shost
, "libfc: Host reset succeeded "
2015 "on port (%6x)\n", fc_host_port_id(lp
->host
));
2018 shost_printk(KERN_INFO
, shost
, "libfc: Host reset failed, "
2019 "port (%6x) is not ready.\n",
2020 fc_host_port_id(lp
->host
));
2024 EXPORT_SYMBOL(fc_eh_host_reset
);
2027 * fc_slave_alloc() - configure queue depth
2028 * @sdev: scsi device
2030 * Configures queue depth based on host's cmd_per_len. If not set
2031 * then we use the libfc default.
2033 int fc_slave_alloc(struct scsi_device
*sdev
)
2035 struct fc_rport
*rport
= starget_to_rport(scsi_target(sdev
));
2038 if (!rport
|| fc_remote_port_chkready(rport
))
2041 if (sdev
->tagged_supported
) {
2042 if (sdev
->host
->hostt
->cmd_per_lun
)
2043 queue_depth
= sdev
->host
->hostt
->cmd_per_lun
;
2045 queue_depth
= FC_FCP_DFLT_QUEUE_DEPTH
;
2046 scsi_activate_tcq(sdev
, queue_depth
);
2050 EXPORT_SYMBOL(fc_slave_alloc
);
2052 int fc_change_queue_depth(struct scsi_device
*sdev
, int qdepth
, int reason
)
2055 case SCSI_QDEPTH_DEFAULT
:
2056 scsi_adjust_queue_depth(sdev
, scsi_get_tag_type(sdev
), qdepth
);
2058 case SCSI_QDEPTH_QFULL
:
2059 scsi_track_queue_full(sdev
, qdepth
);
2064 return sdev
->queue_depth
;
2066 EXPORT_SYMBOL(fc_change_queue_depth
);
2068 int fc_change_queue_type(struct scsi_device
*sdev
, int tag_type
)
2070 if (sdev
->tagged_supported
) {
2071 scsi_set_tag_type(sdev
, tag_type
);
2073 scsi_activate_tcq(sdev
, sdev
->queue_depth
);
2075 scsi_deactivate_tcq(sdev
, sdev
->queue_depth
);
2081 EXPORT_SYMBOL(fc_change_queue_type
);
2083 void fc_fcp_destroy(struct fc_lport
*lp
)
2085 struct fc_fcp_internal
*si
= fc_get_scsi_internal(lp
);
2087 if (!list_empty(&si
->scsi_pkt_queue
))
2088 printk(KERN_ERR
"libfc: Leaked SCSI packets when destroying "
2089 "port (%6x)\n", fc_host_port_id(lp
->host
));
2091 mempool_destroy(si
->scsi_pkt_pool
);
2093 lp
->scsi_priv
= NULL
;
2095 EXPORT_SYMBOL(fc_fcp_destroy
);
2097 int fc_fcp_init(struct fc_lport
*lp
)
2100 struct fc_fcp_internal
*si
;
2102 if (!lp
->tt
.fcp_cmd_send
)
2103 lp
->tt
.fcp_cmd_send
= fc_fcp_cmd_send
;
2105 if (!lp
->tt
.fcp_cleanup
)
2106 lp
->tt
.fcp_cleanup
= fc_fcp_cleanup
;
2108 if (!lp
->tt
.fcp_abort_io
)
2109 lp
->tt
.fcp_abort_io
= fc_fcp_abort_io
;
2111 si
= kzalloc(sizeof(struct fc_fcp_internal
), GFP_KERNEL
);
2115 INIT_LIST_HEAD(&si
->scsi_pkt_queue
);
2117 si
->scsi_pkt_pool
= mempool_create_slab_pool(2, scsi_pkt_cachep
);
2118 if (!si
->scsi_pkt_pool
) {
2128 EXPORT_SYMBOL(fc_fcp_init
);
2130 static int __init
libfc_init(void)
2134 scsi_pkt_cachep
= kmem_cache_create("libfc_fcp_pkt",
2135 sizeof(struct fc_fcp_pkt
),
2136 0, SLAB_HWCACHE_ALIGN
, NULL
);
2137 if (scsi_pkt_cachep
== NULL
) {
2138 printk(KERN_ERR
"libfc: Unable to allocate SRB cache, "
2139 "module load failed!");
2143 rc
= fc_setup_exch_mgr();
2145 goto destroy_pkt_cache
;
2147 rc
= fc_setup_rport();
2153 fc_destroy_exch_mgr();
2155 kmem_cache_destroy(scsi_pkt_cachep
);
2159 static void __exit
libfc_exit(void)
2161 kmem_cache_destroy(scsi_pkt_cachep
);
2162 fc_destroy_exch_mgr();
2166 module_init(libfc_init
);
2167 module_exit(libfc_exit
);