From patchwork Mon Mar 9 21:28:43 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Marcel Holtmann X-Patchwork-Id: 11428069 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id A9F95921 for ; Mon, 9 Mar 2020 21:28:50 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 8995524654 for ; Mon, 9 Mar 2020 21:28:50 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726266AbgCIV2u (ORCPT ); Mon, 9 Mar 2020 17:28:50 -0400 Received: from coyote.holtmann.net ([212.227.132.17]:56142 "EHLO mail.holtmann.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726118AbgCIV2t (ORCPT ); Mon, 9 Mar 2020 17:28:49 -0400 Received: from localhost.localdomain (p4FEFC5A7.dip0.t-ipconnect.de [79.239.197.167]) by mail.holtmann.org (Postfix) with ESMTPSA id 9400FCECC4 for ; Mon, 9 Mar 2020 22:38:16 +0100 (CET) From: Marcel Holtmann To: linux-bluetooth@vger.kernel.org Subject: [RFC] doc: Add commands and event for global debug configuration Date: Mon, 9 Mar 2020 22:28:43 +0100 Message-Id: <20200309212843.430786-1-marcel@holtmann.org> X-Mailer: git-send-email 2.24.1 MIME-Version: 1.0 Sender: linux-bluetooth-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-bluetooth@vger.kernel.org --- doc/mgmt-api.txt | 73 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 73 insertions(+) diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt index 27a41f334d63..bdc83758456d 100644 --- a/doc/mgmt-api.txt +++ b/doc/mgmt-api.txt @@ -3094,6 +3094,62 @@ Set Wideband Speech Command Invalid Index +Get Debug Configuration Command +=============================== + + Command Code: 0x0048 + Controller Index: + Command Parameters: + Return Parameters: Layers (4 Octets) + Flags (4 Octets) + + This command is used to read the current global debug setting of + the stack. + + The Layers parameter is a bitmask with following defined bits: + + 0 Kernel messages + 1 Daemon messages + 2 Tools messages + + If the bit is set, then the corresponding debug messages are + enabled. The kernel only acts on the Kernel messages bit and + all other bits are just passed back to userspace. + + The Flags parameter is a bitmask with following defined bits: + + 0 Include function name + 1 Include line number + 2 Include module name + + This command generates a Command Complete event on success or + a Command Status event on failure. + + Possible errors: Invalid Parameters + Invalid Index + + +Set Debug Configuration Command +=============================== + + Command Code: 0x0049 + Controller Index: + Command Parameters: Layers (4 Octets) + Flags (4 Octets) + Return Parameters: + + This command is used to set the current global debug setting of + the stack. + + Refer Get Debug Configuration command for parameter description. + + 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 ====================== @@ -3976,3 +4032,20 @@ PHY Configuration Changed Event one through which the change was triggered. Refer Get PHY Configuration command for PHYs parameter. + + +Debug Configuration Changed Event +================================= + + Event Code: 0x0027 + Controller Index: + Event Parameters: Layers (4 Octets) + Flags (4 Octets) + + This event indicates that the current global debug setting of + the stack has been changed. + + The event will only be sent to management sockets other than the + one through which the change was triggered. + + Refer Get Debug Configuration command for parameter description.