Skip to contentSkip to conversation

Prepare for constifying SCSI host templates

PATCH Superseded Bart Van Assche 3 participants 9 messages Sep 8, 2022 – Sep 13, 2022

Subsystems (2)

v3 of 7 Superseded Latest is v7 →

lore
Share & tools
lore
#0 lore raw

v3 cover Prepare for constifying SCSI host templates

Hi Martin,

This patch series prepares for constifying SCSI host templates by moving the members that are not constant out of the SCSI host template. Please consider this patch series for the next merge window.

Thanks,

Bart.

Changes compared to v2:
- Optimized the show_info == NULL case.
- Added a patch that removes the code that clears the module pointer in the host template.

Changes compared to v1:
- Fix the CONFIG_SCSI_PROC_FS=n build.

Bart Van Assche (3):
scsi: esas2r: Introduce scsi_template_proc_dir()
scsi: core: Introduce a new list for SCSI proc directory entries
scsi: core: Rework the code for dropping the LLD module reference

 drivers/scsi/esas2r/esas2r_main.c |  18 +++--
 drivers/scsi/scsi_priv.h          |   4 +-
 drivers/scsi/scsi_proc.c          | 119 ++++++++++++++++++++++++++----
 drivers/scsi/scsi_sysfs.c         |   7 +-
 include/scsi/scsi_device.h        |   1 +
 include/scsi/scsi_host.h          |  18 ++---
 6 files changed, 126 insertions(+), 41 deletions(-)
#1 lore raw

PATCH v3 1/3 scsi: esas2r: Introduce scsi_template_proc_dir()

Prepare for removing the 'proc_dir' and 'present' members from the SCSI host template. This patch does not change any functionality.

Cc Bradley Grove <[email protected]>
Cc Christoph Hellwig <[email protected]>
Cc Ming Lei <[email protected]>
Cc Hannes Reinecke <[email protected]>
Cc John Garry <[email protected]>
Cc Mike Christie <[email protected]>
Cc Krzysztof Kozlowski <[email protected]>
---
 drivers/scsi/esas2r/esas2r_main.c | 18 +++++++++++-------
 drivers/scsi/scsi_proc.c          | 11 +++++++++++
 include/scsi/scsi_host.h          |  6 ++++++
 3 files changed, 28 insertions(+), 7 deletions(-)
