https://github.com/waldner/basha123
SHA1/2/3 implementation in pure bash
https://github.com/waldner/basha123
keccak md5 message-digest sha-1 sha-2 sha-3
Last synced: 6 months ago
JSON representation
SHA1/2/3 implementation in pure bash
- Host: GitHub
- URL: https://github.com/waldner/basha123
- Owner: waldner
- Created: 2021-05-23T18:56:01.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-08-07T08:58:43.000Z (about 1 year ago)
- Last Synced: 2025-03-30T03:41:15.661Z (7 months ago)
- Topics: keccak, md5, message-digest, sha-1, sha-2, sha-3
- Language: Shell
- Homepage:
- Size: 8.9 MB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# baSHA123
Low speed SHA1/2/3 message digest in Bash
### What's this?
This is an implementation of [**MD5**](https://en.wikipedia.org/wiki/MD5), [**SHA1**](https://en.wikipedia.org/wiki/SHA-1) and [**SHA2**](https://en.wikipedia.org/wiki/SHA-2) message digest algorithms, using only pure [**bash**](https://tiswww.case.edu/php/chet/bash/bashtop.html) without any external programs. No dependencies, other than a recent version of bash.
NEW: [**SHA3**](https://en.wikipedia.org/wiki/SHA-3) is also implemented, setting a new slowness record at an exceptional processing rate of almost 20 bytes/second.
**WARNING: THIS IS EXTREMELY SLOW AND INEFFICIENT. DO NOT USE IT FOR ANY SERIOUS PURPOSE, AND DO NOT USE IT ON LARGE AMOUNTS OF DATA (EVEN _A FEW TENS_ OF KB ARE ALREADY A LOT FOR THIS BEAST). YOU HAVE BEEN WARNED.**
### Why is it "low speed"?
See the following comparison with [openssl](https://www.openssl.org/) to calculate the SHA2-512 digest of a ~50K file:
$ ls -l /bin/cmp
-rwxr-xr-x 1 root root 51856 Apr 8 2019 /bin/cmp
$ time openssl sha512 /bin/cmp > /dev/null
real 0m0.016s
user 0m0.007s
sys 0m0.008s
$ time ./sha512.sh < /bin/cmp > /dev/null
real 1m29.471s
user 1m29.397s
sys 0m0.071s
But where we really shine is with SHA3 processing:
$ ls -l /bin/unstr
-rwxr-xr-x 1 root root 14088 Apr 8 2019 /bin/unstr
$ time openssl sha3-256 /bin/unstr > /dev/null
real 0m0.004s
user 0m0.000s
sys 0m0.004s
$ time ./sha3-256.sh < /bin/unstr > /dev/null
real 12m22.685s
user 12m14.812s
sys 0m1.882s
### How do I install it?
Just run the `sha*.sh` script that you want/need, feeding input on stdin (so use pipes or redirections). Sample run:
$ echo foobarbazzz12345 | ./sha1.sh
2654fedc3cbf3add0a1a49b8fd8ae735013f4973
$ echo foobarbazzz12345 | ./sha3-512.sh
5c7e1cbb5b9cdae65c0467db7cc3b236cf8c5c47f06ae63d038ca09ec4cd308904887c20f7bb354a58e3c5d0c956c697267ab7137fb9303ee1f73049f58c0c79
`shake128.sh` and `shake256.sh` are variable-length output digests, so an optional argument may be specified, indicating the desired output length (in bytes).
### Testing
If you feel masochistic, there are some test scripts inside the `tests/` directory. Just run the one(s) you want from the root of the repo.