Print this page
14249 pseudo-terminal nomenclature should reflect POSIX
Change-Id: Ib4a3cef899ff4c71b09cb0dc6878863c5e8357bc

@@ -3,52 +3,41 @@
 NAME
        zcons - Zone console device driver
 
 DESCRIPTION
        The zcons character driver exports the console for system zones. The
-       driver is comprised of two "sides:" a master side with which
-       applications in the global zone communicate, and a slave side, which
-       receives I/O from the master side. The slave side is available in the
-       global zones.
+     driver is fundamentally similar to a pseudo-terminal device, and is thus
+     comprised of two sides:
 
+     o   a manager device, which applications in the global zone can open for
+         communication
 
-       Applications must not depend on the location of /dev or /devices
-       entries exported by zcons. Inside a zone, the zcons slave  side is
-       fronted by /dev/console and other console-related  symbolic links,
-       which are used by applications that expect to write to the system
-       console.
+     o   a subsidiary device, which processes in the non-global zone can write
+         to, to communicate with global zone management applications
 
+     Applications must not depend on the location of /dev or /devices entries
+     exposed by zcons in the global zone.  Inside a non-global zone, the zcons
+     subsidiary device is fronted by /dev/console and other console-related
+     symbolic links, which are used by applications that expect to write to
+     the system console.
 
-       The zcons driver is Sun Private, and may change in future releases.
+     The zcons driver is not a Committed interface, and may change at any
+     time.
 
 FILES
-       /dev/zcons/<zonename>/masterconsole
+     /dev/zcons/ZONENAME/globalconsole
+                                       Global zone console manager device for
+                                       zone ZONENAME.
 
-           Global zone master side console for zone <zonename>.
+     /dev/zcons/ZONENAME/zoneconsole   Global zone console subsidiary device
+                                       for zone ZONENAME.
 
+     /dev/zconsole                     Non-global zone console (subsidiary
+                                       device).
 
-       /dev/zcons/<zonename>/slaveconsole
+INTERFACE STABILITY
+     Uncommitted
 
-           Global zone slave side console for zone <zonename>.
-
-
-       /dev/zconsole
-
-           Non-global zone console (slave side).
-
-
-ATTRIBUTES
-       See attributes(5) for descriptions of the following attributes:
-
-
-
-
-       +---------------------+-----------------+
-       |   ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
-       +---------------------+-----------------+
-       | Interface Stability | Sun Private     |
-       +---------------------+-----------------+
-
 SEE ALSO
        zoneadm(1M), zonecfg(1M), attributes(5), zones(5)
 
-                                August 24, 2003                      ZCONS(7D)
+illumos                        February 5, 2022                        illumos