Next: , Previous: rmcat, Up: Admin utils



4.7.4 Regenerating the index

If your index file becomes corrupted, or if you need a copy of the current index for some reason, use

     gen-index [ -n | --numeric ]
               [ -d databasename | --database=databasename ]
               [ -o filename | --outfile=filename ]
               [ -i | --import ] [ -e | --export ]
               [ -h | --help] [ -V | --version ]

With no options, gen-index generates an index that is sorted by the order that the categories appear in the categories file. The index is generated in plaintext or binary format according to the value of binary-index in the dbconfig file (see Index file description). The results are printed to standard output. The options are:

-n
--numeric
Sorts index entries numerically.
-d databasename
--database=databasename
Specifies the database to index. If this option is left out, gen-index attempts to index the database with name taken from the the GNATSDB environment variable, and if that is undefined, the default database, as set when gnats was built (usually default).
-o filename
--outfile=filename
Places output in filename rather than sending it to standard output.
-i
--import
Import the existing index file instead of re-indexing the database.
-e
--export
Force plaintext output.
-h
--help
Prints the usage for gen-index.
-V
--version
Prints the version number for gen-index.