Merge branch 'man-sysconfdir'

Closes strongswan/strongswan#1511
This commit is contained in:
Tobias Brunner
2023-01-16 11:41:17 +01:00
8 changed files with 36 additions and 33 deletions
+2 -2
View File
@@ -38,8 +38,8 @@ charon.cert_cache = yes
charon.cache_crls = no charon.cache_crls = no
Whether Certificate Revocation Lists (CRLs) fetched via HTTP or LDAP should Whether Certificate Revocation Lists (CRLs) fetched via HTTP or LDAP should
be saved under a unique file name derived from the public key of the be saved under a unique file name derived from the public key of the
Certification Authority (CA) to **/etc/ipsec.d/crls** (stroke) or Certification Authority (CA) to **${sysconfdir}/ipsec.d/crls** (stroke) or
**/etc/swanctl/x509crl** (vici), respectively. **${sysconfdir}/swanctl/x509crl** (vici), respectively.
charon.check_current_path = no charon.check_current_path = no
Whether to use DPD to check if the current path still works after any Whether to use DPD to check if the current path still works after any
+1 -1
View File
@@ -1,7 +1,7 @@
charon.plugins.unbound.resolv_conf = /etc/resolv.conf charon.plugins.unbound.resolv_conf = /etc/resolv.conf
File to read DNS resolver configuration from. File to read DNS resolver configuration from.
charon.plugins.unbound.trust_anchors = /etc/ipsec.d/dnssec.keys charon.plugins.unbound.trust_anchors = ${sysconfdir}/ipsec.d/dnssec.keys
File to read DNSSEC trust anchors from (usually root zone KSK). File to read DNSSEC trust anchors from (usually root zone KSK).
File to read DNSSEC trust anchors from (usually root zone KSK). The format File to read DNSSEC trust anchors from (usually root zone KSK). The format
+6 -4
View File
@@ -458,6 +458,7 @@ The variables used above are configured as follows:
.na .na
${piddir} @piddir@ ${piddir} @piddir@
${prefix} @prefix@ ${prefix} @prefix@
${sysconfdir} @sysconfdir@
${random_device} @random_device@ ${random_device} @random_device@
${urandom_device} @urandom_device@ ${urandom_device} @urandom_device@
.ad .ad
@@ -467,18 +468,19 @@ ${urandom_device} @urandom_device@
. .
.nf .nf
.na .na
/etc/strongswan.conf configuration file @sysconfdir@/strongswan.conf configuration file
/etc/strongswan.d/ directory containing included config snippets @sysconfdir@/strongswan.d/ directory containing included config snippets
/etc/strongswan.d/charon/ plugin specific config snippets @sysconfdir@/strongswan.d/charon/ plugin specific config snippets
.ad .ad
.fi .fi
. .
.SH SEE ALSO .SH SEE ALSO
\fBswanctl.conf\fR(5), \fBswanctl\fR(8),
\fBipsec.conf\fR(5), \fBipsec.secrets\fR(5), \fBipsec\fR(8), \fBcharon-cmd\fR(8) \fBipsec.conf\fR(5), \fBipsec.secrets\fR(5), \fBipsec\fR(8), \fBcharon-cmd\fR(8)
.SH HISTORY .SH HISTORY
Written for the Written for the
.UR http://www.strongswan.org .UR https://www.strongswan.org
strongSwan project strongSwan project
.UE .UE
by Tobias Brunner, Andreas Steffen and Martin Willi. by Tobias Brunner, Andreas Steffen and Martin Willi.
+11 -11
View File
@@ -690,7 +690,7 @@ but for the second authentication round (IKEv2 only).
.BR leftcert " = <path>" .BR leftcert " = <path>"
the path to the left participant's X.509 certificate. The file can be encoded the path to the left participant's X.509 certificate. The file can be encoded
either in PEM or DER format. OpenPGP certificates are supported as well. either in PEM or DER format. OpenPGP certificates are supported as well.
Both absolute paths or paths relative to \fI/etc/ipsec.d/certs\fP Both absolute paths or paths relative to \fI@sysconfdir@/ipsec.d/certs\fP
are accepted. By default are accepted. By default
.B leftcert .B leftcert
sets sets
@@ -871,7 +871,7 @@ prefix in front of 0x or 0s, the public key is expected to be in either
the RFC 3110 (not the full RR, only RSA key part) or RFC 4253 public key format, the RFC 3110 (not the full RR, only RSA key part) or RFC 4253 public key format,
respectively. respectively.
Also accepted is the path to a file containing the public key in PEM, DER or SSH Also accepted is the path to a file containing the public key in PEM, DER or SSH
encoding. Both absolute paths or paths relative to \fI/etc/ipsec.d/certs\fP encoding. Both absolute paths or paths relative to \fI@sysconfdir@/ipsec.d/certs\fP
are accepted. are accepted.
.TP .TP
.BR leftsendcert " = never | no | " ifasked " | always | yes" .BR leftsendcert " = never | no | " ifasked " | always | yes"
@@ -1219,7 +1219,7 @@ of this connection will be used as peer ID.
.SH "CA SECTIONS" .SH "CA SECTIONS"
These are optional sections that can be used to assign special These are optional sections that can be used to assign special
parameters to a Certification Authority (CA). Because the daemons parameters to a Certification Authority (CA). Because the daemons
automatically import CA certificates from \fI/etc/ipsec.d/cacerts\fP, automatically import CA certificates from \fI@sysconfdir@/ipsec.d/cacerts\fP,
there is no need to explicitly add them with a CA section, unless you there is no need to explicitly add them with a CA section, unless you
want to assign special parameters (like a CRL) to a CA. want to assign special parameters (like a CRL) to a CA.
.TP .TP
@@ -1235,7 +1235,7 @@ currently can have either the value
.TP .TP
.BR cacert " = <path>" .BR cacert " = <path>"
defines a path to the CA certificate either relative to defines a path to the CA certificate either relative to
\fI/etc/ipsec.d/cacerts\fP or as an absolute path. \fI@sysconfdir@/ipsec.d/cacerts\fP or as an absolute path.
.br .br
A value in the form A value in the form
.B %smartcard[<slot nr>[@<module>]]:<keyid> .B %smartcard[<slot nr>[@<module>]]:<keyid>
@@ -1284,7 +1284,7 @@ section are:
.BR cachecrls " = yes | " no .BR cachecrls " = yes | " no
if enabled, certificate revocation lists (CRLs) fetched via HTTP or LDAP will if enabled, certificate revocation lists (CRLs) fetched via HTTP or LDAP will
be cached in be cached in
.I /etc/ipsec.d/crls/ .I @sysconfdir@/ipsec.d/crls/
under a unique file name derived from the certification authority's public key. under a unique file name derived from the certification authority's public key.
.TP .TP
.BR charondebug " = <debug list>" .BR charondebug " = <debug list>"
@@ -1463,12 +1463,12 @@ time equals zero and, thus, rekeying gets disabled.
.SH FILES .SH FILES
.nf .nf
/etc/ipsec.conf @sysconfdir@/ipsec.conf
/etc/ipsec.d/aacerts @sysconfdir@/ipsec.d/aacerts
/etc/ipsec.d/acerts @sysconfdir@/ipsec.d/acerts
/etc/ipsec.d/cacerts @sysconfdir@/ipsec.d/cacerts
/etc/ipsec.d/certs @sysconfdir@/ipsec.d/certs
/etc/ipsec.d/crls @sysconfdir@/ipsec.d/crls
.SH SEE ALSO .SH SEE ALSO
strongswan.conf(5), ipsec.secrets(5), ipsec(8) strongswan.conf(5), ipsec.secrets(5), ipsec(8)
+4 -4
View File
@@ -15,7 +15,7 @@ Here is an example.
.LP .LP
.RS .RS
.nf .nf
# /etc/ipsec.secrets - strongSwan IPsec secrets file # @sysconfdir@/ipsec.secrets - strongSwan IPsec secrets file
192.168.0.1 %any : PSK "v+NkxY9LLZvwj4qCC2o/gGrWDF2d21jL" 192.168.0.1 %any : PSK "v+NkxY9LLZvwj4qCC2o/gGrWDF2d21jL"
: RSA moonKey.pem : RSA moonKey.pem
@@ -140,7 +140,7 @@ is interpreted as Base64 encoded binary data.
.TQ .TQ
.B : ECDSA <private key file> [ <passphrase> | %prompt ] .B : ECDSA <private key file> [ <passphrase> | %prompt ]
For the private key file both absolute paths or paths relative to For the private key file both absolute paths or paths relative to
\fI/etc/ipsec.d/private\fP are accepted. If the private key file is \fI@sysconfdir@/ipsec.d/private\fP are accepted. If the private key file is
encrypted, the \fIpassphrase\fP must be defined. Instead of a passphrase encrypted, the \fIpassphrase\fP must be defined. Instead of a passphrase
.B %prompt .B %prompt
can be used which then causes the daemon to ask the user for the password can be used which then causes the daemon to ask the user for the password
@@ -148,7 +148,7 @@ whenever it is required to decrypt the key.
.TP .TP
.B : P12 <PKCS#12 file> [ <passphrase> | %prompt ] .B : P12 <PKCS#12 file> [ <passphrase> | %prompt ]
For the PKCS#12 file both absolute paths or paths relative to For the PKCS#12 file both absolute paths or paths relative to
\fI/etc/ipsec.d/private\fP are accepted. If the container is \fI@sysconfdir@/ipsec.d/private\fP are accepted. If the container is
encrypted, the \fIpassphrase\fP must be defined. Instead of a passphrase encrypted, the \fIpassphrase\fP must be defined. Instead of a passphrase
.B %prompt .B %prompt
can be used which then causes the daemon to ask the user for the password can be used which then causes the daemon to ask the user for the password
@@ -182,7 +182,7 @@ can be specified, which causes the daemon to ask the user for the pin code.
.LP .LP
.SH FILES .SH FILES
/etc/ipsec.secrets @sysconfdir@/ipsec.secrets
.SH SEE ALSO .SH SEE ALSO
ipsec.conf(5), strongswan.conf(5), ipsec(8) ipsec.conf(5), strongswan.conf(5), ipsec(8)
.br .br
+1
View File
@@ -10,6 +10,7 @@ _ipsec.8 : _ipsec.8.in
-e "s:@IPSEC_SCRIPT@:$(ipsec_script):g" \ -e "s:@IPSEC_SCRIPT@:$(ipsec_script):g" \
-e "s:@IPSEC_SCRIPT_UPPER@:$(ipsec_script_upper):g" \ -e "s:@IPSEC_SCRIPT_UPPER@:$(ipsec_script_upper):g" \
-e "s:@IPSEC_DIR@:$(ipsecdir):" \ -e "s:@IPSEC_DIR@:$(ipsecdir):" \
-e "s:@IPSEC_CONFDIR@:$(sysconfdir):" \
$(srcdir)/$@.in > $@ $(srcdir)/$@.in > $@
_ipsec : _ipsec.in _ipsec : _ipsec.in
+10 -10
View File
@@ -145,25 +145,25 @@ locally by the IKE daemon or received via the IKE protocol.
.TP .TP
.BI "listcacerts [" --utc ] .BI "listcacerts [" --utc ]
returns a list of X.509 Certification Authority (CA) certificates that were returns a list of X.509 Certification Authority (CA) certificates that were
loaded locally by the IKE daemon from the \fI/etc/ipsec.d/cacerts/\fP loaded locally by the IKE daemon from the \fI@IPSEC_CONFDIR@/ipsec.d/cacerts/\fP
directory or received via the IKE protocol. directory or received via the IKE protocol.
. .
.TP .TP
.BI "listaacerts [" --utc ] .BI "listaacerts [" --utc ]
returns a list of X.509 Authorization Authority (AA) certificates that were returns a list of X.509 Authorization Authority (AA) certificates that were
loaded locally by the IKE daemon from the \fI/etc/ipsec.d/aacerts/\fP loaded locally by the IKE daemon from the \fI@IPSEC_CONFDIR@/ipsec.d/aacerts/\fP
directory. directory.
. .
.TP .TP
.BI "listocspcerts [" --utc ] .BI "listocspcerts [" --utc ]
returns a list of X.509 OCSP Signer certificates that were either loaded returns a list of X.509 OCSP Signer certificates that were either loaded
locally by the IKE daemon from the \fI/etc/ipsec.d/ocspcerts/\fP locally by the IKE daemon from the \fI@IPSEC_CONFDIR@/ipsec.d/ocspcerts/\fP
directory or were sent by an OCSP server. directory or were sent by an OCSP server.
. .
.TP .TP
.BI "listacerts [" --utc ] .BI "listacerts [" --utc ]
returns a list of X.509 Attribute certificates that were loaded locally by returns a list of X.509 Attribute certificates that were loaded locally by
the IKE daemon from the \fI/etc/ipsec.d/acerts/\fP directory. the IKE daemon from the \fI@IPSEC_CONFDIR@/ipsec.d/acerts/\fP directory.
. .
.TP .TP
.BI "listgroups [" --utc ] .BI "listgroups [" --utc ]
@@ -179,7 +179,7 @@ sections in \fIipsec.conf\fP.
.TP .TP
.BI "listcrls [" --utc ] .BI "listcrls [" --utc ]
returns a list of Certificate Revocation Lists (CRLs) that were either loaded returns a list of Certificate Revocation Lists (CRLs) that were either loaded
by the IKE daemon from the \fI/etc/ipsec.d/crls\fP directory or fetched from by the IKE daemon from the \fI@IPSEC_CONFDIR@/ipsec.d/crls\fP directory or fetched from
an HTTP- or LDAP-based CRL distribution point. an HTTP- or LDAP-based CRL distribution point.
. .
.TP .TP
@@ -211,7 +211,7 @@ flushes and rereads all secrets defined in \fIipsec.secrets\fP.
.TP .TP
.B "rereadcacerts" .B "rereadcacerts"
removes previously loaded CA certificates, reads all certificate files removes previously loaded CA certificates, reads all certificate files
contained in the \fI/etc/ipsec.d/cacerts\fP directory and adds them to the list contained in the \fI@IPSEC_CONFDIR@/ipsec.d/cacerts\fP directory and adds them to the list
of Certification Authority (CA) certificates. This does not affect certificates of Certification Authority (CA) certificates. This does not affect certificates
explicitly defined in a explicitly defined in a
.BR ipsec.conf (5) .BR ipsec.conf (5)
@@ -220,23 +220,23 @@ ca section, which may be separately updated using the \fBupdate\fP command.
.TP .TP
.B "rereadaacerts" .B "rereadaacerts"
removes previously loaded AA certificates, reads all certificate files removes previously loaded AA certificates, reads all certificate files
contained in the \fI/etc/ipsec.d/aacerts\fP directory and adds them to the list contained in the \fI@IPSEC_CONFDIR@/ipsec.d/aacerts\fP directory and adds them to the list
of Authorization Authority (AA) certificates. of Authorization Authority (AA) certificates.
. .
.TP .TP
.B "rereadocspcerts" .B "rereadocspcerts"
reads all certificate files contained in the \fI/etc/ipsec.d/ocspcerts/\fP reads all certificate files contained in the \fI@IPSEC_CONFDIR@/ipsec.d/ocspcerts/\fP
directory and adds them to the list of OCSP signer certificates. directory and adds them to the list of OCSP signer certificates.
. .
.TP .TP
.B "rereadacerts" .B "rereadacerts"
reads all certificate files contained in the \fI/etc/ipsec.d/acerts/\fP reads all certificate files contained in the \fI@IPSEC_CONFDIR@/ipsec.d/acerts/\fP
directory and adds them to the list of attribute certificates. directory and adds them to the list of attribute certificates.
. .
.TP .TP
.B "rereadcrls" .B "rereadcrls"
reads all Certificate Revocation Lists (CRLs) contained in the reads all Certificate Revocation Lists (CRLs) contained in the
\fI/etc/ipsec.d/crls/\fP directory and adds them to the list of CRLs. \fI@IPSEC_CONFDIR@/ipsec.d/crls/\fP directory and adds them to the list of CRLs.
. .
.TP .TP
.B "rereadall" .B "rereadall"
+1 -1
View File
@@ -2,7 +2,7 @@
. .
.nf .nf
.na .na
/etc/swanctl/swanctl.conf configuration file @sysconfdir@/swanctl/swanctl.conf configuration file
.ad .ad
.fi .fi
. .