tcpserver

qmail-inject

Commandlineparameters:[-qQvdDoOpPhHrR1][-climit][-bbacklog][-xrules.cdb][-ggid][-uuid][-llocalname][-ttimeout]
hostportprogram[arg...]EnvironmentVariables:
none

THEBIGQmailPICTURE
Version1.03forqmail1.03
Thispictureisintendedtogiveabroadoverviewofonhowallthesmallqmailprogramsfittogetherandtohavean
quickreferencehandy.Themanpagesoftheprogramsgivemoreinformationonhowthingsareworkingindetail.

Configurationfiles:
rules.cdb

qmail-smtpd
Commandlineparameters:
none
EnvironmentVariables:
PROTO(TCP)
TCPLOCALHOSTTCPLOCALIP
TCPLOCALPORTTCPREMOTEHOSTTCPREMOTEINFO
TCPREMOTEIP
TCPREMOTEPORTRELAYCLIENT
Configurationfiles:
badmailfrom
databytes
localiphost(me)rcpthosts
morercpthosts(cdbformat)
smtpgreeting(me)timeoutsmtpd(1200)

SMTPfromnetwork

fromlocal

Configurationfiles:
defaultdomain(me)defaulthost(me)idhost(me)plusdomain(me)qmail-send

tcpserver/
tcp-env/inetd

MUA

qmail-smtpd

qmail-inject

forwardedmessage

EnvironmentVariables:none

qmail-queue

qmail-send

qmail-lspawn
Commandlineparameters:
aliasempty
EnvironmentVariables:none

qmail-rspawn

qmail-lspawn

qmail-rspawn
qmail-remoteqmail-local

EnvironmentVariables:none

mbox/maildir/
programdelivery

Exitcodes:
0success
100permanenterror(bounce)
111softerror(retrylater)

qmail-remote

EnvironmentVariables:
none
Configurationfiles:
helohost(me)smtproutes
timeoutconnect(60)timeoutremote(1200)
Exitcodes:
always0andallerrorscome
backascleartext

R19980814

Configurationfiles:~users/cdb~bin/qmail-getpw
Exitcodes:
0success
100aliasemptymissing
111softerror(retrylater)
Mosterrorscomebackas
cleartext

qmail-local

Configurationfiles:
none

Commandlineparameters:
hostsender
recip[recip...]Configurationfiles:
bouncefrom(mailer-daemon)
bouncehost(me)concurrencylocal(10)concurrencyremote(20)doublebouncehost(me)doublebounceto(postmaster)
envnoathost(me)locals(me)percenthackqueuelifetime(604800)
virtualdomains
Remarks:
virtualdomainsarehandled
afterlocals

qmail-system

Commandlineparameters:noneCommandlineparameters:
none
EnvironmentVariables:none

qmail-queue

Exitcodes:
0success
11addresstoolong
51outofmemory
52timeout
53writeerror
54readerror
61problemwithqmailhomedir
62problemwithqueuedir
63problemwithqueue/pid
64problemwithqueue/mess65problemwithqueue/intd
66problemwithtodo
81internalbug,eg.segfault
91envelopeformaterror

EnvironmentVariables:
QMAILUSER
MAILUSER
USER
LOGNAME
QMAILHOST
MAILHOSTQMAILNAME
MAILNAME
NAME
QMAILINJECTQMAILDEFAULTDOMAINQMAILDEFAULTHOSTQMAILIDHOSTQMAILPLUSDOMAIN

remotemailserver

Commandlineparameters:none

Configurationfiles:
none

Commandlineparameters:[-nNaAhH][-fsender]
recip

remotemailserver

tolocalCommandlineparameters:
[-nN]
user
homedir
local
dash
ext
domainsenderaliasempty
EnvironmentVariables:
none.qmail
Content:#comment|programtoexecute&forwardingemailaddress./mailboxdelivertoMbox./maidir/delivertoMaildir
Exitcodesofprogram:0success
99successandabort.qmail
100permanenterror(bounce)
111softerror(retrylater)

Configurationfiles:~home/.qmail~alias/.qmail
Exitcodes:
0success
1fatalerror
2chdirerror
3SIGALRM
4tryunlinktmp()error
100permanenterror(bounce)
111softerror(retrylater)
Mosterrorscomebackas
cleartext

1998 by Andre Oppermann, opi@nrg4u.com, http://www.nrg4u.com. Free for personal use. Not free for commercial redistribution (eg. Magazines). Contact author for permission.

fromlocal
qmail-qmtpd
Commandlineparameters:
noneqmail-qmqpc
mini-qmail-system

EnvironmentVariables:
PROTO(TCP)
TCPLOCALHOSTTCPLOCALIP
TCPLOCALPORTTCPREMOTEHOSTTCPREMOTEINFO
TCPREMOTEIP
TCPREMOTEPORTRELAYCLIENT

MUA

Commandlineparameters:
none

EnvironmentVariables:
none

