Bluetooth: Document the existing device quirks

The current existing device quirks are not documented. So instead of
spreading bits and pieces somewhere in the code, add proper comments
on where these quirks can be used and what behavior they change.

Signed-off-by: Marcel Holtmann <marcel@holtmann.org>
Signed-off-by: Johan Hedberg <johan.hedberg@intel.com>

diff --git a/include/net/bluetooth/hci.h b/include/net/bluetooth/hci.h
index 606a9b1466a3bea175a75189261e98701ad23e2f..744713cd533585163c08c4e3c944e1a4de7ef9e6 100644 (file)
--- a/include/net/bluetooth/hci.h
+++ b/include/net/bluetooth/hci.h
@@ -81,9 +81,34 @@
 
 /* HCI device quirks */
 enum {
+       /* When this quirk is set, the HCI Reset command is send when
+        * closing the transport instead of when opening it.
+        *
+        * This quirk must be set before hci_register_dev is called.
+        */
        HCI_QUIRK_RESET_ON_CLOSE,
+
+       /* When this quirk is set, the device is turned into a raw-only
+        * device and it will stay in unconfigured state.
+        *
+        * This quirk must be set before hci_register_dev is called.
+        */
        HCI_QUIRK_RAW_DEVICE,
+
+       /* When this quirk is set, the buffer sizes reported by
+        * HCI Read Buffer Size command are corrected if invalid.
+        *
+        * This quirk must be set before hci_register_dev is called.
+        */
        HCI_QUIRK_FIXUP_BUFFER_SIZE,
+
+       /* When this quirk is set, then no stored link key handling
+        * is performed. This is mainly due to the fact that the
+        * HCI Delete Stored Link Key command is advertised, but
+        * not supported.
+        *
+        * This quirk must be set before hci_register_dev is called.
+        */
        HCI_QUIRK_BROKEN_STORED_LINK_KEY,
 };