patch-2.4.0-test2 linux/Documentation/serial-console.txt

Next file: linux/Documentation/sound/Maestro
Previous file: linux/Documentation/powerpc/SBC8260_memory_mapping.txt
Back to the patch index
Back to the overall index

diff -u --recursive --new-file v2.4.0-test1/linux/Documentation/serial-console.txt linux/Documentation/serial-console.txt
@@ -1,5 +1,10 @@
                        Linux Serial Console
 
+To use a serial port as console you need to compile the support into your
+kernel - by default it is not compiled in. For PC style serial ports
+it's the config option next to "Standard/generic (dumb) serial support".
+You must compile serial support into the kernel and not as a module.
+
 It is possible to specify multiple devices for console output. You can
 define a new kernel command line option to select which device(s) to
 use for console output.
@@ -62,14 +67,20 @@
 
    append = "console=ttyS1,9600" 
 
-4. Init and /etc/ioctl.save
+4. Make sure a getty runs on the serial port so that you can login to
+   it once the system is done booting. This is done by adding a line
+   like this to /etc/inittab (exact syntax depends on your getty):
+
+   S1:23:respawn:/sbin/getty -L ttyS1 9600 vt100
+
+5. Init and /etc/ioctl.save
 
    Sysvinit remembers its stty settings in a file in /etc, called
    `/etc/ioctl.save'. REMOVE THIS FILE before using the serial
    console for the first time, because otherwise init will probably
    set the baudrate to 38400 (baudrate of the virtual console).
 
-5. /dev/console and X
+6. /dev/console and X
    Programs that want to do something with the virtual console usually
    open /dev/console. If you have created the new /dev/console device,
    and your console is NOT the virtual console some programs will fail.
@@ -78,18 +89,16 @@
 
    Xfree86, svgalib, gpm, SVGATextMode
 
-   I have binary patched the above mentioned programs to use "tty0"
-   instead of "console".  This will be reported to the maintainers of
-   said programs.
+   It should be fixed in modern versions of these programs though.
 
    Note that if you boot without a console= option (or with
    console=/dev/tty0), /dev/console is the same as /dev/tty0. In that
    case everything will still work.
 
-6. Thanks
+7. Thanks
 
    Thanks to Geert Uytterhoeven <geert@linux-m68k.org>
    for porting the patches from 2.1.4x to 2.1.6x for taking care of
    the integration of these patches into m68k, ppc and alpha.
 
-Miquel van Smoorenburg <miquels@cistron.nl>, 21-Mar-1998
+Miquel van Smoorenburg <miquels@cistron.nl>, 11-Jun-2000

FUNET's LINUX-ADM group, linux-adm@nic.funet.fi
TCL-scripts by Sam Shen (who was at: slshen@lbl.gov)