| .. SPDX-License-Identifier: GPL-2.0 | |
| UNSETTING OPTIONS | |
| ================= | |
| The effect of most command line options can be reverted by prepending "no-" to | |
| the long variant of the option, for example: | |
| $ rtla timerlat top -p 100 --no-period | |
| resets the period back to the default value of 1000 us. | |
| If a command line option sets multiple RTLA parameters at once, the inverted | |
| option will revert all of them, even if they were not set by the particular | |
| option. For example, since using "--auto" implies "--trace", specifying | |
| "--trace --no-auto" will also disable trace output, just like if "--no-trace" | |
| was specified. | |
| SIGINT BEHAVIOR | |
| =============== | |
| On the first SIGINT, RTLA exits after collecting all outstanding samples up to | |
| the point of receiving the signal. | |
| When receiving more than one SIGINT, RTLA discards any outstanding samples, and | |
| exits while displaying only samples that have already been processed. | |
| If SIGINT is received during RTLA cleanup, RTLA exits immediately via | |
| the default signal handler. | |
| Note: For the purpose of SIGINT behavior, the expiry of duration specified via | |
| the -d/--duration option is treated as equivalent to receiving a SIGINT. For | |
| example, a SIGINT received after duration expired but samples have not been | |
| processed yet will drop any outstanding samples. | |
| Also note that when using the timerlat tool in BPF mode, samples are processed | |
| in-kernel; RTLA only copies them out to display them to the user. A second | |
| SIGINT does not affect in-kernel sample aggregation. | |
| EXIT STATUS | |
| =========== | |
| :: | |
| 0 Passed: the test did not hit the stop tracing condition | |
| 1 Error: invalid argument | |
| 2 Failed: the test hit the stop tracing condition | |
| 129 Help: either user requested help or incorrect option was specified | |
| REPORTING BUGS | |
| ============== | |
| Report bugs to <linux-kernel@vger.kernel.org> | |
| and <linux-trace-devel@vger.kernel.org> | |
| LICENSE | |
| ======= | |
| **rtla** is Free Software licensed under the GNU GPLv2 | |
| COPYING | |
| ======= | |
| Copyright \(C) 2021 Red Hat, Inc. Free use of this software is granted under | |
| the terms of the GNU Public License (GPL). |