blob: c01a5dd43a14a4aa41044570da7e03312b60b2d4 [file] [log] [blame]
Dieter Baronbb1453e2003-10-02 14:20:53 +00001.\" zipcmp.mdoc -- compare zip archives
Thomas Klausnera191f7b2014-01-29 15:14:37 +01002.\" Copyright (C) 2003-2014 Dieter Baron and Thomas Klausner
Dieter Baronbb1453e2003-10-02 14:20:53 +00003.\"
4.\" This file is part of libzip, a library to manipulate ZIP archives.
Dieter Baronb86c4332007-11-07 14:35:13 +01005.\" The authors can be contacted at <libzip@nih.at>
Dieter Baronbb1453e2003-10-02 14:20:53 +00006.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\" notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\" notice, this list of conditions and the following disclaimer in
14.\" the documentation and/or other materials provided with the
15.\" distribution.
16.\" 3. The names of the authors may not be used to endorse or promote
17.\" products derived from this software without specific prior
18.\" written permission.
Thomas Klausner05f8b982003-10-02 15:28:22 +000019.\"
Dieter Baronbb1453e2003-10-02 14:20:53 +000020.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
21.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
22.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
24.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
26.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
28.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
29.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
30.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31.\"
Thomas Klausner6d8ff242015-04-29 14:11:09 +020032.Dd April 29, 2015
Dieter Baron90288262003-10-01 18:28:10 +000033.Dt ZIPCMP 1
34.Os
35.Sh NAME
36.Nm zipcmp
37.Nd compare contents of zip archives
38.Sh SYNOPSIS
39.Nm
Thomas Klausnera191f7b2014-01-29 15:14:37 +010040.Op Fl hipqtVv
41.Ar archive1 archive2
Dieter Baron90288262003-10-01 18:28:10 +000042.Sh DESCRIPTION
Thomas Klausner05f8b982003-10-02 15:28:22 +000043.Nm
Thomas Klausnera191f7b2014-01-29 15:14:37 +010044compares the zip archives or directories
45.Ar archive1
Thomas Klausner05f8b982003-10-02 15:28:22 +000046and
Thomas Klausnera191f7b2014-01-29 15:14:37 +010047.Ar archive2
Thomas Klausner05f8b982003-10-02 15:28:22 +000048and checks if they contain the same files, comparing their names,
49uncompressed sizes, and CRCs.
50File order and compressed size differences are ignored.
51.Pp
52Supported options:
Thomas Klausner23da0562005-06-09 18:45:58 +000053.Bl -tag -width MMM
Thomas Klausner05f8b982003-10-02 15:28:22 +000054.It Fl h
55Display a short help message and exit.
Dieter Baron3014e882003-10-03 23:54:32 +000056.It Fl i
57Compare names ignoring case distinctions.
Thomas Klausnera191f7b2014-01-29 15:14:37 +010058.It Fl p
59Enable paranoid checks.
60Compares extra fields and other meta data.
61(Automatically disabled if one of the archives is a directory.)
Thomas Klausner05f8b982003-10-02 15:28:22 +000062.It Fl q
63Quiet mode.
64Compare
65.Fl v .
Thomas Klausnera191f7b2014-01-29 15:14:37 +010066.It Fl t
67Test zip files by comparing the contents to their checksums.
68.It Fl V
69Display version information and exit.
Thomas Klausner05f8b982003-10-02 15:28:22 +000070.It Fl v
71Verbose mode.
72Print details about differences to stdout.
Dieter Baron3014e882003-10-03 23:54:32 +000073(This is the default.)
Thomas Klausner05f8b982003-10-02 15:28:22 +000074.El
Dieter Baron90288262003-10-01 18:28:10 +000075.Sh EXIT STATUS
76.Nm
Thomas Klausnera191f7b2014-01-29 15:14:37 +010077exits 0 if the two archives contain the same files, 1 if they differ,
Dieter Baron90288262003-10-01 18:28:10 +000078and \*[Gt]1 if an error occurred.
Thomas Klausner9611d6b2005-06-09 18:50:16 +000079.Sh SEE ALSO
80.Xr zipmerge 1 ,
81.Xr libzip 3
Thomas Klausnera456cf52005-06-09 21:13:13 +000082.Sh AUTHORS
83.An -nosplit
Thomas Klausner0acbab42013-07-28 23:29:08 +020084.An Dieter Baron Aq Mt dillo@nih.at
Thomas Klausner75330132005-06-17 12:59:06 +000085and
Thomas Klausner0acbab42013-07-28 23:29:08 +020086.An Thomas Klausner Aq Mt tk@giga.or.at