commit 54419f6e59c4fa0f39bc0cf367b7d690b9a4d40b · pyrox.dev/nixpkgs

+1 -1

nixos/doc/manual/configuration/networking.xml

···

       13
       13
        
        <xi:include href="../from_md/configuration/ipv4-config.section.xml" />

     

       14
       14
        
        <xi:include href="../from_md/configuration/ipv6-config.section.xml" />

     

       15
       15
        
        <xi:include href="../from_md/configuration/firewall.section.xml" />

     

       16
       16
       -
        <xi:include href="wireless.xml" />

     

       16
       16
       +
        <xi:include href="../from_md/configuration/wireless.section.xml" />

     

       17
       17
        
        <xi:include href="ad-hoc-network-config.xml" />

     

       18
       18
        
        <xi:include href="renaming-interfaces.xml" />

     

       19
       19
        
       <!-- TODO: OpenVPN, NAT -->

+67

nixos/doc/manual/configuration/wireless.section.md

···

       1
       1
       +
       # Wireless Networks {#sec-wireless}

     

       2
       2
       +
       

     

       3
       3
       +
       For a desktop installation using NetworkManager (e.g., GNOME), you just

     

       4
       4
       +
       have to make sure the user is in the `networkmanager` group and you can

     

       5
       5
       +
       skip the rest of this section on wireless networks.

     

       6
       6
       +
       

     

       7
       7
       +
       NixOS will start wpa_supplicant for you if you enable this setting:

     

       8
       8
       +
       

     

       9
       9
       +
       ```nix

     

       10
       10
       +
       networking.wireless.enable = true;

     

       11
       11
       +
       ```

     

       12
       12
       +
       

     

       13
       13
       +
       NixOS lets you specify networks for wpa_supplicant declaratively:

     

       14
       14
       +
       

     

       15
       15
       +
       ```nix

     

       16
       16
       +
       networking.wireless.networks = {

     

       17
       17
       +
         echelon = {                # SSID with no spaces or special characters

     

       18
       18
       +
           psk = "abcdefgh";

     

       19
       19
       +
         };

     

       20
       20
       +
         "echelon's AP" = {         # SSID with spaces and/or special characters

     

       21
       21
       +
           psk = "ijklmnop";

     

       22
       22
       +
         };

     

       23
       23
       +
         echelon = {                # Hidden SSID

     

       24
       24
       +
           hidden = true;

     

       25
       25
       +
           psk = "qrstuvwx";

     

       26
       26
       +
         };

     

       27
       27
       +
         free.wifi = {};            # Public wireless network

     

       28
       28
       +
       };

     

       29
       29
       +
       ```

     

       30
       30
       +
       

     

       31
       31
       +
       Be aware that keys will be written to the nix store in plaintext! When

     

       32
       32
       +
       no networks are set, it will default to using a configuration file at

     

       33
       33
       +
       `/etc/wpa_supplicant.conf`. You should edit this file yourself to define

     

       34
       34
       +
       wireless networks, WPA keys and so on (see wpa_supplicant.conf(5)).

     

       35
       35
       +
       

     

       36
       36
       +
       If you are using WPA2 you can generate pskRaw key using

     

       37
       37
       +
       `wpa_passphrase`:

     

       38
       38
       +
       

     

       39
       39
       +
       ```ShellSession

     

       40
       40
       +
       $ wpa_passphrase ESSID PSK

     

       41
       41
       +
       network={

     

       42
       42
       +
               ssid="echelon"

     

       43
       43
       +
               #psk="abcdefgh"

     

       44
       44
       +
               psk=dca6d6ed41f4ab5a984c9f55f6f66d4efdc720ebf66959810f4329bb391c5435

     

       45
       45
       +
       }

     

       46
       46
       +
       ```

     

       47
       47
       +
       

     

       48
       48
       +
       ```nix

     

       49
       49
       +
       networking.wireless.networks = {

     

       50
       50
       +
         echelon = {

     

       51
       51
       +
           pskRaw = "dca6d6ed41f4ab5a984c9f55f6f66d4efdc720ebf66959810f4329bb391c5435";

     

       52
       52
       +
         };

     

       53
       53
       +
       }

     

       54
       54
       +
       ```

     

       55
       55
       +
       

     

       56
       56
       +
       or you can use it to directly generate the `wpa_supplicant.conf`:

     

       57
       57
       +
       

     

       58
       58
       +
       ```ShellSession

     

       59
       59
       +
       # wpa_passphrase ESSID PSK > /etc/wpa_supplicant.conf

     

       60
       60
       +
       ```

     

       61
       61
       +
       

     

       62
       62
       +
       After you have edited the `wpa_supplicant.conf`, you need to restart the

     

       63
       63
       +
       wpa_supplicant service.

     

       64
       64
       +
       

     

       65
       65
       +
       ```ShellSession

     

       66
       66
       +
       # systemctl restart wpa_supplicant.service

     

       67
       67
       +
       ```

