diff options
author | Paul Duncan <pabs@pablotron.org> | 2023-10-16 17:29:40 -0400 |
---|---|---|
committer | Paul Duncan <pabs@pablotron.org> | 2023-10-16 17:29:40 -0400 |
commit | daf313260345da8fd1a83f7905768e8e6c419bc9 (patch) | |
tree | 126d299f216af9eb03710d528d82810ea5415291 | |
parent | a9696116c81c5794429e6b91e26704b11dd836b5 (diff) | |
download | sha3-daf313260345da8fd1a83f7905768e8e6c419bc9.tar.bz2 sha3-daf313260345da8fd1a83f7905768e8e6c419bc9.zip |
README.md: fix "Tests" section, add "License" section, tweak intro paragraph
-rw-r--r-- | README.md | 40 |
1 files changed, 31 insertions, 9 deletions
@@ -1,10 +1,11 @@ # sha3 -Embeddable, dependency-free [C11][] implementation of the [SHA-3][] -[cryptographic hash functions][hash], [eXtendable Output Functions -(XOF)][xof], and [Hash-based Message Authentication Code functions -(HMAC)][hmac] defined in [FIPS 202][], [SP 800-185][800-185], and the -[draft KangarooTwelve and TurboSHAKE specification][turboshake-ietf]. +Embeddable, dependency-free, [MIT-0][] licensed [C11][] implementation +of the [SHA-3][] [cryptographic hash functions][hash], [eXtendable +Output Functions (XOFs)][xof], and [Hash-based Message Authentication +Code functions (HMAC)][hmac] defined in [FIPS 202][], [SP +800-185][800-185], and the [draft KangarooTwelve and TurboSHAKE +specification][turboshake-ietf]. Includes [AVX-512][] acceleration, [Doxygen][]-friendly [API][] documentation, and a full test suite with sanitizers enabled and test @@ -166,7 +167,7 @@ int main(void) { } ``` -See the `examples/` directory for more examples. +See the `examples/` directory for more. ## Usage @@ -176,8 +177,6 @@ To use this library in your application: 2. Update your build system to compile `sha3.o`. 3. Include `sha3.h` in your application. -See examples in the `examples/` directory. - ## Documentation Full [API][] documentation is available in the comments of `sha3.h`. If @@ -191,7 +190,7 @@ Use `make test` to build and run the test suite. The test suite checks each component of this implementation for expected answers and is built with several sanitizers supported by both [GCC][] and [Clang][]. The source code for the test suite is embedded at the -bottom of `fips203ipd.c` behind a `TEST_FIPS203IPD` define. +bottom of `sha3.c` behind a `TEST_SHA3` define. ## References @@ -202,6 +201,27 @@ bottom of `fips203ipd.c` behind a `TEST_FIPS203IPD` define. * [TurboSHAKE (PDF)][turboshake] * [KangarooTwelve and TurboSHAKE][turboshake-ietf] +## License + +[MIT No Attribution (MIT-0)][MIT-0]: + +Copyright 2023 Paul Duncan + +Permission is hereby granted, free of charge, to any person obtaining a +copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + [C11]: https://en.wikipedia.org/wiki/C11_(C_standard_revision) "ISO/IEC 9899:2011" [SHA-3]: https://en.wikipedia.org/wiki/SHA-3 @@ -246,3 +266,5 @@ bottom of `fips203ipd.c` behind a `TEST_FIPS203IPD` define. "GNU Compiler Collection." [clang]: https://en.wikipedia.org/wiki/Clang "LLVM compiler front end." +[mit-0]: https://opensource.org/license/mit-0/ + "MIT No Attribution license" |