diff options
| author | Domagoj Stolfa <ds815@gmx.com> | 2021-06-13 16:08:53 +0100 |
|---|---|---|
| committer | Tobias Geerinckx-Rice <me@tobias.gr> | 2021-06-25 00:39:32 +0200 |
| commit | 66be80fabb9af0a570aee4c2e96886267a613e8e (patch) | |
| tree | e56be781fd031d24d3da987f06f9977ceb1317b8 /doc | |
| parent | 1baaf599a4000451a54dcf30098a998f1b5bc70f (diff) | |
gnu: Add strongswan service.
* gnu/services/vpn.scm (<strongswan-configuration>): New record type.
(charon-plugins, strongswan-configuration-file)
(strongswan-shepherd-service, strongswan-service-type): New variables.
* doc/guix.tex (VPN Services): Document them all.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/guix.texi | 39 |
1 files changed, 38 insertions, 1 deletions
diff --git a/doc/guix.texi b/doc/guix.texi index 560d7af83f2..4456f9a0555 100644 --- a/doc/guix.texi +++ b/doc/guix.texi | |||
| @@ -92,6 +92,7 @@ Copyright @copyright{} 2021 Maxime Devos@* | |||
| 92 | Copyright @copyright{} 2021 B. Wilson@* | 92 | Copyright @copyright{} 2021 B. Wilson@* |
| 93 | Copyright @copyright{} 2021 Xinglu Chen@* | 93 | Copyright @copyright{} 2021 Xinglu Chen@* |
| 94 | Copyright @copyright{} 2021 Raghav Gururajan@* | 94 | Copyright @copyright{} 2021 Raghav Gururajan@* |
| 95 | Copyright @copyright{} 2021 Domagoj Stolfa@* | ||
| 95 | 96 | ||
| 96 | Permission is granted to copy, distribute and/or modify this document | 97 | Permission is granted to copy, distribute and/or modify this document |
| 97 | under the terms of the GNU Free Documentation License, Version 1.3 or | 98 | under the terms of the GNU Free Documentation License, Version 1.3 or |
| @@ -27107,9 +27108,45 @@ Defaults to @samp{#f}. | |||
| 27107 | 27108 | ||
| 27108 | @end deftypevr | 27109 | @end deftypevr |
| 27109 | 27110 | ||
| 27110 | |||
| 27111 | @c %end of automatic openvpn-server documentation | 27111 | @c %end of automatic openvpn-server documentation |
| 27112 | 27112 | ||
| 27113 | @subheading strongSwan | ||
| 27114 | |||
| 27115 | Currently, the strongSwan service only provides legacy-style configuration with | ||
| 27116 | @file{ipsec.conf} and @file{ipsec.secrets} files. | ||
| 27117 | |||
| 27118 | @defvr {Scheme Variable} strongswan-service-type | ||
| 27119 | A service type for configuring strongSwan for IPsec @acronym{VPN, | ||
| 27120 | Virtual Private Networking}. Its value must be a | ||
| 27121 | @code{strongswan-configuration} record as in this example: | ||
| 27122 | |||
| 27123 | @lisp | ||
| 27124 | (service strongswan-service-type | ||
| 27125 | (strongswan-configuration | ||
| 27126 | (ipsec-conf "/etc/ipsec.conf") | ||
| 27127 | (ipsec-secrets "/etc/ipsec.secrets"))) | ||
| 27128 | @end lisp | ||
| 27129 | |||
| 27130 | @end defvr | ||
| 27131 | |||
| 27132 | @deftp {Data Type} strongswan-configuration | ||
| 27133 | Data type representing the configuration of the StrongSwan service. | ||
| 27134 | |||
| 27135 | @table @asis | ||
| 27136 | @item @code{strongswan} | ||
| 27137 | The strongSwan package to use for this service. | ||
| 27138 | |||
| 27139 | @item @code{ipsec-conf} (default: @code{#f}) | ||
| 27140 | The file name of your @file{ipsec.conf}. If not @code{#f}, then this and | ||
| 27141 | @code{ipsec-secrets} must both be strings. | ||
| 27142 | |||
| 27143 | @item @code{ipsec-secrets} (default @code{#f}) | ||
| 27144 | The file name of your @file{ipsec.secrets}. If not @code{#f}, then this and | ||
| 27145 | @code{ipsec-conf} must both be strings. | ||
| 27146 | |||
| 27147 | @end table | ||
| 27148 | @end deftp | ||
| 27149 | |||
| 27113 | @subsubheading Wireguard | 27150 | @subsubheading Wireguard |
| 27114 | 27151 | ||
| 27115 | @defvr {Scheme Variable} wireguard-service-type | 27152 | @defvr {Scheme Variable} wireguard-service-type |
