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>

                                                   2024-08-02                                 interfaces-wifi(5)