NAME¶
bsspadmin - Bundle Streaming Service Protocol (BSSP) administration interface
SYNOPSIS¶
bsspadmin [
commands_filename | . ]
DESCRIPTION¶
bsspadmin configures, starts, manages, and stops BSSP operations for the
local ION node.
It operates in response to BSSP configuration commands found in the file
commands_filename, if provided; if not,
bsspadmin prints a
simple prompt (:) so that the user may type commands directly into standard
input. If
commands_filename is a period (.), the effect is the same as
if a command file containing the single command 'x' were passed to
bsspadmin -- that is, the ION node's
bsspclock task and link
service adapter tasks are stopped.
The format of commands for
commands_filename can be queried from
bsspadmin with the 'h' or '?' commands at the prompt. The commands are
documented in
bssprc(5).
EXIT STATUS¶
- 0
- Successful completion of BSSP administration.
EXAMPLES¶
- bsspadmin
- Enter interactive BSSP configuration command entry mode.
- bsspadmin host1.bssp
- Execute all configuration commands in host1.bssp, then terminate
immediately.
- bsspadmin .
- Stop all BSSP operations on the local node.
FILES¶
See
bssprc(5) for details of the BSSP configuration commands.
ENVIRONMENT¶
No environment variables apply.
DIAGNOSTICS¶
Note: all ION administration utilities expect source file input to be
lines of ASCII text that are NL-delimited. If you edit the bssprc file on a
Windows machine, be sure to
use dos2unix to convert it to Unix text
format before presenting it to
bsspadmin. Otherwise
bsspadmin will detect syntax errors and will not function
satisfactorily.
The following diagnostics may be issued to the logfile ion.log:
- bsspadmin can't attach to ION.
- There is no SDR data store for bsspadmin to use. You should run
ionadmin(1) first, to set up an SDR data store for ION.
- Can't open command file...
- The commands_filename specified in the command line doesn't
exist.
Various errors that don't cause
bsspadmin to fail but are noted in the
ion.log log file may be caused by improperly formatted commands given
at the prompt or in the
commands_filename file. Please see
bssprc(5) for details.
BUGS¶
Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>
SEE ALSO¶
bssprc(5)