Lines Matching +full:- +full:- +full:detach +full:- +full:sig

4 .\" Copyright (c) 1996-2017 The strace developers.
42 .\" an-ext.tmac.
44 .  ie \\n(.$-1 \
51 .  ie \\n(.$-1 \
56 .TH STRACE 1 "2018-07-07" "strace 4.25"
58 strace \- trace system calls and signals
62 .OP \-ACdffhikqrtttTvVxxy
65 .OP \-ACdffhiqrtttTvVxxy
67 .OP \-I n
68 .OP \-b execve
69 .OM \-e expr
70 .OP \-a column
71 .OP \-o file
72 .OP \-s strsize
73 .OP \-X format
74 .OM \-P path
75 .OM \-p pid
77 .OR \-p pid
79 .OP \-D
80 .OM \-E var\fR[=\fIval\fR]
81 .OP \-u username
86 .B \-c
87 .OP \-df
88 .OP \-I n
89 .OP \-b execve
90 .OM \-e expr
91 .OP \-O overhead
92 .OP \-S sortby
93 .OM \-P path
94 .OM \-p pid
96 .OR \-p pid
98 .OP \-D
99 .OM \-E var\fR[=\fIval\fR]
100 .OP -u username
117 .B \-o
122 System administrators, diagnosticians and trouble-shooters will find
126 Students, hackers and the overly-curious will find that
140 Errors (typically a return value of \-1) have the errno symbol
143 open("/foo/bar", O_RDONLY) = \-1 ENOENT (No such file or directory)
149 --- SIGINT {si_signo=SIGINT, si_code=SI_USER, si_pid=...} ---
170 --- SIGALRM ... ---
182 flag argument into its three bitwise-OR constituents and printing the
190 as appropriate.  In most cases, arguments are formatted in the most C-like
192 For example, the essence of the command "ls \-l /dev/null" is captured as:
199 member is carefully decoded into a bitwise-OR of symbolic and numeric values.
204 not always be dereferenced.  For example, retrying the "ls \-l" example
205 with a non-existent file produces the following line:
207 lstat("/foo/bar", 0xb004) = \-1 ENOENT (No such file or directory)
216 syscall_0xbad(0x1, 0x2, 0x3, 0x4, 0x5, 0x6) = -1 ENOSYS (Function not implemented)
220 Non-printing characters in strings are normally represented by
226 Here is a line from "ls \-l" where the
239 On the other hand, bit-sets are also shown using square brackets
245 Here, the second argument is a bit-set of two signals,
247 In some cases, the bit-set is so full that printing out the unset
248 elements is more valuable.  In that case, the bit-set is prefixed by
257 .BI "\-a " column
260 .B \-i
264 .B \-k
268 .BI "\-o " filename
274 .B \-ff
281 .B \-ff
284 .B \-A
286 .B \-o
289 .B \-q
294 .B \-qq
297 .B \-r
302 .B \-r
306 .B \-t
309 .BI "\-s " strsize
314 .B \-t
317 .B \-tt
320 .B \-ttt
325 .B \-T
329 .B \-x
330 Print all non-ASCII strings in hexadecimal string format.
332 .B \-xx
335 .BI "\-X " format
356 .B \-y
359 .B \-yy
364 .B \-c
369 .B \-c
374 .B \-C
376 .B \-c
379 .BI "\-O " overhead
386 .B \-c
394 .BI "\-S " sortby
396 .B \-c
406 .B \-w
411 .BI "\-e " expr
435 is a qualifier-dependent symbol or number.  The default
451 allows specifying syscalls only for the 64-bit, 32-bit, or 32-on-64-bit
463 \fB\-e\ trace\fR=\,\fIset\fR
465 .B \-c
475 \fB\-e\ trace\fR=/\,\fIregex\fR
552 Trace syscalls related to file system statistics (statfs-like, fstatfs-like,
570 \fB\-e\ abbrev\fR=\,\fIset\fR
575 .B \-v
579 \fB\-e\ verbose\fR=\,\fIset\fR
584 \fB\-e\ raw\fR=\,\fIset\fR
591 .B \-X raw
594 \fB\-e\ signal\fR=\,\fIset\fR
605 \fB\-e\ read\fR=\,\fIset\fR
613 \fB\-e\ read\fR=\,\fI3\fR,\fI5\fR.
619 \fB\-e\ write\fR=\,\fIset\fR
627 \fB\-e\ write\fR=\,\fI3\fR,\,\fI5\fR.
633 \fB\-e\ inject\fR=\,\fIset\/\fR[:\fBerror\fR=\,\fIerrno\/\fR|:\fBretval\fR=\,\fIvalue\/\fR][:\fBsig…
651 the syscall number is replaced by -1 which corresponds to an invalid syscall
660 success injection is performed: the syscall number is replaced by -1,
663 If :\fBsignal\fR=\,\fIsig\/\fR option is specified with either a symbolic value
676 If :\fBsignal\fR=\,\fIsig\/\fR option is specified without
680 .I sig
686 :\fBsignal\fR=\,\fIsig\/\fR options injects a fault without delivering a signal
690 and :\fBsignal\fR=\,\fIsig\/\fR options are specified, then both
694 with no side effects is injected instead of -1.
739 \fB\-e\ inject\fR=\,\fIchdir\/\fR:\fBerror\fR=\,\fIENOENT\/\fR:\fBwhen\fR=\,\fI3\/\fB+\fR.
762 \fB\-P \fI/dev/urandom \fB\-e inject\fR=\,\fIfile\/\fR:\fBerror\fR=\,\fIENOENT\fR.
765 \fB\-e\ fault\fR=\,\fIset\/\fR[:\fBerror\fR=\,\fIerrno\/\fR][:\fBwhen\fR=\,\fIexpr\/\fR]
769 \fB\-e\ inject\fR= expression with default value of
780 .BI "\-P " path
784 .B \-P
787 .B \-v
794 .BI "\-b " syscall
795 If specified syscall is reached, detach from traced process.
799 multi-threaded process and therefore require -f, but don't want
802 .B \-D
808 .B \-f
816 .B \-p
818 .B \-f
819 will attach all threads of process PID if it is multi-threaded,
822 .B \-ff
824 .B \-o
831 since no per-process counts are kept.
837 .BI "\-I " interruptible
840 (default); 3: fatal signals are always blocked (default if '-o FILE PROG');
842 strace -o FILE PROG not stop on ^Z).
845 \fB\-E\ \fIvar\fR=\,\fIval\fR
850 .BI "\-E " var
856 .BI "\-p " pid
863 .SM CTRL\s0-C).
868 .B \-p
872 .B \-p
874 .B \-p
877 .BI "\-u " username
878 Run command with the user \s-1ID\s0, group \s-2ID\s0, and
887 .B \-d
892 .B \-F
896 .B \-F
900 .B \-f
903 .B \-h
906 .B \-V
922 Note that parent-child relationship (signal stop notifications,
925 .B \-D
929 .B \-p
951 with mode 'rwsr-xr--', user
959 a regular non-setuid version of
978 AArch64	ARM 32-bit EABI
979 PowerPC 64-bit	PowerPC 32-bit
980 RISC-V 64-bit	RISC-V 32-bit
982 SPARC 64-bit	SPARC 32-bit
983 TILE 64-bit	TILE 32-bit
989 .B strace \-V
991 ("non-native" refers to an ABI that differs from the ABI strace has):
993 .B m32-mpers
995 can trace and properly decode non-native 32-bit binaries.
997 .B no-m32-mpers
999 can trace, but cannot properly decode non-native 32-bit binaries.
1001 .B mx32-mpers
1003 can trace and properly decode non-native 32-on-64-bit binaries.
1005 .B no-mx32-mpers
1007 can trace, but cannot properly decode non-native 32-on-64-bit binaries.
1010 .B m32-mpers
1013 then decoding of non-native 32-bit binaries is not implemented at all
1017 .B mx32-mpers
1020 then decoding of non-native 32-on-64-bit binaries is not implemented at all
1027 as data-flow across the user/kernel boundary.  Because user-space
1028 and kernel-space are separate and address-protected, it is
1058 On x32, syscalls that are intended to be used by 64-bit processes and not x32
1067 .B \-p
1100 .SM CTRL\s0-C).
1140 (including ARM, IA-64, MIPS, PA-RISC, PowerPC, s390, SPARC) were introduced.
1147 bi-architecture support for some of them, and received numerous additions and
1158 RISC-V, Tile/TileGx, Xtensa architectures since that time.
1159 In 2012, unmaintained and apparently broken support for non-Linux operating
1177 mailing list at <strace\-devel@lists.strace.io>.