This adds :signal to strace.1 Signed-off-by: Seraphime Kirkovski <kirkser...@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 ------------------------------------------------------------------------------ Check out the vibrant tech community on one of the world's most engaging tech sites, SlashDot.org! http://sdm.link/slashdot _______________________________________________ Strace-devel mailing list Strace-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/strace-devel
