Spamlevel creates the configuration files to enable spam filtering for your mailbox. When enabled, the spam filtering system will deliver all messages classified as spam in a separate spambox, namely mail/INBOX.spam
spamlevel --help
spamlevel --level=lev [--rotate=rot]
spamlevel --show
--help prints a short help message
--level=lev sets the threshold for spam filtering.
The default level is 5. A lower value of lev will let less spam hit your mailbox, but will also increase the risk of False Positives. A higher value will further reduce the number of FPs, but more spam will hit your mailbox. At level 5 one can expect 0.05% to 0.2% of FPs, i.e. one message out of 500 to 2000 incorrectly classified as spam.
To disable spam filtering use --level=0
--rotate=rot will set the cleaning parameters for your spambox. If enabled, cleaning is performed overnight when the size of the spambox exceeds 1M.
--rotate=-1 will disable spambox cleaning.
--rotate=0 will simply empty the spambox when its size exceeds the threshold.
--rotate=n where n is any integer number greater than 0 will rotate up to n old spamboxes i.e. the old INBOX.spam will be moved to INBOX.spam.1, INBOX.spam.1 (if existent) will be moved to INBOX.spam.2 and so on; INBOX.spam.n will be dropped.
It is recommended that you use --rotate=1 (or greater) so that there is always a backup of the spam box (just in case...) and you avoid filling your disk quota with useless messages.
--show will parse your existing .procmailrc (if any) and figure out what is your current level of spam filtering. Please note that this assumes that your .procmailrc was created by spamleven itself. Inconsistent results may be reported if you edited your configuration.
The recommended usage is
spamlevel --level=5 --rotate=1