xref: /linux/Documentation/tools/rtla/common_appendix.txt (revision e2683c8868d03382da7e1ce8453b543a043066d1)
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
33REPORTING BUGS
34==============
35Report bugs to <linux-kernel@vger.kernel.org>
36and <linux-trace-devel@vger.kernel.org>
37
38LICENSE
39=======
40**rtla** is Free Software licensed under the GNU GPLv2
41
42COPYING
43=======
44Copyright \(C) 2021 Red Hat, Inc. Free use of this software is granted under
45the terms of the GNU Public License (GPL).
46