1SIGNALTEST(8)               System Manager's Manual              SIGNALTEST(8)
2
3
4
5# SPDX-License-Identifier: GPL-2.0-only
6

NAME

8       signaltest - signal roundtrip test software
9

SYNOPSIS

11       signaltest  [ -a|--affinity NUM] [ -b|--backtrace USEC ] [-D|--duration
12       TIME] [-h|--help] [--json  FILENAME]  [-l|--loops  LOOPS  ]  [-p|--prio
13       PRIO]  [-q|--quiet]  [-S|--smp]  [-t|--threads  NUM]  [-m|--mlockall  ]
14       [-v|--verbose ]
15

OPTIONS

17       These programs follow the usual GNU command line syntax, with long  op‐
18       tions starting with two dashes ('--').
19
20       -a, --affinity[=PROC-SET]
21              Run  threads  on  the  set  of processors given by PROC-SET.  If
22              PROC-SET is not specified, all processors will be used.  Threads
23              will be assigned to processors in the set in numeric order, in a
24              round-robin fashion.
25              The set of processors can be specified as A,B,C, or A-C,  or  A-
26              B,D-F, and so on*.  The ! character can be used to negate a set.
27              For example, !B-D means to  use  all  available  CPUs  except  B
28              through D.  The cpu numbers are the same as shown in the proces‐
29              sor field in /proc/cpuinfo.  See numa(3) for more information on
30              specifying  CPU  sets.   * Support for CPU sets requires libnuma
31              version >= 2.  For libnuma v1, PROC-SET, if specified, must be a
32              single CPU number.
33
34       -b, --breaktrace=USEC
35              Send break trace command when latency > USEC
36
37       -D, --duration=TIME
38              Specify a length for the test run.
39              Append 'm', 'h', or 'd' to specify minutes, hours or days.
40
41       --help
42              display usage information
43
44       --json=FILENAME
45              Write final results into FILENAME, JSON formatted.
46
47       -l, --loops=LOOPS
48              Number of loops: default=0 (endless)
49
50       -p, --priority=PRIO
51              Priority of highest priority thread
52
53       -q, --quiet
54              print a summary only on exit
55
56       -S, --smp
57              Set  options  for standard testing on SMP systems. Equivalent to
58              using the options: "-t -a" as well keeping any specified  prior‐
59              ity equal across all threads
60
61       -t, --threads=NUM
62              number of threads: default=2
63
64       -m, --mlockall
65              lock current and future memory allocations
66
67       -v, --verbose
68              output values on stdout for statistics
69              format: n:c:v n=tasknum c=count v=value in us
70

AUTHOR

72       signaltest was written by Thomas Gleixner <tglx@linuxtronix.de>.
73
74       This manual page was originally written by
75       John Kacur <jkacur@redhat.com>
76
77       Copying  and  distribution  of this file, with or without modification,
78       are permitted in any medium without royalty provided the copyright  no‐
79       tice  and this notice are preserved.  This file is offered as-is, with‐
80       out any warranty.
81
82
83
84                               November 15, 2020                 SIGNALTEST(8)