1 #ifndef _SKEIN_DEBUG_H_
2 #define _SKEIN_DEBUG_H_
3 /***********************************************************************
5 ** Interface definitions for Skein hashing debug output.
7 ** Source code author: Doug Whiting, 2008.
9 ** This algorithm and source code is released to the public domain.
11 ************************************************************************/
14 /* callout functions used inside Skein code */
15 void Skein_Show_Block(uint_t bits,const Skein_Ctxt_Hdr_t *h,const u64b_t *X,const u08b_t *blkPtr,
16 const u64b_t *wPtr,const u64b_t *ksPtr,const u64b_t *tsPtr);
17 void Skein_Show_Round(uint_t bits,const Skein_Ctxt_Hdr_t *h,size_t r,const u64b_t *X);
18 void Skein_Show_R_Ptr(uint_t bits,const Skein_Ctxt_Hdr_t *h,size_t r,const u64b_t *X_ptr[]);
19 void Skein_Show_Final(uint_t bits,const Skein_Ctxt_Hdr_t *h,size_t cnt,const u08b_t *outPtr);
20 void Skein_Show_Key (uint_t bits,const Skein_Ctxt_Hdr_t *h,const u08b_t *key,size_t keyBytes);
22 extern uint_t skein_DebugFlag; /* flags to control debug output (0 --> none) */
24 #define SKEIN_RND_SPECIAL (1000u)
25 #define SKEIN_RND_KEY_INITIAL (SKEIN_RND_SPECIAL+0u)
26 #define SKEIN_RND_KEY_INJECT (SKEIN_RND_SPECIAL+1u)
27 #define SKEIN_RND_FEED_FWD (SKEIN_RND_SPECIAL+2u)
29 /* flag bits: skein_DebugFlag */
30 #define SKEIN_DEBUG_KEY (1u << 1) /* show MAC key */
31 #define SKEIN_DEBUG_CONFIG (1u << 2) /* show config block processing */
32 #define SKEIN_DEBUG_STATE (1u << 3) /* show input state during Show_Block() */
33 #define SKEIN_DEBUG_TWEAK (1u << 4) /* show input state during Show_Block() */
34 #define SKEIN_DEBUG_KEYSCHED (1u << 5) /* show expanded key schedule */
35 #define SKEIN_DEBUG_INPUT_64 (1u << 6) /* show input block as 64-bit words */
36 #define SKEIN_DEBUG_INPUT_08 (1u << 7) /* show input block as 8-bit bytes */
37 #define SKEIN_DEBUG_INJECT (1u << 8) /* show state after key injection & feedforward points */
38 #define SKEIN_DEBUG_ROUNDS (1u << 9) /* show state after all rounds */
39 #define SKEIN_DEBUG_FINAL (1u <<10) /* show final output of Skein */
40 #define SKEIN_DEBUG_HDR (1u <<11) /* show block header */
41 #define SKEIN_DEBUG_THREEFISH (1u <<12) /* use Threefish name instead of Skein */
42 #define SKEIN_DEBUG_PERMUTE (1u <<13) /* use word permutations */
43 #define SKEIN_DEBUG_ALL ((~0u) & ~(SKEIN_DEBUG_THREEFISH | SKEIN_DEBUG_PERMUTE))
44 #define THREEFISH_DEBUG_ALL (SKEIN_DEBUG_ALL | SKEIN_DEBUG_THREEFISH)
46 #endif /* SKEIN_DEBUG */
48 #endif /* _SKEIN_DEBUG_H_ */