Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 449bb812 authored by Jason Cooper's avatar Jason Cooper Committed by Greg Kroah-Hartman
Browse files

staging: crypto: skein: import code from Skein3Fish.git 

This is a byte-for-byte copy of the skein implementation found at:

  https://github.com/wernerd/Skein3Fish.git



Specifically, from the master branch at commit:

  00e925444c2c Merge pull request #4 from csm/master

The next commit will do the minimum necessary to build this code as a
module.

I've generated the sha256 sums of the files by:

$ (cd drivers/staging/skein; find . -type f | sort | xargs sha256sum)
bcd73168e5805b1b157dbf08863e6a8c217a7b270b6be1a361540591b00624e3  ./CMakeLists.txt
e1adb97dd9e87bc7c05892ed7863a66d1d9fde6728a97a8b7b092709da664d29  ./include/brg_endian.h
240329b4ca4d829ac4d1490e96e83118e161e719e448c7e8dbf15735ab8a8e87  ./include/brg_types.h
0d8f16438f641fa365844a5991220eb04969f0a19c60dff08e10f521e74db5c3  ./include/skein.h
8f7362796e9e43f7619d51020d6faeedce786492b65bebd2ff6a833b621051cb  ./include/skeinApi.h
90510d8a9f686c3bfbf6cf7737237e3fa263c1ed5046b0f19727ba55b9bffeb9  ./include/skein_iv.h
42c6c8eff8f364ee2f0de3177d468dbceba9c6a73222fea473fe6d603213806a  ./include/skein_port.h
0154a4b8d54f5aa424b39a7ee668b31f2522b907bf3a8536fe46440b584531a1  ./include/threefishApi.h
ac0fc0f95a48a716d30cf02e5adad77af17725a938f939cf94f6dfba42badeca  ./skein.c
7af70b177bc63690f68eebceca2dbfef8a4473dcc847ae3525508c65c7d7bcc1  ./skeinApi.c
d7ef7330be8253f7f061de3c36880dbc83b0f5d90c8f2b72d3478766f54fbff0  ./skeinBlockNo3F.c
8bb3d7864afc9eab5569949fb2799cb6f14e583ba00641313cf877a5aea1c763  ./skein_block.c
438e6cb59a0090166e8f1e39418c0a2d0036737a32c5e2822c2ed8b803e2132f  ./threefish1024Block.c
e812ec6f2881300e90c803cfd9d044e954f1ca64faa2fc17a709f56a2f122ff8  ./threefish256Block.c
926f680057e128cdd1feba4a8544c177a74420137af480267b949ae79f3d02b8  ./threefish512Block.c
19357f5d47e7183bc8558a8d0949a3f5a80a931848917d26f36eebb7d205f003  ./threefishApi.c

Signed-off-by: default avatarJason Cooper <jason@lakedaemon.net>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 5565c59e

drivers/staging/skein/CMakeLists.txt

0 → 100755
+27 −0
Original line number Diff line number Diff line 
cmake_minimum_required (VERSION 2.6)



include_directories (${CMAKE_CURRENT_SOURCE_DIR}/include)



# set(skeinBlock_src skein_block.c)

set(skeinBlock_src skeinBlockNo3F.c)



set(skein_src 

    ${skeinBlock_src}

    skein.c

    skeinApi.c

    )



set(threefish_src

    threefishApi.c

    threefish256Block.c

    threefish512Block.c

    threefish1024Block.c

    )

set(s3f_src ${skein_src} ${threefish_src})



add_library(skein3fish SHARED ${s3f_src})

set_target_properties(skein3fish PROPERTIES VERSION ${VERSION} SOVERSION ${SOVERSION})

target_link_libraries(skein3fish ${LIBS})



install(TARGETS skein3fish DESTINATION ${LIBDIRNAME})

drivers/staging/skein/include/brg_endian.h

