CLI zmmsgtrace: Difference between revisions
m (→ZCS 7 and 8) |
No edit summary |
||
Line 1: | Line 1: | ||
{{Article Infobox|{{admin}}|{{ZCS 8.0}}|{{ZCS 7.0}}|{{ZCS 6.0}}|{{ZCS 5.0}}|{{ZCS 4.5}}}} | {{WIP}}{{Article Infobox|{{admin}}|{{ZCS 8.0}}|{{ZCS 7.0}}|{{ZCS 6.0}}|{{ZCS 5.0}}|{{ZCS 4.5}}}} | ||
==zmmsgtrace== | ==zmmsgtrace== |
Revision as of 14:40, 30 March 2015
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 8 and 7
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