blob: d015374f8ea923d8fb0bd33b0918e272a8dc0aa0 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 * scsi_sysfs.c
3 *
4 * SCSI sysfs interface routines.
5 *
6 * Created to pull SCSI mid layer sysfs routines into one file.
7 */
8
Linus Torvalds1da177e2005-04-16 15:20:36 -07009#include <linux/module.h>
Tejun Heo5a0e3ad2010-03-24 17:04:11 +090010#include <linux/slab.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070011#include <linux/init.h>
12#include <linux/blkdev.h>
13#include <linux/device.h>
Alan Sternbc4f2402010-06-17 10:41:42 -040014#include <linux/pm_runtime.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070015
16#include <scsi/scsi.h>
17#include <scsi/scsi_device.h>
18#include <scsi/scsi_host.h>
19#include <scsi/scsi_tcq.h>
Hannes Reinecke41f95dd2015-12-01 10:16:41 +010020#include <scsi/scsi_dh.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070021#include <scsi/scsi_transport.h>
Adrian Bunk44818ef2007-07-09 11:59:59 -070022#include <scsi/scsi_driver.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070023
24#include "scsi_priv.h"
25#include "scsi_logging.h"
26
Hannes Reineckeb0ed4332008-03-18 14:32:28 +010027static struct device_type scsi_dev_type;
28
Arjan van de Ven0ad78202005-11-28 16:22:25 +010029static const struct {
Linus Torvalds1da177e2005-04-16 15:20:36 -070030 enum scsi_device_state value;
31 char *name;
32} sdev_states[] = {
33 { SDEV_CREATED, "created" },
34 { SDEV_RUNNING, "running" },
35 { SDEV_CANCEL, "cancel" },
36 { SDEV_DEL, "deleted" },
37 { SDEV_QUIESCE, "quiesce" },
38 { SDEV_OFFLINE, "offline" },
Mike Christie1b8d2622012-05-17 23:56:56 -050039 { SDEV_TRANSPORT_OFFLINE, "transport-offline" },
Linus Torvalds1da177e2005-04-16 15:20:36 -070040 { SDEV_BLOCK, "blocked" },
James Bottomley6f4267e2008-08-22 16:53:31 -050041 { SDEV_CREATED_BLOCK, "created-blocked" },
Linus Torvalds1da177e2005-04-16 15:20:36 -070042};
43
44const char *scsi_device_state_name(enum scsi_device_state state)
45{
46 int i;
47 char *name = NULL;
48
Tobias Klauser6391a112006-06-08 22:23:48 -070049 for (i = 0; i < ARRAY_SIZE(sdev_states); i++) {
Linus Torvalds1da177e2005-04-16 15:20:36 -070050 if (sdev_states[i].value == state) {
51 name = sdev_states[i].name;
52 break;
53 }
54 }
55 return name;
56}
57
Arjan van de Ven0ad78202005-11-28 16:22:25 +010058static const struct {
Mike Andersond3301872005-06-16 11:12:38 -070059 enum scsi_host_state value;
60 char *name;
61} shost_states[] = {
62 { SHOST_CREATED, "created" },
63 { SHOST_RUNNING, "running" },
64 { SHOST_CANCEL, "cancel" },
65 { SHOST_DEL, "deleted" },
66 { SHOST_RECOVERY, "recovery" },
James Bottomley939647e2005-09-18 15:05:20 -050067 { SHOST_CANCEL_RECOVERY, "cancel/recovery" },
68 { SHOST_DEL_RECOVERY, "deleted/recovery", },
Mike Andersond3301872005-06-16 11:12:38 -070069};
70const char *scsi_host_state_name(enum scsi_host_state state)
71{
72 int i;
73 char *name = NULL;
74
Tobias Klauser6391a112006-06-08 22:23:48 -070075 for (i = 0; i < ARRAY_SIZE(shost_states); i++) {
Mike Andersond3301872005-06-16 11:12:38 -070076 if (shost_states[i].value == state) {
77 name = shost_states[i].name;
78 break;
79 }
80 }
81 return name;
82}
83
Hannes Reinecke9cb78c12014-06-25 15:27:36 +020084static int check_set(unsigned long long *val, char *src)
Linus Torvalds1da177e2005-04-16 15:20:36 -070085{
86 char *last;
87
88 if (strncmp(src, "-", 20) == 0) {
89 *val = SCAN_WILD_CARD;
90 } else {
91 /*
92 * Doesn't check for int overflow
93 */
Hannes Reinecke9cb78c12014-06-25 15:27:36 +020094 *val = simple_strtoull(src, &last, 0);
Linus Torvalds1da177e2005-04-16 15:20:36 -070095 if (*last != '\0')
96 return 1;
97 }
98 return 0;
99}
100
101static int scsi_scan(struct Scsi_Host *shost, const char *str)
102{
Hannes Reinecke9cb78c12014-06-25 15:27:36 +0200103 char s1[15], s2[15], s3[17], junk;
104 unsigned long long channel, id, lun;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700105 int res;
106
Hannes Reinecke9cb78c12014-06-25 15:27:36 +0200107 res = sscanf(str, "%10s %10s %16s %c", s1, s2, s3, &junk);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700108 if (res != 3)
109 return -EINVAL;
110 if (check_set(&channel, s1))
111 return -EINVAL;
112 if (check_set(&id, s2))
113 return -EINVAL;
114 if (check_set(&lun, s3))
115 return -EINVAL;
Christoph Hellwige02f3f52006-01-13 19:04:00 +0100116 if (shost->transportt->user_scan)
117 res = shost->transportt->user_scan(shost, channel, id, lun);
118 else
119 res = scsi_scan_host_selected(shost, channel, id, lun, 1);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700120 return res;
121}
122
123/*
124 * shost_show_function: macro to create an attr function that can be used to
125 * show a non-bit field.
126 */
127#define shost_show_function(name, field, format_string) \
128static ssize_t \
Tony Jonesee959b02008-02-22 00:13:36 +0100129show_##name (struct device *dev, struct device_attribute *attr, \
130 char *buf) \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700131{ \
Tony Jonesee959b02008-02-22 00:13:36 +0100132 struct Scsi_Host *shost = class_to_shost(dev); \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700133 return snprintf (buf, 20, format_string, shost->field); \
134}
135
136/*
137 * shost_rd_attr: macro to create a function and attribute variable for a
138 * read only field.
139 */
140#define shost_rd_attr2(name, field, format_string) \
141 shost_show_function(name, field, format_string) \
Tony Jonesee959b02008-02-22 00:13:36 +0100142static DEVICE_ATTR(name, S_IRUGO, show_##name, NULL);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700143
144#define shost_rd_attr(field, format_string) \
145shost_rd_attr2(field, field, format_string)
146
147/*
148 * Create the actual show/store functions and data structures.
149 */
150
Tony Jonesee959b02008-02-22 00:13:36 +0100151static ssize_t
152store_scan(struct device *dev, struct device_attribute *attr,
153 const char *buf, size_t count)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700154{
Tony Jonesee959b02008-02-22 00:13:36 +0100155 struct Scsi_Host *shost = class_to_shost(dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700156 int res;
157
158 res = scsi_scan(shost, buf);
159 if (res == 0)
160 res = count;
161 return res;
162};
Tony Jonesee959b02008-02-22 00:13:36 +0100163static DEVICE_ATTR(scan, S_IWUSR, NULL, store_scan);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700164
Mike Andersond3301872005-06-16 11:12:38 -0700165static ssize_t
Tony Jonesee959b02008-02-22 00:13:36 +0100166store_shost_state(struct device *dev, struct device_attribute *attr,
167 const char *buf, size_t count)
Mike Andersond3301872005-06-16 11:12:38 -0700168{
169 int i;
Tony Jonesee959b02008-02-22 00:13:36 +0100170 struct Scsi_Host *shost = class_to_shost(dev);
Mike Andersond3301872005-06-16 11:12:38 -0700171 enum scsi_host_state state = 0;
172
Tobias Klauser6391a112006-06-08 22:23:48 -0700173 for (i = 0; i < ARRAY_SIZE(shost_states); i++) {
Mike Andersond3301872005-06-16 11:12:38 -0700174 const int len = strlen(shost_states[i].name);
175 if (strncmp(shost_states[i].name, buf, len) == 0 &&
176 buf[len] == '\n') {
177 state = shost_states[i].value;
178 break;
179 }
180 }
181 if (!state)
182 return -EINVAL;
183
184 if (scsi_host_set_state(shost, state))
185 return -EINVAL;
186 return count;
187}
188
189static ssize_t
Tony Jonesee959b02008-02-22 00:13:36 +0100190show_shost_state(struct device *dev, struct device_attribute *attr, char *buf)
Mike Andersond3301872005-06-16 11:12:38 -0700191{
Tony Jonesee959b02008-02-22 00:13:36 +0100192 struct Scsi_Host *shost = class_to_shost(dev);
Mike Andersond3301872005-06-16 11:12:38 -0700193 const char *name = scsi_host_state_name(shost->shost_state);
194
195 if (!name)
196 return -EINVAL;
197
198 return snprintf(buf, 20, "%s\n", name);
199}
200
Tony Jonesee959b02008-02-22 00:13:36 +0100201/* DEVICE_ATTR(state) clashes with dev_attr_state for sdev */
202struct device_attribute dev_attr_hstate =
203 __ATTR(state, S_IRUGO | S_IWUSR, show_shost_state, store_shost_state);
Mike Andersond3301872005-06-16 11:12:38 -0700204
FUJITA Tomonori5dc2b892007-09-01 02:02:20 +0900205static ssize_t
206show_shost_mode(unsigned int mode, char *buf)
207{
208 ssize_t len = 0;
209
210 if (mode & MODE_INITIATOR)
211 len = sprintf(buf, "%s", "Initiator");
212
213 if (mode & MODE_TARGET)
214 len += sprintf(buf + len, "%s%s", len ? ", " : "", "Target");
215
216 len += sprintf(buf + len, "\n");
217
218 return len;
219}
220
Tony Jonesee959b02008-02-22 00:13:36 +0100221static ssize_t
222show_shost_supported_mode(struct device *dev, struct device_attribute *attr,
223 char *buf)
FUJITA Tomonori5dc2b892007-09-01 02:02:20 +0900224{
Tony Jonesee959b02008-02-22 00:13:36 +0100225 struct Scsi_Host *shost = class_to_shost(dev);
James Bottomley7a39ac32007-09-25 22:45:53 -0500226 unsigned int supported_mode = shost->hostt->supported_mode;
FUJITA Tomonori5dc2b892007-09-01 02:02:20 +0900227
James Bottomley7a39ac32007-09-25 22:45:53 -0500228 if (supported_mode == MODE_UNKNOWN)
229 /* by default this should be initiator */
230 supported_mode = MODE_INITIATOR;
231
232 return show_shost_mode(supported_mode, buf);
FUJITA Tomonori5dc2b892007-09-01 02:02:20 +0900233}
234
Tony Jonesee959b02008-02-22 00:13:36 +0100235static DEVICE_ATTR(supported_mode, S_IRUGO | S_IWUSR, show_shost_supported_mode, NULL);
FUJITA Tomonori5dc2b892007-09-01 02:02:20 +0900236
Tony Jonesee959b02008-02-22 00:13:36 +0100237static ssize_t
238show_shost_active_mode(struct device *dev,
239 struct device_attribute *attr, char *buf)
FUJITA Tomonori5dc2b892007-09-01 02:02:20 +0900240{
Tony Jonesee959b02008-02-22 00:13:36 +0100241 struct Scsi_Host *shost = class_to_shost(dev);
FUJITA Tomonori5dc2b892007-09-01 02:02:20 +0900242
243 if (shost->active_mode == MODE_UNKNOWN)
244 return snprintf(buf, 20, "unknown\n");
245 else
246 return show_shost_mode(shost->active_mode, buf);
247}
248
Tony Jonesee959b02008-02-22 00:13:36 +0100249static DEVICE_ATTR(active_mode, S_IRUGO | S_IWUSR, show_shost_active_mode, NULL);
FUJITA Tomonori5dc2b892007-09-01 02:02:20 +0900250
Sasha Levin072f19b2012-11-15 15:51:46 -0500251static int check_reset_type(const char *str)
Vikas Chaudhary29443692011-08-12 02:51:28 -0700252{
Sasha Levin072f19b2012-11-15 15:51:46 -0500253 if (sysfs_streq(str, "adapter"))
Vikas Chaudhary29443692011-08-12 02:51:28 -0700254 return SCSI_ADAPTER_RESET;
Sasha Levin072f19b2012-11-15 15:51:46 -0500255 else if (sysfs_streq(str, "firmware"))
Vikas Chaudhary29443692011-08-12 02:51:28 -0700256 return SCSI_FIRMWARE_RESET;
257 else
258 return 0;
259}
260
261static ssize_t
262store_host_reset(struct device *dev, struct device_attribute *attr,
263 const char *buf, size_t count)
264{
265 struct Scsi_Host *shost = class_to_shost(dev);
266 struct scsi_host_template *sht = shost->hostt;
267 int ret = -EINVAL;
Vikas Chaudhary29443692011-08-12 02:51:28 -0700268 int type;
269
Sasha Levin072f19b2012-11-15 15:51:46 -0500270 type = check_reset_type(buf);
Vikas Chaudhary29443692011-08-12 02:51:28 -0700271 if (!type)
272 goto exit_store_host_reset;
273
274 if (sht->host_reset)
275 ret = sht->host_reset(shost, type);
276
277exit_store_host_reset:
278 if (ret == 0)
279 ret = count;
280 return ret;
281}
282
283static DEVICE_ATTR(host_reset, S_IWUSR, NULL, store_host_reset);
284
Hannes Reineckeb4562022013-10-23 10:51:21 +0200285static ssize_t
286show_shost_eh_deadline(struct device *dev,
287 struct device_attribute *attr, char *buf)
288{
289 struct Scsi_Host *shost = class_to_shost(dev);
290
Ren Mingxinbb3b6212013-11-11 13:44:56 +0100291 if (shost->eh_deadline == -1)
292 return snprintf(buf, strlen("off") + 2, "off\n");
293 return sprintf(buf, "%u\n", shost->eh_deadline / HZ);
Hannes Reineckeb4562022013-10-23 10:51:21 +0200294}
295
296static ssize_t
297store_shost_eh_deadline(struct device *dev, struct device_attribute *attr,
298 const char *buf, size_t count)
299{
300 struct Scsi_Host *shost = class_to_shost(dev);
301 int ret = -EINVAL;
Ren Mingxinbb3b6212013-11-11 13:44:56 +0100302 unsigned long deadline, flags;
Hannes Reineckeb4562022013-10-23 10:51:21 +0200303
Hannes Reineckead469a52014-01-17 16:05:38 +0100304 if (shost->transportt &&
305 (shost->transportt->eh_strategy_handler ||
306 !shost->hostt->eh_host_reset_handler))
Hannes Reineckeb4562022013-10-23 10:51:21 +0200307 return ret;
308
Ren Mingxinbb3b6212013-11-11 13:44:56 +0100309 if (!strncmp(buf, "off", strlen("off")))
310 deadline = -1;
311 else {
312 ret = kstrtoul(buf, 10, &deadline);
313 if (ret)
314 return ret;
315 if (deadline * HZ > UINT_MAX)
316 return -EINVAL;
Hannes Reineckeb4562022013-10-23 10:51:21 +0200317 }
Ren Mingxinbb3b6212013-11-11 13:44:56 +0100318
319 spin_lock_irqsave(shost->host_lock, flags);
320 if (scsi_host_in_recovery(shost))
321 ret = -EBUSY;
322 else {
323 if (deadline == -1)
324 shost->eh_deadline = -1;
325 else
326 shost->eh_deadline = deadline * HZ;
327
328 ret = count;
329 }
330 spin_unlock_irqrestore(shost->host_lock, flags);
331
Hannes Reineckeb4562022013-10-23 10:51:21 +0200332 return ret;
333}
334
335static DEVICE_ATTR(eh_deadline, S_IRUGO | S_IWUSR, show_shost_eh_deadline, store_shost_eh_deadline);
336
Christoph Hellwigd2852032014-01-17 12:06:53 +0100337shost_rd_attr(use_blk_mq, "%d\n");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700338shost_rd_attr(unique_id, "%u\n");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700339shost_rd_attr(cmd_per_lun, "%hd\n");
James Bottomleyed632da2006-10-16 10:06:27 -0500340shost_rd_attr(can_queue, "%hd\n");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700341shost_rd_attr(sg_tablesize, "%hu\n");
Martin K. Petersen13f05c82010-09-10 20:50:10 +0200342shost_rd_attr(sg_prot_tablesize, "%hu\n");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700343shost_rd_attr(unchecked_isa_dma, "%d\n");
Martin K. Petersen4469f982008-07-17 04:28:30 -0400344shost_rd_attr(prot_capabilities, "%u\n");
345shost_rd_attr(prot_guard_type, "%hd\n");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700346shost_rd_attr2(proc_name, hostt->proc_name, "%s\n");
347
Christoph Hellwig74665012014-01-22 15:29:29 +0100348static ssize_t
349show_host_busy(struct device *dev, struct device_attribute *attr, char *buf)
350{
351 struct Scsi_Host *shost = class_to_shost(dev);
352 return snprintf(buf, 20, "%d\n", atomic_read(&shost->host_busy));
353}
354static DEVICE_ATTR(host_busy, S_IRUGO, show_host_busy, NULL);
355
Hannes Reineckef7120a42008-03-18 14:32:28 +0100356static struct attribute *scsi_sysfs_shost_attrs[] = {
Christoph Hellwigd2852032014-01-17 12:06:53 +0100357 &dev_attr_use_blk_mq.attr,
Hannes Reineckef7120a42008-03-18 14:32:28 +0100358 &dev_attr_unique_id.attr,
359 &dev_attr_host_busy.attr,
360 &dev_attr_cmd_per_lun.attr,
361 &dev_attr_can_queue.attr,
362 &dev_attr_sg_tablesize.attr,
Martin K. Petersen13f05c82010-09-10 20:50:10 +0200363 &dev_attr_sg_prot_tablesize.attr,
Hannes Reineckef7120a42008-03-18 14:32:28 +0100364 &dev_attr_unchecked_isa_dma.attr,
365 &dev_attr_proc_name.attr,
366 &dev_attr_scan.attr,
367 &dev_attr_hstate.attr,
368 &dev_attr_supported_mode.attr,
369 &dev_attr_active_mode.attr,
Martin K. Petersen4469f982008-07-17 04:28:30 -0400370 &dev_attr_prot_capabilities.attr,
371 &dev_attr_prot_guard_type.attr,
Vikas Chaudhary29443692011-08-12 02:51:28 -0700372 &dev_attr_host_reset.attr,
Hannes Reineckeb4562022013-10-23 10:51:21 +0200373 &dev_attr_eh_deadline.attr,
Hannes Reineckef7120a42008-03-18 14:32:28 +0100374 NULL
375};
376
377struct attribute_group scsi_shost_attr_group = {
378 .attrs = scsi_sysfs_shost_attrs,
379};
380
David Brownella4dbd672009-06-24 10:06:31 -0700381const struct attribute_group *scsi_sysfs_shost_attr_groups[] = {
Hannes Reineckef7120a42008-03-18 14:32:28 +0100382 &scsi_shost_attr_group,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700383 NULL
384};
385
Tony Jonesee959b02008-02-22 00:13:36 +0100386static void scsi_device_cls_release(struct device *class_dev)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700387{
388 struct scsi_device *sdev;
389
390 sdev = class_to_sdev(class_dev);
391 put_device(&sdev->sdev_gendev);
392}
393
David Howells65f27f32006-11-22 14:55:48 +0000394static void scsi_device_dev_release_usercontext(struct work_struct *work)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700395{
396 struct scsi_device *sdev;
397 struct device *parent;
Jeff Garzika341cd02007-10-29 17:15:22 -0400398 struct list_head *this, *tmp;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700399 unsigned long flags;
400
David Howells65f27f32006-11-22 14:55:48 +0000401 sdev = container_of(work, struct scsi_device, ew.work);
402
Junichi Nomura23695e42015-10-06 04:32:57 +0000403 scsi_dh_release_device(sdev);
404
David Howells65f27f32006-11-22 14:55:48 +0000405 parent = sdev->sdev_gendev.parent;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700406
407 spin_lock_irqsave(sdev->host->host_lock, flags);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700408 list_del(&sdev->siblings);
409 list_del(&sdev->same_target_siblings);
410 list_del(&sdev->starved_entry);
411 spin_unlock_irqrestore(sdev->host->host_lock, flags);
412
Jeff Garzika341cd02007-10-29 17:15:22 -0400413 cancel_work_sync(&sdev->event_work);
414
415 list_for_each_safe(this, tmp, &sdev->event_list) {
416 struct scsi_event *evt;
417
418 evt = list_entry(this, struct scsi_event, node);
419 list_del(&evt->node);
420 kfree(evt);
421 }
422
James Bottomleye73e0792011-05-25 15:52:14 -0500423 blk_put_queue(sdev->request_queue);
James Bottomley86cbfb52011-04-22 10:39:59 -0500424 /* NULL queue means the device can't be used */
425 sdev->request_queue = NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700426
Hannes Reineckeb3ae8782014-03-15 09:51:49 +0100427 kfree(sdev->vpd_pg83);
428 kfree(sdev->vpd_pg80);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700429 kfree(sdev->inquiry);
430 kfree(sdev);
431
432 if (parent)
433 put_device(parent);
434}
435
James Bottomley65110b22006-02-14 10:48:46 -0600436static void scsi_device_dev_release(struct device *dev)
437{
James Bottomleyffedb452006-02-23 14:27:18 -0600438 struct scsi_device *sdp = to_scsi_device(dev);
David Howells65f27f32006-11-22 14:55:48 +0000439 execute_in_process_context(scsi_device_dev_release_usercontext,
James Bottomleyffedb452006-02-23 14:27:18 -0600440 &sdp->ew);
James Bottomley65110b22006-02-14 10:48:46 -0600441}
442
Adrian Bunk52c1da32005-06-23 22:05:33 -0700443static struct class sdev_class = {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700444 .name = "scsi_device",
Tony Jonesee959b02008-02-22 00:13:36 +0100445 .dev_release = scsi_device_cls_release,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700446};
447
448/* all probing is done in the individual ->probe routines */
449static int scsi_bus_match(struct device *dev, struct device_driver *gendrv)
450{
Hannes Reineckeb0ed4332008-03-18 14:32:28 +0100451 struct scsi_device *sdp;
452
453 if (dev->type != &scsi_dev_type)
454 return 0;
455
456 sdp = to_scsi_device(dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700457 if (sdp->no_uld_attach)
458 return 0;
459 return (sdp->inq_periph_qual == SCSI_INQ_PQ_CON)? 1: 0;
460}
461
Kay Sievers7eff2e72007-08-14 15:15:12 +0200462static int scsi_bus_uevent(struct device *dev, struct kobj_uevent_env *env)
Michael Tokarevd7b8bcb02006-10-27 16:02:37 +0400463{
James Bottomley1f42ea72008-05-22 12:34:41 +0100464 struct scsi_device *sdev;
465
466 if (dev->type != &scsi_dev_type)
467 return 0;
468
469 sdev = to_scsi_device(dev);
Michael Tokarevd7b8bcb02006-10-27 16:02:37 +0400470
Kay Sievers7eff2e72007-08-14 15:15:12 +0200471 add_uevent_var(env, "MODALIAS=" SCSI_DEVICE_MODALIAS_FMT, sdev->type);
Michael Tokarevd7b8bcb02006-10-27 16:02:37 +0400472 return 0;
473}
474
Linus Torvalds1da177e2005-04-16 15:20:36 -0700475struct bus_type scsi_bus_type = {
476 .name = "scsi",
477 .match = scsi_bus_match,
Michael Tokarevd7b8bcb02006-10-27 16:02:37 +0400478 .uevent = scsi_bus_uevent,
Rafael J. Wysockiaa338602011-02-11 00:06:54 +0100479#ifdef CONFIG_PM
Alan Sterndb5bd1e2010-06-17 10:36:49 -0400480 .pm = &scsi_bus_pm_ops,
Alan Sterne6da54d2010-08-05 13:17:10 -0400481#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700482};
Chandra Seetharamana6a8d9f2008-05-01 14:49:46 -0700483EXPORT_SYMBOL_GPL(scsi_bus_type);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700484
485int scsi_sysfs_register(void)
486{
487 int error;
488
489 error = bus_register(&scsi_bus_type);
490 if (!error) {
491 error = class_register(&sdev_class);
492 if (error)
493 bus_unregister(&scsi_bus_type);
494 }
495
496 return error;
497}
498
499void scsi_sysfs_unregister(void)
500{
501 class_unregister(&sdev_class);
502 bus_unregister(&scsi_bus_type);
503}
504
505/*
506 * sdev_show_function: macro to create an attr function that can be used to
507 * show a non-bit field.
508 */
509#define sdev_show_function(field, format_string) \
510static ssize_t \
Tony Jonesee959b02008-02-22 00:13:36 +0100511sdev_show_##field (struct device *dev, struct device_attribute *attr, \
512 char *buf) \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700513{ \
514 struct scsi_device *sdev; \
515 sdev = to_scsi_device(dev); \
516 return snprintf (buf, 20, format_string, sdev->field); \
517} \
518
519/*
520 * sdev_rd_attr: macro to create a function and attribute variable for a
521 * read only field.
522 */
523#define sdev_rd_attr(field, format_string) \
524 sdev_show_function(field, format_string) \
525static DEVICE_ATTR(field, S_IRUGO, sdev_show_##field, NULL);
526
527
528/*
Tomohiro Kusumi160e7f62010-04-14 15:15:14 +0900529 * sdev_rw_attr: create a function and attribute variable for a
Linus Torvalds1da177e2005-04-16 15:20:36 -0700530 * read/write field.
531 */
532#define sdev_rw_attr(field, format_string) \
533 sdev_show_function(field, format_string) \
534 \
535static ssize_t \
Tony Jonesee959b02008-02-22 00:13:36 +0100536sdev_store_##field (struct device *dev, struct device_attribute *attr, \
537 const char *buf, size_t count) \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700538{ \
539 struct scsi_device *sdev; \
540 sdev = to_scsi_device(dev); \
Tomohiro Kusumi160e7f62010-04-14 15:15:14 +0900541 sscanf (buf, format_string, &sdev->field); \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700542 return count; \
543} \
544static DEVICE_ATTR(field, S_IRUGO | S_IWUSR, sdev_show_##field, sdev_store_##field);
545
546/* Currently we don't export bit fields, but we might in future,
547 * so leave this code in */
548#if 0
549/*
550 * sdev_rd_attr: create a function and attribute variable for a
551 * read/write bit field.
552 */
553#define sdev_rw_attr_bit(field) \
554 sdev_show_function(field, "%d\n") \
555 \
556static ssize_t \
Tony Jonesee959b02008-02-22 00:13:36 +0100557sdev_store_##field (struct device *dev, struct device_attribute *attr, \
558 const char *buf, size_t count) \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700559{ \
560 int ret; \
561 struct scsi_device *sdev; \
562 ret = scsi_sdev_check_buf_bit(buf); \
563 if (ret >= 0) { \
564 sdev = to_scsi_device(dev); \
565 sdev->field = ret; \
566 ret = count; \
567 } \
568 return ret; \
569} \
570static DEVICE_ATTR(field, S_IRUGO | S_IWUSR, sdev_show_##field, sdev_store_##field);
571
572/*
573 * scsi_sdev_check_buf_bit: return 0 if buf is "0", return 1 if buf is "1",
574 * else return -EINVAL.
575 */
576static int scsi_sdev_check_buf_bit(const char *buf)
577{
578 if ((buf[1] == '\0') || ((buf[1] == '\n') && (buf[2] == '\0'))) {
579 if (buf[0] == '1')
580 return 1;
581 else if (buf[0] == '0')
582 return 0;
583 else
584 return -EINVAL;
585 } else
586 return -EINVAL;
587}
588#endif
589/*
590 * Create the actual show/store functions and data structures.
591 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700592sdev_rd_attr (type, "%d\n");
593sdev_rd_attr (scsi_level, "%d\n");
594sdev_rd_attr (vendor, "%.8s\n");
595sdev_rd_attr (model, "%.16s\n");
596sdev_rd_attr (rev, "%.4s\n");
597
Christoph Hellwig71e75c92014-04-11 19:07:01 +0200598static ssize_t
599sdev_show_device_busy(struct device *dev, struct device_attribute *attr,
600 char *buf)
601{
602 struct scsi_device *sdev = to_scsi_device(dev);
603 return snprintf(buf, 20, "%d\n", atomic_read(&sdev->device_busy));
604}
605static DEVICE_ATTR(device_busy, S_IRUGO, sdev_show_device_busy, NULL);
606
Christoph Hellwigcd9070c2014-01-23 12:07:41 +0100607static ssize_t
608sdev_show_device_blocked(struct device *dev, struct device_attribute *attr,
609 char *buf)
610{
611 struct scsi_device *sdev = to_scsi_device(dev);
612 return snprintf(buf, 20, "%d\n", atomic_read(&sdev->device_blocked));
613}
614static DEVICE_ATTR(device_blocked, S_IRUGO, sdev_show_device_blocked, NULL);
615
Jens Axboe242f9dc2008-09-14 05:55:09 -0700616/*
617 * TODO: can we make these symlinks to the block layer ones?
618 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700619static ssize_t
Yani Ioannou10523b32005-05-17 06:43:37 -0400620sdev_show_timeout (struct device *dev, struct device_attribute *attr, char *buf)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700621{
622 struct scsi_device *sdev;
623 sdev = to_scsi_device(dev);
Jens Axboe242f9dc2008-09-14 05:55:09 -0700624 return snprintf(buf, 20, "%d\n", sdev->request_queue->rq_timeout / HZ);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700625}
626
627static ssize_t
Tony Jonesee959b02008-02-22 00:13:36 +0100628sdev_store_timeout (struct device *dev, struct device_attribute *attr,
629 const char *buf, size_t count)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700630{
631 struct scsi_device *sdev;
632 int timeout;
633 sdev = to_scsi_device(dev);
634 sscanf (buf, "%d\n", &timeout);
Jens Axboe242f9dc2008-09-14 05:55:09 -0700635 blk_queue_rq_timeout(sdev->request_queue, timeout * HZ);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700636 return count;
637}
638static DEVICE_ATTR(timeout, S_IRUGO | S_IWUSR, sdev_show_timeout, sdev_store_timeout);
639
640static ssize_t
Martin K. Petersen0816c922013-05-10 10:36:04 -0400641sdev_show_eh_timeout(struct device *dev, struct device_attribute *attr, char *buf)
642{
643 struct scsi_device *sdev;
644 sdev = to_scsi_device(dev);
645 return snprintf(buf, 20, "%u\n", sdev->eh_timeout / HZ);
646}
647
648static ssize_t
649sdev_store_eh_timeout(struct device *dev, struct device_attribute *attr,
650 const char *buf, size_t count)
651{
652 struct scsi_device *sdev;
653 unsigned int eh_timeout;
654 int err;
655
656 if (!capable(CAP_SYS_ADMIN))
657 return -EACCES;
658
659 sdev = to_scsi_device(dev);
660 err = kstrtouint(buf, 10, &eh_timeout);
661 if (err)
662 return err;
663 sdev->eh_timeout = eh_timeout * HZ;
664
665 return count;
666}
667static DEVICE_ATTR(eh_timeout, S_IRUGO | S_IWUSR, sdev_show_eh_timeout, sdev_store_eh_timeout);
668
669static ssize_t
Tony Jonesee959b02008-02-22 00:13:36 +0100670store_rescan_field (struct device *dev, struct device_attribute *attr,
671 const char *buf, size_t count)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700672{
673 scsi_rescan_device(dev);
674 return count;
675}
676static DEVICE_ATTR(rescan, S_IWUSR, NULL, store_rescan_field);
677
Tony Jonesee959b02008-02-22 00:13:36 +0100678static ssize_t
679sdev_store_delete(struct device *dev, struct device_attribute *attr,
680 const char *buf, size_t count)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700681{
Tejun Heoac0ece92014-02-03 14:03:03 -0500682 if (device_remove_file_self(dev, attr))
683 scsi_remove_device(to_scsi_device(dev));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700684 return count;
685};
686static DEVICE_ATTR(delete, S_IWUSR, NULL, sdev_store_delete);
687
688static ssize_t
Tony Jonesee959b02008-02-22 00:13:36 +0100689store_state_field(struct device *dev, struct device_attribute *attr,
690 const char *buf, size_t count)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700691{
692 int i;
693 struct scsi_device *sdev = to_scsi_device(dev);
694 enum scsi_device_state state = 0;
695
Tobias Klauser6391a112006-06-08 22:23:48 -0700696 for (i = 0; i < ARRAY_SIZE(sdev_states); i++) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700697 const int len = strlen(sdev_states[i].name);
698 if (strncmp(sdev_states[i].name, buf, len) == 0 &&
699 buf[len] == '\n') {
700 state = sdev_states[i].value;
701 break;
702 }
703 }
704 if (!state)
705 return -EINVAL;
706
707 if (scsi_device_set_state(sdev, state))
708 return -EINVAL;
709 return count;
710}
711
712static ssize_t
Yani Ioannou10523b32005-05-17 06:43:37 -0400713show_state_field(struct device *dev, struct device_attribute *attr, char *buf)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700714{
715 struct scsi_device *sdev = to_scsi_device(dev);
716 const char *name = scsi_device_state_name(sdev->sdev_state);
717
718 if (!name)
719 return -EINVAL;
720
721 return snprintf(buf, 20, "%s\n", name);
722}
723
724static DEVICE_ATTR(state, S_IRUGO | S_IWUSR, show_state_field, store_state_field);
725
726static ssize_t
Tony Jonesee959b02008-02-22 00:13:36 +0100727show_queue_type_field(struct device *dev, struct device_attribute *attr,
728 char *buf)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700729{
730 struct scsi_device *sdev = to_scsi_device(dev);
731 const char *name = "none";
732
Christoph Hellwig609aa222014-10-30 11:54:58 +0100733 if (sdev->simple_tags)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700734 name = "simple";
735
736 return snprintf(buf, 20, "%s\n", name);
737}
738
Hannes Reinecke276b20d2014-03-15 09:51:47 +0100739static ssize_t
740store_queue_type_field(struct device *dev, struct device_attribute *attr,
741 const char *buf, size_t count)
742{
743 struct scsi_device *sdev = to_scsi_device(dev);
Hannes Reinecke276b20d2014-03-15 09:51:47 +0100744
Christoph Hellwigefc3c1d2014-11-24 15:36:18 +0100745 if (!sdev->tagged_supported)
Hannes Reinecke276b20d2014-03-15 09:51:47 +0100746 return -EINVAL;
Christoph Hellwigefc3c1d2014-11-24 15:36:18 +0100747
748 sdev_printk(KERN_INFO, sdev,
749 "ignoring write to deprecated queue_type attribute");
Hannes Reinecke276b20d2014-03-15 09:51:47 +0100750 return count;
751}
752
753static DEVICE_ATTR(queue_type, S_IRUGO | S_IWUSR, show_queue_type_field,
754 store_queue_type_field);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700755
Hannes Reineckeb3ae8782014-03-15 09:51:49 +0100756#define sdev_vpd_pg_attr(_page) \
757static ssize_t \
758show_vpd_##_page(struct file *filp, struct kobject *kobj, \
759 struct bin_attribute *bin_attr, \
760 char *buf, loff_t off, size_t count) \
761{ \
762 struct device *dev = container_of(kobj, struct device, kobj); \
763 struct scsi_device *sdev = to_scsi_device(dev); \
Hannes Reinecke09e2b0b2015-11-09 13:24:28 +0100764 int ret; \
Hannes Reineckeb3ae8782014-03-15 09:51:49 +0100765 if (!sdev->vpd_##_page) \
766 return -EINVAL; \
Hannes Reinecke09e2b0b2015-11-09 13:24:28 +0100767 rcu_read_lock(); \
768 ret = memory_read_from_buffer(buf, count, &off, \
769 rcu_dereference(sdev->vpd_##_page), \
Hannes Reineckeb3ae8782014-03-15 09:51:49 +0100770 sdev->vpd_##_page##_len); \
Hannes Reinecke09e2b0b2015-11-09 13:24:28 +0100771 rcu_read_unlock(); \
772 return ret; \
Hannes Reineckeb3ae8782014-03-15 09:51:49 +0100773} \
774static struct bin_attribute dev_attr_vpd_##_page = { \
775 .attr = {.name = __stringify(vpd_##_page), .mode = S_IRUGO }, \
776 .size = 0, \
777 .read = show_vpd_##_page, \
778};
779
780sdev_vpd_pg_attr(pg83);
781sdev_vpd_pg_attr(pg80);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700782
Johannes Thumshirn92e62462015-11-09 10:56:57 +0100783static ssize_t show_inquiry(struct file *filep, struct kobject *kobj,
784 struct bin_attribute *bin_attr,
785 char *buf, loff_t off, size_t count)
786{
787 struct device *dev = container_of(kobj, struct device, kobj);
788 struct scsi_device *sdev = to_scsi_device(dev);
789
790 if (!sdev->inquiry)
791 return -EINVAL;
792
793 return memory_read_from_buffer(buf, count, &off, sdev->inquiry,
794 sdev->inquiry_len);
795}
796
797static struct bin_attribute dev_attr_inquiry = {
798 .attr = {
799 .name = "inquiry",
800 .mode = S_IRUGO,
801 },
802 .size = 0,
803 .read = show_inquiry,
804};
805
Linus Torvalds1da177e2005-04-16 15:20:36 -0700806static ssize_t
Hannes Reineckeb3ae8782014-03-15 09:51:49 +0100807show_iostat_counterbits(struct device *dev, struct device_attribute *attr,
808 char *buf)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700809{
810 return snprintf(buf, 20, "%d\n", (int)sizeof(atomic_t) * 8);
811}
812
813static DEVICE_ATTR(iocounterbits, S_IRUGO, show_iostat_counterbits, NULL);
814
815#define show_sdev_iostat(field) \
816static ssize_t \
Tony Jonesee959b02008-02-22 00:13:36 +0100817show_iostat_##field(struct device *dev, struct device_attribute *attr, \
818 char *buf) \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700819{ \
820 struct scsi_device *sdev = to_scsi_device(dev); \
821 unsigned long long count = atomic_read(&sdev->field); \
822 return snprintf(buf, 20, "0x%llx\n", count); \
823} \
824static DEVICE_ATTR(field, S_IRUGO, show_iostat_##field, NULL)
825
826show_sdev_iostat(iorequest_cnt);
827show_sdev_iostat(iodone_cnt);
828show_sdev_iostat(ioerr_cnt);
829
Michael Tokarevd7b8bcb02006-10-27 16:02:37 +0400830static ssize_t
831sdev_show_modalias(struct device *dev, struct device_attribute *attr, char *buf)
832{
833 struct scsi_device *sdev;
834 sdev = to_scsi_device(dev);
835 return snprintf (buf, 20, SCSI_DEVICE_MODALIAS_FMT "\n", sdev->type);
836}
837static DEVICE_ATTR(modalias, S_IRUGO, sdev_show_modalias, NULL);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700838
Jeff Garzika341cd02007-10-29 17:15:22 -0400839#define DECLARE_EVT_SHOW(name, Cap_name) \
840static ssize_t \
841sdev_show_evt_##name(struct device *dev, struct device_attribute *attr, \
Tony Jonesee959b02008-02-22 00:13:36 +0100842 char *buf) \
Jeff Garzika341cd02007-10-29 17:15:22 -0400843{ \
844 struct scsi_device *sdev = to_scsi_device(dev); \
845 int val = test_bit(SDEV_EVT_##Cap_name, sdev->supported_events);\
846 return snprintf(buf, 20, "%d\n", val); \
847}
848
849#define DECLARE_EVT_STORE(name, Cap_name) \
850static ssize_t \
Tony Jonesee959b02008-02-22 00:13:36 +0100851sdev_store_evt_##name(struct device *dev, struct device_attribute *attr,\
Jeff Garzika341cd02007-10-29 17:15:22 -0400852 const char *buf, size_t count) \
853{ \
854 struct scsi_device *sdev = to_scsi_device(dev); \
855 int val = simple_strtoul(buf, NULL, 0); \
856 if (val == 0) \
857 clear_bit(SDEV_EVT_##Cap_name, sdev->supported_events); \
858 else if (val == 1) \
859 set_bit(SDEV_EVT_##Cap_name, sdev->supported_events); \
860 else \
861 return -EINVAL; \
862 return count; \
863}
864
865#define DECLARE_EVT(name, Cap_name) \
866 DECLARE_EVT_SHOW(name, Cap_name) \
867 DECLARE_EVT_STORE(name, Cap_name) \
868 static DEVICE_ATTR(evt_##name, S_IRUGO, sdev_show_evt_##name, \
869 sdev_store_evt_##name);
870#define REF_EVT(name) &dev_attr_evt_##name.attr
871
872DECLARE_EVT(media_change, MEDIA_CHANGE)
Ewan D. Milne279afdf2013-08-08 15:07:48 -0400873DECLARE_EVT(inquiry_change_reported, INQUIRY_CHANGE_REPORTED)
874DECLARE_EVT(capacity_change_reported, CAPACITY_CHANGE_REPORTED)
875DECLARE_EVT(soft_threshold_reached, SOFT_THRESHOLD_REACHED_REPORTED)
876DECLARE_EVT(mode_parameter_change_reported, MODE_PARAMETER_CHANGE_REPORTED)
877DECLARE_EVT(lun_change_reported, LUN_CHANGE_REPORTED)
Jeff Garzika341cd02007-10-29 17:15:22 -0400878
Tony Jonesee959b02008-02-22 00:13:36 +0100879static ssize_t
Hannes Reinecke276b20d2014-03-15 09:51:47 +0100880sdev_store_queue_depth(struct device *dev, struct device_attribute *attr,
881 const char *buf, size_t count)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700882{
883 int depth, retval;
884 struct scsi_device *sdev = to_scsi_device(dev);
885 struct scsi_host_template *sht = sdev->host->hostt;
886
887 if (!sht->change_queue_depth)
888 return -EINVAL;
889
890 depth = simple_strtoul(buf, NULL, 0);
891
Jens Axboe1278dd682015-07-13 08:24:39 -0600892 if (depth < 1 || depth > sdev->host->can_queue)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700893 return -EINVAL;
894
Christoph Hellwigdb5ed4d2014-11-13 15:08:42 +0100895 retval = sht->change_queue_depth(sdev, depth);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700896 if (retval < 0)
897 return retval;
898
Vasu Dev4a840672009-10-22 15:46:33 -0700899 sdev->max_queue_depth = sdev->queue_depth;
900
Linus Torvalds1da177e2005-04-16 15:20:36 -0700901 return count;
902}
Hannes Reinecke276b20d2014-03-15 09:51:47 +0100903sdev_show_function(queue_depth, "%d\n");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700904
Hannes Reinecke276b20d2014-03-15 09:51:47 +0100905static DEVICE_ATTR(queue_depth, S_IRUGO | S_IWUSR, sdev_show_queue_depth,
906 sdev_store_queue_depth);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700907
Hannes Reinecke41f95dd2015-12-01 10:16:41 +0100908#ifdef CONFIG_SCSI_DH
909static ssize_t
910sdev_show_dh_state(struct device *dev, struct device_attribute *attr,
911 char *buf)
912{
913 struct scsi_device *sdev = to_scsi_device(dev);
914
915 if (!sdev->handler)
916 return snprintf(buf, 20, "detached\n");
917
918 return snprintf(buf, 20, "%s\n", sdev->handler->name);
919}
920
921static ssize_t
922sdev_store_dh_state(struct device *dev, struct device_attribute *attr,
923 const char *buf, size_t count)
924{
925 struct scsi_device *sdev = to_scsi_device(dev);
926 int err = -EINVAL;
927
928 if (sdev->sdev_state == SDEV_CANCEL ||
929 sdev->sdev_state == SDEV_DEL)
930 return -ENODEV;
931
932 if (!sdev->handler) {
933 /*
934 * Attach to a device handler
935 */
936 err = scsi_dh_attach(sdev->request_queue, buf);
937 } else if (!strncmp(buf, "activate", 8)) {
938 /*
939 * Activate a device handler
940 */
941 if (sdev->handler->activate)
942 err = sdev->handler->activate(sdev, NULL, NULL);
943 else
944 err = 0;
945 } else if (!strncmp(buf, "detach", 6)) {
946 /*
947 * Detach from a device handler
948 */
949 sdev_printk(KERN_WARNING, sdev,
950 "can't detach handler %s.\n",
951 sdev->handler->name);
952 err = -EINVAL;
953 }
954
955 return err < 0 ? err : count;
956}
957
958static DEVICE_ATTR(dh_state, S_IRUGO | S_IWUSR, sdev_show_dh_state,
959 sdev_store_dh_state);
960#endif
961
Tony Jonesee959b02008-02-22 00:13:36 +0100962static ssize_t
Vasu Dev4a840672009-10-22 15:46:33 -0700963sdev_show_queue_ramp_up_period(struct device *dev,
964 struct device_attribute *attr,
965 char *buf)
966{
967 struct scsi_device *sdev;
968 sdev = to_scsi_device(dev);
969 return snprintf(buf, 20, "%u\n",
970 jiffies_to_msecs(sdev->queue_ramp_up_period));
971}
972
973static ssize_t
974sdev_store_queue_ramp_up_period(struct device *dev,
975 struct device_attribute *attr,
976 const char *buf, size_t count)
977{
978 struct scsi_device *sdev = to_scsi_device(dev);
Daniel Walterf7c65af2014-08-08 14:24:05 -0700979 unsigned int period;
Vasu Dev4a840672009-10-22 15:46:33 -0700980
Daniel Walterf7c65af2014-08-08 14:24:05 -0700981 if (kstrtouint(buf, 10, &period))
Vasu Dev4a840672009-10-22 15:46:33 -0700982 return -EINVAL;
983
984 sdev->queue_ramp_up_period = msecs_to_jiffies(period);
Peter Oberparleiter5cb9b402015-10-26 15:54:23 +0100985 return count;
Vasu Dev4a840672009-10-22 15:46:33 -0700986}
987
Hannes Reinecke276b20d2014-03-15 09:51:47 +0100988static DEVICE_ATTR(queue_ramp_up_period, S_IRUGO | S_IWUSR,
989 sdev_show_queue_ramp_up_period,
990 sdev_store_queue_ramp_up_period);
Vasu Dev4a840672009-10-22 15:46:33 -0700991
Hannes Reinecke276b20d2014-03-15 09:51:47 +0100992static umode_t scsi_sdev_attr_is_visible(struct kobject *kobj,
993 struct attribute *attr, int i)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700994{
Hannes Reinecke276b20d2014-03-15 09:51:47 +0100995 struct device *dev = container_of(kobj, struct device, kobj);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700996 struct scsi_device *sdev = to_scsi_device(dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700997
Linus Torvalds1da177e2005-04-16 15:20:36 -0700998
Hannes Reinecke276b20d2014-03-15 09:51:47 +0100999 if (attr == &dev_attr_queue_depth.attr &&
1000 !sdev->host->hostt->change_queue_depth)
1001 return S_IRUGO;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001002
Hannes Reinecke276b20d2014-03-15 09:51:47 +01001003 if (attr == &dev_attr_queue_ramp_up_period.attr &&
1004 !sdev->host->hostt->change_queue_depth)
1005 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001006
Hannes Reinecke276b20d2014-03-15 09:51:47 +01001007 return attr->mode;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001008}
1009
Hannes Reinecke276b20d2014-03-15 09:51:47 +01001010/* Default template for device attributes. May NOT be modified */
1011static struct attribute *scsi_sdev_attrs[] = {
1012 &dev_attr_device_blocked.attr,
1013 &dev_attr_type.attr,
1014 &dev_attr_scsi_level.attr,
1015 &dev_attr_device_busy.attr,
1016 &dev_attr_vendor.attr,
1017 &dev_attr_model.attr,
1018 &dev_attr_rev.attr,
1019 &dev_attr_rescan.attr,
1020 &dev_attr_delete.attr,
1021 &dev_attr_state.attr,
1022 &dev_attr_timeout.attr,
1023 &dev_attr_eh_timeout.attr,
1024 &dev_attr_iocounterbits.attr,
1025 &dev_attr_iorequest_cnt.attr,
1026 &dev_attr_iodone_cnt.attr,
1027 &dev_attr_ioerr_cnt.attr,
1028 &dev_attr_modalias.attr,
1029 &dev_attr_queue_depth.attr,
1030 &dev_attr_queue_type.attr,
Hannes Reinecke41f95dd2015-12-01 10:16:41 +01001031#ifdef CONFIG_SCSI_DH
1032 &dev_attr_dh_state.attr,
1033#endif
Hannes Reinecke276b20d2014-03-15 09:51:47 +01001034 &dev_attr_queue_ramp_up_period.attr,
1035 REF_EVT(media_change),
1036 REF_EVT(inquiry_change_reported),
1037 REF_EVT(capacity_change_reported),
1038 REF_EVT(soft_threshold_reached),
1039 REF_EVT(mode_parameter_change_reported),
1040 REF_EVT(lun_change_reported),
1041 NULL
1042};
1043
Hannes Reineckeb3ae8782014-03-15 09:51:49 +01001044static struct bin_attribute *scsi_sdev_bin_attrs[] = {
1045 &dev_attr_vpd_pg83,
1046 &dev_attr_vpd_pg80,
Johannes Thumshirn92e62462015-11-09 10:56:57 +01001047 &dev_attr_inquiry,
Hannes Reineckeb3ae8782014-03-15 09:51:49 +01001048 NULL
1049};
Hannes Reinecke276b20d2014-03-15 09:51:47 +01001050static struct attribute_group scsi_sdev_attr_group = {
1051 .attrs = scsi_sdev_attrs,
Hannes Reineckeb3ae8782014-03-15 09:51:49 +01001052 .bin_attrs = scsi_sdev_bin_attrs,
Hannes Reinecke276b20d2014-03-15 09:51:47 +01001053 .is_visible = scsi_sdev_attr_is_visible,
1054};
1055
1056static const struct attribute_group *scsi_sdev_attr_groups[] = {
1057 &scsi_sdev_attr_group,
1058 NULL
1059};
1060
James Bottomley643eb2d2008-03-22 22:42:27 -05001061static int scsi_target_add(struct scsi_target *starget)
1062{
1063 int error;
1064
1065 if (starget->state != STARGET_CREATED)
1066 return 0;
1067
1068 error = device_add(&starget->dev);
1069 if (error) {
1070 dev_err(&starget->dev, "target device_add failed, error %d\n", error);
James Bottomley643eb2d2008-03-22 22:42:27 -05001071 return error;
1072 }
1073 transport_add_device(&starget->dev);
1074 starget->state = STARGET_RUNNING;
1075
Alan Sternbc4f2402010-06-17 10:41:42 -04001076 pm_runtime_set_active(&starget->dev);
1077 pm_runtime_enable(&starget->dev);
1078 device_enable_async_suspend(&starget->dev);
1079
James Bottomley643eb2d2008-03-22 22:42:27 -05001080 return 0;
1081}
1082
Linus Torvalds1da177e2005-04-16 15:20:36 -07001083/**
1084 * scsi_sysfs_add_sdev - add scsi device to sysfs
1085 * @sdev: scsi_device to add
1086 *
1087 * Return value:
1088 * 0 on Success / non-zero on Failure
1089 **/
1090int scsi_sysfs_add_sdev(struct scsi_device *sdev)
1091{
1092 int error, i;
James Bottomley80ed71c2007-07-19 10:15:10 -05001093 struct request_queue *rq = sdev->request_queue;
James Bottomley643eb2d2008-03-22 22:42:27 -05001094 struct scsi_target *starget = sdev->sdev_target;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001095
Alan Sternee37e092010-02-12 12:13:55 -05001096 error = scsi_device_set_state(sdev, SDEV_RUNNING);
1097 if (error)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001098 return error;
1099
James Bottomley643eb2d2008-03-22 22:42:27 -05001100 error = scsi_target_add(starget);
1101 if (error)
1102 return error;
1103
1104 transport_configure_device(&starget->dev);
Alan Sternbc4f2402010-06-17 10:41:42 -04001105
Rafael J. Wysocki4cb077d2010-02-08 19:18:26 +01001106 device_enable_async_suspend(&sdev->sdev_gendev);
Alan Sternbc4f2402010-06-17 10:41:42 -04001107 scsi_autopm_get_target(starget);
1108 pm_runtime_set_active(&sdev->sdev_gendev);
1109 pm_runtime_forbid(&sdev->sdev_gendev);
1110 pm_runtime_enable(&sdev->sdev_gendev);
1111 scsi_autopm_put_target(starget);
1112
Alan Sternbc4f2402010-06-17 10:41:42 -04001113 scsi_autopm_get_device(sdev);
1114
Linus Torvalds1da177e2005-04-16 15:20:36 -07001115 error = device_add(&sdev->sdev_gendev);
1116 if (error) {
Alan Stern73d8c342010-11-15 16:03:04 -05001117 sdev_printk(KERN_INFO, sdev,
1118 "failed to add device: %d\n", error);
Alan Sternee37e092010-02-12 12:13:55 -05001119 return error;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001120 }
Christoph Hellwig086b91d2015-08-27 14:16:57 +02001121
1122 error = scsi_dh_add_device(sdev);
Hannes Reinecke221255a2015-12-01 10:16:42 +01001123 if (error)
1124 /*
1125 * device_handler is optional, so any error can be ignored
1126 */
Christoph Hellwig086b91d2015-08-27 14:16:57 +02001127 sdev_printk(KERN_INFO, sdev,
1128 "failed to add device handler: %d\n", error);
Christoph Hellwig086b91d2015-08-27 14:16:57 +02001129
Rafael J. Wysocki4cb077d2010-02-08 19:18:26 +01001130 device_enable_async_suspend(&sdev->sdev_dev);
Tony Jonesee959b02008-02-22 00:13:36 +01001131 error = device_add(&sdev->sdev_dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001132 if (error) {
Alan Stern73d8c342010-11-15 16:03:04 -05001133 sdev_printk(KERN_INFO, sdev,
1134 "failed to add class device: %d\n", error);
Christoph Hellwig086b91d2015-08-27 14:16:57 +02001135 scsi_dh_remove_device(sdev);
James Bottomley860dc732009-11-19 17:48:29 -05001136 device_del(&sdev->sdev_gendev);
Alan Sternee37e092010-02-12 12:13:55 -05001137 return error;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001138 }
James Bottomley860dc732009-11-19 17:48:29 -05001139 transport_add_device(&sdev->sdev_gendev);
1140 sdev->is_visible = 1;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001141
FUJITA Tomonori97f46ae2008-04-19 00:43:14 +09001142 error = bsg_register_queue(rq, &sdev->sdev_gendev, NULL, NULL);
James Bottomley80ed71c2007-07-19 10:15:10 -05001143
1144 if (error)
James Bottomley860dc732009-11-19 17:48:29 -05001145 /* we're treating error on bsg register as non-fatal,
1146 * so pretend nothing went wrong */
James Bottomley80ed71c2007-07-19 10:15:10 -05001147 sdev_printk(KERN_INFO, sdev,
1148 "Failed to register bsg queue, errno=%d\n", error);
1149
Kay Sieversbfd12942007-09-11 17:00:14 +02001150 /* add additional host specific attributes */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001151 if (sdev->host->hostt->sdev_attrs) {
1152 for (i = 0; sdev->host->hostt->sdev_attrs[i]; i++) {
Kay Sieversbfd12942007-09-11 17:00:14 +02001153 error = device_create_file(&sdev->sdev_gendev,
Linus Torvalds1da177e2005-04-16 15:20:36 -07001154 sdev->host->hostt->sdev_attrs[i]);
James Bottomley860dc732009-11-19 17:48:29 -05001155 if (error)
Alan Sternee37e092010-02-12 12:13:55 -05001156 return error;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001157 }
1158 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001159
Subhash Jadavani6fe8c1d2014-09-10 14:54:09 +03001160 scsi_autopm_put_device(sdev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001161 return error;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001162}
1163
Alan Stern903f4fed2005-07-26 10:20:53 -04001164void __scsi_remove_device(struct scsi_device *sdev)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001165{
James Bottomleydf133c22005-11-06 11:47:08 -06001166 struct device *dev = &sdev->sdev_gendev;
1167
James Bottomley860dc732009-11-19 17:48:29 -05001168 if (sdev->is_visible) {
1169 if (scsi_device_set_state(sdev, SDEV_CANCEL) != 0)
1170 return;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001171
James Bottomley860dc732009-11-19 17:48:29 -05001172 bsg_unregister_queue(sdev->request_queue);
1173 device_unregister(&sdev->sdev_dev);
1174 transport_remove_device(dev);
Christoph Hellwig086b91d2015-08-27 14:16:57 +02001175 scsi_dh_remove_device(sdev);
Bart Van Asschebf2cf3b2015-09-18 17:23:42 -07001176 }
Bart Van Asscheb4854622012-06-29 15:36:07 +00001177
1178 /*
1179 * Stop accepting new requests and wait until all queuecommand() and
1180 * scsi_run_queue() invocations have finished before tearing down the
1181 * device.
1182 */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001183 scsi_device_set_state(sdev, SDEV_DEL);
Bart Van Asscheb4854622012-06-29 15:36:07 +00001184 blk_cleanup_queue(sdev->request_queue);
1185 cancel_work_sync(&sdev->requeue_work);
1186
Bart Van Asschebf2cf3b2015-09-18 17:23:42 -07001187 /*
1188 * Remove the device after blk_cleanup_queue() has been called such
1189 * a possible bdi_register() call with the same name occurs after
1190 * blk_cleanup_queue() has called bdi_destroy().
1191 */
1192 if (sdev->is_visible)
1193 device_del(dev);
1194 else
1195 put_device(&sdev->sdev_dev);
1196
Linus Torvalds1da177e2005-04-16 15:20:36 -07001197 if (sdev->host->hostt->slave_destroy)
1198 sdev->host->hostt->slave_destroy(sdev);
James Bottomleydf133c22005-11-06 11:47:08 -06001199 transport_destroy_device(dev);
James Bottomley86cbfb52011-04-22 10:39:59 -05001200
James Bottomleye63ed0d2014-01-21 07:00:50 -08001201 /*
1202 * Paired with the kref_get() in scsi_sysfs_initialize(). We have
1203 * remoed sysfs visibility from the device, so make the target
1204 * invisible if this was the last device underneath it.
1205 */
1206 scsi_target_reap(scsi_target(sdev));
1207
James Bottomleydf133c22005-11-06 11:47:08 -06001208 put_device(dev);
Alan Stern903f4fed2005-07-26 10:20:53 -04001209}
1210
1211/**
1212 * scsi_remove_device - unregister a device from the scsi bus
1213 * @sdev: scsi_device to unregister
1214 **/
1215void scsi_remove_device(struct scsi_device *sdev)
1216{
Alan Stern54195002005-09-15 21:52:51 -04001217 struct Scsi_Host *shost = sdev->host;
1218
Arjan van de Ven0b950672006-01-11 13:16:10 +01001219 mutex_lock(&shost->scan_mutex);
Alan Stern903f4fed2005-07-26 10:20:53 -04001220 __scsi_remove_device(sdev);
Arjan van de Ven0b950672006-01-11 13:16:10 +01001221 mutex_unlock(&shost->scan_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001222}
1223EXPORT_SYMBOL(scsi_remove_device);
1224
Adrian Bunk44818ef2007-07-09 11:59:59 -07001225static void __scsi_remove_target(struct scsi_target *starget)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001226{
1227 struct Scsi_Host *shost = dev_to_shost(starget->dev.parent);
1228 unsigned long flags;
Alan Sterna64358d2005-07-26 10:27:10 -04001229 struct scsi_device *sdev;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001230
1231 spin_lock_irqsave(shost->host_lock, flags);
Alan Sterna64358d2005-07-26 10:27:10 -04001232 restart:
1233 list_for_each_entry(sdev, &shost->__devices, siblings) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07001234 if (sdev->channel != starget->channel ||
Alan Sterna64358d2005-07-26 10:27:10 -04001235 sdev->id != starget->id ||
Christof Schmitt546ae792010-10-06 13:19:44 +02001236 scsi_device_get(sdev))
Linus Torvalds1da177e2005-04-16 15:20:36 -07001237 continue;
1238 spin_unlock_irqrestore(shost->host_lock, flags);
1239 scsi_remove_device(sdev);
Christof Schmitt546ae792010-10-06 13:19:44 +02001240 scsi_device_put(sdev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001241 spin_lock_irqsave(shost->host_lock, flags);
Alan Sterna64358d2005-07-26 10:27:10 -04001242 goto restart;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001243 }
1244 spin_unlock_irqrestore(shost->host_lock, flags);
mochel@digitalimplant.org20b1e672005-03-24 19:03:59 -08001245}
1246
Linus Torvalds1da177e2005-04-16 15:20:36 -07001247/**
1248 * scsi_remove_target - try to remove a target and all its devices
1249 * @dev: generic starget or parent of generic stargets to be removed
1250 *
1251 * Note: This is slightly racy. It is possible that if the user
1252 * requests the addition of another device then the target won't be
1253 * removed.
1254 */
1255void scsi_remove_target(struct device *dev)
1256{
Dan Williams3b661a92012-06-21 23:47:28 -07001257 struct Scsi_Host *shost = dev_to_shost(dev->parent);
Christoph Hellwig40998192015-10-19 16:35:46 +02001258 struct scsi_target *starget;
Dan Williams3b661a92012-06-21 23:47:28 -07001259 unsigned long flags;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001260
Christoph Hellwig40998192015-10-19 16:35:46 +02001261restart:
Dan Williams3b661a92012-06-21 23:47:28 -07001262 spin_lock_irqsave(shost->host_lock, flags);
1263 list_for_each_entry(starget, &shost->__targets, siblings) {
1264 if (starget->state == STARGET_DEL)
1265 continue;
1266 if (starget->dev.parent == dev || &starget->dev == dev) {
James Bottomleye63ed0d2014-01-21 07:00:50 -08001267 kref_get(&starget->reap_ref);
Dan Williamsbc3f02a2012-08-28 22:12:10 -07001268 spin_unlock_irqrestore(shost->host_lock, flags);
Dan Williamsbc3f02a2012-08-28 22:12:10 -07001269 __scsi_remove_target(starget);
Christoph Hellwig40998192015-10-19 16:35:46 +02001270 scsi_target_reap(starget);
1271 goto restart;
Dan Williams3b661a92012-06-21 23:47:28 -07001272 }
1273 }
1274 spin_unlock_irqrestore(shost->host_lock, flags);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001275}
1276EXPORT_SYMBOL(scsi_remove_target);
1277
1278int scsi_register_driver(struct device_driver *drv)
1279{
1280 drv->bus = &scsi_bus_type;
1281
1282 return driver_register(drv);
1283}
1284EXPORT_SYMBOL(scsi_register_driver);
1285
1286int scsi_register_interface(struct class_interface *intf)
1287{
1288 intf->class = &sdev_class;
1289
1290 return class_interface_register(intf);
1291}
1292EXPORT_SYMBOL(scsi_register_interface);
1293
Linus Torvalds1da177e2005-04-16 15:20:36 -07001294/**
1295 * scsi_sysfs_add_host - add scsi host to subsystem
1296 * @shost: scsi host struct to add to subsystem
Linus Torvalds1da177e2005-04-16 15:20:36 -07001297 **/
1298int scsi_sysfs_add_host(struct Scsi_Host *shost)
1299{
1300 int error, i;
1301
Hannes Reineckef7120a42008-03-18 14:32:28 +01001302 /* add host specific attributes */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001303 if (shost->hostt->shost_attrs) {
1304 for (i = 0; shost->hostt->shost_attrs[i]; i++) {
Tony Jonesee959b02008-02-22 00:13:36 +01001305 error = device_create_file(&shost->shost_dev,
Hannes Reineckef7120a42008-03-18 14:32:28 +01001306 shost->hostt->shost_attrs[i]);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001307 if (error)
1308 return error;
1309 }
1310 }
1311
1312 transport_register_device(&shost->shost_gendev);
James Bottomleyd52b3812008-01-05 09:38:30 -06001313 transport_configure_device(&shost->shost_gendev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001314 return 0;
1315}
1316
Kay Sieversbfd12942007-09-11 17:00:14 +02001317static struct device_type scsi_dev_type = {
1318 .name = "scsi_device",
1319 .release = scsi_device_dev_release,
1320 .groups = scsi_sdev_attr_groups,
1321};
1322
Linus Torvalds1da177e2005-04-16 15:20:36 -07001323void scsi_sysfs_device_initialize(struct scsi_device *sdev)
1324{
1325 unsigned long flags;
1326 struct Scsi_Host *shost = sdev->host;
1327 struct scsi_target *starget = sdev->sdev_target;
1328
1329 device_initialize(&sdev->sdev_gendev);
1330 sdev->sdev_gendev.bus = &scsi_bus_type;
Kay Sieversbfd12942007-09-11 17:00:14 +02001331 sdev->sdev_gendev.type = &scsi_dev_type;
Hannes Reinecke9cb78c12014-06-25 15:27:36 +02001332 dev_set_name(&sdev->sdev_gendev, "%d:%d:%d:%llu",
Kay Sievers71610f52008-12-03 22:41:36 +01001333 sdev->host->host_no, sdev->channel, sdev->id, sdev->lun);
1334
Tony Jonesee959b02008-02-22 00:13:36 +01001335 device_initialize(&sdev->sdev_dev);
James Bottomley37e6ba02009-10-02 13:30:08 -05001336 sdev->sdev_dev.parent = get_device(&sdev->sdev_gendev);
Tony Jonesee959b02008-02-22 00:13:36 +01001337 sdev->sdev_dev.class = &sdev_class;
Hannes Reinecke9cb78c12014-06-25 15:27:36 +02001338 dev_set_name(&sdev->sdev_dev, "%d:%d:%d:%llu",
Kay Sievers71610f52008-12-03 22:41:36 +01001339 sdev->host->host_no, sdev->channel, sdev->id, sdev->lun);
Alan Stern50c4e962014-09-02 11:35:50 -04001340 /*
1341 * Get a default scsi_level from the target (derived from sibling
1342 * devices). This is the best we can do for guessing how to set
1343 * sdev->lun_in_cdb for the initial INQUIRY command. For LUN 0 the
1344 * setting doesn't matter, because all the bits are zero anyway.
1345 * But it does matter for higher LUNs.
1346 */
Alan Stern7c9d6f12007-01-08 11:12:32 -05001347 sdev->scsi_level = starget->scsi_level;
Alan Stern50c4e962014-09-02 11:35:50 -04001348 if (sdev->scsi_level <= SCSI_2 &&
1349 sdev->scsi_level != SCSI_UNKNOWN &&
1350 !shost->no_scsi2_lun_in_cdb)
1351 sdev->lun_in_cdb = 1;
1352
Linus Torvalds1da177e2005-04-16 15:20:36 -07001353 transport_setup_device(&sdev->sdev_gendev);
1354 spin_lock_irqsave(shost->host_lock, flags);
1355 list_add_tail(&sdev->same_target_siblings, &starget->devices);
1356 list_add_tail(&sdev->siblings, &shost->__devices);
1357 spin_unlock_irqrestore(shost->host_lock, flags);
James Bottomleye63ed0d2014-01-21 07:00:50 -08001358 /*
1359 * device can now only be removed via __scsi_remove_device() so hold
1360 * the target. Target will be held in CREATED state until something
1361 * beneath it becomes visible (in which case it moves to RUNNING)
1362 */
1363 kref_get(&starget->reap_ref);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001364}
1365
1366int scsi_is_sdev_device(const struct device *dev)
1367{
Kay Sievers13ba9bc2007-09-26 19:54:49 +02001368 return dev->type == &scsi_dev_type;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001369}
1370EXPORT_SYMBOL(scsi_is_sdev_device);
1371
1372/* A blank transport template that is used in drivers that don't
1373 * yet implement Transport Attributes */
1374struct scsi_transport_template blank_transport_template = { { { {NULL, }, }, }, };