0 → 100644
+148 −0
Original line number Diff line number Diff line 
/*

 ---------------------------------------------------------------------------

 Copyright (c) 2003, Dr Brian Gladman, Worcester, UK.   All rights reserved.



 LICENSE TERMS



 The free distribution and use of this software in both source and binary

 form is allowed (with or without changes) provided that:



   1. distributions of this source code include the above copyright

      notice, this list of conditions and the following disclaimer;



   2. distributions in binary form include the above copyright

      notice, this list of conditions and the following disclaimer

      in the documentation and/or other associated materials;



   3. the copyright holder's name is not used to endorse products

      built using this software without specific written permission.



 ALTERNATIVELY, provided that this notice is retained in full, this product

 may be distributed under the terms of the GNU General Public License (GPL),

 in which case the provisions of the GPL apply INSTEAD OF those given above.



 DISCLAIMER



 This software is provided 'as is' with no explicit or implied warranties

 in respect of its properties, including, but not limited to, correctness

 and/or fitness for purpose.

 ---------------------------------------------------------------------------

 Issue 20/10/2006

*/



#ifndef BRG_ENDIAN_H

#define BRG_ENDIAN_H



#define IS_BIG_ENDIAN      4321 /* byte 0 is most significant (mc68k) */

#define IS_LITTLE_ENDIAN   1234 /* byte 0 is least significant (i386) */



/* Include files where endian defines and byteswap functions may reside */

#if defined( __FreeBSD__ ) || defined( __OpenBSD__ ) || defined( __NetBSD__ )

#  include <sys/endian.h>

#elif defined( BSD ) && ( BSD >= 199103 ) || defined( __APPLE__ ) || \

      defined( __CYGWIN32__ ) || defined( __DJGPP__ ) || defined( __osf__ )

#  include <machine/endian.h>

#elif defined( __linux__ ) || defined( __GNUC__ ) || defined( __GNU_LIBRARY__ )

#  if !defined( __MINGW32__ ) && !defined(AVR)

#    include <endian.h>

#    if !defined( __BEOS__ )

#      include <byteswap.h>

#    endif

#  endif

#endif



/* Now attempt to set the define for platform byte order using any  */

/* of the four forms SYMBOL, _SYMBOL, __SYMBOL & __SYMBOL__, which  */

/* seem to encompass most endian symbol definitions                 */



#if defined( BIG_ENDIAN ) && defined( LITTLE_ENDIAN )

#  if defined( BYTE_ORDER ) && BYTE_ORDER == BIG_ENDIAN

#    define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN

#  elif defined( BYTE_ORDER ) && BYTE_ORDER == LITTLE_ENDIAN

#    define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN

#  endif

#elif defined( BIG_ENDIAN )

#  define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN

#elif defined( LITTLE_ENDIAN )

#  define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN

#endif



#if defined( _BIG_ENDIAN ) && defined( _LITTLE_ENDIAN )

#  if defined( _BYTE_ORDER ) && _BYTE_ORDER == _BIG_ENDIAN

#    define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN

#  elif defined( _BYTE_ORDER ) && _BYTE_ORDER == _LITTLE_ENDIAN

#    define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN

#  endif

#elif defined( _BIG_ENDIAN )

#  define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN

#elif defined( _LITTLE_ENDIAN )

#  define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN

#endif



#if defined( __BIG_ENDIAN ) && defined( __LITTLE_ENDIAN )

#  if defined( __BYTE_ORDER ) && __BYTE_ORDER == __BIG_ENDIAN

#    define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN

#  elif defined( __BYTE_ORDER ) && __BYTE_ORDER == __LITTLE_ENDIAN

#    define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN

#  endif

#elif defined( __BIG_ENDIAN )

#  define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN

#elif defined( __LITTLE_ENDIAN )

#  define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN

#endif



#if defined( __BIG_ENDIAN__ ) && defined( __LITTLE_ENDIAN__ )

#  if defined( __BYTE_ORDER__ ) && __BYTE_ORDER__ == __BIG_ENDIAN__

#    define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN

#  elif defined( __BYTE_ORDER__ ) && __BYTE_ORDER__ == __LITTLE_ENDIAN__

#    define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN

#  endif

#elif defined( __BIG_ENDIAN__ )

#  define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN

#elif defined( __LITTLE_ENDIAN__ )

#  define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN

#endif



