modules: readme files regenerated - sipdump ... [skip ci]
[sip-router] / ISSUES
diff --git a/ISSUES b/ISSUES
index dccea66..720f304 100644 (file)
--- a/ISSUES
+++ b/ISSUES
@@ -1,50 +1,34 @@
-#
-# $Id$
-#
-
-This is a collection of issues which have shown up
-since the version 0.8.8 was released.
-
----------------------------------------------------------------
-Desc: in default configuration, SER prints '127.0.0.1' in
-      Warning header field of all replies
-BugId: 372
-Workaround: use listen=<ip_address> in your configuration file;
-      that will make SER listen only on one interface (and not
-      on '127.0.0.1' in parallel) and advertise correct IP
-      address
-Bug reason: multiple listening address ignored in message
-      translator
-CVS status: fixed
----------------------------------------------------------------
-Desc: serctl add ... returns "user exists"
-BugId: 374
-Workaround: either use serweb for addding new users or update
-      the serctl utility from CVS; the fixed version is at
-      http://www.iptel.org/ser/issues/374/
-Bug reason: phplib_id ignored in sc
-CVS Status: fixed
----------------------------------------------------------------
-Desc: SMS, MSILO & JABBER modules fail to load because of unresolved
-dependency on im.so
-BugId: 375
-Workaround: change the makefiles & recompile  
-Bug reason: removal of RTLD_GLOBAL from dlopen.
-CVS status: fixed 
----------------------------------------------------------------
-Desc: when forking & std_error=yes no open FD is closed
-BugId: 376
-CVS status: fixed
----------------------------------------------------------------
-Desc: exec module missing in binary RPM distro
-BugId: -
-CVS status: fixed
-Workaround: compile from source distribution
----------------------------------------------------------------
-Desc: when debug=3 & iptel.cfg is used mysql module fails in submit_query.
-Workaround: use debug=9 or use log_stderr
-Reason: unknown
-BugId: 377
-Cvs status: not fixed
+Reporting Issues
+================
 
+Current set of issues is to be found at our Github Project page:
 
+  * https://github.com/kamailio/kamailio/issues
+
+Issue Report Details
+--------------------
+
+When reporting an issue, gather as much details as possible and include them
+on the bug report. Useful details are:
+
+  * kamailio version (output of kamailio -v)
+  * operating system where server is running
+  * CPU architecture of the system
+  * error log messages from syslog
+  * if there is a coredump file, use gdb to extract the following:
+    - full backtrace (gdb: bt full)
+    - local variables (gdb: info locals)
+    - list of the source code around the issue (gdb: list)
+  * information about when it happens:
+    - at startup
+    - at shutdown
+    - at runtime:
+      ~ randomly (no way to reproduce it has been discovered)
+      ~ periodically (an way to reproduce it has been discovered)
+
+Contact
+-------
+
+If you have further questions about reporting an issue, email to:
+
+  * sr-dev@lists.kamailio.org