4 * Implementation of FSF commands.
6 * Copyright IBM Corporation 2002, 2009
9 #define KMSG_COMPONENT "zfcp"
10 #define pr_fmt(fmt) KMSG_COMPONENT ": " fmt
12 #include <linux/blktrace_api.h>
15 #define ZFCP_REQ_AUTO_CLEANUP 0x00000002
16 #define ZFCP_REQ_NO_QTCB 0x00000008
18 static void zfcp_fsf_request_timeout_handler(unsigned long data)
20 struct zfcp_adapter *adapter = (struct zfcp_adapter *) data;
21 zfcp_erp_adapter_reopen(adapter, ZFCP_STATUS_COMMON_ERP_FAILED,
25 static void zfcp_fsf_start_timer(struct zfcp_fsf_req *fsf_req,
26 unsigned long timeout)
28 fsf_req->timer.function = zfcp_fsf_request_timeout_handler;
29 fsf_req->timer.data = (unsigned long) fsf_req->adapter;
30 fsf_req->timer.expires = jiffies + timeout;
31 add_timer(&fsf_req->timer);
34 static void zfcp_fsf_start_erp_timer(struct zfcp_fsf_req *fsf_req)
36 BUG_ON(!fsf_req->erp_action);
37 fsf_req->timer.function = zfcp_erp_timeout_handler;
38 fsf_req->timer.data = (unsigned long) fsf_req->erp_action;
39 fsf_req->timer.expires = jiffies + 30 * HZ;
40 add_timer(&fsf_req->timer);
43 /* association between FSF command and FSF QTCB type */
44 static u32 fsf_qtcb_type[] = {
45 [FSF_QTCB_FCP_CMND] = FSF_IO_COMMAND,
46 [FSF_QTCB_ABORT_FCP_CMND] = FSF_SUPPORT_COMMAND,
47 [FSF_QTCB_OPEN_PORT_WITH_DID] = FSF_SUPPORT_COMMAND,
48 [FSF_QTCB_OPEN_LUN] = FSF_SUPPORT_COMMAND,
49 [FSF_QTCB_CLOSE_LUN] = FSF_SUPPORT_COMMAND,
50 [FSF_QTCB_CLOSE_PORT] = FSF_SUPPORT_COMMAND,
51 [FSF_QTCB_CLOSE_PHYSICAL_PORT] = FSF_SUPPORT_COMMAND,
52 [FSF_QTCB_SEND_ELS] = FSF_SUPPORT_COMMAND,
53 [FSF_QTCB_SEND_GENERIC] = FSF_SUPPORT_COMMAND,
54 [FSF_QTCB_EXCHANGE_CONFIG_DATA] = FSF_CONFIG_COMMAND,
55 [FSF_QTCB_EXCHANGE_PORT_DATA] = FSF_PORT_COMMAND,
56 [FSF_QTCB_DOWNLOAD_CONTROL_FILE] = FSF_SUPPORT_COMMAND,
57 [FSF_QTCB_UPLOAD_CONTROL_FILE] = FSF_SUPPORT_COMMAND
60 static void zfcp_act_eval_err(struct zfcp_adapter *adapter, u32 table)
62 u16 subtable = table >> 16;
63 u16 rule = table & 0xffff;
64 const char *act_type[] = { "unknown", "OS", "WWPN", "DID", "LUN" };
66 if (subtable && subtable < ARRAY_SIZE(act_type))
67 dev_warn(&adapter->ccw_device->dev,
68 "Access denied according to ACT rule type %s, "
69 "rule %d\n", act_type[subtable], rule);
72 static void zfcp_fsf_access_denied_port(struct zfcp_fsf_req *req,
73 struct zfcp_port *port)
75 struct fsf_qtcb_header *header = &req->qtcb->header;
76 dev_warn(&req->adapter->ccw_device->dev,
77 "Access denied to port 0x%016Lx\n",
78 (unsigned long long)port->wwpn);
79 zfcp_act_eval_err(req->adapter, header->fsf_status_qual.halfword[0]);
80 zfcp_act_eval_err(req->adapter, header->fsf_status_qual.halfword[1]);
81 zfcp_erp_port_access_denied(port, "fspad_1", req);
82 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
85 static void zfcp_fsf_access_denied_unit(struct zfcp_fsf_req *req,
86 struct zfcp_unit *unit)
88 struct fsf_qtcb_header *header = &req->qtcb->header;
89 dev_warn(&req->adapter->ccw_device->dev,
90 "Access denied to unit 0x%016Lx on port 0x%016Lx\n",
91 (unsigned long long)unit->fcp_lun,
92 (unsigned long long)unit->port->wwpn);
93 zfcp_act_eval_err(req->adapter, header->fsf_status_qual.halfword[0]);
94 zfcp_act_eval_err(req->adapter, header->fsf_status_qual.halfword[1]);
95 zfcp_erp_unit_access_denied(unit, "fsuad_1", req);
96 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
99 static void zfcp_fsf_class_not_supp(struct zfcp_fsf_req *req)
101 dev_err(&req->adapter->ccw_device->dev, "FCP device not "
102 "operational because of an unsupported FC class\n");
103 zfcp_erp_adapter_shutdown(req->adapter, 0, "fscns_1", req);
104 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
108 * zfcp_fsf_req_free - free memory used by fsf request
109 * @fsf_req: pointer to struct zfcp_fsf_req
111 void zfcp_fsf_req_free(struct zfcp_fsf_req *req)
113 if (likely(req->pool)) {
114 mempool_free(req, req->pool);
119 kmem_cache_free(zfcp_data.fsf_req_qtcb_cache, req);
125 * zfcp_fsf_req_dismiss_all - dismiss all fsf requests
126 * @adapter: pointer to struct zfcp_adapter
128 * Never ever call this without shutting down the adapter first.
129 * Otherwise the adapter would continue using and corrupting s390 storage.
130 * Included BUG_ON() call to ensure this is done.
131 * ERP is supposed to be the only user of this function.
133 void zfcp_fsf_req_dismiss_all(struct zfcp_adapter *adapter)
135 struct zfcp_fsf_req *req, *tmp;
137 LIST_HEAD(remove_queue);
140 BUG_ON(atomic_read(&adapter->status) & ZFCP_STATUS_ADAPTER_QDIOUP);
141 spin_lock_irqsave(&adapter->req_list_lock, flags);
142 for (i = 0; i < REQUEST_LIST_SIZE; i++)
143 list_splice_init(&adapter->req_list[i], &remove_queue);
144 spin_unlock_irqrestore(&adapter->req_list_lock, flags);
146 list_for_each_entry_safe(req, tmp, &remove_queue, list) {
147 list_del(&req->list);
148 req->status |= ZFCP_STATUS_FSFREQ_DISMISSED;
149 zfcp_fsf_req_complete(req);
153 static void zfcp_fsf_status_read_port_closed(struct zfcp_fsf_req *req)
155 struct fsf_status_read_buffer *sr_buf = req->data;
156 struct zfcp_adapter *adapter = req->adapter;
157 struct zfcp_port *port;
158 int d_id = sr_buf->d_id & ZFCP_DID_MASK;
161 read_lock_irqsave(&zfcp_data.config_lock, flags);
162 list_for_each_entry(port, &adapter->port_list_head, list)
163 if (port->d_id == d_id) {
164 read_unlock_irqrestore(&zfcp_data.config_lock, flags);
165 zfcp_erp_port_reopen(port, 0, "fssrpc1", req);
168 read_unlock_irqrestore(&zfcp_data.config_lock, flags);
171 static void zfcp_fsf_link_down_info_eval(struct zfcp_fsf_req *req, char *id,
172 struct fsf_link_down_info *link_down)
174 struct zfcp_adapter *adapter = req->adapter;
176 if (atomic_read(&adapter->status) & ZFCP_STATUS_ADAPTER_LINK_UNPLUGGED)
179 atomic_set_mask(ZFCP_STATUS_ADAPTER_LINK_UNPLUGGED, &adapter->status);
180 zfcp_scsi_schedule_rports_block(adapter);
185 switch (link_down->error_code) {
186 case FSF_PSQ_LINK_NO_LIGHT:
187 dev_warn(&req->adapter->ccw_device->dev,
188 "There is no light signal from the local "
189 "fibre channel cable\n");
191 case FSF_PSQ_LINK_WRAP_PLUG:
192 dev_warn(&req->adapter->ccw_device->dev,
193 "There is a wrap plug instead of a fibre "
196 case FSF_PSQ_LINK_NO_FCP:
197 dev_warn(&req->adapter->ccw_device->dev,
198 "The adjacent fibre channel node does not "
201 case FSF_PSQ_LINK_FIRMWARE_UPDATE:
202 dev_warn(&req->adapter->ccw_device->dev,
203 "The FCP device is suspended because of a "
204 "firmware update\n");
206 case FSF_PSQ_LINK_INVALID_WWPN:
207 dev_warn(&req->adapter->ccw_device->dev,
208 "The FCP device detected a WWPN that is "
209 "duplicate or not valid\n");
211 case FSF_PSQ_LINK_NO_NPIV_SUPPORT:
212 dev_warn(&req->adapter->ccw_device->dev,
213 "The fibre channel fabric does not support NPIV\n");
215 case FSF_PSQ_LINK_NO_FCP_RESOURCES:
216 dev_warn(&req->adapter->ccw_device->dev,
217 "The FCP adapter cannot support more NPIV ports\n");
219 case FSF_PSQ_LINK_NO_FABRIC_RESOURCES:
220 dev_warn(&req->adapter->ccw_device->dev,
221 "The adjacent switch cannot support "
222 "more NPIV ports\n");
224 case FSF_PSQ_LINK_FABRIC_LOGIN_UNABLE:
225 dev_warn(&req->adapter->ccw_device->dev,
226 "The FCP adapter could not log in to the "
227 "fibre channel fabric\n");
229 case FSF_PSQ_LINK_WWPN_ASSIGNMENT_CORRUPTED:
230 dev_warn(&req->adapter->ccw_device->dev,
231 "The WWPN assignment file on the FCP adapter "
232 "has been damaged\n");
234 case FSF_PSQ_LINK_MODE_TABLE_CURRUPTED:
235 dev_warn(&req->adapter->ccw_device->dev,
236 "The mode table on the FCP adapter "
237 "has been damaged\n");
239 case FSF_PSQ_LINK_NO_WWPN_ASSIGNMENT:
240 dev_warn(&req->adapter->ccw_device->dev,
241 "All NPIV ports on the FCP adapter have "
245 dev_warn(&req->adapter->ccw_device->dev,
246 "The link between the FCP adapter and "
247 "the FC fabric is down\n");
250 zfcp_erp_adapter_failed(adapter, id, req);
253 static void zfcp_fsf_status_read_link_down(struct zfcp_fsf_req *req)
255 struct fsf_status_read_buffer *sr_buf = req->data;
256 struct fsf_link_down_info *ldi =
257 (struct fsf_link_down_info *) &sr_buf->payload;
259 switch (sr_buf->status_subtype) {
260 case FSF_STATUS_READ_SUB_NO_PHYSICAL_LINK:
261 zfcp_fsf_link_down_info_eval(req, "fssrld1", ldi);
263 case FSF_STATUS_READ_SUB_FDISC_FAILED:
264 zfcp_fsf_link_down_info_eval(req, "fssrld2", ldi);
266 case FSF_STATUS_READ_SUB_FIRMWARE_UPDATE:
267 zfcp_fsf_link_down_info_eval(req, "fssrld3", NULL);
271 static void zfcp_fsf_status_read_handler(struct zfcp_fsf_req *req)
273 struct zfcp_adapter *adapter = req->adapter;
274 struct fsf_status_read_buffer *sr_buf = req->data;
276 if (req->status & ZFCP_STATUS_FSFREQ_DISMISSED) {
277 zfcp_hba_dbf_event_fsf_unsol("dism", adapter, sr_buf);
278 mempool_free(sr_buf, adapter->pool.data_status_read);
279 zfcp_fsf_req_free(req);
283 zfcp_hba_dbf_event_fsf_unsol("read", adapter, sr_buf);
285 switch (sr_buf->status_type) {
286 case FSF_STATUS_READ_PORT_CLOSED:
287 zfcp_fsf_status_read_port_closed(req);
289 case FSF_STATUS_READ_INCOMING_ELS:
290 zfcp_fc_incoming_els(req);
292 case FSF_STATUS_READ_SENSE_DATA_AVAIL:
294 case FSF_STATUS_READ_BIT_ERROR_THRESHOLD:
295 dev_warn(&adapter->ccw_device->dev,
296 "The error threshold for checksum statistics "
297 "has been exceeded\n");
298 zfcp_hba_dbf_event_berr(adapter, req);
300 case FSF_STATUS_READ_LINK_DOWN:
301 zfcp_fsf_status_read_link_down(req);
303 case FSF_STATUS_READ_LINK_UP:
304 dev_info(&adapter->ccw_device->dev,
305 "The local link has been restored\n");
306 /* All ports should be marked as ready to run again */
307 zfcp_erp_modify_adapter_status(adapter, "fssrh_1", NULL,
308 ZFCP_STATUS_COMMON_RUNNING,
310 zfcp_erp_adapter_reopen(adapter,
311 ZFCP_STATUS_ADAPTER_LINK_UNPLUGGED |
312 ZFCP_STATUS_COMMON_ERP_FAILED,
315 case FSF_STATUS_READ_NOTIFICATION_LOST:
316 if (sr_buf->status_subtype & FSF_STATUS_READ_SUB_ACT_UPDATED)
317 zfcp_erp_adapter_access_changed(adapter, "fssrh_3",
319 if (sr_buf->status_subtype & FSF_STATUS_READ_SUB_INCOMING_ELS)
320 schedule_work(&adapter->scan_work);
322 case FSF_STATUS_READ_CFDC_UPDATED:
323 zfcp_erp_adapter_access_changed(adapter, "fssrh_4", req);
325 case FSF_STATUS_READ_FEATURE_UPDATE_ALERT:
326 adapter->adapter_features = sr_buf->payload.word[0];
330 mempool_free(sr_buf, adapter->pool.data_status_read);
331 zfcp_fsf_req_free(req);
333 atomic_inc(&adapter->stat_miss);
334 queue_work(zfcp_data.work_queue, &adapter->stat_work);
337 static void zfcp_fsf_fsfstatus_qual_eval(struct zfcp_fsf_req *req)
339 switch (req->qtcb->header.fsf_status_qual.word[0]) {
340 case FSF_SQ_FCP_RSP_AVAILABLE:
341 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
342 case FSF_SQ_NO_RETRY_POSSIBLE:
343 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
345 case FSF_SQ_COMMAND_ABORTED:
346 req->status |= ZFCP_STATUS_FSFREQ_ABORTED;
348 case FSF_SQ_NO_RECOM:
349 dev_err(&req->adapter->ccw_device->dev,
350 "The FCP adapter reported a problem "
351 "that cannot be recovered\n");
352 zfcp_erp_adapter_shutdown(req->adapter, 0, "fsfsqe1", req);
355 /* all non-return stats set FSFREQ_ERROR*/
356 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
359 static void zfcp_fsf_fsfstatus_eval(struct zfcp_fsf_req *req)
361 if (unlikely(req->status & ZFCP_STATUS_FSFREQ_ERROR))
364 switch (req->qtcb->header.fsf_status) {
365 case FSF_UNKNOWN_COMMAND:
366 dev_err(&req->adapter->ccw_device->dev,
367 "The FCP adapter does not recognize the command 0x%x\n",
368 req->qtcb->header.fsf_command);
369 zfcp_erp_adapter_shutdown(req->adapter, 0, "fsfse_1", req);
370 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
372 case FSF_ADAPTER_STATUS_AVAILABLE:
373 zfcp_fsf_fsfstatus_qual_eval(req);
378 static void zfcp_fsf_protstatus_eval(struct zfcp_fsf_req *req)
380 struct zfcp_adapter *adapter = req->adapter;
381 struct fsf_qtcb *qtcb = req->qtcb;
382 union fsf_prot_status_qual *psq = &qtcb->prefix.prot_status_qual;
384 zfcp_hba_dbf_event_fsf_response(req);
386 if (req->status & ZFCP_STATUS_FSFREQ_DISMISSED) {
387 req->status |= ZFCP_STATUS_FSFREQ_ERROR |
388 ZFCP_STATUS_FSFREQ_RETRY; /* only for SCSI cmnds. */
392 switch (qtcb->prefix.prot_status) {
394 case FSF_PROT_FSF_STATUS_PRESENTED:
396 case FSF_PROT_QTCB_VERSION_ERROR:
397 dev_err(&adapter->ccw_device->dev,
398 "QTCB version 0x%x not supported by FCP adapter "
399 "(0x%x to 0x%x)\n", FSF_QTCB_CURRENT_VERSION,
400 psq->word[0], psq->word[1]);
401 zfcp_erp_adapter_shutdown(adapter, 0, "fspse_1", req);
403 case FSF_PROT_ERROR_STATE:
404 case FSF_PROT_SEQ_NUMB_ERROR:
405 zfcp_erp_adapter_reopen(adapter, 0, "fspse_2", req);
406 req->status |= ZFCP_STATUS_FSFREQ_RETRY;
408 case FSF_PROT_UNSUPP_QTCB_TYPE:
409 dev_err(&adapter->ccw_device->dev,
410 "The QTCB type is not supported by the FCP adapter\n");
411 zfcp_erp_adapter_shutdown(adapter, 0, "fspse_3", req);
413 case FSF_PROT_HOST_CONNECTION_INITIALIZING:
414 atomic_set_mask(ZFCP_STATUS_ADAPTER_HOST_CON_INIT,
417 case FSF_PROT_DUPLICATE_REQUEST_ID:
418 dev_err(&adapter->ccw_device->dev,
419 "0x%Lx is an ambiguous request identifier\n",
420 (unsigned long long)qtcb->bottom.support.req_handle);
421 zfcp_erp_adapter_shutdown(adapter, 0, "fspse_4", req);
423 case FSF_PROT_LINK_DOWN:
424 zfcp_fsf_link_down_info_eval(req, "fspse_5",
425 &psq->link_down_info);
426 /* FIXME: reopening adapter now? better wait for link up */
427 zfcp_erp_adapter_reopen(adapter, 0, "fspse_6", req);
429 case FSF_PROT_REEST_QUEUE:
430 /* All ports should be marked as ready to run again */
431 zfcp_erp_modify_adapter_status(adapter, "fspse_7", NULL,
432 ZFCP_STATUS_COMMON_RUNNING,
434 zfcp_erp_adapter_reopen(adapter,
435 ZFCP_STATUS_ADAPTER_LINK_UNPLUGGED |
436 ZFCP_STATUS_COMMON_ERP_FAILED,
440 dev_err(&adapter->ccw_device->dev,
441 "0x%x is not a valid transfer protocol status\n",
442 qtcb->prefix.prot_status);
443 zfcp_erp_adapter_shutdown(adapter, 0, "fspse_9", req);
445 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
449 * zfcp_fsf_req_complete - process completion of a FSF request
450 * @fsf_req: The FSF request that has been completed.
452 * When a request has been completed either from the FCP adapter,
453 * or it has been dismissed due to a queue shutdown, this function
454 * is called to process the completion status and trigger further
455 * events related to the FSF request.
457 void zfcp_fsf_req_complete(struct zfcp_fsf_req *req)
459 if (unlikely(req->fsf_command == FSF_QTCB_UNSOLICITED_STATUS)) {
460 zfcp_fsf_status_read_handler(req);
464 del_timer(&req->timer);
465 zfcp_fsf_protstatus_eval(req);
466 zfcp_fsf_fsfstatus_eval(req);
470 zfcp_erp_notify(req->erp_action, 0);
471 req->status |= ZFCP_STATUS_FSFREQ_COMPLETED;
473 if (likely(req->status & ZFCP_STATUS_FSFREQ_CLEANUP))
474 zfcp_fsf_req_free(req);
476 /* notify initiator waiting for the requests completion */
478 * FIXME: Race! We must not access fsf_req here as it might have been
479 * cleaned up already due to the set ZFCP_STATUS_FSFREQ_COMPLETED
480 * flag. It's an improbable case. But, we have the same paranoia for
481 * the cleanup flag already.
482 * Might better be handled using complete()?
483 * (setting the flag and doing wakeup ought to be atomic
484 * with regard to checking the flag as long as waitqueue is
485 * part of the to be released structure)
487 wake_up(&req->completion_wq);
490 static int zfcp_fsf_exchange_config_evaluate(struct zfcp_fsf_req *req)
492 struct fsf_qtcb_bottom_config *bottom;
493 struct zfcp_adapter *adapter = req->adapter;
494 struct Scsi_Host *shost = adapter->scsi_host;
496 bottom = &req->qtcb->bottom.config;
499 memcpy(req->data, bottom, sizeof(*bottom));
501 fc_host_node_name(shost) = bottom->nport_serv_param.wwnn;
502 fc_host_port_name(shost) = bottom->nport_serv_param.wwpn;
503 fc_host_port_id(shost) = bottom->s_id & ZFCP_DID_MASK;
504 fc_host_speed(shost) = bottom->fc_link_speed;
505 fc_host_supported_classes(shost) = FC_COS_CLASS2 | FC_COS_CLASS3;
507 adapter->hydra_version = bottom->adapter_type;
508 adapter->timer_ticks = bottom->timer_interval;
510 if (fc_host_permanent_port_name(shost) == -1)
511 fc_host_permanent_port_name(shost) = fc_host_port_name(shost);
513 switch (bottom->fc_topology) {
515 adapter->peer_d_id = bottom->peer_d_id & ZFCP_DID_MASK;
516 adapter->peer_wwpn = bottom->plogi_payload.wwpn;
517 adapter->peer_wwnn = bottom->plogi_payload.wwnn;
518 fc_host_port_type(shost) = FC_PORTTYPE_PTP;
520 case FSF_TOPO_FABRIC:
521 fc_host_port_type(shost) = FC_PORTTYPE_NPORT;
524 fc_host_port_type(shost) = FC_PORTTYPE_NLPORT;
526 dev_err(&adapter->ccw_device->dev,
527 "Unknown or unsupported arbitrated loop "
528 "fibre channel topology detected\n");
529 zfcp_erp_adapter_shutdown(adapter, 0, "fsece_1", req);
536 static void zfcp_fsf_exchange_config_data_handler(struct zfcp_fsf_req *req)
538 struct zfcp_adapter *adapter = req->adapter;
539 struct fsf_qtcb *qtcb = req->qtcb;
540 struct fsf_qtcb_bottom_config *bottom = &qtcb->bottom.config;
541 struct Scsi_Host *shost = adapter->scsi_host;
543 if (req->status & ZFCP_STATUS_FSFREQ_ERROR)
546 adapter->fsf_lic_version = bottom->lic_version;
547 adapter->adapter_features = bottom->adapter_features;
548 adapter->connection_features = bottom->connection_features;
549 adapter->peer_wwpn = 0;
550 adapter->peer_wwnn = 0;
551 adapter->peer_d_id = 0;
553 switch (qtcb->header.fsf_status) {
555 if (zfcp_fsf_exchange_config_evaluate(req))
558 if (bottom->max_qtcb_size < sizeof(struct fsf_qtcb)) {
559 dev_err(&adapter->ccw_device->dev,
560 "FCP adapter maximum QTCB size (%d bytes) "
562 bottom->max_qtcb_size);
563 zfcp_erp_adapter_shutdown(adapter, 0, "fsecdh1", req);
566 atomic_set_mask(ZFCP_STATUS_ADAPTER_XCONFIG_OK,
569 case FSF_EXCHANGE_CONFIG_DATA_INCOMPLETE:
570 fc_host_node_name(shost) = 0;
571 fc_host_port_name(shost) = 0;
572 fc_host_port_id(shost) = 0;
573 fc_host_speed(shost) = FC_PORTSPEED_UNKNOWN;
574 fc_host_port_type(shost) = FC_PORTTYPE_UNKNOWN;
575 adapter->hydra_version = 0;
577 atomic_set_mask(ZFCP_STATUS_ADAPTER_XCONFIG_OK,
580 zfcp_fsf_link_down_info_eval(req, "fsecdh2",
581 &qtcb->header.fsf_status_qual.link_down_info);
584 zfcp_erp_adapter_shutdown(adapter, 0, "fsecdh3", req);
588 if (adapter->adapter_features & FSF_FEATURE_HBAAPI_MANAGEMENT) {
589 adapter->hardware_version = bottom->hardware_version;
590 memcpy(fc_host_serial_number(shost), bottom->serial_number,
591 min(FC_SERIAL_NUMBER_SIZE, 17));
592 EBCASC(fc_host_serial_number(shost),
593 min(FC_SERIAL_NUMBER_SIZE, 17));
596 if (FSF_QTCB_CURRENT_VERSION < bottom->low_qtcb_version) {
597 dev_err(&adapter->ccw_device->dev,
598 "The FCP adapter only supports newer "
599 "control block versions\n");
600 zfcp_erp_adapter_shutdown(adapter, 0, "fsecdh4", req);
603 if (FSF_QTCB_CURRENT_VERSION > bottom->high_qtcb_version) {
604 dev_err(&adapter->ccw_device->dev,
605 "The FCP adapter only supports older "
606 "control block versions\n");
607 zfcp_erp_adapter_shutdown(adapter, 0, "fsecdh5", req);
611 static void zfcp_fsf_exchange_port_evaluate(struct zfcp_fsf_req *req)
613 struct zfcp_adapter *adapter = req->adapter;
614 struct fsf_qtcb_bottom_port *bottom = &req->qtcb->bottom.port;
615 struct Scsi_Host *shost = adapter->scsi_host;
618 memcpy(req->data, bottom, sizeof(*bottom));
620 if (adapter->connection_features & FSF_FEATURE_NPIV_MODE)
621 fc_host_permanent_port_name(shost) = bottom->wwpn;
623 fc_host_permanent_port_name(shost) = fc_host_port_name(shost);
624 fc_host_maxframe_size(shost) = bottom->maximum_frame_size;
625 fc_host_supported_speeds(shost) = bottom->supported_speed;
628 static void zfcp_fsf_exchange_port_data_handler(struct zfcp_fsf_req *req)
630 struct fsf_qtcb *qtcb = req->qtcb;
632 if (req->status & ZFCP_STATUS_FSFREQ_ERROR)
635 switch (qtcb->header.fsf_status) {
637 zfcp_fsf_exchange_port_evaluate(req);
639 case FSF_EXCHANGE_CONFIG_DATA_INCOMPLETE:
640 zfcp_fsf_exchange_port_evaluate(req);
641 zfcp_fsf_link_down_info_eval(req, "fsepdh1",
642 &qtcb->header.fsf_status_qual.link_down_info);
647 static int zfcp_fsf_req_sbal_get(struct zfcp_adapter *adapter)
648 __releases(&adapter->req_q_lock)
649 __acquires(&adapter->req_q_lock)
651 struct zfcp_qdio_queue *req_q = &adapter->req_q;
654 if (atomic_read(&req_q->count) <= -REQUEST_LIST_SIZE)
656 if (atomic_read(&req_q->count) > 0)
659 atomic_dec(&req_q->count);
660 spin_unlock_bh(&adapter->req_q_lock);
661 ret = wait_event_interruptible_timeout(adapter->request_wq,
662 atomic_read(&req_q->count) >= 0,
664 spin_lock_bh(&adapter->req_q_lock);
665 atomic_inc(&req_q->count);
670 atomic_inc(&adapter->qdio_outb_full);
674 static struct zfcp_fsf_req *zfcp_fsf_alloc_noqtcb(mempool_t *pool)
676 struct zfcp_fsf_req *req;
677 req = mempool_alloc(pool, GFP_ATOMIC);
680 memset(req, 0, sizeof(*req));
685 static struct zfcp_fsf_req *zfcp_fsf_alloc_qtcb(mempool_t *pool)
687 struct zfcp_fsf_req_qtcb *qtcb;
690 qtcb = mempool_alloc(pool, GFP_ATOMIC);
692 qtcb = kmem_cache_alloc(zfcp_data.fsf_req_qtcb_cache,
697 memset(qtcb, 0, sizeof(*qtcb));
698 qtcb->fsf_req.qtcb = &qtcb->qtcb;
699 qtcb->fsf_req.pool = pool;
701 return &qtcb->fsf_req;
704 static struct zfcp_fsf_req *zfcp_fsf_req_create(struct zfcp_adapter *adapter,
705 u32 fsf_cmd, int req_flags,
708 struct qdio_buffer_element *sbale;
710 struct zfcp_fsf_req *req;
711 struct zfcp_qdio_queue *req_q = &adapter->req_q;
713 if (req_flags & ZFCP_REQ_NO_QTCB)
714 req = zfcp_fsf_alloc_noqtcb(pool);
716 req = zfcp_fsf_alloc_qtcb(pool);
719 return ERR_PTR(-EIO);
721 if (adapter->req_no == 0)
724 INIT_LIST_HEAD(&req->list);
725 init_timer(&req->timer);
726 init_waitqueue_head(&req->completion_wq);
728 req->adapter = adapter;
729 req->fsf_command = fsf_cmd;
730 req->req_id = adapter->req_no;
731 req->sbal_number = 1;
732 req->sbal_first = req_q->first;
733 req->sbal_last = req_q->first;
736 sbale = zfcp_qdio_sbale_req(req);
737 sbale[0].addr = (void *) req->req_id;
738 sbale[0].flags |= SBAL_FLAGS0_COMMAND;
740 if (likely(req->qtcb)) {
741 req->qtcb->prefix.req_seq_no = req->adapter->fsf_req_seq_no;
742 req->qtcb->prefix.req_id = req->req_id;
743 req->qtcb->prefix.ulp_info = 26;
744 req->qtcb->prefix.qtcb_type = fsf_qtcb_type[req->fsf_command];
745 req->qtcb->prefix.qtcb_version = FSF_QTCB_CURRENT_VERSION;
746 req->qtcb->header.req_handle = req->req_id;
747 req->qtcb->header.fsf_command = req->fsf_command;
748 req->seq_no = adapter->fsf_req_seq_no;
749 req->qtcb->prefix.req_seq_no = adapter->fsf_req_seq_no;
750 sbale[1].addr = (void *) req->qtcb;
751 sbale[1].length = sizeof(struct fsf_qtcb);
754 if (!(atomic_read(&adapter->status) & ZFCP_STATUS_ADAPTER_QDIOUP)) {
755 zfcp_fsf_req_free(req);
756 return ERR_PTR(-EIO);
759 if (likely(req_flags & ZFCP_REQ_AUTO_CLEANUP))
760 req->status |= ZFCP_STATUS_FSFREQ_CLEANUP;
765 static int zfcp_fsf_req_send(struct zfcp_fsf_req *req)
767 struct zfcp_adapter *adapter = req->adapter;
771 /* put allocated FSF request into hash table */
772 spin_lock_irqsave(&adapter->req_list_lock, flags);
773 idx = zfcp_reqlist_hash(req->req_id);
774 list_add_tail(&req->list, &adapter->req_list[idx]);
775 spin_unlock_irqrestore(&adapter->req_list_lock, flags);
777 req->qdio_outb_usage = atomic_read(&adapter->req_q.count);
778 req->issued = get_clock();
779 if (zfcp_qdio_send(req)) {
780 del_timer(&req->timer);
781 spin_lock_irqsave(&adapter->req_list_lock, flags);
782 /* lookup request again, list might have changed */
783 if (zfcp_reqlist_find_safe(adapter, req))
784 zfcp_reqlist_remove(adapter, req);
785 spin_unlock_irqrestore(&adapter->req_list_lock, flags);
786 zfcp_erp_adapter_reopen(adapter, 0, "fsrs__1", req);
790 /* Don't increase for unsolicited status */
792 adapter->fsf_req_seq_no++;
799 * zfcp_fsf_status_read - send status read request
800 * @adapter: pointer to struct zfcp_adapter
801 * @req_flags: request flags
802 * Returns: 0 on success, ERROR otherwise
804 int zfcp_fsf_status_read(struct zfcp_adapter *adapter)
806 struct zfcp_fsf_req *req;
807 struct fsf_status_read_buffer *sr_buf;
808 struct qdio_buffer_element *sbale;
811 spin_lock_bh(&adapter->req_q_lock);
812 if (zfcp_fsf_req_sbal_get(adapter))
815 req = zfcp_fsf_req_create(adapter, FSF_QTCB_UNSOLICITED_STATUS,
817 adapter->pool.fsf_req_status_read);
819 retval = PTR_ERR(req);
823 sbale = zfcp_qdio_sbale_req(req);
824 sbale[0].flags |= SBAL_FLAGS0_TYPE_STATUS;
825 sbale[2].flags |= SBAL_FLAGS_LAST_ENTRY;
828 sr_buf = mempool_alloc(adapter->pool.data_status_read, GFP_ATOMIC);
833 memset(sr_buf, 0, sizeof(*sr_buf));
835 sbale = zfcp_qdio_sbale_curr(req);
836 sbale->addr = (void *) sr_buf;
837 sbale->length = sizeof(*sr_buf);
839 retval = zfcp_fsf_req_send(req);
841 goto failed_req_send;
846 mempool_free(sr_buf, adapter->pool.data_status_read);
848 zfcp_fsf_req_free(req);
849 zfcp_hba_dbf_event_fsf_unsol("fail", adapter, NULL);
851 spin_unlock_bh(&adapter->req_q_lock);
855 static void zfcp_fsf_abort_fcp_command_handler(struct zfcp_fsf_req *req)
857 struct zfcp_unit *unit = req->data;
858 union fsf_status_qual *fsq = &req->qtcb->header.fsf_status_qual;
860 if (req->status & ZFCP_STATUS_FSFREQ_ERROR)
863 switch (req->qtcb->header.fsf_status) {
864 case FSF_PORT_HANDLE_NOT_VALID:
865 if (fsq->word[0] == fsq->word[1]) {
866 zfcp_erp_adapter_reopen(unit->port->adapter, 0,
868 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
871 case FSF_LUN_HANDLE_NOT_VALID:
872 if (fsq->word[0] == fsq->word[1]) {
873 zfcp_erp_port_reopen(unit->port, 0, "fsafch2", req);
874 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
877 case FSF_FCP_COMMAND_DOES_NOT_EXIST:
878 req->status |= ZFCP_STATUS_FSFREQ_ABORTNOTNEEDED;
881 zfcp_erp_port_boxed(unit->port, "fsafch3", req);
882 req->status |= ZFCP_STATUS_FSFREQ_ERROR |
883 ZFCP_STATUS_FSFREQ_RETRY;
886 zfcp_erp_unit_boxed(unit, "fsafch4", req);
887 req->status |= ZFCP_STATUS_FSFREQ_ERROR |
888 ZFCP_STATUS_FSFREQ_RETRY;
890 case FSF_ADAPTER_STATUS_AVAILABLE:
891 switch (fsq->word[0]) {
892 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
893 zfcp_test_link(unit->port);
894 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
895 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
900 req->status |= ZFCP_STATUS_FSFREQ_ABORTSUCCEEDED;
906 * zfcp_fsf_abort_fcp_command - abort running SCSI command
907 * @old_req_id: unsigned long
908 * @unit: pointer to struct zfcp_unit
909 * Returns: pointer to struct zfcp_fsf_req
912 struct zfcp_fsf_req *zfcp_fsf_abort_fcp_command(unsigned long old_req_id,
913 struct zfcp_unit *unit)
915 struct qdio_buffer_element *sbale;
916 struct zfcp_fsf_req *req = NULL;
917 struct zfcp_adapter *adapter = unit->port->adapter;
919 spin_lock_bh(&adapter->req_q_lock);
920 if (zfcp_fsf_req_sbal_get(adapter))
922 req = zfcp_fsf_req_create(adapter, FSF_QTCB_ABORT_FCP_CMND,
923 0, adapter->pool.fsf_req_abort);
929 if (unlikely(!(atomic_read(&unit->status) &
930 ZFCP_STATUS_COMMON_UNBLOCKED)))
933 sbale = zfcp_qdio_sbale_req(req);
934 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
935 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
938 req->handler = zfcp_fsf_abort_fcp_command_handler;
939 req->qtcb->header.lun_handle = unit->handle;
940 req->qtcb->header.port_handle = unit->port->handle;
941 req->qtcb->bottom.support.req_handle = (u64) old_req_id;
943 zfcp_fsf_start_timer(req, ZFCP_SCSI_ER_TIMEOUT);
944 if (!zfcp_fsf_req_send(req))
948 zfcp_fsf_req_free(req);
951 spin_unlock_bh(&adapter->req_q_lock);
955 static void zfcp_fsf_send_ct_handler(struct zfcp_fsf_req *req)
957 struct zfcp_adapter *adapter = req->adapter;
958 struct zfcp_send_ct *send_ct = req->data;
959 struct fsf_qtcb_header *header = &req->qtcb->header;
961 send_ct->status = -EINVAL;
963 if (req->status & ZFCP_STATUS_FSFREQ_ERROR)
966 switch (header->fsf_status) {
968 zfcp_san_dbf_event_ct_response(req);
971 case FSF_SERVICE_CLASS_NOT_SUPPORTED:
972 zfcp_fsf_class_not_supp(req);
974 case FSF_ADAPTER_STATUS_AVAILABLE:
975 switch (header->fsf_status_qual.word[0]){
976 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
977 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
978 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
982 case FSF_ACCESS_DENIED:
985 req->status |= ZFCP_STATUS_FSFREQ_ERROR |
986 ZFCP_STATUS_FSFREQ_RETRY;
988 case FSF_PORT_HANDLE_NOT_VALID:
989 zfcp_erp_adapter_reopen(adapter, 0, "fsscth1", req);
990 case FSF_GENERIC_COMMAND_REJECTED:
991 case FSF_PAYLOAD_SIZE_MISMATCH:
992 case FSF_REQUEST_SIZE_TOO_LARGE:
993 case FSF_RESPONSE_SIZE_TOO_LARGE:
994 case FSF_SBAL_MISMATCH:
995 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1000 if (send_ct->handler)
1001 send_ct->handler(send_ct->handler_data);
1004 static int zfcp_fsf_setup_ct_els_sbals(struct zfcp_fsf_req *req,
1005 struct scatterlist *sg_req,
1006 struct scatterlist *sg_resp,
1009 struct qdio_buffer_element *sbale = zfcp_qdio_sbale_req(req);
1010 u32 feat = req->adapter->adapter_features;
1013 if (!(feat & FSF_FEATURE_ELS_CT_CHAINED_SBALS)) {
1014 if (sg_req->length > PAGE_SIZE || sg_resp->length > PAGE_SIZE ||
1015 !sg_is_last(sg_req) || !sg_is_last(sg_resp))
1018 sbale[0].flags |= SBAL_FLAGS0_TYPE_WRITE_READ;
1019 sbale[2].addr = sg_virt(sg_req);
1020 sbale[2].length = sg_req->length;
1021 sbale[3].addr = sg_virt(sg_resp);
1022 sbale[3].length = sg_resp->length;
1023 sbale[3].flags |= SBAL_FLAGS_LAST_ENTRY;
1027 bytes = zfcp_qdio_sbals_from_sg(req, SBAL_FLAGS0_TYPE_WRITE_READ,
1031 req->qtcb->bottom.support.req_buf_length = bytes;
1032 req->sbale_curr = ZFCP_LAST_SBALE_PER_SBAL;
1034 bytes = zfcp_qdio_sbals_from_sg(req, SBAL_FLAGS0_TYPE_WRITE_READ,
1035 sg_resp, max_sbals);
1038 req->qtcb->bottom.support.resp_buf_length = bytes;
1044 * zfcp_fsf_send_ct - initiate a Generic Service request (FC-GS)
1045 * @ct: pointer to struct zfcp_send_ct with data for request
1046 * @pool: if non-null this mempool is used to allocate struct zfcp_fsf_req
1047 * @erp_action: if non-null the Generic Service request sent within ERP
1049 int zfcp_fsf_send_ct(struct zfcp_send_ct *ct, mempool_t *pool,
1050 struct zfcp_erp_action *erp_action)
1052 struct zfcp_wka_port *wka_port = ct->wka_port;
1053 struct zfcp_adapter *adapter = wka_port->adapter;
1054 struct zfcp_fsf_req *req;
1057 spin_lock_bh(&adapter->req_q_lock);
1058 if (zfcp_fsf_req_sbal_get(adapter))
1061 req = zfcp_fsf_req_create(adapter, FSF_QTCB_SEND_GENERIC,
1062 ZFCP_REQ_AUTO_CLEANUP, pool);
1068 ret = zfcp_fsf_setup_ct_els_sbals(req, ct->req, ct->resp,
1069 FSF_MAX_SBALS_PER_REQ);
1073 req->handler = zfcp_fsf_send_ct_handler;
1074 req->qtcb->header.port_handle = wka_port->handle;
1075 req->qtcb->bottom.support.service_class = FSF_CLASS_3;
1076 req->qtcb->bottom.support.timeout = ct->timeout;
1079 zfcp_san_dbf_event_ct_request(req);
1082 erp_action->fsf_req = req;
1083 req->erp_action = erp_action;
1084 zfcp_fsf_start_erp_timer(req);
1086 zfcp_fsf_start_timer(req, ZFCP_FSF_REQUEST_TIMEOUT);
1088 ret = zfcp_fsf_req_send(req);
1095 zfcp_fsf_req_free(req);
1097 erp_action->fsf_req = NULL;
1099 spin_unlock_bh(&adapter->req_q_lock);
1103 static void zfcp_fsf_send_els_handler(struct zfcp_fsf_req *req)
1105 struct zfcp_send_els *send_els = req->data;
1106 struct zfcp_port *port = send_els->port;
1107 struct fsf_qtcb_header *header = &req->qtcb->header;
1109 send_els->status = -EINVAL;
1111 if (req->status & ZFCP_STATUS_FSFREQ_ERROR)
1112 goto skip_fsfstatus;
1114 switch (header->fsf_status) {
1116 zfcp_san_dbf_event_els_response(req);
1117 send_els->status = 0;
1119 case FSF_SERVICE_CLASS_NOT_SUPPORTED:
1120 zfcp_fsf_class_not_supp(req);
1122 case FSF_ADAPTER_STATUS_AVAILABLE:
1123 switch (header->fsf_status_qual.word[0]){
1124 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
1125 if (port && (send_els->ls_code != ZFCP_LS_ADISC))
1126 zfcp_test_link(port);
1128 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
1129 case FSF_SQ_RETRY_IF_POSSIBLE:
1130 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1134 case FSF_ELS_COMMAND_REJECTED:
1135 case FSF_PAYLOAD_SIZE_MISMATCH:
1136 case FSF_REQUEST_SIZE_TOO_LARGE:
1137 case FSF_RESPONSE_SIZE_TOO_LARGE:
1139 case FSF_ACCESS_DENIED:
1140 zfcp_fsf_access_denied_port(req, port);
1142 case FSF_SBAL_MISMATCH:
1143 /* should never occure, avoided in zfcp_fsf_send_els */
1146 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1150 if (send_els->handler)
1151 send_els->handler(send_els->handler_data);
1155 * zfcp_fsf_send_els - initiate an ELS command (FC-FS)
1156 * @els: pointer to struct zfcp_send_els with data for the command
1158 int zfcp_fsf_send_els(struct zfcp_send_els *els)
1160 struct zfcp_fsf_req *req;
1161 struct zfcp_adapter *adapter = els->adapter;
1162 struct fsf_qtcb_bottom_support *bottom;
1165 spin_lock_bh(&adapter->req_q_lock);
1166 if (zfcp_fsf_req_sbal_get(adapter))
1168 req = zfcp_fsf_req_create(adapter, FSF_QTCB_SEND_ELS,
1169 ZFCP_REQ_AUTO_CLEANUP, NULL);
1175 ret = zfcp_fsf_setup_ct_els_sbals(req, els->req, els->resp, 2);
1180 bottom = &req->qtcb->bottom.support;
1181 req->handler = zfcp_fsf_send_els_handler;
1182 bottom->d_id = els->d_id;
1183 bottom->service_class = FSF_CLASS_3;
1184 bottom->timeout = 2 * R_A_TOV;
1187 zfcp_san_dbf_event_els_request(req);
1189 zfcp_fsf_start_timer(req, ZFCP_FSF_REQUEST_TIMEOUT);
1190 ret = zfcp_fsf_req_send(req);
1197 zfcp_fsf_req_free(req);
1199 spin_unlock_bh(&adapter->req_q_lock);
1203 int zfcp_fsf_exchange_config_data(struct zfcp_erp_action *erp_action)
1205 struct qdio_buffer_element *sbale;
1206 struct zfcp_fsf_req *req;
1207 struct zfcp_adapter *adapter = erp_action->adapter;
1210 spin_lock_bh(&adapter->req_q_lock);
1211 if (zfcp_fsf_req_sbal_get(adapter))
1213 req = zfcp_fsf_req_create(adapter,
1214 FSF_QTCB_EXCHANGE_CONFIG_DATA,
1215 ZFCP_REQ_AUTO_CLEANUP,
1216 adapter->pool.fsf_req_erp);
1218 retval = PTR_ERR(req);
1222 sbale = zfcp_qdio_sbale_req(req);
1223 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
1224 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
1226 req->qtcb->bottom.config.feature_selection =
1228 FSF_FEATURE_LUN_SHARING |
1229 FSF_FEATURE_NOTIFICATION_LOST |
1230 FSF_FEATURE_UPDATE_ALERT;
1231 req->erp_action = erp_action;
1232 req->handler = zfcp_fsf_exchange_config_data_handler;
1233 erp_action->fsf_req = req;
1235 zfcp_fsf_start_erp_timer(req);
1236 retval = zfcp_fsf_req_send(req);
1238 zfcp_fsf_req_free(req);
1239 erp_action->fsf_req = NULL;
1242 spin_unlock_bh(&adapter->req_q_lock);
1246 int zfcp_fsf_exchange_config_data_sync(struct zfcp_adapter *adapter,
1247 struct fsf_qtcb_bottom_config *data)
1249 struct qdio_buffer_element *sbale;
1250 struct zfcp_fsf_req *req = NULL;
1253 spin_lock_bh(&adapter->req_q_lock);
1254 if (zfcp_fsf_req_sbal_get(adapter))
1257 req = zfcp_fsf_req_create(adapter, FSF_QTCB_EXCHANGE_CONFIG_DATA,
1260 retval = PTR_ERR(req);
1264 sbale = zfcp_qdio_sbale_req(req);
1265 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
1266 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
1267 req->handler = zfcp_fsf_exchange_config_data_handler;
1269 req->qtcb->bottom.config.feature_selection =
1271 FSF_FEATURE_LUN_SHARING |
1272 FSF_FEATURE_NOTIFICATION_LOST |
1273 FSF_FEATURE_UPDATE_ALERT;
1278 zfcp_fsf_start_timer(req, ZFCP_FSF_REQUEST_TIMEOUT);
1279 retval = zfcp_fsf_req_send(req);
1281 spin_unlock_bh(&adapter->req_q_lock);
1283 wait_event(req->completion_wq,
1284 req->status & ZFCP_STATUS_FSFREQ_COMPLETED);
1286 zfcp_fsf_req_free(req);
1292 * zfcp_fsf_exchange_port_data - request information about local port
1293 * @erp_action: ERP action for the adapter for which port data is requested
1294 * Returns: 0 on success, error otherwise
1296 int zfcp_fsf_exchange_port_data(struct zfcp_erp_action *erp_action)
1298 struct qdio_buffer_element *sbale;
1299 struct zfcp_fsf_req *req;
1300 struct zfcp_adapter *adapter = erp_action->adapter;
1303 if (!(adapter->adapter_features & FSF_FEATURE_HBAAPI_MANAGEMENT))
1306 spin_lock_bh(&adapter->req_q_lock);
1307 if (zfcp_fsf_req_sbal_get(adapter))
1309 req = zfcp_fsf_req_create(adapter, FSF_QTCB_EXCHANGE_PORT_DATA,
1310 ZFCP_REQ_AUTO_CLEANUP,
1311 adapter->pool.fsf_req_erp);
1313 retval = PTR_ERR(req);
1317 sbale = zfcp_qdio_sbale_req(req);
1318 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
1319 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
1321 req->handler = zfcp_fsf_exchange_port_data_handler;
1322 req->erp_action = erp_action;
1323 erp_action->fsf_req = req;
1325 zfcp_fsf_start_erp_timer(req);
1326 retval = zfcp_fsf_req_send(req);
1328 zfcp_fsf_req_free(req);
1329 erp_action->fsf_req = NULL;
1332 spin_unlock_bh(&adapter->req_q_lock);
1337 * zfcp_fsf_exchange_port_data_sync - request information about local port
1338 * @adapter: pointer to struct zfcp_adapter
1339 * @data: pointer to struct fsf_qtcb_bottom_port
1340 * Returns: 0 on success, error otherwise
1342 int zfcp_fsf_exchange_port_data_sync(struct zfcp_adapter *adapter,
1343 struct fsf_qtcb_bottom_port *data)
1345 struct qdio_buffer_element *sbale;
1346 struct zfcp_fsf_req *req = NULL;
1349 if (!(adapter->adapter_features & FSF_FEATURE_HBAAPI_MANAGEMENT))
1352 spin_lock_bh(&adapter->req_q_lock);
1353 if (zfcp_fsf_req_sbal_get(adapter))
1356 req = zfcp_fsf_req_create(adapter, FSF_QTCB_EXCHANGE_PORT_DATA, 0,
1359 retval = PTR_ERR(req);
1366 sbale = zfcp_qdio_sbale_req(req);
1367 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
1368 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
1370 req->handler = zfcp_fsf_exchange_port_data_handler;
1371 zfcp_fsf_start_timer(req, ZFCP_FSF_REQUEST_TIMEOUT);
1372 retval = zfcp_fsf_req_send(req);
1374 spin_unlock_bh(&adapter->req_q_lock);
1376 wait_event(req->completion_wq,
1377 req->status & ZFCP_STATUS_FSFREQ_COMPLETED);
1378 zfcp_fsf_req_free(req);
1383 static void zfcp_fsf_open_port_handler(struct zfcp_fsf_req *req)
1385 struct zfcp_port *port = req->data;
1386 struct fsf_qtcb_header *header = &req->qtcb->header;
1387 struct fsf_plogi *plogi;
1389 if (req->status & ZFCP_STATUS_FSFREQ_ERROR)
1392 switch (header->fsf_status) {
1393 case FSF_PORT_ALREADY_OPEN:
1395 case FSF_ACCESS_DENIED:
1396 zfcp_fsf_access_denied_port(req, port);
1398 case FSF_MAXIMUM_NUMBER_OF_PORTS_EXCEEDED:
1399 dev_warn(&req->adapter->ccw_device->dev,
1400 "Not enough FCP adapter resources to open "
1401 "remote port 0x%016Lx\n",
1402 (unsigned long long)port->wwpn);
1403 zfcp_erp_port_failed(port, "fsoph_1", req);
1404 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1406 case FSF_ADAPTER_STATUS_AVAILABLE:
1407 switch (header->fsf_status_qual.word[0]) {
1408 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
1409 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
1410 case FSF_SQ_NO_RETRY_POSSIBLE:
1411 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1416 port->handle = header->port_handle;
1417 atomic_set_mask(ZFCP_STATUS_COMMON_OPEN |
1418 ZFCP_STATUS_PORT_PHYS_OPEN, &port->status);
1419 atomic_clear_mask(ZFCP_STATUS_COMMON_ACCESS_DENIED |
1420 ZFCP_STATUS_COMMON_ACCESS_BOXED,
1422 /* check whether D_ID has changed during open */
1424 * FIXME: This check is not airtight, as the FCP channel does
1425 * not monitor closures of target port connections caused on
1426 * the remote side. Thus, they might miss out on invalidating
1427 * locally cached WWPNs (and other N_Port parameters) of gone
1428 * target ports. So, our heroic attempt to make things safe
1429 * could be undermined by 'open port' response data tagged with
1430 * obsolete WWPNs. Another reason to monitor potential
1431 * connection closures ourself at least (by interpreting
1432 * incoming ELS' and unsolicited status). It just crosses my
1433 * mind that one should be able to cross-check by means of
1434 * another GID_PN straight after a port has been opened.
1435 * Alternately, an ADISC/PDISC ELS should suffice, as well.
1437 plogi = (struct fsf_plogi *) req->qtcb->bottom.support.els;
1438 if (req->qtcb->bottom.support.els1_length >=
1439 FSF_PLOGI_MIN_LEN) {
1440 if (plogi->serv_param.wwpn != port->wwpn)
1443 port->wwnn = plogi->serv_param.wwnn;
1444 zfcp_fc_plogi_evaluate(port, plogi);
1448 case FSF_UNKNOWN_OP_SUBTYPE:
1449 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1455 * zfcp_fsf_open_port - create and send open port request
1456 * @erp_action: pointer to struct zfcp_erp_action
1457 * Returns: 0 on success, error otherwise
1459 int zfcp_fsf_open_port(struct zfcp_erp_action *erp_action)
1461 struct qdio_buffer_element *sbale;
1462 struct zfcp_adapter *adapter = erp_action->adapter;
1463 struct zfcp_fsf_req *req;
1466 spin_lock_bh(&adapter->req_q_lock);
1467 if (zfcp_fsf_req_sbal_get(adapter))
1470 req = zfcp_fsf_req_create(adapter,
1471 FSF_QTCB_OPEN_PORT_WITH_DID,
1472 ZFCP_REQ_AUTO_CLEANUP,
1473 adapter->pool.fsf_req_erp);
1475 retval = PTR_ERR(req);
1479 sbale = zfcp_qdio_sbale_req(req);
1480 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
1481 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
1483 req->handler = zfcp_fsf_open_port_handler;
1484 req->qtcb->bottom.support.d_id = erp_action->port->d_id;
1485 req->data = erp_action->port;
1486 req->erp_action = erp_action;
1487 erp_action->fsf_req = req;
1489 zfcp_fsf_start_erp_timer(req);
1490 retval = zfcp_fsf_req_send(req);
1492 zfcp_fsf_req_free(req);
1493 erp_action->fsf_req = NULL;
1496 spin_unlock_bh(&adapter->req_q_lock);
1500 static void zfcp_fsf_close_port_handler(struct zfcp_fsf_req *req)
1502 struct zfcp_port *port = req->data;
1504 if (req->status & ZFCP_STATUS_FSFREQ_ERROR)
1507 switch (req->qtcb->header.fsf_status) {
1508 case FSF_PORT_HANDLE_NOT_VALID:
1509 zfcp_erp_adapter_reopen(port->adapter, 0, "fscph_1", req);
1510 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1512 case FSF_ADAPTER_STATUS_AVAILABLE:
1515 zfcp_erp_modify_port_status(port, "fscph_2", req,
1516 ZFCP_STATUS_COMMON_OPEN,
1523 * zfcp_fsf_close_port - create and send close port request
1524 * @erp_action: pointer to struct zfcp_erp_action
1525 * Returns: 0 on success, error otherwise
1527 int zfcp_fsf_close_port(struct zfcp_erp_action *erp_action)
1529 struct qdio_buffer_element *sbale;
1530 struct zfcp_adapter *adapter = erp_action->adapter;
1531 struct zfcp_fsf_req *req;
1534 spin_lock_bh(&adapter->req_q_lock);
1535 if (zfcp_fsf_req_sbal_get(adapter))
1538 req = zfcp_fsf_req_create(adapter, FSF_QTCB_CLOSE_PORT,
1539 ZFCP_REQ_AUTO_CLEANUP,
1540 adapter->pool.fsf_req_erp);
1542 retval = PTR_ERR(req);
1546 sbale = zfcp_qdio_sbale_req(req);
1547 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
1548 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
1550 req->handler = zfcp_fsf_close_port_handler;
1551 req->data = erp_action->port;
1552 req->erp_action = erp_action;
1553 req->qtcb->header.port_handle = erp_action->port->handle;
1554 erp_action->fsf_req = req;
1556 zfcp_fsf_start_erp_timer(req);
1557 retval = zfcp_fsf_req_send(req);
1559 zfcp_fsf_req_free(req);
1560 erp_action->fsf_req = NULL;
1563 spin_unlock_bh(&adapter->req_q_lock);
1567 static void zfcp_fsf_open_wka_port_handler(struct zfcp_fsf_req *req)
1569 struct zfcp_wka_port *wka_port = req->data;
1570 struct fsf_qtcb_header *header = &req->qtcb->header;
1572 if (req->status & ZFCP_STATUS_FSFREQ_ERROR) {
1573 wka_port->status = ZFCP_WKA_PORT_OFFLINE;
1577 switch (header->fsf_status) {
1578 case FSF_MAXIMUM_NUMBER_OF_PORTS_EXCEEDED:
1579 dev_warn(&req->adapter->ccw_device->dev,
1580 "Opening WKA port 0x%x failed\n", wka_port->d_id);
1581 case FSF_ADAPTER_STATUS_AVAILABLE:
1582 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1583 case FSF_ACCESS_DENIED:
1584 wka_port->status = ZFCP_WKA_PORT_OFFLINE;
1586 case FSF_PORT_ALREADY_OPEN:
1589 wka_port->handle = header->port_handle;
1590 wka_port->status = ZFCP_WKA_PORT_ONLINE;
1593 wake_up(&wka_port->completion_wq);
1597 * zfcp_fsf_open_wka_port - create and send open wka-port request
1598 * @wka_port: pointer to struct zfcp_wka_port
1599 * Returns: 0 on success, error otherwise
1601 int zfcp_fsf_open_wka_port(struct zfcp_wka_port *wka_port)
1603 struct qdio_buffer_element *sbale;
1604 struct zfcp_adapter *adapter = wka_port->adapter;
1605 struct zfcp_fsf_req *req;
1608 spin_lock_bh(&adapter->req_q_lock);
1609 if (zfcp_fsf_req_sbal_get(adapter))
1612 req = zfcp_fsf_req_create(adapter,
1613 FSF_QTCB_OPEN_PORT_WITH_DID,
1614 ZFCP_REQ_AUTO_CLEANUP,
1615 adapter->pool.fsf_req_erp);
1616 if (unlikely(IS_ERR(req))) {
1617 retval = PTR_ERR(req);
1621 sbale = zfcp_qdio_sbale_req(req);
1622 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
1623 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
1625 req->handler = zfcp_fsf_open_wka_port_handler;
1626 req->qtcb->bottom.support.d_id = wka_port->d_id;
1627 req->data = wka_port;
1629 zfcp_fsf_start_timer(req, ZFCP_FSF_REQUEST_TIMEOUT);
1630 retval = zfcp_fsf_req_send(req);
1632 zfcp_fsf_req_free(req);
1634 spin_unlock_bh(&adapter->req_q_lock);
1638 static void zfcp_fsf_close_wka_port_handler(struct zfcp_fsf_req *req)
1640 struct zfcp_wka_port *wka_port = req->data;
1642 if (req->qtcb->header.fsf_status == FSF_PORT_HANDLE_NOT_VALID) {
1643 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1644 zfcp_erp_adapter_reopen(wka_port->adapter, 0, "fscwph1", req);
1647 wka_port->status = ZFCP_WKA_PORT_OFFLINE;
1648 wake_up(&wka_port->completion_wq);
1652 * zfcp_fsf_close_wka_port - create and send close wka port request
1653 * @erp_action: pointer to struct zfcp_erp_action
1654 * Returns: 0 on success, error otherwise
1656 int zfcp_fsf_close_wka_port(struct zfcp_wka_port *wka_port)
1658 struct qdio_buffer_element *sbale;
1659 struct zfcp_adapter *adapter = wka_port->adapter;
1660 struct zfcp_fsf_req *req;
1663 spin_lock_bh(&adapter->req_q_lock);
1664 if (zfcp_fsf_req_sbal_get(adapter))
1667 req = zfcp_fsf_req_create(adapter, FSF_QTCB_CLOSE_PORT,
1668 ZFCP_REQ_AUTO_CLEANUP,
1669 adapter->pool.fsf_req_erp);
1670 if (unlikely(IS_ERR(req))) {
1671 retval = PTR_ERR(req);
1675 sbale = zfcp_qdio_sbale_req(req);
1676 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
1677 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
1679 req->handler = zfcp_fsf_close_wka_port_handler;
1680 req->data = wka_port;
1681 req->qtcb->header.port_handle = wka_port->handle;
1683 zfcp_fsf_start_timer(req, ZFCP_FSF_REQUEST_TIMEOUT);
1684 retval = zfcp_fsf_req_send(req);
1686 zfcp_fsf_req_free(req);
1688 spin_unlock_bh(&adapter->req_q_lock);
1692 static void zfcp_fsf_close_physical_port_handler(struct zfcp_fsf_req *req)
1694 struct zfcp_port *port = req->data;
1695 struct fsf_qtcb_header *header = &req->qtcb->header;
1696 struct zfcp_unit *unit;
1698 if (req->status & ZFCP_STATUS_FSFREQ_ERROR)
1701 switch (header->fsf_status) {
1702 case FSF_PORT_HANDLE_NOT_VALID:
1703 zfcp_erp_adapter_reopen(port->adapter, 0, "fscpph1", req);
1704 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1706 case FSF_ACCESS_DENIED:
1707 zfcp_fsf_access_denied_port(req, port);
1709 case FSF_PORT_BOXED:
1710 zfcp_erp_port_boxed(port, "fscpph2", req);
1711 req->status |= ZFCP_STATUS_FSFREQ_ERROR |
1712 ZFCP_STATUS_FSFREQ_RETRY;
1713 /* can't use generic zfcp_erp_modify_port_status because
1714 * ZFCP_STATUS_COMMON_OPEN must not be reset for the port */
1715 atomic_clear_mask(ZFCP_STATUS_PORT_PHYS_OPEN, &port->status);
1716 list_for_each_entry(unit, &port->unit_list_head, list)
1717 atomic_clear_mask(ZFCP_STATUS_COMMON_OPEN,
1720 case FSF_ADAPTER_STATUS_AVAILABLE:
1721 switch (header->fsf_status_qual.word[0]) {
1722 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
1724 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
1725 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1730 /* can't use generic zfcp_erp_modify_port_status because
1731 * ZFCP_STATUS_COMMON_OPEN must not be reset for the port
1733 atomic_clear_mask(ZFCP_STATUS_PORT_PHYS_OPEN, &port->status);
1734 list_for_each_entry(unit, &port->unit_list_head, list)
1735 atomic_clear_mask(ZFCP_STATUS_COMMON_OPEN,
1742 * zfcp_fsf_close_physical_port - close physical port
1743 * @erp_action: pointer to struct zfcp_erp_action
1744 * Returns: 0 on success
1746 int zfcp_fsf_close_physical_port(struct zfcp_erp_action *erp_action)
1748 struct qdio_buffer_element *sbale;
1749 struct zfcp_adapter *adapter = erp_action->adapter;
1750 struct zfcp_fsf_req *req;
1753 spin_lock_bh(&adapter->req_q_lock);
1754 if (zfcp_fsf_req_sbal_get(adapter))
1757 req = zfcp_fsf_req_create(adapter, FSF_QTCB_CLOSE_PHYSICAL_PORT,
1758 ZFCP_REQ_AUTO_CLEANUP,
1759 adapter->pool.fsf_req_erp);
1761 retval = PTR_ERR(req);
1765 sbale = zfcp_qdio_sbale_req(req);
1766 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
1767 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
1769 req->data = erp_action->port;
1770 req->qtcb->header.port_handle = erp_action->port->handle;
1771 req->erp_action = erp_action;
1772 req->handler = zfcp_fsf_close_physical_port_handler;
1773 erp_action->fsf_req = req;
1775 zfcp_fsf_start_erp_timer(req);
1776 retval = zfcp_fsf_req_send(req);
1778 zfcp_fsf_req_free(req);
1779 erp_action->fsf_req = NULL;
1782 spin_unlock_bh(&adapter->req_q_lock);
1786 static void zfcp_fsf_open_unit_handler(struct zfcp_fsf_req *req)
1788 struct zfcp_adapter *adapter = req->adapter;
1789 struct zfcp_unit *unit = req->data;
1790 struct fsf_qtcb_header *header = &req->qtcb->header;
1791 struct fsf_qtcb_bottom_support *bottom = &req->qtcb->bottom.support;
1792 struct fsf_queue_designator *queue_designator =
1793 &header->fsf_status_qual.fsf_queue_designator;
1794 int exclusive, readwrite;
1796 if (req->status & ZFCP_STATUS_FSFREQ_ERROR)
1799 atomic_clear_mask(ZFCP_STATUS_COMMON_ACCESS_DENIED |
1800 ZFCP_STATUS_COMMON_ACCESS_BOXED |
1801 ZFCP_STATUS_UNIT_SHARED |
1802 ZFCP_STATUS_UNIT_READONLY,
1805 switch (header->fsf_status) {
1807 case FSF_PORT_HANDLE_NOT_VALID:
1808 zfcp_erp_adapter_reopen(unit->port->adapter, 0, "fsouh_1", req);
1810 case FSF_LUN_ALREADY_OPEN:
1812 case FSF_ACCESS_DENIED:
1813 zfcp_fsf_access_denied_unit(req, unit);
1814 atomic_clear_mask(ZFCP_STATUS_UNIT_SHARED, &unit->status);
1815 atomic_clear_mask(ZFCP_STATUS_UNIT_READONLY, &unit->status);
1817 case FSF_PORT_BOXED:
1818 zfcp_erp_port_boxed(unit->port, "fsouh_2", req);
1819 req->status |= ZFCP_STATUS_FSFREQ_ERROR |
1820 ZFCP_STATUS_FSFREQ_RETRY;
1822 case FSF_LUN_SHARING_VIOLATION:
1823 if (header->fsf_status_qual.word[0])
1824 dev_warn(&adapter->ccw_device->dev,
1825 "LUN 0x%Lx on port 0x%Lx is already in "
1826 "use by CSS%d, MIF Image ID %x\n",
1827 (unsigned long long)unit->fcp_lun,
1828 (unsigned long long)unit->port->wwpn,
1829 queue_designator->cssid,
1830 queue_designator->hla);
1832 zfcp_act_eval_err(adapter,
1833 header->fsf_status_qual.word[2]);
1834 zfcp_erp_unit_access_denied(unit, "fsouh_3", req);
1835 atomic_clear_mask(ZFCP_STATUS_UNIT_SHARED, &unit->status);
1836 atomic_clear_mask(ZFCP_STATUS_UNIT_READONLY, &unit->status);
1837 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1839 case FSF_MAXIMUM_NUMBER_OF_LUNS_EXCEEDED:
1840 dev_warn(&adapter->ccw_device->dev,
1841 "No handle is available for LUN "
1842 "0x%016Lx on port 0x%016Lx\n",
1843 (unsigned long long)unit->fcp_lun,
1844 (unsigned long long)unit->port->wwpn);
1845 zfcp_erp_unit_failed(unit, "fsouh_4", req);
1847 case FSF_INVALID_COMMAND_OPTION:
1848 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1850 case FSF_ADAPTER_STATUS_AVAILABLE:
1851 switch (header->fsf_status_qual.word[0]) {
1852 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
1853 zfcp_test_link(unit->port);
1855 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
1856 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1862 unit->handle = header->lun_handle;
1863 atomic_set_mask(ZFCP_STATUS_COMMON_OPEN, &unit->status);
1865 if (!(adapter->connection_features & FSF_FEATURE_NPIV_MODE) &&
1866 (adapter->adapter_features & FSF_FEATURE_LUN_SHARING) &&
1867 (adapter->ccw_device->id.dev_model != ZFCP_DEVICE_MODEL_PRIV)) {
1868 exclusive = (bottom->lun_access_info &
1869 FSF_UNIT_ACCESS_EXCLUSIVE);
1870 readwrite = (bottom->lun_access_info &
1871 FSF_UNIT_ACCESS_OUTBOUND_TRANSFER);
1874 atomic_set_mask(ZFCP_STATUS_UNIT_SHARED,
1878 atomic_set_mask(ZFCP_STATUS_UNIT_READONLY,
1880 dev_info(&adapter->ccw_device->dev,
1881 "SCSI device at LUN 0x%016Lx on port "
1882 "0x%016Lx opened read-only\n",
1883 (unsigned long long)unit->fcp_lun,
1884 (unsigned long long)unit->port->wwpn);
1887 if (exclusive && !readwrite) {
1888 dev_err(&adapter->ccw_device->dev,
1889 "Exclusive read-only access not "
1890 "supported (unit 0x%016Lx, "
1892 (unsigned long long)unit->fcp_lun,
1893 (unsigned long long)unit->port->wwpn);
1894 zfcp_erp_unit_failed(unit, "fsouh_5", req);
1895 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1896 zfcp_erp_unit_shutdown(unit, 0, "fsouh_6", req);
1897 } else if (!exclusive && readwrite) {
1898 dev_err(&adapter->ccw_device->dev,
1899 "Shared read-write access not "
1900 "supported (unit 0x%016Lx, port "
1902 (unsigned long long)unit->fcp_lun,
1903 (unsigned long long)unit->port->wwpn);
1904 zfcp_erp_unit_failed(unit, "fsouh_7", req);
1905 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1906 zfcp_erp_unit_shutdown(unit, 0, "fsouh_8", req);
1914 * zfcp_fsf_open_unit - open unit
1915 * @erp_action: pointer to struct zfcp_erp_action
1916 * Returns: 0 on success, error otherwise
1918 int zfcp_fsf_open_unit(struct zfcp_erp_action *erp_action)
1920 struct qdio_buffer_element *sbale;
1921 struct zfcp_adapter *adapter = erp_action->adapter;
1922 struct zfcp_fsf_req *req;
1925 spin_lock_bh(&adapter->req_q_lock);
1926 if (zfcp_fsf_req_sbal_get(adapter))
1929 req = zfcp_fsf_req_create(adapter, FSF_QTCB_OPEN_LUN,
1930 ZFCP_REQ_AUTO_CLEANUP,
1931 adapter->pool.fsf_req_erp);
1933 retval = PTR_ERR(req);
1937 sbale = zfcp_qdio_sbale_req(req);
1938 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
1939 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
1941 req->qtcb->header.port_handle = erp_action->port->handle;
1942 req->qtcb->bottom.support.fcp_lun = erp_action->unit->fcp_lun;
1943 req->handler = zfcp_fsf_open_unit_handler;
1944 req->data = erp_action->unit;
1945 req->erp_action = erp_action;
1946 erp_action->fsf_req = req;
1948 if (!(adapter->connection_features & FSF_FEATURE_NPIV_MODE))
1949 req->qtcb->bottom.support.option = FSF_OPEN_LUN_SUPPRESS_BOXING;
1951 zfcp_fsf_start_erp_timer(req);
1952 retval = zfcp_fsf_req_send(req);
1954 zfcp_fsf_req_free(req);
1955 erp_action->fsf_req = NULL;
1958 spin_unlock_bh(&adapter->req_q_lock);
1962 static void zfcp_fsf_close_unit_handler(struct zfcp_fsf_req *req)
1964 struct zfcp_unit *unit = req->data;
1966 if (req->status & ZFCP_STATUS_FSFREQ_ERROR)
1969 switch (req->qtcb->header.fsf_status) {
1970 case FSF_PORT_HANDLE_NOT_VALID:
1971 zfcp_erp_adapter_reopen(unit->port->adapter, 0, "fscuh_1", req);
1972 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1974 case FSF_LUN_HANDLE_NOT_VALID:
1975 zfcp_erp_port_reopen(unit->port, 0, "fscuh_2", req);
1976 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1978 case FSF_PORT_BOXED:
1979 zfcp_erp_port_boxed(unit->port, "fscuh_3", req);
1980 req->status |= ZFCP_STATUS_FSFREQ_ERROR |
1981 ZFCP_STATUS_FSFREQ_RETRY;
1983 case FSF_ADAPTER_STATUS_AVAILABLE:
1984 switch (req->qtcb->header.fsf_status_qual.word[0]) {
1985 case FSF_SQ_INVOKE_LINK_TEST_PROCEDURE:
1986 zfcp_test_link(unit->port);
1988 case FSF_SQ_ULP_DEPENDENT_ERP_REQUIRED:
1989 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
1994 atomic_clear_mask(ZFCP_STATUS_COMMON_OPEN, &unit->status);
2000 * zfcp_fsf_close_unit - close zfcp unit
2001 * @erp_action: pointer to struct zfcp_unit
2002 * Returns: 0 on success, error otherwise
2004 int zfcp_fsf_close_unit(struct zfcp_erp_action *erp_action)
2006 struct qdio_buffer_element *sbale;
2007 struct zfcp_adapter *adapter = erp_action->adapter;
2008 struct zfcp_fsf_req *req;
2011 spin_lock_bh(&adapter->req_q_lock);
2012 if (zfcp_fsf_req_sbal_get(adapter))
2014 req = zfcp_fsf_req_create(adapter, FSF_QTCB_CLOSE_LUN,
2015 ZFCP_REQ_AUTO_CLEANUP,
2016 adapter->pool.fsf_req_erp);
2018 retval = PTR_ERR(req);
2022 sbale = zfcp_qdio_sbale_req(req);
2023 sbale[0].flags |= SBAL_FLAGS0_TYPE_READ;
2024 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
2026 req->qtcb->header.port_handle = erp_action->port->handle;
2027 req->qtcb->header.lun_handle = erp_action->unit->handle;
2028 req->handler = zfcp_fsf_close_unit_handler;
2029 req->data = erp_action->unit;
2030 req->erp_action = erp_action;
2031 erp_action->fsf_req = req;
2033 zfcp_fsf_start_erp_timer(req);
2034 retval = zfcp_fsf_req_send(req);
2036 zfcp_fsf_req_free(req);
2037 erp_action->fsf_req = NULL;
2040 spin_unlock_bh(&adapter->req_q_lock);
2044 static void zfcp_fsf_update_lat(struct fsf_latency_record *lat_rec, u32 lat)
2046 lat_rec->sum += lat;
2047 lat_rec->min = min(lat_rec->min, lat);
2048 lat_rec->max = max(lat_rec->max, lat);
2051 static void zfcp_fsf_req_latency(struct zfcp_fsf_req *req)
2053 struct fsf_qual_latency_info *lat_inf;
2054 struct latency_cont *lat;
2055 struct zfcp_unit *unit = req->unit;
2057 lat_inf = &req->qtcb->prefix.prot_status_qual.latency_info;
2059 switch (req->qtcb->bottom.io.data_direction) {
2060 case FSF_DATADIR_READ:
2061 lat = &unit->latencies.read;
2063 case FSF_DATADIR_WRITE:
2064 lat = &unit->latencies.write;
2066 case FSF_DATADIR_CMND:
2067 lat = &unit->latencies.cmd;
2073 spin_lock(&unit->latencies.lock);
2074 zfcp_fsf_update_lat(&lat->channel, lat_inf->channel_lat);
2075 zfcp_fsf_update_lat(&lat->fabric, lat_inf->fabric_lat);
2077 spin_unlock(&unit->latencies.lock);
2080 #ifdef CONFIG_BLK_DEV_IO_TRACE
2081 static void zfcp_fsf_trace_latency(struct zfcp_fsf_req *fsf_req)
2083 struct fsf_qual_latency_info *lat_inf;
2084 struct scsi_cmnd *scsi_cmnd = (struct scsi_cmnd *)fsf_req->data;
2085 struct request *req = scsi_cmnd->request;
2086 struct zfcp_blk_drv_data trace;
2087 int ticks = fsf_req->adapter->timer_ticks;
2090 trace.magic = ZFCP_BLK_DRV_DATA_MAGIC;
2091 if (fsf_req->adapter->adapter_features & FSF_FEATURE_MEASUREMENT_DATA) {
2092 trace.flags |= ZFCP_BLK_LAT_VALID;
2093 lat_inf = &fsf_req->qtcb->prefix.prot_status_qual.latency_info;
2094 trace.channel_lat = lat_inf->channel_lat * ticks;
2095 trace.fabric_lat = lat_inf->fabric_lat * ticks;
2097 if (fsf_req->status & ZFCP_STATUS_FSFREQ_ERROR)
2098 trace.flags |= ZFCP_BLK_REQ_ERROR;
2099 trace.inb_usage = fsf_req->qdio_inb_usage;
2100 trace.outb_usage = fsf_req->qdio_outb_usage;
2102 blk_add_driver_data(req->q, req, &trace, sizeof(trace));
2105 static inline void zfcp_fsf_trace_latency(struct zfcp_fsf_req *fsf_req)
2110 static void zfcp_fsf_send_fcp_command_task_handler(struct zfcp_fsf_req *req)
2112 struct scsi_cmnd *scpnt;
2113 struct fcp_rsp_iu *fcp_rsp_iu = (struct fcp_rsp_iu *)
2114 &(req->qtcb->bottom.io.fcp_rsp);
2116 char *fcp_rsp_info = (unsigned char *) &fcp_rsp_iu[1];
2117 unsigned long flags;
2119 read_lock_irqsave(&req->adapter->abort_lock, flags);
2122 if (unlikely(!scpnt)) {
2123 read_unlock_irqrestore(&req->adapter->abort_lock, flags);
2127 if (unlikely(req->status & ZFCP_STATUS_FSFREQ_ABORTED)) {
2128 set_host_byte(scpnt, DID_SOFT_ERROR);
2129 goto skip_fsfstatus;
2132 if (unlikely(req->status & ZFCP_STATUS_FSFREQ_ERROR)) {
2133 set_host_byte(scpnt, DID_ERROR);
2134 goto skip_fsfstatus;
2137 set_msg_byte(scpnt, COMMAND_COMPLETE);
2139 scpnt->result |= fcp_rsp_iu->scsi_status;
2141 if (req->adapter->adapter_features & FSF_FEATURE_MEASUREMENT_DATA)
2142 zfcp_fsf_req_latency(req);
2144 zfcp_fsf_trace_latency(req);
2146 if (unlikely(fcp_rsp_iu->validity.bits.fcp_rsp_len_valid)) {
2147 if (fcp_rsp_info[3] == RSP_CODE_GOOD)
2148 set_host_byte(scpnt, DID_OK);
2150 set_host_byte(scpnt, DID_ERROR);
2151 goto skip_fsfstatus;
2155 if (unlikely(fcp_rsp_iu->validity.bits.fcp_sns_len_valid)) {
2156 sns_len = FSF_FCP_RSP_SIZE - sizeof(struct fcp_rsp_iu) +
2157 fcp_rsp_iu->fcp_rsp_len;
2158 sns_len = min(sns_len, (u32) SCSI_SENSE_BUFFERSIZE);
2159 sns_len = min(sns_len, fcp_rsp_iu->fcp_sns_len);
2161 memcpy(scpnt->sense_buffer,
2162 zfcp_get_fcp_sns_info_ptr(fcp_rsp_iu), sns_len);
2165 if (unlikely(fcp_rsp_iu->validity.bits.fcp_resid_under)) {
2166 scsi_set_resid(scpnt, fcp_rsp_iu->fcp_resid);
2167 if (scsi_bufflen(scpnt) - scsi_get_resid(scpnt) <
2169 set_host_byte(scpnt, DID_ERROR);
2172 if (scpnt->result != 0)
2173 zfcp_scsi_dbf_event_result("erro", 3, req->adapter, scpnt, req);
2174 else if (scpnt->retries > 0)
2175 zfcp_scsi_dbf_event_result("retr", 4, req->adapter, scpnt, req);
2177 zfcp_scsi_dbf_event_result("norm", 6, req->adapter, scpnt, req);
2179 scpnt->host_scribble = NULL;
2180 (scpnt->scsi_done) (scpnt);
2182 * We must hold this lock until scsi_done has been called.
2183 * Otherwise we may call scsi_done after abort regarding this
2184 * command has completed.
2185 * Note: scsi_done must not block!
2187 read_unlock_irqrestore(&req->adapter->abort_lock, flags);
2190 static void zfcp_fsf_send_fcp_ctm_handler(struct zfcp_fsf_req *req)
2192 struct fcp_rsp_iu *fcp_rsp_iu = (struct fcp_rsp_iu *)
2193 &(req->qtcb->bottom.io.fcp_rsp);
2194 char *fcp_rsp_info = (unsigned char *) &fcp_rsp_iu[1];
2196 if ((fcp_rsp_info[3] != RSP_CODE_GOOD) ||
2197 (req->status & ZFCP_STATUS_FSFREQ_ERROR))
2198 req->status |= ZFCP_STATUS_FSFREQ_TMFUNCFAILED;
2202 static void zfcp_fsf_send_fcp_command_handler(struct zfcp_fsf_req *req)
2204 struct zfcp_unit *unit;
2205 struct fsf_qtcb_header *header = &req->qtcb->header;
2207 if (unlikely(req->status & ZFCP_STATUS_FSFREQ_TASK_MANAGEMENT))
2212 if (unlikely(req->status & ZFCP_STATUS_FSFREQ_ERROR))
2213 goto skip_fsfstatus;
2215 switch (header->fsf_status) {
2216 case FSF_HANDLE_MISMATCH:
2217 case FSF_PORT_HANDLE_NOT_VALID:
2218 zfcp_erp_adapter_reopen(unit->port->adapter, 0, "fssfch1", req);
2219 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2221 case FSF_FCPLUN_NOT_VALID:
2222 case FSF_LUN_HANDLE_NOT_VALID:
2223 zfcp_erp_port_reopen(unit->port, 0, "fssfch2", req);
2224 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2226 case FSF_SERVICE_CLASS_NOT_SUPPORTED:
2227 zfcp_fsf_class_not_supp(req);
2229 case FSF_ACCESS_DENIED:
2230 zfcp_fsf_access_denied_unit(req, unit);
2232 case FSF_DIRECTION_INDICATOR_NOT_VALID:
2233 dev_err(&req->adapter->ccw_device->dev,
2234 "Incorrect direction %d, unit 0x%016Lx on port "
2235 "0x%016Lx closed\n",
2236 req->qtcb->bottom.io.data_direction,
2237 (unsigned long long)unit->fcp_lun,
2238 (unsigned long long)unit->port->wwpn);
2239 zfcp_erp_adapter_shutdown(unit->port->adapter, 0, "fssfch3",
2241 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2243 case FSF_CMND_LENGTH_NOT_VALID:
2244 dev_err(&req->adapter->ccw_device->dev,
2245 "Incorrect CDB length %d, unit 0x%016Lx on "
2246 "port 0x%016Lx closed\n",
2247 req->qtcb->bottom.io.fcp_cmnd_length,
2248 (unsigned long long)unit->fcp_lun,
2249 (unsigned long long)unit->port->wwpn);
2250 zfcp_erp_adapter_shutdown(unit->port->adapter, 0, "fssfch4",
2252 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2254 case FSF_PORT_BOXED:
2255 zfcp_erp_port_boxed(unit->port, "fssfch5", req);
2256 req->status |= ZFCP_STATUS_FSFREQ_ERROR |
2257 ZFCP_STATUS_FSFREQ_RETRY;
2260 zfcp_erp_unit_boxed(unit, "fssfch6", req);
2261 req->status |= ZFCP_STATUS_FSFREQ_ERROR |
2262 ZFCP_STATUS_FSFREQ_RETRY;
2264 case FSF_ADAPTER_STATUS_AVAILABLE:
2265 if (header->fsf_status_qual.word[0] ==
2266 FSF_SQ_INVOKE_LINK_TEST_PROCEDURE)
2267 zfcp_test_link(unit->port);
2268 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2272 if (req->status & ZFCP_STATUS_FSFREQ_TASK_MANAGEMENT)
2273 zfcp_fsf_send_fcp_ctm_handler(req);
2275 zfcp_fsf_send_fcp_command_task_handler(req);
2277 zfcp_unit_put(unit);
2281 static void zfcp_set_fcp_dl(struct fcp_cmnd_iu *fcp_cmd, u32 fcp_dl)
2286 * fcp_dl_addr = start address of fcp_cmnd structure +
2287 * size of fixed part + size of dynamically sized add_dcp_cdb field
2288 * SEE FCP-2 documentation
2290 fcp_dl_ptr = (u32 *) ((unsigned char *) &fcp_cmd[1] +
2291 (fcp_cmd->add_fcp_cdb_length << 2));
2292 *fcp_dl_ptr = fcp_dl;
2296 * zfcp_fsf_send_fcp_command_task - initiate an FCP command (for a SCSI command)
2297 * @unit: unit where command is sent to
2298 * @scsi_cmnd: scsi command to be sent
2300 int zfcp_fsf_send_fcp_command_task(struct zfcp_unit *unit,
2301 struct scsi_cmnd *scsi_cmnd)
2303 struct zfcp_fsf_req *req;
2304 struct fcp_cmnd_iu *fcp_cmnd_iu;
2305 unsigned int sbtype;
2306 int real_bytes, retval = -EIO;
2307 struct zfcp_adapter *adapter = unit->port->adapter;
2309 if (unlikely(!(atomic_read(&unit->status) &
2310 ZFCP_STATUS_COMMON_UNBLOCKED)))
2313 spin_lock(&adapter->req_q_lock);
2314 if (atomic_read(&adapter->req_q.count) <= 0) {
2315 atomic_inc(&adapter->qdio_outb_full);
2318 req = zfcp_fsf_req_create(adapter, FSF_QTCB_FCP_CMND,
2319 ZFCP_REQ_AUTO_CLEANUP,
2320 adapter->pool.fsf_req_scsi);
2322 retval = PTR_ERR(req);
2326 zfcp_unit_get(unit);
2328 req->data = scsi_cmnd;
2329 req->handler = zfcp_fsf_send_fcp_command_handler;
2330 req->qtcb->header.lun_handle = unit->handle;
2331 req->qtcb->header.port_handle = unit->port->handle;
2332 req->qtcb->bottom.io.service_class = FSF_CLASS_3;
2334 scsi_cmnd->host_scribble = (unsigned char *) req->req_id;
2336 fcp_cmnd_iu = (struct fcp_cmnd_iu *) &(req->qtcb->bottom.io.fcp_cmnd);
2337 fcp_cmnd_iu->fcp_lun = unit->fcp_lun;
2339 * set depending on data direction:
2340 * data direction bits in SBALE (SB Type)
2341 * data direction bits in QTCB
2342 * data direction bits in FCP_CMND IU
2344 switch (scsi_cmnd->sc_data_direction) {
2346 req->qtcb->bottom.io.data_direction = FSF_DATADIR_CMND;
2347 sbtype = SBAL_FLAGS0_TYPE_READ;
2349 case DMA_FROM_DEVICE:
2350 req->qtcb->bottom.io.data_direction = FSF_DATADIR_READ;
2351 sbtype = SBAL_FLAGS0_TYPE_READ;
2352 fcp_cmnd_iu->rddata = 1;
2355 req->qtcb->bottom.io.data_direction = FSF_DATADIR_WRITE;
2356 sbtype = SBAL_FLAGS0_TYPE_WRITE;
2357 fcp_cmnd_iu->wddata = 1;
2359 case DMA_BIDIRECTIONAL:
2362 goto failed_scsi_cmnd;
2365 if (likely((scsi_cmnd->device->simple_tags) ||
2366 ((atomic_read(&unit->status) & ZFCP_STATUS_UNIT_READONLY) &&
2367 (atomic_read(&unit->status) & ZFCP_STATUS_UNIT_SHARED))))
2368 fcp_cmnd_iu->task_attribute = SIMPLE_Q;
2370 fcp_cmnd_iu->task_attribute = UNTAGGED;
2372 if (unlikely(scsi_cmnd->cmd_len > FCP_CDB_LENGTH))
2373 fcp_cmnd_iu->add_fcp_cdb_length =
2374 (scsi_cmnd->cmd_len - FCP_CDB_LENGTH) >> 2;
2376 memcpy(fcp_cmnd_iu->fcp_cdb, scsi_cmnd->cmnd, scsi_cmnd->cmd_len);
2378 req->qtcb->bottom.io.fcp_cmnd_length = sizeof(struct fcp_cmnd_iu) +
2379 fcp_cmnd_iu->add_fcp_cdb_length + sizeof(u32);
2381 real_bytes = zfcp_qdio_sbals_from_sg(req, sbtype,
2382 scsi_sglist(scsi_cmnd),
2383 FSF_MAX_SBALS_PER_REQ);
2384 if (unlikely(real_bytes < 0)) {
2385 if (req->sbal_number < FSF_MAX_SBALS_PER_REQ)
2388 dev_err(&adapter->ccw_device->dev,
2389 "Oversize data package, unit 0x%016Lx "
2390 "on port 0x%016Lx closed\n",
2391 (unsigned long long)unit->fcp_lun,
2392 (unsigned long long)unit->port->wwpn);
2393 zfcp_erp_unit_shutdown(unit, 0, "fssfct1", req);
2396 goto failed_scsi_cmnd;
2399 zfcp_set_fcp_dl(fcp_cmnd_iu, real_bytes);
2401 retval = zfcp_fsf_req_send(req);
2402 if (unlikely(retval))
2403 goto failed_scsi_cmnd;
2408 zfcp_unit_put(unit);
2409 zfcp_fsf_req_free(req);
2410 scsi_cmnd->host_scribble = NULL;
2412 spin_unlock(&adapter->req_q_lock);
2417 * zfcp_fsf_send_fcp_ctm - send SCSI task management command
2418 * @unit: pointer to struct zfcp_unit
2419 * @tm_flags: unsigned byte for task management flags
2420 * Returns: on success pointer to struct fsf_req, NULL otherwise
2422 struct zfcp_fsf_req *zfcp_fsf_send_fcp_ctm(struct zfcp_unit *unit, u8 tm_flags)
2424 struct qdio_buffer_element *sbale;
2425 struct zfcp_fsf_req *req = NULL;
2426 struct fcp_cmnd_iu *fcp_cmnd_iu;
2427 struct zfcp_adapter *adapter = unit->port->adapter;
2429 if (unlikely(!(atomic_read(&unit->status) &
2430 ZFCP_STATUS_COMMON_UNBLOCKED)))
2433 spin_lock_bh(&adapter->req_q_lock);
2434 if (zfcp_fsf_req_sbal_get(adapter))
2436 req = zfcp_fsf_req_create(adapter, FSF_QTCB_FCP_CMND, 0,
2437 adapter->pool.fsf_req_scsi);
2443 req->status |= ZFCP_STATUS_FSFREQ_TASK_MANAGEMENT;
2445 req->handler = zfcp_fsf_send_fcp_command_handler;
2446 req->qtcb->header.lun_handle = unit->handle;
2447 req->qtcb->header.port_handle = unit->port->handle;
2448 req->qtcb->bottom.io.data_direction = FSF_DATADIR_CMND;
2449 req->qtcb->bottom.io.service_class = FSF_CLASS_3;
2450 req->qtcb->bottom.io.fcp_cmnd_length = sizeof(struct fcp_cmnd_iu) +
2453 sbale = zfcp_qdio_sbale_req(req);
2454 sbale[0].flags |= SBAL_FLAGS0_TYPE_WRITE;
2455 sbale[1].flags |= SBAL_FLAGS_LAST_ENTRY;
2457 fcp_cmnd_iu = (struct fcp_cmnd_iu *) &req->qtcb->bottom.io.fcp_cmnd;
2458 fcp_cmnd_iu->fcp_lun = unit->fcp_lun;
2459 fcp_cmnd_iu->task_management_flags = tm_flags;
2461 zfcp_fsf_start_timer(req, ZFCP_SCSI_ER_TIMEOUT);
2462 if (!zfcp_fsf_req_send(req))
2465 zfcp_fsf_req_free(req);
2468 spin_unlock_bh(&adapter->req_q_lock);
2472 static void zfcp_fsf_control_file_handler(struct zfcp_fsf_req *req)
2474 if (req->qtcb->header.fsf_status != FSF_GOOD)
2475 req->status |= ZFCP_STATUS_FSFREQ_ERROR;
2479 * zfcp_fsf_control_file - control file upload/download
2480 * @adapter: pointer to struct zfcp_adapter
2481 * @fsf_cfdc: pointer to struct zfcp_fsf_cfdc
2482 * Returns: on success pointer to struct zfcp_fsf_req, NULL otherwise
2484 struct zfcp_fsf_req *zfcp_fsf_control_file(struct zfcp_adapter *adapter,
2485 struct zfcp_fsf_cfdc *fsf_cfdc)
2487 struct qdio_buffer_element *sbale;
2488 struct zfcp_fsf_req *req = NULL;
2489 struct fsf_qtcb_bottom_support *bottom;
2490 int direction, retval = -EIO, bytes;
2492 if (!(adapter->adapter_features & FSF_FEATURE_CFDC))
2493 return ERR_PTR(-EOPNOTSUPP);
2495 switch (fsf_cfdc->command) {
2496 case FSF_QTCB_DOWNLOAD_CONTROL_FILE:
2497 direction = SBAL_FLAGS0_TYPE_WRITE;
2499 case FSF_QTCB_UPLOAD_CONTROL_FILE:
2500 direction = SBAL_FLAGS0_TYPE_READ;
2503 return ERR_PTR(-EINVAL);
2506 spin_lock_bh(&adapter->req_q_lock);
2507 if (zfcp_fsf_req_sbal_get(adapter))
2510 req = zfcp_fsf_req_create(adapter, fsf_cfdc->command, 0, NULL);
2516 req->handler = zfcp_fsf_control_file_handler;
2518 sbale = zfcp_qdio_sbale_req(req);
2519 sbale[0].flags |= direction;
2521 bottom = &req->qtcb->bottom.support;
2522 bottom->operation_subtype = FSF_CFDC_OPERATION_SUBTYPE;
2523 bottom->option = fsf_cfdc->option;
2525 bytes = zfcp_qdio_sbals_from_sg(req, direction, fsf_cfdc->sg,
2526 FSF_MAX_SBALS_PER_REQ);
2527 if (bytes != ZFCP_CFDC_MAX_SIZE) {
2529 zfcp_fsf_req_free(req);
2533 zfcp_fsf_start_timer(req, ZFCP_FSF_REQUEST_TIMEOUT);
2534 retval = zfcp_fsf_req_send(req);
2536 spin_unlock_bh(&adapter->req_q_lock);
2539 wait_event(req->completion_wq,
2540 req->status & ZFCP_STATUS_FSFREQ_COMPLETED);
2543 return ERR_PTR(retval);