Generates a listing of message files which have been marked as held. This listing is always generated from the imta/queue/ directory tree.
Available for both interactive and non-interactive modes.
held [-envelope] [-file_info | -nofile_info] [-total | -nototal] [-from=address] [-to=address] [-match=bool] [channel-name] |
The options for this sub-command are:
Option |
Description |
---|---|
-envelope |
Generates a listing which also contains envelope address information. |
-total | -nototal |
Generate size and count totals across all selected channels. |
-from=address and -to=address and -match=bool |
Lists only those messages with envelope From: or To: addresses matching the specified address. When both -from and -to are specified, a message is listed if either its envelope From: or To: addresses match the specified addresses. This corresponds to the -match=or option. Specify -match=and to list only messages matching both the specified From: and To: addresses. Use of -from or -to implies -envelope. |
-file_info | -nofile_info |
When the directory tree is scanned, each message file is opened to determine its size as measured in units of blocks (normally 1024 bytes). To suppress this behavior and speed up generation of the listing, specify -nofile_info. |
channel-name |
Restricts the listing to one or more channels. If the channel-name parameter is omitted, a listing is made for all channels. The channel-name parameter may contain the * and ? wildcard characters. |