Browse code

core: updated the issues file

- removed the content specific to very old versions 0.x.y

Daniel-Constantin Mierla authored on 06/12/2016 14:07:53
Showing 1 changed files
... ...
@@ -1,256 +1,34 @@
1
-This file is here for old time's sake.
2
-Current set of issues is to be found at our
3
-Github Project page:
4
-https://github.com/kamailio/kamailio/issues
1
+Reporting Issues
2
+================
5 3
 
4
+Current set of issues is to be found at our Github Project page:
6 5
 
7
-This is a collection of issues which have shown up
8
-since the version 0.8.8 was released. The issues are
9
-ordered by numbers of ser versions to which they relate,
10
-beginning with the newest release. Issues related to
11
-operating systems are summarized in the bottom.
12
-Desc: tls triggered crash on system with kerberos enabled openssl libs
13
-Ser version:  0.10.x, 0.9.x
14
-Reason:  there is a bug in the openssl kerberos code (kssl.c): 
15
-         libc malloc/free/calloc are used instead of the OPENSSL
16
-         versions. In ser ssl connections move between processes and
17
-         if normal mallocs are used (instead of ser shm versions) a
18
-         crash will occur eventually.
19
-         Quick openssl kerberos support check: 
20
-             grep OPENSSL_NO_KRB5 openssl/opensslconf.h
21
-         If the above command returns no result => openssl is compiled with
22
-         kerberos support.
23
-Workaround: use openssl versions not compiled with kerberos support or
24
-            try a late ser 0.10.x version compiled on the target machine
25
-            (its very important to compile against the same openssl library
26
-             as the one on the target machine)
27
-CVS status: fixed / workarround enabled
28
-Desc: ser crashes on startup if a group is specified (-g or group=)
29
-Ser version:  <=0.8.12
30
-Reason:  bad copy & paste :-)
31
-Patch: http://www.mobile-ip.de/~andrei/ser/main_group.patch
32
-Workaround: update from cvs or  apply the corresponding patch
33
-CVS status: fixed
34
-Desc: textops search REs like "^From" fail to match on RH8
35
-Ser version: all
36
-Reason: there is a bug in RH8 libc, this kind of REs will never match
37
-        in case insensitive mode
38
-Test:  compile test/re_test.c (gcc re_test.c -o re_test) and try
39
-        echo -e "From:\nTo:" |./re_test -v '^From'
40
-       if your system is ok you should see 1 match, if not (and 
41
-       your libc has this bug), 0 matches.
42
-Workaround: ?upgrade?
43
-Desc: textops REs match newline in constructs such [^@]
44
-Ser version: all 
45
-Reason: there is a bug in newer linux libc versions (at least in
46
-         Debian libc6 2.3.x, Gentoo 1.4 lib 2.3.2, RH8, RH9, Fedora)
47
-Test:  compile test/re_test.c (gcc re_test.c -o re_test) and try
48
-        echo -e "From:\nTo:" |./re_test -v '[^.]+'
49
-       if your system is ok you should see 2 matches, if not (and 
50
-       your libc has this bug), only 1 match.
51
-Workaround: - use an older or fixed libc6 or avoid [^something]
52
-             - rewrite [^something] as [^something[:cntrl:]]
53
-Desc: memory leaks occurs if SIP requests are processed in which
54
-      a Via header field occurs in end of header and includes
55
-      a parameter
56
-Ser version: 0.8.10
57
-Reason: parameter fragment is not linked to a list when EoH is
58
-        encountered
59
-Patch: http://www.iptel.org/ser/issues/via_ml_0810.patch
60
-CVS Status: fixed
61
-Desc: ser segfaults on receipt of some messages (occurs
62
-      rather rarely with a very high number of messages, 
63
-      typically during stress tests)
64
-Ser version: 0.8.10 and before
65
-Reason: valid TM label value 0 is considered mistakenly 
66
-        a special value
67
-Workaround: turn syn_branch config option off
68
-Patch: http://www.iptel.org/ser/issues/hash_fix.patch
69
-CVS Status: fixed
70
-Desc: serctl returns "read: Illegal option -s" for "add user"
71
-Ser version: 0.8.10 and before
72
-Reason: serctl's use of some shell script commands not portable
73
-Workaround: download serctl 1.45 and set SUBSCRIBER_COLUMN back
74
-            to user_id
75
-Download: http://cvs.berlios.de/cgi-bin/viewcvs.cgi/*checkout*/ser/sip_router/scripts/sc?rev=1.45
76
-CVS Status: fixed
77
-Desc: 3261 ACKs for 200s are consumed by stateful processing
78
-Ser version: 0.8.10
79
-Reason: 200/ACKs which happen to have the same transaction ID
80
-        as original INVITE were not distinguished from hbh
81
-        ACKs and consequently absorbed
82
-Patch: http://www.iptel.org/ser/issues/tid3261ack.patch
83
-Workaround: apply the patch to 0.8.10 sources
84
-CVS status: fixed
85
-Desc: on sparc machines, usage of mysql library causes a bus error
86
-Ser version: 0.8.10
87
-Reason: ser is compiled with DBG_QM_MALLOC, which mistakenly uses
88
-        only alignment of four (ROUNDTO) -- insufficient for sparc
89
-        boxes, mysql library uses long long
90
-Workaround: recompile with DBG_QM_MALLOC turned off or ROUNDTO redefined
91
-            to 8
92
-CVS status: fixed
93
-Desc: nonce validation doesn't work correctly on big endian machines.
94
-BugId: 498
95
-Ser version: 0.8.10
96
-Patch: http://iptel.org/~janakj/nonce.c.patch
97
-Workaround: Apply the patch to 0.8.10 sources
98
-CVS status: fixed
99
-Desc: ser 0.8.10 memory leak when an INVITE containing Route
100
-      header fields is received.
101
-      Symptoms: ser reports No memory left or crashes with BUG: qm_*: fragm.
102
-BugId:n/a
103
-Ser version: 0.8.10
104
-Patch: http://iptel.org/~janakj/invroute.patch
105
-Workaround: Apply the patch to 0.8.10 sources
106
-CVS status: fixed
107
-Desc: ser 0.8.10 fails to remove consumed verified credentials properly
108
-      and leaves characters in forwarded messages when consume_credentials
109
-      is used
110
-BugId:n/a
111
-Ser version: 0.8.10
112
-Module:     http://www.iptel.org/~jiri/ser/auth.tar.gz
113
-Workaround: compile the auth module newly from sources above or
114
-            don't remove credentials (they only harm in terms of
115
-            packet size)
116
-CVS status: fixed
117
-Desc: ser 0.8.10 and earlier versions crash if contact list
118
-      excessively long
119
-BugId: n/a
120
-Ser version: 0.8.8, 0.8.9, 0.8.10
121
-Patch: http://www.iptel.org/ser/security/secalert-002-0_8_10.patch
122
-Workaround: apply the patch to 0.8.10 sources
123
-CVS status: fixed 
124
-Desc:  ser 0.8.10 won't compile with bison 1.75
125
-BugId:  n/a
126
-Ser version: 0.8.8, 0.8.9, 0.8.10 
127
-Patch: 
128
- 0.8.10 http://www.mobile-ip.de/~andrei/ser/0.8.10/ser-0.8.10-bison-1.75.patch
129
- 0.8.9  http://www.mobile-ip.de/~andrei/ser/0.8.9/ser-0.8.9-bison-1.75.patch
130
-Workaround: update from cvs,  apply the corresponding patch or downgrade bison
131
-CVS status: fixed
6
+  * https://github.com/kamailio/kamailio/issues
132 7
 
