fetchexc(1)
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.