'\" te .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved .\" 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. 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. 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] .TH VNTSD 1M "Mar 31, 2009" .SH NAME vntsd \- virtual network terminal server daemon for Logical Domains .SH SYNOPSIS .LP .nf \fB/usr/lib/ldoms/vntsd\fR .fi .SH DESCRIPTION .sp .LP The \fBvntsd\fR daemon is a server that supports connections to the Logical Domains (LDoms) console by using \fBtelnet\fR(1). When a \fBtelnet\fR session starts, \fBvntsd\fR sends \fBtelnet\fR options to the client indicating a willingness to remotely echo characters and to suppress go ahead. .sp .LP Consoles are organized into groups by the LDoms Manager. Each console group is assigned a unique group name and TCP port number. \fBvntsd\fR uses the group's port number to export access to the consoles within that group. To establish a connection with a console or console group, a user starts a \fBtelnet\fR(1) session with the corresponding group's port number. Depending on the number of consoles within that group, \fBvntsd\fR does one of two things: .RS +4 .TP .ie t \(bu .el o If there is only one console in the group, \fBvntsd\fR connects a session to that LDoms console. .RE .RS +4 .TP .ie t \(bu .el o If there are multiple consoles in the group, \fBvntsd\fR prompts the user to select the console to which they would like to connect, as shown in "Multiple-Console Options," below. .RE .sp .LP For each console, \fBvntsd\fR provides write access only to the first user connecting to the console. Subsequent users connecting to the console are allowed only to read from the console and wait for write access. When the first user disconnects, write privileges are transferred to the next user waiting in the queue. If a user who does not have write privileges attempts to write to a console, the \fBvntsd\fR displays the following message: .sp .in +2 .nf You do not have write access .fi .in -2 .sp .LP A user who has no write access can acquire write access forcibly by using the \fB~w\fR special console command, described in "Special Console Commands," below. .sp .LP \fBvntsd\fR can be invoked only with superuser privileges or by someone in the Primary Administrator role. .SH OPTIONS .sp .LP The options for \fBvntsd\fR are divided into multiple-console options and console commands. .SS "Multiple-Console Options" .sp .LP The options listed below are supported when there are multiple LDoms consoles in a group. The syntax for the use of these options is: .sp .in +2 .nf \fI\fR-vnts-\fI\fR: \fI