19b50d902SRodney W. Grimes.\" Copyright (c) 1992, 1993 29b50d902SRodney W. Grimes.\" The Regents of the University of California. All rights reserved. 39b50d902SRodney W. Grimes.\" 49b50d902SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without 59b50d902SRodney W. Grimes.\" modification, are permitted provided that the following conditions 69b50d902SRodney W. Grimes.\" are met: 79b50d902SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright 89b50d902SRodney W. Grimes.\" notice, this list of conditions and the following disclaimer. 99b50d902SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright 109b50d902SRodney W. Grimes.\" notice, this list of conditions and the following disclaimer in the 119b50d902SRodney W. Grimes.\" documentation and/or other materials provided with the distribution. 129b50d902SRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software 139b50d902SRodney W. Grimes.\" must display the following acknowledgement: 149b50d902SRodney W. Grimes.\" This product includes software developed by the University of 159b50d902SRodney W. Grimes.\" California, Berkeley and its contributors. 169b50d902SRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors 179b50d902SRodney W. Grimes.\" may be used to endorse or promote products derived from this software 189b50d902SRodney W. Grimes.\" without specific prior written permission. 199b50d902SRodney W. Grimes.\" 209b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 219b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 229b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 239b50d902SRodney W. Grimes.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 249b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 259b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 269b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 279b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 289b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 299b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 309b50d902SRodney W. Grimes.\" SUCH DAMAGE. 319b50d902SRodney W. Grimes.\" 329b50d902SRodney W. Grimes.\" @(#)cap_mkdb.1 8.1 (Berkeley) 6/6/93 33c3aac50fSPeter Wemm.\" $FreeBSD$ 349b50d902SRodney W. Grimes.\" 35681e5e7aSSteve Price.Dd June 6, 1993 369b50d902SRodney W. Grimes.Dt CAP_MKDB 1 379b50d902SRodney W. Grimes.Os 389b50d902SRodney W. Grimes.Sh NAME 399b50d902SRodney W. Grimes.Nm cap_mkdb 409b50d902SRodney W. Grimes.Nd create capability database 419b50d902SRodney W. Grimes.Sh SYNOPSIS 428fe908efSRuslan Ermilov.Nm 439b50d902SRodney W. Grimes.Op Fl v 449b50d902SRodney W. Grimes.Op Fl f Ar outfile 4593d6b9b6SPhilippe Charnier.Ar file 4693d6b9b6SPhilippe Charnier.Op Ar 479b50d902SRodney W. Grimes.Sh DESCRIPTION 489b50d902SRodney W. Grimes.Nm Cap_mkdb 499b50d902SRodney W. Grimesbuilds a hashed database out of the 509b50d902SRodney W. Grimes.Xr getcap 3 519b50d902SRodney W. Grimeslogical database constructed by the concatenation of the specified 529b50d902SRodney W. Grimesfiles. 539b50d902SRodney W. Grimes.Pp 549b50d902SRodney W. GrimesThe database is named by the basename of the first file argument and 559b50d902SRodney W. Grimesthe string 569b50d902SRodney W. Grimes.Dq .db . 579b50d902SRodney W. GrimesThe 589b50d902SRodney W. Grimes.Xr getcap 3 599b50d902SRodney W. Grimesroutines can access the database in this form much more quickly 609b50d902SRodney W. Grimesthan they can the original text file(s). 619b50d902SRodney W. Grimes.Pp 629b50d902SRodney W. GrimesThe ``tc'' capabilities of the records are expanded before the 639b50d902SRodney W. Grimesrecord is stored into the database. 649b50d902SRodney W. Grimes.Pp 6593d6b9b6SPhilippe CharnierThe following options are available: 6693d6b9b6SPhilippe Charnier.Bl -tag -width indent 679b50d902SRodney W. Grimes.It Fl f Ar outfile 689b50d902SRodney W. GrimesSpecify a different database basename. 699b50d902SRodney W. Grimes.It Fl v 709b50d902SRodney W. GrimesPrint out the number of capability records in the database. 719b50d902SRodney W. Grimes.El 729b50d902SRodney W. Grimes.Pp 739b50d902SRodney W. Grimes.Sh FORMAT 749b50d902SRodney W. GrimesEach record is stored in the database using two different types of keys. 759b50d902SRodney W. Grimes.Pp 769b50d902SRodney W. GrimesThe first type is a key which consists of the first capability of 779b50d902SRodney W. Grimesthe record (not including the trailing colon (``:'')) with a data 789b50d902SRodney W. Grimesfield consisting of a special byte followed by the rest of the record. 799b50d902SRodney W. GrimesThe special byte is either a 0 or 1, where a 0 means that the record 809b50d902SRodney W. Grimesis okay, and a 1 means that there was a ``tc'' capability in the record 819b50d902SRodney W. Grimesthat couldn't be expanded. 829b50d902SRodney W. Grimes.Pp 839b50d902SRodney W. GrimesThe second type is a key which consists of one of the names from the 849b50d902SRodney W. Grimesfirst capability of the record with a data field consisting a special 85e83201b4SWolfram Schneiderbyte followed by the first capability of the record. 869b50d902SRodney W. GrimesThe special byte is a 2. 879b50d902SRodney W. Grimes.Pp 889b50d902SRodney W. GrimesIn normal operation names are looked up in the database, resulting 899b50d902SRodney W. Grimesin a key/data pair of the second type. 909b50d902SRodney W. GrimesThe data field of this key/data pair is used to look up a key/data 919b50d902SRodney W. Grimespair of the first type which has the real data associated with the 929b50d902SRodney W. Grimesname. 9393d6b9b6SPhilippe Charnier.Sh DIAGNOSTICS 949b50d902SRodney W. GrimesThe 9593d6b9b6SPhilippe Charnier.Nm 9693d6b9b6SPhilippe Charnierutility exits 0 on success, and >0 if an error occurs. 979b50d902SRodney W. Grimes.Sh SEE ALSO 989b50d902SRodney W. Grimes.Xr dbopen 3 , 999b50d902SRodney W. Grimes.Xr getcap 3 , 1009b50d902SRodney W. Grimes.Xr termcap 5 101