summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJim Meyering <jim@meyering.net>1995-08-08 05:37:39 +0000
committerJim Meyering <jim@meyering.net>1995-08-08 05:37:39 +0000
commitc02722d395118cbb0a2e6187339b08702d107bce (patch)
tree63f44b9ffb3c3d71fce3d5cbdbd7333d5890896d /doc
parentb3d74743a86f6f9ddf13b1c186f9bb59b53653cb (diff)
downloadcoreutils-c02722d395118cbb0a2e6187339b08702d107bce.tar.xz
work on updating md5sum
Diffstat (limited to 'doc')
-rw-r--r--doc/textutils.texi21
1 files changed, 15 insertions, 6 deletions
diff --git a/doc/textutils.texi b/doc/textutils.texi
index 7b27e1e4c..0e1ef7b3c 100644
--- a/doc/textutils.texi
+++ b/doc/textutils.texi
@@ -1559,12 +1559,16 @@ options}.
@cindex message-digest, 128-bit
@code{md5sum} computes a 128-bit checksum (or @dfn{fingerprint} or
-@dfn{message-digest} for each given @var{file}, or standard input if
-none are given or for a @var{file} of @samp{-}. It can also check if the
-checksum has changed. Synopsis:
+@dfn{message-digest}) for each specified @var{file}.
+If a @var{file} is specified as @samp{-} or if no files are given
+@code{md5sum} computes the checksum for the standard input.
+@code{md5sum} can also determine whether
+a file's checksum has changed. Synopsis:
@example
md5sum [@var{option}]@dots{} [@var{file}]@dots{}
+md5sum [@var{option}]@dots{} --check [@var{file}]
+md5sum [@var{option}]@dots{} --string=@var{string}@dots{}
@end example
For each @var{file}, @samp{md5sum} outputs the MD5 checksum, a flag
@@ -1584,9 +1588,14 @@ but other systems have different internal and external character
representations, notably to mark end-of-line.
@item -c
-@itemx --check=@var{file}
-@var{file} is taken as the output of a former run of @samp{md5sum}: each
-line consists of an MD5 checksum, a binary/text flag, and a filename.
+@itemx --check
+Read filenames and checksum information from the single @var{file}
+(or from stdin if no @var{file} was specified) and report whether
+each named file and the corresponding checksum data are consistent.
+The input to this mode of @code{md5sum} is usually the output of
+a prior, checksum-generating run of @samp{md5sum}.
+Each recognized line of input consists of an MD5 checksum, a binary/text
+flag, and then a filename.
The file will be opened (with each possible relative path) and the its
message-digest computed. If this computed message digest is not the
same as that given in the line, the file will be marked as failed.