diff options
author | Siri Hansen <[email protected]> | 2019-03-04 19:15:24 +0100 |
---|---|---|
committer | Siri Hansen <[email protected]> | 2019-03-08 09:35:44 +0100 |
commit | e2af137524ac6a645689daf309871893dcc655a1 (patch) | |
tree | d1efb019a0d6e812a305d7a626592a2d2965f355 /lib/kernel/doc | |
parent | 56cacefda4f18c8fdc45839b6bec1d07d0d2d78e (diff) | |
download | otp-e2af137524ac6a645689daf309871893dcc655a1.tar.gz otp-e2af137524ac6a645689daf309871893dcc655a1.tar.bz2 otp-e2af137524ac6a645689daf309871893dcc655a1.zip |
[logger] Add option file_check to logger_std_h
OTP-15663
This option indicates how often the handler shall check if the log
file still exists and if the inode is changed.
Diffstat (limited to 'lib/kernel/doc')
-rw-r--r-- | lib/kernel/doc/src/logger_std_h.xml | 19 |
1 files changed, 19 insertions, 0 deletions
diff --git a/lib/kernel/doc/src/logger_std_h.xml b/lib/kernel/doc/src/logger_std_h.xml index ce54a91342..5ed1a2f210 100644 --- a/lib/kernel/doc/src/logger_std_h.xml +++ b/lib/kernel/doc/src/logger_std_h.xml @@ -134,6 +134,25 @@ value <c>infinity</c>.</p> <p>Defaults to <c>false</c>.</p> </item> + <tag><marker id="file_check"/><c>file_check = non_neg_integer()</c></tag> + <item> + <p>When <c>logger_std_h</c> logs to a file, it reads the file + information of the log file prior to each write + operation. This is to make sure the file still exists and + has the same inode as when it was opened. This implies some + performance loss, but ensures that no log events are lost in + the case when the file has been removed or renamed by an + external actor.</p> + <p>In order to allow minimizing the performance loss, the + <c>file_check</c> parameter can be set to a positive integer + value, <c>N</c>. The handler will then skip reading the file + information prior to writing, as long as no more + than <c>N</c> milliseconds have passed since it was last + read.</p> + <p>Notice that the risk of loosing log events grows when + the <c>file_check</c> value grows.</p> + <p>Defaults to 0.</p> + </item> <tag><c>filesync_repeat_interval = pos_integer() | no_repeat</c></tag> <item> <p>This value, in milliseconds, specifies how often the handler does |