---
name: "fetchexc"
section: "1"
platform: "linux"
package: "fetchexc"
version: "2.0-3"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/fetchexc"
---

# fetchexc(1)

program to retrieve email from Microsoft Exchange servers via WebDAV

## 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 http*s*://*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