[PATCH/RFC v1 2/2] [GSoC] Make relevant changes in NEWS and man page
Sahil Siddiq
icegambit91 at gmail.com
Tue Feb 14 21:24:01 UTC 2023
Document the changes in the man page and NEWS.
* doc/strace.1.in: Add -l/--syscall-limit option.
* NEWS: Mention this change.
Signed-off-by: Sahil Siddiq <icegambit91 at gmail.com>
---
NEWS | 2 ++
doc/strace.1.in | 8 ++++++++
2 files changed, 10 insertions(+)
diff --git a/NEWS b/NEWS
index dca78dc97..3a3c14843 100644
--- a/NEWS
+++ b/NEWS
@@ -6,6 +6,8 @@ Noteworthy changes in release ?.? (????-??-??)
netlink attributes.
* Updated lists of ALG_*, BPF_*, IFLA_*, KEY_*, and MEMBARRIER_* constants.
* Updated lists of ioctl commands from Linux 6.2.
+ * Implemented ability to automatically detach/stop strace after
+ capturing a specified number of syscalls.
Noteworthy changes in release 6.1 (2022-12-12)
==============================================
diff --git a/doc/strace.1.in b/doc/strace.1.in
index 71661bd2e..e76929a8b 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
@@ -1332,6 +1334,12 @@ field is not supplied explicitly, it is added as the last column.
.B \-\-summary\-wall\-clock
Summarise the time difference between the beginning and end of
each system call. The default is to summarise the system time.
+.SS Stop condition
+.TP 12
+.BI "\-l " limit
+.TQ
+.BR "\-\-syscall\-limit" = \fIlimit\fR
+Detach/stop strace after \fIlimit\fR number of syscalls are captured.
.SS Tampering
.ad l
.TP 12
--
2.39.1
More information about the Strace-devel
mailing list