tcdb.5 - cdb - Constant database manipulation utility
 (HTM) git clone git://git.z3bra.org/cdb.git
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) LICENSE
       ---
       tcdb.5 (924B)
       ---
            1 .Dd 2022-08-31
            2 .Dt CDB 5
            3 .Os POSIX.1-2008
            4 .Sh NAME
            5 .Nm cdb
            6 .Nd constant database
            7 .Sh DESCRIPTION
            8 A
            9 .Nm
           10 contains a data set as key/value pairs, and multiple values can be
           11 associated with the same key. In such case, multiple queries should be
           12 done to retrieve all the values for a given key.
           13 .Pp
           14 Because of how records are stored, the database size MUST be kept under
           15 4 gigabytes.
           16 .Ss ENCODED RECORD
           17 .Nm
           18 are created from encoded records, one per line. The end of the data set
           19 is marked with an extra newline.
           20 .Pp
           21 A record is encoded as
           22 .Li +klen,dlen:key->data
           23 .Pp
           24 .Em key
           25 and
           26 .Em data
           27 are plaintext strings.
           28 .Em klen
           29 is the number of bytes in key, while
           30 .Em dlen
           31 is the number of bytes in data.
           32 .Sh EXAMPLE
           33 Encoded record format, suitable for creating a new
           34 .Nm
           35 .Bd -literal
           36 +3,5:one->Hello
           37 +3,7:two->Goodbye
           38 .Ed
           39 .Sh SEE ALSO
           40 .Xr cdb 1 ,
           41 .Xr http://cr.yp.to/cdb/cdbmake.html
           42 .Sh AUTHORS
           43 .An Willy Goiffon Aq Mt dev@z3bra.org