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.

     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.