NAME

cpsd - contact plan synchronization daemon

SYNOPSIS

cpsd

DESCRIPTION

cpsd is a background "daemon" task that effects the synchronization of contact plan changes across all nodes in the region corresponding to that contact plan.

It accomplishes this by (a) de-queueing contact plan synchronization notices from the local node's ION database (inserted into that queue when contacts were added to the local node's contact plan with "announce" requested) and multicasting those notices to all other nodes in the corresponding region and (b) receiving CPS notices multicast by other cpsd tasks and applying them to the local node's contact plan for the indicated region.

cpsd 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.

Note that in order for cpsd to operate, ION must be built with multicast enabled and both the "imc" scheme and the "imc:0.1" endpoint must be defined in the configuration of the node.

EXIT STATUS

"0"

cpsd 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 contact plan synchronization.
"1"

cpsd 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 contact plan synchronization.

FILES

No configuration files are needed.

ENVIRONMENT

No environment variables apply.

DIAGNOSTICS

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

cpsd can't attach to BP.

bpadmin has not yet initialized Bundle Protocol operations.
cpsd task is already started for this node

Redundant initiation of cpsd.

BUGS

Report bugs to <https://github.com/nasa-jpl/ION-DTN/issues>