meowsum

= meowsum
apiote
v1.0.0 2022-06-17
:toc:

== Name

meowsum — print or verify Meow hash checksums

== Description

The meowsum utility calculates and prints or verifies https://mollyrocket.com/meowhash[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 https://developercertificate.org/[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 .

Meowhash created by https://github.com/cmuratori/meow_hash[mollyrocket], Zlib license.

== Copyright

Copyright (C) 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