ptsematest(8)                                                    ptsematest(8)

# SPDX-License-Identifier: GPL-2.0-or-later

<?><?><?> (NAME)
       ptsematest - <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> POSIX mutex

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       ptsematest [-a|--affinity [PROC]] [-b|--breaktrace USEC] [-d|--distance
       DIST] [-D|--duration TIME] [-h|--help] [-i|--interval INTV] [--json
       FILENAME] [-l|--loops LOOPS] [-p|--prio PRIO] [-q|--quiet] [-S|--smp]
       [-t|--threads [NUM]]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> ptsematest <?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> pthread_mutex_unlock()
       <?> pthread_mutex_lock() <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -a, --affinity[=PROC]
              <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              PROC. <?><?><?> PROC <?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?>.

       -b, --breaktrace=USEC
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              (break trace) <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?> USEC <?><?><?><?>. <?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              (realtime preemption patch) <?><?><?>. <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?>.

       -d, --distance=DIST
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
              (<?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?>). <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> -t <?><?><?><?><?><?><?><?> <?><?><?> <?>
              <?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?>: Interval(thread N) =
              Interval(thread N-1) + DIST

       -D, --duration=TIME
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?>.
              <?><?><?><?><?><?> 'm'<?> 'h' <?><?> 'd' <?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?>.

       -h, --help
              <?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       -i, --interval=INTV
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?>(<?><?>) <?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?> (<?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?>).
              <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?> -d <?><?>
              <?><?><?><?><?><?>.

       --json=FILENAME
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> FILENAME
              <?><?> <?><?><?><?> JSON.

       -l, --loops=LOOPS
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              (<?><?><?><?><?><?><?>). <?><?><?><?><?> <?><?><?><?><?><?><?> 0
              (<?><?><?><?><?><?><?><?>) <?><?><?>. <?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>.
              <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              ptsematest <?><?><?><?><?> <?><?><?><?><?><?>.

       -p, --prio=PRIO
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.

       -q, --quiet
              <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?>. <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.

       -S, --smp
              <?><?><?><?><?> SMP: <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              -a <?> -t <?> <?><?><?><?><?><?> <?><?><?><?><?>.

       -t, --threads[=NUM]
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> (<?><?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?>
              <?><?><?>). <?><?><?> NUM <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> NUM <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?> NUM <?><?><?><?> <?><?><?><?><?>
              NUM <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?> (4-way processor) <?><?><?><?> <?><?><?>
       <?><?><?>:

       # ptsematest -a -t -p99 -i100 -d25 -l1000000
       #0: ID8672, P99, CPU0, I100; #1: ID8673, P99, CPU0, Cycles 1000000
       #2: ID8674, P98, CPU1, I125; #3: ID8675, P98, CPU1, Cycles 811035
       #4: ID8676, P97, CPU2, I150; #5: ID8677, P97, CPU2, Cycles 668130
       #6: ID8678, P96, CPU3, I175; #7: ID8679, P96, CPU3, Cycles 589423
       #1 -> #0, Min    1, Cur    1, Avg    2, Max   11
       #3 -> #2, Min    1, Cur    2, Avg    2, Max   13
       #5 -> #4, Min    1, Cur    4, Avg    3, Max   12
       #7 -> #6, Min    1, Cur    4, Avg    2, Max   12

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Carsten Emde <C.Emde@osadl.org>

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       pthread_mutex_lock(3p), pthread_mutex_unlock(3p)

                                      0.1                        ptsematest(8)