Technical article 110501

What is SLS OSS605A, the NetBIOS Drivers Supplement for SCO OpenServer Release 5.0.4 and 5.0.5?

OpenServer 5.0.4OpenServer 5.0.5

Written · Last revised

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 0x0000000E
Associated 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 0x0000000E
Associated 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.

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.000

2. Run the Software Manager with the command:

# scoadmin software

or 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 software

or 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.

From the Xinuos technical article database, record 110501. Reproduced with permission. The original is at www.sco.com/ta/110501, which is reachable but blocked from search engines. Xinuos marks this article against a retired product line. That refers to the product’s lifecycle, not to whether the advice still works — plenty of it still applies to running systems.

Next step

Need this fixed rather than explained?

Tell us the release, what the system runs and what it is doing. We will reply by email with what we would do next.

  • You deal with the people who do the work
  • No obligation, and no upgrade required before we will help
  • We tell you plainly if something is not worth doing

Send an enquiry

We reply by email. If a server is down, say so in the first line. You can also write to help@scoexpert.com.