BLUETOOTHD(8)

🌸 BLUETOOTHD(8) — the bluetoothd glow-up 🌸

okay so bestie, welcome to the bluetoothd(8) page 💖 this is the manual for the Bluetooth daemon, and yes it lives in the system management commands section, and yes it is iconic in a quiet, background-process kind of way 🫶

---

✨ NAME ✨

bluetoothd — the Bluetooth daemon, periodt 💅

---

🦋 SYNOPSIS 🦋

bluetoothd [--version] | [--help]

bluetoothd  [--nodetach]  [--compat] [--experimental] [--debug=<files>]
[--plugin=<plugins>] [--noplugin=<plugins>]

so you either ask it its version, or you ask it for help, or you actually run it with a whole lil' stack of flags 🌈

---

🌸 DESCRIPTION 🌸

This manual page documents briefly the bluetoothd daemon, which manages all the Bluetooth devices 🔥 like, all of them. it's giving main character energy but for hardware.

bluetoothd can also provide a number of services via the D-Bus message bus system ⭐ iykyk.

---

💅 OPTIONS 💅

• -v, --version — prints the bluetoothd version and dips out. exit, stage left 👋
• -h, --help — prints the bluetoothd options and then leaves. very "here's the menu, bye" of it 🎀
• -n, --nodetach — enables logging in the foreground ✨ it directs log output to the controlling terminal in addition to syslog, so you get double the tea 🍵
• -f, --configfile — specifies an explicit config file path instead of relying on the default path (/etc/bluetooth/main.conf) for the config file 🗂️ no guessing, you tell it exactly where.
• -d, --debug=<file1>:<file2>:... — sets how much information bluetoothd sends to the log destination (usually syslog's "daemon" facility). if the file options are omitted, then debugging information from all the source files gets printed 👑 if file options are present, then only debug prints from that source file are printed. the option can be a pattern containing "*" and "?" characters 🔍

Example: --debug=src/adapter.c:src/agent.c

• -p, --plugin=<plugin1>,<plugin2>,.. — load these plugins only. the option can be a pattern containing "*" and "?" characters 🧚 selective, exclusive, slay.
• -P, --noplugin=<plugin1>,<plugin2>,.. — never load these plugins 💀 literally never. the option can be a pattern containing "*" and "?" characters.
• -C, --compat — provides deprecated command line interfaces ⚠️ deprecated, bestie, like it's living in the past on purpose.
• -E, --experimental — enables D-Bus experimental interfaces 🧪 these interfaces are not guaranteed to be compatible or present in future releases, so don't get too attached 😭
• -T, --testing — enables D-Bus testing interfaces 🔬 these interfaces are only meant for test validation of the internals of bluetoothd and shall not never be used by anything other than that. (yes that's a double negative in the original, we keep it, we don't fix it 🙈)

real talk: unless you are literally testing the internals, stay away from this one. it said "shall not never", it meant it.

• -K, --kernel=<uuid1>,<uuid2>,... — enable Kernel experimental features 🚀 kernel experimental features are considered unstable and may be removed from future kernel releases. highkey risky, do with that what you will 🌈

---

🍓 FILES 🍓

• /etc/bluetooth/main.conf — location of the global configuration file 📍 that's the one, that's the spot.

---

🎀 RESOURCES 🎀

http://www.bluez.org — go look, bestie 🌐

---

💀 REPORTING BUGS 💀

linux-bluetooth@vger.kernel.org — found a bug? email the list, don't suffer in silence 😤

---

👑 AUTHOR 👑

Marcel Holtmann, Philipp Matthias Hahn, Fredrik Noring 🫶 legends, all of them.

---

🌟 COPYRIGHT 🌟

Free use of this software is granted under the terms of the GNU Lesser General Public Licenses (LGPL) 📜

---

so yeah, that's the whole page, no notes 💖 this beauty is brought to you by BlueZ, dated March, 2004, and it's been serving Bluetooth daemon realness ever since 🦋✨ go forth and pair responsibly, ily 🎀