cec 1.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798
  1. .TH CEC 8
  2. .SH NAME
  3. cec \- Coraid Ethernet Console
  4. .SH SYNOPSIS
  5. .B cec
  6. [
  7. .B -d
  8. ] [
  9. .B -s
  10. .I shelf
  11. ] [
  12. .B -e
  13. .I esc
  14. ]
  15. .I interface
  16. .SH DESCRIPTION
  17. The
  18. .I cec
  19. command uses raw Ethernet frames to connect to a CEC
  20. server for console access. All clients share the same session. Coraid
  21. appliances are currently the only CEC servers.
  22. .PP
  23. A
  24. .I cec
  25. process starts by probing the specified network interface
  26. (e.g.,
  27. .LR /net/ether0 )
  28. for available CEC servers. If the shelf address of the server is
  29. specified with the
  30. .B -s
  31. flag, the connection will
  32. proceed immediately upon discovery of the first CEC server
  33. with this shelf address. Otherwise, a selection prompt
  34. will be displayed showing the discovered CEC servers
  35. available for communication. If no servers are discovered,
  36. .I cec
  37. exits.
  38. .IP
  39. .EX
  40. 0 5 003048865f1e shelf5
  41. [#qp]:
  42. .EE
  43. .LP
  44. The selection prompt accepts
  45. .TP
  46. .I number
  47. Connect to server
  48. .I number
  49. (from the first column),
  50. .TP
  51. .B p
  52. Probe the interface again, and
  53. .TP
  54. .B q
  55. Quit.
  56. .PP
  57. Note the selection number is not the shelf address but the
  58. .IR cec -generated
  59. ID number printed in the leftmost column.
  60. .PP
  61. Once connected to a CEC server, entering the escape sequence
  62. will drop the user into an escape prompt where the user may
  63. type
  64. .L q
  65. to quit the connection,
  66. .L i
  67. to send the escape sequence
  68. across the connection, or
  69. .L .
  70. to continue the connection.
  71. The escape sequence is printed on connection.
  72. .PP
  73. If the
  74. .B -s
  75. option is used,
  76. .I cec
  77. will exit upon closing the connection.
  78. Otherwise,
  79. .I cec
  80. will return to the selection prompt upon connection close.
  81. .SS Options
  82. .TP 1i
  83. .B -d
  84. Output debugging information.
  85. .TP
  86. .BI -s " shelf"
  87. Connect to the server at shelf address
  88. .IR shelf .
  89. .TP
  90. .BI -e " esc"
  91. Set the escape caracter to
  92. .BI control -
  93. .IR esc .
  94. The default setting is
  95. .BR control -\e.
  96. .SH BUGS
  97. The CEC protocol should be integrated with the console server.
  98. The arbitration between the keyboard and network is suboptimal.