xref: /minix3/usr.bin/cmp/cmp.1 (revision e7ca52fbf9467cf529d9418733479b3ad4e41b58)
1*e7ca52fbSDavid van Moolenbroek.\"	$NetBSD: cmp.1,v 1.9 2003/08/07 11:13:21 agc Exp $
2*e7ca52fbSDavid van Moolenbroek.\"
3*e7ca52fbSDavid van Moolenbroek.\" Copyright (c) 1987, 1990, 1993
4*e7ca52fbSDavid van Moolenbroek.\"	The Regents of the University of California.  All rights reserved.
5*e7ca52fbSDavid van Moolenbroek.\"
6*e7ca52fbSDavid van Moolenbroek.\" This code is derived from software contributed to Berkeley by
7*e7ca52fbSDavid van Moolenbroek.\" the Institute of Electrical and Electronics Engineers, Inc.
8*e7ca52fbSDavid van Moolenbroek.\"
9*e7ca52fbSDavid van Moolenbroek.\" Redistribution and use in source and binary forms, with or without
10*e7ca52fbSDavid van Moolenbroek.\" modification, are permitted provided that the following conditions
11*e7ca52fbSDavid van Moolenbroek.\" are met:
12*e7ca52fbSDavid van Moolenbroek.\" 1. Redistributions of source code must retain the above copyright
13*e7ca52fbSDavid van Moolenbroek.\"    notice, this list of conditions and the following disclaimer.
14*e7ca52fbSDavid van Moolenbroek.\" 2. Redistributions in binary form must reproduce the above copyright
15*e7ca52fbSDavid van Moolenbroek.\"    notice, this list of conditions and the following disclaimer in the
16*e7ca52fbSDavid van Moolenbroek.\"    documentation and/or other materials provided with the distribution.
17*e7ca52fbSDavid van Moolenbroek.\" 3. Neither the name of the University nor the names of its contributors
18*e7ca52fbSDavid van Moolenbroek.\"    may be used to endorse or promote products derived from this software
19*e7ca52fbSDavid van Moolenbroek.\"    without specific prior written permission.
20*e7ca52fbSDavid van Moolenbroek.\"
21*e7ca52fbSDavid van Moolenbroek.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22*e7ca52fbSDavid van Moolenbroek.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23*e7ca52fbSDavid van Moolenbroek.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24*e7ca52fbSDavid van Moolenbroek.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25*e7ca52fbSDavid van Moolenbroek.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26*e7ca52fbSDavid van Moolenbroek.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27*e7ca52fbSDavid van Moolenbroek.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28*e7ca52fbSDavid van Moolenbroek.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29*e7ca52fbSDavid van Moolenbroek.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30*e7ca52fbSDavid van Moolenbroek.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31*e7ca52fbSDavid van Moolenbroek.\" SUCH DAMAGE.
32*e7ca52fbSDavid van Moolenbroek.\"
33*e7ca52fbSDavid van Moolenbroek.\"     @(#)cmp.1	8.1 (Berkeley) 6/6/93
34*e7ca52fbSDavid van Moolenbroek.\"
35*e7ca52fbSDavid van Moolenbroek.Dd June 6, 1993
36*e7ca52fbSDavid van Moolenbroek.Dt CMP 1
37*e7ca52fbSDavid van Moolenbroek.Os
38*e7ca52fbSDavid van Moolenbroek.Sh NAME
39*e7ca52fbSDavid van Moolenbroek.Nm cmp
40*e7ca52fbSDavid van Moolenbroek.Nd compare two files
41*e7ca52fbSDavid van Moolenbroek.Sh SYNOPSIS
42*e7ca52fbSDavid van Moolenbroek.Nm
43*e7ca52fbSDavid van Moolenbroek.Op Fl l | Fl s
44*e7ca52fbSDavid van Moolenbroek.Ar file1 file2
45*e7ca52fbSDavid van Moolenbroek.Op Ar skip1 Op Ar skip2
46*e7ca52fbSDavid van Moolenbroek.Sh DESCRIPTION
47*e7ca52fbSDavid van MoolenbroekThe cmp utility compares two files of any type and writes the results
48*e7ca52fbSDavid van Moolenbroekto the standard output.
49*e7ca52fbSDavid van MoolenbroekBy default,
50*e7ca52fbSDavid van Moolenbroek.Nm
51*e7ca52fbSDavid van Moolenbroekis silent if the files are the same; if they differ, the byte
52*e7ca52fbSDavid van Moolenbroekand line number at which the first difference occurred is reported.
53*e7ca52fbSDavid van Moolenbroek.Pp
54*e7ca52fbSDavid van MoolenbroekBytes and lines are numbered beginning with one.
55*e7ca52fbSDavid van Moolenbroek.Pp
56*e7ca52fbSDavid van MoolenbroekThe following options are available:
57*e7ca52fbSDavid van Moolenbroek.Bl -tag -width flag
58*e7ca52fbSDavid van Moolenbroek.It Fl l
59*e7ca52fbSDavid van MoolenbroekPrint the byte number (decimal) and the differing
60*e7ca52fbSDavid van Moolenbroekbyte values (octal) for each difference.
61*e7ca52fbSDavid van Moolenbroek.It Fl s
62*e7ca52fbSDavid van MoolenbroekPrint nothing for differing files; return exit
63*e7ca52fbSDavid van Moolenbroekstatus only.
64*e7ca52fbSDavid van Moolenbroek.El
65*e7ca52fbSDavid van Moolenbroek.Pp
66*e7ca52fbSDavid van MoolenbroekThe optional arguments
67*e7ca52fbSDavid van Moolenbroek.Ar skip1
68*e7ca52fbSDavid van Moolenbroekand
69*e7ca52fbSDavid van Moolenbroek.Ar skip2
70*e7ca52fbSDavid van Moolenbroekare the byte offsets from the beginning of
71*e7ca52fbSDavid van Moolenbroek.Ar file1
72*e7ca52fbSDavid van Moolenbroekand
73*e7ca52fbSDavid van Moolenbroek.Ar file2 ,
74*e7ca52fbSDavid van Moolenbroekrespectively, where the comparison will begin.
75*e7ca52fbSDavid van MoolenbroekThe offset is decimal by default, but may be expressed as an hexadecimal
76*e7ca52fbSDavid van Moolenbroekor octal value by preceding it with a leading ``0x'' or ``0''.
77*e7ca52fbSDavid van Moolenbroek.Pp
78*e7ca52fbSDavid van MoolenbroekThe
79*e7ca52fbSDavid van Moolenbroek.Nm
80*e7ca52fbSDavid van Moolenbroekutility exits with one of the following values:
81*e7ca52fbSDavid van Moolenbroek.Bl -tag -width 4n
82*e7ca52fbSDavid van Moolenbroek.It 0
83*e7ca52fbSDavid van MoolenbroekThe files are identical.
84*e7ca52fbSDavid van Moolenbroek.It 1
85*e7ca52fbSDavid van MoolenbroekThe files are different; this includes the case
86*e7ca52fbSDavid van Moolenbroekwhere one file is identical to the first part of
87*e7ca52fbSDavid van Moolenbroekthe other.
88*e7ca52fbSDavid van MoolenbroekIn the latter case, if the
89*e7ca52fbSDavid van Moolenbroek.Fl s
90*e7ca52fbSDavid van Moolenbroekoption has not been specified,
91*e7ca52fbSDavid van Moolenbroek.Nm
92*e7ca52fbSDavid van Moolenbroekwrites to standard output that EOF was reached in the shorter
93*e7ca52fbSDavid van Moolenbroekfile (before any differences were found).
94*e7ca52fbSDavid van Moolenbroek.It \*[Gt]1
95*e7ca52fbSDavid van MoolenbroekAn error occurred.
96*e7ca52fbSDavid van Moolenbroek.El
97*e7ca52fbSDavid van Moolenbroek.Sh SEE ALSO
98*e7ca52fbSDavid van Moolenbroek.Xr diff 1 ,
99*e7ca52fbSDavid van Moolenbroek.Xr diff3 1
100*e7ca52fbSDavid van Moolenbroek.Sh STANDARDS
101*e7ca52fbSDavid van MoolenbroekThe
102*e7ca52fbSDavid van Moolenbroek.Nm
103*e7ca52fbSDavid van Moolenbroekutility is expected to be
104*e7ca52fbSDavid van Moolenbroek.St -p1003.2
105*e7ca52fbSDavid van Moolenbroekcompatible.
106