include/linux/context_tracking.h
Source file repositories/reference/linux-study-clean/include/linux/context_tracking.h
File Facts
- System
- Linux kernel
- Corpus path
include/linux/context_tracking.h- Extension
.h- Size
- 4510 bytes
- Lines
- 173
- Domain
- Core OS
- Bucket
- Core Kernel Interface
- Inferred role
- Core OS: implementation source
- Status
- source implementation candidate
Why This File Exists
Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.
- Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
Dependency Surface
linux/sched.hlinux/vtime.hlinux/context_tracking_state.hlinux/instrumentation.hasm/ptrace.h
Detected Declarations
function user_enterfunction user_exitfunction user_enter_irqofffunction user_exit_irqofffunction exception_enterfunction exception_exitfunction context_tracking_guest_enterfunction context_tracking_guest_exitfunction user_enterfunction exception_exitfunction __ct_statefunction context_tracking_guest_enterfunction context_tracking_guest_exitfunction context_tracking_initfunction CPUfunction ct_state_incfunction warn_rcu_enterfunction warn_rcu_exitfunction ct_idle_enterfunction warn_rcu_exit
Annotated Snippet
context_tracking_enabled()) {
if (prev_ctx != CT_STATE_KERNEL)
ct_user_enter(prev_ctx);
}
}
static __always_inline bool context_tracking_guest_enter(void)
{
if (context_tracking_enabled())
__ct_user_enter(CT_STATE_GUEST);
return context_tracking_enabled_this_cpu();
}
static __always_inline bool context_tracking_guest_exit(void)
{
if (context_tracking_enabled())
__ct_user_exit(CT_STATE_GUEST);
return context_tracking_enabled_this_cpu();
}
#define CT_WARN_ON(cond) WARN_ON(context_tracking_enabled() && (cond))
#else
static inline void user_enter(void) { }
static inline void user_exit(void) { }
static inline void user_enter_irqoff(void) { }
static inline void user_exit_irqoff(void) { }
static inline int exception_enter(void) { return 0; }
static inline void exception_exit(enum ctx_state prev_ctx) { }
static inline int ct_state(void) { return -1; }
static inline int __ct_state(void) { return -1; }
static __always_inline bool context_tracking_guest_enter(void) { return false; }
static __always_inline bool context_tracking_guest_exit(void) { return false; }
#define CT_WARN_ON(cond) do { } while (0)
#endif /* !CONFIG_CONTEXT_TRACKING_USER */
#ifdef CONFIG_CONTEXT_TRACKING_USER_FORCE
extern void context_tracking_init(void);
#else
static inline void context_tracking_init(void) { }
#endif /* CONFIG_CONTEXT_TRACKING_USER_FORCE */
#ifdef CONFIG_CONTEXT_TRACKING_IDLE
extern void ct_idle_enter(void);
extern void ct_idle_exit(void);
/*
* Is RCU watching the current CPU (IOW, it is not in an extended quiescent state)?
*
* Note that this returns the actual boolean data (watching / not watching),
* whereas ct_rcu_watching() returns the RCU_WATCHING subvariable of
* context_tracking.state.
*
* No ordering, as we are sampling CPU-local information.
*/
static __always_inline bool rcu_is_watching_curr_cpu(void)
{
return raw_atomic_read(this_cpu_ptr(&context_tracking.state)) & CT_RCU_WATCHING;
}
/*
* Increment the current CPU's context_tracking structure's ->state field
* with ordering. Return the new value.
*/
static __always_inline unsigned long ct_state_inc(int incby)
{
return raw_atomic_add_return(incby, this_cpu_ptr(&context_tracking.state));
}
static __always_inline bool warn_rcu_enter(void)
{
bool ret = false;
/*
* Horrible hack to shut up recursive RCU isn't watching fail since
* lots of the actual reporting also relies on RCU.
*/
preempt_disable_notrace();
if (!rcu_is_watching_curr_cpu()) {
ret = true;
ct_state_inc(CT_RCU_WATCHING);
}
return ret;
}
static __always_inline void warn_rcu_exit(bool rcu)
{
Annotation
- Immediate include surface: `linux/sched.h`, `linux/vtime.h`, `linux/context_tracking_state.h`, `linux/instrumentation.h`, `asm/ptrace.h`.
- Detected declarations: `function user_enter`, `function user_exit`, `function user_enter_irqoff`, `function user_exit_irqoff`, `function exception_enter`, `function exception_exit`, `function context_tracking_guest_enter`, `function context_tracking_guest_exit`, `function user_enter`, `function exception_exit`.
- Atlas domain: Core OS / Core Kernel Interface.
- Implementation status: source implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
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.