CEC(8) CEC(8)
NAME
cec - Coraid Ethernet Console
SYNOPSIS
cec [ -dp ] [ -S srv ] [ -c esc ] [ -e ea ] [ -h host [ -s
shelf ] [ interface ]
DESCRIPTION
Cec uses raw Ethernet packets to connect to a CEC server for
console access. All clients share the same session. Coraid
appliances and Coraid Plan 9 kernels can currently be CEC
servers.
Cec starts by probing the specified network interface for
available CEC servers. The default is /net/ether0. Only
one cec process may be run per Ethernet interface. If the
server is specified with the -b, -h, or -s options, communi-
cation will proceed immediately upon discovery of the first
CEC server with the specified address. Otherwise, a selec-
tion prompt will be displayed showing the discovered CEC
servers available for communication. Unless the -p option
is specified, cec exits if no matching servers are found.
The selection prompt accepts
number Connect to server number (from the first column),
p Probe the interface again, and
q Quit.
Note the selection number is not the shelf address but the
cec-generated sequence number printed in the leftmost col-
umn.
Once connected to a CEC server, typing the escape character
will drop the user into an escape prompt where the user may
type `q' to quit the connection, `i' to send the escape
character across the connection, or `.' to continue the
connection.
Options
-c Set the escape character to control-esc. The default
setting is control-\.
-d Print debugging information.
-e Connect to the server with Ethernet address ea; implies
-p.
-h Connect to the server host. Note that this name might
not be the same as the contents of `/dev/sysname' on
the target system.
Page 1 Plan 9 (printed 12/21/24)
CEC(8) CEC(8)
-p Persist: continue trying to connect even if there are
no matching servers. This is useful when connecting to
a CPU server before it boots.
-s Connect to the server at address shelf.
-S Post the CEC connection as /srv/srv to allow sharing.
If the -e, -s, or -h options are given, cec will exit upon
closing the connection. Otherwise, cec will return to the
selection prompt upon connection close.
EXAMPLES
; cec '#l1/ether1'
0 1 003048679b89
[#qp]: 0
SR shelf 1>
SR shelf 1> >>> q
0 1 003048679b89
[#qp]: q
;
SOURCE
/sys/src/cmd/cec
BUGS
The CEC protocol should be integrated with the console
server. The arbitration between the keyboard and network is
suboptimal.
Early boot information and very late crash information from
servers may be lost due to timing quirks.
Page 2 Plan 9 (printed 12/21/24)