Merge tag 'OTP-20.0' into sverker/20/binary_to_atom-utf8-crash/ERL-474/OTP-14590

1 files changed, 341 insertions, 3 deletions

diff --git a/lib/kernel/doc/src/notes.xml b/lib/kernel/doc/src/notes.xml
index f37433110c..e1cf45109d 100644
--- a/lib/kernel/doc/src/notes.xml
+++ b/lib/kernel/doc/src/notes.xml
@@ -4,7 +4,7 @@
 <chapter>
   <header>
     <copyright>
-      <year>2004</year><year>2016</year>
+      <year>2004</year><year>2017</year>
       <holder>Ericsson AB. All Rights Reserved.</holder>
     </copyright>
     <legalnotice>
@@ -31,6 +31,344 @@
   </header>
   <p>This document describes the changes made to the Kernel application.</p>
 
+<section><title>Kernel 5.3</title>
+
+    <section><title>Fixed Bugs and Malfunctions</title>
+      <list>
+        <item>
+	    <p>Function <c>inet:ntoa/1</c> has been fixed to return
+	    lowercase letters according to RFC 5935 that has been
+	    approved after this function was written. Previously
+	    uppercase letters were returned so this may be a
+	    backwards incompatible change depending on how the
+	    returned address string is used.</p>
+	    <p>Function <c>inet:parse_address/1</c> has been fixed to
+	    accept %-suffixes on scoped addresses. The addresses does
+	    not work yet, but gives no parse errors.</p>
+          <p>
+	    *** POTENTIAL INCOMPATIBILITY ***</p>
+          <p>
+	    Own Id: OTP-13006 Aux Id: ERIERL-20, ERL-429 </p>
+        </item>
+        <item>
+          <p>
+	    Fix bug where gethostname would incorrectly fail with
+	    enametoolong on Linux.</p>
+          <p>
+	    Own Id: OTP-14310</p>
+        </item>
+        <item>
+          <p>
+	    Fix bug causing <c>code:is_module_native</c> to falsely
+	    return true when <c>local</c> call trace is enabled for
+	    the module.</p>
+          <p>
+	    Own Id: OTP-14390</p>
+        </item>
+        <item>
+          <p>
+	    Add early reject of invalid node names from distributed
+	    nodes.</p>
+          <p>
+	    Own Id: OTP-14426</p>
+        </item>
+      </list>
+    </section>
+
+
+    <section><title>Improvements and New Features</title>
+      <list>
+        <item>
+          <p>
+	    Since Unicode is now allowed in atoms an extra check is
+	    needed for node names, which are restricted to Latin-1.</p>
+          <p>
+	    Own Id: OTP-13805</p>
+        </item>
+        <item>
+	    <p>Replaced usage of deprecated symbolic <seealso
+	    marker="erts:erlang#type-time_unit"><c>time
+	    unit</c></seealso> representations.</p>
+          <p>
+	    Own Id: OTP-13831 Aux Id: OTP-13735 </p>
+        </item>
+        <item>
+	    <p><c>file:write_file(Name, Data, [raw])</c> would turn
+	    <c>Data</c> into a single binary before writing. This
+	    meant it could not take advantage of the <c>writev()</c>
+	    system call if it was given a list of binaries and told
+	    to write with <c>raw</c> mode.</p>
+          <p>
+	    Own Id: OTP-13909</p>
+        </item>
+        <item>
+	    <p>The performance of the <c>disk_log</c> has been
+	    somewhat improved in some corner cases (big items), and
+	    the documentation has been clarified. </p>
+          <p>
+	    Own Id: OTP-14057 Aux Id: PR-1245 </p>
+        </item>
+        <item>
+	    <p>Functions for detecting changed code has been added.
+	    <c>code:modified_modules/0</c> returns all currently
+	    loaded modules that have changed on disk.
+	    <c>code:module_status/1</c> returns the status for a
+	    module. In the shell and in <c>c</c> module, <c>mm/0</c>
+	    is short for <c>code:modified_modules/0</c>, and
+	    <c>lm/0</c> reloads all currently loaded modules that
+	    have changed on disk.</p>
+          <p>
+	    Own Id: OTP-14059</p>
+        </item>
+        <item>
+          <p>
+	    Introduce an event manager in Erlang to handle OS
+	    signals. A subset of OS signals may be subscribed to and
+	    those are described in the Kernel application.</p>
+          <p>
+	    Own Id: OTP-14186</p>
+        </item>
+        <item>
+	    <p> Sockets can now be bound to device (SO_BINDTODEVICE)
+	    on platforms where it is supported. </p> <p> This has
+	    been implemented e.g to support VRF-Lite under Linux; see
+	    <url
+	    href="https://www.kernel.org/doc/Documentation/networking/vrf.txt">
+	    VRF </url>, and GitHub pull request <url
+	    href="https://github.com/erlang/otp/pull/1326">#1326</url>.
+	    </p>
+          <p>
+	    Own Id: OTP-14357 Aux Id: PR-1326 </p>
+        </item>
+        <item>
+          <p>
+	    Added option to store shell_history on disk so that the
+	    history can be reused between sessions.</p>
+          <p>
+	    Own Id: OTP-14409 Aux Id: PR-1420 </p>
+        </item>
+        <item>
+	    <p> The size of crash reports created by
+	    <c>gen_server</c>, <c>gen_statem</c> and <c>proc_lib</c>
+	    is limited with aid of the Kernel application variable
+	    <c>error_logger_format_depth</c>. The purpose is to limit
+	    the size of the messages sent to the <c>error_logger</c>
+	    process when processes with huge message queues or states
+	    crash. </p> <p>The crash report generated by
+	    <c>proc_lib</c> includes the new tag
+	    <c>message_queue_len</c>. The neighbour report also
+	    includes the new tag <c>current_stacktrace</c>. Finally,
+	    the neighbour report no longer includes the tags
+	    <c>messages</c> and <c>dictionary</c>. </p> <p> The new
+	    function <c>error_logger:get_format_depth/0</c> can be
+	    used to retrieve the value of the Kernel application
+	    variable <c>error_logger_format_depth</c>. </p>
+          <p>
+	    Own Id: OTP-14417</p>
+        </item>
+        <item>
+	    <p> One of the ETS tables used by the <c>global</c>
+	    module is created with <c>{read_concurrency, true}</c> in
+	    order to reduce contention. </p>
+          <p>
+	    Own Id: OTP-14419</p>
+        </item>
+        <item>
+          <p>
+	    Warnings have been added to the relevant documentation
+	    about not using un-secure distributed nodes in exposed
+	    environments.</p>
+          <p>
+	    Own Id: OTP-14425</p>
+        </item>
+      </list>
+    </section>
+
+</section>
+
+<section><title>Kernel 5.2</title>
+
+    <section><title>Fixed Bugs and Malfunctions</title>
+      <list>
+        <item>
+          <p>
+	    Fix a race during cleanup of os:cmd that would cause
+	    os:cmd to hang indefinitely.</p>
+          <p>
+	    Own Id: OTP-14232 Aux Id: seq13275 </p>
+        </item>
+      </list>
+    </section>
+
+
+    <section><title>Improvements and New Features</title>
+      <list>
+        <item>
+	    <p>The functions in the '<c>file</c>' module that take a
+	    list of paths (e.g. <c>file:path_consult/2</c>) will now
+	    continue to search in the path if the path contains
+	    something that is not a directory.</p>
+          <p>
+	    Own Id: OTP-14191</p>
+        </item>
+        <item>
+	    <p>Two OTP processes that are known to receive many
+	    messages are 'rex' (used by 'rpc') and 'error_logger'.
+	    Those processes will now store unprocessed messages
+	    outside the process heap, which will potentially decrease
+	    the cost of garbage collections.</p>
+          <p>
+	    Own Id: OTP-14192</p>
+        </item>
+      </list>
+    </section>
+
+</section>
+
+<section><title>Kernel 5.1.1</title>
+
+    <section><title>Fixed Bugs and Malfunctions</title>
+      <list>
+        <item>
+          <p>
+	    <c>code:add_pathsa/1</c> and command line option
+	    <c>-pa</c> both revert the given list of directories when
+	    adding it at the beginning of the code path. This is now
+	    documented.</p>
+          <p>
+	    Own Id: OTP-13920 Aux Id: ERL-267 </p>
+        </item>
+        <item>
+          <p>
+	    Add lost runtime dependency to erts-8.1. This should have
+	    been done in kernel-5.1 (OTP-19.1) as it cannot run
+	    without at least erts-8.1 (OTP-19.1).</p>
+          <p>
+	    Own Id: OTP-14003</p>
+        </item>
+        <item>
+          <p>
+	    Type and doc for gen_{tcp,udp,sctp}:controlling_process/2
+	    has been improved.</p>
+          <p>
+	    Own Id: OTP-14022 Aux Id: PR-1208 </p>
+        </item>
+      </list>
+    </section>
+
+</section>
+
+<section><title>Kernel 5.1</title>
+
+    <section><title>Fixed Bugs and Malfunctions</title>
+      <list>
+        <item>
+          <p>
+	    Fix a memory leak when calling
+	    seq_trace:get_system_tracer().</p>
+          <p>
+	    Own Id: OTP-13742</p>
+        </item>
+        <item>
+          <p>
+	    Fix for the problem that when adding the ebin directory
+	    of an application to the code path, the
+	    <c>code:priv_dir/1</c> function returns an incorrect path
+	    to the priv directory of the same application.</p>
+          <p>
+	    Own Id: OTP-13758 Aux Id: ERL-195 </p>
+        </item>
+        <item>
+          <p>
+	    Fix code_server crash when adding code paths of two
+	    levels.</p>
+          <p>
+	    Own Id: OTP-13765 Aux Id: ERL-194 </p>
+        </item>
+        <item>
+          <p>
+	    Respect -proto_dist switch while connection to EPMD</p>
+          <p>
+	    Own Id: OTP-13770 Aux Id: PR-1129 </p>
+        </item>
+        <item>
+          <p>
+	    Fixed a bug where init:stop could deadlock if a process
+	    with infinite shutdown timeout (e.g. a supervisor)
+	    attempted to load code while terminating.</p>
+          <p>
+	    Own Id: OTP-13802</p>
+        </item>
+        <item>
+          <p>
+	    Close stdin of commands run in os:cmd. This is a
+	    backwards compatibility fix that restores the behaviour of
+	    pre 19.0 os:cmd.</p>
+          <p>
+	    Own Id: OTP-13867 Aux Id: seq13178 </p>
+        </item>
+      </list>
+    </section>
+
+
+    <section><title>Improvements and New Features</title>
+      <list>
+        <item>
+          <p>
+	    Add <c>net_kernel:setopts/2</c> and
+	    <c>net_kernel:getopts/2</c> to control options for
+	    distribution sockets in runtime.</p>
+          <p>
+	    Own Id: OTP-13564</p>
+        </item>
+        <item>
+          <p>
+	    Rudimentary support for DSCP has been implemented
+	    in the guise of a <c>tclass</c> socket option
+	    for IPv6 sockets.</p>
+          <p>
+	    Own Id: OTP-13582</p>
+        </item>
+      </list>
+    </section>
+
+</section>
+
+<section><title>Kernel 5.0.2</title>
+
+    <section><title>Fixed Bugs and Malfunctions</title>
+      <list>
+        <item>
+          <p>
+	    When calling os:cmd from a process that has set trap_exit
+	    to true an 'EXIT' message would be left in the message
+	    queue. This bug was introduced in kernel vsn 5.0.1.</p>
+          <p>
+	    Own Id: OTP-13813</p>
+        </item>
+      </list>
+    </section>
+
+</section>
+
+<section><title>Kernel 5.0.1</title>
+
+    <section><title>Fixed Bugs and Malfunctions</title>
+      <list>
+        <item>
+          <p>
+	    Fix a os:cmd bug where creating a background job using
+	    &amp; would cause os:cmd to hang until the background job
+	    terminated or closed its stdout and stderr file
+	    descriptors. This bug has existed from kernel 5.0.</p>
+          <p>
+	    Own Id: OTP-13741</p>
+        </item>
+      </list>
+    </section>
+
+</section>
+
 <section><title>Kernel 5.0</title>
 
     <section><title>Fixed Bugs and Malfunctions</title>
@@ -1309,7 +1647,7 @@
 	    dependent, so applications aiming to be portable should
 	    consider using <c>{ipv6_v6only,true}</c> when creating an
 	    <c>inet6</c> listening/destination socket, and if
-	    neccesary also create an <c>inet</c> socket on the same
+	    necessary also create an <c>inet</c> socket on the same
 	    port for IPv4 traffic. See the documentation.</p>
           <p>
 	    Own Id: OTP-8928 Aux Id: kunagi-193 [104] </p>
@@ -3447,7 +3785,7 @@
 	    types (for instance, <c>ensure_loaded/1</c> now only
 	    accepts an atom as documented; it used to accept a string
 	    too).</p>
-	    <p><c>Dialyzer</c> will generally emit warnings for any
+	    <p>Dialyzer will generally emit warnings for any
 	    calls that use undocumented argument types. Even if the
 	    call happens to still work in R12B, you should correct
 	    your code. A future release will adhere to the