Enum TimelineEvent 

#[non_exhaustive]
pub enum TimelineEvent {
    Switch {
        ts: u64,
        cpu: u32,
        prev_pid: u32,
        next_pid: u32,
        prev_state: u64,
        preempt: bool,
    },
    Migrate {
        ts: u64,
        cpu: u32,
        pid: u32,
        orig_cpu: u32,
        dest_cpu: u32,
    },
    Wakeup {
        ts: u64,
        cpu: u32,
        pid: u32,
        target_cpu: u32,
    },
    PiBoost {
        ts: u64,
        cpu: u32,
        prober_tid: u32,
        pid: u32,
        old_prio: i32,
        new_prio: i32,
    },
    LockContend {
        ts: u64,
        cpu: u32,
        tid: u32,
        lock_kva: u64,
        flags: u32,
    },
    Unknown {
        ts: u64,
        cpu: u32,
        type_: u32,
        prev_pid: u32,
        next_pid: u32,
        a: u64,
        b: u64,
    },
}

Parsed timeline event with variant-aware field naming.

non_exhaustive so future BPF event types added in intf.h (per the TL_EVT_PI_BOOST / TL_EVT_LOCK_CONTEND sites) can land without breaking existing on-disk dumps.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Switch

tp_btf/sched_switch. The kernel switched from prev_pid to next_pid on cpu at ts (boot-time ns).

Fields

ts: u64

cpu: u32

prev_pid: u32

next_pid: u32

prev_state: u64

Raw prev_state bitfield (TASK_RUNNING / TASK_INTERRUPTIBLE / etc., from include/linux/sched.h).

preempt: bool

True when the switch was a preemption (vs voluntary dequeue).

Migrate

tp_btf/sched_migrate_task. Task pid migrated from orig_cpu to dest_cpu.

Fields

ts: u64

cpu: u32

pid: u32

orig_cpu: u32

dest_cpu: u32

Wakeup

tp_btf/sched_wakeup. Task pid woken up; scheduler chose target_cpu for placement.

Fields

ts: u64

cpu: u32

pid: u32

target_cpu: u32

PiBoost

PI boost. Probe-context tid prober_tid; boosted task pid. old_prio/new_prio are the boosted task’s effective kernel priority (signed int) before and after the boost. Scheduling-class transitions are counted separately via the pi_class_changes counter, not carried in this record. Field layout per src/bpf/intf.h::TL_EVT_PI_BOOST.

Fields

ts: u64

cpu: u32

prober_tid: u32

pid: u32

old_prio: i32

new_prio: i32

LockContend

Lock contention begin. tid is the waiter; lock_kva is the lock’s kernel virtual address; flags carries the LCB_* class bits (F_SPIN, F_READ, F_WRITE, F_RT — see include/trace/events/lock.h).

Fields

ts: u64

cpu: u32

tid: u32

lock_kva: u64

flags: u32

Unknown

Unrecognized type byte. Library doesn’t drop unknown records — surfacing them as Unknown lets the failure dump preserve forward-compat data the consumer can opt into rendering later.

Fields

ts: u64

cpu: u32

type_: u32

prev_pid: u32

next_pid: u32

a: u64

b: u64

Trait Implementations

impl Clone for TimelineEvent

fn clone(&self) -> TimelineEvent

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TimelineEvent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TimelineEvent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TimelineEvent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.