┌──────────────┬────────────┬────────────┬───────────────────────┬───────────────────┐ │              │            │            │                       │                   │ │Variable      │ Type       │ Kernel     │ BPF Helper            │ Description       │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │$1, $2, ...$n │ int64      │ n/a        │ n/a                   │ The nth           │ │              │            │            │                       │ positional        │ │              │            │            │                       │ parameter         │ │              │            │            │                       │ passed to the     │ │              │            │            │                       │ bpftrace          │ │              │            │            │                       │ program. If       │ │              │            │            │                       │ less than n       │ │              │            │            │                       │ parameters        │ │              │            │            │                       │ are passed        │ │              │            │            │                       │ this              │ │              │            │            │                       │ evaluates to      │ │              │            │            │                       │ 0. For string     │ │              │            │            │                       │ arguments use     │ │              │            │            │                       │ the str()         │ │              │            │            │                       │ call to           │ │              │            │            │                       │ retrieve the      │ │              │            │            │                       │ value.            │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │$#            │ int64      │ n/a        │ n/a                   │ Total amount      │ │              │            │            │                       │ of positional     │ │              │            │            │                       │ parameters        │ │              │            │            │                       │ passed.           │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │arg0, arg1,   │ int64      │ n/a        │ n/a                   │ nth argument      │ │...argn       │            │            │                       │ passed to the     │ │              │            │            │                       │ function          │ │              │            │            │                       │ being traced.     │ │              │            │            │                       │ These are         │ │              │            │            │                       │ extracted         │ │              │            │            │                       │ from the CPU      │ │              │            │            │                       │ registers.        │ │              │            │            │                       │ The amount of     │ │              │            │            │                       │ args passed       │ │              │            │            │                       │ in registers      │ │              │            │            │                       │ depends on        │ │              │            │            │                       │ the CPU           │ │              │            │            │                       │ architecture.     │ │              │            │            │                       │ (kprobes,         │ │              │            │            │                       │ uprobes,          │ │              │            │            │                       │ usdt).            │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │cgroup        │ uint64     │ 4.18       │ get_current_cgroup_id │ ID of the         │ │              │            │            │                       │ cgroup the        │ │              │            │            │                       │ current task      │ │              │            │            │                       │ is in. Only       │ │              │            │            │                       │ works with        │ │              │            │            │                       │ cgroupv2.         │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │comm          │ string[16] │ 4.2        │ get_current_com       │ comm of the       │ │              │            │            │                       │ current task.     │ │              │            │            │                       │ Equal to the      │ │              │            │            │                       │ value in          │ │              │            │            │                       │ /proc/<pid>/comm  │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │cpid          │ uint32     │ n/a        │ n/a                   │ PID of the child  │ │              │            │            │                       │ process           │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │cpu           │ uint32     │ 4.1        │ raw_smp_processor_id  │ ID of the         │ │              │            │            │                       │ processor         │ │              │            │            │                       │ executing the     │ │              │            │            │                       │ BPF program       │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │curtask       │ uint64     │ 4.8        │ get_current_task      │ Pointer to        │ │              │            │            │                       │ struct            │ │              │            │            │                       │ task_struct of    │ │              │            │            │                       │ the current task  │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │elapsed       │ uint64     │ (see nsec) │ ktime_get_ns /        │ Nanoseconds       │ │              │            │            │ ktime_get_boot_ns     │ elapsed since     │ │              │            │            │                       │ bpftrace          │ │              │            │            │                       │ initialization,   │ │              │            │            │                       │ based on nsecs    │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │func          │ string     │ n/a        │ n/a                   │ Name of the       │ │              │            │            │                       │ current function  │ │              │            │            │                       │ being traced      │ │              │            │            │                       │ (kprobes,uprobes) │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │gid           │ uint64     │ 4.2        │ get_current_uid_gid   │ GID of current    │ │              │            │            │                       │ task              │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │kstack        │ kstack     │            │ get_stackid           │ Kernel stack      │ │              │            │            │                       │ trace             │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │nsecs         │ uint64     │ 4.1 / 5.7  │ ktime_get_ns /        │ nanoseconds since │ │              │            │            │ ktime_get_boot_ns     │ kernel boot. On   │ │              │            │            │                       │ kernels that      │ │              │            │            │                       │ support           │ │              │            │            │                       │ ktime_get_boot_ns │ │              │            │            │                       │ this includes the │ │              │            │            │                       │ time spent        │ │              │            │            │                       │ suspended, on     │ │              │            │            │                       │ older kernels it  │ │              │            │            │                       │ does not.         │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │pid           │ uint64     │ 4.2        │ get_current_pid_tgid  │ Process ID (or    │ │              │            │            │                       │ thread group ID)  │ │              │            │            │                       │ of the current    │ │              │            │            │                       │ task.             │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │probe         │ string     │ n/na       │ n/a                   │ Name of the       │ │              │            │            │                       │ current probe     │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │rand          │ uint32     │ 4.1        │ get_prandom_u32       │ Random number     │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │retval        │ int64      │ n/a        │ n/a                   │ Value returned by │ │              │            │            │                       │ the function      │ │              │            │            │                       │ being traced      │ │              │            │            │                       │ (kretprobe,       │ │              │            │            │                       │ uretprobe,        │ │              │            │            │                       │ kretfunc)         │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │sarg0, sarg1, │ int64      │ n/a        │ n/a                   │ nth stack value   │ │...sargn      │            │            │                       │ of the function   │ │              │            │            │                       │ being traced.     │ │              │            │            │                       │ (kprobes,         │ │              │            │            │                       │ uprobes).         │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │tid           │ uint64     │ 4.2        │ get_current_pid_tgid  │ Thread ID of the  │ │              │            │            │                       │ current task.     │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │uid           │ uint64     │ 4.2        │ get_current_uid_gid   │ UID of current    │ │              │            │            │                       │ task              │ ├──────────────┼────────────┼────────────┼───────────────────────┼───────────────────┤ │              │            │            │                       │                   │ │ustack        │ ustack     │ 4.6        │ get_stackid           │ Userspace stack   │ │              │            │            │                       │ trace             │ └──────────────┴────────────┴────────────┴───────────────────────┴───────────────────┘