3 # Takes a list of modules and unloads them and all dependent modules.
4 # If a module cannot be unloaded (e.g. it's in use), an error is
6 ###############################################################################
8 SCRIPT_NAME="$(basename "$0")"
14 echo "$SCRIPT_NAME -h|--help"
15 echo "$SCRIPT_NAME [-d|--debug-kernel] [modulesname...]"
17 echo -e "\t-h, --help\t\tDisplay this help message"
18 echo -e "\t-d, --debug-kernel\tDisplay lustre kernel debug messages"
19 echo -e "\tmodulesname\t\tList of lustre modules to unload. By default"
20 echo -e "\t\t\t\tldiskfs and libcfs (and their dependencies) are"
21 echo -e "\t\t\t\tselected."
24 # Print kernel debug message for lustre modules
26 $LCTL mark "$SCRIPT_NAME : Stop debug"
31 # Unload all modules dependent on $1 (exclude removal of $1)
32 unload_dep_modules_exclusive() {
35 local DEPS="$(lsmod | awk '($1 == "'$MODULE'") { print $4 }')"
36 for SUBMOD in $(echo $DEPS | tr ',' ' '); do
37 unload_dep_modules_inclusive $SUBMOD || return 1
42 # Unload all modules dependent on $1 (include removal of $1)
43 unload_dep_modules_inclusive() {
46 # if $MODULE not loaded, return 0
47 lsmod | egrep -q "^\<$MODULE\>" || return 0
48 unload_dep_modules_exclusive $MODULE || return 1
51 if [ "$MODULE" = 'libcfs' ]; then
54 $LCTL mark "$SCRIPT_NAME : Unload $MODULE"
57 rmmod $MODULE || return 1
62 while [ $# -gt 0 ]; do
69 if lsmod | egrep -q '^libcfs'; then
72 echo "Debug unavailable: libcfs is not loaded" >&2
76 echo "Error invalid option" >&2
87 # To maintain backwards compatibility, ldiskfs and libcfs must be
88 # unloaded if no parameters are given, or if only the ldiskfs parameter
89 # is given. It's ugly, but is needed to emulate the prior functionality
90 if [ "${#modules[@]}" -eq 0 ] || [ "${modules[*]}" = "ldiskfs" ]; then
92 modules=('lnet_selftest' 'ldiskfs' 'libcfs')
97 if [ -f /sys/kernel/debug/kmemleak ] ; then
98 cat /proc/modules >/tmp/kmemleak-modules-list.txt
99 echo scan > /sys/kernel/debug/kmemleak
100 cat /sys/kernel/debug/kmemleak > /tmp/kmemleak-before-unload.txt
101 test -s /tmp/kmemleak-before-unload.txt && logger -t leak-pre -f /tmp/kmemleak-before-unload.txt
102 rm /tmp/kmemleak-before-unload.txt
103 # Clear everything here so that only new leaks show up
104 # after module unload
105 echo clear > /sys/kernel/debug/kmemleak
110 echo "Lustre debug parameters:" >&2
111 $LCTL get_param debug >&2
112 $LCTL get_param debug_mb >&2
114 $LCTL mark "$SCRIPT_NAME : Start debug"
118 unload_dep_modules_inclusive 'ptlrpc' || exit 1
119 # LNet may have an internal ref which can prevent LND modules from
120 # unloading. Try to drop it before unloading modules.
121 # NB: we squelch stderr because lnetctl/lctl may complain about
122 # LNet being "busy", but this is normal. We're making a best effort
124 # Prefer lnetctl if it is present
125 if [ -n "$(which lnetctl 2>/dev/null)" ]; then
126 lnetctl lnet unconfigure 2>/dev/null
127 elif [ -n "$(which lctl 2>/dev/null)" ]; then
128 lctl net down 2>/dev/null | grep -v "LNET ready to unload"
132 for mod in ${modules[*]}; do
133 unload_dep_modules_inclusive $mod || exit 1
140 if [ -f /sys/kernel/debug/kmemleak ] ; then
141 echo scan > /sys/kernel/debug/kmemleak
142 cat /sys/kernel/debug/kmemleak > /tmp/kmemleak-after-unload.txt
143 test -s /tmp/kmemleak-after-unload.txt && logger -t leak-mods -f /tmp/kmemleak-modules-list.txt && logger -t leak-post -f /tmp/kmemleak-after-unload.txt
144 rm -f /tmp/kmemleak-after-unload.txt /tmp/kmemleak-modules-list.txt