133
-=================================================================================
134
-* ser 0.8.10 released, all the issues below this are fixed in ser 0.8.10, all the
135
-* issues above are not :-)
136
-=================================================================================
8
+Issue Report Details
9
+--------------------
137 10
 
138
-Desc:  ser 0.8.9 won't log to stderr or syslog unless dontfork is set
139
-        (introduced when trying to fix bug 376)
140
-BugId:  n/a
141
-Ser version: =0.8.9 (0.8.8 is ok)
142
-Patch: http://www.mobile-ip.de/~andrei/ser/0.8.9/ser-0.8.9_log.patch
143
-Workaround: update from cvs or apply the patch.
144
-CVS status: fixed
145
-Desc: local domain mismatch resulting in infinite loops
146
-      (With default configuration and domain names in a request
147
-      URI's, ser may not match "owned domain" in the
148
-      script's uri==myself condition, consider the request to
149
-	  be for outside domain, and forward it to itself, resulting
150
-	  in an infinite loop and "482" returned back to UAC.)
151
-BugId: n/a
152
-Reason: aliases do not support reverse DNS lookups yet
153
-Workaround: Start ser with "alias=hostname" in config file
154
-CVS status: fixed
155
-Desc: sendto problems on FreeBSD
156
-      (when using tm sendto fails because of bad sockaddr len passed
157
-        to it)
158
-BugId: n/a
159
-Workaround:  update from cvs or  apply the following patch: 
160
-   http://www.mobile-ip.de/~andrei/ser/0.8.9/update_sock_struct_from_ip.patch
161
-CVS status:  fixed
162
-Desc: full ipv6 addresses (w/o ::) are converted to 0:0:0:0:0:0:0
163
-      (ser will listen on :: instead of the specified address)
164
-BugId: n/a
165
-Workaround: use ipv6 addresses w/ :: or compile ser without -DDNS_IP_HACK 
166
-            (Makefile.defs).
167
-CVS status: fixed
11
+When reporting an issue, gather as much details as possible and include them
12
+on the bug report. Useful details are:
168 13
 
