Subversion Repositories planix.SVN

Rev

Rev 2 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 - 1 
.TH CEC 8
2 
.SH NAME
3 
cec \- Coraid Ethernet Console
4 
.SH SYNOPSIS
5 
.B cec
6 
[
7 
.B -dp
8 
] [
9 
.B -S
10 
.I srv
11 
] [
12 
.B -c
13 
.I esc
14 
] [
15 
.B -e
16 
.I ea
17 
] [
18 
.B -h
19 
.I host
20 
[
21 
.B -s
22 
.I shelf
23 
] [
24 
.I interface
25 
]
26 
.SH DESCRIPTION
27 
.I Cec
28 
uses raw Ethernet packets to connect to a CEC server for console access.
29 
All clients share the same session.
30 
Coraid appliances and Coraid Plan 9 kernels can currently be CEC servers.
31 
.PP
32 
.I Cec
33 
starts by probing the specified network interface
34 
for available CEC servers.  The default is
35 
.BR /net/ether0 .
36 
Only one
37 
.I cec
38 
process may be run per Ethernet interface.
39 
If the server is specified with the
40 
.BR -b ,
41 
.BR -h ,
42 
or
43 
.B -s
44 
options, communication will
45 
proceed immediately upon discovery of the first CEC server
46 
with the specified address.
47 
Otherwise, a selection prompt
48 
will be displayed showing the discovered CEC servers
49 
available for communication.  Unless the
50 
.B -p
51 
option is specified,
52 
.I cec
53 
exits if no matching servers are found.
54 
The selection prompt accepts
55 
.LP
56 
.TF "\fInumber "
57 
.TP
58 
.I number
59 
Connect to server
60 
.I number
61 
(from the first column),
62 
.TP
63 
.B p
64 
Probe the interface again, and
65 
.TP
66 
.B q
67 
Quit.
68 
.PD
69 
.PP
70 
Note the selection number is not the shelf address but the
71 
.IR cec -generated
72 
sequence number printed in the leftmost column.
73 
.PP
74 
Once connected to a CEC server, typing the escape character
75 
will drop the user into an escape prompt where the user may type
76 
.L q
77 
to quit the connection,
78 
.L i
79 
to send the escape character
80 
across the connection, or
81 
.L .
82 
to continue the connection.
83 
.SS Options
84 
.TP
85 
.B -c
86 
Set the escape character to
87 
.RI control- esc .
88 
The default setting is control-\e.
89 
.TP
90 
.B -d
91 
Print debugging information.
92 
.TP
93 
.B -e
94 
Connect to the server with Ethernet address
95 
.IR ea ;
96 
implies
97 
.BR -p .
98 
.TP
99 
.B -h
100 
Connect to the server
101 
.IR host .
102 
Note that this name might not be the same as the contents of
103 
.L /dev/sysname
104 
on the target system.
105 
.TP
106 
.B -p
107 
Persist: continue trying to connect even if
108 
there are no matching servers.  This is useful when
109 
connecting to a CPU server before it boots.
110 
.TP
111 
.B -s
112 
Connect to the server at address
113 
.IR shelf .
114 
.TP
115 
.B -S
116 
Post the CEC connection as
117 
.BI /srv/ srv
118 
to allow sharing.
119 
.PP
120 
If the
121 
.BR -e ,
122 
.BR -s ,
123 
or
124 
.B -h
125 
options are given,
126 
.I cec
127 
will exit upon closing the connection.
128 
Otherwise,
129 
.I cec
130 
will return to the selection prompt upon connection close.
131 
.SH EXAMPLES
132 
.IP
133 
.EX
134 
; cec '#l1/ether1'
135 
 
136 
[#qp]: 0
137 
 
138 
SR shelf 1>
139 
SR shelf 1> >>> q
140 
 
141 
[#qp]: q
142 
;
143 
.EE
144 
.SH SOURCE
145 
.B /sys/src/cmd/cec
146 
.\" .SH "SEE ALSO"
147 
.\" .IR cec (3)
148 
.SH BUGS
149 
The CEC protocol should be integrated with the console server.
150 
The arbitration between the keyboard and network is suboptimal.
151 
.PP
152 
Early boot information and very late crash information from servers
153 
may be lost due to timing quirks.