-70

nixos/doc/manual/configuration/wireless.xml

···

       1
       1
       -
       <section xmlns="http://docbook.org/ns/docbook"

     

       2
       2
       -
                xmlns:xlink="http://www.w3.org/1999/xlink"

     

       3
       3
       -
                xmlns:xi="http://www.w3.org/2001/XInclude"

     

       4
       4
       -
                version="5.0"

     

       5
       5
       -
                xml:id="sec-wireless">

     

       6
       6
       -
        <title>Wireless Networks</title>

     

       7
       7
       -
       

     

       8
       8
       -
        <para>

     

       9
       9
       -
         For a desktop installation using NetworkManager (e.g., GNOME), you just have

     

       10
       10
       -
         to make sure the user is in the <code>networkmanager</code> group and you can

     

       11
       11
       -
         skip the rest of this section on wireless networks.

     

       12
       12
       -
        </para>

     

       13
       13
       -
       

     

       14
       14
       -
        <para>

     

       15
       15
       -
         NixOS will start wpa_supplicant for you if you enable this setting:

     

       16
       16
       -
       <programlisting>

     

       17
       17
       -
       <xref linkend="opt-networking.wireless.enable"/> = true;

     

       18
       18
       -
       </programlisting>

     

       19
       19
       -
         NixOS lets you specify networks for wpa_supplicant declaratively:

     

       20
       20
       -
       <programlisting>

     

       21
       21
       -
       <xref linkend="opt-networking.wireless.networks"/> = {

     

       22
       22
       -
         echelon = {                # SSID with no spaces or special characters

     

       23
       23
       -
           psk = "abcdefgh";

     

       24
       24
       -
         };

     

       25
       25
       -
         "echelon's AP" = {         # SSID with spaces and/or special characters

     

       26
       26
       -
           psk = "ijklmnop";

     

       27
       27
       -
         };

     

       28
       28
       -
         echelon = {                # Hidden SSID

     

       29
       29
       -
           hidden = true;

     

       30
       30
       -
           psk = "qrstuvwx";

     

       31
       31
       -
         };

     

       32
       32
       -
         free.wifi = {};            # Public wireless network

     

       33
       33
       -
       };

     

       34
       34
       -
       </programlisting>

     

       35
       35
       -
         Be aware that keys will be written to the nix store in plaintext! When no

     

       36
       36
       -
         networks are set, it will default to using a configuration file at

     

       37
       37
       -
         <literal>/etc/wpa_supplicant.conf</literal>. You should edit this file

     

       38
       38
       -
         yourself to define wireless networks, WPA keys and so on (see <citerefentry>

     

       39
       39
       -
         <refentrytitle>wpa_supplicant.conf</refentrytitle>

     

       40
       40
       -
         <manvolnum>5</manvolnum> </citerefentry>).

     

       41
       41
       -
        </para>

     

       42
       42
       -
       

     

       43
       43
       -
        <para>

     

       44
       44
       -
         If you are using WPA2 you can generate pskRaw key using

     

       45
       45
       -
         <command>wpa_passphrase</command>:

     

       46
       46
       -
       <screen>

     

       47
       47
       -
       <prompt>$ </prompt>wpa_passphrase ESSID PSK

     

       48
       48
       -
       network={

     

       49
       49
       -
               ssid="echelon"

     

       50
       50
       -
               #psk="abcdefgh"

     

       51
       51
       -
               psk=dca6d6ed41f4ab5a984c9f55f6f66d4efdc720ebf66959810f4329bb391c5435

     

       52
       52
       -
       }

     

       53
       53
       -
       </screen>

     

       54
       54
       -
       <programlisting>

     

       55
       55
       -
       <xref linkend="opt-networking.wireless.networks"/> = {

     

       56
       56
       -
         echelon = {

     

       57
       57
       -
           pskRaw = "dca6d6ed41f4ab5a984c9f55f6f66d4efdc720ebf66959810f4329bb391c5435";

     

       58
       58
       -
         };

     

       59
       59
       -
       }

     

       60
       60
       -
       </programlisting>

     

       61
       61
       -
         or you can use it to directly generate the

     

       62
       62
       -
         <literal>wpa_supplicant.conf</literal>:

     

       63
       63
       -
       <screen>

     

       64
       64
       -
       <prompt># </prompt>wpa_passphrase ESSID PSK > /etc/wpa_supplicant.conf</screen>

     

       65
       65
       -
         After you have edited the <literal>wpa_supplicant.conf</literal>, you need to

     

       66
       66
       -
         restart the wpa_supplicant service.

     

       67
       67
       -
       <screen>

     

       68
       68
       -
       <prompt># </prompt>systemctl restart wpa_supplicant.service</screen>

     

       69
       69
       -
        </para>

     

       70
       70
       -
       </section>

