1*bbf21555SRichard Lowe'\" te 2*bbf21555SRichard Lowe.\" Copyright 2003 Sun Microsystems, Inc. All rights reserved. 3*bbf21555SRichard Lowe.\" 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*bbf21555SRichard Lowe.\" 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*bbf21555SRichard Lowe.\" 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*bbf21555SRichard Lowe.\" Copyright 2022 Oxide Computer Company 7*bbf21555SRichard Lowe.Dd February 5, 2022 8*bbf21555SRichard Lowe.Dt ZCONS 4D 9*bbf21555SRichard Lowe.Os 10*bbf21555SRichard Lowe.Sh NAME 11*bbf21555SRichard Lowe.Nm zcons 12*bbf21555SRichard Lowe.Nd Zone console device driver 13*bbf21555SRichard Lowe.Sh DESCRIPTION 14*bbf21555SRichard LoweThe 15*bbf21555SRichard Lowe.Nm zcons 16*bbf21555SRichard Lowecharacter driver exports the console for system zones. 17*bbf21555SRichard LoweThe driver is fundamentally similar to a pseudo-terminal device, and is thus 18*bbf21555SRichard Lowecomprised of two sides: 19*bbf21555SRichard Lowe.Bl -bullet 20*bbf21555SRichard Lowe.It 21*bbf21555SRichard Lowea manager device, which applications in the global zone can open for 22*bbf21555SRichard Lowecommunication 23*bbf21555SRichard Lowe.It 24*bbf21555SRichard Lowea subsidiary device, which processes in the non-global zone can write to, to 25*bbf21555SRichard Lowecommunicate with global zone management applications 26*bbf21555SRichard Lowe.El 27*bbf21555SRichard Lowe.Pp 28*bbf21555SRichard LoweApplications must not depend on the location of 29*bbf21555SRichard Lowe.Pa /dev 30*bbf21555SRichard Loweor 31*bbf21555SRichard Lowe.Pa /devices 32*bbf21555SRichard Loweentries exposed by 33*bbf21555SRichard Lowe.Nm zcons 34*bbf21555SRichard Lowein the global zone. 35*bbf21555SRichard LoweInside a non-global zone, the 36*bbf21555SRichard Lowe.Nm zcons 37*bbf21555SRichard Lowesubsidiary device is fronted by 38*bbf21555SRichard Lowe.Pa /dev/console 39*bbf21555SRichard Loweand other console-related symbolic links, which are used by applications that 40*bbf21555SRichard Loweexpect to write to the system console. 41*bbf21555SRichard Lowe.Pp 42*bbf21555SRichard LoweThe 43*bbf21555SRichard Lowe.Nm 44*bbf21555SRichard Lowedriver is not a 45*bbf21555SRichard Lowe.Sy Committed 46*bbf21555SRichard Loweinterface, and may change at any time. 47*bbf21555SRichard Lowe.Sh FILES 48*bbf21555SRichard Lowe.Bl -tag -width Pa 49*bbf21555SRichard Lowe.It Pa /dev/zcons/ZONENAME/globalconsole 50*bbf21555SRichard LoweGlobal zone console manager device for zone 51*bbf21555SRichard Lowe.Sy ZONENAME . 52*bbf21555SRichard Lowe.It Pa /dev/zcons/ZONENAME/zoneconsole 53*bbf21555SRichard LoweGlobal zone console subsidiary device for zone 54*bbf21555SRichard Lowe.Sy ZONENAME . 55*bbf21555SRichard Lowe.It Pa /dev/zconsole 56*bbf21555SRichard LoweNon-global zone console (subsidiary device). 57*bbf21555SRichard Lowe.El 58*bbf21555SRichard Lowe.Sh INTERFACE STABILITY 59*bbf21555SRichard Lowe.Sy Uncommitted 60*bbf21555SRichard Lowe.Sh SEE ALSO 61*bbf21555SRichard Lowe.Xr attributes 7 , 62*bbf21555SRichard Lowe.Xr zones 7 , 63*bbf21555SRichard Lowe.Xr zoneadm 8 , 64*bbf21555SRichard Lowe.Xr zonecfg 8 65