169
-================================================================================
170
-* ser 0.8.9 released, all the issues below this are fixed in ser 0.8.9, all the
171
-* issues above are not :-)
172
-================================================================================
14
+  * kamailio version (output of kamailio -v)
15
+  * operating system where server is running
16
+  * CPU architecture of the system
17
+  * error log messages from syslog
18
+  * if there is a coredump file, use gdb to extract the following:
19
+    - full backtrace (gdb: bt full)
20
+    - local variables (gdb: info locals)
21
+    - list of the source code around the issue (gdb: list)
22
+  * information about when it happens:
23
+    - at startup
24
+    - at shutdown
25
+    - at runtime:
26
+      ~ randomly (no way to reproduce it has been discovered)
27
+      ~ periodically (an way to reproduce it has been discovered)
173 28
 
174
-Desc: in default configuration, SER prints '127.0.0.1' in
175
-      Warning header field of all replies
176
-BugId: 372
177
-Workaround: use listen=<ip_address> in your configuration file;
178
-      that will make SER listen only on one interface (and not
179
-      on '127.0.0.1' in parallel) and advertise correct IP
180
-      address
181
-Bug reason: multiple listening address ignored in message
182
-      translator
183
-CVS status: fixed
184
-Desc: serctl add ... returns "user exists"
185
-BugId: 374
186
-Workaround: either use serweb for adding new users or update
187
-      the serctl utility from CVS; the fixed version is at
188
-      http://www.iptel.org/ser/issues/374/
189
-Bug reason: phplib_id ignored in sc
190
-CVS Status: fixed
191
-Desc: SMS, MSILO & JABBER modules fail to load because of unresolved
192
-dependency on im.so
193
-BugId: 375
194
-Workaround: change the makefiles & recompile  
195
-Bug reason: removal of RTLD_GLOBAL from dlopen.
196
-CVS status: fixed 
197
-Desc: when forking & std_error=yes no open FD is closed
198
-BugId: 376
199
-CVS status: fixed
200
-Desc: exec module missing in binary RPM distro
201
-BugId: -
202
-CVS status: fixed
203
-Workaround: compile from source distribution
204
-Desc: when debug=3 & iptel.cfg is used mysql module fails in submit_query.
205
-Workaround: use debug=9 or use log_stderr
206
-Reason: unknown
207
-BugId: 377
208
-Cvs status: not fixed
29
+Contact
30
+-------
209 31
 
32
+If you have further questions about reporting an issue, email to:
210 33
 
211
-================================================================================
212
-* OS-related issues
213
-================================================================================
214
-
215
-Desc:  ser won't run on linux kernels <2.4  (fails with EINVAL when
216
-      initializing the shared memory)
217
-BugId:  n/a
218
-Ser version: 0.8.8, 0.8.9, 0.8.10 
219
-Workaround: Upgrade to a 2.4.* kernel (older kernels don't support shared 
220
-            mmaping of /dev/zero ) or recompile ser with SYSV shm instead of
221
-            mmap (remove -DSHM_MMAP from Makefile.defs)
222
-CVS status: n/a
223
-Desc: Solaris resolver memory leak
224
-	  (getipnodebyname on Solaris has a memory leak. unpatched
225
-	  solaris 8 installations will fail after processing 
226
-	  ~ 360000 requests)
227
-BugId: n/a
228
-CVS status: n/a
229
-Workaround: patch your Solaris OS
34
+  * sr-dev@lists.sip-router.org