From b092ffbcbe2c9398494f7dc9db6f0796971633e0 Mon Sep 17 00:00:00 2001 From: Rob Austein Date: Sun, 13 Sep 2020 23:04:30 +0000 Subject: Import Cryptech wiki dump --- raw-wiki-dump/GitRepositories%2Fsw%2Fcryptlib | 96 +++++++++++++++++++++++++++ 1 file changed, 96 insertions(+) create mode 100644 raw-wiki-dump/GitRepositories%2Fsw%2Fcryptlib (limited to 'raw-wiki-dump/GitRepositories%2Fsw%2Fcryptlib') diff --git a/raw-wiki-dump/GitRepositories%2Fsw%2Fcryptlib b/raw-wiki-dump/GitRepositories%2Fsw%2Fcryptlib new file mode 100644 index 0000000..7038476 --- /dev/null +++ b/raw-wiki-dump/GitRepositories%2Fsw%2Fcryptlib @@ -0,0 +1,96 @@ +{{{ +#!htmlcomment + +This page is maintained automatically by a script. Don't modify this page by hand, +your changes will just be overwritten the next time the script runs. Talk to your +Friendly Neighborhood Repository Maintainer if you need to change something here. + +}}} + +{{{ +#!html +

cryptlib

+ +

Introduction

+ +

This is a port of Peter Gutmann's +cryptlib package +to the Cryptech project's environment. This is a work in progress, +and still at a very early stage as of this writing.

+ +

The main addition to the stock cryptlib environment is a set of +Hardware Adaption Layer (HAL) implementations that use the Cryptech +FPGA cores.

+ +

While we expect to be making more significant use of cryptlib in the +future, the main purposes of this code at the moment are +proof-of-concept and connecting the Cryptech cores to a more complete +cryptographic programming environment for testing and development +purposes.

+ +

Current status

+ +

At present, the Cryptech HAL code runs only on the Novena PVT1. There +are three variants of the HAL, all using the I2C bus, but speaking +different protocols:

+ + + +

All of these HAL implementations are in the src/ directory. See the +GNUmakefile for details on how to select the variant you want.

+ +

At present, the only relevant Cryptech cores are the TRNG and several +digest algorithms. The current HAL uses the SHA-1, SHA-256, and +SHA-512 cores to implement the SHA-1, SHA-256, SHA-384, and SHA-512 +digests. SHA-512/224 and SHA-512/256 are not supported.

+ +

In principal there is no reason why one could not write a HAL which +spoke to a Terasic board, perhaps via the coretest protocol over a +UART, but to date this has not been done.

+ +

Code import status

+ +

Cryptlib itself is present in the repository in the form of a verbatim +copy of the Cryptlib 3.4.2 distribution zipfile, which the top-level +makefile unpacks while building. This has proven simpler to work with +than importing the entire Cryptlib distribution into a vendor branch.

+ +

Packaging Cryptlib this way has two implications:

+ + + +

Test code

+ +

The tests/ directory contains a few test scripts, written in Python, +using the standard Cryptlib Python bindings. The Cryptlib Python +environment is a fairly literaly translation of the Cryptlib C +environment, so portions of it will be a bit, um, surprising to Python +programmers, but the basic functionality works. Note that it's normal +for test scripts to fail when the functionality they're testing isn't +loaded on the FPGA.

+ +

Copyright status

+ +

Cryptlib itself is copyright by Peter Gutmann. See the Cryptlib web +site for licensing details.

+ +

Code written for the Cryptech project is under the usual Cryptech +BSD-style license.

+}}} + +[[RepositoryIndex(format=table,glob=sw/cryptlib)]] + +|| Clone `https://git.cryptech.is/sw/cryptlib.git` || -- cgit v1.2.3