arch/x86/kernel/pvclock.c
Source file repositories/reference/linux-study-clean/arch/x86/kernel/pvclock.c
File Facts
- System
- Linux kernel
- Corpus path
arch/x86/kernel/pvclock.c- Extension
.c- Size
- 4297 bytes
- Lines
- 167
- Domain
- Architecture Layer
- Bucket
- arch/x86
- Inferred role
- Architecture Layer: exported/initcall integration point
- Status
- integration implementation candidate
Why This File Exists
CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.
- CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.
- Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/clocksource.hlinux/kernel.hlinux/percpu.hlinux/notifier.hlinux/sched.hlinux/gfp.hlinux/memblock.hlinux/nmi.hasm/fixmap.hasm/pvclock.hasm/vgtod.h
Detected Declarations
function pvclock_set_flagsfunction pvclock_tsc_khzfunction pvclock_touch_watchdogsfunction pvclock_resumefunction pvclock_read_flagsfunction __pvclock_clocksource_readfunction pvclock_clocksource_readfunction pvclock_clocksource_read_nowdfunction pvclock_read_wallclockfunction pvclock_set_pvti_cpu0_vaexport pvclock_get_pvti_cpu0_va
Annotated Snippet
// SPDX-License-Identifier: GPL-2.0-or-later
/* paravirtual clock -- common code used by kvm/xen
*/
#include <linux/clocksource.h>
#include <linux/kernel.h>
#include <linux/percpu.h>
#include <linux/notifier.h>
#include <linux/sched.h>
#include <linux/gfp.h>
#include <linux/memblock.h>
#include <linux/nmi.h>
#include <asm/fixmap.h>
#include <asm/pvclock.h>
#include <asm/vgtod.h>
static u8 valid_flags __read_mostly = 0;
static struct pvclock_vsyscall_time_info *pvti_cpu0_va __read_mostly;
void pvclock_set_flags(u8 flags)
{
valid_flags = flags;
}
unsigned long pvclock_tsc_khz(struct pvclock_vcpu_time_info *src)
{
u64 pv_tsc_khz = 1000000ULL << 32;
do_div(pv_tsc_khz, src->tsc_to_system_mul);
if (src->tsc_shift < 0)
pv_tsc_khz <<= -src->tsc_shift;
else
pv_tsc_khz >>= src->tsc_shift;
return pv_tsc_khz;
}
void pvclock_touch_watchdogs(void)
{
touch_softlockup_watchdog_sync();
clocksource_touch_watchdog();
rcu_cpu_stall_reset();
reset_hung_task_detector();
}
static atomic64_t last_value = ATOMIC64_INIT(0);
void pvclock_resume(void)
{
atomic64_set(&last_value, 0);
}
u8 pvclock_read_flags(struct pvclock_vcpu_time_info *src)
{
unsigned version;
u8 flags;
do {
version = pvclock_read_begin(src);
flags = src->flags;
} while (pvclock_read_retry(src, version));
return flags & valid_flags;
}
static __always_inline
u64 __pvclock_clocksource_read(struct pvclock_vcpu_time_info *src, bool dowd)
{
unsigned version;
u64 ret;
u64 last;
u8 flags;
do {
version = pvclock_read_begin(src);
ret = __pvclock_read_cycles(src, rdtsc_ordered());
flags = src->flags;
} while (pvclock_read_retry(src, version));
if (dowd && unlikely((flags & PVCLOCK_GUEST_STOPPED) != 0)) {
src->flags &= ~PVCLOCK_GUEST_STOPPED;
pvclock_touch_watchdogs();
}
if ((valid_flags & PVCLOCK_TSC_STABLE_BIT) &&
(flags & PVCLOCK_TSC_STABLE_BIT))
return ret;
/*
Annotation
- Immediate include surface: `linux/clocksource.h`, `linux/kernel.h`, `linux/percpu.h`, `linux/notifier.h`, `linux/sched.h`, `linux/gfp.h`, `linux/memblock.h`, `linux/nmi.h`.
- Detected declarations: `function pvclock_set_flags`, `function pvclock_tsc_khz`, `function pvclock_touch_watchdogs`, `function pvclock_resume`, `function pvclock_read_flags`, `function __pvclock_clocksource_read`, `function pvclock_clocksource_read`, `function pvclock_clocksource_read_nowd`, `function pvclock_read_wallclock`, `function pvclock_set_pvti_cpu0_va`.
- Atlas domain: Architecture Layer / arch/x86.
- Implementation status: integration implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.