diff options
Diffstat (limited to 'fetchmail.man')
| -rw-r--r-- | fetchmail.man | 24 |
1 files changed, 21 insertions, 3 deletions
diff --git a/fetchmail.man b/fetchmail.man index e2b4ce62..792093fb 100644 --- a/fetchmail.man +++ b/fetchmail.man @@ -657,6 +657,7 @@ safely, or easily disable entries for hosts that are temporarily down.) .PP Legal server options are: + via protocol (or proto) port authenticate (or auth) @@ -704,9 +705,26 @@ The 'folder' and 'smtphost' options can take a space- or comma-separated list of names following them. .PP All options correspond to the obvious command-line arguments, except -the following: `interval', `aka', `is', `to', `dns'/`no dns', `password', -\&`preconnect', `localdomains', `stripcr'/`no stripcr' , -\&`forcecr'/`no forcecr', `pass8bits'/`no pass8bits' and `no received'. +the following: `via', `interval', `aka', `is', `to', `dns'/`no dns', +\&`password', \&`preconnect', `localdomains', `stripcr'/`no stripcr' , +\&`forcecr'/`no forcecr', `pass8bits'/`no pass8bits' and `no +received'. +.PP +The `via' option is for use with ssh, or if you want to have more +than one configuration pointing at the same site. If it is present, +the string argument will be taken as the actual DNS name of the +mailserver host to query. So, for example, you can say: + +.nf +poll mailhost.net via localhost port 1234 with pop3: + preconnect "ssh -f -L 1234:mailhost.net:110 mailhost.net sleep 20 </dev/null >/dev/null"; +.fi + +This will override the argument of poll, which can simply be a +distinct label for the configuration. The poll name will still be the +one you would give on the command line to explicitly query this host. +It will also still be used as a possible match in multidrop mode, in +case it is (as in this case) the real host name. .PP The `interval' option (which takes a numeric argument) allows you to poll a server less frequently than the basic poll interval. If you say |