Script Return Codes, Return code for modified messages

Hi
I wrote my own spamassassin script in PHP,
and set the return code to 5 if the message is spam,
this seemed to work, until i checked the Frozen queues and noticed
all the spam hanging out in there.

Can someone guide me on the return codes? the Docs are a bit confusing:

if I modify the message it says I must return 7, but what if I want to reject
the message without freezing it, would the return code be 4 or 11 ?

What do return codes 1 - 3 do ? anything?

-BizOdd

>reject the message without freezing it, would the return code be 4 or 11 ?
This requires code 4, because rejecting is not a modification. The file is not saved and picked up by the queue scheduler again. It is just thrown away.

>What do return codes 1 - 3 do ? anything?
Only 0,4,5,6,7 and 16 are currently relevant. You should not return 1,2 or 3 because they might become relevant in future.

Thanks Harald, 4 seems to have done the trick.

FYI: the file was infact modified by spamassassin but i guess thats irrelevant
if it just deletes it.

Do you happen to have a list of what the relevant return codes do?

this is what ive worked out from the manual:
0 = ?
4 = reject and do not freeze
5 = reject but freeze
6 = reject (?)
7 = file was modified,deliver it.
16 = Stop filtering this email.

and, if i understand the manual, your supposed to combine return codes
but i dont see when that might apply.

thanks for your insight
-BizOdd

>FYI: the file was infact modified by spamassassin but i guess thats irrelevant if it just deletes it.
Exactly!

Returncodes:
0 = Let the message pass the filter unmodified
4 = Reject and do not freeze
5 = Reject and freeze
6 = Reject and freeze with sender notification
7 = Deliver the modified file

Additional Filter Flags:
16 = Stop all other filters after this one.

It only makes sense to add 16 to other return codes in order to signal that other filters should be stopped after this one has finished. That's why they are called filter flags in the manual. Currently there is only one single flag defined.

Keep in mind that code 0 or 7 submit the file to the next filter if not stopped by setting the stop flag (+16).