Browse Source

strace.1.in: eliminate empty lines

Replace them with .IP or just remove.
Eugene Syromyatnikov 1 month ago
parent
commit
07baaacfca
1 changed files with 16 additions and 19 deletions
  1. 16
    19
      strace.1.in

+ 16
- 19
strace.1.in View File

@@ -79,7 +79,6 @@ strace \- trace system calls and signals
79 79
 .IR command " [" args ]
80 80
 .BR "" }
81 81
 .YS
82
-
83 82
 .SH DESCRIPTION
84 83
 .IX "strace command" "" "\fLstrace\fR command"
85 84
 .LP
@@ -372,7 +371,7 @@ is the numeric process id of each process.
372 371
 This is incompatible with
373 372
 .BR \-c ,
374 373
 since no per-process counts are kept.
375
-
374
+.IP
376 375
 One might want to consider using
377 376
 .BR strace-log-merge (1)
378 377
 to obtain a combined strace log view.
@@ -672,7 +671,6 @@ system call which is controlled by the option
672 671
 .BR "\-e\ kvm" = vcpu
673 672
 Print the exit reason of kvm vcpu.  Requires Linux kernel version 4.16.0
674 673
 or higher.
675
-
676 674
 .TP
677 675
 .B \-i
678 676
 Print the instruction pointer at the time of the system call.
@@ -833,7 +831,7 @@ each system call.  The default is to summarise the system time.
833 831
 .TP 12
834 832
 \fB\-e\ inject\fR=\,\fIset\/\fR[:\fBerror\fR=\,\fIerrno\/\fR|:\fBretval\fR=\,\fIvalue\/\fR][:\fBsignal\fR=\,\fIsig\/\fR][:\fBsyscall\fR=\fIsyscall\fR][:\fBdelay_enter\fR=\,\fIusecs\/\fR][:\fBdelay_exit\fR=\,\fIusecs\/\fR][:\fBwhen\fR=\,\fIexpr\/\fR]
835 833
 Perform syscall tampering for the specified set of syscalls.
836
-
834
+.IP
837 835
 At least one of
838 836
 .BR error ,
839 837
 .BR retval ,
@@ -846,7 +844,7 @@ options has to be specified.
846 844
 and
847 845
 .B retval
848 846
 are mutually exclusive.
849
-
847
+.IP
850 848
 If :\fBerror\fR=\,\fIerrno\/\fR option is specified,
851 849
 a fault is injected into a syscall invocation:
852 850
 the syscall number is replaced by -1 which corresponds to an invalid syscall
@@ -856,24 +854,24 @@ and the error code is specified using a symbolic
856 854
 value like
857 855
 .B ENOSYS
858 856
 or a numeric value within 1..4095 range.
859
-
857
+.IP
860 858
 If :\fBretval\fR=\,\fIvalue\/\fR option is specified,
861 859
 success injection is performed: the syscall number is replaced by -1,
862 860
 but a bogus success value is returned to the callee.
863
-
861
+.IP
864 862
 If :\fBsignal\fR=\,\fIsig\/\fR option is specified with either a symbolic value
865 863
 like
866 864
 .B SIGSEGV
867 865
 or a numeric value within 1..\fBSIGRTMAX\fR range,
868 866
 that signal is delivered on entering every syscall specified by the
869 867
 .IR set .
870
-
868
+.IP
871 869
 If :\fBdelay_enter\fR=\,\fIusecs\/\fR or :\fBdelay_exit\fR=\,\fIusecs\/\fR
872 870
 options are specified, delay injection is performed: the tracee is delayed
873 871
 by at least
874 872
 .IR usecs
875 873
 microseconds on entering or exiting the syscall.
876
-
874
+.IP
877 875
 If :\fBsignal\fR=\,\fIsig\/\fR option is specified without
878 876
 :\fBerror\fR=\,\fIerrno\/\fR, :\fBretval\fR=\,\fIvalue\/\fR or
879 877
 :\fBdelay_{enter,exit}\fR=\,\fIusecs\/\fR options,
@@ -886,21 +884,21 @@ Conversely, :\fBerror\fR=\,\fIerrno\/\fR or
886 884
 :\fBdelay_exit\fR=\,\fIusecs\/\fR or
887 885
 :\fBsignal\fR=\,\fIsig\/\fR options injects a fault without delivering a signal
888 886
 or injecting a delay, etc.
889
-
887
+.IP
890 888
 If both :\fBerror\fR=\,\fIerrno\/\fR or :\fBretval\fR=\,\fIvalue\/\fR
891 889
 and :\fBsignal\fR=\,\fIsig\/\fR options are specified, then both
892 890
 a fault or success is injected and a signal is delivered.
893
-
891
+.IP
894 892
 if :\fBsyscall\fR=\fIsyscall\fR option is specified, the corresponding syscall
895 893
 with no side effects is injected instead of -1.
896 894
 Currently, only "pure" (see
897 895
 .BR "-e trace" = "%pure"
898 896
 description) syscalls can be specified there.
899
-
897
+.IP
900 898
 Unless a :\fBwhen\fR=\,\fIexpr\fR subexpression is specified,
901 899
 an injection is being made into every invocation of each syscall from the
902 900
 .IR set .
903
-
901
+.IP
904 902
 The format of the subexpression is one of the following:
905 903
 .RS
906 904
 .TP 12
@@ -932,13 +930,13 @@ For example, to fail each third and subsequent chdir syscalls with
932 930
 .BR ENOENT ,
933 931
 use
934 932
 \fB\-e\ inject\fR=\,\fIchdir\/\fR:\fBerror\fR=\,\fIENOENT\/\fR:\fBwhen\fR=\,\fI3\/\fB+\fR.
935
-
933
+.IP
936 934
 The valid range for numbers
937 935
 .I first
938 936
 and
939 937
 .I step
940 938
 is 1..65535.
941
-
939
+.IP
942 940
 An injection expression can contain only one
943 941
 .BR error =
944 942
 or
@@ -948,18 +946,17 @@ specification, and only one
948 946
 specification.  If an injection expression contains multiple
949 947
 .BR when =
950 948
 specifications, the last one takes precedence.
951
-
949
+.IP
952 950
 Accounting of syscalls that are subject to injection
953 951
 is done per syscall and per tracee.
954
-
952
+.IP
955 953
 Specification of syscall injection can be combined
956 954
 with other syscall filtering options, for example,
957 955
 \fB\-P \fI/dev/urandom \fB\-e inject\fR=\,\fIfile\/\fR:\fBerror\fR=\,\fIENOENT\fR.
958
-
959 956
 .TP
960 957
 \fB\-e\ fault\fR=\,\fIset\/\fR[:\fBerror\fR=\,\fIerrno\/\fR][:\fBwhen\fR=\,\fIexpr\/\fR]
961 958
 Perform syscall fault injection for the specified set of syscalls.
962
-
959
+.IP
963 960
 This is equivalent to more generic
964 961
 \fB\-e\ inject\fR= expression with default value of
965 962
 .I errno

Loading…
Cancel
Save