@@ -81,3 +81,51 @@ _get_fs_module_param()
{
cat /sys/module/${FSTYP}/parameters/${1} 2>/dev/null
}
+
+# checks the refcount and returns 0 if we can safely remove the module. rmmod
+# does this check for us, but we can use this to also iterate checking for this
+# refcount before we even try to remove the module. This is useful when using
+# debug test modules which take a while to quiesce.
+_patient_rmmod_check_refcnt()
+{
+ local module=$1
+ local refcnt=0
+
+ if [[ -f /sys/module/$module/refcnt ]]; then
+ refcnt=$(cat /sys/module/$module/refcnt 2>/dev/null)
+ if [[ $? -ne 0 || $refcnt -eq 0 ]]; then
+ return 0
+ fi
+ return 1
+ fi
+ return 0
+}
+
+# patiently tries to wait to remove a module by ensuring first
+# the refcnt is 0. We wait for 10 seconds at most.
+_patient_rmmod()
+{
+ local module=$1
+ local max_tries=10
+
+ while [[ $max_tries != 0 ]]; do
+ _patient_rmmod_check_refcnt $module
+ if [[ $? -eq 0 ]]; then
+ break
+ fi
+ sleep 1
+ let max_tries=$max_tries-1
+ done
+
+ # give some grace time for when the refcnt is 0 as otherwise the
+ # removal can fail on older kernels. Refer to:
+ # https://bugzilla.kernel.org/show_bug.cgi?id=212337
+ sleep 10
+
+ if [[ -d /sys/module/$module ]]; then
+ modprobe -r $module
+ return $?
+ fi
+
+ return 0
+}
When we call rmmod it will fail if the refcnt is greater than 0. This is expected, however, if using test modules such as scsi_debug, userspace tests may expect that once userspace is done issuing out whatever it needs to that immediately after it can remove the module. This is not true, things can linger for a while when a test driver's reference count is greater than 0, and so userspace has to wait before it can reliably try rmmod. Furthermore... experience on older kernels shows it may be a while before we can actually remove the module even *after* /sys/module/$module/refcnt is 0. This is only currently observed on older kernels. Provide a check for the refcnt before we try to remove the module. And add a grace period to allow things quiesce before we really try removing the module so that we don't get false positives. An example of this is when using the scsi_debug module. Using udevadm settle does ensure the devices are properly ready to use after modprobe, however once you start using the module, say testing xfs with generic/108, you will see refcnt linger between 1 and 2, and once the test completes this eventually goes down to 0. The refcnt can be > 0 after userspace thinks it is done with a test, and so will fail to remove it. Likewise, on older kernels even with a refcnt of 0 the module may sometimes fail to be removed. Yes, the sleep 10 is rather large, however if you want to prevent false positives it is needed. Doug's patch recent test patch [0] helps with these older kernel kernels not having to require such large delays, however we have no way of telling currently if such scsi_debug quiesce patch is applied. [0] https://lore.kernel.org/linux-scsi/20210508230745.27923-1-dgilbert@interlog.com/ Signed-off-by: Luis Chamberlain <mcgrof@kernel.org> --- common/module | 48 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+)