The options for this command are:
Option |
Description |
---|---|
-content=substring -from=substring
-subject=substring -to=substring -domain_to=substring |
Specifies the substrings for which to search. Any combination of -content, -from, -subject, -to, and -domain_to may be specified. However, only one of each may be used. When a combination of such options is used, the -match option controls whether the options are interpreted as further restrictions (-match=AND) or as alternatives (-match=OR). The -domain_to option scans for frequently occurring envelope To: addresses. Identical to the -to option, except -domain_to looks at only the host.domain portion of the envelope To: address. |
-database |
Specifies that only message files identified by the queue cache is searched. |
-delete |
Deletes matching message files. |
-hold |
Holds matching message files. |
-directory_tree |
Searches all message files that are actually present in the channel queue directory tree. |
-ignore_zz |
Ignores queued message files with file names beginning with “ZZ”. This option may be used to scan only those message files which represent queued messages which have failed at least one delivery attempt. |
-match=keyword |
Controls whether a message file must contain all (-match=AND) or only one of (-match=OR) the specified substrings in order to be held or deleted. The default is -match=AND. |
-min_length=n |
Specifies the minimum length of the substring for which to search. By default, each substring must be at least 24 bytes long. Use the -min_length option to override this limit. |
-threads=n | -nothreads |
Accelerates the searching on multiprocessor systems by dividing the work amongst multiple, simultaneous running threads. To run n simultaneous searching threads, specify -threads=n. The value n must be an integer between 1 and 8. The default is -nothreads. |
-verbose | -noverbose |
Requests that the utility displays operation information (-verbose). The default is -noverbose. |
channel |
Specifies an MTA channel area to be searched for matching messages. The * or ? wildcard characters may be used in the channel specification. |