diff options
author | Karel Zak | 2017-10-03 15:35:17 +0200 |
---|---|---|
committer | Karel Zak | 2017-10-03 15:35:17 +0200 |
commit | 7d2a9960adcbe546808e90a9a193590cbf575ab3 (patch) | |
tree | d784b03707364f83d2a6e05d6e44393a3b2e4722 /sys-utils/rfkill.8 | |
parent | rfkill: remove duplicate code (diff) | |
download | kernel-qcow2-util-linux-7d2a9960adcbe546808e90a9a193590cbf575ab3.tar.gz kernel-qcow2-util-linux-7d2a9960adcbe546808e90a9a193590cbf575ab3.tar.xz kernel-qcow2-util-linux-7d2a9960adcbe546808e90a9a193590cbf575ab3.zip |
rfkill: support old "list" output
.. just because we want to be replacement for the original version.
Signed-off-by: Karel Zak <kzak@redhat.com>
Diffstat (limited to 'sys-utils/rfkill.8')
-rw-r--r-- | sys-utils/rfkill.8 | 20 |
1 files changed, 15 insertions, 5 deletions
diff --git a/sys-utils/rfkill.8 b/sys-utils/rfkill.8 index 0cb704070..cdaecfafe 100644 --- a/sys-utils/rfkill.8 +++ b/sys-utils/rfkill.8 @@ -4,17 +4,24 @@ rfkill \- tool for enabling and disabling wireless devices .SH SYNOPSIS .B rfkill -.RI [ options ] " command" " [" id | type \ ...] +.RI [ options ] +.RI [ command ] +.RI [ id|type \ ...] .SH DESCRIPTION .B rfkill lists, enabling and disabling wireless devices. +The command "list" output format is deprecated and maintained for backward +compatibility only. The new output format is the default when no command is +specified or when the option \fB\-\-output\fR is used. + The default output is subject to change. So whenever possible, you should avoid using default outputs in your scripts. Always explicitly define expected columns by using the \fB\-\-output\fR option together with a columns list in environments where a stable output is required. + .SH OPTIONS .TP \fB\-J\fR, \fB\-\-json\fR @@ -44,9 +51,8 @@ Display help text and exit. Listen for rfkill events and display them on stdout. .TP \fBlist \fR[\fIid\fR|\fItype\fR ...] -List the current state of all available devices. The full list has TYPE and -ID columns that one can use to limit the scope. It is a good idea to check -with +List the current state of all available devices. The command output format is deprecated, see the section DESCRIPTION. +It is a good idea to check with .B list command .IR id " or " type @@ -66,7 +72,7 @@ Enable the corresponding device. If the device is hard\-blocked, for example via a hardware switch, it will remain unavailable though it is now soft\-unblocked. .SH EXAMPLES -rfkill list +rfkill --output ID,TYPE .br rfkill block all .br @@ -87,6 +93,10 @@ The code has been later modifified by .MT kerolasa@\:iki.\:fi Sami Kerola .ME +and +.MT kzak@\:redhat.\:com +Karel Zak +.ME for util-linux project. .PP This manual page was written by |