apiote

meowsum

https://git.apiote.xyz/git/meowsum.git

Name

meowsum — print or verify Meow hash checksums

Description

The meowsum utility calculates and prints or verifies Meow hash checksums. The output format is consistent with POSIX cksum; meowsum prints the checksum, number of bytes, and file path to standard output.

The meowsum is an alternative for such utilities as cksum, md5sum, sha512sum.

Usage

	meowsum -h
	meowsum [-ceq] FILE…​
	meowsum [-s size] FILE…​
	-h  show this help and exit
	-c  read sums from the FILEs and check them
	-s  size set hash size; size can be 32, 64, 128 bits;
			the default is 128
	The following options are useful only when verifying checksums:
	-q  only return status; do not print OK, ERH, ERS, ERM
	-e  fail for missing files

Building

meowsum uses mk for building but it can also be built manually.

To build meowsum, a C compiler that supports C17 is needed. By default, it’s clang, but it can be changed using the CC variable. Other compilers, however, have not been tested.

To generate documentation, scdoc is needed.

To compile only meowsum, run mk meowsum. To generate only the manpage, run mk meowsum.1. To build everything at once, run just mk.

Installation

meowsum can be installed using mk, but also manually.

To install using mk, run mk install as root. This will copy the binary to $PREFIX/bin/, which is /usr/local/bin/ by default, and the manpage to /usr/share/man/man1/.

Future

meowsum might be rewritten to another language, but it will definitely not be Rust. It is, however, feature complete. Feature requests and patches with new features will be dropped.

Contributing

This project is finished; no more functions will be implemented; all feature requests will be ignored.

This project uses The Code of Merit, which is available as CODE_OF_CONDUCT file.

Fixes and patches are welcome; please send them to meowsum@git.apiote.xyz using git send-email. They must include a sign-off to certify agreement to Developer Certificate of Origin.

All communication—questions, bugs, etc.—should go through the mailing list available at meowsum@git.apiote.xyz. Note that all communication will be made public at https://asgard.apiote.xyz/.

Mirrors

The canonical repository for this project is https://git.apiote.xyz/meowsum.git it’s mirrored at https://notabug.org/apiote/meowsum

Mirrors exist solely for the sake of the code and any additional functions provided by third-party services (including but not limited to issues and pull requests) will not be used and will be ignored.

Authors

Maintained by apiote <me@apiote.xyz>.

Meowhash created by mollyrocket, Zlib license.

Copyright © 2021 apiote

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/gpl.html