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).