.TH VLTEST 1 "2005-06-01" "Man Page" "Quick Database Manager"

.SH NAME
vltest \- test cases for QDBM Villa

.SH SYNOPSIS
.PP
.B vltest write
.RI "[-int] [-cz|-cy|-cx] [-tune " lrecmax " " nidxmax " " lcnum " " ncnum "] [-fbp " num "] " name " " rnum
.br
.B vltest read
.RI "[-int] " name
.br
.B vltest rdup
.RI "[-int] [-cz|-cy|-cx] [-cc] [-tune " lrecmax " " nidxmax " " lcnum " " ncnum "] [-fbp " num "] " name " " rnum " " pnum
.br
.B vltest combo
.RI "[-cz|-cy|-cx] " name
.br
.B vltest wicked
.RI "[-c] [-cz|-cy|-cx] " name " " rnum

.SH DESCRIPTION
.PP
The command `vltest' is a utility for facility test and performance test.  Check a database generated by the command or measure the execution time of the command.  This command is used in the following format. `name' specifies a database name.  `rnum' specifies the number of the records.
.PP
.TP
.B vltest write [-int] [-cz|-cy|-cx] [-tune lrecmax nidxmax lcnum ncnum] [-fbp num] name rnum
Store records with keys of 8 bytes. They change as `00000001', `00000002'...
.TP
.B vltest read [-int] [-vc] name
Retrieve all records of the database above.
.TP
.B vltest rdup [-int] [-cz|-cy|-cx] [-cc] [-tune lrecmax nidxmax lcnum ncnum] [-fbp num] name rnum pnum
Store records with partway duplicated keys using duplicate mode.
.TP
.B vltest combo [-cz|-cy|-cx] name
Perform combination test of various operations.
.TP
.B vltest wicked [-c] [-cz|-cy|-cx] name rnum
Perform updating operations selected at random.
.PP
Options feature the following.
.PP
.RS
.B -int
: treat keys and values as objects of `int', and use comparing function `VL_CMPINT'.
.br
.B -cz
: compress leaves in the database with ZLIB.
.br
.B -cy
: compress leaves in the database with LZO.
.br
.B -cx
: compress leaves in the database with BZIP2.
.br
.B -vc
: refer to volatile cache.
.br
.B -cc
: select `VL_DCAT' or `VL_DDUP' at random.
.br
.B -tune lrecmax nidxmax lcnum ncnum
: set tuning parameters.
.br
.B -fbp num
: set the size of the free block pool.
.br
.B -c
: perform comparison test with map of Cabin.
.RE
.PP
This command returns 0 on success, another on failure.  The environment variable `QDBMDBGFD' specifies the file descriptor to output the history of updating the variable `dpecode'.

.SH SEE ALSO
.PP
.BR qdbm (3),
.BR villa (3)

.SH AUTHOR
QDBM was written by Mikio Hirabayashi <mikio@fallabs.com>.