NAME
tcapublish - Trusted Collective authority task that publishes consensus critical information bulletins
SYNOPSIS
tcapublish blocks_group_number
DESCRIPTION
tcapublish is a background task that completes the processing of a single iteration of the bulletin publication cycle for the collective authority function of the TC application identified by blocks_group_number on the local node. To do so, it receives proposed bulletins multicast by tcacompile daemons, resolves differences among the received bulletins to arrive at a consensus bulletin, computes a hash for the consensus bulletin, erasure-codes the consensus bulletin, and multicasts that subset of the resulting code blocks that is allocated to the local node according to the local node's assigned position in the authority array of the application's collective authority. It is spawned automatically by the local node's tcacompile daemon for the indicated application, at the time that daemon publishes its own proposed bulletin for this iteration of the bulletin compilation cycle; it terminates immediately after it has finished publishing code blocks.
EXIT STATUS
-
"0"
tcapublish terminated, for reasons noted in the ion.log file.
-
"1"
tcapublish was unable to attach to TC authority operations, probably because tcaadmin has not yet been run.
FILES
No configuration files are needed.
ENVIRONMENT
No environment variables apply.
DIAGNOSTICS
The following diagnostics may be issued to the ion.log log file:
-
tcapublish can't attach to DTKA.
tcaadmin has not yet initialized the authority database for this TC application.
BUGS
Report bugs to <https://github.com/nasa-jpl/ION-DTN/issues>
SEE ALSO
tcaadmin(1), tc(3), tcauthrc(5)