- key derivation for child_sa works
[strongswan.git] / Source / charon / sa / child_sa.h
index da8883c..8a74625 100644 (file)
@@ -21,8 +21,8 @@
  */
 
 
-#ifndef CHILD_SA_H_
-#define CHILD_SA_H_
+#ifndef _CHILD_SA_H_
+#define _CHILD_SA_H_
 
 #include <types.h>
 #include <transforms/prf_plus.h>
 typedef struct child_sa_t child_sa_t;
 
 /**
- * @brief 
+ * @brief Represents a CHILD_SA between to hosts.
+ * 
+ * 
+ * @b Constructors:
+ *  - child_sa_create
+ * 
  * @ingroup sa
  */
 struct child_sa_t {
        
+       /**
+        * @brief Returns the SPI value of this CHILD_SA.
+        * 
+        * AH and ESP are using 4 byte SPI values.
+        * 
+        * @param this          calling object
+        * @return                      4 Byte SPI value
+        */
        u_int32_t (*get_spi) (child_sa_t *this);
 
        /**
         * @brief Destroys a child_sa.
         *
-        * @param this                          child_sa_t object
+        * @param this          calling object
         */
        void (*destroy) (child_sa_t *this);
 };
 
 /**
- * @brief 
+ * @brief Constructor to create a new CHILD_SA.
  * 
+ * @param protocol_id  protocol id (AH or ESP) of CHILD_SA
+ * @param prf_plus             prf_plus_t object use to derive shared secrets
+ * @return                             child_sa_t object
  * @ingroup sa
  */
-child_sa_t * child_sa_create(protocol_id_t protocol_id, prf_plus_t *prf_plus);
+child_sa_t * child_sa_create(child_proposal_t *proposal, prf_plus_t *prf_plus);
 
-#endif /*CHILD_SA_H_*/
+#endif /*_CHILD_SA_H_*/