fetchexc - program to retrieve email from Microsoft Exchange servers
fetchexc [-p property-file]
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.
Specify the preferences file to use, rather than the default of
fetchExc.properties in the current directory.
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.
Retrieve all messages, rather than only unread messages.
Deletes messages after retrieving them. Otherwise messages are
marked read and left in the Inbox.
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 address, only used with form-based authentication. The
correct value can be found in the login page's source in the hidden
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.
NetBIOS domain name, for instance YOYODYNE if your NetBIOS login is
The web server to retrieve messages from, for example
The path to Outlook Web Access. Usually exchange.
The Exchange mailbox name, not necessarily the same as the Username
The three Exchange options are used to form the web-access URI of the
Login page for form-based authentication. The default is
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.
This could lead to more spam getting through.
Email address that the forwarding server will accept. Only used if
ForceFrom is true.
SMTP server to forward messages to. This option is not used if
MboxFile is set.
mbox file to store mail in. This disables the MailServer and
mbox file locking is not yet well-tested. Use this option with
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: <email@example.com> wasn't valid
MAIL FROM error status=501
Message 1 not sent
Password for authentication with the Exchange server.
If true the program in DestinationAddress is used to send email.
The default is false.
Uses HTTPS when set to true. This should be enabled whenever
Username for authentication with the Exchange server. Not
necessarily the same as the ExchangeUser option.
Example 1. Configuration file for SMTP forwarding
ExchangeServer = webmail.example.com
ExchangePath = exchange
ExchangeUser = Joe.User
MailServer = mail.example.net
DestinationAddress = firstname.lastname@example.org
Username = juser
Password = secret
Domain = YOYODYNE
Delete = false
All = false
Secure = true
NoEightBitMime = true
fetchExc is primarily the work of Juhani Rautiainen
This manual page was written by Ted Percival email@example.com 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.
[FIXME: source] 2006-06-25