rfkill(8)

NAME

rfkill - tool for enabling and disabling wireless devices

SYNOPSIS

rfkill [options] [command] [ID|type ...]

DESCRIPTION

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 --output 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 --output option together with a columns list in environments where a stable output is required.

OPTIONS

-J, --json: Use JSON output format.

-n, --noheadings: Do not print a header line.

-o, --output: Specify which output columns to print. Use --help to get a list of available columns.

--output-all: Output all available columns.

-r, --raw: Use the raw output format.

-h, --help: Display help text and exit.

-V, --version: Display version and exit.

ENVIRONMENT

LIBSMARTCOLS_DEBUG=all

enables libsmartcols debug output.

LIBSMARTCOLS_DEBUG_PADDING=on

use visible padding characters.

LIBSMARTCOLS_JSON=compact|lines

Controls JSON output format when using --json. Supported values are compact for JSON output with minimal whitespace, and lines for JSON Lines format (one JSON object per line). If unset or set to any other value, pretty-printed JSON is used.

COMMANDS

help

Display help text and exit.

event

Listen for rfkill events and display them on stdout.

list [id|type ...]

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.

block id|type [...]

Disable the corresponding device.

unblock id|type [...]

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.

toggle id|type [...]

Enable or disable the corresponding device.

EXAMPLE

  rfkill --output ID,TYPE
  rfkill block all
  rfkill unblock wlan
  rfkill block bluetooth uwb wimax wwan gps fm nfc

AUTHORS

rfkill was originally written by Johannes Berg <[email protected]> and Marcel Holtmann <[email protected]>. The code has been later modified by Sami Kerola <[email protected]> and Karel Zak <[email protected]> for the util-linux project.

This manual page was written by Darren Salt <[email protected]> for the Debian project (and may be used by others).

REPORTING BUGS

For bug reports, use the issue tracker <https://github.com/util-linux/util-linux/issues>.

AVAILABILITY

The rfkill command is part of the util-linux package which can be downloaded from Linux Kernel Archive <https://www.kernel.org/pub/linux/utils/util-linux/>.