Bug 66117

Summary: Handbook Serial Console Page doesn't list how to recompile boot blocks.
Product: Documentation Reporter: Jamin Brown <alec>
Component: Books & ArticlesAssignee: Giorgos Keramidas <keramida>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Jamin Brown 2004-04-30 19:30:17 UTC 
Neither the pages at http://www.freebsd.org/doc/handbook/serialconsole-setup.html nor http://www.freebsd.org/doc/handbook/boot-blocks.html detail how to recompile boot blocks for when an option like BOOT_COMCONSOLE_SPEED is updated in make.conf

Fix: 

Add documentation that explains that:

cd /usr/src/sys/boot/i386/boot2
make clean
make all install

are needed before 'disklabel -B diskslice' if you are trying to compile boot blocks with custom settings like an updated COM_CONSOLE_SPEED.
Comment 1 Ceri Davies 2004-04-30 19:37:14 UTC 
On Fri, Apr 30, 2004 at 11:25:26AM -0700, Jamin Brown wrote:
> >Fix:
> Add documentation that explains that:
> 
> cd /usr/src/sys/boot/i386/boot2
> make clean
> make all install
> 
> are needed before 'disklabel -B diskslice' if you are trying to compile boot blocks with custom settings like an updated COM_CONSOLE_SPEED.

It should also be noted that the "-o packet" option is required
if you have a "large" disk.

Ceri

--
Comment 2 Giorgos Keramidas freebsd_committer freebsd_triage 2004-07-07 23:27:33 UTC 
> Add documentation that explains that:
>
> cd /usr/src/sys/boot/i386/boot2
> make clean
> make all install

There is documentation about doing exactly this thing a few lines below.
Is a cross-reference ok (to avoid repeating things)?

%%
Index: chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml,v
retrieving revision 1.88
diff -u -r1.88 chapter.sgml
--- chapter.sgml	6 Jun 2004 18:17:07 -0000	1.88
+++ chapter.sgml	7 Jul 2004 22:21:55 -0000
@@ -2442,7 +2442,12 @@
 	  blocks:</para>
 
 	<programlisting>BOOT_COMCONSOLE_SPEED=19200</programlisting>
-  
+
+	<para>Changing <makevar>BOOT_COMCONSOLE_SPEED</makevar> in
+	  <filename>make.conf</filename> might require building and
+	  installing new boot blocks.
+	  See <xref linkend="serialconsole-com2"> for details.</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
%%
Comment 3 Giorgos Keramidas freebsd_committer freebsd_triage 2004-07-08 06:28:05 UTC 
State Changed
From-To: open->closed

Committed the <xref> patch.  Thanks!
Comment 4 Giorgos Keramidas freebsd_committer freebsd_triage 2004-07-08 06:28:05 UTC 
Responsible Changed
From-To: freebsd-doc->keramida