10564b1175
groff 1.23.0 added .MR to its -man macro package. The NEWS file states
that the inclusion of the macro "was prompted by its introduction to
Plan 9 from User Space's troff in August 2020." From d32deab it seems
that the name for Plan 9 from User Space's implementation was suggested
by groff maintainer G. Brandon Robinson.
Not sure if the intention was to make these definitions compatible, but
it would be nice if they were.
Currently, Plan 9 from User Space's .MR expects its second argument to
be parenthesized. groff's .MR does not. This results in extra
parentheses appearing in manual references when viewing Plan 9 from User
Space's manual pages on a system using groff.
78 lines
1.4 KiB
Groff
78 lines
1.4 KiB
Groff
.TH SUM 1
|
|
.SH NAME
|
|
sum, md5sum, sha1sum \- sum and count blocks in a file
|
|
.SH SYNOPSIS
|
|
.B sum
|
|
[
|
|
.B -5r
|
|
]
|
|
[
|
|
.I file ...
|
|
]
|
|
.PP
|
|
.B md5sum
|
|
[
|
|
.I file ...
|
|
]
|
|
.PP
|
|
.B sha1sum
|
|
[
|
|
.I file ...
|
|
]
|
|
.SH DESCRIPTION
|
|
By default,
|
|
.I sum
|
|
calculates and prints a 32-bit hexadecimal checksum,
|
|
a byte count,
|
|
and the name of
|
|
each
|
|
.IR file .
|
|
The checksum is also a function of the input length.
|
|
If no files are given,
|
|
the standard input is
|
|
summed.
|
|
Other summing algorithms are available.
|
|
The options are
|
|
.TP
|
|
.B -r
|
|
Sum with the algorithm of System V's
|
|
.B "sum -r"
|
|
and print the length (in 1K blocks) of the input.
|
|
.TP
|
|
.B -5
|
|
Sum with System V's default algorithm
|
|
and print the length (in 512-byte blocks) of the input.
|
|
.PP
|
|
.I Sum
|
|
is typically used to look for bad spots,
|
|
to validate a file communicated over
|
|
some transmission line or
|
|
as a quick way to determine if two files on different machines might be the same.
|
|
.PP
|
|
.B Md5sum
|
|
computes the 32 hex digit RSA Data Security, Inc. MD5 Message-Digest Algorithm
|
|
described in RFC1321.
|
|
If no
|
|
.I files
|
|
are given,
|
|
the standard input is
|
|
summed.
|
|
.PP
|
|
.B Sha1sum
|
|
computes the 40 hex digit National Institute of Standards and Technology SHA1 secure hash algorithm
|
|
described in FIPS PUB 180-1.
|
|
If no
|
|
.I files
|
|
are given,
|
|
the standard input is
|
|
summed.
|
|
.SH SOURCE
|
|
.B \*9/src/cmd/sum.c
|
|
.br
|
|
.B \*9/src/cmd/md5sum.c
|
|
.br
|
|
.B \*9/src/cmd/sha1sum.c
|
|
.SH "SEE ALSO"
|
|
.MR cmp 1 ,
|
|
.MR wc 1
|