/*  if the platform byte order could not be determined, then try to */

/*  set this define using common machine defines                    */

#if !defined(PLATFORM_BYTE_ORDER)



#if   defined( __alpha__ ) || defined( __alpha ) || defined( i386 )       || \

      defined( __i386__ )  || defined( _M_I86 )  || defined( _M_IX86 )    || \

      defined( __OS2__ )   || defined( sun386 )  || defined( __TURBOC__ ) || \

      defined( vax )       || defined( vms )     || defined( VMS )        || \

      defined( __VMS )     || defined( _M_X64 )  || defined( AVR )

#  define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN



#elif defined( AMIGA )   || defined( applec )    || defined( __AS400__ )  || \

      defined( _CRAY )   || defined( __hppa )    || defined( __hp9000 )   || \

      defined( ibm370 )  || defined( mc68000 )   || defined( m68k )       || \

      defined( __MRC__ ) || defined( __MVS__ )   || defined( __MWERKS__ ) || \

      defined( sparc )   || defined( __sparc)    || defined( SYMANTEC_C ) || \

      defined( __VOS__ ) || defined( __TIGCC__ ) || defined( __TANDEM )   || \

      defined( THINK_C ) || defined( __VMCMS__ )

#  define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN



#elif 0     /* **** EDIT HERE IF NECESSARY **** */

#  define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN

#elif 0     /* **** EDIT HERE IF NECESSARY **** */

#  define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN

#else

#  error Please edit lines 126 or 128 in brg_endian.h to set the platform byte order

#endif

#endif



/* special handler for IA64, which may be either endianness (?)  */

/* here we assume little-endian, but this may need to be changed */

#if defined(__ia64) || defined(__ia64__) || defined(_M_IA64)

#  define PLATFORM_MUST_ALIGN (1)

#ifndef PLATFORM_BYTE_ORDER

#  define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN

#endif

#endif



#ifndef   PLATFORM_MUST_ALIGN

#  define PLATFORM_MUST_ALIGN (0)

#endif



#endif  /* ifndef BRG_ENDIAN_H */

drivers/staging/skein/include/brg_types.h

0 → 100644
+188 −0
Original line number Diff line number Diff line 
/*

 ---------------------------------------------------------------------------

 Copyright (c) 1998-2006, Brian Gladman, Worcester, UK. All rights reserved.



 LICENSE TERMS



 The free distribution and use of this software in both source and binary

 form is allowed (with or without changes) provided that:



   1. distributions of this source code include the above copyright

      notice, this list of conditions and the following disclaimer;



   2. distributions in binary form include the above copyright

      notice, this list of conditions and the following disclaimer

      in the documentation and/or other associated materials;



   3. the copyright holder's name is not used to endorse products

      built using this software without specific written permission.



 ALTERNATIVELY, provided that this notice is retained in full, this product

 may be distributed under the terms of the GNU General Public License (GPL),

 in which case the provisions of the GPL apply INSTEAD OF those given above.



 DISCLAIMER



 This software is provided 'as is' with no explicit or implied warranties

 in respect of its properties, including, but not limited to, correctness

 and/or fitness for purpose.

 ---------------------------------------------------------------------------

 Issue 09/09/2006



 The unsigned integer types defined here are of the form uint_<nn>t where

 <nn> is the length of the type; for example, the unsigned 32-bit type is

 'uint_32t'.  These are NOT the same as the 'C99 integer types' that are

 defined in the inttypes.h and stdint.h headers since attempts to use these

 types have shown that support for them is still highly variable.  However,

 since the latter are of the form uint<nn>_t, a regular expression search

 and replace (in VC++ search on 'uint_{:z}t' and replace with 'uint\1_t')

 can be used to convert the types used here to the C99 standard types.

*/



#ifndef BRG_TYPES_H

#define BRG_TYPES_H



#if defined(__cplusplus)

