sys/man/8/cec

   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  0       1 003048679b89
 136 [#qp]: 0
 137
 138 SR shelf 1>
 139 SR shelf 1> >>> q
 140  0       1 003048679b89
 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.