NAME

       bssfw - bundle route computation task for the IPN scheme, adapted for Bundle Streaming
       Service

SYNOPSIS

       bssfw

DESCRIPTION

       bssfw is a background "daemon" task that pops bundles from the queue of bundle destined
       for IPN-scheme endpoints, computes proximate destinations for those bundles, and appends
       those bundles to the appropriate queues of bundles pending transmission to those computed
       proximate destinations.

       For each possible proximate destination (that is, neighboring node) there is a separate
       queue for each possible level of bundle priority: 0, 1, 2.  Each outbound bundle is
       appended to the queue matching the bundle's designated priority.

       Proximate destination computation is affected by static and default routes as configured
       by bssadmin(1) and by contact graphs as managed by ionadmin(1) and rfxclock(1).  bssfw
       differs from ipnfw in this way: a bundle that is destined for an endpoint associated with
       a BSS application (as registered in an "entry" passed to bssadmin(1) in a bssrc(5)
       command) is forwarded via a duct identified in a separately defined real-time or playback
       duct expression, rather than the standard duct that is used for non-BSS traffic.

       bssfw is spawned automatically by bpadmin in response to the 's' (START) command that
       starts operation of Bundle Protocol on the local ION node, and it is terminated by bpadmin
       in response to an 'x' (STOP) command.  bssfw can also be spawned and terminated in
       response to START and STOP commands that pertain specifically to the IPN scheme.

EXIT STATUS

       "0" bssfw terminated, for reasons noted in the ion.log log file.  If this termination was
           not commanded, investigate and solve the problem identified in the log file and use
           bpadmin to restart bssfw.

       "1" bssfw could not commence operations, for reasons noted in the ion.log log file.
           Investigate and solve the problem identified in the log file, then use bpadmin to
           restart bssfw.

FILES

       No configuration files are needed.

ENVIRONMENT

       No environment variables apply.

DIAGNOSTICS

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

       bssfw can't attach to BP.
           bpadmin has not yet initialized BP operations.

       bssfw can't load routing database.
           bssadmin has not yet initialized the IPN scheme.

       Can't create lists for route computation.
           An unrecoverable database error was encountered.  bssfw terminates.

       'bss' scheme is unknown.
           The IPN scheme was not added when bpadmin initialized BP operations.  Use bpadmin to
           add and start the scheme.

       Can't take forwarder semaphore.
           ION system error.  bssfw terminates.

       Can't exclude sender from routes.
           An unrecoverable database error was encountered.  bssfw terminates.

       Can't enqueue bundle.
           An unrecoverable database error was encountered.  bssfw terminates.

BUGS

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

SEE ALSO

       bpadmin(1), bssadmin(1), bprc(5), bssrc(5).