Merge commit 'dc97a43d4a70c8773a619f11b95b07a787f6f5b7' into merges
[unleashed.git] / share / man / man8 / cvcd.8
blob802ec3669cc487cfe96a9f7de69238adae8c17b2
1 '\" te
2 .\"  Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved
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 .\" 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 .\" 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 CVCD 8 "Mar 9, 2006"
7 .SH NAME
8 cvcd \- virtual console daemon
9 .SH SYNOPSIS
10 .LP
11 .nf
12 \fB/platform\fI\fR/\fIplatform_name\fR/cvcd\fR [\fB-a\fR \fIauth\fR] [\fB-e\fR \fIencr\fR]
13      [\fB-u\fR \fIesp_auth\fR]
14 .fi
16 .SH DESCRIPTION
17 .sp
18 .LP
19 The virtual console daemon, \fBcvcd\fR, is a server process that supports the
20 network console provided on some platforms. The \fBcvcd\fR daemon accepts
21 network console connections from a remote host (only one host at any given
22 time). Console input is read from this connection and forwarded to
23 \fBcvc\fR(7D) by way of \fBcvcredir\fR(7D).
24 .sp
25 .LP
26 Similarly, console output is read from \fBcvcredir\fR(7D) and forwarded across
27 the network console connection. If \fBcvcd\fR dies, console traffic is
28 automatically rerouted through an internal hardware interface.
29 .sp
30 .LP
31 The \fBcvcd\fR daemon normally starts at system boot time. Each domain supports
32 only one \fBcvcd\fR process at a time.
33 .LP
34 Caution -
35 .sp
36 .RS 2
37 On Sun Enterprise 10000 domains, \fBcvcd\fR uses a configuration file
38 (\fB/etc/ssphostname\fR) to determine the name of the host from which network
39 console connections are allowed. If the remote console host is renamed, you
40 must edit the configuration file to reflect that change.
41 .RE
42 .sp
43 .LP
44 The \fBcvcd\fR daemon supports per-socket IP Security Architecture (IPsec)
45 through the options described below. See \fBipsec\fR(7P).
46 .SH OPTIONS
47 .sp
48 .LP
49 The \fBcvcd\fR daemon supports the options listed below.
50 .sp
51 .ne 2
52 .na
53 \fB\fB-a\fR \fIauth\fR\fR
54 .ad
55 .RS 15n
56 Controls the IPsec Authentication Header (AH) algorithm. \fIauth\fR can be one
57 of \fBnone\fR, \fBmd5\fR, or \fBsha1\fR.
58 .RE
60 .sp
61 .ne 2
62 .na
63 \fB\fB-e\fR \fIencr\fR\fR
64 .ad
65 .RS 15n
66 Controls the IPsec Encapsulating Security Payload (ESP) encryption algorithm.
67 \fIencr\fR can be one of \fBnone\fR, \fBdes\fR, or \fB3des\fR.
68 .RE
70 .sp
71 .ne 2
72 .na
73 \fB\fB-u\fR \fIesp_auth\fR\fR
74 .ad
75 .RS 15n
76 Controls the IPsec Encapsulating Security Payload (ESP) authentication
77 algorithm. \fIesp_auth\fR can be one of \fBnone\fR, \fBmd5\fR, or \fBsha1\fR.
78 .RE
80 .SH OPERANDS
81 .sp
82 .LP
83 The following operands are supported:
84 .sp
85 .ne 2
86 .na
87 \fB\fIplatform_name\fR\fR
88 .ad
89 .RS 17n
90 The official Sun platform name used in packaging and code. For example, for Sun
91 Fire 15K servers, the \fIplatform_name\fR would be \fBSUNW,Sun-Fire-15000\fR.
92 .RE
94 .SH EXAMPLES
95 .LP
96 \fBExample 1 \fRSetting an IPSec Option
97 .sp
98 .LP
99 The command below sets the value of the IPsec Authentication Header algorithm
100 to \fBmd5\fR. As a result of this command, \fBcvcd\fR will use the HMAC-MD5
101 authentication algorithm.
104 .in +2
106 # \fBsvccfg -s svc:/system/cvc setprop cvc/ah_auth = "md5"\fR
107 # \fBsvccfg -s svc:/system/cvc setprop cvc/esp_encr = "none"\fR
108 # \fBsvccfg -s svc:/system/cvc setprop cvc/esp_auth = "none"\fR
109 # \fBsvcadm refresh svc:/system/cvc\fR
111 .in -2
114 .SH ATTRIBUTES
117 See \fBattributes\fR(5) for descriptions of the following attributes:
122 box;
123 c | c
124 l | l .
125 ATTRIBUTE TYPE  ATTRIBUTE VALUE
127 Architecture    T{
128 Sun Enterprise 10000 servers, Sun Fire High-End Systems
132 .SH SEE ALSO
135 \fBsvcs\fR(1), \fBsvcadm\fR(8), \fBsvccfg\fR(8), \fBservices\fR(4),
136 \fBattributes\fR(5), \fBsmf\fR(5), \fBcvc\fR(7D), \fBcvcredir\fR(7D),
137 \fBipsec\fR(7P)
140 \fISun Enterprise 10000 SSP Reference Manual\fR
143 \fISystem Management Services (SMS) Reference Manual\fR
144 .SH NOTES
147 The \fBcvcd\fR service is managed by the service management facility,
148 \fBsmf\fR(5), under the fault management resource identifier (FMRI):
150 .in +2
152 svc:/system/cvc
154 .in -2
159 Administrative actions on this service, such as enabling, disabling, or
160 requesting restart, can be performed using \fBsvcadm\fR(8) or
161 \fBsvccfg\fR(8). The service's status can be queried using the \fBsvcs\fR(1)
162 command.