Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CAP_MKDB(1)		    General Commands Manual		   CAP_MKDB(1)

NAME
       cap_mkdb	-- create capability database

SYNOPSIS
       cap_mkdb	[-b | -l] [-v] [-f outfile] file ...

DESCRIPTION
       The cap_mkdb utility builds a hashed database out of the	getcap(3) log-
       ical 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 following options are available:

       -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 -l flags are mutually	exclusive.  The	default	byte  ordering
       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
       consisting of a special byte followed by	the rest of the	 record.   The
       special	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 could not 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)

FreeBSD	13.2		       February	22, 2005		   CAP_MKDB(1)

NAME | SYNOPSIS | DESCRIPTION | FORMAT | EXIT STATUS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=cap_mkdb&manpath=FreeBSD+14.1-RELEASE+and+Ports>

home | help