ckdist.1 (2552ba361954415a8e2ae144f37788033c6c12f6) ckdist.1 (dcf118f17cfafbc38a1312903fb686cc7dafcdfb)
1.\" Copyright (c) 1997 Robert Nordier
2.\" All rights reserved.
3.\"
1.\" Copyright (c) 1997 Robert Nordier
2.\" All rights reserved.
3.\"
4.\" $FreeBSD$
4.\" $Id: ckdist.1,v 1.2 1997/01/20 16:47:04 rnordier Exp $
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the

--- 8 unchanged lines hidden (view full) ---

21.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
23.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
24.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25.\" POSSIBILITY OF SUCH DAMAGE.
26.\"
27.Dd January 20, 1997
28.Dt CKDIST 1
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the

--- 8 unchanged lines hidden (view full) ---

21.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
23.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
24.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25.\" POSSIBILITY OF SUCH DAMAGE.
26.\"
27.Dd January 20, 1997
28.Dt CKDIST 1
29.Os
29.Os
30.Sh NAME
31.Nm ckdist
32.Nd check software distributions
33.Sh SYNOPSIS
30.Sh NAME
31.Nm ckdist
32.Nd check software distributions
33.Sh SYNOPSIS
34.Nm
34.Nm ckdist
35.Bq Fl airsx
36.Bq Fl d Ar dir
37.Bq Fl n Ar name
38.Bq Fl t Ar type
35.Bq Fl airsx
36.Bq Fl d Ar dir
37.Bq Fl n Ar name
38.Bq Fl t Ar type
39.Ar
39.Ar file ...
40.Sh DESCRIPTION
41The
40.Sh DESCRIPTION
41The
42.Nm
43utility reads
44.Dq checksum
45files (which are assumed to specify components
42.Nm ckdist
43utility reads "checksum" files (which are assumed to specify components
46of a software distribution) and verifies the integrity of the
47distribution by validating the checksum of each component file.
44of a software distribution) and verifies the integrity of the
45distribution by validating the checksum of each component file.
48Both MD5 (128-bit
49.Dq "message digest" )
50and
51.Pa .inf
52(32-bit CRC) checksum
46Both MD5 (128-bit "message digest") and .inf (32-bit CRC) checksum
53formats are supported.
54.Pp
55The
56.Ar file
47formats are supported.
48.Pp
49The
50.Ar file
57operands may refer to regular files or to directories.
58Regular files
59named
60.Pa md5 ,
61or which have an
62.Pa .md5
63or an
64.Pa .inf
65extension, are
51operands may refer to regular files or to directories. Regular files
52named "md5", or which have an ".md5" or an ".inf" extension, are
66assumed to be of the implied type, otherwise format is determined from
53assumed to be of the implied type, otherwise format is determined from
67content.
68If a directory is specified, it is searched for
54content. If a directory is specified, it is searched for
69appropriately-named files only.
70.Pp
55appropriately-named files only.
56.Pp
71The options are as follows:
72.\"Bl -tag -width ".Fl n Ar name"
57Options are as follows:
73.Bl -tag -width 8n -offset indent
74.It Fl a
75Report on all distribution components, not just those in respect of
76which errors are detected.
77.It Fl i
78Ignore missing distribution components.
79.It Fl r
80Search specified directories recursively.
81.It Fl s
82Suppress complaints about inaccessible checksum files and directories.
83.It Fl x
84Verify the existence of distribution components (and also check sizes,
58.Bl -tag -width 8n -offset indent
59.It Fl a
60Report on all distribution components, not just those in respect of
61which errors are detected.
62.It Fl i
63Ignore missing distribution components.
64.It Fl r
65Search specified directories recursively.
66.It Fl s
67Suppress complaints about inaccessible checksum files and directories.
68.It Fl x
69Verify the existence of distribution components (and also check sizes,
85in the case of
86.Pa .inf
87files), but omit the more time-consuming step of
70in the case of .inf files), but omit the more time-consuming step of
88actually computing and comparing checksums.
89.It Fl d Ar dir
90Look for distribution components in the directory
91.Ar dir .
92.It Fl n Ar name
93Access distribution components using the filename
94.Ar name .
71actually computing and comparing checksums.
72.It Fl d Ar dir
73Look for distribution components in the directory
74.Ar dir .
75.It Fl n Ar name
76Access distribution components using the filename
77.Ar name .
95When accessing
96.Pa .inf
97file components, append the appropriate
98extension to the filename.
78(When accessing .inf file components, append the appropriate
79extension to the filename.)
99.It Fl t Ar type
100Assume that all specified checksum files are of the format
101.Ar type ,
102and search directories only for files in this format (where
80.It Fl t Ar type
81Assume that all specified checksum files are of the format
82.Ar type ,
83and search directories only for files in this format (where
103.Ar type
104is either
105.Cm md5
106or
107.Cm inf ) .
84.Ar type
85is either "md5" or "inf").
108.El
86.El
109.Sh EXIT STATUS
110The
111.Nm
112utility exits with one of the following values:
113.Pp
114.Bl -tag -width indent
115.It 0
116No errors were detected.
117.It 1
118Errors were found in a distribution.
119.It 2
120Usage errors, inaccessible input files, or
121other system errors were encountered.
122.El
123.Sh SEE ALSO
87.Sh SEE ALSO
124.Xr cksum 1 ,
125.Xr md5 1
88cksum(1), md5(1)
89.Sh DIAGNOSTICS
90Exit status is 0 if no errors were detected, 1 if errors were found in
91a distribution, and 2 if usage errors, inaccessible input files, or
92other system errors were encountered.
126.Sh NOTES
93.Sh NOTES
127Both
128.Bx
129and
130.Tn DOS
131versions of
132.Nm
94Both BSD and DOS versions of
95.Nm ckdist
133are available.
96are available.