.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "MAKEDBZ 8"
.TH MAKEDBZ 8 2024-04-01 "INN 2.7.2" "InterNetNews Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
makedbz \- Rebuild dbz files
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBmakedbz\fR [\fB\-io\fR] [\fB\-f\fR \fIfilename\fR] [\fB\-s\fR \fIsize\fR]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBmakedbz\fR rebuilds \fIdbz\fR database (also known as the \fIhistory\fR file).
The default name of the text file is \fIpathdb\fR/history; to specify a different
name, use the \fB\-f\fR flag.
.SH OPTIONS
.IX Header "OPTIONS"
.IP "\fB\-f\fR \fIfilename\fR" 4
.IX Item "-f filename"
If the \fB\-f\fR flag is used, then the database files are named
\&\f(CW\*(C`\fR\f(CIfilename\fR\f(CW.dir\*(C'\fR, \f(CW\*(C`\fR\f(CIfilename\fR\f(CW.index\*(C'\fR, and \f(CW\*(C`\fR\f(CIfilename\fR\f(CW.hash\*(C'\fR.  If the
\&\fB\-f\fR flag is not used, then a temporary link to the name \f(CW\*(C`history.n\*(C'\fR is made
and the database files are written as \f(CW\*(C`history.n.index\*(C'\fR , \f(CW\*(C`history.n.hash\*(C'\fR
and \f(CW\*(C`history.n.dir\*(C'\fR.
.IP \fB\-i\fR 4
.IX Item "-i"
To ignore the old database when determining the size of the new one to create,
use the \fB\-i\fR flag.  Using the \fB\-o\fR or \fB\-s\fR flags implies the \fB\-i\fR flag.
.Sp
When the old database is ignored, and a size is not specified with \fB\-s\fR,
\&\fBmakedbz\fR will count the number of lines of the current text \fIhistory\fR
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).
.Sp
If no text \fIhistory\fR file exists, the new one will have the default creation
size (see \fB\-s\fR).
.IP \fB\-o\fR 4
.IX Item "-o"
If the \fB\-o\fR flag is used, then the temporary link to \f(CW\*(C`history.n\*(C'\fR
(or the name specified by the \fB\-f\fR flag) is not made and any existing
\&\fIhistory\fR files are overwritten.  If the old database exists, \fBmakedbz\fR
will use it to determine the size of the new database (see \fB\-i\fR).
.IP "\fB\-s\fR \fIsize\fR" 4
.IX Item "-s size"
\&\fBmakedbz\fR will also ignore any old database if the \fB\-s\fR 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.)
.Sp
The effective size used will be larger, to optimize the performances of the
database.  For more information, see \fB\-i\fR and the discussion of \fBdbzfresh\fR
and \fBdbzsize\fR in libinn_dbz(3).
.Sp
The default is 6,666,666 when creating a new \fIhistory\fR database.  (If the
slower tagged hash format is used, the default is 500,000.)
.SH HISTORY
.IX Header "HISTORY"
Written by Katsuhiro Kondou <kondou@nec.co.jp> for InterNetNews.  Converted to
POD by Julien Elie.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
history(5), libinn_dbz(3).