rtc

rtc --get-clock [-m MODULE]
rtc --set-clock [-aA] [-m MODULE] [TIME]

Views and sets the module’s real-time clock.

Option Description

Action selection

-g, --get-clock

Gets (reads) the module’s clock time (default).

-t, --set-clock

Sets (writes) the module’s clock.
Setting the module’s clock usually requires the insertion of administrator cards. To try anyway, without any admin cards, use `--no-admin-keys'.
The module’s clock is set to one of:

  • TIME, if it is provided as a list of six integers (in the order of yyyy mm dd hh mm ss), separated by non-digit characters

  • the host’s current time

Clock setting options

a, --no-admin-keys

Doesn’t read admin cards.

-A, --adjust

Calibrates clock drift.
The module uses the difference between its idea of the current time and the new time, together with how long it’s been since the clock was last set, to compute how much its clock is drifting.
Assuming that the host has an accurate clock, for example, it runs an NTP client, you can calibrate the drift by running `rtc --set-clock', and then, about 24 hours later, `rtc --set-clock --adjust'.

Option to address HSMs

-m, --module=<MODULE>

Read or write the clock of module MODULE (default = module 1).

Help options

-h, --help

Displays help for rtc.

-u, --usage

Displays a brief usage summary for rtc.

-v, --version

Displays the version number of the Security World Software that deploys rtc.