3 * linux/drivers/s390/scsi/zfcp_fsf.c
5 * FCP adapter driver for IBM eServer zSeries
7 * (C) Copyright IBM Corp. 2002, 2004
9 * Author(s): Martin Peschke <mpeschke@de.ibm.com>
10 * Raimund Schroeder <raimund.schroeder@de.ibm.com>
13 * Stefan Bader <stefan.bader@de.ibm.com>
14 * Heiko Carstens <heiko.carstens@de.ibm.com>
15 * Andreas Herrmann <aherrman@de.ibm.com>
16 * Volker Sameske <sameske@de.ibm.com>
18 * This program is free software; you can redistribute it and/or modify
19 * it under the terms of the GNU General Public License as published by
20 * the Free Software Foundation; either version 2, or (at your option)
23 * This program is distributed in the hope that it will be useful,
24 * but WITHOUT ANY WARRANTY; without even the implied warranty of
25 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
26 * GNU General Public License for more details.
28 * You should have received a copy of the GNU General Public License
29 * along with this program; if not, write to the Free Software
30 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
33 #define ZFCP_FSF_C_REVISION "$Revision: 1.88 $"
37 static int zfcp_fsf_exchange_config_data_handler(struct zfcp_fsf_req *);
38 static void zfcp_fsf_exchange_port_data_handler(struct zfcp_fsf_req *);
39 static int zfcp_fsf_open_port_handler(struct zfcp_fsf_req *);
40 static int zfcp_fsf_close_port_handler(struct zfcp_fsf_req *);
41 static int zfcp_fsf_close_physical_port_handler(struct zfcp_fsf_req *);
42 static int zfcp_fsf_open_unit_handler(struct zfcp_fsf_req *);
43 static int zfcp_fsf_close_unit_handler(struct zfcp_fsf_req *);
44 static int zfcp_fsf_send_fcp_command_handler(struct zfcp_fsf_req *);
45 static int zfcp_fsf_send_fcp_command_task_handler(struct zfcp_fsf_req *);
46 static int zfcp_fsf_send_fcp_command_task_management_handler(
47 struct zfcp_fsf_req *);
48 static int zfcp_fsf_abort_fcp_command_handler(struct zfcp_fsf_req *);
49 static int zfcp_fsf_status_read_handler(struct zfcp_fsf_req *);
50 static int zfcp_fsf_send_ct_handler(struct zfcp_fsf_req *);
51 static int zfcp_fsf_send_els_handler(struct zfcp_fsf_req *);
52 static int zfcp_fsf_control_file_handler(struct zfcp_fsf_req *);
53 static inline int zfcp_fsf_req_sbal_check(
54 unsigned long *, struct zfcp_qdio_queue *, int);
55 static inline int zfcp_use_one_sbal(
56 struct scatterlist *, int, struct scatterlist *, int);
57 static struct zfcp_fsf_req *zfcp_fsf_req_alloc(mempool_t *, int);
58 static int zfcp_fsf_req_send(struct zfcp_fsf_req *, struct timer_list *);
59 static int zfcp_fsf_protstatus_eval(struct zfcp_fsf_req *);
60 static int zfcp_fsf_fsfstatus_eval(struct zfcp_fsf_req *);
61 static int zfcp_fsf_fsfstatus_qual_eval(struct zfcp_fsf_req *);
62 static int zfcp_fsf_req_dispatch(struct zfcp_fsf_req *);
63 static void zfcp_fsf_req_dismiss(struct zfcp_fsf_req *);
64 static void zfcp_fsf_req_free(struct zfcp_fsf_req *);
66 /* association between FSF command and FSF QTCB type */
67 static u32 fsf_qtcb_type[] = {
68 [FSF_QTCB_FCP_CMND] = FSF_IO_COMMAND,
69 [FSF_QTCB_ABORT_FCP_CMND] = FSF_SUPPORT_COMMAND,
70 [FSF_QTCB_OPEN_PORT_WITH_DID] = FSF_SUPPORT_COMMAND,
71 [FSF_QTCB_OPEN_LUN] = FSF_SUPPORT_COMMAND,
72 [FSF_QTCB_CLOSE_LUN] = FSF_SUPPORT_COMMAND,
73 [FSF_QTCB_CLOSE_PORT] = FSF_SUPPORT_COMMAND,
74 [FSF_QTCB_CLOSE_PHYSICAL_PORT] = FSF_SUPPORT_COMMAND,
75 [FSF_QTCB_SEND_ELS] = FSF_SUPPORT_COMMAND,
76 [FSF_QTCB_SEND_GENERIC] = FSF_SUPPORT_COMMAND,
77 [FSF_QTCB_EXCHANGE_CONFIG_DATA] = FSF_CONFIG_COMMAND,
78 [FSF_QTCB_EXCHANGE_PORT_DATA] = FSF_PORT_COMMAND,
79 [FSF_QTCB_DOWNLOAD_CONTROL_FILE] = FSF_SUPPORT_COMMAND,
80 [FSF_QTCB_UPLOAD_CONTROL_FILE] = FSF_SUPPORT_COMMAND
83 static const char zfcp_act_subtable_type[5][8] = {
84 "unknown", "OS", "WWPN", "DID", "LUN"
87 /****************************************************************/
88 /*************** FSF related Functions *************************/
89 /****************************************************************/
91 #define ZFCP_LOG_AREA ZFCP_LOG_AREA_FSF
94 * function: zfcp_fsf_req_alloc
96 * purpose: Obtains an fsf_req and potentially a qtcb (for all but
97 * unsolicited requests) via helper functions
98 * Does some initial fsf request set-up.
100 * returns: pointer to allocated fsf_req if successfull
106 static struct zfcp_fsf_req *
107 zfcp_fsf_req_alloc(mempool_t *pool, int req_flags)
111 struct zfcp_fsf_req *fsf_req = NULL;
113 if (req_flags & ZFCP_REQ_NO_QTCB)
114 size = sizeof(struct zfcp_fsf_req);
116 size = sizeof(struct zfcp_fsf_req_pool_element);
118 if (likely(pool != NULL))
119 ptr = mempool_alloc(pool, GFP_ATOMIC);
121 ptr = kmalloc(size, GFP_ATOMIC);
123 if (unlikely(NULL == ptr))
126 memset(ptr, 0, size);
128 if (req_flags & ZFCP_REQ_NO_QTCB) {
129 fsf_req = (struct zfcp_fsf_req *) ptr;
131 fsf_req = &((struct zfcp_fsf_req_pool_element *) ptr)->fsf_req;
133 &((struct zfcp_fsf_req_pool_element *) ptr)->qtcb;
136 fsf_req->pool = pool;
143 * function: zfcp_fsf_req_free
145 * purpose: Frees the memory of an fsf_req (and potentially a qtcb) or
146 * returns it into the pool via helper functions.
153 zfcp_fsf_req_free(struct zfcp_fsf_req *fsf_req)
155 if (likely(fsf_req->pool != NULL))
156 mempool_free(fsf_req, fsf_req->pool);
168 * note: qdio queues shall be down (no ongoing inbound processing)
171 zfcp_fsf_req_dismiss_all(struct zfcp_adapter *adapter)
174 struct zfcp_fsf_req *fsf_req, *tmp;
176 list_for_each_entry_safe(fsf_req, tmp, &adapter->fsf_req_list_head,
178 zfcp_fsf_req_dismiss(fsf_req);
179 /* wait_event_timeout? */
180 while (!list_empty(&adapter->fsf_req_list_head)) {
181 ZFCP_LOG_DEBUG("fsf req list of adapter %s not yet empty\n",
182 zfcp_get_busid_by_adapter(adapter));
183 /* wait for woken intiators to clean up their requests */
184 msleep(jiffies_to_msecs(ZFCP_FSFREQ_CLEANUP_TIMEOUT));
187 /* consistency check */
188 if (atomic_read(&adapter->fsf_reqs_active)) {
189 ZFCP_LOG_NORMAL("bug: There are still %d FSF requests pending "
190 "on adapter %s after cleanup.\n",
191 atomic_read(&adapter->fsf_reqs_active),
192 zfcp_get_busid_by_adapter(adapter));
193 atomic_set(&adapter->fsf_reqs_active, 0);
207 zfcp_fsf_req_dismiss(struct zfcp_fsf_req *fsf_req)
209 fsf_req->status |= ZFCP_STATUS_FSFREQ_DISMISSED;
210 zfcp_fsf_req_complete(fsf_req);
214 * function: zfcp_fsf_req_complete
216 * purpose: Updates active counts and timers for openfcp-reqs
217 * May cleanup request after req_eval returns
219 * returns: 0 - success
225 zfcp_fsf_req_complete(struct zfcp_fsf_req *fsf_req)
229 struct zfcp_adapter *adapter = fsf_req->adapter;
231 /* do some statistics */
232 atomic_dec(&adapter->fsf_reqs_active);
234 if (unlikely(fsf_req->fsf_command == FSF_QTCB_UNSOLICITED_STATUS)) {
235 ZFCP_LOG_DEBUG("Status read response received\n");
237 * Note: all cleanup handling is done in the callchain of
238 * the function call-chain below.
240 zfcp_fsf_status_read_handler(fsf_req);
243 zfcp_fsf_protstatus_eval(fsf_req);
246 * fsf_req may be deleted due to waking up functions, so
247 * cleanup is saved here and used later
249 if (likely(fsf_req->status & ZFCP_STATUS_FSFREQ_CLEANUP))
254 fsf_req->status |= ZFCP_STATUS_FSFREQ_COMPLETED;
256 /* cleanup request if requested by initiator */
257 if (likely(cleanup)) {
258 ZFCP_LOG_TRACE("removing FSF request %p\n", fsf_req);
260 * lock must not be held here since it will be
261 * grabed by the called routine, too
263 zfcp_fsf_req_cleanup(fsf_req);
265 /* notify initiator waiting for the requests completion */
266 ZFCP_LOG_TRACE("waking initiator of FSF request %p\n",fsf_req);
268 * FIXME: Race! We must not access fsf_req here as it might have been
269 * cleaned up already due to the set ZFCP_STATUS_FSFREQ_COMPLETED
270 * flag. It's an improbable case. But, we have the same paranoia for
271 * the cleanup flag already.
272 * Might better be handled using complete()?
273 * (setting the flag and doing wakeup ought to be atomic
274 * with regard to checking the flag as long as waitqueue is
275 * part of the to be released structure)
277 wake_up(&fsf_req->completion_wq);
285 * function: zfcp_fsf_protstatus_eval
287 * purpose: evaluates the QTCB of the finished FSF request
288 * and initiates appropriate actions
289 * (usually calling FSF command specific handlers)
298 zfcp_fsf_protstatus_eval(struct zfcp_fsf_req *fsf_req)
301 struct zfcp_adapter *adapter = fsf_req->adapter;
303 ZFCP_LOG_DEBUG("QTCB is at %p\n", fsf_req->qtcb);
305 if (fsf_req->status & ZFCP_STATUS_FSFREQ_DISMISSED) {
306 ZFCP_LOG_DEBUG("fsf_req 0x%lx has been dismissed\n",
307 (unsigned long) fsf_req);
308 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR |
309 ZFCP_STATUS_FSFREQ_RETRY; /* only for SCSI cmnds. */
310 zfcp_cmd_dbf_event_fsf("dismiss", fsf_req, NULL, 0);
311 goto skip_protstatus;
314 /* log additional information provided by FSF (if any) */
315 if (unlikely(fsf_req->qtcb->header.log_length)) {
316 /* do not trust them ;-) */
317 if (fsf_req->qtcb->header.log_start > sizeof(struct fsf_qtcb)) {
319 ("bug: ULP (FSF logging) log data starts "
320 "beyond end of packet header. Ignored. "
321 "(start=%i, size=%li)\n",
322 fsf_req->qtcb->header.log_start,
323 sizeof(struct fsf_qtcb));
326 if ((size_t) (fsf_req->qtcb->header.log_start +
327 fsf_req->qtcb->header.log_length)
328 > sizeof(struct fsf_qtcb)) {
329 ZFCP_LOG_NORMAL("bug: ULP (FSF logging) log data ends "
330 "beyond end of packet header. Ignored. "
331 "(start=%i, length=%i, size=%li)\n",
332 fsf_req->qtcb->header.log_start,
333 fsf_req->qtcb->header.log_length,
334 sizeof(struct fsf_qtcb));
337 ZFCP_LOG_TRACE("ULP log data: \n");
338 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_TRACE,
339 (char *) fsf_req->qtcb +
340 fsf_req->qtcb->header.log_start,
341 fsf_req->qtcb->header.log_length);
345 /* evaluate FSF Protocol Status */
346 switch (fsf_req->qtcb->prefix.prot_status) {
349 ZFCP_LOG_TRACE("FSF_PROT_GOOD\n");
352 case FSF_PROT_FSF_STATUS_PRESENTED:
353 ZFCP_LOG_TRACE("FSF_PROT_FSF_STATUS_PRESENTED\n");
356 case FSF_PROT_QTCB_VERSION_ERROR:
357 ZFCP_LOG_FLAGS(0, "FSF_PROT_QTCB_VERSION_ERROR\n");
358 ZFCP_LOG_NORMAL("error: The adapter %s contains "
359 "microcode of version 0x%x, the device driver "
360 "only supports 0x%x. Aborting.\n",
361 zfcp_get_busid_by_adapter(adapter),
362 fsf_req->qtcb->prefix.prot_status_qual.
363 version_error.fsf_version, ZFCP_QTCB_VERSION);
364 /* stop operation for this adapter */
365 debug_text_exception(adapter->erp_dbf, 0, "prot_ver_err");
366 zfcp_erp_adapter_shutdown(adapter, 0);
367 zfcp_cmd_dbf_event_fsf("qverserr", fsf_req,
368 &fsf_req->qtcb->prefix.prot_status_qual,
369 sizeof (union fsf_prot_status_qual));
370 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
373 case FSF_PROT_SEQ_NUMB_ERROR:
374 ZFCP_LOG_FLAGS(0, "FSF_PROT_SEQ_NUMB_ERROR\n");
375 ZFCP_LOG_NORMAL("bug: Sequence number mismatch between "
376 "driver (0x%x) and adapter %s (0x%x). "
377 "Restarting all operations on this adapter.\n",
378 fsf_req->qtcb->prefix.req_seq_no,
379 zfcp_get_busid_by_adapter(adapter),
380 fsf_req->qtcb->prefix.prot_status_qual.
381 sequence_error.exp_req_seq_no);
382 debug_text_exception(adapter->erp_dbf, 0, "prot_seq_err");
383 /* restart operation on this adapter */
384 zfcp_erp_adapter_reopen(adapter, 0);
385 zfcp_cmd_dbf_event_fsf("seqnoerr", fsf_req,
386 &fsf_req->qtcb->prefix.prot_status_qual,
387 sizeof (union fsf_prot_status_qual));
388 fsf_req->status |= ZFCP_STATUS_FSFREQ_RETRY;
389 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
392 case FSF_PROT_UNSUPP_QTCB_TYPE:
393 ZFCP_LOG_FLAGS(0, "FSF_PROT_UNSUP_QTCB_TYPE\n");
394 ZFCP_LOG_NORMAL("error: Packet header type used by the "
395 "device driver is incompatible with "
396 "that used on adapter %s. "
397 "Stopping all operations on this adapter.\n",
398 zfcp_get_busid_by_adapter(adapter));
399 debug_text_exception(adapter->erp_dbf, 0, "prot_unsup_qtcb");
400 zfcp_erp_adapter_shutdown(adapter, 0);
401 zfcp_cmd_dbf_event_fsf("unsqtcbt", fsf_req,
402 &fsf_req->qtcb->prefix.prot_status_qual,
403 sizeof (union fsf_prot_status_qual));
404 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
407 case FSF_PROT_HOST_CONNECTION_INITIALIZING:
408 ZFCP_LOG_FLAGS(1, "FSF_PROT_HOST_CONNECTION_INITIALIZING\n");
409 zfcp_cmd_dbf_event_fsf("hconinit", fsf_req,
410 &fsf_req->qtcb->prefix.prot_status_qual,
411 sizeof (union fsf_prot_status_qual));
412 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
413 atomic_set_mask(ZFCP_STATUS_ADAPTER_HOST_CON_INIT,
415 debug_text_event(adapter->erp_dbf, 3, "prot_con_init");
418 case FSF_PROT_DUPLICATE_REQUEST_ID:
419 ZFCP_LOG_FLAGS(0, "FSF_PROT_DUPLICATE_REQUEST_IDS\n");
421 ZFCP_LOG_NORMAL("bug: The request identifier 0x%Lx "
422 "to the adapter %s is ambiguous. "
423 "Stopping all operations on this "
425 *(unsigned long long *)
426 (&fsf_req->qtcb->bottom.support.
428 zfcp_get_busid_by_adapter(adapter));
430 ZFCP_LOG_NORMAL("bug: The request identifier %p "
431 "to the adapter %s is ambiguous. "
432 "Stopping all operations on this "
434 "(bug: got this for an unsolicited "
435 "status read request)\n",
437 zfcp_get_busid_by_adapter(adapter));
439 debug_text_exception(adapter->erp_dbf, 0, "prot_dup_id");
440 zfcp_erp_adapter_shutdown(adapter, 0);
441 zfcp_cmd_dbf_event_fsf("dupreqid", fsf_req,
442 &fsf_req->qtcb->prefix.prot_status_qual,
443 sizeof (union fsf_prot_status_qual));
444 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
447 case FSF_PROT_LINK_DOWN:
448 ZFCP_LOG_FLAGS(1, "FSF_PROT_LINK_DOWN\n");
450 * 'test and set' is not atomic here -
451 * it's ok as long as calls to our response queue handler
452 * (and thus execution of this code here) are serialized
455 if (!atomic_test_mask(ZFCP_STATUS_ADAPTER_LINK_UNPLUGGED,
457 switch (fsf_req->qtcb->prefix.prot_status_qual.
458 locallink_error.code) {
459 case FSF_PSQ_LINK_NOLIGHT:
460 ZFCP_LOG_INFO("The local link to adapter %s "
461 "is down (no light detected).\n",
462 zfcp_get_busid_by_adapter(
465 case FSF_PSQ_LINK_WRAPPLUG:
466 ZFCP_LOG_INFO("The local link to adapter %s "
467 "is down (wrap plug detected).\n",
468 zfcp_get_busid_by_adapter(
471 case FSF_PSQ_LINK_NOFCP:
472 ZFCP_LOG_INFO("The local link to adapter %s "
473 "is down (adjacent node on "
474 "link does not support FCP).\n",
475 zfcp_get_busid_by_adapter(
479 ZFCP_LOG_INFO("The local link to adapter %s "
481 "(warning: unknown reason "
483 zfcp_get_busid_by_adapter(
489 * Due to the 'erp failed' flag the adapter won't
490 * be recovered but will be just set to 'blocked'
491 * state. All subordinary devices will have state
492 * 'blocked' and 'erp failed', too.
493 * Thus the adapter is still able to provide
494 * 'link up' status without being flooded with
496 * (note: even 'close port' is not permitted)
498 ZFCP_LOG_INFO("Stopping all operations for adapter "
500 zfcp_get_busid_by_adapter(adapter));
501 atomic_set_mask(ZFCP_STATUS_ADAPTER_LINK_UNPLUGGED |
502 ZFCP_STATUS_COMMON_ERP_FAILED,
504 zfcp_erp_adapter_reopen(adapter, 0);
505 debug_text_event(adapter->erp_dbf, 1, "prot_link_down");
507 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
510 case FSF_PROT_REEST_QUEUE:
511 ZFCP_LOG_FLAGS(1, "FSF_PROT_REEST_QUEUE\n");
512 debug_text_event(adapter->erp_dbf, 1, "prot_reest_queue");
513 ZFCP_LOG_INFO("The local link to adapter with "
514 "%s was re-plugged. "
515 "Re-starting operations on this adapter.\n",
516 zfcp_get_busid_by_adapter(adapter));
517 /* All ports should be marked as ready to run again */
518 zfcp_erp_modify_adapter_status(adapter,
519 ZFCP_STATUS_COMMON_RUNNING,
521 zfcp_erp_adapter_reopen(adapter,
522 ZFCP_STATUS_ADAPTER_LINK_UNPLUGGED
523 | ZFCP_STATUS_COMMON_ERP_FAILED);
524 zfcp_cmd_dbf_event_fsf("reestque", fsf_req,
525 &fsf_req->qtcb->prefix.prot_status_qual,
526 sizeof (union fsf_prot_status_qual));
527 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
530 case FSF_PROT_ERROR_STATE:
531 ZFCP_LOG_FLAGS(0, "FSF_PROT_ERROR_STATE\n");
532 ZFCP_LOG_NORMAL("error: The adapter %s "
533 "has entered the error state. "
534 "Restarting all operations on this "
536 zfcp_get_busid_by_adapter(adapter));
537 debug_text_event(adapter->erp_dbf, 0, "prot_err_sta");
538 /* restart operation on this adapter */
539 zfcp_erp_adapter_reopen(adapter, 0);
540 zfcp_cmd_dbf_event_fsf("proterrs", fsf_req,
541 &fsf_req->qtcb->prefix.prot_status_qual,
542 sizeof (union fsf_prot_status_qual));
543 fsf_req->status |= ZFCP_STATUS_FSFREQ_RETRY;
544 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
548 ZFCP_LOG_NORMAL("bug: Transfer protocol status information "
549 "provided by the adapter %s "
550 "is not compatible with the device driver. "
551 "Stopping all operations on this adapter. "
552 "(debug info 0x%x).\n",
553 zfcp_get_busid_by_adapter(adapter),
554 fsf_req->qtcb->prefix.prot_status);
555 debug_text_event(adapter->erp_dbf, 0, "prot_inval:");
556 debug_exception(adapter->erp_dbf, 0,
557 &fsf_req->qtcb->prefix.prot_status,
559 zfcp_erp_adapter_shutdown(adapter, 0);
560 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
565 * always call specific handlers to give them a chance to do
566 * something meaningful even in error cases
568 zfcp_fsf_fsfstatus_eval(fsf_req);
573 * function: zfcp_fsf_fsfstatus_eval
575 * purpose: evaluates FSF status of completed FSF request
576 * and acts accordingly
581 zfcp_fsf_fsfstatus_eval(struct zfcp_fsf_req *fsf_req)
585 if (unlikely(fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR)) {
589 /* evaluate FSF Status */
590 switch (fsf_req->qtcb->header.fsf_status) {
591 case FSF_UNKNOWN_COMMAND:
592 ZFCP_LOG_FLAGS(0, "FSF_UNKNOWN_COMMAND\n");
593 ZFCP_LOG_NORMAL("bug: Command issued by the device driver is "
594 "not known by the adapter %s "
595 "Stopping all operations on this adapter. "
596 "(debug info 0x%x).\n",
597 zfcp_get_busid_by_adapter(fsf_req->adapter),
598 fsf_req->qtcb->header.fsf_command);
599 debug_text_exception(fsf_req->adapter->erp_dbf, 0,
601 zfcp_erp_adapter_shutdown(fsf_req->adapter, 0);
602 zfcp_cmd_dbf_event_fsf("unknownc", fsf_req,
603 &fsf_req->qtcb->header.fsf_status_qual,
604 sizeof (union fsf_status_qual));
605 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
608 case FSF_FCP_RSP_AVAILABLE:
609 ZFCP_LOG_FLAGS(2, "FSF_FCP_RSP_AVAILABLE\n");
610 ZFCP_LOG_DEBUG("FCP Sense data will be presented to the "
612 debug_text_event(fsf_req->adapter->erp_dbf, 3, "fsf_s_rsp");
615 case FSF_ADAPTER_STATUS_AVAILABLE:
616 ZFCP_LOG_FLAGS(2, "FSF_ADAPTER_STATUS_AVAILABLE\n");
617 debug_text_event(fsf_req->adapter->erp_dbf, 2, "fsf_s_astatus");
618 zfcp_fsf_fsfstatus_qual_eval(fsf_req);
627 * always call specific handlers to give them a chance to do
628 * something meaningful even in error cases
630 zfcp_fsf_req_dispatch(fsf_req);
636 * function: zfcp_fsf_fsfstatus_qual_eval
638 * purpose: evaluates FSF status-qualifier of completed FSF request
639 * and acts accordingly
644 zfcp_fsf_fsfstatus_qual_eval(struct zfcp_fsf_req *fsf_req)
648 switch (fsf_req->qtcb->header.fsf_status_qual.word[0]) {
649 case FSF_SQ_FCP_RSP_AVAILABLE:
650 ZFCP_LOG_FLAGS(2, "FSF_SQ_FCP_RSP_AVAILABLE\n");
651 debug_text_event(fsf_req->adapter->erp_dbf, 4, "fsf_sq_rsp");
653 case FSF_SQ_RETRY_IF_POSSIBLE:
654 ZFCP_LOG_FLAGS(2, "FSF_SQ_RETRY_IF_POSSIBLE\n");
655 /* The SCSI-stack may now issue retries or escalate */
656 debug_text_event(fsf_req->adapter->erp_dbf, 2, "fsf_sq_retry");
657 zfcp_cmd_dbf_event_fsf("sqretry", fsf_req,
658 &fsf_req->qtcb->header.fsf_status_qual,
659 sizeof (union fsf_status_qual));
660 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
662 case FSF_SQ_COMMAND_ABORTED:
663 ZFCP_LOG_FLAGS(2, "FSF_SQ_COMMAND_ABORTED\n");
664 /* Carry the aborted state on to upper layer */
665 debug_text_event(fsf_req->adapter->erp_dbf, 2, "fsf_sq_abort");
666 zfcp_cmd_dbf_event_fsf("sqabort", fsf_req,
667 &fsf_req->qtcb->header.fsf_status_qual,
668 sizeof (union fsf_status_qual));
669 fsf_req->status |= ZFCP_STATUS_FSFREQ_ABORTED;
670 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
672 case FSF_SQ_NO_RECOM:
673 ZFCP_LOG_FLAGS(0, "FSF_SQ_NO_RECOM\n");
674 debug_text_exception(fsf_req->adapter->erp_dbf, 0,
676 ZFCP_LOG_NORMAL("bug: No recommendation could be given for a"
677 "problem on the adapter %s "
678 "Stopping all operations on this adapter. ",
679 zfcp_get_busid_by_adapter(fsf_req->adapter));
680 zfcp_erp_adapter_shutdown(fsf_req->adapter, 0);
681 zfcp_cmd_dbf_event_fsf("sqnrecom", fsf_req,
682 &fsf_req->qtcb->header.fsf_status_qual,
683 sizeof (union fsf_status_qual));
684 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
686 case FSF_SQ_ULP_PROGRAMMING_ERROR:
687 ZFCP_LOG_FLAGS(0, "FSF_SQ_ULP_PROGRAMMING_ERROR\n");
688 ZFCP_LOG_NORMAL("error: not enough SBALs for data transfer "
690 zfcp_get_busid_by_adapter(fsf_req->adapter));
691 debug_text_exception(fsf_req->adapter->erp_dbf, 0,
693 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
695 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
696 case FSF_SQ_NO_RETRY_POSSIBLE:
697 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
698 /* dealt with in the respective functions */
701 ZFCP_LOG_NORMAL("bug: Additional status info could "
702 "not be interpreted properly.\n");
703 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_NORMAL,
704 (char *) &fsf_req->qtcb->header.fsf_status_qual,
705 sizeof (union fsf_status_qual));
706 debug_text_event(fsf_req->adapter->erp_dbf, 0, "fsf_sq_inval:");
707 debug_exception(fsf_req->adapter->erp_dbf, 0,
708 &fsf_req->qtcb->header.fsf_status_qual.word[0],
710 zfcp_cmd_dbf_event_fsf("squndef", fsf_req,
711 &fsf_req->qtcb->header.fsf_status_qual,
712 sizeof (union fsf_status_qual));
713 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
721 * function: zfcp_fsf_req_dispatch
723 * purpose: calls the appropriate command specific handler
728 zfcp_fsf_req_dispatch(struct zfcp_fsf_req *fsf_req)
730 struct zfcp_erp_action *erp_action = fsf_req->erp_action;
731 struct zfcp_adapter *adapter = fsf_req->adapter;
734 if (unlikely(fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR)) {
735 ZFCP_LOG_TRACE("fsf_req=%p, QTCB=%p\n", fsf_req, fsf_req->qtcb);
736 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_TRACE,
737 (char *) fsf_req->qtcb, sizeof(struct fsf_qtcb));
740 switch (fsf_req->fsf_command) {
742 case FSF_QTCB_FCP_CMND:
743 ZFCP_LOG_FLAGS(3, "FSF_QTCB_FCP_CMND\n");
744 zfcp_fsf_send_fcp_command_handler(fsf_req);
747 case FSF_QTCB_ABORT_FCP_CMND:
748 ZFCP_LOG_FLAGS(2, "FSF_QTCB_ABORT_FCP_CMND\n");
749 zfcp_fsf_abort_fcp_command_handler(fsf_req);
752 case FSF_QTCB_SEND_GENERIC:
753 ZFCP_LOG_FLAGS(2, "FSF_QTCB_SEND_GENERIC\n");
754 zfcp_fsf_send_ct_handler(fsf_req);
757 case FSF_QTCB_OPEN_PORT_WITH_DID:
758 ZFCP_LOG_FLAGS(2, "FSF_QTCB_OPEN_PORT_WITH_DID\n");
759 zfcp_fsf_open_port_handler(fsf_req);
762 case FSF_QTCB_OPEN_LUN:
763 ZFCP_LOG_FLAGS(2, "FSF_QTCB_OPEN_LUN\n");
764 zfcp_fsf_open_unit_handler(fsf_req);
767 case FSF_QTCB_CLOSE_LUN:
768 ZFCP_LOG_FLAGS(2, "FSF_QTCB_CLOSE_LUN\n");
769 zfcp_fsf_close_unit_handler(fsf_req);
772 case FSF_QTCB_CLOSE_PORT:
773 ZFCP_LOG_FLAGS(2, "FSF_QTCB_CLOSE_PORT\n");
774 zfcp_fsf_close_port_handler(fsf_req);
777 case FSF_QTCB_CLOSE_PHYSICAL_PORT:
778 ZFCP_LOG_FLAGS(2, "FSF_QTCB_CLOSE_PHYSICAL_PORT\n");
779 zfcp_fsf_close_physical_port_handler(fsf_req);
782 case FSF_QTCB_EXCHANGE_CONFIG_DATA:
783 ZFCP_LOG_FLAGS(2, "FSF_QTCB_EXCHANGE_CONFIG_DATA\n");
784 zfcp_fsf_exchange_config_data_handler(fsf_req);
787 case FSF_QTCB_EXCHANGE_PORT_DATA:
788 ZFCP_LOG_FLAGS(2, "FSF_QTCB_EXCHANGE_PORT_DATA\n");
789 zfcp_fsf_exchange_port_data_handler(fsf_req);
792 case FSF_QTCB_SEND_ELS:
793 ZFCP_LOG_FLAGS(2, "FSF_QTCB_SEND_ELS\n");
794 zfcp_fsf_send_els_handler(fsf_req);
797 case FSF_QTCB_DOWNLOAD_CONTROL_FILE:
798 ZFCP_LOG_FLAGS(2, "FSF_QTCB_DOWNLOAD_CONTROL_FILE\n");
799 zfcp_fsf_control_file_handler(fsf_req);
802 case FSF_QTCB_UPLOAD_CONTROL_FILE:
803 ZFCP_LOG_FLAGS(2, "FSF_QTCB_UPLOAD_CONTROL_FILE\n");
804 zfcp_fsf_control_file_handler(fsf_req);
808 ZFCP_LOG_FLAGS(2, "FSF_QTCB_UNKNOWN\n");
809 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
810 ZFCP_LOG_NORMAL("bug: Command issued by the device driver is "
811 "not supported by the adapter %s\n",
812 zfcp_get_busid_by_adapter(fsf_req->adapter));
813 if (fsf_req->fsf_command != fsf_req->qtcb->header.fsf_command)
815 ("bug: Command issued by the device driver differs "
816 "from the command returned by the adapter %s "
817 "(debug info 0x%x, 0x%x).\n",
818 zfcp_get_busid_by_adapter(fsf_req->adapter),
819 fsf_req->fsf_command,
820 fsf_req->qtcb->header.fsf_command);
826 debug_text_event(adapter->erp_dbf, 3, "a_frh");
827 debug_event(adapter->erp_dbf, 3, &erp_action->action, sizeof (int));
828 zfcp_erp_async_handler(erp_action, 0);
834 * function: zfcp_fsf_status_read
836 * purpose: initiates a Status Read command at the specified adapter
841 zfcp_fsf_status_read(struct zfcp_adapter *adapter, int req_flags)
843 struct zfcp_fsf_req *fsf_req;
844 struct fsf_status_read_buffer *status_buffer;
845 unsigned long lock_flags;
846 volatile struct qdio_buffer_element *sbale;
849 /* setup new FSF request */
850 retval = zfcp_fsf_req_create(adapter, FSF_QTCB_UNSOLICITED_STATUS,
851 req_flags | ZFCP_REQ_NO_QTCB,
852 adapter->pool.fsf_req_status_read,
853 &lock_flags, &fsf_req);
855 ZFCP_LOG_INFO("error: Could not create unsolicited status "
856 "buffer for adapter %s.\n",
857 zfcp_get_busid_by_adapter(adapter));
858 goto failed_req_create;
861 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
862 sbale[0].flags |= SBAL_FLAGS0_TYPE_STATUS;
863 sbale[2].flags |= SBAL_FLAGS_LAST_ENTRY;
864 fsf_req->sbale_curr = 2;
867 mempool_alloc(adapter->pool.data_status_read, GFP_ATOMIC);
868 if (!status_buffer) {
869 ZFCP_LOG_NORMAL("bug: could not get some buffer\n");
872 memset(status_buffer, 0, sizeof (struct fsf_status_read_buffer));
873 fsf_req->data.status_read.buffer = status_buffer;
875 /* insert pointer to respective buffer */
876 sbale = zfcp_qdio_sbale_curr(fsf_req);
877 sbale->addr = (void *) status_buffer;
878 sbale->length = sizeof(struct fsf_status_read_buffer);
880 /* start QDIO request for this FSF request */
881 retval = zfcp_fsf_req_send(fsf_req, NULL);
883 ZFCP_LOG_DEBUG("error: Could not set-up unsolicited status "
885 goto failed_req_send;
888 ZFCP_LOG_TRACE("Status Read request initiated (adapter%s)\n",
889 zfcp_get_busid_by_adapter(adapter));
893 mempool_free(status_buffer, adapter->pool.data_status_read);
896 zfcp_fsf_req_free(fsf_req);
899 write_unlock_irqrestore(&adapter->request_queue.queue_lock, lock_flags);
904 zfcp_fsf_status_read_port_closed(struct zfcp_fsf_req *fsf_req)
906 struct fsf_status_read_buffer *status_buffer;
907 struct zfcp_adapter *adapter;
908 struct zfcp_port *port;
911 status_buffer = fsf_req->data.status_read.buffer;
912 adapter = fsf_req->adapter;
914 read_lock_irqsave(&zfcp_data.config_lock, flags);
915 list_for_each_entry(port, &adapter->port_list_head, list)
916 if (port->d_id == (status_buffer->d_id & ZFCP_DID_MASK))
918 read_unlock_irqrestore(&zfcp_data.config_lock, flags);
920 if (!port || (port->d_id != (status_buffer->d_id & ZFCP_DID_MASK))) {
921 ZFCP_LOG_NORMAL("bug: Reopen port indication received for"
922 "nonexisting port with d_id 0x%08x on "
923 "adapter %s. Ignored.\n",
924 status_buffer->d_id & ZFCP_DID_MASK,
925 zfcp_get_busid_by_adapter(adapter));
929 switch (status_buffer->status_subtype) {
931 case FSF_STATUS_READ_SUB_CLOSE_PHYS_PORT:
932 ZFCP_LOG_FLAGS(2, "FSF_STATUS_READ_SUB_CLOSE_PHYS_PORT\n");
933 debug_text_event(adapter->erp_dbf, 3, "unsol_pc_phys:");
934 zfcp_erp_port_reopen(port, 0);
937 case FSF_STATUS_READ_SUB_ERROR_PORT:
938 ZFCP_LOG_FLAGS(1, "FSF_STATUS_READ_SUB_ERROR_PORT\n");
939 debug_text_event(adapter->erp_dbf, 1, "unsol_pc_err:");
940 zfcp_erp_port_shutdown(port, 0);
944 debug_text_event(adapter->erp_dbf, 0, "unsol_unk_sub:");
945 debug_exception(adapter->erp_dbf, 0,
946 &status_buffer->status_subtype, sizeof (u32));
947 ZFCP_LOG_NORMAL("bug: Undefined status subtype received "
948 "for a reopen indication on port with "
949 "d_id 0x%08x on the adapter %s. "
950 "Ignored. (debug info 0x%x)\n",
952 zfcp_get_busid_by_adapter(adapter),
953 status_buffer->status_subtype);
960 * function: zfcp_fsf_status_read_handler
962 * purpose: is called for finished Open Port command
967 zfcp_fsf_status_read_handler(struct zfcp_fsf_req *fsf_req)
970 struct zfcp_adapter *adapter = fsf_req->adapter;
971 struct fsf_status_read_buffer *status_buffer =
972 fsf_req->data.status_read.buffer;
974 if (fsf_req->status & ZFCP_STATUS_FSFREQ_DISMISSED) {
975 mempool_free(status_buffer, adapter->pool.data_status_read);
976 zfcp_fsf_req_cleanup(fsf_req);
980 switch (status_buffer->status_type) {
982 case FSF_STATUS_READ_PORT_CLOSED:
983 ZFCP_LOG_FLAGS(1, "FSF_STATUS_READ_PORT_CLOSED\n");
984 debug_text_event(adapter->erp_dbf, 3, "unsol_pclosed:");
985 debug_event(adapter->erp_dbf, 3,
986 &status_buffer->d_id, sizeof (u32));
987 zfcp_fsf_status_read_port_closed(fsf_req);
990 case FSF_STATUS_READ_INCOMING_ELS:
991 ZFCP_LOG_FLAGS(1, "FSF_STATUS_READ_INCOMING_ELS\n");
992 debug_text_event(adapter->erp_dbf, 3, "unsol_els:");
993 zfcp_fsf_incoming_els(fsf_req);
996 case FSF_STATUS_READ_SENSE_DATA_AVAIL:
997 ZFCP_LOG_FLAGS(1, "FSF_STATUS_READ_SENSE_DATA_AVAIL\n");
998 debug_text_event(adapter->erp_dbf, 3, "unsol_sense:");
999 ZFCP_LOG_INFO("unsolicited sense data received (adapter %s)\n",
1000 zfcp_get_busid_by_adapter(adapter));
1001 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_NORMAL, (char *) status_buffer,
1002 sizeof(struct fsf_status_read_buffer));
1005 case FSF_STATUS_READ_BIT_ERROR_THRESHOLD:
1006 ZFCP_LOG_FLAGS(1, "FSF_STATUS_READ_BIT_ERROR_THRESHOLD\n");
1007 debug_text_event(adapter->erp_dbf, 3, "unsol_bit_err:");
1008 ZFCP_LOG_NORMAL("Bit error threshold data received:\n");
1009 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_NORMAL,
1010 (char *) status_buffer,
1011 sizeof (struct fsf_status_read_buffer));
1014 case FSF_STATUS_READ_LINK_DOWN:
1015 ZFCP_LOG_FLAGS(1, "FSF_STATUS_READ_LINK_DOWN\n");
1016 debug_text_event(adapter->erp_dbf, 0, "unsol_link_down:");
1017 ZFCP_LOG_INFO("Local link to adapter %s is down\n",
1018 zfcp_get_busid_by_adapter(adapter));
1019 atomic_set_mask(ZFCP_STATUS_ADAPTER_LINK_UNPLUGGED,
1021 zfcp_erp_adapter_failed(adapter);
1024 case FSF_STATUS_READ_LINK_UP:
1025 ZFCP_LOG_FLAGS(1, "FSF_STATUS_READ_LINK_UP\n");
1026 debug_text_event(adapter->erp_dbf, 2, "unsol_link_up:");
1027 ZFCP_LOG_INFO("Local link to adapter %s was replugged. "
1028 "Restarting operations on this adapter\n",
1029 zfcp_get_busid_by_adapter(adapter));
1030 /* All ports should be marked as ready to run again */
1031 zfcp_erp_modify_adapter_status(adapter,
1032 ZFCP_STATUS_COMMON_RUNNING,
1034 zfcp_erp_adapter_reopen(adapter,
1035 ZFCP_STATUS_ADAPTER_LINK_UNPLUGGED
1036 | ZFCP_STATUS_COMMON_ERP_FAILED);
1039 case FSF_STATUS_READ_CFDC_UPDATED:
1040 ZFCP_LOG_FLAGS(1, "FSF_STATUS_READ_CFDC_UPDATED\n");
1041 debug_text_event(adapter->erp_dbf, 2, "unsol_cfdc_update:");
1042 ZFCP_LOG_INFO("CFDC has been updated on the adapter %s\n",
1043 zfcp_get_busid_by_adapter(adapter));
1044 zfcp_erp_adapter_access_changed(adapter);
1047 case FSF_STATUS_READ_CFDC_HARDENED:
1048 ZFCP_LOG_FLAGS(1, "FSF_STATUS_READ_CFDC_HARDENED\n");
1049 debug_text_event(adapter->erp_dbf, 2, "unsol_cfdc_harden:");
1050 switch (status_buffer->status_subtype) {
1051 case FSF_STATUS_READ_SUB_CFDC_HARDENED_ON_SE:
1052 ZFCP_LOG_INFO("CFDC of adapter %s saved on SE\n",
1053 zfcp_get_busid_by_adapter(adapter));
1055 case FSF_STATUS_READ_SUB_CFDC_HARDENED_ON_SE2:
1056 ZFCP_LOG_INFO("CFDC of adapter %s has been copied "
1057 "to the secondary SE\n",
1058 zfcp_get_busid_by_adapter(adapter));
1061 ZFCP_LOG_INFO("CFDC of adapter %s has been hardened\n",
1062 zfcp_get_busid_by_adapter(adapter));
1067 debug_text_event(adapter->erp_dbf, 0, "unsol_unknown:");
1068 debug_exception(adapter->erp_dbf, 0,
1069 &status_buffer->status_type, sizeof (u32));
1070 ZFCP_LOG_NORMAL("bug: An unsolicited status packet of unknown "
1071 "type was received (debug info 0x%x)\n",
1072 status_buffer->status_type);
1073 ZFCP_LOG_DEBUG("Dump of status_read_buffer %p:\n",
1075 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
1076 (char *) status_buffer,
1077 sizeof (struct fsf_status_read_buffer));
1080 mempool_free(status_buffer, adapter->pool.data_status_read);
1081 zfcp_fsf_req_cleanup(fsf_req);
1083 * recycle buffer and start new request repeat until outbound
1084 * queue is empty or adapter shutdown is requested
1088 * we may wait in the req_create for 5s during shutdown, so
1089 * qdio_cleanup will have to wait at least that long before returning
1090 * with failure to allow us a proper cleanup under all circumstances
1094 * allocation failure possible? (Is this code needed?)
1096 retval = zfcp_fsf_status_read(adapter, 0);
1098 ZFCP_LOG_INFO("Failed to create unsolicited status read "
1099 "request for the adapter %s.\n",
1100 zfcp_get_busid_by_adapter(adapter));
1101 /* temporary fix to avoid status read buffer shortage */
1102 adapter->status_read_failed++;
1103 if ((ZFCP_STATUS_READS_RECOM - adapter->status_read_failed)
1104 < ZFCP_STATUS_READ_FAILED_THRESHOLD) {
1105 ZFCP_LOG_INFO("restart adapter %s due to status read "
1106 "buffer shortage\n",
1107 zfcp_get_busid_by_adapter(adapter));
1108 zfcp_erp_adapter_reopen(adapter, 0);
1116 * function: zfcp_fsf_abort_fcp_command
1118 * purpose: tells FSF to abort a running SCSI command
1120 * returns: address of initiated FSF request
1121 * NULL - request could not be initiated
1123 * FIXME(design): should be watched by a timeout !!!
1124 * FIXME(design) shouldn't this be modified to return an int
1125 * also...don't know how though
1127 struct zfcp_fsf_req *
1128 zfcp_fsf_abort_fcp_command(unsigned long old_req_id,
1129 struct zfcp_adapter *adapter,
1130 struct zfcp_unit *unit, int req_flags)
1132 volatile struct qdio_buffer_element *sbale;
1133 unsigned long lock_flags;
1134 struct zfcp_fsf_req *fsf_req = NULL;
1137 /* setup new FSF request */
1138 retval = zfcp_fsf_req_create(adapter, FSF_QTCB_ABORT_FCP_CMND,
1139 req_flags, adapter->pool.fsf_req_abort,
1140 &lock_flags, &fsf_req);
1142 ZFCP_LOG_INFO("error: Failed to create an abort command "
1143 "request for lun 0x%016Lx on port 0x%016Lx "
1147 zfcp_get_busid_by_adapter(adapter));
1151 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
1152 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
1153 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
1155 fsf_req->data.abort_fcp_command.unit = unit;
1157 /* set handles of unit and its parent port in QTCB */
1158 fsf_req->qtcb->header.lun_handle = unit->handle;
1159 fsf_req->qtcb->header.port_handle = unit->port->handle;
1161 /* set handle of request which should be aborted */
1162 fsf_req->qtcb->bottom.support.req_handle = (u64) old_req_id;
1164 /* start QDIO request for this FSF request */
1166 zfcp_fsf_start_scsi_er_timer(adapter);
1167 retval = zfcp_fsf_req_send(fsf_req, NULL);
1169 del_timer(&adapter->scsi_er_timer);
1170 ZFCP_LOG_INFO("error: Failed to send abort command request "
1171 "on adapter %s, port 0x%016Lx, unit 0x%016Lx\n",
1172 zfcp_get_busid_by_adapter(adapter),
1173 unit->port->wwpn, unit->fcp_lun);
1174 zfcp_fsf_req_free(fsf_req);
1179 ZFCP_LOG_DEBUG("Abort FCP Command request initiated "
1180 "(adapter%s, port d_id=0x%08x, "
1181 "unit x%016Lx, old_req_id=0x%lx)\n",
1182 zfcp_get_busid_by_adapter(adapter),
1184 unit->fcp_lun, old_req_id);
1186 write_unlock_irqrestore(&adapter->request_queue.queue_lock, lock_flags);
1191 * function: zfcp_fsf_abort_fcp_command_handler
1193 * purpose: is called for finished Abort FCP Command request
1198 zfcp_fsf_abort_fcp_command_handler(struct zfcp_fsf_req *new_fsf_req)
1200 int retval = -EINVAL;
1201 struct zfcp_unit *unit = new_fsf_req->data.abort_fcp_command.unit;
1202 unsigned char status_qual =
1203 new_fsf_req->qtcb->header.fsf_status_qual.word[0];
1205 del_timer(&new_fsf_req->adapter->scsi_er_timer);
1207 if (new_fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR) {
1208 /* do not set ZFCP_STATUS_FSFREQ_ABORTSUCCEEDED */
1209 goto skip_fsfstatus;
1212 /* evaluate FSF status in QTCB */
1213 switch (new_fsf_req->qtcb->header.fsf_status) {
1215 case FSF_PORT_HANDLE_NOT_VALID:
1216 if (status_qual >> 4 != status_qual % 0xf) {
1217 ZFCP_LOG_FLAGS(2, "FSF_PORT_HANDLE_NOT_VALID\n");
1218 debug_text_event(new_fsf_req->adapter->erp_dbf, 3,
1221 * In this case a command that was sent prior to a port
1222 * reopen was aborted (handles are different). This is
1226 ZFCP_LOG_FLAGS(1, "FSF_PORT_HANDLE_NOT_VALID\n");
1227 ZFCP_LOG_INFO("Temporary port identifier 0x%x for "
1228 "port 0x%016Lx on adapter %s invalid. "
1229 "This may happen occasionally.\n",
1232 zfcp_get_busid_by_unit(unit));
1233 ZFCP_LOG_INFO("status qualifier:\n");
1234 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_INFO,
1235 (char *) &new_fsf_req->qtcb->header.
1237 sizeof (union fsf_status_qual));
1238 /* Let's hope this sorts out the mess */
1239 debug_text_event(new_fsf_req->adapter->erp_dbf, 1,
1241 zfcp_erp_adapter_reopen(unit->port->adapter, 0);
1242 new_fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1246 case FSF_LUN_HANDLE_NOT_VALID:
1247 if (status_qual >> 4 != status_qual % 0xf) {
1249 ZFCP_LOG_FLAGS(0, "FSF_LUN_HANDLE_NOT_VALID\n");
1250 debug_text_event(new_fsf_req->adapter->erp_dbf, 3,
1253 * In this case a command that was sent prior to a unit
1254 * reopen was aborted (handles are different).
1258 ZFCP_LOG_FLAGS(1, "FSF_LUN_HANDLE_NOT_VALID\n");
1260 ("Warning: Temporary LUN identifier 0x%x of LUN "
1261 "0x%016Lx on port 0x%016Lx on adapter %s is "
1262 "invalid. This may happen in rare cases. "
1263 "Trying to re-establish link.\n",
1267 zfcp_get_busid_by_unit(unit));
1268 ZFCP_LOG_DEBUG("Status qualifier data:\n");
1269 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
1270 (char *) &new_fsf_req->qtcb->header.
1272 sizeof (union fsf_status_qual));
1273 /* Let's hope this sorts out the mess */
1274 debug_text_event(new_fsf_req->adapter->erp_dbf, 1,
1276 zfcp_erp_port_reopen(unit->port, 0);
1277 new_fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1281 case FSF_FCP_COMMAND_DOES_NOT_EXIST:
1282 ZFCP_LOG_FLAGS(2, "FSF_FCP_COMMAND_DOES_NOT_EXIST\n");
1284 debug_text_event(new_fsf_req->adapter->erp_dbf, 3,
1286 new_fsf_req->status |= ZFCP_STATUS_FSFREQ_ABORTNOTNEEDED;
1289 case FSF_PORT_BOXED:
1291 ZFCP_LOG_FLAGS(0, "FSF_PORT_BOXED\n");
1292 ZFCP_LOG_INFO("Remote port 0x%016Lx on adapter %s needs to "
1293 "be reopened\n", unit->port->wwpn,
1294 zfcp_get_busid_by_unit(unit));
1295 debug_text_event(new_fsf_req->adapter->erp_dbf, 2,
1297 zfcp_erp_port_reopen(unit->port, 0);
1298 new_fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR
1299 | ZFCP_STATUS_FSFREQ_RETRY;
1303 ZFCP_LOG_FLAGS(0, "FSF_LUN_BOXED\n");
1305 "unit 0x%016Lx on port 0x%016Lx on adapter %s needs "
1307 unit->fcp_lun, unit->port->wwpn,
1308 zfcp_get_busid_by_unit(unit));
1309 debug_text_event(new_fsf_req->adapter->erp_dbf, 1, "fsf_s_lboxed");
1310 zfcp_erp_unit_reopen(unit, 0);
1311 zfcp_cmd_dbf_event_fsf("unitbox", new_fsf_req,
1312 &new_fsf_req->qtcb->header.fsf_status_qual,
1313 sizeof(union fsf_status_qual));
1314 new_fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR
1315 | ZFCP_STATUS_FSFREQ_RETRY;
1318 case FSF_ADAPTER_STATUS_AVAILABLE:
1320 ZFCP_LOG_FLAGS(0, "FSF_ADAPTER_STATUS_AVAILABLE\n");
1321 switch (new_fsf_req->qtcb->header.fsf_status_qual.word[0]) {
1322 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
1324 "FSF_SQ_INVOKE_LINK_TEST_PROCEDURE\n");
1325 debug_text_event(new_fsf_req->adapter->erp_dbf, 1,
1327 /* reopening link to port */
1328 zfcp_erp_port_reopen(unit->port, 0);
1329 new_fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1331 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
1333 "FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED\n");
1334 /* SCSI stack will escalate */
1335 debug_text_event(new_fsf_req->adapter->erp_dbf, 1,
1337 new_fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1341 ("bug: Wrong status qualifier 0x%x arrived.\n",
1342 new_fsf_req->qtcb->header.fsf_status_qual.word[0]);
1343 debug_text_event(new_fsf_req->adapter->erp_dbf, 0,
1345 debug_exception(new_fsf_req->adapter->erp_dbf, 0,
1346 &new_fsf_req->qtcb->header.
1347 fsf_status_qual.word[0], sizeof (u32));
1354 ZFCP_LOG_FLAGS(0, "FSF_GOOD\n");
1356 new_fsf_req->status |= ZFCP_STATUS_FSFREQ_ABORTSUCCEEDED;
1360 ZFCP_LOG_NORMAL("bug: An unknown FSF Status was presented "
1361 "(debug info 0x%x)\n",
1362 new_fsf_req->qtcb->header.fsf_status);
1363 debug_text_event(new_fsf_req->adapter->erp_dbf, 0,
1365 debug_exception(new_fsf_req->adapter->erp_dbf, 0,
1366 &new_fsf_req->qtcb->header.fsf_status,
1375 * zfcp_use_one_sbal - checks whether req buffer and resp bother each fit into
1377 * Two scatter-gather lists are passed, one for the reqeust and one for the
1381 zfcp_use_one_sbal(struct scatterlist *req, int req_count,
1382 struct scatterlist *resp, int resp_count)
1384 return ((req_count == 1) &&
1385 (resp_count == 1) &&
1386 (((unsigned long) zfcp_sg_to_address(&req[0]) &
1388 ((unsigned long) (zfcp_sg_to_address(&req[0]) +
1389 req[0].length - 1) & PAGE_MASK)) &&
1390 (((unsigned long) zfcp_sg_to_address(&resp[0]) &
1392 ((unsigned long) (zfcp_sg_to_address(&resp[0]) +
1393 resp[0].length - 1) & PAGE_MASK)));
1397 * zfcp_fsf_send_ct - initiate a Generic Service request (FC-GS)
1398 * @ct: pointer to struct zfcp_send_ct which conatins all needed data for
1400 * @pool: pointer to memory pool, if non-null this pool is used to allocate
1401 * a struct zfcp_fsf_req
1402 * @erp_action: pointer to erp_action, if non-null the Generic Service request
1403 * is sent within error recovery
1406 zfcp_fsf_send_ct(struct zfcp_send_ct *ct, mempool_t *pool,
1407 struct zfcp_erp_action *erp_action)
1409 volatile struct qdio_buffer_element *sbale;
1410 struct zfcp_port *port;
1411 struct zfcp_adapter *adapter;
1412 struct zfcp_fsf_req *fsf_req;
1413 unsigned long lock_flags;
1418 adapter = port->adapter;
1420 ret = zfcp_fsf_req_create(adapter, FSF_QTCB_SEND_GENERIC,
1421 ZFCP_WAIT_FOR_SBAL | ZFCP_REQ_AUTO_CLEANUP,
1422 pool, &lock_flags, &fsf_req);
1424 ZFCP_LOG_INFO("error: Could not create CT request (FC-GS) for "
1426 zfcp_get_busid_by_adapter(adapter));
1430 if (erp_action != NULL) {
1431 erp_action->fsf_req = fsf_req;
1432 fsf_req->erp_action = erp_action;
1435 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
1436 if (zfcp_use_one_sbal(ct->req, ct->req_count,
1437 ct->resp, ct->resp_count)){
1438 /* both request buffer and response buffer
1439 fit into one sbale each */
1440 sbale[0].flags |= SBAL_FLAGS0_TYPE_WRITE_READ;
1441 sbale[2].addr = zfcp_sg_to_address(&ct->req[0]);
1442 sbale[2].length = ct->req[0].length;
1443 sbale[3].addr = zfcp_sg_to_address(&ct->resp[0]);
1444 sbale[3].length = ct->resp[0].length;
1445 sbale[3].flags |= SBAL_FLAGS_LAST_ENTRY;
1446 } else if (adapter->supported_features &
1447 FSF_FEATURE_ELS_CT_CHAINED_SBALS) {
1448 /* try to use chained SBALs */
1449 bytes = zfcp_qdio_sbals_from_sg(fsf_req,
1450 SBAL_FLAGS0_TYPE_WRITE_READ,
1451 ct->req, ct->req_count,
1452 ZFCP_MAX_SBALS_PER_CT_REQ);
1454 ZFCP_LOG_INFO("error: creation of CT request failed "
1456 zfcp_get_busid_by_adapter(adapter));
1464 fsf_req->qtcb->bottom.support.req_buf_length = bytes;
1465 fsf_req->sbale_curr = ZFCP_LAST_SBALE_PER_SBAL;
1466 bytes = zfcp_qdio_sbals_from_sg(fsf_req,
1467 SBAL_FLAGS0_TYPE_WRITE_READ,
1468 ct->resp, ct->resp_count,
1469 ZFCP_MAX_SBALS_PER_CT_REQ);
1471 ZFCP_LOG_INFO("error: creation of CT request failed "
1473 zfcp_get_busid_by_adapter(adapter));
1481 fsf_req->qtcb->bottom.support.resp_buf_length = bytes;
1483 /* reject send generic request */
1485 "error: microcode does not support chained SBALs,"
1486 "CT request too big (adapter %s)\n",
1487 zfcp_get_busid_by_adapter(adapter));
1492 /* settings in QTCB */
1493 fsf_req->qtcb->header.port_handle = port->handle;
1494 fsf_req->qtcb->bottom.support.service_class = adapter->fc_service_class;
1495 fsf_req->qtcb->bottom.support.timeout = ct->timeout;
1496 fsf_req->data.send_ct = ct;
1498 /* start QDIO request for this FSF request */
1499 ret = zfcp_fsf_req_send(fsf_req, ct->timer);
1501 ZFCP_LOG_DEBUG("error: initiation of CT request failed "
1502 "(adapter %s, port 0x%016Lx)\n",
1503 zfcp_get_busid_by_adapter(adapter), port->wwpn);
1507 ZFCP_LOG_DEBUG("CT request initiated (adapter %s, port 0x%016Lx)\n",
1508 zfcp_get_busid_by_adapter(adapter), port->wwpn);
1512 zfcp_fsf_req_free(fsf_req);
1513 if (erp_action != NULL) {
1514 erp_action->fsf_req = NULL;
1518 write_unlock_irqrestore(&adapter->request_queue.queue_lock,
1524 * zfcp_fsf_send_ct_handler - handler for Generic Service requests
1525 * @fsf_req: pointer to struct zfcp_fsf_req
1527 * Data specific for the Generic Service request is passed by
1528 * fsf_req->data.send_ct
1529 * Usually a specific handler for the request is called via
1530 * fsf_req->data.send_ct->handler at end of this function.
1533 zfcp_fsf_send_ct_handler(struct zfcp_fsf_req *fsf_req)
1535 struct zfcp_port *port;
1536 struct zfcp_adapter *adapter;
1537 struct zfcp_send_ct *send_ct;
1538 struct fsf_qtcb_header *header;
1539 struct fsf_qtcb_bottom_support *bottom;
1540 int retval = -EINVAL;
1541 u16 subtable, rule, counter;
1543 adapter = fsf_req->adapter;
1544 send_ct = fsf_req->data.send_ct;
1545 port = send_ct->port;
1546 header = &fsf_req->qtcb->header;
1547 bottom = &fsf_req->qtcb->bottom.support;
1549 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR)
1550 goto skip_fsfstatus;
1552 /* evaluate FSF status in QTCB */
1553 switch (header->fsf_status) {
1556 ZFCP_LOG_FLAGS(2,"FSF_GOOD\n");
1560 case FSF_SERVICE_CLASS_NOT_SUPPORTED:
1561 ZFCP_LOG_FLAGS(2, "FSF_SERVICE_CLASS_NOT_SUPPORTED\n");
1562 if (adapter->fc_service_class <= 3) {
1563 ZFCP_LOG_INFO("error: adapter %s does not support fc "
1565 zfcp_get_busid_by_port(port),
1566 adapter->fc_service_class);
1568 ZFCP_LOG_INFO("bug: The fibre channel class at the "
1569 "adapter %s is invalid. "
1570 "(debug info %d)\n",
1571 zfcp_get_busid_by_port(port),
1572 adapter->fc_service_class);
1574 /* stop operation for this adapter */
1575 debug_text_exception(adapter->erp_dbf, 0, "fsf_s_class_nsup");
1576 zfcp_erp_adapter_shutdown(adapter, 0);
1577 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1580 case FSF_ADAPTER_STATUS_AVAILABLE:
1581 ZFCP_LOG_FLAGS(2, "FSF_ADAPTER_STATUS_AVAILABLE\n");
1582 switch (header->fsf_status_qual.word[0]){
1583 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
1584 ZFCP_LOG_FLAGS(2,"FSF_SQ_INVOKE_LINK_TEST_PROCEDURE\n");
1585 /* reopening link to port */
1586 debug_text_event(adapter->erp_dbf, 1, "fsf_sq_ltest");
1587 zfcp_test_link(port);
1588 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1590 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
1591 ZFCP_LOG_FLAGS(2,"FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED\n");
1592 /* ERP strategy will escalate */
1593 debug_text_event(adapter->erp_dbf, 1, "fsf_sq_ulp");
1594 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1597 ZFCP_LOG_INFO("bug: Wrong status qualifier 0x%x "
1599 header->fsf_status_qual.word[0]);
1604 case FSF_ACCESS_DENIED:
1605 ZFCP_LOG_FLAGS(2, "FSF_ACCESS_DENIED\n");
1606 ZFCP_LOG_NORMAL("access denied, cannot send generic service "
1607 "command (adapter %s, port d_id=0x%08x)\n",
1608 zfcp_get_busid_by_port(port), port->d_id);
1609 for (counter = 0; counter < 2; counter++) {
1610 subtable = header->fsf_status_qual.halfword[counter * 2];
1611 rule = header->fsf_status_qual.halfword[counter * 2 + 1];
1613 case FSF_SQ_CFDC_SUBTABLE_OS:
1614 case FSF_SQ_CFDC_SUBTABLE_PORT_WWPN:
1615 case FSF_SQ_CFDC_SUBTABLE_PORT_DID:
1616 case FSF_SQ_CFDC_SUBTABLE_LUN:
1617 ZFCP_LOG_INFO("Access denied (%s rule %d)\n",
1618 zfcp_act_subtable_type[subtable], rule);
1622 debug_text_event(adapter->erp_dbf, 1, "fsf_s_access");
1623 zfcp_erp_port_access_denied(port);
1624 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1627 case FSF_GENERIC_COMMAND_REJECTED:
1628 ZFCP_LOG_FLAGS(2, "FSF_GENERIC_COMMAND_REJECTED\n");
1629 ZFCP_LOG_INFO("generic service command rejected "
1630 "(adapter %s, port d_id=0x%08x)\n",
1631 zfcp_get_busid_by_port(port), port->d_id);
1632 ZFCP_LOG_INFO("status qualifier:\n");
1633 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_INFO,
1634 (char *) &header->fsf_status_qual,
1635 sizeof (union fsf_status_qual));
1636 debug_text_event(adapter->erp_dbf, 1, "fsf_s_gcom_rej");
1637 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1640 case FSF_PORT_HANDLE_NOT_VALID:
1641 ZFCP_LOG_FLAGS(2, "FSF_PORT_HANDLE_NOT_VALID\n");
1642 ZFCP_LOG_DEBUG("Temporary port identifier 0x%x for port "
1643 "0x%016Lx on adapter %s invalid. This may "
1644 "happen occasionally.\n", port->handle,
1645 port->wwpn, zfcp_get_busid_by_port(port));
1646 ZFCP_LOG_INFO("status qualifier:\n");
1647 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_INFO,
1648 (char *) &header->fsf_status_qual,
1649 sizeof (union fsf_status_qual));
1650 debug_text_event(adapter->erp_dbf, 1, "fsf_s_phandle_nv");
1651 zfcp_erp_adapter_reopen(adapter, 0);
1652 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1655 case FSF_PORT_BOXED:
1656 ZFCP_LOG_FLAGS(2, "FSF_PORT_BOXED\n");
1657 ZFCP_LOG_INFO("port needs to be reopened "
1658 "(adapter %s, port d_id=0x%08x)\n",
1659 zfcp_get_busid_by_port(port), port->d_id);
1660 debug_text_event(adapter->erp_dbf, 2, "fsf_s_pboxed");
1661 zfcp_erp_port_reopen(port, 0);
1662 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR
1663 | ZFCP_STATUS_FSFREQ_RETRY;
1666 /* following states should never occure, all cases avoided
1667 in zfcp_fsf_send_ct - but who knows ... */
1668 case FSF_PAYLOAD_SIZE_MISMATCH:
1669 ZFCP_LOG_FLAGS(2, "FSF_PAYLOAD_SIZE_MISMATCH\n");
1670 ZFCP_LOG_INFO("payload size mismatch (adapter: %s, "
1671 "req_buf_length=%d, resp_buf_length=%d)\n",
1672 zfcp_get_busid_by_adapter(adapter),
1673 bottom->req_buf_length, bottom->resp_buf_length);
1674 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1676 case FSF_REQUEST_SIZE_TOO_LARGE:
1677 ZFCP_LOG_FLAGS(2, "FSF_REQUEST_SIZE_TOO_LARGE\n");
1678 ZFCP_LOG_INFO("request size too large (adapter: %s, "
1679 "req_buf_length=%d)\n",
1680 zfcp_get_busid_by_adapter(adapter),
1681 bottom->req_buf_length);
1682 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1684 case FSF_RESPONSE_SIZE_TOO_LARGE:
1685 ZFCP_LOG_FLAGS(2, "FSF_RESPONSE_SIZE_TOO_LARGE\n");
1686 ZFCP_LOG_INFO("response size too large (adapter: %s, "
1687 "resp_buf_length=%d)\n",
1688 zfcp_get_busid_by_adapter(adapter),
1689 bottom->resp_buf_length);
1690 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1692 case FSF_SBAL_MISMATCH:
1693 ZFCP_LOG_FLAGS(2, "FSF_SBAL_MISMATCH\n");
1694 ZFCP_LOG_INFO("SBAL mismatch (adapter: %s, req_buf_length=%d, "
1695 "resp_buf_length=%d)\n",
1696 zfcp_get_busid_by_adapter(adapter),
1697 bottom->req_buf_length, bottom->resp_buf_length);
1698 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1702 ZFCP_LOG_NORMAL("bug: An unknown FSF Status was presented "
1703 "(debug info 0x%x)\n", header->fsf_status);
1704 debug_text_event(adapter->erp_dbf, 0, "fsf_sq_inval:");
1705 debug_exception(adapter->erp_dbf, 0,
1706 &header->fsf_status_qual.word[0], sizeof (u32));
1711 send_ct->status = retval;
1713 if (send_ct->handler != NULL)
1714 send_ct->handler(send_ct->handler_data);
1720 * zfcp_fsf_send_els - initiate an ELS command (FC-FS)
1721 * @els: pointer to struct zfcp_send_els which contains all needed data for
1725 zfcp_fsf_send_els(struct zfcp_send_els *els)
1727 volatile struct qdio_buffer_element *sbale;
1728 struct zfcp_fsf_req *fsf_req;
1730 struct zfcp_adapter *adapter;
1731 unsigned long lock_flags;
1736 adapter = els->adapter;
1738 ret = zfcp_fsf_req_create(adapter, FSF_QTCB_SEND_ELS,
1739 ZFCP_REQ_AUTO_CLEANUP,
1740 NULL, &lock_flags, &fsf_req);
1742 ZFCP_LOG_INFO("error: creation of ELS request failed "
1743 "(adapter %s, port d_id: 0x%08x)\n",
1744 zfcp_get_busid_by_adapter(adapter), d_id);
1748 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
1749 if (zfcp_use_one_sbal(els->req, els->req_count,
1750 els->resp, els->resp_count)){
1751 /* both request buffer and response buffer
1752 fit into one sbale each */
1753 sbale[0].flags |= SBAL_FLAGS0_TYPE_WRITE_READ;
1754 sbale[2].addr = zfcp_sg_to_address(&els->req[0]);
1755 sbale[2].length = els->req[0].length;
1756 sbale[3].addr = zfcp_sg_to_address(&els->resp[0]);
1757 sbale[3].length = els->resp[0].length;
1758 sbale[3].flags |= SBAL_FLAGS_LAST_ENTRY;
1759 } else if (adapter->supported_features &
1760 FSF_FEATURE_ELS_CT_CHAINED_SBALS) {
1761 /* try to use chained SBALs */
1762 bytes = zfcp_qdio_sbals_from_sg(fsf_req,
1763 SBAL_FLAGS0_TYPE_WRITE_READ,
1764 els->req, els->req_count,
1765 ZFCP_MAX_SBALS_PER_ELS_REQ);
1767 ZFCP_LOG_INFO("error: creation of ELS request failed "
1768 "(adapter %s, port d_id: 0x%08x)\n",
1769 zfcp_get_busid_by_adapter(adapter), d_id);
1777 fsf_req->qtcb->bottom.support.req_buf_length = bytes;
1778 fsf_req->sbale_curr = ZFCP_LAST_SBALE_PER_SBAL;
1779 bytes = zfcp_qdio_sbals_from_sg(fsf_req,
1780 SBAL_FLAGS0_TYPE_WRITE_READ,
1781 els->resp, els->resp_count,
1782 ZFCP_MAX_SBALS_PER_ELS_REQ);
1784 ZFCP_LOG_INFO("error: creation of ELS request failed "
1785 "(adapter %s, port d_id: 0x%08x)\n",
1786 zfcp_get_busid_by_adapter(adapter), d_id);
1794 fsf_req->qtcb->bottom.support.resp_buf_length = bytes;
1796 /* reject request */
1797 ZFCP_LOG_INFO("error: microcode does not support chained SBALs"
1798 ", ELS request too big (adapter %s, "
1799 "port d_id: 0x%08x)\n",
1800 zfcp_get_busid_by_adapter(adapter), d_id);
1805 /* settings in QTCB */
1806 fsf_req->qtcb->bottom.support.d_id = d_id;
1807 fsf_req->qtcb->bottom.support.service_class = adapter->fc_service_class;
1808 fsf_req->qtcb->bottom.support.timeout = ZFCP_ELS_TIMEOUT;
1809 fsf_req->data.send_els = els;
1811 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
1813 /* start QDIO request for this FSF request */
1814 ret = zfcp_fsf_req_send(fsf_req, els->timer);
1816 ZFCP_LOG_DEBUG("error: initiation of ELS request failed "
1817 "(adapter %s, port d_id: 0x%08x)\n",
1818 zfcp_get_busid_by_adapter(adapter), d_id);
1822 ZFCP_LOG_DEBUG("ELS request initiated (adapter %s, port d_id: "
1823 "0x%08x)\n", zfcp_get_busid_by_adapter(adapter), d_id);
1827 zfcp_fsf_req_free(fsf_req);
1831 write_unlock_irqrestore(&adapter->request_queue.queue_lock,
1838 * zfcp_fsf_send_els_handler - handler for ELS commands
1839 * @fsf_req: pointer to struct zfcp_fsf_req
1841 * Data specific for the ELS command is passed by
1842 * fsf_req->data.send_els
1843 * Usually a specific handler for the command is called via
1844 * fsf_req->data.send_els->handler at end of this function.
1846 static int zfcp_fsf_send_els_handler(struct zfcp_fsf_req *fsf_req)
1848 struct zfcp_adapter *adapter;
1850 struct zfcp_port *port;
1851 struct fsf_qtcb_header *header;
1852 struct fsf_qtcb_bottom_support *bottom;
1853 struct zfcp_send_els *send_els;
1854 int retval = -EINVAL;
1855 u16 subtable, rule, counter;
1857 send_els = fsf_req->data.send_els;
1858 adapter = send_els->adapter;
1859 d_id = send_els->d_id;
1860 header = &fsf_req->qtcb->header;
1861 bottom = &fsf_req->qtcb->bottom.support;
1863 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR)
1864 goto skip_fsfstatus;
1866 switch (header->fsf_status) {
1869 ZFCP_LOG_FLAGS(2, "FSF_GOOD\n");
1873 case FSF_SERVICE_CLASS_NOT_SUPPORTED:
1874 ZFCP_LOG_FLAGS(2, "FSF_SERVICE_CLASS_NOT_SUPPORTED\n");
1875 if (adapter->fc_service_class <= 3) {
1876 ZFCP_LOG_INFO("error: adapter %s does "
1877 "not support fibrechannel class %d.\n",
1878 zfcp_get_busid_by_adapter(adapter),
1879 adapter->fc_service_class);
1881 ZFCP_LOG_INFO("bug: The fibrechannel class at "
1882 "adapter %s is invalid. "
1883 "(debug info %d)\n",
1884 zfcp_get_busid_by_adapter(adapter),
1885 adapter->fc_service_class);
1887 /* stop operation for this adapter */
1888 debug_text_exception(adapter->erp_dbf, 0, "fsf_s_class_nsup");
1889 zfcp_erp_adapter_shutdown(adapter, 0);
1890 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1893 case FSF_ADAPTER_STATUS_AVAILABLE:
1894 ZFCP_LOG_FLAGS(2, "FSF_ADAPTER_STATUS_AVAILABLE\n");
1895 switch (header->fsf_status_qual.word[0]){
1896 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
1897 ZFCP_LOG_FLAGS(2,"FSF_SQ_INVOKE_LINK_TEST_PROCEDURE\n");
1898 debug_text_event(adapter->erp_dbf, 1, "fsf_sq_ltest");
1899 if (send_els->ls_code != ZFCP_LS_ADISC) {
1900 read_lock(&zfcp_data.config_lock);
1901 port = zfcp_get_port_by_did(adapter, d_id);
1903 zfcp_test_link(port);
1904 read_unlock(&zfcp_data.config_lock);
1906 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1908 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
1909 ZFCP_LOG_FLAGS(2,"FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED\n");
1910 debug_text_event(adapter->erp_dbf, 1, "fsf_sq_ulp");
1911 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1913 zfcp_handle_els_rjt(header->fsf_status_qual.word[1],
1914 (struct zfcp_ls_rjt_par *)
1915 &header->fsf_status_qual.word[2]);
1917 case FSF_SQ_RETRY_IF_POSSIBLE:
1918 ZFCP_LOG_FLAGS(2, "FSF_SQ_RETRY_IF_POSSIBLE\n");
1919 debug_text_event(adapter->erp_dbf, 1, "fsf_sq_retry");
1920 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1923 ZFCP_LOG_INFO("bug: Wrong status qualifier 0x%x\n",
1924 header->fsf_status_qual.word[0]);
1925 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_INFO,
1926 (char*)header->fsf_status_qual.word, 16);
1930 case FSF_ELS_COMMAND_REJECTED:
1931 ZFCP_LOG_FLAGS(2, "FSF_ELS_COMMAND_REJECTED\n");
1932 ZFCP_LOG_INFO("ELS has been rejected because command filter "
1933 "prohibited sending "
1934 "(adapter: %s, port d_id: 0x%08x)\n",
1935 zfcp_get_busid_by_adapter(adapter), d_id);
1939 case FSF_PAYLOAD_SIZE_MISMATCH:
1940 ZFCP_LOG_FLAGS(2, "FSF_PAYLOAD_SIZE_MISMATCH\n");
1942 "ELS request size and ELS response size must be either "
1943 "both 0, or both greater than 0 "
1944 "(adapter: %s, req_buf_length=%d resp_buf_length=%d)\n",
1945 zfcp_get_busid_by_adapter(adapter),
1946 bottom->req_buf_length,
1947 bottom->resp_buf_length);
1950 case FSF_REQUEST_SIZE_TOO_LARGE:
1951 ZFCP_LOG_FLAGS(2, "FSF_REQUEST_SIZE_TOO_LARGE\n");
1953 "Length of the ELS request buffer, "
1954 "specified in QTCB bottom, "
1955 "exceeds the size of the buffers "
1956 "that have been allocated for ELS request data "
1957 "(adapter: %s, req_buf_length=%d)\n",
1958 zfcp_get_busid_by_adapter(adapter),
1959 bottom->req_buf_length);
1962 case FSF_RESPONSE_SIZE_TOO_LARGE:
1963 ZFCP_LOG_FLAGS(2, "FSF_RESPONSE_SIZE_TOO_LARGE\n");
1965 "Length of the ELS response buffer, "
1966 "specified in QTCB bottom, "
1967 "exceeds the size of the buffers "
1968 "that have been allocated for ELS response data "
1969 "(adapter: %s, resp_buf_length=%d)\n",
1970 zfcp_get_busid_by_adapter(adapter),
1971 bottom->resp_buf_length);
1974 case FSF_SBAL_MISMATCH:
1975 /* should never occure, avoided in zfcp_fsf_send_els */
1976 ZFCP_LOG_FLAGS(2, "FSF_SBAL_MISMATCH\n");
1977 ZFCP_LOG_INFO("SBAL mismatch (adapter: %s, req_buf_length=%d, "
1978 "resp_buf_length=%d)\n",
1979 zfcp_get_busid_by_adapter(adapter),
1980 bottom->req_buf_length, bottom->resp_buf_length);
1981 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1984 case FSF_ACCESS_DENIED:
1985 ZFCP_LOG_FLAGS(2, "FSF_ACCESS_DENIED\n");
1986 ZFCP_LOG_NORMAL("access denied, cannot send ELS command "
1987 "(adapter %s, port d_id=0x%08x)\n",
1988 zfcp_get_busid_by_adapter(adapter), d_id);
1989 for (counter = 0; counter < 2; counter++) {
1990 subtable = header->fsf_status_qual.halfword[counter * 2];
1991 rule = header->fsf_status_qual.halfword[counter * 2 + 1];
1993 case FSF_SQ_CFDC_SUBTABLE_OS:
1994 case FSF_SQ_CFDC_SUBTABLE_PORT_WWPN:
1995 case FSF_SQ_CFDC_SUBTABLE_PORT_DID:
1996 case FSF_SQ_CFDC_SUBTABLE_LUN:
1997 ZFCP_LOG_INFO("Access denied (%s rule %d)\n",
1998 zfcp_act_subtable_type[subtable], rule);
2002 debug_text_event(adapter->erp_dbf, 1, "fsf_s_access");
2003 read_lock(&zfcp_data.config_lock);
2004 port = zfcp_get_port_by_did(adapter, d_id);
2006 zfcp_erp_port_access_denied(port);
2007 read_unlock(&zfcp_data.config_lock);
2008 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2013 "bug: An unknown FSF Status was presented "
2014 "(adapter: %s, fsf_status=0x%08x)\n",
2015 zfcp_get_busid_by_adapter(adapter),
2016 header->fsf_status);
2017 debug_text_event(adapter->erp_dbf, 0, "fsf_sq_inval");
2018 debug_exception(adapter->erp_dbf, 0,
2019 &header->fsf_status_qual.word[0], sizeof(u32));
2020 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2025 send_els->status = retval;
2027 if (send_els->handler != 0)
2028 send_els->handler(send_els->handler_data);
2038 * returns: address of initiated FSF request
2039 * NULL - request could not be initiated
2042 zfcp_fsf_exchange_config_data(struct zfcp_erp_action *erp_action)
2044 volatile struct qdio_buffer_element *sbale;
2045 unsigned long lock_flags;
2048 /* setup new FSF request */
2049 retval = zfcp_fsf_req_create(erp_action->adapter,
2050 FSF_QTCB_EXCHANGE_CONFIG_DATA,
2051 ZFCP_REQ_AUTO_CLEANUP,
2052 erp_action->adapter->pool.fsf_req_erp,
2053 &lock_flags, &(erp_action->fsf_req));
2055 ZFCP_LOG_INFO("error: Could not create exchange configuration "
2056 "data request for adapter %s.\n",
2057 zfcp_get_busid_by_adapter(erp_action->adapter));
2061 sbale = zfcp_qdio_sbale_req(erp_action->fsf_req,
2062 erp_action->fsf_req->sbal_curr, 0);
2063 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
2064 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
2066 erp_action->fsf_req->erp_action = erp_action;
2067 erp_action->fsf_req->qtcb->bottom.config.feature_selection =
2068 (FSF_FEATURE_CFDC | FSF_FEATURE_LUN_SHARING);
2070 /* start QDIO request for this FSF request */
2071 retval = zfcp_fsf_req_send(erp_action->fsf_req, &erp_action->timer);
2074 ("error: Could not send exchange configuration data "
2075 "command on the adapter %s\n",
2076 zfcp_get_busid_by_adapter(erp_action->adapter));
2077 zfcp_fsf_req_free(erp_action->fsf_req);
2078 erp_action->fsf_req = NULL;
2082 ZFCP_LOG_DEBUG("exchange configuration data request initiated "
2084 zfcp_get_busid_by_adapter(erp_action->adapter));
2087 write_unlock_irqrestore(&erp_action->adapter->request_queue.queue_lock,
2093 * zfcp_fsf_exchange_config_evaluate
2094 * @fsf_req: fsf_req which belongs to xchg config data request
2095 * @xchg_ok: specifies if xchg config data was incomplete or complete (0/1)
2097 * returns: -EIO on error, 0 otherwise
2100 zfcp_fsf_exchange_config_evaluate(struct zfcp_fsf_req *fsf_req, int xchg_ok)
2102 struct fsf_qtcb_bottom_config *bottom;
2103 struct zfcp_adapter *adapter = fsf_req->adapter;
2105 bottom = &fsf_req->qtcb->bottom.config;
2106 ZFCP_LOG_DEBUG("low/high QTCB version 0x%x/0x%x of FSF\n",
2107 bottom->low_qtcb_version, bottom->high_qtcb_version);
2108 adapter->fsf_lic_version = bottom->lic_version;
2109 adapter->supported_features = bottom->supported_features;
2112 adapter->wwnn = bottom->nport_serv_param.wwnn;
2113 adapter->wwpn = bottom->nport_serv_param.wwpn;
2114 adapter->s_id = bottom->s_id & ZFCP_DID_MASK;
2115 adapter->fc_topology = bottom->fc_topology;
2116 adapter->fc_link_speed = bottom->fc_link_speed;
2117 adapter->hydra_version = bottom->adapter_type;
2122 adapter->fc_topology = 0;
2123 adapter->fc_link_speed = 0;
2124 adapter->hydra_version = 0;
2127 if(adapter->supported_features & FSF_FEATURE_HBAAPI_MANAGEMENT){
2128 adapter->hardware_version = bottom->hardware_version;
2129 memcpy(adapter->serial_number, bottom->serial_number, 17);
2130 EBCASC(adapter->serial_number, sizeof(adapter->serial_number));
2133 ZFCP_LOG_INFO("The adapter %s reported the following characteristics:\n"
2137 "adapter version 0x%x, "
2138 "LIC version 0x%x, "
2139 "FC link speed %d Gb/s\n",
2140 zfcp_get_busid_by_adapter(adapter),
2143 (unsigned int) adapter->s_id,
2144 adapter->hydra_version,
2145 adapter->fsf_lic_version,
2146 adapter->fc_link_speed);
2147 if (ZFCP_QTCB_VERSION < bottom->low_qtcb_version) {
2148 ZFCP_LOG_NORMAL("error: the adapter %s "
2149 "only supports newer control block "
2150 "versions in comparison to this device "
2151 "driver (try updated device driver)\n",
2152 zfcp_get_busid_by_adapter(adapter));
2153 debug_text_event(adapter->erp_dbf, 0, "low_qtcb_ver");
2154 zfcp_erp_adapter_shutdown(adapter, 0);
2157 if (ZFCP_QTCB_VERSION > bottom->high_qtcb_version) {
2158 ZFCP_LOG_NORMAL("error: the adapter %s "
2159 "only supports older control block "
2160 "versions than this device driver uses"
2161 "(consider a microcode upgrade)\n",
2162 zfcp_get_busid_by_adapter(adapter));
2163 debug_text_event(adapter->erp_dbf, 0, "high_qtcb_ver");
2164 zfcp_erp_adapter_shutdown(adapter, 0);
2171 * function: zfcp_fsf_exchange_config_data_handler
2173 * purpose: is called for finished Exchange Configuration Data command
2178 zfcp_fsf_exchange_config_data_handler(struct zfcp_fsf_req *fsf_req)
2180 struct fsf_qtcb_bottom_config *bottom;
2181 struct zfcp_adapter *adapter = fsf_req->adapter;
2183 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR)
2186 switch (fsf_req->qtcb->header.fsf_status) {
2189 ZFCP_LOG_FLAGS(2, "FSF_GOOD\n");
2191 if (zfcp_fsf_exchange_config_evaluate(fsf_req, 1))
2194 switch (adapter->fc_topology) {
2196 ZFCP_LOG_FLAGS(1, "FSF_TOPO_P2P\n");
2197 ZFCP_LOG_NORMAL("error: Point-to-point fibrechannel "
2198 "configuration detected at adapter %s "
2199 "unsupported, shutting down adapter\n",
2200 zfcp_get_busid_by_adapter(adapter));
2201 debug_text_event(fsf_req->adapter->erp_dbf, 0,
2203 zfcp_erp_adapter_shutdown(adapter, 0);
2206 ZFCP_LOG_FLAGS(1, "FSF_TOPO_AL\n");
2207 ZFCP_LOG_NORMAL("error: Arbitrated loop fibrechannel "
2208 "topology detected at adapter %s "
2209 "unsupported, shutting down adapter\n",
2210 zfcp_get_busid_by_adapter(adapter));
2211 debug_text_event(fsf_req->adapter->erp_dbf, 0,
2213 zfcp_erp_adapter_shutdown(adapter, 0);
2215 case FSF_TOPO_FABRIC:
2216 ZFCP_LOG_FLAGS(1, "FSF_TOPO_FABRIC\n");
2217 ZFCP_LOG_INFO("Switched fabric fibrechannel "
2218 "network detected at adapter %s.\n",
2219 zfcp_get_busid_by_adapter(adapter));
2222 ZFCP_LOG_NORMAL("bug: The fibrechannel topology "
2223 "reported by the exchange "
2224 "configuration command for "
2225 "the adapter %s is not "
2226 "of a type known to the zfcp "
2227 "driver, shutting down adapter\n",
2228 zfcp_get_busid_by_adapter(adapter));
2229 debug_text_exception(fsf_req->adapter->erp_dbf, 0,
2231 zfcp_erp_adapter_shutdown(adapter, 0);
2234 bottom = &fsf_req->qtcb->bottom.config;
2235 if (bottom->max_qtcb_size < sizeof(struct fsf_qtcb)) {
2236 ZFCP_LOG_NORMAL("bug: Maximum QTCB size (%d bytes) "
2237 "allowed by the adapter %s "
2238 "is lower than the minimum "
2239 "required by the driver (%ld bytes).\n",
2240 bottom->max_qtcb_size,
2241 zfcp_get_busid_by_adapter(adapter),
2242 sizeof(struct fsf_qtcb));
2243 debug_text_event(fsf_req->adapter->erp_dbf, 0,
2245 debug_event(fsf_req->adapter->erp_dbf, 0,
2246 &bottom->max_qtcb_size, sizeof (u32));
2247 zfcp_erp_adapter_shutdown(adapter, 0);
2250 atomic_set_mask(ZFCP_STATUS_ADAPTER_XCONFIG_OK,
2253 case FSF_EXCHANGE_CONFIG_DATA_INCOMPLETE:
2254 debug_text_event(adapter->erp_dbf, 0, "xchg-inco");
2256 if (zfcp_fsf_exchange_config_evaluate(fsf_req, 0))
2259 ZFCP_LOG_INFO("Local link to adapter %s is down\n",
2260 zfcp_get_busid_by_adapter(adapter));
2261 atomic_set_mask(ZFCP_STATUS_ADAPTER_XCONFIG_OK |
2262 ZFCP_STATUS_ADAPTER_LINK_UNPLUGGED,
2264 zfcp_erp_adapter_failed(adapter);
2267 debug_text_event(fsf_req->adapter->erp_dbf, 0, "fsf-stat-ng");
2268 debug_event(fsf_req->adapter->erp_dbf, 0,
2269 &fsf_req->qtcb->header.fsf_status, sizeof (u32));
2270 zfcp_erp_adapter_shutdown(adapter, 0);
2277 * zfcp_fsf_exchange_port_data - request information about local port
2278 * @adapter: for which port data is requested
2279 * @data: response to exchange port data request
2282 zfcp_fsf_exchange_port_data(struct zfcp_adapter *adapter,
2283 struct fsf_qtcb_bottom_port *data)
2285 volatile struct qdio_buffer_element *sbale;
2287 unsigned long lock_flags;
2288 struct zfcp_fsf_req *fsf_req;
2289 struct timer_list *timer;
2291 if(!(adapter->supported_features & FSF_FEATURE_HBAAPI_MANAGEMENT)){
2292 ZFCP_LOG_INFO("error: exchange port data "
2293 "command not supported by adapter %s\n",
2294 zfcp_get_busid_by_adapter(adapter));
2298 timer = kmalloc(sizeof(struct timer_list), GFP_KERNEL);
2302 /* setup new FSF request */
2303 retval = zfcp_fsf_req_create(adapter, FSF_QTCB_EXCHANGE_PORT_DATA,
2304 0, 0, &lock_flags, &fsf_req);
2306 ZFCP_LOG_INFO("error: Out of resources. Could not create an "
2307 "exchange port data request for"
2308 "the adapter %s.\n",
2309 zfcp_get_busid_by_adapter(adapter));
2310 write_unlock_irqrestore(&adapter->request_queue.queue_lock,
2315 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
2316 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
2317 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
2319 fsf_req->data.port_data = data;
2322 timer->function = zfcp_fsf_request_timeout_handler;
2323 timer->data = (unsigned long) adapter;
2324 timer->expires = ZFCP_FSF_REQUEST_TIMEOUT;
2326 retval = zfcp_fsf_req_send(fsf_req, timer);
2328 ZFCP_LOG_INFO("error: Could not send an exchange port data "
2329 "command on the adapter %s\n",
2330 zfcp_get_busid_by_adapter(adapter));
2331 zfcp_fsf_req_free(fsf_req);
2332 write_unlock_irqrestore(&adapter->request_queue.queue_lock,
2337 ZFCP_LOG_DEBUG("Exchange Port Data request initiated (adapter %s)\n",
2338 zfcp_get_busid_by_adapter(adapter));
2340 write_unlock_irqrestore(&adapter->request_queue.queue_lock,
2343 wait_event(fsf_req->completion_wq,
2344 fsf_req->status & ZFCP_STATUS_FSFREQ_COMPLETED);
2345 del_timer_sync(timer);
2346 zfcp_fsf_req_cleanup(fsf_req);
2354 * zfcp_fsf_exchange_port_data_handler - handler for exchange_port_data request
2355 * @fsf_req: pointer to struct zfcp_fsf_req
2358 zfcp_fsf_exchange_port_data_handler(struct zfcp_fsf_req *fsf_req)
2360 struct fsf_qtcb_bottom_port *bottom;
2361 struct fsf_qtcb_bottom_port *data = fsf_req->data.port_data;
2363 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR)
2366 switch (fsf_req->qtcb->header.fsf_status) {
2368 ZFCP_LOG_FLAGS(2,"FSF_GOOD\n");
2369 bottom = &fsf_req->qtcb->bottom.port;
2370 memcpy(data, bottom, sizeof(*data));
2374 debug_text_event(fsf_req->adapter->erp_dbf, 0, "xchg-port-ng");
2375 debug_event(fsf_req->adapter->erp_dbf, 0,
2376 &fsf_req->qtcb->header.fsf_status, sizeof(u32));
2382 * function: zfcp_fsf_open_port
2386 * returns: address of initiated FSF request
2387 * NULL - request could not be initiated
2390 zfcp_fsf_open_port(struct zfcp_erp_action *erp_action)
2392 volatile struct qdio_buffer_element *sbale;
2393 unsigned long lock_flags;
2396 /* setup new FSF request */
2397 retval = zfcp_fsf_req_create(erp_action->adapter,
2398 FSF_QTCB_OPEN_PORT_WITH_DID,
2399 ZFCP_WAIT_FOR_SBAL | ZFCP_REQ_AUTO_CLEANUP,
2400 erp_action->adapter->pool.fsf_req_erp,
2401 &lock_flags, &(erp_action->fsf_req));
2403 ZFCP_LOG_INFO("error: Could not create open port request "
2404 "for port 0x%016Lx on adapter %s.\n",
2405 erp_action->port->wwpn,
2406 zfcp_get_busid_by_adapter(erp_action->adapter));
2410 sbale = zfcp_qdio_sbale_req(erp_action->fsf_req,
2411 erp_action->fsf_req->sbal_curr, 0);
2412 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
2413 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
2415 erp_action->fsf_req->qtcb->bottom.support.d_id = erp_action->port->d_id;
2416 atomic_set_mask(ZFCP_STATUS_COMMON_OPENING, &erp_action->port->status);
2417 erp_action->fsf_req->data.open_port.port = erp_action->port;
2418 erp_action->fsf_req->erp_action = erp_action;
2420 /* start QDIO request for this FSF request */
2421 retval = zfcp_fsf_req_send(erp_action->fsf_req, &erp_action->timer);
2423 ZFCP_LOG_INFO("error: Could not send open port request for "
2424 "port 0x%016Lx on adapter %s.\n",
2425 erp_action->port->wwpn,
2426 zfcp_get_busid_by_adapter(erp_action->adapter));
2427 zfcp_fsf_req_free(erp_action->fsf_req);
2428 erp_action->fsf_req = NULL;
2432 ZFCP_LOG_DEBUG("open port request initiated "
2433 "(adapter %s, port 0x%016Lx)\n",
2434 zfcp_get_busid_by_adapter(erp_action->adapter),
2435 erp_action->port->wwpn);
2437 write_unlock_irqrestore(&erp_action->adapter->request_queue.queue_lock,
2443 * function: zfcp_fsf_open_port_handler
2445 * purpose: is called for finished Open Port command
2450 zfcp_fsf_open_port_handler(struct zfcp_fsf_req *fsf_req)
2452 int retval = -EINVAL;
2453 struct zfcp_port *port;
2454 struct fsf_plogi *plogi;
2455 struct fsf_qtcb_header *header;
2456 u16 subtable, rule, counter;
2458 port = fsf_req->data.open_port.port;
2459 header = &fsf_req->qtcb->header;
2461 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR) {
2462 /* don't change port status in our bookkeeping */
2463 goto skip_fsfstatus;
2466 /* evaluate FSF status in QTCB */
2467 switch (header->fsf_status) {
2469 case FSF_PORT_ALREADY_OPEN:
2470 ZFCP_LOG_FLAGS(0, "FSF_PORT_ALREADY_OPEN\n");
2471 ZFCP_LOG_NORMAL("bug: remote port 0x%016Lx on adapter %s "
2472 "is already open.\n",
2473 port->wwpn, zfcp_get_busid_by_port(port));
2474 debug_text_exception(fsf_req->adapter->erp_dbf, 0,
2477 * This is a bug, however operation should continue normally
2478 * if it is simply ignored
2482 case FSF_ACCESS_DENIED:
2483 ZFCP_LOG_FLAGS(2, "FSF_ACCESS_DENIED\n");
2484 ZFCP_LOG_NORMAL("Access denied, cannot open port 0x%016Lx "
2486 port->wwpn, zfcp_get_busid_by_port(port));
2487 for (counter = 0; counter < 2; counter++) {
2488 subtable = header->fsf_status_qual.halfword[counter * 2];
2489 rule = header->fsf_status_qual.halfword[counter * 2 + 1];
2491 case FSF_SQ_CFDC_SUBTABLE_OS:
2492 case FSF_SQ_CFDC_SUBTABLE_PORT_WWPN:
2493 case FSF_SQ_CFDC_SUBTABLE_PORT_DID:
2494 case FSF_SQ_CFDC_SUBTABLE_LUN:
2495 ZFCP_LOG_INFO("Access denied (%s rule %d)\n",
2496 zfcp_act_subtable_type[subtable], rule);
2500 debug_text_event(fsf_req->adapter->erp_dbf, 1, "fsf_s_access");
2501 zfcp_erp_port_access_denied(port);
2502 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2505 case FSF_MAXIMUM_NUMBER_OF_PORTS_EXCEEDED:
2506 ZFCP_LOG_FLAGS(1, "FSF_MAXIMUM_NUMBER_OF_PORTS_EXCEEDED\n");
2507 ZFCP_LOG_INFO("error: The FSF adapter is out of resources. "
2508 "The remote port 0x%016Lx on adapter %s "
2509 "could not be opened. Disabling it.\n",
2510 port->wwpn, zfcp_get_busid_by_port(port));
2511 debug_text_event(fsf_req->adapter->erp_dbf, 1,
2513 zfcp_erp_port_failed(port);
2514 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2517 case FSF_ADAPTER_STATUS_AVAILABLE:
2518 ZFCP_LOG_FLAGS(2, "FSF_ADAPTER_STATUS_AVAILABLE\n");
2519 switch (header->fsf_status_qual.word[0]) {
2520 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
2522 "FSF_SQ_INVOKE_LINK_TEST_PROCEDURE\n");
2523 debug_text_event(fsf_req->adapter->erp_dbf, 1,
2525 /* ERP strategy will escalate */
2526 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2528 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
2529 /* ERP strategy will escalate */
2530 debug_text_event(fsf_req->adapter->erp_dbf, 1,
2532 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2534 case FSF_SQ_NO_RETRY_POSSIBLE:
2535 ZFCP_LOG_FLAGS(0, "FSF_SQ_NO_RETRY_POSSIBLE\n");
2536 ZFCP_LOG_NORMAL("The remote port 0x%016Lx on "
2537 "adapter %s could not be opened. "
2540 zfcp_get_busid_by_port(port));
2541 debug_text_exception(fsf_req->adapter->erp_dbf, 0,
2543 zfcp_erp_port_failed(port);
2544 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2548 ("bug: Wrong status qualifier 0x%x arrived.\n",
2549 header->fsf_status_qual.word[0]);
2550 debug_text_event(fsf_req->adapter->erp_dbf, 0,
2553 fsf_req->adapter->erp_dbf, 0,
2554 &header->fsf_status_qual.word[0],
2561 ZFCP_LOG_FLAGS(3, "FSF_GOOD\n");
2562 /* save port handle assigned by FSF */
2563 port->handle = header->port_handle;
2564 ZFCP_LOG_INFO("The remote port 0x%016Lx via adapter %s "
2565 "was opened, it's port handle is 0x%x\n",
2566 port->wwpn, zfcp_get_busid_by_port(port),
2568 /* mark port as open */
2569 atomic_set_mask(ZFCP_STATUS_COMMON_OPEN |
2570 ZFCP_STATUS_PORT_PHYS_OPEN, &port->status);
2572 /* check whether D_ID has changed during open */
2574 * FIXME: This check is not airtight, as the FCP channel does
2575 * not monitor closures of target port connections caused on
2576 * the remote side. Thus, they might miss out on invalidating
2577 * locally cached WWPNs (and other N_Port parameters) of gone
2578 * target ports. So, our heroic attempt to make things safe
2579 * could be undermined by 'open port' response data tagged with
2580 * obsolete WWPNs. Another reason to monitor potential
2581 * connection closures ourself at least (by interpreting
2582 * incoming ELS' and unsolicited status). It just crosses my
2583 * mind that one should be able to cross-check by means of
2584 * another GID_PN straight after a port has been opened.
2585 * Alternately, an ADISC/PDISC ELS should suffice, as well.
2587 plogi = (struct fsf_plogi *) fsf_req->qtcb->bottom.support.els;
2588 if (!atomic_test_mask(ZFCP_STATUS_PORT_NO_WWPN, &port->status))
2590 if (fsf_req->qtcb->bottom.support.els1_length <
2591 ((((unsigned long) &plogi->serv_param.wwpn) -
2592 ((unsigned long) plogi)) + sizeof (u64))) {
2594 "warning: insufficient length of "
2595 "PLOGI payload (%i)\n",
2596 fsf_req->qtcb->bottom.support.els1_length);
2597 debug_text_event(fsf_req->adapter->erp_dbf, 0,
2598 "fsf_s_short_plogi:");
2599 /* skip sanity check and assume wwpn is ok */
2601 if (plogi->serv_param.wwpn != port->wwpn) {
2602 ZFCP_LOG_INFO("warning: d_id of port "
2603 "0x%016Lx changed during "
2604 "open\n", port->wwpn);
2606 fsf_req->adapter->erp_dbf, 0,
2607 "fsf_s_did_change:");
2609 ZFCP_STATUS_PORT_DID_DID,
2612 port->wwnn = plogi->serv_param.wwnn;
2617 case FSF_UNKNOWN_OP_SUBTYPE:
2618 /* should never occure, subtype not set in zfcp_fsf_open_port */
2619 ZFCP_LOG_FLAGS(2, "FSF_UNKNOWN_OP_SUBTYPE\n");
2620 ZFCP_LOG_INFO("unknown operation subtype (adapter: %s, "
2621 "op_subtype=0x%x)\n",
2622 zfcp_get_busid_by_port(port),
2623 fsf_req->qtcb->bottom.support.operation_subtype);
2624 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2628 ZFCP_LOG_NORMAL("bug: An unknown FSF Status was presented "
2629 "(debug info 0x%x)\n",
2630 header->fsf_status);
2631 debug_text_event(fsf_req->adapter->erp_dbf, 0, "fsf_s_inval:");
2632 debug_exception(fsf_req->adapter->erp_dbf, 0,
2633 &header->fsf_status, sizeof (u32));
2638 atomic_clear_mask(ZFCP_STATUS_COMMON_OPENING, &port->status);
2643 * function: zfcp_fsf_close_port
2645 * purpose: submit FSF command "close port"
2647 * returns: address of initiated FSF request
2648 * NULL - request could not be initiated
2651 zfcp_fsf_close_port(struct zfcp_erp_action *erp_action)
2653 volatile struct qdio_buffer_element *sbale;
2654 unsigned long lock_flags;
2657 /* setup new FSF request */
2658 retval = zfcp_fsf_req_create(erp_action->adapter,
2659 FSF_QTCB_CLOSE_PORT,
2660 ZFCP_WAIT_FOR_SBAL | ZFCP_REQ_AUTO_CLEANUP,
2661 erp_action->adapter->pool.fsf_req_erp,
2662 &lock_flags, &(erp_action->fsf_req));
2664 ZFCP_LOG_INFO("error: Could not create a close port request "
2665 "for port 0x%016Lx on adapter %s.\n",
2666 erp_action->port->wwpn,
2667 zfcp_get_busid_by_adapter(erp_action->adapter));
2671 sbale = zfcp_qdio_sbale_req(erp_action->fsf_req,
2672 erp_action->fsf_req->sbal_curr, 0);
2673 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
2674 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
2676 atomic_set_mask(ZFCP_STATUS_COMMON_CLOSING, &erp_action->port->status);
2677 erp_action->fsf_req->data.close_port.port = erp_action->port;
2678 erp_action->fsf_req->erp_action = erp_action;
2679 erp_action->fsf_req->qtcb->header.port_handle =
2680 erp_action->port->handle;
2682 /* start QDIO request for this FSF request */
2683 retval = zfcp_fsf_req_send(erp_action->fsf_req, &erp_action->timer);
2685 ZFCP_LOG_INFO("error: Could not send a close port request for "
2686 "port 0x%016Lx on adapter %s.\n",
2687 erp_action->port->wwpn,
2688 zfcp_get_busid_by_adapter(erp_action->adapter));
2689 zfcp_fsf_req_free(erp_action->fsf_req);
2690 erp_action->fsf_req = NULL;
2694 ZFCP_LOG_TRACE("close port request initiated "
2695 "(adapter %s, port 0x%016Lx)\n",
2696 zfcp_get_busid_by_adapter(erp_action->adapter),
2697 erp_action->port->wwpn);
2699 write_unlock_irqrestore(&erp_action->adapter->request_queue.queue_lock,
2705 * function: zfcp_fsf_close_port_handler
2707 * purpose: is called for finished Close Port FSF command
2712 zfcp_fsf_close_port_handler(struct zfcp_fsf_req *fsf_req)
2714 int retval = -EINVAL;
2715 struct zfcp_port *port;
2717 port = fsf_req->data.close_port.port;
2719 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR) {
2720 /* don't change port status in our bookkeeping */
2721 goto skip_fsfstatus;
2724 /* evaluate FSF status in QTCB */
2725 switch (fsf_req->qtcb->header.fsf_status) {
2727 case FSF_PORT_HANDLE_NOT_VALID:
2728 ZFCP_LOG_FLAGS(1, "FSF_PORT_HANDLE_NOT_VALID\n");
2729 ZFCP_LOG_INFO("Temporary port identifier 0x%x for port "
2730 "0x%016Lx on adapter %s invalid. This may happen "
2731 "occasionally.\n", port->handle,
2732 port->wwpn, zfcp_get_busid_by_port(port));
2733 ZFCP_LOG_DEBUG("status qualifier:\n");
2734 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
2735 (char *) &fsf_req->qtcb->header.fsf_status_qual,
2736 sizeof (union fsf_status_qual));
2737 debug_text_event(fsf_req->adapter->erp_dbf, 1,
2739 zfcp_erp_adapter_reopen(port->adapter, 0);
2740 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2743 case FSF_ADAPTER_STATUS_AVAILABLE:
2744 ZFCP_LOG_FLAGS(2, "FSF_ADAPTER_STATUS_AVAILABLE\n");
2745 /* Note: FSF has actually closed the port in this case.
2746 * The status code is just daft. Fingers crossed for a change
2752 ZFCP_LOG_FLAGS(3, "FSF_GOOD\n");
2753 ZFCP_LOG_TRACE("remote port 0x016%Lx on adapter %s closed, "
2754 "port handle 0x%x\n", port->wwpn,
2755 zfcp_get_busid_by_port(port), port->handle);
2756 zfcp_erp_modify_port_status(port,
2757 ZFCP_STATUS_COMMON_OPEN,
2763 ZFCP_LOG_NORMAL("bug: An unknown FSF Status was presented "
2764 "(debug info 0x%x)\n",
2765 fsf_req->qtcb->header.fsf_status);
2766 debug_text_event(fsf_req->adapter->erp_dbf, 0, "fsf_s_inval:");
2767 debug_exception(fsf_req->adapter->erp_dbf, 0,
2768 &fsf_req->qtcb->header.fsf_status,
2774 atomic_clear_mask(ZFCP_STATUS_COMMON_CLOSING, &port->status);
2779 * function: zfcp_fsf_close_physical_port
2781 * purpose: submit FSF command "close physical port"
2783 * returns: address of initiated FSF request
2784 * NULL - request could not be initiated
2787 zfcp_fsf_close_physical_port(struct zfcp_erp_action *erp_action)
2790 unsigned long lock_flags;
2791 volatile struct qdio_buffer_element *sbale;
2793 /* setup new FSF request */
2794 retval = zfcp_fsf_req_create(erp_action->adapter,
2795 FSF_QTCB_CLOSE_PHYSICAL_PORT,
2796 ZFCP_WAIT_FOR_SBAL | ZFCP_REQ_AUTO_CLEANUP,
2797 erp_action->adapter->pool.fsf_req_erp,
2798 &lock_flags, &erp_action->fsf_req);
2800 ZFCP_LOG_INFO("error: Could not create close physical port "
2801 "request (adapter %s, port 0x%016Lx)\n",
2802 zfcp_get_busid_by_adapter(erp_action->adapter),
2803 erp_action->port->wwpn);
2808 sbale = zfcp_qdio_sbale_req(erp_action->fsf_req,
2809 erp_action->fsf_req->sbal_curr, 0);
2810 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
2811 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
2813 /* mark port as being closed */
2814 atomic_set_mask(ZFCP_STATUS_PORT_PHYS_CLOSING,
2815 &erp_action->port->status);
2816 /* save a pointer to this port */
2817 erp_action->fsf_req->data.close_physical_port.port = erp_action->port;
2818 /* port to be closeed */
2819 erp_action->fsf_req->qtcb->header.port_handle =
2820 erp_action->port->handle;
2821 erp_action->fsf_req->erp_action = erp_action;
2823 /* start QDIO request for this FSF request */
2824 retval = zfcp_fsf_req_send(erp_action->fsf_req, &erp_action->timer);
2826 ZFCP_LOG_INFO("error: Could not send close physical port "
2827 "request (adapter %s, port 0x%016Lx)\n",
2828 zfcp_get_busid_by_adapter(erp_action->adapter),
2829 erp_action->port->wwpn);
2830 zfcp_fsf_req_free(erp_action->fsf_req);
2831 erp_action->fsf_req = NULL;
2835 ZFCP_LOG_TRACE("close physical port request initiated "
2836 "(adapter %s, port 0x%016Lx)\n",
2837 zfcp_get_busid_by_adapter(erp_action->adapter),
2838 erp_action->port->wwpn);
2840 write_unlock_irqrestore(&erp_action->adapter->request_queue.queue_lock,
2846 * function: zfcp_fsf_close_physical_port_handler
2848 * purpose: is called for finished Close Physical Port FSF command
2853 zfcp_fsf_close_physical_port_handler(struct zfcp_fsf_req *fsf_req)
2855 int retval = -EINVAL;
2856 struct zfcp_port *port;
2857 struct zfcp_unit *unit;
2858 struct fsf_qtcb_header *header;
2859 u16 subtable, rule, counter;
2861 port = fsf_req->data.close_physical_port.port;
2862 header = &fsf_req->qtcb->header;
2864 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR) {
2865 /* don't change port status in our bookkeeping */
2866 goto skip_fsfstatus;
2869 /* evaluate FSF status in QTCB */
2870 switch (header->fsf_status) {
2872 case FSF_PORT_HANDLE_NOT_VALID:
2873 ZFCP_LOG_FLAGS(1, "FSF_PORT_HANDLE_NOT_VALID\n");
2874 ZFCP_LOG_INFO("Temporary port identifier 0x%x invalid"
2875 "(adapter %s, port 0x%016Lx). "
2876 "This may happen occasionally.\n",
2878 zfcp_get_busid_by_port(port),
2880 ZFCP_LOG_DEBUG("status qualifier:\n");
2881 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
2882 (char *) &header->fsf_status_qual,
2883 sizeof (union fsf_status_qual));
2884 debug_text_event(fsf_req->adapter->erp_dbf, 1,
2886 zfcp_erp_adapter_reopen(port->adapter, 0);
2887 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2890 case FSF_ACCESS_DENIED:
2891 ZFCP_LOG_FLAGS(2, "FSF_ACCESS_DENIED\n");
2892 ZFCP_LOG_NORMAL("Access denied, cannot close "
2893 "physical port 0x%016Lx on adapter %s\n",
2894 port->wwpn, zfcp_get_busid_by_port(port));
2895 for (counter = 0; counter < 2; counter++) {
2896 subtable = header->fsf_status_qual.halfword[counter * 2];
2897 rule = header->fsf_status_qual.halfword[counter * 2 + 1];
2899 case FSF_SQ_CFDC_SUBTABLE_OS:
2900 case FSF_SQ_CFDC_SUBTABLE_PORT_WWPN:
2901 case FSF_SQ_CFDC_SUBTABLE_PORT_DID:
2902 case FSF_SQ_CFDC_SUBTABLE_LUN:
2903 ZFCP_LOG_INFO("Access denied (%s rule %d)\n",
2904 zfcp_act_subtable_type[subtable], rule);
2908 debug_text_event(fsf_req->adapter->erp_dbf, 1, "fsf_s_access");
2909 zfcp_erp_port_access_denied(port);
2910 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2913 case FSF_PORT_BOXED:
2914 ZFCP_LOG_FLAGS(2, "FSF_PORT_BOXED\n");
2915 ZFCP_LOG_DEBUG("The remote port 0x%016Lx on adapter "
2916 "%s needs to be reopened but it was attempted "
2917 "to close it physically.\n",
2919 zfcp_get_busid_by_port(port));
2920 debug_text_event(fsf_req->adapter->erp_dbf, 1, "fsf_s_pboxed");
2921 zfcp_erp_port_reopen(port, 0);
2922 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR |
2923 ZFCP_STATUS_FSFREQ_RETRY;
2926 case FSF_ADAPTER_STATUS_AVAILABLE:
2927 ZFCP_LOG_FLAGS(2, "FSF_ADAPTER_STATUS_AVAILABLE\n");
2928 switch (header->fsf_status_qual.word[0]) {
2929 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
2931 "FSF_SQ_INVOKE_LINK_TEST_PROCEDURE\n");
2932 debug_text_event(fsf_req->adapter->erp_dbf, 1,
2934 /* This will now be escalated by ERP */
2935 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2937 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
2939 "FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED\n");
2940 /* ERP strategy will escalate */
2941 debug_text_event(fsf_req->adapter->erp_dbf, 1,
2943 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2947 ("bug: Wrong status qualifier 0x%x arrived.\n",
2948 header->fsf_status_qual.word[0]);
2949 debug_text_event(fsf_req->adapter->erp_dbf, 0,
2952 fsf_req->adapter->erp_dbf, 0,
2953 &header->fsf_status_qual.word[0], sizeof (u32));
2959 ZFCP_LOG_FLAGS(3, "FSF_GOOD\n");
2960 ZFCP_LOG_DEBUG("Remote port 0x%016Lx via adapter %s "
2961 "physically closed, port handle 0x%x\n",
2963 zfcp_get_busid_by_port(port), port->handle);
2964 /* can't use generic zfcp_erp_modify_port_status because
2965 * ZFCP_STATUS_COMMON_OPEN must not be reset for the port
2967 atomic_clear_mask(ZFCP_STATUS_PORT_PHYS_OPEN, &port->status);
2968 list_for_each_entry(unit, &port->unit_list_head, list)
2969 atomic_clear_mask(ZFCP_STATUS_COMMON_OPEN, &unit->status);
2974 ZFCP_LOG_NORMAL("bug: An unknown FSF Status was presented "
2975 "(debug info 0x%x)\n",
2976 header->fsf_status);
2977 debug_text_event(fsf_req->adapter->erp_dbf, 0, "fsf_s_inval:");
2978 debug_exception(fsf_req->adapter->erp_dbf, 0,
2979 &header->fsf_status, sizeof (u32));
2984 atomic_clear_mask(ZFCP_STATUS_PORT_PHYS_CLOSING, &port->status);
2989 * function: zfcp_fsf_open_unit
2995 * assumptions: This routine does not check whether the associated
2996 * remote port has already been opened. This should be
2997 * done by calling routines. Otherwise some status
2998 * may be presented by FSF
3001 zfcp_fsf_open_unit(struct zfcp_erp_action *erp_action)
3003 volatile struct qdio_buffer_element *sbale;
3004 unsigned long lock_flags;
3007 /* setup new FSF request */
3008 retval = zfcp_fsf_req_create(erp_action->adapter,
3010 ZFCP_WAIT_FOR_SBAL | ZFCP_REQ_AUTO_CLEANUP,
3011 erp_action->adapter->pool.fsf_req_erp,
3012 &lock_flags, &(erp_action->fsf_req));
3014 ZFCP_LOG_INFO("error: Could not create open unit request for "
3015 "unit 0x%016Lx on port 0x%016Lx on adapter %s.\n",
3016 erp_action->unit->fcp_lun,
3017 erp_action->unit->port->wwpn,
3018 zfcp_get_busid_by_adapter(erp_action->adapter));
3022 sbale = zfcp_qdio_sbale_req(erp_action->fsf_req,
3023 erp_action->fsf_req->sbal_curr, 0);
3024 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
3025 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
3027 erp_action->fsf_req->qtcb->header.port_handle =
3028 erp_action->port->handle;
3029 erp_action->fsf_req->qtcb->bottom.support.fcp_lun =
3030 erp_action->unit->fcp_lun;
3031 erp_action->fsf_req->qtcb->bottom.support.option =
3032 FSF_OPEN_LUN_SUPPRESS_BOXING;
3033 atomic_set_mask(ZFCP_STATUS_COMMON_OPENING, &erp_action->unit->status);
3034 erp_action->fsf_req->data.open_unit.unit = erp_action->unit;
3035 erp_action->fsf_req->erp_action = erp_action;
3037 /* start QDIO request for this FSF request */
3038 retval = zfcp_fsf_req_send(erp_action->fsf_req, &erp_action->timer);
3040 ZFCP_LOG_INFO("error: Could not send an open unit request "
3041 "on the adapter %s, port 0x%016Lx for "
3043 zfcp_get_busid_by_adapter(erp_action->adapter),
3044 erp_action->port->wwpn,
3045 erp_action->unit->fcp_lun);
3046 zfcp_fsf_req_free(erp_action->fsf_req);
3047 erp_action->fsf_req = NULL;
3051 ZFCP_LOG_TRACE("Open LUN request initiated (adapter %s, "
3052 "port 0x%016Lx, unit 0x%016Lx)\n",
3053 zfcp_get_busid_by_adapter(erp_action->adapter),
3054 erp_action->port->wwpn, erp_action->unit->fcp_lun);
3056 write_unlock_irqrestore(&erp_action->adapter->request_queue.queue_lock,
3062 * function: zfcp_fsf_open_unit_handler
3064 * purpose: is called for finished Open LUN command
3069 zfcp_fsf_open_unit_handler(struct zfcp_fsf_req *fsf_req)
3071 int retval = -EINVAL;
3072 struct zfcp_adapter *adapter;
3073 struct zfcp_unit *unit;
3074 struct fsf_qtcb_header *header;
3075 struct fsf_qtcb_bottom_support *bottom;
3076 struct fsf_queue_designator *queue_designator;
3077 u16 subtable, rule, counter;
3078 u32 allowed, exclusive, readwrite;
3080 unit = fsf_req->data.open_unit.unit;
3082 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR) {
3083 /* don't change unit status in our bookkeeping */
3084 goto skip_fsfstatus;
3087 adapter = fsf_req->adapter;
3088 header = &fsf_req->qtcb->header;
3089 bottom = &fsf_req->qtcb->bottom.support;
3090 queue_designator = &header->fsf_status_qual.fsf_queue_designator;
3092 allowed = bottom->lun_access_info & FSF_UNIT_ACCESS_OPEN_LUN_ALLOWED;
3093 exclusive = bottom->lun_access_info & FSF_UNIT_ACCESS_EXCLUSIVE;
3094 readwrite = bottom->lun_access_info & FSF_UNIT_ACCESS_OUTBOUND_TRANSFER;
3096 atomic_clear_mask(ZFCP_STATUS_COMMON_ACCESS_DENIED |
3097 ZFCP_STATUS_UNIT_SHARED |
3098 ZFCP_STATUS_UNIT_READONLY,
3101 /* evaluate FSF status in QTCB */
3102 switch (header->fsf_status) {
3104 case FSF_PORT_HANDLE_NOT_VALID:
3105 ZFCP_LOG_FLAGS(1, "FSF_PORT_HANDLE_NOT_VALID\n");
3106 ZFCP_LOG_INFO("Temporary port identifier 0x%x "
3107 "for port 0x%016Lx on adapter %s invalid "
3108 "This may happen occasionally\n",
3110 unit->port->wwpn, zfcp_get_busid_by_unit(unit));
3111 ZFCP_LOG_DEBUG("status qualifier:\n");
3112 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
3113 (char *) &header->fsf_status_qual,
3114 sizeof (union fsf_status_qual));
3115 debug_text_event(adapter->erp_dbf, 1, "fsf_s_ph_nv");
3116 zfcp_erp_adapter_reopen(unit->port->adapter, 0);
3117 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3120 case FSF_LUN_ALREADY_OPEN:
3121 ZFCP_LOG_FLAGS(0, "FSF_LUN_ALREADY_OPEN\n");
3122 ZFCP_LOG_NORMAL("bug: Attempted to open unit 0x%016Lx on "
3123 "remote port 0x%016Lx on adapter %s twice.\n",
3125 unit->port->wwpn, zfcp_get_busid_by_unit(unit));
3126 debug_text_exception(adapter->erp_dbf, 0,
3128 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3131 case FSF_ACCESS_DENIED:
3132 ZFCP_LOG_FLAGS(2, "FSF_ACCESS_DENIED\n");
3133 ZFCP_LOG_NORMAL("Access denied, cannot open unit 0x%016Lx on "
3134 "remote port 0x%016Lx on adapter %s\n",
3135 unit->fcp_lun, unit->port->wwpn,
3136 zfcp_get_busid_by_unit(unit));
3137 for (counter = 0; counter < 2; counter++) {
3138 subtable = header->fsf_status_qual.halfword[counter * 2];
3139 rule = header->fsf_status_qual.halfword[counter * 2 + 1];
3141 case FSF_SQ_CFDC_SUBTABLE_OS:
3142 case FSF_SQ_CFDC_SUBTABLE_PORT_WWPN:
3143 case FSF_SQ_CFDC_SUBTABLE_PORT_DID:
3144 case FSF_SQ_CFDC_SUBTABLE_LUN:
3145 ZFCP_LOG_INFO("Access denied (%s rule %d)\n",
3146 zfcp_act_subtable_type[subtable], rule);
3150 debug_text_event(adapter->erp_dbf, 1, "fsf_s_access");
3151 zfcp_erp_unit_access_denied(unit);
3152 atomic_clear_mask(ZFCP_STATUS_UNIT_SHARED, &unit->status);
3153 atomic_clear_mask(ZFCP_STATUS_UNIT_READONLY, &unit->status);
3154 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3157 case FSF_PORT_BOXED:
3158 ZFCP_LOG_FLAGS(2, "FSF_PORT_BOXED\n");
3159 ZFCP_LOG_DEBUG("The remote port 0x%016Lx on adapter %s "
3160 "needs to be reopened\n",
3161 unit->port->wwpn, zfcp_get_busid_by_unit(unit));
3162 debug_text_event(adapter->erp_dbf, 2, "fsf_s_pboxed");
3163 zfcp_erp_port_reopen(unit->port, 0);
3164 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR |
3165 ZFCP_STATUS_FSFREQ_RETRY;
3168 case FSF_LUN_SHARING_VIOLATION:
3169 ZFCP_LOG_FLAGS(2, "FSF_LUN_SHARING_VIOLATION\n");
3170 if (header->fsf_status_qual.word[0] != 0) {
3171 ZFCP_LOG_NORMAL("FCP-LUN 0x%Lx at the remote port "
3173 "connected to the adapter %s "
3174 "is already in use in LPAR%d, CSS%d\n",
3177 zfcp_get_busid_by_unit(unit),
3178 queue_designator->hla,
3179 queue_designator->cssid);
3181 subtable = header->fsf_status_qual.halfword[4];
3182 rule = header->fsf_status_qual.halfword[5];
3184 case FSF_SQ_CFDC_SUBTABLE_OS:
3185 case FSF_SQ_CFDC_SUBTABLE_PORT_WWPN:
3186 case FSF_SQ_CFDC_SUBTABLE_PORT_DID:
3187 case FSF_SQ_CFDC_SUBTABLE_LUN:
3188 ZFCP_LOG_NORMAL("Access to FCP-LUN 0x%Lx at the "
3189 "remote port with WWPN 0x%Lx "
3190 "connected to the adapter %s "
3191 "is denied (%s rule %d)\n",
3194 zfcp_get_busid_by_unit(unit),
3195 zfcp_act_subtable_type[subtable],
3200 ZFCP_LOG_DEBUG("status qualifier:\n");
3201 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
3202 (char *) &header->fsf_status_qual,
3203 sizeof (union fsf_status_qual));
3204 debug_text_event(adapter->erp_dbf, 2,
3206 zfcp_erp_unit_failed(unit);
3207 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3210 case FSF_MAXIMUM_NUMBER_OF_LUNS_EXCEEDED:
3211 ZFCP_LOG_FLAGS(1, "FSF_MAXIMUM_NUMBER_OF_LUNS_EXCEEDED\n");
3212 ZFCP_LOG_INFO("error: The adapter ran out of resources. "
3213 "There is no handle (temporary port identifier) "
3214 "available for unit 0x%016Lx on port 0x%016Lx "
3218 zfcp_get_busid_by_unit(unit));
3219 debug_text_event(adapter->erp_dbf, 1,
3221 zfcp_erp_unit_failed(unit);
3222 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3225 case FSF_ADAPTER_STATUS_AVAILABLE:
3226 ZFCP_LOG_FLAGS(2, "FSF_ADAPTER_STATUS_AVAILABLE\n");
3227 switch (header->fsf_status_qual.word[0]) {
3228 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
3230 "FSF_SQ_INVOKE_LINK_TEST_PROCEDURE\n");
3231 /* Re-establish link to port */
3232 debug_text_event(adapter->erp_dbf, 1,
3234 zfcp_erp_port_reopen(unit->port, 0);
3235 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3237 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
3239 "FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED\n");
3240 /* ERP strategy will escalate */
3241 debug_text_event(adapter->erp_dbf, 1,
3243 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3247 ("bug: Wrong status qualifier 0x%x arrived.\n",
3248 header->fsf_status_qual.word[0]);
3249 debug_text_event(adapter->erp_dbf, 0,
3251 debug_exception(adapter->erp_dbf, 0,
3252 &header->fsf_status_qual.word[0],
3257 case FSF_INVALID_COMMAND_OPTION:
3258 ZFCP_LOG_FLAGS(2, "FSF_INVALID_COMMAND_OPTION\n");
3260 "Invalid option 0x%x has been specified "
3261 "in QTCB bottom sent to the adapter %s\n",
3263 zfcp_get_busid_by_adapter(adapter));
3264 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3269 ZFCP_LOG_FLAGS(3, "FSF_GOOD\n");
3270 /* save LUN handle assigned by FSF */
3271 unit->handle = header->lun_handle;
3272 ZFCP_LOG_TRACE("unit 0x%016Lx on remote port 0x%016Lx on "
3273 "adapter %s opened, port handle 0x%x\n",
3276 zfcp_get_busid_by_unit(unit),
3278 /* mark unit as open */
3279 atomic_set_mask(ZFCP_STATUS_COMMON_OPEN, &unit->status);
3281 if (adapter->supported_features & FSF_FEATURE_LUN_SHARING){
3283 atomic_set_mask(ZFCP_STATUS_UNIT_SHARED,
3287 atomic_set_mask(ZFCP_STATUS_UNIT_READONLY,
3289 ZFCP_LOG_NORMAL("read-only access for unit "
3290 "(adapter %s, wwpn=0x%016Lx, "
3291 "fcp_lun=0x%016Lx)\n",
3292 zfcp_get_busid_by_unit(unit),
3297 if (exclusive && !readwrite) {
3298 ZFCP_LOG_NORMAL("exclusive access of read-only "
3299 "unit not supported\n");
3300 zfcp_erp_unit_failed(unit);
3301 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3302 zfcp_erp_unit_shutdown(unit, 0);
3303 } else if (!exclusive && readwrite) {
3304 ZFCP_LOG_NORMAL("shared access of read-write "
3305 "unit not supported\n");
3306 zfcp_erp_unit_failed(unit);
3307 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3308 zfcp_erp_unit_shutdown(unit, 0);
3316 ZFCP_LOG_NORMAL("bug: An unknown FSF Status was presented "
3317 "(debug info 0x%x)\n",
3318 header->fsf_status);
3319 debug_text_event(adapter->erp_dbf, 0, "fsf_s_inval:");
3320 debug_exception(adapter->erp_dbf, 0,
3321 &header->fsf_status, sizeof (u32));
3326 atomic_clear_mask(ZFCP_STATUS_COMMON_OPENING, &unit->status);
3331 * function: zfcp_fsf_close_unit
3335 * returns: address of fsf_req - request successfully initiated
3338 * assumptions: This routine does not check whether the associated
3339 * remote port/lun has already been opened. This should be
3340 * done by calling routines. Otherwise some status
3341 * may be presented by FSF
3344 zfcp_fsf_close_unit(struct zfcp_erp_action *erp_action)
3346 volatile struct qdio_buffer_element *sbale;
3347 unsigned long lock_flags;
3350 /* setup new FSF request */
3351 retval = zfcp_fsf_req_create(erp_action->adapter,
3353 ZFCP_WAIT_FOR_SBAL | ZFCP_REQ_AUTO_CLEANUP,
3354 erp_action->adapter->pool.fsf_req_erp,
3355 &lock_flags, &(erp_action->fsf_req));
3357 ZFCP_LOG_INFO("error: Could not create close unit request for "
3358 "unit 0x%016Lx on port 0x%016Lx on adapter %s.\n",
3359 erp_action->unit->fcp_lun,
3360 erp_action->port->wwpn,
3361 zfcp_get_busid_by_adapter(erp_action->adapter));
3365 sbale = zfcp_qdio_sbale_req(erp_action->fsf_req,
3366 erp_action->fsf_req->sbal_curr, 0);
3367 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
3368 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
3370 erp_action->fsf_req->qtcb->header.port_handle =
3371 erp_action->port->handle;
3372 erp_action->fsf_req->qtcb->header.lun_handle = erp_action->unit->handle;
3373 atomic_set_mask(ZFCP_STATUS_COMMON_CLOSING, &erp_action->unit->status);
3374 erp_action->fsf_req->data.close_unit.unit = erp_action->unit;
3375 erp_action->fsf_req->erp_action = erp_action;
3377 /* start QDIO request for this FSF request */
3378 retval = zfcp_fsf_req_send(erp_action->fsf_req, &erp_action->timer);
3380 ZFCP_LOG_INFO("error: Could not send a close unit request for "
3381 "unit 0x%016Lx on port 0x%016Lx onadapter %s.\n",
3382 erp_action->unit->fcp_lun,
3383 erp_action->port->wwpn,
3384 zfcp_get_busid_by_adapter(erp_action->adapter));
3385 zfcp_fsf_req_free(erp_action->fsf_req);
3386 erp_action->fsf_req = NULL;
3390 ZFCP_LOG_TRACE("Close LUN request initiated (adapter %s, "
3391 "port 0x%016Lx, unit 0x%016Lx)\n",
3392 zfcp_get_busid_by_adapter(erp_action->adapter),
3393 erp_action->port->wwpn, erp_action->unit->fcp_lun);
3395 write_unlock_irqrestore(&erp_action->adapter->request_queue.queue_lock,
3401 * function: zfcp_fsf_close_unit_handler
3403 * purpose: is called for finished Close LUN FSF command
3408 zfcp_fsf_close_unit_handler(struct zfcp_fsf_req *fsf_req)
3410 int retval = -EINVAL;
3411 struct zfcp_unit *unit;
3413 unit = fsf_req->data.close_unit.unit; /* restore unit */
3415 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR) {
3416 /* don't change unit status in our bookkeeping */
3417 goto skip_fsfstatus;
3420 /* evaluate FSF status in QTCB */
3421 switch (fsf_req->qtcb->header.fsf_status) {
3423 case FSF_PORT_HANDLE_NOT_VALID:
3424 ZFCP_LOG_FLAGS(1, "FSF_PORT_HANDLE_NOT_VALID\n");
3425 ZFCP_LOG_INFO("Temporary port identifier 0x%x for port "
3426 "0x%016Lx on adapter %s invalid. This may "
3427 "happen in rare circumstances\n",
3430 zfcp_get_busid_by_unit(unit));
3431 ZFCP_LOG_DEBUG("status qualifier:\n");
3432 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
3433 (char *) &fsf_req->qtcb->header.fsf_status_qual,
3434 sizeof (union fsf_status_qual));
3435 debug_text_event(fsf_req->adapter->erp_dbf, 1,
3437 zfcp_erp_adapter_reopen(unit->port->adapter, 0);
3438 zfcp_cmd_dbf_event_fsf("porthinv", fsf_req,
3439 &fsf_req->qtcb->header.fsf_status_qual,
3440 sizeof (union fsf_status_qual));
3441 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3444 case FSF_LUN_HANDLE_NOT_VALID:
3445 ZFCP_LOG_FLAGS(1, "FSF_LUN_HANDLE_NOT_VALID\n");
3446 ZFCP_LOG_INFO("Temporary LUN identifier 0x%x of unit "
3447 "0x%016Lx on port 0x%016Lx on adapter %s is "
3448 "invalid. This may happen occasionally.\n",
3452 zfcp_get_busid_by_unit(unit));
3453 ZFCP_LOG_DEBUG("Status qualifier data:\n");
3454 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
3455 (char *) &fsf_req->qtcb->header.fsf_status_qual,
3456 sizeof (union fsf_status_qual));
3457 debug_text_event(fsf_req->adapter->erp_dbf, 1,
3459 zfcp_erp_port_reopen(unit->port, 0);
3460 zfcp_cmd_dbf_event_fsf("lunhinv", fsf_req,
3461 &fsf_req->qtcb->header.fsf_status_qual,
3462 sizeof (union fsf_status_qual));
3463 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3466 case FSF_PORT_BOXED:
3467 ZFCP_LOG_FLAGS(2, "FSF_PORT_BOXED\n");
3468 ZFCP_LOG_DEBUG("The remote port 0x%016Lx on adapter %s "
3469 "needs to be reopened\n",
3471 zfcp_get_busid_by_unit(unit));
3472 debug_text_event(fsf_req->adapter->erp_dbf, 2, "fsf_s_pboxed");
3473 zfcp_erp_port_reopen(unit->port, 0);
3474 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR |
3475 ZFCP_STATUS_FSFREQ_RETRY;
3478 case FSF_ADAPTER_STATUS_AVAILABLE:
3479 ZFCP_LOG_FLAGS(2, "FSF_ADAPTER_STATUS_AVAILABLE\n");
3480 switch (fsf_req->qtcb->header.fsf_status_qual.word[0]) {
3481 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
3483 "FSF_SQ_INVOKE_LINK_TEST_PROCEDURE\n");
3484 /* re-establish link to port */
3485 debug_text_event(fsf_req->adapter->erp_dbf, 1,
3487 zfcp_erp_port_reopen(unit->port, 0);
3488 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3490 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
3492 "FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED\n");
3493 /* ERP strategy will escalate */
3494 debug_text_event(fsf_req->adapter->erp_dbf, 1,
3496 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3500 ("bug: Wrong status qualifier 0x%x arrived.\n",
3501 fsf_req->qtcb->header.fsf_status_qual.word[0]);
3502 debug_text_event(fsf_req->adapter->erp_dbf, 0,
3505 fsf_req->adapter->erp_dbf, 0,
3506 &fsf_req->qtcb->header.fsf_status_qual.word[0],
3513 ZFCP_LOG_FLAGS(3, "FSF_GOOD\n");
3514 ZFCP_LOG_TRACE("unit 0x%016Lx on port 0x%016Lx on adapter %s "
3515 "closed, port handle 0x%x\n",
3518 zfcp_get_busid_by_unit(unit),
3520 /* mark unit as closed */
3521 atomic_clear_mask(ZFCP_STATUS_COMMON_OPEN, &unit->status);
3526 ZFCP_LOG_NORMAL("bug: An unknown FSF Status was presented "
3527 "(debug info 0x%x)\n",
3528 fsf_req->qtcb->header.fsf_status);
3529 debug_text_event(fsf_req->adapter->erp_dbf, 0, "fsf_s_inval:");
3530 debug_exception(fsf_req->adapter->erp_dbf, 0,
3531 &fsf_req->qtcb->header.fsf_status,
3537 atomic_clear_mask(ZFCP_STATUS_COMMON_CLOSING, &unit->status);
3542 * zfcp_fsf_send_fcp_command_task - initiate an FCP command (for a SCSI command)
3543 * @adapter: adapter where scsi command is issued
3544 * @unit: unit where command is sent to
3545 * @scsi_cmnd: scsi command to be sent
3546 * @timer: timer to be started when request is initiated
3547 * @req_flags: flags for fsf_request
3550 zfcp_fsf_send_fcp_command_task(struct zfcp_adapter *adapter,
3551 struct zfcp_unit *unit,
3552 struct scsi_cmnd * scsi_cmnd,
3553 struct timer_list *timer, int req_flags)
3555 struct zfcp_fsf_req *fsf_req = NULL;
3556 struct fcp_cmnd_iu *fcp_cmnd_iu;
3557 unsigned int sbtype;
3558 unsigned long lock_flags;
3563 /* setup new FSF request */
3564 retval = zfcp_fsf_req_create(adapter, FSF_QTCB_FCP_CMND, req_flags,
3565 adapter->pool.fsf_req_scsi,
3566 &lock_flags, &fsf_req);
3567 if (unlikely(retval < 0)) {
3568 ZFCP_LOG_DEBUG("error: Could not create FCP command request "
3569 "for unit 0x%016Lx on port 0x%016Lx on "
3573 zfcp_get_busid_by_adapter(adapter));
3574 goto failed_req_create;
3578 * associate FSF request with SCSI request
3579 * (need this for look up on abort)
3581 fsf_req->data.send_fcp_command_task.fsf_req = fsf_req;
3582 scsi_cmnd->host_scribble = (char *) &(fsf_req->data);
3585 * associate SCSI command with FSF request
3586 * (need this for look up on normal command completion)
3588 fsf_req->data.send_fcp_command_task.scsi_cmnd = scsi_cmnd;
3589 fsf_req->data.send_fcp_command_task.start_jiffies = jiffies;
3590 fsf_req->data.send_fcp_command_task.unit = unit;
3591 ZFCP_LOG_DEBUG("unit=%p, fcp_lun=0x%016Lx\n", unit, unit->fcp_lun);
3593 /* set handles of unit and its parent port in QTCB */
3594 fsf_req->qtcb->header.lun_handle = unit->handle;
3595 fsf_req->qtcb->header.port_handle = unit->port->handle;
3597 /* FSF does not define the structure of the FCP_CMND IU */
3598 fcp_cmnd_iu = (struct fcp_cmnd_iu *)
3599 &(fsf_req->qtcb->bottom.io.fcp_cmnd);
3602 * set depending on data direction:
3603 * data direction bits in SBALE (SB Type)
3604 * data direction bits in QTCB
3605 * data direction bits in FCP_CMND IU
3607 switch (scsi_cmnd->sc_data_direction) {
3609 ZFCP_LOG_FLAGS(3, "DMA_NONE\n");
3610 fsf_req->qtcb->bottom.io.data_direction = FSF_DATADIR_CMND;
3613 * what is the correct type for commands
3614 * without 'real' data buffers?
3616 sbtype = SBAL_FLAGS0_TYPE_READ;
3618 case DMA_FROM_DEVICE:
3619 ZFCP_LOG_FLAGS(3, "DMA_FROM_DEVICE\n");
3620 fsf_req->qtcb->bottom.io.data_direction = FSF_DATADIR_READ;
3621 sbtype = SBAL_FLAGS0_TYPE_READ;
3622 fcp_cmnd_iu->rddata = 1;
3625 ZFCP_LOG_FLAGS(3, "DMA_TO_DEVICE\n");
3626 fsf_req->qtcb->bottom.io.data_direction = FSF_DATADIR_WRITE;
3627 sbtype = SBAL_FLAGS0_TYPE_WRITE;
3628 fcp_cmnd_iu->wddata = 1;
3630 case DMA_BIDIRECTIONAL:
3631 ZFCP_LOG_FLAGS(0, "DMA_BIDIRECTIONAL not supported\n");
3634 * dummy, catch this condition earlier
3635 * in zfcp_scsi_queuecommand
3637 goto failed_scsi_cmnd;
3640 /* set FC service class in QTCB (3 per default) */
3641 fsf_req->qtcb->bottom.io.service_class = adapter->fc_service_class;
3643 /* set FCP_LUN in FCP_CMND IU in QTCB */
3644 fcp_cmnd_iu->fcp_lun = unit->fcp_lun;
3646 mask = ZFCP_STATUS_UNIT_READONLY | ZFCP_STATUS_UNIT_SHARED;
3648 /* set task attributes in FCP_CMND IU in QTCB */
3649 if (likely((scsi_cmnd->device->simple_tags) ||
3650 (atomic_test_mask(mask, &unit->status))))
3651 fcp_cmnd_iu->task_attribute = SIMPLE_Q;
3653 fcp_cmnd_iu->task_attribute = UNTAGGED;
3655 /* set additional length of FCP_CDB in FCP_CMND IU in QTCB, if needed */
3656 if (unlikely(scsi_cmnd->cmd_len > FCP_CDB_LENGTH)) {
3657 fcp_cmnd_iu->add_fcp_cdb_length
3658 = (scsi_cmnd->cmd_len - FCP_CDB_LENGTH) >> 2;
3659 ZFCP_LOG_TRACE("SCSI CDB length is 0x%x, "
3660 "additional FCP_CDB length is 0x%x "
3661 "(shifted right 2 bits)\n",
3663 fcp_cmnd_iu->add_fcp_cdb_length);
3666 * copy SCSI CDB (including additional length, if any) to
3667 * FCP_CDB in FCP_CMND IU in QTCB
3669 memcpy(fcp_cmnd_iu->fcp_cdb, scsi_cmnd->cmnd, scsi_cmnd->cmd_len);
3671 /* FCP CMND IU length in QTCB */
3672 fsf_req->qtcb->bottom.io.fcp_cmnd_length =
3673 sizeof (struct fcp_cmnd_iu) +
3674 fcp_cmnd_iu->add_fcp_cdb_length + sizeof (fcp_dl_t);
3676 /* generate SBALEs from data buffer */
3677 real_bytes = zfcp_qdio_sbals_from_scsicmnd(fsf_req, sbtype, scsi_cmnd);
3678 if (unlikely(real_bytes < 0)) {
3679 if (fsf_req->sbal_number < ZFCP_MAX_SBALS_PER_REQ) {
3681 "Data did not fit into available buffer(s), "
3682 "waiting for more...\n");
3685 ZFCP_LOG_NORMAL("error: No truncation implemented but "
3686 "required. Shutting down unit "
3687 "(adapter %s, port 0x%016Lx, "
3689 zfcp_get_busid_by_unit(unit),
3692 zfcp_erp_unit_shutdown(unit, 0);
3698 /* set length of FCP data length in FCP_CMND IU in QTCB */
3699 zfcp_set_fcp_dl(fcp_cmnd_iu, real_bytes);
3701 ZFCP_LOG_DEBUG("Sending SCSI command:\n");
3702 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
3703 (char *) scsi_cmnd->cmnd, scsi_cmnd->cmd_len);
3706 * start QDIO request for this FSF request
3707 * covered by an SBALE)
3709 retval = zfcp_fsf_req_send(fsf_req, timer);
3710 if (unlikely(retval < 0)) {
3711 ZFCP_LOG_INFO("error: Could not send FCP command request "
3712 "on adapter %s, port 0x%016Lx, unit 0x%016Lx\n",
3713 zfcp_get_busid_by_adapter(adapter),
3719 ZFCP_LOG_TRACE("Send FCP Command initiated (adapter %s, "
3720 "port 0x%016Lx, unit 0x%016Lx)\n",
3721 zfcp_get_busid_by_adapter(adapter),
3729 zfcp_fsf_req_free(fsf_req);
3731 scsi_cmnd->host_scribble = NULL;
3734 write_unlock_irqrestore(&adapter->request_queue.queue_lock, lock_flags);
3739 * function: zfcp_fsf_send_fcp_command_task_management
3745 * FIXME(design): should be watched by a timeout!!!
3746 * FIXME(design) shouldn't this be modified to return an int
3747 * also...don't know how though
3750 struct zfcp_fsf_req *
3751 zfcp_fsf_send_fcp_command_task_management(struct zfcp_adapter *adapter,
3752 struct zfcp_unit *unit,
3753 u8 tm_flags, int req_flags)
3755 struct zfcp_fsf_req *fsf_req = NULL;
3757 struct fcp_cmnd_iu *fcp_cmnd_iu;
3758 unsigned long lock_flags;
3759 volatile struct qdio_buffer_element *sbale;
3761 /* setup new FSF request */
3762 retval = zfcp_fsf_req_create(adapter, FSF_QTCB_FCP_CMND, req_flags,
3763 adapter->pool.fsf_req_scsi,
3764 &lock_flags, &fsf_req);
3766 ZFCP_LOG_INFO("error: Could not create FCP command (task "
3767 "management) request for adapter %s, port "
3768 " 0x%016Lx, unit 0x%016Lx.\n",
3769 zfcp_get_busid_by_adapter(adapter),
3770 unit->port->wwpn, unit->fcp_lun);
3775 * Used to decide on proper handler in the return path,
3776 * could be either zfcp_fsf_send_fcp_command_task_handler or
3777 * zfcp_fsf_send_fcp_command_task_management_handler */
3779 fsf_req->status |= ZFCP_STATUS_FSFREQ_TASK_MANAGEMENT;
3782 * hold a pointer to the unit being target of this
3783 * task management request
3785 fsf_req->data.send_fcp_command_task_management.unit = unit;
3787 /* set FSF related fields in QTCB */
3788 fsf_req->qtcb->header.lun_handle = unit->handle;
3789 fsf_req->qtcb->header.port_handle = unit->port->handle;
3790 fsf_req->qtcb->bottom.io.data_direction = FSF_DATADIR_CMND;
3791 fsf_req->qtcb->bottom.io.service_class = adapter->fc_service_class;
3792 fsf_req->qtcb->bottom.io.fcp_cmnd_length =
3793 sizeof (struct fcp_cmnd_iu) + sizeof (fcp_dl_t);
3795 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
3796 sbale[0].flags |= SBAL_FLAGS0_TYPE_WRITE;
3797 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
3799 /* set FCP related fields in FCP_CMND IU in QTCB */
3800 fcp_cmnd_iu = (struct fcp_cmnd_iu *)
3801 &(fsf_req->qtcb->bottom.io.fcp_cmnd);
3802 fcp_cmnd_iu->fcp_lun = unit->fcp_lun;
3803 fcp_cmnd_iu->task_management_flags = tm_flags;
3805 /* start QDIO request for this FSF request */
3806 zfcp_fsf_start_scsi_er_timer(adapter);
3807 retval = zfcp_fsf_req_send(fsf_req, NULL);
3809 del_timer(&adapter->scsi_er_timer);
3810 ZFCP_LOG_INFO("error: Could not send an FCP-command (task "
3811 "management) on adapter %s, port 0x%016Lx for "
3812 "unit LUN 0x%016Lx\n",
3813 zfcp_get_busid_by_adapter(adapter),
3816 zfcp_fsf_req_free(fsf_req);
3821 ZFCP_LOG_TRACE("Send FCP Command (task management function) initiated "
3822 "(adapter %s, port 0x%016Lx, unit 0x%016Lx, "
3824 zfcp_get_busid_by_adapter(adapter),
3829 write_unlock_irqrestore(&adapter->request_queue.queue_lock, lock_flags);
3834 * function: zfcp_fsf_send_fcp_command_handler
3836 * purpose: is called for finished Send FCP Command
3841 zfcp_fsf_send_fcp_command_handler(struct zfcp_fsf_req *fsf_req)
3843 int retval = -EINVAL;
3844 struct zfcp_unit *unit;
3845 struct fsf_qtcb_header *header;
3846 u16 subtable, rule, counter;
3848 header = &fsf_req->qtcb->header;
3850 if (unlikely(fsf_req->status & ZFCP_STATUS_FSFREQ_TASK_MANAGEMENT))
3851 unit = fsf_req->data.send_fcp_command_task_management.unit;
3853 unit = fsf_req->data.send_fcp_command_task.unit;
3855 if (unlikely(fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR)) {
3856 /* go directly to calls of special handlers */
3857 goto skip_fsfstatus;
3860 /* evaluate FSF status in QTCB */
3861 switch (header->fsf_status) {
3863 case FSF_PORT_HANDLE_NOT_VALID:
3864 ZFCP_LOG_FLAGS(1, "FSF_PORT_HANDLE_NOT_VALID\n");
3865 ZFCP_LOG_INFO("Temporary port identifier 0x%x for port "
3866 "0x%016Lx on adapter %s invalid\n",
3868 unit->port->wwpn, zfcp_get_busid_by_unit(unit));
3869 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
3870 (char *) &header->fsf_status_qual,
3871 sizeof (union fsf_status_qual));
3872 debug_text_event(fsf_req->adapter->erp_dbf, 1,
3874 zfcp_erp_adapter_reopen(unit->port->adapter, 0);
3875 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3878 case FSF_LUN_HANDLE_NOT_VALID:
3879 ZFCP_LOG_FLAGS(1, "FSF_LUN_HANDLE_NOT_VALID\n");
3880 ZFCP_LOG_INFO("Temporary LUN identifier 0x%x for unit "
3881 "0x%016Lx on port 0x%016Lx on adapter %s is "
3882 "invalid. This may happen occasionally.\n",
3886 zfcp_get_busid_by_unit(unit));
3887 ZFCP_LOG_NORMAL("Status qualifier data:\n");
3888 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_NORMAL,
3889 (char *) &header->fsf_status_qual,
3890 sizeof (union fsf_status_qual));
3891 debug_text_event(fsf_req->adapter->erp_dbf, 1,
3893 zfcp_erp_port_reopen(unit->port, 0);
3894 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3897 case FSF_HANDLE_MISMATCH:
3898 ZFCP_LOG_FLAGS(0, "FSF_HANDLE_MISMATCH\n");
3899 ZFCP_LOG_NORMAL("bug: The port handle 0x%x has changed "
3900 "unexpectedly. (adapter %s, port 0x%016Lx, "
3903 zfcp_get_busid_by_unit(unit),
3906 ZFCP_LOG_NORMAL("status qualifier:\n");
3907 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_NORMAL,
3908 (char *) &header->fsf_status_qual,
3909 sizeof (union fsf_status_qual));
3910 debug_text_event(fsf_req->adapter->erp_dbf, 1,
3912 zfcp_erp_adapter_reopen(unit->port->adapter, 0);
3913 zfcp_cmd_dbf_event_fsf("handmism",
3915 &header->fsf_status_qual,
3916 sizeof (union fsf_status_qual));
3917 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3920 case FSF_SERVICE_CLASS_NOT_SUPPORTED:
3921 ZFCP_LOG_FLAGS(0, "FSF_SERVICE_CLASS_NOT_SUPPORTED\n");
3922 if (fsf_req->adapter->fc_service_class <= 3) {
3923 ZFCP_LOG_NORMAL("error: The adapter %s does "
3924 "not support fibrechannel class %d.\n",
3925 zfcp_get_busid_by_unit(unit),
3926 fsf_req->adapter->fc_service_class);
3928 ZFCP_LOG_NORMAL("bug: The fibrechannel class at "
3929 "adapter %s is invalid. "
3930 "(debug info %d)\n",
3931 zfcp_get_busid_by_unit(unit),
3932 fsf_req->adapter->fc_service_class);
3934 /* stop operation for this adapter */
3935 debug_text_exception(fsf_req->adapter->erp_dbf, 0,
3936 "fsf_s_class_nsup");
3937 zfcp_erp_adapter_shutdown(unit->port->adapter, 0);
3938 zfcp_cmd_dbf_event_fsf("unsclass",
3940 &header->fsf_status_qual,
3941 sizeof (union fsf_status_qual));
3942 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3945 case FSF_FCPLUN_NOT_VALID:
3946 ZFCP_LOG_FLAGS(0, "FSF_FCPLUN_NOT_VALID\n");
3947 ZFCP_LOG_NORMAL("bug: unit 0x%016Lx on port 0x%016Lx on "
3948 "adapter %s does not have correct unit "
3952 zfcp_get_busid_by_unit(unit),
3954 ZFCP_LOG_DEBUG("status qualifier:\n");
3955 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
3956 (char *) &header->fsf_status_qual,
3957 sizeof (union fsf_status_qual));
3958 debug_text_event(fsf_req->adapter->erp_dbf, 1,
3959 "fsf_s_fcp_lun_nv");
3960 zfcp_erp_port_reopen(unit->port, 0);
3961 zfcp_cmd_dbf_event_fsf("fluninv",
3963 &header->fsf_status_qual,
3964 sizeof (union fsf_status_qual));
3965 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3968 case FSF_ACCESS_DENIED:
3969 ZFCP_LOG_FLAGS(2, "FSF_ACCESS_DENIED\n");
3970 ZFCP_LOG_NORMAL("Access denied, cannot send FCP command to "
3971 "unit 0x%016Lx on port 0x%016Lx on "
3972 "adapter %s\n", unit->fcp_lun, unit->port->wwpn,
3973 zfcp_get_busid_by_unit(unit));
3974 for (counter = 0; counter < 2; counter++) {
3975 subtable = header->fsf_status_qual.halfword[counter * 2];
3976 rule = header->fsf_status_qual.halfword[counter * 2 + 1];
3978 case FSF_SQ_CFDC_SUBTABLE_OS:
3979 case FSF_SQ_CFDC_SUBTABLE_PORT_WWPN:
3980 case FSF_SQ_CFDC_SUBTABLE_PORT_DID:
3981 case FSF_SQ_CFDC_SUBTABLE_LUN:
3982 ZFCP_LOG_INFO("Access denied (%s rule %d)\n",
3983 zfcp_act_subtable_type[subtable], rule);
3987 debug_text_event(fsf_req->adapter->erp_dbf, 1, "fsf_s_access");
3988 zfcp_erp_unit_access_denied(unit);
3989 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3992 case FSF_DIRECTION_INDICATOR_NOT_VALID:
3993 ZFCP_LOG_FLAGS(0, "FSF_DIRECTION_INDICATOR_NOT_VALID\n");
3994 ZFCP_LOG_INFO("bug: Invalid data direction given for unit "
3995 "0x%016Lx on port 0x%016Lx on adapter %s "
3996 "(debug info %d)\n",
3999 zfcp_get_busid_by_unit(unit),
4000 fsf_req->qtcb->bottom.io.data_direction);
4001 /* stop operation for this adapter */
4002 debug_text_event(fsf_req->adapter->erp_dbf, 0,
4003 "fsf_s_dir_ind_nv");
4004 zfcp_erp_adapter_shutdown(unit->port->adapter, 0);
4005 zfcp_cmd_dbf_event_fsf("dirinv",
4007 &header->fsf_status_qual,
4008 sizeof (union fsf_status_qual));
4009 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4012 case FSF_CMND_LENGTH_NOT_VALID:
4013 ZFCP_LOG_FLAGS(0, "FSF_CMND_LENGTH_NOT_VALID\n");
4015 ("bug: An invalid control-data-block length field "
4016 "was found in a command for unit 0x%016Lx on port "
4017 "0x%016Lx on adapter %s " "(debug info %d)\n",
4018 unit->fcp_lun, unit->port->wwpn,
4019 zfcp_get_busid_by_unit(unit),
4020 fsf_req->qtcb->bottom.io.fcp_cmnd_length);
4021 /* stop operation for this adapter */
4022 debug_text_event(fsf_req->adapter->erp_dbf, 0,
4023 "fsf_s_cmd_len_nv");
4024 zfcp_erp_adapter_shutdown(unit->port->adapter, 0);
4025 zfcp_cmd_dbf_event_fsf("cleninv",
4027 &header->fsf_status_qual,
4028 sizeof (union fsf_status_qual));
4029 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4032 case FSF_PORT_BOXED:
4033 ZFCP_LOG_FLAGS(2, "FSF_PORT_BOXED\n");
4034 ZFCP_LOG_DEBUG("The remote port 0x%016Lx on adapter %s "
4035 "needs to be reopened\n",
4036 unit->port->wwpn, zfcp_get_busid_by_unit(unit));
4037 debug_text_event(fsf_req->adapter->erp_dbf, 2, "fsf_s_pboxed");
4038 zfcp_erp_port_reopen(unit->port, 0);
4039 zfcp_cmd_dbf_event_fsf("portbox", fsf_req,
4040 &header->fsf_status_qual,
4041 sizeof (union fsf_status_qual));
4042 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR |
4043 ZFCP_STATUS_FSFREQ_RETRY;
4047 ZFCP_LOG_FLAGS(0, "FSF_LUN_BOXED\n");
4048 ZFCP_LOG_NORMAL("unit needs to be reopened (adapter %s, "
4049 "wwpn=0x%016Lx, fcp_lun=0x%016Lx)\n",
4050 zfcp_get_busid_by_unit(unit),
4051 unit->port->wwpn, unit->fcp_lun);
4052 debug_text_event(fsf_req->adapter->erp_dbf, 1, "fsf_s_lboxed");
4053 zfcp_erp_unit_reopen(unit, 0);
4054 zfcp_cmd_dbf_event_fsf("unitbox", fsf_req,
4055 &header->fsf_status_qual,
4056 sizeof(union fsf_status_qual));
4057 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR
4058 | ZFCP_STATUS_FSFREQ_RETRY;
4061 case FSF_ADAPTER_STATUS_AVAILABLE:
4062 ZFCP_LOG_FLAGS(2, "FSF_ADAPTER_STATUS_AVAILABLE\n");
4063 switch (header->fsf_status_qual.word[0]) {
4064 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
4066 "FSF_SQ_INVOKE_LINK_TEST_PROCEDURE\n");
4067 /* re-establish link to port */
4068 debug_text_event(fsf_req->adapter->erp_dbf, 1,
4070 zfcp_erp_port_reopen(unit->port, 0);
4071 zfcp_cmd_dbf_event_fsf(
4074 &header->fsf_status_qual,
4075 sizeof (union fsf_status_qual));
4076 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4078 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
4080 "FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED\n");
4081 /* FIXME(hw) need proper specs for proper action */
4082 /* let scsi stack deal with retries and escalation */
4083 debug_text_event(fsf_req->adapter->erp_dbf, 1,
4085 zfcp_cmd_dbf_event_fsf(
4088 &header->fsf_status_qual,
4089 sizeof (union fsf_status_qual));
4090 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4093 /* FIXME: shall we consider this a successful transfer? */
4095 ("bug: Wrong status qualifier 0x%x arrived.\n",
4096 header->fsf_status_qual.word[0]);
4097 debug_text_event(fsf_req->adapter->erp_dbf, 0,
4099 debug_exception(fsf_req->adapter->erp_dbf, 0,
4100 &header->fsf_status_qual.word[0],
4107 ZFCP_LOG_FLAGS(3, "FSF_GOOD\n");
4110 case FSF_FCP_RSP_AVAILABLE:
4111 ZFCP_LOG_FLAGS(2, "FSF_FCP_RSP_AVAILABLE\n");
4115 debug_text_event(fsf_req->adapter->erp_dbf, 0, "fsf_s_inval:");
4116 debug_exception(fsf_req->adapter->erp_dbf, 0,
4117 &header->fsf_status, sizeof(u32));
4122 if (fsf_req->status & ZFCP_STATUS_FSFREQ_TASK_MANAGEMENT) {
4124 zfcp_fsf_send_fcp_command_task_management_handler(fsf_req);
4126 retval = zfcp_fsf_send_fcp_command_task_handler(fsf_req);
4132 * function: zfcp_fsf_send_fcp_command_task_handler
4134 * purpose: evaluates FCP_RSP IU
4139 zfcp_fsf_send_fcp_command_task_handler(struct zfcp_fsf_req *fsf_req)
4142 struct scsi_cmnd *scpnt;
4143 struct fcp_rsp_iu *fcp_rsp_iu = (struct fcp_rsp_iu *)
4144 &(fsf_req->qtcb->bottom.io.fcp_rsp);
4145 struct fcp_cmnd_iu *fcp_cmnd_iu = (struct fcp_cmnd_iu *)
4146 &(fsf_req->qtcb->bottom.io.fcp_cmnd);
4148 char *fcp_rsp_info = zfcp_get_fcp_rsp_info_ptr(fcp_rsp_iu);
4149 unsigned long flags;
4150 struct zfcp_unit *unit = fsf_req->data.send_fcp_command_task.unit;
4152 read_lock_irqsave(&fsf_req->adapter->abort_lock, flags);
4153 scpnt = fsf_req->data.send_fcp_command_task.scsi_cmnd;
4154 if (unlikely(!scpnt)) {
4156 ("Command with fsf_req %p is not associated to "
4157 "a scsi command anymore. Aborted?\n", fsf_req);
4160 if (unlikely(fsf_req->status & ZFCP_STATUS_FSFREQ_ABORTED)) {
4161 /* FIXME: (design) mid-layer should handle DID_ABORT like
4162 * DID_SOFT_ERROR by retrying the request for devices
4163 * that allow retries.
4165 ZFCP_LOG_DEBUG("Setting DID_SOFT_ERROR and SUGGEST_RETRY\n");
4166 set_host_byte(&scpnt->result, DID_SOFT_ERROR);
4167 set_driver_byte(&scpnt->result, SUGGEST_RETRY);
4168 goto skip_fsfstatus;
4171 if (unlikely(fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR)) {
4172 ZFCP_LOG_DEBUG("Setting DID_ERROR\n");
4173 set_host_byte(&scpnt->result, DID_ERROR);
4174 goto skip_fsfstatus;
4177 /* set message byte of result in SCSI command */
4178 scpnt->result |= COMMAND_COMPLETE << 8;
4181 * copy SCSI status code of FCP_STATUS of FCP_RSP IU to status byte
4182 * of result in SCSI command
4184 scpnt->result |= fcp_rsp_iu->scsi_status;
4185 if (unlikely(fcp_rsp_iu->scsi_status)) {
4187 ZFCP_LOG_DEBUG("status for SCSI Command:\n");
4188 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
4189 scpnt->cmnd, scpnt->cmd_len);
4190 ZFCP_LOG_DEBUG("SCSI status code 0x%x\n",
4191 fcp_rsp_iu->scsi_status);
4192 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
4193 (void *) fcp_rsp_iu, sizeof (struct fcp_rsp_iu));
4194 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
4195 zfcp_get_fcp_sns_info_ptr(fcp_rsp_iu),
4196 fcp_rsp_iu->fcp_sns_len);
4199 /* check FCP_RSP_INFO */
4200 if (unlikely(fcp_rsp_iu->validity.bits.fcp_rsp_len_valid)) {
4201 ZFCP_LOG_DEBUG("rsp_len is valid\n");
4202 switch (fcp_rsp_info[3]) {
4204 ZFCP_LOG_FLAGS(3, "RSP_CODE_GOOD\n");
4206 ZFCP_LOG_TRACE("no failure or Task Management "
4207 "Function complete\n");
4208 set_host_byte(&scpnt->result, DID_OK);
4210 case RSP_CODE_LENGTH_MISMATCH:
4211 ZFCP_LOG_FLAGS(0, "RSP_CODE_LENGTH_MISMATCH\n");
4213 ZFCP_LOG_NORMAL("bug: FCP response code indictates "
4214 "that the fibrechannel protocol data "
4215 "length differs from the burst length. "
4216 "The problem occured on unit 0x%016Lx "
4217 "on port 0x%016Lx on adapter %s",
4220 zfcp_get_busid_by_unit(unit));
4221 /* dump SCSI CDB as prepared by zfcp */
4222 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
4223 (char *) &fsf_req->qtcb->
4224 bottom.io.fcp_cmnd, FSF_FCP_CMND_SIZE);
4225 zfcp_cmd_dbf_event_fsf("clenmis", fsf_req, NULL, 0);
4226 set_host_byte(&scpnt->result, DID_ERROR);
4227 goto skip_fsfstatus;
4228 case RSP_CODE_FIELD_INVALID:
4229 ZFCP_LOG_FLAGS(0, "RSP_CODE_FIELD_INVALID\n");
4230 /* driver or hardware bug */
4231 ZFCP_LOG_NORMAL("bug: FCP response code indictates "
4232 "that the fibrechannel protocol data "
4233 "fields were incorrectly set up. "
4234 "The problem occured on the unit "
4235 "0x%016Lx on port 0x%016Lx on "
4239 zfcp_get_busid_by_unit(unit));
4240 /* dump SCSI CDB as prepared by zfcp */
4241 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
4242 (char *) &fsf_req->qtcb->
4243 bottom.io.fcp_cmnd, FSF_FCP_CMND_SIZE);
4244 set_host_byte(&scpnt->result, DID_ERROR);
4245 zfcp_cmd_dbf_event_fsf("codeinv", fsf_req, NULL, 0);
4246 goto skip_fsfstatus;
4247 case RSP_CODE_RO_MISMATCH:
4248 ZFCP_LOG_FLAGS(0, "RSP_CODE_RO_MISMATCH\n");
4250 ZFCP_LOG_NORMAL("bug: The FCP response code indicates "
4251 "that conflicting values for the "
4252 "fibrechannel payload offset from the "
4253 "header were found. "
4254 "The problem occured on unit 0x%016Lx "
4255 "on port 0x%016Lx on adapter %s.\n",
4258 zfcp_get_busid_by_unit(unit));
4259 /* dump SCSI CDB as prepared by zfcp */
4260 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
4261 (char *) &fsf_req->qtcb->
4262 bottom.io.fcp_cmnd, FSF_FCP_CMND_SIZE);
4263 zfcp_cmd_dbf_event_fsf("codemism", fsf_req, NULL, 0);
4264 set_host_byte(&scpnt->result, DID_ERROR);
4265 goto skip_fsfstatus;
4267 ZFCP_LOG_NORMAL("bug: An invalid FCP response "
4268 "code was detected for a command. "
4269 "The problem occured on the unit "
4270 "0x%016Lx on port 0x%016Lx on "
4271 "adapter %s (debug info 0x%x)\n",
4274 zfcp_get_busid_by_unit(unit),
4276 /* dump SCSI CDB as prepared by zfcp */
4277 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
4278 (char *) &fsf_req->qtcb->
4279 bottom.io.fcp_cmnd, FSF_FCP_CMND_SIZE);
4280 zfcp_cmd_dbf_event_fsf("undeffcp", fsf_req, NULL, 0);
4281 set_host_byte(&scpnt->result, DID_ERROR);
4285 /* check for sense data */
4286 if (unlikely(fcp_rsp_iu->validity.bits.fcp_sns_len_valid)) {
4287 sns_len = FSF_FCP_RSP_SIZE -
4288 sizeof (struct fcp_rsp_iu) + fcp_rsp_iu->fcp_rsp_len;
4289 ZFCP_LOG_TRACE("room for %i bytes sense data in QTCB\n",
4291 sns_len = min(sns_len, (u32) SCSI_SENSE_BUFFERSIZE);
4292 ZFCP_LOG_TRACE("room for %i bytes sense data in SCSI command\n",
4293 SCSI_SENSE_BUFFERSIZE);
4294 sns_len = min(sns_len, fcp_rsp_iu->fcp_sns_len);
4295 ZFCP_LOG_TRACE("scpnt->result =0x%x, command was:\n",
4297 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_TRACE,
4298 (void *) &scpnt->cmnd, scpnt->cmd_len);
4300 ZFCP_LOG_TRACE("%i bytes sense data provided by FCP\n",
4301 fcp_rsp_iu->fcp_sns_len);
4302 memcpy(&scpnt->sense_buffer,
4303 zfcp_get_fcp_sns_info_ptr(fcp_rsp_iu), sns_len);
4304 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_TRACE,
4305 (void *) &scpnt->sense_buffer, sns_len);
4308 /* check for overrun */
4309 if (unlikely(fcp_rsp_iu->validity.bits.fcp_resid_over)) {
4310 ZFCP_LOG_INFO("A data overrun was detected for a command. "
4311 "unit 0x%016Lx, port 0x%016Lx, adapter %s. "
4312 "The response data length is "
4313 "%d, the original length was %d.\n",
4316 zfcp_get_busid_by_unit(unit),
4317 fcp_rsp_iu->fcp_resid,
4318 (int) zfcp_get_fcp_dl(fcp_cmnd_iu));
4321 /* check for underrun */
4322 if (unlikely(fcp_rsp_iu->validity.bits.fcp_resid_under)) {
4323 ZFCP_LOG_DEBUG("A data underrun was detected for a command. "
4324 "unit 0x%016Lx, port 0x%016Lx, adapter %s. "
4325 "The response data length is "
4326 "%d, the original length was %d.\n",
4329 zfcp_get_busid_by_unit(unit),
4330 fcp_rsp_iu->fcp_resid,
4331 (int) zfcp_get_fcp_dl(fcp_cmnd_iu));
4333 * It may not have been possible to send all data and the
4334 * underrun on send may already be in scpnt->resid, so it's add
4335 * not equals in the below statement.
4337 scpnt->resid += fcp_rsp_iu->fcp_resid;
4338 ZFCP_LOG_TRACE("scpnt->resid=0x%x\n", scpnt->resid);
4342 ZFCP_LOG_DEBUG("scpnt->result =0x%x\n", scpnt->result);
4344 zfcp_cmd_dbf_event_scsi("response", scpnt);
4346 /* cleanup pointer (need this especially for abort) */
4347 scpnt->host_scribble = NULL;
4351 * according to the outcome of a discussion on linux-scsi we
4352 * don't need to grab the io_request_lock here since we use
4355 /* always call back */
4357 (scpnt->scsi_done) (scpnt);
4360 * We must hold this lock until scsi_done has been called.
4361 * Otherwise we may call scsi_done after abort regarding this
4362 * command has completed.
4363 * Note: scsi_done must not block!
4366 read_unlock_irqrestore(&fsf_req->adapter->abort_lock, flags);
4371 * function: zfcp_fsf_send_fcp_command_task_management_handler
4373 * purpose: evaluates FCP_RSP IU
4378 zfcp_fsf_send_fcp_command_task_management_handler(struct zfcp_fsf_req *fsf_req)
4381 struct fcp_rsp_iu *fcp_rsp_iu = (struct fcp_rsp_iu *)
4382 &(fsf_req->qtcb->bottom.io.fcp_rsp);
4383 char *fcp_rsp_info = zfcp_get_fcp_rsp_info_ptr(fcp_rsp_iu);
4384 struct zfcp_unit *unit =
4385 fsf_req->data.send_fcp_command_task_management.unit;
4387 del_timer(&fsf_req->adapter->scsi_er_timer);
4388 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR) {
4389 fsf_req->status |= ZFCP_STATUS_FSFREQ_TMFUNCFAILED;
4390 goto skip_fsfstatus;
4393 /* check FCP_RSP_INFO */
4394 switch (fcp_rsp_info[3]) {
4396 ZFCP_LOG_FLAGS(3, "RSP_CODE_GOOD\n");
4398 ZFCP_LOG_DEBUG("no failure or Task Management "
4399 "Function complete\n");
4401 case RSP_CODE_TASKMAN_UNSUPP:
4402 ZFCP_LOG_FLAGS(0, "RSP_CODE_TASKMAN_UNSUPP\n");
4403 ZFCP_LOG_NORMAL("bug: A reuested task management function "
4404 "is not supported on the target device "
4405 "unit 0x%016Lx, port 0x%016Lx, adapter %s\n ",
4408 zfcp_get_busid_by_unit(unit));
4409 fsf_req->status |= ZFCP_STATUS_FSFREQ_TMFUNCNOTSUPP;
4411 case RSP_CODE_TASKMAN_FAILED:
4412 ZFCP_LOG_FLAGS(0, "RSP_CODE_TASKMAN_FAILED\n");
4413 ZFCP_LOG_NORMAL("bug: A reuested task management function "
4414 "failed to complete successfully. "
4415 "unit 0x%016Lx, port 0x%016Lx, adapter %s.\n",
4418 zfcp_get_busid_by_unit(unit));
4419 fsf_req->status |= ZFCP_STATUS_FSFREQ_TMFUNCFAILED;
4422 ZFCP_LOG_NORMAL("bug: An invalid FCP response "
4423 "code was detected for a command. "
4424 "unit 0x%016Lx, port 0x%016Lx, adapter %s "
4425 "(debug info 0x%x)\n",
4428 zfcp_get_busid_by_unit(unit),
4430 fsf_req->status |= ZFCP_STATUS_FSFREQ_TMFUNCFAILED;
4439 * function: zfcp_fsf_control_file
4441 * purpose: Initiator of the control file upload/download FSF requests
4443 * returns: 0 - FSF request is successfuly created and queued
4444 * -EOPNOTSUPP - The FCP adapter does not have Control File support
4445 * -EINVAL - Invalid direction specified
4446 * -ENOMEM - Insufficient memory
4447 * -EPERM - Cannot create FSF request or place it in QDIO queue
4450 zfcp_fsf_control_file(struct zfcp_adapter *adapter,
4451 struct zfcp_fsf_req **fsf_req_ptr,
4454 struct zfcp_sg_list *sg_list)
4456 struct zfcp_fsf_req *fsf_req;
4457 struct fsf_qtcb_bottom_support *bottom;
4458 volatile struct qdio_buffer_element *sbale;
4459 struct timer_list *timer;
4460 unsigned long lock_flags;
4465 if (!(adapter->supported_features & FSF_FEATURE_CFDC)) {
4466 ZFCP_LOG_INFO("cfdc not supported (adapter %s)\n",
4467 zfcp_get_busid_by_adapter(adapter));
4468 retval = -EOPNOTSUPP;
4472 switch (fsf_command) {
4474 case FSF_QTCB_DOWNLOAD_CONTROL_FILE:
4475 direction = SBAL_FLAGS0_TYPE_WRITE;
4476 if ((option != FSF_CFDC_OPTION_FULL_ACCESS) &&
4477 (option != FSF_CFDC_OPTION_RESTRICTED_ACCESS))
4478 req_flags = ZFCP_WAIT_FOR_SBAL;
4481 case FSF_QTCB_UPLOAD_CONTROL_FILE:
4482 direction = SBAL_FLAGS0_TYPE_READ;
4486 ZFCP_LOG_INFO("Invalid FSF command code 0x%08x\n", fsf_command);
4491 timer = kmalloc(sizeof(struct timer_list), GFP_KERNEL);
4497 retval = zfcp_fsf_req_create(adapter, fsf_command, req_flags,
4498 NULL, &lock_flags, &fsf_req);
4500 ZFCP_LOG_INFO("error: Could not create FSF request for the "
4502 zfcp_get_busid_by_adapter(adapter));
4504 goto unlock_queue_lock;
4507 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
4508 sbale[0].flags |= direction;
4510 bottom = &fsf_req->qtcb->bottom.support;
4511 bottom->operation_subtype = FSF_CFDC_OPERATION_SUBTYPE;
4512 bottom->option = option;
4514 if (sg_list->count > 0) {
4517 bytes = zfcp_qdio_sbals_from_sg(fsf_req, direction,
4518 sg_list->sg, sg_list->count,
4519 ZFCP_MAX_SBALS_PER_REQ);
4520 if (bytes != ZFCP_CFDC_MAX_CONTROL_FILE_SIZE) {
4522 "error: Could not create sufficient number of "
4523 "SBALS for an FSF request to the adapter %s\n",
4524 zfcp_get_busid_by_adapter(adapter));
4529 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
4532 timer->function = zfcp_fsf_request_timeout_handler;
4533 timer->data = (unsigned long) adapter;
4534 timer->expires = ZFCP_FSF_REQUEST_TIMEOUT;
4536 retval = zfcp_fsf_req_send(fsf_req, timer);
4538 ZFCP_LOG_INFO("initiation of cfdc up/download failed"
4540 zfcp_get_busid_by_adapter(adapter));
4544 write_unlock_irqrestore(&adapter->request_queue.queue_lock, lock_flags);
4546 ZFCP_LOG_NORMAL("Control file %s FSF request has been sent to the "
4548 fsf_command == FSF_QTCB_DOWNLOAD_CONTROL_FILE ?
4549 "download" : "upload",
4550 zfcp_get_busid_by_adapter(adapter));
4552 wait_event(fsf_req->completion_wq,
4553 fsf_req->status & ZFCP_STATUS_FSFREQ_COMPLETED);
4555 *fsf_req_ptr = fsf_req;
4556 del_timer_sync(timer);
4560 zfcp_fsf_req_free(fsf_req);
4562 write_unlock_irqrestore(&adapter->request_queue.queue_lock, lock_flags);
4571 * function: zfcp_fsf_control_file_handler
4573 * purpose: Handler of the control file upload/download FSF requests
4575 * returns: 0 - FSF request successfuly processed
4576 * -EAGAIN - Operation has to be repeated because of a temporary problem
4577 * -EACCES - There is no permission to execute an operation
4578 * -EPERM - The control file is not in a right format
4579 * -EIO - There is a problem with the FCP adapter
4580 * -EINVAL - Invalid operation
4581 * -EFAULT - User space memory I/O operation fault
4584 zfcp_fsf_control_file_handler(struct zfcp_fsf_req *fsf_req)
4586 struct zfcp_adapter *adapter = fsf_req->adapter;
4587 struct fsf_qtcb_header *header = &fsf_req->qtcb->header;
4588 struct fsf_qtcb_bottom_support *bottom = &fsf_req->qtcb->bottom.support;
4591 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR) {
4593 goto skip_fsfstatus;
4596 switch (header->fsf_status) {
4599 ZFCP_LOG_FLAGS(2, "FSF_GOOD\n");
4601 "The FSF request has been successfully completed "
4602 "on the adapter %s\n",
4603 zfcp_get_busid_by_adapter(adapter));
4606 case FSF_OPERATION_PARTIALLY_SUCCESSFUL:
4607 ZFCP_LOG_FLAGS(2, "FSF_OPERATION_PARTIALLY_SUCCESSFUL\n");
4608 if (bottom->operation_subtype == FSF_CFDC_OPERATION_SUBTYPE) {
4609 switch (header->fsf_status_qual.word[0]) {
4611 case FSF_SQ_CFDC_COULD_NOT_HARDEN_ON_SE:
4613 "CFDC of the adapter %s could not "
4614 "be saved on the SE\n",
4615 zfcp_get_busid_by_adapter(adapter));
4618 case FSF_SQ_CFDC_COULD_NOT_HARDEN_ON_SE2:
4620 "CFDC of the adapter %s could not "
4621 "be copied to the secondary SE\n",
4622 zfcp_get_busid_by_adapter(adapter));
4627 "CFDC could not be hardened "
4628 "on the adapter %s\n",
4629 zfcp_get_busid_by_adapter(adapter));
4632 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4636 case FSF_AUTHORIZATION_FAILURE:
4637 ZFCP_LOG_FLAGS(2, "FSF_AUTHORIZATION_FAILURE\n");
4639 "Adapter %s does not accept privileged commands\n",
4640 zfcp_get_busid_by_adapter(adapter));
4641 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4645 case FSF_CFDC_ERROR_DETECTED:
4646 ZFCP_LOG_FLAGS(2, "FSF_CFDC_ERROR_DETECTED\n");
4648 "Error at position %d in the CFDC, "
4649 "CFDC is discarded by the adapter %s\n",
4650 header->fsf_status_qual.word[0],
4651 zfcp_get_busid_by_adapter(adapter));
4652 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4656 case FSF_CONTROL_FILE_UPDATE_ERROR:
4657 ZFCP_LOG_FLAGS(2, "FSF_CONTROL_FILE_UPDATE_ERROR\n");
4659 "Adapter %s cannot harden the control file, "
4660 "file is discarded\n",
4661 zfcp_get_busid_by_adapter(adapter));
4662 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4666 case FSF_CONTROL_FILE_TOO_LARGE:
4667 ZFCP_LOG_FLAGS(2, "FSF_CONTROL_FILE_TOO_LARGE\n");
4669 "Control file is too large, file is discarded "
4670 "by the adapter %s\n",
4671 zfcp_get_busid_by_adapter(adapter));
4672 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4676 case FSF_ACCESS_CONFLICT_DETECTED:
4677 ZFCP_LOG_FLAGS(2, "FSF_ACCESS_CONFLICT_DETECTED\n");
4678 if (bottom->operation_subtype == FSF_CFDC_OPERATION_SUBTYPE)
4680 "CFDC has been discarded by the adapter %s, "
4681 "because activation would impact "
4682 "%d active connection(s)\n",
4683 zfcp_get_busid_by_adapter(adapter),
4684 header->fsf_status_qual.word[0]);
4685 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4689 case FSF_CONFLICTS_OVERRULED:
4690 ZFCP_LOG_FLAGS(2, "FSF_CONFLICTS_OVERRULED\n");
4691 if (bottom->operation_subtype == FSF_CFDC_OPERATION_SUBTYPE)
4693 "CFDC has been activated on the adapter %s, "
4694 "but activation has impacted "
4695 "%d active connection(s)\n",
4696 zfcp_get_busid_by_adapter(adapter),
4697 header->fsf_status_qual.word[0]);
4698 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4702 case FSF_UNKNOWN_OP_SUBTYPE:
4703 ZFCP_LOG_FLAGS(2, "FSF_UNKNOWN_OP_SUBTYPE\n");
4704 ZFCP_LOG_NORMAL("unknown operation subtype (adapter: %s, "
4705 "op_subtype=0x%x)\n",
4706 zfcp_get_busid_by_adapter(adapter),
4707 bottom->operation_subtype);
4708 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4712 case FSF_INVALID_COMMAND_OPTION:
4713 ZFCP_LOG_FLAGS(2, "FSF_INVALID_COMMAND_OPTION\n");
4715 "Invalid option 0x%x has been specified "
4716 "in QTCB bottom sent to the adapter %s\n",
4718 zfcp_get_busid_by_adapter(adapter));
4719 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4725 "bug: An unknown/unexpected FSF status 0x%08x "
4726 "was presented on the adapter %s\n",
4728 zfcp_get_busid_by_adapter(adapter));
4729 debug_text_event(fsf_req->adapter->erp_dbf, 0, "fsf_sq_inval");
4730 debug_exception(fsf_req->adapter->erp_dbf, 0,
4731 &header->fsf_status_qual.word[0], sizeof(u32));
4732 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4743 * function: zfcp_fsf_req_wait_and_cleanup
4747 * FIXME(design): signal seems to be <0 !!!
4748 * returns: 0 - request completed (*status is valid), cleanup succ.
4749 * <0 - request completed (*status is valid), cleanup failed
4750 * >0 - signal which interrupted waiting (*status invalid),
4751 * request not completed, no cleanup
4753 * *status is a copy of status of completed fsf_req
4756 zfcp_fsf_req_wait_and_cleanup(struct zfcp_fsf_req *fsf_req,
4757 int interruptible, u32 * status)
4762 if (interruptible) {
4763 __wait_event_interruptible(fsf_req->completion_wq,
4765 ZFCP_STATUS_FSFREQ_COMPLETED,
4768 ZFCP_LOG_DEBUG("Caught signal %i while waiting for the "
4769 "completion of the request at %p\n",
4775 __wait_event(fsf_req->completion_wq,
4776 fsf_req->status & ZFCP_STATUS_FSFREQ_COMPLETED);
4779 *status = fsf_req->status;
4781 /* cleanup request */
4782 zfcp_fsf_req_cleanup(fsf_req);
4788 zfcp_fsf_req_sbal_check(unsigned long *flags,
4789 struct zfcp_qdio_queue *queue, int needed)
4791 write_lock_irqsave(&queue->queue_lock, *flags);
4792 if (likely(atomic_read(&queue->free_count) >= needed))
4794 write_unlock_irqrestore(&queue->queue_lock, *flags);
4799 * set qtcb pointer in fsf_req and initialize QTCB
4802 zfcp_fsf_req_qtcb_init(struct zfcp_fsf_req *fsf_req, u32 fsf_cmd)
4804 if (likely(fsf_req->qtcb != NULL)) {
4805 fsf_req->qtcb->prefix.req_id = (unsigned long)fsf_req;
4806 fsf_req->qtcb->prefix.ulp_info = ZFCP_ULP_INFO_VERSION;
4807 fsf_req->qtcb->prefix.qtcb_type = fsf_qtcb_type[fsf_cmd];
4808 fsf_req->qtcb->prefix.qtcb_version = ZFCP_QTCB_VERSION;
4809 fsf_req->qtcb->header.req_handle = (unsigned long)fsf_req;
4810 fsf_req->qtcb->header.fsf_command = fsf_cmd;
4815 * zfcp_fsf_req_sbal_get - try to get one SBAL in the request queue
4816 * @adapter: adapter for which request queue is examined
4817 * @req_flags: flags indicating whether to wait for needed SBAL or not
4818 * @lock_flags: lock_flags if queue_lock is taken
4819 * Return: 0 on success, otherwise -EIO, or -ERESTARTSYS
4820 * Locks: lock adapter->request_queue->queue_lock on success
4823 zfcp_fsf_req_sbal_get(struct zfcp_adapter *adapter, int req_flags,
4824 unsigned long *lock_flags)
4827 struct zfcp_qdio_queue *req_queue = &adapter->request_queue;
4829 if (unlikely(req_flags & ZFCP_WAIT_FOR_SBAL)) {
4830 ret = wait_event_interruptible_timeout(adapter->request_wq,
4831 zfcp_fsf_req_sbal_check(lock_flags, req_queue, 1),
4837 } else if (!zfcp_fsf_req_sbal_check(lock_flags, req_queue, 1))
4844 * function: zfcp_fsf_req_create
4846 * purpose: create an FSF request at the specified adapter and
4847 * setup common fields
4849 * returns: -ENOMEM if there was insufficient memory for a request
4850 * -EIO if no qdio buffers could be allocate to the request
4851 * -EINVAL/-EPERM on bug conditions in req_dequeue
4854 * note: The created request is returned by reference.
4856 * locks: lock of concerned request queue must not be held,
4857 * but is held on completion (write, irqsave)
4860 zfcp_fsf_req_create(struct zfcp_adapter *adapter, u32 fsf_cmd, int req_flags,
4861 mempool_t *pool, unsigned long *lock_flags,
4862 struct zfcp_fsf_req **fsf_req_p)
4864 volatile struct qdio_buffer_element *sbale;
4865 struct zfcp_fsf_req *fsf_req = NULL;
4867 struct zfcp_qdio_queue *req_queue = &adapter->request_queue;
4869 /* allocate new FSF request */
4870 fsf_req = zfcp_fsf_req_alloc(pool, req_flags);
4871 if (unlikely(NULL == fsf_req)) {
4872 ZFCP_LOG_DEBUG("error: Could not put an FSF request into"
4873 "the outbound (send) queue.\n");
4875 goto failed_fsf_req;
4878 zfcp_fsf_req_qtcb_init(fsf_req, fsf_cmd);
4880 /* initialize waitqueue which may be used to wait on
4881 this request completion */
4882 init_waitqueue_head(&fsf_req->completion_wq);
4884 ret = zfcp_fsf_req_sbal_get(adapter, req_flags, lock_flags);
4890 * We hold queue_lock here. Check if QDIOUP is set and let request fail
4891 * if it is not set (see also *_open_qdio and *_close_qdio).
4894 if (!atomic_test_mask(ZFCP_STATUS_ADAPTER_QDIOUP, &adapter->status)) {
4895 write_unlock_irqrestore(&req_queue->queue_lock, *lock_flags);
4900 fsf_req->adapter = adapter; /* pointer to "parent" adapter */
4901 fsf_req->fsf_command = fsf_cmd;
4902 fsf_req->sbal_number = 1;
4903 fsf_req->sbal_first = req_queue->free_index;
4904 fsf_req->sbal_curr = req_queue->free_index;
4905 fsf_req->sbale_curr = 1;
4907 if (likely(req_flags & ZFCP_REQ_AUTO_CLEANUP)) {
4908 fsf_req->status |= ZFCP_STATUS_FSFREQ_CLEANUP;
4911 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
4913 /* setup common SBALE fields */
4914 sbale[0].addr = fsf_req;
4915 sbale[0].flags |= SBAL_FLAGS0_COMMAND;
4916 if (likely(fsf_req->qtcb != NULL)) {
4917 sbale[1].addr = (void *) fsf_req->qtcb;
4918 sbale[1].length = sizeof(struct fsf_qtcb);
4921 ZFCP_LOG_TRACE("got %i free BUFFERs starting at index %i\n",
4922 fsf_req->sbal_number, fsf_req->sbal_first);
4927 /* dequeue new FSF request previously enqueued */
4928 zfcp_fsf_req_free(fsf_req);
4932 write_lock_irqsave(&req_queue->queue_lock, *lock_flags);
4934 *fsf_req_p = fsf_req;
4939 * function: zfcp_fsf_req_send
4941 * purpose: start transfer of FSF request via QDIO
4943 * returns: 0 - request transfer succesfully started
4944 * !0 - start of request transfer failed
4947 zfcp_fsf_req_send(struct zfcp_fsf_req *fsf_req, struct timer_list *timer)
4949 struct zfcp_adapter *adapter;
4950 struct zfcp_qdio_queue *req_queue;
4951 volatile struct qdio_buffer_element *sbale;
4952 int new_distance_from_int;
4953 unsigned long flags;
4957 adapter = fsf_req->adapter;
4958 req_queue = &adapter->request_queue,
4961 /* FIXME(debug): remove it later */
4962 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_first, 0);
4963 ZFCP_LOG_DEBUG("SBALE0 flags=0x%x\n", sbale[0].flags);
4964 ZFCP_LOG_TRACE("HEX DUMP OF SBALE1 PAYLOAD:\n");
4965 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_TRACE, (char *) sbale[1].addr,
4968 /* set sequence counter in QTCB */
4969 if (likely(fsf_req->qtcb)) {
4970 fsf_req->qtcb->prefix.req_seq_no = adapter->fsf_req_seq_no;
4971 fsf_req->seq_no = adapter->fsf_req_seq_no;
4972 ZFCP_LOG_TRACE("FSF request %p of adapter %s gets "
4973 "FSF sequence counter value of %i\n",
4975 zfcp_get_busid_by_adapter(adapter),
4976 fsf_req->qtcb->prefix.req_seq_no);
4980 /* put allocated FSF request at list tail */
4981 write_lock_irqsave(&adapter->fsf_req_list_lock, flags);
4982 list_add_tail(&fsf_req->list, &adapter->fsf_req_list_head);
4983 write_unlock_irqrestore(&adapter->fsf_req_list_lock, flags);
4985 /* figure out expiration time of timeout and start timeout */
4986 if (unlikely(timer)) {
4987 timer->expires += jiffies;
4991 ZFCP_LOG_TRACE("request queue of adapter %s: "
4992 "next free SBAL is %i, %i free SBALs\n",
4993 zfcp_get_busid_by_adapter(adapter),
4994 req_queue->free_index,
4995 atomic_read(&req_queue->free_count));
4997 ZFCP_LOG_DEBUG("calling do_QDIO adapter %s, flags=0x%x, queue_no=%i, "
4998 "index_in_queue=%i, count=%i, buffers=%p\n",
4999 zfcp_get_busid_by_adapter(adapter),
5000 QDIO_FLAG_SYNC_OUTPUT,
5001 0, fsf_req->sbal_first, fsf_req->sbal_number,
5002 &req_queue->buffer[fsf_req->sbal_first]);
5005 * adjust the number of free SBALs in request queue as well as
5006 * position of first one
5008 atomic_sub(fsf_req->sbal_number, &req_queue->free_count);
5009 ZFCP_LOG_TRACE("free_count=%d\n", atomic_read(&req_queue->free_count));
5010 req_queue->free_index += fsf_req->sbal_number; /* increase */
5011 req_queue->free_index %= QDIO_MAX_BUFFERS_PER_Q; /* wrap if needed */
5012 new_distance_from_int = zfcp_qdio_determine_pci(req_queue, fsf_req);
5014 retval = do_QDIO(adapter->ccw_device,
5015 QDIO_FLAG_SYNC_OUTPUT,
5016 0, fsf_req->sbal_first, fsf_req->sbal_number, NULL);
5018 if (unlikely(retval)) {
5019 /* Queues are down..... */
5022 * FIXME(potential race):
5023 * timer might be expired (absolutely unlikely)
5026 del_timer_sync(timer);
5027 write_lock_irqsave(&adapter->fsf_req_list_lock, flags);
5028 list_del(&fsf_req->list);
5029 write_unlock_irqrestore(&adapter->fsf_req_list_lock, flags);
5031 * adjust the number of free SBALs in request queue as well as
5032 * position of first one
5034 zfcp_qdio_zero_sbals(req_queue->buffer,
5035 fsf_req->sbal_first, fsf_req->sbal_number);
5036 atomic_add(fsf_req->sbal_number, &req_queue->free_count);
5037 req_queue->free_index -= fsf_req->sbal_number; /* increase */
5038 req_queue->free_index += QDIO_MAX_BUFFERS_PER_Q;
5039 req_queue->free_index %= QDIO_MAX_BUFFERS_PER_Q; /* wrap */
5041 ("error: do_QDIO failed. Buffers could not be enqueued "
5042 "to request queue.\n");
5044 req_queue->distance_from_int = new_distance_from_int;
5046 * increase FSF sequence counter -
5047 * this must only be done for request successfully enqueued to
5048 * QDIO this rejected requests may be cleaned up by calling
5049 * routines resulting in missing sequence counter values
5052 /* Don't increase for unsolicited status */
5053 if (likely(inc_seq_no)) {
5054 adapter->fsf_req_seq_no++;
5056 ("FSF sequence counter value of adapter %s "
5057 "increased to %i\n",
5058 zfcp_get_busid_by_adapter(adapter),
5059 adapter->fsf_req_seq_no);
5061 /* count FSF requests pending */
5062 atomic_inc(&adapter->fsf_reqs_active);
5068 * function: zfcp_fsf_req_cleanup
5070 * purpose: cleans up an FSF request and removes it from the specified list
5074 * assumption: no pending SB in SBALEs other than QTCB
5077 zfcp_fsf_req_cleanup(struct zfcp_fsf_req *fsf_req)
5079 struct zfcp_adapter *adapter = fsf_req->adapter;
5080 unsigned long flags;
5082 write_lock_irqsave(&adapter->fsf_req_list_lock, flags);
5083 list_del(&fsf_req->list);
5084 write_unlock_irqrestore(&adapter->fsf_req_list_lock, flags);
5085 zfcp_fsf_req_free(fsf_req);
5088 #undef ZFCP_LOG_AREA