···

       
66
       
 
       
  sets the kernel’s TCP keepalive time to 120 seconds. To see the available

     

       
67
       
 
       
  parameters, run <command>sysctl -a</command>.

     

       
68
       
 
       
 </para>

     

       
69
       
-
       
 <section>

     

       
70
       
 
       
  <title>Customize your kernel</title>

     

       
71
       
 
       


     

       
72
       
 
       
  <para>

     

       
73
       
 
       
   The first step before compiling the kernel is to generate an appropriate

     

       
74
       
-
       
   <literal>.config</literal> configuration. Either you pass your own config via

     

       
75
       
-
       
   the <literal>configfile</literal> setting of <literal>linuxManualConfig</literal>:

     

       
76
       
-
       
  <screen><![CDATA[

     

       
0
       
 
       

     

       
77
       
 
       
  custom-kernel = super.linuxManualConfig {

     

       
78
       
 
       
    inherit (super) stdenv hostPlatform;

     

       
79
       
 
       
    inherit (linux_4_9) src;

     
···

       
117
       
 
       
  ]]></screen>

     

       
118
       
 
       
  </para>

     

       
119
       
 
       
 </section>

     

       
120
       
-
       
 <section>

     

       
121
       
 
       
  <title>Developing kernel modules</title>

     

       
122
       
 
       


     

       
123
       
 
       
  <para>

     

···

       
66
       
 
       
  sets the kernel’s TCP keepalive time to 120 seconds. To see the available

     

       
67
       
 
       
  parameters, run <command>sysctl -a</command>.

     

       
68
       
 
       
 </para>

     

       
69
       
+
       
 <section xml:id="sec-linux-config-customizing">

     

       
70
       
 
       
  <title>Customize your kernel</title>

     

       
71
       
 
       


     

       
72
       
 
       
  <para>

     

       
73
       
 
       
   The first step before compiling the kernel is to generate an appropriate

     

       
74
       
+
       
   <literal>.config</literal> configuration. Either you pass your own config

     

       
75
       
+
       
   via the <literal>configfile</literal> setting of

     

       
76
       
+
       
   <literal>linuxManualConfig</literal>:

     

       
77
       
+
       
<screen><![CDATA[

     

       
78
       
 
       
  custom-kernel = super.linuxManualConfig {

     

       
79
       
 
       
    inherit (super) stdenv hostPlatform;

     

       
80
       
 
       
    inherit (linux_4_9) src;

     
···

       
118
       
 
       
  ]]></screen>

     

       
119
       
 
       
  </para>

     

       
120
       
 
       
 </section>

     

       
121
       
+
       
 <section xml:id="sec-linux-config-developing-modules">

     

       
122
       
 
       
  <title>Developing kernel modules</title>

     

       
123
       
 
       


     

       
124
       
 
       
  <para>

     

···

       
20
       
 
       
  NixOS module system.

     

       
21
       
 
       
 </para>

     

       
22
       
 
       


     

       
23
       
-
       
 <section>

     

       
24
       
 
       
  <title>Warnings</title>

     

       
25
       
 
       


     

       
26
       
 
       
  <para>

     
···

       
44
       
 
       
</programlisting>

     

       
45
       
 
       
 </section>

     

       
46
       
 
       


     

       
47
       
-
       
 <section>

     

       
48
       
 
       
  <title>Assertions</title>

     

       
49
       
 
       


     

       
50
       
 
       
  <para>

     

···

       
20
       
 
       
  NixOS module system.

     

       
21
       
 
       
 </para>

     

       
22
       
 
       


     

       
23
       
+
       
 <section xml:id="sec-assertions-warnings">

     

       
24
       
 
       
  <title>Warnings</title>

     

       
25
       
 
       


     

       
26
       
 
       
  <para>

     
···

       
44
       
 
       
</programlisting>

     

       
45
       
 
       
 </section>

     

       
46
       
 
       


     

       
47
       
+
       
 <section xml:id="sec-assertions-assertions">

     

       
48
       
 
       
  <title>Assertions</title>

     

       
49
       
 
       


     

       
50
       
 
       
  <para>

     

···

       
11
       
 
       
  value definitions.

     

       
12
       
 
       
 </para>

     

       
13
       
 
       


     

       
14
       
-
       
 <section>

     

       
15
       
 
       
  <title>Basic Types</title>

     

       
16
       
 
       


     

       
17
       
 
       
  <para>

     
···

       
196
       
 
       
  </variablelist>

     

       
197
       
 
       
 </section>

     

       
198
       
 
       


     

       
199
       
-
       
 <section>

     

       
200
       
 
       
  <title>Value Types</title>

     

       
201
       
 
       


     

       
202
       
 
       
  <para>

     
···

       
257
       
 
       
  </variablelist>

     

       
258
       
 
       
 </section>

     

       
259
       
 
       


     

       
260
       
-
       
 <section>

     

       
261
       
 
       
  <title>Composed Types</title>

     

       
262
       
 
       


     

       
263
       
 
       
  <para>

     
···

       
483
       
 
       
  </example>

     

       
484
       
 
       
 </section>

     

       
485
       
 
       


     

       
486
       
-
       
 <section>

     

       
487
       
 
       
  <title>Extending types</title>

     

       
488
       
 
       


     

       
489
       
 
       
  <para>

     
···

       
543
       
 
       
  </variablelist>

     

       
544
       
 
       
 </section>

     

       
545
       
 
       


     

       
546
       
-
       
 <section>

     

       
547
       
 
       
  <title>Custom Types</title>

     

       
548
       
 
       


     

       
549
       
 
       
  <para>

     

       
550
       
 
       
   Custom types can be created with the <literal>mkOptionType</literal>

     

       
551
       
 
       
   function. As type creation includes some more complex topics such as

     

       
552
       
 
       
   submodule handling, it is recommended to get familiar with

     

       
553
       
-
       
   <filename 

     

       
554
       
 
       
  xlink:href="https://github.com/NixOS/nixpkgs/blob/master/lib/types.nix">types.nix</filename>

     

       
555
       
 
       
   code before creating a new type.

     

       
556
       
 
       
  </para>

     

···

       
11
       
 
       
  value definitions.

     

       
12
       
 
       
 </para>

     

       
13
       
 
       


     

       
14
       
+
       
 <section xml:id="sec-option-types-basic">

     

       
15
       
 
       
  <title>Basic Types</title>

     

       
16
       
 
       


     

       
17
       
 
       
  <para>

     
···

       
196
       
 
       
  </variablelist>

     

       
197
       
 
       
 </section>

     

       
198
       
 
       


     

       
199
       
+
       
 <section xml:id="sec-option-types-value">

     

       
200
       
 
       
  <title>Value Types</title>

     

       
201
       
 
       


     

       
202
       
 
       
  <para>

     
···

       
257
       
 
       
  </variablelist>

     

       
258
       
 
       
 </section>

     

       
259
       
 
       


     

       
260
       
+
       
 <section xml:id="sec-option-types-composed">

     

       
261
       
 
       
  <title>Composed Types</title>

     

       
262
       
 
       


     

       
263
       
 
       
  <para>

     
···

       
483
       
 
       
  </example>

     

       
484
       
 
       
 </section>

     

       
485
       
 
       


     

       
486
       
+
       
 <section xml:id="sec-option-types-extending">

     

       
487
       
 
       
  <title>Extending types</title>

     

       
488
       
 
       


     

       
489
       
 
       
  <para>

     
···

       
543
       
 
       
  </variablelist>

     

       
544
       
 
       
 </section>

     

       
545
       
 
       


     

       
546
       
+
       
 <section xml:id="sec-option-types-custom">

     

       
547
       
 
       
  <title>Custom Types</title>

     

       
548
       
 
       


     

       
549
       
 
       
  <para>

     

       
550
       
 
       
   Custom types can be created with the <literal>mkOptionType</literal>

     

       
551
       
 
       
   function. As type creation includes some more complex topics such as

     

       
552
       
 
       
   submodule handling, it is recommended to get familiar with

     

       
553
       
+
       
   <filename

     

       
554
       
 
       
  xlink:href="https://github.com/NixOS/nixpkgs/blob/master/lib/types.nix">types.nix</filename>

     

       
555
       
 
       
   code before creating a new type.

     

       
556
       
 
       
  </para>

     

···

       
10
       
 
       
  sources and presenting it in an accessible style would be a worthy

     

       
11
       
 
       
  contribution to the project.

     

       
12
       
 
       
 </para>

     

       
13
       
-
       
 <section>

     

       
14
       
 
       
  <title>Building the Manual</title>

     

       
15
       
 
       


     

       
16
       
 
       
  <para>

     
···

       
42
       
 
       
   <filename>./result/share/doc/nixos/index.html</filename>.

     

       
43
       
 
       
  </para>

     

       
44
       
 
       
 </section>

     

       
45
       
-
       
 <section>

     

       
46
       
 
       
  <title>Editing DocBook XML</title>

     

       
47
       
 
       


     

       
48
       
 
       
  <para>

     
···

       
76
       
 
       
   Issue</link> and someone will handle the conversion to XML for you.

     

       
77
       
 
       
  </para>

     

       
78
       
 
       
 </section>

     

       
79
       
-
       
 <section>

     

       
80
       
 
       
  <title>Creating a Topic</title>

     

       
81
       
 
       


     

       
82
       
 
       
  <para>

     
···

       
128
       
 
       
   </itemizedlist>

     

       
129
       
 
       
  </para>

     

       
130
       
 
       
 </section>

     

       
131
       
-
       
 <section>

     

       
132
       
 
       
  <title>Adding a Topic to the Book</title>

     

       
133
       
 
       


     

       
134
       
 
       
  <para>

     

···

       
10
       
 
       
  sources and presenting it in an accessible style would be a worthy

     

       
11
       
 
       
  contribution to the project.

     

       
12
       
 
       
 </para>

     

       
13
       
+
       
 <section xml:id="sec-writing-docs-building-the-manual">

     

       
14
       
 
       
  <title>Building the Manual</title>

     

       
15
       
 
       


     

       
16
       
 
       
  <para>

     
···

       
42
       
 
       
   <filename>./result/share/doc/nixos/index.html</filename>.

     

       
43
       
 
       
  </para>

     

       
44
       
 
       
 </section>

     

       
45
       
+
       
 <section xml:id="sec-writing-docs-editing-docbook-xml">

     

       
46
       
 
       
  <title>Editing DocBook XML</title>

     

       
47
       
 
       


     

       
48
       
 
       
  <para>

     
···

       
76
       
 
       
   Issue</link> and someone will handle the conversion to XML for you.

     

       
77
       
 
       
  </para>

     

       
78
       
 
       
 </section>

     

       
79
       
+
       
 <section xml:id="sec-writing-docs-creating-a-topic">

     

       
80
       
 
       
  <title>Creating a Topic</title>

     

       
81
       
 
       


     

       
82
       
 
       
  <para>

     
···

       
128
       
 
       
   </itemizedlist>

     

       
129
       
 
       
  </para>

     

       
130
       
 
       
 </section>

     

       
131
       
+
       
 <section xml:id="sec-writing-docs-adding-a-topic">

     

       
132
       
 
       
  <title>Adding a Topic to the Book</title>

     

       
133
       
 
       


     

       
134
       
 
       
  <para>

     

···

       
109
       
 
       
   so in that case you will not be able to go back to your original channel.

     

       
110
       
 
       
  </para>

     

       
111
       
 
       
 </warning>

     

       
112
       
-
       
 <section>

     

       
113
       
 
       
  <title>Automatic Upgrades</title>

     

       
114
       
 
       


     

       
115
       
 
       
  <para>

     

···

       
109
       
 
       
   so in that case you will not be able to go back to your original channel.

     

       
110
       
 
       
  </para>

     

       
111
       
 
       
 </warning>

     

       
112
       
+
       
 <section xml:id="sec-upgrading-automatic">

     

       
113
       
 
       
  <title>Automatic Upgrades</title>

     

       
114
       
 
       


     

       
115
       
 
       
  <para>