CLI zmmsgtrace: Difference between revisions
mNo edit summary |
m (→ZCS 7 and 8) |
||
Line 5: | Line 5: | ||
=ZCS 7 and 8= | =ZCS 7 and 8= | ||
zmmsgtrace is available for versions 7.1.1 and above, and all releases of 8.x. | |||
===Syntax=== | ===Syntax=== | ||
Line 84: | Line 86: | ||
# this regex is more specific - recipient ending in "@example.com" | # this regex is more specific - recipient ending in "@example.com" | ||
$ zmmsgtrace -s '^p' -r '@example\.com$' /var/log/zimbra* | $ zmmsgtrace -s '^p' -r '@example\.com$' /var/log/zimbra* | ||
=ZCS 6.0= | =ZCS 6.0= |
Revision as of 08:46, 5 September 2013
Article Information |
---|
This article applies to the following ZCS versions. |
zmmsgtrace
This command is used to trace an email that was sent or received. So if you want to track a particular user's emails for the day, you can use this. It can filter emails by the sender's ID, recipient's ID, time, source host and/or destination host.
ZCS 7 and 8
zmmsgtrace is available for versions 7.1.1 and above, and all releases of 8.x.
Syntax
zmmsgtrace [options] [<mail-syslog-file>...]
Description
Long Name | Short Name | Description |
---|---|---|
--help | Shows the help for the usage options for this tool. | |
--id | -i | Message ID. Case sensitive regex. |
--sender | -s | Sender address. Case insensitive regex. |
--recipient | -r | Recipient address. Case insensitive regex. |
--srchost | -F | Source host, using hostname or IP. Case insensitive regex. |
--desthost | -D | Destination host, using hostname or IP. Case insensitive regex. |
--time | -t | Start, end times in YYYYMM[DD[HH[MM[SS]]]] format |
--year | File year if no YYYY in file | |
--nosort | Do not sort @ARGV files by mtime | |
--debug | Verbose output useful for debugging | |
--man | Display the entire man page. Contains useful examples. |
Examples
Show a trace of all messages in '/var/log/zimbra.log':
$ zmmsgtrace
Show a trace of all messages in '/var/log/zimbra.log' by sender matching the word 'phil':
$ zmmsgtrace -s phil
Show a trace of messages sent by 'phil.pearl' between '20130917' and '20130921' in '/var/log/zimbra.log.1.gz' and '/var/log/zimbra.log':
# note: a '.' (period) in a regex matches any character $ cd /var/log $ zmmsgtrace zimbra.log.1.gz zimbra.log \ -sender 'phil\.pearl' -srchost localhost -time 20130917,20130921
Find any email sent by an email address starting with 'p' to anyone at 'example.com' in all files matching /var/log/zimbra*:
# note: this regex can match more than desired! $ zmmsgtrace -s '^p' -r '@example.com' /var/log/zimbra*
# this regex is more specific - recipient ending in "@example.com" $ zmmsgtrace -s '^p' -r '@example\.com$' /var/log/zimbra*
ZCS 6.0
- 6.0 does not have the CLI zmmsgtrace
ZCS 5.0
Syntax
zmmsgtrace {-i|-s|-r|-F} <message_id>
Description
Long Name | Short Name | Description |
---|---|---|
--help | -h | Shows the help for the usage options for this tool. |
-i | Message ID. | |
-s | Sender address. | |
-r | Recipient address. | |
-F | From Times in YYYYMMDD (hhmmss) format. | |
-D | dest_ip/host | |
-t | start, end times in YYYYMMDD (hhmmss) format |
ZCS 4.5
Related Articles