manual/gnumaniak/original/man1/md5sum.1

   1 .\" You may copy, distribute and modify under the terms of the LDP General
   2 .\" Public License as specified in the LICENSE file that comes with the
   3 .\" gnumaniak distribution
   4 .\"
   5 .\" The author kindly requests that no comments regarding the "better"
   6 .\" suitability or up-to-date notices of any info documentation alternative
   7 .\" is added without contacting him first.
   8 .\"
   9 .\" (C) 2002 Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>
  10 .\"
  11 .\"     GNU md5sum man page
  12 .\"     man pages are NOT obsolete!
  13 .\"     <ragnar@ragnar-hojland.com>
  14 .TH MD5SUM 1 "7 October 2002" "GNU textutils 2.1"
  15 .SH NAME
  16 \fBmd5sum\fR \- calculate and check MD5 hash checksums
  17 .SH SYNOPSIS
  18 .B md5sum
  19 .RB [ \-bctw ]
  20 .RB [ \-\-binary ]
  21 .RB [ \-\-check ]
  22 .RB [ \-\-status ]
  23 .RB [ \-\-text ]
  24 .RB [ \-\-warn ]
  25 .RI [ FILE... ]
  26
  27 .BR md5sum " [" \-\-help "] [" \-\-version ]
  28 .SH DESCRIPTION
  29 .B md5sum
  30 computes and prints a 128-bit checksum (or "fingerprint" or
  31 "message-digest") for each given
  32 .IR FILE .
  33 If
  34 .I FILE
  35 is omitted or if it is a
  36 .RB ` \- ',
  37 standard input is used for reading.
  38
  39 Output format when calculating checksums consists for each input \fIFILE\fR,
  40 in a MD5 sum, a space, a file type character (`*' for binary, ` ' for text)
  41 and a filename.  This is the format \fB\-\-check\fR expects.
  42 .SH OPTIONS
  43 .TP
  44 .B \-b, \-\-binary
  45 Reads the input \fIFILE\fRs in binary mode. This option has no effect on Unix
  46 systems, since they don't distinguish between binary and text files.  This is
  47 the default on DOS platforms.
  48 .TP
  49 .B \-c, \-\-check
  50 Reads filenames and checksums from the given \fIFILE\fRs, and report wether
  51 each file and the corresponding checksum are correct.  \fb\-\-check\fR
  52 expects the same format \fBmd5sum\fR outputs.
  53 .sp
  54 .nf
  55 For example:
  56 md5sum *.txt > checksums.md5
  57 md5sum \-\-check checksums.md5
  58 .fi
  59 .TP
  60 .B \-\-text
  61 Treat all input files as text files.
  62 .TP
  63 .B \-w, \-\-warn
  64 When verifying checksums, warn about improperly formatted MD5
  65 checksum lines.  This option is useful only if all but a few lines
  66 in the checked input are valid.
  67 .TP
  68 .B \-\-status
  69 Silently exit with a status return code.  Warnings or checksum failures are
  70 omitted, and errors from operations such as opening are reading are printed.
  71 A successful exit code of 0 is only returned is everything is passed and no
  72 errors have ocurred.  Otherwise a non-zero value is returned.
  73 .TP
  74 .B "\-\-help"
  75 Print a usage message on standard output and exit successfully.
  76 .TP
  77 .B "\-\-version"
  78 Print version information on standard output then exit successfully.
  79 .SH NOTES
  80 Report bugs to bug-textutils@gnu.org.
  81 .br
  82 Man page by Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>