@chapter Rspamd purposes and features.
-@node introduction
@section Introduction.
Rspamd filtering system is created as a replacement of popular
@code{spamassassin}
jobs among them now are implemented @code{LMTP} worker that implements
@code{LMTP} protocol for filtering mail and fuzzy hashes storage server.
-@node features
@section Features.
The main features of rspamd are:
@itemize @bullet
@chapter Installation of rspamd.
-@node obtaining
@section Obtaining of rspamd.
The main rspamd site is @url{http://rspamd.sourceforge.net/, sourceforge}. Here
shipped with all modules and sample config by default. But there are some
requirements for building and running rspamd.
-@node requirements
@section Requirements.
For building rspamd from sources you need @code{CMake} system. CMake is very
site}. Also for rspamc client you need @code{perl} interpreter that could be
installed from @url{http://www.perl.org}.
-@node building
@section Building and Installation.
Build process of rspamd is rather simple:
For @code{FreeBSD} system there also would be start script for running rspamd in
@emph{PREFIX/etc/rc.d/rspamd.sh}.
-@node running
@section Running rspamd.
Rspamd can be started by running main rspamd executable -
@noindent
After this command new xml config would be dumped to rspamd.xml file.
-@node signals
@section Managing rspamd with signals.
First of all it is important to note that all user's signals should be sent to
rspamd main process and not to its children (as for child processes these
@chapter Configuring of rspamd.
-@node principles
@section Principles of work.
We need to define several terms to explain configuration of rspamd. Rspamd
pause message's processing while waiting for some event. This is true for lua
modules as well.
-@node config structure
@section Rspamd config file structure.
Rspamd config file is placed in PREFIX/etc/rspamd.xml by default. You can
Each of these sections would be described further in details.
@section Rspamd configuration atoms.
-@node config atoms
There are several primitive types of rspamd configuration parameters:
@itemize @bullet
@item @var{<debug_ip>}
@tab List that contains ip addresses for which debugging would be turned on. For
-more information about ip lists look at @ref{config atoms}.
+more information about ip lists look at config atoms section.
@end multitable
@section Factors configuration.
my $result = $client->check($testmsg);
-if ($result->{'default'}->@{isspam@} eq 'True') @{
+if ($result->@{'default'@}->@{isspam@} eq 'True') @{
# do something with spam message here
@}
@end example
configuration options for modules indexed by module. This can be written this
way:
@example
-config['module_name'] = {}
+config['module_name'] = @{@}
local mconfig = config['module_name']
mconfig['option_name'] = 'option value'
@item @emph{symbol} (string): symbol to insert (default: 'R_FUZZY')
@item @emph{max_score} (double): maximum score to that weights of hashes would be
normalized (default: 0 - no normalization)
-@item @emph{fuzzy_map} (string): a string that contains map in format { fuzzy_key => [
-symbol, weight ] } where fuzzy_key is number of fuzzy list. This string itself
+@item @emph{fuzzy_map} (string): a string that contains map in format @{ fuzzy_key => [
+symbol, weight ] @} where fuzzy_key is number of fuzzy list. This string itself
should be in format 1:R_FUZZY_SAMPLE1:10,2:R_FUZZY_SAMPLE2:1 etc, where first
number is fuzzy key, second is symbol to insert and third - weight for
normalization