msys.cloudmark.analyze
Name
msys.cloudmark.analyze — Analyze a message using Cloudmark
Synopsis
require('msys.cloudmark')
msys.cloudmark.analyze(hdr, msg, vctx)
hdr: string msg: userdata, ec_message type (optional) vctx: userdata, validate_context type (optional)
Description
This function analyzes the input string hdr
and returns a table of the following key/value pairs:
-
score
– Authority score for the message, a number between 0 and 100. The higher the number, the more certain the engine is that the mail is spam. -
is_spam
– If the cloudmark moduleMinimumScore
option is set, this flag is set for messages whose score exceedsMinimumScore
, indicating the engine has determined the message is spam. No action is directly taken on the message; that is left to the user to do using a policy script. -
category
– Category assigned to the message by the Cloudmark Authority -
category-desc
– Description of the category -
sub-category
– Sub-category assigned to the message by the Cloudmark Authority -
sub-category-desc
– Description of sub-category -
rescan
– rescan flag. If this flag is set toyes
, the email would benefit from a rescan. -
analysis
– Cloudmark Authority analysis header
If msg
or vctx
is not provided, they will be inferred from the current context. The above name value pairs are also set within the validation context (VCTX_MESS with cmae- as prefix) except analysis
.
For a listing of the available context variables, see “cloudmark – Cloudmark Authority® Content Scanning”. .
Warning
Do not use pcall
with this function.