# HG changeset patch
# User asl
# Date 1069505844 0
# Node ID 219ebc4f4562a0f2a9f977d1d86079c8c0c95901
# Parent  44c872c79d5f5ea18326c96ce91550ea7a08fa67
        * cdl/net.cdl: Added control for IPSEC
        * doc/ipsec.sgml: General documentation of ipsec.

diff --git a/packages/net/common/current/ChangeLog b/packages/net/common/current/ChangeLog
--- a/packages/net/common/current/ChangeLog
+++ b/packages/net/common/current/ChangeLog
@@ -1,3 +1,8 @@
+2003-11-22  Andrew Lunn  <andrew.lunn@ascom.ch>
+
+	* cdl/net.cdl: Added control for IPSEC 
+	* doc/ipsec.sgml: General documentation of ipsec.
+
 2003-10-30  Gary Thomas  <gary@mlbassoc.com>
 
 	* tests/ping_test.c: Enable profiling if configured in - example use only.
diff --git a/packages/net/common/current/cdl/net.cdl b/packages/net/common/current/cdl/net.cdl
--- a/packages/net/common/current/cdl/net.cdl
+++ b/packages/net/common/current/cdl/net.cdl
@@ -71,6 +71,9 @@ cdl_package CYGPKG_NET {
     cdl_interface CYGPKG_NET_STACK_INET6 {
         display   "Network stack support for IPv6"
     }
+    cdl_interface CYGPKG_NET_STACK_IPSEC {
+        display   "Network stack support for IPSEC"
+    }
 
     cdl_component CYGPKG_NET_INET {
         display       "INET support"
@@ -106,6 +109,16 @@ cdl_package CYGPKG_NET {
             define INET6
         }
 
+        cdl_option CYGPKG_NET_IPSEC {
+            display       "IPSEC support"
+            active_if     CYGPKG_NET_STACK_IPSEC
+            flavor        bool
+            default_value 1
+            description   "
+                This option enables support for IPSEC"
+            define IPSEC
+            define IPSEC_ESP
+        }
         cdl_option CYGSEM_NET_ROUTING {
             display "Multicast routing support"
             flavor  bool
@@ -457,7 +470,7 @@ cdl_package CYGPKG_NET {
                     tests/tcp_lo_test \
                     tests/udp_lo_test \
                     tests/multi_lo_select \
-                    tests/tcp_lo_select"
+                    tests/tcp_lo_select
             }
             description   "
              This option specifies the set of tests
diff --git a/packages/net/common/current/doc/ipsec.sgml b/packages/net/common/current/doc/ipsec.sgml
new file mode 100644
--- /dev/null
+++ b/packages/net/common/current/doc/ipsec.sgml
@@ -0,0 +1,87 @@
+<!-- {{{ Banner                         -->
+
+<!-- =============================================================== -->
+<!--                                                                 -->
+<!--     ipsec.sgml                                                  -->
+<!--                                                                 -->
+<!-- =============================================================== -->
+<!-- ####COPYRIGHTBEGIN####                                          -->
+<!--                                                                 -->
+<!-- =============================================================== -->
+<!-- Copyright (c) 2003 Andrew Lunn                                  -->
+<!-- This material may be distributed only subject to the terms      -->
+<!-- and conditions set forth in the Open Publication License, v1.0  -->
+<!-- or later (the latest version is presently available at          -->
+<!-- http://www.opencontent.org/openpub/)                            -->
+<!-- Distribution of the work or derivative of the work in any       -->
+<!-- standard (paper) book form is prohibited unless prior           -->
+<!-- permission obtained from the copyright holder                   -->
+<!-- =============================================================== -->
+<!--                                                                 -->      
+<!-- ####COPYRIGHTEND####                                            -->
+<!-- =============================================================== -->
+<!-- #####DESCRIPTIONBEGIN####                                       -->
+<!--                                                                 -->
+<!-- ####DESCRIPTIONEND####                                          -->
+<!-- =============================================================== -->
+
+<!-- }}} -->
+
+<PART ID="net-ipsec-common">
+  <TITLE>IPSEC for eCos</TITLE>
+  <PARTINTRO>
+    <PARA>
+    The FreeBSD network stack which is part of
+    <productname>eCos</productname> can be configured to use IPSEC to
+    provide more secure communications between Internet hosts. IPSEC
+    can be used with both IPv4 and IPv6.
+    </PARA>
+  </PARTINTRO>
+  <CHAPTER id="net-ipsec-common-installation">
+    <TITLE>Installation and Configuration</TITLE>
+    <PARA>
+    Due to the restrictions imposed by various countries on the
+    exportation and importation of cryptographic software, it has been
+    decided to distribute the crypto parts of FreeBSD IPSEC separately
+    from the rest of eCos. Before IPSEC can be enabled the eCos
+    package bsd_crypto must be installed. This package can be found on
+    the eCosCentric server at
+    <ulink url="ftp://ftp.ecoscentric.com:/pub/contrib">
+    ftp.ecoscentric.com:/pub/contrib</ulink>. Once the package has been
+    downloaded it must be installed using the
+    <LITERAL>ecosadmin.tcl</LITERAL> script.
+    </PARA>
+
+    <PARA>
+    When the bsd_crypto package has been installed, the building of
+    IPSEC will automatically be enabled when the FreeBSD stack is
+    used. It can be disabled using the configuration option
+    <LITERAL>CYGPKG_NET_IPSEC</LITERAL>. There are no other
+    configuration options for IPSEC as a whole.
+    </PARA>
+
+    <PARA>
+    In order to use IPSEC, connections must be configured. This can be
+    performed using <FUNCTION>setsockopt()</FUNCTION> calls. A more
+    convenient way is the use the <LITERAL>libipsec</LITERAL> library
+    from the <PRODUCTNAME>KAME</PRODUCTNAME> distribution. eCos
+    contains a snapshot of this library, which is documented else
+    where. The aim is to also port the
+    <PRODUCTNAME>racoon</PRODUCTNAME> daemon to eCos in the near
+    future.
+    </PARA>
+
+    <PARA>
+    It should be noted that the FreeBSD stack in eCos is quite
+    old. IPSEC and IPv6 have continued to develop. It is quite
+    possible there could be interoperabilty problems when using the
+    IPSEC implementation in eCos with more modern implementations.
+    </PARA>
+
+    <PARA>
+    It should also be noted that IPSEC, libipsec etc are currently
+    work in progress items.
+    </PARA>
+  </CHAPTER>
+  &net-ipsec-libipsec-libipsec-manpages-sgml;
+</PART>