CEC(3)                                                     CEC(3)

     NAME
          cec - coraid ethernet console server

     SYNOPSIS
          bind #© /dev

          /dev/ceccfg
          /dev/cecctl
          /dev/cecdbg
          /dev/cecstat

     DESCRIPTION
          Cec exports a machines console over raw ethernet frames.
          See cec(8) for a client.

          The read-only file ceccfg lists the interfaces on which cec
          is configured, one per line.

          The write-only cecctl accepts control messages.  The command

               cecon ethern

          turns on a cec listener for ethern, while

               cecoff ethern

          turns that listener off.  The command

               namestring

          sets the name of the current machine name to string while

               shelf n

          sets the shelf number in Toffer messages.  The default name
          is the empty string and the default shelf number is -1.
          These parameters are listed in the available servers pre-
          sented by cec(8). The command

               password string

          sets the connection password.  The cec protocol transmits
          passwords in the clear. This is not real security.  The
          strings traceon and traceoff control cec tracing.

          Debugging output is available in the read-only file cecdbg.

          The file cecstat lists each connection in the following for-
          mat

     Page 1                       Plan 9             (printed 4/25/24)

     CEC(3)                                                     CEC(3)

               000e0c06a37c  25 open              0 0 0 00000000

          The 7 fields are ethernet mac address, the connection num-
          ber, the connection state ( unused, initb, login, open), the
          number of idle ticks, the number of retires and the address
          of the current outstanding message's Block*.  Fields 4-7 are
          likely to change in the future.

     EXAMPLE
          Start cec on ports with no ip stack.

               bind -a '#©' /dev
               for(i in `{seq 1 10}){
                    if(test -e '#l'^$i)
                    if(! test -e /net*/ether^$i)
                         echo 'cecon #l'^$i>/dev/cecctl
               }

     SEE ALSO
          cec(8),

     SOURCE
          /sys/src/9/port/devcec.c

     BUGS
          Cec is not available before ethernet has started or from
          9load.

          The cecstat format is neither fixed-width nor are fields 4-7
          very useful.

     Page 2                       Plan 9             (printed 4/25/24)