-rw-r--r-- 1426 cdb-20251021/doc/man/cdbget.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
cdbget - search for a record in a constant database
.SS SYNOPSIS
.PP
\f[V]cdbget\f[R] \f[I]K\f[R]
.PP
\f[V]cdbget\f[R] \f[I]K\f[R] \f[I]S\f[R]
.SS DESCRIPTION
.PP
\f[V]cdbget\f[R] searches for a record with key \f[I]K\f[R] in a
constant database.
The constant database must be readable (and seekable) on
\f[V]cdbget\f[R]\[cq]s standard input.
.PP
\f[V]cdbget\f[R] prints the data in the first record with key
\f[I]K\f[R] and exits 0.
If there is no record with key \f[I]K\f[R], \f[V]cdbget\f[R] exits 100
without printing anything.
.PP
If \f[V]cdbget\f[R] encounters a read error, write error, or database
format error, it complains and exits 111.
.PP
If a numeric argument \f[I]S\f[R] is provided, \f[V]cdbget\f[R] skips
past the first \f[I]S\f[R] records with key \f[I]K\f[R], and prints the
data in the next record.
For example, \f[V]cdbget foo 3\f[R] prints the fourth record with key
\f[V]foo\f[R] (skipping 3 records).
.PP
There is also a \f[V]cdb64get\f[R] that uses cdb64 format instead of cdb
format.
.SS SEE ALSO
.PP
\f[B]cdbmake\f[R](1), \f[B]cdbdump\f[R](1), \f[B]cdbstats\f[R](1)