diff --git a/usr.sbin/ckdist/ckdist.1 b/usr.sbin/ckdist/ckdist.1 index 9a5f9f948a37..91a809160213 100644 --- a/usr.sbin/ckdist/ckdist.1 +++ b/usr.sbin/ckdist/ckdist.1 @@ -40,23 +40,36 @@ .Sh DESCRIPTION The .Nm -utility reads "checksum" files (which are assumed to specify components +utility reads +.Dq checksum +files (which are assumed to specify components of a software distribution) and verifies the integrity of the distribution by validating the checksum of each component file. -Both MD5 (128-bit "message digest") and .inf (32-bit CRC) checksum +Both MD5 (128-bit +.Dq "message digest" ) +and +.Pa .inf +(32-bit CRC) checksum formats are supported. .Pp The .Ar file operands may refer to regular files or to directories. Regular files -named "md5", or which have an ".md5" or an ".inf" extension, are +named +.Pa md5 , +or which have an +.Pa .md5 +or an +.Pa .inf +extension, are assumed to be of the implied type, otherwise format is determined from content. If a directory is specified, it is searched for appropriately-named files only. .Pp -Options are as follows: +The options are as follows: +.\"Bl -tag -width ".Fl n Ar name" .Bl -tag -width 8n -offset indent .It Fl a Report on all distribution components, not just those in respect of @@ -69,7 +82,9 @@ Search specified directories recursively. Suppress complaints about inaccessible checksum files and directories. .It Fl x Verify the existence of distribution components (and also check sizes, -in the case of .inf files), but omit the more time-consuming step of +in the case of +.Pa .inf +files), but omit the more time-consuming step of actually computing and comparing checksums. .It Fl d Ar dir Look for distribution components in the directory @@ -77,19 +92,34 @@ Look for distribution components in the directory .It Fl n Ar name Access distribution components using the filename .Ar name . -When accessing .inf file components, append the appropriate +When accessing +.Pa .inf +file components, append the appropriate extension to the filename. .It Fl t Ar type Assume that all specified checksum files are of the format .Ar type , and search directories only for files in this format (where .Ar type -is either "md5" or "inf"). +is either +.Cm md5 +or +.Cm inf ) . .El .Sh EXIT STATUS -Exit status is 0 if no errors were detected, 1 if errors were found in -a distribution, and 2 if usage errors, inaccessible input files, or +The +.Nm +utility exits with one of the following values: +.Pp +.Bl -tag -width indent +.It 0 +No errors were detected. +.It 1 +Errors were found in a distribution. +.It 2 +Usage errors, inaccessible input files, or other system errors were encountered. +.El .Sh SEE ALSO .Xr cksum 1 , .Xr md5 1