fixup! strace.1.in: print names of entities in bold, provide man page sections

This commit is contained in:
Eugene Syromyatnikov 2018-09-04 19:53:51 +02:00
parent 3ef3477891
commit 90320f4ce4

View File

@ -788,8 +788,7 @@ This is equivalent to more generic
\fB\-e\ inject\fR= expression with default value of
.I errno
option set to
.IR ENOSYS .
.BR ENOSYS .
.TP
.BR "\-e\ kvm" = vcpu
Print the exit reason of kvm vcpu. Requires Linux kernel version 4.16.0
@ -813,10 +812,11 @@ this option to get all of the gory details.
.BI "\-b " syscall
If specified syscall is reached, detach from traced process.
Currently, only
.I execve
.BR execve (2)
syscall is supported. This option is useful if you want to trace
multi-threaded process and therefore require -f, but don't want
to trace its (potentially very complex) children.
multi-threaded process and therefore require
.BR \-f ,
but don't want to trace its (potentially very complex) children.
.TP
.B \-D
Run tracer process as a detached grandchild, not as parent of the
@ -835,16 +835,20 @@ system calls. Note that
.B \-p
.I PID
.B \-f
will attach all threads of process PID if it is multi-threaded,
not only thread with thread_id = PID.
will attach all threads of process
.I PID
if it is multi-threaded, not only thread with
.IR thread_id " = " PID .
.TP
.B \-ff
If the
.B \-o
.I filename
option is in effect, each processes trace is written to
.I filename.pid
where pid is the numeric process id of each process.
.IR filename . pid
where
.I pid
is the numeric process id of each process.
This is incompatible with
.BR \-c ,
since no per-process counts are kept.
@ -874,7 +878,7 @@ fatal signals are always blocked (default if
fatal signals and
.BR SIGTSTP " (" ^Z )
are always blocked (useful to make
.BI "strace -o " FILE PROG
.BI "strace -o " "FILE PROG"
not stop on
.BR ^Z ).
.RE
@ -1098,15 +1102,19 @@ Xtensa syscall are filtered and printed as
.LP
On x32, syscalls that are intended to be used by 64-bit processes and not x32
ones (for example,
.BR readv ,
.BR readv (2),
that has syscall number 19 on x86_64, with its x32 counterpart has syscall
number 515), but called with
.B __X32_SYSCALL_BIT
flag being set, are designated with "#64" suffix.
flag being set, are designated with
.B "#64"
suffix.
.LP
On some platforms a process that is attached to with the
.B \-p
option may observe a spurious EINTR return from the current
option may observe a spurious
.B EINTR
return from the current
system call that is not restartable. (Ideally, all system calls
should be restarted on strace attach, making the attach invisible
to the traced process, but a few system calls aren't.