summaryrefslogtreecommitdiffstats
path: root/development/diffoscope/diffoscope.1
blob: a816cd5171df46105dc6d4e7b7396a56308aab5d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
.\" Man page generated from reStructuredText.
.
.TH DIFFOSCOPE 1 "" "" "Debian"
.SH NAME
diffoscope \- in-depth comparison of files, archives, and directories
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
diffoscope [\-h] [\-\-version] [\-\-debug] [\-\-html output] [\-\-text output] [\-\-max\-report\-size bytes] [\-\-css url] file1 file2
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
diffoscope will try to get to the bottom of what makes files or
directories different. It will recursively unpack archives of many kinds
and transform various binary formats into more human readable form to
compare them. It can compare two tarballs, ISO images, or PDF just as
easily.
.sp
It can be scripted through error codes, and a report can be produced
with the detected differences. The report can be text or HTML.
When no type of report has been selected, diffoscope defaults
to write a text report on the standard output.
.sp
diffoscope is developed as part of the “reproducible builds” Debian
project and was formerly known as “debbindiff”.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-h\fP,\fB  \-\-help
show this help message and exit
.TP
.B \-\-version
show program\(aqs version number and exit
.TP
.B \-\-debug
display debug messages
.TP
.BI \-\-html \ output
write HTML report to given file
(use \- for standard output)
.TP
.BI \-\-text \ output
write plain text report to given file
(use \- for standard output)
.TP
.BI \-\-max\-report\-size \ BYTES
maximum bytes written in report (default: 2048000)
.TP
.BI \-\-max\-diff\-block\-lines \ MAX_DIFF_BLOCK_LINES
maximum number of lines per diff block (default: 50)
.TP
.BI \-\-max\-diff\-input\-lines \ MAX_DIFF_INPUT_LINES
maximum number of lines fed to diff (default: 100000)
.TP
.BI \-\-fuzzy\-threshold \ FUZZY_THRESHOLD
threshold for fuzzy\-matching (0 to disable, 60 is
default, 400 is high fuzziness)
.TP
.B \-\-new\-file
treat absent files as empty
.TP
.BI \-\-css \ url
link to an extra CSS for the HTML report
.UNINDENT
.SH EXIT STATUS
.sp
Exit status is 0 if inputs are the same, 1 if different, 2 if trouble.
.SH SEE ALSO
.INDENT 0.0
.IP \(bu 2
\fI<https://diffoscope.org/>\fP
.IP \(bu 2
\fI<https://wiki.debian.org/ReproducibleBuilds>\fP
.UNINDENT
.SH AUTHOR
Debian "Reproducible Builds" Team
.SH COPYRIGHT
GPL-3+
.\" Generated by docutils manpage writer.
.