diff --git a/Documentation/nvme-reachability-associations-log.txt b/Documentation/nvme-reachability-associations-log.txt new file mode 100644 index 0000000000..6adf57b830 --- /dev/null +++ b/Documentation/nvme-reachability-associations-log.txt @@ -0,0 +1,56 @@ +nvme-reachability-associations-log(1) +===================================== + +NAME +---- +nvme-reachability-associations-log - Retrieve Reachability Associations Log, show it + +SYNOPSIS +-------- +[verse] +'nvme reachability-associations-log' [--associations-only | -a] [--rae | -r] + [--verbose | -v] [--output-format= | -o ] + [--timeout=] + +DESCRIPTION +----------- +Retrieve Reachability Associations Log, show it + +The parameter is mandatory NVMe character device (ex: /dev/nvme0). + +On success it returns 0, error code otherwise. + +OPTIONS +------- +-a:: +--associations-only:: + Return associations Only. + +-r:: +--rae:: + Retain an Asynchronous Event. + +-v:: +--verbose:: + Increase the information detail in the output. + +-o :: +--output-format=:: + Set the reporting format to 'normal', 'json' or 'binary'. Only one + output format can be used at a time. + +-t :: +--timeout=:: + Override default timeout value. In milliseconds. + +EXAMPLES +-------- +* Has the program issue a reachability-associations-log ++ +------------ +# nvme reachability-associations-log /dev/nvme0 +------------ + +NVME +---- +Part of the nvme-user suite. diff --git a/completions/_nvme b/completions/_nvme index 68e97a88e3..324b070e07 100644 --- a/completions/_nvme +++ b/completions/_nvme @@ -114,6 +114,7 @@ _nvme () { 'changed-ns-list-log:retrieve changed allocated namespaces log' 'dispersed-ns-participating-nss-log:retrieve dispersed namespace participating NVM subsystems log' 'reachability-groups-log:retrieve reachability groups log' + 'reachability-associations-log:retrieve reachability associations log' 'version:show the program version' 'ocp:OCP cloud SSD extensions' 'solidigm:Solidigm plug-in extensions' @@ -2693,6 +2694,24 @@ _nvme () { _arguments '*:: :->subcmds' _describe -t commands "nvme reachability-groups-log" _rg_log ;; + (reachability-associations-log) + local _ra_log + _caplog=( + /dev/nvme':supply a device to use (required)' + --associations-only':Return Associations Only' + -a':alias for --associations-only' + --rae':Retain an Asynchronous Event' + -r':alias for --rae' + --verbose':Increase the information detail in the output.' + -v':alias for --verbose' + --output-format=':Output format: normal|json|binary' + -o ':alias for --output-format' + --timeout=':value for timeout' + -t ':alias for --timeout' + ) + _arguments '*:: :->subcmds' + _describe -t commands "nvme reachability-associationsroups-log" _ra_log + ;; (version) local _version _version=( diff --git a/completions/bash-nvme-completion.sh b/completions/bash-nvme-completion.sh index 9903603fa2..949f4da506 100644 --- a/completions/bash-nvme-completion.sh +++ b/completions/bash-nvme-completion.sh @@ -505,7 +505,11 @@ nvme_list_opts () { --timeout= -t" ;; "reachability-groups-log") - opts+=" --groups-only -g --rae -r --verbose -v \ + opts+=" --groups-only -g --rae -r --verbose -v \ + --output-format= -o --timeout= -t" + ;; + "reachability-associations-log") + opts+=" --associations-only -a --rae -r --verbose -v \ --output-format= -o --timeout= -t" ;; "version") @@ -1701,7 +1705,7 @@ _nvme_subcmds () { nvme-mi-recv nvme-mi-send get-reg set-reg mgmt-addr-list-log \ rotational-media-info-log changed-alloc-ns-list-log \ io-mgmt-recv io-mgmt-send dispersed-ns-participating-nss-log \ - reachability-groups-log" + reachability-groups-log reachability-associations-log" # Add plugins: for plugin in "${!_plugin_subcmds[@]}"; do