EMbedded Secure HAshing library. https://docs.shimmering-clarity.net/emsha/
Go to file
Kyle Isom ad07da5a39 Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
.idea Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
.trunk Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
cmake Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
debian Miscellaneous packaging fixes. 2016-01-29 16:38:18 -08:00
docs Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
emsha Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
scripts Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
.clang-format Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
.clang-tidy Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
.gitignore Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
.travis.yml pkg-config and add gitignore. 2016-01-28 09:42:03 -08:00
CHANGELOG Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
CMakeLists.txt Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
LICENSE Initial import. 2015-12-17 01:54:10 -08:00
README.rst Fix comparison test in hash_equal, release 1.0.1. 2015-12-22 21:41:33 -08:00
TODO.rst Add Debian package, finish TODOs. 2016-01-27 21:41:02 -08:00
emsha.cc Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
emsha.pc.in Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
hmac.cc Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
sha256.cc Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
test_emsha.cc Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
test_hmac.cc Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
test_mem.cc Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
test_sha256.cc Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
test_utils.cc Major refactoring effort underway. 2023-10-17 23:43:18 -07:00
test_utils.h Major refactoring effort underway. 2023-10-17 23:43:18 -07:00

README.rst

libemsha
========

.. image:: https://travis-ci.org/kisom/libemsha.svg?branch=master
    :target: https://travis-ci.org/kisom/libemsha

.. image:: https://scan.coverity.com/projects/7318/badge.svg
    :target: https://scan.coverity.com/projects/libemsha-52f2a5fd-e759-43c2-9073-cf6c2ed9abdb

This library is an MIT-licensed HMAC-SHA-256 C++11 library designed
for embedded systems. It is built following the JPL `Power of Ten
<http://spinroot.com/gerard/pdf/P10.pdf>`_ rules. It was written in
response to a need for a standalone HMAC-SHA-256 package that could run
on several platforms.


-------------------------------
Getting and Building the Source
-------------------------------

The source code is available via `Github
<https://github.com/kisom/libemsha/>`_; each version should be git tagged. ::

    git clone https://github.com/kisom/libemsha
    git clone git@github.com:kisom/libemsha

The current release is `1.0.1 <https://github.com/kisom/libemsha/releases/tag/v1.0.1>`_.

The project is built using Autotools and ``make``.

When building from a git checkout, the `autobuild` script will bootstrap
the project from the autotools sources (e.g. via ``autoreconf -i``),
run ``configure`` (by default to use clang), and attempt to build the library
and run the unit tests.

Once the autotools infrastructure has been bootstrapped, the following
should work: ::

    ./configure && make && make check && make install

There are three flags to ``configure`` that might be useful:

+ ``--disable-hexstring`` disables the provided ``hexstring`` function;
  while this might be useful in many cases, it also adds extra size to
  the code.

+ ``--disable-hexlut`` disables the larger lookup table used by
  ``hexstring``, which can save around a kilobyte of program space. If
  the ``hexstring`` function is disabled, this option has no effect.

+ ``--disable-selftest`` disables the internal self-tests, which can
  reclaim some additional program space.


-------------
Documentation
-------------

Documentation is currently done with `Sphinx <http://sphinx-doc.org/>`_.
See ``doc/``.


See also
--------

* `FIPS 180-4, the Secure Hash Standard <http://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.180-4.pdf>`_
* `FIPS 198-1, The Keyed-Hash Message Authentication Code (HMAC) <http://csrc.nist.gov/publications/fips/fips198-1/FIPS-198-1_final.pdf>`_
* `RFC 2014, HMAC: Keyed-Hashing for Message Authentication <https://tools.ietf.org/html/rfc2104>`_
* `RFC 6234, US Secure Hash Algorithms (SHA and SHA-based HMAC and HKDF) <https://tools.ietf.org/html/rfc6234>`_\ [#f1]_
* The behaviour of this package was cross-checked using the Go 1.5.1
  linux/amd64 standard library's `crypto/sha256 <https://golang.org/src/crypto/sha256/>`_
  package.

.. rubric:: Footnotes

.. [#f1] This library came about after extracting the relevant C code
         from RFC 6234, and needing a C++ version. It draws heavy
         inspiration from that code base.