summaryrefslogtreecommitdiffstats
path: root/share
diff options
context:
space:
mode:
authored <ed@FreeBSD.org>2009-09-06 10:27:45 +0000
committered <ed@FreeBSD.org>2009-09-06 10:27:45 +0000
commit73faea23017b4ce65aa723109ce740c5dacc3dc1 (patch)
tree6d9a466863179e420214ce35c14f77dc63cfd4c0 /share
parentd8177c84337105c433440a5aa9dada5bf71e0d65 (diff)
downloadFreeBSD-src-73faea23017b4ce65aa723109ce740c5dacc3dc1.zip
FreeBSD-src-73faea23017b4ce65aa723109ce740c5dacc3dc1.tar.gz
Move ptmx into pty(4).
Now that pty(4) is a loadable kernel module, I'd better move /dev/ptmx in there as well. This means that pty(4) now provides almost all pseudo-terminal compatibility code. This means it's very easy to test whether applications use the proper library interfaces when allocating pseudo-terminals (namely posix_openpt and openpty).
Diffstat (limited to 'share')
-rw-r--r--share/man/man4/pts.49
-rw-r--r--share/man/man4/pty.413
2 files changed, 11 insertions, 11 deletions
diff --git a/share/man/man4/pts.4 b/share/man/man4/pts.4
index dc13a90..d0e8832 100644
--- a/share/man/man4/pts.4
+++ b/share/man/man4/pts.4
@@ -147,15 +147,6 @@ The files used by this
pseudo-terminals implementation are:
.Pp
.Bl -tag -width ".Pa /dev/pts/[num]"
-.It Pa /dev/ptmx
-Control device, returns a file descriptor to a new master
-pseudo-terminal when opened.
-This device should not be opened directly.
-It's only available for binary compatibility.
-New devices should only be allocated with
-.Xr posix_openpt 2
-and
-.Xr openpty 3 .
.It Pa /dev/pts/[num]
Pseudo-terminal slave devices.
.El
diff --git a/share/man/man4/pty.4 b/share/man/man4/pty.4
index 515f912..f72a8be 100644
--- a/share/man/man4/pty.4
+++ b/share/man/man4/pty.4
@@ -32,7 +32,7 @@
.Os
.Sh NAME
.Nm pty
-.Nd BSD-style compatibility pseudo-terminal driver
+.Nd BSD-style and System V-style compatibility pseudo-terminal driver
.Sh SYNOPSIS
.Cd "device pty"
.Sh DESCRIPTION
@@ -48,6 +48,12 @@ driver.
A device node for this terminal shall be created, which has the name
.Pa /dev/ttyXX .
.Pp
+The
+.Nm
+driver also provides a cloning System V
+.Pa /dev/ptmx
+device.
+.Pp
New code should not try to allocate pseudo-terminals using this
interface.
It is only provided for compatibility with older C libraries
@@ -63,6 +69,9 @@ device names:
Pseudo-terminal master devices.
.It Pa /dev/tty[l-sL-S][0-9a-v]
Pseudo-terminal slave devices.
+.It Pa /dev/ptmx
+Control device, returns a file descriptor to a new master
+pseudo-terminal when opened.
.El
.Sh DIAGNOSTICS
None.
@@ -75,7 +84,7 @@ A
pseudo-terminal driver appeared in
.Bx 4.2 .
.Sh BUGS
-Unlike previous implementations, the master slave device nodes are
+Unlike previous implementations, the master and slave device nodes are
destroyed when the PTY becomes unused.
A call to
.Xr stat 2
OpenPOWER on IntegriCloud