bpsource(1) [debian man page]

BPSOURCE(1)							  BP executables						       BPSOURCE(1)

NAME

       bpsource - Bundle Protocol transmission test shell

SYNOPSIS

       bpsource destinationEndpointId ['text'] [-tTTL]

DESCRIPTION

       When text is supplied, bpsource simply uses Bundle Protocol to send text to a counterpart bpsink application task that has opened the BP
       endpoint identified by destinationEndpointId, then terminates.

       Otherwise, bpsource offers the user an interactive "shell" for testing Bundle Protocol data transmission.  bpsource prints a prompt string
       (": ") to stdout, accepts a string of text from stdin, uses Bundle Protocol to send the string to a counterpart bpsink application task
       that has opened the BP endpoint identified by destinationEndpointId, then prints another prompt string and so on.  To terminate the
       program, enter a string consisting of a single exclamation point (!) character.

       TTL indicates the number of seconds the bundles may remain in the network, undelivered, before they are automatically destroyed. If
       omitted, TTL defaults to 300 seconds.

       The source endpoint ID for each bundle sent by bpsource is the null endpoint ID, i.e., the bundles are anonymous.  All bundles are sent
       standard priority with no custody transfer and no status reports requested.

EXIT STATUS

       0   bpsource has terminated.  Any problems encountered during operation will be noted in the ion.log log file.

FILES

       The service data units transmitted by bpsource are sequences of text obtained from a file in the current working directory named
       "bpsourceAduFile", which bpsource creates automatically.

ENVIRONMENT

       No environment variables apply.

DIAGNOSTICS

       Diagnostic messages produced by bpsource are written to the ION log file ion.log.

       Can't attach to BP.
	   bpadmin has not yet initialized Bundle Protocol operations.

       bpsource fgets failed
	   Operating system error.  Check errtext, correct problem, and rerun.

       No space for ZCO extent.
	   ION system error.  Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.

       Can't create ZCO extent.
	   ION system error.  Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.

       bpsource can't send ADU
	   Bundle Protocol service to the remote endpoint has been stopped.

BUGS

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

SEE ALSO

       bpadmin(1), bpsink(1), bp(3)

perl v5.14.2							    2012-05-25							       BPSOURCE(1)

BPSTATS2(1)							  BP executables						       BPSTATS2(1)

NAME

       bpstats2 - Bundle Protocol (BP) processing statistics query utility via bundles

SYNOPSIS

       bpstats2 sourceEID [default destEID] [ct]

DESCRIPTION

       bpstats2 creates bundles containing the current values of all BP processing statistics accumulators.  It creates these bundles when:

       o   an interrogation bundle is delivered to sourceEID: the contents of the bundle are discarded, a new statistics bundle is generated and
	   sent to the source of the interrogation bundle.  The format of the interrogation bundle is irrelevant.

       o   a SIGUSR1 signal is delivered to the bpstats2 application: a new statistics bundle is generated and sent to default destEID.

EXIT STATUS

       0   bpstats2 has terminated. Any problems encountered during operation will be noted in the ion.log log file.

       1   bpstats2 failed to start up or receive bundles.  Diagnose the issue reported in the ion.log file and try again.

OPTIONS

       [ct]
	   If the string "ct" is appended as the last argument, then statistics bundles will be sent with custody transfer requested.

FILES

       No configuration files are needed.

ENVIRONMENT

       No environment variables apply.

DIAGNOSTICS

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

       bpstats2 can't bp_attach().
	   bpadmin has not yet initialized BP operations.

       bpstats2 can't open own endpoint.
	   Another BP application has opened that endpoint; close it and try again.

       No space for ZCO extent.
	   ION system error.  Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.

       Can't create ZCO extent.
	   ION system error.  Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.

       bpstats2 can't send stats bundle.
	   Bundle Protocol service to the remote endpoint has been stopped.

       Can't send stats: bad dest EID (dest EID)
	   The destination EID printed is an invalid destination EID.  The destination EID may be specified in default destEID or the source EID
	   of the interrogation bundle.  Ensure that default destEID is an EID that is valid for ION, and that the interrogator is a source EID
	   that is also a valid destination EID.  Note that "dtn:none" is not a valid destination EID, but is a valid source EID.

NOTES

       A very simple interrogator is bpchat which can repeatedly interrogate bpstats2 by just striking the enter key.

BUGS

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

SEE ALSO

       bpstats(1), bpchat(1)

perl v5.14.2							    2012-05-25							       BPSTATS2(1)