BPDRIVER(1) BP executables BPDRIVER(1)
NAME
bpdriver - Bundle Protocol transmission test program
SYNOPSIS
bpdriver nbrOfCycles ownEndpointId destinationEndpointId [length] [tTTL]
DESCRIPTION
bpdriver uses Bundle Protocol to send nbrOfCycles application data units of length indicated by length, to a counterpart application task
that has opened the BP endpoint identified by destinationEndpointId.
If omitted, length defaults to 60000.
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.
bpdriver normally runs in "echo" mode: after sending each bundle it waits for an acknowledgment bundle before sending the next one. For
this purpose, the counterpart application task should be bpecho.
Alternatively bpdriver can run in "streaming" mode, i.e., without expecting or receiving acknowledgments. Streaming mode is enabled when
length is specified as a negative number, in which case the additive inverse of length is used as the effective value of length. For this
purpose, the counterpart application task should be bpcounter.
If the effective value of length is 1, the sizes of the transmitted service data units will be randomly selected multiples of 1024 in the
range 1024 to 62464.
bpdriver normally runs with custody transfer disabled. To request custody transfer for all bundles sent by bpdriver, specify nbrOfCycles
as a negative number; the additive inverse of nbrOfCycles will be used as its effective value in this case.
When all copies of the file have been sent, bpdriver prints a performance report.
EXIT STATUS
0 bpdriver has terminated. Any problems encountered during operation will be noted in the ion.log log file.
FILES
The service data units transmitted by bpdriver are sequences of text obtained from a file in the current working directory named
"bpdriverAduFile", which bpdriver creates automatically.
ENVIRONMENT
No environment variables apply.
DIAGNOSTICS
Diagnostic messages produced by bpdriver are written to the ION log file ion.log.
Can't attach to BP.
bpadmin has not yet initialized Bundle Protocol operations.
Can't open own endpoint.
Another application has already opened ownEndpointId. Terminate that application and rerun.
Can't create ADU file
Operating system error. Check errtext, correct problem, and rerun.
Error writing to ADU file
Operating system error. Check errtext, correct problem, and rerun.
bpdriver can't create file ref.
ION system error. Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.
bpdriver can't create ZCO.
ION system error. Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.
bpdriver can't send message
Bundle Protocol service to the remote endpoint has been stopped.
bpdriver reception failed
bpdriver is in "echo" mode, and Bundle Protocol delivery service has been stopped.
BUGS
Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>
SEE ALSO
bpadmin(1), bpcounter(1), bpecho(1), bp(3)
perl v5.14.2 2012-05-25 BPDRIVER(1)