summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEugene Syromyatnikov <evgsyr@gmail.com>2021-11-25 20:23:22 +0100
committerDmitry V. Levin <ldv@strace.io>2021-11-25 19:23:22 +0000
commitdf89e8bb642dbe63b3a6f82bb571d1b1139d1439 (patch)
treedf01e444ce34b6af1a1509e44adba99fd659b489
parent0ab000e96458fa6a35c9820bd402fd4c3d413b3c (diff)
downloadstrace-df89e8bb642dbe63b3a6f82bb571d1b1139d1439.tar.gz
doc/strace.1: elaborate on support of multiple PIDs as a -p argument
While it was mentioned that -p "`pidof PROG`" syntax is supported, it was not explicitly stated what characters can be used as separators (like newline, which is used by pgrep, as noted in process_opt_p_list). * doc/strace.1.in (.SS Startup): Explicitly mention that multiple PIDs can be provided as an argument to a single -p option; list all supported separator characters; mention possible -p "$(pgrep PROG)" syntax.
-rw-r--r--doc/strace.1.in9
1 files changed, 8 insertions, 1 deletions
diff --git a/doc/strace.1.in b/doc/strace.1.in
index 22c96d55a..66e5448e9 100644
--- a/doc/strace.1.in
+++ b/doc/strace.1.in
@@ -323,8 +323,15 @@ options can be used to attach to many processes in addition to
(which is optional if at least one
.B \-p
option is given).
+Multiple process IDs, separated by either
+comma (\(lq,\(rq), space (\(lq \(rq), tab, or newline character,
+can be provided as an argument to a single
.B \-p
-"`pidof PROG`" syntax is supported.
+option, so, for example,
+.B \-p
+"$(pidof PROG)" and
+.B \-p
+"$(pgrep PROG)" syntaxes are supported.
.TP
.BI "\-u " username
.TQ