1.\" Copyright (c) 2001-2002 Maksim Yevmenkin <m_evmenkin@yahoo.com>
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.\" $Id: hcsecd.conf.5,v 1.1 2003/05/26 22:49:23 max Exp $
26.\"
27.Dd May 26, 2003
28.Dt HCSECD.CONF 5
29.Os
30.Sh NAME
31.Nm hcsecd.conf
32.Nd
33.Xr hcsecd 8
34configuration file
35.Sh DESCRIPTION
36The
37.Nm
38file is the configuration file for the
39.Xr hcsecd 8
40Bluetooth link keys/PIN codes management daemon.
41.Pp
42The
43.Nm
44file is a free-form
45.Tn ASCII
46text file.
47It is parsed by the recursive-descent parser built into
48.Xr hcsecd 8 .
49The file may contain extra tabs and newlines for formatting purposes.
50Keywords in the file are case-sensitive.
51Comments may be placed anywhere within the file (except within quotes).
52Comments begin with the
53.Ql #
54character and end at the end of the line.
55.Sh FILE FORMAT
56The
57.Nm
58file consists of a list of
59.Cm device
60entries.
61Each
62.Cm device
63entry defines a link key or PIN code for a remote Bluetooth device.
64Each remote Bluetooth device is identified by its unique BD_ADDR.
65.Pp
66The
67.Cm device
68entry
69.Pp
70.Cm device
71{
72.Cm option Ar argument ;
73.Oo
74.Cm option Ar argument ;
75.Oc
76}
77.Pp
78The following section describes all supported options and arguments.
79.Bl -tag -width indent
80.It Cm bdaddr Ar BD_ADDR
81Specify remote device BD_ADDR for the entry.
82.It Cm name Ar device_name
83Specify user friendly name for the entry.
84Name is a string in straight double quotes.
85.It Cm key Ar link_key
86Specify link key for the entry.
87Link key is hexadecimal string up to 32 characters in length starting with
88.Ql 0x .
89.It Cm key nokey
90Specify no link key for the entry.
91.It Cm pin Ar PIN_code
92Specify PIN code for the entry.
93PIN code is a string up to 16 characters in length in straight double quotes.
94.It Cm pin nopin
95Specify no PIN code for the entry.
96.El
97.Sh EXAMPLES
98A sample
99.Nm
100file:
101.Bd -literal
102# Default entry is applied if no better match found
103# It MUST have 00:00:00:00:00:00 as bdaddr
104device {
105        bdaddr  00:00:00:00:00:00;
106        name    "Default entry";
107        key     nokey;
108        pin     nopin;
109}
110
111# Ericsson T68 phone
112device {
113        bdaddr  00:80:37:5e:4d:d4;
114        name    "Ericsson T68 phone";
115        key     nokey;
116        pin     "0000"; # PIN code
117}
118
119# Dummy device
120device {
121        bdaddr  00:11:22:33:44:55;
122        name    "Dummy";
123        key     0x00112233445566778899aabbccddeeff; # 16 bytes key
124        pin     nopin;
125}
126.Ed
127.Sh SEE ALSO
128.Xr hcsecd 8
129.Sh AUTHORS
130.An Maksim Yevmenkin Aq Mt m_evmenkin@yahoo.com
131