PMDF User's Guide
UNIX Edition


Previous Contents Index

3.1 Mailbox Filter File

By default, you have no mailbox filters unless your system administrator has chosen to set them up for you. If mailbox filtering has been enabled for your account, when you use the web-based interface, a mailbox filter is created for you. Your mailbox filters are stored in a mailbox filter file. The location of that file is site-configurable. In most cases, that location is in a directory that is not directly accessible by non-privileged users, and all modifications to your mailbox filters are done using the web interface.

If your system administrator has set up your mailbox filter file to be accessible by you, you may create or modify the filter file using any text editor. The mailbox filter file is a text file containing commands in the SIEVE language with some extensions. See the System Manager's Guide, Chapter 16, for more information about SIEVE.

Warning

If you edit your mailbox filter file manually, you cannot use the web interface any longer. The web interface can only read filter files it has written itself. You can use the web interface to create an initial mailbox filter file, and then edit it manually, but not vice-versa.

3.1.1 Checking Your Changes

Note

After you have made changes to your mailbox filter file, it is important for you to verify that it is working correctly, especially if you have edited it manually. If your filter file is not working, for example if it has a syntax error, your mail delivery could be interrupted.

The easiest way to check your mailbox filter file is to send yourself mail. If your mail gets to your mailbox successfully, then there is nothing wrong with your filter file.

Your filter file can also be verified by your system administrator using the command:


# pmdf test -rewrite -filter <your-mailbox>


Previous Next Contents Index