changeset 2938:b274d289798d

Documented the use of cyclic memory buffer log with lldb.
author Sergey Kandaurov <pluknet@nginx.com>
date Thu, 23 Feb 2023 17:27:57 +0400
parents 36f817631bbc
children 9f31f7f1876b
files xml/en/docs/debugging_log.xml xml/ru/docs/debugging_log.xml
diffstat 2 files changed, 16 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/debugging_log.xml
+++ b/xml/en/docs/debugging_log.xml
@@ -8,7 +8,7 @@
 <article name="A debugging log"
          link="/en/docs/debugging_log.html"
          lang="en"
-         rev="5">
+         rev="6">
 
 
 <section>
@@ -122,6 +122,13 @@ end
 set $buf = (ngx_log_memory_buf_t *) $log->wdata
 dump binary memory debug_log.txt $buf->start $buf->end
 </example>
+Or using an <command>lldb</command> script as follows:
+<example>
+expr ngx_log_t *$log = ngx_cycle->log
+expr while ($log->writer != ngx_log_memory_writer) { $log = $log->next; }
+expr ngx_log_memory_buf_t *$buf = (ngx_log_memory_buf_t *) $log->wdata
+memory read --force --outfile debug_log.txt --binary $buf->start $buf->end
+</example>
 </para>
 
 </section>
--- a/xml/ru/docs/debugging_log.xml
+++ b/xml/ru/docs/debugging_log.xml
@@ -8,7 +8,7 @@
 <article name="Отладочный лог"
          link="/ru/docs/debugging_log.html"
          lang="ru"
-         rev="5">
+         rev="6">
 
 
 <section>
@@ -121,6 +121,13 @@ end
 set $buf = (ngx_log_memory_buf_t *) $log->wdata
 dump binary memory debug_log.txt $buf->start $buf->end
 </example>
+Или при помощи такого <command>lldb</command>-скрипта:
+<example>
+expr ngx_log_t *$log = ngx_cycle->log
+expr while ($log->writer != ngx_log_memory_writer) { $log = $log->next; }
+expr ngx_log_memory_buf_t *$buf = (ngx_log_memory_buf_t *) $log->wdata
+memory read --force --outfile debug_log.txt --binary $buf->start $buf->end
+</example>
 </para>
 
 </section>