changeset 574:5e9ff979eac8

Documented debug_points.
author Ruslan Ermilov <ru@nginx.com>
date Mon, 09 Jul 2012 07:00:40 +0000
parents 58f5acb7a67d
children ebcb351d9eb3
files xml/en/docs/ngx_core_module.xml xml/ru/docs/ngx_core_module.xml
diffstat 2 files changed, 40 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/ngx_core_module.xml
+++ b/xml/en/docs/ngx_core_module.xml
@@ -116,6 +116,26 @@ be built with <literal>--with-debug</lit
 </directive>
 
 
+<directive name="debug_points">
+<syntax><literal>abort</literal> | <literal>stop</literal></syntax>
+<default/>
+<context>main</context>
+
+<para>
+This directive is used for debugging.
+</para>
+
+<para>
+When internal error is detected, e.g. the leak of sockets on
+restart of working processes, enabling <literal>debug_points</literal>
+leads to a core file creation (<literal>abort</literal>)
+or stopping a process (<literal>stop</literal>) for further
+analysis using a system debugger.
+</para>
+
+</directive>
+
+
 <directive name="error_log">
 <syntax>
 <value>file</value> | <literal>stderr</literal>
--- a/xml/ru/docs/ngx_core_module.xml
+++ b/xml/ru/docs/ngx_core_module.xml
@@ -116,6 +116,26 @@ events {
 </directive>
 
 
+<directive name="debug_points">
+<syntax><literal>abort</literal> | <literal>stop</literal></syntax>
+<default/>
+<context>main</context>
+
+<para>
+Эта директива используется для отладки.
+</para>
+
+<para>
+В случае обнаружения внутренней ошибки, например, утечки сокетов в момент
+перезапуска рабочих процессов, включение <literal>debug_points</literal>
+приводит к созданию core-файла (<literal>abort</literal>)
+или остановке процесса (<literal>stop</literal>) с целью последующей
+диагностики с помощью системного отладчика.
+</para>
+
+</directive>
+
+
 <directive name="error_log">
 <syntax>
 <value>файл</value> | <literal>stderr</literal>