updated

LDP/howto/docbook/Remote-Serial-Console-HOWTO.sgml

@@ -157,28 +157,28 @@
   <section id="preliminaries-credits">
    <title>Acknowledgments</title>
 
-   <para>This <citetitle>HOWTO</citetitle> was initially based upon
+   <para>The first edition of this <citetitle>HOWTO</citetitle> was
+   written by Mark Komarinski.  It was based upon
    <filename>/usr/src/linux/Documentation/serial-console.txt</filename>,
-   written by Miquel van Smoorenburg
-   <email>miquels@cistron.nl</email>.  Many thanks to Miquel for the
-   information in his document.</para>
+   which was written by Miquel van Smoorenburg.</para>
 
-   <para>This <citetitle>HOWTO</citetitle> was significantly revised
-   by the staff of the <ulink
+   <para>The second edition of this <citetitle>HOWTO</citetitle> was
+   written by the staff of the <ulink
    url="http://www.aarnet.edu.au/">Australian Academic and Research
-   Network</ulink>.  The revised text was then edited by the members
-   of the LinuxSA mailing list.  <ulink
-   url="http://www.linuxsa.org.au/">LinuxSA</ulink> is a Linux user
-   group based in South Australia.</para>
+   Network</ulink>, mainly Glen Turner and David Vu.  The revised text
+   was proof read by the members of the LinuxSA mailing list.  <ulink
+   url="http://www.linuxsa.org.au/">LinuxSA</ulink> is a <systemitem
+   class="osname">Linux</systemitem> user group based in South
+   Australia.</para>
 
    <para>David Lawyer, author of the <ulink
    url="http://www.linuxdoc.org/HOWTO/Text-Terminal-HOWTO.html"><citetitle>Text-Terminal-HOWTO</citetitle></ulink>,
-   reviewed this document.  Many thanks to David for his useful
+   reviewed the second edition.  Many thanks to David for his useful
    feedback.</para>
 
    <para>Glen Turner would like to thank his family for allowing him
    to work on this project for the surprisingly large number of
-   evenings it has taken to write this <citetitle>HOWTO</citetitle>.
+   evenings which it took to write this <citetitle>HOWTO</citetitle>.
    Thanks Karen, Kayla and Ella.</para>
 
   </section> <!-- preliminaries-credits -->
@@ -1197,6 +1197,50 @@ Press any key to continue.
 terminal &hyphen;&hyphen;timeout=10 &hyphen;&hyphen;dumb serial console</programlisting>
    </figure> <!-- configure-boot-loader-grub-dumb -->
 
+   <para>This <citetitle>HOWTO</citetitle> does not discuss the use of
+   <application>GRUB</application>'s command line.  It is far too
+   complex and error-prone to recommend for use on production
+   machines.  Wizards will know to consult
+   <application>GRUB</application>'s <application>info</application>
+   manual for the commands required to boot the kernel.</para>
+
+   <para><application>GRUB</application>'s menu's can be edited
+   interactively after <keycap>P</keycap> is pressed and the password
+   supplied.  A better approach is to add menu items to boot the
+   machine into alternative run levels.  A sample configuration
+   showing a menu entry for the default run level and an alternative
+   menu entry for single user mode (run level
+   <wordasword>s</wordasword>) is shown in <xref
+   linkend="configure-boot-loader-grub-runlevel">.  Remember to use
+   the <command>lock</command> command to require a password for
+   single user mode, as single user mode does not ask for a
+   <systemitem class="osname">Linux</systemitem> password.</para>
+
+   <figure id="configure-boot-loader-grub-runlevel">
+    <title>Adding a single user mode option to the
+    <application>GRUB</application> menu</title>
+<programlisting>
+password &hyphen;&hyphen;md5 $1$U$JK7xFegdxWH6VuppCUSIb.
+default 0
+title Red Hat Linux (2.4.9-21)
+        root (hd0,0)
+        kernel /vmlinuz-2.4.9-21 ro root=/dev/hda6
+        initrd /initrd-2.4.9-21.img
+title Red Hat Linux (2.4.9-21) single user mode
+        lock
+        root (hd0,0)
+        kernel /vmlinuz-2.4.9-21 ro root=/dev/hda6 s
+        initrd /initrd-2.4.9-21.img
+</programlisting>
+   </figure>
+
+   <para>File names in the <command>kernel</command> and
+   <command>initrd</command> commands are relative to the
+   <application>GRUB</application> installation directory, which is
+   usually <filename class="directory">/boot/grub</filename>.  So
+   <filename>/vmlinuz-2.4.9-21</filename> is actually the file
+   <filename>/boot/grub/vmlinuz-2.4.9-21</filename>.</para>
+
    <para><application>GRUB</application> is now configured to use the
    serial console.  The kernels booted from
    <application>GRUB</application> are yet to be configured to use the
@@ -1602,7 +1646,8 @@ root (hd0,0)
    linkend="configure-kernel-grub-rhl-serial">.</para>
 
   <example id="configure-kernel-grub-rhl-serial">
-   <title>Complete <application>GRUB</application> configuration, modified for serial console</title>
+   <title>Complete <application>GRUB</application> configuration,
+   modified for serial console</title>
 <programlisting>
 default=0
 timeout=10
@@ -1610,9 +1655,14 @@ password --md5 $1$wwmIq64O$2vofKBDL9vZKeJyaKwIeT.
 serial --unit=0 --speed=9600 -word=8 --parity=no --stop=1
 terminal --timeout=10 serial console
 title Red Hat Linux (2.4.9-21)
-root (hd0,0)
+  root (hd0,0)
   kernel /vmlinuz-2.4.9-21 ro root=/dev/hda6 console=tty0 console=ttyS0,9600n81
   initrd /initrd-2.4.9-21.img
+title Red Hat Linux (2.4.9-21) single user mode
+  lock
+  root (hd0,0)
+  kernel /vmlinuz-2.4.9-21 ro root=/dev/hda6 console=tty0 console=ttyS0,9600n81 s
+  initrd /initrd-2.4.9-21.img
 </programlisting>
    </example> <!-- configure-kernel-grub-rhl-serial -->
 
@@ -2278,8 +2328,7 @@ l systty tty0</programlisting>
 <computeroutput>linux-2.4.x:l systty tty0</computeroutput>
 <prompt>bash#</prompt> <command>vi linux-2.4.x</command>
 </screen>
-
-<programlisting>
+<programlisting format="linespecific">
 l systty ttyS0
 </programlisting>
    </figure>