From nobody@FreeBSD.org  Sat Feb 20 09:32:40 2010
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 57EC21065670
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 20 Feb 2010 09:32:40 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 463E18FC14
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 20 Feb 2010 09:32:40 +0000 (UTC)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o1K9Wend035749
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 20 Feb 2010 09:32:40 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id o1K9WdNx035748;
	Sat, 20 Feb 2010 09:32:39 GMT
	(envelope-from nobody)
Message-Id: <201002200932.o1K9WdNx035748@www.freebsd.org>
Date: Sat, 20 Feb 2010 09:32:39 GMT
From: "G. Paul Ziemba" <p-fbsd-bugs@ziemba.us>
To: freebsd-gnats-submit@FreeBSD.org
Subject: termios(4) man page wrongly claims CCTS_OFLOW/CRTSCTS is unused
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         144127
>Category:       docs
>Synopsis:       termios(4) man page wrongly claims CCTS_OFLOW/CRTSCTS is unused
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    ed
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Feb 20 09:40:01 UTC 2010
>Closed-Date:    
>Last-Modified:  Mon Jun 10 14:00:00 UTC 2013
>Originator:     G. Paul Ziemba
>Release:        8.X
>Organization:
>Environment:
FreeBSD foo.ziemba.us 8.0-STABLE FreeBSD 8.0-STABLE #2: Fri Dec 11 16:36:37 PST 2009     root@hairball:/usr/obj/usr/src/sys/GPZ-091127  i386
>Description:
termios(4) says:
"The CCTS_OFLOW (CRTSCTS) flag is currently unused."

Yet code in /usr/src/sys/dev/uart/uart_tty.c references CCTS_OFLOW and as far as I know, it works. Hasn't it worked forever?
>How-To-Repeat:

>Fix:
Proposed replacement text:

    If CCTS_OFLOW (CRTSCTS) is set, transmission is stopped when CTS is lowered and resumed when CTS is raised.

Maybe similar treatment is warranted for CRTS_IFLOW?

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->ed 
Responsible-Changed-By: ed 
Responsible-Changed-When: Wed Feb 24 21:35:47 UTC 2010 
Responsible-Changed-Why:  
I am Mr. TTY. 

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

From: r4721@tormail.org
To: bug-followup@freebsd.org
Cc:  
Subject: Re: docs/144127: termios(4) man page wrongly claims
 CCTS_OFLOW/CRTSCTS is unused
Date: Mon, 10 Jun 2013 13:53:31 -0000

 ------=_20130610135331_39180
 Content-Type: text/plain; charset="iso-8859-1"
 Content-Transfer-Encoding: 8bit
 
 patch to fix this.
 
 * change CRTSCTS to show it is the same as CCTS_OFLOW|CRTS_IFLOW
 * remove text saying CRTSCTS is unused. it is used and works
 * add missing flow control pin configurations
 * change definition of MDMBUF to show it is an alias of CCAR_OFLOW
 * remove MDMBUF text in line with other flow control pins
 ------=_20130610135331_39180
 Content-Type: text/plain; name="termios.txt"
 Content-Transfer-Encoding: 8bit
 Content-Disposition: attachment; filename="termios.txt"
 
 Index: share/man/man4/termios.4
 ===================================================================
 --- share/man/man4/termios.4	(revision 251518)
 +++ share/man/man4/termios.4	(working copy)
 @@ -1182,13 +1182,29 @@
  .Dv CTS
  flow control of output */
  .It Dv CRTSCTS
 -/* same as
 +/* both
  .Dv CCTS_OFLOW
 +and
 +.Dv CRTS_IFLOW
  */
  .It Dv CRTS_IFLOW
  /* RTS flow control of input */
 +.It Dv CDTR_IFLOW
 +/*
 +.Dv DTR
 +flow control of input */
 +.It Dv CDSR_OFLOW
 +/*
 +.Dv DSR
 +flow control of output */
 +.It Dv CCAR_OFLOW
 +/*
 +.Dv DCD
 +flow control of output */
  .It Dv MDMBUF
 -/* flow control output via Carrier */
 +/* alias of
 +.Dv CCAR_OFLOW
 +*/
  .El
  .Pp
  The
 @@ -1261,16 +1277,6 @@
  function returns
  immediately without waiting for the connection.
  .Pp
 -The
 -.Dv CCTS_OFLOW
 -.Pf ( Dv CRTSCTS )
 -flag is currently unused.
 -.Pp
 -If
 -.Dv MDMBUF
 -is set then output flow control is controlled by the state
 -of Carrier Detect.
 -.Pp
  If the object for which the control modes are set is not an asynchronous
  serial connection, some of the modes may be ignored; for example, if an
  attempt is made to set the baud rate on a network connection to a
 ------=_20130610135331_39180--
 
 
>Unformatted:
