summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSahil Siddiq <icegambit91@gmail.com>2023-03-20 11:10:57 +0530
committerDmitry V. Levin <ldv@strace.io>2023-04-03 19:13:29 +0000
commit94d59946736548741fcf75d175c2ee7c318c390a (patch)
tree7beb72964059a0e44dbb16e3bbbb83e514de3ee7
parentac1d1e25d8d45b8e74ec4cde0f06a7b1df621304 (diff)
downloadstrace-94d59946736548741fcf75d175c2ee7c318c390a.tar.gz
Document new -l/--syscall-limit options
* doc/strace.1.in: Document -l/--syscall-limit options. * NEWS: Mention them. Signed-off-by: Sahil Siddiq <icegambit91@gmail.com>
-rw-r--r--NEWS2
-rw-r--r--doc/strace.1.in14
2 files changed, 16 insertions, 0 deletions
diff --git a/NEWS b/NEWS
index 5bf6c80cb..c77140e6f 100644
--- a/NEWS
+++ b/NEWS
@@ -3,6 +3,8 @@ Noteworthy changes in release ?.? (????-??-??)
* Improvements
* Updated lists of ioctl commands from Linux 6.3.
+ * Implemented -l/--syscall-limit option to automatically detach tracees
+ after capturing the specified number of syscalls.
Noteworthy changes in release 6.2 (2023-02-26)
==============================================
diff --git a/doc/strace.1.in b/doc/strace.1.in
index 71661bd2e..c40d9b7ba 100644
--- a/doc/strace.1.in
+++ b/doc/strace.1.in
@@ -52,6 +52,7 @@ strace \- trace system calls and signals
.OP \-X format
.OM \-P path
.OM \-p pid
+.OP \-l limit
.OP \-\-seccomp\-bpf
.if '@ENABLE_SECONTEXT_FALSE@'#' .OP \-\-secontext\fR[=\fIformat\fR]
.BR "" {
@@ -74,6 +75,7 @@ strace \- trace system calls and signals
.OP \-U columns
.OM \-P path
.OM \-p pid
+.OP \-l limit
.OP \-\-seccomp\-bpf
.BR "" {
.OR \-p pid
@@ -465,6 +467,18 @@ not stop on
default if
.BR \-D ).
.RE
+.TP
+.BI "\-l " limit
+.TQ
+.BR "\-\-syscall\-limit" = \fIlimit\fR
+Detach all tracees when
+.I limit
+number of syscalls have been captured. Syscalls filtered out via
+.BR \-\-trace ,
+.B \-\-trace\-path
+or
+.B \-\-status
+options are not considered when keeping track of the number of syscalls that are captured.
.SS Filtering
.TP 12
\fB\-e\ trace\fR=\,\fIsyscall_set\fR