[master] d2e880f How to debug crashing child.

Per Buer perbu at varnish-cache.org
Thu Jun 6 15:12:08 CEST 2013


commit d2e880fff39c7673652ed83043a8e7361a4ebb5a
Author: Per Buer <perbu at varnish-software.com>
Date:   Thu Jun 6 12:45:51 2013 +0200

    How to debug crashing child.

diff --git a/doc/sphinx/users-guide/troubleshooting.rst b/doc/sphinx/users-guide/troubleshooting.rst
index 51797d8..1735c2b 100644
--- a/doc/sphinx/users-guide/troubleshooting.rst
+++ b/doc/sphinx/users-guide/troubleshooting.rst
@@ -67,8 +67,20 @@ errors will be logged in syslog. It might look like this::
 In this situation the mother process assumes that the cache died and
 killed it off.
 
-XXX: Describe crashing child process and crashing mother process here too.
-XXX: panic.show
+In certain situation the child process might crash itself. This might
+happen because internal integrity checks fail as a result of a bug.
+
+In these situations the child will start back up again right away but
+the cache will be cleared. A panic is logged with the mother
+process. You can inspect the stack trace with the CLI command
+panic.show.
+
+Some of these situations might be caused by bugs, other by
+misconfigations. Often we see varnish running out of session
+workspace, which will result in the child aborting its execution.
+
+In a rare event you might also see a segmentation fault or bus
+error. These are either bugs, kernel- or hardware failures.
 
 Varnish gives me Guru meditation
 --------------------------------



More information about the varnish-commit mailing list