^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) /* SPDX-License-Identifier: GPL-2.0 */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) #ifndef _ASM_X86_PVCLOCK_ABI_H
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) #define _ASM_X86_PVCLOCK_ABI_H
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) #ifndef __ASSEMBLY__
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) * These structs MUST NOT be changed.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) * They are the ABI between hypervisor and guest OS.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) * Both Xen and KVM are using this.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) * pvclock_vcpu_time_info holds the system time and the tsc timestamp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) * of the last update. So the guest can use the tsc delta to get a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) * more precise system time. There is one per virtual cpu.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) * pvclock_wall_clock references the point in time when the system
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) * time was zero (usually boot time), thus the guest calculates the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) * current wall clock by adding the system time.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) * Protocol for the "version" fields is: hypervisor raises it (making
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) * it uneven) before it starts updating the fields and raises it again
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) * (making it even) when it is done. Thus the guest can make sure the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) * time values it got are consistent by checking the version before
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) * and after reading them.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) struct pvclock_vcpu_time_info {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) u32 version;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) u32 pad0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) u64 tsc_timestamp;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) u64 system_time;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) u32 tsc_to_system_mul;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) s8 tsc_shift;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) u8 flags;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) u8 pad[2];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) } __attribute__((__packed__)); /* 32 bytes */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) struct pvclock_wall_clock {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) u32 version;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) u32 sec;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) u32 nsec;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) } __attribute__((__packed__));
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) #define PVCLOCK_TSC_STABLE_BIT (1 << 0)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) #define PVCLOCK_GUEST_STOPPED (1 << 1)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) /* PVCLOCK_COUNTS_FROM_ZERO broke ABI and can't be used anymore. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) #define PVCLOCK_COUNTS_FROM_ZERO (1 << 2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) #endif /* __ASSEMBLY__ */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) #endif /* _ASM_X86_PVCLOCK_ABI_H */