---
name: "hcsecd.conf"
section: "5"
platform: "freebsd"
package: "base"
version: "16.0-CURRENT-20261027-61c70dc16a79"
release: "FreeBSD 16.0-CURRENT (2026-10-27)"
platforms: ["freebsd"]
url: "https://new.carta.tech/hcsecd.conf"
---

# hcsecd.conf(5)

hcsecd(8) configuration file

## NAME

**hcsecd.conf** – [hcsecd(8)](/hcsecd/8.md) configuration file

## DESCRIPTION

The **hcsecd.conf** file is the configuration file for the [hcsecd(8)](/hcsecd/8.md) Bluetooth link keys/PIN codes management daemon.

The **hcsecd.conf** file is a free-form ASCII text file. It is parsed by the recursive-descent parser built into [hcsecd(8)](/hcsecd/8.md). The file may contain extra tabs and newlines for formatting purposes. Keywords in the file are case-sensitive. Comments may be placed anywhere within the file (except within quotes). Comments begin with the ‘#’ character and end at the end of the line.

## FILE FORMAT

The **hcsecd.conf** file consists of a list of **device** entries. Each **device** entry defines a link key or PIN code for a remote Bluetooth device. Each remote Bluetooth device is identified by its unique BD\_ADDR.

The **device** entry

**device** { **option** *argument*;\[ **option** *argument*;\] }

The following section describes all supported options and arguments.

- **bdaddr** *BD\_ADDR*

  Specify remote device BD\_ADDR for the entry.

- **name** *device\_name*

  Specify user friendly name for the entry. Name is a string in straight double quotes.

- **key** *link\_key*

  Specify link key for the entry. Link key is hexadecimal string up to 32 characters in length starting with ‘0x’.

- **key** **nokey**

  Specify no link key for the entry.

- **pin** *PIN\_code*

  Specify PIN code for the entry. PIN code is a string up to 16 characters in length in straight double quotes.

- **pin** **nopin**

  Specify no PIN code for the entry.

## EXAMPLES

A sample **hcsecd.conf** file:

```
# Default entry is applied if no better match found
# It MUST have 00:00:00:00:00:00 as bdaddr
device {
        bdaddr  00:00:00:00:00:00;
        name    "Default entry";
        key     nokey;
        pin     nopin;
}
# Ericsson T68 phone
device {
        bdaddr  00:80:37:5e:4d:d4;
        name    "Ericsson T68 phone";
        key     nokey;
        pin     "0000"; # PIN code
}
# Dummy device
device {
        bdaddr  00:11:22:33:44:55;
        name    "Dummy";
        key     0x00112233445566778899aabbccddeeff; # 16 bytes key
        pin     nopin;
}
```

## SEE ALSO

[hcsecd(8)](/hcsecd/8.md)

## AUTHORS

Maksim Yevmenkin ⟨*m\_evmenkin@yahoo.com*⟩