From 7c4d78faf324dab6428dc414ac84ecda1a18e685 Mon Sep 17 00:00:00 2001 From: Guilhem Moulin Date: Mon, 27 May 2019 18:40:49 +0200 Subject: 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.) --- pullimap.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) (limited to 'pullimap.md') 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* -- cgit v1.2.3