Linux Fast-STREAMS -- 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).
7.5 Bugs
========
7.5.1 Defect Notices
--------------------
"Linux Fast-STREAMS" 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.
7.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". "Linux Fast-STREAMS" had no
known bugs at the time of release.
7.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
.....
`006. 2007-03-14T23:48:26-0600'
There appears to be an inode lock imbalance that occurred for
several clone error paths in stropen. If the returned major
device number does not correspond to a driver, or an snode cannot
be acquired for the new entry and the stream head reparented.
_*fixed*_ in `streams-0.9.2.2'
`005. 2007-03-07T15:53:06-0700'
Demand loading of kernel modules for clone devices opened, for
example, as /dev/streams/clone/mux was requesting module
streams-clone-mux and /dev/streams/clone/mux but was not requesting
streams-mux or /dev/streams/mux and the modules were failing to
demand load.
_*fixed*_ in `streams-0.9.2.2'
`004. 2007-02-26T08:25:09-0700'
Jérémy Composte pointed out error in clone.c. When an automatic
clone minor device was unregistered, it was unregistering the
modid instead of the major number. This was not noticed because
all OpenSS7 drivers have the same modid as major number (strconf
does this automatically).
_*fixed*_ in `streams-0.9.2.2'
`003. 2007-02-26T08:25:09-0700'
Jérémy Composte pointed out syntax error in strsched.c that kept
synqs from compiling properly.
_*fixed*_ in `streams-0.9.2.2'
`002. 2006-09-24T20:02:00+0000'
Discovered asynchronous thread cancellation inconsistencies in
libLiS libpLiS by inspection during documentation. isastream(2),
fattach(2) were not performing proper asynchronous thread
cancellation suppression so that these function contained a
cancellation point when the should not.
_*fixed*_ in `streams-0.7a.6.rc3'
`001. 2006-07-05T21:54:49+0000'
Fedora Core 5 reports a rwlock bug during udp module unloading as
follows:
BUG: rwlock wrong CPU on CPU#0, rmmod/7515
Call Trace:
{rwlock_bug+100}
{_raw_write_unlock+88}
{:streams:unregister_strnod+211}
{:streams:unregister_clone+64}
{:streams:unregister_strdev+24}
{:streams_udp:udpterminate+26}
{sys_delete_module+406}
{system_call+126}
It appears that unregister_strnod() is scheduling while holding a
write lock on cdevsw_lock. This is probably in iput() called
within cmin_del.
_*fixed*_ in `streams-0.7a.6.rc2'
There were a number of places where sleeping functions were called
with spin-locks held, causing the CPU awaking from the sleep to
sometimes be different from the CPU that took the lock. This was
buggy, so I reworked all of these cdev and fmod sections to handle
spin locks properly. FC5/SMP on HT no longer reports these bugs.
-----
=========================================================================
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