[deployment-guide/comm-rel: 295/727] Updated the Unloading a Module section.

[Jaromir Hradilek]

commit 097f62a094c5951c679990731fe000bf0e86765a
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Mon Aug 9 17:48:21 2010 +0200

    Updated the Unloading a Module section.

 en-US/Working_with_Kernel_Modules.xml |   29 +++++++++++++++++++++--------
 1 files changed, 21 insertions(+), 8 deletions(-)
---
diff --git a/en-US/Working_with_Kernel_Modules.xml b/en-US/Working_with_Kernel_Modules.xml
index 7fecf45..6b4ce92 100644
--- a/en-US/Working_with_Kernel_Modules.xml
+++ b/en-US/Working_with_Kernel_Modules.xml
@@ -155,20 +155,33 @@ insmod /lib/modules/2.6.32-54.el6.i686/kernel/drivers/net/e100.ko</screen>
       <indexterm
         significance="normal">
         <primary>
-          <command>rmmod</command>
+          <command>modprobe</command>
         </primary>
       </indexterm>
       <indexterm
         significance="normal">
         <primary>kernel module</primary>
-        <secondary>unload</secondary>
+        <secondary>unloading</secondary>
       </indexterm>
-      <para>To unload kernel modules, use the <command>/sbin/rmmod</command> command followed by the module name. The <command>rmmod</command> utility only unloads modules that are not in use and that are not a dependency of other modules in use.</para>
-      <para>For example, the command:</para>
-      <screen>~]#&#160;<command>/sbin/rmmod e100</command>
-      </screen>
-      <para>…unloads the <systemitem
-        class="resource">e100</systemitem> kernel module.</para>
+      <para>To unload a kernel module, use the <command>modprobe</command> command in the following form:</para>
+      <screen><command>/sbin/modprobe -r <replaceable>&lt;module&gt;</replaceable></command></screen>
+      <para>For example, to unload the <systemitem class="resource">wacom</systemitem> module, type:</para>
+      <screen>~]#&#160;<command>/sbin/modprobe -r wacom</command></screen>
+      <para>The <command>modprobe -r</command> command only unloads modules that are not in use and that are not a dependency of other modules in use. On the other hand, it checks for dependencies and unloads all modules that were previously required, but that are no longer necessary.</para>
+      <para>To display all commands as <command>modprobe</command> executes them, use the <option>-v</option> option. For example:</para>
+      <screen>~]#&#160;<command>/sbin/modprobe -v -r e100</command>
+rmmod /lib/modules/2.6.32-54.el6.i686/kernel/drivers/net/e100.ko
+rmmod /lib/modules/2.6.32-54.el6.i686/kernel/drivers/net/mii.ko</screen>
+      <indexterm
+        significance="normal">
+        <primary>
+          <command>rmmod</command>
+        </primary>
+      </indexterm>
+      <important>
+        <title>Important: Do Not Use <command>rmmod</command> Directly</title>
+        <para>Although the <command>/sbin/rmmod</command> command can also be used to unload kernel modules, it is recommended that you use <command>modprobe</command> instead.</para>
+      </important>
     </section>
     <section
       id="s2-kernel-module-utils-modinfo">