xref: /aosp_15_r20/external/strace/README (revision cf84ac9a129d8ea9952db616b4e9b904c4bdde56)
1*cf84ac9aSAndroid Build Coastguard WorkerThis is strace - a diagnostic, debugging and instructional userspace utility
2*cf84ac9aSAndroid Build Coastguard Workerwith a traditional command-line interface for Linux.  It is used to monitor
3*cf84ac9aSAndroid Build Coastguard Workerand tamper with interactions between processes and the Linux kernel, which
4*cf84ac9aSAndroid Build Coastguard Workerinclude system calls, signal deliveries, and changes of process state.
5*cf84ac9aSAndroid Build Coastguard WorkerThe operation of strace is made possible by the kernel feature known as ptrace.
6*cf84ac9aSAndroid Build Coastguard Worker
7*cf84ac9aSAndroid Build Coastguard Workerstrace is released under a Berkeley-style license at the request
8*cf84ac9aSAndroid Build Coastguard Workerof Paul Kranenburg; see the file COPYING for details.
9*cf84ac9aSAndroid Build Coastguard Worker
10*cf84ac9aSAndroid Build Coastguard WorkerSee the file CREDITS for a list of authors and other contributors.
11*cf84ac9aSAndroid Build Coastguard WorkerSee the file INSTALL for compilation and installation instructions.
12*cf84ac9aSAndroid Build Coastguard WorkerSee the file NEWS for information on what has changed in recent versions.
13*cf84ac9aSAndroid Build Coastguard Worker
14*cf84ac9aSAndroid Build Coastguard WorkerThe project's homepage is at
15*cf84ac9aSAndroid Build Coastguard Worker	https://strace.io
16*cf84ac9aSAndroid Build Coastguard Worker
17*cf84ac9aSAndroid Build Coastguard Workerstrace has a mailing list:
18*cf84ac9aSAndroid Build Coastguard Worker	[email protected]
19*cf84ac9aSAndroid Build Coastguard Worker
20*cf84ac9aSAndroid Build Coastguard WorkerSystem requirements:
21*cf84ac9aSAndroid Build Coastguard Worker	* Linux kernel >= 2.6.18 is recommended.  Older versions might still work
22*cf84ac9aSAndroid Build Coastguard Worker	  but they haven't been thoroughly tested with this release.
23*cf84ac9aSAndroid Build Coastguard Worker	* Linux kernel >= 2.5.46 is required.
24*cf84ac9aSAndroid Build Coastguard Worker	  Older versions without a decent PTRACE_SETOPTIONS support will not work.
25*cf84ac9aSAndroid Build Coastguard Worker	* On mips, Linux kernel >= 2.6.15 is required.
26*cf84ac9aSAndroid Build Coastguard Worker	  Older versions without a decent PTRACE_GETREGS support will not work.
27*cf84ac9aSAndroid Build Coastguard Worker	* On s390 and s390x, Linux kernel >= 2.6.27 is required.
28*cf84ac9aSAndroid Build Coastguard Worker	  Older versions without a decent PTRACE_GETREGSET support will not work.
29