+73

nixos/doc/manual/from_md/configuration/wireless.section.xml

···

       1
       1
       +
       <section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sec-wireless">

     

       2
       2
       +
         <title>Wireless Networks</title>

     

       3
       3
       +
         <para>

     

       4
       4
       +
           For a desktop installation using NetworkManager (e.g., GNOME), you

     

       5
       5
       +
           just have to make sure the user is in the

     

       6
       6
       +
           <literal>networkmanager</literal> group and you can skip the rest of

     

       7
       7
       +
           this section on wireless networks.

     

       8
       8
       +
         </para>

     

       9
       9
       +
         <para>

     

       10
       10
       +
           NixOS will start wpa_supplicant for you if you enable this setting:

     

       11
       11
       +
         </para>

     

       12
       12
       +
         <programlisting language="bash">

     

       13
       13
       +
       networking.wireless.enable = true;

     

       14
       14
       +
       </programlisting>

     

       15
       15
       +
         <para>

     

       16
       16
       +
           NixOS lets you specify networks for wpa_supplicant declaratively:

     

       17
       17
       +
         </para>

     

       18
       18
       +
         <programlisting language="bash">

     

       19
       19
       +
       networking.wireless.networks = {

     

       20
       20
       +
         echelon = {                # SSID with no spaces or special characters

     

       21
       21
       +
           psk = &quot;abcdefgh&quot;;

     

       22
       22
       +
         };

     

       23
       23
       +
         &quot;echelon's AP&quot; = {         # SSID with spaces and/or special characters

     

       24
       24
       +
           psk = &quot;ijklmnop&quot;;

     

       25
       25
       +
         };

     

       26
       26
       +
         echelon = {                # Hidden SSID

     

       27
       27
       +
           hidden = true;

     

       28
       28
       +
           psk = &quot;qrstuvwx&quot;;

     

       29
       29
       +
         };

     

       30
       30
       +
         free.wifi = {};            # Public wireless network

     

       31
       31
       +
       };

     

       32
       32
       +
       </programlisting>

     

       33
       33
       +
         <para>

     

       34
       34
       +
           Be aware that keys will be written to the nix store in plaintext!

     

       35
       35
       +
           When no networks are set, it will default to using a configuration

     

       36
       36
       +
           file at <literal>/etc/wpa_supplicant.conf</literal>. You should edit

     

       37
       37
       +
           this file yourself to define wireless networks, WPA keys and so on

     

       38
       38
       +
           (see wpa_supplicant.conf(5)).

     

       39
       39
       +
         </para>

     

       40
       40
       +
         <para>

     

       41
       41
       +
           If you are using WPA2 you can generate pskRaw key using

     

       42
       42
       +
           <literal>wpa_passphrase</literal>:

     

       43
       43
       +
         </para>

     

       44
       44
       +
         <programlisting>

     

       45
       45
       +
       $ wpa_passphrase ESSID PSK

     

       46
       46
       +
       network={

     

       47
       47
       +
               ssid=&quot;echelon&quot;

     

       48
       48
       +
               #psk=&quot;abcdefgh&quot;

     

       49
       49
       +
               psk=dca6d6ed41f4ab5a984c9f55f6f66d4efdc720ebf66959810f4329bb391c5435

     

       50
       50
       +
       }

     

       51
       51
       +
       </programlisting>

     

       52
       52
       +
         <programlisting language="bash">

     

       53
       53
       +
       networking.wireless.networks = {

     

       54
       54
       +
         echelon = {

     

       55
       55
       +
           pskRaw = &quot;dca6d6ed41f4ab5a984c9f55f6f66d4efdc720ebf66959810f4329bb391c5435&quot;;

     

       56
       56
       +
         };

     

       57
       57
       +
       }

     

       58
       58
       +
       </programlisting>

     

       59
       59
       +
         <para>

     

       60
       60
       +
           or you can use it to directly generate the

     

       61
       61
       +
           <literal>wpa_supplicant.conf</literal>:

     

       62
       62
       +
         </para>

     

       63
       63
       +
         <programlisting>

     

       64
       64
       +
       # wpa_passphrase ESSID PSK &gt; /etc/wpa_supplicant.conf

     

       65
       65
       +
       </programlisting>

     

       66
       66
       +
         <para>

     

       67
       67
       +
           After you have edited the <literal>wpa_supplicant.conf</literal>,

     

       68
       68
       +
           you need to restart the wpa_supplicant service.

     

       69
       69
       +
         </para>

     

       70
       70
       +
         <programlisting>

     

       71
       71
       +
       # systemctl restart wpa_supplicant.service

     

       72
       72
       +
       </programlisting>

     

       73
       73
       +
       </section>