Problem
What problems are addressed by Support Level Supplement (SLS) OSS605A, the NetBIOS Drivers Supplement for SCO OpenServer Release 5.0.4 and 5.0.5?
Solution
SLS OSS605A addresses and corrects the following problems, which are known to occur when running applications that use NetBIOS to send and receive data over TCP/IP between a client system and SCO OpenServer Release 5.0.4 or 5.0.5:
(1) If the sender closed a NetBIOS over TCP session before
the receiver had finished reading the data, a kernel panic
could result. The resulting panic message is:PANIC: k_trap - kernel mode trap type 0x0000000EAssociated SCO Tracking Numbers: SCO-236-1148, 710373(2) If the sender closed a NetBIOS over TCP session before the receiver had finished reading the data, any NetBIOS packets still buffered in the receiver's kernel could be lost.
See the attached cover letter that accompanies this SLS for more information, including installation instructions.
NOTES: Please be aware of the minor modification of the file
/etc/conf/pack.d/nb/space.c in the instructions below. This
change needs to be made after installing SLS OSS605A in order
to address problem (2) above.Please be aware that the /etc/conf/pack.d/nb/space.c file
mentioned above is actually a replacement of the preexisting
space.c. In the event that this original space.c file had
been modified and you wish to either recover it or merge the
changes into the new space.c, a saved copy is available at
/usr/lib/custom/oss605a.sav/space.c.Dear SCO Customer,Support Level Supplement (SLS) OSS605A, the NetBIOS Drivers Supplement for SCO OpenServer Release 5.0.4 and 5.0.5, installs an updated nb driver.
SLS OSS605A corrects these problems:1. If the sender closed a NetBIOS over TCP session before the
receiver had finished reading the data, a kernel panic could
result. The resulting panic message is:PANIC: k_trap - kernel mode trap type 0x0000000EAssociated SCO Tracking Numbers: SCO-236-1148, 7103732. If the sender closed a NetBIOS over TCP session before the receiver had finished reading the data, any NetBIOS packets still buffered in the receiver's kernel could be lost.
Note: By default, this behavior remains the same, for backward
compatibility. In order to give the receiving application up to
30 seconds to read the last NetBIOS packets after the sender has
closed the NetBIOS over TCP session, do the following:- Modify "/etc/conf/pack.d/nb/space.c", changing "int nb_allow_tpi_ordrel = 0;" to "int nb_allow_tpi_ordrel = 1;". - Relink the kernel. - Reboot.
These instructions are contained in the complete OSS605A installation procedure below.
Software Notes and Recommendations
----------------------------------SLS OSS605A should only be installed on:
SCO OpenServer Enterprise System Release 5.0.4, 5.0.5 SCO OpenServer Host System Release 5.0.4, 5.0.5 SCO OpenServer Desktop System Release 5.0.4, 5.0.5
Installation Instructions
-------------------------1. Download the OSS605A media image file (oss605a file). Place the file in the /tmp directory and rename the file by typing these commands:
mv /tmp/oss605a /tmp/VOL.000.0002. Run the Software Manager with the command:
# scoadmin softwareor double-click on the Software Manager icon in the desktop.
3. Pull down the "Software" menu and select "Install New".
4. When prompted for the host from which to install, choose the local machine and then "Continue".
5. In the "Select Media" menu, pull down the "Media Device" menu. Select "Media Images", then choose "Continue".
6. When prompted for the "Image Directory", enter "/tmp" (or the directory where you placed the VOL file in step 1) and choose "OK".
7. When prompted to select software to install, make sure that the
"OSS605A" entry is highlighted. Choose "Install".8. Installation of SLS OSS605A is now complete, although step 9 should
be carried out, if desired (according to the above discussion of
the problems addressed by OSS605A), before rebooting. To exit the
Software Manager, select "Exit" from the "Host" menu.9. In order to configure the NetBIOS driver to save, for 30 seconds, the last NetBIOS packets sent by an application which has closed the NetBIOS over TCP session, perform the following steps:
- Edit the /etc/conf/pack.d/nb/space.c file# cd /etc/conf/pack.d/nb
# vi space.c- Find the line which reads "int nb_allow_tpi_ordrel = 0;" and change this to "int nb_allow_tpi_ordrel = 1;"
- Relink the kernel:# cd ../../cf.d
# ./link_unix -y- Reboot the system for all changes to take effect.
Note: Please be aware that the /etc/conf/pack.d/nb/space.c file
mentioned above is actually a replacement of the pre-existing
space.c. In the event that this original space.c file had
been modified and you wish to either recover it or merge the
changes into the new space.c, a saved copy is available at
/usr/lib/custom/oss605a.sav/space.c.Removal Instructions
--------------------Note: Patches must be rolled back in the reverse order in which they
were installed on a per-component basis. That is, if the NetBIOS Drivers
Supplement is not the most recent patch applied to the TCP component of
the product, you will have to roll back all patches applied after the
NetBIOS Drivers Supplement prior to rollback of the NetBIOS Drivers
Supplement.To remove SLS OSS605A, take these steps:
1. Log in as root.2. Execute the command:# scoadmin softwareor double-click on the Software Manager icon in the desktop.
3. Highlight "OSS605A: NetBIOS Drivers Supplement".4. Pull down the "Software" menu and select "Remove Software".
5. Once the removal finishes, quit the Software Manager. Removal of
SLS OSS605A is now complete.If you have questions regarding this SLS, or the product on which it is installed, please contact your software supplier.