| Elliott Hughes | 28e98bc | 2018-06-14 16:59:04 -0700 | [diff] [blame] | 1 | This is strace - a diagnostic, debugging and instructional userspace utility |
| 2 | with a traditional command-line interface for Linux. It is used to monitor |
| 3 | and tamper with interactions between processes and the Linux kernel, which |
| 4 | include system calls, signal deliveries, and changes of process state. |
| 5 | The operation of strace is made possible by the kernel feature known as ptrace. |
| Wichert Akkerman | 76baf7c | 1999-02-19 00:21:36 +0000 | [diff] [blame] | 6 | |
| Dmitry V. Levin | dd762c3 | 2012-02-25 15:29:21 +0100 | [diff] [blame] | 7 | strace is released under a Berkeley-style license at the request |
| Elliott Hughes | 28e98bc | 2018-06-14 16:59:04 -0700 | [diff] [blame] | 8 | of Paul Kranenburg; see the file COPYING for details. |
| Wichert Akkerman | 76baf7c | 1999-02-19 00:21:36 +0000 | [diff] [blame] | 9 | |
| Dmitry V. Levin | dd762c3 | 2012-02-25 15:29:21 +0100 | [diff] [blame] | 10 | See the file CREDITS for a list of authors and other contributors. |
| Dmitry V. Levin | dd762c3 | 2012-02-25 15:29:21 +0100 | [diff] [blame] | 11 | See the file INSTALL for compilation and installation instructions. |
| Elvira Khabirova | e547035 | 2016-06-16 20:17:59 +0300 | [diff] [blame] | 12 | See the file NEWS for information on what has changed in recent versions. |
| Wichert Akkerman | 76baf7c | 1999-02-19 00:21:36 +0000 | [diff] [blame] | 13 | |
| Elvira Khabirova | e547035 | 2016-06-16 20:17:59 +0300 | [diff] [blame] | 14 | The project's homepage is at |
| Elliott Hughes | 39bac05 | 2017-05-25 16:56:11 -0700 | [diff] [blame] | 15 | https://strace.io |
| Wichert Akkerman | 76baf7c | 1999-02-19 00:21:36 +0000 | [diff] [blame] | 16 | |
| Elvira Khabirova | e547035 | 2016-06-16 20:17:59 +0300 | [diff] [blame] | 17 | strace has a mailing list: |
| Elliott Hughes | 28e98bc | 2018-06-14 16:59:04 -0700 | [diff] [blame] | 18 | strace-devel@lists.strace.io |
| Wichert Akkerman | 360815e | 1999-06-28 13:16:03 +0000 | [diff] [blame] | 19 | |
| Elvira Khabirova | e547035 | 2016-06-16 20:17:59 +0300 | [diff] [blame] | 20 | System requirements: |
| 21 | * Linux kernel >= 2.6.18 is recommended. Older versions might still work |
| 22 | but they haven't been thoroughly tested with this release. |
| 23 | * Linux kernel >= 2.5.46 is required. |
| 24 | Older versions without a decent PTRACE_SETOPTIONS support will not work. |
| Elliott Hughes | 28e98bc | 2018-06-14 16:59:04 -0700 | [diff] [blame] | 25 | * On mips, Linux kernel >= 2.6.15 is required. |
| Elvira Khabirova | e547035 | 2016-06-16 20:17:59 +0300 | [diff] [blame] | 26 | Older versions without a decent PTRACE_GETREGS support will not work. |
| Elliott Hughes | 28e98bc | 2018-06-14 16:59:04 -0700 | [diff] [blame] | 27 | * On s390 and s390x, Linux kernel >= 2.6.27 is required. |
| Elvira Khabirova | e547035 | 2016-06-16 20:17:59 +0300 | [diff] [blame] | 28 | Older versions without a decent PTRACE_GETREGSET support will not work. |