License cleanup: add SPDX GPL-2.0 license identifier to files with no license
Many source files in the tree are missing licensing information, which
makes it harder for compliance tools to determine the correct license.
By default all files without license information are under the default
license of the kernel, which is GPL version 2.
Update the files which contain no license information with the 'GPL-2.0'
SPDX license identifier. The SPDX identifier is a legally binding
shorthand, which can be used instead of the full boiler plate text.
This patch is based on work done by Thomas Gleixner and Kate Stewart and
Philippe Ombredanne.
How this work was done:
Patches were generated and checked against linux-4.14-rc6 for a subset of
the use cases:
- file had no licensing information it it.
- file was a */uapi/* one with no licensing information in it,
- file was a */uapi/* one with existing licensing information,
Further patches will be generated in subsequent months to fix up cases
where non-standard license headers were used, and references to license
had to be inferred by heuristics based on keywords.
The analysis to determine which SPDX License Identifier to be applied to
a file was done in a spreadsheet of side by side results from of the
output of two independent scanners (ScanCode & Windriver) producing SPDX
tag:value files created by Philippe Ombredanne. Philippe prepared the
base worksheet, and did an initial spot review of a few 1000 files.
The 4.13 kernel was the starting point of the analysis with 60,537 files
assessed. Kate Stewart did a file by file comparison of the scanner
results in the spreadsheet to determine which SPDX license identifier(s)
to be applied to the file. She confirmed any determination that was not
immediately clear with lawyers working with the Linux Foundation.
Criteria used to select files for SPDX license identifier tagging was:
- Files considered eligible had to be source code files.
- Make and config files were included as candidates if they contained >5
lines of source
- File already had some variant of a license header in it (even if <5
lines).
All documentation files were explicitly excluded.
The following heuristics were used to determine which SPDX license
identifiers to apply.
- when both scanners couldn't find any license traces, file was
considered to have no license information in it, and the top level
COPYING file license applied.
For non */uapi/* files that summary was:
SPDX license identifier # files
---------------------------------------------------|-------
GPL-2.0 11139
and resulted in the first patch in this series.
If that file was a */uapi/* path one, it was "GPL-2.0 WITH
Linux-syscall-note" otherwise it was "GPL-2.0". Results of that was:
SPDX license identifier # files
---------------------------------------------------|-------
GPL-2.0 WITH Linux-syscall-note 930
and resulted in the second patch in this series.
- if a file had some form of licensing information in it, and was one
of the */uapi/* ones, it was denoted with the Linux-syscall-note if
any GPL family license was found in the file or had no licensing in
it (per prior point). Results summary:
SPDX license identifier # files
---------------------------------------------------|------
GPL-2.0 WITH Linux-syscall-note 270
GPL-2.0+ WITH Linux-syscall-note 169
((GPL-2.0 WITH Linux-syscall-note) OR BSD-2-Clause) 21
((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause) 17
LGPL-2.1+ WITH Linux-syscall-note 15
GPL-1.0+ WITH Linux-syscall-note 14
((GPL-2.0+ WITH Linux-syscall-note) OR BSD-3-Clause) 5
LGPL-2.0+ WITH Linux-syscall-note 4
LGPL-2.1 WITH Linux-syscall-note 3
((GPL-2.0 WITH Linux-syscall-note) OR MIT) 3
((GPL-2.0 WITH Linux-syscall-note) AND MIT) 1
and that resulted in the third patch in this series.
- when the two scanners agreed on the detected license(s), that became
the concluded license(s).
- when there was disagreement between the two scanners (one detected a
license but the other didn't, or they both detected different
licenses) a manual inspection of the file occurred.
- In most cases a manual inspection of the information in the file
resulted in a clear resolution of the license that should apply (and
which scanner probably needed to revisit its heuristics).
- When it was not immediately clear, the license identifier was
confirmed with lawyers working with the Linux Foundation.
- If there was any question as to the appropriate license identifier,
the file was flagged for further research and to be revisited later
in time.
In total, over 70 hours of logged manual review was done on the
spreadsheet to determine the SPDX license identifiers to apply to the
source files by Kate, Philippe, Thomas and, in some cases, confirmation
by lawyers working with the Linux Foundation.
Kate also obtained a third independent scan of the 4.13 code base from
FOSSology, and compared selected files where the other two scanners
disagreed against that SPDX file, to see if there was new insights. The
Windriver scanner is based on an older version of FOSSology in part, so
they are related.
Thomas did random spot checks in about 500 files from the spreadsheets
for the uapi headers and agreed with SPDX license identifier in the
files he inspected. For the non-uapi files Thomas did random spot checks
in about 15000 files.
In initial set of patches against 4.14-rc6, 3 files were found to have
copy/paste license identifier errors, and have been fixed to reflect the
correct identifier.
Additionally Philippe spent 10 hours this week doing a detailed manual
inspection and review of the 12,461 patched files from the initial patch
version early this week with:
- a full scancode scan run, collecting the matched texts, detected
license ids and scores
- reviewing anything where there was a license detected (about 500+
files) to ensure that the applied SPDX license was correct
- reviewing anything where there was no detection but the patch license
was not GPL-2.0 WITH Linux-syscall-note to ensure that the applied
SPDX license was correct
This produced a worksheet with 20 files needing minor correction. This
worksheet was then exported into 3 different .csv files for the
different types of files to be modified.
These .csv files were then reviewed by Greg. Thomas wrote a script to
parse the csv files and add the proper SPDX tag to the file, in the
format that the file expected. This script was further refined by Greg
based on the output to detect more types of files automatically and to
distinguish between header and source .c files (which need different
comment types.) Finally Greg ran the script using the .csv files to
generate the patches.
Reviewed-by: Kate Stewart <kstewart@linuxfoundation.org>
Reviewed-by: Philippe Ombredanne <pombredanne@nexb.com>
Reviewed-by: Thomas Gleixner <tglx@linutronix.de>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
2017-11-01 22:07:57 +08:00
|
|
|
/* SPDX-License-Identifier: GPL-2.0 */
|
2005-04-17 06:20:36 +08:00
|
|
|
#ifndef _SCSI_SCSI_DEVICE_H
|
|
|
|
|
#define _SCSI_SCSI_DEVICE_H
|
|
|
|
|
|
|
|
|
|
#include <linux/list.h>
|
|
|
|
|
#include <linux/spinlock.h>
|
2006-02-24 04:27:18 +08:00
|
|
|
#include <linux/workqueue.h>
|
2007-02-28 11:40:27 +08:00
|
|
|
#include <linux/blkdev.h>
|
2008-08-07 01:21:18 +08:00
|
|
|
#include <scsi/scsi.h>
|
2011-07-27 07:09:06 +08:00
|
|
|
#include <linux/atomic.h>
|
2021-01-22 10:33:17 +08:00
|
|
|
#include <linux/sbitmap.h>
|
2005-04-17 06:20:36 +08:00
|
|
|
|
2012-01-31 00:46:54 +08:00
|
|
|
struct device;
|
2005-04-17 06:20:36 +08:00
|
|
|
struct request_queue;
|
|
|
|
|
struct scsi_cmnd;
|
2005-07-15 00:54:17 +08:00
|
|
|
struct scsi_lun;
|
2005-08-29 00:33:52 +08:00
|
|
|
struct scsi_sense_hdr;
|
2005-04-17 06:20:36 +08:00
|
|
|
|
2018-04-18 07:35:08 +08:00
|
|
|
typedef __u64 __bitwise blist_flags_t;
|
2017-11-15 19:07:30 +08:00
|
|
|
|
2018-08-01 03:51:54 +08:00
|
|
|
#define SCSI_SENSE_BUFFERSIZE 96
|
|
|
|
|
|
2005-08-29 00:27:01 +08:00
|
|
|
struct scsi_mode_data {
|
|
|
|
|
__u32 length;
|
|
|
|
|
__u16 block_descriptor_length;
|
|
|
|
|
__u8 medium_type;
|
|
|
|
|
__u8 device_specific;
|
|
|
|
|
__u8 header_length;
|
|
|
|
|
__u8 longlba:1;
|
|
|
|
|
};
|
|
|
|
|
|
2005-04-17 06:20:36 +08:00
|
|
|
/*
|
|
|
|
|
* sdev state: If you alter this, you also need to alter scsi_sysfs.c
|
|
|
|
|
* (for the ascii descriptions) and the state model enforcer:
|
|
|
|
|
* scsi_lib:scsi_device_set_state().
|
|
|
|
|
*/
|
|
|
|
|
enum scsi_device_state {
|
|
|
|
|
SDEV_CREATED = 1, /* device created but not added to sysfs
|
|
|
|
|
* Only internal commands allowed (for inq) */
|
|
|
|
|
SDEV_RUNNING, /* device properly configured
|
|
|
|
|
* All commands allowed */
|
|
|
|
|
SDEV_CANCEL, /* beginning to delete device
|
|
|
|
|
* Only error handler commands allowed */
|
|
|
|
|
SDEV_DEL, /* device deleted
|
|
|
|
|
* no commands allowed */
|
|
|
|
|
SDEV_QUIESCE, /* Device quiescent. No block commands
|
|
|
|
|
* will be accepted, only specials (which
|
|
|
|
|
* originate in the mid-layer) */
|
|
|
|
|
SDEV_OFFLINE, /* Device offlined (by error handling or
|
|
|
|
|
* user request */
|
2012-05-18 12:56:56 +08:00
|
|
|
SDEV_TRANSPORT_OFFLINE, /* Offlined by transport class error handler */
|
2008-08-23 05:53:31 +08:00
|
|
|
SDEV_BLOCK, /* Device blocked by scsi lld. No
|
|
|
|
|
* scsi commands from user or midlayer
|
|
|
|
|
* should be issued to the scsi
|
|
|
|
|
* lld. */
|
|
|
|
|
SDEV_CREATED_BLOCK, /* same as above but for created devices */
|
2005-04-17 06:20:36 +08:00
|
|
|
};
|
|
|
|
|
|
2016-03-17 15:39:45 +08:00
|
|
|
enum scsi_scan_mode {
|
|
|
|
|
SCSI_SCAN_INITIAL = 0,
|
|
|
|
|
SCSI_SCAN_RESCAN,
|
|
|
|
|
SCSI_SCAN_MANUAL,
|
|
|
|
|
};
|
|
|
|
|
|
2007-10-30 05:15:22 +08:00
|
|
|
enum scsi_device_event {
|
|
|
|
|
SDEV_EVT_MEDIA_CHANGE = 1, /* media has changed */
|
2013-08-09 03:07:48 +08:00
|
|
|
SDEV_EVT_INQUIRY_CHANGE_REPORTED, /* 3F 03 UA reported */
|
|
|
|
|
SDEV_EVT_CAPACITY_CHANGE_REPORTED, /* 2A 09 UA reported */
|
|
|
|
|
SDEV_EVT_SOFT_THRESHOLD_REACHED_REPORTED, /* 38 07 UA reported */
|
|
|
|
|
SDEV_EVT_MODE_PARAMETER_CHANGE_REPORTED, /* 2A 01 UA reported */
|
|
|
|
|
SDEV_EVT_LUN_CHANGE_REPORTED, /* 3F 0E UA reported */
|
2015-07-06 19:41:53 +08:00
|
|
|
SDEV_EVT_ALUA_STATE_CHANGE_REPORTED, /* 2A 06 UA reported */
|
2017-10-17 15:11:24 +08:00
|
|
|
SDEV_EVT_POWER_ON_RESET_OCCURRED, /* 29 00 UA reported */
|
2013-08-09 03:07:48 +08:00
|
|
|
|
|
|
|
|
SDEV_EVT_FIRST = SDEV_EVT_MEDIA_CHANGE,
|
2017-10-17 15:11:24 +08:00
|
|
|
SDEV_EVT_LAST = SDEV_EVT_POWER_ON_RESET_OCCURRED,
|
2007-10-30 05:15:22 +08:00
|
|
|
|
|
|
|
|
SDEV_EVT_MAXBITS = SDEV_EVT_LAST + 1
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
struct scsi_event {
|
|
|
|
|
enum scsi_device_event evt_type;
|
|
|
|
|
struct list_head node;
|
|
|
|
|
|
|
|
|
|
/* put union of data structures, for non-simple event types,
|
|
|
|
|
* here
|
|
|
|
|
*/
|
|
|
|
|
};
|
|
|
|
|
|
2017-08-29 23:50:13 +08:00
|
|
|
/**
|
|
|
|
|
* struct scsi_vpd - SCSI Vital Product Data
|
|
|
|
|
* @rcu: For kfree_rcu().
|
|
|
|
|
* @len: Length in bytes of @data.
|
|
|
|
|
* @data: VPD data as defined in various T10 SCSI standard documents.
|
|
|
|
|
*/
|
|
|
|
|
struct scsi_vpd {
|
|
|
|
|
struct rcu_head rcu;
|
|
|
|
|
int len;
|
|
|
|
|
unsigned char data[];
|
|
|
|
|
};
|
|
|
|
|
|
2005-04-17 06:20:36 +08:00
|
|
|
struct scsi_device {
|
|
|
|
|
struct Scsi_Host *host;
|
|
|
|
|
struct request_queue *request_queue;
|
|
|
|
|
|
|
|
|
|
/* the next two are protected by the host->host_lock */
|
|
|
|
|
struct list_head siblings; /* list of all devices on this host */
|
|
|
|
|
struct list_head same_target_siblings; /* just the devices sharing same target id */
|
|
|
|
|
|
2021-01-22 10:33:17 +08:00
|
|
|
struct sbitmap budget_map;
|
2014-01-23 19:07:41 +08:00
|
|
|
atomic_t device_blocked; /* Device returned QUEUE_FULL. */
|
|
|
|
|
|
2020-09-10 15:50:56 +08:00
|
|
|
atomic_t restarts;
|
2005-04-17 06:20:36 +08:00
|
|
|
spinlock_t list_lock;
|
|
|
|
|
struct list_head starved_entry;
|
|
|
|
|
unsigned short queue_depth; /* How deep of a queue we want */
|
2009-10-23 06:46:33 +08:00
|
|
|
unsigned short max_queue_depth; /* max queue depth */
|
2005-04-17 06:20:36 +08:00
|
|
|
unsigned short last_queue_full_depth; /* These two are used by */
|
|
|
|
|
unsigned short last_queue_full_count; /* scsi_track_queue_full() */
|
2009-10-23 06:46:33 +08:00
|
|
|
unsigned long last_queue_full_time; /* last queue full time */
|
|
|
|
|
unsigned long queue_ramp_up_period; /* ramp up period in jiffies */
|
|
|
|
|
#define SCSI_DEFAULT_RAMP_UP_PERIOD (120 * HZ)
|
|
|
|
|
|
|
|
|
|
unsigned long last_queue_ramp_up; /* last queue ramp up time */
|
2005-04-17 06:20:36 +08:00
|
|
|
|
2014-06-25 21:27:36 +08:00
|
|
|
unsigned int id, channel;
|
|
|
|
|
u64 lun;
|
2005-04-17 06:20:36 +08:00
|
|
|
unsigned int manufacturer; /* Manufacturer of device, for using
|
|
|
|
|
* vendor-specific cmd's */
|
|
|
|
|
unsigned sector_size; /* size in bytes */
|
|
|
|
|
|
|
|
|
|
void *hostdata; /* available to low-level driver */
|
2017-08-26 04:46:28 +08:00
|
|
|
unsigned char type;
|
2005-04-17 06:20:36 +08:00
|
|
|
char scsi_level;
|
|
|
|
|
char inq_periph_qual; /* PQ from INQUIRY data */
|
2015-11-09 20:24:28 +08:00
|
|
|
struct mutex inquiry_mutex;
|
2005-04-17 06:20:36 +08:00
|
|
|
unsigned char inquiry_len; /* valid bytes in 'inquiry' */
|
|
|
|
|
unsigned char * inquiry; /* INQUIRY response data */
|
2005-12-02 02:50:13 +08:00
|
|
|
const char * vendor; /* [back_compat] point into 'inquiry' ... */
|
|
|
|
|
const char * model; /* ... after scan; point to static string */
|
|
|
|
|
const char * rev; /* ... "nullnullnullnull" before scan */
|
2014-03-15 16:51:49 +08:00
|
|
|
|
|
|
|
|
#define SCSI_VPD_PG_LEN 255
|
2019-09-27 00:22:17 +08:00
|
|
|
struct scsi_vpd __rcu *vpd_pg0;
|
2017-08-29 23:50:13 +08:00
|
|
|
struct scsi_vpd __rcu *vpd_pg83;
|
|
|
|
|
struct scsi_vpd __rcu *vpd_pg80;
|
2019-09-27 00:22:17 +08:00
|
|
|
struct scsi_vpd __rcu *vpd_pg89;
|
2005-04-17 06:20:36 +08:00
|
|
|
unsigned char current_tag; /* current tag */
|
2021-04-16 06:08:08 +08:00
|
|
|
struct scsi_target *sdev_target;
|
2005-04-17 06:20:36 +08:00
|
|
|
|
2017-11-15 19:07:30 +08:00
|
|
|
blist_flags_t sdev_bflags; /* black/white flags as also found in
|
2005-04-17 06:20:36 +08:00
|
|
|
* scsi_devinfo.[hc]. For now used only to
|
|
|
|
|
* pass settings from slave_alloc to scsi
|
|
|
|
|
* core. */
|
2013-05-10 22:36:04 +08:00
|
|
|
unsigned int eh_timeout; /* Error handling timeout */
|
2005-04-17 06:20:36 +08:00
|
|
|
unsigned removable:1;
|
|
|
|
|
unsigned changed:1; /* Data invalid due to media change */
|
|
|
|
|
unsigned busy:1; /* Used to prevent races */
|
|
|
|
|
unsigned lockable:1; /* Able to prevent media removal */
|
|
|
|
|
unsigned locked:1; /* Media removal disabled */
|
|
|
|
|
unsigned borken:1; /* Tell the Seagate driver to be
|
|
|
|
|
* painfully slow on this device */
|
|
|
|
|
unsigned disconnect:1; /* can disconnect */
|
|
|
|
|
unsigned soft_reset:1; /* Uses soft reset option */
|
|
|
|
|
unsigned sdtr:1; /* Device supports SDTR messages */
|
|
|
|
|
unsigned wdtr:1; /* Device supports WDTR messages */
|
|
|
|
|
unsigned ppr:1; /* Device supports PPR messages */
|
|
|
|
|
unsigned tagged_supported:1; /* Supports SCSI-II tagged queuing */
|
|
|
|
|
unsigned simple_tags:1; /* simple queue tag messages are enabled */
|
|
|
|
|
unsigned was_reset:1; /* There was a bus reset on the bus for
|
|
|
|
|
* this device */
|
|
|
|
|
unsigned expecting_cc_ua:1; /* Expecting a CHECK_CONDITION/UNIT_ATTN
|
|
|
|
|
* because we did a bus reset. */
|
|
|
|
|
unsigned use_10_for_rw:1; /* first try 10-byte read / write */
|
|
|
|
|
unsigned use_10_for_ms:1; /* first try 10-byte mode sense/select */
|
2019-12-05 10:14:25 +08:00
|
|
|
unsigned set_dbd_for_ms:1; /* Set "DBD" field in mode sense */
|
2012-09-19 00:19:30 +08:00
|
|
|
unsigned no_report_opcodes:1; /* no REPORT SUPPORTED OPERATION CODES */
|
2012-09-19 00:19:32 +08:00
|
|
|
unsigned no_write_same:1; /* no WRITE SAME command */
|
2012-11-15 06:03:22 +08:00
|
|
|
unsigned use_16_for_rw:1; /* Use read/write(16) over read/write(10) */
|
2005-04-17 06:20:36 +08:00
|
|
|
unsigned skip_ms_page_8:1; /* do not use MODE SENSE page 0x08 */
|
|
|
|
|
unsigned skip_ms_page_3f:1; /* do not use MODE SENSE page 0x3f */
|
2012-01-11 02:43:30 +08:00
|
|
|
unsigned skip_vpd_pages:1; /* do not read VPD pages */
|
2014-07-16 00:49:17 +08:00
|
|
|
unsigned try_vpd_pages:1; /* attempt to read VPD pages */
|
2005-04-17 06:20:36 +08:00
|
|
|
unsigned use_192_bytes_for_3f:1; /* ask for 192 bytes from page 0x3f */
|
|
|
|
|
unsigned no_start_on_add:1; /* do not issue start on add */
|
|
|
|
|
unsigned allow_restart:1; /* issue START_UNIT in error handler */
|
2007-03-20 23:13:59 +08:00
|
|
|
unsigned manage_start_stop:1; /* Let HLD (sd) manage start/stop */
|
2008-05-11 06:34:07 +08:00
|
|
|
unsigned start_stop_pwr_cond:1; /* Set power cond. in START_STOP_UNIT */
|
2005-04-17 06:20:36 +08:00
|
|
|
unsigned no_uld_attach:1; /* disable connecting to upper level drivers */
|
|
|
|
|
unsigned select_no_atn:1;
|
|
|
|
|
unsigned fix_capacity:1; /* READ_CAPACITY is too high by 1 */
|
2007-02-08 16:04:48 +08:00
|
|
|
unsigned guess_capacity:1; /* READ_CAPACITY might be too high by 1 */
|
2005-04-17 06:20:36 +08:00
|
|
|
unsigned retry_hwerror:1; /* Retry HARDWARE_ERROR */
|
2008-08-06 12:42:21 +08:00
|
|
|
unsigned last_sector_bug:1; /* do not use multisector accesses on
|
|
|
|
|
SD_LAST_BUGGY_SECTORS */
|
2010-10-02 05:20:08 +08:00
|
|
|
unsigned no_read_disc_info:1; /* Avoid READ_DISC_INFO cmds */
|
2010-10-02 05:20:10 +08:00
|
|
|
unsigned no_read_capacity_16:1; /* Avoid READ_CAPACITY_16 cmds */
|
2012-06-21 04:04:19 +08:00
|
|
|
unsigned try_rc_10_first:1; /* Try READ_CAPACACITY_10 first */
|
2017-06-19 20:26:46 +08:00
|
|
|
unsigned security_supported:1; /* Supports Security Protocols */
|
2009-11-20 06:48:29 +08:00
|
|
|
unsigned is_visible:1; /* is the device visible in sysfs */
|
2012-07-08 11:05:08 +08:00
|
|
|
unsigned wce_default_on:1; /* Cache is ON by default */
|
2012-08-29 02:29:35 +08:00
|
|
|
unsigned no_dif:1; /* T10 PI (DIF) should be disabled */
|
2014-06-30 23:04:21 +08:00
|
|
|
unsigned broken_fua:1; /* Don't set FUA bit */
|
2014-09-02 23:35:50 +08:00
|
|
|
unsigned lun_in_cdb:1; /* Store LUN bits in CDB[1] */
|
2017-09-28 09:35:12 +08:00
|
|
|
unsigned unmap_limit_for_ws:1; /* Use the UNMAP limit for WRITE SAME */
|
2019-09-16 23:56:49 +08:00
|
|
|
unsigned rpm_autosuspend:1; /* Enable runtime autosuspend at device
|
|
|
|
|
* creation time */
|
2020-03-11 22:39:30 +08:00
|
|
|
|
|
|
|
|
bool offline_already; /* Device offline message logged */
|
|
|
|
|
|
2013-01-23 15:09:32 +08:00
|
|
|
atomic_t disk_events_disable_depth; /* disable depth for disk events */
|
|
|
|
|
|
2007-10-30 05:15:22 +08:00
|
|
|
DECLARE_BITMAP(supported_events, SDEV_EVT_MAXBITS); /* supported events */
|
2013-08-09 03:07:48 +08:00
|
|
|
DECLARE_BITMAP(pending_events, SDEV_EVT_MAXBITS); /* pending events */
|
2007-10-30 05:15:22 +08:00
|
|
|
struct list_head event_list; /* asserted events */
|
|
|
|
|
struct work_struct event_work;
|
|
|
|
|
|
2005-04-17 06:20:36 +08:00
|
|
|
unsigned int max_device_blocked; /* what device_blocked counts down from */
|
|
|
|
|
#define SCSI_DEFAULT_DEVICE_BLOCKED 3
|
|
|
|
|
|
|
|
|
|
atomic_t iorequest_cnt;
|
|
|
|
|
atomic_t iodone_cnt;
|
|
|
|
|
atomic_t ioerr_cnt;
|
|
|
|
|
|
2008-02-22 07:13:36 +08:00
|
|
|
struct device sdev_gendev,
|
|
|
|
|
sdev_dev;
|
2005-04-17 06:20:36 +08:00
|
|
|
|
2006-02-24 04:27:18 +08:00
|
|
|
struct execute_work ew; /* used to get process context on put */
|
2011-05-17 17:04:44 +08:00
|
|
|
struct work_struct requeue_work;
|
2006-02-24 04:27:18 +08:00
|
|
|
|
2015-08-27 20:16:59 +08:00
|
|
|
struct scsi_device_handler *handler;
|
|
|
|
|
void *handler_data;
|
|
|
|
|
|
2020-04-14 15:42:24 +08:00
|
|
|
size_t dma_drain_len;
|
|
|
|
|
void *dma_drain_buf;
|
|
|
|
|
|
2016-03-03 14:54:07 +08:00
|
|
|
unsigned char access_state;
|
2017-06-03 05:21:55 +08:00
|
|
|
struct mutex state_mutex;
|
2005-04-17 06:20:36 +08:00
|
|
|
enum scsi_device_state sdev_state;
|
2017-11-10 02:49:58 +08:00
|
|
|
struct task_struct *quiesced_by;
|
2020-02-25 00:14:06 +08:00
|
|
|
unsigned long sdev_data[];
|
2005-04-17 06:20:36 +08:00
|
|
|
} __attribute__((aligned(sizeof(unsigned long))));
|
2008-05-02 05:49:46 +08:00
|
|
|
|
2005-04-17 06:20:36 +08:00
|
|
|
#define to_scsi_device(d) \
|
|
|
|
|
container_of(d, struct scsi_device, sdev_gendev)
|
|
|
|
|
#define class_to_sdev(d) \
|
2008-02-22 07:13:36 +08:00
|
|
|
container_of(d, struct scsi_device, sdev_dev)
|
2005-04-17 06:20:36 +08:00
|
|
|
#define transport_class_to_sdev(class_dev) \
|
2008-02-22 07:13:36 +08:00
|
|
|
to_scsi_device(class_dev->parent)
|
2005-04-17 06:20:36 +08:00
|
|
|
|
2014-02-07 04:23:07 +08:00
|
|
|
#define sdev_dbg(sdev, fmt, a...) \
|
|
|
|
|
dev_dbg(&(sdev)->sdev_gendev, fmt, ##a)
|
|
|
|
|
|
2014-10-24 20:26:44 +08:00
|
|
|
/*
|
|
|
|
|
* like scmd_printk, but the device name is passed in
|
|
|
|
|
* as a string pointer
|
|
|
|
|
*/
|
2015-02-04 15:11:34 +08:00
|
|
|
__printf(4, 5) void
|
2015-01-18 23:11:29 +08:00
|
|
|
sdev_prefix_printk(const char *, const struct scsi_device *, const char *,
|
|
|
|
|
const char *, ...);
|
2015-01-08 14:43:42 +08:00
|
|
|
|
|
|
|
|
#define sdev_printk(l, sdev, fmt, a...) \
|
|
|
|
|
sdev_prefix_printk(l, sdev, NULL, fmt, ##a)
|
|
|
|
|
|
2015-02-04 15:11:34 +08:00
|
|
|
__printf(3, 4) void
|
2015-01-18 23:11:29 +08:00
|
|
|
scmd_printk(const char *, const struct scsi_cmnd *, const char *, ...);
|
2005-10-25 06:03:34 +08:00
|
|
|
|
2014-02-07 04:23:07 +08:00
|
|
|
#define scmd_dbg(scmd, fmt, a...) \
|
|
|
|
|
do { \
|
|
|
|
|
if ((scmd)->request->rq_disk) \
|
|
|
|
|
sdev_dbg((scmd)->device, "[%s] " fmt, \
|
|
|
|
|
(scmd)->request->rq_disk->disk_name, ##a);\
|
|
|
|
|
else \
|
|
|
|
|
sdev_dbg((scmd)->device, fmt, ##a); \
|
|
|
|
|
} while (0)
|
|
|
|
|
|
2006-02-24 04:27:18 +08:00
|
|
|
enum scsi_target_state {
|
2008-03-23 11:42:27 +08:00
|
|
|
STARGET_CREATED = 1,
|
|
|
|
|
STARGET_RUNNING,
|
2016-04-05 17:50:44 +08:00
|
|
|
STARGET_REMOVE,
|
2017-06-28 02:55:58 +08:00
|
|
|
STARGET_CREATED_REMOVE,
|
2006-02-24 04:27:18 +08:00
|
|
|
STARGET_DEL,
|
|
|
|
|
};
|
|
|
|
|
|
2005-04-17 06:20:36 +08:00
|
|
|
/*
|
|
|
|
|
* scsi_target: representation of a scsi target, for now, this is only
|
|
|
|
|
* used for single_lun devices. If no one has active IO to the target,
|
|
|
|
|
* starget_sdev_user is NULL, else it points to the active sdev.
|
|
|
|
|
*/
|
|
|
|
|
struct scsi_target {
|
|
|
|
|
struct scsi_device *starget_sdev_user;
|
|
|
|
|
struct list_head siblings;
|
|
|
|
|
struct list_head devices;
|
|
|
|
|
struct device dev;
|
2014-01-21 23:00:50 +08:00
|
|
|
struct kref reap_ref; /* last put renders target invisible */
|
2005-04-17 06:20:36 +08:00
|
|
|
unsigned int channel;
|
|
|
|
|
unsigned int id; /* target id ... replace
|
|
|
|
|
* scsi_device.id eventually */
|
2006-02-10 04:26:18 +08:00
|
|
|
unsigned int create:1; /* signal that it needs to be added */
|
2007-11-12 23:00:44 +08:00
|
|
|
unsigned int single_lun:1; /* Indicates we should only
|
|
|
|
|
* allow I/O to one of the luns
|
|
|
|
|
* for the device at a time. */
|
2012-01-11 02:43:04 +08:00
|
|
|
unsigned int pdt_1f_for_no_lun:1; /* PDT = 0x1f
|
|
|
|
|
* means no lun present. */
|
2012-01-11 02:43:30 +08:00
|
|
|
unsigned int no_report_luns:1; /* Don't use
|
|
|
|
|
* REPORT LUNS for scanning. */
|
2013-08-09 03:07:48 +08:00
|
|
|
unsigned int expecting_lun_change:1; /* A device has reported
|
|
|
|
|
* a 3F/0E UA, other devices on
|
|
|
|
|
* the same target will also. */
|
2014-01-22 21:49:41 +08:00
|
|
|
/* commands actually active on LLD. */
|
|
|
|
|
atomic_t target_busy;
|
2014-01-23 19:07:41 +08:00
|
|
|
atomic_t target_blocked;
|
|
|
|
|
|
[SCSI] Add helper code so transport classes/driver can control queueing (v3)
SCSI-ml manages the queueing limits for the device and host, but
does not do so at the target level. However something something similar
can come in userful when a driver is transitioning a transport object to
the the blocked state, becuase at that time we do not want to queue
io and we do not want the queuecommand to be called again.
The patch adds code similar to the exisiting SCSI_ML_*BUSY handlers.
You can now return SCSI_MLQUEUE_TARGET_BUSY when we hit
a transport level queueing issue like the hw cannot allocate some
resource at the iscsi session/connection level, or the target has temporarily
closed or shrunk the queueing window, or if we are transitioning
to the blocked state.
bnx2i, when they rework their firmware according to netdev
developers requests, will also need to be able to limit queueing at this
level. bnx2i will hook into libiscsi, but will allocate a scsi host per
netdevice/hba, so unlike pure software iscsi/iser which is allocating
a host per session, it cannot set the scsi_host->can_queue and return
SCSI_MLQUEUE_HOST_BUSY to reflect queueing limits on the transport.
The iscsi class/driver can also set a scsi_target->can_queue value which
reflects the max commands the driver/class can support. For iscsi this
reflects the number of commands we can support for each session due to
session/connection hw limits, driver limits, and to also reflect the
session/targets's queueing window.
Changes:
v1 - initial patch.
v2 - Fix scsi_run_queue handling of multiple blocked targets.
Previously we would break from the main loop if a device was added back on
the starved list. We now run over the list and check if any target is
blocked.
v3 - Rediff for scsi-misc.
Signed-off-by: Mike Christie <michaelc@cs.wisc.edu>
Signed-off-by: James Bottomley <James.Bottomley@HansenPartnership.com>
2008-08-18 04:24:38 +08:00
|
|
|
/*
|
|
|
|
|
* LLDs should set this in the slave_alloc host template callout.
|
|
|
|
|
* If set to zero then there is not limit.
|
|
|
|
|
*/
|
|
|
|
|
unsigned int can_queue;
|
|
|
|
|
unsigned int max_target_blocked;
|
|
|
|
|
#define SCSI_DEFAULT_TARGET_BLOCKED 3
|
2006-02-10 04:26:18 +08:00
|
|
|
|
2005-09-23 09:33:28 +08:00
|
|
|
char scsi_level;
|
2006-02-24 04:27:18 +08:00
|
|
|
enum scsi_target_state state;
|
2005-05-25 01:06:38 +08:00
|
|
|
void *hostdata; /* available to low-level driver */
|
2020-02-25 00:14:06 +08:00
|
|
|
unsigned long starget_data[]; /* for the transport */
|
2005-05-25 01:06:38 +08:00
|
|
|
/* starget_data must be the last element!!!! */
|
2005-04-17 06:20:36 +08:00
|
|
|
} __attribute__((aligned(sizeof(unsigned long))));
|
|
|
|
|
|
|
|
|
|
#define to_scsi_target(d) container_of(d, struct scsi_target, dev)
|
|
|
|
|
static inline struct scsi_target *scsi_target(struct scsi_device *sdev)
|
|
|
|
|
{
|
|
|
|
|
return to_scsi_target(sdev->sdev_gendev.parent);
|
|
|
|
|
}
|
|
|
|
|
#define transport_class_to_starget(class_dev) \
|
2008-02-22 07:13:36 +08:00
|
|
|
to_scsi_target(class_dev->parent)
|
2005-04-17 06:20:36 +08:00
|
|
|
|
2005-10-03 00:45:08 +08:00
|
|
|
#define starget_printk(prefix, starget, fmt, a...) \
|
|
|
|
|
dev_printk(prefix, &(starget)->dev, fmt, ##a)
|
|
|
|
|
|
2005-04-17 06:20:36 +08:00
|
|
|
extern struct scsi_device *__scsi_add_device(struct Scsi_Host *,
|
2014-06-25 21:27:36 +08:00
|
|
|
uint, uint, u64, void *hostdata);
|
2005-09-11 01:44:09 +08:00
|
|
|
extern int scsi_add_device(struct Scsi_Host *host, uint channel,
|
2014-06-25 21:27:36 +08:00
|
|
|
uint target, u64 lun);
|
2008-05-02 05:49:46 +08:00
|
|
|
extern int scsi_register_device_handler(struct scsi_device_handler *scsi_dh);
|
2005-04-17 06:20:36 +08:00
|
|
|
extern void scsi_remove_device(struct scsi_device *);
|
2008-05-02 05:49:46 +08:00
|
|
|
extern int scsi_unregister_device_handler(struct scsi_device_handler *scsi_dh);
|
2014-03-15 16:51:49 +08:00
|
|
|
void scsi_attach_vpd(struct scsi_device *sdev);
|
2005-04-17 06:20:36 +08:00
|
|
|
|
2017-02-17 16:02:45 +08:00
|
|
|
extern struct scsi_device *scsi_device_from_queue(struct request_queue *q);
|
2017-04-06 00:52:50 +08:00
|
|
|
extern int __must_check scsi_device_get(struct scsi_device *);
|
2005-04-17 06:20:36 +08:00
|
|
|
extern void scsi_device_put(struct scsi_device *);
|
|
|
|
|
extern struct scsi_device *scsi_device_lookup(struct Scsi_Host *,
|
2014-06-25 21:27:36 +08:00
|
|
|
uint, uint, u64);
|
2005-04-17 06:20:36 +08:00
|
|
|
extern struct scsi_device *__scsi_device_lookup(struct Scsi_Host *,
|
2014-06-25 21:27:36 +08:00
|
|
|
uint, uint, u64);
|
2005-04-17 06:20:36 +08:00
|
|
|
extern struct scsi_device *scsi_device_lookup_by_target(struct scsi_target *,
|
2014-06-25 21:27:36 +08:00
|
|
|
u64);
|
2005-04-17 06:20:36 +08:00
|
|
|
extern struct scsi_device *__scsi_device_lookup_by_target(struct scsi_target *,
|
2014-06-25 21:27:36 +08:00
|
|
|
u64);
|
2005-04-17 06:20:36 +08:00
|
|
|
extern void starget_for_each_device(struct scsi_target *, void *,
|
|
|
|
|
void (*fn)(struct scsi_device *, void *));
|
2007-12-11 07:49:31 +08:00
|
|
|
extern void __starget_for_each_device(struct scsi_target *, void *,
|
|
|
|
|
void (*fn)(struct scsi_device *,
|
|
|
|
|
void *));
|
2005-04-17 06:20:36 +08:00
|
|
|
|
|
|
|
|
/* only exposed to implement shost_for_each_device */
|
|
|
|
|
extern struct scsi_device *__scsi_iterate_devices(struct Scsi_Host *,
|
|
|
|
|
struct scsi_device *);
|
|
|
|
|
|
|
|
|
|
/**
|
2006-09-29 05:19:20 +08:00
|
|
|
* shost_for_each_device - iterate over all devices of a host
|
|
|
|
|
* @sdev: the &struct scsi_device to use as a cursor
|
|
|
|
|
* @shost: the &struct scsi_host to iterate over
|
2005-04-17 06:20:36 +08:00
|
|
|
*
|
2006-09-29 05:19:20 +08:00
|
|
|
* Iterator that returns each device attached to @shost. This loop
|
|
|
|
|
* takes a reference on each device and releases it at the end. If
|
|
|
|
|
* you break out of the loop, you must call scsi_device_put(sdev).
|
2005-04-17 06:20:36 +08:00
|
|
|
*/
|
|
|
|
|
#define shost_for_each_device(sdev, shost) \
|
|
|
|
|
for ((sdev) = __scsi_iterate_devices((shost), NULL); \
|
|
|
|
|
(sdev); \
|
|
|
|
|
(sdev) = __scsi_iterate_devices((shost), (sdev)))
|
|
|
|
|
|
|
|
|
|
/**
|
2006-09-29 05:19:20 +08:00
|
|
|
* __shost_for_each_device - iterate over all devices of a host (UNLOCKED)
|
|
|
|
|
* @sdev: the &struct scsi_device to use as a cursor
|
|
|
|
|
* @shost: the &struct scsi_host to iterate over
|
2005-04-17 06:20:36 +08:00
|
|
|
*
|
2006-09-29 05:19:20 +08:00
|
|
|
* Iterator that returns each device attached to @shost. It does _not_
|
|
|
|
|
* take a reference on the scsi_device, so the whole loop must be
|
|
|
|
|
* protected by shost->host_lock.
|
2005-04-17 06:20:36 +08:00
|
|
|
*
|
2006-09-29 05:19:20 +08:00
|
|
|
* Note: The only reason to use this is because you need to access the
|
|
|
|
|
* device list in interrupt context. Otherwise you really want to use
|
|
|
|
|
* shost_for_each_device instead.
|
2005-04-17 06:20:36 +08:00
|
|
|
*/
|
|
|
|
|
#define __shost_for_each_device(sdev, shost) \
|
|
|
|
|
list_for_each_entry((sdev), &((shost)->__devices), siblings)
|
|
|
|
|
|
2014-11-13 22:08:42 +08:00
|
|
|
extern int scsi_change_queue_depth(struct scsi_device *, int);
|
2005-04-17 06:20:36 +08:00
|
|
|
extern int scsi_track_queue_full(struct scsi_device *, int);
|
|
|
|
|
|
|
|
|
|
extern int scsi_set_medium_removal(struct scsi_device *, char);
|
|
|
|
|
|
|
|
|
|
extern int scsi_mode_sense(struct scsi_device *sdev, int dbd, int modepage,
|
|
|
|
|
unsigned char *buffer, int len, int timeout,
|
2005-08-29 00:27:01 +08:00
|
|
|
int retries, struct scsi_mode_data *data,
|
2005-08-29 00:33:52 +08:00
|
|
|
struct scsi_sense_hdr *);
|
2006-03-19 04:10:35 +08:00
|
|
|
extern int scsi_mode_select(struct scsi_device *sdev, int pf, int sp,
|
|
|
|
|
int modepage, unsigned char *buffer, int len,
|
|
|
|
|
int timeout, int retries,
|
|
|
|
|
struct scsi_mode_data *data,
|
|
|
|
|
struct scsi_sense_hdr *);
|
2005-04-17 06:20:36 +08:00
|
|
|
extern int scsi_test_unit_ready(struct scsi_device *sdev, int timeout,
|
2007-12-03 01:10:40 +08:00
|
|
|
int retries, struct scsi_sense_hdr *sshdr);
|
2009-11-04 02:33:07 +08:00
|
|
|
extern int scsi_get_vpd_page(struct scsi_device *, u8 page, unsigned char *buf,
|
|
|
|
|
int buf_len);
|
2012-09-19 00:19:30 +08:00
|
|
|
extern int scsi_report_opcode(struct scsi_device *sdev, unsigned char *buffer,
|
|
|
|
|
unsigned int len, unsigned char opcode);
|
2005-04-17 06:20:36 +08:00
|
|
|
extern int scsi_device_set_state(struct scsi_device *sdev,
|
|
|
|
|
enum scsi_device_state state);
|
2007-10-30 05:15:22 +08:00
|
|
|
extern struct scsi_event *sdev_evt_alloc(enum scsi_device_event evt_type,
|
|
|
|
|
gfp_t gfpflags);
|
|
|
|
|
extern void sdev_evt_send(struct scsi_device *sdev, struct scsi_event *evt);
|
|
|
|
|
extern void sdev_evt_send_simple(struct scsi_device *sdev,
|
|
|
|
|
enum scsi_device_event evt_type, gfp_t gfpflags);
|
2005-04-17 06:20:36 +08:00
|
|
|
extern int scsi_device_quiesce(struct scsi_device *sdev);
|
|
|
|
|
extern void scsi_device_resume(struct scsi_device *sdev);
|
|
|
|
|
extern void scsi_target_quiesce(struct scsi_target *);
|
|
|
|
|
extern void scsi_target_resume(struct scsi_target *);
|
|
|
|
|
extern void scsi_scan_target(struct device *parent, unsigned int channel,
|
2016-03-17 15:39:45 +08:00
|
|
|
unsigned int id, u64 lun,
|
|
|
|
|
enum scsi_scan_mode rescan);
|
2005-04-17 06:20:36 +08:00
|
|
|
extern void scsi_target_reap(struct scsi_target *);
|
|
|
|
|
extern void scsi_target_block(struct device *);
|
2012-05-18 12:56:57 +08:00
|
|
|
extern void scsi_target_unblock(struct device *, enum scsi_device_state);
|
2005-04-17 06:20:36 +08:00
|
|
|
extern void scsi_remove_target(struct device *);
|
|
|
|
|
extern const char *scsi_device_state_name(enum scsi_device_state);
|
|
|
|
|
extern int scsi_is_sdev_device(const struct device *);
|
|
|
|
|
extern int scsi_is_target_device(const struct device *);
|
2016-01-28 10:16:26 +08:00
|
|
|
extern void scsi_sanitize_inquiry_string(unsigned char *s, int len);
|
2018-08-01 03:51:54 +08:00
|
|
|
extern int __scsi_execute(struct scsi_device *sdev, const unsigned char *cmd,
|
2005-08-29 00:31:14 +08:00
|
|
|
int data_direction, void *buffer, unsigned bufflen,
|
2017-02-23 23:02:36 +08:00
|
|
|
unsigned char *sense, struct scsi_sense_hdr *sshdr,
|
|
|
|
|
int timeout, int retries, u64 flags,
|
|
|
|
|
req_flags_t rq_flags, int *resid);
|
2018-08-01 03:51:54 +08:00
|
|
|
/* Make sure any sense buffer is the correct size. */
|
|
|
|
|
#define scsi_execute(sdev, cmd, data_direction, buffer, bufflen, sense, \
|
|
|
|
|
sshdr, timeout, retries, flags, rq_flags, resid) \
|
|
|
|
|
({ \
|
|
|
|
|
BUILD_BUG_ON((sense) != NULL && \
|
|
|
|
|
sizeof(sense) != SCSI_SENSE_BUFFERSIZE); \
|
|
|
|
|
__scsi_execute(sdev, cmd, data_direction, buffer, bufflen, \
|
|
|
|
|
sense, sshdr, timeout, retries, flags, rq_flags, \
|
|
|
|
|
resid); \
|
|
|
|
|
})
|
2013-03-23 11:42:25 +08:00
|
|
|
static inline int scsi_execute_req(struct scsi_device *sdev,
|
|
|
|
|
const unsigned char *cmd, int data_direction, void *buffer,
|
|
|
|
|
unsigned bufflen, struct scsi_sense_hdr *sshdr, int timeout,
|
|
|
|
|
int retries, int *resid)
|
|
|
|
|
{
|
2017-02-23 23:02:37 +08:00
|
|
|
return scsi_execute(sdev, cmd, data_direction, buffer,
|
|
|
|
|
bufflen, NULL, sshdr, timeout, retries, 0, 0, resid);
|
2013-03-23 11:42:25 +08:00
|
|
|
}
|
2013-01-23 15:09:32 +08:00
|
|
|
extern void sdev_disable_disk_events(struct scsi_device *sdev);
|
|
|
|
|
extern void sdev_enable_disk_events(struct scsi_device *sdev);
|
2015-12-01 17:16:55 +08:00
|
|
|
extern int scsi_vpd_lun_id(struct scsi_device *, char *, size_t);
|
2015-12-01 17:16:57 +08:00
|
|
|
extern int scsi_vpd_tpg_id(struct scsi_device *, int *);
|
2005-08-29 00:31:14 +08:00
|
|
|
|
2014-12-15 06:13:55 +08:00
|
|
|
#ifdef CONFIG_PM
|
[SCSI] implement runtime Power Management
This patch (as1398b) adds runtime PM support to the SCSI layer. Only
the machanism is provided; use of it is up to the various high-level
drivers, and the patch doesn't change any of them. Except for sg --
the patch expicitly prevents a device from being runtime-suspended
while its sg device file is open.
The implementation is simplistic. In general, hosts and targets are
automatically suspended when all their children are asleep, but for
them the runtime-suspend code doesn't actually do anything. (A host's
runtime PM status is propagated up the device tree, though, so a
runtime-PM-aware lower-level driver could power down the host adapter
hardware at the appropriate times.) There are comments indicating
where a transport class might be notified or some other hooks added.
LUNs are runtime-suspended by calling the drivers' existing suspend
handlers (and likewise for runtime-resume). Somewhat arbitrarily, the
implementation delays for 100 ms before suspending an eligible LUN.
This is because there typically are occasions during bootup when the
same device file is opened and closed several times in quick
succession.
The way this all works is that the SCSI core increments a device's
PM-usage count when it is registered. If a high-level driver does
nothing then the device will not be eligible for runtime-suspend
because of the elevated usage count. If a high-level driver wants to
use runtime PM then it can call scsi_autopm_put_device() in its probe
routine to decrement the usage count and scsi_autopm_get_device() in
its remove routine to restore the original count.
Hosts, targets, and LUNs are not suspended while they are being probed
or removed, or while the error handler is running. In fact, a fairly
large part of the patch consists of code to make sure that things
aren't suspended at such times.
[jejb: fix up compile issues in PM config variations]
Signed-off-by: Alan Stern <stern@rowland.harvard.edu>
Signed-off-by: James Bottomley <James.Bottomley@suse.de>
2010-06-17 22:41:42 +08:00
|
|
|
extern int scsi_autopm_get_device(struct scsi_device *);
|
|
|
|
|
extern void scsi_autopm_put_device(struct scsi_device *);
|
|
|
|
|
#else
|
|
|
|
|
static inline int scsi_autopm_get_device(struct scsi_device *d) { return 0; }
|
|
|
|
|
static inline void scsi_autopm_put_device(struct scsi_device *d) {}
|
2014-12-15 06:13:55 +08:00
|
|
|
#endif /* CONFIG_PM */
|
[SCSI] implement runtime Power Management
This patch (as1398b) adds runtime PM support to the SCSI layer. Only
the machanism is provided; use of it is up to the various high-level
drivers, and the patch doesn't change any of them. Except for sg --
the patch expicitly prevents a device from being runtime-suspended
while its sg device file is open.
The implementation is simplistic. In general, hosts and targets are
automatically suspended when all their children are asleep, but for
them the runtime-suspend code doesn't actually do anything. (A host's
runtime PM status is propagated up the device tree, though, so a
runtime-PM-aware lower-level driver could power down the host adapter
hardware at the appropriate times.) There are comments indicating
where a transport class might be notified or some other hooks added.
LUNs are runtime-suspended by calling the drivers' existing suspend
handlers (and likewise for runtime-resume). Somewhat arbitrarily, the
implementation delays for 100 ms before suspending an eligible LUN.
This is because there typically are occasions during bootup when the
same device file is opened and closed several times in quick
succession.
The way this all works is that the SCSI core increments a device's
PM-usage count when it is registered. If a high-level driver does
nothing then the device will not be eligible for runtime-suspend
because of the elevated usage count. If a high-level driver wants to
use runtime PM then it can call scsi_autopm_put_device() in its probe
routine to decrement the usage count and scsi_autopm_get_device() in
its remove routine to restore the original count.
Hosts, targets, and LUNs are not suspended while they are being probed
or removed, or while the error handler is running. In fact, a fairly
large part of the patch consists of code to make sure that things
aren't suspended at such times.
[jejb: fix up compile issues in PM config variations]
Signed-off-by: Alan Stern <stern@rowland.harvard.edu>
Signed-off-by: James Bottomley <James.Bottomley@suse.de>
2010-06-17 22:41:42 +08:00
|
|
|
|
2006-10-01 09:23:44 +08:00
|
|
|
static inline int __must_check scsi_device_reprobe(struct scsi_device *sdev)
|
2006-03-15 04:24:55 +08:00
|
|
|
{
|
2006-10-01 09:23:44 +08:00
|
|
|
return device_reprobe(&sdev->sdev_gendev);
|
2006-03-15 04:24:55 +08:00
|
|
|
}
|
|
|
|
|
|
2005-10-25 06:03:34 +08:00
|
|
|
static inline unsigned int sdev_channel(struct scsi_device *sdev)
|
|
|
|
|
{
|
|
|
|
|
return sdev->channel;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
static inline unsigned int sdev_id(struct scsi_device *sdev)
|
|
|
|
|
{
|
|
|
|
|
return sdev->id;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
#define scmd_id(scmd) sdev_id((scmd)->device)
|
|
|
|
|
#define scmd_channel(scmd) sdev_channel((scmd)->device)
|
|
|
|
|
|
2008-08-23 05:43:59 +08:00
|
|
|
/*
|
|
|
|
|
* checks for positions of the SCSI state machine
|
|
|
|
|
*/
|
2005-04-17 06:20:36 +08:00
|
|
|
static inline int scsi_device_online(struct scsi_device *sdev)
|
|
|
|
|
{
|
2009-01-12 16:28:55 +08:00
|
|
|
return (sdev->sdev_state != SDEV_OFFLINE &&
|
2012-05-18 12:56:56 +08:00
|
|
|
sdev->sdev_state != SDEV_TRANSPORT_OFFLINE &&
|
2009-01-12 16:28:55 +08:00
|
|
|
sdev->sdev_state != SDEV_DEL);
|
2005-04-17 06:20:36 +08:00
|
|
|
}
|
2008-08-23 05:43:59 +08:00
|
|
|
static inline int scsi_device_blocked(struct scsi_device *sdev)
|
|
|
|
|
{
|
2008-08-23 05:53:31 +08:00
|
|
|
return sdev->sdev_state == SDEV_BLOCK ||
|
|
|
|
|
sdev->sdev_state == SDEV_CREATED_BLOCK;
|
2008-08-23 05:43:59 +08:00
|
|
|
}
|
|
|
|
|
static inline int scsi_device_created(struct scsi_device *sdev)
|
|
|
|
|
{
|
2008-08-23 05:53:31 +08:00
|
|
|
return sdev->sdev_state == SDEV_CREATED ||
|
|
|
|
|
sdev->sdev_state == SDEV_CREATED_BLOCK;
|
2008-08-23 05:43:59 +08:00
|
|
|
}
|
2005-04-17 06:20:36 +08:00
|
|
|
|
2017-06-03 05:21:53 +08:00
|
|
|
int scsi_internal_device_block_nowait(struct scsi_device *sdev);
|
2017-06-03 05:21:54 +08:00
|
|
|
int scsi_internal_device_unblock_nowait(struct scsi_device *sdev,
|
|
|
|
|
enum scsi_device_state new_state);
|
2017-03-02 01:00:36 +08:00
|
|
|
|
2005-04-17 06:20:36 +08:00
|
|
|
/* accessor functions for the SCSI parameters */
|
|
|
|
|
static inline int scsi_device_sync(struct scsi_device *sdev)
|
|
|
|
|
{
|
|
|
|
|
return sdev->sdtr;
|
|
|
|
|
}
|
|
|
|
|
static inline int scsi_device_wide(struct scsi_device *sdev)
|
|
|
|
|
{
|
|
|
|
|
return sdev->wdtr;
|
|
|
|
|
}
|
|
|
|
|
static inline int scsi_device_dt(struct scsi_device *sdev)
|
|
|
|
|
{
|
|
|
|
|
return sdev->ppr;
|
|
|
|
|
}
|
|
|
|
|
static inline int scsi_device_dt_only(struct scsi_device *sdev)
|
|
|
|
|
{
|
|
|
|
|
if (sdev->inquiry_len < 57)
|
|
|
|
|
return 0;
|
|
|
|
|
return (sdev->inquiry[56] & 0x0c) == 0x04;
|
|
|
|
|
}
|
|
|
|
|
static inline int scsi_device_ius(struct scsi_device *sdev)
|
|
|
|
|
{
|
|
|
|
|
if (sdev->inquiry_len < 57)
|
|
|
|
|
return 0;
|
|
|
|
|
return sdev->inquiry[56] & 0x01;
|
|
|
|
|
}
|
|
|
|
|
static inline int scsi_device_qas(struct scsi_device *sdev)
|
|
|
|
|
{
|
|
|
|
|
if (sdev->inquiry_len < 57)
|
|
|
|
|
return 0;
|
|
|
|
|
return sdev->inquiry[56] & 0x02;
|
|
|
|
|
}
|
2008-01-20 23:09:40 +08:00
|
|
|
static inline int scsi_device_enclosure(struct scsi_device *sdev)
|
|
|
|
|
{
|
2011-03-01 07:13:22 +08:00
|
|
|
return sdev->inquiry ? (sdev->inquiry[6] & (1<<6)) : 1;
|
2008-01-20 23:09:40 +08:00
|
|
|
}
|
[SCSI] modalias for scsi devices
The following patch adds support for sysfs/uevent modalias
attribute for scsi devices (like disks, tapes, cdroms etc),
based on whatever current sd.c, sr.c, st.c and osst.c drivers
supports.
The modalias format is like this:
scsi:type-0x04
(for TYPE_WORM, handled by sr.c now).
Several comments.
o This hexadecimal type value is because all TYPE_XXX constants
in include/scsi/scsi.h are given in hex, but __stringify() will
not convert them to decimal (so it will NOT be scsi:type-4).
Since it does not really matter in which format it is, while
both modalias in module and modalias attribute match each other,
I descided to go for that 0x%02x format (and added a comment in
include/scsi/scsi.h to keep them that way), instead of changing
them all to decimal.
o There was no .uevent routine for SCSI bus. It might be a good
idea to add some more ueven environment variables in there.
o osst.c driver handles tapes too, like st.c, but only SOME tapes.
With this setup, hotplug scripts (or whatever is used by the
user) will try to load both st and osst modules for all SCSI
tapes found, because both modules have scsi:type-0x01 alias).
It is not harmful, but one extra module is no good either.
It is possible to solve this, by exporting more info in
modalias attribute, including vendor and device identification
strings, so that modalias becomes something like
scsi:type-0x12:vendor-Adaptec LTD:device-OnStream Tape Drive
and having that, match for all 3 attributes, not only device
type. But oh well, vendor and device strings may be large,
and they do contain spaces and whatnot.
So I left them for now, awaiting for comments first.
Signed-off-by: Michael Tokarev <mjt@tls.msk.ru>
Signed-off-by: James Bottomley <James.Bottomley@SteelEye.com>
2006-10-27 20:02:37 +08:00
|
|
|
|
2008-07-18 05:08:48 +08:00
|
|
|
static inline int scsi_device_protection(struct scsi_device *sdev)
|
|
|
|
|
{
|
2012-08-29 02:29:35 +08:00
|
|
|
if (sdev->no_dif)
|
|
|
|
|
return 0;
|
|
|
|
|
|
2008-08-07 01:21:18 +08:00
|
|
|
return sdev->scsi_level > SCSI_2 && sdev->inquiry[5] & (1<<0);
|
2008-07-18 05:08:48 +08:00
|
|
|
}
|
|
|
|
|
|
2011-08-24 16:51:13 +08:00
|
|
|
static inline int scsi_device_tpgs(struct scsi_device *sdev)
|
|
|
|
|
{
|
|
|
|
|
return sdev->inquiry ? (sdev->inquiry[5] >> 4) & 0x3 : 0;
|
|
|
|
|
}
|
|
|
|
|
|
2016-04-01 14:57:36 +08:00
|
|
|
/**
|
|
|
|
|
* scsi_device_supports_vpd - test if a device supports VPD pages
|
|
|
|
|
* @sdev: the &struct scsi_device to test
|
|
|
|
|
*
|
|
|
|
|
* If the 'try_vpd_pages' flag is set it takes precedence.
|
|
|
|
|
* Otherwise we will assume VPD pages are supported if the
|
|
|
|
|
* SCSI level is at least SPC-3 and 'skip_vpd_pages' is not set.
|
|
|
|
|
*/
|
|
|
|
|
static inline int scsi_device_supports_vpd(struct scsi_device *sdev)
|
|
|
|
|
{
|
|
|
|
|
/* Attempt VPD inquiry if the device blacklist explicitly calls
|
|
|
|
|
* for it.
|
|
|
|
|
*/
|
|
|
|
|
if (sdev->try_vpd_pages)
|
|
|
|
|
return 1;
|
|
|
|
|
/*
|
|
|
|
|
* Although VPD inquiries can go to SCSI-2 type devices,
|
|
|
|
|
* some USB ones crash on receiving them, and the pages
|
2016-04-01 14:57:37 +08:00
|
|
|
* we currently ask for are mandatory for SPC-2 and beyond
|
2016-04-01 14:57:36 +08:00
|
|
|
*/
|
2016-04-01 14:57:37 +08:00
|
|
|
if (sdev->scsi_level >= SCSI_SPC_2 && !sdev->skip_vpd_pages)
|
2016-04-01 14:57:36 +08:00
|
|
|
return 1;
|
|
|
|
|
return 0;
|
|
|
|
|
}
|
|
|
|
|
|
2021-01-22 10:33:15 +08:00
|
|
|
static inline int scsi_device_busy(struct scsi_device *sdev)
|
|
|
|
|
{
|
2021-01-22 10:33:17 +08:00
|
|
|
return sbitmap_weight(&sdev->budget_map);
|
2021-01-22 10:33:15 +08:00
|
|
|
}
|
|
|
|
|
|
[SCSI] modalias for scsi devices
The following patch adds support for sysfs/uevent modalias
attribute for scsi devices (like disks, tapes, cdroms etc),
based on whatever current sd.c, sr.c, st.c and osst.c drivers
supports.
The modalias format is like this:
scsi:type-0x04
(for TYPE_WORM, handled by sr.c now).
Several comments.
o This hexadecimal type value is because all TYPE_XXX constants
in include/scsi/scsi.h are given in hex, but __stringify() will
not convert them to decimal (so it will NOT be scsi:type-4).
Since it does not really matter in which format it is, while
both modalias in module and modalias attribute match each other,
I descided to go for that 0x%02x format (and added a comment in
include/scsi/scsi.h to keep them that way), instead of changing
them all to decimal.
o There was no .uevent routine for SCSI bus. It might be a good
idea to add some more ueven environment variables in there.
o osst.c driver handles tapes too, like st.c, but only SOME tapes.
With this setup, hotplug scripts (or whatever is used by the
user) will try to load both st and osst modules for all SCSI
tapes found, because both modules have scsi:type-0x01 alias).
It is not harmful, but one extra module is no good either.
It is possible to solve this, by exporting more info in
modalias attribute, including vendor and device identification
strings, so that modalias becomes something like
scsi:type-0x12:vendor-Adaptec LTD:device-OnStream Tape Drive
and having that, match for all 3 attributes, not only device
type. But oh well, vendor and device strings may be large,
and they do contain spaces and whatnot.
So I left them for now, awaiting for comments first.
Signed-off-by: Michael Tokarev <mjt@tls.msk.ru>
Signed-off-by: James Bottomley <James.Bottomley@SteelEye.com>
2006-10-27 20:02:37 +08:00
|
|
|
#define MODULE_ALIAS_SCSI_DEVICE(type) \
|
|
|
|
|
MODULE_ALIAS("scsi:t-" __stringify(type) "*")
|
|
|
|
|
#define SCSI_DEVICE_MODALIAS_FMT "scsi:t-0x%02x"
|
|
|
|
|
|
2005-04-17 06:20:36 +08:00
|
|
|
#endif /* _SCSI_SCSI_DEVICE_H */
|