extern "C" {

#endif



#include <limits.h>



#ifndef BRG_UI8

#  define BRG_UI8

#  if UCHAR_MAX == 255u

     typedef unsigned char uint_8t;

#  else

#    error Please define uint_8t as an 8-bit unsigned integer type in brg_types.h

#  endif

#endif



#ifndef BRG_UI16

#  define BRG_UI16

#  if USHRT_MAX == 65535u

     typedef unsigned short uint_16t;

#  else

#    error Please define uint_16t as a 16-bit unsigned short type in brg_types.h

#  endif

#endif



#ifndef BRG_UI32

#  define BRG_UI32

#  if UINT_MAX == 4294967295u

#    define li_32(h) 0x##h##u

     typedef unsigned int uint_32t;

#  elif ULONG_MAX == 4294967295u

#    define li_32(h) 0x##h##ul

     typedef unsigned long uint_32t;

#  elif defined( _CRAY )

#    error This code needs 32-bit data types, which Cray machines do not provide

#  else

#    error Please define uint_32t as a 32-bit unsigned integer type in brg_types.h

#  endif

#endif



#ifndef BRG_UI64

#  if defined( __BORLANDC__ ) && !defined( __MSDOS__ )

#    define BRG_UI64

#    define li_64(h) 0x##h##ui64

     typedef unsigned __int64 uint_64t;

#  elif defined( _MSC_VER ) && ( _MSC_VER < 1300 )    /* 1300 == VC++ 7.0 */

#    define BRG_UI64

#    define li_64(h) 0x##h##ui64

     typedef unsigned __int64 uint_64t;

#  elif defined( __sun ) && defined(ULONG_MAX) && ULONG_MAX == 0xfffffffful

#    define BRG_UI64

#    define li_64(h) 0x##h##ull

     typedef unsigned long long uint_64t;

#  elif defined( UINT_MAX ) && UINT_MAX > 4294967295u

#    if UINT_MAX == 18446744073709551615u

#      define BRG_UI64

#      define li_64(h) 0x##h##u

       typedef unsigned int uint_64t;

#    endif

#  elif defined( ULONG_MAX ) && ULONG_MAX > 4294967295u

#    if ULONG_MAX == 18446744073709551615ul

#      define BRG_UI64

#      define li_64(h) 0x##h##ul

       typedef unsigned long uint_64t;

#    endif

#  elif defined( ULLONG_MAX ) && ULLONG_MAX > 4294967295u

#    if ULLONG_MAX == 18446744073709551615ull

#      define BRG_UI64

#      define li_64(h) 0x##h##ull

       typedef unsigned long long uint_64t;

#    endif

#  elif defined( ULONG_LONG_MAX ) && ULONG_LONG_MAX > 4294967295u

#    if ULONG_LONG_MAX == 18446744073709551615ull

#      define BRG_UI64

#      define li_64(h) 0x##h##ull

       typedef unsigned long long uint_64t;

#    endif

#  elif defined(__GNUC__)  /* DLW: avoid mingw problem with -ansi */

#      define BRG_UI64

#      define li_64(h) 0x##h##ull

       typedef unsigned long long uint_64t;

#  endif

#endif



#if defined( NEED_UINT_64T ) && !defined( BRG_UI64 )

#  error Please define uint_64t as an unsigned 64 bit type in brg_types.h

#endif



#ifndef RETURN_VALUES

#  define RETURN_VALUES

#  if defined( DLL_EXPORT )

#    if defined( _MSC_VER ) || defined ( __INTEL_COMPILER )

#      define VOID_RETURN    __declspec( dllexport ) void __stdcall

#      define INT_RETURN     __declspec( dllexport ) int  __stdcall

#    elif defined( __GNUC__ )

#      define VOID_RETURN    __declspec( __dllexport__ ) void

#      define INT_RETURN     __declspec( __dllexport__ ) int

#    else

#      error Use of the DLL is only available on the Microsoft, Intel and GCC compilers

#    endif

#  elif defined( DLL_IMPORT )

#    if defined( _MSC_VER ) || defined ( __INTEL_COMPILER )

#      define VOID_RETURN    __declspec( dllimport ) void __stdcall

#      define INT_RETURN     __declspec( dllimport ) int  __stdcall

#    elif defined( __GNUC__ )

#      define VOID_RETURN    __declspec( __dllimport__ ) void

#      define INT_RETURN     __declspec( __dllimport__ ) int

#    else

#      error Use of the DLL is only available on the Microsoft, Intel and GCC compilers

#    endif

#  elif defined( __WATCOMC__ )

#    define VOID_RETURN  void __cdecl

#    define INT_RETURN   int  __cdecl

#  else

#    define VOID_RETURN  void

#    define INT_RETURN   int

#  endif

#endif



/*  These defines are used to declare buffers in a way that allows

    faster operations on longer variables to be used.  In all these

    defines 'size' must be a power of 2 and >= 8



    dec_unit_type(size,x)       declares a variable 'x' of length 

                                'size' bits



    dec_bufr_type(size,bsize,x) declares a buffer 'x' of length 'bsize' 

                                bytes defined as an array of variables

                                each of 'size' bits (bsize must be a 

                                multiple of size / 8)



    ptr_cast(x,size)            casts a pointer to a pointer to a 

                                varaiable of length 'size' bits

*/



#define ui_type(size)               uint_##size##t

#define dec_unit_type(size,x)       typedef ui_type(size) x

#define dec_bufr_type(size,bsize,x) typedef ui_type(size) x[bsize / (size >> 3)]

#define ptr_cast(x,size)            ((ui_type(size)*)(x))



#if defined(__cplusplus)

}

