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

          --- old/usr/src/man/man7d/zcons.7d
          +++ new/usr/src/man/man7d/zcons.7d
   1    1  '\" te
   2    2  .\"  Copyright 2003 Sun Microsystems, Inc. All rights reserved.
   3    3  .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4    4  .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5    5  .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6      -.TH ZCONS 7D "Aug 24, 2003"
   7      -.SH NAME
   8      -zcons \- Zone console device driver
   9      -.SH DESCRIPTION
  10      -.sp
  11      -.LP
  12      -The \fBzcons\fR character driver exports the console for system zones. The
  13      -driver is comprised of two "sides:" a master side with which applications in
  14      -the global zone communicate, and a slave side, which receives I/O from the
  15      -master side. The slave side is available in the global zones.
  16      -.sp
  17      -.LP
  18      -Applications must not depend on the location of \fB/dev\fR or \fB/devices\fR
  19      -entries exported by \fBzcons\fR. Inside a zone, the \fBzcons\fR slave  side is
  20      -fronted by \fB/dev/console\fR and other console-related  symbolic links, which
  21      -are used by applications that expect to write to the system console.
  22      -.sp
  23      -.LP
  24      -The \fBzcons\fR driver is Sun Private, and may change in future releases.
  25      -.SH FILES
  26      -.sp
  27      -.ne 2
  28      -.na
  29      -\fB\fB/dev/zcons/<\fIzonename\fR>/masterconsole\fR \fR
  30      -.ad
  31      -.sp .6
  32      -.RS 4n
  33      -Global zone master side console for zone <\fIzonename\fR>.
  34      -.RE
  35      -
  36      -.sp
  37      -.ne 2
  38      -.na
  39      -\fB\fB/dev/zcons/<\fIzonename\fR>/slaveconsole\fR \fR
  40      -.ad
  41      -.sp .6
  42      -.RS 4n
  43      -Global zone slave side console for zone <\fIzonename\fR>.
  44      -.RE
  45      -
  46      -.sp
  47      -.ne 2
  48      -.na
  49      -\fB\fB/dev/zconsole\fR \fR
  50      -.ad
  51      -.sp .6
  52      -.RS 4n
  53      -Non-global zone console (slave side).
  54      -.RE
  55      -
  56      -.SH ATTRIBUTES
  57      -.sp
  58      -.LP
  59      -See \fBattributes\fR(5) for descriptions of the following attributes:
  60      -.sp
  61      -
  62      -.sp
  63      -.TS
  64      -box;
  65      -c | c
  66      -l | l .
  67      -ATTRIBUTE TYPE  ATTRIBUTE VALUE
  68      -_
  69      - Interface Stability    Sun Private
  70      -.TE
  71      -
  72      -.SH SEE ALSO
  73      -.sp
  74      -.LP
  75      -\fBzoneadm\fR(1M), \fBzonecfg\fR(1M), \fBattributes\fR(5), \fBzones\fR(5)
        6 +.\" Copyright 2022 Oxide Computer Company
        7 +.Dd February 5, 2022
        8 +.Dt ZCONS 7D
        9 +.Os
       10 +.Sh NAME
       11 +.Nm zcons
       12 +.Nd Zone console device driver
       13 +.Sh DESCRIPTION
       14 +The
       15 +.Nm zcons
       16 +character driver exports the console for system zones.
       17 +The driver is fundamentally similar to a pseudo-terminal device, and is thus
       18 +comprised of two sides:
       19 +.Bl -bullet
       20 +.It
       21 +a manager device, which applications in the global zone can open for
       22 +communication
       23 +.It
       24 +a subsidiary device, which processes in the non-global zone can write to, to
       25 +communicate with global zone management applications
       26 +.El
       27 +.Pp
       28 +Applications must not depend on the location of
       29 +.Pa /dev
       30 +or
       31 +.Pa /devices
       32 +entries exposed by
       33 +.Nm zcons
       34 +in the global zone.
       35 +Inside a non-global zone, the
       36 +.Nm zcons
       37 +subsidiary device is fronted by
       38 +.Pa /dev/console
       39 +and other console-related symbolic links, which are used by applications that
       40 +expect to write to the system console.
       41 +.Pp
       42 +The
       43 +.Nm
       44 +driver is not a
       45 +.Sy Committed
       46 +interface, and may change at any time.
       47 +.Sh FILES
       48 +.Bl -tag -width Pa
       49 +.It Pa /dev/zcons/ZONENAME/globalconsole
       50 +Global zone console manager device for zone
       51 +.Sy ZONENAME .
       52 +.It Pa /dev/zcons/ZONENAME/zoneconsole
       53 +Global zone console subsidiary device for zone
       54 +.Sy ZONENAME .
       55 +.It Pa /dev/zconsole
       56 +Non-global zone console (subsidiary device).
       57 +.El
       58 +.Sh INTERFACE STABILITY
       59 +.Sy Uncommitted
       60 +.Sh SEE ALSO
       61 +.Xr zoneadm 1M ,
       62 +.Xr zonecfg 1M ,
       63 +.Xr attributes 5 ,
       64 +.Xr zones 5
    

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX