From nobody@FreeBSD.org  Mon Apr 15 18:25:43 2002
Return-Path: <nobody@FreeBSD.org>
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id B1ACF37B416
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 15 Apr 2002 18:25:42 -0700 (PDT)
Received: (from nobody@localhost)
	by freefall.freebsd.org (8.11.6/8.11.6) id g3G1Pgj17866;
	Mon, 15 Apr 2002 18:25:42 -0700 (PDT)
	(envelope-from nobody)
Message-Id: <200204160125.g3G1Pgj17866@freefall.freebsd.org>
Date: Mon, 15 Apr 2002 18:25:42 -0700 (PDT)
From: Doyle Myers <doylem@mac.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Handbook 15.3 needs mention of 3wire
X-Send-Pr-Version: www-1.0

>Number:         37120
>Category:       docs
>Synopsis:       Handbook 15.3 needs mention of 3wire
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Apr 15 18:30:00 PDT 2002
>Closed-Date:    Thu May 30 01:03:16 PDT 2002
>Last-Modified:  Thu May 30 01:03:16 PDT 2002
>Originator:     Doyle Myers
>Release:        n/a
>Organization:
>Environment:
n/a
>Description:
Chapter 15 of the handbook is generally excellent, but I spent some time unable to connect because my cable didn't support hardware handshaking. A mention that std.38400 assumes modem control signals on the serial port and that changing the entry in /etc/ttys from std.38400 to 3wire.38400 will allow a 3-wire connection to work would have solved the problem more quickly.

>How-To-Repeat:
      
>Fix:
I suggest adding the info above to the end of section 15.3.3.1. Something like:

"If the getty process is running but the terminal still displays no logon prompt, or if it dosplays a prompt but will not allow you to type, your terminal or cable may not support hardware handshaking. Try changing the entry in /etc/ttys from std.38400 to 3wire.38400 remember to kill -HUP 1 after modifying /etc/ttys). The 3wire entry is similar to std, but ignores hardware handshaking. You may need to reduce the baud rate or enable software flow control when using 3wire to prevent buffer overflows."

The example in 15-1 explains that std.38400 ignored parity, so perhaps a note there about using 3wire if you don't have hardware flow control might help.

Otherwise, section 15 is really easy to follow, and got me up and running very quickly. Thanks for the excellent dox.
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: murray 
State-Changed-When: Thu May 30 01:02:50 PDT 2002 
State-Changed-Why:  
I've added your text with just a few minor changes.  The website 
should be updated within 24 hours.  Thanks for the submission! 


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