summaryrefslogtreecommitdiff
path: root/rsync-ssl.1.md
diff options
context:
space:
mode:
authorWayne Davison <wayne@opencoder.net>2020-06-15 09:51:20 -0700
committerWayne Davison <wayne@opencoder.net>2020-06-15 10:41:08 -0700
commit628dcceb8daf6aa2cf79bb03dfd22d36f97561e2 (patch)
tree69be4526641a376781f6d73557ed0e673fc7b739 /rsync-ssl.1.md
parent00ec415a6965cf36bb05a7efbfdcc693ea2e0195 (diff)
downloadrsync-628dcceb8daf6aa2cf79bb03dfd22d36f97561e2.tar.gz
Choose openssl before stunnel.
Diffstat (limited to 'rsync-ssl.1.md')
-rw-r--r--rsync-ssl.1.md21
1 files changed, 12 insertions, 9 deletions
diff --git a/rsync-ssl.1.md b/rsync-ssl.1.md
index c16b9657..ff4913c2 100644
--- a/rsync-ssl.1.md
+++ b/rsync-ssl.1.md
@@ -17,7 +17,7 @@ that requires ssl connections.
If the **first** arg is a `--type=SSL_TYPE` option, the script will only use
that particular program to open an ssl connection instead of trying to find an
-stunnel or openssl executable via a simple heuristic (assuming that the
+openssl or stunnel executable via a simple heuristic (assuming that the
`RSYNC_SSL_TYPE` environment variable is not set as well -- see below). This
option must specify one of `openssl` or `stunnel`. The equal sign is
required for this particular option.
@@ -41,17 +41,12 @@ The ssl helper scripts are affected by the following environment variables:
certificate to use for the connection.
0. `RSYNC_SSL_CA_CERT` If specified, the value is a filename that contains a
certificate authority certificate that is used to validate the connection.
-0. `RSYNC_SSL_STUNNEL` Specifies the stunnel executable to run when the
- connection type is set to stunnel. If unspecified, the $PATH is searched
- first for "stunnel4" and then for "stunnel".
0. `RSYNC_SSL_OPENSSL` Specifies the openssl executable to run when the
connection type is set to openssl. If unspecified, the $PATH is searched
for "openssl".
-
-# CAVEATS
-
-Note that using an stunnel connection requires at least version 4 of stunnel,
-which should be the case on modern systems.
+0. `RSYNC_SSL_STUNNEL` Specifies the stunnel executable to run when the
+ connection type is set to stunnel. If unspecified, the $PATH is searched
+ first for "stunnel4" and then for "stunnel".
# EXAMPLES
@@ -63,6 +58,14 @@ which should be the case on modern systems.
**rsync**(1), **rsyncd.conf**(5)
+# CAVEATS
+
+Note that using an stunnel connection requires at least version 4 of stunnel,
+which should be the case on modern systems. Also, it does not verify a
+connection against the CA certificate collection, so it only encrypts the
+connection without any cert validation unless you have specified the
+certificate environment options.
+
# BUGS
Please report bugs! See the web site at <http://rsync.samba.org/>.