From 26184ad62ac3a798a1f24af33bd603a96a489b6f Mon Sep 17 00:00:00 2001 From: Jim Harris Date: Wed, 15 Jun 2022 23:25:53 +0000 Subject: [PATCH] doc: cleanup spdkcli.py - spdkcli.py is no longer be considered experimental. - consistently refer to it as 'spdkcli' - a few other miscellaneous changes Signed-off-by: Jim Harris Change-Id: I1f5c75961e4c1741d0573f2041b4b023ee627357 Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/13057 Community-CI: Broadcom CI Tested-by: SPDK CI Jenkins Reviewed-by: Changpeng Liu Reviewed-by: Ben Walker Reviewed-by: Paul Luse --- doc/spdkcli.md | 30 ++++++++++++++++-------------- 1 file changed, 16 insertions(+), 14 deletions(-) diff --git a/doc/spdkcli.md b/doc/spdkcli.md index 74cc26dbb..cec062aa9 100644 --- a/doc/spdkcli.md +++ b/doc/spdkcli.md @@ -1,36 +1,38 @@ -# SPDK CLI {#spdkcli} +# spdkcli {#spdkcli} -Spdkcli is a command-line management application for SPDK. -Spdkcli has support for a limited number of applications and bdev modules, -and should be considered experimental for the v18.04 release. -This experimental version was added for v18.04 to get early feedback -that can be incorporated as spdkcli becomes more fully-featured -for the next SPDK release. +spdkcli is a command-line management application for SPDK. +spdkcli has support for most transport protocols and +bdev modules. -## Install needed dependencies +## Dependencies -All dependencies should be handled by scripts/pkgdep.sh script. +Dependencies are installed by scripts/pkgdep.sh. Package dependencies at the moment include: - configshell -## Run SPDK application instance +Some distributions name the package configshell_fb. + +## Example usage + +### Start SPDK application ~~~{.sh} ./scripts/setup.sh ./build/bin/vhost -c vhost.json ~~~ -## Run SPDK CLI +### Run spdkcli -Spdkcli should be run with the same privileges as SPDK application. -In order to use SPDK CLI in interactive mode please use: +spdkcli should be run with the same privileges as SPDK application. + +To use spdkcli in interactive mode: ~~~{.sh} scripts/spdkcli.py ~~~ Use "help" command to get a list of available commands for each tree node. -It is also possible to use SPDK CLI to run just a single command, +It is also possible to use spdkcli to run just a single command, just use the command as an argument to the application. For example, to view current configuration and immediately exit: ~~~{.sh}