]> git.ipfire.org Git - thirdparty/util-linux.git/blob - sys-utils/rfkill.8
Merge branch 'patch-1' of https://github.com/aner-perez/util-linux
[thirdparty/util-linux.git] / 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 ] " command" " [" id | type \ ...]
8 .SH OPTIONS
9 .TP
10 \fB\-J\fR, \fB\-\-json\fR
11 Use JSON output format.
12 .TP
13 \fB\-n\fR, \fB\-\-noheadings\fR
14 Do not print a header line.
15 .TP
16 \fB\-o\fR, \fB\-\-output\fR
17 Specify which output columns to print. Use \-\-help to get a list of
18 available columns.
19 .TP
20 \fB\-r\fR, \fB\-\-raw\fR
21 Use the raw output format.
22 .TP
23 .B \-\-help
24 Display help text and exit.
25 .TP
26 .B \-\-version
27 Display version information and exit.
28 .SH COMMANDS
29 .TP
30 .B help
31 Display help text and exit.
32 .TP
33 .B event
34 Listen for rfkill events and display them on stdout.
35 .TP
36 \fBlist \fR[\fIid\fR|\fItype\fR ...]
37 List the current state of all available devices. The full list has TYPE and
38 ID columns that one can use to limit the scope. It is a good idea to check
39 with
40 .B list
41 command
42 .IR id " or " type
43 scope is appropriate before setting
44 .BR block " or " unblock .
45 Special
46 .I all
47 type string will match everything. Use of multiple
48 .IR id " or " type
49 arguments is supported.
50 .TP
51 \fBblock \fBid\fR|\fBtype\fR [...]
52 Disable the corresponding device.
53 .TP
54 \fBunblock \fBid\fR|\fBtype\fR [...]
55 Enable the corresponding device. If the device is hard\-blocked, for example
56 via a hardware switch, it will remain unavailable though it is now
57 soft\-unblocked.
58 .SH EXAMPLES
59 rfkill list
60 .br
61 rfkill block all
62 .br
63 rfkill unblock wlan
64 .br
65 rfkill block bluetooth uwb wimax wwan gps fm nfc
66 .SH AUTHORS
67 .B rfkill
68 was originally written by
69 .MT johannes@\:sipsolutions.\:net
70 Johannes Berg
71 .ME
72 and
73 .MT marcel@\:holtmann.\:org
74 Marcel Holtmann
75 .ME .
76 The code has been later modifified by
77 .MT kerolasa@\:iki.\:fi
78 Sami Kerola
79 .ME
80 for util-linux project.
81 .PP
82 This manual page was written by
83 .MT linux@\:youmustbejoking.\:demon.\:co.uk
84 Darren Salt
85 .ME ,
86 for the Debian project (and may be used by others).
87 .SH "SEE ALSO"
88 .BR powertop (8),
89 .BR systemd-rfkill (8),
90 .UR https://\:git.\:kernel.\:org/\:pub/\:scm/\:linux/\:kernel/\:git/\:torvalds/\:linux.git/\:tree/\:Documentation/\:rfkill.txt
91 Linux kernel documentation
92 .UE
93 .SH AVAILABILITY
94 The rfkill command is part of the util\-linux package and is available from
95 .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util\-linux/
96 Linux Kernel Archive
97 .UE .