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)