.\" Copyright (c) 2006 Fredrik Lindberg
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" $Id: bbdm.1 57 2006-02-23 14:15:13Z fli $
.\"
.Dd February 13, 2006
.Dt BBDM 1
.Sh NAME
.Nm bbdm 
.Nd "BioAPI BIR Database Management"
.Sh SYNOPSIS
.Nm
.Op Fl l Ar bsp|birdb
.Nm
.Op Fl b Ar uuid
.Op Fl m Ar backend
.Op Fl c Ar username
.Op Fl v Ar username
.Op Fl i
.Op Fl f Ar file 
.Sh DESCRIPTION
.Nm
is a small BioAPI management utility which allows enrollment and verification
of BIR entries.
It works together with libbirdb and the BioAPI framework and should work
with any libbirdb backend and any compliant BioAPI BSP module. 
.Bl -tag -width ".Fl c Ar username"
.It Fl l Ar bsp
List all BSPs registerd in the BioAPI database.
.It Fl l Ar birdb
List all avaiable BIR DB backend modules.
.It Fl b Ar uuid
Use the BSP with UUID
.Ar uuid
.It Fl m Ar backend
Use BIR DB backend module with id
.Ar backend
.It Fl c Ar username
Capture/enroll a new user.
.It Fl v Ar username
Verify a previously enrolled user.
.It Fl i
Identify a user based on biometric data.
.It Fl f Ar path
Specify location of BIR DB configuration file.
.El
.Sh EXAMPLES
Enroll the user
.Dq Li foo
with the BSP ID
.Dq Li {ffffffff-ffff-ffff-ffff-ffffffffffff}
and the BIR DB backend
.Dq Li filedb
.Dl "bbdm -b {ffffffff-ffff-ffff-ffff-ffffffffffff} -m filedb -c foo"
.Pp
.Sh AUTHORS
This utility was written by Fredrik Lindberg.
BioAPI is provided by the BioAPI Consortium (http://www.bioapi.org)
.Sh SEE ALSO
.Xr pam_bsdbioapi 8
.Xr libbirdb 3
.Sh BUGS
Only a subset of the BioAPI specification is implemented.