Patch-ID# 110527-04
Keywords: token ring PCI driver system panic beacon ttcp tri/p trp_beacon_warn
Synopsis: SunLink TRI/P 5.0: Token Ring Driver Patch
Date: Mar/28/2003

Install Requirements: None                      
Solaris Release: 8

SunOS Release: 5.8

Unbundled Product: SunLink/TRI/P

Unbundled Release: 5.0

Xref: 

Topic: 

Relevant Architectures: sparc

BugId's fixed with this patch: 4357138 4367101 4380474 4382603 4419468 4520637 4630723 4753618 4755877 4783907

Changes incorporated in this version: 4753618 4755877 4783907

Patches accumulated and obsoleted by this patch: 

Patches which conflict with this patch: 

Patches required with this patch: 

Obsoleted by: 

Files included with this patch: 

/kernel/drv/sparcv9/trp
/kernel/drv/trp

Problem Description:

4753618 trp: [ID 488867 kern.info] Mdg HJU setting mp->b_next to NULL
4755877 udt headers enum declarations needs fix for compiler warnings
4783907 The RIF bugfixes tri-p driver enhancement needs to be documented
 
(from 110527-03)
4630723 tri/p always reports IfInOctets and IfSpeed as 0
4520637 tri/p adaptor link status is cycling up/down
 
(from 110527-02)
4419468 ifOperStatus.4 = down(2) when single station mode detected
 
(from 110527-01)
4382603 TRI/P 5.0 rev 5.26 losing source route
4357138 starcat system panics when running ttcp tests over TRI/P
4367101 System panics when running TTCP with TRI/P nic adapter.
4380474 pci token ring beaconing problems with version 5.0 of driver

Patch Installation Instructions:
-------------------------------- 
For Solaris 8 releases, refer to the man pages for instructions on
using 'patchadd' and 'patchrm' scripts provided with Solaris.
Any other special or non-generic installation instructions should be
described below as special instructions.  The following example
installs a patch to a standalone machine:
 
        example# patchadd /var/spool/patch/104945-02
 
The following example removes a patch from a standalone system:
 
        example# patchrm 104945-02
 
For additional examples please see the appropriate man pages.

Special Install Instructions:
----------------------------- 
After installing this patch, reboot the system to load the newly installed 
driver.
 
Driver Tunables
---------------
 
Some new tri-p driver parameters are introduced since bugfixes:
 
4316474 Token ring Frames being transmitted without RIF
4382603 TRI/P 5.0 rev 5.26 losing source route
 
trp_sr_max_local_tries, trp_sr_max_single_tries, trp_sr_expiry_secs,
and trp_sr_sticky_secs are parameter that affect all adapters. 
These parameters are used to control the behavior of the source 
routing cache.
 
trp_sr_max_local_tries specifies how many attempts will be made
to locate a remote node on the local ring before a source-route
explorer frame is sent.
 
trp_sr_max_single_tries specifies how many single-route source-route
explorers will be sent before an all-routes source-route explorer is
sent.
 
trp_sr_expiry_secs specifies for how many seconds a source routing
cache entry is considered valid.
 
trp_sr_sticky_secs is the minimum time for which a source routing
cache entry will be used before it may be updated by a received frame.
 
The default values and ranges are as follows:
 
trp_sr_max_local_tries:  default = 1,  min = 0, max = 10
trp_sr_max_single_tries: default = 1,  min = 0, max = 10
trp_sr_expiry_secs:      default = 30, min = 0, max = 86400
trp_sr_sticky_secs:      default = 3,  min = 0, max = 86400
 
A new external trp_any_multicast_rif_hold has been added to capture
all multicast rifs that pass by the node. If the user sets this to 1
then capture will occur, else the driver will behave as normal.
 
To fix bugs 4316474, 4382603 in addition to installing the patch,
these parameters have to be defined as follows in the trp.conf file.
 
trp_sr_max_local_tries = 0;
trp_sr_max_single_tries = 0;
trp_sr_expiry_secs = 60;
trp_sr_sticky_secs = 10;
 
trp_any_multicast_rif_hold = 1;

README -- Last modified date:  Friday, March 28, 2003