xref: /linux/drivers/s390/scsi/zfcp_scsi.c (revision 2b8232ce512105e28453f301d1510de8363bccd1)
1 /*
2  * This file is part of the zfcp device driver for
3  * FCP adapters for IBM System z9 and zSeries.
4  *
5  * (C) Copyright IBM Corp. 2002, 2006
6  *
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.
11  *
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.
16  *
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.
20  */
21 
22 #define ZFCP_LOG_AREA			ZFCP_LOG_AREA_SCSI
23 
24 #include "zfcp_ext.h"
25 #include <asm/atomic.h>
26 
27 static void zfcp_scsi_slave_destroy(struct scsi_device *sdp);
28 static int zfcp_scsi_slave_alloc(struct scsi_device *sdp);
29 static int zfcp_scsi_slave_configure(struct scsi_device *sdp);
30 static int zfcp_scsi_queuecommand(struct scsi_cmnd *,
31 				  void (*done) (struct scsi_cmnd *));
32 static int zfcp_scsi_eh_abort_handler(struct scsi_cmnd *);
33 static int zfcp_scsi_eh_device_reset_handler(struct scsi_cmnd *);
34 static int zfcp_scsi_eh_host_reset_handler(struct scsi_cmnd *);
35 static int zfcp_task_management_function(struct zfcp_unit *, u8,
36 					 struct scsi_cmnd *);
37 
38 static struct zfcp_unit *zfcp_unit_lookup(struct zfcp_adapter *, int,
39 					  unsigned int, unsigned int);
40 
41 static struct device_attribute *zfcp_sysfs_sdev_attrs[];
42 
43 struct zfcp_data zfcp_data = {
44 	.scsi_host_template = {
45 		.name			= ZFCP_NAME,
46 		.module			= THIS_MODULE,
47 		.proc_name		= "zfcp",
48 		.slave_alloc		= zfcp_scsi_slave_alloc,
49 		.slave_configure	= zfcp_scsi_slave_configure,
50 		.slave_destroy		= zfcp_scsi_slave_destroy,
51 		.queuecommand		= zfcp_scsi_queuecommand,
52 		.eh_abort_handler	= zfcp_scsi_eh_abort_handler,
53 		.eh_device_reset_handler = zfcp_scsi_eh_device_reset_handler,
54 		.eh_bus_reset_handler	= zfcp_scsi_eh_host_reset_handler,
55 		.eh_host_reset_handler	= zfcp_scsi_eh_host_reset_handler,
56 		.can_queue		= 4096,
57 		.this_id		= -1,
58 		.sg_tablesize		= ZFCP_MAX_SBALES_PER_REQ,
59 		.cmd_per_lun		= 1,
60 		.use_clustering		= 1,
61 		.sdev_attrs		= zfcp_sysfs_sdev_attrs,
62 		.max_sectors		= ZFCP_MAX_SECTORS,
63 	},
64 	.driver_version = ZFCP_VERSION,
65 };
66 
67 /* Find start of Response Information in FCP response unit*/
68 char *
69 zfcp_get_fcp_rsp_info_ptr(struct fcp_rsp_iu *fcp_rsp_iu)
70 {
71 	char *fcp_rsp_info_ptr;
72 
73 	fcp_rsp_info_ptr =
74 	    (unsigned char *) fcp_rsp_iu + (sizeof (struct fcp_rsp_iu));
75 
76 	return fcp_rsp_info_ptr;
77 }
78 
79 /* Find start of Sense Information in FCP response unit*/
80 char *
81 zfcp_get_fcp_sns_info_ptr(struct fcp_rsp_iu *fcp_rsp_iu)
82 {
83 	char *fcp_sns_info_ptr;
84 
85 	fcp_sns_info_ptr =
86 	    (unsigned char *) fcp_rsp_iu + (sizeof (struct fcp_rsp_iu));
87 	if (fcp_rsp_iu->validity.bits.fcp_rsp_len_valid)
88 		fcp_sns_info_ptr = (char *) fcp_sns_info_ptr +
89 		    fcp_rsp_iu->fcp_rsp_len;
90 
91 	return fcp_sns_info_ptr;
92 }
93 
94 static fcp_dl_t *
95 zfcp_get_fcp_dl_ptr(struct fcp_cmnd_iu * fcp_cmd)
96 {
97 	int additional_length = fcp_cmd->add_fcp_cdb_length << 2;
98 	fcp_dl_t *fcp_dl_addr;
99 
100 	fcp_dl_addr = (fcp_dl_t *)
101 		((unsigned char *) fcp_cmd +
102 		 sizeof (struct fcp_cmnd_iu) + additional_length);
103 	/*
104 	 * fcp_dl_addr = start address of fcp_cmnd structure +
105 	 * size of fixed part + size of dynamically sized add_dcp_cdb field
106 	 * SEE FCP-2 documentation
107 	 */
108 	return fcp_dl_addr;
109 }
110 
111 fcp_dl_t
112 zfcp_get_fcp_dl(struct fcp_cmnd_iu * fcp_cmd)
113 {
114 	return *zfcp_get_fcp_dl_ptr(fcp_cmd);
115 }
116 
117 void
118 zfcp_set_fcp_dl(struct fcp_cmnd_iu *fcp_cmd, fcp_dl_t fcp_dl)
119 {
120 	*zfcp_get_fcp_dl_ptr(fcp_cmd) = fcp_dl;
121 }
122 
123 /*
124  * note: it's a bit-or operation not an assignment
125  * regarding the specified byte
126  */
127 static inline void
128 set_byte(int *result, char status, char pos)
129 {
130 	*result |= status << (pos * 8);
131 }
132 
133 void
134 set_host_byte(int *result, char status)
135 {
136 	set_byte(result, status, 2);
137 }
138 
139 void
140 set_driver_byte(int *result, char status)
141 {
142 	set_byte(result, status, 3);
143 }
144 
145 static int
146 zfcp_scsi_slave_alloc(struct scsi_device *sdp)
147 {
148 	struct zfcp_adapter *adapter;
149 	struct zfcp_unit *unit;
150 	unsigned long flags;
151 	int retval = -ENXIO;
152 
153 	adapter = (struct zfcp_adapter *) sdp->host->hostdata[0];
154 	if (!adapter)
155 		goto out;
156 
157 	read_lock_irqsave(&zfcp_data.config_lock, flags);
158 	unit = zfcp_unit_lookup(adapter, sdp->channel, sdp->id, sdp->lun);
159 	if (unit && atomic_test_mask(ZFCP_STATUS_UNIT_REGISTERED,
160 				     &unit->status)) {
161 		sdp->hostdata = unit;
162 		unit->device = sdp;
163 		zfcp_unit_get(unit);
164 		retval = 0;
165 	}
166 	read_unlock_irqrestore(&zfcp_data.config_lock, flags);
167  out:
168 	return retval;
169 }
170 
171 /**
172  * zfcp_scsi_slave_destroy - called when scsi device is removed
173  *
174  * Remove reference to associated scsi device for an zfcp_unit.
175  * Mark zfcp_unit as failed. The scsi device might be deleted via sysfs
176  * or a scan for this device might have failed.
177  */
178 static void zfcp_scsi_slave_destroy(struct scsi_device *sdpnt)
179 {
180 	struct zfcp_unit *unit = (struct zfcp_unit *) sdpnt->hostdata;
181 
182 	if (unit) {
183 		zfcp_erp_wait(unit->port->adapter);
184 		wait_event(unit->scsi_scan_wq,
185 			   atomic_test_mask(ZFCP_STATUS_UNIT_SCSI_WORK_PENDING,
186 					    &unit->status) == 0);
187 		atomic_clear_mask(ZFCP_STATUS_UNIT_REGISTERED, &unit->status);
188 		sdpnt->hostdata = NULL;
189 		unit->device = NULL;
190 		zfcp_erp_unit_failed(unit);
191 		zfcp_unit_put(unit);
192 	} else {
193 		ZFCP_LOG_NORMAL("bug: no unit associated with SCSI device at "
194 				"address %p\n", sdpnt);
195 	}
196 }
197 
198 /*
199  * called from scsi midlayer to allow finetuning of a device.
200  */
201 static int
202 zfcp_scsi_slave_configure(struct scsi_device *sdp)
203 {
204 	if (sdp->tagged_supported)
205 		scsi_adjust_queue_depth(sdp, MSG_SIMPLE_TAG, ZFCP_CMND_PER_LUN);
206 	else
207 		scsi_adjust_queue_depth(sdp, 0, 1);
208 	return 0;
209 }
210 
211 /**
212  * zfcp_scsi_command_fail - set result in scsi_cmnd and call scsi_done function
213  * @scpnt: pointer to struct scsi_cmnd where result is set
214  * @result: result to be set in scpnt (e.g. DID_ERROR)
215  */
216 static void
217 zfcp_scsi_command_fail(struct scsi_cmnd *scpnt, int result)
218 {
219 	set_host_byte(&scpnt->result, result);
220 	if ((scpnt->device != NULL) && (scpnt->device->host != NULL))
221 		zfcp_scsi_dbf_event_result("fail", 4,
222 			(struct zfcp_adapter*) scpnt->device->host->hostdata[0],
223 			scpnt, NULL);
224 	/* return directly */
225 	scpnt->scsi_done(scpnt);
226 }
227 
228 /**
229  * zfcp_scsi_command_async - worker for zfcp_scsi_queuecommand and
230  *	zfcp_scsi_command_sync
231  * @adapter: adapter where scsi command is issued
232  * @unit: unit to which scsi command is sent
233  * @scpnt: scsi command to be sent
234  * @timer: timer to be started if request is successfully initiated
235  *
236  * Note: In scsi_done function must be set in scpnt.
237  */
238 int
239 zfcp_scsi_command_async(struct zfcp_adapter *adapter, struct zfcp_unit *unit,
240 			struct scsi_cmnd *scpnt, int use_timer)
241 {
242 	int tmp;
243 	int retval;
244 
245 	retval = 0;
246 
247 	BUG_ON((adapter == NULL) || (adapter != unit->port->adapter));
248 	BUG_ON(scpnt->scsi_done == NULL);
249 
250 	if (unlikely(NULL == unit)) {
251 		zfcp_scsi_command_fail(scpnt, DID_NO_CONNECT);
252 		goto out;
253 	}
254 
255 	if (unlikely(
256 	      atomic_test_mask(ZFCP_STATUS_COMMON_ERP_FAILED, &unit->status) ||
257 	     !atomic_test_mask(ZFCP_STATUS_COMMON_RUNNING, &unit->status))) {
258 		ZFCP_LOG_DEBUG("stopping SCSI I/O on unit 0x%016Lx on port "
259 			       "0x%016Lx on adapter %s\n",
260 			       unit->fcp_lun, unit->port->wwpn,
261 			       zfcp_get_busid_by_adapter(adapter));
262 		zfcp_scsi_command_fail(scpnt, DID_ERROR);
263 		goto out;
264 	}
265 
266 	if (unlikely(
267 	     !atomic_test_mask(ZFCP_STATUS_COMMON_UNBLOCKED, &unit->status))) {
268 		ZFCP_LOG_DEBUG("adapter %s not ready or unit 0x%016Lx "
269 			       "on port 0x%016Lx in recovery\n",
270 			       zfcp_get_busid_by_unit(unit),
271 			       unit->fcp_lun, unit->port->wwpn);
272 		zfcp_scsi_command_fail(scpnt, DID_NO_CONNECT);
273 		goto out;
274 	}
275 
276 	tmp = zfcp_fsf_send_fcp_command_task(adapter, unit, scpnt, use_timer,
277 					     ZFCP_REQ_AUTO_CLEANUP);
278 
279 	if (unlikely(tmp < 0)) {
280 		ZFCP_LOG_DEBUG("error: initiation of Send FCP Cmnd failed\n");
281 		retval = SCSI_MLQUEUE_HOST_BUSY;
282 	}
283 
284 out:
285 	return retval;
286 }
287 
288 static void
289 zfcp_scsi_command_sync_handler(struct scsi_cmnd *scpnt)
290 {
291 	struct completion *wait = (struct completion *) scpnt->SCp.ptr;
292 	complete(wait);
293 }
294 
295 
296 /**
297  * zfcp_scsi_command_sync - send a SCSI command and wait for completion
298  * @unit: unit where command is sent to
299  * @scpnt: scsi command to be sent
300  * @use_timer: indicates whether timer should be setup or not
301  * Return: 0
302  *
303  * Errors are indicated in scpnt->result
304  */
305 int
306 zfcp_scsi_command_sync(struct zfcp_unit *unit, struct scsi_cmnd *scpnt,
307 		       int use_timer)
308 {
309 	int ret;
310 	DECLARE_COMPLETION_ONSTACK(wait);
311 
312 	scpnt->SCp.ptr = (void *) &wait;  /* silent re-use */
313 	scpnt->scsi_done = zfcp_scsi_command_sync_handler;
314 	ret = zfcp_scsi_command_async(unit->port->adapter, unit, scpnt,
315 				      use_timer);
316 	if (ret == 0)
317 		wait_for_completion(&wait);
318 
319 	scpnt->SCp.ptr = NULL;
320 
321 	return 0;
322 }
323 
324 /*
325  * function:	zfcp_scsi_queuecommand
326  *
327  * purpose:	enqueues a SCSI command to the specified target device
328  *
329  * returns:	0 - success, SCSI command enqueued
330  *		!0 - failure
331  */
332 static int
333 zfcp_scsi_queuecommand(struct scsi_cmnd *scpnt,
334 		       void (*done) (struct scsi_cmnd *))
335 {
336 	struct zfcp_unit *unit;
337 	struct zfcp_adapter *adapter;
338 
339 	/* reset the status for this request */
340 	scpnt->result = 0;
341 	scpnt->host_scribble = NULL;
342 	scpnt->scsi_done = done;
343 
344 	/*
345 	 * figure out adapter and target device
346 	 * (stored there by zfcp_scsi_slave_alloc)
347 	 */
348 	adapter = (struct zfcp_adapter *) scpnt->device->host->hostdata[0];
349 	unit = (struct zfcp_unit *) scpnt->device->hostdata;
350 
351 	return zfcp_scsi_command_async(adapter, unit, scpnt, 0);
352 }
353 
354 static struct zfcp_unit *
355 zfcp_unit_lookup(struct zfcp_adapter *adapter, int channel, unsigned int id,
356 		 unsigned int lun)
357 {
358 	struct zfcp_port *port;
359 	struct zfcp_unit *unit, *retval = NULL;
360 
361 	list_for_each_entry(port, &adapter->port_list_head, list) {
362 		if (!port->rport || (id != port->rport->scsi_target_id))
363 			continue;
364 		list_for_each_entry(unit, &port->unit_list_head, list) {
365 			if (lun == unit->scsi_lun) {
366 				retval = unit;
367 				goto out;
368 			}
369 		}
370 	}
371  out:
372 	return retval;
373 }
374 
375 /**
376  * zfcp_scsi_eh_abort_handler - abort the specified SCSI command
377  * @scpnt: pointer to scsi_cmnd to be aborted
378  * Return: SUCCESS - command has been aborted and cleaned up in internal
379  *          bookkeeping, SCSI stack won't be called for aborted command
380  *         FAILED - otherwise
381  *
382  * We do not need to care for a SCSI command which completes normally
383  * but late during this abort routine runs.  We are allowed to return
384  * late commands to the SCSI stack.  It tracks the state of commands and
385  * will handle late commands.  (Usually, the normal completion of late
386  * commands is ignored with respect to the running abort operation.)
387  */
388 static int zfcp_scsi_eh_abort_handler(struct scsi_cmnd *scpnt)
389 {
390  	struct Scsi_Host *scsi_host;
391  	struct zfcp_adapter *adapter;
392 	struct zfcp_unit *unit;
393 	struct zfcp_fsf_req *fsf_req;
394 	unsigned long flags;
395 	unsigned long old_req_id;
396 	int retval = SUCCESS;
397 
398 	scsi_host = scpnt->device->host;
399 	adapter = (struct zfcp_adapter *) scsi_host->hostdata[0];
400 	unit = (struct zfcp_unit *) scpnt->device->hostdata;
401 
402 	ZFCP_LOG_INFO("aborting scsi_cmnd=%p on adapter %s\n",
403 		      scpnt, zfcp_get_busid_by_adapter(adapter));
404 
405 	/* avoid race condition between late normal completion and abort */
406 	write_lock_irqsave(&adapter->abort_lock, flags);
407 
408 	/* Check whether corresponding fsf_req is still pending */
409 	spin_lock(&adapter->req_list_lock);
410 	fsf_req = zfcp_reqlist_find(adapter,
411 				    (unsigned long) scpnt->host_scribble);
412 	spin_unlock(&adapter->req_list_lock);
413 	if (!fsf_req) {
414 		write_unlock_irqrestore(&adapter->abort_lock, flags);
415 		zfcp_scsi_dbf_event_abort("lte1", adapter, scpnt, NULL, 0);
416 		retval = SUCCESS;
417 		goto out;
418 	}
419 	fsf_req->data = 0;
420 	fsf_req->status |= ZFCP_STATUS_FSFREQ_ABORTING;
421 	old_req_id = fsf_req->req_id;
422 
423 	/* don't access old fsf_req after releasing the abort_lock */
424 	write_unlock_irqrestore(&adapter->abort_lock, flags);
425 
426 	fsf_req = zfcp_fsf_abort_fcp_command(old_req_id, adapter, unit, 0);
427 	if (!fsf_req) {
428 		ZFCP_LOG_INFO("error: initiation of Abort FCP Cmnd failed\n");
429 		zfcp_scsi_dbf_event_abort("nres", adapter, scpnt, NULL,
430 					  old_req_id);
431 		retval = FAILED;
432 		goto out;
433 	}
434 
435 	__wait_event(fsf_req->completion_wq,
436 		     fsf_req->status & ZFCP_STATUS_FSFREQ_COMPLETED);
437 
438 	if (fsf_req->status & ZFCP_STATUS_FSFREQ_ABORTSUCCEEDED) {
439 		zfcp_scsi_dbf_event_abort("okay", adapter, scpnt, fsf_req, 0);
440 		retval = SUCCESS;
441 	} else if (fsf_req->status & ZFCP_STATUS_FSFREQ_ABORTNOTNEEDED) {
442 		zfcp_scsi_dbf_event_abort("lte2", adapter, scpnt, fsf_req, 0);
443 		retval = SUCCESS;
444 	} else {
445 		zfcp_scsi_dbf_event_abort("fail", adapter, scpnt, fsf_req, 0);
446 		retval = FAILED;
447 	}
448 	zfcp_fsf_req_free(fsf_req);
449  out:
450 	return retval;
451 }
452 
453 static int
454 zfcp_scsi_eh_device_reset_handler(struct scsi_cmnd *scpnt)
455 {
456 	int retval;
457 	struct zfcp_unit *unit = (struct zfcp_unit *) scpnt->device->hostdata;
458 
459 	if (!unit) {
460 		ZFCP_LOG_NORMAL("bug: Tried reset for nonexistent unit\n");
461 		retval = SUCCESS;
462 		goto out;
463 	}
464 	ZFCP_LOG_NORMAL("resetting unit 0x%016Lx\n", unit->fcp_lun);
465 
466 	/*
467 	 * If we do not know whether the unit supports 'logical unit reset'
468 	 * then try 'logical unit reset' and proceed with 'target reset'
469 	 * if 'logical unit reset' fails.
470 	 * If the unit is known not to support 'logical unit reset' then
471 	 * skip 'logical unit reset' and try 'target reset' immediately.
472 	 */
473 	if (!atomic_test_mask(ZFCP_STATUS_UNIT_NOTSUPPUNITRESET,
474 			      &unit->status)) {
475 		retval = zfcp_task_management_function(unit,
476 						       FCP_LOGICAL_UNIT_RESET,
477 						       scpnt);
478 		if (retval) {
479 			ZFCP_LOG_DEBUG("unit reset failed (unit=%p)\n", unit);
480 			if (retval == -ENOTSUPP)
481 				atomic_set_mask
482 				    (ZFCP_STATUS_UNIT_NOTSUPPUNITRESET,
483 				     &unit->status);
484 			/* fall through and try 'target reset' next */
485 		} else {
486 			ZFCP_LOG_DEBUG("unit reset succeeded (unit=%p)\n",
487 				       unit);
488 			/* avoid 'target reset' */
489 			retval = SUCCESS;
490 			goto out;
491 		}
492 	}
493 	retval = zfcp_task_management_function(unit, FCP_TARGET_RESET, scpnt);
494 	if (retval) {
495 		ZFCP_LOG_DEBUG("target reset failed (unit=%p)\n", unit);
496 		retval = FAILED;
497 	} else {
498 		ZFCP_LOG_DEBUG("target reset succeeded (unit=%p)\n", unit);
499 		retval = SUCCESS;
500 	}
501  out:
502 	return retval;
503 }
504 
505 static int
506 zfcp_task_management_function(struct zfcp_unit *unit, u8 tm_flags,
507 			      struct scsi_cmnd *scpnt)
508 {
509 	struct zfcp_adapter *adapter = unit->port->adapter;
510 	struct zfcp_fsf_req *fsf_req;
511 	int retval = 0;
512 
513 	/* issue task management function */
514 	fsf_req = zfcp_fsf_send_fcp_command_task_management
515 		(adapter, unit, tm_flags, 0);
516 	if (!fsf_req) {
517 		ZFCP_LOG_INFO("error: creation of task management request "
518 			      "failed for unit 0x%016Lx on port 0x%016Lx on  "
519 			      "adapter %s\n", unit->fcp_lun, unit->port->wwpn,
520 			      zfcp_get_busid_by_adapter(adapter));
521 		zfcp_scsi_dbf_event_devreset("nres", tm_flags, unit, scpnt);
522 		retval = -ENOMEM;
523 		goto out;
524 	}
525 
526 	__wait_event(fsf_req->completion_wq,
527 		     fsf_req->status & ZFCP_STATUS_FSFREQ_COMPLETED);
528 
529 	/*
530 	 * check completion status of task management function
531 	 */
532 	if (fsf_req->status & ZFCP_STATUS_FSFREQ_TMFUNCFAILED) {
533 		zfcp_scsi_dbf_event_devreset("fail", tm_flags, unit, scpnt);
534 		retval = -EIO;
535 	} else if (fsf_req->status & ZFCP_STATUS_FSFREQ_TMFUNCNOTSUPP) {
536 		zfcp_scsi_dbf_event_devreset("nsup", tm_flags, unit, scpnt);
537 		retval = -ENOTSUPP;
538 	} else
539 		zfcp_scsi_dbf_event_devreset("okay", tm_flags, unit, scpnt);
540 
541 	zfcp_fsf_req_free(fsf_req);
542  out:
543 	return retval;
544 }
545 
546 /**
547  * zfcp_scsi_eh_host_reset_handler - handler for host and bus reset
548  */
549 static int zfcp_scsi_eh_host_reset_handler(struct scsi_cmnd *scpnt)
550 {
551 	struct zfcp_unit *unit;
552 	struct zfcp_adapter *adapter;
553 
554 	unit = (struct zfcp_unit*) scpnt->device->hostdata;
555 	adapter = unit->port->adapter;
556 
557 	ZFCP_LOG_NORMAL("host/bus reset because of problems with "
558 			"unit 0x%016Lx\n", unit->fcp_lun);
559 
560 	zfcp_erp_adapter_reopen(adapter, 0);
561 	zfcp_erp_wait(adapter);
562 
563 	return SUCCESS;
564 }
565 
566 int
567 zfcp_adapter_scsi_register(struct zfcp_adapter *adapter)
568 {
569 	int retval = 0;
570 	static unsigned int unique_id = 0;
571 
572 	if (adapter->scsi_host)
573 		goto out;
574 
575 	/* register adapter as SCSI host with mid layer of SCSI stack */
576 	adapter->scsi_host = scsi_host_alloc(&zfcp_data.scsi_host_template,
577 					     sizeof (struct zfcp_adapter *));
578 	if (!adapter->scsi_host) {
579 		ZFCP_LOG_NORMAL("error: registration with SCSI stack failed "
580 				"for adapter %s ",
581 				zfcp_get_busid_by_adapter(adapter));
582 		retval = -EIO;
583 		goto out;
584 	}
585 	ZFCP_LOG_DEBUG("host registered, scsi_host=%p\n", adapter->scsi_host);
586 
587 	/* tell the SCSI stack some characteristics of this adapter */
588 	adapter->scsi_host->max_id = 1;
589 	adapter->scsi_host->max_lun = 1;
590 	adapter->scsi_host->max_channel = 0;
591 	adapter->scsi_host->unique_id = unique_id++;	/* FIXME */
592 	adapter->scsi_host->max_cmd_len = ZFCP_MAX_SCSI_CMND_LENGTH;
593 	adapter->scsi_host->transportt = zfcp_data.scsi_transport_template;
594 
595 	/*
596 	 * save a pointer to our own adapter data structure within
597 	 * hostdata field of SCSI host data structure
598 	 */
599 	adapter->scsi_host->hostdata[0] = (unsigned long) adapter;
600 
601 	if (scsi_add_host(adapter->scsi_host, &adapter->ccw_device->dev)) {
602 		scsi_host_put(adapter->scsi_host);
603 		retval = -EIO;
604 		goto out;
605 	}
606 	atomic_set_mask(ZFCP_STATUS_ADAPTER_REGISTERED, &adapter->status);
607  out:
608 	return retval;
609 }
610 
611 void
612 zfcp_adapter_scsi_unregister(struct zfcp_adapter *adapter)
613 {
614 	struct Scsi_Host *shost;
615 	struct zfcp_port *port;
616 
617 	shost = adapter->scsi_host;
618 	if (!shost)
619 		return;
620 	read_lock_irq(&zfcp_data.config_lock);
621 	list_for_each_entry(port, &adapter->port_list_head, list)
622 		if (port->rport)
623 			port->rport = NULL;
624 	read_unlock_irq(&zfcp_data.config_lock);
625 	fc_remove_host(shost);
626 	scsi_remove_host(shost);
627 	scsi_host_put(shost);
628 	adapter->scsi_host = NULL;
629 	atomic_clear_mask(ZFCP_STATUS_ADAPTER_REGISTERED, &adapter->status);
630 
631 	return;
632 }
633 
634 /*
635  * Support functions for FC transport class
636  */
637 static struct fc_host_statistics*
638 zfcp_init_fc_host_stats(struct zfcp_adapter *adapter)
639 {
640 	struct fc_host_statistics *fc_stats;
641 
642 	if (!adapter->fc_stats) {
643 		fc_stats = kmalloc(sizeof(*fc_stats), GFP_KERNEL);
644 		if (!fc_stats)
645 			return NULL;
646 		adapter->fc_stats = fc_stats; /* freed in adater_dequeue */
647 	}
648 	memset(adapter->fc_stats, 0, sizeof(*adapter->fc_stats));
649 	return adapter->fc_stats;
650 }
651 
652 static void
653 zfcp_adjust_fc_host_stats(struct fc_host_statistics *fc_stats,
654 			  struct fsf_qtcb_bottom_port *data,
655 			  struct fsf_qtcb_bottom_port *old)
656 {
657 	fc_stats->seconds_since_last_reset = data->seconds_since_last_reset -
658 		old->seconds_since_last_reset;
659 	fc_stats->tx_frames = data->tx_frames - old->tx_frames;
660 	fc_stats->tx_words = data->tx_words - old->tx_words;
661 	fc_stats->rx_frames = data->rx_frames - old->rx_frames;
662 	fc_stats->rx_words = data->rx_words - old->rx_words;
663 	fc_stats->lip_count = data->lip - old->lip;
664 	fc_stats->nos_count = data->nos - old->nos;
665 	fc_stats->error_frames = data->error_frames - old->error_frames;
666 	fc_stats->dumped_frames = data->dumped_frames - old->dumped_frames;
667 	fc_stats->link_failure_count = data->link_failure - old->link_failure;
668 	fc_stats->loss_of_sync_count = data->loss_of_sync - old->loss_of_sync;
669 	fc_stats->loss_of_signal_count = data->loss_of_signal -
670 		old->loss_of_signal;
671 	fc_stats->prim_seq_protocol_err_count = data->psp_error_counts -
672 		old->psp_error_counts;
673 	fc_stats->invalid_tx_word_count = data->invalid_tx_words -
674 		old->invalid_tx_words;
675 	fc_stats->invalid_crc_count = data->invalid_crcs - old->invalid_crcs;
676 	fc_stats->fcp_input_requests = data->input_requests -
677 		old->input_requests;
678 	fc_stats->fcp_output_requests = data->output_requests -
679 		old->output_requests;
680 	fc_stats->fcp_control_requests = data->control_requests -
681 		old->control_requests;
682 	fc_stats->fcp_input_megabytes = data->input_mb - old->input_mb;
683 	fc_stats->fcp_output_megabytes = data->output_mb - old->output_mb;
684 }
685 
686 static void
687 zfcp_set_fc_host_stats(struct fc_host_statistics *fc_stats,
688 		       struct fsf_qtcb_bottom_port *data)
689 {
690 	fc_stats->seconds_since_last_reset = data->seconds_since_last_reset;
691 	fc_stats->tx_frames = data->tx_frames;
692 	fc_stats->tx_words = data->tx_words;
693 	fc_stats->rx_frames = data->rx_frames;
694 	fc_stats->rx_words = data->rx_words;
695 	fc_stats->lip_count = data->lip;
696 	fc_stats->nos_count = data->nos;
697 	fc_stats->error_frames = data->error_frames;
698 	fc_stats->dumped_frames = data->dumped_frames;
699 	fc_stats->link_failure_count = data->link_failure;
700 	fc_stats->loss_of_sync_count = data->loss_of_sync;
701 	fc_stats->loss_of_signal_count = data->loss_of_signal;
702 	fc_stats->prim_seq_protocol_err_count = data->psp_error_counts;
703 	fc_stats->invalid_tx_word_count = data->invalid_tx_words;
704 	fc_stats->invalid_crc_count = data->invalid_crcs;
705 	fc_stats->fcp_input_requests = data->input_requests;
706 	fc_stats->fcp_output_requests = data->output_requests;
707 	fc_stats->fcp_control_requests = data->control_requests;
708 	fc_stats->fcp_input_megabytes = data->input_mb;
709 	fc_stats->fcp_output_megabytes = data->output_mb;
710 }
711 
712 /**
713  * zfcp_get_fc_host_stats - provide fc_host_statistics for scsi_transport_fc
714  *
715  * assumption: scsi_transport_fc synchronizes calls of
716  *             get_fc_host_stats and reset_fc_host_stats
717  *             (XXX to be checked otherwise introduce locking)
718  */
719 static struct fc_host_statistics *
720 zfcp_get_fc_host_stats(struct Scsi_Host *shost)
721 {
722 	struct zfcp_adapter *adapter;
723 	struct fc_host_statistics *fc_stats;
724 	struct fsf_qtcb_bottom_port *data;
725 	int ret;
726 
727 	adapter = (struct zfcp_adapter *)shost->hostdata[0];
728 	fc_stats = zfcp_init_fc_host_stats(adapter);
729 	if (!fc_stats)
730 		return NULL;
731 
732 	data = kzalloc(sizeof(*data), GFP_KERNEL);
733 	if (!data)
734 		return NULL;
735 
736 	ret = zfcp_fsf_exchange_port_data(NULL, adapter, data);
737 	if (ret) {
738 		kfree(data);
739 		return NULL; /* XXX return zeroed fc_stats? */
740 	}
741 
742 	if (adapter->stats_reset &&
743 	    ((jiffies/HZ - adapter->stats_reset) <
744 	     data->seconds_since_last_reset)) {
745 		zfcp_adjust_fc_host_stats(fc_stats, data,
746 					  adapter->stats_reset_data);
747 	} else
748 		zfcp_set_fc_host_stats(fc_stats, data);
749 
750 	kfree(data);
751 	return fc_stats;
752 }
753 
754 static void
755 zfcp_reset_fc_host_stats(struct Scsi_Host *shost)
756 {
757 	struct zfcp_adapter *adapter;
758 	struct fsf_qtcb_bottom_port *data, *old_data;
759 	int ret;
760 
761 	adapter = (struct zfcp_adapter *)shost->hostdata[0];
762 	data = kzalloc(sizeof(*data), GFP_KERNEL);
763 	if (!data)
764 		return;
765 
766 	ret = zfcp_fsf_exchange_port_data(NULL, adapter, data);
767 	if (ret) {
768 		kfree(data);
769 	} else {
770 		adapter->stats_reset = jiffies/HZ;
771 		old_data = adapter->stats_reset_data;
772 		adapter->stats_reset_data = data; /* finally freed in
773 						     adater_dequeue */
774 		kfree(old_data);
775 	}
776 }
777 
778 static void zfcp_set_rport_dev_loss_tmo(struct fc_rport *rport, u32 timeout)
779 {
780 	rport->dev_loss_tmo = timeout;
781 }
782 
783 struct fc_function_template zfcp_transport_functions = {
784 	.show_starget_port_id = 1,
785 	.show_starget_port_name = 1,
786 	.show_starget_node_name = 1,
787 	.show_rport_supported_classes = 1,
788 	.show_rport_maxframe_size = 1,
789 	.show_rport_dev_loss_tmo = 1,
790 	.show_host_node_name = 1,
791 	.show_host_port_name = 1,
792 	.show_host_permanent_port_name = 1,
793 	.show_host_supported_classes = 1,
794 	.show_host_supported_speeds = 1,
795 	.show_host_maxframe_size = 1,
796 	.show_host_serial_number = 1,
797 	.get_fc_host_stats = zfcp_get_fc_host_stats,
798 	.reset_fc_host_stats = zfcp_reset_fc_host_stats,
799 	.set_rport_dev_loss_tmo = zfcp_set_rport_dev_loss_tmo,
800 	/* no functions registered for following dynamic attributes but
801 	   directly set by LLDD */
802 	.show_host_port_type = 1,
803 	.show_host_speed = 1,
804 	.show_host_port_id = 1,
805 };
806 
807 /**
808  * ZFCP_DEFINE_SCSI_ATTR
809  * @_name:   name of show attribute
810  * @_format: format string
811  * @_value:  value to print
812  *
813  * Generates attribute for a unit.
814  */
815 #define ZFCP_DEFINE_SCSI_ATTR(_name, _format, _value)                    \
816 static ssize_t zfcp_sysfs_scsi_##_name##_show(struct device *dev, struct device_attribute *attr,        \
817                                               char *buf)                 \
818 {                                                                        \
819         struct scsi_device *sdev;                                        \
820         struct zfcp_unit *unit;                                          \
821                                                                          \
822         sdev = to_scsi_device(dev);                                      \
823         unit = sdev->hostdata;                                           \
824         return sprintf(buf, _format, _value);                            \
825 }                                                                        \
826                                                                          \
827 static DEVICE_ATTR(_name, S_IRUGO, zfcp_sysfs_scsi_##_name##_show, NULL);
828 
829 ZFCP_DEFINE_SCSI_ATTR(hba_id, "%s\n", zfcp_get_busid_by_unit(unit));
830 ZFCP_DEFINE_SCSI_ATTR(wwpn, "0x%016llx\n", unit->port->wwpn);
831 ZFCP_DEFINE_SCSI_ATTR(fcp_lun, "0x%016llx\n", unit->fcp_lun);
832 
833 static struct device_attribute *zfcp_sysfs_sdev_attrs[] = {
834 	&dev_attr_fcp_lun,
835 	&dev_attr_wwpn,
836 	&dev_attr_hba_id,
837 	NULL
838 };
839 
840 #undef ZFCP_LOG_AREA
841