aboutsummaryrefslogtreecommitdiffstats
path: root/contrib/README.getmail
blob: 237889cd86d5ffda44646eaa36e5dbbc34464ac1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
-------------------------------------------------------------------------------

                         - GetMail - GotMail -

             1999 by Thomas Nesges <ThomaNesges@TNT-Computer.de>

-------------------------------------------------------------------------------

-------------------------------------------------------------------------------
Installation:
-------------------------------------------------------------------------------
The Installation is as simple as it could be.  Just create the directory
/usr/local/gotmail and copy all files to it. Ready.

If you decide to choose an other directory to copy the files to, don't forget
to change the path in the scripts.

-------------------------------------------------------------------------------
Usage:
-------------------------------------------------------------------------------
GetMail starts with: getmail <option>

options:
 clear  - stops fetchmail and kills the logfile
 fetch  - starts fetchmail
 got    - starts gotmail
 goth   - starts gotmail html
 send   - sends all mail from the mailqueue
 status - tails the logfile
 start  - starts fetchmail and tails the logfile
 stop   - stops fetchmail
 -v     - prints GetMails version number

GotMail can be startet without any parameters. It then prints a statistic
on the console. The only parameters so far are:

 html   - prints the output to an html file specified in gotmail.conf
 -v     - prints GotMails version number

-------------------------------------------------------------------------------
Configuration
-------------------------------------------------------------------------------
GotMail is configured by a file named gotmail.conf either in the user's home
dir, in /etc or in /usr/local/gotmail. gotmail.conf itself is a shell script.
It just exports some variables to the environment. So it's syntax is like this:

 export <OPTION>=<VALUE>

Remember not to put spaces between <OPTION>=<VALUE> !!
You have the folllowing options:
 
  GOTM_ERR	yes|no		print error messages?
  GOTM_MSG	yes|no		print mail stats?
  GOTM_TIM	yes|no		print start/stop stats?
  GOTM_HED	yes|no		print a header?

 Special HTML options:
  GOTM_BGCOL	hex color	backgroundcolor
  GOTM_TXCOL	hex color	textcolor
  GOTM_ERRCOL	hex color	color of error messages
  GOTM_TIMCOL	hex color	color of start/stop stats
  GOTM_MSGCOL	hex color	color of mail stats
  GOTM_HTMLFILE	filename	filename for html output
-------------------------------------------------------------------------------
$1; } elsif (/^$/) { # An empty line marks the end of the headers. last; } } # If we didn't find a Boundary declaration just pipe the rest of the # message unchanged. if (!defined $decltag) { while (<STDIN>) { print; } exit 0; } # Substitute $decltag for every ocurrence of an outer-level boundary # string found in the body of the message. my $usedtag; while (<STDIN>) { if (/^--(.*)$/) { $usedtag = $1 unless defined $usedtag; if ($1 eq $usedtag) { $_ = "--$decltag\n"; } elsif ($1 eq "$usedtag--") { $_ = "--$decltag--\n"; } } print; } =pod This script can be used to bypass a bug in the Domino-5.0.2b IMAP service that manifests itself when you use fetchmail as the IMAP client. The problem is that fetchmail (differently from other IMAP clients) fetches messages in two parts, first the headers and then the body. It seems that Domino converts the messages from its internal format into MIME twice. In doing so, it declared a boundary string in the messages Content-type header and uses another one to separate the parts in the body. This script should be used as a mda option for fetchmail. As arguments to it, pass the former mda you used. I, for example, use the following entry in my .fetchmailrc: poll server ... mda "/usr/bin/procmail -d %T"; To use this filter, I changed the above into the following: poll server ... mda "/home/gustavo/bin/correct-domino-mime-conversion /usr/bin/procmail -d %T"; If you do not use a mda normally, you can try the following to call sendmail directly: poll server ... mda "/home/gustavo/bin/correct-domino-mime-conversion //wherever/is/your/sendmail -oem -f %F %T"; Without argumets this script is a filter that reads from its stdin and outputs the result into its stdout. I should mention that this bug seems to be solved in Domino 5.0.3 (http://www.notes.net/46dom.nsf/434e319a66960d8385256857005cd97b/4499e0db6e43732b852568b2006ef7e9?OpenDocument) but I have not checked it. Gustavo. <gustavo@cpqd.com.br> =cut