From cb5c41cde987fafa330fa679e25fee904ac6fe1f Mon Sep 17 00:00:00 2001
From: Martin Willi <martin@strongswan.org>
Date: Wed, 12 Jul 2006 14:08:52 +0000
Subject: [PATCH 1/1] updated some inline docs

---
 src/charon/daemon.h                      |  6 ++++--
 src/charon/sa/ike_sa.h                   | 34 +++++++++++++++++++++++++++++++-
 src/charon/sa/transactions/transaction.c |  2 ++
 src/charon/sa/transactions/transaction.h |  2 +-
 4 files changed, 40 insertions(+), 4 deletions(-)

diff --git a/src/charon/daemon.h b/src/charon/daemon.h
index 42feb03..4c2423a 100644
--- a/src/charon/daemon.h
+++ b/src/charon/daemon.h
@@ -159,9 +159,11 @@
  */
 
 /**
- * @defgroup states states
+ * @defgroup transactions transactions
  *
- * Varius states in which an IKE SA can be.
+ * Transactions represent a request/response
+ * message exchange to implement the IKEv2
+ * protocol exchange scenarios.
  *
  * @ingroup sa
  */
diff --git a/src/charon/sa/ike_sa.h b/src/charon/sa/ike_sa.h
index 955ec8f..40a2728 100644
--- a/src/charon/sa/ike_sa.h
+++ b/src/charon/sa/ike_sa.h
@@ -46,7 +46,39 @@ typedef enum ike_sa_state_t ike_sa_state_t;
 
 /**
  * @brief State of an IKE_SA.
- * 
+ *
+ * An IKE_SA passes various states in its lifetime. A newly created
+ * SA is in the state CREATED.
+ * @verbatim
+                 +----------------+
+                 ¦   SA_CREATED   ¦
+                 +----------------+
+                         ¦
+    on initiate()--->    ¦   <----- on IKE_SA_INIT received 
+                         ¦
+                 +----------------+
+                 ¦ SA_CONNECTING  ¦
+                 +----------------+
+                         ¦
+                         ¦   <----- on IKE_AUTH successfully completed
+                         ¦
+                 +----------------+
+                 ¦ SA_ESTABLISHED ¦
+                 +----------------+
+                         ¦
+    on delete()--->      ¦   <----- on IKE_SA delete request received
+                         ¦
+                 +----------------+
+                 ¦  SA_DELETING   ¦
+                 +----------------+
+                         ¦
+                         ¦   <----- after delete() acknowledged
+                         ¦
+                        \¦/
+                         X
+                        / \
+   @endverbatim
+ *
  * @ingroup sa
  */
 enum ike_sa_state_t {
diff --git a/src/charon/sa/transactions/transaction.c b/src/charon/sa/transactions/transaction.c
index e03b0cc..37baaf9 100644
--- a/src/charon/sa/transactions/transaction.c
+++ b/src/charon/sa/transactions/transaction.c
@@ -100,6 +100,8 @@ transaction_t *transaction_create(ike_sa_t *ike_sa, message_t *request)
 						/* we do not handle rekeying of CHILD_SAs in a special 
 						 * transaction, as the procedure is nearly equal 
 						 * to create a new CHILD_SA. */
+						transaction = (transaction_t*)create_child_sa_create(ike_sa, message_id);
+						break;
 					default:
 						break;
 				}
diff --git a/src/charon/sa/transactions/transaction.h b/src/charon/sa/transactions/transaction.h
index 9bb600f..bf910ea 100644
--- a/src/charon/sa/transactions/transaction.h
+++ b/src/charon/sa/transactions/transaction.h
@@ -47,7 +47,7 @@ typedef struct transaction_t transaction_t;
  *
  * The responder must not destroy the transaction, until the 
  * initiator initiates another transaction (or a number of transactions
- * > window size). This allows us to redo a transaction in case of a 
+ * > window size). This allows us to redo a transaction in case of a
  * message loss. The initiator can destroy the the transaction once
  * the conclude() function is called.
  * 
-- 
2.7.4