migrate/debbugs-dbhash.8

   1 .TH DEBBUGS\-DBHASH 8
   2 .SH NAME
   3 debbugs\-dbhash \- migrate a debbugs database to hashed format
   4 .SH SYNOPSIS
   5 .B debbugs\-dbhash
   6 .I old-db-directory
   7 .I new-db-directory
   8 .SH DESCRIPTION
   9 .B debbugs\-dbhash
  10 converts an old-style flat debbugs database into a new-style
  11 hashed-directory debbugs database, for use with debbugs 2.4 and
  12 above.
  13 .PP
  14 The old database is simply copied, and otherwise left untouched.
  15 The directory given for the new database must not already exist.
  16 .PP
  17 In the hashed format, files with names of the form
  18 .I 1023.log
  19 are now stored as
  20 .I 23/1023.log
  21 instead.
  22 This improves performance on many filesystems for debbugs
  23 installations with large numbers of bug reports.
  24 .SH WARNINGS
  25 .B debbugs\-dbhash
  26 will print a warning message for each file whose name is of a form
  27 that cannot be hashed as above.
  28 Typical debbugs installations will have a few of these, usually
  29 index files and the like.
  30 .SH AUTHORS
  31 Adam Heath is primarily responsible for the hashed directory support
  32 in debbugs.
  33 Colin Watson wrote
  34 .B debbugs\-dbhash
  35 and this man page.