From nobody Sun Dec 14 22:13:20 2025 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4dTyBS3vnPz6KwVN for ; Sun, 14 Dec 2025 22:13:20 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4dTyBS1Xf5z3f3g for ; Sun, 14 Dec 2025 22:13:20 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1765750400; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=QRCVjuQTrK4VyYGWWkbkwL3ga3clR8Ku8LWUuNOKE1E=; b=tl3rn/KiGo/lq5HdBALbgFEY6JnYL/Pb4KVjF/8cu1rlY+cTSiYLcxW3ihCgSUvdjGnd5Y ksfhvr1a04pCiSUFuF3D2kNCeRDZsDS6B30oW4HcCkkbx5t6e4fEVXC1whtQtDkFI6kxF3 HCQx/PTY6L5PJNYmGDwe1k0yAMOOaqUKvsHH2oIaCmLgzDRNiJ/WCIgSoAy2pUKhtcFcx4 TTdfl5V+eWKTQJBXPTb4c4jRW2R5x4YWE1M9lZFQs3j/kox6wguVyjSUX+yq8ACM3DHeH2 U9qXex+u+yfWTkpV6utiSjq/+GuveD5ixkUuNYbWwkeCJZPPDwWNhJpGGagusg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1765750400; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=QRCVjuQTrK4VyYGWWkbkwL3ga3clR8Ku8LWUuNOKE1E=; b=oSqEeCqeR4JbCvDqTX5mDTddYJsc1/hP2369JgirZxl+zY0O0BEydbgKQ9Ea0prLuUHNdp uXs9QlYaj8xgeSA1HElQzKHssKEOBKjpvxXiklcBjVWi9YAFKuXeCYkWLSr7J4uS8lK3Ng v/K+Gm3G5182r2Q8AN539/K0CtTCVBUNkTFZ4OA698XtSNRmYH2LnnX119Xyfo5adgrmjK McX2E/HFVOt+QlBta///BNxlM7mG5dpufTgpNcyO2dTAkZewZzUJB73otn4RxUhKLV5a1r w9XSuraEVVb24s1bqvzCtHsNZXB2fh/NDofDeEQ3iFiI+g2ljXcY8QttWnJncQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1765750400; a=rsa-sha256; cv=none; b=FiIAyrHn+Lig0LGJMtQSAIIv39EmvW5TYkn3lnKNDStI1IUZW55Mbw6kPu2zeeEqyMVNiT vi2AKSHD8zfG2khWQoW5t4hOzkBFHItFQ2m4PoLwwDa62krJNNHw+u1zzVsImFHHl+qNqx sW/fxemXziCQq3Rph0CHOovuAo+St2L9OdbI+/O49Qkzv+79UKiLGyWcIOdq2OMjJq4Ugp cYg30X1r8YHVmultwTyYk2t1a7mfABDtKQdYyXY19GTWiVbP7K02WcRqhuZ7yA+H+zqjaF Wv/LZeiirVFZOpM9dggtznDJe/1vq/IGFC+LBYqdYvxJbL+41a+v1PEEOtAJ4g== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4dTyBS0m2fzsht for ; Sun, 14 Dec 2025 22:13:20 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 3fd56 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Sun, 14 Dec 2025 22:13:20 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Poul-Henning Kamp Subject: git: edd982b95372 - main - Cross-reference all of uart(4), tty(4) and termios(4) List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: phk X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: edd982b95372bee56de4bfe3a61873a8fed254ae Auto-Submitted: auto-generated Date: Sun, 14 Dec 2025 22:13:20 +0000 Message-Id: <693f3680.3fd56.52521b89@gitrepo.freebsd.org> The branch main has been updated by phk: URL: https://cgit.FreeBSD.org/src/commit/?id=edd982b95372bee56de4bfe3a61873a8fed254ae commit edd982b95372bee56de4bfe3a61873a8fed254ae Author: Poul-Henning Kamp AuthorDate: 2025-12-14 22:09:48 +0000 Commit: Poul-Henning Kamp CommitDate: 2025-12-14 22:09:48 +0000 Cross-reference all of uart(4), tty(4) and termios(4) Add a BUGS subsection about why, in the vain hope that somebody improves the situation. --- share/man/man4/Makefile | 1 + share/man/man4/termios.4 | 11 +++++++++++ share/man/man4/tty.4 | 16 +++++++++++++--- share/man/man4/uart.4 | 12 ++++++++++++ 4 files changed, 37 insertions(+), 3 deletions(-) diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile index 4084fa55dc69..8cf4a06ea9bb 100644 --- a/share/man/man4/Makefile +++ b/share/man/man4/Makefile @@ -809,6 +809,7 @@ MLINKS+=tap.4 if_tap.4 \ tap.4 if_vmnet.4 MLINKS+=tdfx.4 tdfx_linux.4 MLINKS+=ti.4 if_ti.4 +MLINKS+=tty.4 cua.4 MLINKS+=tun.4 if_tun.4 MLINKS+=ure.4 if_ure.4 MLINKS+=vge.4 if_vge.4 diff --git a/share/man/man4/termios.4 b/share/man/man4/termios.4 index 08b0b81126c3..3d99130c8d33 100644 --- a/share/man/man4/termios.4 +++ b/share/man/man4/termios.4 @@ -1594,4 +1594,15 @@ the values in the header .Xr tcsetattr 3 , .Xr tcsetsid 3 , .Xr tty 4 , +.Xr uart 4 , .Xr stack 9 +.Sh BUGS +Before the Internet, serial ports were primarily used for inbound +connections from terminals, either directly or through modems, these +days serial ports are primarily used for outbound connections to +devices, an evolution which unfortunately has spread the relevant +documentation over three different manual pages: +.Xr termios 4 , +.Xr uart 4 and +.Xr tty 4 . + diff --git a/share/man/man4/tty.4 b/share/man/man4/tty.4 index caa31835a331..ec93ff440855 100644 --- a/share/man/man4/tty.4 +++ b/share/man/man4/tty.4 @@ -37,9 +37,9 @@ This section describes the interface to the terminal drivers in the system. .Ss Terminal Special Files -Each hardware terminal port on the system usually has a terminal special device -file associated with it in the directory ``/dev/'' (for -example, ``/dev/tty03''). +Each hardware terminal port on the system has several terminal special device +files associated with it in the directory ``/dev/'' (for +example, ``/dev/tty03'' and ``/dev/cua03''). When a user logs into the system on one of these hardware terminal ports, the system has already opened the associated device and prepared the line for normal interactive @@ -375,6 +375,7 @@ variables. .Xr pts 4 , .Xr pty 4 , .Xr termios 4 , +.Xr uart 4 , .Xr getty 8 .Sh HISTORY A console typewriter device @@ -383,3 +384,12 @@ and asynchronous communication interfaces .Pa /dev/tty[0-5] first appeared in .At v1 . +.Sh BUGS +Before the Internet, serial ports were primarily used for inbound +connections from terminals, either directly or through modems, these +days serial ports are primarily used for outbound connections to +devices, an evolution which unfortunately has spread the relevant +documentation over three different manual pages: +.Xr termios 4 , +.Xr uart 4 and +.Xr tty 4 . diff --git a/share/man/man4/uart.4 b/share/man/man4/uart.4 index 98b61886371d..f0b6b23b53d2 100644 --- a/share/man/man4/uart.4 +++ b/share/man/man4/uart.4 @@ -377,6 +377,8 @@ COM2 instead of COM1 and set the baud rate to 115200. .Xr cu 1 , .Xr puc 4 , .Xr scc 4 , +.Xr termios 4 , +.Xr tty 4 , .Xr ttys 5 .\" .Sh HISTORY @@ -389,3 +391,13 @@ The .Nm device driver and this manual page were written by .An Marcel Moolenaar Aq Mt marcel@xcllnt.net . +.Sh BUGS +Before the Internet, serial ports were primarily used for inbound +connections from terminals, either directly or through modems, these +days serial ports are primarily used for outbound connections to +devices, an evolution which unfortunately has spread the relevant +documentation over three different manual pages: +.Xr termios 4 , +.Xr uart 4 and +.Xr tty 4 . +