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
       format 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
       option is used when converting from multiple, separate wordlists
       (spamlist.db and	goodlist.db - containing spam and ham tokens,
       respectively) to	a combined 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+14.3.quarterly>

home | help