.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "interfaces-wifi" "5" "2024-05-06"
.PP
.SH NAME
.PP
\fBinterfaces-wifi\fR - WiFi vocabulary for the interfaces(5) file format
.PP
.SH DESCRIPTION
.PP
Wi-Fi (the IEEE 802.\&11 family of protocols) is a commonly used wireless
networking standard.\&  The following options allow for configuration of
Wi-Fi client interfaces.\&
.PP
WPA-secured networks are managed using \fBwpa_supplicant\fR(8), while insecure
networks are managed directly with \fBiwconfig\fR(8).\&
.PP
.SH WIFI-RELATED OPTIONS
.PP
\fBwifi-config-path\fR \fIpath\fR
.RS 4
Denotes the absolute \fIpath\fR to a \fBwpa_supplicant\fR configuration file.\&
If no path is given, \fI/run/wpa_supplicant.\&<interface>.\&conf\fR will be
used for a temporary configuration file.\&  This option may not be used
with other configuration options.\&
.PP
.RE
\fBwifi-ssid\fR \fIssid\fR
.RS 4
The SSID the Wi-Fi client should connect to.\&
.PP
.RE
\fBwifi-psk\fR \fIpsk\fR
.RS 4
The passphrase for connecting to the Wi-Fi network.\&  If unset, the
client will connect without WPA2 encryption.\&
.PP
.RE
.SH EXAMPLES
.PP
A typical setup may involve connecting to a home and work network.\&  To
achieve this, we can define a pair of virtual interfaces called \fBwifi-home\fR
and \fBwifi-work\fR, which connect to their respective wifi networks:
.PP
.nf
.RS 4
iface wifi-home
	use dhcp
	wifi-ssid HomeNetwork
	wifi-psk ExamplePassphrase

iface wifi-work
	use dhcp
	wifi-config-path /etc/network/wpa-work\&.conf
.fi
.RE
.PP
The virtual interfaces can be used with \fBifup\fR and \fBifdown\fR:
.PP
.nf
.RS 4
# ifup wlan0=wifi-home
# ifdown wlan0
# ifup wlan0=wifi-work
.fi
.RE
.PP
.SH SEE ALSO
.PP
\fBiwconfig\fR(8)
.br
\fBwpa_supplicant\fR(8)
.PP
.SH AUTHORS
.PP
Ariadne Conill <ariadne@dereferenced.\&org>