manual/gnumaniak/original/man1/sha1sum.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 nl man page
  12 .\"     man pages are NOT obsolete!
  13 .\"     <ragnar@ragnar-hojland.com>
  14 .TH NL 1 "7 October 2002" "GNU textutils 2.1"
  15 .SH NAME
  16 \fBsha1sum\fR \- calculate and check SHA1 hash checksums
  17 .SH SYNOPSIS
  18 .B sha1sum
  19 .RB [ \-bctw ]
  20 .RB [ \-\-binary ]
  21 .RB [ \-\-check ]
  22 .RB [ \-\-status ]
  23 .RB [ \-\-text ]
  24 .RB [ \-\-warn ]
  25 .RI [ FILE... ]
  26
  27 .BR sha1sum " [" \-\-help "] [" \-\-version ]
  28 .SH DESCRIPTION
  29 .B sha1sum
  30 outputs or checks the SHA1 checkum of
  31 .I FILE s according to FIPS-180-1.  If
  32 .I FILE
  33 is omitted or if is a
  34 .RB ` \- ',
  35 standard input is used.
  36
  37 Output format when calculating checksums consists for each input \fIFILE\fR,
  38 in a SHA1 sum, a space, a file type character (`*' for binary, ` ' for text)
  39 and a filename.  This is the format \fB\-\-check\fR expects.
  40
  41 .SH OPTIONS
  42 .TP
  43 .B \-b, \-\-binary
  44 Reads the input \fIFILE\fRs in binary mode. This option has no effect on Unix
  45 systems, since they don't distinguish between binary and text files.  This is
  46 the default on DOS platforms.
  47 .TP
  48 .B \-c, \-\-check
  49 Reads filenames and checksums from the given \fIFILE\fRs, and report wether
  50 each file and the corresponding checksum are correct.  \fb\-\-check\fR
  51 expects the same format \fBsha1sum\fR outputs.
  52 .sp
  53 .nf
  54 For example:
  55 sha1sum *.sha1 > checksums.sha1
  56 sha1sum \-\-check checksums.sha1
  57 .fi
  58 .TP
  59 .B \-\t, \-\-text
  60 Reads the input \fIFILE\fRs in text mode.
  61 .TP
  62 .B \-w, \-\-warn
  63 Warn about badly formatted entries.  Only makes sense with \fB\-\-check\fR.
  64 .TP
  65 .B \-\-status
  66 Silently exit with a status return code.  Warnings or checksum failures are
  67 omitted, and errors from operations such as opening are reading are printed.
  68 A successful exit code of 0 is only returned is everything is passed and no
  69 errors have ocurred.  Otherwise a non-zero value is returned.
  70 .TP
  71 .B "\-\-help"
  72 Print a usage message on standard output and exit successfully.
  73 .TP
  74 .B "\-\-version"
  75 Print version information on standard output then exit successfully.
  76 .SH NOTES
  77 Report bugs to bug-textutils@gnu.org.
  78 .br
  79 Man page by Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>
  80