-rw-r--r-- 1455 cdb-20251021/doc/man/cdbtest.1 raw
.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "cdb" "1" "" "" ""
.hy
.SS NAME
.PP
cdbtest - check a constant database
.SS SYNOPSIS
.PP
\f[V]cdbtest\f[R]
.SS DESCRIPTION
.PP
\f[V]cdbtest\f[R] reads a (seekable) constant database from its standard
input.
For each record in the database, it double-checks that the record can be
found by its key.
It prints tallies in several categories:
.IP \[bu] 2
\f[V]found\f[R] is the number of records found correctly by their keys.
.IP \[bu] 2
\f[V]different record\f[R] is the number of records where a different
record was found with the same key.
This should not happen unless the database has multiple records with the
same key.
.IP \[bu] 2
\f[V]bad length\f[R] is the number of records found but with the wrong
data length.
This should never happen.
.IP \[bu] 2
\f[V]not found\f[R] is the number of records not found.
This should never happen.
.IP \[bu] 2
\f[V]untested\f[R] is the number of records with keys longer than 1024
bytes.
\f[V]cdbtest\f[R] doesn\[cq]t bother testing these records.
.PP
There is also a \f[V]cdb64test\f[R] that uses cdb64 format instead of
cdb format.
.SS SEE ALSO
.PP
\f[B]cdbget\f[R](1), \f[B]cdbmake\f[R](1), \f[B]cdbstats\f[R](1)