EnvironmentVariables:
PROTO(TCP)
TCPLOCALHOSTTCPLOCALIP
TCPLOCALPORTTCPREMOTEHOSTTCPREMOTEINFO
TCPREMOTEIP
TCPREMOTEPORT

Configurationfiles:
qmqpservers
Exitcodes:
exitsifnoqmqpserveris
reachable

qmail-inject

Remarks:
inamini-qmailinstallation
qmail-queueisreplacedwith
asymlinktoqmail-qmqpc

Configurationfiles:
databytes
rcpthosts
morercpthosts(cdbformat)

qmail-qmqpd

Commandlineparameters:none

Configurationfiles:
none
Exitcodes:
noneqmail-qmqpc
Remarks:receivesmailmessagesvia
theQuickMailTransfer
Protocol(QMTP)

Remarks:
willrelaymessagestoany
destination

QMQP (QuickMailQueueingProtocol)

QMTPfromnetwork(QuickMailTransportProtocol)

POP3fromnetwork

remotemailserver

remotemailclient

qmail-popup
Commandlineparameters:
hostname
subprogram[args...]EnvironmentVariables:none

tcpserver/
tcp-env/inetd

tcpserver/
tcp-env/inetd

MUA

tcpserver/
tcp-env/inetdConfigurationfiles:
none
Exitcodes:
allerrorscomebackasclear
text

qmail-qmtpd

qmail-qmqpd

qmail-inject

checkpassword

Remarks:
readsaPOPusernameand
passwordfromthenetwork

checkpassword
Commandlineparameters:
subprogram[args...]forwardedmessage

qmail-queue

qmail-pop3d

qmtp&qmqpenabledqmail-system

EnvironmentVariables:
none
Configurationfiles:
none
Exitcodes:
allerrorscomebackasclear
text

qmail-sendRemarks:receivesloginname,passwordandtimestampon
descriptor3fromqmail-popup

qmail-rspawn

qmail-lspawn

qmail-pop3d
Commandlineparameters:
maildirname

qmail-remoteqmail-local

EnvironmentVariables:
none
Configurationfiles:none

maildir

Exitcodes:
allerrorscomebackasclear
text
Remarks:
doesnotworkwithmboxfiles

remotemailserver

R19980814

tolocal1998 by Andre Oppermann, opi@nrg4u.com, http://www.nrg4u.com. Free for personal use. Not free for commercial redistribution (eg. Magazines). Contact author for permission.

dot-qmailprograms
bouncesaying

condredirect

Description:
bounceeachincoming
message(accordingtotheexit
valueof[program])

Description:
redirectmessagetoanotheraddressaccordingtotheexit
valueofprogram

Commandlineparameters:
in.qmail:|bouncesaying
error[program[arg...]]

Commandlineparameters:
in.qmail:|condredirect
newaddress
program[arg...]EnvironmentVariables:
none

EnvironmentVariables:
none

Configurationfiles:
none

Configurationfiles:
none

Exitcodesofprogram:0bounceandsayerror
111softerror(retrylater)
allothererrorsareignored
andtherestof.qmailwillbe
processedasusual

Exitcodesofprogram:0forwardtonewaddress
111softerror(retrylater)
allothererrorsareignored
andtherestof.qmailwillbe
processedasusual

prelineDescription:
prependUUCP-stylelines
Commandlineparameters:
in.qmail:|prelinecommand[-d](noDelivered-Toline)[-f](noFrom_line)[-r](noReturn-Pathline)

forward
Description:
forwardmessagetooneor
moreaddresses

Commandlineparameters:
in.qmail:|except
program[arg...]Commandlineparameters:
in.qmail:|forward
address...

EnvironmentVariables:
none

EnvironmentVariables:
none

Configurationfiles:
none

Configurationfiles:
none

Exitcodesofprogram:0exceptexits100
111softerror(retrylater)
allothererrorsareignored
andtherestof.qmailwillbe
processedasusual

Exitcodesofprogram:
none

qbiff

qlist

qreceipt

Description:
announcenewmessagethe
momentitarrives

Description:
handlemailinglistsubscription
requests

Description:
respondtodeliverynotice
requests

Commandlineparameters:
in.qmail:|qbiffCommandlineparameters:
in.qmail-list-request:|qlistreadmanpagefordetails

Commandlineparameters:
in.qmail:|qreceipt
youraddress

EnvironmentVariables:
none

EnvironmentVariables:
none

Configurationfiles:
none

Configurationfiles:
none

Exitcodes:
none

Exitcodes:
noneRemarks:
readmanpagefordetails

Remarks:
sendsasuccessnoticeback
totheenvelopesender

EnvironmentVariables:
none

EnvironmentVariables:
none

Configurationfiles:
none

Configurationfiles:
none

Exitcodes:
none

Exitcodesofprogram:none

Remarks:
writesamessagetoyour
screenwheneveranew
messageisdelivered

Remarks:
isusefulforprocmailand
ELM'sfilter

