Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
BOGOTUNE(1)		   Bogofilter Reference Manual		     BOGOTUNE(1)

NAME
     bogotune - find optimum parameter settings for bogofilter

SYNOPSIS
     bogotune  [-v]  [-c config] [-C] [-d dir] [-D] [-r value] [-T value] -n ok-
	      file [[-n] okfile [...]]	       -s spamfile [[-s] spamfile [...]]
	      [-M file]

     bogotune [-h]

DESCRIPTION
     Bogotune  tries to find optimum parameter settings for bogofilter. It needs
     at least one set  each  of  spam  and  non-spam  messages.  The  production
     wordlist  is  normally  used,  but  it  can be directed to read a different
     wordlist, or to build its own from half the supplied messages.

     In order to produce useful results, bogotune has minimum message count  re-
     quirements.  The  wordlist  it uses must have at least 2,000 spam and 2,000
     non-spam in it and the message files must contain at least 500 spam and 500
     non-spam messages. Also, the ratio of spam to non-spam  should  be  in  the
     range  0.2  to 5. If you direct bogotune to build its own wordlist, it will
     use the half the input or 2000  messages  (whichever  is  larger)	for  the
     wordlist.

     Message  files  may  be  in mbox, maildir, or MH folder or any combination.
     Msg-count files can also be used, but not mixed with other formats.

OPTIONS
     The -h option prints the help message and exits.

     The -v option increases the verbosity level. Level 1 displays the scan out-
     put in detail instead of using a progress meter.

     The -c filename option tells bogofilter to read the config file named.

     The -C option prevents bogotune from reading a configuration file.

     The -d dir option specifies the directory for the database. See  the  ENVI-
     RONMENT section for other directory setting options.

     The  -D option tells bogotune to build a wordlist in memory using the input
     messages. The messages are read and divided  into	two  groups.  The  first
     group  is used to build a wordlist (in ram) and the second is used for tun-
     ing. To meet the minimum requirements of 2000 messages in the wordlist  and
     500  messages for testing, when -D is used, there must be 2500 non-spam and
     2500 spam in the input files. If  there  are  enough  messages  (more  than
     4000),  they  will be split evenly between wordlist and testing. Otherwise,
     they will be split proportionately.

     The -n option tells bogotune that the following  argument	is  a  file  (or
     folder) containing non-spam. Since version 1.0.3, multiple arguments to the
     -n  option  can be given. All non-option arguments until the next -s option
     will be treated as though they had been preceded by -n

     The -s option tells bogotune that the following  argument	is  a  file  (or
     folder)  containing  spam.  It can be repeated as often as necessary. Since
     version 1.0.3, multiple arguments to the -s can be  given.  All  non-option
     arguments	until the next -n option will be treated as though they had been
     preceded by -s.

     The -r value option tells bogotune to use the following  parameter  as  the
     robx value.

     The  -T  value  option  tells bogotune to use the following parameter as fp
     target value.

     The -M file option tells bogotune to convert the file to message count for-
     mat. This format provides a sorted list of each  message's  unique  tokens,
     along  with  their ham and spam counts. Sorting hides the sense of the mes-
     sages quite effectively, thus protecting privacy. The message-count  format
     allows  bogotune  and  bogofilter to score messages quickly without needing
     the original token database.

ENVIRONMENT
     Bogofilter uses a database directory, which can be set in the config  file.
     If not set there, bogofilter will use the value of BOGOFILTER_DIR. Both can
     be overridden by the -ddir option. If none of that is available, bogofilter
     will use directory $HOME/.bogofilter.

BUGS
     Bogotune is not particularly robust when presented with garbage input.

AUTHOR
     The bogofilter developer team.

     For updates, see the bogofilter project page[1].

SEE ALSO
     bogofilter(1), bogolexer(1), bogoupgrade(1), bogoutil(1)

NOTES
      1. the bogofilter project page
	 http://bogofilter.sourceforge.net/

Bogofilter			   05/19/2019			     BOGOTUNE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=bogotune&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help