#endif



#endif

drivers/staging/skein/include/skein.h

0 → 100644
+327 −0

File added.

Preview size limit exceeded, changes collapsed.

drivers/staging/skein/include/skeinApi.h

0 → 100755
+239 −0
Original line number Diff line number Diff line 
/*

Copyright (c) 2010 Werner Dittmann



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, subject to the following

conditions:



The above copyright notice and this permission notice shall be

included in all copies or substantial portions of the Software.



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.



*/



#ifndef SKEINAPI_H

#define SKEINAPI_H



/**

 * @file skeinApi.h

 * @brief A Skein API and its functions.

 * @{

 *

 * This API and the functions that implement this API simplify the usage

 * of Skein. The design and the way to use the functions follow the openSSL

 * design but at the same time take care of some Skein specific behaviour

 * and possibilities.

 * 

 * The functions enable applications to create a normal Skein hashes and

 * message authentication codes (MAC).

 * 

 * Using these functions is simple and straight forward:

 * 

 * @code

 * 

 * #include <skeinApi.h>

 * 

 * ...

 * SkeinCtx_t ctx;             // a Skein hash or MAC context

 * 

 * // prepare context, here for a Skein with a state size of 512 bits.

 * skeinCtxPrepare(&ctx, Skein512);

 * 

 * // Initialize the context to set the requested hash length in bits

 * // here request a output hash size of 31 bits (Skein supports variable

 * // output sizes even very strange sizes)

 * skeinInit(&ctx, 31);

 * 

 * // Now update Skein with any number of message bits. A function that

 * // takes a number of bytes is also available.

 * skeinUpdateBits(&ctx, message, msgLength);

 * 

 * // Now get the result of the Skein hash. The output buffer must be

 * // large enough to hold the request number of output bits. The application

 * // may now extract the bits.

 * skeinFinal(&ctx, result);

 * ...

 * @endcode

 * 

 * An application may use @c skeinReset to reset a Skein context and use

 * it for creation of another hash with the same Skein state size and output

 * bit length. In this case the API implementation restores some internal

 * internal state data and saves a full Skein initialization round.

 * 

 * To create a MAC the application just uses @c skeinMacInit instead of 

 * @c skeinInit. All other functions calls remain the same.

 * 

 */



#include <skein.h>

#include <stdint.h>



#ifdef __cplusplus

extern "C"

