NAME

       bssadmin - Interplanetary Internet (IPN) scheme administration interface for use with
       Bundle Streaming Service

SYNOPSIS

       bssadmin [ commands_filename ]

DESCRIPTION

       bssadmin is a BSS variant of ipnadmin(1) that configures the local ION node's routing of
       bundles to endpoints whose IDs conform to the ipn endpoint ID scheme.  ipn is a CBHE-
       conformant scheme; that is, every endpoint ID in the ipn scheme is a string of the form
       "ipn:element_number.service_number" where element_number is a CBHE "node number" and
       service_number identifies a specific application processing point.

       bssadmin operates in response to IPN scheme configuration commands found in the file
       commands_filename, if provided; if not, bssadmin prints a simple prompt (:) so that the
       user may type commands directly into standard input.

       The format of commands for commands_filename can be queried from bssadmin with the 'h' or
       '?' commands at the prompt.  The commands are documented in bssrc(5).

EXIT STATUS

       "0" Successful completion of IPN scheme administration.
       "1" Unsuccessful completion of IPN scheme administration, due to inability to attach to
       the Bundle Protocol system or to initialize the IPN scheme.

EXAMPLES

       bssadmin
           Enter interactive IPN scheme configuration command entry mode.

       bssadmin host1.bssrc
           Execute all configuration commands in host1.bssrc, then terminate immediately.

FILES

       See bssrc(5) for details of the BSS configuration commands for the IPN scheme.

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 bssrc file on a Windows machine, be sure to use
       dos2unix to convert it to Unix text format before presenting it to bssadmin.  Otherwise
       bssadmin will detect syntax errors and will not function satisfactorily.

       The following diagnostics may be issued to the logfile ion.log:

       bssadmin can't attach to BP.
           Bundle Protocol has not been initialized on this computer.  You need to run bpadmin(1)
           first.

       bssadmin can't initialize routing database.
           There is no SDR data store for dtnadmin to use.  Please run ionadmin(1) to start the
           local ION node.

       Can't open command file...
           The commands_filename specified in the command line doesn't exist.

       Various errors that don't cause bssadmin 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 bssrc(5) for details.

BUGS

       Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>

SEE ALSO

       bssrc(5)