Expand the section `Setting a Faster Serial Port Speed', to mention

ways to set the serial console speed without having to rebuild the
boot blocks.  Note that for releases before 6.1, though, rebuilding
the boot blocks may be the only option.

PR:		docs/100903
Submitted by:	Martin Jackson <mhjacks@swbell.net>
Reviewed by:	remko
This commit is contained in:
Giorgos Keramidas 2006-08-23 23:37:19 +00:00
parent 5ed4cb10b2
commit dca1abbc7f
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=28524

View file

@ -2625,23 +2625,61 @@ boot:</screen>
<title>Setting a Faster Serial Port Speed</title>
<para>By default, the serial port settings are: 9600 baud, 8
bits, no parity, and 1 stop bit. If you wish to change the speed, you
need to recompile at least the boot blocks. Add the following line
to <filename>/etc/make.conf</filename> and compile new boot
blocks:</para>
bits, no parity, and 1 stop bit. If you wish to change the default
console speed, you have the following options:</para>
<programlisting>BOOT_COMCONSOLE_SPEED=19200</programlisting>
<itemizedlist>
<listitem>
<para>Recompile the boot blocks
with <makevar>BOOT_COMCONSOLE_SPEED</makevar> set to the new
console speed. See <xref linkend="serialconsole-com2"> for
detailed instructions about building and installing new boot
blocks.</para>
<para>See <xref linkend="serialconsole-com2"> for detailed
instructions about building and installing new boot blocks.</para>
<para>If the serial console is configured in some other way than
by booting with <option>-h</option>, or if the serial console
used by the kernel is different from the one used by the boot
blocks, then you must also add the following option to the
kernel configuration file and compile a new kernel:</para>
<para>If the serial console is configured in some other way than by
booting with <option>-h</option>, or if the serial console used by
the kernel is different from the one used by the boot blocks, then
you must also add the following option to the kernel configuration
file and compile a new kernel:</para>
<programlisting>options CONSPEED=19200</programlisting>
</listitem>
<programlisting>options CONSPEED=19200</programlisting>
<listitem>
<para>Use the <option>-S</option> boot option of the kernel.
The <option>-S</option> command line option can be added
to <filename>/boot.config</filename>. See the &man.boot.8;
manual page for a description of how to add options
to <filename>/boot.config</filename> and a list of the supported
options.</para>
</listitem>
<listitem>
<para>Enable the options <varname>comconsole_speed</varname>
option in your <filename>/boot/loader.conf</filename>
file.</para>
<para>This option depends on <varname>console</varname>,
<varname>boot_serial</varname>, and
<varname>boot_multicons</varname> being set in
<filename>/boot/loader.conf</filename> too. An example of using
<varname>comconsole_speed</varname> to change the serial console
speed is:</para>
<programlisting>boot_multicons="YES"
boot_serial="YES"
comconsole_speed="115200"
console="comconsole,vidconsole"</programlisting>
</listitem>
</itemizedlist>
<note>
<para>&os; versions before 6.1-RELEASE do not support the
<option>-S</option> or the <varname>comconsole_speed</varname>
option in <filename>/boot/loader.conf</filename>, so you will have
to recompile the boot blocks if you are using such a version of
&os;.</para>
</note>
</sect3>
<sect3 id="serialconsole-com2">