xenial (1) dtn2fw.1.gz

NAME

       dtn2fw - bundle route computation task for the "dtn" scheme

SYNOPSIS

       dtn2fw

DESCRIPTION

       dtn2fw is a background "daemon" task that pops bundles from the queue of bundle destined for "dtn"-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 routes as configured by dtn2admin(1).

       dtn2fw 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.  dtn2fw can also be spawned and terminated in response to START and STOP commands that pertain
       specifically to the "dtn" scheme.

EXIT STATUS

       "0" dtn2fw 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 dtn2fw.

       "1" dtn2fw 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 dtn2fw.

FILES

       No configuration files are needed.

ENVIRONMENT

       No environment variables apply.

DIAGNOSTICS

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

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

       dtn2fw can't load routing database.
           dtn2admin has not yet initialized the "dtn" scheme.

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

       'dtn' scheme is unknown.
           The "dtn" 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.  dtn2fw terminates.

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

BUGS

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

SEE ALSO

       bpadmin(1), dtn2admin(1), bprc(5), dtn2rc(5).