cap_mkdb(1) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
CAP_MKDB(1)             NetBSD General Commands Manual             CAP_MKDB(1)


NAME

     cap_mkdb - create capability database


SYNOPSIS

     cap_mkdb [-b | -l] [-v] [-f outfile] file1 [file2 ...]


DESCRIPTION

     cap_mkdb builds a hashed database out of the getcap(3) logical database
     constructed by the concatenation of the specified files .

     The database is named by the basename of the first file argument and the
     string ``.db''.  The getcap(3) routines can access the database in this
     form much more quickly than they can the original text file(s).

     The ``tc'' capabilities of the records are expanded before the record is
     stored into the database.

     The options are as follows:

           -b      Use big-endian byte order for database metadata.

           -f outfile
                   Specify a different database basename.

           -l      Use little-endian byte order for database metadata.

           -v      Print out the number of capability records in the database.

     The -b and the -l flags are mutually exclusive.  The default byte order-
     ing is the current host order.


FORMAT

     Each record is stored in the database using two different types of keys.

     The first type is a key which consists of the first capability of the
     record (not including the trailing colon (``:'')) with a data field con-
     sisting of a special byte followed by the rest of the record.  The spe-
     cial byte is either a 0 or 1, where a 0 means that the record is okay,
     and a 1 means that there was a ``tc'' capability in the record that
     couldn't be expanded.

     The second type is a key which consists of one of the names from the
     first capability of the record with a data field consisting a special
     byte followed by the first capability of the record.  The special byte is
     a 2.

     In normal operation names are looked up in the database, resulting in a
     key/data pair of the second type.  The data field of this key/data pair
     is used to look up a key/data pair of the first type which has the real
     data associated with the name.


EXIT STATUS

     The cap_mkdb utility exits 0 on success and >0 if an error occurs.


SEE ALSO

     dbopen(3), getcap(3), termcap(5)

NetBSD 2.1                       June 6, 1993                       NetBSD 2.1