summaryrefslogtreecommitdiffstats
path: root/sys-utils/rfkill.8
diff options
context:
space:
mode:
authorKarel Zak2017-10-03 15:35:17 +0200
committerKarel Zak2017-10-03 15:35:17 +0200
commit7d2a9960adcbe546808e90a9a193590cbf575ab3 (patch)
treed784b03707364f83d2a6e05d6e44393a3b2e4722 /sys-utils/rfkill.8
parentrfkill: remove duplicate code (diff)
downloadkernel-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.820
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