| LUSTRE_RMMOD(8) | Lustre Configuration Utilities | LUSTRE_RMMOD(8) |
NAME
lustre_rmmod - remove Lustre modules from the kernel
SYNOPSIS
lustre_rmmod |
[-d|--debug-kernel] [-h|--help] [-w|--wait SECONDS] [MODULE ...] |
DESCRIPTION
lustre_rmmod calls the rmmod(8) utility to unload all of the Lustre kernel modules in the correct order to handle dependencies between them. This is useful/necessary when upgrading the kernel modules to ensure that the newly-installed modules are used for mounting the filesystem. Otherwise, if the system was not rebooted or modules unloaded before remounting, it is possible that old modules are used.
If one or more MODULE arguments is given on the command line, then all dependencies of the specified module(s) as well as the module itself are unloaded. If no module is specified, then all Lustre kernel modules are unloaded.
OPTIONS
- -d, --debug-kernel
- Dump the Lustre kernel debug log using lctl-debug_kernel(8) before unloading the last module. This allows capturing full debug traces in case of issues during cleanup, or when tracing memory leaks.
- -h, --help
- Print a usage message and exit.
- -w, --wait SECONDS
- Wait up to SECONDS seconds, total, for OBD devices to be cleaned up (according to lctl-device_list(8)) before trying to unload the modules, to allow asynchronous device cleanup actions to complete after umount(8) returns. If SECONDS is 0, no devices are configured, or lctl returns an error, then there is no further wait before module unload.
An empty device list does not itself guarantee that a module's reference count has reached zero, since some modules may briefly retain a reference after the last device disappears. If unloading a module fails, the remainder of the SECONDS budget is used to poll the module's reference count and retry the unload once it reaches zero, rather than failing immediately.
AVAILABILITY
lustre_rmmod is part of the lustre(7) filesystem package since release 1.6.0
SEE ALSO
lctl(8), lctl-debug_kernel(8), lctl-device_list(8), rmmod(8), umount(8)
| 2026-07-07 | Lustre |