D. J. Bernstein
Frequently asked questions
How to solve problems
What should I do if I have trouble with qmail?
Read the documentation!
Most questions are answered by
Your system includes a wide variety of monitoring tools
to show you what qmail is doing:
- this list of frequently asked questions;
which show how qmail handles various types of messages;
- the other how-to pages in /var/qmail/doc; and
- the qmail manual pages in /var/qmail/man/cat*.
If all else fails, you could try asking for help on the
qmail mailing list.
Your message should give complete answers
to the following three questions:
- the qmail log, as introduced in /var/qmail/doc/TEST.*;
- instcheck (in the qmail install directory),
which looks for installation problems;
- qmail-showctl, which explains your current configuration;
- dot-forward -n (if you have installed dot-forward),
which lets you see how a .forward file will be interpreted;
- fastforward -n (if you have installed fastforward),
which lets you see how a forwarding table will be interpreted;
- ps, which lets you see what processes are running;
- recordio (if you have installed ucspi-tcp) and tcpdump,
which let you see what data is flowing over a TCP connection; and
- a syscall tracing tool, trace or truss or strace or ktrace,
which lets you see exactly how a program is interacting with the system.
For checkpassword and other POP password checkers you should
instead try the
password mailing list.
For serialmail and other part-time-dialup questions you should
instead try the
serialmail mailing list.
- What exactly did you do?
- What exactly did the computer do?
- What exactly did you expect the computer to do?
Is there commercial support for qmail?
Yes. See www.qmail.org.
Where can I find technical information about Internet mail?
explains the Internet mail infrastructure.
explains the Simple Mail Transfer Protocol.
explains the Internet mail message header format.