FETCHEXC

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.