From: Alan T. DeKok <aland@freeradius.org>
Date: Wed, 7 Jan 2009 09:51:34 +0000 (+0100)
Subject: Added notes on using "screen"
X-Git-Tag: release_2_1_4~102
X-Git-Url: http://www.project-moonshot.org/gitweb/?p=freeradius.git;a=commitdiff_plain;h=981470709fa3e51be551aaa6f839683929c53724

Added notes on using "screen"
---

diff --git a/doc/bugs b/doc/bugs
index a6a6216..2d6d878 100644
--- a/doc/bugs
+++ b/doc/bugs
@@ -130,6 +130,29 @@ $ valgrind --tool=memcheck --leak-check=full radiusd -Xm
   cannot do anything about those problems.  However, any errors that are
   inside of the FreeRADIUS source should be brought to our attention.
 
+
+6. Running with "screen"
+
+  If the bug is a crash of the server, and it takes a long time for the
+  crash to happen, perform the following steps:
+
+ * log in as root
+ * open a screen session (http://blogamundo.net/code/screen/)
+   $ screen bash
+ * make sure FreeRADIUS is not running
+ * make sure you have all the debug symbols about, or a debugable 
+   version of the server installed
+ * configure screen to log to a file; 'Ctrl-A H'
+ * type 'gdb /path/to/radius'  (or /path/to/freeradius on Debian)
+ * at the (gdb) prompt, type 'run -X'
+ * detach from screen 'Ctrl-A D'
+ * when you notice FreeRADIUS has died, reconnect to your screen session
+   $ screen -D -r
+ * at the (gdb) prompt type 'where' or for *lots* of info try
+   'thread apply all bt full'
+ * tell screen to stop logging, 'Ctrl-A H'
+ * logout from screen
+
 --
 
 FreeRADIUS Project, copyright 2008