chiark / gitweb /
debugging for thing that crashed
[innduct.git] / doc / man / makedbz.8
1 .\" $Revision: 5909 $
2 .TH MAKEDBZ 8
3 .SH NAME
4 makedbz \- rebuild dbz files
5 .SH SYNOPSIS
6 .B makedbz
7 [
8 .BI \-f " filename"
9 ]
10 [
11 .B \-i
12 ]
13 [
14 .B \-o
15 ]
16 [
17 .BI \-s " size"
18 ]
19 .SH DESCRIPTION
20 .PP
21 .I Makedbz
22 rebuilds
23 .IR dbz (3)
24 database.
25 The default name of the text file is
26 .IR <pathdb\ in\ inn.conf>/history ;
27 to specify a different name, use the ``\fB\-f\fP'' flag.
28 .SH OPTIONS
29 .TP
30 .B \-f file
31 If the ``\fB\-f\fP'' flag is used, then the database files are named
32 .IR file.dir ,
33 .IR file.index ,
34 and
35 .IR file.hash .
36 If the ``\fB\-f\fP'' flag is not used, then a temporary link to the name
37 .I history.n
38 is made and the database files are written as
39 .I history.n.index
40 ,
41 .I history.n.hash
42 and
43 .IR history.n.dir .
44 .TP
45 .B \-i
46 To ignore the old database use the ``\fB\-i\fP'' flag.
47 Using the ``\fB\-o\fP'' or ``\fB\-s\fP'' flags implies the ``\fB\-i\fP'' flag.
48 .TP
49 .B \-o
50 If the ``\fB\-o\fP'' flag is used, then the link is not made and any existing
51 history files are overwritten.
52 If the old database exists,
53 .I makedbz
54 will use it to determine the size of the new database.
55 .TP
56 .B \-s size
57 The program will also ignore any old database if the ``\fB\-s\fP'' flag is used
58 to specify the approximate number of entries in the new database.
59 Accurately specifying the size is an optimization that will create a more
60 efficient database.  Size is measured in key-value pairs (i.e., lines).
61 (The size should be the estimated eventual size of the file, typically
62 the size of the old file.)
63 For more information, see the discussion of
64 .I dbzfresh
65 and
66 .I dbzsize
67 in
68 .IR dbz (3).
69 .SH HISTORY
70 Written by Katsuhiro Kondou <kondou@nec.co.jp> for InterNetNews.
71 .de R$
72 This is revision \\$3, dated \\$4.
73 ..
74 .R$ $Id: makedbz.8 5909 2002-12-03 05:17:18Z vinocur $
75 .SH "SEE ALSO"
76 dbz(3),
77 history(5),
78 inn.conf(5).