NAME
fetchexc - program to retrieve email from Microsoft Exchange servers
via WebDAV
SYNOPSIS
fetchexc [-p property-file]
DESCRIPTION
fetchexc fetches emails from Outlook Web Access using the WebDAV
protocol. Its configuration is read from a properties file called
fetchExc.properties. The properties file should be in the current
directory, otherwise in the location specified with the -p option.
OPTIONS
-p
Specify the preferences file to use, rather than the default of
fetchExc.properties in the current directory.
CONFIGURATION
The configuration file format is key = value. Whitespace around the key
is ignored, as well as whitespace before the value. Lines whose first
non-whitespace character is # or ! are considered comments and ignored.
A description of each configuration option is given below.
All
Retrieve all messages, rather than only unread messages.
Delete
Deletes messages after retrieving them. Otherwise messages are
marked read and left in the Inbox.
Warning
Don't combine Delete = false and All = true if you are not
testing. That will fetch every message from your Inbox every
time you run fetchExc.
Destination
Destination address, only used with form-based authentication. The
correct value can be found in the login page's source in the hidden
"destination" field.
DestinationAddress
The address of the recipient for retrieved emails. If MboxFile is
defined this option is ignored. If ProcMail is true this is the
program to use for sending mail, for example /usr/bin/procmail.
Domain
NetBIOS domain name, for instance YOYODYNE if your NetBIOS login is
YOYODYNE\Joe.User.
ExchangeServer
The web server to retrieve messages from, for example
webmail.example.com.
ExchangePath
The path to Outlook Web Access. Usually exchange.
ExchangeUser
The Exchange mailbox name, not necessarily the same as the Username
option.
The three Exchange options are used to form the web-access URI of the
form https://ExchangeServer/ExchangePath/ExchangeUser.
FBApath
Login page for form-based authentication. The default is
/exchweb/bin/auth/owaauth.dll.
ForceFrom
If this is set to true forwarded mail will be forwarded with the
address from ForceFromAddr. This only happens when the sender
address is invalid, for example if there are two From headers
Exchange sometimes joins them.
Note
This could lead to more spam getting through.
ForceFromAddr
Email address that the forwarding server will accept. Only used if
ForceFrom is true.
MailServer
SMTP server to forward messages to. This option is not used if
MboxFile is set.
MboxFile
mbox file to store mail in. This disables the MailServer and
DestinationAddress options.
Warning
mbox file locking is not yet well-tested. Use this option with
caution.
NoEightBitMime
Setting to true disables eight-bit MIME with SMTP forwarding. The
default is false.
Enabling this option can help if the following error occurs:
From: <joe.user@example.com> wasn't valid
MAIL FROM error status=501
Message 1 not sent
Password
Password for authentication with the Exchange server.
ProcMail
If true the program in DestinationAddress is used to send email.
The default is false.
Secure
Uses HTTPS when set to true. This should be enabled whenever
possible.
Username
Username for authentication with the Exchange server. Not
necessarily the same as the ExchangeUser option.
EXAMPLES
Example 1. Configuration file for SMTP forwarding
ExchangeServer = webmail.example.com
ExchangePath = exchange
ExchangeUser = Joe.User
MailServer = mail.example.net
DestinationAddress = joe@example.net
Username = juser
Password = secret
Domain = YOYODYNE
Delete = false
All = false
Secure = true
NoEightBitMime = true
AUTHOR
fetchExc is primarily the work of Juhani Rautiainen
http://personal.inet.fi/atk/fetchexc/.
This manual page was written by Ted Percival ted@midg3t.net for the
Debian system (but may be used by others). Permission is granted to
copy, distribute and/or modify this document under the terms of the GNU
General Public License, version 2 or any later version published by the
Free Software Foundation.
On Debian systems, the complete text of the GNU General Public License
can be found in /usr/share/common-licenses/GPL.
AUTHOR
Ted Percival
Author.
COPYRIGHT
[FIXME: source] 2006-06-25