SERIAL-CONSOLE(1)

NAME
serial-console

SYNOPSIS
serial-console [options]

Options:

    -h,--help         Display brief help message
    -v,--verbose      Increase verbosity
    -q,--quiet        Decrease verbosity
    -l,--log FILE     Log output to file
    -r,--rcfile FILE  Modify specified bochsrc file

DESCRIPTION
"serial-console" provides a virtual serial console for use with Bochs. Running "serial-console" creates a pseudo-tty. The master side of this pty is made available to the user for interaction; the slave device is written to the Bochs configuration file ("bochsrc.txt") for use by a subsequent Bochs session.

EXAMPLES

"serial-console"
    Create a virtual serial console for Bochs, modify "bochsrc.txt" appropriately.

"serial-console -r ../.bochsrc -l serial.log"
    Create a virtual serial console for Bochs, modify "../.bochsrc" appropriately, log output to "serial.log".

INVOCATION
Before starting Bochs, run "serial-console" in a different session (e.g. a different xterm window). When you subsequently start Bochs, anything that the emulated machine writes to its serial port will appear in the window running "serial-console", and anything typed in the "serial-console" window will arrive on the emulated machine's serial port.

You do not need to rerun "serial-console" afresh for each Bochs session.

OPTIONS

-l,--log FILE
    Log all output (i.e. everything that is printed in the "serial-console" window) to the specified file.

-r,--rcfile FILE
    Modify the specified bochsrc file. The file will be updated to contain the path to the slave side of the psuedo tty that we create. The original file will be restored when "serial-console" exits. The default is to modify the file "bochsrc.txt" in the current directory.

    To avoid modifying any bochsrc file, use "--norcfile".