Q - How do I filter my mail ? - select the Filter your mail link on the User Utility Page and it will take you to the mail filter form. Here you can establish filters, delete filters and edit existing filters. All of this is done with the UNIX mail program - procmail. The form provided here lets you configure procmail a little easier than doing it via the command line. If you're a big shell user, please feel free to simply edit your .procmailrc file the old fashioned way via the shell. :-)

A quick look at the form

Note - Like it said in the form - filters are ignored if you have forwarding turned on. If you want to use filtering, you will need to turn forwarding off.

A mail filter for procmail is a rule that says - take all email that meets certain criteria and do something with it. Your choices of criteria to filter on and you choices of what to do with it are varied.

You can have multiple rules and procmail will look at each rule to find if any of them apply to the incoming email.

When you call up the filter email form, there is one form for each rule that you already have set - plus a blank form to add a new filter.

Q - How do I delete an existing filter ? - To delete an existing filter - just hit the Delete button on that filter. That filter will be deleted and the page will be redrawn without that filter.

Q - How do I modify an existing filter ? - To modify an existing filter - change the data to what you want for that filter and hit the Submit button for that filter. That filter will be modified and the page will be redrawn with the new version of that filter included.

Q - How do I create a new filter ? - To make a new filter - fill in the blank filter form at the bottom of the page and hit the Submit button for the new filter. The new filter will be added to the list and the page will be redrawn with the new filter and a new blank form at the bottom.

For all cases above - Remember to hit the button or nothing gets changed

Q - What do all the buttons do ?

End/Number - This button appears only on the new filter form at the bottom. It tells the utility where to put the new filter in order with the existing filters. Use this button to stick a new filter into your filter list at a particualr position. The position of a filter in the list can be important if you want more than one filter used against each message.

Comment - Hitting this button on the new filter form adds a blank comment line to your procmail filter set

Flags - These checkboxes set special flags in the new procmail rule

• Use a Copy.... - this flag causes procmail to make a copy of the mail message before performing any of the specified actions in the filter. This means the original message is left behind in your email box. This means if you have other filters set, they will be processed against the message as well.
• Case Sensitive - matches against the conditions you enter are not case sensitive unless you specify this flag
• Search Message Body this flag tells procmail to search the body of the message for text you specify

Condition - Select what condition you want to check for and enter any qualifying test in the box

And... - This button allows you to add multiple checks to a single rule

Action - Select what action you want procmail to take and enter any qualifying text in the box

Submit - After you have the form filled out the way you want it, hit the Submit button to make your changes take effect.
Remember to hit the button or nothing gets changed