xenial (1) bbctl.1.gz

Provided by: bit-babbler_0.5_amd64 bug

NAME

       bbctl - query and control tool for BitBabbler hardware RNG devices

SYNOPSIS

       bbctl [options]

DESCRIPTION

       The  bbctl  program can be used to issue command requests to the control socket of software controlling a
       BitBabbler device (such as the seedd(1) daemon).

OPTIONS

       The following options are available:

       -s, --scan
              Scan for active devices.  This will report the device identifiers which can be  queried  from  the
              owner of the control socket.

       -i, --device-id=id
              Act  on  only the specified device.  If no devices are explicitly specified then the default is to
              act upon all of them.  This option may be passed multiple times to  act  on  some  subset  of  the
              available  devices.  The id must be an identifier name as reported by bbctl --scan, you cannot use
              device logical or physical addresses here.

       -b, --bin-freq
              Report the 8-bit symbol frequencies.

       -B, --bin-freq16
              Report the 16-bit symbol frequencies.

           --bin-count
              Report the 8-bit symbol counts.  Similar to --bin-freq except the  bins  are  reported  in  symbol
              order instead of sorted by frequency.

           --bin-count16
              Report  the  16-bit symbol counts.  Similar to --bin-freq16 except the bins are reported in symbol
              order instead of sorted by frequency.

           --first=n
              Show only the first n results.  Useful when you don't want to actually see all 65 thousand entries
              for  the  16-bit  bins.   The  default (if neither this nor the --last option are specified) is to
              report everything in its full glory.  Don't say I didn't warn you.

           --last=n
              Show only the last n results.  Useful when you don't want to actually see all 65 thousand  entries
              for  the  16-bit bins.  If used together with the --first option, then both the requested head and
              tail of the results will be shown.

       -r, --bit-runs
              Report on runs of consecutive bits.

       -S, --stats
              Report general QA statistics.

       -c, --control-socket=path
              The filesystem path for the service control socket to query.  This can belong to any process  that
              supports  the  BitBabbler  control  socket  interface  and  for  which  the user running bbctl has
              permission to connect to.

              An address of the form tcp:host:port may be used if the control socket is  bound  to  a  TCP  port
              rather  than  a  unix domain socket path.  The host part can be a DNS hostname or address literal.
              If an IPv6 address literal is used it should be enclosed in square brackets  (e.g.  tcp:[::1]:2020
              to  bind  to  port  2020 on the local IPv6 interface).  The port can be a port number or a service
              name (as defined in /etc/services or other system name-service  databases  which  are  queried  by
              getaddrinfo(3)).

       -V, --log-verbosity=n
              Change the logging verbosity of the control socket owner.

       -v, --verbose
              Make more noise about what is going on internally.  It may be passed multiple times to get swamped
              with even more information.

       -?, --help
              Show a shorter version of all of this, which may fit on a single page.

           --version
              Report the bbctl release version.

FILES

       /var/run/bit-babbler/seedd.socket
              The default control socket path if not explicitly specified.

SEE ALSO

       seedd(1).

AUTHOR

       seedd was written by Ron <ron@debian.org>.  You can  send  bug  reports,  feature  requests,  praise  and
       complaints to support@bitbabbler.org.

                                                February 24, 2015                                       BBCTL(1)