drivers/scsi/esas2r/esas2r_main.c +11 -7
index 7a4eadad23d7..fbf7fdb3b52a 100644
@@ -248,7 +248,6 @@ static struct scsi_host_template driver_template = {
 	.sg_tablesize			= SG_CHUNK_SIZE,
 	.cmd_per_lun			=
 		ESAS2R_DEFAULT_CMD_PER_LUN,
-	.present			= 0,
 	.emulated			= 0,
 	.proc_name			= ESAS2R_DRVR_NAME,
 	.change_queue_depth		= scsi_change_queue_depth,
@@ -637,10 +636,13 @@ static void __exit esas2r_exit(void)
 	esas2r_log(ESAS2R_LOG_INFO, "%s called", __func__);
 
 	if (esas2r_proc_major > 0) {
+		struct proc_dir_entry *proc_dir;
+
 		esas2r_log(ESAS2R_LOG_INFO, "unregister proc");
 
-		remove_proc_entry(ATTONODE_NAME,
-				  esas2r_proc_host->hostt->proc_dir);
+		proc_dir = scsi_template_proc_dir(esas2r_proc_host->hostt);
+		if (proc_dir)
+			remove_proc_entry(ATTONODE_NAME, proc_dir);
 		unregister_chrdev(esas2r_proc_major, ESAS2R_DRVR_NAME);
 
 		esas2r_proc_major = 0;
@@ -730,11 +732,13 @@ const char *esas2r_info(struct Scsi_Host *sh)
 			       esas2r_proc_major);
 
 		if (esas2r_proc_major > 0) {
-			struct proc_dir_entry *pde;
+			struct proc_dir_entry *proc_dir;
+			struct proc_dir_entry *pde = NULL;
 
-			pde = proc_create(ATTONODE_NAME, 0,
-					  sh->hostt->proc_dir,
-					  &esas2r_proc_ops);
+			proc_dir = scsi_template_proc_dir(sh->hostt);
+			if (proc_dir)
+				pde = proc_create(ATTONODE_NAME, 0, proc_dir,
+						  &esas2r_proc_ops);
 
 			if (!pde) {
 				esas2r_log_dev(ESAS2R_LOG_WARN,
drivers/scsi/scsi_proc.c +11 -0
index 95aee1ad1383..eeb9261c93f7 100644
@@ -83,6 +83,17 @@ static int proc_scsi_host_open(struct inode *inode, struct file *file)
 				4 * PAGE_SIZE);
 }
 
+/**
+ * scsi_template_proc_dir() - returns the procfs dir for a SCSI host template
+ * @sht: SCSI host template pointer.
+ */
+struct proc_dir_entry *
+scsi_template_proc_dir(const struct scsi_host_template *sht)
+{
+	return sht->proc_dir;
+}
+EXPORT_SYMBOL(scsi_template_proc_dir);
+
 static const struct proc_ops proc_scsi_ops = {
 	.proc_open	= proc_scsi_host_open,
 	.proc_release	= single_release,
include/scsi/scsi_host.h +6 -0
index 9b0a028bf053..030faca947d2 100644
@@ -751,6 +751,12 @@ extern struct Scsi_Host *scsi_host_alloc(struct scsi_host_template *, int);
 extern int __must_check scsi_add_host_with_dma(struct Scsi_Host *,
 					       struct device *,
 					       struct device *);
+#if defined(CONFIG_SCSI_PROC_FS)
+struct proc_dir_entry *
+scsi_template_proc_dir(const struct scsi_host_template *sht);
+#else
+#define scsi_template_proc_dir(sht) NULL
+#endif
 extern void scsi_scan_host(struct Scsi_Host *);
 extern void scsi_rescan_device(struct device *);
 extern void scsi_remove_host(struct Scsi_Host *);
#2 lore raw

Re: [PATCH v3 1/3] scsi: esas2r: Introduce scsi_template_proc_dir()

Quoted 22 lines · Bart Van Assche

Prepare for removing the 'proc_dir' and 'present' members from the SCSI host template. This patch does not change any functionality.

Cc Bradley Grove <[email protected]>
Cc Christoph Hellwig <[email protected]>
Cc Ming Lei <[email protected]>
Cc Hannes Reinecke <[email protected]>
Cc John Garry <[email protected]>
Cc Mike Christie <[email protected]>
Cc Krzysztof Kozlowski <[email protected]>
---
  drivers/scsi/esas2r/esas2r_main.c | 18 +++++++++++-------
  drivers/scsi/scsi_proc.c          | 11 +++++++++++
  include/scsi/scsi_host.h          |  6 ++++++
  3 files changed, 28 insertions(+), 7 deletions(-)
drivers/scsi/esas2r/esas2r_main.c +0 -0
index 7a4eadad23d7..fbf7fdb3b52a 100644

drivers/scsi/esas2r/esas2r_main.c static struct scsi_host_template driver_template = { · line 251

Quoted 4 lines
drivers/scsi/esas2r/esas2r_main.c +0 -1
@@ -248,7 +248,6 @@ static struct scsi_host_template driver_template = {
  	.sg_tablesize			= SG_CHUNK_SIZE,
  	.cmd_per_lun			=
  		ESAS2R_DEFAULT_CMD_PER_LUN,
-	.present			= 0,

nit: this really could be a separate change. It's not really strictly related to introducing scsi_template_proc_dir()

drivers/scsi/scsi_proc.c

Quoted 40 lines
drivers/scsi/esas2r/esas2r_main.c +10 -6
  	.emulated			= 0,
  	.proc_name			= ESAS2R_DRVR_NAME,
  	.change_queue_depth		= scsi_change_queue_depth,
@@ -637,10 +636,13 @@ static void __exit esas2r_exit(void)
  	esas2r_log(ESAS2R_LOG_INFO, "%s called", __func__);
 
  	if (esas2r_proc_major > 0) {
+		struct proc_dir_entry *proc_dir;
+
  		esas2r_log(ESAS2R_LOG_INFO, "unregister proc");
 
-		remove_proc_entry(ATTONODE_NAME,
-				  esas2r_proc_host->hostt->proc_dir);
+		proc_dir = scsi_template_proc_dir(esas2r_proc_host->hostt);
+		if (proc_dir)
+			remove_proc_entry(ATTONODE_NAME, proc_dir);
  		unregister_chrdev(esas2r_proc_major, ESAS2R_DRVR_NAME);
 
  		esas2r_proc_major = 0;
@@ -730,11 +732,13 @@ const char *esas2r_info(struct Scsi_Host *sh)
  			       esas2r_proc_major);
 
  		if (esas2r_proc_major > 0) {
-			struct proc_dir_entry *pde;
+			struct proc_dir_entry *proc_dir;
+			struct proc_dir_entry *pde = NULL;
 
-			pde = proc_create(ATTONODE_NAME, 0,
-					  sh->hostt->proc_dir,
-					  &esas2r_proc_ops);
+			proc_dir = scsi_template_proc_dir(sh->hostt); > +			if (proc_dir)
+				pde = proc_create(ATTONODE_NAME, 0, proc_dir,
+						  &esas2r_proc_ops);
 
  			if (!pde) {
  				esas2r_log_dev(ESAS2R_LOG_WARN,
drivers/scsi/scsi_proc.c +0 -0
index 95aee1ad1383..eeb9261c93f7 100644

Again, seems it should be a separate change - this is not esas2r code now

Quoted 4 lines
drivers/scsi/scsi_proc.c +0 -0
@@ -83,6 +83,17 @@ static int proc_scsi_host_open(struct inode *inode, struct file *file)
  				4 * PAGE_SIZE);
  }
 

drivers/scsi/scsi_proc.c static int proc_scsi_host_open(struct inode *inode, struct file *file) · line 95

Quoted 10 lines
drivers/scsi/scsi_proc.c +10 -0
+/**
+ * scsi_template_proc_dir() - returns the procfs dir for a SCSI host template
+ * @sht: SCSI host template pointer.
+ */
+struct proc_dir_entry *
+scsi_template_proc_dir(const struct scsi_host_template *sht)
+{
+	return sht->proc_dir;
+}
+EXPORT_SYMBOL(scsi_template_proc_dir);

Don't we encourage EXPORT_SYMBOL_GPL? The core code seems a mishmash.

Quoted 9 lines
drivers/scsi/scsi_proc.c +1 -0
+
  static const struct proc_ops proc_scsi_ops = {
  	.proc_open	= proc_scsi_host_open,
  	.proc_release	= single_release,
include/scsi/scsi_host.h +0 -0
index 9b0a028bf053..030faca947d2 100644

include/scsi/scsi_host.h extern struct Scsi_Host *scsi_host_alloc(struct scsi_host_template *, int); · line 755

Quoted 5 lines
include/scsi/scsi_host.h +2 -0
@@ -751,6 +751,12 @@ extern struct Scsi_Host *scsi_host_alloc(struct scsi_host_template *, int);
  extern int __must_check scsi_add_host_with_dma(struct Scsi_Host *,
  					       struct device *,
  					       struct device *);
+#if defined(CONFIG_SCSI_PROC_FS)
+struct proc_dir_entry *

I don't feel too strongly about this, but elsewhere we have extern and I thought that consistency trumps coding standards.

Quoted 7 lines
include/scsi/scsi_host.h +3 -0
+scsi_template_proc_dir(const struct scsi_host_template *sht); > +#else
+#define scsi_template_proc_dir(sht) NULL
+#endif
  extern void scsi_scan_host(struct Scsi_Host *);
  extern void scsi_rescan_device(struct device *);
  extern void scsi_remove_host(struct Scsi_Host *);

.

#3 lore raw

Re: [PATCH v3 1/3] scsi: esas2r: Introduce scsi_template_proc_dir()

Quoted 12 lines · John Garry
Quoted 9 lines · Bart Van Assche
drivers/scsi/esas2r/esas2r_main.c +0 -0
index 7a4eadad23d7..fbf7fdb3b52a 100644
@@ -248,7 +248,6 @@ static struct scsi_host_template driver_template = {
       .sg_tablesize            = SG_CHUNK_SIZE,

      .cmd_per_lun            =
          ESAS2R_DEFAULT_CMD_PER_LUN,
-    .present            = 0,

nit: this really could be a separate change. It's not really strictly related to introducing scsi_template_proc_dir()

I will move this change into a separate patch.

Quoted 6 lines

drivers/scsi/scsi_proc.c

Quoted 4 lines
drivers/scsi/scsi_proc.c +0 -0
index 95aee1ad1383..eeb9261c93f7 100644

Again, seems it should be a separate change - this is not esas2r code now

In the kernel community it is strongly recommended to introduce new functions in the same patch that adds a user. Hence the presence of scsi_proc.c changes in this patch.

Quoted 3 lines
Quoted 1 line

+EXPORT_SYMBOL(scsi_template_proc_dir);

Don't we encourage EXPORT_SYMBOL_GPL? The core code seems a mishmash.

I will change this into EXPORT_SYMBOL_GPL().

Quoted 4 lines

drivers/scsi/scsi_proc.c

Quoted 2 lines
drivers/scsi/scsi_proc.c +2 -0
+#if defined(CONFIG_SCSI_PROC_FS)
+struct proc_dir_entry *

I don't feel too strongly about this, but elsewhere we have extern and I thought that consistency trumps coding standards.

Should I submit a separate patch that removes superfluous uses of the 'extern' keyword?

Thanks,

Bart.

#4 lore raw

PATCH v3 2/3 scsi: core: Introduce a new list for SCSI proc directory entries

In reply to Bart Van Assche

Instead of using scsi_host_template members to track the SCSI proc directory entries, track these entries in a list. This patch changes the time needed for looking up the proc dir pointer from O(1) into O(n). I think this is acceptable since the number of SCSI host adapter types per host is usually small (less than ten).

This patch has been tested by attaching two USB storage devices to a qemu host:

$ grep -aH . /proc/scsi/usb-storage/*
/proc/scsi/usb-storage/7:   Host scsi7: usb-storage
/proc/scsi/usb-storage/7:       Vendor: QEMU
/proc/scsi/usb-storage/7:      Product: QEMU USB HARDDRIVE
/proc/scsi/usb-storage/7:Serial Number: 1-0000:00:02.1:00.0-6
/proc/scsi/usb-storage/7:     Protocol: Transparent SCSI
/proc/scsi/usb-storage/7:    Transport: Bulk
/proc/scsi/usb-storage/7:       Quirks: SANE_SENSE
/proc/scsi/usb-storage/8:   Host scsi8: usb-storage
/proc/scsi/usb-storage/8:       Vendor: QEMU
/proc/scsi/usb-storage/8:      Product: QEMU USB HARDDRIVE
/proc/scsi/usb-storage/8:Serial Number: 1-0000:00:02.1:00.0-7
/proc/scsi/usb-storage/8:     Protocol: Transparent SCSI
/proc/scsi/usb-storage/8:    Transport: Bulk
/proc/scsi/usb-storage/8:       Quirks: SANE_SENSE

This patch prepares for constifying most SCSI host templates.

Cc Christoph Hellwig <[email protected]>
Cc Ming Lei <[email protected]>
Cc Hannes Reinecke <[email protected]>
Cc John Garry <[email protected]>
Cc Mike Christie <[email protected]>
Cc Krzysztof Kozlowski <[email protected]>
---
 drivers/scsi/scsi_priv.h |   4 +-
 drivers/scsi/scsi_proc.c | 110 +++++++++++++++++++++++++++++++++------
 include/scsi/scsi_host.h |  12 -----
 3 files changed, 95 insertions(+), 31 deletions(-)
drivers/scsi/scsi_priv.h +2 -2
index f385b3f04d6e..be5d7c9b7f39 100644
@@ -100,8 +100,8 @@ extern void scsi_evt_thread(struct work_struct *work);
 
 /* scsi_proc.c */
 #ifdef CONFIG_SCSI_PROC_FS
-extern void scsi_proc_hostdir_add(struct scsi_host_template *);
-extern void scsi_proc_hostdir_rm(struct scsi_host_template *);
+extern void scsi_proc_hostdir_add(const struct scsi_host_template *);
+extern void scsi_proc_hostdir_rm(const struct scsi_host_template *);
 extern void scsi_proc_host_add(struct Scsi_Host *);
 extern void scsi_proc_host_rm(struct Scsi_Host *);
 extern int scsi_init_procfs(void);
drivers/scsi/scsi_proc.c +93 -17

177 lines not on this page · raw message

include/scsi/scsi_host.h +0 -12
index 030faca947d2..fb8184d87384 100644
@@ -357,12 +357,6 @@ struct scsi_host_template {
 	 */
 	const char *proc_name;
 
-	/*
-	 * Used to store the procfs directory if a driver implements the
-	 * show_info method.
-	 */
-	struct proc_dir_entry *proc_dir;
-
 	/*
 	 * This determines if we will use a non-interrupt driven
 	 * or an interrupt driven scheme.  It is set to the maximum number
@@ -423,12 +417,6 @@ struct scsi_host_template {
 	 */
 	short cmd_per_lun;
 
-	/*
-	 * present contains counter indicating how many boards of this
-	 * type were found when we did the scan.
-	 */
-	unsigned char present;
-
 	/* If use block layer to manage tags, this is tag allocation policy */
 	int tag_alloc_policy;
 
Reviewed-by on v3 2/3
#5 lore raw

Re: [PATCH v3 2/3] scsi: core: Introduce a new list for SCSI proc directory entries

Quoted 9 lines · Bart Van Assche

Instead of using scsi_host_template members to track the SCSI proc directory entries, track these entries in a list. This patch changes the time needed for looking up the proc dir pointer from O(1) into O(n). I think this is acceptable since the number of SCSI host adapter types per host is usually small (less than ten).

This patch has been tested by attaching two USB storage devices to a qemu host:

#6 lore raw

Re: [PATCH v3 2/3] scsi: core: Introduce a new list for SCSI proc directory entries

In reply to Bart Van Assche
Quoted 70 lines · Bart Van Assche

Instead of using scsi_host_template members to track the SCSI proc directory entries, track these entries in a list. This patch changes the time needed for looking up the proc dir pointer from O(1) into O(n). I think this is acceptable since the number of SCSI host adapter types per host is usually small (less than ten).

This patch has been tested by attaching two USB storage devices to a qemu host:

$ grep -aH . /proc/scsi/usb-storage/*
/proc/scsi/usb-storage/7:   Host scsi7: usb-storage
/proc/scsi/usb-storage/7:       Vendor: QEMU
/proc/scsi/usb-storage/7:      Product: QEMU USB HARDDRIVE
/proc/scsi/usb-storage/7:Serial Number: 1-0000:00:02.1:00.0-6
/proc/scsi/usb-storage/7:     Protocol: Transparent SCSI
/proc/scsi/usb-storage/7:    Transport: Bulk
/proc/scsi/usb-storage/7:       Quirks: SANE_SENSE
/proc/scsi/usb-storage/8:   Host scsi8: usb-storage
/proc/scsi/usb-storage/8:       Vendor: QEMU
/proc/scsi/usb-storage/8:      Product: QEMU USB HARDDRIVE
/proc/scsi/usb-storage/8:Serial Number: 1-0000:00:02.1:00.0-7
/proc/scsi/usb-storage/8:     Protocol: Transparent SCSI
/proc/scsi/usb-storage/8:    Transport: Bulk
/proc/scsi/usb-storage/8:       Quirks: SANE_SENSE

This patch prepares for constifying most SCSI host templates.

Cc Christoph Hellwig <[email protected]>
Cc Ming Lei <[email protected]>
Cc Hannes Reinecke <[email protected]>
Cc John Garry <[email protected]>
Cc Mike Christie <[email protected]>
Cc Krzysztof Kozlowski <[email protected]>
---
  drivers/scsi/scsi_priv.h |   4 +-
  drivers/scsi/scsi_proc.c | 110 +++++++++++++++++++++++++++++++++------
  include/scsi/scsi_host.h |  12 -----
  3 files changed, 95 insertions(+), 31 deletions(-)
drivers/scsi/scsi_priv.h +2 -2
index f385b3f04d6e..be5d7c9b7f39 100644
@@ -100,8 +100,8 @@ extern void scsi_evt_thread(struct work_struct *work);
 
  /* scsi_proc.c */
  #ifdef CONFIG_SCSI_PROC_FS
-extern void scsi_proc_hostdir_add(struct scsi_host_template *);
-extern void scsi_proc_hostdir_rm(struct scsi_host_template *);
+extern void scsi_proc_hostdir_add(const struct scsi_host_template *);
+extern void scsi_proc_hostdir_rm(const struct scsi_host_template *);
  extern void scsi_proc_host_add(struct Scsi_Host *);
  extern void scsi_proc_host_rm(struct Scsi_Host *);
  extern int scsi_init_procfs(void);
drivers/scsi/scsi_proc.c +5 -1
index eeb9261c93f7..e04db652a81e 100644
@@ -43,8 +43,23 @@
 
  static struct proc_dir_entry *proc_scsi;
 
-/* Protect sht->present and sht->proc_dir */
+/* Protects scsi_proc_list */
  static DEFINE_MUTEX(global_host_template_mutex);
+static LIST_HEAD(scsi_proc_list);
+
+/**
+ * struct scsi_proc_entry - (host template, SCSI proc dir) association

drivers/scsi/scsi_proc.c line 61

Quoted 10 lines
drivers/scsi/scsi_proc.c +10 -0
+ * @entry: entry in scsi_proc_list.
+ * @sht: SCSI host template associated with the procfs directory.
+ * @proc_dir: procfs directory associated with the SCSI host template.
+ * @present: Number of SCSI hosts instantiated for @sht.
+ */
+struct scsi_proc_entry {
+	struct list_head	entry;
+	const struct scsi_host_template *sht;
+	struct proc_dir_entry	*proc_dir;
+	unsigned char		present;

is there really a hard limit of 255 hosts?

Quoted 5 lines
drivers/scsi/scsi_proc.c +1 -0
+};
 
  static ssize_t proc_scsi_host_write(struct file *file, const char __user *buf,
                             size_t count, loff_t *ppos)

drivers/scsi/scsi_proc.c static int proc_scsi_host_open(struct inode *inode, struct file *file) · line 106

Quoted 9 lines
drivers/scsi/scsi_proc.c +6 -0
@@ -83,6 +98,32 @@ static int proc_scsi_host_open(struct inode *inode, struct file *file)
  				4 * PAGE_SIZE);
  }
 
+static struct scsi_proc_entry *
+__scsi_lookup_proc_entry(const struct scsi_host_template *sht)
+{
+	struct scsi_proc_entry *e;
+
+	lockdep_assert_held(&global_host_template_mutex);

I'm not sure we really need this - maybe a comment would be better. I don't care too much either way.

Quoted 57 lines
drivers/scsi/scsi_proc.c +31 -7
+
+	list_for_each_entry(e, &scsi_proc_list, entry)
+		if (e->sht == sht)
+			return e;
+
+	return NULL;
+}
+
+static struct scsi_proc_entry *
+scsi_lookup_proc_entry(const struct scsi_host_template *sht)
+{
+	struct scsi_proc_entry *e;
+
+	mutex_lock(&global_host_template_mutex);
+	e = __scsi_lookup_proc_entry(sht);
+	mutex_unlock(&global_host_template_mutex);
+
+	return e;
+}
+
  /**
   * scsi_template_proc_dir() - returns the procfs dir for a SCSI host template
   * @sht: SCSI host template pointer.
@@ -90,7 +131,9 @@ static int proc_scsi_host_open(struct inode *inode, struct file *file)
  struct proc_dir_entry *
  scsi_template_proc_dir(const struct scsi_host_template *sht)
  {
-	return sht->proc_dir;
+	struct scsi_proc_entry *e = scsi_lookup_proc_entry(sht);
+
+	return e ? e->proc_dir : NULL;
  }
  EXPORT_SYMBOL(scsi_template_proc_dir);
 
@@ -109,34 +152,56 @@ static const struct proc_ops proc_scsi_ops = {
   * Sets sht->proc_dir to the new directory.
   */
 
-void scsi_proc_hostdir_add(struct scsi_host_template *sht)
+void scsi_proc_hostdir_add(const struct scsi_host_template *sht)
  {
+	struct scsi_proc_entry *e;
+
  	if (!sht->show_info)
  		return;
 
  	mutex_lock(&global_host_template_mutex);
-	if (!sht->present++) {
-		sht->proc_dir = proc_mkdir(sht->proc_name, proc_scsi);
-        	if (!sht->proc_dir)
-			printk(KERN_ERR "%s: proc_mkdir failed for %s\n",
-			       __func__, sht->proc_name);
+	e = __scsi_lookup_proc_entry(sht);
+	if (!e) {
+		e = kzalloc(sizeof(*e), GFP_KERNEL);
+		if (!e)
+			goto unlock;

drivers/scsi/scsi_proc.c static const struct proc_ops proc_scsi_ops = { · line 177

Quoted 10 lines
drivers/scsi/scsi_proc.c +9 -0
  	}
+	if (e->present++) {
+		e = NULL;
+		goto unlock;
+	}
+	e->proc_dir = proc_mkdir(sht->proc_name, proc_scsi);
+	if (!e->proc_dir) {
+		printk(KERN_ERR "%s: proc_mkdir failed for %s\n", __func__,
+		       sht->proc_name);
+		goto unlock;

hmmm... in this case we don't add e to the list. As unlikely as it seems, if a subsequent attempt to create the proc dir passes for another host with the same sht, then e->present would be incorrect, right?

Quoted 112 lines
drivers/scsi/scsi_proc.c +31 -9
+	}
+	e->sht = sht;
+	list_add_tail(&e->entry, &scsi_proc_list);
+	e = NULL;
+unlock:
  	mutex_unlock(&global_host_template_mutex);
+
+	kfree(e);
  }
 
  /**
   * scsi_proc_hostdir_rm - remove directory in /proc for a scsi host
   * @sht: owner of directory
   */
-void scsi_proc_hostdir_rm(struct scsi_host_template *sht)
+void scsi_proc_hostdir_rm(const struct scsi_host_template *sht)
  {
+	struct scsi_proc_entry *e;
+
  	if (!sht->show_info)
  		return;
 
  	mutex_lock(&global_host_template_mutex);
-	if (!--sht->present && sht->proc_dir) {
+	e = __scsi_lookup_proc_entry(sht);
+	if (e && !--e->present) {
  		remove_proc_entry(sht->proc_name, proc_scsi);
-		sht->proc_dir = NULL;
+		list_del(&e->entry);
+		kfree(e);
  	}
  	mutex_unlock(&global_host_template_mutex);
  }
@@ -148,16 +213,21 @@ void scsi_proc_hostdir_rm(struct scsi_host_template *sht)
   */
  void scsi_proc_host_add(struct Scsi_Host *shost)
  {
-	struct scsi_host_template *sht = shost->hostt;
+	const struct scsi_host_template *sht = shost->hostt;
+	struct scsi_proc_entry *e;
  	struct proc_dir_entry *p;
  	char name[10];
 
-	if (!sht->proc_dir)
+	if (!sht->show_info)
+		return;
+
+	e = scsi_lookup_proc_entry(sht);
+	if (!e)
  		return;
 
  	sprintf(name,"%d", shost->host_no);
-	p = proc_create_data(name, S_IRUGO | S_IWUSR,
-		sht->proc_dir, &proc_scsi_ops, shost);
+	p = proc_create_data(name, S_IRUGO | S_IWUSR, e->proc_dir,
+			     &proc_scsi_ops, shost);
  	if (!p)
  		printk(KERN_ERR "%s: Failed to register host %d in"
  		       "%s\n", __func__, shost->host_no,
@@ -170,13 +240,19 @@ void scsi_proc_host_add(struct Scsi_Host *shost)
   */
  void scsi_proc_host_rm(struct Scsi_Host *shost)
  {
+	const struct scsi_host_template *sht = shost->hostt;
+	struct scsi_proc_entry *e;
  	char name[10];
 
-	if (!shost->hostt->proc_dir)
+	if (!sht->show_info)
+		return;
+
+	e = scsi_lookup_proc_entry(sht);
+	if (!e)
  		return;
 
  	sprintf(name,"%d", shost->host_no);
-	remove_proc_entry(name, shost->hostt->proc_dir);
+	remove_proc_entry(name, e->proc_dir);
  }
  /**
   * proc_print_scsidevice - return data about this host
include/scsi/scsi_host.h +0 -12
index 030faca947d2..fb8184d87384 100644
@@ -357,12 +357,6 @@ struct scsi_host_template {
  	 */
  	const char *proc_name;
 
-	/*
-	 * Used to store the procfs directory if a driver implements the
-	 * show_info method.
-	 */
-	struct proc_dir_entry *proc_dir;
-
  	/*
  	 * This determines if we will use a non-interrupt driven
  	 * or an interrupt driven scheme.  It is set to the maximum number
@@ -423,12 +417,6 @@ struct scsi_host_template {
  	 */
  	short cmd_per_lun;
 
-	/*
-	 * present contains counter indicating how many boards of this
-	 * type were found when we did the scan.
-	 */
-	unsigned char present;
-
  	/* If use block layer to manage tags, this is tag allocation policy */
  	int tag_alloc_policy;
 

.

#7 lore raw

Re: [PATCH v3 2/3] scsi: core: Introduce a new list for SCSI proc directory entries

Quoted 8 lines · John Garry
Quoted 5 lines · Bart Van Assche

+struct scsi_proc_entry {
+    struct list_head    entry;
+    const struct scsi_host_template *sht;
+    struct proc_dir_entry    *proc_dir;
+    unsigned char        present;

is there really a hard limit of 255 hosts?

Apparently that limit exists today. I can use a wider data type for the 'present' member if you want.

Quoted 8 lines

drivers/scsi/scsi_proc.c static int proc_scsi_host_open(struct inode *inode, struct file *file) · line 106

Quoted 6 lines
drivers/scsi/scsi_proc.c +6 -0
+static struct scsi_proc_entry *
+__scsi_lookup_proc_entry(const struct scsi_host_template *sht)
+{
+    struct scsi_proc_entry *e;
+
+    lockdep_assert_held(&global_host_template_mutex);

I'm not sure we really need this - maybe a comment would be better. I don't care too much either way.

lockdep_assert_held() statements get verified at runtime if lockdep is enabled but comments not. This is why I prefer lockdep_assert_held() over a comment.

Quoted 11 lines
Quoted 9 lines

+    if (e->present++) {
+        e = NULL;
+        goto unlock;
+    }
+    e->proc_dir = proc_mkdir(sht->proc_name, proc_scsi); +    if (!e->proc_dir) {
+        printk(KERN_ERR "%s: proc_mkdir failed for %s\n", __func__, +               sht->proc_name);
+        goto unlock;

hmmm... in this case we don't add e to the list. As unlikely as it seems, if a subsequent attempt to create the proc dir passes for another host with the same sht, then e->present would be incorrect, right?

Right, this needs to be fixed.

Thanks,

Bart.

#8 lore raw

PATCH v3 3/3 scsi: core: Rework the code for dropping the LLD module reference

In reply to Bart Van Assche

Instead of clearing the host template module pointer if the LLD kernel module is being unloaded, set the 'drop_module_ref' SCSI device member. This patch prepares for constifying the SCSI host template.

Cc Christoph Hellwig <[email protected]>
Cc Ming Lei <[email protected]>
Cc Hannes Reinecke <[email protected]>
Cc John Garry <[email protected]>
Cc Mike Christie <[email protected]>
Cc Krzysztof Kozlowski <[email protected]>
---
 drivers/scsi/scsi_sysfs.c  | 7 +++----
 include/scsi/scsi_device.h | 1 +
 2 files changed, 4 insertions(+), 4 deletions(-)
drivers/scsi/scsi_sysfs.c +3 -4
index 5d61f58399dc..822ae60a64b9 100644
@@ -454,7 +454,7 @@ static void scsi_device_dev_release_usercontext(struct work_struct *work)
 
 	sdev = container_of(work, struct scsi_device, ew.work);
 
-	mod = sdev->host->hostt->module;
+	mod = sdev->drop_module_ref ? sdev->host->hostt->module : NULL;
 
 	scsi_dh_release_device(sdev);
 
@@ -525,9 +525,8 @@ static void scsi_device_dev_release(struct device *dev)
 {
 	struct scsi_device *sdp = to_scsi_device(dev);
 
-	/* Set module pointer as NULL in case of module unloading */
-	if (!try_module_get(sdp->host->hostt->module))
-		sdp->host->hostt->module = NULL;
+	if (try_module_get(sdp->host->hostt->module))
+		sdp->drop_module_ref = true;
 
 	execute_in_process_context(scsi_device_dev_release_usercontext,
 				   &sdp->ew);
include/scsi/scsi_device.h +1 -0
index 2493bd65351a..b03176b69056 100644
@@ -214,6 +214,7 @@ struct scsi_device {
 					 * creation time */
 	unsigned ignore_media_change:1; /* Ignore MEDIA CHANGE on resume */
 	unsigned silence_suspend:1;	/* Do not print runtime PM related messages */
+	unsigned drop_module_ref:1;
 
 	unsigned int queue_stopped;	/* request queue is quiesced */
 	bool offline_already;		/* Device offline message logged */