exceptDescription:
reversetheexitcodeofa
programuserlandprograms
maildirmake

maildirwatch

Description:
createsamaildirstructure

Description:
watchfornewmessagesina
maildir

Description:
movesmessagesfrommaildir
tomboxformat

Description:
sendamailmessagewitha
subjectline

Commandlineparameters:
youhavesosetthe
environment

Commandlineparameters:
youhavesosetthe
environment

Commandlineparameters:
subject
recip...

EnvironmentVariables:
MAILDIR

EnvironmentVariables:
MAILDIR
MAIL
MAILTMP

EnvironmentVariables:
none

Commandlineparameters:
directory
EnvironmentVariables:
none
Configurationfiles:
none
Exitcodes:
none

Configurationfiles:
none
Exitcodes:
noneRemarks:
printsanewmailsummarytwiceperminuteR19980814

maildir2mbox

Configurationfiles:
none
Exitcodes:
noneRemarks:
youshouldrunonlyone
maildir2mboxatatime

mailsubj

Configurationfiles:
none
Exitcodes:
noneRemarks:
readsthebodyofthe
messagefromitsstandard
input

1998 by Andre Oppermann, opi@nrg4u.com, http://www.nrg4u.com. Free for personal use. Not free for commercial redistribution (eg. Magazines). Contact author for permission.

queuemanagement
qmail-qstat

qmail-qread

Description:summarizestatusofmail
queue

Description:
listoutgoingmessagesandrecipients

Description:
printsqmail-remote'scurrent
listoftimeouts

qmail-tcpto

Description:erasesqmail-remote'scurrent
listoftimeouts

Commandlineparameters:noneCommandlineparameters:noneCommandlineparameters:noneCommandlineparameters:
none

EnvironmentVariables:
none

EnvironmentVariables:
none

EnvironmentVariables:
none

EnvironmentVariables:
none

Configurationfiles:
none

Configurationfiles:
none

Configurationfiles:
none

Configurationfiles:
none

Exitcodes:
complainsifthereisaproblem

Exitcodes:
complainsifthereisaproblem

Exitcodes:
complainsifthereisaproblem

Exitcodes:
complainsifthereisaproblem

Remarks:
mustberuneitherasrootor
withgidqmail

Remarks:
mustberuneitherasrootor
withuidqmailsandgidqmailRemarks:
mustberuneitherasrootor
withuidqmailrandgidqmail

Remarks:
mustberuneitherasrootor
withuidqmailrandgidqmail

Hint:torescheduleeverymessageinthequeueforimmediatedelivery,doa“kill-ALRM

qmail-tcpokpid”ontheqmail-sendpid

userandsystemmanagement
qmail-newmrh

qmail-showctl

Description:buildaddressassignments
fromapasswdfile

qmail-pw2u

Description:
prepareaddressassignments
forqmail-lspawn

Description:
preparemorercpthostsfor
qmail-smtpd

Description:
analyzetheqmailconfigfiles

Commandlineparameters:[-/ohHuUC][-cchar]Commandlineparameters:noneCommandlineparameters:
none

EnvironmentVariables:none

EnvironmentVariables:
none

EnvironmentVariables:
none

Configurationfiles:~users/include~users/exclude~users/mailnames~users/subusers~users/append

Configurationfiles:~users/assign

Configurationfiles:~control/morercpthosts

Exitcodes:
complainsifthereisaproblem
with~users/assignqmailnewu

Exitcodes:
complainsifthereisaproblem
withcontrol/morercpthosts
qmail-newmrhcomplains

Remarks:
generates~users/cdb

Remarks:
generates~control/morercpthosts.cdb

Exitcodes:
complainsifthereisaproblem

qmail-newu

Remarks:
generates~users/assign

Commandlineparameters:
none
EnvironmentVariables:
none
Configurationfiles:
all
Exitcodes:
complainsifthereisaproblem
Remarks:
explainsthecurrentqmail
configuration

otherqmaildaemons
qmail-start

qmail-clean

Description:
turnonmaildelivery

Description:cleanupthequeuedirectory

Commandlineparameters:
defaultdelivery
logger[args...]Commandlineparameters:
none

EnvironmentVariables:
none
Configurationfiles:
none
Exitcodes:
doesnotprintanything,even
onfailure
Remarks:
makesuretocleanupthe
environmentbeforestarting
qmail

R19980814

EnvironmentVariables:
none
Configurationfiles:
none
Exitcodes:
noneRemarks:
canonlybestartedby
qmail-start

sploggerDescription:readsaseriesofmessages
andfeedsthemtosyslog
Commandlineparameters:[tag[facility]]
EnvironmentVariables:
none
Configurationfiles:
none
Exitcodes:
complainsifthereisaproblem
Remarks:
convertsunprintablecharacterstoquestionmarks

1998 by Andre Oppermann, opi@nrg4u.com, http://www.nrg4u.com. Free for personal use. Not free for commercial redistribution (eg. Magazines). Contact author for permission.