Installation guide

Chapter 24. Miscellaneous administration tasks
194
Table 24.1. Offset attribute values
Value Description
utc The guest clock will be synchronized to UTC
when booted.
localtime The guest clock will be synchronized to the
host's configured timezone when booted, if any.
timezone The guest clock will be synchronized to a given
timezone, specified by the timezone attribute.
variable The guest clock will be synchronized to an
arbitrary offset from UTC. The delta relative
to UTC is specified in seconds, using the
adjustment attribute. The guest is free to
adjust the Real Time Clock (RTC) over time and
expect that it will be honored following the next
reboot. This is in contrast to utc mode, where
any RTC adjustments are lost at each reboot.
•
timezone
The timezone to which the guest clock is to be synchronized.
•
adjustment
The delta for guest clock synchronization. In seconds, relative to UTC.
Example 24.1. Always synchronize to UTC
<clock offset="utc" />
Example 24.2. Always synchronize to the host timezone
<clock offset="localtime" />
Example 24.3. Synchronize to an arbitrary timezone
<clock offset="timezone" timezone="Europe/Paris" />
Example 24.4. Synchronize to UTC + arbitrary offset
<clock offset="variable" adjustment="123456" />
<timer>
A clock element can have zero or more timer elements as children. The timer element specifies a time
source used for guest clock synchronization. The timer element has the following attributes. Only the
name is required, all other attributes are optional.
•
name
The name of the time source to use.