[Bug 210903] Section 25.6 (Setting up the serial console) of the Handbook has some errors and omissions

[bugzilla-noreply at freebsd.org]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=210903

            Bug ID: 210903
           Summary: Section 25.6 (Setting up the serial console) of the
                    Handbook has some errors and omissions
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Many People
          Priority: ---
         Component: Documentation
          Assignee: freebsd-doc at FreeBSD.org
          Reporter: fmatthew5876 at gmail.com

(1) In section 25.6.3: 

For the bootloader, one can use the flag -S115200 in /boot.config to set the
speed instead of recompiling.

(2) In section 25.6.3:

The listed set of commands to rebuild the bootloader failed to work on new
install of FreeBSD 10.3. I had to do the following:

cd /usr/src/sys/boot
MKOBJDIRPREFIX=/usr/obj make obj depend all
MKOBJDIRPREFIX=/usr/obj make install

I'm not terribly familiar with the ins and outs of the world makefiles so maybe
there is a better way than this. Regardless, the instructions in the handbook
are wrong and result in a build failure.

(3) It would be helpful to add a subsection on how to use a different serial
port such as COM2.

The steps I figured out to do this are:

1. Search dmesg for the port number of the desired serial port (0x2f8 for COM2
usuallt)
2. Bootloader: Rebuild with BOOT_COMCONSOLE_PORT=0x2f8. There does not appear
to be a command line option for this in /boot.config.
3. Console: Recompile loader with BOOT_COMCONSOLE_PORT=0x2f8 or specify
comconsole_port=0x2f8 in /boot/loader.conf
4. Login: Enable the console for /dev/ttyu1 in /etc/ttys

-- 
You are receiving this mail because:
You are the assignee for the bug.