xref: /netbsd-src/usr.bin/cmp/cmp.1 (revision 4b30c543a0b21e3ba94f2c569e9a82b4fdb2075f)
1.\" Copyright (c) 1987, 1990 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" This code is derived from software contributed to Berkeley by
5.\" the Institute of Electrical and Electronics Engineers, Inc.
6.\"
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 the
14.\"    documentation and/or other materials provided with the distribution.
15.\" 3. All advertising materials mentioning features or use of this software
16.\"    must display the following acknowledgement:
17.\"	This product includes software developed by the University of
18.\"	California, Berkeley and its contributors.
19.\" 4. Neither the name of the University nor the names of its contributors
20.\"    may be used to endorse or promote products derived from this software
21.\"    without specific prior written permission.
22.\"
23.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
24.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
27.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33.\" SUCH DAMAGE.
34.\"
35.\"     from: @(#)cmp.1	6.7 (Berkeley) 6/27/91
36.\"	$Id: cmp.1,v 1.3 1993/09/21 22:37:52 jtc Exp $
37.\"
38.Dd June 27, 1991
39.Dt CMP 1
40.Os
41.Sh NAME
42.Nm cmp
43.Nd Compare two files.
44.Sh SYNOPSIS
45.Nm cmp
46.Op Fl l Li \&| Fl s
47.Ar file1 file2
48.Sh DESCRIPTION
49The cmp utility compares two files of any type and
50writes the results to the standard output.
51By default,
52.Nm
53is silent if the files are the same; if they differ, the byte
54and line number at which the first difference occurred is reported.
55.Pp
56Bytes and lines are numbered beginning with one.
57.Pp
58The following options are available:
59.Bl -tag -width Ds
60.It Fl l
61Print the byte number (decimal) and the differing
62byte values (octal) for each difference.
63.It Fl s
64Print nothing for differing files; return exit
65status only.
66.El
67.Pp
68If
69.Ar file1
70or
71.Ar file2
72is ``-'', the the standard input is used.
73.Pp
74The
75.Nm cmp
76utility exits with one of the following values:
77.Bl -tag -width 4n
78.It 0
79The files are identical.
80.It 1
81The files are different; this includes the case
82where one file is identical to the first part of
83the other.
84In the latter case, if the
85.Fl s
86option has
87not been specified, cmp writes to standard error
88that EOF was reached in the shorter file (before
89any differences were found).
90.It >1
91An error occurred.
92.El
93.Sh SEE ALSO
94.Xr diff 1 ,
95.Xr diff3 1
96.Sh STANDARDS
97The
98.Nm cmp
99utility conforms to
100.St -p1003.2-92 .
101