docs/118490: [patch] add setting required to run GDB over dcons to the man page

[Alexandre Kovalenko]

>Number:         118490
>Category:       docs
>Synopsis:       [patch] add setting required to run GDB over dcons to the man page
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Sat Dec 08 02:20:01 UTC 2007
>Closed-Date:
>Last-Modified:
>Originator:     Alexandre Kovalenko
>Release:        7.0-BETA3
>Organization:
Home
>Environment:
FreeBSD RabbitsDen.RabbitsLawn.verizon.net 7.0-BETA3 FreeBSD 7.0-BETA3 #0: Sat Dec  1 12:05:44 EST 2007     root at RabbitsDen.RabbitsLawn.verizon.net:/usr/obj/usr/src/sys/TPX60  i386
>Description:
Starting with this commit
http://lists.freebsd.org/pipermail/cvs-src/2007-June/079563.html
it is mandatory to set 
dcons_gdb="1" 
in the loader.conf to make dcons the valid GDB port. I have added this fact to the examples portion of the dcons(4) man page.
>How-To-Repeat:

>Fix:


Patch attached with submission follows:

--- share/man/man4/dcons.4.ORIG	2007-12-07 20:56:02.000000000 -0500
+++ share/man/man4/dcons.4	2007-12-07 21:02:29.000000000 -0500
@@ -87,6 +87,16 @@
 dcons	"/usr/libexec/getty std.9600"	vt100	on  secure
 .Ed
 .Pp
+If you want to use 
+.Xr dcons 4
+as 
+.Xr gdb 1
+port, add the following line to your
+.Xr loader.conf 5
+.Bd -literal -offset indent
+dcons_gdb="1"
+.Ed
+.Pp
 Once the
 .Xr fwohci 4
 device is initialized to allow physical access,


>Release-Note:
>Audit-Trail:
>Unformatted: