NAME

       makedbz - Rebuild dbz files

SYNOPSIS

       makedbz [-io] [-f filename] [-s size]

DESCRIPTION

       makedbz rebuilds dbz database (also known as the history file).  The default name of the text file is
       pathdb/history; to specify a different name, use the -f flag.

OPTIONS

       -f filename
           If  the  -f  flag  is  used,  then the database files are named "filename.dir", "filename.index", and
           "filename.hash".  If the -f flag is not used, then a temporary link to the name "history.n"  is  made
           and the database files are written as "history.n.index" , "history.n.hash" and "history.n.dir".

       -i  To  ignore  the  old  database  when  determining the size of the new one to create, use the -i flag.
           Using the -o or -s flags implies the -i flag.

           When the old database is ignored, and a size is not specified with -s, makedbz will count the  number
           of  lines  of the current text history file, add 10% to that count (for the next articles to arrive),
           and another 50% (or 100% if the slower tagged hash format is used) to determine the size of  the  new
           database to create.  The aim is to optimize the performances of the database, keeping it filled below
           2/3 of its size (or 1/2 with the tagged hash format).

           If no text history file exists, the new one will have the default creation size (see -s).

       -o  If the -o flag is used, then the temporary link to "history.n" (or the name specified by the -f flag)
           is not made and any existing history files are overwritten.  If the old database exists, makedbz will
           use it to determine the size of the new database (see -i).

       -s size
           makedbz will also ignore any old database if the -s flag is used to specify the approximate number of
           entries  in  the  new database.  Accurately specifying the size is an optimization that will create a
           more efficient database.  The news server will still accept more articles, but will be slower.   Size
           is  measured in key-value pairs (i.e. lines).  (The size should be the estimated eventual size of the
           file, typically the size of the old file.)

           The effective size used will be larger, to optimize the  performances  of  the  database.   For  more
           information, see -i and the discussion of dbzfresh and dbzsize in libinn_dbz(3).

           The  default is 6,666,666 when creating a new history database.  (If the slower tagged hash format is
           used, the default is 500,000.)

HISTORY

       Written by Katsuhiro Kondou <kondou@nec.co.jp> for InterNetNews.  Converted to POD by Julien Elie.

SEE ALSO

       history(5), libinn_dbz(3).

INN 2.7.3                                          2025-05-19                                         MAKEDBZ(8)