Provided by: ekeyd_1.1.2-1_i386 bug

NAME

       ekeydctl - Entropy Key Daemon Control tool

SYNOPSIS

       ekeydctl  add  DeviceNode  |addall  KeyDirPath |list |remove Identifier
       |stats Identifier |keyring KeyRingFile |shutdown

DESCRIPTION

       ekeydctl is a tool which interacts with the ekeyd using  a  local  unix
       domain socket.

OPTIONS

       add DeviceNode
              Add  an  Entropy  Key  to  be  managed  by the ekeyd daemon. The
              argument   is   the   device    node    of    the    key    e.g.
              /dev/entropykey/AAAAAAAAAAAAAAAAAAA

       addall DevicePath
              Add  a  number of Entopy Keys to be managed by the ekeyd daemon.
              The argument is the path to a directory  containing  the  device
              nodes to be added e.g. /dev/entropykey

       list   List all the entropy keys attached to the ekeyd daemon.

       remove Identifier
              Remove  an  Entropy Key from management by the ekeyd daemon. The
              argument may be the device node, the serial number of the key or
              the numeric ID as shown in the list command.

       stats Identifier
              Show  statistics  for  an  Entropy  Key. The argument may be the
              device node, the serial number of the key or the numeric  ID  as
              shown in the list command.

       keyring Keyring
              Re-load  keyring entries from a keyring file. The argument is to
              a keyring file. Any existing connections will not be affected.

       shutdown
              Shut the entropy key daemon down.

STATISTIC VARIABLES

       The stats command produces a list of key and value pairs. Each variable
       gives some information about the selected Entropy Key.

       BytesRead
              The total number of bytes read from the Entropy Key device.

       BytesWritten
              The total number of bytes written to the Entropy Key device.

       ConnectionNonces
              The number of session key nonces issued by the host software.

       ConnectionPackets
              The number of packets recived from the Entropy Key device.

       ConnectionRekeys
              The number of session re-keying events.

       ConnectionResets
              The number of times the Entropy Key device has been reset by the
              host software.

       ConnectionTime
              The number of seconds the Entropy Key device has been  connected
              to the host software.

       EntropyRate
              The number of bits per second of entropy from the Entropy Key.

       FipsFrameRate
              The  number  of  FIPS frames generated per second by the Entropy
              Key.

       FrameByteLast
              The byte offset of the last valid frame.

       FramesOk
              The number of valid frames recived from the Entropy Key.

       FramingErrors
              The number of framing errors.

       KeyDbsdShannonPerByteL
              The  estimated  number  of  shannons  per  byte  from  the  left
              generator after debiasing.

       KeyDbsdShannonPerByteR
              The  estimated  number  of  shannons  per  byte  from  the right
              generator after debiasing.

       KeyRawShannonPerByteL
              The  estimated  number  of  shannons  per  byte  from  the  left
              generator before debiasing.

       KeyRawShannonPerByteR
              The  estimated  number  of  shannons  per  byte  from  the right
              generator before debiasing.

       KeyRawShannonPerByteX
              The estimated number of shannons per  byte  from  the  exclusive
              orred output of the generators before debiasing.

       KeyTemperatureC
              The internal temperature in Celsius of the Entropy Key.

       KeyTemperatureF
              The internal temperature in Fahrenheit of the Entropy Key.

       KeyTemperatureK
              The internal temperature in Kelvin of the Entropy Key.

       KeyVoltage
              The internal supply voltage of the Entropy Key.

       PacketErrors
              The number of packet level errors.

       PacketOK
              The number of correct packets.

       ReadRate
              The number of bits per second being read from the Entropy Key.

       TotalEntropy
              The total number of bytes read from the Entropy Key.

       WriteRate
              The  number of bits per second being written to the Entropy Key.

SEE ALSO

       ekeyd(8)

AUTHOR

       Copyright © 2009 Simtec Electronics.  All rights reserved.

       Permission is hereby granted, free of charge, to any person obtaining a
       copy   of   this  software  and  associated  documentation  files  (the
       "Software"), to deal in the  Software  without  restriction,  including
       without  limitation  the  rights  to use, copy, modify, merge, publish,
       distribute, sublicense, and/or sell copies  of  the  Software,  and  to
       permit  persons  to whom the Software is furnished to do so, subject to
       the following conditions:

       The above copyright notice and this permission notice shall be included
       in all copies or substantial portions of the Software.

       THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
       OR  IMPLIED,  INCLUDING  BUT  NOT  LIMITED   TO   THE   WARRANTIES   OF
       MERCHANTABILITY,  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
       IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE  LIABLE  FOR  ANY
       CLAIM,  DAMAGES  OR  OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
       TORT OR OTHERWISE, ARISING FROM, OUT  OF  OR  IN  CONNECTION  WITH  THE
       SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

                                19th July 2009                     ekeydctl(8)