NAME

       interfaces-wifi - WiFi vocabulary for the interfaces(5) file format

DESCRIPTION

       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.

       WPA-secured networks are managed using wpa_supplicant(8), while insecure networks are
       managed directly with iwconfig(8).

WIFI-RELATED OPTIONS

       wifi-config-path path
           Denotes the absolute path to a wpa_supplicant configuration file. If no path is given,
           /run/wpa_supplicant.<interface>.conf will be used for a temporary configuration file.
           This option may not be used with other configuration options.

       wifi-ssid ssid
           The SSID the Wi-Fi client should connect to.

       wifi-psk psk
           The passphrase for connecting to the Wi-Fi network.  If unset, the client will connect
           without WPA2 encryption.

EXAMPLES

       A typical setup may involve connecting to a home and work network.  To achieve this, we
       can define a pair of virtual interfaces called wifi-home and wifi-work, which connect to
       their respective wifi networks:

           iface wifi-home
                use dhcp
                wifi-ssid HomeNetwork
                wifi-psk ExamplePassphrase

           iface wifi-work
                use dhcp
                wifi-config-path /etc/network/wpa-work.conf

       The virtual interfaces can be used with ifup and ifdown:

           # ifup wlan0=wifi-home
           # ifdown wlan0
           # ifup wlan0=wifi-work

SEE ALSO

       iwconfig(8)
       wpa_supplicant(8)

AUTHORS

       Ariadne Conill <ariadne@dereferenced.org>

                                            2022-02-16                         interfaces-wifi(5)