Skip to content

Commit

Permalink
doc: Add nvme commands latency option
Browse files Browse the repository at this point in the history
Since the nvme commands using NVME_ARGS() macro added the latency option.

Signed-off-by: Tokunori Ikegami <[email protected]>
  • Loading branch information
ikegami-t committed Dec 29, 2023
1 parent 92c9414 commit 810197e
Show file tree
Hide file tree
Showing 102 changed files with 491 additions and 26 deletions.
10 changes: 5 additions & 5 deletions Documentation/nvme-admin-passthru.txt
Original file line number Diff line number Diff line change
Expand Up @@ -24,8 +24,8 @@ SYNOPSIS
[--dry-run | -d]
[--raw-binary | -b]
[--prefill=<prefill> | -p <prefill>]
[--latency | -L]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
[--latency | -L]

DESCRIPTION
-----------
Expand Down Expand Up @@ -110,10 +110,6 @@ OPTIONS
value. It may also be useful if you need to confirm if a device
is overwriting a buffer for a data-in command.

-L::
--latency::
Print out the latency the IOCTL took (in us).

-o <fmt>::
--output-format=<fmt>::
Set the reporting format to 'normal', 'json' or 'binary'. Only one
Expand All @@ -123,6 +119,10 @@ OPTIONS
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

-t <timeout>::
--timeout=<timeout>::
Override default timeout value. In milliseconds.
Expand Down
5 changes: 5 additions & 0 deletions Documentation/nvme-ana-log.txt
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ SYNOPSIS
[verse]
'nvme ana-log' <device> [--groups | -g]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
[--latency | -L]

DESCRIPTION
-----------
Expand Down Expand Up @@ -38,6 +39,10 @@ OPTIONS
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

EXAMPLES
--------
* Print the ANA log page in a human readable format:
Expand Down
5 changes: 5 additions & 0 deletions Documentation/nvme-attach-ns.txt
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ SYNOPSIS
'nvme attach-ns' <device> [--namespace-id=<nsid> | -n <nsid>]
[--controllers=<ctrl-list,> | -c <ctrl-list,>]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
[--latency | -L]

DESCRIPTION
-----------
Expand Down Expand Up @@ -38,6 +39,10 @@ OPTIONS
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

EXAMPLES
--------
Attach namespace to the controller:
Expand Down
5 changes: 5 additions & 0 deletions Documentation/nvme-boot-part-log.txt
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ SYNOPSIS
'nvme boot-part-log' <device> [--lsp=<field> | -s <field>]
[--output-file=<file> | -f <file>]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
[--latency | -L]

DESCRIPTION
-----------
Expand Down Expand Up @@ -42,6 +43,10 @@ OPTIONS
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

EXAMPLES
--------
* Retrieve Boot Partition data to boot_part_log.bin
Expand Down
5 changes: 5 additions & 0 deletions Documentation/nvme-capacity-mgmt.txt
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ SYNOPSIS
[--cap-lower=<cap-lower> | -l <cap-lower>]
[--cap-upper=<cap-upper> | -u <cap-upper>]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
[--latency | -L]

DESCRIPTION
-----------
Expand Down Expand Up @@ -55,6 +56,10 @@ OPTIONS
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

EXAMPLES
--------
No examples provided yet.
Expand Down
5 changes: 5 additions & 0 deletions Documentation/nvme-changed-ns-list-log.txt
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ SYNOPSIS
[verse]
'nvme changed-ns-list-log' <device> [--raw-binary | -b]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
[--latency | -L]

DESCRIPTION
-----------
Expand Down Expand Up @@ -40,6 +41,10 @@ OPTIONS
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

EXAMPLES
--------
* Print the Changed Namespace List Log page in a human readable format:
Expand Down
5 changes: 5 additions & 0 deletions Documentation/nvme-check-dhchap-key.txt
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ SYNOPSIS
[verse]
'nvme check-dhchap-key' [--key=<key>]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
[--latency | -L]

DESCRIPTION
-----------
Expand All @@ -32,6 +33,10 @@ OPTIONS
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

EXAMPLES
--------
No Examples
Expand Down
4 changes: 4 additions & 0 deletions Documentation/nvme-check-tls-key.txt
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,10 @@ OPTIONS
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

EXAMPLES
--------
No Examples
Expand Down
5 changes: 5 additions & 0 deletions Documentation/nvme-cmdset-ind-id-ns.txt
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ SYNOPSIS
'nvme cmdset-ind-id-ns' <device> [--namespace-id=<nsid> | -n <nsid>]
[--raw-binary | -b] [--human-readable | -H]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
[--latency | -L]

DESCRIPTION
-----------
Expand Down Expand Up @@ -55,6 +56,10 @@ OPTIONS
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

EXAMPLES
--------
* Has the program interpret the returned buffer and display the known
Expand Down
10 changes: 5 additions & 5 deletions Documentation/nvme-compare.txt
Original file line number Diff line number Diff line change
Expand Up @@ -25,11 +25,11 @@ SYNOPSIS
[--dsm=<dsm> | -D <dsm>]
[--show-command | -V]
[--dry-run | -w]
[--latency | -L]
[--storage-tag<storage-tag> | -g <storage-tag>]
[--storage-tag-check | -C]
[--force]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
[--latency | -L]

