From patchwork Thu Jul 20 19:02:26 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Luiz Augusto von Dentz X-Patchwork-Id: 13321000 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 1552EC001DC for ; Thu, 20 Jul 2023 19:02:42 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230049AbjGTTCl (ORCPT ); Thu, 20 Jul 2023 15:02:41 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:51720 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230042AbjGTTCi (ORCPT ); Thu, 20 Jul 2023 15:02:38 -0400 Received: from mail-pf1-x432.google.com (mail-pf1-x432.google.com [IPv6:2607:f8b0:4864:20::432]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 36F7E2D51 for ; Thu, 20 Jul 2023 12:02:31 -0700 (PDT) Received: by mail-pf1-x432.google.com with SMTP id d2e1a72fcca58-6689430d803so771676b3a.0 for ; Thu, 20 Jul 2023 12:02:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1689879750; x=1690484550; h=content-transfer-encoding:mime-version:message-id:date:subject:to :from:from:to:cc:subject:date:message-id:reply-to; bh=9/+mox3v2KbxXdDwh9oMGpsXq/Zi8ycYrIlIRRzL0a4=; b=UCN0Ye/1Dj2O2vzSLL3zQkrHIEwDbvH4rF15zJBgFDeN6hN1AelC4skT0WoQPMQG9U 68sJwc7/573z17dlcqvm6N/45jnYrcVESZ2BlINMOuaI2j5VZmnHe2j3JVmcQgBT4M0q UQeGqEVZNjfNFJkoSUsY4EQKszC4eApY19Uu794zamGDa/1qqTW4zI2iIi/KZPWz+gsr 619F6V1XsCOWCGQeUjV6JHEtJeE0XTbPYr47W2Bb9Pd+Bnd4SrWEy3I+C6PgOCPFcNq/ UyKnA7A2sUz2lf9Qtzd39kyrGaWX+sSIHZTRQ+3diQGEWdhXODdbVbD2f2ElRfYID2xk S/xw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1689879750; x=1690484550; h=content-transfer-encoding:mime-version:message-id:date:subject:to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=9/+mox3v2KbxXdDwh9oMGpsXq/Zi8ycYrIlIRRzL0a4=; b=innifFa/uUNnRhW4ZPYuIhruU2m5rp6sgqD6KgDLL0cRORoUWKQxUftT4sNH2fqPmy 54X3Aftr6TjFbY+jvQDGQpjdnkTcq4SpIEb4+DGzCtmULwTNSY4UUr4LRDUQnFAxmw+l Omc7NpRktH/Wm6GQBBNCoZAdbrRjgt4tqxlcpKtwdUPNuSNy2ak6+wMF8pi374JYvbLE XBpj9dQRlciV42imlVA4AM/80UIAuvBVIc1gV09ts8y/dR1/tZx62fHJxyxCcau08zPJ 3Xd667Z6ePWNJDIXksRw649c9ExJ1X/VzO3OffFIwNDKWaIQzm4m/V7gLV+pW/KudbD6 5D7A== X-Gm-Message-State: ABy/qLY7LArVeueVuUgINkM/0j9awdyg+yqo59/36zA/y98lSe1XsEIS fCT3cYIm5eKUGvbN1E4JYa30Qbw32Dc= X-Google-Smtp-Source: APBJJlFuU7kRhvYPqnwPqP3zolBsXPSYW22vm8nVKNKxGYqHpqF7R7qY3pE1MG2hQtrYGkdRnU2t2g== X-Received: by 2002:a05:6a00:1808:b0:668:8705:57dd with SMTP id y8-20020a056a00180800b00668870557ddmr3413232pfa.28.1689879749742; Thu, 20 Jul 2023 12:02:29 -0700 (PDT) Received: from lvondent-mobl4.. (c-71-236-201-58.hsd1.or.comcast.net. [71.236.201.58]) by smtp.gmail.com with ESMTPSA id s3-20020aa78283000000b00682a9325ffcsm1544496pfm.5.2023.07.20.12.02.28 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 20 Jul 2023 12:02:29 -0700 (PDT) From: Luiz Augusto von Dentz To: linux-bluetooth@vger.kernel.org Subject: [BlueZ PATCH v5 1/3] btmgmt: Add man page Date: Thu, 20 Jul 2023 12:02:26 -0700 Message-ID: <20230720190228.446570-1-luiz.dentz@gmail.com> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-bluetooth@vger.kernel.org From: Luiz Augusto von Dentz This adds btmgmt.rst which is then converted to btmgmt.1 using rst2man. --- Makefile.tools | 5 +-- tools/btmgmt.rst | 79 ++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 82 insertions(+), 2 deletions(-) create mode 100644 tools/btmgmt.rst diff --git a/Makefile.tools b/Makefile.tools index 7d9697001b75..c1de187bf72b 100644 --- a/Makefile.tools +++ b/Makefile.tools @@ -347,7 +347,8 @@ profiles_iap_iapd_SOURCES = profiles/iap/main.c profiles_iap_iapd_LDADD = gdbus/libgdbus-internal.la $(GLIB_LIBS) $(DBUS_LIBS) if MANPAGES -man_MANS += tools/rctest.1 tools/l2ping.1 tools/btattach.1 tools/isotest.1 +man_MANS += tools/rctest.1 tools/l2ping.1 tools/btattach.1 tools/isotest.1 \ + tools/btmgmt.1 endif if MESH @@ -468,7 +469,7 @@ manual_pages += tools/hciattach.1 tools/hciconfig.1 \ tools/hcitool.1 tools/hcidump.1 \ tools/rfcomm.1 tools/sdptool.1 tools/ciptool.1 \ tools/rctest.1 tools/l2ping.1 tools/btattach.1 \ - tools/bdaddr.1 tools/isotest.1 + tools/bdaddr.1 tools/isotest.1 tools/btmgmt.1 if HID2HCI udevdir = $(UDEV_DIR) diff --git a/tools/btmgmt.rst b/tools/btmgmt.rst new file mode 100644 index 000000000000..0159ee128f62 --- /dev/null +++ b/tools/btmgmt.rst @@ -0,0 +1,79 @@ +====== +btmgmt +====== + +------------------------------------- +interactive bluetooth management tool +------------------------------------- + +:Version: BlueZ +:Copyright: Free use of this software is granted under ther terms of the GNU + Lesser General Public Licenses (LGPL). +:Date: July 2023 +:Manual section: 1 +:Manual group: Linux System Administration + +SYNOPSIS +======== + +**btmgmt** [--options] [commands] + +DESCRIPTION +=========== + +**btmgmt(1)** interactive bluetooth management tool. The tool issues commands +to the Kernel using the Bluetooth Management socket, some commands may require +net-admin capability in order to work since the Bluetooth Management interface +is considered a low-level interface meant for the likes of **bluetoothd(8)**, +it is not recommended for applications to use it directly as it may result in +unexpected behavior. + +OPTIONS +======= + +:-i/--index: Specify adapter index +:-m-/-monitor: Enable monitor output +:-t/--timeout: Timeout in seconds for non-interactive mode +:-v/--version: Display version +:-i/--init-script: Init script file +:-h/--help: Display help + +COMMANDS +======== + +:main: See **bluetoothctl-mgmt(1)** +:monitor: See **bluetoothctl-monitor(1)** + +AUTOMATION +========== + +Two common ways to automate the tool are to pass the commands directly like in +the follow example: + +.. code-block:: + + btmgmt < X-Patchwork-Id: 13321001 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 42723EB64DA for ; Thu, 20 Jul 2023 19:02:44 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230013AbjGTTCn (ORCPT ); Thu, 20 Jul 2023 15:02:43 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:51822 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230040AbjGTTCj (ORCPT ); Thu, 20 Jul 2023 15:02:39 -0400 Received: from mail-pf1-x430.google.com (mail-pf1-x430.google.com [IPv6:2607:f8b0:4864:20::430]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 1E7A32D5E for ; Thu, 20 Jul 2023 12:02:33 -0700 (PDT) Received: by mail-pf1-x430.google.com with SMTP id d2e1a72fcca58-6686c74183cso991711b3a.1 for ; Thu, 20 Jul 2023 12:02:33 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1689879752; x=1690484552; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:from:to:cc:subject:date:message-id :reply-to; bh=YwUeNMKfNG2aVHOiaLSmwzLqv5akrnYuI5vG7Wjwnz0=; b=J8KzXa2fLo4dhJMVnJEl7SRNYmzKGBY7UVw1u5iQqTKXcqdl04gSUOeUAQxDqKaxeK wjn3B9MCbO/sHV9pCzWGqGECcy++7AwKUuKuM85bcy+MX7H1Ra8ONm12CeeIXVQO6N9Z NPcOtKxJI7vUb8fva43Mp30ae/EqtLljydYDEjW9pwr6WvFBwadqZl6ynQaSlWs4ZQhP ebQcCS+Lb8clb/WoJDNa91dzq+FL43pGDswSltD5a4gk5wVfLMgxn8dFXN5704GYRrIe TKbvSKJvv0+TjJxKP5VYHBWnyrHMrvm5nHBPwBrYU0NGWctzXfNKl4dJeAac/0D/LMqb 5oyQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1689879752; x=1690484552; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=YwUeNMKfNG2aVHOiaLSmwzLqv5akrnYuI5vG7Wjwnz0=; b=UD7DbRf7BEZRU8vPg1orW8QfeuO2v+xemGJGsGeYKYsX2xfqFrN35yUqJ32cyjsBah lVKibV/O7P3qz/H6Qmb6nSBnTyZEERx/R4qXfgt2qUS+nHSs9hnVsxopFB/KEx4t/1rP mTLeZrrSxUc4OetNagc1sp/URHcFjRaqkmscRCxOM2P/wz9wEHBdRouguMMpB0eQYdDG 8tME7dJyLnBYEAJc9OehMXqhfsT8KyihQEPVs3w8p5HLW2Y6YfL1QQGM+IwnDSTmndNF 5BSmEi6oj8hI9nBMgZIMdYoc9Gbcz367O39EbWzU2wd47nLK1Ei7eeQfXGfglp9r8y/8 UGqg== X-Gm-Message-State: ABy/qLaTQFhZK6l1RPqWUW9sfigJz15bDhQJPle8QD8sGvxpHVE5K2yO rM1UCC+8rDR2xq78EspDxTURr62Ss2w= X-Google-Smtp-Source: APBJJlEuKcbAg0AgazAnNTfmjWGV3iCqJhTLZXr5SaIGrpbV35nt84VHtcWvhfFTf8EuLe51f0qFxg== X-Received: by 2002:a05:6a20:3aa6:b0:137:db14:e88b with SMTP id d38-20020a056a203aa600b00137db14e88bmr85995pzh.29.1689879751672; Thu, 20 Jul 2023 12:02:31 -0700 (PDT) Received: from lvondent-mobl4.. (c-71-236-201-58.hsd1.or.comcast.net. [71.236.201.58]) by smtp.gmail.com with ESMTPSA id s3-20020aa78283000000b00682a9325ffcsm1544496pfm.5.2023.07.20.12.02.29 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 20 Jul 2023 12:02:30 -0700 (PDT) From: Luiz Augusto von Dentz To: linux-bluetooth@vger.kernel.org Subject: [BlueZ PATCH v5 2/3] client: Add bluetoothctl-mgmt.1 man page Date: Thu, 20 Jul 2023 12:02:27 -0700 Message-ID: <20230720190228.446570-2-luiz.dentz@gmail.com> X-Mailer: git-send-email 2.41.0 In-Reply-To: <20230720190228.446570-1-luiz.dentz@gmail.com> References: <20230720190228.446570-1-luiz.dentz@gmail.com> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-bluetooth@vger.kernel.org From: Luiz Augusto von Dentz This adds bluetoothctl-mgmt.rst which is then converted to bluetooth-mgmt.1 using rst2man. --- Makefile.tools | 5 +- client/bluetoothctl-mgmt.rst | 559 +++++++++++++++++++++++++++++++++++ 2 files changed, 562 insertions(+), 2 deletions(-) create mode 100644 client/bluetoothctl-mgmt.rst diff --git a/Makefile.tools b/Makefile.tools index c1de187bf72b..10d29108ce19 100644 --- a/Makefile.tools +++ b/Makefile.tools @@ -348,7 +348,7 @@ profiles_iap_iapd_LDADD = gdbus/libgdbus-internal.la $(GLIB_LIBS) $(DBUS_LIBS) if MANPAGES man_MANS += tools/rctest.1 tools/l2ping.1 tools/btattach.1 tools/isotest.1 \ - tools/btmgmt.1 + tools/btmgmt.1 client/bluetoothctl-mgmt.1 endif if MESH @@ -469,7 +469,8 @@ manual_pages += tools/hciattach.1 tools/hciconfig.1 \ tools/hcitool.1 tools/hcidump.1 \ tools/rfcomm.1 tools/sdptool.1 tools/ciptool.1 \ tools/rctest.1 tools/l2ping.1 tools/btattach.1 \ - tools/bdaddr.1 tools/isotest.1 tools/btmgmt.1 + tools/bdaddr.1 tools/isotest.1 tools/btmgmt.1 \ + client/bluetoothctl-mgmt.1 if HID2HCI udevdir = $(UDEV_DIR) diff --git a/client/bluetoothctl-mgmt.rst b/client/bluetoothctl-mgmt.rst new file mode 100644 index 000000000000..4baed6480c14 --- /dev/null +++ b/client/bluetoothctl-mgmt.rst @@ -0,0 +1,559 @@ +================= +bluetoothctl-mgmt +================= + +------------------ +Management Submenu +------------------ + +:Version: BlueZ +:Copyright: Free use of this software is granted under ther terms of the GNU + Lesser General Public Licenses (LGPL). +:Date: July 2023 +:Manual section: 1 +:Manual group: Linux System Administration + +SYNOPSIS +======== + +**bluetoothctl** [--options] [mgmt.commands] + +Mgmt Commands +============= + +select +------ + +Select a different index + +:Usage: **# select ** + +revision +-------- + +Get the MGMT Revision + +:Usage: **# revision** + +commands +-------- + +List supported commands + +:Usage: **# commands** + +config +------ + +Show configuration info + +:Usage: **# config** + +info +---- + +Show controller info + +:Usage: **# info** + +extinfo +------- + +Show extended controller info + +:Usage: **# extinfo** + +auto-power +---------- + +Power all available features + +:Usage: **# auto-power** + +power +----- + +Toggle powered state + +:Usage: **# power ** + +discov +------ + +Toggle discoverable state + +:Usage: **# discov [timeout]** + +connectable +----------- + +Toggle connectable state + +:Usage: **# connectable ** + +fast-conn +--------- + +Toggle fast connectable state + +:Usage: **# fast-conn ** + +bondable +-------- + +Toggle bondable state + +:Usage: **# bondable ** + +pairable +-------- + +Toggle bondable state + +:Usage: **# pairable ** + +linksec +------- + +Toggle link level security + +:Usage: **# linksec ** + +ssp +--- + +Toggle SSP mode + +:Usage: **# spp ** + +sc +-- + +Toggle SC support + +:Usage: **# sc ** + +hs +-- + +Toggle HS support + +:Usage: **# hs ** + +le +-- + +Toggle LE support + +:Usage: **# le ** + +advertising +----------- + +Toggle LE advertising + +:Usage: **# advertise ** + +bredr +----- + +Toggle BR/EDR support + +:Usage: **# bredr ** + +privacy +------- + +Toggle privacy support + +:Usage: **# privacy [irk]** + +class +----- + +Set device major/minor class + +:Usage: **# class ** + +disconnect +---------- + +Disconnect device + +:Usage: **# disconnect [-t type] ** + +con +--- + +List connections + +:Usage: **# con** + +find +---- + +Discover nearby devices + +:Usage: **# find [-l|-b] [-L]** + +find-service +------------ + +Discover nearby service + +:Usage: **# find-service [-u UUID] [-r RSSI_Threshold] [-l|-b]** + +stop-find +--------- + +Stop discovery + +:Usage: **# stop-find [-l|-b]** + +name +---- + +Set local name + +:Usage: **# name [shortname]** + +pair +---- + +Pair with a remote device + +:Usage: **# pair [-c cap] [-t type] ** + +cancelpair +---------- + +Cancel pairing + +:Usage: **# cancelpair [-t type] ** + +unpair +------ + +Unpair device + +:Usage: **# unpair [-t type] ** + +keys +---- + +Load Link Keys + +:Usage: **keys** + +ltks +---- + +Load Long Term Keys + +:Usage: **# ltks** + +irks +---- + +Load Identity Resolving Keys + +:Usage: **# irks [--local index] [--file file path]** + +block +----- + +Block Device + +:Usage: **# block [-t type] ** + +unblock +------- + +Unblock Device + +:Usage: **# unblock [-t type] ** + +add-uuid +-------- + +Add UUID + +:Usage: **# add-uuid ** + +rm-uuid +------- + +Remove UUID + +:Usage: **# rm-uuid ** + +clr-uuids +--------- + +Clear UUIDs + +:Usage: **# clear-uuids** + +local-oob +--------- + +Local OOB data + +:Usage: **# local-oob** + +remote-oob +---------- + +Remote OOB data + +:Usage: **# remote-oob [-t ] [-r ] [-h ] + [-R ] [-H ] ** + +did +--- + +Set Device ID + +:Usage: **# did :::** + +static-addr +----------- + +Set static address + +:Usage: **# static-addr
** + +public-addr +----------- + +Set public address + +:Usage: **# public-addr
** + +ext-config +---------- + +External configuration + +:Usage: **# ext-config ** + +debug-keys +---------- + +Toggle debug keys + +:Usage: **# debug-keys ** + +conn-info +--------- + +Get connection information + +:Usage: **# conn-info [-t type] ** + +io-cap +------ + +Set IO Capability + +:Usage: **# io-cap ** + +scan-params +----------- + +Set Scan Parameters + +:Usage: **# scan-params ** + +get-clock +--------- + +Get Clock Information + +:Usage: **# get-clock [address]** + +add-device +---------- + +Add Device + +:Usage: **# add-device [-a action] [-t type]
** + +del-device +---------- + +Remove Device + +:Usage: **# del-device [-t type]
** + +clr-devices +----------- + +Clear Devices + +:Usage: **# clr-devices** + +bredr-oob +--------- + +Local OOB data (BR/EDR) + +:Usage: **# bredr-oob** + +le-oob +------ + +Local OOB data (LE) + +:Usage: **# le-oob** + +advinfo +------- + +Show advertising features + +:Usage: **# advinfo** + +advsize +------- + +Show advertising size info + +:Usage: **# advsize [options] ** + +add-adv +------- + +Add advertising instance + +:Usage: **# add-adv [options] ** + +rm-adv +------ + +Remove advertising instance + +:Usage: **# rm-adv ** + +clr-adv +------- + +Clear advertising instances + +:Usage: **# clr-adv** + +add-ext-adv-params +------------------ + +Add extended advertising params + +:Usage: **# add-ext-adv-parms [options] ** + +add-ext-adv-data +---------------- + +Add extended advertising data + +:Usage: **# add-ext-adv-data [options] ** + +appearance +---------- + +Set appearance + +:Usage: **# appearance ** + +phy +--- + +Get/Set PHY Configuration + +:Usage: **# phy [LE1MTX] [LE1MRX] [LE2MTX] [LE2MRX] [LECODEDTX] [LECODEDRX] + [BR1M1SLOT] [BR1M3SLOT] [BR1M5SLOT][EDR2M1SLOT] [EDR2M3SLOT] + [EDR2M5SLOT][EDR3M1SLOT] [EDR3M3SLOT] [EDR3M5SLOT]** + +wbs +--- + +Toggle Wideband-Speech support + +:Usage: **# wbs ** + +secinfo +------- + +Show security information + +:Usage: **# secinfo** + +expinfo +------- + +Show experimental features + +:Usage: **# expinfo** + +exp-debug +--------- + +Set debug feature + +:Usage: **# exp-debug ** + +exp-privacy +----------- + +Set LL privacy feature + +:Usage: **# exp-privacy ** + +exp-quality +----------- + +Set bluetooth quality report feature + +:Usage: **# exp-quality ** + +exp-offload +----------- + +Toggle codec support + +:Usage: **# exp-offload ** + +read-sysconfig +-------------- + +Read System Configuration + +:Usage: **# read-sysconfig** + +set-sysconfig +------------- + +Set System Configuration + +:Usage: **# set-sysconfig <-v|-h> [options...]** + +get-flags +--------- + +Get device flags + + +set-flags +--------- + +Set device flags + +:Usage: **# set-flags [-f flags] [-t type]
** + +RESOURCES +========= + +http://www.bluez.org + +REPORTING BUGS +============== + +linux-bluetooth@vger.kernel.org From patchwork Thu Jul 20 19:02:28 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Luiz Augusto von Dentz X-Patchwork-Id: 13321002 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id A2E89C001DC for ; Thu, 20 Jul 2023 19:02:45 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230019AbjGTTCp (ORCPT ); Thu, 20 Jul 2023 15:02:45 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:51838 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230078AbjGTTCk (ORCPT ); Thu, 20 Jul 2023 15:02:40 -0400 Received: from mail-pf1-x435.google.com (mail-pf1-x435.google.com [IPv6:2607:f8b0:4864:20::435]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id DF6312D70 for ; Thu, 20 Jul 2023 12:02:34 -0700 (PDT) Received: by mail-pf1-x435.google.com with SMTP id d2e1a72fcca58-666ecf9a081so984355b3a.2 for ; Thu, 20 Jul 2023 12:02:34 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1689879753; x=1690484553; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:from:to:cc:subject:date:message-id :reply-to; bh=hbfdkufRNOJQU/a0ykvT+J03mTPh81jbTpSPr0lKDz8=; b=hDPcCkEHWVUMSpoECJ5d9QW1nc6hl/k8yuocd4DfhT4YJMHMWaAfbemtOrd1LFSQGT 0dUH56vaRhj4qMvmpcz3i0bvN8fQ3xg19yLK7Q/BWQVDD7nMLL74j+dLLhJlm6ALXDvV LElezlOtoqGmpfa4+7nepYQ8ToETBSeHmoawZ7rdKAPYps44Pk/YTKg4Bas+z+CYWh8b UTH0Rgh1tKPtt+7UPhiK9WceHPuCADOsrtqoinMHPIB+olTcdyIF6uzKtgrT8I47qnHL zBlRDXUMHFiGDnsF57DY1mDKkQtb5Ygy7RfE5oPS5HdVViQAzPZV6d9TQaLJQSHtF6LT a0eg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1689879753; x=1690484553; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=hbfdkufRNOJQU/a0ykvT+J03mTPh81jbTpSPr0lKDz8=; b=I6kZpcL5lSzpyc9/Ij2xXV6jLXTJBkaSItetJdZcYVpfUL126DAU/Z24t2dCPt1oH3 CeigIQPOg13IGPeoRlJclgF6bT60mCe4dBSqUGT1ZXuwrsmol1llYd53W8nGzFx3w7im ng1p9c5RPlHzvUME1DynYnKloT+wh4L001c8gwvr9nk/rsq1HKzt9hLICTL6HeUV5xgI W9TPCPMWvNiS8qRL6wXeidC8FOWbU5PYYqgD8/htenyj6W9F3YIlH4xHgzxVVa9lhII+ tGH2vhRkSu5Fly4MfZTsWyvVEHHtmo+w3UUp+yZDUIvdwb/8gNMBneJUAOcDytR8ezgJ 2Cig== X-Gm-Message-State: ABy/qLaBAb/AyNmhlEnoEAqgO87QGRThoMukLKzgdDkfAgUSn1X1Skgd ZsIhlJOslfd7wI5MrOxSoWhgzmsAO9U= X-Google-Smtp-Source: APBJJlEAa+yCQVy8hSy3qre2BNjedsyzkPKkWcNy2I0XRZQ+9Jj0XY2WUUkvTwqbQbICJ3AIwlipsA== X-Received: by 2002:a05:6a00:21d4:b0:686:22de:6365 with SMTP id t20-20020a056a0021d400b0068622de6365mr11524493pfj.8.1689879753554; Thu, 20 Jul 2023 12:02:33 -0700 (PDT) Received: from lvondent-mobl4.. (c-71-236-201-58.hsd1.or.comcast.net. [71.236.201.58]) by smtp.gmail.com with ESMTPSA id s3-20020aa78283000000b00682a9325ffcsm1544496pfm.5.2023.07.20.12.02.31 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 20 Jul 2023 12:02:32 -0700 (PDT) From: Luiz Augusto von Dentz To: linux-bluetooth@vger.kernel.org Subject: [BlueZ PATCH v5 3/3] client: Add bluetoothctl-monitor.1 man page Date: Thu, 20 Jul 2023 12:02:28 -0700 Message-ID: <20230720190228.446570-3-luiz.dentz@gmail.com> X-Mailer: git-send-email 2.41.0 In-Reply-To: <20230720190228.446570-1-luiz.dentz@gmail.com> References: <20230720190228.446570-1-luiz.dentz@gmail.com> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-bluetooth@vger.kernel.org From: Luiz Augusto von Dentz This adds bluetoothctl-monitor.rst which is then converted to bluetoothctl-mgmt.1 using rst2man. --- Makefile.tools | 6 ++- client/bluetoothctl-monitor.rst | 89 +++++++++++++++++++++++++++++++++ 2 files changed, 93 insertions(+), 2 deletions(-) create mode 100644 client/bluetoothctl-monitor.rst diff --git a/Makefile.tools b/Makefile.tools index 10d29108ce19..0bc0f232da91 100644 --- a/Makefile.tools +++ b/Makefile.tools @@ -348,7 +348,8 @@ profiles_iap_iapd_LDADD = gdbus/libgdbus-internal.la $(GLIB_LIBS) $(DBUS_LIBS) if MANPAGES man_MANS += tools/rctest.1 tools/l2ping.1 tools/btattach.1 tools/isotest.1 \ - tools/btmgmt.1 client/bluetoothctl-mgmt.1 + tools/btmgmt.1 client/bluetoothctl-mgmt.1 \ + client/bluetoothctl-monitor.1 endif if MESH @@ -470,7 +471,8 @@ manual_pages += tools/hciattach.1 tools/hciconfig.1 \ tools/rfcomm.1 tools/sdptool.1 tools/ciptool.1 \ tools/rctest.1 tools/l2ping.1 tools/btattach.1 \ tools/bdaddr.1 tools/isotest.1 tools/btmgmt.1 \ - client/bluetoothctl-mgmt.1 + client/bluetoothctl-mgmt.1 \ + client/bluetoothctl-monitor.1 if HID2HCI udevdir = $(UDEV_DIR) diff --git a/client/bluetoothctl-monitor.rst b/client/bluetoothctl-monitor.rst new file mode 100644 index 000000000000..2357a56ace36 --- /dev/null +++ b/client/bluetoothctl-monitor.rst @@ -0,0 +1,89 @@ +==================== +bluetoothctl-monitor +==================== + +--------------- +Monitor Submenu +--------------- + +:Version: BlueZ +:Copyright: Free use of this software is granted under ther terms of the GNU + Lesser General Public Licenses (LGPL). +:Date: July 2023 +:Manual section: 1 +:Manual group: Linux System Administration + +SYNOPSIS +======== + +**bluetoothctl** [--options] [monitor.commands] + +Monitor Commands +================ + +set-rssi-threshold +------------------ + +Set RSSI threshold parameter + +:Usage: **# set-rssi-threshold ** + +set-rssi-timeout +---------------- + +Set RSSI timeout parameter + +:Usage: **# set-rssi-timeout ** + +set-rssi-sampling-period +------------------------- + +Set RSSI sampling period parameter + +:Usage: **# set-rssi-timeout ** + +add-or-pattern +-------------- + +Register 'or pattern' type monitor with the specified RSSI parameters + +:Usage: **# add-or-pattern [patterns=pattern1 pattern2 ...]** + +get-pattern +----------- + +Get advertisement monitor + +:Usage: **# get-pattern ** + +remove-pattern +-------------- + +Remove advertisement monitor + +:Usage: **# remove-pattern ** + +get-supported-info +------------------ + +Get advertisement manager supported features and supported monitor types + +:Usage: **# get-supported-info** + +print-usage +----------- + +Print the command usage + +:Usage: **# print-usage ** + +RESOURCES +========= + +http://www.bluez.org + +REPORTING BUGS +============== + +linux-bluetooth@vger.kernel.org +