OpenSS7 STREAMS SCTP -- defects. 2007-03-15
$Id$
Copyright (c) 2001-2007 OpenSS7 Corporation.
Copyright (c) 1997-2000 Brian Bidulock
See the end for copying conditions (for this file).
6.5 Bugs
========
6.5.1 Defect Notices
--------------------
"OpenSS7 STREAMS SCTP" could possibly contain unknown defects. This is
a "production" release. Nevertheless, some remaining unknown defects
could possibly be harmful. Validation testing has been performed by
the `OpenSS7 Project' and external entities on this software for the
set of systems listed in the release notes. Nevertheless, the software
might still fail to configure or compile on other systems. The
`OpenSS7 Project' recommends that you validate this software for your
target system before using this software. Use at your own risk.
Remember that there is NO WARRANTY.(1)
This software is production software. As such, it is stable on
validated systems but might still crash your kernel in unique
circumstances. Installation of the software on a non-validated
distribution might mangle your header files or Linux distribution in
such a way as to make it unusable. Crashes could possibly lock your
system and rebooting the system might not repair the problem. You can
possibly lose all the data on your system. Because this software
stands a chance of crashing your kernel, the resulting unstable system
could possibly destroy computer hardware or peripherals making them
unusable. You might void the warranty on any system on which you run
this software. YOU HAVE BEEN WARNED.
---------- Footnotes ----------
(1) See section NO WARRANTY under `GNU General Public License', in the
manual.
6.5.2 Known Defects
-------------------
With the exception of packages not originally created by the `OpenSS7
Project', the `OpenSS7 Project' software does not ship with known bugs
in any release stage except "pre-alpha". "OpenSS7 STREAMS SCTP" had no
known bugs at the time of release.
6.5.3 Defect History
--------------------
This section contains historical bugs that were encountered during
development and their resolutions. This list serves two purposes:
1. It captures bugs encountered between releases during development
that could possibly reoccur (and the Moon is made of blue cheese).
It therefore provides a place for users to look if they encounter
a problem.
2. It provides a low overhead bug list between releases for
developers to use as a `TODO' list.
Bugs
.....
`004. 2007-03-14T17:36:31-0600'
Another bug found, a double buffer free in sctp_recv_msg() when
calling sctp_rcv_ootb(). This bug was discovered during
verification testing on a high speed SMP machine.
_*fixed*_ in `strsctp-0.9.2.7'
`003. 2007-03-10T05:59:10-0700'
One serious locking problem discovered. sctp_cleanup_read() was
suppressing IRQs across calls to putnext() when delivering data
and acknowledgements. Recent kernels on Fedora and Ubuntu were
complaining about IRQs suppressed across calls to
local_bh_enable() in M2PA and that is what lead to the discovery.
_*fixed*_ in `strsctp-0.9.2.7'
`test-sctp_n -o 9.1 Sun, 29 Oct 2006 16:27:35 -0700'
`test-sctp_n -o 9.2 Sun, 29 Oct 2006 16:27:35 -0700'
When the number of test packets is set to 300, we are crashing on
high speed SMP HT box. This seems to be a locking problem of
sorts, or some flow control race condition. For now, the number
of test packets, TEST_PACKETS has been reduced from 300 to 30 to
avoid the crash. Again, packet tests at IP level should reveal
this problem.
Note that there does not seem to be a problem with similar TPI
tests, so the problem might be NPI interface related after all.
`test-sctp_n -o 7.1 Sun, 15 Oct 2006 06:22:05 -0600'
I notice that when the message size in this test is larger than
the receive window size on the receiver, the receiver aborts the
association after its window fills. If the message size is
reduced to just beneath the receive window size, the test case
succeeds. So, it looks like we are not handling zero window
probes very well at all. For now I have just reduced the message
size as this is for interface testing not packet testing. Packet
tests at IP level should reveal this problem.
-----
=========================================================================
Copyright (c) 2001-2007 OpenSS7 Corporation
Copyright (c) 1997-2000 Brian Bidulock
All Rights Reserved.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.
Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one
Since the Linux kernel and libraries are constantly changing, this
manual page may be incorrect or out-of-date. The author(s) assume no
responsibility for errors or omissions, or for damages resulting from
the use of the information contained herein. The author(s) may not
have taken the same level of care in the production of this manual,
which is licensed free of charge, as they might when working
professionally.
Formatted or processed versions of this manual, if unaccompanied by the
source, must acknowledge the copyright and authors of this work.
-------------------------------------------------------------------------
U.S. GOVERNMENT RESTRICTED RIGHTS. If you are licensing this Software
on behalf of the U.S. Government ("Government"), the following
provisions apply to you. If the Software is supplied by the Department
of Defense ("DoD"), it is classified as "Commercial Computer Software"
under paragraph 252.227-7014 of the DoD Supplement to the Federal
Acquisition Regulations ("DFARS") (or any successor regulations) and
the Government is acquiring only the license rights granted herein (the
license rights customarily provided to non-Government users). If the
Software is supplied to any unit or agency of the Government other than
DoD, it is classified as "Restricted Computer Software" and the
Government's rights in the Software are defined in paragraph 52.227-19
of the Federal Acquisition Regulations ("FAR") (or any successor
regulations) or, in the cases of NASA, in paragraph 18.52.227-86 of the
NASA Supplement to the FAR (or any successor regulations).
=========================================================================
Commercial licensing and support of this software is available from
OpenSS7 Corporation at a fee. See http://www.openss7.com/
=========================================================================
vim: ft=README tw=72 nocindent nosmartindent formatoptions+=tcqlorn