Received-SPF: pass (google.com: best guess record for domain of linux-bluetooth-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67;
From:   Alain Michaud <alainm@chromium.org>
To:     linux-bluetooth@vger.kernel.org
Cc:     Alain Michaud <alainm@chromium.org>
Subject: [Bluez PATCH] doc: Add definition for Set Kernel Debug Level
Date:   Mon, 20 Jan 2020 20:27:08 +0000
Message-Id: <20200120202708.111383-1-alainm@chromium.org>
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Sender: linux-bluetooth-owner@vger.kernel.org
Precedence: bulk

This command is used to by higher level applications to dynamically
control the debug logging level of the kernel module.  This is
particularly useful to collect debug information from customers filing
feedback reports for issues that are difficult to reproduce outside of a
customer's particular environement.

---

 doc/mgmt-api.txt | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt
index 1e59acc54..f2dba64d1 100644
--- a/doc/mgmt-api.txt
+++ b/doc/mgmt-api.txt
@@ -3047,6 +3047,31 @@ Load Blocked Keys Command
 	Possible errors:	Invalid Parameters
 				Invalid Index
 
+Set Kernel Debug Logging Level Command
+=======================
+
+	Command Code:		0x0047
+	Controller Index: <controller id>
+	Command Parameters : Debug_Logging_Level (1 octet)
+
+	This command is used to set the kernel debug logging level. This
+	can be by higher level applications to facilitate dynamically
+	controlling	the logging level produced by the Bluez kernel module.
+
+	Supported Debug_Logging_Level values:
+		0 : No Logging
+		1 : All debug information.
+		All other values are reserved for future use.
+
+	When the kernel receives a value higher than the maximum supported
+	value, the kernel module shall set it's logging level to the highest
+	value it supports.
+
+	This command generates a Command Complete event on success or
+	a Command Status event on failure.
+
+	Possible errors:	Invalid Parameters
+				Invalid Index
 
 Command Complete Event
 ======================
-- 
2.25.0.341.g760bfbb309-goog