126 lines
2.6 KiB
Plaintext
126 lines
2.6 KiB
Plaintext
.\" Copyright (c) 1992, 1994, 1996 Bunyip Information Systems Inc.
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" Archie 3.5
|
|
.\" August 1996
|
|
.\"
|
|
.\" @(#)db_build.n
|
|
.\"
|
|
.TH DB_BUILD N "August 1996"
|
|
|
|
.SH NAME
|
|
.B db_build
|
|
\- build the strings index file.
|
|
|
|
.SH SYNOPSIS
|
|
.B db_build
|
|
[
|
|
.BI \-k " <maxsize>"
|
|
] [
|
|
.BI \-d " <database>"
|
|
] [
|
|
.B \-f
|
|
] [
|
|
.BI \-t " <tmp-dir>"
|
|
] [
|
|
.BI \-M " <dir>"
|
|
] [
|
|
.BI \-h " <dir>"
|
|
] [
|
|
.B \-v
|
|
] [
|
|
.B \-l
|
|
] [
|
|
.BI \-L " <logfile>"
|
|
]
|
|
|
|
.SH DESCRIPTION
|
|
.B db_build
|
|
builds the strings index file,
|
|
.BR Stridx.Index .
|
|
The index file allows faster searching in the strings database. The
|
|
file
|
|
.B Stridx.Split
|
|
contains the size of the initial segment of
|
|
.B Stridx.Strings
|
|
that is currently indexed. If
|
|
.B Stridx.Strings
|
|
has grown much larger than the value in
|
|
.BR Stridx.Split ,
|
|
it is recommended that
|
|
.B db_build
|
|
be run, to speed up the searching.
|
|
|
|
.B db_build
|
|
will usually take a long time to build an index. The time required
|
|
to build the index grows with the size of the
|
|
.B Stridx.Strings
|
|
file.
|
|
|
|
.SH OPTIONS
|
|
.TP
|
|
.BI \-k " <maxsize>"
|
|
The approximate, maximum amount of memory to use while building the index.
|
|
The value is specified in kilobytes (1024 bytes).
|
|
.TP
|
|
.BI \-f
|
|
Force the building of the index. By default,
|
|
.B db_build
|
|
checks the sizes of the
|
|
.B Stridx.*
|
|
files to decide whether or not to rebuild the index.
|
|
.TP
|
|
.BI \-M " <dir>"
|
|
The name of the master Archie database directory. If not specified, the
|
|
program looks in the directory
|
|
.BR ~archie/db ,
|
|
then
|
|
.BR ./db .
|
|
.TP
|
|
.BI \-d " <database>"
|
|
The catalog for which to build the index,
|
|
.BR Stridx.Strings .
|
|
By default the program will examine all available catalogs listed in
|
|
.BR ~archie/etc/catalogs.cf .
|
|
.TP
|
|
.BI \-t " <tmp-dir>"
|
|
The name of the temporary directory where the build will be performed.
|
|
.TP
|
|
.BI \-h " <dir>"
|
|
The name of the Archie host database directory. If not specified, the program
|
|
will first try
|
|
.BR ~archie/db/host_db ,
|
|
then
|
|
.BR ./host_db .
|
|
.TP
|
|
.BI \-v
|
|
Verbose. Print messages indicating what the program is doing.
|
|
.TP
|
|
.BI \-l
|
|
Write messages to the default log file,
|
|
.BR ~archie/logs/archie.log .
|
|
The location of the log file can be overridden with the
|
|
.B \-L
|
|
option. By default, messages are written to
|
|
.IR stderr .
|
|
.TP
|
|
.BI \-L " <logfile>"
|
|
The name of the file to be used for logging messages. Note that debugging
|
|
information is also written to the log file. The
|
|
.B \-l
|
|
option must also be specified.
|
|
|
|
.SH FILES
|
|
~archie/db/\fI<db-name>\fP/Stridx.*
|
|
|
|
.SH SEE ALSO
|
|
.BR db_stats (n)
|
|
|
|
.SH AUTHOR
|
|
Bunyip Information Systems.
|
|
.br
|
|
Montr\o"\'e"al, Qu\o"\'e"bec, Canada
|
|
.sp
|
|
Archie is a registered trademark of Bunyip Information Systems Inc., Canada,
|
|
1990.
|