xsum - Compute and check file checksums/digests (using various algorithms)
This document describes version 0.003 of xsum (from Perl distribution App-xsum), released on 2019-09-12.
Usage:
% xsum [options] <file> ...
Examples:
Compute MD5 digests for some files:
% xsum -a md5 *.dat
Compute SHA1 digest for data in stdin:
% somecmd | xsum -a sha1 -
Check MD5 digests of files listed in MD5SUMS:
% xsum --check -a md5 MD5SUMS
Check MD5 digest of one file:
% xsum -a md5 download.exe -C 9f4b2277f50a412e56de6e0306f4afb8
Check MD5 digest of two files:
% xsum -a md5 download1.exe -C 9f4b2277f50a412e56de6e0306f4afb8 download2.zip -C 62b3bf86abdfdd87e9f6a3ea7b51aa7b
xsum is a handy small utility that can be used as an alternative/replacement for the individual per-algorithm Unix utilities like md5sum, sha1sum, sha224sum, and so on. It's basically the same as said Unix utilities but you can use a single command instead.
xsum
md5sum
sha1sum
sha224sum
The backend of xsum is a Perl module File::Digest which in turn delegates to the individual per-algorithm backend like Digest::MD5, Digest::SHA, and so on. Most of the backend modules are written in C/XS so you don't suffer significant performance decrease.
* marks required options.
*
Default value:
"md5"
Valid values:
["crc32","md5","sha1","sha224","sha256","sha384","sha512","sha512224","sha512256"]
Read checksum from files and check them.
Supply checksum(s) (JSON-encoded).
Can be specified multiple times.
See --file.
--file
Create a BSD-style checksum.
Display help message and exit.
Display program's version and exit.
This script has shell tab completion capability with support for several shells.
To activate bash completion for this script, put:
complete -C xsum xsum
in your bash startup (e.g. ~/.bashrc). Your next shell session will then recognize tab completion for the command. Or, you can also directly execute the line above in your shell to activate immediately.
It is recommended, however, that you install modules using cpanm-shcompgen which can activate shell completion for scripts immediately.
To activate tcsh completion for this script, put:
complete xsum 'p/*/`xsum`/'
in your tcsh startup (e.g. ~/.tcshrc). Your next shell session will then recognize tab completion for the command. Or, you can also directly execute the line above in your shell to activate immediately.
It is also recommended to install shcompgen (see above).
For fish and zsh, install shcompgen as described above.
Please visit the project's homepage at https://metacpan.org/release/App-xsum.
Source repository is at https://github.com/perlancar/perl-App-xsum.
Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=App-xsum
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
shasum. Script which comes with the perl distribution.
md5sum. Unix utility.
sha1sum. Unix utility.
sha256sum. Unix utility.
perlancar <perlancar@cpan.org>
This software is copyright (c) 2019, 2016 by perlancar@cpan.org.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install App::xsum, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::xsum
CPAN shell
perl -MCPAN -e shell install App::xsum
For more information on module installation, please visit the detailed CPAN module installation guide.