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

FreeBSD Manual Pages

  
 
  

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

NAME
     bogoupgrade - upgrades bogofilter database to current version

SYNOPSIS
     bogoupgrade     [-h]    -d directory    [-i input file]	[-o output file]
		 [-b path to bogoutil]

DESCRIPTION
     bogoupgrade is a command to upgrade bogofilter's databases from an old for-
     mat to the current format. Since the format of the database changes once in
     a while, the utility is designed to make the upgrade easy.

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

     The -d specifies the directory with the wordlists for converting. This  op-
     tion is used when converting from multiple, separate wordlists (spamlist.db
     and  goodlist.db  - containing spam and ham tokens, respectively) to a com-
     bined wordlist (wordlist.db) which contains both spam and ham tokens.

     The -i specifies the input file to be converted. It should be a  text  file
     containing  message  counts,  and possibly data. If there is no data in the
     text file, there should be a Berkeley DB file in the same directory as  the
     text file which contains the data.

     The -o specifies the output Berkeley DB file.

     The  -b  gives the path to the bogoutil command. It defaults to 'bogoutil',
     in the hopes that your shell will find it.

UPGRADING
     Follow these instructions to upgrade bogofilter's databases to  the  latest
     version.

       1. Stop	all  instances	of  bogofilter. While the upgrade tools lock the
	 database files, the upgrade may take a long time if  you  have  a  busy
	 site.	Don't forget to stop cron jobs or daemons that fetch and process
	 mail and could fire off bogofilter.

      2. Backup your data. Let's assume that you said:

	     $ mv ~/.bogofilter ~/.bogofilter.safe
	     $ mkdir ~/.bogofilter

      3. If your bogofilter version is less than 0.7, say:

	     $ bogoupgrade -i ~/.bogofilter.safe/goodlist -o ~/.bogofilter/goodlist.db
	     $ bogoupgrade -i ~/.bogofilter.safe/badlist -o ~/.bogofilter/spamlist.db

	 If your bogofilter version is 0.7 or greater, say:

	     $ bogoupgrade -i ~/.bogofilter.safe/hamlist.count -o ~/.bogofilter/goodlist.db
	     $ bogoupgrade -i ~/.bogofilter.safe/spamlist.count -o ~/.bogofilter/spamlist.db

      4. Current versions of bogofilter use a combined wordlist that holds  both
	 spam  and  non-spam tokens. It is named wordlist.db. If you're updating
	 from a version older than 0.14.0 that	has  separate  wordlists  (named
	 goodlist.db and spamlist.db), use:

	     $ bogoupgrade -d ~/.bogofilter.safe

      5. Done. Restart any stopped daemons, cron tasks, etc.

AUTHOR
     bogoupgrade was written by Gyepi Sam <gyepi@praxis-sw.com> and David Relson
     <relson@osagesoftware.com>.

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

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

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

Bogofilter			   05/19/2019			  BOGOUPGRADE(1)

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

home | help