about summary refs log tree commit diff
path: root/doc/s6-log.html
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2021-01-22 19:10:56 +0000
committerLaurent Bercot <ska-skaware@skarnet.org>2021-01-22 19:10:56 +0000
commit7fba356b1378b0d470f746b45797c229e9d882cd (patch)
treedd5a7021eeaf040afc34c47e7a5f81e2fd583bed /doc/s6-log.html
parentcedfe51030470abecc325b54656098376cc70305 (diff)
downloads6-7fba356b1378b0d470f746b45797c229e9d882cd.tar.gz
s6-7fba356b1378b0d470f746b45797c229e9d882cd.tar.xz
s6-7fba356b1378b0d470f746b45797c229e9d882cd.zip
bugfix: make s6-log -l actually split
Diffstat (limited to 'doc/s6-log.html')
-rw-r--r--doc/s6-log.html12
1 files changed, 7 insertions, 5 deletions
diff --git a/doc/s6-log.html b/doc/s6-log.html
index 7f461bc..158dd57 100644
--- a/doc/s6-log.html
+++ b/doc/s6-log.html
@@ -68,11 +68,13 @@ Currently supported verbosity levels:
    <li> 1: write alerts, warnings and fatal errors </li>
   </ul> </li>
  <li> <tt>-l&nbsp;<em>linelimit</em></tt>&nbsp;: if a log line is longer than
-<em>linelimit</em> bytes, cut it in two by inserting a newline. The newline
-may appear anywhere after <em>linelimit</em> or more bytes. <em>linelimit</em>
-cannot be less than 48. Using this option ensures that an ill-formatted log
-stream will not make s6-log uncontrollably eat memory by trying to read and
-process an extremely long line in one go. The default is 8192 bytes. </li>
+<em>linelimit</em> bytes, split it by inserting a newline after the
+<em>linelimit</em>th byte. After the split, the remainder of the line will
+also be processed, so it will go through the selection process, timestamping,
+etc. <em>linelimit</em> cannot be less than 48, unless it is 0 (which means
+infinite). The default is 8192 bytes. Setting <em>linelimit</em> to 0 ensures
+that lines will never be split; this may cause important memory consumption
+by s6-log if it is fed extremely long lines, so use with caution. </li>
 </ul>
 
 <h2> Logdirs </h2>