TECHNICAL INFORMATION DOCUMENT TITLE: PTF148 - Token Ring Hardware Support Update DOCUMENT ID: TID021423 DOCUMENT REVISION: E DATE: 25JAN95 ALERT STATUS: Yellow INFORMATION TYPE: Symptom Solution README FOR: PTF148 PRODUCT and VERSION: UnixWare 1.1 ABSTRACT: This PTF is a rerelease of the Token Ring Hardware Support package. Because it is necessary to completely replace the original package, this package will be installed as the "tok" package (instead of "ptf148"). Additionally (and also as a result of this being a package rerelease), backup/restore processing as normally done by PTFs is not performed. This patch should be installed on all UnixWare 1.1.1 systems which have the Token Ring Hardware Support (tok) package installed. SYMPTOM Token Ring Hardware Support did not fully function under UnixWare 1.1. Various error events (most commonly, inadvertently disconnecting the network cable, but also including the receipt of a MAC remove frame) would result in the network interface being permanently disabled until the next system reboot. SOLUTION Apply the ptf148 file. Installation Instructions: DATATYPE: datastream 1. Download the ptf148.Z and ptf148.txt files to the /tmp directory on your machine. 2. Read the release notes contained in this file. 3. Now become root, uncompress the file and add the package to your system using the following commands: $ su # uncompress /tmp/ptf148.Z # pkgadd -d /tmp/ptf148 Solution Specifics These release notes acquaint you with the contents of UnixWare PTF148 - Token Ring Hardware Support Update 1. General Description This PTF is a re-release of the Token Ring Hardware Support package. Because it is necessary to completely replace the original package, this package will be installed as the "tok" package (instead of "ptf148"). Additionally (and also as a result of this being a package re-release), backup/restore processing as normally done by PTFs is not performed. The following problems are resolved by this updated package: - Various error events (most commonly, inadvertently disconnecting the network cable, but also including the receipt of a MAC remove frame) would result in the network interface being permanently disabled until the next system reboot. The problem is corrected for those situations where the error occurs after the system is up and running; if the cable is disconnected when the system is booted, however, a reboot still will be necessary after the cable is connected. - Packet sizes are limited to a maximum of 1500 bytes. The maximum packet size is now 8192 bytes. Please see the comments in /etc/conf/pack.d/ibmtok/space.c for information on enabling larger packet sizes. - Only one adapter card could be installed because errors would occur when rebuilding the kernel after a second card was installed. This has been corrected. Version 1.2 additionally contains resolutions for the following: - PANICs when using the LLC2 or RAW modes (used by some communications software packages). These occurred when using a communications package developed with an incompatible prototype implementation of these features. Additional error checking was added and a failure indication is now returned to the user process. - Cannot use Source Routing when the LLC2 or RAW modes are to be used. Source Routing is now disabled on a per-user basis when either LLC2 or RAW mode is requested. This allows Source Routing to be used where applicable while concurrently supporting LLC2 and RAW modes for those packages that require them. - Cannot reuse DLSAP address after closing stream in DL_IDLE state. When a stream is closed without first issuing a DL_UNBIND_REQ, all resources allocated for the address associated with the stream are now released, so that the address can now be reused. Version 1.3 resolves the following: - Additional errors found in multiple card support. Initialization errors reported in some configuration have been corrected. - Failure indications returned to some users of LLC2 mode. Some packages using LLC2 mode incorrectly set dl_dest_addr_length. The additional error checking added earlier (version 1.2) caused messages with an incorrect length value to be rejected. The error checking was modified somewhat to accomodate the erroneous length when LLC2 mode has been enabled. 2. New Features A Locally Administered Address is now supported. Please see the comments in /etc/conf/pack.d/ibmtok/space.c for information on configuring a Locally Administered Address. 3. Software Notes and Recommendations This patch should be installed on all UnixWare 1.1.1 systems which have the Token Ring Hardware Support (tok) package installed. 4. Hardware Notes and Recommendations None 5. Installation Instructions Before this re-release of the Token Ring Hardware Support package can be installed, you must first remove the previous version (pkgrm tok). Then, depending on the format: If this PTF was delivered on a diskette, then (as "root") pkgadd -d diskette1 should install this patch. Otherwise, if you have a file such as "ptf148" which is in a "stream" format, then (as "root") pkgadd -d /ptf148 will work. After installing this patch, a system reboot will be needed to rebuild the kernel and incorporate the updated driver(s). Because this is a re-release, backup/restore is not performed. To remove this version of the package and install the previous version, you must first pkgrm this version, followed by pkgadd of the previous version. 6. Troubleshooting For most error events, attempts to reopen the adapter are made at 1-minute intervals. As recommended by the Token Ring Technical Reference manual, when the adapter is shut down due to the receipt of a MAC REMOVE frame, a 6-minute interval is used (if some other error is detected on attempting to reopen the adapter, however, the 1-minute interval will be used).