Added strongswan.conf(5) stub.
authorTobias Brunner <tobias@strongswan.org>
Thu, 9 Sep 2010 12:03:22 +0000 (14:03 +0200)
committerTobias Brunner <tobias@strongswan.org>
Fri, 10 Sep 2010 10:01:19 +0000 (12:01 +0200)
man/.gitignore
man/Makefile.am
man/strongswan.conf.5.in [new file with mode: 0644]

index cf55e34..2767ce8 100644 (file)
@@ -1,2 +1,3 @@
 ipsec.conf.5
 ipsec.secrets.5
+strongswan.conf.5
index f57f124..a74a901 100644 (file)
@@ -1,6 +1,6 @@
-dist_man_MANS = ipsec.conf.5 ipsec.secrets.5
-EXTRA_DIST = ipsec.conf.5.in ipsec.secrets.5.in
-CLEANFILES = ipsec.conf.5 ipsec.secrets.5
+dist_man_MANS = ipsec.conf.5 ipsec.secrets.5 strongswan.conf.5
+EXTRA_DIST = ipsec.conf.5.in ipsec.secrets.5.in strongswan.conf.5.in
+CLEANFILES = ipsec.conf.5 ipsec.secrets.5 strongswan.conf.5
 
 SUFFIXES = .in
 
diff --git a/man/strongswan.conf.5.in b/man/strongswan.conf.5.in
new file mode 100644 (file)
index 0000000..5b85046
--- /dev/null
@@ -0,0 +1,26 @@
+.TH STRONGSWAN.CONF 5 "2010-09-09" "@IPSEC_VERSION@" "strongSwan"
+.SH NAME
+strongswan.conf \- strongSwan configuration file
+.SH DESCRIPTION
+While the
+.IR ipsec.conf (5)
+configuration file is well suited to define IPsec related configuration
+parameters, it is not useful for other strongSwan applications to read options
+from this file.
+The file is hard to parse and only
+.I ipsec starter
+is capable of doing so. As the number of components of the strongSwan project
+is continually growing, a more flexible configuration file was needed, one that 
+is easy to extend and can be used by all components. With strongSwan 4.2.1
+.IR strongswan.conf (5)
+was introduced which meets these requirements.
+
+.SH FILES
+.nf
+/etc/strongswan.conf
+
+.SH SEE ALSO
+ipsec.conf (5), ipsec.secrets (5)
+.SH HISTORY
+Written for the strongSwan project <http://www.strongswan.org> by
+Tobias Brunner, Andreas Steffen and Martin Willi.