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

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man7d/zcons.7d.man.txt
          +++ new/usr/src/man/man7d/zcons.7d.man.txt
   1    1  ZCONS(7D)                           Devices                          ZCONS(7D)
   2    2  
   3    3  NAME
   4      -       zcons - Zone console device driver
        4 +     zcons - Zone console device driver
   5    5  
   6    6  DESCRIPTION
   7      -       The zcons character driver exports the console for system zones. The
   8      -       driver is comprised of two "sides:" a master side with which
   9      -       applications in the global zone communicate, and a slave side, which
  10      -       receives I/O from the master side. The slave side is available in the
  11      -       global zones.
        7 +     The zcons character driver exports the console for system zones.  The
        8 +     driver is fundamentally similar to a pseudo-terminal device, and is thus
        9 +     comprised of two sides:
  12   10  
       11 +     o   a manager device, which applications in the global zone can open for
       12 +         communication
  13   13  
  14      -       Applications must not depend on the location of /dev or /devices
  15      -       entries exported by zcons. Inside a zone, the zcons slave  side is
  16      -       fronted by /dev/console and other console-related  symbolic links,
  17      -       which are used by applications that expect to write to the system
  18      -       console.
       14 +     o   a subsidiary device, which processes in the non-global zone can write
       15 +         to, to communicate with global zone management applications
  19   16  
       17 +     Applications must not depend on the location of /dev or /devices entries
       18 +     exposed by zcons in the global zone.  Inside a non-global zone, the zcons
       19 +     subsidiary device is fronted by /dev/console and other console-related
       20 +     symbolic links, which are used by applications that expect to write to
       21 +     the system console.
  20   22  
  21      -       The zcons driver is Sun Private, and may change in future releases.
       23 +     The zcons driver is not a Committed interface, and may change at any
       24 +     time.
  22   25  
  23   26  FILES
  24      -       /dev/zcons/<zonename>/masterconsole
       27 +     /dev/zcons/ZONENAME/globalconsole
       28 +                                       Global zone console manager device for
       29 +                                       zone ZONENAME.
  25   30  
  26      -           Global zone master side console for zone <zonename>.
       31 +     /dev/zcons/ZONENAME/zoneconsole   Global zone console subsidiary device
       32 +                                       for zone ZONENAME.
  27   33  
       34 +     /dev/zconsole                     Non-global zone console (subsidiary
       35 +                                       device).
  28   36  
  29      -       /dev/zcons/<zonename>/slaveconsole
       37 +INTERFACE STABILITY
       38 +     Uncommitted
  30   39  
  31      -           Global zone slave side console for zone <zonename>.
  32      -
  33      -
  34      -       /dev/zconsole
  35      -
  36      -           Non-global zone console (slave side).
  37      -
  38      -
  39      -ATTRIBUTES
  40      -       See attributes(5) for descriptions of the following attributes:
  41      -
  42      -
  43      -
  44      -
  45      -       +---------------------+-----------------+
  46      -       |   ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
  47      -       +---------------------+-----------------+
  48      -       | Interface Stability | Sun Private     |
  49      -       +---------------------+-----------------+
  50      -
  51   40  SEE ALSO
  52      -       zoneadm(1M), zonecfg(1M), attributes(5), zones(5)
       41 +     zoneadm(1M), zonecfg(1M), attributes(5), zones(5)
  53   42  
  54      -                                August 24, 2003                      ZCONS(7D)
       43 +illumos                        February 5, 2022                        illumos
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX