||include||style.htm|| ||define((xbegin),minus(time,mul(7,86400)))|| ||define((xend),minus(time,mul(1,86400)))|| ||include||body.htm||

$$List of Archive rules$$ Note: Check out the new archive search interface!

||ifdef||vlist_message||

||vlist_message||

||endif|| ||ifdef||vlist_message2||

||vlist_message2||

||endif||
||include||table.htm|| $$To$$ $$From$$ $$From Or To$$ $$Subject$$ $$Owner$$ $$Archive Path$$ $$Max msg size$$ $$Archive size$$ $$Size in days$$ $$Early$$ $$TCPIP$$ ||begin_list|| search ||end_list||

$$To$$, $$From$$ $$and$$ $$Subject$$ $$are optional filter rules. eg To/From "*@adomain.com" or Subject "*important business*". Leaving a field blank is the same as "*"$$.
$$Archive path$$ $$is required and is the path on disk the archive is stored$$.
$$Max msg size$$, $$Archive size$$, $$Size in days$$ $$and$$ $$Early$$ $$are optional and modify the behaviour of your archive$$.

$$Notes$$:
- $$"From Or To"$$ $$use this to archive any email from or to the domain/user e.g. *@domain.name, this is needed because if you use the individual from/to rules then it would use a logical AND and would only archive messages from AND to the domain specified rather than from OR to...$$.
- $$PATH$$ $$The path MUST be unqiue, archives cannot share a path$$.
- $$Search$$ $$links to the archive search and extract page$$.
- $$Max msg size$$ $$is the maximum that will be logged per message. Any message larger than this will be truncated to this size in the archive. If not specified the default is 1mb$$.
- $$Archive size$$ $$and$$ $$Size in days$$ $$specify the "size" of the archive. If size in days is specified all old mail will be stored for this duration regardless of specified archive size, otherwise (or if fixed size is specified) the archive will be a fixed size rotating archive. If nothing is specified the default is a fixed size rotating archive of 20mb$$.
- $$Early$$ $$allows you to archive messages before they are passed to the virus or spam filters. This can be useful for unmodified message text as received by surgemail$$.
- $$The from field will also match the senders IP address eg From "1.2.3.*"$$
- $$To delete an entry set path to blank$$.
- $$Owner$$ $$specifies a local user who can read/browse this archive via the user self admin interface (e.g. a domain manager)$$.

- $$eg. to run a 5 year archive for a particular domain$$:
     $$fromorto=*@mydomain.com subject=* path=c:\archives\mydomain msgsize=100mb days=5years$$
$$beware though... 5 years of mail is a lot of mail, unless you have a very big disk you will probably want to move the archive files off your server periodically. Also you will probably want to increase g_archive_bucketsize$$.