====== Quick & Dirty Exim Management ======
Below are some shell commands that can be used to manage Exim and it's email queue. The commands listed below must be run as root.

==== Managing Exim Itself ====

Start/Stop/Restart Exim
<sxh bash>/etc/init.d/exim start|stop|restart</sxh>

Print what Exim is doing right now
<sxh bash>exiwhat</sxh>

Test how exim will route a given email address
<sxh bash>exim -bt email@address.tld</sxh>

Generate and display Exim stats from a logfile
<sxh bash>eximstats /path/to/exim_mainlog</sxh>

Run a pretend SMTP transaction from the command line, as if it were coming from the given IP address. This will display Exim’s checks, ACLs, and filters as they are applied. Replace x.x.x.x with the IP you want to use as the source

<sxh bash>exim -bh x.x.x.x</sxh>

Display all of Exim’s configuration settings

<sxh bash>exim -bP</sxh>

==== Queue Information ====

Print a count of messages in the queue
<sxh bash>exim -bpc</sxh>

Print a listing of the messages in the queue (time queued, size, message-id, sender, recipient)
<sxh bash>exim -bp</sxh>

Print a summary of messages in the queue (count, volume, oldest, newest, domain, and totals)
<sxh bash>exim -bp | exiqsumm</sxh>

==== Searching the Queue ====

Search the queue for messages from a specific sender

<sxh bash>exiqgrep -f [user]@domain</sxh>

Search the queue for messages for a specific recipient/domain

<sxh bash>exiqgrep -r [user]@domain</sxh>

Print just the message-id as a result of one of the above two searches

<sxh bash>exiqgrep -i [ -r | -f ] ...</sxh>

Print a count of messages matching one of the above searches

<sxh bash>exiqgrep -c [ -r | -f ] ...</sxh>

Print just the message-id of the entire queue

<sxh bash>exiqgrep -i</sxh>

==== Viewing Messages In The Queue ====

View a message's headers:

<sxh bash>exim -Mvh <message-id></sxh>

View a message's body:

<sxh bash>exim -Mvb <message-id></sxh>

View a message's logs:

<sxh bash>exim -Mvl <message-id></sxh>

==== Queue Management ====

Start a queue run
<sxh bash>exim -q -v</sxh>

Start a queue run for just local deliveries
<sxh bash>exim -ql -v</sxh>

Remove a message from the queue
<sxh bash>exim -Mrm <message-id></sxh>

Remove all messages older than X seconds from the queue(for example 5 days would be 432000 seconds)
<sxh bash>exiqgrep -o 432000 -i | xargs exim -Mrm</sxh>

Freeze all queued mail from a sender
<sxh bash>exiqgrep -i -f email@address.tld | xargs exim -Mf</sxh>

View a queued message's header
<sxh bash>exim -Mvh <message-id></sxh>

View a queued message's body
<sxh bash>exim -Mvb <message-id></sxh>

View a queued message's log
<sxh bash>exim -Mvl <message-id></sxh>

Remove all messages from the queue (usually a bad idea)
<sxh bash>exiqgrep -i | xargs exim -Mrm </sxh>


{{tag>how-to exim smx}}