xref: /linux/Documentation/tools/rtla/common_appendix.txt (revision d639d9fa162aadec1ae9980c4dcf6e50bd2f8290)
1.. SPDX-License-Identifier: GPL-2.0
2
3SIGINT BEHAVIOR
4===============
5
6On the first SIGINT, RTLA exits after collecting all outstanding samples up to
7the point of receiving the signal.
8
9When receiving more than one SIGINT, RTLA discards any outstanding samples, and
10exits while displaying only samples that have already been processed.
11
12If SIGINT is received during RTLA cleanup, RTLA exits immediately via
13the default signal handler.
14
15Note: For the purpose of SIGINT behavior, the expiry of duration specified via
16the -d/--duration option is treated as equivalent to receiving a SIGINT. For
17example, a SIGINT received after duration expired but samples have not been
18processed yet will drop any outstanding samples.
19
20Also note that when using the timerlat tool in BPF mode, samples are processed
21in-kernel; RTLA only copies them out to display them to the user. A second
22SIGINT does not affect in-kernel sample aggregation.
23
24EXIT STATUS
25===========
26
27::
28
29 0    Passed: the test did not hit the stop tracing condition
30 1    Error: invalid argument
31 2    Failed: the test hit the stop tracing condition
32 129  Help: either user requested help or incorrect option was specified
33
34REPORTING BUGS
35==============
36Report bugs to <linux-kernel@vger.kernel.org>
37and <linux-trace-devel@vger.kernel.org>
38
39LICENSE
40=======
41**rtla** is Free Software licensed under the GNU GPLv2
42
43COPYING
44=======
45Copyright \(C) 2021 Red Hat, Inc. Free use of this software is granted under
46the terms of the GNU Public License (GPL).
47