debian/rules: Use `git' potty wrapper.
[qmail] / debian / README.debian
CommitLineData
9312c29d
MW
1WARNING - WARNING - WARNING - WARNING - WARNING - WARNING
2
3 qmail does not support dot-locking internally.
4
5 You are in danger of losing mail if you re-configure
6 qmail without understanding the implications of this.
7
8WARNING - WARNING - WARNING - WARNING - WARNING - WARNING
9
10On Debian the standard location for a users mailbox is
11
12 /var/spool/mail/<username>
13
14and when programs write to that file they are expected to lock the
15file to prevent another process from accessing it at the same time, and
16thus corrupting your mail file.
17
18For reasons explained in /usr/doc/qmail/INSTALL.mbox, qmail does not do this.
19
20The default setup uses /usr/sbin/qmail-procmail to perform the final
21delivery of mail with apropriate dot-locking to prevent loss of mail.
22This is just a script that invokes procmail.
23
24You should not really need to invoke this as a user, but if you can
25think of a reason to do so, a line like this in your .qmail file will
26result in normal delivery via procmail:
27
28 |/usr/sbin/qmail-procmail
29
30If you were to instead put something like:
31
32 /var/spool/mail/phil
33
34in your .qmail file, it would deliver mail to that file, but would
35lock it using flock's rather than dot-lock's. Unless you know
36different, that would probably mean that every other program on the
37system would consider the file to be unlocked, and would leave you
38open to mail loss.
39
40Personally, I'd recommend moving to Maildir/ format if you can. Read
41the files in /usr/doc/qmail to find out more.
42
43---
44
45How the Debian setup differs from standard qmail setups:
46
47 The default setup sets aliasempty (i.e. the default delivery method)
48 to be /usr/sbin/qmail-procmail, which is a wrapper around procmail.
49
50 This results in delivery into /var/spool/mail.
51
52 To change this to one of the more standard qmail setups edit
53 /etc/init.d/qmail
54
55 The binaries normail found in /var/qmail/bin have been split between
56 /usr/bin and /usr/sbin.
57
58 The configuration files have been moved to /etc/qmail and the queue
59 has been moved to /var/spool/qmail.
60
61 Symbolic links have been placed in /var/qmail to make it look like a
62 normal qmail setup.
63
64Phil Hands <phil@hands.com>