---
name: "dtpcclock"
section: "1"
platform: "linux"
package: "ion"
version: "3.2.1+dfsg-1.1"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/dtpcclock"
---

# dtpcclock(1)

DTPC daemon task for managing scheduled events

## NAME

dtpcclock - DTPC daemon task for managing scheduled events

## SYNOPSIS

**dtpcclock**

## DESCRIPTION

**dtpcclock** is a background "daemon" task that periodically performs scheduled DTPC activities.  It is spawned automatically by **dtpcadmin** in response to the 's' command that starts operation of the DTPC protocol, and it is terminated by **dtpcadmin** in response to an 'x' (STOP) command.

Once per second, **dtpcclock** takes the following action:

First it executes all DTPC events scheduled to occur at any time up to the current moment:

DTPC ADUs for which an expected positive acknowledgment has not yet arrived are retransmitted.

Received DTPC ADUs whose time to live has elapsed are deleted.

Then **dtpcclock** increases the ages of all DTPC ADUs pending transmission and initiates transmission of each such ADU whose age now equals or exceeds its aggregation time limit.

## EXIT STATUS

- 0

  **dtpcclock** terminated, 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 **dtpcadmin** to restart **dtpcclock**.

- 1

  **dtpcclock** was unable to attach to DTPC protocol operations, probably because **dtpcadmin** 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:

- dtpcclock can't initialize DTPC.

  **dtpcadmin** has not yet initialized DTPC protocol operations.

- Can't send finished adu.

  An unrecoverable database error was encountered.  **dtpcclock** terminates.

- Can't stop aggregation for adu.

  An unrecoverable database error was encountered.  **dtpcclock** terminates.

- Could not scan outbound Adus

  An unrecoverable database error was encountered.  **dtpcclock** terminates.

## BUGS

Report bugs to \<ion-bugs@korgano.eecs.ohiou.edu\>

## SEE ALSO

[*dtpcadmin*(1)](/dtpcadmin/1.md)