{

#endif



    /**

     * Which Skein size to use

     */

    typedef enum SkeinSize {

        Skein256 = 256,     /*!< Skein with 256 bit state */

        Skein512 = 512,     /*!< Skein with 512 bit state */

        Skein1024 = 1024    /*!< Skein with 1024 bit state */

    } SkeinSize_t;



    /**

     * Context for Skein.

     *

     * This structure was setup with some know-how of the internal

     * Skein structures, in particular ordering of header and size dependent

     * variables. If Skein implementation changes this, then adapt these

     * structures as well.

     */

    typedef struct SkeinCtx {

        u64b_t skeinSize;

        u64b_t  XSave[SKEIN_MAX_STATE_WORDS];   /* save area for state variables */

        union {

            Skein_Ctxt_Hdr_t h;

            Skein_256_Ctxt_t s256;

            Skein_512_Ctxt_t s512;

            Skein1024_Ctxt_t s1024;

        } m;

    } SkeinCtx_t;



    /**

     * Prepare a Skein context.

     * 

     * An application must call this function before it can use the Skein

     * context. The functions clears memory and initializes size dependent

     * variables.

     *

     * @param ctx

     *     Pointer to a Skein context.

     * @param size

     *     Which Skein size to use.

     * @return

     *     SKEIN_SUCESS of SKEIN_FAIL

     */

    int skeinCtxPrepare(SkeinCtx_t* ctx, SkeinSize_t size);



    /**

     * Initialize a Skein context.

     *

     * Initializes the context with this data and saves the resulting Skein 

     * state variables for further use.

     *

     * @param ctx

     *     Pointer to a Skein context.

     * @param hashBitLen

     *     Number of MAC hash bits to compute

     * @return

     *     SKEIN_SUCESS of SKEIN_FAIL

     * @see skeinReset

     */

    int skeinInit(SkeinCtx_t* ctx, size_t hashBitLen);



    /**

     * Resets a Skein context for further use.

     * 

     * Restores the saved chaining variables to reset the Skein context. 

     * Thus applications can reuse the same setup to  process several 

     * messages. This saves a complete Skein initialization cycle.

     * 

     * @param ctx

     *     Pointer to a pre-initialized Skein MAC context

     */

    void skeinReset(SkeinCtx_t* ctx);

    

    /**

     * Initializes a Skein context for MAC usage.

     * 

     * Initializes the context with this data and saves the resulting Skein 

     * state variables for further use.

     *

     * Applications call the normal Skein functions to update the MAC and

     * get the final result.

     *

     * @param ctx

     *     Pointer to an empty or preinitialized Skein MAC context

     * @param key

     *     Pointer to key bytes or NULL

     * @param keyLen

     *     Length of the key in bytes or zero

     * @param hashBitLen

     *     Number of MAC hash bits to compute

     * @return

     *     SKEIN_SUCESS of SKEIN_FAIL

     */

    int skeinMacInit(SkeinCtx_t* ctx, const uint8_t *key, size_t keyLen,

                     size_t hashBitLen);



    /**

     * Update Skein with the next part of the message.

     *

     * @param ctx

     *     Pointer to initialized Skein context

     * @param msg

     *     Pointer to the message.

     * @param msgByteCnt

     *     Length of the message in @b bytes

     * @return

     *     Success or error code.

     */

    int skeinUpdate(SkeinCtx_t *ctx, const uint8_t *msg,

                    size_t msgByteCnt);



    /**

     * Update the hash with a message bit string.

     *

     * Skein can handle data not only as bytes but also as bit strings of

     * arbitrary length (up to its maximum design size).

     *

     * @param ctx

     *     Pointer to initialized Skein context

     * @param msg

     *     Pointer to the message.

     * @param msgBitCnt

     *     Length of the message in @b bits.

     */

    int skeinUpdateBits(SkeinCtx_t *ctx, const uint8_t *msg,

                        size_t msgBitCnt);



    /**

     * Finalize Skein and return the hash.

     * 

     * Before an application can reuse a Skein setup the application must

     * reset the Skein context.

     *

     * @param ctx

     *     Pointer to initialized Skein context

     * @param hash

     *     Pointer to buffer that receives the hash. The buffer must be large

     *     enough to store @c hashBitLen bits.

     * @return

     *     Success or error code.

     * @see skeinReset

     */

    int skeinFinal(SkeinCtx_t* ctx, uint8_t* hash);



#ifdef __cplusplus

}

#endif



/**

 * @}

 */

#endif