diff options
author | Guilhem Moulin <guilhem@fripost.org> | 2019-05-27 18:40:49 +0200 |
---|---|---|
committer | Guilhem Moulin <guilhem@fripost.org> | 2019-05-27 18:47:29 +0200 |
commit | 7c4d78faf324dab6428dc414ac84ecda1a18e685 (patch) | |
tree | ce75e6628440419c65e5fc3409411bef6d9aaefa /pullimap.md | |
parent | 8e379c62a48d68cd5ab2a32c6fc9244b1ae94084 (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.md | 9 |
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* |