EXIM Cheatsheet

This forum is for the posting and reading of tutorials.
Post Reply
User avatar
kheny22
Apprentice
Posts: 8
Joined: Fri May 01, 2020 8:37 pm

EXIM Cheatsheet

Post by kheny22 »

Basic information

Print a count of the messages in the queue:

Code: Select all

# exim -bpc
Print a listing of the messages in the queue (time queued, size, message-id, sender, recipient):

Code: Select all

# exim -bp
Print a summary of messages in the queue (count, volume, oldest, newest, domain, and totals):

Code: Select all

# exim -bp | exiqsumm
Print what Exim is doing right now:

Code: Select all

# exiwhat
Test how exim will route a given address:

Code: Select all

# exim -bt alias@localdomain.com user@thishost.com router = localuser, transport = local_delivery
# exim -bt user@thishost.com user@thishost.com router = localuser, transport = local_delivery
# exim -bt user@remotehost.com router = lookuphost, transport = remote_smtp host mail.remotehost.com [1.2.3.4] MX=0
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. The message will NOT actually be delivered.

Code: Select all

# exim -bh 192.168.11.22
Display all of Exim's configuration settings:

Code: Select all

# exim -bP
Searching the queue with exiqgrep
Exim includes a utility that is quite nice for grepping through the queue, called exiqgrep. Learn it. Know it. Live it. If you're not using this, and if you're not familiar with the various flags it uses, you're probably doing things the hard way, like piping `exim -bp` into awk, grep, cut, or `wc -l`. Don't make life harder than it already is.

First, various flags that control what messages are matched. These can be combined to come up with a very particular search.

Use -f to search the queue for messages from a specific sender:

Code: Select all

# exiqgrep -f [luser]@domain
Use -r to search the queue for messages for a specific recipient/domain:

Code: Select all

# exiqgrep -r [luser]@domain
Use -o to print messages older than the specified number of seconds. For example, messages older than 1 day:

Code: Select all

# exiqgrep -o 86400 [...]
Use -y to print messages that are younger than the specified number of seconds. For example, messages less than an hour old:

Code: Select all

# exiqgrep -y 3600 [...]
Use -s to match the size of a message with a regex. For example, 700-799 bytes:

Code: Select all

# exiqgrep -s '^7..$' [...]
Use -z to match only frozen messages, or -x to match only unfrozen messages.

There are also a few flags that control the display of the output.

Use -i to print just the message-id as a result of one of the above two searches:

Code: Select all

# exiqgrep -i [ -r | -f ] ...
Use -c to print a count of messages matching one of the above searches:

Code: Select all

# exiqgrep -c ...
Print just the message-id of the entire queue:

Code: Select all

# exiqgrep -i
Managing the queue

The main exim binary (/usr/sbin/exim) is used with various flags to make things happen to messages in the queue. Most of these require one or more message-IDs to be specified in the command line, which is where `exiqgrep -i` as described above really comes in handy.

Start a queue run:

Code: Select all

# exim -q -v
Start a queue run for just local deliveries:

Code: Select all

# exim -ql -v
Remove a message from the queue:

Code: Select all

# exim -Mrm <message-id> [ <message-id> ... ]
Freeze a message:

Code: Select all

# exim -Mf <message-id> [ <message-id> ... ]
Thaw a message:

Code: Select all

# exim -Mt <message-id> [ <message-id> ... ]
Deliver a message, whether it's frozen or not, whether the retry time has been reached or not:

Code: Select all

# exim -M <message-id> [ <message-id> ... ]
Deliver a message, but only if the retry time has been reached:

Code: Select all

# exim -Mc <message-id> [ <message-id> ... ]
Force a message to fail and bounce as "cancelled by administrator":

Code: Select all

# exim -Mg <message-id> [ <message-id> ... ]
Remove all frozen messages:

Code: Select all

# exiqgrep -z -i | xargs exim -Mrm
Remove all messages older than five days (86400 * 5 = 432000 seconds):

Code: Select all

# exiqgrep -o 432000 -i | xargs exim -Mrm
Freeze all queued mail from a given sender:

Code: Select all

# exiqgrep -i -f luser@example.tld | xargs exim -Mf
View a message's headers:

Code: Select all

# exim -Mvh <message-id>
View a message's body:

Code: Select all

# exim -Mvb <message-id>
View a message's logs:

Code: Select all

# exim -Mvl <message-id>
Add a recipient to a message:

Code: Select all

# exim -Mar <message-id> <address> [ <address> ... ]
Edit the sender of a message:

Code: Select all

# exim -Mes <message-id> <address>

Post Reply