sys-utils/rfkill.8

   1 .\" -*- nroff -*-
   2 .TH RFKILL "8" "2017-07-06" "util-linux" "System Administration"
   3 .SH NAME
   4 rfkill \- tool for enabling and disabling wireless devices
   5 .SH SYNOPSIS
   6 .B rfkill
   7 .RI [ options ]
   8 .RI [ command ]
   9 .RI [ id|type \ ...]
  10
  11 .SH DESCRIPTION
  12 .B rfkill
  13 lists, enabling and disabling wireless devices.
  14
  15 The command "list" output format is deprecated and maintained for backward
  16 compatibility only. The new output format is the default when no command is
  17 specified or when the option \fB\-\-output\fR is used.
  18
  19 The default output is subject to change.  So whenever possible, you should
  20 avoid using default outputs in your scripts.  Always explicitly define expected
  21 columns by using the \fB\-\-output\fR option together with a columns list in
  22 environments where a stable output is required.
  23
  24
  25 .SH OPTIONS
  26 .TP
  27 \fB\-J\fR, \fB\-\-json\fR
  28 Use JSON output format.
  29 .TP
  30 \fB\-n\fR, \fB\-\-noheadings\fR
  31 Do not print a header line.
  32 .TP
  33 \fB\-o\fR, \fB\-\-output\fR
  34 Specify which output columns to print.  Use \-\-help to get a list of
  35 available columns.
  36 .TP
  37 \fB\-r\fR, \fB\-\-raw\fR
  38 Use the raw output format.
  39 .TP
  40 .B \-\-help
  41 Display help text and exit.
  42 .TP
  43 .B \-\-version
  44 Display version information and exit.
  45 .SH COMMANDS
  46 .TP
  47 .B help
  48 Display help text and exit.
  49 .TP
  50 .B event
  51 Listen for rfkill events and display them on stdout.
  52 .TP
  53 \fBlist \fR[\fIid\fR|\fItype\fR ...]
  54 List the current state of all available devices.  The command output format is deprecated, see the section DESCRIPTION.
  55 It is a good idea to check with
  56 .B list
  57 command
  58 .IR id " or " type
  59 scope is appropriate before setting
  60 .BR block " or " unblock .
  61 Special
  62 .I all
  63 type string will match everything.  Use of multiple
  64 .IR id " or " type
  65 arguments is supported.
  66 .TP
  67 \fBblock \fBid\fR|\fBtype\fR [...]
  68 Disable the corresponding device.
  69 .TP
  70 \fBunblock \fBid\fR|\fBtype\fR [...]
  71 Enable the corresponding device.  If the device is hard\-blocked, for example
  72 via a hardware switch, it will remain unavailable though it is now
  73 soft\-unblocked.
  74 .SH EXAMPLES
  75 rfkill --output ID,TYPE
  76 .br
  77 rfkill block all
  78 .br
  79 rfkill unblock wlan
  80 .br
  81 rfkill block bluetooth uwb wimax wwan gps fm nfc
  82 .SH AUTHORS
  83 .B rfkill
  84 was originally written by
  85 .MT johannes@\:sipsolutions.\:net
  86 Johannes Berg
  87 .ME
  88 and
  89 .MT marcel@\:holtmann.\:org
  90 Marcel Holtmann
  91 .ME .
  92 The code has been later modified by
  93 .MT kerolasa@\:iki.\:fi
  94 Sami Kerola
  95 .ME
  96 and
  97 .MT kzak@\:redhat.\:com
  98 Karel Zak
  99 .ME
 100 for util-linux project.
 101 .PP
 102 This manual page was written by
 103 .MT linux@\:youmustbejoking.\:demon.\:co.uk
 104 Darren Salt
 105 .ME ,
 106 for the Debian project (and may be used by others).
 107 .SH "SEE ALSO"
 108 .BR powertop (8),
 109 .BR systemd-rfkill (8),
 110 .UR https://\:git.\:kernel.\:org/\:pub/\:scm/\:linux/\:kernel/\:git/\:torvalds/\:linux.git/\:tree/\:Documentation/\:rfkill.txt
 111 Linux kernel documentation
 112 .UE
 113 .SH AVAILABILITY
 114 The rfkill command is part of the util\-linux package and is available from
 115 .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util\-linux/
 116 Linux Kernel Archive
 117 .UE .