PERF-LOCK(1)                      perf Manual                     PERF-LOCK(1)

<?><?><?> (NAME)
       perf-lock - <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       perf lock {record|report|script|info|contention}

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?> <?><?><?><?><?> perf lock <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.

           <?><?><?><?><?> 'perf lock record <command>' <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?>
           <?><?><?><?> <?> <?><?><?><?><?> <command> <?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?> "perf.data" <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>.

           <?><?><?><?><?> 'perf lock report' <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?> 'perf lock script' <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?> 'perf lock info' <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?> 'perf lock contention' <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       -i, --input=<file>
           <?><?><?> <?><?><?><?> <?><?><?><?><?>. (<?><?><?><?><?><?><?>:
           perf.data <?><?><?> <?><?><?><?><?> stdin <?><?> fifo <?><?><?><?>)

       --output=<file>
           <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> perf lock
           contention <?> report.

       -v, --verbose
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           (<?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?>).

       -q, --quiet
           <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?>. (<?><?><?><?><?><?><?><?><?> -v)

       -D, --dump-raw-trace
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> (raw trace) <?><?>
           <?><?><?><?> ASCII.

       -f, --force
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?>.

       --vmlinux=<file>
           <?><?><?><?> <?><?><?><?> vmlinux

       --kallsyms=<file>
           <?><?><?><?> <?><?><?><?> kallsyms

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (REPORT OPTIONS)
       -k, --key=<value>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?>. <?><?><?><?><?><?>
           <?><?><?><?>: acquired (<?><?><?><?><?><?><?>)<?> contended<?>
           avg_wait<?> wait_total<?> wait_max<?> wait_min.

       -F, --field=<value>
           <?><?><?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?>
           <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>.
           <?><?><?><?><?><?> <?><?><?><?>: acquired<?> contended<?>
           avg_wait<?> wait_total<?> wait_max<?> wait_min.

       -c, --combine-locks
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> (<?><?> <?><?><?><?> <?><?><?>).

       -t, --threads
           <?><?><?><?><?><?> -t <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?> (per-thread)
           <?><?><?><?><?> <?><?><?> <?><?><?>:

               $ perf lock report -t -F acquired,contended,avg_wait

               Name   acquired  contended   avg wait (ns)

                          perf     240569          9            5784
                       swapper     106610         19             543
                        :15789      17370          2           14538
                  ContainerMgr       8981          6             874
                         sleep       5275          1           11281
               ContainerThread       4416          4             944
               RootPressureThr       3215          5            1215
                   rcu_preempt       2954          0               0
                  ContainerMgr       2560          0               0
                       unnamed       1873          0               0
               EventManager_De       1845          1             636
               futex-default-S       1609          0               0

       -E, --entries=<value>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>.

           -t, --threads
               <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
               thread<?><?> <?><?> perf.data.

           -m, --map
               <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?> <?><?><?> (<?><?><?><?>
               address:name).

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (CONTENTION OPTIONS)
       -k, --key=<value>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?>. <?><?><?><?><?><?>
           <?><?><?><?>: contended<?> wait_total (<?><?><?><?><?><?><?>)<?>
           wait_max<?> wait_min<?> avg_wait.

       -F, --field=<value>
           <?><?><?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?><?><?> wait_min <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?><?>
           <?><?><?><?>: contended<?> wait_total<?> wait_max<?> wait_min<?>
           avg_wait.

       -t, --threads
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
           <?><?><?><?> <?><?> thread.

       -b, --use-bpf
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> BPF <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?>.

       -a, --all-cpus
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?> CPU<?><?>.

       -C, --cpu=<value>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?><?> CPU<?><?><?> <?><?><?><?><?><?><?><?><?>.
           <?><?><?><?><?> CPU <?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?>: 0,1. <?><?><?><?><?><?><?><?> CPU <?><?> - <?><?><?><?>
           <?><?><?><?><?><?><?>: 0-2. <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?> CPU<?><?> <?><?><?>.

       -p, --pid=<value>
           <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> (PID) <?><?><?><?><?> (<?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?>).

       --tid=<value>
           <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> thread
           <?><?><?><?><?> (<?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?>).

       -M, --map-nr-entries=<value>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> BPF (<?><?><?><?><?><?><?>: 16384). <?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?> <?><?><?><?>
           <?><?><?><?><?> <?><?>.

       --max-stack=<value>
           <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
           (<?><?><?><?><?><?><?>: 8).

       --stack-skip=<value>
           <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?>
           (<?><?><?><?><?><?><?>: 3).

       -E, --entries=<value>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>.

       -l, --lock-addr
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?>.

       -o, --lock-owner
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> -t <?><?> <?><?><?><?> <?><?><?>
           <?><?> thread <?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> -v <?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?>. <?><?><?><?><?><?><?> --use-bpf <?><?><?>.

       -Y, --type-filter=<value>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> (<?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?>). <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>: semaphore, spinlock,
           rwlock, rwlock:R, rwlock:W, rwsem, rwsem:R, rwsem:W, rtmutex,
           rwlock-rt, rwlock-rt:R, rwlock-rt:W, percpu-rwmem, pcpu-sem,
           pcpu-sem:R, pcpu-sem:W, mutex

               <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> RW <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> :R <?> :W <?><?><?><?><?>.  <?><?><?><?><?><?><?> <?><?><?><?>
               <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>.  <?><?><?><?>: rwsem = rwsem:R + rwsem:W.

       -L, --lock-filter=<value>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?> (<?><?><?><?><?> <?><?><?><?><?><?>
           <?><?> <?><?><?><?>).

       -S, --callstack-filter=<value>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?> callstack <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> rq <?><?> <?><?>
           raw_spin_rq_lock <?> <?><?> <?><?> irq_enter_rcu <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?>.

       -x, --field-separator=<SEP>
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?> CSV <?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> SEP <?><?><?>
           <?><?><?><?><?><?><?>.

       --lock-cgroup
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
           <?><?><?><?> cgroup. <?><?><?><?><?><?><?> --use-bpf <?><?><?>.

       -G, --cgroup-filter=<value>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
           cgroup<?><?><?> <?><?><?><?><?><?><?><?> (<?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?>).

       -J, --inject-delay=<time@function[1]>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?> (<?><?><?><?>) <?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?>. <?><?><?> <?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>.
           <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> -b/--use-bpf
           <?><?><?> <?><?><?><?><?><?>.

               <?><?><?><?><?> 'time' <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.  <?><?><?><?><?><?><?>
               <?><?><?><?><?> "ms" <?>"us" <?> "ns" <?><?><?><?><?>.  <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> 10ms <?><?><?><?><?>
               <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

               <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> (busy-wait) <?><?> <?><?><?><?><?> <?><?><?>.  <?><?><?><?><?> <?><?><?><?><?>
               <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.  <?><?><?><?><?>
               <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>.

           perf(1)

<?><?><?><?> (NOTES)
        1. time@function
           mailto:time@function

perf                              09/04/2026                      PERF-LOCK(1)