https://github.com/amurzeau/guest-vm-sync-time-rtc

Synchronize a VM guest system time with RTC time when the RTC time jump (for example by a host suspend or VM suspend)
https://github.com/amurzeau/guest-vm-sync-time-rtc

guest qemu rtc sync synchronization system time virtual-machine vm

Last synced: about 1 month ago
JSON representation

Synchronize a VM guest system time with RTC time when the RTC time jump (for example by a host suspend or VM suspend)

• Host: GitHub
• URL: https://github.com/amurzeau/guest-vm-sync-time-rtc
• Owner: amurzeau
• License: mit
• Created: 2022-07-09T10:56:51.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2022-07-09T14:46:25.000Z (over 2 years ago)
• Last Synced: 2023-03-02T13:17:03.505Z (almost 2 years ago)
• Topics: guest, qemu, rtc, sync, synchronization, system, time, virtual-machine, vm
• Language: C
• Homepage:
• Size: 11.7 KB
• Stars: 1
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# guest-vm-sync-time-rtc

This tool allow synchronizing a guest VM system time running Linux with the RTC.

This is used to keep the guest time synchronized with the host time when:

  - The host was suspended

  - The guest was suspended

  - Any other case where the host clock time jump

When this happen, the guest's system time will be in the past and won't be updated with the hardware time.

Solutions to this are:

  - Run a NTP daemon to keep the system time in sync with the real time

  - If internet is not available, you can try to sync the system time with a PTP device

  - If a PTP is not available, you can use this tool to synchronize with the hardware RTC

    (which is kept up to date with the host's system time by the hypervisor). This can be

    needed with qemu on Windows for example.

# Algorithm

This tool does this:

  - Every minute, read the RTC clock, and check if it jumped since previous read (with a margin of

    +/-10%)

  - If the RTC clock jumped forward, set the system time with the current RTC time

Note: if the RTC time jump but its time is lower than the system time, the system time won't be updated

to avoid jumping the system time back in the past. This is not handled in most application and will cause

crashes.