sys-utils/rfkill.8.adoc

   1 //po4a: entry man manual
   2 = rfkill(8)
   3 :doctype: manpage
   4 :man manual: System Administration
   5 :man source: util-linux {release-version}
   6 :page-layout: base
   7 :command: rfkill
   8
   9 == NAME
  10
  11 rfkill - tool for enabling and disabling wireless devices
  12
  13 == SYNOPSIS
  14
  15 *rfkill* [options] [_command_] [_ID_|_type_ ...]
  16
  17 == DESCRIPTION
  18
  19 *rfkill* lists, enabling and disabling wireless devices.
  20
  21 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 *--output* is used.
  22
  23 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 *--output* option together with a columns list in environments where a stable output is required.
  24
  25 == OPTIONS
  26
  27 *-J*, *--json*::
  28 Use JSON output format.
  29
  30 *-n*, *--noheadings*::
  31 Do not print a header line.
  32
  33 *-o*, *--output*::
  34 Specify which output columns to print. Use *--help* to get a list of available columns.
  35
  36 *--output-all*::
  37 Output all available columns.
  38
  39 *-r*, *--raw*::
  40 Use the raw output format.
  41
  42 include::man-common/help-version.adoc[]
  43
  44 == COMMANDS
  45
  46 *help*::
  47 Display help text and exit.
  48
  49 *event*::
  50 Listen for rfkill events and display them on stdout.
  51
  52 *list* [__id__|__type__ ...]::
  53 List the current state of all available devices. The command output format is deprecated, see the *DESCRIPTION* section. It is a good idea to check with *list* command _id_ or _type_ scope is appropriate before setting *block* or *unblock*. Special _all_ type string will match everything. Use of multiple _ID_ or _type_ arguments is supported. Possible types are all, {wlan | wifi}, bluetooth, {uwb | ultrawideband}, wimax, wwan, gps, fm, nfc.
  54
  55 **block** __id__|__type__ [...]::
  56 Disable the corresponding device.
  57
  58 **unblock** __id__|__type__ [...]::
  59 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.
  60
  61 **toggle** __id__|__type__ [...]::
  62 Enable or disable the corresponding device.
  63
  64 == EXAMPLE
  65 ....
  66   rfkill --output ID,TYPE
  67   rfkill block all
  68   rfkill unblock wlan
  69   rfkill block bluetooth uwb wimax wwan gps fm nfc
  70 ....
  71
  72 == AUTHORS
  73
  74 *rfkill* was originally written by mailto:johannes@sipsolutions.net[Johannes Berg] and mailto:marcel@holtmann.org[Marcel Holtmann]. The code has been later modified by mailto:kerolasa@iki.fi[Sami Kerola] and mailto:kzak@redhat.com[Karel Zak] for the util-linux project.
  75
  76 This manual page was written by mailto:linux@youmustbejoking.demon.co.uk[Darren Salt] for the Debian project (and may be used by others).
  77
  78 == SEE ALSO
  79
  80 *powertop*(8),
  81 *systemd-rfkill*(8),
  82 https://docs.kernel.org/driver-api/rfkill.html[Linux kernel documentation]
  83
  84 include::man-common/bugreports.adoc[]
  85
  86 include::man-common/footer.adoc[]
  87
  88 ifdef::translation[]
  89 include::man-common/translation.adoc[]
  90 endif::[]