RMMOD(8) Linux Module Support RMMOD(8) NNAAMMEE rmmod - unload loadable modules SSYYNNOOPPSSIISS rrmmmmoodd [ -aehrsvV ] module ... DDEESSCCRRIIPPTTIIOONN rrmmmmoodd unloads loadable modules from the running kernel. rrmmmmoodd tries to unload a set of modules from the kernel, with the restriction that they are not in use and that they are not referred to by other modules. If more than one module is named on the command line, the modules will be removed in the given order. This supports unloading of stacked modules. With the option '-r' a recursive removal of modules will be attempted. This means that if a top module in a stack is named on the command line, all modules that are used by this module will be removed as well, if possible. OOPPTTIIOONNSS _-_a _-_-_a_l_l Remove all unused autocleanable modules. _-_e _-_-_p_e_r_s_i_s_t Save persistent data for the named modules, without unloading any modules. If no module names are specified then data is saved for all modules that have persistent data. Data is only saved if both the kernel and modutils support persistent data and /proc/ksyms contains an entry __insmod__m_o_d_u_l_e_n_a_m_e_P_p_e_r_s_i_s_t_e_n_t___f_i_l_e_n_a_m_e _-_h _-_-_h_e_l_p Print the help text. _-_r _-_-_s_t_a_c_k_s Remove a module stack. _-_s _-_-_s_y_s_l_o_g Output everything to ssyysslloogg(3) instead of the terminal. _-_v _-_-_v_e_r_b_o_s_e Be verbose. _-_V _-_-_v_e_r_s_i_o_n Print the version of modutils. PPEERRSSIISSTTEENNTT DDAATTAA If a module contains persistent data (see _i_n_s_m_o_d(8) and Linux November 12, 2000 1 RMMOD(8) Linux Module Support RMMOD(8) _m_o_d_u_l_e_s_._c_o_n_f(5)) then removing the module always writes the persistent data to the filename in the __insmod _P symbol entry. You can also save the persistent data at any time by rmmod -e, this will not unload any modules. When the persistent data is written to file, it is preceded by a generated comment line, #% _k_e_r_n_e_l___v_e_r_s_i_o_n _t_i_m_e_s_t_a_m_p Generated comment lines start with '#%', all generated comments are stripped from the existing file, other comments are preserved. The saved data values are written to the file, preserving the existing order of comments and assignments. New values are added at the end of the file. If the file contains values that do not exist in the module then these values are preserved but are preceded by a generated comment warning that they are not being used. The latter operation allows a user to switch between kernels without losing persistent data and without getting any error messages. NNoottee:: Comments are only supported when the first non-space character on a line is '#'. Any non-blank lines that do not start with '#' are module options, one per line. The option lines have leading spaces removed, the remainder of the line is passed to insmod as an option, including any trailing characters. SSEEEE AALLSSOO insmod(8), lsmod(8), ksyms(8), modprobe(8), modules(2) HHIISSTTOORRYY Module support was first conceived by Anonymous Initial Linux version by Bas Laarhoven Version 0.99.14 by Jon Tombs Extended by Bjorn Ekwall Updated for 2.1.17 by Richard Henderson Updated for 2.2.2 by by Bjorn Ekwall Updated for modutils 2.3.20 by by Keith Owens Persistent data for modutils 2.3.22 by by Keith Owens Linux November 12, 2000 2