CLI zmmsgtrace

Article Information
This article applies to the following ZCS versions. ZCS 8.0 ZCS 7.0 ZCS 6.0

For the most recent information on this CLI, including syntax and description, see ZCS Administrator's Guide Network Edition > Appendix A Command-Line Utilities.

zmmsgtrace

This command is used to trace an email message that was sent or received.

ZCS 7 and 8

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

• ZCS Administrator's Guide Network Edition > Appendix A Command-Line Utilities > zmmsgtrace

Related Articles

• Finding messages