From nobody@FreeBSD.org  Wed Aug  2 16:52:48 2006
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 9D0D016A4DE
	for <freebsd-gnats-submit@FreeBSD.org>; Wed,  2 Aug 2006 16:52:48 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 4DE3243D45
	for <freebsd-gnats-submit@FreeBSD.org>; Wed,  2 Aug 2006 16:52:46 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.13.1/8.13.1) with ESMTP id k72GqksQ005901
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 2 Aug 2006 16:52:46 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.13.1/8.13.1/Submit) id k72GqkIl005899;
	Wed, 2 Aug 2006 16:52:46 GMT
	(envelope-from nobody)
Message-Id: <200608021652.k72GqkIl005899@www.freebsd.org>
Date: Wed, 2 Aug 2006 16:52:46 GMT
From: Jo Rhett <jrhett@svcolo.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: serial console documentation implies kernel rebuild required -- doesn't mention device hints
X-Send-Pr-Version: www-2.3

>Number:         101271
>Category:       docs
>Synopsis:       serial console documentation implies kernel rebuild required -- doesn't mention device hints
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    dru
>State:          closed
>Quarter:        
>Keywords:       handbook
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Aug 02 17:00:32 GMT 2006
>Closed-Date:    Thu May 08 16:10:50 UTC 2014
>Last-Modified:  Thu May 08 16:10:50 UTC 2014
>Originator:     Jo Rhett
>Release:        6.0-REL
>Organization:
svcolo
>Environment:
irrelevant
>Description:
The following page has sent me spinning down some irrelevant roads. 

http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/serialconsole-setup.html

In particular, you can control which serial port has the 0x10 flags from device hints.  It's not clear to me if recompiling is required for the boot loader or not, but it's not required for the main console after high-level sio is enabled.

I believe the page is simply out of date and needs to be updated for modern versions.

>How-To-Repeat:

>Fix:
Please

1. Update to indicate what can be handled with device hints instead of recompiling

2. Mention that sio ports are often assigned in the order presented, so sio0 isn't always 0x3f8 and thus you'll need to move the 0x10 flags.

See i386/100831
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->remko 
Responsible-Changed-By: remko 
Responsible-Changed-When: Fri Oct 13 07:40:57 UTC 2006 
Responsible-Changed-Why:  
I will be working on the serial console section anytime now, drag this 
along. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=101271 

From: David Adam <zanchey@ucc.gu.uwa.edu.au>
To: bug-followup@FreeBSD.org, jrhett@svcolo.com
Cc:  
Subject: Re: docs/101271: serial console documentation implies kernel rebuild
 required -- doesn't mention device hints
Date: Sat, 19 Jul 2008 19:00:17 +0800 (WST)

 Remko,
 
 I understand that you'd like to fix this in the context of a larger 
 chapter rework, but I've also just spent a little time wondering why these 
 instructions fail before realising that they're out of date.
 
 How about a quick fix in the meantime: replace step 3 on adding hints to 
 the kernel config with:
 
 """
 3. Edit the /boot/device.hints file. Remove the line
 hint.sio.0.flags="0x10"
 and instead add the flags to the appropriate line for your serial console. 
 For example, if you want to make sio1 (COM2) the console, add the line:
 hint.sio.1.flags="0x10"
 """
 
 and remove step 5 ("Rebuild and reinstall the kernel").
 
 This will correct the inaccuracies in the short term until the chapter is 
 reviewed.
 
 Thanks,
 
 David Adam
 zanchey@ucc.gu.uwa.edu.au
 
Responsible-Changed-From-To: remko->freebsd-doc 
Responsible-Changed-By: remko 
Responsible-Changed-When: Thu Sep 27 07:43:24 UTC 2012 
Responsible-Changed-Why:  
I see that I cannot do this in reasonable time, reassign to the pool 

http://www.freebsd.org/cgi/query-pr.cgi?pr=101271 
Responsible-Changed-From-To: freebsd-doc->dru 
Responsible-Changed-By: dru 
Responsible-Changed-When: Thu May 8 16:09:59 UTC 2014 
Responsible-Changed-Why:  
I'll take 

http://www.freebsd.org/cgi/query-pr.cgi?pr=101271 
State-Changed-From-To: open->closed 
State-Changed-By: dru 
State-Changed-When: Thu May 8 16:10:23 UTC 2014 
State-Changed-Why:  
Addressed in r44793. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=101271 
>Unformatted:
