1SHASUM(1)             User Contributed Perl Documentation            SHASUM(1)
2
3
4

NAME

6       shasum - Print or Check SHA Checksums
7

SYNOPSIS

9        Usage: shasum [OPTION]... [FILE]...
10        Print or check SHA checksums.
11        With no FILE, or when FILE is -, read standard input.
12
13          -a, --algorithm   1 (default), 224, 256, 384, 512, 512224, 512256
14          -b, --binary      read in binary mode
15          -c, --check       read SHA sums from the FILEs and check them
16          -t, --text        read in text mode (default)
17          -p, --portable    read in portable mode
18                                produces same digest on Windows/Unix/Mac
19          -0, --01          read in BITS mode
20                                ASCII '0' interpreted as 0-bit,
21                                ASCII '1' interpreted as 1-bit,
22                                all other characters ignored
23
24        The following two options are useful only when verifying checksums:
25          -s, --status      don't output anything, status code shows success
26          -w, --warn        warn about improperly formatted checksum lines
27
28          -h, --help        display this help and exit
29          -v, --version     output version information and exit
30
31        When verifying SHA-512/224 or SHA-512/256 checksums, indicate the
32        algorithm explicitly using the -a option, e.g.
33
34          shasum -a 512224 -c checksumfile
35
36        The sums are computed as described in FIPS-180-4.  When checking, the
37        input should be a former output of this program.  The default mode is to
38        print a line with checksum, a character indicating type (`*' for binary,
39        ` ' for text, `?' for portable, `^' for BITS), and name for each FILE.
40
41        Report shasum bugs to mshelor@cpan.org
42

DESCRIPTION

44       Running shasum is often the quickest way to compute SHA message
45       digests.  The user simply feeds data to the script through files or
46       standard input, and then collects the results from standard output.
47
48       The following command shows how to compute digests for typical inputs
49       such as the NIST test vector "abc":
50
51               perl -e "print qq(abc)" | shasum
52
53       Or, if you want to use SHA-256 instead of the default SHA-1, simply
54       say:
55
56               perl -e "print qq(abc)" | shasum -a 256
57
58       Since shasum mimics the behavior of the combined GNU sha1sum,
59       sha224sum, sha256sum, sha384sum, and sha512sum programs, you can
60       install this script as a convenient drop-in replacement.
61
62       Unlike the GNU programs, shasum encompasses the full SHA standard by
63       allowing partial-byte inputs.  This is accomplished through the BITS
64       option (-0).  The following example computes the SHA-224 digest of the
65       7-bit message 0001100:
66
67               perl -e "print qq(0001100)" | shasum -0 -a 224
68

AUTHOR

70       Copyright (c) 2003-2013 Mark Shelor <mshelor@cpan.org>.
71

SEE ALSO

73       shasum is implemented using the Perl module Digest::SHA or
74       Digest::SHA::PurePerl.
75
76
77
78perl v5.16.3                      2013-06-26                         SHASUM(1)
Impressum