Revert "[PATCH] paravirt: Add startup infrastructure for paravirtualization"
[pv_ops_mirror.git] / drivers / s390 / scsi / zfcp_fsf.c
bloba8b02542ac2da30aaaf9a953153d41e419c18da0
1 /*
2 * This file is part of the zfcp device driver for
3 * FCP adapters for IBM System z9 and zSeries.
5 * (C) Copyright IBM Corp. 2002, 2006
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2, or (at your option)
10 * any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
22 #include "zfcp_ext.h"
24 static int zfcp_fsf_exchange_config_data_handler(struct zfcp_fsf_req *);
25 static void zfcp_fsf_exchange_port_data_handler(struct zfcp_fsf_req *);
26 static int zfcp_fsf_open_port_handler(struct zfcp_fsf_req *);
27 static int zfcp_fsf_close_port_handler(struct zfcp_fsf_req *);
28 static int zfcp_fsf_close_physical_port_handler(struct zfcp_fsf_req *);
29 static int zfcp_fsf_open_unit_handler(struct zfcp_fsf_req *);
30 static int zfcp_fsf_close_unit_handler(struct zfcp_fsf_req *);
31 static int zfcp_fsf_send_fcp_command_handler(struct zfcp_fsf_req *);
32 static int zfcp_fsf_send_fcp_command_task_handler(struct zfcp_fsf_req *);
33 static int zfcp_fsf_send_fcp_command_task_management_handler(
34 struct zfcp_fsf_req *);
35 static int zfcp_fsf_abort_fcp_command_handler(struct zfcp_fsf_req *);
36 static int zfcp_fsf_status_read_handler(struct zfcp_fsf_req *);
37 static int zfcp_fsf_send_ct_handler(struct zfcp_fsf_req *);
38 static int zfcp_fsf_send_els_handler(struct zfcp_fsf_req *);
39 static int zfcp_fsf_control_file_handler(struct zfcp_fsf_req *);
40 static inline int zfcp_fsf_req_sbal_check(
41 unsigned long *, struct zfcp_qdio_queue *, int);
42 static inline int zfcp_use_one_sbal(
43 struct scatterlist *, int, struct scatterlist *, int);
44 static struct zfcp_fsf_req *zfcp_fsf_req_alloc(mempool_t *, int);
45 static int zfcp_fsf_req_send(struct zfcp_fsf_req *);
46 static int zfcp_fsf_protstatus_eval(struct zfcp_fsf_req *);
47 static int zfcp_fsf_fsfstatus_eval(struct zfcp_fsf_req *);
48 static int zfcp_fsf_fsfstatus_qual_eval(struct zfcp_fsf_req *);
49 static void zfcp_fsf_link_down_info_eval(struct zfcp_adapter *,
50 struct fsf_link_down_info *);
51 static int zfcp_fsf_req_dispatch(struct zfcp_fsf_req *);
53 /* association between FSF command and FSF QTCB type */
54 static u32 fsf_qtcb_type[] = {
55 [FSF_QTCB_FCP_CMND] = FSF_IO_COMMAND,
56 [FSF_QTCB_ABORT_FCP_CMND] = FSF_SUPPORT_COMMAND,
57 [FSF_QTCB_OPEN_PORT_WITH_DID] = FSF_SUPPORT_COMMAND,
58 [FSF_QTCB_OPEN_LUN] = FSF_SUPPORT_COMMAND,
59 [FSF_QTCB_CLOSE_LUN] = FSF_SUPPORT_COMMAND,
60 [FSF_QTCB_CLOSE_PORT] = FSF_SUPPORT_COMMAND,
61 [FSF_QTCB_CLOSE_PHYSICAL_PORT] = FSF_SUPPORT_COMMAND,
62 [FSF_QTCB_SEND_ELS] = FSF_SUPPORT_COMMAND,
63 [FSF_QTCB_SEND_GENERIC] = FSF_SUPPORT_COMMAND,
64 [FSF_QTCB_EXCHANGE_CONFIG_DATA] = FSF_CONFIG_COMMAND,
65 [FSF_QTCB_EXCHANGE_PORT_DATA] = FSF_PORT_COMMAND,
66 [FSF_QTCB_DOWNLOAD_CONTROL_FILE] = FSF_SUPPORT_COMMAND,
67 [FSF_QTCB_UPLOAD_CONTROL_FILE] = FSF_SUPPORT_COMMAND
70 static const char zfcp_act_subtable_type[5][8] = {
71 "unknown", "OS", "WWPN", "DID", "LUN"
74 /****************************************************************/
75 /*************** FSF related Functions *************************/
76 /****************************************************************/
78 #define ZFCP_LOG_AREA ZFCP_LOG_AREA_FSF
81 * function: zfcp_fsf_req_alloc
83 * purpose: Obtains an fsf_req and potentially a qtcb (for all but
84 * unsolicited requests) via helper functions
85 * Does some initial fsf request set-up.
87 * returns: pointer to allocated fsf_req if successfull
88 * NULL otherwise
90 * locks: none
93 static struct zfcp_fsf_req *
94 zfcp_fsf_req_alloc(mempool_t *pool, int req_flags)
96 size_t size;
97 void *ptr;
98 struct zfcp_fsf_req *fsf_req = NULL;
100 if (req_flags & ZFCP_REQ_NO_QTCB)
101 size = sizeof(struct zfcp_fsf_req);
102 else
103 size = sizeof(struct zfcp_fsf_req_qtcb);
105 if (likely(pool))
106 ptr = mempool_alloc(pool, GFP_ATOMIC);
107 else {
108 if (req_flags & ZFCP_REQ_NO_QTCB)
109 ptr = kmalloc(size, GFP_ATOMIC);
110 else
111 ptr = kmem_cache_alloc(zfcp_data.fsf_req_qtcb_cache,
112 GFP_ATOMIC);
115 if (unlikely(!ptr))
116 goto out;
118 memset(ptr, 0, size);
120 if (req_flags & ZFCP_REQ_NO_QTCB) {
121 fsf_req = (struct zfcp_fsf_req *) ptr;
122 } else {
123 fsf_req = &((struct zfcp_fsf_req_qtcb *) ptr)->fsf_req;
124 fsf_req->qtcb = &((struct zfcp_fsf_req_qtcb *) ptr)->qtcb;
127 fsf_req->pool = pool;
129 out:
130 return fsf_req;
134 * function: zfcp_fsf_req_free
136 * purpose: Frees the memory of an fsf_req (and potentially a qtcb) or
137 * returns it into the pool via helper functions.
139 * returns: sod all
141 * locks: none
143 void
144 zfcp_fsf_req_free(struct zfcp_fsf_req *fsf_req)
146 if (likely(fsf_req->pool)) {
147 mempool_free(fsf_req, fsf_req->pool);
148 return;
151 if (fsf_req->qtcb) {
152 kmem_cache_free(zfcp_data.fsf_req_qtcb_cache, fsf_req);
153 return;
156 kfree(fsf_req);
160 * zfcp_fsf_req_dismiss - dismiss a single fsf request
162 static void zfcp_fsf_req_dismiss(struct zfcp_adapter *adapter,
163 struct zfcp_fsf_req *fsf_req,
164 unsigned int counter)
166 u64 dbg_tmp[2];
168 dbg_tmp[0] = (u64) atomic_read(&adapter->reqs_active);
169 dbg_tmp[1] = (u64) counter;
170 debug_event(adapter->erp_dbf, 4, (void *) dbg_tmp, 16);
171 list_del(&fsf_req->list);
172 fsf_req->status |= ZFCP_STATUS_FSFREQ_DISMISSED;
173 zfcp_fsf_req_complete(fsf_req);
177 * zfcp_fsf_req_dismiss_all - dismiss all remaining fsf requests
179 void zfcp_fsf_req_dismiss_all(struct zfcp_adapter *adapter)
181 struct zfcp_fsf_req *request, *tmp;
182 unsigned long flags;
183 LIST_HEAD(remove_queue);
184 unsigned int i, counter;
186 spin_lock_irqsave(&adapter->req_list_lock, flags);
187 atomic_set(&adapter->reqs_active, 0);
188 for (i=0; i<REQUEST_LIST_SIZE; i++)
189 list_splice_init(&adapter->req_list[i], &remove_queue);
191 spin_unlock_irqrestore(&adapter->req_list_lock, flags);
193 counter = 0;
194 list_for_each_entry_safe(request, tmp, &remove_queue, list) {
195 zfcp_fsf_req_dismiss(adapter, request, counter);
196 counter++;
201 * function: zfcp_fsf_req_complete
203 * purpose: Updates active counts and timers for openfcp-reqs
204 * May cleanup request after req_eval returns
206 * returns: 0 - success
207 * !0 - failure
209 * context:
212 zfcp_fsf_req_complete(struct zfcp_fsf_req *fsf_req)
214 int retval = 0;
215 int cleanup;
217 if (unlikely(fsf_req->fsf_command == FSF_QTCB_UNSOLICITED_STATUS)) {
218 ZFCP_LOG_DEBUG("Status read response received\n");
220 * Note: all cleanup handling is done in the callchain of
221 * the function call-chain below.
223 zfcp_fsf_status_read_handler(fsf_req);
224 goto out;
225 } else {
226 del_timer(&fsf_req->timer);
227 zfcp_fsf_protstatus_eval(fsf_req);
231 * fsf_req may be deleted due to waking up functions, so
232 * cleanup is saved here and used later
234 if (likely(fsf_req->status & ZFCP_STATUS_FSFREQ_CLEANUP))
235 cleanup = 1;
236 else
237 cleanup = 0;
239 fsf_req->status |= ZFCP_STATUS_FSFREQ_COMPLETED;
241 /* cleanup request if requested by initiator */
242 if (likely(cleanup)) {
243 ZFCP_LOG_TRACE("removing FSF request %p\n", fsf_req);
245 * lock must not be held here since it will be
246 * grabed by the called routine, too
248 zfcp_fsf_req_free(fsf_req);
249 } else {
250 /* notify initiator waiting for the requests completion */
251 ZFCP_LOG_TRACE("waking initiator of FSF request %p\n",fsf_req);
253 * FIXME: Race! We must not access fsf_req here as it might have been
254 * cleaned up already due to the set ZFCP_STATUS_FSFREQ_COMPLETED
255 * flag. It's an improbable case. But, we have the same paranoia for
256 * the cleanup flag already.
257 * Might better be handled using complete()?
258 * (setting the flag and doing wakeup ought to be atomic
259 * with regard to checking the flag as long as waitqueue is
260 * part of the to be released structure)
262 wake_up(&fsf_req->completion_wq);
265 out:
266 return retval;
270 * function: zfcp_fsf_protstatus_eval
272 * purpose: evaluates the QTCB of the finished FSF request
273 * and initiates appropriate actions
274 * (usually calling FSF command specific handlers)
276 * returns:
278 * context:
280 * locks:
282 static int
283 zfcp_fsf_protstatus_eval(struct zfcp_fsf_req *fsf_req)
285 int retval = 0;
286 struct zfcp_adapter *adapter = fsf_req->adapter;
287 struct fsf_qtcb *qtcb = fsf_req->qtcb;
288 union fsf_prot_status_qual *prot_status_qual =
289 &qtcb->prefix.prot_status_qual;
291 zfcp_hba_dbf_event_fsf_response(fsf_req);
293 if (fsf_req->status & ZFCP_STATUS_FSFREQ_DISMISSED) {
294 ZFCP_LOG_DEBUG("fsf_req 0x%lx has been dismissed\n",
295 (unsigned long) fsf_req);
296 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR |
297 ZFCP_STATUS_FSFREQ_RETRY; /* only for SCSI cmnds. */
298 goto skip_protstatus;
301 /* log additional information provided by FSF (if any) */
302 if (likely(qtcb->header.log_length)) {
303 /* do not trust them ;-) */
304 if (unlikely(qtcb->header.log_start >
305 sizeof(struct fsf_qtcb))) {
306 ZFCP_LOG_NORMAL
307 ("bug: ULP (FSF logging) log data starts "
308 "beyond end of packet header. Ignored. "
309 "(start=%i, size=%li)\n",
310 qtcb->header.log_start,
311 sizeof(struct fsf_qtcb));
312 goto forget_log;
314 if (unlikely((size_t) (qtcb->header.log_start +
315 qtcb->header.log_length) >
316 sizeof(struct fsf_qtcb))) {
317 ZFCP_LOG_NORMAL("bug: ULP (FSF logging) log data ends "
318 "beyond end of packet header. Ignored. "
319 "(start=%i, length=%i, size=%li)\n",
320 qtcb->header.log_start,
321 qtcb->header.log_length,
322 sizeof(struct fsf_qtcb));
323 goto forget_log;
325 ZFCP_LOG_TRACE("ULP log data: \n");
326 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_TRACE,
327 (char *) qtcb + qtcb->header.log_start,
328 qtcb->header.log_length);
330 forget_log:
332 /* evaluate FSF Protocol Status */
333 switch (qtcb->prefix.prot_status) {
335 case FSF_PROT_GOOD:
336 case FSF_PROT_FSF_STATUS_PRESENTED:
337 break;
339 case FSF_PROT_QTCB_VERSION_ERROR:
340 ZFCP_LOG_NORMAL("error: The adapter %s contains "
341 "microcode of version 0x%x, the device driver "
342 "only supports 0x%x. Aborting.\n",
343 zfcp_get_busid_by_adapter(adapter),
344 prot_status_qual->version_error.fsf_version,
345 ZFCP_QTCB_VERSION);
346 zfcp_erp_adapter_shutdown(adapter, 0);
347 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
348 break;
350 case FSF_PROT_SEQ_NUMB_ERROR:
351 ZFCP_LOG_NORMAL("bug: Sequence number mismatch between "
352 "driver (0x%x) and adapter %s (0x%x). "
353 "Restarting all operations on this adapter.\n",
354 qtcb->prefix.req_seq_no,
355 zfcp_get_busid_by_adapter(adapter),
356 prot_status_qual->sequence_error.exp_req_seq_no);
357 zfcp_erp_adapter_reopen(adapter, 0);
358 fsf_req->status |= ZFCP_STATUS_FSFREQ_RETRY;
359 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
360 break;
362 case FSF_PROT_UNSUPP_QTCB_TYPE:
363 ZFCP_LOG_NORMAL("error: Packet header type used by the "
364 "device driver is incompatible with "
365 "that used on adapter %s. "
366 "Stopping all operations on this adapter.\n",
367 zfcp_get_busid_by_adapter(adapter));
368 zfcp_erp_adapter_shutdown(adapter, 0);
369 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
370 break;
372 case FSF_PROT_HOST_CONNECTION_INITIALIZING:
373 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
374 atomic_set_mask(ZFCP_STATUS_ADAPTER_HOST_CON_INIT,
375 &(adapter->status));
376 break;
378 case FSF_PROT_DUPLICATE_REQUEST_ID:
379 ZFCP_LOG_NORMAL("bug: The request identifier 0x%Lx "
380 "to the adapter %s is ambiguous. "
381 "Stopping all operations on this adapter.\n",
382 *(unsigned long long*)
383 (&qtcb->bottom.support.req_handle),
384 zfcp_get_busid_by_adapter(adapter));
385 zfcp_erp_adapter_shutdown(adapter, 0);
386 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
387 break;
389 case FSF_PROT_LINK_DOWN:
390 zfcp_fsf_link_down_info_eval(adapter,
391 &prot_status_qual->link_down_info);
392 zfcp_erp_adapter_reopen(adapter, 0);
393 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
394 break;
396 case FSF_PROT_REEST_QUEUE:
397 ZFCP_LOG_NORMAL("The local link to adapter with "
398 "%s was re-plugged. "
399 "Re-starting operations on this adapter.\n",
400 zfcp_get_busid_by_adapter(adapter));
401 /* All ports should be marked as ready to run again */
402 zfcp_erp_modify_adapter_status(adapter,
403 ZFCP_STATUS_COMMON_RUNNING,
404 ZFCP_SET);
405 zfcp_erp_adapter_reopen(adapter,
406 ZFCP_STATUS_ADAPTER_LINK_UNPLUGGED
407 | ZFCP_STATUS_COMMON_ERP_FAILED);
408 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
409 break;
411 case FSF_PROT_ERROR_STATE:
412 ZFCP_LOG_NORMAL("error: The adapter %s "
413 "has entered the error state. "
414 "Restarting all operations on this "
415 "adapter.\n",
416 zfcp_get_busid_by_adapter(adapter));
417 zfcp_erp_adapter_reopen(adapter, 0);
418 fsf_req->status |= ZFCP_STATUS_FSFREQ_RETRY;
419 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
420 break;
422 default:
423 ZFCP_LOG_NORMAL("bug: Transfer protocol status information "
424 "provided by the adapter %s "
425 "is not compatible with the device driver. "
426 "Stopping all operations on this adapter. "
427 "(debug info 0x%x).\n",
428 zfcp_get_busid_by_adapter(adapter),
429 qtcb->prefix.prot_status);
430 zfcp_erp_adapter_shutdown(adapter, 0);
431 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
434 skip_protstatus:
436 * always call specific handlers to give them a chance to do
437 * something meaningful even in error cases
439 zfcp_fsf_fsfstatus_eval(fsf_req);
440 return retval;
444 * function: zfcp_fsf_fsfstatus_eval
446 * purpose: evaluates FSF status of completed FSF request
447 * and acts accordingly
449 * returns:
451 static int
452 zfcp_fsf_fsfstatus_eval(struct zfcp_fsf_req *fsf_req)
454 int retval = 0;
456 if (unlikely(fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR)) {
457 goto skip_fsfstatus;
460 /* evaluate FSF Status */
461 switch (fsf_req->qtcb->header.fsf_status) {
462 case FSF_UNKNOWN_COMMAND:
463 ZFCP_LOG_NORMAL("bug: Command issued by the device driver is "
464 "not known by the adapter %s "
465 "Stopping all operations on this adapter. "
466 "(debug info 0x%x).\n",
467 zfcp_get_busid_by_adapter(fsf_req->adapter),
468 fsf_req->qtcb->header.fsf_command);
469 zfcp_erp_adapter_shutdown(fsf_req->adapter, 0);
470 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
471 break;
473 case FSF_FCP_RSP_AVAILABLE:
474 ZFCP_LOG_DEBUG("FCP Sense data will be presented to the "
475 "SCSI stack.\n");
476 break;
478 case FSF_ADAPTER_STATUS_AVAILABLE:
479 zfcp_fsf_fsfstatus_qual_eval(fsf_req);
480 break;
483 skip_fsfstatus:
485 * always call specific handlers to give them a chance to do
486 * something meaningful even in error cases
488 zfcp_fsf_req_dispatch(fsf_req);
490 return retval;
494 * function: zfcp_fsf_fsfstatus_qual_eval
496 * purpose: evaluates FSF status-qualifier of completed FSF request
497 * and acts accordingly
499 * returns:
501 static int
502 zfcp_fsf_fsfstatus_qual_eval(struct zfcp_fsf_req *fsf_req)
504 int retval = 0;
506 switch (fsf_req->qtcb->header.fsf_status_qual.word[0]) {
507 case FSF_SQ_FCP_RSP_AVAILABLE:
508 break;
509 case FSF_SQ_RETRY_IF_POSSIBLE:
510 /* The SCSI-stack may now issue retries or escalate */
511 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
512 break;
513 case FSF_SQ_COMMAND_ABORTED:
514 /* Carry the aborted state on to upper layer */
515 fsf_req->status |= ZFCP_STATUS_FSFREQ_ABORTED;
516 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
517 break;
518 case FSF_SQ_NO_RECOM:
519 ZFCP_LOG_NORMAL("bug: No recommendation could be given for a"
520 "problem on the adapter %s "
521 "Stopping all operations on this adapter. ",
522 zfcp_get_busid_by_adapter(fsf_req->adapter));
523 zfcp_erp_adapter_shutdown(fsf_req->adapter, 0);
524 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
525 break;
526 case FSF_SQ_ULP_PROGRAMMING_ERROR:
527 ZFCP_LOG_NORMAL("error: not enough SBALs for data transfer "
528 "(adapter %s)\n",
529 zfcp_get_busid_by_adapter(fsf_req->adapter));
530 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
531 break;
532 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
533 case FSF_SQ_NO_RETRY_POSSIBLE:
534 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
535 /* dealt with in the respective functions */
536 break;
537 default:
538 ZFCP_LOG_NORMAL("bug: Additional status info could "
539 "not be interpreted properly.\n");
540 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_NORMAL,
541 (char *) &fsf_req->qtcb->header.fsf_status_qual,
542 sizeof (union fsf_status_qual));
543 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
544 break;
547 return retval;
551 * zfcp_fsf_link_down_info_eval - evaluate link down information block
553 static void
554 zfcp_fsf_link_down_info_eval(struct zfcp_adapter *adapter,
555 struct fsf_link_down_info *link_down)
557 if (atomic_test_mask(ZFCP_STATUS_ADAPTER_LINK_UNPLUGGED,
558 &adapter->status))
559 return;
561 atomic_set_mask(ZFCP_STATUS_ADAPTER_LINK_UNPLUGGED, &adapter->status);
563 if (link_down == NULL)
564 goto out;
566 switch (link_down->error_code) {
567 case FSF_PSQ_LINK_NO_LIGHT:
568 ZFCP_LOG_NORMAL("The local link to adapter %s is down "
569 "(no light detected)\n",
570 zfcp_get_busid_by_adapter(adapter));
571 break;
572 case FSF_PSQ_LINK_WRAP_PLUG:
573 ZFCP_LOG_NORMAL("The local link to adapter %s is down "
574 "(wrap plug detected)\n",
575 zfcp_get_busid_by_adapter(adapter));
576 break;
577 case FSF_PSQ_LINK_NO_FCP:
578 ZFCP_LOG_NORMAL("The local link to adapter %s is down "
579 "(adjacent node on link does not support FCP)\n",
580 zfcp_get_busid_by_adapter(adapter));
581 break;
582 case FSF_PSQ_LINK_FIRMWARE_UPDATE:
583 ZFCP_LOG_NORMAL("The local link to adapter %s is down "
584 "(firmware update in progress)\n",
585 zfcp_get_busid_by_adapter(adapter));
586 break;
587 case FSF_PSQ_LINK_INVALID_WWPN:
588 ZFCP_LOG_NORMAL("The local link to adapter %s is down "
589 "(duplicate or invalid WWPN detected)\n",
590 zfcp_get_busid_by_adapter(adapter));
591 break;
592 case FSF_PSQ_LINK_NO_NPIV_SUPPORT:
593 ZFCP_LOG_NORMAL("The local link to adapter %s is down "
594 "(no support for NPIV by Fabric)\n",
595 zfcp_get_busid_by_adapter(adapter));
596 break;
597 case FSF_PSQ_LINK_NO_FCP_RESOURCES:
598 ZFCP_LOG_NORMAL("The local link to adapter %s is down "
599 "(out of resource in FCP daughtercard)\n",
600 zfcp_get_busid_by_adapter(adapter));
601 break;
602 case FSF_PSQ_LINK_NO_FABRIC_RESOURCES:
603 ZFCP_LOG_NORMAL("The local link to adapter %s is down "
604 "(out of resource in Fabric)\n",
605 zfcp_get_busid_by_adapter(adapter));
606 break;
607 case FSF_PSQ_LINK_FABRIC_LOGIN_UNABLE:
608 ZFCP_LOG_NORMAL("The local link to adapter %s is down "
609 "(unable to Fabric login)\n",
610 zfcp_get_busid_by_adapter(adapter));
611 break;
612 case FSF_PSQ_LINK_WWPN_ASSIGNMENT_CORRUPTED:
613 ZFCP_LOG_NORMAL("WWPN assignment file corrupted on adapter %s\n",
614 zfcp_get_busid_by_adapter(adapter));
615 break;
616 case FSF_PSQ_LINK_MODE_TABLE_CURRUPTED:
617 ZFCP_LOG_NORMAL("Mode table corrupted on adapter %s\n",
618 zfcp_get_busid_by_adapter(adapter));
619 break;
620 case FSF_PSQ_LINK_NO_WWPN_ASSIGNMENT:
621 ZFCP_LOG_NORMAL("No WWPN for assignment table on adapter %s\n",
622 zfcp_get_busid_by_adapter(adapter));
623 break;
624 default:
625 ZFCP_LOG_NORMAL("The local link to adapter %s is down "
626 "(warning: unknown reason code %d)\n",
627 zfcp_get_busid_by_adapter(adapter),
628 link_down->error_code);
631 if (adapter->connection_features & FSF_FEATURE_NPIV_MODE)
632 ZFCP_LOG_DEBUG("Debug information to link down: "
633 "primary_status=0x%02x "
634 "ioerr_code=0x%02x "
635 "action_code=0x%02x "
636 "reason_code=0x%02x "
637 "explanation_code=0x%02x "
638 "vendor_specific_code=0x%02x\n",
639 link_down->primary_status,
640 link_down->ioerr_code,
641 link_down->action_code,
642 link_down->reason_code,
643 link_down->explanation_code,
644 link_down->vendor_specific_code);
646 out:
647 zfcp_erp_adapter_failed(adapter);
651 * function: zfcp_fsf_req_dispatch
653 * purpose: calls the appropriate command specific handler
655 * returns:
657 static int
658 zfcp_fsf_req_dispatch(struct zfcp_fsf_req *fsf_req)
660 struct zfcp_erp_action *erp_action = fsf_req->erp_action;
661 struct zfcp_adapter *adapter = fsf_req->adapter;
662 int retval = 0;
665 switch (fsf_req->fsf_command) {
667 case FSF_QTCB_FCP_CMND:
668 zfcp_fsf_send_fcp_command_handler(fsf_req);
669 break;
671 case FSF_QTCB_ABORT_FCP_CMND:
672 zfcp_fsf_abort_fcp_command_handler(fsf_req);
673 break;
675 case FSF_QTCB_SEND_GENERIC:
676 zfcp_fsf_send_ct_handler(fsf_req);
677 break;
679 case FSF_QTCB_OPEN_PORT_WITH_DID:
680 zfcp_fsf_open_port_handler(fsf_req);
681 break;
683 case FSF_QTCB_OPEN_LUN:
684 zfcp_fsf_open_unit_handler(fsf_req);
685 break;
687 case FSF_QTCB_CLOSE_LUN:
688 zfcp_fsf_close_unit_handler(fsf_req);
689 break;
691 case FSF_QTCB_CLOSE_PORT:
692 zfcp_fsf_close_port_handler(fsf_req);
693 break;
695 case FSF_QTCB_CLOSE_PHYSICAL_PORT:
696 zfcp_fsf_close_physical_port_handler(fsf_req);
697 break;
699 case FSF_QTCB_EXCHANGE_CONFIG_DATA:
700 zfcp_fsf_exchange_config_data_handler(fsf_req);
701 break;
703 case FSF_QTCB_EXCHANGE_PORT_DATA:
704 zfcp_fsf_exchange_port_data_handler(fsf_req);
705 break;
707 case FSF_QTCB_SEND_ELS:
708 zfcp_fsf_send_els_handler(fsf_req);
709 break;
711 case FSF_QTCB_DOWNLOAD_CONTROL_FILE:
712 zfcp_fsf_control_file_handler(fsf_req);
713 break;
715 case FSF_QTCB_UPLOAD_CONTROL_FILE:
716 zfcp_fsf_control_file_handler(fsf_req);
717 break;
719 default:
720 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
721 ZFCP_LOG_NORMAL("bug: Command issued by the device driver is "
722 "not supported by the adapter %s\n",
723 zfcp_get_busid_by_adapter(adapter));
724 if (fsf_req->fsf_command != fsf_req->qtcb->header.fsf_command)
725 ZFCP_LOG_NORMAL
726 ("bug: Command issued by the device driver differs "
727 "from the command returned by the adapter %s "
728 "(debug info 0x%x, 0x%x).\n",
729 zfcp_get_busid_by_adapter(adapter),
730 fsf_req->fsf_command,
731 fsf_req->qtcb->header.fsf_command);
734 if (!erp_action)
735 return retval;
737 zfcp_erp_async_handler(erp_action, 0);
739 return retval;
743 * function: zfcp_fsf_status_read
745 * purpose: initiates a Status Read command at the specified adapter
747 * returns:
750 zfcp_fsf_status_read(struct zfcp_adapter *adapter, int req_flags)
752 struct zfcp_fsf_req *fsf_req;
753 struct fsf_status_read_buffer *status_buffer;
754 unsigned long lock_flags;
755 volatile struct qdio_buffer_element *sbale;
756 int retval = 0;
758 /* setup new FSF request */
759 retval = zfcp_fsf_req_create(adapter, FSF_QTCB_UNSOLICITED_STATUS,
760 req_flags | ZFCP_REQ_NO_QTCB,
761 adapter->pool.fsf_req_status_read,
762 &lock_flags, &fsf_req);
763 if (retval < 0) {
764 ZFCP_LOG_INFO("error: Could not create unsolicited status "
765 "buffer for adapter %s.\n",
766 zfcp_get_busid_by_adapter(adapter));
767 goto failed_req_create;
770 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
771 sbale[0].flags |= SBAL_FLAGS0_TYPE_STATUS;
772 sbale[2].flags |= SBAL_FLAGS_LAST_ENTRY;
773 fsf_req->sbale_curr = 2;
775 status_buffer =
776 mempool_alloc(adapter->pool.data_status_read, GFP_ATOMIC);
777 if (!status_buffer) {
778 ZFCP_LOG_NORMAL("bug: could not get some buffer\n");
779 goto failed_buf;
781 memset(status_buffer, 0, sizeof (struct fsf_status_read_buffer));
782 fsf_req->data = (unsigned long) status_buffer;
784 /* insert pointer to respective buffer */
785 sbale = zfcp_qdio_sbale_curr(fsf_req);
786 sbale->addr = (void *) status_buffer;
787 sbale->length = sizeof(struct fsf_status_read_buffer);
789 retval = zfcp_fsf_req_send(fsf_req);
790 if (retval) {
791 ZFCP_LOG_DEBUG("error: Could not set-up unsolicited status "
792 "environment.\n");
793 goto failed_req_send;
796 ZFCP_LOG_TRACE("Status Read request initiated (adapter%s)\n",
797 zfcp_get_busid_by_adapter(adapter));
798 goto out;
800 failed_req_send:
801 mempool_free(status_buffer, adapter->pool.data_status_read);
803 failed_buf:
804 zfcp_fsf_req_free(fsf_req);
805 failed_req_create:
806 zfcp_hba_dbf_event_fsf_unsol("fail", adapter, NULL);
807 out:
808 write_unlock_irqrestore(&adapter->request_queue.queue_lock, lock_flags);
809 return retval;
812 static int
813 zfcp_fsf_status_read_port_closed(struct zfcp_fsf_req *fsf_req)
815 struct fsf_status_read_buffer *status_buffer;
816 struct zfcp_adapter *adapter;
817 struct zfcp_port *port;
818 unsigned long flags;
820 status_buffer = (struct fsf_status_read_buffer *) fsf_req->data;
821 adapter = fsf_req->adapter;
823 read_lock_irqsave(&zfcp_data.config_lock, flags);
824 list_for_each_entry(port, &adapter->port_list_head, list)
825 if (port->d_id == (status_buffer->d_id & ZFCP_DID_MASK))
826 break;
827 read_unlock_irqrestore(&zfcp_data.config_lock, flags);
829 if (!port || (port->d_id != (status_buffer->d_id & ZFCP_DID_MASK))) {
830 ZFCP_LOG_NORMAL("bug: Reopen port indication received for"
831 "nonexisting port with d_id 0x%06x on "
832 "adapter %s. Ignored.\n",
833 status_buffer->d_id & ZFCP_DID_MASK,
834 zfcp_get_busid_by_adapter(adapter));
835 goto out;
838 switch (status_buffer->status_subtype) {
840 case FSF_STATUS_READ_SUB_CLOSE_PHYS_PORT:
841 debug_text_event(adapter->erp_dbf, 3, "unsol_pc_phys:");
842 zfcp_erp_port_reopen(port, 0);
843 break;
845 case FSF_STATUS_READ_SUB_ERROR_PORT:
846 debug_text_event(adapter->erp_dbf, 1, "unsol_pc_err:");
847 zfcp_erp_port_shutdown(port, 0);
848 break;
850 default:
851 debug_text_event(adapter->erp_dbf, 0, "unsol_unk_sub:");
852 debug_exception(adapter->erp_dbf, 0,
853 &status_buffer->status_subtype, sizeof (u32));
854 ZFCP_LOG_NORMAL("bug: Undefined status subtype received "
855 "for a reopen indication on port with "
856 "d_id 0x%06x on the adapter %s. "
857 "Ignored. (debug info 0x%x)\n",
858 status_buffer->d_id,
859 zfcp_get_busid_by_adapter(adapter),
860 status_buffer->status_subtype);
862 out:
863 return 0;
867 * function: zfcp_fsf_status_read_handler
869 * purpose: is called for finished Open Port command
871 * returns:
873 static int
874 zfcp_fsf_status_read_handler(struct zfcp_fsf_req *fsf_req)
876 int retval = 0;
877 struct zfcp_adapter *adapter = fsf_req->adapter;
878 struct fsf_status_read_buffer *status_buffer =
879 (struct fsf_status_read_buffer *) fsf_req->data;
880 struct fsf_bit_error_payload *fsf_bit_error;
882 if (fsf_req->status & ZFCP_STATUS_FSFREQ_DISMISSED) {
883 zfcp_hba_dbf_event_fsf_unsol("dism", adapter, status_buffer);
884 mempool_free(status_buffer, adapter->pool.data_status_read);
885 zfcp_fsf_req_free(fsf_req);
886 goto out;
889 zfcp_hba_dbf_event_fsf_unsol("read", adapter, status_buffer);
891 switch (status_buffer->status_type) {
893 case FSF_STATUS_READ_PORT_CLOSED:
894 zfcp_fsf_status_read_port_closed(fsf_req);
895 break;
897 case FSF_STATUS_READ_INCOMING_ELS:
898 zfcp_fsf_incoming_els(fsf_req);
899 break;
901 case FSF_STATUS_READ_SENSE_DATA_AVAIL:
902 ZFCP_LOG_INFO("unsolicited sense data received (adapter %s)\n",
903 zfcp_get_busid_by_adapter(adapter));
904 break;
906 case FSF_STATUS_READ_BIT_ERROR_THRESHOLD:
907 fsf_bit_error = (struct fsf_bit_error_payload *)
908 status_buffer->payload;
909 ZFCP_LOG_NORMAL("Warning: bit error threshold data "
910 "received (adapter %s, "
911 "link failures = %i, loss of sync errors = %i, "
912 "loss of signal errors = %i, "
913 "primitive sequence errors = %i, "
914 "invalid transmission word errors = %i, "
915 "CRC errors = %i)\n",
916 zfcp_get_busid_by_adapter(adapter),
917 fsf_bit_error->link_failure_error_count,
918 fsf_bit_error->loss_of_sync_error_count,
919 fsf_bit_error->loss_of_signal_error_count,
920 fsf_bit_error->primitive_sequence_error_count,
921 fsf_bit_error->invalid_transmission_word_error_count,
922 fsf_bit_error->crc_error_count);
923 ZFCP_LOG_INFO("Additional bit error threshold data "
924 "(adapter %s, "
925 "primitive sequence event time-outs = %i, "
926 "elastic buffer overrun errors = %i, "
927 "advertised receive buffer-to-buffer credit = %i, "
928 "current receice buffer-to-buffer credit = %i, "
929 "advertised transmit buffer-to-buffer credit = %i, "
930 "current transmit buffer-to-buffer credit = %i)\n",
931 zfcp_get_busid_by_adapter(adapter),
932 fsf_bit_error->primitive_sequence_event_timeout_count,
933 fsf_bit_error->elastic_buffer_overrun_error_count,
934 fsf_bit_error->advertised_receive_b2b_credit,
935 fsf_bit_error->current_receive_b2b_credit,
936 fsf_bit_error->advertised_transmit_b2b_credit,
937 fsf_bit_error->current_transmit_b2b_credit);
938 break;
940 case FSF_STATUS_READ_LINK_DOWN:
941 switch (status_buffer->status_subtype) {
942 case FSF_STATUS_READ_SUB_NO_PHYSICAL_LINK:
943 ZFCP_LOG_INFO("Physical link to adapter %s is down\n",
944 zfcp_get_busid_by_adapter(adapter));
945 zfcp_fsf_link_down_info_eval(adapter,
946 (struct fsf_link_down_info *)
947 &status_buffer->payload);
948 break;
949 case FSF_STATUS_READ_SUB_FDISC_FAILED:
950 ZFCP_LOG_INFO("Local link to adapter %s is down "
951 "due to failed FDISC login\n",
952 zfcp_get_busid_by_adapter(adapter));
953 zfcp_fsf_link_down_info_eval(adapter,
954 (struct fsf_link_down_info *)
955 &status_buffer->payload);
956 break;
957 case FSF_STATUS_READ_SUB_FIRMWARE_UPDATE:
958 ZFCP_LOG_INFO("Local link to adapter %s is down "
959 "due to firmware update on adapter\n",
960 zfcp_get_busid_by_adapter(adapter));
961 zfcp_fsf_link_down_info_eval(adapter, NULL);
962 break;
963 default:
964 ZFCP_LOG_INFO("Local link to adapter %s is down "
965 "due to unknown reason\n",
966 zfcp_get_busid_by_adapter(adapter));
967 zfcp_fsf_link_down_info_eval(adapter, NULL);
969 break;
971 case FSF_STATUS_READ_LINK_UP:
972 ZFCP_LOG_NORMAL("Local link to adapter %s was replugged. "
973 "Restarting operations on this adapter\n",
974 zfcp_get_busid_by_adapter(adapter));
975 /* All ports should be marked as ready to run again */
976 zfcp_erp_modify_adapter_status(adapter,
977 ZFCP_STATUS_COMMON_RUNNING,
978 ZFCP_SET);
979 zfcp_erp_adapter_reopen(adapter,
980 ZFCP_STATUS_ADAPTER_LINK_UNPLUGGED
981 | ZFCP_STATUS_COMMON_ERP_FAILED);
982 break;
984 case FSF_STATUS_READ_NOTIFICATION_LOST:
985 ZFCP_LOG_NORMAL("Unsolicited status notification(s) lost: "
986 "adapter %s%s%s%s%s%s%s%s%s\n",
987 zfcp_get_busid_by_adapter(adapter),
988 (status_buffer->status_subtype &
989 FSF_STATUS_READ_SUB_INCOMING_ELS) ?
990 ", incoming ELS" : "",
991 (status_buffer->status_subtype &
992 FSF_STATUS_READ_SUB_SENSE_DATA) ?
993 ", sense data" : "",
994 (status_buffer->status_subtype &
995 FSF_STATUS_READ_SUB_LINK_STATUS) ?
996 ", link status change" : "",
997 (status_buffer->status_subtype &
998 FSF_STATUS_READ_SUB_PORT_CLOSED) ?
999 ", port close" : "",
1000 (status_buffer->status_subtype &
1001 FSF_STATUS_READ_SUB_BIT_ERROR_THRESHOLD) ?
1002 ", bit error exception" : "",
1003 (status_buffer->status_subtype &
1004 FSF_STATUS_READ_SUB_ACT_UPDATED) ?
1005 ", ACT update" : "",
1006 (status_buffer->status_subtype &
1007 FSF_STATUS_READ_SUB_ACT_HARDENED) ?
1008 ", ACT hardening" : "",
1009 (status_buffer->status_subtype &
1010 FSF_STATUS_READ_SUB_FEATURE_UPDATE_ALERT) ?
1011 ", adapter feature change" : "");
1013 if (status_buffer->status_subtype &
1014 FSF_STATUS_READ_SUB_ACT_UPDATED)
1015 zfcp_erp_adapter_access_changed(adapter);
1016 break;
1018 case FSF_STATUS_READ_CFDC_UPDATED:
1019 ZFCP_LOG_NORMAL("CFDC has been updated on the adapter %s\n",
1020 zfcp_get_busid_by_adapter(adapter));
1021 zfcp_erp_adapter_access_changed(adapter);
1022 break;
1024 case FSF_STATUS_READ_CFDC_HARDENED:
1025 switch (status_buffer->status_subtype) {
1026 case FSF_STATUS_READ_SUB_CFDC_HARDENED_ON_SE:
1027 ZFCP_LOG_NORMAL("CFDC of adapter %s saved on SE\n",
1028 zfcp_get_busid_by_adapter(adapter));
1029 break;
1030 case FSF_STATUS_READ_SUB_CFDC_HARDENED_ON_SE2:
1031 ZFCP_LOG_NORMAL("CFDC of adapter %s has been copied "
1032 "to the secondary SE\n",
1033 zfcp_get_busid_by_adapter(adapter));
1034 break;
1035 default:
1036 ZFCP_LOG_NORMAL("CFDC of adapter %s has been hardened\n",
1037 zfcp_get_busid_by_adapter(adapter));
1039 break;
1041 case FSF_STATUS_READ_FEATURE_UPDATE_ALERT:
1042 debug_text_event(adapter->erp_dbf, 2, "unsol_features:");
1043 ZFCP_LOG_INFO("List of supported features on adapter %s has "
1044 "been changed from 0x%08X to 0x%08X\n",
1045 zfcp_get_busid_by_adapter(adapter),
1046 *(u32*) (status_buffer->payload + 4),
1047 *(u32*) (status_buffer->payload));
1048 adapter->adapter_features = *(u32*) status_buffer->payload;
1049 break;
1051 default:
1052 ZFCP_LOG_NORMAL("warning: An unsolicited status packet of unknown "
1053 "type was received (debug info 0x%x)\n",
1054 status_buffer->status_type);
1055 ZFCP_LOG_DEBUG("Dump of status_read_buffer %p:\n",
1056 status_buffer);
1057 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
1058 (char *) status_buffer,
1059 sizeof (struct fsf_status_read_buffer));
1060 break;
1062 mempool_free(status_buffer, adapter->pool.data_status_read);
1063 zfcp_fsf_req_free(fsf_req);
1065 * recycle buffer and start new request repeat until outbound
1066 * queue is empty or adapter shutdown is requested
1069 * FIXME(qdio):
1070 * we may wait in the req_create for 5s during shutdown, so
1071 * qdio_cleanup will have to wait at least that long before returning
1072 * with failure to allow us a proper cleanup under all circumstances
1075 * FIXME:
1076 * allocation failure possible? (Is this code needed?)
1078 retval = zfcp_fsf_status_read(adapter, 0);
1079 if (retval < 0) {
1080 ZFCP_LOG_INFO("Failed to create unsolicited status read "
1081 "request for the adapter %s.\n",
1082 zfcp_get_busid_by_adapter(adapter));
1083 /* temporary fix to avoid status read buffer shortage */
1084 adapter->status_read_failed++;
1085 if ((ZFCP_STATUS_READS_RECOM - adapter->status_read_failed)
1086 < ZFCP_STATUS_READ_FAILED_THRESHOLD) {
1087 ZFCP_LOG_INFO("restart adapter %s due to status read "
1088 "buffer shortage\n",
1089 zfcp_get_busid_by_adapter(adapter));
1090 zfcp_erp_adapter_reopen(adapter, 0);
1093 out:
1094 return retval;
1098 * function: zfcp_fsf_abort_fcp_command
1100 * purpose: tells FSF to abort a running SCSI command
1102 * returns: address of initiated FSF request
1103 * NULL - request could not be initiated
1105 * FIXME(design): should be watched by a timeout !!!
1106 * FIXME(design) shouldn't this be modified to return an int
1107 * also...don't know how though
1109 struct zfcp_fsf_req *
1110 zfcp_fsf_abort_fcp_command(unsigned long old_req_id,
1111 struct zfcp_adapter *adapter,
1112 struct zfcp_unit *unit, int req_flags)
1114 volatile struct qdio_buffer_element *sbale;
1115 struct zfcp_fsf_req *fsf_req = NULL;
1116 unsigned long lock_flags;
1117 int retval = 0;
1119 /* setup new FSF request */
1120 retval = zfcp_fsf_req_create(adapter, FSF_QTCB_ABORT_FCP_CMND,
1121 req_flags, adapter->pool.fsf_req_abort,
1122 &lock_flags, &fsf_req);
1123 if (retval < 0) {
1124 ZFCP_LOG_INFO("error: Failed to create an abort command "
1125 "request for lun 0x%016Lx on port 0x%016Lx "
1126 "on adapter %s.\n",
1127 unit->fcp_lun,
1128 unit->port->wwpn,
1129 zfcp_get_busid_by_adapter(adapter));
1130 goto out;
1133 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
1134 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
1135 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
1137 fsf_req->data = (unsigned long) unit;
1139 /* set handles of unit and its parent port in QTCB */
1140 fsf_req->qtcb->header.lun_handle = unit->handle;
1141 fsf_req->qtcb->header.port_handle = unit->port->handle;
1143 /* set handle of request which should be aborted */
1144 fsf_req->qtcb->bottom.support.req_handle = (u64) old_req_id;
1146 zfcp_fsf_start_timer(fsf_req, ZFCP_SCSI_ER_TIMEOUT);
1147 retval = zfcp_fsf_req_send(fsf_req);
1148 if (retval) {
1149 ZFCP_LOG_INFO("error: Failed to send abort command request "
1150 "on adapter %s, port 0x%016Lx, unit 0x%016Lx\n",
1151 zfcp_get_busid_by_adapter(adapter),
1152 unit->port->wwpn, unit->fcp_lun);
1153 zfcp_fsf_req_free(fsf_req);
1154 fsf_req = NULL;
1155 goto out;
1158 ZFCP_LOG_DEBUG("Abort FCP Command request initiated "
1159 "(adapter%s, port d_id=0x%06x, "
1160 "unit x%016Lx, old_req_id=0x%lx)\n",
1161 zfcp_get_busid_by_adapter(adapter),
1162 unit->port->d_id,
1163 unit->fcp_lun, old_req_id);
1164 out:
1165 write_unlock_irqrestore(&adapter->request_queue.queue_lock, lock_flags);
1166 return fsf_req;
1170 * function: zfcp_fsf_abort_fcp_command_handler
1172 * purpose: is called for finished Abort FCP Command request
1174 * returns:
1176 static int
1177 zfcp_fsf_abort_fcp_command_handler(struct zfcp_fsf_req *new_fsf_req)
1179 int retval = -EINVAL;
1180 struct zfcp_unit *unit;
1181 unsigned char status_qual =
1182 new_fsf_req->qtcb->header.fsf_status_qual.word[0];
1184 if (new_fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR) {
1185 /* do not set ZFCP_STATUS_FSFREQ_ABORTSUCCEEDED */
1186 goto skip_fsfstatus;
1189 unit = (struct zfcp_unit *) new_fsf_req->data;
1191 /* evaluate FSF status in QTCB */
1192 switch (new_fsf_req->qtcb->header.fsf_status) {
1194 case FSF_PORT_HANDLE_NOT_VALID:
1195 if (status_qual >> 4 != status_qual % 0xf) {
1196 debug_text_event(new_fsf_req->adapter->erp_dbf, 3,
1197 "fsf_s_phand_nv0");
1199 * In this case a command that was sent prior to a port
1200 * reopen was aborted (handles are different). This is
1201 * fine.
1203 } else {
1204 ZFCP_LOG_INFO("Temporary port identifier 0x%x for "
1205 "port 0x%016Lx on adapter %s invalid. "
1206 "This may happen occasionally.\n",
1207 unit->port->handle,
1208 unit->port->wwpn,
1209 zfcp_get_busid_by_unit(unit));
1210 ZFCP_LOG_INFO("status qualifier:\n");
1211 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_INFO,
1212 (char *) &new_fsf_req->qtcb->header.
1213 fsf_status_qual,
1214 sizeof (union fsf_status_qual));
1215 /* Let's hope this sorts out the mess */
1216 debug_text_event(new_fsf_req->adapter->erp_dbf, 1,
1217 "fsf_s_phand_nv1");
1218 zfcp_erp_adapter_reopen(unit->port->adapter, 0);
1219 new_fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1221 break;
1223 case FSF_LUN_HANDLE_NOT_VALID:
1224 if (status_qual >> 4 != status_qual % 0xf) {
1225 /* 2 */
1226 debug_text_event(new_fsf_req->adapter->erp_dbf, 3,
1227 "fsf_s_lhand_nv0");
1229 * In this case a command that was sent prior to a unit
1230 * reopen was aborted (handles are different).
1231 * This is fine.
1233 } else {
1234 ZFCP_LOG_INFO
1235 ("Warning: Temporary LUN identifier 0x%x of LUN "
1236 "0x%016Lx on port 0x%016Lx on adapter %s is "
1237 "invalid. This may happen in rare cases. "
1238 "Trying to re-establish link.\n",
1239 unit->handle,
1240 unit->fcp_lun,
1241 unit->port->wwpn,
1242 zfcp_get_busid_by_unit(unit));
1243 ZFCP_LOG_DEBUG("Status qualifier data:\n");
1244 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
1245 (char *) &new_fsf_req->qtcb->header.
1246 fsf_status_qual,
1247 sizeof (union fsf_status_qual));
1248 /* Let's hope this sorts out the mess */
1249 debug_text_event(new_fsf_req->adapter->erp_dbf, 1,
1250 "fsf_s_lhand_nv1");
1251 zfcp_erp_port_reopen(unit->port, 0);
1252 new_fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1254 break;
1256 case FSF_FCP_COMMAND_DOES_NOT_EXIST:
1257 retval = 0;
1258 debug_text_event(new_fsf_req->adapter->erp_dbf, 3,
1259 "fsf_s_no_exist");
1260 new_fsf_req->status |= ZFCP_STATUS_FSFREQ_ABORTNOTNEEDED;
1261 break;
1263 case FSF_PORT_BOXED:
1264 ZFCP_LOG_INFO("Remote port 0x%016Lx on adapter %s needs to "
1265 "be reopened\n", unit->port->wwpn,
1266 zfcp_get_busid_by_unit(unit));
1267 debug_text_event(new_fsf_req->adapter->erp_dbf, 2,
1268 "fsf_s_pboxed");
1269 zfcp_erp_port_boxed(unit->port);
1270 new_fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR
1271 | ZFCP_STATUS_FSFREQ_RETRY;
1272 break;
1274 case FSF_LUN_BOXED:
1275 ZFCP_LOG_INFO(
1276 "unit 0x%016Lx on port 0x%016Lx on adapter %s needs "
1277 "to be reopened\n",
1278 unit->fcp_lun, unit->port->wwpn,
1279 zfcp_get_busid_by_unit(unit));
1280 debug_text_event(new_fsf_req->adapter->erp_dbf, 1, "fsf_s_lboxed");
1281 zfcp_erp_unit_boxed(unit);
1282 new_fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR
1283 | ZFCP_STATUS_FSFREQ_RETRY;
1284 break;
1286 case FSF_ADAPTER_STATUS_AVAILABLE:
1287 switch (new_fsf_req->qtcb->header.fsf_status_qual.word[0]) {
1288 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
1289 debug_text_event(new_fsf_req->adapter->erp_dbf, 1,
1290 "fsf_sq_ltest");
1291 zfcp_test_link(unit->port);
1292 new_fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1293 break;
1294 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
1295 /* SCSI stack will escalate */
1296 debug_text_event(new_fsf_req->adapter->erp_dbf, 1,
1297 "fsf_sq_ulp");
1298 new_fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1299 break;
1300 default:
1301 ZFCP_LOG_NORMAL
1302 ("bug: Wrong status qualifier 0x%x arrived.\n",
1303 new_fsf_req->qtcb->header.fsf_status_qual.word[0]);
1304 debug_text_event(new_fsf_req->adapter->erp_dbf, 0,
1305 "fsf_sq_inval:");
1306 debug_exception(new_fsf_req->adapter->erp_dbf, 0,
1307 &new_fsf_req->qtcb->header.
1308 fsf_status_qual.word[0], sizeof (u32));
1309 break;
1311 break;
1313 case FSF_GOOD:
1314 retval = 0;
1315 new_fsf_req->status |= ZFCP_STATUS_FSFREQ_ABORTSUCCEEDED;
1316 break;
1318 default:
1319 ZFCP_LOG_NORMAL("bug: An unknown FSF Status was presented "
1320 "(debug info 0x%x)\n",
1321 new_fsf_req->qtcb->header.fsf_status);
1322 debug_text_event(new_fsf_req->adapter->erp_dbf, 0,
1323 "fsf_s_inval:");
1324 debug_exception(new_fsf_req->adapter->erp_dbf, 0,
1325 &new_fsf_req->qtcb->header.fsf_status,
1326 sizeof (u32));
1327 break;
1329 skip_fsfstatus:
1330 return retval;
1334 * zfcp_use_one_sbal - checks whether req buffer and resp bother each fit into
1335 * one SBALE
1336 * Two scatter-gather lists are passed, one for the reqeust and one for the
1337 * response.
1339 static inline int
1340 zfcp_use_one_sbal(struct scatterlist *req, int req_count,
1341 struct scatterlist *resp, int resp_count)
1343 return ((req_count == 1) &&
1344 (resp_count == 1) &&
1345 (((unsigned long) zfcp_sg_to_address(&req[0]) &
1346 PAGE_MASK) ==
1347 ((unsigned long) (zfcp_sg_to_address(&req[0]) +
1348 req[0].length - 1) & PAGE_MASK)) &&
1349 (((unsigned long) zfcp_sg_to_address(&resp[0]) &
1350 PAGE_MASK) ==
1351 ((unsigned long) (zfcp_sg_to_address(&resp[0]) +
1352 resp[0].length - 1) & PAGE_MASK)));
1356 * zfcp_fsf_send_ct - initiate a Generic Service request (FC-GS)
1357 * @ct: pointer to struct zfcp_send_ct which conatins all needed data for
1358 * the request
1359 * @pool: pointer to memory pool, if non-null this pool is used to allocate
1360 * a struct zfcp_fsf_req
1361 * @erp_action: pointer to erp_action, if non-null the Generic Service request
1362 * is sent within error recovery
1365 zfcp_fsf_send_ct(struct zfcp_send_ct *ct, mempool_t *pool,
1366 struct zfcp_erp_action *erp_action)
1368 volatile struct qdio_buffer_element *sbale;
1369 struct zfcp_port *port;
1370 struct zfcp_adapter *adapter;
1371 struct zfcp_fsf_req *fsf_req;
1372 unsigned long lock_flags;
1373 int bytes;
1374 int ret = 0;
1376 port = ct->port;
1377 adapter = port->adapter;
1379 ret = zfcp_fsf_req_create(adapter, FSF_QTCB_SEND_GENERIC,
1380 ZFCP_WAIT_FOR_SBAL | ZFCP_REQ_AUTO_CLEANUP,
1381 pool, &lock_flags, &fsf_req);
1382 if (ret < 0) {
1383 ZFCP_LOG_INFO("error: Could not create CT request (FC-GS) for "
1384 "adapter: %s\n",
1385 zfcp_get_busid_by_adapter(adapter));
1386 goto failed_req;
1389 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
1390 if (zfcp_use_one_sbal(ct->req, ct->req_count,
1391 ct->resp, ct->resp_count)){
1392 /* both request buffer and response buffer
1393 fit into one sbale each */
1394 sbale[0].flags |= SBAL_FLAGS0_TYPE_WRITE_READ;
1395 sbale[2].addr = zfcp_sg_to_address(&ct->req[0]);
1396 sbale[2].length = ct->req[0].length;
1397 sbale[3].addr = zfcp_sg_to_address(&ct->resp[0]);
1398 sbale[3].length = ct->resp[0].length;
1399 sbale[3].flags |= SBAL_FLAGS_LAST_ENTRY;
1400 } else if (adapter->adapter_features &
1401 FSF_FEATURE_ELS_CT_CHAINED_SBALS) {
1402 /* try to use chained SBALs */
1403 bytes = zfcp_qdio_sbals_from_sg(fsf_req,
1404 SBAL_FLAGS0_TYPE_WRITE_READ,
1405 ct->req, ct->req_count,
1406 ZFCP_MAX_SBALS_PER_CT_REQ);
1407 if (bytes <= 0) {
1408 ZFCP_LOG_INFO("error: creation of CT request failed "
1409 "on adapter %s\n",
1410 zfcp_get_busid_by_adapter(adapter));
1411 if (bytes == 0)
1412 ret = -ENOMEM;
1413 else
1414 ret = bytes;
1416 goto failed_send;
1418 fsf_req->qtcb->bottom.support.req_buf_length = bytes;
1419 fsf_req->sbale_curr = ZFCP_LAST_SBALE_PER_SBAL;
1420 bytes = zfcp_qdio_sbals_from_sg(fsf_req,
1421 SBAL_FLAGS0_TYPE_WRITE_READ,
1422 ct->resp, ct->resp_count,
1423 ZFCP_MAX_SBALS_PER_CT_REQ);
1424 if (bytes <= 0) {
1425 ZFCP_LOG_INFO("error: creation of CT request failed "
1426 "on adapter %s\n",
1427 zfcp_get_busid_by_adapter(adapter));
1428 if (bytes == 0)
1429 ret = -ENOMEM;
1430 else
1431 ret = bytes;
1433 goto failed_send;
1435 fsf_req->qtcb->bottom.support.resp_buf_length = bytes;
1436 } else {
1437 /* reject send generic request */
1438 ZFCP_LOG_INFO(
1439 "error: microcode does not support chained SBALs,"
1440 "CT request too big (adapter %s)\n",
1441 zfcp_get_busid_by_adapter(adapter));
1442 ret = -EOPNOTSUPP;
1443 goto failed_send;
1446 /* settings in QTCB */
1447 fsf_req->qtcb->header.port_handle = port->handle;
1448 fsf_req->qtcb->bottom.support.service_class =
1449 ZFCP_FC_SERVICE_CLASS_DEFAULT;
1450 fsf_req->qtcb->bottom.support.timeout = ct->timeout;
1451 fsf_req->data = (unsigned long) ct;
1453 zfcp_san_dbf_event_ct_request(fsf_req);
1455 if (erp_action) {
1456 erp_action->fsf_req = fsf_req;
1457 fsf_req->erp_action = erp_action;
1458 zfcp_erp_start_timer(fsf_req);
1459 } else
1460 zfcp_fsf_start_timer(fsf_req, ZFCP_FSF_REQUEST_TIMEOUT);
1462 ret = zfcp_fsf_req_send(fsf_req);
1463 if (ret) {
1464 ZFCP_LOG_DEBUG("error: initiation of CT request failed "
1465 "(adapter %s, port 0x%016Lx)\n",
1466 zfcp_get_busid_by_adapter(adapter), port->wwpn);
1467 goto failed_send;
1470 ZFCP_LOG_DEBUG("CT request initiated (adapter %s, port 0x%016Lx)\n",
1471 zfcp_get_busid_by_adapter(adapter), port->wwpn);
1472 goto out;
1474 failed_send:
1475 zfcp_fsf_req_free(fsf_req);
1476 if (erp_action != NULL) {
1477 erp_action->fsf_req = NULL;
1479 failed_req:
1480 out:
1481 write_unlock_irqrestore(&adapter->request_queue.queue_lock,
1482 lock_flags);
1483 return ret;
1487 * zfcp_fsf_send_ct_handler - handler for Generic Service requests
1488 * @fsf_req: pointer to struct zfcp_fsf_req
1490 * Data specific for the Generic Service request is passed using
1491 * fsf_req->data. There we find the pointer to struct zfcp_send_ct.
1492 * Usually a specific handler for the CT request is called which is
1493 * found in this structure.
1495 static int
1496 zfcp_fsf_send_ct_handler(struct zfcp_fsf_req *fsf_req)
1498 struct zfcp_port *port;
1499 struct zfcp_adapter *adapter;
1500 struct zfcp_send_ct *send_ct;
1501 struct fsf_qtcb_header *header;
1502 struct fsf_qtcb_bottom_support *bottom;
1503 int retval = -EINVAL;
1504 u16 subtable, rule, counter;
1506 adapter = fsf_req->adapter;
1507 send_ct = (struct zfcp_send_ct *) fsf_req->data;
1508 port = send_ct->port;
1509 header = &fsf_req->qtcb->header;
1510 bottom = &fsf_req->qtcb->bottom.support;
1512 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR)
1513 goto skip_fsfstatus;
1515 /* evaluate FSF status in QTCB */
1516 switch (header->fsf_status) {
1518 case FSF_GOOD:
1519 zfcp_san_dbf_event_ct_response(fsf_req);
1520 retval = 0;
1521 break;
1523 case FSF_SERVICE_CLASS_NOT_SUPPORTED:
1524 ZFCP_LOG_INFO("error: adapter %s does not support fc "
1525 "class %d.\n",
1526 zfcp_get_busid_by_port(port),
1527 ZFCP_FC_SERVICE_CLASS_DEFAULT);
1528 /* stop operation for this adapter */
1529 debug_text_exception(adapter->erp_dbf, 0, "fsf_s_class_nsup");
1530 zfcp_erp_adapter_shutdown(adapter, 0);
1531 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1532 break;
1534 case FSF_ADAPTER_STATUS_AVAILABLE:
1535 switch (header->fsf_status_qual.word[0]){
1536 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
1537 /* reopening link to port */
1538 debug_text_event(adapter->erp_dbf, 1, "fsf_sq_ltest");
1539 zfcp_test_link(port);
1540 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1541 break;
1542 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
1543 /* ERP strategy will escalate */
1544 debug_text_event(adapter->erp_dbf, 1, "fsf_sq_ulp");
1545 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1546 break;
1547 default:
1548 ZFCP_LOG_INFO("bug: Wrong status qualifier 0x%x "
1549 "arrived.\n",
1550 header->fsf_status_qual.word[0]);
1551 break;
1553 break;
1555 case FSF_ACCESS_DENIED:
1556 ZFCP_LOG_NORMAL("access denied, cannot send generic service "
1557 "command (adapter %s, port d_id=0x%06x)\n",
1558 zfcp_get_busid_by_port(port), port->d_id);
1559 for (counter = 0; counter < 2; counter++) {
1560 subtable = header->fsf_status_qual.halfword[counter * 2];
1561 rule = header->fsf_status_qual.halfword[counter * 2 + 1];
1562 switch (subtable) {
1563 case FSF_SQ_CFDC_SUBTABLE_OS:
1564 case FSF_SQ_CFDC_SUBTABLE_PORT_WWPN:
1565 case FSF_SQ_CFDC_SUBTABLE_PORT_DID:
1566 case FSF_SQ_CFDC_SUBTABLE_LUN:
1567 ZFCP_LOG_INFO("Access denied (%s rule %d)\n",
1568 zfcp_act_subtable_type[subtable], rule);
1569 break;
1572 debug_text_event(adapter->erp_dbf, 1, "fsf_s_access");
1573 zfcp_erp_port_access_denied(port);
1574 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1575 break;
1577 case FSF_GENERIC_COMMAND_REJECTED:
1578 ZFCP_LOG_INFO("generic service command rejected "
1579 "(adapter %s, port d_id=0x%06x)\n",
1580 zfcp_get_busid_by_port(port), port->d_id);
1581 ZFCP_LOG_INFO("status qualifier:\n");
1582 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_INFO,
1583 (char *) &header->fsf_status_qual,
1584 sizeof (union fsf_status_qual));
1585 debug_text_event(adapter->erp_dbf, 1, "fsf_s_gcom_rej");
1586 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1587 break;
1589 case FSF_PORT_HANDLE_NOT_VALID:
1590 ZFCP_LOG_DEBUG("Temporary port identifier 0x%x for port "
1591 "0x%016Lx on adapter %s invalid. This may "
1592 "happen occasionally.\n", port->handle,
1593 port->wwpn, zfcp_get_busid_by_port(port));
1594 ZFCP_LOG_INFO("status qualifier:\n");
1595 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_INFO,
1596 (char *) &header->fsf_status_qual,
1597 sizeof (union fsf_status_qual));
1598 debug_text_event(adapter->erp_dbf, 1, "fsf_s_phandle_nv");
1599 zfcp_erp_adapter_reopen(adapter, 0);
1600 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1601 break;
1603 case FSF_PORT_BOXED:
1604 ZFCP_LOG_INFO("port needs to be reopened "
1605 "(adapter %s, port d_id=0x%06x)\n",
1606 zfcp_get_busid_by_port(port), port->d_id);
1607 debug_text_event(adapter->erp_dbf, 2, "fsf_s_pboxed");
1608 zfcp_erp_port_boxed(port);
1609 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR
1610 | ZFCP_STATUS_FSFREQ_RETRY;
1611 break;
1613 /* following states should never occure, all cases avoided
1614 in zfcp_fsf_send_ct - but who knows ... */
1615 case FSF_PAYLOAD_SIZE_MISMATCH:
1616 ZFCP_LOG_INFO("payload size mismatch (adapter: %s, "
1617 "req_buf_length=%d, resp_buf_length=%d)\n",
1618 zfcp_get_busid_by_adapter(adapter),
1619 bottom->req_buf_length, bottom->resp_buf_length);
1620 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1621 break;
1622 case FSF_REQUEST_SIZE_TOO_LARGE:
1623 ZFCP_LOG_INFO("request size too large (adapter: %s, "
1624 "req_buf_length=%d)\n",
1625 zfcp_get_busid_by_adapter(adapter),
1626 bottom->req_buf_length);
1627 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1628 break;
1629 case FSF_RESPONSE_SIZE_TOO_LARGE:
1630 ZFCP_LOG_INFO("response size too large (adapter: %s, "
1631 "resp_buf_length=%d)\n",
1632 zfcp_get_busid_by_adapter(adapter),
1633 bottom->resp_buf_length);
1634 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1635 break;
1636 case FSF_SBAL_MISMATCH:
1637 ZFCP_LOG_INFO("SBAL mismatch (adapter: %s, req_buf_length=%d, "
1638 "resp_buf_length=%d)\n",
1639 zfcp_get_busid_by_adapter(adapter),
1640 bottom->req_buf_length, bottom->resp_buf_length);
1641 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1642 break;
1644 default:
1645 ZFCP_LOG_NORMAL("bug: An unknown FSF Status was presented "
1646 "(debug info 0x%x)\n", header->fsf_status);
1647 debug_text_event(adapter->erp_dbf, 0, "fsf_sq_inval:");
1648 debug_exception(adapter->erp_dbf, 0,
1649 &header->fsf_status_qual.word[0], sizeof (u32));
1650 break;
1653 skip_fsfstatus:
1654 send_ct->status = retval;
1656 if (send_ct->handler != NULL)
1657 send_ct->handler(send_ct->handler_data);
1659 return retval;
1663 * zfcp_fsf_send_els - initiate an ELS command (FC-FS)
1664 * @els: pointer to struct zfcp_send_els which contains all needed data for
1665 * the command.
1668 zfcp_fsf_send_els(struct zfcp_send_els *els)
1670 volatile struct qdio_buffer_element *sbale;
1671 struct zfcp_fsf_req *fsf_req;
1672 u32 d_id;
1673 struct zfcp_adapter *adapter;
1674 unsigned long lock_flags;
1675 int bytes;
1676 int ret = 0;
1678 d_id = els->d_id;
1679 adapter = els->adapter;
1681 ret = zfcp_fsf_req_create(adapter, FSF_QTCB_SEND_ELS,
1682 ZFCP_REQ_AUTO_CLEANUP,
1683 NULL, &lock_flags, &fsf_req);
1684 if (ret < 0) {
1685 ZFCP_LOG_INFO("error: creation of ELS request failed "
1686 "(adapter %s, port d_id: 0x%06x)\n",
1687 zfcp_get_busid_by_adapter(adapter), d_id);
1688 goto failed_req;
1691 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
1692 if (zfcp_use_one_sbal(els->req, els->req_count,
1693 els->resp, els->resp_count)){
1694 /* both request buffer and response buffer
1695 fit into one sbale each */
1696 sbale[0].flags |= SBAL_FLAGS0_TYPE_WRITE_READ;
1697 sbale[2].addr = zfcp_sg_to_address(&els->req[0]);
1698 sbale[2].length = els->req[0].length;
1699 sbale[3].addr = zfcp_sg_to_address(&els->resp[0]);
1700 sbale[3].length = els->resp[0].length;
1701 sbale[3].flags |= SBAL_FLAGS_LAST_ENTRY;
1702 } else if (adapter->adapter_features &
1703 FSF_FEATURE_ELS_CT_CHAINED_SBALS) {
1704 /* try to use chained SBALs */
1705 bytes = zfcp_qdio_sbals_from_sg(fsf_req,
1706 SBAL_FLAGS0_TYPE_WRITE_READ,
1707 els->req, els->req_count,
1708 ZFCP_MAX_SBALS_PER_ELS_REQ);
1709 if (bytes <= 0) {
1710 ZFCP_LOG_INFO("error: creation of ELS request failed "
1711 "(adapter %s, port d_id: 0x%06x)\n",
1712 zfcp_get_busid_by_adapter(adapter), d_id);
1713 if (bytes == 0) {
1714 ret = -ENOMEM;
1715 } else {
1716 ret = bytes;
1718 goto failed_send;
1720 fsf_req->qtcb->bottom.support.req_buf_length = bytes;
1721 fsf_req->sbale_curr = ZFCP_LAST_SBALE_PER_SBAL;
1722 bytes = zfcp_qdio_sbals_from_sg(fsf_req,
1723 SBAL_FLAGS0_TYPE_WRITE_READ,
1724 els->resp, els->resp_count,
1725 ZFCP_MAX_SBALS_PER_ELS_REQ);
1726 if (bytes <= 0) {
1727 ZFCP_LOG_INFO("error: creation of ELS request failed "
1728 "(adapter %s, port d_id: 0x%06x)\n",
1729 zfcp_get_busid_by_adapter(adapter), d_id);
1730 if (bytes == 0) {
1731 ret = -ENOMEM;
1732 } else {
1733 ret = bytes;
1735 goto failed_send;
1737 fsf_req->qtcb->bottom.support.resp_buf_length = bytes;
1738 } else {
1739 /* reject request */
1740 ZFCP_LOG_INFO("error: microcode does not support chained SBALs"
1741 ", ELS request too big (adapter %s, "
1742 "port d_id: 0x%06x)\n",
1743 zfcp_get_busid_by_adapter(adapter), d_id);
1744 ret = -EOPNOTSUPP;
1745 goto failed_send;
1748 /* settings in QTCB */
1749 fsf_req->qtcb->bottom.support.d_id = d_id;
1750 fsf_req->qtcb->bottom.support.service_class =
1751 ZFCP_FC_SERVICE_CLASS_DEFAULT;
1752 fsf_req->qtcb->bottom.support.timeout = ZFCP_ELS_TIMEOUT;
1753 fsf_req->data = (unsigned long) els;
1755 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
1757 zfcp_san_dbf_event_els_request(fsf_req);
1759 zfcp_fsf_start_timer(fsf_req, ZFCP_FSF_REQUEST_TIMEOUT);
1760 ret = zfcp_fsf_req_send(fsf_req);
1761 if (ret) {
1762 ZFCP_LOG_DEBUG("error: initiation of ELS request failed "
1763 "(adapter %s, port d_id: 0x%06x)\n",
1764 zfcp_get_busid_by_adapter(adapter), d_id);
1765 goto failed_send;
1768 ZFCP_LOG_DEBUG("ELS request initiated (adapter %s, port d_id: "
1769 "0x%06x)\n", zfcp_get_busid_by_adapter(adapter), d_id);
1770 goto out;
1772 failed_send:
1773 zfcp_fsf_req_free(fsf_req);
1775 failed_req:
1776 out:
1777 write_unlock_irqrestore(&adapter->request_queue.queue_lock,
1778 lock_flags);
1780 return ret;
1784 * zfcp_fsf_send_els_handler - handler for ELS commands
1785 * @fsf_req: pointer to struct zfcp_fsf_req
1787 * Data specific for the ELS command is passed using
1788 * fsf_req->data. There we find the pointer to struct zfcp_send_els.
1789 * Usually a specific handler for the ELS command is called which is
1790 * found in this structure.
1792 static int zfcp_fsf_send_els_handler(struct zfcp_fsf_req *fsf_req)
1794 struct zfcp_adapter *adapter;
1795 struct zfcp_port *port;
1796 u32 d_id;
1797 struct fsf_qtcb_header *header;
1798 struct fsf_qtcb_bottom_support *bottom;
1799 struct zfcp_send_els *send_els;
1800 int retval = -EINVAL;
1801 u16 subtable, rule, counter;
1803 send_els = (struct zfcp_send_els *) fsf_req->data;
1804 adapter = send_els->adapter;
1805 port = send_els->port;
1806 d_id = send_els->d_id;
1807 header = &fsf_req->qtcb->header;
1808 bottom = &fsf_req->qtcb->bottom.support;
1810 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR)
1811 goto skip_fsfstatus;
1813 switch (header->fsf_status) {
1815 case FSF_GOOD:
1816 zfcp_san_dbf_event_els_response(fsf_req);
1817 retval = 0;
1818 break;
1820 case FSF_SERVICE_CLASS_NOT_SUPPORTED:
1821 ZFCP_LOG_INFO("error: adapter %s does not support fc "
1822 "class %d.\n",
1823 zfcp_get_busid_by_adapter(adapter),
1824 ZFCP_FC_SERVICE_CLASS_DEFAULT);
1825 /* stop operation for this adapter */
1826 debug_text_exception(adapter->erp_dbf, 0, "fsf_s_class_nsup");
1827 zfcp_erp_adapter_shutdown(adapter, 0);
1828 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1829 break;
1831 case FSF_ADAPTER_STATUS_AVAILABLE:
1832 switch (header->fsf_status_qual.word[0]){
1833 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
1834 debug_text_event(adapter->erp_dbf, 1, "fsf_sq_ltest");
1835 if (port && (send_els->ls_code != ZFCP_LS_ADISC))
1836 zfcp_test_link(port);
1837 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1838 break;
1839 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
1840 debug_text_event(adapter->erp_dbf, 1, "fsf_sq_ulp");
1841 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1842 retval =
1843 zfcp_handle_els_rjt(header->fsf_status_qual.word[1],
1844 (struct zfcp_ls_rjt_par *)
1845 &header->fsf_status_qual.word[2]);
1846 break;
1847 case FSF_SQ_RETRY_IF_POSSIBLE:
1848 debug_text_event(adapter->erp_dbf, 1, "fsf_sq_retry");
1849 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1850 break;
1851 default:
1852 ZFCP_LOG_INFO("bug: Wrong status qualifier 0x%x\n",
1853 header->fsf_status_qual.word[0]);
1854 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_INFO,
1855 (char*)header->fsf_status_qual.word, 16);
1857 break;
1859 case FSF_ELS_COMMAND_REJECTED:
1860 ZFCP_LOG_INFO("ELS has been rejected because command filter "
1861 "prohibited sending "
1862 "(adapter: %s, port d_id: 0x%06x)\n",
1863 zfcp_get_busid_by_adapter(adapter), d_id);
1865 break;
1867 case FSF_PAYLOAD_SIZE_MISMATCH:
1868 ZFCP_LOG_INFO(
1869 "ELS request size and ELS response size must be either "
1870 "both 0, or both greater than 0 "
1871 "(adapter: %s, req_buf_length=%d resp_buf_length=%d)\n",
1872 zfcp_get_busid_by_adapter(adapter),
1873 bottom->req_buf_length,
1874 bottom->resp_buf_length);
1875 break;
1877 case FSF_REQUEST_SIZE_TOO_LARGE:
1878 ZFCP_LOG_INFO(
1879 "Length of the ELS request buffer, "
1880 "specified in QTCB bottom, "
1881 "exceeds the size of the buffers "
1882 "that have been allocated for ELS request data "
1883 "(adapter: %s, req_buf_length=%d)\n",
1884 zfcp_get_busid_by_adapter(adapter),
1885 bottom->req_buf_length);
1886 break;
1888 case FSF_RESPONSE_SIZE_TOO_LARGE:
1889 ZFCP_LOG_INFO(
1890 "Length of the ELS response buffer, "
1891 "specified in QTCB bottom, "
1892 "exceeds the size of the buffers "
1893 "that have been allocated for ELS response data "
1894 "(adapter: %s, resp_buf_length=%d)\n",
1895 zfcp_get_busid_by_adapter(adapter),
1896 bottom->resp_buf_length);
1897 break;
1899 case FSF_SBAL_MISMATCH:
1900 /* should never occure, avoided in zfcp_fsf_send_els */
1901 ZFCP_LOG_INFO("SBAL mismatch (adapter: %s, req_buf_length=%d, "
1902 "resp_buf_length=%d)\n",
1903 zfcp_get_busid_by_adapter(adapter),
1904 bottom->req_buf_length, bottom->resp_buf_length);
1905 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1906 break;
1908 case FSF_ACCESS_DENIED:
1909 ZFCP_LOG_NORMAL("access denied, cannot send ELS command "
1910 "(adapter %s, port d_id=0x%06x)\n",
1911 zfcp_get_busid_by_adapter(adapter), d_id);
1912 for (counter = 0; counter < 2; counter++) {
1913 subtable = header->fsf_status_qual.halfword[counter * 2];
1914 rule = header->fsf_status_qual.halfword[counter * 2 + 1];
1915 switch (subtable) {
1916 case FSF_SQ_CFDC_SUBTABLE_OS:
1917 case FSF_SQ_CFDC_SUBTABLE_PORT_WWPN:
1918 case FSF_SQ_CFDC_SUBTABLE_PORT_DID:
1919 case FSF_SQ_CFDC_SUBTABLE_LUN:
1920 ZFCP_LOG_INFO("Access denied (%s rule %d)\n",
1921 zfcp_act_subtable_type[subtable], rule);
1922 break;
1925 debug_text_event(adapter->erp_dbf, 1, "fsf_s_access");
1926 if (port != NULL)
1927 zfcp_erp_port_access_denied(port);
1928 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1929 break;
1931 default:
1932 ZFCP_LOG_NORMAL(
1933 "bug: An unknown FSF Status was presented "
1934 "(adapter: %s, fsf_status=0x%08x)\n",
1935 zfcp_get_busid_by_adapter(adapter),
1936 header->fsf_status);
1937 debug_text_event(adapter->erp_dbf, 0, "fsf_sq_inval");
1938 debug_exception(adapter->erp_dbf, 0,
1939 &header->fsf_status_qual.word[0], sizeof(u32));
1940 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1941 break;
1944 skip_fsfstatus:
1945 send_els->status = retval;
1947 if (send_els->handler != 0)
1948 send_els->handler(send_els->handler_data);
1950 return retval;
1954 zfcp_fsf_exchange_config_data(struct zfcp_erp_action *erp_action)
1956 volatile struct qdio_buffer_element *sbale;
1957 struct zfcp_fsf_req *fsf_req;
1958 unsigned long lock_flags;
1959 int retval = 0;
1961 /* setup new FSF request */
1962 retval = zfcp_fsf_req_create(erp_action->adapter,
1963 FSF_QTCB_EXCHANGE_CONFIG_DATA,
1964 ZFCP_REQ_AUTO_CLEANUP,
1965 erp_action->adapter->pool.fsf_req_erp,
1966 &lock_flags, &fsf_req);
1967 if (retval < 0) {
1968 ZFCP_LOG_INFO("error: Could not create exchange configuration "
1969 "data request for adapter %s.\n",
1970 zfcp_get_busid_by_adapter(erp_action->adapter));
1971 goto out;
1974 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
1975 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
1976 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
1978 fsf_req->qtcb->bottom.config.feature_selection =
1979 FSF_FEATURE_CFDC |
1980 FSF_FEATURE_LUN_SHARING |
1981 FSF_FEATURE_NOTIFICATION_LOST |
1982 FSF_FEATURE_UPDATE_ALERT;
1983 fsf_req->erp_action = erp_action;
1984 erp_action->fsf_req = fsf_req;
1986 zfcp_erp_start_timer(fsf_req);
1987 retval = zfcp_fsf_req_send(fsf_req);
1988 if (retval) {
1989 ZFCP_LOG_INFO
1990 ("error: Could not send exchange configuration data "
1991 "command on the adapter %s\n",
1992 zfcp_get_busid_by_adapter(erp_action->adapter));
1993 zfcp_fsf_req_free(fsf_req);
1994 erp_action->fsf_req = NULL;
1995 goto out;
1998 ZFCP_LOG_DEBUG("exchange configuration data request initiated "
1999 "(adapter %s)\n",
2000 zfcp_get_busid_by_adapter(erp_action->adapter));
2002 out:
2003 write_unlock_irqrestore(&erp_action->adapter->request_queue.queue_lock,
2004 lock_flags);
2005 return retval;
2009 * zfcp_fsf_exchange_config_evaluate
2010 * @fsf_req: fsf_req which belongs to xchg config data request
2011 * @xchg_ok: specifies if xchg config data was incomplete or complete (0/1)
2013 * returns: -EIO on error, 0 otherwise
2015 static int
2016 zfcp_fsf_exchange_config_evaluate(struct zfcp_fsf_req *fsf_req, int xchg_ok)
2018 struct fsf_qtcb_bottom_config *bottom;
2019 struct zfcp_adapter *adapter = fsf_req->adapter;
2020 struct Scsi_Host *shost = adapter->scsi_host;
2022 bottom = &fsf_req->qtcb->bottom.config;
2023 ZFCP_LOG_DEBUG("low/high QTCB version 0x%x/0x%x of FSF\n",
2024 bottom->low_qtcb_version, bottom->high_qtcb_version);
2025 adapter->fsf_lic_version = bottom->lic_version;
2026 adapter->adapter_features = bottom->adapter_features;
2027 adapter->connection_features = bottom->connection_features;
2028 adapter->peer_wwpn = 0;
2029 adapter->peer_wwnn = 0;
2030 adapter->peer_d_id = 0;
2032 if (xchg_ok) {
2033 fc_host_node_name(shost) = bottom->nport_serv_param.wwnn;
2034 fc_host_port_name(shost) = bottom->nport_serv_param.wwpn;
2035 fc_host_port_id(shost) = bottom->s_id & ZFCP_DID_MASK;
2036 fc_host_speed(shost) = bottom->fc_link_speed;
2037 fc_host_supported_classes(shost) = FC_COS_CLASS2 | FC_COS_CLASS3;
2038 adapter->hydra_version = bottom->adapter_type;
2039 if (fc_host_permanent_port_name(shost) == -1)
2040 fc_host_permanent_port_name(shost) =
2041 fc_host_port_name(shost);
2042 if (bottom->fc_topology == FSF_TOPO_P2P) {
2043 adapter->peer_d_id = bottom->peer_d_id & ZFCP_DID_MASK;
2044 adapter->peer_wwpn = bottom->plogi_payload.wwpn;
2045 adapter->peer_wwnn = bottom->plogi_payload.wwnn;
2046 fc_host_port_type(shost) = FC_PORTTYPE_PTP;
2047 } else if (bottom->fc_topology == FSF_TOPO_FABRIC)
2048 fc_host_port_type(shost) = FC_PORTTYPE_NPORT;
2049 else if (bottom->fc_topology == FSF_TOPO_AL)
2050 fc_host_port_type(shost) = FC_PORTTYPE_NLPORT;
2051 else
2052 fc_host_port_type(shost) = FC_PORTTYPE_UNKNOWN;
2053 } else {
2054 fc_host_node_name(shost) = 0;
2055 fc_host_port_name(shost) = 0;
2056 fc_host_port_id(shost) = 0;
2057 fc_host_speed(shost) = FC_PORTSPEED_UNKNOWN;
2058 fc_host_port_type(shost) = FC_PORTTYPE_UNKNOWN;
2059 adapter->hydra_version = 0;
2062 if (adapter->adapter_features & FSF_FEATURE_HBAAPI_MANAGEMENT) {
2063 adapter->hardware_version = bottom->hardware_version;
2064 memcpy(fc_host_serial_number(shost), bottom->serial_number,
2065 min(FC_SERIAL_NUMBER_SIZE, 17));
2066 EBCASC(fc_host_serial_number(shost),
2067 min(FC_SERIAL_NUMBER_SIZE, 17));
2070 ZFCP_LOG_NORMAL("The adapter %s reported the following characteristics:\n"
2071 "WWNN 0x%016Lx, "
2072 "WWPN 0x%016Lx, "
2073 "S_ID 0x%06x,\n"
2074 "adapter version 0x%x, "
2075 "LIC version 0x%x, "
2076 "FC link speed %d Gb/s\n",
2077 zfcp_get_busid_by_adapter(adapter),
2078 (wwn_t) fc_host_node_name(shost),
2079 (wwn_t) fc_host_port_name(shost),
2080 fc_host_port_id(shost),
2081 adapter->hydra_version,
2082 adapter->fsf_lic_version,
2083 fc_host_speed(shost));
2084 if (ZFCP_QTCB_VERSION < bottom->low_qtcb_version) {
2085 ZFCP_LOG_NORMAL("error: the adapter %s "
2086 "only supports newer control block "
2087 "versions in comparison to this device "
2088 "driver (try updated device driver)\n",
2089 zfcp_get_busid_by_adapter(adapter));
2090 debug_text_event(adapter->erp_dbf, 0, "low_qtcb_ver");
2091 zfcp_erp_adapter_shutdown(adapter, 0);
2092 return -EIO;
2094 if (ZFCP_QTCB_VERSION > bottom->high_qtcb_version) {
2095 ZFCP_LOG_NORMAL("error: the adapter %s "
2096 "only supports older control block "
2097 "versions than this device driver uses"
2098 "(consider a microcode upgrade)\n",
2099 zfcp_get_busid_by_adapter(adapter));
2100 debug_text_event(adapter->erp_dbf, 0, "high_qtcb_ver");
2101 zfcp_erp_adapter_shutdown(adapter, 0);
2102 return -EIO;
2104 return 0;
2108 * function: zfcp_fsf_exchange_config_data_handler
2110 * purpose: is called for finished Exchange Configuration Data command
2112 * returns:
2114 static int
2115 zfcp_fsf_exchange_config_data_handler(struct zfcp_fsf_req *fsf_req)
2117 struct fsf_qtcb_bottom_config *bottom;
2118 struct zfcp_adapter *adapter = fsf_req->adapter;
2119 struct fsf_qtcb *qtcb = fsf_req->qtcb;
2121 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR)
2122 return -EIO;
2124 switch (qtcb->header.fsf_status) {
2126 case FSF_GOOD:
2127 if (zfcp_fsf_exchange_config_evaluate(fsf_req, 1))
2128 return -EIO;
2130 switch (fc_host_port_type(adapter->scsi_host)) {
2131 case FC_PORTTYPE_PTP:
2132 ZFCP_LOG_NORMAL("Point-to-Point fibrechannel "
2133 "configuration detected at adapter %s\n"
2134 "Peer WWNN 0x%016llx, "
2135 "peer WWPN 0x%016llx, "
2136 "peer d_id 0x%06x\n",
2137 zfcp_get_busid_by_adapter(adapter),
2138 adapter->peer_wwnn,
2139 adapter->peer_wwpn,
2140 adapter->peer_d_id);
2141 debug_text_event(fsf_req->adapter->erp_dbf, 0,
2142 "top-p-to-p");
2143 break;
2144 case FC_PORTTYPE_NLPORT:
2145 ZFCP_LOG_NORMAL("error: Arbitrated loop fibrechannel "
2146 "topology detected at adapter %s "
2147 "unsupported, shutting down adapter\n",
2148 zfcp_get_busid_by_adapter(adapter));
2149 debug_text_event(fsf_req->adapter->erp_dbf, 0,
2150 "top-al");
2151 zfcp_erp_adapter_shutdown(adapter, 0);
2152 return -EIO;
2153 case FC_PORTTYPE_NPORT:
2154 ZFCP_LOG_NORMAL("Switched fabric fibrechannel "
2155 "network detected at adapter %s.\n",
2156 zfcp_get_busid_by_adapter(adapter));
2157 break;
2158 default:
2159 ZFCP_LOG_NORMAL("bug: The fibrechannel topology "
2160 "reported by the exchange "
2161 "configuration command for "
2162 "the adapter %s is not "
2163 "of a type known to the zfcp "
2164 "driver, shutting down adapter\n",
2165 zfcp_get_busid_by_adapter(adapter));
2166 debug_text_exception(fsf_req->adapter->erp_dbf, 0,
2167 "unknown-topo");
2168 zfcp_erp_adapter_shutdown(adapter, 0);
2169 return -EIO;
2171 bottom = &qtcb->bottom.config;
2172 if (bottom->max_qtcb_size < sizeof(struct fsf_qtcb)) {
2173 ZFCP_LOG_NORMAL("bug: Maximum QTCB size (%d bytes) "
2174 "allowed by the adapter %s "
2175 "is lower than the minimum "
2176 "required by the driver (%ld bytes).\n",
2177 bottom->max_qtcb_size,
2178 zfcp_get_busid_by_adapter(adapter),
2179 sizeof(struct fsf_qtcb));
2180 debug_text_event(fsf_req->adapter->erp_dbf, 0,
2181 "qtcb-size");
2182 debug_event(fsf_req->adapter->erp_dbf, 0,
2183 &bottom->max_qtcb_size, sizeof (u32));
2184 zfcp_erp_adapter_shutdown(adapter, 0);
2185 return -EIO;
2187 atomic_set_mask(ZFCP_STATUS_ADAPTER_XCONFIG_OK,
2188 &adapter->status);
2189 break;
2190 case FSF_EXCHANGE_CONFIG_DATA_INCOMPLETE:
2191 debug_text_event(adapter->erp_dbf, 0, "xchg-inco");
2193 if (zfcp_fsf_exchange_config_evaluate(fsf_req, 0))
2194 return -EIO;
2196 atomic_set_mask(ZFCP_STATUS_ADAPTER_XCONFIG_OK, &adapter->status);
2198 zfcp_fsf_link_down_info_eval(adapter,
2199 &qtcb->header.fsf_status_qual.link_down_info);
2200 break;
2201 default:
2202 debug_text_event(fsf_req->adapter->erp_dbf, 0, "fsf-stat-ng");
2203 debug_event(fsf_req->adapter->erp_dbf, 0,
2204 &fsf_req->qtcb->header.fsf_status, sizeof (u32));
2205 zfcp_erp_adapter_shutdown(adapter, 0);
2206 return -EIO;
2208 return 0;
2212 * zfcp_fsf_exchange_port_data - request information about local port
2213 * @erp_action: ERP action for the adapter for which port data is requested
2214 * @adapter: for which port data is requested
2215 * @data: response to exchange port data request
2218 zfcp_fsf_exchange_port_data(struct zfcp_erp_action *erp_action,
2219 struct zfcp_adapter *adapter,
2220 struct fsf_qtcb_bottom_port *data)
2222 volatile struct qdio_buffer_element *sbale;
2223 struct zfcp_fsf_req *fsf_req;
2224 unsigned long lock_flags;
2225 int retval = 0;
2227 if (!(adapter->adapter_features & FSF_FEATURE_HBAAPI_MANAGEMENT)) {
2228 ZFCP_LOG_INFO("error: exchange port data "
2229 "command not supported by adapter %s\n",
2230 zfcp_get_busid_by_adapter(adapter));
2231 return -EOPNOTSUPP;
2234 /* setup new FSF request */
2235 retval = zfcp_fsf_req_create(adapter, FSF_QTCB_EXCHANGE_PORT_DATA,
2236 erp_action ? ZFCP_REQ_AUTO_CLEANUP : 0,
2237 NULL, &lock_flags, &fsf_req);
2238 if (retval < 0) {
2239 ZFCP_LOG_INFO("error: Out of resources. Could not create an "
2240 "exchange port data request for"
2241 "the adapter %s.\n",
2242 zfcp_get_busid_by_adapter(adapter));
2243 write_unlock_irqrestore(&adapter->request_queue.queue_lock,
2244 lock_flags);
2245 return retval;
2248 if (data)
2249 fsf_req->data = (unsigned long) data;
2251 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
2252 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
2253 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
2255 if (erp_action) {
2256 erp_action->fsf_req = fsf_req;
2257 fsf_req->erp_action = erp_action;
2258 zfcp_erp_start_timer(fsf_req);
2259 } else
2260 zfcp_fsf_start_timer(fsf_req, ZFCP_FSF_REQUEST_TIMEOUT);
2262 retval = zfcp_fsf_req_send(fsf_req);
2263 if (retval) {
2264 ZFCP_LOG_INFO("error: Could not send an exchange port data "
2265 "command on the adapter %s\n",
2266 zfcp_get_busid_by_adapter(adapter));
2267 zfcp_fsf_req_free(fsf_req);
2268 if (erp_action)
2269 erp_action->fsf_req = NULL;
2270 write_unlock_irqrestore(&adapter->request_queue.queue_lock,
2271 lock_flags);
2272 return retval;
2275 write_unlock_irqrestore(&adapter->request_queue.queue_lock, lock_flags);
2277 if (!erp_action) {
2278 wait_event(fsf_req->completion_wq,
2279 fsf_req->status & ZFCP_STATUS_FSFREQ_COMPLETED);
2280 zfcp_fsf_req_free(fsf_req);
2282 return retval;
2286 * zfcp_fsf_exchange_port_evaluate
2287 * @fsf_req: fsf_req which belongs to xchg port data request
2288 * @xchg_ok: specifies if xchg port data was incomplete or complete (0/1)
2290 static void
2291 zfcp_fsf_exchange_port_evaluate(struct zfcp_fsf_req *fsf_req, int xchg_ok)
2293 struct zfcp_adapter *adapter;
2294 struct fsf_qtcb *qtcb;
2295 struct fsf_qtcb_bottom_port *bottom, *data;
2296 struct Scsi_Host *shost;
2298 adapter = fsf_req->adapter;
2299 qtcb = fsf_req->qtcb;
2300 bottom = &qtcb->bottom.port;
2301 shost = adapter->scsi_host;
2303 data = (struct fsf_qtcb_bottom_port*) fsf_req->data;
2304 if (data)
2305 memcpy(data, bottom, sizeof(struct fsf_qtcb_bottom_port));
2307 if (adapter->connection_features & FSF_FEATURE_NPIV_MODE)
2308 fc_host_permanent_port_name(shost) = bottom->wwpn;
2309 else
2310 fc_host_permanent_port_name(shost) = fc_host_port_name(shost);
2311 fc_host_maxframe_size(shost) = bottom->maximum_frame_size;
2312 fc_host_supported_speeds(shost) = bottom->supported_speed;
2316 * zfcp_fsf_exchange_port_data_handler - handler for exchange_port_data request
2317 * @fsf_req: pointer to struct zfcp_fsf_req
2319 static void
2320 zfcp_fsf_exchange_port_data_handler(struct zfcp_fsf_req *fsf_req)
2322 struct zfcp_adapter *adapter;
2323 struct fsf_qtcb *qtcb;
2325 adapter = fsf_req->adapter;
2326 qtcb = fsf_req->qtcb;
2328 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR)
2329 return;
2331 switch (qtcb->header.fsf_status) {
2332 case FSF_GOOD:
2333 zfcp_fsf_exchange_port_evaluate(fsf_req, 1);
2334 atomic_set_mask(ZFCP_STATUS_ADAPTER_XPORT_OK, &adapter->status);
2335 break;
2336 case FSF_EXCHANGE_CONFIG_DATA_INCOMPLETE:
2337 zfcp_fsf_exchange_port_evaluate(fsf_req, 0);
2338 atomic_set_mask(ZFCP_STATUS_ADAPTER_XPORT_OK, &adapter->status);
2339 zfcp_fsf_link_down_info_eval(adapter,
2340 &qtcb->header.fsf_status_qual.link_down_info);
2341 break;
2342 default:
2343 debug_text_event(adapter->erp_dbf, 0, "xchg-port-ng");
2344 debug_event(adapter->erp_dbf, 0,
2345 &fsf_req->qtcb->header.fsf_status, sizeof(u32));
2351 * function: zfcp_fsf_open_port
2353 * purpose:
2355 * returns: address of initiated FSF request
2356 * NULL - request could not be initiated
2359 zfcp_fsf_open_port(struct zfcp_erp_action *erp_action)
2361 volatile struct qdio_buffer_element *sbale;
2362 struct zfcp_fsf_req *fsf_req;
2363 unsigned long lock_flags;
2364 int retval = 0;
2366 /* setup new FSF request */
2367 retval = zfcp_fsf_req_create(erp_action->adapter,
2368 FSF_QTCB_OPEN_PORT_WITH_DID,
2369 ZFCP_WAIT_FOR_SBAL | ZFCP_REQ_AUTO_CLEANUP,
2370 erp_action->adapter->pool.fsf_req_erp,
2371 &lock_flags, &fsf_req);
2372 if (retval < 0) {
2373 ZFCP_LOG_INFO("error: Could not create open port request "
2374 "for port 0x%016Lx on adapter %s.\n",
2375 erp_action->port->wwpn,
2376 zfcp_get_busid_by_adapter(erp_action->adapter));
2377 goto out;
2380 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
2381 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
2382 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
2384 fsf_req->qtcb->bottom.support.d_id = erp_action->port->d_id;
2385 atomic_set_mask(ZFCP_STATUS_COMMON_OPENING, &erp_action->port->status);
2386 fsf_req->data = (unsigned long) erp_action->port;
2387 fsf_req->erp_action = erp_action;
2388 erp_action->fsf_req = fsf_req;
2390 zfcp_erp_start_timer(fsf_req);
2391 retval = zfcp_fsf_req_send(fsf_req);
2392 if (retval) {
2393 ZFCP_LOG_INFO("error: Could not send open port request for "
2394 "port 0x%016Lx on adapter %s.\n",
2395 erp_action->port->wwpn,
2396 zfcp_get_busid_by_adapter(erp_action->adapter));
2397 zfcp_fsf_req_free(fsf_req);
2398 erp_action->fsf_req = NULL;
2399 goto out;
2402 ZFCP_LOG_DEBUG("open port request initiated "
2403 "(adapter %s, port 0x%016Lx)\n",
2404 zfcp_get_busid_by_adapter(erp_action->adapter),
2405 erp_action->port->wwpn);
2406 out:
2407 write_unlock_irqrestore(&erp_action->adapter->request_queue.queue_lock,
2408 lock_flags);
2409 return retval;
2413 * function: zfcp_fsf_open_port_handler
2415 * purpose: is called for finished Open Port command
2417 * returns:
2419 static int
2420 zfcp_fsf_open_port_handler(struct zfcp_fsf_req *fsf_req)
2422 int retval = -EINVAL;
2423 struct zfcp_port *port;
2424 struct fsf_plogi *plogi;
2425 struct fsf_qtcb_header *header;
2426 u16 subtable, rule, counter;
2428 port = (struct zfcp_port *) fsf_req->data;
2429 header = &fsf_req->qtcb->header;
2431 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR) {
2432 /* don't change port status in our bookkeeping */
2433 goto skip_fsfstatus;
2436 /* evaluate FSF status in QTCB */
2437 switch (header->fsf_status) {
2439 case FSF_PORT_ALREADY_OPEN:
2440 ZFCP_LOG_NORMAL("bug: remote port 0x%016Lx on adapter %s "
2441 "is already open.\n",
2442 port->wwpn, zfcp_get_busid_by_port(port));
2443 debug_text_exception(fsf_req->adapter->erp_dbf, 0,
2444 "fsf_s_popen");
2446 * This is a bug, however operation should continue normally
2447 * if it is simply ignored
2449 break;
2451 case FSF_ACCESS_DENIED:
2452 ZFCP_LOG_NORMAL("Access denied, cannot open port 0x%016Lx "
2453 "on adapter %s\n",
2454 port->wwpn, zfcp_get_busid_by_port(port));
2455 for (counter = 0; counter < 2; counter++) {
2456 subtable = header->fsf_status_qual.halfword[counter * 2];
2457 rule = header->fsf_status_qual.halfword[counter * 2 + 1];
2458 switch (subtable) {
2459 case FSF_SQ_CFDC_SUBTABLE_OS:
2460 case FSF_SQ_CFDC_SUBTABLE_PORT_WWPN:
2461 case FSF_SQ_CFDC_SUBTABLE_PORT_DID:
2462 case FSF_SQ_CFDC_SUBTABLE_LUN:
2463 ZFCP_LOG_INFO("Access denied (%s rule %d)\n",
2464 zfcp_act_subtable_type[subtable], rule);
2465 break;
2468 debug_text_event(fsf_req->adapter->erp_dbf, 1, "fsf_s_access");
2469 zfcp_erp_port_access_denied(port);
2470 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2471 break;
2473 case FSF_MAXIMUM_NUMBER_OF_PORTS_EXCEEDED:
2474 ZFCP_LOG_INFO("error: The FSF adapter is out of resources. "
2475 "The remote port 0x%016Lx on adapter %s "
2476 "could not be opened. Disabling it.\n",
2477 port->wwpn, zfcp_get_busid_by_port(port));
2478 debug_text_event(fsf_req->adapter->erp_dbf, 1,
2479 "fsf_s_max_ports");
2480 zfcp_erp_port_failed(port);
2481 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2482 break;
2484 case FSF_ADAPTER_STATUS_AVAILABLE:
2485 switch (header->fsf_status_qual.word[0]) {
2486 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
2487 debug_text_event(fsf_req->adapter->erp_dbf, 1,
2488 "fsf_sq_ltest");
2489 /* ERP strategy will escalate */
2490 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2491 break;
2492 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
2493 /* ERP strategy will escalate */
2494 debug_text_event(fsf_req->adapter->erp_dbf, 1,
2495 "fsf_sq_ulp");
2496 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2497 break;
2498 case FSF_SQ_NO_RETRY_POSSIBLE:
2499 ZFCP_LOG_NORMAL("The remote port 0x%016Lx on "
2500 "adapter %s could not be opened. "
2501 "Disabling it.\n",
2502 port->wwpn,
2503 zfcp_get_busid_by_port(port));
2504 debug_text_exception(fsf_req->adapter->erp_dbf, 0,
2505 "fsf_sq_no_retry");
2506 zfcp_erp_port_failed(port);
2507 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2508 break;
2509 default:
2510 ZFCP_LOG_NORMAL
2511 ("bug: Wrong status qualifier 0x%x arrived.\n",
2512 header->fsf_status_qual.word[0]);
2513 debug_text_event(fsf_req->adapter->erp_dbf, 0,
2514 "fsf_sq_inval:");
2515 debug_exception(
2516 fsf_req->adapter->erp_dbf, 0,
2517 &header->fsf_status_qual.word[0],
2518 sizeof (u32));
2519 break;
2521 break;
2523 case FSF_GOOD:
2524 /* save port handle assigned by FSF */
2525 port->handle = header->port_handle;
2526 ZFCP_LOG_INFO("The remote port 0x%016Lx via adapter %s "
2527 "was opened, it's port handle is 0x%x\n",
2528 port->wwpn, zfcp_get_busid_by_port(port),
2529 port->handle);
2530 /* mark port as open */
2531 atomic_set_mask(ZFCP_STATUS_COMMON_OPEN |
2532 ZFCP_STATUS_PORT_PHYS_OPEN, &port->status);
2533 atomic_clear_mask(ZFCP_STATUS_COMMON_ACCESS_DENIED |
2534 ZFCP_STATUS_COMMON_ACCESS_BOXED,
2535 &port->status);
2536 retval = 0;
2537 /* check whether D_ID has changed during open */
2539 * FIXME: This check is not airtight, as the FCP channel does
2540 * not monitor closures of target port connections caused on
2541 * the remote side. Thus, they might miss out on invalidating
2542 * locally cached WWPNs (and other N_Port parameters) of gone
2543 * target ports. So, our heroic attempt to make things safe
2544 * could be undermined by 'open port' response data tagged with
2545 * obsolete WWPNs. Another reason to monitor potential
2546 * connection closures ourself at least (by interpreting
2547 * incoming ELS' and unsolicited status). It just crosses my
2548 * mind that one should be able to cross-check by means of
2549 * another GID_PN straight after a port has been opened.
2550 * Alternately, an ADISC/PDISC ELS should suffice, as well.
2552 plogi = (struct fsf_plogi *) fsf_req->qtcb->bottom.support.els;
2553 if (!atomic_test_mask(ZFCP_STATUS_PORT_NO_WWPN, &port->status))
2555 if (fsf_req->qtcb->bottom.support.els1_length <
2556 sizeof (struct fsf_plogi)) {
2557 ZFCP_LOG_INFO(
2558 "warning: insufficient length of "
2559 "PLOGI payload (%i)\n",
2560 fsf_req->qtcb->bottom.support.els1_length);
2561 debug_text_event(fsf_req->adapter->erp_dbf, 0,
2562 "fsf_s_short_plogi:");
2563 /* skip sanity check and assume wwpn is ok */
2564 } else {
2565 if (plogi->serv_param.wwpn != port->wwpn) {
2566 ZFCP_LOG_INFO("warning: d_id of port "
2567 "0x%016Lx changed during "
2568 "open\n", port->wwpn);
2569 debug_text_event(
2570 fsf_req->adapter->erp_dbf, 0,
2571 "fsf_s_did_change:");
2572 atomic_clear_mask(
2573 ZFCP_STATUS_PORT_DID_DID,
2574 &port->status);
2575 } else {
2576 port->wwnn = plogi->serv_param.wwnn;
2577 zfcp_plogi_evaluate(port, plogi);
2581 break;
2583 case FSF_UNKNOWN_OP_SUBTYPE:
2584 /* should never occure, subtype not set in zfcp_fsf_open_port */
2585 ZFCP_LOG_INFO("unknown operation subtype (adapter: %s, "
2586 "op_subtype=0x%x)\n",
2587 zfcp_get_busid_by_port(port),
2588 fsf_req->qtcb->bottom.support.operation_subtype);
2589 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2590 break;
2592 default:
2593 ZFCP_LOG_NORMAL("bug: An unknown FSF Status was presented "
2594 "(debug info 0x%x)\n",
2595 header->fsf_status);
2596 debug_text_event(fsf_req->adapter->erp_dbf, 0, "fsf_s_inval:");
2597 debug_exception(fsf_req->adapter->erp_dbf, 0,
2598 &header->fsf_status, sizeof (u32));
2599 break;
2602 skip_fsfstatus:
2603 atomic_clear_mask(ZFCP_STATUS_COMMON_OPENING, &port->status);
2604 return retval;
2608 * function: zfcp_fsf_close_port
2610 * purpose: submit FSF command "close port"
2612 * returns: address of initiated FSF request
2613 * NULL - request could not be initiated
2616 zfcp_fsf_close_port(struct zfcp_erp_action *erp_action)
2618 volatile struct qdio_buffer_element *sbale;
2619 struct zfcp_fsf_req *fsf_req;
2620 unsigned long lock_flags;
2621 int retval = 0;
2623 /* setup new FSF request */
2624 retval = zfcp_fsf_req_create(erp_action->adapter,
2625 FSF_QTCB_CLOSE_PORT,
2626 ZFCP_WAIT_FOR_SBAL | ZFCP_REQ_AUTO_CLEANUP,
2627 erp_action->adapter->pool.fsf_req_erp,
2628 &lock_flags, &fsf_req);
2629 if (retval < 0) {
2630 ZFCP_LOG_INFO("error: Could not create a close port request "
2631 "for port 0x%016Lx on adapter %s.\n",
2632 erp_action->port->wwpn,
2633 zfcp_get_busid_by_adapter(erp_action->adapter));
2634 goto out;
2637 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
2638 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
2639 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
2641 atomic_set_mask(ZFCP_STATUS_COMMON_CLOSING, &erp_action->port->status);
2642 fsf_req->data = (unsigned long) erp_action->port;
2643 fsf_req->erp_action = erp_action;
2644 fsf_req->qtcb->header.port_handle = erp_action->port->handle;
2645 fsf_req->erp_action = erp_action;
2646 erp_action->fsf_req = fsf_req;
2648 zfcp_erp_start_timer(fsf_req);
2649 retval = zfcp_fsf_req_send(fsf_req);
2650 if (retval) {
2651 ZFCP_LOG_INFO("error: Could not send a close port request for "
2652 "port 0x%016Lx on adapter %s.\n",
2653 erp_action->port->wwpn,
2654 zfcp_get_busid_by_adapter(erp_action->adapter));
2655 zfcp_fsf_req_free(fsf_req);
2656 erp_action->fsf_req = NULL;
2657 goto out;
2660 ZFCP_LOG_TRACE("close port request initiated "
2661 "(adapter %s, port 0x%016Lx)\n",
2662 zfcp_get_busid_by_adapter(erp_action->adapter),
2663 erp_action->port->wwpn);
2664 out:
2665 write_unlock_irqrestore(&erp_action->adapter->request_queue.queue_lock,
2666 lock_flags);
2667 return retval;
2671 * function: zfcp_fsf_close_port_handler
2673 * purpose: is called for finished Close Port FSF command
2675 * returns:
2677 static int
2678 zfcp_fsf_close_port_handler(struct zfcp_fsf_req *fsf_req)
2680 int retval = -EINVAL;
2681 struct zfcp_port *port;
2683 port = (struct zfcp_port *) fsf_req->data;
2685 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR) {
2686 /* don't change port status in our bookkeeping */
2687 goto skip_fsfstatus;
2690 /* evaluate FSF status in QTCB */
2691 switch (fsf_req->qtcb->header.fsf_status) {
2693 case FSF_PORT_HANDLE_NOT_VALID:
2694 ZFCP_LOG_INFO("Temporary port identifier 0x%x for port "
2695 "0x%016Lx on adapter %s invalid. This may happen "
2696 "occasionally.\n", port->handle,
2697 port->wwpn, zfcp_get_busid_by_port(port));
2698 ZFCP_LOG_DEBUG("status qualifier:\n");
2699 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
2700 (char *) &fsf_req->qtcb->header.fsf_status_qual,
2701 sizeof (union fsf_status_qual));
2702 debug_text_event(fsf_req->adapter->erp_dbf, 1,
2703 "fsf_s_phand_nv");
2704 zfcp_erp_adapter_reopen(port->adapter, 0);
2705 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2706 break;
2708 case FSF_ADAPTER_STATUS_AVAILABLE:
2709 /* Note: FSF has actually closed the port in this case.
2710 * The status code is just daft. Fingers crossed for a change
2712 retval = 0;
2713 break;
2715 case FSF_GOOD:
2716 ZFCP_LOG_TRACE("remote port 0x016%Lx on adapter %s closed, "
2717 "port handle 0x%x\n", port->wwpn,
2718 zfcp_get_busid_by_port(port), port->handle);
2719 zfcp_erp_modify_port_status(port,
2720 ZFCP_STATUS_COMMON_OPEN,
2721 ZFCP_CLEAR);
2722 retval = 0;
2723 break;
2725 default:
2726 ZFCP_LOG_NORMAL("bug: An unknown FSF Status was presented "
2727 "(debug info 0x%x)\n",
2728 fsf_req->qtcb->header.fsf_status);
2729 debug_text_event(fsf_req->adapter->erp_dbf, 0, "fsf_s_inval:");
2730 debug_exception(fsf_req->adapter->erp_dbf, 0,
2731 &fsf_req->qtcb->header.fsf_status,
2732 sizeof (u32));
2733 break;
2736 skip_fsfstatus:
2737 atomic_clear_mask(ZFCP_STATUS_COMMON_CLOSING, &port->status);
2738 return retval;
2742 * function: zfcp_fsf_close_physical_port
2744 * purpose: submit FSF command "close physical port"
2746 * returns: address of initiated FSF request
2747 * NULL - request could not be initiated
2750 zfcp_fsf_close_physical_port(struct zfcp_erp_action *erp_action)
2752 volatile struct qdio_buffer_element *sbale;
2753 struct zfcp_fsf_req *fsf_req;
2754 unsigned long lock_flags;
2755 int retval = 0;
2757 /* setup new FSF request */
2758 retval = zfcp_fsf_req_create(erp_action->adapter,
2759 FSF_QTCB_CLOSE_PHYSICAL_PORT,
2760 ZFCP_WAIT_FOR_SBAL | ZFCP_REQ_AUTO_CLEANUP,
2761 erp_action->adapter->pool.fsf_req_erp,
2762 &lock_flags, &fsf_req);
2763 if (retval < 0) {
2764 ZFCP_LOG_INFO("error: Could not create close physical port "
2765 "request (adapter %s, port 0x%016Lx)\n",
2766 zfcp_get_busid_by_adapter(erp_action->adapter),
2767 erp_action->port->wwpn);
2769 goto out;
2772 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
2773 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
2774 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
2776 /* mark port as being closed */
2777 atomic_set_mask(ZFCP_STATUS_PORT_PHYS_CLOSING,
2778 &erp_action->port->status);
2779 /* save a pointer to this port */
2780 fsf_req->data = (unsigned long) erp_action->port;
2781 fsf_req->qtcb->header.port_handle = erp_action->port->handle;
2782 fsf_req->erp_action = erp_action;
2783 erp_action->fsf_req = fsf_req;
2785 zfcp_erp_start_timer(fsf_req);
2786 retval = zfcp_fsf_req_send(fsf_req);
2787 if (retval) {
2788 ZFCP_LOG_INFO("error: Could not send close physical port "
2789 "request (adapter %s, port 0x%016Lx)\n",
2790 zfcp_get_busid_by_adapter(erp_action->adapter),
2791 erp_action->port->wwpn);
2792 zfcp_fsf_req_free(fsf_req);
2793 erp_action->fsf_req = NULL;
2794 goto out;
2797 ZFCP_LOG_TRACE("close physical port request initiated "
2798 "(adapter %s, port 0x%016Lx)\n",
2799 zfcp_get_busid_by_adapter(erp_action->adapter),
2800 erp_action->port->wwpn);
2801 out:
2802 write_unlock_irqrestore(&erp_action->adapter->request_queue.queue_lock,
2803 lock_flags);
2804 return retval;
2808 * function: zfcp_fsf_close_physical_port_handler
2810 * purpose: is called for finished Close Physical Port FSF command
2812 * returns:
2814 static int
2815 zfcp_fsf_close_physical_port_handler(struct zfcp_fsf_req *fsf_req)
2817 int retval = -EINVAL;
2818 struct zfcp_port *port;
2819 struct zfcp_unit *unit;
2820 struct fsf_qtcb_header *header;
2821 u16 subtable, rule, counter;
2823 port = (struct zfcp_port *) fsf_req->data;
2824 header = &fsf_req->qtcb->header;
2826 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR) {
2827 /* don't change port status in our bookkeeping */
2828 goto skip_fsfstatus;
2831 /* evaluate FSF status in QTCB */
2832 switch (header->fsf_status) {
2834 case FSF_PORT_HANDLE_NOT_VALID:
2835 ZFCP_LOG_INFO("Temporary port identifier 0x%x invalid"
2836 "(adapter %s, port 0x%016Lx). "
2837 "This may happen occasionally.\n",
2838 port->handle,
2839 zfcp_get_busid_by_port(port),
2840 port->wwpn);
2841 ZFCP_LOG_DEBUG("status qualifier:\n");
2842 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
2843 (char *) &header->fsf_status_qual,
2844 sizeof (union fsf_status_qual));
2845 debug_text_event(fsf_req->adapter->erp_dbf, 1,
2846 "fsf_s_phand_nv");
2847 zfcp_erp_adapter_reopen(port->adapter, 0);
2848 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2849 break;
2851 case FSF_ACCESS_DENIED:
2852 ZFCP_LOG_NORMAL("Access denied, cannot close "
2853 "physical port 0x%016Lx on adapter %s\n",
2854 port->wwpn, zfcp_get_busid_by_port(port));
2855 for (counter = 0; counter < 2; counter++) {
2856 subtable = header->fsf_status_qual.halfword[counter * 2];
2857 rule = header->fsf_status_qual.halfword[counter * 2 + 1];
2858 switch (subtable) {
2859 case FSF_SQ_CFDC_SUBTABLE_OS:
2860 case FSF_SQ_CFDC_SUBTABLE_PORT_WWPN:
2861 case FSF_SQ_CFDC_SUBTABLE_PORT_DID:
2862 case FSF_SQ_CFDC_SUBTABLE_LUN:
2863 ZFCP_LOG_INFO("Access denied (%s rule %d)\n",
2864 zfcp_act_subtable_type[subtable], rule);
2865 break;
2868 debug_text_event(fsf_req->adapter->erp_dbf, 1, "fsf_s_access");
2869 zfcp_erp_port_access_denied(port);
2870 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2871 break;
2873 case FSF_PORT_BOXED:
2874 ZFCP_LOG_DEBUG("The remote port 0x%016Lx on adapter "
2875 "%s needs to be reopened but it was attempted "
2876 "to close it physically.\n",
2877 port->wwpn,
2878 zfcp_get_busid_by_port(port));
2879 debug_text_event(fsf_req->adapter->erp_dbf, 1, "fsf_s_pboxed");
2880 zfcp_erp_port_boxed(port);
2881 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR |
2882 ZFCP_STATUS_FSFREQ_RETRY;
2883 break;
2885 case FSF_ADAPTER_STATUS_AVAILABLE:
2886 switch (header->fsf_status_qual.word[0]) {
2887 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
2888 debug_text_event(fsf_req->adapter->erp_dbf, 1,
2889 "fsf_sq_ltest");
2890 /* This will now be escalated by ERP */
2891 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2892 break;
2893 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
2894 /* ERP strategy will escalate */
2895 debug_text_event(fsf_req->adapter->erp_dbf, 1,
2896 "fsf_sq_ulp");
2897 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2898 break;
2899 default:
2900 ZFCP_LOG_NORMAL
2901 ("bug: Wrong status qualifier 0x%x arrived.\n",
2902 header->fsf_status_qual.word[0]);
2903 debug_text_event(fsf_req->adapter->erp_dbf, 0,
2904 "fsf_sq_inval:");
2905 debug_exception(
2906 fsf_req->adapter->erp_dbf, 0,
2907 &header->fsf_status_qual.word[0], sizeof (u32));
2908 break;
2910 break;
2912 case FSF_GOOD:
2913 ZFCP_LOG_DEBUG("Remote port 0x%016Lx via adapter %s "
2914 "physically closed, port handle 0x%x\n",
2915 port->wwpn,
2916 zfcp_get_busid_by_port(port), port->handle);
2917 /* can't use generic zfcp_erp_modify_port_status because
2918 * ZFCP_STATUS_COMMON_OPEN must not be reset for the port
2920 atomic_clear_mask(ZFCP_STATUS_PORT_PHYS_OPEN, &port->status);
2921 list_for_each_entry(unit, &port->unit_list_head, list)
2922 atomic_clear_mask(ZFCP_STATUS_COMMON_OPEN, &unit->status);
2923 retval = 0;
2924 break;
2926 default:
2927 ZFCP_LOG_NORMAL("bug: An unknown FSF Status was presented "
2928 "(debug info 0x%x)\n",
2929 header->fsf_status);
2930 debug_text_event(fsf_req->adapter->erp_dbf, 0, "fsf_s_inval:");
2931 debug_exception(fsf_req->adapter->erp_dbf, 0,
2932 &header->fsf_status, sizeof (u32));
2933 break;
2936 skip_fsfstatus:
2937 atomic_clear_mask(ZFCP_STATUS_PORT_PHYS_CLOSING, &port->status);
2938 return retval;
2942 * function: zfcp_fsf_open_unit
2944 * purpose:
2946 * returns:
2948 * assumptions: This routine does not check whether the associated
2949 * remote port has already been opened. This should be
2950 * done by calling routines. Otherwise some status
2951 * may be presented by FSF
2954 zfcp_fsf_open_unit(struct zfcp_erp_action *erp_action)
2956 volatile struct qdio_buffer_element *sbale;
2957 struct zfcp_fsf_req *fsf_req;
2958 unsigned long lock_flags;
2959 int retval = 0;
2961 /* setup new FSF request */
2962 retval = zfcp_fsf_req_create(erp_action->adapter,
2963 FSF_QTCB_OPEN_LUN,
2964 ZFCP_WAIT_FOR_SBAL | ZFCP_REQ_AUTO_CLEANUP,
2965 erp_action->adapter->pool.fsf_req_erp,
2966 &lock_flags, &fsf_req);
2967 if (retval < 0) {
2968 ZFCP_LOG_INFO("error: Could not create open unit request for "
2969 "unit 0x%016Lx on port 0x%016Lx on adapter %s.\n",
2970 erp_action->unit->fcp_lun,
2971 erp_action->unit->port->wwpn,
2972 zfcp_get_busid_by_adapter(erp_action->adapter));
2973 goto out;
2976 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
2977 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
2978 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
2980 fsf_req->qtcb->header.port_handle = erp_action->port->handle;
2981 fsf_req->qtcb->bottom.support.fcp_lun = erp_action->unit->fcp_lun;
2982 if (!(erp_action->adapter->connection_features & FSF_FEATURE_NPIV_MODE))
2983 fsf_req->qtcb->bottom.support.option =
2984 FSF_OPEN_LUN_SUPPRESS_BOXING;
2985 atomic_set_mask(ZFCP_STATUS_COMMON_OPENING, &erp_action->unit->status);
2986 fsf_req->data = (unsigned long) erp_action->unit;
2987 fsf_req->erp_action = erp_action;
2988 erp_action->fsf_req = fsf_req;
2990 zfcp_erp_start_timer(fsf_req);
2991 retval = zfcp_fsf_req_send(erp_action->fsf_req);
2992 if (retval) {
2993 ZFCP_LOG_INFO("error: Could not send an open unit request "
2994 "on the adapter %s, port 0x%016Lx for "
2995 "unit 0x%016Lx\n",
2996 zfcp_get_busid_by_adapter(erp_action->adapter),
2997 erp_action->port->wwpn,
2998 erp_action->unit->fcp_lun);
2999 zfcp_fsf_req_free(fsf_req);
3000 erp_action->fsf_req = NULL;
3001 goto out;
3004 ZFCP_LOG_TRACE("Open LUN request initiated (adapter %s, "
3005 "port 0x%016Lx, unit 0x%016Lx)\n",
3006 zfcp_get_busid_by_adapter(erp_action->adapter),
3007 erp_action->port->wwpn, erp_action->unit->fcp_lun);
3008 out:
3009 write_unlock_irqrestore(&erp_action->adapter->request_queue.queue_lock,
3010 lock_flags);
3011 return retval;
3015 * function: zfcp_fsf_open_unit_handler
3017 * purpose: is called for finished Open LUN command
3019 * returns:
3021 static int
3022 zfcp_fsf_open_unit_handler(struct zfcp_fsf_req *fsf_req)
3024 int retval = -EINVAL;
3025 struct zfcp_adapter *adapter;
3026 struct zfcp_unit *unit;
3027 struct fsf_qtcb_header *header;
3028 struct fsf_qtcb_bottom_support *bottom;
3029 struct fsf_queue_designator *queue_designator;
3030 u16 subtable, rule, counter;
3031 int exclusive, readwrite;
3033 unit = (struct zfcp_unit *) fsf_req->data;
3035 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR) {
3036 /* don't change unit status in our bookkeeping */
3037 goto skip_fsfstatus;
3040 adapter = fsf_req->adapter;
3041 header = &fsf_req->qtcb->header;
3042 bottom = &fsf_req->qtcb->bottom.support;
3043 queue_designator = &header->fsf_status_qual.fsf_queue_designator;
3045 atomic_clear_mask(ZFCP_STATUS_COMMON_ACCESS_DENIED |
3046 ZFCP_STATUS_COMMON_ACCESS_BOXED |
3047 ZFCP_STATUS_UNIT_SHARED |
3048 ZFCP_STATUS_UNIT_READONLY,
3049 &unit->status);
3051 /* evaluate FSF status in QTCB */
3052 switch (header->fsf_status) {
3054 case FSF_PORT_HANDLE_NOT_VALID:
3055 ZFCP_LOG_INFO("Temporary port identifier 0x%x "
3056 "for port 0x%016Lx on adapter %s invalid "
3057 "This may happen occasionally\n",
3058 unit->port->handle,
3059 unit->port->wwpn, zfcp_get_busid_by_unit(unit));
3060 ZFCP_LOG_DEBUG("status qualifier:\n");
3061 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
3062 (char *) &header->fsf_status_qual,
3063 sizeof (union fsf_status_qual));
3064 debug_text_event(adapter->erp_dbf, 1, "fsf_s_ph_nv");
3065 zfcp_erp_adapter_reopen(unit->port->adapter, 0);
3066 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3067 break;
3069 case FSF_LUN_ALREADY_OPEN:
3070 ZFCP_LOG_NORMAL("bug: Attempted to open unit 0x%016Lx on "
3071 "remote port 0x%016Lx on adapter %s twice.\n",
3072 unit->fcp_lun,
3073 unit->port->wwpn, zfcp_get_busid_by_unit(unit));
3074 debug_text_exception(adapter->erp_dbf, 0,
3075 "fsf_s_uopen");
3076 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3077 break;
3079 case FSF_ACCESS_DENIED:
3080 ZFCP_LOG_NORMAL("Access denied, cannot open unit 0x%016Lx on "
3081 "remote port 0x%016Lx on adapter %s\n",
3082 unit->fcp_lun, unit->port->wwpn,
3083 zfcp_get_busid_by_unit(unit));
3084 for (counter = 0; counter < 2; counter++) {
3085 subtable = header->fsf_status_qual.halfword[counter * 2];
3086 rule = header->fsf_status_qual.halfword[counter * 2 + 1];
3087 switch (subtable) {
3088 case FSF_SQ_CFDC_SUBTABLE_OS:
3089 case FSF_SQ_CFDC_SUBTABLE_PORT_WWPN:
3090 case FSF_SQ_CFDC_SUBTABLE_PORT_DID:
3091 case FSF_SQ_CFDC_SUBTABLE_LUN:
3092 ZFCP_LOG_INFO("Access denied (%s rule %d)\n",
3093 zfcp_act_subtable_type[subtable], rule);
3094 break;
3097 debug_text_event(adapter->erp_dbf, 1, "fsf_s_access");
3098 zfcp_erp_unit_access_denied(unit);
3099 atomic_clear_mask(ZFCP_STATUS_UNIT_SHARED, &unit->status);
3100 atomic_clear_mask(ZFCP_STATUS_UNIT_READONLY, &unit->status);
3101 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3102 break;
3104 case FSF_PORT_BOXED:
3105 ZFCP_LOG_DEBUG("The remote port 0x%016Lx on adapter %s "
3106 "needs to be reopened\n",
3107 unit->port->wwpn, zfcp_get_busid_by_unit(unit));
3108 debug_text_event(adapter->erp_dbf, 2, "fsf_s_pboxed");
3109 zfcp_erp_port_boxed(unit->port);
3110 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR |
3111 ZFCP_STATUS_FSFREQ_RETRY;
3112 break;
3114 case FSF_LUN_SHARING_VIOLATION:
3115 if (header->fsf_status_qual.word[0] != 0) {
3116 ZFCP_LOG_NORMAL("FCP-LUN 0x%Lx at the remote port "
3117 "with WWPN 0x%Lx "
3118 "connected to the adapter %s "
3119 "is already in use in LPAR%d, CSS%d\n",
3120 unit->fcp_lun,
3121 unit->port->wwpn,
3122 zfcp_get_busid_by_unit(unit),
3123 queue_designator->hla,
3124 queue_designator->cssid);
3125 } else {
3126 subtable = header->fsf_status_qual.halfword[4];
3127 rule = header->fsf_status_qual.halfword[5];
3128 switch (subtable) {
3129 case FSF_SQ_CFDC_SUBTABLE_OS:
3130 case FSF_SQ_CFDC_SUBTABLE_PORT_WWPN:
3131 case FSF_SQ_CFDC_SUBTABLE_PORT_DID:
3132 case FSF_SQ_CFDC_SUBTABLE_LUN:
3133 ZFCP_LOG_NORMAL("Access to FCP-LUN 0x%Lx at the "
3134 "remote port with WWPN 0x%Lx "
3135 "connected to the adapter %s "
3136 "is denied (%s rule %d)\n",
3137 unit->fcp_lun,
3138 unit->port->wwpn,
3139 zfcp_get_busid_by_unit(unit),
3140 zfcp_act_subtable_type[subtable],
3141 rule);
3142 break;
3145 ZFCP_LOG_DEBUG("status qualifier:\n");
3146 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
3147 (char *) &header->fsf_status_qual,
3148 sizeof (union fsf_status_qual));
3149 debug_text_event(adapter->erp_dbf, 2,
3150 "fsf_s_l_sh_vio");
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;
3155 break;
3157 case FSF_MAXIMUM_NUMBER_OF_LUNS_EXCEEDED:
3158 ZFCP_LOG_INFO("error: The adapter ran out of resources. "
3159 "There is no handle (temporary port identifier) "
3160 "available for unit 0x%016Lx on port 0x%016Lx "
3161 "on adapter %s\n",
3162 unit->fcp_lun,
3163 unit->port->wwpn,
3164 zfcp_get_busid_by_unit(unit));
3165 debug_text_event(adapter->erp_dbf, 1,
3166 "fsf_s_max_units");
3167 zfcp_erp_unit_failed(unit);
3168 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3169 break;
3171 case FSF_ADAPTER_STATUS_AVAILABLE:
3172 switch (header->fsf_status_qual.word[0]) {
3173 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
3174 /* Re-establish link to port */
3175 debug_text_event(adapter->erp_dbf, 1,
3176 "fsf_sq_ltest");
3177 zfcp_test_link(unit->port);
3178 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3179 break;
3180 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
3181 /* ERP strategy will escalate */
3182 debug_text_event(adapter->erp_dbf, 1,
3183 "fsf_sq_ulp");
3184 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3185 break;
3186 default:
3187 ZFCP_LOG_NORMAL
3188 ("bug: Wrong status qualifier 0x%x arrived.\n",
3189 header->fsf_status_qual.word[0]);
3190 debug_text_event(adapter->erp_dbf, 0,
3191 "fsf_sq_inval:");
3192 debug_exception(adapter->erp_dbf, 0,
3193 &header->fsf_status_qual.word[0],
3194 sizeof (u32));
3196 break;
3198 case FSF_INVALID_COMMAND_OPTION:
3199 ZFCP_LOG_NORMAL(
3200 "Invalid option 0x%x has been specified "
3201 "in QTCB bottom sent to the adapter %s\n",
3202 bottom->option,
3203 zfcp_get_busid_by_adapter(adapter));
3204 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3205 retval = -EINVAL;
3206 break;
3208 case FSF_GOOD:
3209 /* save LUN handle assigned by FSF */
3210 unit->handle = header->lun_handle;
3211 ZFCP_LOG_TRACE("unit 0x%016Lx on remote port 0x%016Lx on "
3212 "adapter %s opened, port handle 0x%x\n",
3213 unit->fcp_lun,
3214 unit->port->wwpn,
3215 zfcp_get_busid_by_unit(unit),
3216 unit->handle);
3217 /* mark unit as open */
3218 atomic_set_mask(ZFCP_STATUS_COMMON_OPEN, &unit->status);
3220 if (!(adapter->connection_features & FSF_FEATURE_NPIV_MODE) &&
3221 (adapter->adapter_features & FSF_FEATURE_LUN_SHARING) &&
3222 (adapter->ccw_device->id.dev_model != ZFCP_DEVICE_MODEL_PRIV)) {
3223 exclusive = (bottom->lun_access_info &
3224 FSF_UNIT_ACCESS_EXCLUSIVE);
3225 readwrite = (bottom->lun_access_info &
3226 FSF_UNIT_ACCESS_OUTBOUND_TRANSFER);
3228 if (!exclusive)
3229 atomic_set_mask(ZFCP_STATUS_UNIT_SHARED,
3230 &unit->status);
3232 if (!readwrite) {
3233 atomic_set_mask(ZFCP_STATUS_UNIT_READONLY,
3234 &unit->status);
3235 ZFCP_LOG_NORMAL("read-only access for unit "
3236 "(adapter %s, wwpn=0x%016Lx, "
3237 "fcp_lun=0x%016Lx)\n",
3238 zfcp_get_busid_by_unit(unit),
3239 unit->port->wwpn,
3240 unit->fcp_lun);
3243 if (exclusive && !readwrite) {
3244 ZFCP_LOG_NORMAL("exclusive access of read-only "
3245 "unit not supported\n");
3246 zfcp_erp_unit_failed(unit);
3247 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3248 zfcp_erp_unit_shutdown(unit, 0);
3249 } else if (!exclusive && readwrite) {
3250 ZFCP_LOG_NORMAL("shared access of read-write "
3251 "unit not supported\n");
3252 zfcp_erp_unit_failed(unit);
3253 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3254 zfcp_erp_unit_shutdown(unit, 0);
3258 retval = 0;
3259 break;
3261 default:
3262 ZFCP_LOG_NORMAL("bug: An unknown FSF Status was presented "
3263 "(debug info 0x%x)\n",
3264 header->fsf_status);
3265 debug_text_event(adapter->erp_dbf, 0, "fsf_s_inval:");
3266 debug_exception(adapter->erp_dbf, 0,
3267 &header->fsf_status, sizeof (u32));
3268 break;
3271 skip_fsfstatus:
3272 atomic_clear_mask(ZFCP_STATUS_COMMON_OPENING, &unit->status);
3273 return retval;
3277 * function: zfcp_fsf_close_unit
3279 * purpose:
3281 * returns: address of fsf_req - request successfully initiated
3282 * NULL -
3284 * assumptions: This routine does not check whether the associated
3285 * remote port/lun has already been opened. This should be
3286 * done by calling routines. Otherwise some status
3287 * may be presented by FSF
3290 zfcp_fsf_close_unit(struct zfcp_erp_action *erp_action)
3292 volatile struct qdio_buffer_element *sbale;
3293 struct zfcp_fsf_req *fsf_req;
3294 unsigned long lock_flags;
3295 int retval = 0;
3297 /* setup new FSF request */
3298 retval = zfcp_fsf_req_create(erp_action->adapter,
3299 FSF_QTCB_CLOSE_LUN,
3300 ZFCP_WAIT_FOR_SBAL | ZFCP_REQ_AUTO_CLEANUP,
3301 erp_action->adapter->pool.fsf_req_erp,
3302 &lock_flags, &fsf_req);
3303 if (retval < 0) {
3304 ZFCP_LOG_INFO("error: Could not create close unit request for "
3305 "unit 0x%016Lx on port 0x%016Lx on adapter %s.\n",
3306 erp_action->unit->fcp_lun,
3307 erp_action->port->wwpn,
3308 zfcp_get_busid_by_adapter(erp_action->adapter));
3309 goto out;
3312 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
3313 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
3314 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
3316 fsf_req->qtcb->header.port_handle = erp_action->port->handle;
3317 fsf_req->qtcb->header.lun_handle = erp_action->unit->handle;
3318 atomic_set_mask(ZFCP_STATUS_COMMON_CLOSING, &erp_action->unit->status);
3319 fsf_req->data = (unsigned long) erp_action->unit;
3320 fsf_req->erp_action = erp_action;
3321 erp_action->fsf_req = fsf_req;
3323 zfcp_erp_start_timer(fsf_req);
3324 retval = zfcp_fsf_req_send(erp_action->fsf_req);
3325 if (retval) {
3326 ZFCP_LOG_INFO("error: Could not send a close unit request for "
3327 "unit 0x%016Lx on port 0x%016Lx onadapter %s.\n",
3328 erp_action->unit->fcp_lun,
3329 erp_action->port->wwpn,
3330 zfcp_get_busid_by_adapter(erp_action->adapter));
3331 zfcp_fsf_req_free(fsf_req);
3332 erp_action->fsf_req = NULL;
3333 goto out;
3336 ZFCP_LOG_TRACE("Close LUN request initiated (adapter %s, "
3337 "port 0x%016Lx, unit 0x%016Lx)\n",
3338 zfcp_get_busid_by_adapter(erp_action->adapter),
3339 erp_action->port->wwpn, erp_action->unit->fcp_lun);
3340 out:
3341 write_unlock_irqrestore(&erp_action->adapter->request_queue.queue_lock,
3342 lock_flags);
3343 return retval;
3347 * function: zfcp_fsf_close_unit_handler
3349 * purpose: is called for finished Close LUN FSF command
3351 * returns:
3353 static int
3354 zfcp_fsf_close_unit_handler(struct zfcp_fsf_req *fsf_req)
3356 int retval = -EINVAL;
3357 struct zfcp_unit *unit;
3359 unit = (struct zfcp_unit *) fsf_req->data;
3361 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR) {
3362 /* don't change unit status in our bookkeeping */
3363 goto skip_fsfstatus;
3366 /* evaluate FSF status in QTCB */
3367 switch (fsf_req->qtcb->header.fsf_status) {
3369 case FSF_PORT_HANDLE_NOT_VALID:
3370 ZFCP_LOG_INFO("Temporary port identifier 0x%x for port "
3371 "0x%016Lx on adapter %s invalid. This may "
3372 "happen in rare circumstances\n",
3373 unit->port->handle,
3374 unit->port->wwpn,
3375 zfcp_get_busid_by_unit(unit));
3376 ZFCP_LOG_DEBUG("status qualifier:\n");
3377 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
3378 (char *) &fsf_req->qtcb->header.fsf_status_qual,
3379 sizeof (union fsf_status_qual));
3380 debug_text_event(fsf_req->adapter->erp_dbf, 1,
3381 "fsf_s_phand_nv");
3382 zfcp_erp_adapter_reopen(unit->port->adapter, 0);
3383 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3384 break;
3386 case FSF_LUN_HANDLE_NOT_VALID:
3387 ZFCP_LOG_INFO("Temporary LUN identifier 0x%x of unit "
3388 "0x%016Lx on port 0x%016Lx on adapter %s is "
3389 "invalid. This may happen occasionally.\n",
3390 unit->handle,
3391 unit->fcp_lun,
3392 unit->port->wwpn,
3393 zfcp_get_busid_by_unit(unit));
3394 ZFCP_LOG_DEBUG("Status qualifier data:\n");
3395 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
3396 (char *) &fsf_req->qtcb->header.fsf_status_qual,
3397 sizeof (union fsf_status_qual));
3398 debug_text_event(fsf_req->adapter->erp_dbf, 1,
3399 "fsf_s_lhand_nv");
3400 zfcp_erp_port_reopen(unit->port, 0);
3401 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3402 break;
3404 case FSF_PORT_BOXED:
3405 ZFCP_LOG_DEBUG("The remote port 0x%016Lx on adapter %s "
3406 "needs to be reopened\n",
3407 unit->port->wwpn,
3408 zfcp_get_busid_by_unit(unit));
3409 debug_text_event(fsf_req->adapter->erp_dbf, 2, "fsf_s_pboxed");
3410 zfcp_erp_port_boxed(unit->port);
3411 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR |
3412 ZFCP_STATUS_FSFREQ_RETRY;
3413 break;
3415 case FSF_ADAPTER_STATUS_AVAILABLE:
3416 switch (fsf_req->qtcb->header.fsf_status_qual.word[0]) {
3417 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
3418 /* re-establish link to port */
3419 debug_text_event(fsf_req->adapter->erp_dbf, 1,
3420 "fsf_sq_ltest");
3421 zfcp_test_link(unit->port);
3422 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3423 break;
3424 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
3425 /* ERP strategy will escalate */
3426 debug_text_event(fsf_req->adapter->erp_dbf, 1,
3427 "fsf_sq_ulp");
3428 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3429 break;
3430 default:
3431 ZFCP_LOG_NORMAL
3432 ("bug: Wrong status qualifier 0x%x arrived.\n",
3433 fsf_req->qtcb->header.fsf_status_qual.word[0]);
3434 debug_text_event(fsf_req->adapter->erp_dbf, 0,
3435 "fsf_sq_inval:");
3436 debug_exception(
3437 fsf_req->adapter->erp_dbf, 0,
3438 &fsf_req->qtcb->header.fsf_status_qual.word[0],
3439 sizeof (u32));
3440 break;
3442 break;
3444 case FSF_GOOD:
3445 ZFCP_LOG_TRACE("unit 0x%016Lx on port 0x%016Lx on adapter %s "
3446 "closed, port handle 0x%x\n",
3447 unit->fcp_lun,
3448 unit->port->wwpn,
3449 zfcp_get_busid_by_unit(unit),
3450 unit->handle);
3451 /* mark unit as closed */
3452 atomic_clear_mask(ZFCP_STATUS_COMMON_OPEN, &unit->status);
3453 retval = 0;
3454 break;
3456 default:
3457 ZFCP_LOG_NORMAL("bug: An unknown FSF Status was presented "
3458 "(debug info 0x%x)\n",
3459 fsf_req->qtcb->header.fsf_status);
3460 debug_text_event(fsf_req->adapter->erp_dbf, 0, "fsf_s_inval:");
3461 debug_exception(fsf_req->adapter->erp_dbf, 0,
3462 &fsf_req->qtcb->header.fsf_status,
3463 sizeof (u32));
3464 break;
3467 skip_fsfstatus:
3468 atomic_clear_mask(ZFCP_STATUS_COMMON_CLOSING, &unit->status);
3469 return retval;
3473 * zfcp_fsf_send_fcp_command_task - initiate an FCP command (for a SCSI command)
3474 * @adapter: adapter where scsi command is issued
3475 * @unit: unit where command is sent to
3476 * @scsi_cmnd: scsi command to be sent
3477 * @timer: timer to be started when request is initiated
3478 * @req_flags: flags for fsf_request
3481 zfcp_fsf_send_fcp_command_task(struct zfcp_adapter *adapter,
3482 struct zfcp_unit *unit,
3483 struct scsi_cmnd * scsi_cmnd,
3484 int use_timer, int req_flags)
3486 struct zfcp_fsf_req *fsf_req = NULL;
3487 struct fcp_cmnd_iu *fcp_cmnd_iu;
3488 unsigned int sbtype;
3489 unsigned long lock_flags;
3490 int real_bytes = 0;
3491 int retval = 0;
3492 int mask;
3494 /* setup new FSF request */
3495 retval = zfcp_fsf_req_create(adapter, FSF_QTCB_FCP_CMND, req_flags,
3496 adapter->pool.fsf_req_scsi,
3497 &lock_flags, &fsf_req);
3498 if (unlikely(retval < 0)) {
3499 ZFCP_LOG_DEBUG("error: Could not create FCP command request "
3500 "for unit 0x%016Lx on port 0x%016Lx on "
3501 "adapter %s\n",
3502 unit->fcp_lun,
3503 unit->port->wwpn,
3504 zfcp_get_busid_by_adapter(adapter));
3505 goto failed_req_create;
3508 zfcp_unit_get(unit);
3509 fsf_req->unit = unit;
3511 /* associate FSF request with SCSI request (for look up on abort) */
3512 scsi_cmnd->host_scribble = (unsigned char *) fsf_req->req_id;
3514 /* associate SCSI command with FSF request */
3515 fsf_req->data = (unsigned long) scsi_cmnd;
3517 /* set handles of unit and its parent port in QTCB */
3518 fsf_req->qtcb->header.lun_handle = unit->handle;
3519 fsf_req->qtcb->header.port_handle = unit->port->handle;
3521 /* FSF does not define the structure of the FCP_CMND IU */
3522 fcp_cmnd_iu = (struct fcp_cmnd_iu *)
3523 &(fsf_req->qtcb->bottom.io.fcp_cmnd);
3526 * set depending on data direction:
3527 * data direction bits in SBALE (SB Type)
3528 * data direction bits in QTCB
3529 * data direction bits in FCP_CMND IU
3531 switch (scsi_cmnd->sc_data_direction) {
3532 case DMA_NONE:
3533 fsf_req->qtcb->bottom.io.data_direction = FSF_DATADIR_CMND;
3535 * FIXME(qdio):
3536 * what is the correct type for commands
3537 * without 'real' data buffers?
3539 sbtype = SBAL_FLAGS0_TYPE_READ;
3540 break;
3541 case DMA_FROM_DEVICE:
3542 fsf_req->qtcb->bottom.io.data_direction = FSF_DATADIR_READ;
3543 sbtype = SBAL_FLAGS0_TYPE_READ;
3544 fcp_cmnd_iu->rddata = 1;
3545 break;
3546 case DMA_TO_DEVICE:
3547 fsf_req->qtcb->bottom.io.data_direction = FSF_DATADIR_WRITE;
3548 sbtype = SBAL_FLAGS0_TYPE_WRITE;
3549 fcp_cmnd_iu->wddata = 1;
3550 break;
3551 case DMA_BIDIRECTIONAL:
3552 default:
3554 * dummy, catch this condition earlier
3555 * in zfcp_scsi_queuecommand
3557 goto failed_scsi_cmnd;
3560 /* set FC service class in QTCB (3 per default) */
3561 fsf_req->qtcb->bottom.io.service_class = ZFCP_FC_SERVICE_CLASS_DEFAULT;
3563 /* set FCP_LUN in FCP_CMND IU in QTCB */
3564 fcp_cmnd_iu->fcp_lun = unit->fcp_lun;
3566 mask = ZFCP_STATUS_UNIT_READONLY | ZFCP_STATUS_UNIT_SHARED;
3568 /* set task attributes in FCP_CMND IU in QTCB */
3569 if (likely((scsi_cmnd->device->simple_tags) ||
3570 (atomic_test_mask(mask, &unit->status))))
3571 fcp_cmnd_iu->task_attribute = SIMPLE_Q;
3572 else
3573 fcp_cmnd_iu->task_attribute = UNTAGGED;
3575 /* set additional length of FCP_CDB in FCP_CMND IU in QTCB, if needed */
3576 if (unlikely(scsi_cmnd->cmd_len > FCP_CDB_LENGTH)) {
3577 fcp_cmnd_iu->add_fcp_cdb_length
3578 = (scsi_cmnd->cmd_len - FCP_CDB_LENGTH) >> 2;
3579 ZFCP_LOG_TRACE("SCSI CDB length is 0x%x, "
3580 "additional FCP_CDB length is 0x%x "
3581 "(shifted right 2 bits)\n",
3582 scsi_cmnd->cmd_len,
3583 fcp_cmnd_iu->add_fcp_cdb_length);
3586 * copy SCSI CDB (including additional length, if any) to
3587 * FCP_CDB in FCP_CMND IU in QTCB
3589 memcpy(fcp_cmnd_iu->fcp_cdb, scsi_cmnd->cmnd, scsi_cmnd->cmd_len);
3591 /* FCP CMND IU length in QTCB */
3592 fsf_req->qtcb->bottom.io.fcp_cmnd_length =
3593 sizeof (struct fcp_cmnd_iu) +
3594 fcp_cmnd_iu->add_fcp_cdb_length + sizeof (fcp_dl_t);
3596 /* generate SBALEs from data buffer */
3597 real_bytes = zfcp_qdio_sbals_from_scsicmnd(fsf_req, sbtype, scsi_cmnd);
3598 if (unlikely(real_bytes < 0)) {
3599 if (fsf_req->sbal_number < ZFCP_MAX_SBALS_PER_REQ) {
3600 ZFCP_LOG_DEBUG(
3601 "Data did not fit into available buffer(s), "
3602 "waiting for more...\n");
3603 retval = -EIO;
3604 } else {
3605 ZFCP_LOG_NORMAL("error: No truncation implemented but "
3606 "required. Shutting down unit "
3607 "(adapter %s, port 0x%016Lx, "
3608 "unit 0x%016Lx)\n",
3609 zfcp_get_busid_by_unit(unit),
3610 unit->port->wwpn,
3611 unit->fcp_lun);
3612 zfcp_erp_unit_shutdown(unit, 0);
3613 retval = -EINVAL;
3615 goto no_fit;
3618 /* set length of FCP data length in FCP_CMND IU in QTCB */
3619 zfcp_set_fcp_dl(fcp_cmnd_iu, real_bytes);
3621 ZFCP_LOG_DEBUG("Sending SCSI command:\n");
3622 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
3623 (char *) scsi_cmnd->cmnd, scsi_cmnd->cmd_len);
3625 if (use_timer)
3626 zfcp_fsf_start_timer(fsf_req, ZFCP_FSF_REQUEST_TIMEOUT);
3628 retval = zfcp_fsf_req_send(fsf_req);
3629 if (unlikely(retval < 0)) {
3630 ZFCP_LOG_INFO("error: Could not send FCP command request "
3631 "on adapter %s, port 0x%016Lx, unit 0x%016Lx\n",
3632 zfcp_get_busid_by_adapter(adapter),
3633 unit->port->wwpn,
3634 unit->fcp_lun);
3635 goto send_failed;
3638 ZFCP_LOG_TRACE("Send FCP Command initiated (adapter %s, "
3639 "port 0x%016Lx, unit 0x%016Lx)\n",
3640 zfcp_get_busid_by_adapter(adapter),
3641 unit->port->wwpn,
3642 unit->fcp_lun);
3643 goto success;
3645 send_failed:
3646 no_fit:
3647 failed_scsi_cmnd:
3648 zfcp_unit_put(unit);
3649 zfcp_fsf_req_free(fsf_req);
3650 fsf_req = NULL;
3651 scsi_cmnd->host_scribble = NULL;
3652 success:
3653 failed_req_create:
3654 write_unlock_irqrestore(&adapter->request_queue.queue_lock, lock_flags);
3655 return retval;
3658 struct zfcp_fsf_req *
3659 zfcp_fsf_send_fcp_command_task_management(struct zfcp_adapter *adapter,
3660 struct zfcp_unit *unit,
3661 u8 tm_flags, int req_flags)
3663 struct zfcp_fsf_req *fsf_req = NULL;
3664 int retval = 0;
3665 struct fcp_cmnd_iu *fcp_cmnd_iu;
3666 unsigned long lock_flags;
3667 volatile struct qdio_buffer_element *sbale;
3669 /* setup new FSF request */
3670 retval = zfcp_fsf_req_create(adapter, FSF_QTCB_FCP_CMND, req_flags,
3671 adapter->pool.fsf_req_scsi,
3672 &lock_flags, &fsf_req);
3673 if (retval < 0) {
3674 ZFCP_LOG_INFO("error: Could not create FCP command (task "
3675 "management) request for adapter %s, port "
3676 " 0x%016Lx, unit 0x%016Lx.\n",
3677 zfcp_get_busid_by_adapter(adapter),
3678 unit->port->wwpn, unit->fcp_lun);
3679 goto out;
3683 * Used to decide on proper handler in the return path,
3684 * could be either zfcp_fsf_send_fcp_command_task_handler or
3685 * zfcp_fsf_send_fcp_command_task_management_handler */
3687 fsf_req->status |= ZFCP_STATUS_FSFREQ_TASK_MANAGEMENT;
3690 * hold a pointer to the unit being target of this
3691 * task management request
3693 fsf_req->data = (unsigned long) unit;
3695 /* set FSF related fields in QTCB */
3696 fsf_req->qtcb->header.lun_handle = unit->handle;
3697 fsf_req->qtcb->header.port_handle = unit->port->handle;
3698 fsf_req->qtcb->bottom.io.data_direction = FSF_DATADIR_CMND;
3699 fsf_req->qtcb->bottom.io.service_class = ZFCP_FC_SERVICE_CLASS_DEFAULT;
3700 fsf_req->qtcb->bottom.io.fcp_cmnd_length =
3701 sizeof (struct fcp_cmnd_iu) + sizeof (fcp_dl_t);
3703 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
3704 sbale[0].flags |= SBAL_FLAGS0_TYPE_WRITE;
3705 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
3707 /* set FCP related fields in FCP_CMND IU in QTCB */
3708 fcp_cmnd_iu = (struct fcp_cmnd_iu *)
3709 &(fsf_req->qtcb->bottom.io.fcp_cmnd);
3710 fcp_cmnd_iu->fcp_lun = unit->fcp_lun;
3711 fcp_cmnd_iu->task_management_flags = tm_flags;
3713 zfcp_fsf_start_timer(fsf_req, ZFCP_SCSI_ER_TIMEOUT);
3714 retval = zfcp_fsf_req_send(fsf_req);
3715 if (retval) {
3716 ZFCP_LOG_INFO("error: Could not send an FCP-command (task "
3717 "management) on adapter %s, port 0x%016Lx for "
3718 "unit LUN 0x%016Lx\n",
3719 zfcp_get_busid_by_adapter(adapter),
3720 unit->port->wwpn,
3721 unit->fcp_lun);
3722 zfcp_fsf_req_free(fsf_req);
3723 fsf_req = NULL;
3724 goto out;
3727 ZFCP_LOG_TRACE("Send FCP Command (task management function) initiated "
3728 "(adapter %s, port 0x%016Lx, unit 0x%016Lx, "
3729 "tm_flags=0x%x)\n",
3730 zfcp_get_busid_by_adapter(adapter),
3731 unit->port->wwpn,
3732 unit->fcp_lun,
3733 tm_flags);
3734 out:
3735 write_unlock_irqrestore(&adapter->request_queue.queue_lock, lock_flags);
3736 return fsf_req;
3740 * function: zfcp_fsf_send_fcp_command_handler
3742 * purpose: is called for finished Send FCP Command
3744 * returns:
3746 static int
3747 zfcp_fsf_send_fcp_command_handler(struct zfcp_fsf_req *fsf_req)
3749 int retval = -EINVAL;
3750 struct zfcp_unit *unit;
3751 struct fsf_qtcb_header *header;
3752 u16 subtable, rule, counter;
3754 header = &fsf_req->qtcb->header;
3756 if (unlikely(fsf_req->status & ZFCP_STATUS_FSFREQ_TASK_MANAGEMENT))
3757 unit = (struct zfcp_unit *) fsf_req->data;
3758 else
3759 unit = fsf_req->unit;
3761 if (unlikely(fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR)) {
3762 /* go directly to calls of special handlers */
3763 goto skip_fsfstatus;
3766 /* evaluate FSF status in QTCB */
3767 switch (header->fsf_status) {
3769 case FSF_PORT_HANDLE_NOT_VALID:
3770 ZFCP_LOG_INFO("Temporary port identifier 0x%x for port "
3771 "0x%016Lx on adapter %s invalid\n",
3772 unit->port->handle,
3773 unit->port->wwpn, zfcp_get_busid_by_unit(unit));
3774 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
3775 (char *) &header->fsf_status_qual,
3776 sizeof (union fsf_status_qual));
3777 debug_text_event(fsf_req->adapter->erp_dbf, 1,
3778 "fsf_s_phand_nv");
3779 zfcp_erp_adapter_reopen(unit->port->adapter, 0);
3780 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3781 break;
3783 case FSF_LUN_HANDLE_NOT_VALID:
3784 ZFCP_LOG_INFO("Temporary LUN identifier 0x%x for unit "
3785 "0x%016Lx on port 0x%016Lx on adapter %s is "
3786 "invalid. This may happen occasionally.\n",
3787 unit->handle,
3788 unit->fcp_lun,
3789 unit->port->wwpn,
3790 zfcp_get_busid_by_unit(unit));
3791 ZFCP_LOG_NORMAL("Status qualifier data:\n");
3792 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_NORMAL,
3793 (char *) &header->fsf_status_qual,
3794 sizeof (union fsf_status_qual));
3795 debug_text_event(fsf_req->adapter->erp_dbf, 1,
3796 "fsf_s_uhand_nv");
3797 zfcp_erp_port_reopen(unit->port, 0);
3798 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3799 break;
3801 case FSF_HANDLE_MISMATCH:
3802 ZFCP_LOG_NORMAL("bug: The port handle 0x%x has changed "
3803 "unexpectedly. (adapter %s, port 0x%016Lx, "
3804 "unit 0x%016Lx)\n",
3805 unit->port->handle,
3806 zfcp_get_busid_by_unit(unit),
3807 unit->port->wwpn,
3808 unit->fcp_lun);
3809 ZFCP_LOG_NORMAL("status qualifier:\n");
3810 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_NORMAL,
3811 (char *) &header->fsf_status_qual,
3812 sizeof (union fsf_status_qual));
3813 debug_text_event(fsf_req->adapter->erp_dbf, 1,
3814 "fsf_s_hand_mis");
3815 zfcp_erp_adapter_reopen(unit->port->adapter, 0);
3816 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3817 break;
3819 case FSF_SERVICE_CLASS_NOT_SUPPORTED:
3820 ZFCP_LOG_INFO("error: adapter %s does not support fc "
3821 "class %d.\n",
3822 zfcp_get_busid_by_unit(unit),
3823 ZFCP_FC_SERVICE_CLASS_DEFAULT);
3824 /* stop operation for this adapter */
3825 debug_text_exception(fsf_req->adapter->erp_dbf, 0,
3826 "fsf_s_class_nsup");
3827 zfcp_erp_adapter_shutdown(unit->port->adapter, 0);
3828 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3829 break;
3831 case FSF_FCPLUN_NOT_VALID:
3832 ZFCP_LOG_NORMAL("bug: unit 0x%016Lx on port 0x%016Lx on "
3833 "adapter %s does not have correct unit "
3834 "handle 0x%x\n",
3835 unit->fcp_lun,
3836 unit->port->wwpn,
3837 zfcp_get_busid_by_unit(unit),
3838 unit->handle);
3839 ZFCP_LOG_DEBUG("status qualifier:\n");
3840 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
3841 (char *) &header->fsf_status_qual,
3842 sizeof (union fsf_status_qual));
3843 debug_text_event(fsf_req->adapter->erp_dbf, 1,
3844 "fsf_s_fcp_lun_nv");
3845 zfcp_erp_port_reopen(unit->port, 0);
3846 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3847 break;
3849 case FSF_ACCESS_DENIED:
3850 ZFCP_LOG_NORMAL("Access denied, cannot send FCP command to "
3851 "unit 0x%016Lx on port 0x%016Lx on "
3852 "adapter %s\n", unit->fcp_lun, unit->port->wwpn,
3853 zfcp_get_busid_by_unit(unit));
3854 for (counter = 0; counter < 2; counter++) {
3855 subtable = header->fsf_status_qual.halfword[counter * 2];
3856 rule = header->fsf_status_qual.halfword[counter * 2 + 1];
3857 switch (subtable) {
3858 case FSF_SQ_CFDC_SUBTABLE_OS:
3859 case FSF_SQ_CFDC_SUBTABLE_PORT_WWPN:
3860 case FSF_SQ_CFDC_SUBTABLE_PORT_DID:
3861 case FSF_SQ_CFDC_SUBTABLE_LUN:
3862 ZFCP_LOG_INFO("Access denied (%s rule %d)\n",
3863 zfcp_act_subtable_type[subtable], rule);
3864 break;
3867 debug_text_event(fsf_req->adapter->erp_dbf, 1, "fsf_s_access");
3868 zfcp_erp_unit_access_denied(unit);
3869 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3870 break;
3872 case FSF_DIRECTION_INDICATOR_NOT_VALID:
3873 ZFCP_LOG_INFO("bug: Invalid data direction given for unit "
3874 "0x%016Lx on port 0x%016Lx on adapter %s "
3875 "(debug info %d)\n",
3876 unit->fcp_lun,
3877 unit->port->wwpn,
3878 zfcp_get_busid_by_unit(unit),
3879 fsf_req->qtcb->bottom.io.data_direction);
3880 /* stop operation for this adapter */
3881 debug_text_event(fsf_req->adapter->erp_dbf, 0,
3882 "fsf_s_dir_ind_nv");
3883 zfcp_erp_adapter_shutdown(unit->port->adapter, 0);
3884 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3885 break;
3887 case FSF_CMND_LENGTH_NOT_VALID:
3888 ZFCP_LOG_NORMAL
3889 ("bug: An invalid control-data-block length field "
3890 "was found in a command for unit 0x%016Lx on port "
3891 "0x%016Lx on adapter %s " "(debug info %d)\n",
3892 unit->fcp_lun, unit->port->wwpn,
3893 zfcp_get_busid_by_unit(unit),
3894 fsf_req->qtcb->bottom.io.fcp_cmnd_length);
3895 /* stop operation for this adapter */
3896 debug_text_event(fsf_req->adapter->erp_dbf, 0,
3897 "fsf_s_cmd_len_nv");
3898 zfcp_erp_adapter_shutdown(unit->port->adapter, 0);
3899 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3900 break;
3902 case FSF_PORT_BOXED:
3903 ZFCP_LOG_DEBUG("The remote port 0x%016Lx on adapter %s "
3904 "needs to be reopened\n",
3905 unit->port->wwpn, zfcp_get_busid_by_unit(unit));
3906 debug_text_event(fsf_req->adapter->erp_dbf, 2, "fsf_s_pboxed");
3907 zfcp_erp_port_boxed(unit->port);
3908 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR |
3909 ZFCP_STATUS_FSFREQ_RETRY;
3910 break;
3912 case FSF_LUN_BOXED:
3913 ZFCP_LOG_NORMAL("unit needs to be reopened (adapter %s, "
3914 "wwpn=0x%016Lx, fcp_lun=0x%016Lx)\n",
3915 zfcp_get_busid_by_unit(unit),
3916 unit->port->wwpn, unit->fcp_lun);
3917 debug_text_event(fsf_req->adapter->erp_dbf, 1, "fsf_s_lboxed");
3918 zfcp_erp_unit_boxed(unit);
3919 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR
3920 | ZFCP_STATUS_FSFREQ_RETRY;
3921 break;
3923 case FSF_ADAPTER_STATUS_AVAILABLE:
3924 switch (header->fsf_status_qual.word[0]) {
3925 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
3926 /* re-establish link to port */
3927 debug_text_event(fsf_req->adapter->erp_dbf, 1,
3928 "fsf_sq_ltest");
3929 zfcp_test_link(unit->port);
3930 break;
3931 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
3932 /* FIXME(hw) need proper specs for proper action */
3933 /* let scsi stack deal with retries and escalation */
3934 debug_text_event(fsf_req->adapter->erp_dbf, 1,
3935 "fsf_sq_ulp");
3936 break;
3937 default:
3938 ZFCP_LOG_NORMAL
3939 ("Unknown status qualifier 0x%x arrived.\n",
3940 header->fsf_status_qual.word[0]);
3941 debug_text_event(fsf_req->adapter->erp_dbf, 0,
3942 "fsf_sq_inval:");
3943 debug_exception(fsf_req->adapter->erp_dbf, 0,
3944 &header->fsf_status_qual.word[0],
3945 sizeof(u32));
3946 break;
3948 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
3949 break;
3951 case FSF_GOOD:
3952 break;
3954 case FSF_FCP_RSP_AVAILABLE:
3955 break;
3957 default:
3958 debug_text_event(fsf_req->adapter->erp_dbf, 0, "fsf_s_inval:");
3959 debug_exception(fsf_req->adapter->erp_dbf, 0,
3960 &header->fsf_status, sizeof(u32));
3961 break;
3964 skip_fsfstatus:
3965 if (fsf_req->status & ZFCP_STATUS_FSFREQ_TASK_MANAGEMENT) {
3966 retval =
3967 zfcp_fsf_send_fcp_command_task_management_handler(fsf_req);
3968 } else {
3969 retval = zfcp_fsf_send_fcp_command_task_handler(fsf_req);
3970 fsf_req->unit = NULL;
3971 zfcp_unit_put(unit);
3973 return retval;
3977 * function: zfcp_fsf_send_fcp_command_task_handler
3979 * purpose: evaluates FCP_RSP IU
3981 * returns:
3983 static int
3984 zfcp_fsf_send_fcp_command_task_handler(struct zfcp_fsf_req *fsf_req)
3986 int retval = 0;
3987 struct scsi_cmnd *scpnt;
3988 struct fcp_rsp_iu *fcp_rsp_iu = (struct fcp_rsp_iu *)
3989 &(fsf_req->qtcb->bottom.io.fcp_rsp);
3990 struct fcp_cmnd_iu *fcp_cmnd_iu = (struct fcp_cmnd_iu *)
3991 &(fsf_req->qtcb->bottom.io.fcp_cmnd);
3992 u32 sns_len;
3993 char *fcp_rsp_info = zfcp_get_fcp_rsp_info_ptr(fcp_rsp_iu);
3994 unsigned long flags;
3995 struct zfcp_unit *unit = fsf_req->unit;
3997 read_lock_irqsave(&fsf_req->adapter->abort_lock, flags);
3998 scpnt = (struct scsi_cmnd *) fsf_req->data;
3999 if (unlikely(!scpnt)) {
4000 ZFCP_LOG_DEBUG
4001 ("Command with fsf_req %p is not associated to "
4002 "a scsi command anymore. Aborted?\n", fsf_req);
4003 goto out;
4005 if (unlikely(fsf_req->status & ZFCP_STATUS_FSFREQ_ABORTED)) {
4006 /* FIXME: (design) mid-layer should handle DID_ABORT like
4007 * DID_SOFT_ERROR by retrying the request for devices
4008 * that allow retries.
4010 ZFCP_LOG_DEBUG("Setting DID_SOFT_ERROR and SUGGEST_RETRY\n");
4011 set_host_byte(&scpnt->result, DID_SOFT_ERROR);
4012 set_driver_byte(&scpnt->result, SUGGEST_RETRY);
4013 goto skip_fsfstatus;
4016 if (unlikely(fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR)) {
4017 ZFCP_LOG_DEBUG("Setting DID_ERROR\n");
4018 set_host_byte(&scpnt->result, DID_ERROR);
4019 goto skip_fsfstatus;
4022 /* set message byte of result in SCSI command */
4023 scpnt->result |= COMMAND_COMPLETE << 8;
4026 * copy SCSI status code of FCP_STATUS of FCP_RSP IU to status byte
4027 * of result in SCSI command
4029 scpnt->result |= fcp_rsp_iu->scsi_status;
4030 if (unlikely(fcp_rsp_iu->scsi_status)) {
4031 /* DEBUG */
4032 ZFCP_LOG_DEBUG("status for SCSI Command:\n");
4033 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
4034 scpnt->cmnd, scpnt->cmd_len);
4035 ZFCP_LOG_DEBUG("SCSI status code 0x%x\n",
4036 fcp_rsp_iu->scsi_status);
4037 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
4038 (void *) fcp_rsp_iu, sizeof (struct fcp_rsp_iu));
4039 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
4040 zfcp_get_fcp_sns_info_ptr(fcp_rsp_iu),
4041 fcp_rsp_iu->fcp_sns_len);
4044 /* check FCP_RSP_INFO */
4045 if (unlikely(fcp_rsp_iu->validity.bits.fcp_rsp_len_valid)) {
4046 ZFCP_LOG_DEBUG("rsp_len is valid\n");
4047 switch (fcp_rsp_info[3]) {
4048 case RSP_CODE_GOOD:
4049 /* ok, continue */
4050 ZFCP_LOG_TRACE("no failure or Task Management "
4051 "Function complete\n");
4052 set_host_byte(&scpnt->result, DID_OK);
4053 break;
4054 case RSP_CODE_LENGTH_MISMATCH:
4055 /* hardware bug */
4056 ZFCP_LOG_NORMAL("bug: FCP response code indictates "
4057 "that the fibrechannel protocol data "
4058 "length differs from the burst length. "
4059 "The problem occured on unit 0x%016Lx "
4060 "on port 0x%016Lx on adapter %s",
4061 unit->fcp_lun,
4062 unit->port->wwpn,
4063 zfcp_get_busid_by_unit(unit));
4064 /* dump SCSI CDB as prepared by zfcp */
4065 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
4066 (char *) &fsf_req->qtcb->
4067 bottom.io.fcp_cmnd, FSF_FCP_CMND_SIZE);
4068 set_host_byte(&scpnt->result, DID_ERROR);
4069 goto skip_fsfstatus;
4070 case RSP_CODE_FIELD_INVALID:
4071 /* driver or hardware bug */
4072 ZFCP_LOG_NORMAL("bug: FCP response code indictates "
4073 "that the fibrechannel protocol data "
4074 "fields were incorrectly set up. "
4075 "The problem occured on the unit "
4076 "0x%016Lx on port 0x%016Lx on "
4077 "adapter %s",
4078 unit->fcp_lun,
4079 unit->port->wwpn,
4080 zfcp_get_busid_by_unit(unit));
4081 /* dump SCSI CDB as prepared by zfcp */
4082 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
4083 (char *) &fsf_req->qtcb->
4084 bottom.io.fcp_cmnd, FSF_FCP_CMND_SIZE);
4085 set_host_byte(&scpnt->result, DID_ERROR);
4086 goto skip_fsfstatus;
4087 case RSP_CODE_RO_MISMATCH:
4088 /* hardware bug */
4089 ZFCP_LOG_NORMAL("bug: The FCP response code indicates "
4090 "that conflicting values for the "
4091 "fibrechannel payload offset from the "
4092 "header were found. "
4093 "The problem occured on unit 0x%016Lx "
4094 "on port 0x%016Lx on adapter %s.\n",
4095 unit->fcp_lun,
4096 unit->port->wwpn,
4097 zfcp_get_busid_by_unit(unit));
4098 /* dump SCSI CDB as prepared by zfcp */
4099 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
4100 (char *) &fsf_req->qtcb->
4101 bottom.io.fcp_cmnd, FSF_FCP_CMND_SIZE);
4102 set_host_byte(&scpnt->result, DID_ERROR);
4103 goto skip_fsfstatus;
4104 default:
4105 ZFCP_LOG_NORMAL("bug: An invalid FCP response "
4106 "code was detected for a command. "
4107 "The problem occured on the unit "
4108 "0x%016Lx on port 0x%016Lx on "
4109 "adapter %s (debug info 0x%x)\n",
4110 unit->fcp_lun,
4111 unit->port->wwpn,
4112 zfcp_get_busid_by_unit(unit),
4113 fcp_rsp_info[3]);
4114 /* dump SCSI CDB as prepared by zfcp */
4115 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_DEBUG,
4116 (char *) &fsf_req->qtcb->
4117 bottom.io.fcp_cmnd, FSF_FCP_CMND_SIZE);
4118 set_host_byte(&scpnt->result, DID_ERROR);
4119 goto skip_fsfstatus;
4123 /* check for sense data */
4124 if (unlikely(fcp_rsp_iu->validity.bits.fcp_sns_len_valid)) {
4125 sns_len = FSF_FCP_RSP_SIZE -
4126 sizeof (struct fcp_rsp_iu) + fcp_rsp_iu->fcp_rsp_len;
4127 ZFCP_LOG_TRACE("room for %i bytes sense data in QTCB\n",
4128 sns_len);
4129 sns_len = min(sns_len, (u32) SCSI_SENSE_BUFFERSIZE);
4130 ZFCP_LOG_TRACE("room for %i bytes sense data in SCSI command\n",
4131 SCSI_SENSE_BUFFERSIZE);
4132 sns_len = min(sns_len, fcp_rsp_iu->fcp_sns_len);
4133 ZFCP_LOG_TRACE("scpnt->result =0x%x, command was:\n",
4134 scpnt->result);
4135 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_TRACE,
4136 (void *) &scpnt->cmnd, scpnt->cmd_len);
4138 ZFCP_LOG_TRACE("%i bytes sense data provided by FCP\n",
4139 fcp_rsp_iu->fcp_sns_len);
4140 memcpy(&scpnt->sense_buffer,
4141 zfcp_get_fcp_sns_info_ptr(fcp_rsp_iu), sns_len);
4142 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_TRACE,
4143 (void *) &scpnt->sense_buffer, sns_len);
4146 /* check for overrun */
4147 if (unlikely(fcp_rsp_iu->validity.bits.fcp_resid_over)) {
4148 ZFCP_LOG_INFO("A data overrun was detected for a command. "
4149 "unit 0x%016Lx, port 0x%016Lx, adapter %s. "
4150 "The response data length is "
4151 "%d, the original length was %d.\n",
4152 unit->fcp_lun,
4153 unit->port->wwpn,
4154 zfcp_get_busid_by_unit(unit),
4155 fcp_rsp_iu->fcp_resid,
4156 (int) zfcp_get_fcp_dl(fcp_cmnd_iu));
4159 /* check for underrun */
4160 if (unlikely(fcp_rsp_iu->validity.bits.fcp_resid_under)) {
4161 ZFCP_LOG_INFO("A data underrun was detected for a command. "
4162 "unit 0x%016Lx, port 0x%016Lx, adapter %s. "
4163 "The response data length is "
4164 "%d, the original length was %d.\n",
4165 unit->fcp_lun,
4166 unit->port->wwpn,
4167 zfcp_get_busid_by_unit(unit),
4168 fcp_rsp_iu->fcp_resid,
4169 (int) zfcp_get_fcp_dl(fcp_cmnd_iu));
4171 scpnt->resid = fcp_rsp_iu->fcp_resid;
4172 if (scpnt->request_bufflen - scpnt->resid < scpnt->underflow)
4173 set_host_byte(&scpnt->result, DID_ERROR);
4176 skip_fsfstatus:
4177 ZFCP_LOG_DEBUG("scpnt->result =0x%x\n", scpnt->result);
4179 if (scpnt->result != 0)
4180 zfcp_scsi_dbf_event_result("erro", 3, fsf_req->adapter, scpnt, fsf_req);
4181 else if (scpnt->retries > 0)
4182 zfcp_scsi_dbf_event_result("retr", 4, fsf_req->adapter, scpnt, fsf_req);
4183 else
4184 zfcp_scsi_dbf_event_result("norm", 6, fsf_req->adapter, scpnt, fsf_req);
4186 /* cleanup pointer (need this especially for abort) */
4187 scpnt->host_scribble = NULL;
4189 /* always call back */
4190 (scpnt->scsi_done) (scpnt);
4193 * We must hold this lock until scsi_done has been called.
4194 * Otherwise we may call scsi_done after abort regarding this
4195 * command has completed.
4196 * Note: scsi_done must not block!
4198 out:
4199 read_unlock_irqrestore(&fsf_req->adapter->abort_lock, flags);
4200 return retval;
4204 * function: zfcp_fsf_send_fcp_command_task_management_handler
4206 * purpose: evaluates FCP_RSP IU
4208 * returns:
4210 static int
4211 zfcp_fsf_send_fcp_command_task_management_handler(struct zfcp_fsf_req *fsf_req)
4213 int retval = 0;
4214 struct fcp_rsp_iu *fcp_rsp_iu = (struct fcp_rsp_iu *)
4215 &(fsf_req->qtcb->bottom.io.fcp_rsp);
4216 char *fcp_rsp_info = zfcp_get_fcp_rsp_info_ptr(fcp_rsp_iu);
4217 struct zfcp_unit *unit = (struct zfcp_unit *) fsf_req->data;
4219 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR) {
4220 fsf_req->status |= ZFCP_STATUS_FSFREQ_TMFUNCFAILED;
4221 goto skip_fsfstatus;
4224 /* check FCP_RSP_INFO */
4225 switch (fcp_rsp_info[3]) {
4226 case RSP_CODE_GOOD:
4227 /* ok, continue */
4228 ZFCP_LOG_DEBUG("no failure or Task Management "
4229 "Function complete\n");
4230 break;
4231 case RSP_CODE_TASKMAN_UNSUPP:
4232 ZFCP_LOG_NORMAL("bug: A reuested task management function "
4233 "is not supported on the target device "
4234 "unit 0x%016Lx, port 0x%016Lx, adapter %s\n ",
4235 unit->fcp_lun,
4236 unit->port->wwpn,
4237 zfcp_get_busid_by_unit(unit));
4238 fsf_req->status |= ZFCP_STATUS_FSFREQ_TMFUNCNOTSUPP;
4239 break;
4240 case RSP_CODE_TASKMAN_FAILED:
4241 ZFCP_LOG_NORMAL("bug: A reuested task management function "
4242 "failed to complete successfully. "
4243 "unit 0x%016Lx, port 0x%016Lx, adapter %s.\n",
4244 unit->fcp_lun,
4245 unit->port->wwpn,
4246 zfcp_get_busid_by_unit(unit));
4247 fsf_req->status |= ZFCP_STATUS_FSFREQ_TMFUNCFAILED;
4248 break;
4249 default:
4250 ZFCP_LOG_NORMAL("bug: An invalid FCP response "
4251 "code was detected for a command. "
4252 "unit 0x%016Lx, port 0x%016Lx, adapter %s "
4253 "(debug info 0x%x)\n",
4254 unit->fcp_lun,
4255 unit->port->wwpn,
4256 zfcp_get_busid_by_unit(unit),
4257 fcp_rsp_info[3]);
4258 fsf_req->status |= ZFCP_STATUS_FSFREQ_TMFUNCFAILED;
4261 skip_fsfstatus:
4262 return retval;
4267 * function: zfcp_fsf_control_file
4269 * purpose: Initiator of the control file upload/download FSF requests
4271 * returns: 0 - FSF request is successfuly created and queued
4272 * -EOPNOTSUPP - The FCP adapter does not have Control File support
4273 * -EINVAL - Invalid direction specified
4274 * -ENOMEM - Insufficient memory
4275 * -EPERM - Cannot create FSF request or place it in QDIO queue
4278 zfcp_fsf_control_file(struct zfcp_adapter *adapter,
4279 struct zfcp_fsf_req **fsf_req_ptr,
4280 u32 fsf_command,
4281 u32 option,
4282 struct zfcp_sg_list *sg_list)
4284 struct zfcp_fsf_req *fsf_req;
4285 struct fsf_qtcb_bottom_support *bottom;
4286 volatile struct qdio_buffer_element *sbale;
4287 unsigned long lock_flags;
4288 int req_flags = 0;
4289 int direction;
4290 int retval = 0;
4292 if (!(adapter->adapter_features & FSF_FEATURE_CFDC)) {
4293 ZFCP_LOG_INFO("cfdc not supported (adapter %s)\n",
4294 zfcp_get_busid_by_adapter(adapter));
4295 retval = -EOPNOTSUPP;
4296 goto out;
4299 switch (fsf_command) {
4301 case FSF_QTCB_DOWNLOAD_CONTROL_FILE:
4302 direction = SBAL_FLAGS0_TYPE_WRITE;
4303 if ((option != FSF_CFDC_OPTION_FULL_ACCESS) &&
4304 (option != FSF_CFDC_OPTION_RESTRICTED_ACCESS))
4305 req_flags = ZFCP_WAIT_FOR_SBAL;
4306 break;
4308 case FSF_QTCB_UPLOAD_CONTROL_FILE:
4309 direction = SBAL_FLAGS0_TYPE_READ;
4310 break;
4312 default:
4313 ZFCP_LOG_INFO("Invalid FSF command code 0x%08x\n", fsf_command);
4314 retval = -EINVAL;
4315 goto out;
4318 retval = zfcp_fsf_req_create(adapter, fsf_command, req_flags,
4319 NULL, &lock_flags, &fsf_req);
4320 if (retval < 0) {
4321 ZFCP_LOG_INFO("error: Could not create FSF request for the "
4322 "adapter %s\n",
4323 zfcp_get_busid_by_adapter(adapter));
4324 retval = -EPERM;
4325 goto unlock_queue_lock;
4328 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
4329 sbale[0].flags |= direction;
4331 bottom = &fsf_req->qtcb->bottom.support;
4332 bottom->operation_subtype = FSF_CFDC_OPERATION_SUBTYPE;
4333 bottom->option = option;
4335 if (sg_list->count > 0) {
4336 int bytes;
4338 bytes = zfcp_qdio_sbals_from_sg(fsf_req, direction,
4339 sg_list->sg, sg_list->count,
4340 ZFCP_MAX_SBALS_PER_REQ);
4341 if (bytes != ZFCP_CFDC_MAX_CONTROL_FILE_SIZE) {
4342 ZFCP_LOG_INFO(
4343 "error: Could not create sufficient number of "
4344 "SBALS for an FSF request to the adapter %s\n",
4345 zfcp_get_busid_by_adapter(adapter));
4346 retval = -ENOMEM;
4347 goto free_fsf_req;
4349 } else
4350 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
4352 zfcp_fsf_start_timer(fsf_req, ZFCP_FSF_REQUEST_TIMEOUT);
4353 retval = zfcp_fsf_req_send(fsf_req);
4354 if (retval < 0) {
4355 ZFCP_LOG_INFO("initiation of cfdc up/download failed"
4356 "(adapter %s)\n",
4357 zfcp_get_busid_by_adapter(adapter));
4358 retval = -EPERM;
4359 goto free_fsf_req;
4361 write_unlock_irqrestore(&adapter->request_queue.queue_lock, lock_flags);
4363 ZFCP_LOG_NORMAL("Control file %s FSF request has been sent to the "
4364 "adapter %s\n",
4365 fsf_command == FSF_QTCB_DOWNLOAD_CONTROL_FILE ?
4366 "download" : "upload",
4367 zfcp_get_busid_by_adapter(adapter));
4369 wait_event(fsf_req->completion_wq,
4370 fsf_req->status & ZFCP_STATUS_FSFREQ_COMPLETED);
4372 *fsf_req_ptr = fsf_req;
4373 goto out;
4375 free_fsf_req:
4376 zfcp_fsf_req_free(fsf_req);
4377 unlock_queue_lock:
4378 write_unlock_irqrestore(&adapter->request_queue.queue_lock, lock_flags);
4379 out:
4380 return retval;
4385 * function: zfcp_fsf_control_file_handler
4387 * purpose: Handler of the control file upload/download FSF requests
4389 * returns: 0 - FSF request successfuly processed
4390 * -EAGAIN - Operation has to be repeated because of a temporary problem
4391 * -EACCES - There is no permission to execute an operation
4392 * -EPERM - The control file is not in a right format
4393 * -EIO - There is a problem with the FCP adapter
4394 * -EINVAL - Invalid operation
4395 * -EFAULT - User space memory I/O operation fault
4397 static int
4398 zfcp_fsf_control_file_handler(struct zfcp_fsf_req *fsf_req)
4400 struct zfcp_adapter *adapter = fsf_req->adapter;
4401 struct fsf_qtcb_header *header = &fsf_req->qtcb->header;
4402 struct fsf_qtcb_bottom_support *bottom = &fsf_req->qtcb->bottom.support;
4403 int retval = 0;
4405 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR) {
4406 retval = -EINVAL;
4407 goto skip_fsfstatus;
4410 switch (header->fsf_status) {
4412 case FSF_GOOD:
4413 ZFCP_LOG_NORMAL(
4414 "The FSF request has been successfully completed "
4415 "on the adapter %s\n",
4416 zfcp_get_busid_by_adapter(adapter));
4417 break;
4419 case FSF_OPERATION_PARTIALLY_SUCCESSFUL:
4420 if (bottom->operation_subtype == FSF_CFDC_OPERATION_SUBTYPE) {
4421 switch (header->fsf_status_qual.word[0]) {
4423 case FSF_SQ_CFDC_HARDENED_ON_SE:
4424 ZFCP_LOG_NORMAL(
4425 "CFDC on the adapter %s has being "
4426 "hardened on primary and secondary SE\n",
4427 zfcp_get_busid_by_adapter(adapter));
4428 break;
4430 case FSF_SQ_CFDC_COULD_NOT_HARDEN_ON_SE:
4431 ZFCP_LOG_NORMAL(
4432 "CFDC of the adapter %s could not "
4433 "be saved on the SE\n",
4434 zfcp_get_busid_by_adapter(adapter));
4435 break;
4437 case FSF_SQ_CFDC_COULD_NOT_HARDEN_ON_SE2:
4438 ZFCP_LOG_NORMAL(
4439 "CFDC of the adapter %s could not "
4440 "be copied to the secondary SE\n",
4441 zfcp_get_busid_by_adapter(adapter));
4442 break;
4444 default:
4445 ZFCP_LOG_NORMAL(
4446 "CFDC could not be hardened "
4447 "on the adapter %s\n",
4448 zfcp_get_busid_by_adapter(adapter));
4451 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4452 retval = -EAGAIN;
4453 break;
4455 case FSF_AUTHORIZATION_FAILURE:
4456 ZFCP_LOG_NORMAL(
4457 "Adapter %s does not accept privileged commands\n",
4458 zfcp_get_busid_by_adapter(adapter));
4459 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4460 retval = -EACCES;
4461 break;
4463 case FSF_CFDC_ERROR_DETECTED:
4464 ZFCP_LOG_NORMAL(
4465 "Error at position %d in the CFDC, "
4466 "CFDC is discarded by the adapter %s\n",
4467 header->fsf_status_qual.word[0],
4468 zfcp_get_busid_by_adapter(adapter));
4469 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4470 retval = -EPERM;
4471 break;
4473 case FSF_CONTROL_FILE_UPDATE_ERROR:
4474 ZFCP_LOG_NORMAL(
4475 "Adapter %s cannot harden the control file, "
4476 "file is discarded\n",
4477 zfcp_get_busid_by_adapter(adapter));
4478 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4479 retval = -EIO;
4480 break;
4482 case FSF_CONTROL_FILE_TOO_LARGE:
4483 ZFCP_LOG_NORMAL(
4484 "Control file is too large, file is discarded "
4485 "by the adapter %s\n",
4486 zfcp_get_busid_by_adapter(adapter));
4487 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4488 retval = -EIO;
4489 break;
4491 case FSF_ACCESS_CONFLICT_DETECTED:
4492 if (bottom->operation_subtype == FSF_CFDC_OPERATION_SUBTYPE)
4493 ZFCP_LOG_NORMAL(
4494 "CFDC has been discarded by the adapter %s, "
4495 "because activation would impact "
4496 "%d active connection(s)\n",
4497 zfcp_get_busid_by_adapter(adapter),
4498 header->fsf_status_qual.word[0]);
4499 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4500 retval = -EIO;
4501 break;
4503 case FSF_CONFLICTS_OVERRULED:
4504 if (bottom->operation_subtype == FSF_CFDC_OPERATION_SUBTYPE)
4505 ZFCP_LOG_NORMAL(
4506 "CFDC has been activated on the adapter %s, "
4507 "but activation has impacted "
4508 "%d active connection(s)\n",
4509 zfcp_get_busid_by_adapter(adapter),
4510 header->fsf_status_qual.word[0]);
4511 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4512 retval = -EIO;
4513 break;
4515 case FSF_UNKNOWN_OP_SUBTYPE:
4516 ZFCP_LOG_NORMAL("unknown operation subtype (adapter: %s, "
4517 "op_subtype=0x%x)\n",
4518 zfcp_get_busid_by_adapter(adapter),
4519 bottom->operation_subtype);
4520 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4521 retval = -EINVAL;
4522 break;
4524 case FSF_INVALID_COMMAND_OPTION:
4525 ZFCP_LOG_NORMAL(
4526 "Invalid option 0x%x has been specified "
4527 "in QTCB bottom sent to the adapter %s\n",
4528 bottom->option,
4529 zfcp_get_busid_by_adapter(adapter));
4530 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4531 retval = -EINVAL;
4532 break;
4534 default:
4535 ZFCP_LOG_NORMAL(
4536 "bug: An unknown/unexpected FSF status 0x%08x "
4537 "was presented on the adapter %s\n",
4538 header->fsf_status,
4539 zfcp_get_busid_by_adapter(adapter));
4540 debug_text_event(fsf_req->adapter->erp_dbf, 0, "fsf_sq_inval");
4541 debug_exception(fsf_req->adapter->erp_dbf, 0,
4542 &header->fsf_status_qual.word[0], sizeof(u32));
4543 fsf_req->status |= ZFCP_STATUS_FSFREQ_ERROR;
4544 retval = -EINVAL;
4545 break;
4548 skip_fsfstatus:
4549 return retval;
4552 static inline int
4553 zfcp_fsf_req_sbal_check(unsigned long *flags,
4554 struct zfcp_qdio_queue *queue, int needed)
4556 write_lock_irqsave(&queue->queue_lock, *flags);
4557 if (likely(atomic_read(&queue->free_count) >= needed))
4558 return 1;
4559 write_unlock_irqrestore(&queue->queue_lock, *flags);
4560 return 0;
4564 * set qtcb pointer in fsf_req and initialize QTCB
4566 static void
4567 zfcp_fsf_req_qtcb_init(struct zfcp_fsf_req *fsf_req)
4569 if (likely(fsf_req->qtcb != NULL)) {
4570 fsf_req->qtcb->prefix.req_seq_no =
4571 fsf_req->adapter->fsf_req_seq_no;
4572 fsf_req->qtcb->prefix.req_id = fsf_req->req_id;
4573 fsf_req->qtcb->prefix.ulp_info = ZFCP_ULP_INFO_VERSION;
4574 fsf_req->qtcb->prefix.qtcb_type =
4575 fsf_qtcb_type[fsf_req->fsf_command];
4576 fsf_req->qtcb->prefix.qtcb_version = ZFCP_QTCB_VERSION;
4577 fsf_req->qtcb->header.req_handle = fsf_req->req_id;
4578 fsf_req->qtcb->header.fsf_command = fsf_req->fsf_command;
4583 * zfcp_fsf_req_sbal_get - try to get one SBAL in the request queue
4584 * @adapter: adapter for which request queue is examined
4585 * @req_flags: flags indicating whether to wait for needed SBAL or not
4586 * @lock_flags: lock_flags if queue_lock is taken
4587 * Return: 0 on success, otherwise -EIO, or -ERESTARTSYS
4588 * Locks: lock adapter->request_queue->queue_lock on success
4590 static int
4591 zfcp_fsf_req_sbal_get(struct zfcp_adapter *adapter, int req_flags,
4592 unsigned long *lock_flags)
4594 long ret;
4595 struct zfcp_qdio_queue *req_queue = &adapter->request_queue;
4597 if (unlikely(req_flags & ZFCP_WAIT_FOR_SBAL)) {
4598 ret = wait_event_interruptible_timeout(adapter->request_wq,
4599 zfcp_fsf_req_sbal_check(lock_flags, req_queue, 1),
4600 ZFCP_SBAL_TIMEOUT);
4601 if (ret < 0)
4602 return ret;
4603 if (!ret)
4604 return -EIO;
4605 } else if (!zfcp_fsf_req_sbal_check(lock_flags, req_queue, 1))
4606 return -EIO;
4608 return 0;
4612 * function: zfcp_fsf_req_create
4614 * purpose: create an FSF request at the specified adapter and
4615 * setup common fields
4617 * returns: -ENOMEM if there was insufficient memory for a request
4618 * -EIO if no qdio buffers could be allocate to the request
4619 * -EINVAL/-EPERM on bug conditions in req_dequeue
4620 * 0 in success
4622 * note: The created request is returned by reference.
4624 * locks: lock of concerned request queue must not be held,
4625 * but is held on completion (write, irqsave)
4628 zfcp_fsf_req_create(struct zfcp_adapter *adapter, u32 fsf_cmd, int req_flags,
4629 mempool_t *pool, unsigned long *lock_flags,
4630 struct zfcp_fsf_req **fsf_req_p)
4632 volatile struct qdio_buffer_element *sbale;
4633 struct zfcp_fsf_req *fsf_req = NULL;
4634 int ret = 0;
4635 struct zfcp_qdio_queue *req_queue = &adapter->request_queue;
4637 /* allocate new FSF request */
4638 fsf_req = zfcp_fsf_req_alloc(pool, req_flags);
4639 if (unlikely(NULL == fsf_req)) {
4640 ZFCP_LOG_DEBUG("error: Could not put an FSF request into"
4641 "the outbound (send) queue.\n");
4642 ret = -ENOMEM;
4643 goto failed_fsf_req;
4646 fsf_req->adapter = adapter;
4647 fsf_req->fsf_command = fsf_cmd;
4648 INIT_LIST_HEAD(&fsf_req->list);
4649 init_timer(&fsf_req->timer);
4651 /* initialize waitqueue which may be used to wait on
4652 this request completion */
4653 init_waitqueue_head(&fsf_req->completion_wq);
4655 ret = zfcp_fsf_req_sbal_get(adapter, req_flags, lock_flags);
4656 if (ret < 0)
4657 goto failed_sbals;
4659 /* this is serialized (we are holding req_queue-lock of adapter) */
4660 if (adapter->req_no == 0)
4661 adapter->req_no++;
4662 fsf_req->req_id = adapter->req_no++;
4664 zfcp_fsf_req_qtcb_init(fsf_req);
4667 * We hold queue_lock here. Check if QDIOUP is set and let request fail
4668 * if it is not set (see also *_open_qdio and *_close_qdio).
4671 if (!atomic_test_mask(ZFCP_STATUS_ADAPTER_QDIOUP, &adapter->status)) {
4672 write_unlock_irqrestore(&req_queue->queue_lock, *lock_flags);
4673 ret = -EIO;
4674 goto failed_sbals;
4677 if (fsf_req->qtcb) {
4678 fsf_req->seq_no = adapter->fsf_req_seq_no;
4679 fsf_req->qtcb->prefix.req_seq_no = adapter->fsf_req_seq_no;
4681 fsf_req->sbal_number = 1;
4682 fsf_req->sbal_first = req_queue->free_index;
4683 fsf_req->sbal_curr = req_queue->free_index;
4684 fsf_req->sbale_curr = 1;
4686 if (likely(req_flags & ZFCP_REQ_AUTO_CLEANUP)) {
4687 fsf_req->status |= ZFCP_STATUS_FSFREQ_CLEANUP;
4690 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_curr, 0);
4692 /* setup common SBALE fields */
4693 sbale[0].addr = (void *) fsf_req->req_id;
4694 sbale[0].flags |= SBAL_FLAGS0_COMMAND;
4695 if (likely(fsf_req->qtcb != NULL)) {
4696 sbale[1].addr = (void *) fsf_req->qtcb;
4697 sbale[1].length = sizeof(struct fsf_qtcb);
4700 ZFCP_LOG_TRACE("got %i free BUFFERs starting at index %i\n",
4701 fsf_req->sbal_number, fsf_req->sbal_first);
4703 goto success;
4705 failed_sbals:
4706 /* dequeue new FSF request previously enqueued */
4707 zfcp_fsf_req_free(fsf_req);
4708 fsf_req = NULL;
4710 failed_fsf_req:
4711 write_lock_irqsave(&req_queue->queue_lock, *lock_flags);
4712 success:
4713 *fsf_req_p = fsf_req;
4714 return ret;
4718 * function: zfcp_fsf_req_send
4720 * purpose: start transfer of FSF request via QDIO
4722 * returns: 0 - request transfer succesfully started
4723 * !0 - start of request transfer failed
4725 static int zfcp_fsf_req_send(struct zfcp_fsf_req *fsf_req)
4727 struct zfcp_adapter *adapter;
4728 struct zfcp_qdio_queue *req_queue;
4729 volatile struct qdio_buffer_element *sbale;
4730 int inc_seq_no;
4731 int new_distance_from_int;
4732 u64 dbg_tmp[2];
4733 int retval = 0;
4735 adapter = fsf_req->adapter;
4736 req_queue = &adapter->request_queue,
4739 /* FIXME(debug): remove it later */
4740 sbale = zfcp_qdio_sbale_req(fsf_req, fsf_req->sbal_first, 0);
4741 ZFCP_LOG_DEBUG("SBALE0 flags=0x%x\n", sbale[0].flags);
4742 ZFCP_LOG_TRACE("HEX DUMP OF SBALE1 PAYLOAD:\n");
4743 ZFCP_HEX_DUMP(ZFCP_LOG_LEVEL_TRACE, (char *) sbale[1].addr,
4744 sbale[1].length);
4746 /* put allocated FSF request into hash table */
4747 spin_lock(&adapter->req_list_lock);
4748 zfcp_reqlist_add(adapter, fsf_req);
4749 spin_unlock(&adapter->req_list_lock);
4751 inc_seq_no = (fsf_req->qtcb != NULL);
4753 ZFCP_LOG_TRACE("request queue of adapter %s: "
4754 "next free SBAL is %i, %i free SBALs\n",
4755 zfcp_get_busid_by_adapter(adapter),
4756 req_queue->free_index,
4757 atomic_read(&req_queue->free_count));
4759 ZFCP_LOG_DEBUG("calling do_QDIO adapter %s, flags=0x%x, queue_no=%i, "
4760 "index_in_queue=%i, count=%i, buffers=%p\n",
4761 zfcp_get_busid_by_adapter(adapter),
4762 QDIO_FLAG_SYNC_OUTPUT,
4763 0, fsf_req->sbal_first, fsf_req->sbal_number,
4764 &req_queue->buffer[fsf_req->sbal_first]);
4767 * adjust the number of free SBALs in request queue as well as
4768 * position of first one
4770 atomic_sub(fsf_req->sbal_number, &req_queue->free_count);
4771 ZFCP_LOG_TRACE("free_count=%d\n", atomic_read(&req_queue->free_count));
4772 req_queue->free_index += fsf_req->sbal_number; /* increase */
4773 req_queue->free_index %= QDIO_MAX_BUFFERS_PER_Q; /* wrap if needed */
4774 new_distance_from_int = zfcp_qdio_determine_pci(req_queue, fsf_req);
4776 fsf_req->issued = get_clock();
4778 retval = do_QDIO(adapter->ccw_device,
4779 QDIO_FLAG_SYNC_OUTPUT,
4780 0, fsf_req->sbal_first, fsf_req->sbal_number, NULL);
4782 dbg_tmp[0] = (unsigned long) sbale[0].addr;
4783 dbg_tmp[1] = (u64) retval;
4784 debug_event(adapter->erp_dbf, 4, (void *) dbg_tmp, 16);
4786 if (unlikely(retval)) {
4787 /* Queues are down..... */
4788 retval = -EIO;
4789 del_timer(&fsf_req->timer);
4790 spin_lock(&adapter->req_list_lock);
4791 zfcp_reqlist_remove(adapter, fsf_req);
4792 spin_unlock(&adapter->req_list_lock);
4793 /* undo changes in request queue made for this request */
4794 zfcp_qdio_zero_sbals(req_queue->buffer,
4795 fsf_req->sbal_first, fsf_req->sbal_number);
4796 atomic_add(fsf_req->sbal_number, &req_queue->free_count);
4797 req_queue->free_index -= fsf_req->sbal_number;
4798 req_queue->free_index += QDIO_MAX_BUFFERS_PER_Q;
4799 req_queue->free_index %= QDIO_MAX_BUFFERS_PER_Q; /* wrap */
4800 zfcp_erp_adapter_reopen(adapter, 0);
4801 } else {
4802 req_queue->distance_from_int = new_distance_from_int;
4804 * increase FSF sequence counter -
4805 * this must only be done for request successfully enqueued to
4806 * QDIO this rejected requests may be cleaned up by calling
4807 * routines resulting in missing sequence counter values
4808 * otherwise,
4811 /* Don't increase for unsolicited status */
4812 if (inc_seq_no)
4813 adapter->fsf_req_seq_no++;
4815 /* count FSF requests pending */
4816 atomic_inc(&adapter->reqs_active);
4818 return retval;
4821 #undef ZFCP_LOG_AREA