Repository: trafficserver Updated Branches: refs/heads/master 7b12e4872 -> ea43e6e42
Document proxy.config.stack_dump_enabled While debugging the issues we've had with ATS, we needed to generate core files, but by default ATS handles the SIGSEGV signal and prints the backtrace to traffic.out. We've find out, though, that there's a config setting that disables this behavior, allowing core files to be generated, and decided we should add this information to the doc as others, specially newcomers to ATS, may find it useful. This closes #109. Project: http://git-wip-us.apache.org/repos/asf/trafficserver/repo Commit: http://git-wip-us.apache.org/repos/asf/trafficserver/commit/ea43e6e4 Tree: http://git-wip-us.apache.org/repos/asf/trafficserver/tree/ea43e6e4 Diff: http://git-wip-us.apache.org/repos/asf/trafficserver/diff/ea43e6e4 Branch: refs/heads/master Commit: ea43e6e42dd8ecd3dbefd243db1c44696caf276b Parents: 7b12e48 Author: AcaÌcio Centeno <[email protected]> Authored: Mon Sep 8 14:31:56 2014 +0000 Committer: James Peach <[email protected]> Committed: Wed Sep 10 13:35:44 2014 -0700 ---------------------------------------------------------------------- doc/sdk/troubleshooting-tips/using-a-debugger.en.rst | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ea43e6e4/doc/sdk/troubleshooting-tips/using-a-debugger.en.rst ---------------------------------------------------------------------- diff --git a/doc/sdk/troubleshooting-tips/using-a-debugger.en.rst b/doc/sdk/troubleshooting-tips/using-a-debugger.en.rst index d2729e2..b4b55ce 100644 --- a/doc/sdk/troubleshooting-tips/using-a-debugger.en.rst +++ b/doc/sdk/troubleshooting-tips/using-a-debugger.en.rst @@ -25,15 +25,25 @@ the core files in the :file:`records.config` file to -1 as follows: :: - CONFIG proxy.config.core_limit INT -1 + CONFIG :ts:cv:`proxy.config.core_limit` INT -1 This is the equivalent of setting ``ulimit -c unlimited`` +Also, if you want to generate a core dump, you must set the variable: + +:: + + CONFIG :ts:cv:`proxy.config.stack_dump_enabled` INT 0 + +If this variable is set to 1, ATS will handle the SIGSEGV signal and +print the backtrace to traffic.out, preventing the core file from being +generated. + Debugging Tips: ~~~~~~~~~~~~~~~ - Use a Traffic Server debug version. -- Use assertions in your plugin (``TSAssert``/``TSReleaseAssert``). +- Use assertions in your plugin (:c:func:`TSAssert` and :c:func:`TSReleaseAssert`).
