aboutsummaryrefslogtreecommitdiffstats
path: root/pullimap.md
diff options
context:
space:
mode:
authorGuilhem Moulin <guilhem@fripost.org>2019-05-27 18:40:49 +0200
committerGuilhem Moulin <guilhem@fripost.org>2019-05-27 18:47:29 +0200
commit7c4d78faf324dab6428dc414ac84ecda1a18e685 (patch)
treece75e6628440419c65e5fc3409411bef6d9aaefa /pullimap.md
parent8e379c62a48d68cd5ab2a32c6fc9244b1ae94084 (diff)
Manpages: clarify that the tunnel command is run following Perl's `exec` semantics.
It is passed to `/bin/sh -c` when it contains shell metacharacters; and split into words and passed to execvp(3) otherwise. https://perldoc.perl.org/functions/exec.html (Since c8fb54897f046a5a3fb4c1d45dc21fd8bcd882e3 the value no longer needs to stard with a forward slash.)
Diffstat (limited to 'pullimap.md')
-rw-r--r--pullimap.md9
1 files changed, 6 insertions, 3 deletions
diff --git a/pullimap.md b/pullimap.md
index a367dd1..72418aa 100644
--- a/pullimap.md
+++ b/pullimap.md
@@ -131,8 +131,9 @@ Valid options are:
: One of `imap`, `imaps` or `tunnel`.
`type=imap` and `type=imaps` are respectively used for IMAP and IMAP
over SSL/TLS connections over a INET socket.
- `type=tunnel` causes `pullimap` to open a pipe to a *command*
- instead of a raw socket.
+ `type=tunnel` causes `pullimap` to create an unnamed pair of
+ connected sockets for interprocess communication with a *command*
+ instead of a opening a network socket.
(Default: `imaps`.)
*host*
@@ -160,7 +161,9 @@ Valid options are:
: Command to use for `type=tunnel`. Must speak the [IMAP4rev1
protocol][RFC 3501] on its standard output, and understand it on its
- standard input.
+ standard input. The value is passed to `` `/bin/sh -c` `` if it
+ contains shell metacharacters; otherwise it is split into words and
+ the list is passed to `execvp`(3).
*STARTTLS*