From: Brian Bunker <brian@purestorage.com>
To: hare@suse.de, linux-scsi@vger.kernel.org
Cc: Brian Bunker <brian@purestorage.com>,
Krishna Kant <krishna.kant@purestorage.com>
Subject: [PATCH 3/6] scsi: Add scsi_update_inquiry_data() for updating INQUIRY data
Date: Fri, 24 Apr 2026 14:53:21 -0700 [thread overview]
Message-ID: <20260424215324.99045-4-brian@purestorage.com> (raw)
In-Reply-To: <20260424215324.99045-1-brian@purestorage.com>
Add a new function scsi_update_inquiry_data() that can safely update all
INQUIRY-derived fields for an existing SCSI device:
- Vendor, model, revision strings
- Peripheral qualifier and device type
- Capability flags (removable, lockable, tagged queuing support, etc.)
- ATA device detection and allow_restart setting
The function:
- Takes the inquiry_mutex to protect against concurrent sysfs reads
- Respects BLIST_ISROM and BLIST_NOTQ blacklist flags
- Returns 1 if device type or peripheral qualifier changed, indicating
the caller should call device_reprobe() to re-match drivers
- Returns 0 on success with no changes requiring reprobe
- Returns negative errno on failure
This is the core infrastructure needed for updating INQUIRY data during
device rescan operations, which is required for proper ALUA unavailable
state handling.
Signed-off-by: Brian Bunker <brian@purestorage.com>
Signed-off-by: Krishna Kant <krishna.kant@purestorage.com>
---
drivers/scsi/scsi.c | 164 +++++++++++++++++++++++++++++++++++++
include/scsi/scsi_device.h | 13 +++
2 files changed, 177 insertions(+)
diff --git a/drivers/scsi/scsi.c b/drivers/scsi/scsi.c
index 76cdad063f7bc..82231c6970587 100644
--- a/drivers/scsi/scsi.c
+++ b/drivers/scsi/scsi.c
@@ -61,6 +61,7 @@
#include <scsi/scsi_cmnd.h>
#include <scsi/scsi_dbg.h>
#include <scsi/scsi_device.h>
+#include <scsi/scsi_devinfo.h>
#include <scsi/scsi_driver.h>
#include <scsi/scsi_eh.h>
#include <scsi/scsi_host.h>
@@ -549,6 +550,169 @@ void scsi_attach_vpd(struct scsi_device *sdev)
kfree(vpd_buf);
}
+/**
+ * scsi_update_inquiry_data - Update standard INQUIRY data for a SCSI device
+ * @sdev: The device to update
+ * @inq_result: Buffer containing new INQUIRY data
+ * @inq_len: Length of inquiry data
+ *
+ * Updates the standard INQUIRY data (vendor, model, rev, peripheral qualifier,
+ * device type, removable media flag) and capability flags derived from INQUIRY
+ * data for a SCSI device. This is used during both initial device setup and
+ * when reprobing a device to get fresh INQUIRY information. The old inquiry
+ * buffer is freed and replaced with the new data under the protection of
+ * inquiry_mutex.
+ *
+ * Blacklist flags (BLIST_ISROM, BLIST_NOTQ) are respected when updating
+ * device properties.
+ *
+ * Returns:
+ * SCSI_INQ_UNCHANGED on success
+ * SCSI_INQ_REPROBE_NEEDED if type or PQ changed (caller should reprobe)
+ * -ENOMEM on allocation failure
+ * -EINVAL if inquiry data is too short
+ */
+int scsi_update_inquiry_data(struct scsi_device *sdev,
+ unsigned char *inq_result, size_t inq_len)
+{
+ unsigned char *new_inquiry;
+ unsigned char old_type;
+ unsigned char old_periph_qual;
+ bool had_prior_inquiry;
+
+ /*
+ * Ensure we have at least the minimum standard INQUIRY data (36 bytes)
+ * to safely access device type, vendor, model, rev, and capability flags.
+ */
+ if (inq_len < SCSI_INQ_STD_LEN) {
+ sdev_printk(KERN_WARNING, sdev,
+ "INQUIRY data too short (%zu bytes), need at least %d\n",
+ inq_len, SCSI_INQ_STD_LEN);
+ return -EINVAL;
+ }
+
+ /* Allocate new inquiry buffer */
+ new_inquiry = kmemdup(inq_result, max_t(size_t, inq_len, SCSI_INQ_STD_LEN),
+ GFP_KERNEL);
+ if (!new_inquiry)
+ return -ENOMEM;
+
+ /* Update inquiry data under mutex protection */
+ mutex_lock(&sdev->inquiry_mutex);
+
+ /*
+ * Save old values to detect changes that require reprobe.
+ * Only meaningful if we had prior inquiry data; during initial
+ * setup sdev->inquiry is NULL and the old values are just
+ * zero-initialized defaults.
+ */
+ had_prior_inquiry = (sdev->inquiry != NULL);
+ old_type = sdev->type;
+ old_periph_qual = sdev->inq_periph_qual;
+
+ kfree(sdev->inquiry);
+ sdev->inquiry = new_inquiry;
+ sdev->vendor = scsi_inq_vendor(sdev->inquiry);
+ sdev->model = scsi_inq_product(sdev->inquiry);
+ sdev->rev = scsi_inq_revision(sdev->inquiry);
+ sdev->inq_periph_qual = scsi_inq_periph_qual(inq_result[0]);
+
+ /*
+ * Check if this is an ATA device (SATA emulation layer).
+ * ATA devices need allow_restart set to work around SATL power
+ * management specifications.
+ */
+ if (strncmp(sdev->vendor, "ATA ", 8) == 0) {
+ sdev->is_ata = 1;
+ sdev->allow_restart = 1;
+ } else
+ sdev->is_ata = 0;
+
+ /*
+ * Update device type from INQUIRY byte 0.
+ * BLIST_ISROM is a quirk for devices that report wrong type but should
+ * be treated as (removable) CD-ROM. Override to TYPE_ROM as exception.
+ */
+ if (sdev->sdev_bflags & BLIST_ISROM)
+ sdev->type = TYPE_ROM;
+ else
+ sdev->type = scsi_inq_device_type(inq_result[0], sdev->lun);
+
+ /*
+ * Update removable flag from INQUIRY byte 1.
+ * BLIST_ISROM devices are always removable (exception/quirk).
+ */
+ if (sdev->sdev_bflags & BLIST_ISROM)
+ sdev->removable = 1;
+ else
+ sdev->removable = scsi_inq_removable(inq_result[1]);
+
+ /*
+ * Set lockable to match removable. Devices with removable media
+ * can typically have their media locked/unlocked via the
+ * ALLOW_MEDIUM_REMOVAL command.
+ */
+ sdev->lockable = sdev->removable;
+
+ /* Update capability flags from INQUIRY byte 7 */
+ sdev->soft_reset = (scsi_inq_sftre(inq_result[7]) &&
+ (scsi_inq_resp_data_fmt(inq_result[3]) == 2)) ? 1 : 0;
+
+ /*
+ * Update protocol support flags.
+ * Only update ppr if we have enough INQUIRY data (>56 bytes) to check
+ * byte 56, or if scsi_level indicates SCSI-3+ support. If we don't have
+ * enough data, leave ppr unchanged to avoid incorrectly clearing it
+ * during rescan with short INQUIRY.
+ */
+ if (sdev->scsi_level >= SCSI_3 || inq_len > 56)
+ sdev->ppr = (sdev->scsi_level >= SCSI_3 ||
+ (inq_len > 56 && inq_result[56] & 0x04)) ? 1 : 0;
+ sdev->wdtr = scsi_inq_wbus16(inq_result[7]);
+ sdev->sdtr = scsi_inq_sync(inq_result[7]);
+
+ /*
+ * Update tagged queuing support from INQUIRY byte 7.
+ * BLIST_NOTQ is an exception to force tagged queuing off.
+ */
+ if (sdev->sdev_bflags & BLIST_NOTQ)
+ sdev->tagged_supported = 0;
+ else
+ sdev->tagged_supported = (sdev->scsi_level >= SCSI_2) &&
+ scsi_inq_cmdque(inq_result[7]);
+ sdev->simple_tags = sdev->tagged_supported;
+
+ mutex_unlock(&sdev->inquiry_mutex);
+
+ /*
+ * If device type or peripheral qualifier changed, return a special
+ * code to indicate that caller should trigger device_reprobe() to
+ * re-match with appropriate upper-layer driver.
+ *
+ * - Type changes require different drivers (sd vs sr vs st, etc.)
+ * - PQ changes affect scsi_bus_match() which only matches PQ == 0
+ *
+ * Note: We check this AFTER updating all fields and releasing the
+ * mutex, so all INQUIRY-derived data is current regardless of whether
+ * reprobe is needed.
+ */
+ if (had_prior_inquiry &&
+ (old_type != sdev->type || old_periph_qual != sdev->inq_periph_qual)) {
+ if (old_type != sdev->type)
+ sdev_printk(KERN_NOTICE, sdev,
+ "device type changed from %d to %d\n",
+ old_type, sdev->type);
+ if (old_periph_qual != sdev->inq_periph_qual)
+ sdev_printk(KERN_NOTICE, sdev,
+ "peripheral qualifier changed from %d to %d\n",
+ old_periph_qual, sdev->inq_periph_qual);
+ return SCSI_INQ_REPROBE_NEEDED;
+ }
+
+ return SCSI_INQ_UNCHANGED;
+}
+EXPORT_SYMBOL(scsi_update_inquiry_data);
+
/**
* scsi_report_opcode - Find out if a given command is supported
* @sdev: scsi device to query
diff --git a/include/scsi/scsi_device.h b/include/scsi/scsi_device.h
index 9c2a7bbe5891e..356396b85869a 100644
--- a/include/scsi/scsi_device.h
+++ b/include/scsi/scsi_device.h
@@ -407,6 +407,19 @@ void scsi_attach_vpd(struct scsi_device *sdev);
void scsi_cdl_check(struct scsi_device *sdev);
int scsi_cdl_enable(struct scsi_device *sdev, bool enable);
+/**
+ * enum scsi_inq_update_result - Return values for scsi_update_inquiry_data()
+ * @SCSI_INQ_UNCHANGED: INQUIRY data updated, no reprobe needed
+ * @SCSI_INQ_REPROBE_NEEDED: INQUIRY data updated, device type or PQ changed
+ */
+enum scsi_inq_update_result {
+ SCSI_INQ_UNCHANGED = 0,
+ SCSI_INQ_REPROBE_NEEDED = 1,
+};
+
+int scsi_update_inquiry_data(struct scsi_device *sdev,
+ unsigned char *inq_result, size_t inq_len);
+
extern struct scsi_device *scsi_device_from_queue(struct request_queue *q);
extern int __must_check scsi_device_get(struct scsi_device *);
extern void scsi_device_put(struct scsi_device *);
--
2.50.1 (Apple Git-155)
next prev parent reply other threads:[~2026-04-24 21:53 UTC|newest]
Thread overview: 22+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-04-24 21:53 [PATCH 0/6] scsi: Support ALUA unavailable state and INQUIRY changes Brian Bunker
2026-04-24 21:53 ` [PATCH 1/6] scsi: Add INQUIRY data field definitions and accessor helpers Brian Bunker
2026-04-27 8:19 ` Hannes Reinecke
2026-04-30 15:50 ` Bart Van Assche
2026-04-24 21:53 ` [PATCH 2/6] scsi: Protect INQUIRY sysfs attributes with mutex Brian Bunker
2026-04-27 8:22 ` Hannes Reinecke
2026-04-29 1:27 ` [PATCH v2 " Brian Bunker
2026-04-29 21:06 ` Damien Le Moal
2026-04-29 21:15 ` Bart Van Assche
2026-04-29 22:49 ` [PATCH v3 " Brian Bunker
2026-04-30 6:03 ` Hannes Reinecke
2026-04-30 15:48 ` Bart Van Assche
2026-05-01 22:11 ` Brian Bunker
2026-05-02 16:37 ` Bart Van Assche
2026-05-03 15:44 ` Bart Van Assche
2026-05-04 18:36 ` Brian Bunker
2026-05-05 8:24 ` Bart Van Assche
2026-05-05 17:13 ` Brian Bunker
2026-04-24 21:53 ` Brian Bunker [this message]
2026-04-24 21:53 ` [PATCH 4/6] scsi: Refactor scsi_add_lun() to use scsi_update_inquiry_data() Brian Bunker
2026-04-24 21:53 ` [PATCH 5/6] scsi: Add device reprobe support to scsi_rescan_device() Brian Bunker
2026-04-24 21:53 ` [PATCH 6/6] scsi: Handle reprobe for existing devices during SCSI scan Brian Bunker
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260424215324.99045-4-brian@purestorage.com \
--to=brian@purestorage.com \
--cc=hare@suse.de \
--cc=krishna.kant@purestorage.com \
--cc=linux-scsi@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox