1=head1 NAME
2
3makedbz - Rebuild dbz files
4
5=head1 SYNOPSIS
6
7B<makedbz> [B<-io>] [B<-f> I<filename>] [B<-s> I<size>]
8
9=head1 DESCRIPTION
10
11B<makedbz> rebuilds dbz(3) database.  The default name of the text
12file is I<pathdb>/history; to specify a different name, use the B<-f> flag.
13
14=head1 OPTIONS
15
16=over 4
17
18=item B<-f> I<filename>
19
20If the B<-f> flag is used, then the database files are named C<I<filename>.dir>,
21C<I<filename>.index>, and C<I<filename>.hash>.  If the B<-f> flag is not used,
22then a temporary link to the name C<history.n> is made and the database files
23are written as C<history.n.index> , C<history.n.hash> and C<history.n.dir>.
24
25=item B<-i>
26
27To ignore the old database, use the B<-i> flag.  Using the B<-o> or B<-s>
28flags implies the B<-i> flag.
29
30=item B<-o>
31
32If the B<-o> flag is used, then the temporary link to C<history.n>
33(or the name specified by the B<-f> flag) is not made and any existing
34history files are overwritten.  If the old database exists, B<makedbz>
35will use it to determine the size of the new database.
36
37=item B<-s> I<size>
38
39B<makedbz> will also ignore any old database if the B<-s> flag is used to
40specify the approximate number of entries in the new database.  Accurately
41specifying the size is an optimization that will create a more efficient
42database.  Size is measured in key-value pairs (i.e. lines).  (The size
43should be the estimated eventual size of the file, typically the size
44of the old file.)
45
46For more information, see the discussion of B<dbzfresh> and B<dbzsize>
47in dbz(3).
48
49=back
50
51=head1 HISTORY
52
53Written by Katsuhiro Kondou <kondou@nec.co.jp> for InterNetNews.  Converted to
54POD by Julien Elie.
55
56$Id: makedbz.pod 9934 2015-08-28 19:28:56Z iulius $
57
58=head1 SEE ALSO
59
60dbz(3), history(5).
61
62=cut
63