summaryrefslogtreecommitdiff
path: root/bin/sqfsdiff/sqfsdiff.1
diff options
context:
space:
mode:
authorDavid Oberhollenzer <david.oberhollenzer@sigma-star.at>2020-05-27 14:57:48 +0200
committerDavid Oberhollenzer <david.oberhollenzer@sigma-star.at>2020-05-30 17:49:40 +0200
commitceb86b571c1cabf2a0890603b140a1af99912fd9 (patch)
tree40c6071c057b474b483d692a16dd5dc7a402b0d3 /bin/sqfsdiff/sqfsdiff.1
parent4332c116b303e0f86aaac4ae0bf699db5744769d (diff)
Cleanup: move man pages to the respective program source directories
Signed-off-by: David Oberhollenzer <david.oberhollenzer@sigma-star.at>
Diffstat (limited to 'bin/sqfsdiff/sqfsdiff.1')
-rw-r--r--bin/sqfsdiff/sqfsdiff.172
1 files changed, 72 insertions, 0 deletions
diff --git a/bin/sqfsdiff/sqfsdiff.1 b/bin/sqfsdiff/sqfsdiff.1
new file mode 100644
index 0000000..c0ee550
--- /dev/null
+++ b/bin/sqfsdiff/sqfsdiff.1
@@ -0,0 +1,72 @@
+.TH SQFSDIFF "1" "August 2019" "sqfsdiff" "User Commands"
+.SH NAME
+sqfsdiff \- compare two squashfs images by contents and metadata
+.SH SYNOPSIS
+.B sqfsdiff
+[\fI\,OPTIONS\/\fR...] \-\-old \fI\,<first>\fR \-\-new \fI\,<second>\/\fR
+.SH DESCRIPTION
+Compare two squashfs images. In contrast to doing a direct diff of the
+images, this actually parses the filesystems and generates a more
+meaningful difference report.
+.PP
+If only contents are compared, any differences in packed file layout,
+ordering, compression, inode meta data and so on is ignored and the two
+images are considered equal if each directory contains the same entries,
+symlink with the same paths have the same targets, device nodes the same
+device number and files the same size and contents.
+.PP
+A report of any difference is printed to stdout. The exit status is similar
+that of diff(1): 0 means equal, 1 means different, 2 means problem.
+.PP
+Possible options:
+.TP
+\fB\-\-old\fR, \fB\-a\fR <first>
+Specify the first filesystem image or source directory, relativ to which the
+changes are evaluated.
+.TP
+\fB\-\-new\fR, \fB\-b\fR <second>
+Specify the second filesystem image to source directory to compare to the
+first one.
+.TP
+\fB\-\-no\-contents\fR, \fB\-C\fR
+Do not compare file contents.
+.TP
+\fB\-\-no\-owner\fR, \fB\-O\fR
+Do not compare file owners.
+.TP
+\fB\-\-no\-permissions\fR, \fB\-P\fR
+Do not compare permission bits.
+.TP
+\fB\-\-timestamps\fR, \fB\-T\fR
+Compare file timestamps.
+.TP
+\fB\-\-inode\-num\fR, \fB\-I\fR
+Compare inode numbers of all files.
+.TP
+\fB\-\-super\fR, \fB\-S\fR
+Also compare meta data in super blocks.
+.TP
+\fB\-\-extract\fR, \fB\-e\fR <path>
+Extract files that exist in both images but have different contents to the
+specified directory. Contents of the first image end up in a sub directory
+named \fBold\fR and the contents of the second image in a sub directory
+named \fBnew\fR.
+.TP
+\fB\-\-help\fR, \fB\-h\fR
+Print help text and exit.
+.TP
+\fB\-\-version\fR, \fB\-V\fR
+Print version information and exit.
+.SH EXIT STATUS
+The exit status is similar that of diff(1): 0 means equal, 1 means different,
+2 means problem.
+.SH SEE ALSO
+rdsquashfs(1), sqfs2tar(1)
+.SH AUTHOR
+Written by David Oberhollenzer.
+.SH COPYRIGHT
+Copyright \(co 2019 David Oberhollenzer et al
+License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
+.br
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.