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

# rfxclock(1)

ION daemon task for managing scheduled events

## NAME

rfxclock - ION daemon task for managing scheduled events

## SYNOPSIS

**rfxclock**

## DESCRIPTION

**rfxclock** is a background "daemon" task that periodically applies scheduled changes in node connectivity and range to the ION node's database. It is spawned automatically by **ionadmin** in response to the 's' command that starts operation of the ION node infrastructure, and it is terminated by **ionadmin** in response to an 'x' (STOP) command.

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

For each neighboring node that has been refusing custody of bundles sent to it to be forwarded to some destination node, to which no such bundle has been sent for at least N seconds (where N is twice the one-way light time from the local node to this neighbor), **rfxclock** turns on a *probeIsDue* flag authorizing transmission of the next such bundle in hopes of learning that this neighbor is now able to accept custody.

Then **rfxclock** purges the database of all range and contact information that is no longer applicable, based on the stop times of the records.

Finally, **rfxclock** applies to the database all range and contact information that is currently applicable, i.e., those records whose start times are before the current time and whose stop times are in the future.

## EXIT STATUS

- "0"

  **rfxclock** 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 **ionadmin** to restart **rfxclock**.

- "1"

  **rfxclock** was unable to attach to the local ION node, probably because **ionadmin** 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:

- rfxclock can't attach to ION.

  **ionadmin** has not yet initialized the ION database.

- Can't apply ranges.

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

- Can't apply contacts.

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

- Can't purge ranges.

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

- Can't purge contacts.

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

## BUGS

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

## SEE ALSO

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