[Accel-config] [PATCH 7/7] accel-config: Add doumentation for new command "config-user-default"

Fenghua Yu <[email protected]> Tue, 1 Aug 2023 14:52:32 -0700
Newsgroups dev.linux.lists.accel-config
Message-ID <[email protected]>
The new command "config-user-default" and its options are documented.

Signed-off-by: Fenghua Yu <[email protected]>
Reviewed-by: Ramesh Thomas <[email protected]>
---
 Documentation/accfg/Makefile.am               |  6 +-
 .../accel-config-config-user-default.txt      | 75 +++++++++++++++++++
 2 files changed, 79 insertions(+), 2 deletions(-)
 create mode 100644 Documentation/accfg/accel-config-config-user-default.txt

diff --git a/Documentation/accfg/Makefile.am b/Documentation/accfg/Makefile.am
index 2e938ed..ed2b288 100644
--- a/Documentation/accfg/Makefile.am
+++ b/Documentation/accfg/Makefile.am
@@ -29,7 +29,8 @@ man1_MANS = \
 	accel-config-disable-device.1 \
 	accel-config-disable-wq.1 \
 	accel-config-enable-wq.1 \
-	accel-config-enable-device.1
+	accel-config-enable-device.1 \
+	accel-config-config-user-default.1
 
 EXTRA_DIST = \
 	$(man1_MANS) \
@@ -44,7 +45,8 @@ EXTRA_DIST = \
 	accel-config-disable-device.txt \
 	accel-config-disable-wq.txt \
 	accel-config-enable-wq.txt \
-	accel-config-enable-device.txt
+	accel-config-enable-device.txt \
+	accel-config-config-user-default.txt
 
 CLEANFILES = $(man1_MANS)
 
diff --git a/Documentation/accfg/accel-config-config-user-default.txt b/Documentation/accfg/accel-config-config-user-default.txt
new file mode 100644
index 0000000..612e414
--- /dev/null
+++ b/Documentation/accfg/accel-config-config-user-default.txt
@@ -0,0 +1,75 @@
+// SPDX-License-Identifier: GPL-2.0
+
+accel-config-config-user-default(1)
+===================================
+
+NAME
+----
+accel-config-config-user-default - load a pre-defined user default configuration
+
+SYNOPSIS
+--------
+[verse]
+'accel-config config-user-default' [<options>]
+
+Without an option, config-user-default loads a pre-defined user default
+configuration.
+
+There is a config file template at contrib/configs/user_default_profile.conf.
+Run "accel-config config-user-default -c user_default_profile.conf" to
+configure all available devices with the template values. Any modifications to
+the template file should retain the json format.
+
+EXAMPLE
+-------
+# accel-config config-user-default
+
+The command will load the pre-defined user default config to all available
+WQs and engines on all available DSA and IAX devices with the following
+attributes:
+	All WQs and all engines are in group 0
+
+	WQ attributes:
+	priority: 1
+	group_id: 0
+	block_on_fault: 1
+	ats_disable: 0
+	prs_disable: 1
+	mode: "shared"
+	type: "user"
+	name: "user_default_wq"
+	driver_name: "user"
+	size: max WQ size / max WQs
+	threshold: size
+	max_transfer_size: default value
+	max_batch_size: default value on DSA. N/A on IAX
+	op_config: default value
+
+	Attributes of all devices and groups are default values.
+
+# accel-config config-user-default -c /etc/accel-config/contrib/configs/user_default_profile.conf
+
+The command will load the specified user default config file. The config
+file is a template that specifies attributes and devices. User can edit
+the config file per requirements.
+
+# accel-config config-user-default -d -n <wq_name>
+The command will disable all WQs named <wq_name> (default name is
+"user_default_wq").
+
+OPTIONS
+-------
+-c::
+--config-file::
+	to specify the location of the customized user default config file
+
+-n::
+--name::
+	to specify WQ name which will be used to disable enabled WQs
+-d::
+--disable::
+	to disable the configured devices and wqs
+
+-v::
+--verbose::
+	verbose
-- 
2.31.1