DESCRIPTION
-----------
Expand Down Expand Up @@ -137,10 +137,6 @@ metadata is passes.
--show-cmd option _must_ be set. Otherwise --dry-run option will be
_ignored_.

-L::
--latency::
Print out the latency the IOCTL took (in us).

-g <storage-tag>::
--storage-tag=<storage-tag>::
Variable Sized Expected Logical Block Storage Tag(ELBST).
Expand All @@ -163,6 +159,10 @@ metadata is passes.
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

EXAMPLES
--------
No examples yet.
Expand Down
5 changes: 5 additions & 0 deletions Documentation/nvme-config.txt
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ SYNOPSIS
[--duplicate-connect | -D] [--disable-sqflow | -d]
[--hdr-digest | -g] [--data-digest | -G]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
[--latency | -L]

DESCRIPTION
-----------
Expand Down Expand Up @@ -190,6 +191,10 @@ OPTIONS
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

EXAMPLES
--------
* Read the current system configuration and write the contents to /tmp/config.json:
Expand Down
5 changes: 5 additions & 0 deletions Documentation/nvme-connect-all.txt
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ SYNOPSIS
[--dump-config | -O] [--nbft] [--no-nbft]
[--nbft-path=<STR>] [--context=<STR>]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
[--latency | -L]

DESCRIPTION
-----------
Expand Down Expand Up @@ -216,6 +217,10 @@ OPTIONS
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

EXAMPLES
--------
* Connect to all records returned by the Discover Controller with IP4 address
Expand Down
5 changes: 5 additions & 0 deletions Documentation/nvme-connect.txt
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ SYNOPSIS
[--hdr-digest | -g] [--data-digest | -G] [--tls]
[--dump-config | -O] [--application=<id>]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
[--latency | -L]

DESCRIPTION
-----------
Expand Down Expand Up @@ -193,6 +194,10 @@ OPTIONS
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

EXAMPLES
--------
* Connect to a subsystem named nqn.2014-08.com.example:nvme:nvm-subsystem-sn-d78432
Expand Down
5 changes: 5 additions & 0 deletions Documentation/nvme-copy.txt
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,7 @@ SYNOPSIS
[--dir-spec=<spec> | -S <spec>]
[--format=<entry-format> | -F <entry-format>]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
[--latency | -L]

DESCRIPTION
-----------
Expand Down Expand Up @@ -122,6 +123,10 @@ OPTIONS
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

EXAMPLES
--------
No examples yet.
Expand Down
5 changes: 5 additions & 0 deletions Documentation/nvme-create-ns.txt
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ SYNOPSIS
[--rnumzrwa=<rnumzrwa> | -u <rnumzrwa>]
[--phndls=<placement-handle-list,> | -p <placement-handle-list,>]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
[--latency | -L]

DESCRIPTION
-----------
Expand Down Expand Up @@ -144,6 +145,10 @@ OPTIONS
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

-t <timeout>::
--timeout=<timeout>::
Override default timeout value. In milliseconds.
Expand Down
5 changes: 5 additions & 0 deletions Documentation/nvme-delete-ns.txt
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ SYNOPSIS
[verse]
'nvme delete-ns' <device> [--namespace-id=<nsid> | -n <nsid>]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
[--latency | -L]

DESCRIPTION
-----------
Expand All @@ -35,6 +36,10 @@ OPTIONS
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

EXAMPLES
--------
No examples yet.
Expand Down
5 changes: 5 additions & 0 deletions Documentation/nvme-detach-ns.txt
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ SYNOPSIS
'nvme detach-ns' <device> [--namespace-id=<nsid> | -n <nsid>]
[--controllers=<ctrl-list,> | -c <ctrl-list,>
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
[--latency | -L]

DESCRIPTION
-----------
Expand Down Expand Up @@ -38,6 +39,10 @@ OPTIONS
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

EXAMPLES
--------
No examples yet.
Expand Down
5 changes: 5 additions & 0 deletions Documentation/nvme-device-self-test.txt
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ SYNOPSIS
'nvme device-self-test' <device> [--namespace-id=<NUM> | -n <NUM>]
[--self-test-code=<NUM> | -s <NUM>] [--wait | -w]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
[--latency | -L]

DESCRIPTION
-----------
Expand Down Expand Up @@ -52,6 +53,10 @@ OPTIONS
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

EXAMPLES
--------
* Start a short device self-test in the namespace-id 1:
Expand Down
5 changes: 5 additions & 0 deletions Documentation/nvme-dim.txt
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ SYNOPSIS
'nvme dim' [--task=<task> | -t <task>] [--nqn=<nqn> | -n <nqn>]
[--device=<device> | -d <device>]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
[--latency | -L]

DESCRIPTION
-----------
Expand Down Expand Up @@ -60,6 +61,10 @@ OPTIONS
--verbose::
Increase the information detail in the output.

-L::
--latency::
Print out the latency the IOCTL took (in us).

EXAMPLES
--------
* Register with the Central Discovery Controller (CDC) named
Expand Down
Loading

0 comments on commit 810197e

Please sign in to comment.