File ndctl-Documentation-refactor-bus-options-into-its-own-incl.patch of Package ndctl.15916
From 9faff14692fc4d9f1871a32616c17418b5fc9a66 Mon Sep 17 00:00:00 2001
From: Vishal Verma <vishal.l.verma@intel.com>
Date: Wed, 28 Aug 2019 16:44:02 -0600
Subject: [PATCH 1/2] Documentation: refactor 'bus options' into its own
include
References: bsc#1173861
Patch-mainline: v67
Git-commit: 470ebeec2afed4d961de7fb9832fa2bfe70612e6
Create a new 'xable-bus-options.txt' file that is included everywhere
that previously relied upon xable-region-options.txt for bus options
inclusion.
While at it, fix the formatting for the first description text block
from an include - the empty line at the start caused the first block to
be incorrectly indented. This fixes both the dimm and region variants.
Cc: Dan Williams <dan.j.williams@intel.com>
Signed-off-by: Vishal Verma <vishal.l.verma@intel.com>
---
Documentation/ndctl/ndctl-check-namespace.txt | 4 ++++
Documentation/ndctl/ndctl-create-namespace.txt | 4 ++++
Documentation/ndctl/ndctl-disable-dimm.txt | 4 ++++
Documentation/ndctl/ndctl-disable-region.txt | 4 ++++
Documentation/ndctl/ndctl-enable-dimm.txt | 4 ++++
Documentation/ndctl/ndctl-enable-region.txt | 4 ++++
Documentation/ndctl/ndctl-freeze-security.txt | 4 ++++
Documentation/ndctl/ndctl-inject-error.txt | 4 ++++
Documentation/ndctl/ndctl-list.txt | 4 ++++
Documentation/ndctl/ndctl-remove-passphrase.txt | 4 ++++
Documentation/ndctl/ndctl-sanitize-dimm.txt | 4 ++++
Documentation/ndctl/ndctl-setup-passphrase.txt | 4 ++++
Documentation/ndctl/ndctl-update-firmware.txt | 4 ++++
Documentation/ndctl/ndctl-update-passphrase.txt | 4 ++++
Documentation/ndctl/ndctl-wait-overwrite.txt | 4 ++++
Documentation/ndctl/xable-bus-options.txt | 4 ++++
Documentation/ndctl/xable-dimm-options.txt | 13 +++----------
Documentation/ndctl/xable-namespace-options.txt | 4 ++++
Documentation/ndctl/xable-region-options.txt | 13 +++----------
19 files changed, 74 insertions(+), 20 deletions(-)
create mode 100644 Documentation/ndctl/xable-bus-options.txt
diff --git a/Documentation/ndctl/ndctl-check-namespace.txt b/Documentation/ndctl/ndctl-check-namespace.txt
index 2ece4e770305..222f72982a6c 100644
--- a/Documentation/ndctl/ndctl-check-namespace.txt
+++ b/Documentation/ndctl/ndctl-check-namespace.txt
@@ -69,6 +69,10 @@ OPTIONS
--region=::
include::xable-region-options.txt[]
+-b::
+--bus=::
+include::xable-bus-options.txt[]
+
include::../copyright.txt[]
SEE ALSO
diff --git a/Documentation/ndctl/ndctl-create-namespace.txt b/Documentation/ndctl/ndctl-create-namespace.txt
index 343733dedfd9..c9ae27c30247 100644
--- a/Documentation/ndctl/ndctl-create-namespace.txt
+++ b/Documentation/ndctl/ndctl-create-namespace.txt
@@ -211,6 +211,10 @@ OPTIONS
--region=::
include::xable-region-options.txt[]
+-b::
+--bus=::
+include::xable-bus-options.txt[]
+
include::../copyright.txt[]
SEE ALSO
diff --git a/Documentation/ndctl/ndctl-disable-dimm.txt b/Documentation/ndctl/ndctl-disable-dimm.txt
index 7706ac351abc..caa671470e83 100644
--- a/Documentation/ndctl/ndctl-disable-dimm.txt
+++ b/Documentation/ndctl/ndctl-disable-dimm.txt
@@ -19,6 +19,10 @@ OPTIONS
<dimm>::
include::xable-dimm-options.txt[]
+-b::
+--bus=::
+include::xable-bus-options.txt[]
+
include::../copyright.txt[]
SEE ALSO
diff --git a/Documentation/ndctl/ndctl-disable-region.txt b/Documentation/ndctl/ndctl-disable-region.txt
index ea1fd3ac0008..3ca65a665c9a 100644
--- a/Documentation/ndctl/ndctl-disable-region.txt
+++ b/Documentation/ndctl/ndctl-disable-region.txt
@@ -19,6 +19,10 @@ OPTIONS
<region>::
include::xable-region-options.txt[]
+-b::
+--bus=::
+include::xable-bus-options.txt[]
+
include::../copyright.txt[]
SEE ALSO
diff --git a/Documentation/ndctl/ndctl-enable-dimm.txt b/Documentation/ndctl/ndctl-enable-dimm.txt
index cd9908d41696..3e7106c49897 100644
--- a/Documentation/ndctl/ndctl-enable-dimm.txt
+++ b/Documentation/ndctl/ndctl-enable-dimm.txt
@@ -19,6 +19,10 @@ OPTIONS
<dimm>::
include::xable-dimm-options.txt[]
+-b::
+--bus=::
+include::xable-bus-options.txt[]
+
include::../copyright.txt[]
SEE ALSO
diff --git a/Documentation/ndctl/ndctl-enable-region.txt b/Documentation/ndctl/ndctl-enable-region.txt
index e5cbddbe6cf7..96c2d1e15ca6 100644
--- a/Documentation/ndctl/ndctl-enable-region.txt
+++ b/Documentation/ndctl/ndctl-enable-region.txt
@@ -19,6 +19,10 @@ OPTIONS
<region>::
include::xable-region-options.txt[]
+-b::
+--bus=::
+include::xable-bus-options.txt[]
+
include::../copyright.txt[]
SEE ALSO
diff --git a/Documentation/ndctl/ndctl-freeze-security.txt b/Documentation/ndctl/ndctl-freeze-security.txt
index 573577194183..aa06e03ce440 100644
--- a/Documentation/ndctl/ndctl-freeze-security.txt
+++ b/Documentation/ndctl/ndctl-freeze-security.txt
@@ -54,6 +54,10 @@ OPTIONS
<dimm>::
include::xable-dimm-options.txt[]
+-b::
+--bus=::
+include::xable-bus-options.txt[]
+
-v::
--verbose::
Emit debug messages.
diff --git a/Documentation/ndctl/ndctl-inject-error.txt b/Documentation/ndctl/ndctl-inject-error.txt
index 744ea5048f4b..da376ecfb1cc 100644
--- a/Documentation/ndctl/ndctl-inject-error.txt
+++ b/Documentation/ndctl/ndctl-inject-error.txt
@@ -112,6 +112,10 @@ include::human-option.txt[]
--region=::
include::xable-region-options.txt[]
+-b::
+--bus=::
+include::xable-bus-options.txt[]
+
include::../copyright.txt[]
SEE ALSO
diff --git a/Documentation/ndctl/ndctl-list.txt b/Documentation/ndctl/ndctl-list.txt
index bdd69add9f22..0bb433d1ed47 100644
--- a/Documentation/ndctl/ndctl-list.txt
+++ b/Documentation/ndctl/ndctl-list.txt
@@ -62,6 +62,10 @@ OPTIONS
--region=::
include::xable-region-options.txt[]
+-b::
+--bus=::
+include::xable-bus-options.txt[]
+
-d::
--dimm=::
An 'nmemX' device name, or dimm id number. The dimm id number
diff --git a/Documentation/ndctl/ndctl-remove-passphrase.txt b/Documentation/ndctl/ndctl-remove-passphrase.txt
index 3e838bbafde5..f14e64946660 100644
--- a/Documentation/ndctl/ndctl-remove-passphrase.txt
+++ b/Documentation/ndctl/ndctl-remove-passphrase.txt
@@ -25,6 +25,10 @@ OPTIONS
<dimm>::
include::xable-dimm-options.txt[]
+-b::
+--bus=::
+include::xable-bus-options.txt[]
+
-v::
--verbose::
Emit debug messages.
diff --git a/Documentation/ndctl/ndctl-sanitize-dimm.txt b/Documentation/ndctl/ndctl-sanitize-dimm.txt
index 7f57a11572de..0bac1542ae33 100644
--- a/Documentation/ndctl/ndctl-sanitize-dimm.txt
+++ b/Documentation/ndctl/ndctl-sanitize-dimm.txt
@@ -38,6 +38,10 @@ OPTIONS
<dimm>::
include::xable-dimm-options.txt[]
+-b::
+--bus=::
+include::xable-bus-options.txt[]
+
-c::
--crypto-erase::
Replace the media encryption key on the NVDIMM causing all existing
diff --git a/Documentation/ndctl/ndctl-setup-passphrase.txt b/Documentation/ndctl/ndctl-setup-passphrase.txt
index b22d352388cc..1219279b4c66 100644
--- a/Documentation/ndctl/ndctl-setup-passphrase.txt
+++ b/Documentation/ndctl/ndctl-setup-passphrase.txt
@@ -34,6 +34,10 @@ OPTIONS
<dimm>::
include::xable-dimm-options.txt[]
+-b::
+--bus=::
+include::xable-bus-options.txt[]
+
-k::
--key_handle=::
Handle for the master 'kek' (key-encryption-key) that will be used for
diff --git a/Documentation/ndctl/ndctl-update-firmware.txt b/Documentation/ndctl/ndctl-update-firmware.txt
index 449d85810546..1aa7fee502ca 100644
--- a/Documentation/ndctl/ndctl-update-firmware.txt
+++ b/Documentation/ndctl/ndctl-update-firmware.txt
@@ -24,6 +24,10 @@ OPTIONS
<dimm>::
include::xable-dimm-options.txt[]
+-b::
+--bus=::
+include::xable-bus-options.txt[]
+
-f::
--firmware::
firmware file used to perform the update
diff --git a/Documentation/ndctl/ndctl-update-passphrase.txt b/Documentation/ndctl/ndctl-update-passphrase.txt
index 995efec64370..c7c1bfc8ab0b 100644
--- a/Documentation/ndctl/ndctl-update-passphrase.txt
+++ b/Documentation/ndctl/ndctl-update-passphrase.txt
@@ -31,6 +31,10 @@ OPTIONS
<dimm>::
include::xable-dimm-options.txt[]
+-b::
+--bus=::
+include::xable-bus-options.txt[]
+
-k::
--key_handle=::
Handle for the master 'kek' (key-encryption-key) that will be used for
diff --git a/Documentation/ndctl/ndctl-wait-overwrite.txt b/Documentation/ndctl/ndctl-wait-overwrite.txt
index 0fada3623e6e..eb24f390cc41 100644
--- a/Documentation/ndctl/ndctl-wait-overwrite.txt
+++ b/Documentation/ndctl/ndctl-wait-overwrite.txt
@@ -23,6 +23,10 @@ OPTIONS
<dimm>::
include::xable-dimm-options.txt[]
+-b::
+--bus=::
+include::xable-bus-options.txt[]
+
-v::
--verbose::
Emit debug messages.
diff --git a/Documentation/ndctl/xable-bus-options.txt b/Documentation/ndctl/xable-bus-options.txt
new file mode 100644
index 000000000000..8813113797c6
--- /dev/null
+++ b/Documentation/ndctl/xable-bus-options.txt
@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: GPL-2.0
+Enforce that the operation only be carried on devices that are
+attached to the given bus. Where 'bus' can be a provider name or a bus
+id number.
diff --git a/Documentation/ndctl/xable-dimm-options.txt b/Documentation/ndctl/xable-dimm-options.txt
index 709e2e4202dd..8826c2ba1300 100644
--- a/Documentation/ndctl/xable-dimm-options.txt
+++ b/Documentation/ndctl/xable-dimm-options.txt
@@ -1,11 +1,4 @@
// SPDX-License-Identifier: GPL-2.0
-
- A 'nmemX' device name, or a dimm id number. The keyword 'all' can
- be specified to carry out the operation on every dimm in the system,
- optionally filtered by bus id (see --bus= option).
-
--b::
---bus=::
- Enforce that the operation only be carried on devices that are
- attached to the given bus. Where 'bus' can be a provider name or a bus
- id number.
+A 'nmemX' device name, or a dimm id number. The keyword 'all' can
+be specified to carry out the operation on every dimm in the system,
+optionally filtered by bus id (see --bus= option).
diff --git a/Documentation/ndctl/xable-namespace-options.txt b/Documentation/ndctl/xable-namespace-options.txt
index babc248f2288..1a25fee855df 100644
--- a/Documentation/ndctl/xable-namespace-options.txt
+++ b/Documentation/ndctl/xable-namespace-options.txt
@@ -9,6 +9,10 @@ the operation on every namespace in the system, optionally filtered by region
--region=::
include::xable-region-options.txt[]
+-b::
+--bus=::
+include::xable-bus-options.txt[]
+
-v::
--verbose::
Emit debug messages for the namespace operation
diff --git a/Documentation/ndctl/xable-region-options.txt b/Documentation/ndctl/xable-region-options.txt
index 69d39266a4f1..d5198f5de465 100644
--- a/Documentation/ndctl/xable-region-options.txt
+++ b/Documentation/ndctl/xable-region-options.txt
@@ -1,11 +1,4 @@
// SPDX-License-Identifier: GPL-2.0
-
- A 'regionX' device name, or a region id number. The keyword 'all' can
- be specified to carry out the operation on every region in the system,
- optionally filtered by bus id (see --bus= option).
-
--b::
---bus=::
- Enforce that the operation only be carried on devices that are
- attached to the given bus. Where 'bus' can be a provider name or a bus
- id number.
+A 'regionX' device name, or a region id number. The keyword 'all' can
+be specified to carry out the operation on every region in the system,
+optionally filtered by bus id (see --bus= option).
--
2.26.2