NAME¶
bpsource - Bundle Protocol transmission test shell
SYNOPSIS¶
bpsource destinationEndpointId ['
text'] [-t
TTL]
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)