Author: tedp-guest Date: 2007-08-27 12:20:45 +0000 (Mon, 27 Aug 2007) New Revision: 4067
Added: branches/fetchexc/ tags/fetchexc/ trunk/fetchexc/ trunk/fetchexc/debian/ trunk/fetchexc/debian/MAINTAINING trunk/fetchexc/debian/README.html trunk/fetchexc/debian/changelog trunk/fetchexc/debian/changelog.upstream trunk/fetchexc/debian/compat trunk/fetchexc/debian/control trunk/fetchexc/debian/copyright trunk/fetchexc/debian/dirs trunk/fetchexc/debian/docs trunk/fetchexc/debian/manpage.xml trunk/fetchexc/debian/patches/ trunk/fetchexc/debian/patches/001_build_changes.dpatch trunk/fetchexc/debian/patches/002_usr_bin_fetchexc.dpatch trunk/fetchexc/debian/patches/00list trunk/fetchexc/debian/rules trunk/fetchexc/debian/watch Log: Import fetchexc Added: trunk/fetchexc/debian/MAINTAINING =================================================================== --- trunk/fetchexc/debian/MAINTAINING (rev 0) +++ trunk/fetchexc/debian/MAINTAINING 2007-08-27 12:20:45 UTC (rev 4067) @@ -0,0 +1,12 @@ +The README.html and changelog.upstream files are manually maintained as +follows. + +README.html is taken from the upstream URI + http://personal.inet.fi/atk/fetchexc/ +with an explanatory block at the top and all links adjusted so that they +still work. + +changelog.upstream is trimmed from the output of a `lynx -dump` of the +upstream URI. + +# vim: tw=72 Added: trunk/fetchexc/debian/README.html =================================================================== --- trunk/fetchexc/debian/README.html (rev 0) +++ trunk/fetchexc/debian/README.html 2007-08-27 12:20:45 UTC (rev 4067) @@ -0,0 +1,215 @@ +<html> +<head> + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1"> + <meta http-equiv="Keywords" content="fetchmail, fetchExc, Exchange, e2k, e2k3, webDAV, OWA"> + <title>fetchExc - fetches mail with webDAV from Exchange 2000/2003 servers</title> +</head> +<body> +<p> + This document was retrieved from the fetchExc website at + <a href="http://personal.inet.fi/atk/fetchexc/";>http://personal.inet.fi/atk/fetchexc/</a> + on 2007-08-05. + Some of the instructions do not apply to the + <a href="http://www.debian.org/";>Debian</a> package, but have been left in + for completeness. +</p> +<hr /> + <H2>fetchExc - fetches mail with webDAV from MS Exchange 2000/2003 servers</H2> + <br> + <H3>What fetchExc does:</H3> + <p>FetchExc is java utility which retrieves mail from your MS Exchange + (2000/2003) inbox and forwards it to SMTP server of your choice or + mbox type file. FetchExc uses webDAV to retrieve mail either over + http or https. webDAV is used also by Outlook Webaccees (OWA). This is also means that you administrator + must have left OWA available in Exchange in order to get this utility to work. + </p> + <p>I consider this program usable in production environment. There are still many places that should be polished and improved but atleast there haven't been major problems in over a year. Before you install read installation instructions from below carefully. Check list at the bottom of the page to see what has changed in each version.</p> + + <H3>How to get fetchExc:</H3> + <p>You'll need following:</p> + <ul> + <li><a href="http://personal.inet.fi/atk/fetchexc/fetchExc-2.0.tar.gz";>fetchExc-2.0.tar.gz - Contains all needed jar files</a> + </ul> + + <p>Or if you want to pick-up all pieces yourself: + <ul> + <li><a href="http://personal.inet.fi/atk/fetchexc/fetchExc.jar";> fetchExc.jar - Jar file containing fetchExc.</a> + <li><a href="http://jakarta.apache.org/commons/httpclient/";> Jakarta Commons HttpClient</a> + <li><a href="http://jakarta.apache.org/commons/logging/";> Jakarta Commons Logging</a> + <li><a href="http://jakarta.apache.org/commons/codec/";> Jakarta Commons Codec</a> + </ul> + <p>From HttpClient you'll need <b>commons-httpclient-3.0.1.jar</b> (or later). From Logging you'll need <b>commons-logging-api-1.1.jar</b> and <b>commons-logging-1.1.jar</b>. And finally from Codec you'll need <b>commons-codec-1.3.jar</b>. Put all jars in same directory.</p> + <p>You also need Java Runtime Environment (1.5.0 or later) <a href="http://java.sun.com/j2se";>Java 2 Platform, Standard Edition</a></p> + <H3>Installing:</H3> + <p>So far this only covers *nix systems (windows instructions may follow + if they are needed)</p> + <p>Extract fetchExc-*.tar.gz or make directory for fetchExc.jar. If + you are downloading Jakarta components yourself put them in the same + directory as fetchExc.jar.</p> + <p>Create fetchExc.properties file in your home directory. Remember to protect it with chmod 700 (it contains your password). If you took .tar.gz package there should be example included.</p> + <pre> +ExchangeServer=xxx.dddddd.com +ExchangePath=exchange +MailServer=yyy.dddddd.com [EMAIL PROTECTED] +Username=domainuser +Password=domainpassword +Domain=DOMAIN +Delete=false +All=false +Secure=true +FBApath=/exchweb/bin/auth/owaauth.dll +</pre> + <ul> + <li><p><b>ExchangeServer</b> - Name of your MS Exchange server.</p> + <li><p><b>ExchangePath</b> - Exchange path for MS Exchange OutLook WebAccess.</p> + </ul><p>You can test first two properties by making URL out of them: http://ExchangeServer/ExchangePath/. This should give you a Outlook Webaccess Page.</p> + <ul> + <li><p><b>ExchangeUser</b> - Name of you MS Exchange User. This is not needed if version is v1.50 or later</p> + <li><p><b>MboxFile</b> - Path and name of mbox-type mail box. This disables MailServer- and DestinationAddress-properties. Be careful with this because I'm not 100% sure that file locking works (YMMV). If there are problems let me know. Also success reports would be nice.</p> + <li><p><b>MailServer</b> - Name of your SMTP Server which receives forwarded messages. If there is MboxFile defined this property won't be used.<p> + <li><p><b>DestinationAddess</b> - Address of recipient of forwarded messages. If there is MboxFile defined this property won't be used. If ProcMail is true this is program which is used to send mail for example /usr/bin/procmail. </p> + <li><p><b>Username</b> - Username for your windows domain user. It may be same as <b>ExchangeUser</b> but necessarily.</p> + <li><p><b>Password</b> - Password for domain user.</p> + <li><p><b>Domain</b> - Domain for above user.</p> + <li><p><b>Delete</b> - Whether program should delete mail from Inbox or just mark them as read. If <b>Delete</b> is true mail will be deleted after succesful forwarding. Any other value will just mark message as read. While you are configuring other properties I strongly recommend that you use value false for this property.</p> + <li><p><b>All</b> - Whether program should real all mail from Inbox or just which are not read yet. If <b>All</b> is true every mail will be read. Any other value will read only unread mail. While you are configuring other properties I strongly recommend that you use value false for this property. </p> +</ul><p><font color=red><b>WARNING!!!</b></font> Don't combine Delete=false and All=true if you are not testing. That will fetch every mail from your Inbox everytime you start the program.</p> + <ul> + <li><p><b>Secure</b> - If value is true program will use https. Any other value will use http. Https should be user whenever possible. <b>NOTE!!!</b> Check <a href="http://personal.inet.fi/atk/fetchexc/getcert.html";>this</a> if you get sun.security.validator.ValidatorException-Exception</p> + <li><p><b>FBApath</b> - Path to form based authentication. If not set defaults to /exchweb/bin/auth/owaauth.dll. This can be found on FBA login page source (hint: search for "destination")</p> + <li><p><b>ForceFrom</b> - If this is set to true forwarded mail will be forwarded with address from ForceFromAddr parameter. This only happens when sender address is not valid. For example if there is two From: fields in mail header Exchange can join addresses. <b>NOTE!!!</b>: This may help spam to get through so use carefully.</p> + <li><p><b>ForceFromAddr</b> - E-mail address that forwarding server will accept. Only used if ForceFrom is true</p> + <li><p><b>NoEightBitMime</b> - If this is true SMTP forwarding doesn't use BODY=8BITMIME. Default is false.</p> + <li><p><b>ProcMail</b> - If this is true program in DestinationAddress is used to send mail. Default is false.</p> + <li><p><b>Destination</b> - Use this if use use FBA with ISA. Value for this property can be found from login page source. Search for hidden field "destination" for value.</p> + <li><p><b>ProxyHost</b> - If you have to use proxy put proxy hostname here. <b>NOTE!!!</b> So far I haven't been able to connect through proxy when Secure=true. If this works for you with Secure=true send me a message.</p> + <li><p><b>ProxyPort</b> - If ProxyHost is set you can define port for it here. Default is port 80.</p> + + </ul> + <p>Now you just need to include JRE in you path. If it is in you path you can run program:</p> + <pre>java -jar /install/fetchExc/fetchExc.jar</pre> + <p>You can now (>0.80) use -p switch to change properties file. For example:</p> + <pre>java -jar /install/fetchExc/fetchExc.jar -p test.properties</pre> + <p>would run program using properties from test.properties</p> + <p>I use fetchExc with following little shell script and crontab entry so that it keeps fetching mail every two minutes.</p> + <p>fetchExc</p> + <pre> +#!/bin/bash +export PATH=$PATH:/usr/local/jre/bin +java -jar /install/fetchExc/fetchExc.jar $* >> fetchExc.log 2>> fetchExc.err +</pre> + <p>If you use this script replace /usr/local/jre/bin with path to your java runtime environment. Same applies to location of your installation on next line.</p> + <p>crontab entry:</p> + <pre>*/2 * * * * ~jrauti/bin/fetchExc</pre> + + <H3>Source:</H3> + <p>For compilation you need Java development environment (>1.4.2) and apache ant.</p> + <ul> + <li><a href="http://personal.inet.fi/atk/fetchexc/fetchExc-src-2.0.tar.gz";>fetchExc-src-2.0.tar.gz - Contains all needed sources and Jakarta Commons jar-files</a> + </ul> + + <H3>Version History:</H3> + <p>v0.50 First public release</p> + <p>v0.65 (22.2.2005):</p> + <ul> + <li>Added timeout to TCP connection</li> + <li>Added '|'-character handling in URL</li> + </ul> + <p>v0.70 (25.2.2005):</p> + <ul> + <li>Fixed SMTP message ending (does work with Postfix now)</li> + </ul> + <p>v0.80 (8.3.2005):</p> + <ul> + <li>It's possible to write mail to mbox type mailbox</li> + <li>It's possible to use different properties files</li> + </ul> + <p>v0.85 (11.3.2005):</p> + <ul> + <li>Fixed bad bug in mbox handling and cleaned up some code other code there too</li> + <li>Added few more characters to URL-handling</li> + <li>Thanks to Robert Clark for error report and fixes/cleanups</li> + </ul> + <p>v0.90 (6.4.2005):</p> + <ul> + <li>Robert made mbox-file locking better and found few more characters that weren't handled properly</li> + </ul> + <p>v0.91 (1.7.2005):</p> + <ul> + <li>Fetches more than 100 mail per time (old limit)</li> + </ul> + <p>v0.95 (6.7.2005):</p> + <ul> + <li>Now fetches mail even if form based authentication (FBA) is enabled.</li> + </ul> + <p>v0.97 (7.9.2005):</p> + <ul> + <li>Fixed issues when mail has multiple From: fields because this confuses Exchange. There are two new properties (ForceFrom, ForceFromAddr)</li> + </ul> + <p>v0.98 (21.9.2005):</p> + <ul> + <li>Smail doesn't seem to like BODY=8BITMIME in MAIL FROM: in certaind distros so it's possible to switch off (NoEightBitMime property). Also fixed one status message if mail is picked from E2K.</li> + </ul> + <p>v0.99 (11.10.2005):</p> + <ul> + <li>Fixed long standing bug which caused some Exchange 2000 servers to response Search-request with error page. Error in fetchExc.log looked something like 'The element type 'META' must be terminated by the matching end-tag '</META>'. Thanks for Arnout Vos for helping to solve this one.</li> + <li>Fixed formatting bug in Received: header date formatting</li> + </ul> + <p>v1.00 (28.10.2005):</p> + <ul> + <li>Fixed handling of messages with no From:. This seems to happen with E2K when message headers have been cut with extra line. Seems to happen with spam.</li> + <li>Some RFC2821 compliance issues fixed and message size counter added. Thanks to Eric Krohn for patches.</li> + </ul> + <p>v1.10 (30.05.2006):</p> + <ul> + <li>Using Exchange as MTA works.</li> + <li>Sending mail with local procmail added. New property ProcMail handles this. Thanks for this to Kurt Neufeld for idea and example.</li> + <li>Using FBA with ISA works. Use property Destination to activate this. Thanks to Stefan Krantz for helping to solve this one.</li> + </ul> + <p>v1.15 (05.10.2006):</p> + <ul> + <li>Fixed end-of-message handling. Qmail should work now too. </li> + </ul> + <p>v1.50 (05.11.2006):</p> + <ul> + <li>ExchangeUser propertry not used anymore. fetchExc should be able to find correct path without.</li> + <li>Proxy support added. Check ProxyHost and ProxyPort properties. NOTE!!! Haven't for proxying to work with Secure=true (SSL/TLS)</li> + </ul> + <p>v2.0 (27.03.2007):</p> + <ul> + <li>Java changed from 1.4 to 1.5.</li> + <li>Httpclient upgraded from 2.0 to 3.0. This makes https through proxy to work.</li> + <li>Code cleanups.</li> + <li>Small fix in mbox saving. + </ul> + <H3>Acknowledgments:</H3> + <p>Thanks for <a href="http://jakarta.apache.org";>Jakarta Project</a> for excellent components.</p> + <p>Thanks for <a href="http://www.novell.com";>Novell</a> for Evolution Connector which I used to get traffic dumps that I needed for webDAV(OWA) conversation</p> + <p>Thanks for <a href="http://www.catb.org/~esr/";>Eric S. Raymond</a> for excellent <a href="http://www.catb.org/~esr/fetchmail/";>fetchmail</a> which I still use whenever I can.</p> + + <H3>Contact:</H3> + <p>You can reach me with email: jrauti(at)iki.fi. You should know what to do with (at) ;-). Any comments and improvements are welcome.</p> + + <H3>License:</H3> + <p>FetchExc - fetches mail with webDAV from MS Exchange 2000/2003 servers.</p> + <p>Copyright (C) 2004-2007 Juhani Rautiainen + <p>This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version.</p> + <p>This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details.</p> + <p>You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA</p> + + <br> + <p> +Outlook is a registered trademark of Microsoft Corporation and Exchange is a trademark of Microsoft Corporation. All other brands and product names are trademarks and registered trademarks of their respective holders. +</p> +<img src="http://www.kati.fi/jrauti/stats.gif"; border=0 height=0 width=0> +</body> +</html> Added: trunk/fetchexc/debian/changelog =================================================================== --- trunk/fetchexc/debian/changelog (rev 0) +++ trunk/fetchexc/debian/changelog 2007-08-27 12:20:45 UTC (rev 4067) @@ -0,0 +1,5 @@ +fetchexc (2.0-1) unstable; urgency=low + + * Initial release (Closes: #367835). + + -- Ted Percival <[EMAIL PROTECTED]> Sat, 04 Aug 2007 21:12:15 +1000 Added: trunk/fetchexc/debian/changelog.upstream =================================================================== --- trunk/fetchexc/debian/changelog.upstream (rev 0) +++ trunk/fetchexc/debian/changelog.upstream 2007-08-27 12:20:45 UTC (rev 4067) @@ -0,0 +1,77 @@ + v0.50 First public release + + v0.65 (22.2.2005): + * Added timeout to TCP connection + * Added '|'-character handling in URL + + v0.70 (25.2.2005): + * Fixed SMTP message ending (does work with Postfix now) + + v0.80 (8.3.2005): + * It's possible to write mail to mbox type mailbox + * It's possible to use different properties files + + v0.85 (11.3.2005): + * Fixed bad bug in mbox handling and cleaned up some code other code + there too + * Added few more characters to URL-handling + * Thanks to Robert Clark for error report and fixes/cleanups + + v0.90 (6.4.2005): + * Robert made mbox-file locking better and found few more characters + that weren't handled properly + + v0.91 (1.7.2005): + * Fetches more than 100 mail per time (old limit) + + v0.95 (6.7.2005): + * Now fetches mail even if form based authentication (FBA) is + enabled. + + v0.97 (7.9.2005): + * Fixed issues when mail has multiple From: fields because this + confuses Exchange. There are two new properties (ForceFrom, + ForceFromAddr) + + v0.98 (21.9.2005): + * Smail doesn't seem to like BODY=8BITMIME in MAIL FROM: in certaind + distros so it's possible to switch off (NoEightBitMime property). + Also fixed one status message if mail is picked from E2K. + + v0.99 (11.10.2005): + * Fixed long standing bug which caused some Exchange 2000 servers to + response Search-request with error page. Error in fetchExc.log + looked something like 'The element type 'META' must be terminated + by the matching end-tag '</META>'. Thanks for Arnout Vos for + helping to solve this one. + * Fixed formatting bug in Received: header date formatting + + v1.00 (28.10.2005): + * Fixed handling of messages with no From:. This seems to happen with + E2K when message headers have been cut with extra line. Seems to + happen with spam. + * Some RFC2821 compliance issues fixed and message size counter + added. Thanks to Eric Krohn for patches. + + v1.10 (30.05.2006): + * Using Exchange as MTA works. + * Sending mail with local procmail added. New property ProcMail + handles this. Thanks for this to Kurt Neufeld for idea and example. + * Using FBA with ISA works. Use property Destination to activate + this. Thanks to Stefan Krantz for helping to solve this one. + + v1.15 (05.10.2006): + * Fixed end-of-message handling. Qmail should work now too. + + v1.50 (05.11.2006): + * ExchangeUser propertry not used anymore. fetchExc should be able to + find correct path without. + * Proxy support added. Check ProxyHost and ProxyPort properties. + NOTE!!! Haven't for proxying to work with Secure=true (SSL/TLS) + + v2.0 (27.03.2007): + * Java changed from 1.4 to 1.5. + * Httpclient upgraded from 2.0 to 3.0. This makes https through proxy + to work. + * Code cleanups. + * Small fix in mbox saving. Added: trunk/fetchexc/debian/compat =================================================================== --- trunk/fetchexc/debian/compat (rev 0) +++ trunk/fetchexc/debian/compat 2007-08-27 12:20:45 UTC (rev 4067) @@ -0,0 +1 @@ +5 Added: trunk/fetchexc/debian/control =================================================================== --- trunk/fetchexc/debian/control (rev 0) +++ trunk/fetchexc/debian/control 2007-08-27 12:20:45 UTC (rev 4067) @@ -0,0 +1,22 @@ +Source: fetchexc +Section: net +Priority: optional +Maintainer: Ted Percival <[EMAIL PROTECTED]> +Build-Depends: cdbs, debhelper (>= 4.0.0), dpatch, ant +Build-Depends-Indep: libcommons-httpclient-java, xsltproc, + docbook-xsl, java-gcj-compat-dev +Standards-Version: 3.7.2.2 +XS-Vcs-Hg: http://hg.midg3t.net/fetchexc-debian +XS-Vcs-Browser: http://hg.midg3t.net/fetchexc-debian + +Package: fetchexc +Architecture: all +Depends: libcommons-httpclient-java, + libcommons-logging-java, libcommons-codec-java, + gij | sun-java6-jre | sun-java5-jre, + ${misc:Depends} +Description: Fetches email from Microsoft Exchange servers + FetchExc retrieves emails using WebDAV (Outlook Web Access) and + delivers it to an SMTP server or local mbox store. + . + Homepage: http://personal.inet.fi/atk/fetchexc/ Added: trunk/fetchexc/debian/copyright =================================================================== --- trunk/fetchexc/debian/copyright (rev 0) +++ trunk/fetchexc/debian/copyright 2007-08-27 12:20:45 UTC (rev 4067) @@ -0,0 +1,27 @@ +This package was debianised by Ted Percival <[EMAIL PROTECTED]> on +Thu, 18 May 2006 19:01:56 +1000. + +It was downloaded from http://personal.inet.fi/atk/fetchexc/ + +Copyright 2004, 2005, 2006 Juhani Rautiainen <[EMAIL PROTECTED]> +Copyright 2005 Robert Clark + +License: + + This package is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This package is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this package; if not, write to the Free Software + Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA + +On Debian systems, the complete text of the GNU General +Public License can be found in `/usr/share/common-licenses/GPL'. + Added: trunk/fetchexc/debian/dirs =================================================================== --- trunk/fetchexc/debian/dirs (rev 0) +++ trunk/fetchexc/debian/dirs 2007-08-27 12:20:45 UTC (rev 4067) @@ -0,0 +1 @@ +/usr/bin Added: trunk/fetchexc/debian/docs =================================================================== --- trunk/fetchexc/debian/docs (rev 0) +++ trunk/fetchexc/debian/docs 2007-08-27 12:20:45 UTC (rev 4067) @@ -0,0 +1 @@ +debian/README.html Added: trunk/fetchexc/debian/manpage.xml =================================================================== --- trunk/fetchexc/debian/manpage.xml (rev 0) +++ trunk/fetchexc/debian/manpage.xml 2007-08-27 12:20:45 UTC (rev 4067) @@ -0,0 +1,379 @@ +<?xml version='1.0' encoding='UTF-8'?> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" +"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"; [ + +<!-- + +Process this file with an XSLT processor: `xsltproc \ +-''-nonet /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/\ +manpages/docbook.xsl manpage.dbk'. A manual page +<package>.<section> will be generated. You may view the +manual page with: nroff -man <package>.<section> | less'. A +typical entry in a Makefile or Makefile.am is: + +DB2MAN=/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/\ +manpages/docbook.xsl +XP=xsltproc -''-nonet + +manpage.1: manpage.dbk + $(XP) $(DB2MAN) $< + +The xsltproc binary is found in the xsltproc package. The +XSL files are in docbook-xsl. Please remember that if you +create the nroff version in one of the debian/rules file +targets (such as build), you will need to include xsltproc +and docbook-xsl in your Build-Depends control field. + +--> + + <!ENTITY dhfirstname "<firstname>Ted</firstname>"> + <!ENTITY dhsurname "<surname>Percival</surname>"> + <!-- Please adjust the date whenever revising the manpage. --> + <!ENTITY dhdate "<date>2006-06-25</date>"> + <!ENTITY dhsection "<manvolnum>1</manvolnum>"> + <!ENTITY dhemail "<email>[EMAIL PROTECTED]</email>"> + <!ENTITY dhusername "Ted Percival"> + <!ENTITY dhucpackage "<refentrytitle>FETCHEXC</refentrytitle>"> + <!ENTITY dhpackage "fetchexc"> + + <!ENTITY debian "<productname>Debian</productname>"> + <!ENTITY gnu "<acronym>GNU</acronym>"> + <!ENTITY gpl "&gnu; <acronym>GPL</acronym>"> + <!ENTITY propfile "<filename>fetchExc.properties</filename>"> +]> + +<refentry> + <refentryinfo> + <address> + &dhemail; + </address> + <author> + &dhfirstname; + &dhsurname; + </author> + <copyright> + <year>2006</year> + <holder>&dhusername;</holder> + </copyright> + &dhdate; + </refentryinfo> + <refmeta> + &dhucpackage; + + &dhsection; + </refmeta> + <refnamediv> + <refname>&dhpackage;</refname> + <refpurpose>program to retrieve email from Microsoft Exchange servers via WebDAV</refpurpose> + </refnamediv> +<!-- Uncommenting this leads to the fetchexc.1 manpage being empty. Pity. + <refnamediv> + <refname>&propfile;</refname> + <refpurpose>fetchExc configuration file</refpurpose> + </refnamediv> +--> + <refsynopsisdiv> + <cmdsynopsis> + <command>&dhpackage;</command> + + <arg><option>-p <filename>property-file</filename></option></arg> + + </cmdsynopsis> + </refsynopsisdiv> + <refsect1> + <title>DESCRIPTION</title> + + <para><command>&dhpackage;</command> fetches + emails from Outlook Web Access using the WebDAV protocol. Its + configuration is read from a properties file called + <filename>fetchExc.properties</filename>. The properties file should be in the + current directory, otherwise in the location specified with + the <option>-p</option> option. + </para> + + </refsect1> + <refsect1> + <title>OPTIONS</title> + + <variablelist> + <varlistentry> + <term><option>-p</option> + </term> + <listitem> + <para>Specify the preferences file to use, rather than the + default of <filename>fetchExc.properties</filename> in + the current directory.</para> + </listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>CONFIGURATION</title> + + <para>The configuration file format is <userinput>key = value</userinput>. + 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.</para> + + <para>A description of each configuration option is given below.</para> + + <variablelist> + + <varlistentry> + <term><option>All</option></term> + <listitem> + <para> + Retrieve all messages, rather than only unread messages. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>Delete</option></term> + <listitem> + <para> + Deletes messages after retrieving them. Otherwise messages are + marked read and left in the Inbox. + </para> + + <warning> + <para> + Don't combine <userinput>Delete = false</userinput> and + <userinput>All = true</userinput> if you are not testing. That + will fetch every message from your Inbox every time you run + fetchExc. + </para> + </warning> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>Destination</option></term> + <listitem> + <para> + 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. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>DestinationAddress</option></term> + <listitem> + <para> + The address of the recipient for retrieved emails. If <option>MboxFile</option> is + defined this option is ignored. If <option>ProcMail</option> is + <replaceable class="parameter">true</replaceable> + this is the program to use for sending mail, for example + <replaceable class="parameter"><command>/usr/bin/procmail</command></replaceable>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>Domain</option></term> + <listitem> + <para> + NetBIOS domain name, for instance <userinput>YOYODYNE</userinput> if your NetBIOS login is + <userinput>YOYODYNE\Joe.User</userinput>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>ExchangeServer</option></term> + <listitem> + <para> + The web server to retrieve messages from, for example + <replaceable class="parameter">webmail.example.com</replaceable>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>ExchangePath</option></term> + <listitem> + <para>The path to Outlook Web Access. Usually + <userinput>exchange</userinput>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>ExchangeUser</option></term> + <listitem> + <para>The Exchange mailbox name, not necessarily the same as + the <option>Username</option> option.</para> + </listitem> + </varlistentry> + + <para>The three Exchange options are used to form the web-access + URI of the form + <uri>http<replaceable>s</replaceable>://<replaceable>ExchangeServer</replaceable>/<replaceable>ExchangePath</replaceable>/<replaceable>ExchangeUser</replaceable></uri>.</para> + + <varlistentry> + <term><option>FBApath</option></term> + <listitem> + <para> + Login page for form-based authentication. The default is + <replaceable class="parameter">/exchweb/bin/auth/owaauth.dll</replaceable>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>ForceFrom</option></term> + <listitem> + <para>If this is set to true forwarded mail will be forwarded with + the address from <option>ForceFromAddr</option>. This only happens + when the sender address is invalid, for example if there are two + From headers Exchange sometimes joins them.</para> + + <note><para> + This could lead to more spam getting through. + </para></note> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>ForceFromAddr</option></term> + <listitem> + <para> + Email address that the forwarding server will accept. + Only used if <option>ForceFrom</option> is <replaceable class="parameter">true</replaceable>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>MailServer</option></term> + <listitem> + <para> + SMTP server to forward messages to. This option is not used if + <option>MboxFile</option> is set. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>MboxFile</option></term> + <listitem> + <para> + mbox file to store mail in. This disables the <option>MailServer</option> + and <option>DestinationAddress</option> options. + </para> + + <warning> + <para>mbox file locking is not yet well-tested. Use this option with caution.</para> + </warning> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>NoEightBitMime</option></term> + <listitem> + <para> + Setting to <replaceable class="parameter">true</replaceable> disables eight-bit + MIME with SMTP forwarding. The default is <replaceable class="parameter">false</replaceable>. + </para> + + <para> + Enabling this option can help if the following error occurs: + <literallayout> + <errortext> + From: <[EMAIL PROTECTED]> wasn't valid + MAIL FROM error status=501 + Message 1 not sent + </errortext> + </literallayout> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>Password</option></term> + <listitem> + <para>Password for authentication with the Exchange server.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>ProcMail</option></term> + <listitem> + <para> + If <replaceable class="parameter">true</replaceable> the program + in <option>DestinationAddress</option> is used to send email. + The default is <replaceable class="parameter">false</replaceable>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>Secure</option></term> + <listitem> + <para> + Uses HTTPS when set to <replaceable class="parameter">true</replaceable>. + This should be enabled whenever possible. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>Username</option></term> + <listitem> + <para> + Username for authentication with the Exchange server. Not + necessarily the same as the <option>ExchangeUser</option> option. + </para> + </listitem> + </varlistentry> + + </variablelist> + </refsect1> + + <refsect1> + <title>EXAMPLES</title> + <example label="1"> + <title>Configuration file for SMTP forwarding</title> + + <literallayout> + ExchangeServer = webmail.example.com + ExchangePath = exchange + ExchangeUser = Joe.User + MailServer = mail.example.net + DestinationAddress = [EMAIL PROTECTED] + Username = juser + Password = secret + Domain = YOYODYNE + Delete = false + All = false + Secure = true + NoEightBitMime = true + </literallayout> + + </example> + </refsect1> + + <refsect1> + <title>AUTHOR</title> + + <para>fetchExc is primarily the work of Juhani Rautiainen + <uri>http://personal.inet.fi/atk/fetchexc/</uri>.</para> + + <para>This manual page was written by &dhusername; &dhemail; 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. + </para> + <para> + On Debian systems, the complete text of the GNU General Public + License can be found in /usr/share/common-licenses/GPL. + </para> + + </refsect1> +</refentry> +<!-- + vim:ts=2:et:sw=2 +--> Added: trunk/fetchexc/debian/patches/001_build_changes.dpatch =================================================================== --- trunk/fetchexc/debian/patches/001_build_changes.dpatch (rev 0) +++ trunk/fetchexc/debian/patches/001_build_changes.dpatch 2007-08-27 12:20:45 UTC (rev 4067) @@ -0,0 +1,64 @@ +#! /bin/sh /usr/share/dpatch/dpatch-run +## build_changes.dpatch by <[EMAIL PROTECTED]> +## +## All lines beginning with `## DP:' are a description of the patch. +## DP: Changes to allow the library to be built for Debian + [EMAIL PROTECTED]@ + +--- ../build.xml 2007-03-28 02:35:01.000000000 +1000 ++++ ../build.xml 2007-08-05 17:49:42.000000000 +1000 +@@ -2,43 +2,36 @@ + <!-- build file for fetchExc --> + <project name="fetchExc" default="build" basedir="."> + +- <property name="lib" value="lib"/> +- <property name="jarname" value="fetchExc.jar"/> ++ <property name="destdir" value="debian/fetchexc/usr/share/java"/> + <property name="classpath" value="classes"/> +- <property name="include" value="include"/> ++ <property name="include" value="/usr/share/java"/> + <property name="src" value="."/> + <property name="build" value="build"/> +- <property name="version" value="1.00"/> ++ <property name="version" value="unknown"/> ++ <property name="jarname" value="fetchexc-${version}.jar"/> + + <target name="init"> + <mkdir dir="${build}"/> +- <mkdir dir="${lib}"/> + </target> + +- <target name="compile"> ++ <target name="build" depends="init"> + <javac srcdir="${src}" destdir="${build}"> +- <classpath> +- <pathelement path="${classpath}"/> +- <!-- include all jar files --> +- <fileset dir="${include}"> +- <include name="**/*.jar"/> +- </fileset> +- </classpath> + <compilerarg value="-deprecation"/> + </javac> + </target> + +- <target name="build" depends="init,compile"> +- <jar jarfile="${lib}/${jarname}" basedir="${build}"> ++ <target name="dist" depends="init"> ++ <!-- really depends on build, but let the debian/rules file handle that --> ++ <mkdir dir="${destdir}"/> ++ <jar jarfile="${destdir}/${jarname}" basedir="${build}"> + <manifest> + <attribute name="Main-Class" value="fetchExc"/> +- <attribute name="Class-Path" value="commons-httpclient-3.0.1.jar commons-logging-1.1.jar commons-logging-api-1.1.jar commons-codec-1.3.jar"/> ++ <attribute name="Class-Path" value="commons-codec.jar commons-httpclient.jar commons-logging.jar commons-logging-api.jar"/> + </manifest> + </jar> + </target> + + <target name="clean"> + <delete dir="${build}"/> +- <delete dir="${lib}"/> + </target> + </project> Property changes on: trunk/fetchexc/debian/patches/001_build_changes.dpatch ___________________________________________________________________ Name: svn:executable + * Added: trunk/fetchexc/debian/patches/002_usr_bin_fetchexc.dpatch =================================================================== --- trunk/fetchexc/debian/patches/002_usr_bin_fetchexc.dpatch (rev 0) +++ trunk/fetchexc/debian/patches/002_usr_bin_fetchexc.dpatch 2007-08-27 12:20:45 UTC (rev 4067) @@ -0,0 +1,23 @@ +#! /bin/sh /usr/share/dpatch/dpatch-run +## 002_usr_bin_fetchexc.dpatch by Ted Percival <[EMAIL PROTECTED]> +## +## All lines beginning with `## DP:' are a description of the patch. +## DP: Creates a wrapper script ready for /usr/bin + [EMAIL PROTECTED]@ + +--- /dev/null Thu Jan 01 00:00:00 1970 +0000 ++++ ../src/fetchexc Mon Aug 06 21:18:53 2007 +1000 +@@ -0,0 +1,12 @@ ++#!/bin/sh ++set -e ++ ++for java in /usr/bin/gij /usr/lib/jvm/java-6-sun/bin/java \ ++ /usr/lib/jvm/java-1.5.0-sun/bin/java; do ++ if [ -x $java ]; then ++ exec $java -jar /usr/share/java/fetchexc.jar "$@" ++ fi ++done ++ ++echo "No suitable java program found" >&2 ++exit 1 Property changes on: trunk/fetchexc/debian/patches/002_usr_bin_fetchexc.dpatch ___________________________________________________________________ Name: svn:executable + * Added: trunk/fetchexc/debian/patches/00list =================================================================== --- trunk/fetchexc/debian/patches/00list (rev 0) +++ trunk/fetchexc/debian/patches/00list 2007-08-27 12:20:45 UTC (rev 4067) @@ -0,0 +1,2 @@ +001_build_changes +002_usr_bin_fetchexc Added: trunk/fetchexc/debian/rules =================================================================== --- trunk/fetchexc/debian/rules (rev 0) +++ trunk/fetchexc/debian/rules 2007-08-27 12:20:45 UTC (rev 4067) @@ -0,0 +1,61 @@ +#!/usr/bin/make -f +include /usr/share/cdbs/1/rules/debhelper.mk +include /usr/share/cdbs/1/class/ant.mk +include /usr/share/cdbs/1/rules/dpatch.mk + +# Version is everything before the first hyphen, taken from changelog +VERSION=$(shell dpkg-parsechangelog | grep ^Version | sed 's,^Version: \([^-]*\).*,\1,') +UPSTREAM_TGZ=http://personal.inet.fi/atk/fetchexc/fetchExc-src-$(VERSION).tar.gz + +DEB_ANT_ARGS = -Dversion=$(VERSION) -Dant.build.javac.source=1.5 +DEB_JARS = commons-codec commons-httpclient commons-logging commons-logging-api +DEB_ANT_BUILD_TARGET = build +DEB_ANT_INSTALL_TARGET = dist +DEB_DH_LINK_ARGS = /usr/share/java/fetchexc-$(VERSION).jar /usr/share/java/fetchexc.jar +DEB_INSTALL_CHANGELOGS_ALL = debian/changelog.upstream +DEB_INSTALL_DOCS_fetchexc = debian/README.html +DEB_INSTALL_MANPAGES_fetchexc = fetchexc.1 +DEB_PHONY_RULES = get-orig-source +JAVA_HOME = /usr/lib/jvm/java-gcj + +clean:: + rm -f fetchexc.1 fetchexc.1~ + +install/fetchexc:: + cp src/fetchexc debian/fetchexc/usr/bin/fetchexc + +binary-install/fetchexc:: + # CDBS doesn't know that README is just a copyright file + rm -f debian/fetchexc/usr/share/doc/fetchexc/README + +DB2MAN=/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/manpages/docbook.xsl +XP=xsltproc -''-nonet + +build/fetchexc:: fetchexc.1 + +fetchexc.1:: debian/manpage.xml + $(XP) $(DB2MAN) $< + mv fetchexc.1 fetchexc.1~ + # Remove duplicate AUTHORS section and + # Convert \240 (non-breaking space) to regular \040 space + # (seems to be caused by docbook.xsl outputting ISO-8859-1). + head -n-3 fetchexc.1~ | tr '\240' '\040' > $@ + rm -f fetchexc.1~ + +#### +## All the rules below here are intended for manual invocation. +#### + +get-orig-source:: + dh_testdir + # Remove any existing files that would get in the way + rm -rf fetchexc-$(VERSION) fetchExc-src-$(VERSION).tar.gz + wget $(UPSTREAM_TGZ) + tar -zxf fetchExc-src-$(VERSION).tar.gz + rm -f fetchExc-src-$(VERSION).tar.gz + # Remove unwanted files + rm -rf fetchExc/Apache-LICENSE.txt fetchExc/include + # Recreate archive + mv fetchExc fetchexc-$(VERSION) + tar -czf fetchexc_$(VERSION).orig.tar.gz fetchexc-$(VERSION) + rm -rf fetchexc-$(VERSION) Property changes on: trunk/fetchexc/debian/rules ___________________________________________________________________ Name: svn:executable + * Added: trunk/fetchexc/debian/watch =================================================================== --- trunk/fetchexc/debian/watch (rev 0) +++ trunk/fetchexc/debian/watch 2007-08-27 12:20:45 UTC (rev 4067) @@ -0,0 +1,3 @@ +# See uscan(1) for format +version=3 +http://personal.inet.fi/atk/fetchexc/ fetchExc-src-(.*)\.tar\.gz _______________________________________________ pkg-java-commits mailing list [email protected] http://lists.alioth.debian.org/mailman/listinfo/pkg-java-commits
![http://www.kati.fi/jrauti/stats.gif"](http://www.kati.fi/jrauti/stats.gif"){kind=link}