| /* |
| Copyright (C) 2013 Werner Dittmann |
| |
| This program is free software: you can redistribute it and/or modify |
| it under the terms of the GNU Lesser General Public License as published by |
| the Free Software Foundation, either version 3 of the License, or |
| (at your option) any later version. |
| |
| This program is distributed in the hope that it will be useful, |
| but WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| GNU General Public License for more details. |
| |
| You should have received a copy of the GNU General Public License |
| along with this program. If not, see <http://www.gnu.org/licenses/>. |
| */ |
| |
| /** |
| * Functions to compute Skein384 digest. |
| * |
| * @author: Werner Dittmann <Werner.Dittmann@t-online.de> |
| */ |
| |
| #ifndef _SKEIN384_H |
| #define _SKEIN384_H |
| |
| /** |
| * @file skein384.h |
| * @brief Functions that provide Skein384 support |
| * |
| * @ingroup GNU_ZRTP |
| * @{ |
| */ |
| |
| #include <stdint.h> |
| |
| #ifndef SKEIN384_DIGEST_LENGTH |
| #define SKEIN384_DIGEST_LENGTH 48 |
| #endif |
| #define SKEIN_SIZE Skein512 |
| |
| |
| /** |
| * Compute Skein384 digest. |
| * |
| * This functions takes one data chunk and computes its Skein384 digest. This |
| * function creates and deletes an own Skein384 context to perform the Skein384 |
| * operations. |
| * |
| * @param data |
| * Points to the data chunk. |
| * @param data_length |
| * Length of the data in bytes |
| * @param digest |
| * Points to a buffer that receives the computed digest. This |
| * buffer must have a size of at least 48 bytes (Skein384_DIGEST_LENGTH). |
| */ |
| void skein384(unsigned char *data, |
| unsigned int data_length, |
| unsigned char *digest); |
| |
| /** |
| * Compute Skein384 digest over several data cunks. |
| * |
| * This functions takes several data chunks and computes the Skein384 digest. |
| * This function creates and deletes an own Skein384 context to perform the |
| * Skein384 operations. |
| * |
| * @param data |
| * Points to an array of pointers that point to the data chunks. A NULL |
| * pointer in an array element terminates the data chunks. |
| * @param data_length |
| * Points to an array of integers that hold the length of each data chunk. |
| * @param digest |
| * Points to a buffer that receives the computed digest. This |
| * buffer must have a size of at least 48 bytes (Skein384_DIGEST_LENGTH). |
| */ |
| void skein384(unsigned char *data[], |
| unsigned int data_length[], |
| unsigned char *digest); |
| /** |
| * Create and initialize a Skein384 context. |
| * |
| * An application uses this context to hash several data into one Skein384 |
| * digest. See also skein384Ctx(...) and closeSha384Context(...). |
| * |
| * @return Returns a pointer to the initialized Skein384 context |
| */ |
| void* createSkein384Context(); |
| |
| /** |
| * Compute a digest and close the SHa384 digest. |
| * |
| * An application uses this function to compute the Skein384 digest and to |
| * close the Skein384 context. |
| * |
| * @param ctx |
| * Points to the Skein384 context. |
| * @param digest |
| * If this pointer is not NULL then it must point to a byte array that |
| * is big enough to hold the Skein384 digest (384 bit = 48 Bytes). If this |
| * pointer is NULL then the functions does not compute the digest but |
| * closes the context only. The context cannot be used anymore. |
| */ |
| void closeSkein384Context(void* ctx, |
| unsigned char* digest); |
| |
| /** |
| * Update the Skein384 context with data. |
| * |
| * This functions updates the Skein384 context with some data. |
| * See also CloseSha384Context(...) how to get the digest. |
| * |
| * @param ctx |
| * Points to the Skein384 context. |
| * @param data |
| * Points to the data to update the context. |
| * @param dataLength |
| * The length of the data in bytes. |
| */ |
| void skein384Ctx(void* ctx, unsigned char* data, |
| unsigned int dataLength); |
| |
| /** |
| * Update the Skein384 context with several data chunks. |
| * |
| * This functions updates the Skein384 context with some data. |
| * See also CloseSha384Context(...) how to get the digest. |
| * |
| * @param ctx |
| * Points to the Skein384 context. |
| * @param dataChunks |
| * Points to an array of pointers that point to the data chunks. A NULL |
| * pointer in an array element terminates the data chunks. |
| * @param dataChunkLength |
| * Points to an array of integers that hold the length of each data chunk. |
| * |
| */ |
| void skein384Ctx(void* ctx, unsigned char* dataChunks[], |
| unsigned int dataChunkLength[]); |
| |
| /** |
| * @} |
| */ |
| #endif |
| |