signers implemented with HMAC now support NULL output parameters

[strongswan.git] / src / libstrongswan / crypto / signers / signer.h

diff --git a/src/libstrongswan/crypto/signers/signer.h b/src/libstrongswan/crypto/signers/signer.h
index 5851839..4218e41 100644 (file)
--- a/src/libstrongswan/crypto/signers/signer.h
+++ b/src/libstrongswan/crypto/signers/signer.h
@@ -24,18 +24,16 @@
 #ifndef SIGNER_H_
 #define SIGNER_H_
 
 #ifndef SIGNER_H_
 #define SIGNER_H_
 

-#include <types.h>
-#include <definitions.h>
-

 typedef enum integrity_algorithm_t integrity_algorithm_t;
 typedef enum integrity_algorithm_t integrity_algorithm_t;

+typedef struct signer_t signer_t;
+
+#include <library.h>

 
 /**
  * @brief Integrity algorithm, as in IKEv2 RFC 3.3.2.
 
 /**
  * @brief Integrity algorithm, as in IKEv2 RFC 3.3.2.

- * 
- * Currently only the following algorithms are implemented and therefore supported:
- * - AUTH_HMAC_MD5_96
- * - AUTH_HMAC_SHA1_96
- * 
+ *
+ * Algorithms not specified in IKEv2 are allocated in private use space.
+ *

  * @ingroup signers
  */
 enum integrity_algorithm_t {
  * @ingroup signers
  */
 enum integrity_algorithm_t {


@@ -46,31 +44,39 @@ enum integrity_algorithm_t {
        AUTH_HMAC_SHA1_96 = 2,
        AUTH_DES_MAC = 3,
        AUTH_KPDK_MD5 = 4,
        AUTH_HMAC_SHA1_96 = 2,
        AUTH_DES_MAC = 3,
        AUTH_KPDK_MD5 = 4,

-       AUTH_AES_XCBC_96 = 5
+       AUTH_AES_XCBC_96 = 5,
+       /** Implemented via hmac_signer_t */
+       AUTH_HMAC_SHA2_256_128 = 12,
+       /** Implemented via hmac_signer_t */
+       AUTH_HMAC_SHA2_384_192 = 13,
+       /** Implemented via hmac_signer_t */
+       AUTH_HMAC_SHA2_512_256 = 14,
+       /** Implemented via hmac_signer_t */
+       AUTH_HMAC_SHA1_128 = 1025,

 };
 
 };
 

-/** 
- * String mappings for integrity_algorithm_t.
+/**
+ * enum names for integrity_algorithm_t.

  */
  */

-extern mapping_t integrity_algorithm_m[];
-
-
-typedef struct signer_t signer_t;
+extern enum_name_t *integrity_algorithm_names;

 
 /**
  * @brief Generig interface for a symmetric signature algorithm.
 
 /**
  * @brief Generig interface for a symmetric signature algorithm.

- * 
+ *

  * @b Constructors:
  *  - signer_create()
  *  - hmac_signer_create()
  * @b Constructors:
  *  - signer_create()
  *  - hmac_signer_create()

- * 
+ *

  * @todo Implement more integrity algorithms
  * @todo Implement more integrity algorithms

- * 
+ *

  * @ingroup signers
  */
 struct signer_t {
        /**
         * @brief Generate a signature.
  * @ingroup signers
  */
 struct signer_t {
        /**
         * @brief Generate a signature.

+        *
+        * If buffer is NULL, data is processed and prepended to a next call until
+        * buffer is a valid pointer.

         * 
         * @param this                  calling object
         * @param data                  a chunk containing the data to sign
         * 
         * @param this                  calling object
         * @param data                  a chunk containing the data to sign


@@ -80,6 +86,9 @@ struct signer_t {
        
        /**
         * @brief Generate a signature and allocate space for it.
        
        /**
         * @brief Generate a signature and allocate space for it.

+        *
+        * If chunk is NULL, data is processed and prepended to a next call until
+        * chunk is a valid chunk pointer.

         * 
         * @param this                  calling object
         * @param data                  a chunk containing the data to sign
         * 
         * @param this                  calling object
         * @param data                  a chunk containing the data to sign