Node: <copy>

Node: copy

<copy enabled="yes" createdir="yes" mail="yes" operation="overwrite" prepend="" append="">filename</copy>

Attributes:

enabled

yes
no

createdir

yes
no

mail

yes
no

operation

append
overwrite

prepend

Specify data to write to the destination file before the contents of the email are written

append

Specify the data to write to the destination file after the contents of the email are written

Notes

Writes information (typically a copy of the email content) to the filename specified. Use the filename as a template to describe the path and file name of the destination file.

If the destination directory does not exist and the createdir attribute is set to yes the directory is created.

Information can be written to the file before and after the email itself, and the email can optionally not be written (mail attribute) if it's desired just to use this as a method of writing text to a file. The information written can overwrite any existing file of the same name or can be appended to any existing contents of the destination file (operation attribute).

prepend and append data can include carriage return, line feed and tab characters using these character sequences:

\r		Carriage return
\n		Line feed (newline)
\t		Tab
\\		Single backslash

Macros are expanded in the filename and in the prepend and append attributes.

When the file is copied to an NTFS volume and the operation attribute is overwrite, additional information necessary to recreate the SMTP session is stored in an alternate stream of the file. This information includes the Client IP address, MAIL FROM and RCPT TO data. It is recommended that you utilize an NTFS volume if you plan to experiment with testing filters against captured email copies since this extra information is utilized in the filtering process.

Revision History:

- prepend and append require v2.0.23 or higher

- Multiple <copy> nodes is supported in v2.0.23 and higher

- mail and operation require v2.1.0 or higher