Received-SPF: pass (google.com: domain of linux-bluetooth-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
Date:   Tue,  3 Aug 2021 19:43:17 +0800
In-Reply-To: <20210803114317.801840-1-howardchung@google.com>
Message-Id: <20210803194127.Bluez.v9.13.Ide727bc4654c80ce67a268b624a6c5a0f79a11e1@changeid>
Mime-Version: 1.0
References: <20210803114317.801840-1-howardchung@google.com>
Subject: [Bluez PATCH v9 13/13] doc: add admin policy file storage description
From:   Howard Chung <howardchung@google.com>
To:     linux-bluetooth@vger.kernel.org, luiz.dentz@gmail.com
Cc:     Yun-Hao Chung <howardchung@chromium.org>
Content-Type: text/plain; charset="UTF-8"
Precedence: bulk

From: Yun-Hao Chung <howardchung@chromium.org>

This adds storage description of admin policy file in
doc/settings-storage.txt
---

(no changes since v1)

 doc/settings-storage.txt | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/doc/settings-storage.txt b/doc/settings-storage.txt
index d21150f09ecb..1d96cd66d94f 100644
--- a/doc/settings-storage.txt
+++ b/doc/settings-storage.txt
@@ -36,6 +36,7 @@ root, named based on the address, which contains:
 
  - a settings file for the local adapter
  - an attributes file containing attributes of supported LE services
+ - an admin policy file containing current values of admin policies
  - a cache directory containing:
     - one file per device, named by remote device address, which contains
     device name
@@ -50,6 +51,7 @@ So the directory structure is:
     /var/lib/bluetooth/<adapter address>/
         ./settings
         ./attributes
+	./admin_policy_settings
         ./cache/
             ./<remote device address>
             ./<remote device address>
@@ -140,6 +142,24 @@ Sample:
   Value=4578616D706C6520446576696365
 
 
+Admin Policy file format
+======================
+
+The admin policy file stores the current value of each admin policy.
+
+[General] group contains:
+
+  ServiceAllowlist	List of		List of service UUID allowed by
+			strings		adapter in 128-bits format, separated
+					by ','. Default is empty.
+
+Sample:
+  [General]
+  ServiceAllowlist=
+
+
+
+
 CCC file format
 ======================
 
-- 
2.32.0.554.ge1b32706d8-goog