[PATCH 2/2] man: document the :signal option to -e fault

[Seraphime Kirkovski]

This adds :signal to strace.1

Signed-off-by: Seraphime Kirkovski <kirkseraph at gmail.com>
---
 strace.1 | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/strace.1 b/strace.1
index 24dd7d3..2be7d83 100644
--- a/strace.1
+++ b/strace.1
@@ -472,7 +472,7 @@ Note that this is independent from the normal tracing of the
 system call which is controlled by the option
 .BR -e "\ " trace = write .
 .TP
-\fB\-e\ fault\fR=\,\fIset\/\fR[:\fBerror\fR=\,\fIerrno\/\fR][:\fBwhen\fR=\,\fIexpr\/\fR]
+\fB\-e\ fault\fR=\,\fIset\/\fR[:\fBerror\fR=\,\fIerrno\/\fR][:\fBsignal\fR=\,\fIsig\/\fR][:\fBwhen\fR=\,\fIexpr\/\fR]
 Perform a syscall fault injection for the specified set of syscalls.
 When a fault is injected into a syscall invocation, the syscall number
 is replaced by -1 which corresponds to an invalid syscall.
@@ -486,6 +486,17 @@ the default error code returned by the kernel, which is traditionally
 .B ENOSYS
 for invalid syscall numbers on most architectures.
 
+If a signal is specified using either a symbolic value like
+.B SIGSEGV
+or a numeric value within 1..\fBSIGRTMAX\fR,
+that signal is sent upon entry of any of the syscalls in \,\fIset\fR.
+
+If \,\fIsig\fR is specified without \,\fIerrno\fR, no error injection is made.
+Conversely, \,\fIerrno\fR without \,\fIsig\fR faults the syscall without sending a signal.
+
+If both \,\fIsig\fR and \,\fIerrno\fR are specified, the signal \,\fIsig\fR is sent
+and the error code \,\fIerrno\fR is injected.
+
 Unless a :\fBwhen\fR=\,\fIexpr\fR subexpression is specified,
 a fault is injected into every invocation of each syscall from the
 .IR set .
-- 
2.10.2