renaming to AVR-Crypto-Lib

[avr-crypto-lib.git] / skipjack.h

diff --git a/skipjack.h b/skipjack.h
index 0db740d6791cf83e2dbce6e93971a1e8c8cb9f33..4b4372aa6932a73e74add8efc10ae2792f6fc361 100644 (file)
--- a/skipjack.h
+++ b/skipjack.h
@@ -1,6 +1,6 @@
 /* skipjack.h */
 /*
-    This file is part of the Crypto-avr-lib/microcrypt-lib.
+    This file is part of the This file is part of the AVR-Crypto-Lib.
     Copyright (C) 2008  Daniel Otte (daniel.otte@rub.de)
 
     This program is free software: you can redistribute it and/or modify
@@ -19,18 +19,37 @@
 #ifndef SKIPJACK_H_
 #define SKIPJACK_H_
 
+/** 
+ * \file      skipjack.h
+ * \author    Daniel Otte
+ * \date      2006-11-01
+ * \license   GPLv3 or later
+ * \brief     Implementation of the serpent sbox function.
+ * 
+ */
+
+
 #include <stdint.h>
 
-/*****************************************************************************/
-/**
- * block is 64 bits (=8 bytes) in size, key is 80 bits (=10 bytes) in size.
+/** \fn void skipjack_enc(void* block, void* key)
+ * \brief skipjack encryption function
  * 
+ * This function encrypts a block of plaintext with the Skipjac encryption
+ * algorithm. The block is 64 bit (8 byte) long, the key is 80 bit (10 byte)
+ * long.
+ * \param block pointer to the 64 bit (8 byte) block to encrypt
+ * \param key   pointer to the 80 bit (10 byte) key 
  */
 void skipjack_enc(void* block, void* key);
-/*****************************************************************************/
-/**
- * block is 64 bits (=8 bytes) in size, key is 80 bits (=10 bytes) in size.
+
+/** \fn void skipjack_dec(void* block, void* key)
+ * \brief skipjack decryption function
  * 
+ * This function decrypts a block of ciphertext encrypted with the Skipjac
+ * encryption algorithm. 
+ * The block is 64 bit (8 byte) long, the key is 80 bit (10 byte) long.
+ * \param block pointer to the 64 bit (8 byte) block to decrypt
+ * \param key   pointer to the 80 bit (10 byte) key 
  */
 void skipjack_dec(void* block, void* key);