NAME¶
stcpclo - DTN simple TCP convergence layer adapter output task
SYNOPSIS¶
stcpclo remote_hostname[:
remote_port_nbr]
DESCRIPTION¶
stcpclo is a background "daemon" task that connects to a remote
node's TCP socket at
remote_hostname and
remote_port_nbr. It
then begins extracting bundles from the queues of bundles ready for
transmission via TCP to this remote bundle protocol agent and transmitting
those bundles over the connected socket to that node. Each transmitted bundle
is preceded by a 32-bit integer in network byte order indicating the length of
the bundle.
If not specified,
remote_port_nbr defaults to 4556.
Note that
stcpclo is not a "promiscuous" convergence layer
daemon: it can transmit bundles only to the node to which it is connected, so
scheme configuration directives that cite this outduct need only provide the
protocol name and the outduct name as specified on the command line when
stcpclo is started.
stcpclo is spawned automatically by
bpadmin in response to the 's'
(START) command that starts operation of the Bundle Protocol, and it is
terminated by
bpadmin in response to an 'x' (STOP) command.
stcpclo can also be spawned and terminated in response to START and
STOP commands that pertain specifically to the STCP convergence layer
protocol.
EXIT STATUS¶
- "0"
- stcpclo terminated normally, for reasons noted in the
ion.log file. If this termination was not commanded, investigate
and solve the problem identified in the log file and use bpadmin to
restart the STCP protocol.
- "1"
- stcpclo terminated abnormally, for reasons noted in the
ion.log file. Investigate and solve the problem identified in the
log file, then use bpadmin to restart the STCP protocol.
FILES¶
No configuration files are needed.
ENVIRONMENT¶
No environment variables apply.
DIAGNOSTICS¶
The following diagnostics may be issued to the
ion.log log file:
- stcpclo can't attach to BP.
- bpadmin has not yet initialized Bundle Protocol operations.
- No such stcp duct.
- No STCP outduct with duct name matching remote_hostname and
remote_port_nbr has been added to the BP database. Use
bpadmin to stop the STCP convergence-layer protocol, add the
outduct, and then restart the STCP protocol.
- CLO task is already started for this duct.
- Redundant initiation of stcpclo.
- Can't get IP address for host
- Operating system error. Check errtext, correct problem, and restart
STCP.
BUGS¶
Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>
SEE ALSO¶
bpadmin(1),
bprc(5),
stcpcli(1)