[PATCH iproute2-next v4 3/3] devlink : update man page and bash-completion for new commands
From: Vikas Gupta <vikas.gupta@broadcom.com>
Date: 2022-07-29 10:18:54
Subsystem:
the rest · Maintainer:
Linus Torvalds
Update the man page for newly added selftests commands. Examples: devlink dev selftests run pci/0000:03:00.0 id flash devlink dev selftests show pci/0000:03:00.0 Signed-off-by: Vikas Gupta <vikas.gupta@broadcom.com> --- bash-completion/devlink | 21 +++++++++++++++++- man/man8/devlink-dev.8 | 48 +++++++++++++++++++++++++++++++++++++++++ 2 files changed, 68 insertions(+), 1 deletion(-)
diff --git a/bash-completion/devlink b/bash-completion/devlink
index 361be9fe..608a60d0 100644
--- a/bash-completion/devlink
+++ b/bash-completion/devlink@@ -262,6 +262,25 @@ _devlink_dev_flash() esac } +# Completion for devlink dev selftests +_devlink_dev_selftests() +{ + case "$cword" in + 3) + COMPREPLY=( $( compgen -W "show run" -- "$cur" ) ) + return + ;; + 4) + _devlink_direct_complete "dev" + return + ;; + 5) + COMPREPLY=( $( compgen -W "id" -- "$cur" ) ) + return + ;; + esac +} + # Completion for devlink dev _devlink_dev() {
@@ -274,7 +293,7 @@ _devlink_dev() fi return ;; - eswitch|param) + eswitch|param|selftests) _devlink_dev_$command return ;;
diff --git a/man/man8/devlink-dev.8 b/man/man8/devlink-dev.8
index 6906e509..5a06682a 100644
--- a/man/man8/devlink-dev.8
+++ b/man/man8/devlink-dev.8@@ -85,6 +85,20 @@ devlink-dev \- devlink device configuration .I ID ] +.ti -8 +.B devlink dev selftests show +[ +.I DEV +] + +.ti -8 +.B devlink dev selftests run +.I DEV +[ +.B id +.RI "{ " TESTNAME " }" +] + .SH "DESCRIPTION" .SS devlink dev show - display devlink device attributes
@@ -249,6 +263,30 @@ should match the component names from .B "devlink dev info" and may be driver-dependent. +.SS devlink dev selftests show - shows supported selftests on devlink device. + +.PP +.I "DEV" +- specifies the devlink device. +If this argument is omitted all selftests for devlink devices are listed. + +.SS devlink dev selftests run - runs selftests on devlink device. + +.PP +.I "DEV" +- specifies the devlink device to execute selftests. + +.B id +{ +.RI { " ID " } +} +- The value of +.I ID +should match the selftests shown in +.B "devlink dev selftests show". +to execute a selftest on the devlink device. +If this argument is omitted all selftets supported by devlink devices are executed. + .SH "EXAMPLES" .PP devlink dev show
@@ -296,6 +334,16 @@ Flashing 100% .br Flashing done .RE +.PP +devlink dev selftests show pci/0000:01:00.0 +.RS 4 +Shows the supported selftests by the devlink device. +.RE +.PP +devlink dev selftests run pci/0000:01:00.0 id flash +.RS 4 +Perform a flash test on the devlink device. +.RE .SH SEE ALSO .BR devlink (8),
--
2.31.1
Attachments
- smime.p7s [application/pkcs7-signature] 4206 bytes