manual/util-linux/original/man8/rfkill.8

   1 '\" t
   2 .\"     Title: rfkill
   3 .\"    Author: [see the "AUTHOR(S)" section]
   4 .\" Generator: Asciidoctor 2.0.15
   5 .\"      Date: 2022-02-14
   6 .\"    Manual: System Administration
   7 .\"    Source: util-linux 2.37.4
   8 .\"  Language: English
   9 .\"
  10 .TH "RFKILL" "8" "2022-02-14" "util\-linux 2.37.4" "System Administration"
  11 .ie \n(.g .ds Aq \(aq
  12 .el       .ds Aq '
  13 .ss \n[.ss] 0
  14 .nh
  15 .ad l
  16 .de URL
  17 \fI\\$2\fP <\\$1>\\$3
  18 ..
  19 .als MTO URL
  20 .if \n[.g] \{\
  21 .  mso www.tmac
  22 .  am URL
  23 .    ad l
  24 .  .
  25 .  am MTO
  26 .    ad l
  27 .  .
  28 .  LINKSTYLE blue R < >
  29 .\}
  30 .SH "NAME"
  31 rfkill \- tool for enabling and disabling wireless devices
  32 .SH "SYNOPSIS"
  33 .sp
  34 \fBrfkill\fP [options] [\fIcommand\fP] [\fIID\fP|\fItype\fP ...]
  35 .SH "DESCRIPTION"
  36 .sp
  37 \fBrfkill\fP lists, enabling and disabling wireless devices.
  38 .sp
  39 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\fP is used.
  40 .sp
  41 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\fP option together with a columns list in environments where a stable output is required.
  42 .SH "OPTIONS"
  43 .sp
  44 \fB\-J\fP, \fB\-\-json\fP
  45 .RS 4
  46 Use JSON output format.
  47 .RE
  48 .sp
  49 \fB\-n\fP, \fB\-\-noheadings\fP
  50 .RS 4
  51 Do not print a header line.
  52 .RE
  53 .sp
  54 \fB\-o\fP, \fB\-\-output\fP
  55 .RS 4
  56 Specify which output columns to print. Use \fB\-\-help\fP to get a list of available columns.
  57 .RE
  58 .sp
  59 \fB\-\-output\-all\fP
  60 .RS 4
  61 Output all available columns.
  62 .RE
  63 .sp
  64 \fB\-r\fP, \fB\-\-raw\fP
  65 .RS 4
  66 Use the raw output format.
  67 .RE
  68 .sp
  69 \fB\-\-help\fP
  70 .RS 4
  71 Display help text and exit.
  72 .RE
  73 .sp
  74 \fB\-\-version\fP
  75 .RS 4
  76 Display version information and exit.
  77 .RE
  78 .SH "COMMANDS"
  79 .sp
  80 \fBhelp\fP
  81 .RS 4
  82 Display help text and exit.
  83 .RE
  84 .sp
  85 \fBevent\fP
  86 .RS 4
  87 Listen for rfkill events and display them on stdout.
  88 .RE
  89 .sp
  90 \fBlist\fP [\fIid\fP|\fItype\fP ...]
  91 .RS 4
  92 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 \fBlist\fP command \fIid\fP or \fItype\fP scope is appropriate before setting \fBblock\fP or \fBunblock\fP. Special \fIall\fP type string will match everything. Use of multiple \fIID\fP or \fItype\fP arguments is supported.
  93 .RE
  94 .sp
  95 \fBblock id\fP|\fBtype\fP [...]
  96 .RS 4
  97 Disable the corresponding device.
  98 .RE
  99 .sp
 100 \fBunblock id\fP|\fBtype\fP [...]
 101 .RS 4
 102 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.
 103 .RE
 104 .sp
 105 \fBtoggle id\fP|\fBtype\fP [...]
 106 .RS 4
 107 Enable or disable the corresponding device.
 108 .RE
 109 .SH "EXAMPLE"
 110 .sp
 111 .if n .RS 4
 112 .nf
 113 .fam C
 114   rfkill \-\-output ID,TYPE
 115   rfkill block all
 116   rfkill unblock wlan
 117   rfkill block bluetooth uwb wimax wwan gps fm nfc
 118 .fam
 119 .fi
 120 .if n .RE
 121 .SH "AUTHORS"
 122 .sp
 123 \fBrfkill\fP was originally written by \c
 124 .MTO "johannes\(atsipsolutions.net" "Johannes Berg" ""
 125 and
 126 .MTO "marcel\(atholtmann.org" "Marcel Holtmann" "."
 127 The code has been later modified by
 128 .MTO "kerolasa\(atiki.fi" "Sami Kerola" ""
 129 and
 130 .MTO "kzak\(atredhat.com" "Karel Zak" ""
 131 for the util\-linux project.
 132 .sp
 133 This manual page was written by \c
 134 .MTO "linux\(atyoumustbejoking.demon.co.uk" "Darren Salt" ""
 135 for the Debian project (and may be used by others).
 136 .SH "SEE ALSO"
 137 .sp
 138 \fBpowertop\fP(8),
 139 \fBsystemd\-rfkill\fP(8),
 140 .URL "https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/Documentation/driver\-api/rfkill.rst" "Linux kernel documentation" ""
 141 .SH "REPORTING BUGS"
 142 .sp
 143 For bug reports, use the issue tracker at \c
 144 .URL "https://github.com/karelzak/util\-linux/issues" "" "."
 145 .SH "AVAILABILITY"
 146 .sp
 147 The \fBrfkill\fP command is part of the util\-linux package which can be downloaded from \c
 148 .URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."