https://github.com/ricardobranco777/xhash
This Go program uses goroutines to calculate multiple hashes on strings, files and directories
https://github.com/ricardobranco777/xhash
blake2b golang goroutine hashing md5 sha1 sha256 sha3
Last synced: about 1 year ago
JSON representation
This Go program uses goroutines to calculate multiple hashes on strings, files and directories
- Host: GitHub
- URL: https://github.com/ricardobranco777/xhash
- Owner: ricardobranco777
- License: mit
- Created: 2016-12-28T19:38:49.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2025-04-14T20:19:09.000Z (about 1 year ago)
- Last Synced: 2025-04-14T21:26:47.764Z (about 1 year ago)
- Topics: blake2b, golang, goroutine, hashing, md5, sha1, sha256, sha3
- Language: Go
- Homepage:
- Size: 265 KB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# xhash
This Go program uses goroutines to calculate multiple hashes on strings, files and directories. By default it reads from standard input. It can be used as a drop-in replacement for the GNU **coreutils** when hard-linked as **md5sum**, etc. and it actually supports the `--zero` option with `--check`, [unlike the GNU tool](https://debbugs.gnu.org/cgi/bugreport.cgi?bug=69368). The output format is fully configurable.
Docker image available at `ghcr.io/ricardobranco777/xhash:latest`
## Examples:
* To hash every file in your home directory using both SHA-512 and SHA-256
`xhash -r -sha512 -sha256 $HOME`
* To hash the /etc/passwd file with all algorithms _except_ MD5 and SHA-1
`xhash -all -md5 -sha1 /etc/passwd`
* To hash the string "abc" with all algorithms
`xhash -all -s "abc"`
* To check the hashes in /tmp/hashes.md5
`xhash -c /tmp/hashes.md5`
* To hash all files specified in /tmp/files.list
`xhash -i /tmp/files.list`
## Output format
The output format is the same as the BSD commands. Use `--gnu` to use the format used by **md5sum**.
To use the format used by **hashdeep** use `--size -f '{{range .}}{{.Sum}},{{end}}{{(index . 0).File}}\n'`
## Requirements
- Go 1.24+
## Usage
```
Usage: xhash [OPTIONS] [-s STRING...]|[-c FILE]|[-i FILE]|[FILE...]|[-r FILE... DIRECTORY...]
-a, --all all algorithms (except others specified, if any)
-b, --base64 output hash in Base64 encoding format
--blake2b-256 BLAKE2b-256 algorithm
--blake2b-512 BLAKE2b-512 algorithm
--blake2s-256 BLAKE2s-256 algorithm
--blake3 BLAKE3 algorithm
-c, --check string read checksums from file (use "" for stdin) (default "\x00")
-f, --format string output format (default "{{range .}}{{.Name}} ({{.File}}) = {{.Sum }}\n{{end}}")
--gnu output hashes in the format used by md5sum
-H, --hmac string key for HMAC (in hexadecimal) or read from specified pathname (default "\x00")
--ignore-missing don't fail or report status for missing files
-i, --input string read pathnames from file (use "" for stdin) (default "\x00")
--md5 MD5 algorithm
-q, --quiet don't print OK for each successfully verified file
-r, --recursive recurse into directories
--sha1 SHA1 algorithm
--sha256 SHA256 algorithm
--sha3-256 SHA3-256 algorithm
--sha3-512 SHA3-512 algorithm
--sha512 SHA512 algorithm
--sha512-256 SHA512-256 algorithm
--size output size
-S, --status don't output anything, status code shows success
--strict exit non-zero for improperly formatted checksum lines
-s, --string treat arguments as strings
-L, --symlinks follow symbolic links while recursing directories
-v, --verbose verbose operation
--version show version and exit
-w, --warn warn about improperly formatted checksum lines
-z, --zero end each output line with NUL, not newline, and disable file name escaping
```