summary refs log tree commit diff
path: root/nixos/doc/manual/release-notes/rl-1703.xml
blob: 94aa674fed6cfc6fcef1e81fccfba59a6e85707a (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
<section xmlns="http://docbook.org/ns/docbook"
         xmlns:xlink="http://www.w3.org/1999/xlink"
         xmlns:xi="http://www.w3.org/2001/XInclude"
         version="5.0"
         xml:id="sec-release-17.03">

<title>Release 17.03 (“XXX”, 2017/03/??)</title>

<para>In addition to numerous new and upgraded packages, this release
has the following highlights: </para>

<itemizedlist>
  <listitem>
    <para>Nixpkgs is now extensible through overlays. See the <link
    xlink:href="https://nixos.org/nixpkgs/manual/#sec-overlays-install">Nixpkgs
    manual</link> for more information.</para>
  </listitem>

  <listitem>

    <para>Setting capabilities on programs is now supported with a
    <literal>setcap-wrapper</literal> functionality. This
    functionality and the <literal>setuid-wrapper</literal> are merged
    into a single "wrappers" module.</para>
  </listitem>
</itemizedlist>

<para>The following new services were added since the last release:</para>

<itemizedlist>
  <listitem>
    <para></para>
  </listitem>
</itemizedlist>


<para>When upgrading from a previous release, please be aware of the
following incompatible changes:</para>

<itemizedlist>
  <listitem>
    <para>
      Cross compilation has been rewritten. See the nixpkgs manual for
      details. The most obvious breaking change is that derivations absent a
      <literal>.nativeDrv</literal> or <literal>.crossDrv</literal> are now
      cross by default, not native.
    </para>
  </listitem>

  <listitem>
    <para>
      <literal>stdenv.overrides</literal> is now expected to take <literal>self</literal>
      and <literal>super</literal> arguments. See <literal>lib.trivial.extends</literal>
      for what those parameters represent.
    </para>
  </listitem>

  <listitem>
    <para>
      <literal>gnome</literal> alias has been removed along with
      <literal>gtk</literal>, <literal>gtkmm</literal> and several others.
      Now you need to use versioned attributes, like <literal>gnome3</literal>.
    </para>
  </listitem>

  <listitem>
    <para>
      The attribute name of the Radicale daemon has been changed from
      <literal>pythonPackages.radicale</literal> to
      <literal>radicale</literal>.
    </para>
  </listitem>

  <listitem>
    <para>
      The Yama LSM is now enabled by default in the kernel,
      which prevents ptracing non-child processes.
      This means you will not be able to attach gdb to an existing process,
      but will need to start that process from gdb (so it is a child).
    </para>
  </listitem>

  <listitem>
    <para>
      The <literal>stripHash</literal> bash function in <literal>stdenv</literal>
      changed according to its documentation; it now outputs the stripped name to
      <literal>stdout</literal> instead of putting it in the variable
      <literal>strippedName</literal>.
    </para>
  </listitem>

  <listitem>
    <para>PHP now scans for extra configuration .ini files in /etc/php.d
    instead of /etc. This prevents accidentally loading non-PHP .ini files
    that may be in /etc.
    </para>
  </listitem>

  <listitem>
    <para>
      Parsoid service now uses YAML configuration format.
     <literal>service.parsoid.interwikis</literal> is now called
     <literal>service.parsoid.wikis</literal> and is a list of either API URLs
     or attribute sets as specified in parsoid's documentation.
    </para>
  </listitem>

  <listitem>
    <para>
     <literal>Ntpd</literal> was replaced by
     <literal>systemd-timesyncd</literal> as the default service to synchronize
     system time with a remote NTP server. The old behavior can be restored by
     setting <literal>services.ntp.enable</literal> to <literal>true</literal>.
     Upstream time servers for all NTP implementations are now configured using
     <literal>networking.timeServers</literal>.
   </para>
  </listitem>

  <listitem>

    <para><literal>overridePackages</literal> function no longer exists.
    It is replaced by <link
    xlink:href="https://nixos.org/nixpkgs/manual/#sec-overlays-install">
    overlays</link>.  For example, the following code:

<programlisting>
  let
    pkgs = import &lt;nixpkgs&gt; {};
  in
    pkgs.overridePackages (self: super: ...)
</programlisting>

    should be replaced by:

<programlisting>
  let
    pkgs = import &lt;nixpkgs&gt; {};
  in
    import pkgs.path { overlays = [(self: super: ...)] }
</programlisting>

    </para>
  </listitem>

  <listitem>
    <para>
      Autoloading connection tracking helpers is now disabled by default.
      This default was also changed in the Linux kernel and is considered
      insecure if not configured properly in your firewall. If you need
      connection tracking helpers (i.e. for active FTP) please enable
      <literal>networking.firewall.autoLoadConntrackHelpers</literal> and
      tune <literal>networking.firewall.connectionTrackingModules</literal>
      to suit your needs.
    </para>
  </listitem>

</itemizedlist>


<para>Other notable improvements:</para>

<itemizedlist>
  <listitem>
    <para>Module type system have a new extensible option types feature that
      allow to extend certain types, such as enum, through multiple option
      declarations of the same option across multiple modules.
    </para>
  </listitem>
</itemizedlist>


</section>