From 9780184b2cf76eced1ef987408073e96cc29f3bb Mon Sep 17 00:00:00 2001 From: Erlang/OTP Date: Mon, 11 Mar 2019 11:52:56 +0100 Subject: Prepare release --- lib/kernel/doc/src/application.xml | 4 +- lib/kernel/doc/src/logger.xml | 2 +- lib/kernel/doc/src/notes.xml | 179 +++++++++++++++++++++++++++++++++++++ 3 files changed, 182 insertions(+), 3 deletions(-) (limited to 'lib/kernel/doc/src') diff --git a/lib/kernel/doc/src/application.xml b/lib/kernel/doc/src/application.xml index 5170502581..83a83ebad2 100644 --- a/lib/kernel/doc/src/application.xml +++ b/lib/kernel/doc/src/application.xml @@ -238,8 +238,8 @@ Nodes = [cp1@cave, {cp2@cave, cp3@cave}] - - + + Sets the configuration parameters of multiple applications.

Sets the configuration Config for multiple diff --git a/lib/kernel/doc/src/logger.xml b/lib/kernel/doc/src/logger.xml index ebebcaa1ae..5bdfcf91db 100644 --- a/lib/kernel/doc/src/logger.xml +++ b/lib/kernel/doc/src/logger.xml @@ -1119,7 +1119,7 @@ logger:set_proxy_config(maps:merge(Old, Config)). - + Return a timestamp to insert in meta data for a log event. diff --git a/lib/kernel/doc/src/notes.xml b/lib/kernel/doc/src/notes.xml index 1f4d9be1f5..0c187eb19f 100644 --- a/lib/kernel/doc/src/notes.xml +++ b/lib/kernel/doc/src/notes.xml @@ -31,6 +31,185 @@

This document describes the changes made to the Kernel application.

+
Kernel 6.3 + +
Fixed Bugs and Malfunctions + + +

+ If for example the /etc/hosts did not come into + existence until after the kernel application had started, + its content was never read. This bug has now been + corrected.

+

+ Own Id: OTP-14702 Aux Id: PR-2066

+
+ +

+ Fix bug where doing seq_trace:reset_trace() while + another process was doing a garbage collection could + cause the run-time system to segfault.

+

+ Own Id: OTP-15490

+
+ +

+ Fix erl_epmd:port_please spec to include + atom() and string().

+

+ Own Id: OTP-15557 Aux Id: PR-2117

+
+ +

+ The Logger handler logger_std_h now keeps track of the + inode of its log file in order to re-open the file if the + inode changes. This may happen, for instance, if the log + file is opened and saved by an editor.

+

+ Own Id: OTP-15578 Aux Id: ERL-850

+
+ +

+ When user specific file modes are given to the logger + handler logger_std_h, they were earlier accepted + without any control. This is now changes, so Logger will + adjust the file modes as follows:

+

+ - If raw is not found in the list, it is + added.
- If none of write, append or + exclusive are found in the list, append is + added.
- If none of delayed_write or + {delayed_write,Size,Delay} are found in the list, + delayed_write is added.

+

+ Own Id: OTP-15602

+
+
+
+ + +
Improvements and New Features + + +

+ The standard logger handler, logger_std_h, now has + a new internal feature for log rotation. The rotation + scheme is as follows:

+

+ The log file to which the handler currently writes always + has the same name, i.e. the name which is configured for + the handler. The archived files have the same name, but + with extension ".N", where N is an integer. The newest + archive has extension ".0", and the oldest archive has + the highest number.

+

+ The size at which the log file is rotated, and the number + of archive files that are kept, is specified with the + handler specific configuration parameters + max_no_bytes and max_no_files respectively.

+

+ Archives can be compressed, in which case they get a + ".gz" file extension after the integer. Compression is + specified with the handler specific configuration + parameter compress_on_rotate.

+

+ Own Id: OTP-15479

+
+ +

+ The new functions logger:i/0 and logger:i/1 + are added. These provide the same information as + logger:get_config/0 and other + logger:get_*_config functions, but the information + is more logically sorted and more readable.

+

+ Own Id: OTP-15600

+
+ +

+ Logger is now protected against overload due to massive + amounts of log events from the emulator or from remote + nodes.

+

+ Own Id: OTP-15601

+
+ +

+ Logger now uses os:system_time/1 instead of + erlang:system_time/1 to generate log event timestamps.

+

+ Own Id: OTP-15625

+
+ +

+ Add functions application:set_env/1,2 and + application:set_env/2. These take a list of + application configuration parameters, and the behaviour + is equivalent to calling application:set_env/4 + individually for each application/key combination, except + it is more efficient.

+

+ set_env/1,2 warns about duplicated applications or + keys. The warning is also emitted during boot, if + applications or keys are duplicated within one + configuration file, e.g. sys.config.

+

+ Own Id: OTP-15642 Aux Id: PR-2164

+
+ +

+ Handler specific configuration parameters for the + standard handler logger_std_h are changed to be + more intuitive and more similar to the disk_log handler.

+

+ Earlier there was only one parameter, type, which + could have the values standard_io, + standard_error, {file,FileName} or + {file,FileName,Modes}.

+

+ This is now changed, so the following parameters are + allowed:

+

+ type = standard_io | standard_error | file
+ file = file:filename()
modes = + [file:mode()]

+

+ All parameters are optional. type defaults to + standard_io, unless a file name is given, in which + case it defaults to file. If type is set to + file, the file name defaults to the same as the + handler id.

+

+ The potential incompatibility is that + logger:get_config/0 and + logger:get_handler_config/1 now returns the new + parameters, even if the configuration was set with the + old variant, e.g. #{type=>{file,FileName}}.

+

+ *** POTENTIAL INCOMPATIBILITY ***

+

+ Own Id: OTP-15662

+
+ +

+ The new configuration parameter file_check is + added to the Logger handler logger_std_h. This + parameter specifies how long (in milliseconds) the + handler may wait before checking if the log file still + exists and the inode is the same as when it was opened.

+

+ The default value is 0, which means that this check is + done prior to each write operation. Setting a higher + number may improve performance, but adds the risk of + loosing log events.

+

+ Own Id: OTP-15663

+
+
+
+ +
+
Kernel 6.2.1
Fixed Bugs and Malfunctions -- cgit v1.2.3