change.doc

以太网交换机协议平台stp协议的设计与实现源代码。

SPANNING TREE CHANGE FILE - Contact RouterWare Support at
[e-mail] (please put STP: <problem> in title)
ftp.routerware.com
FAX [phone]
---------------------------------------------------------------------
This file will always contain the latest changes, with a date and a
release version number.  Please note that the release version number
will not necessarily coincide with all the files internal version
number (but they should be close).
---------------------------------------------------------------------
Recent Changes up to and including Spanning Tree v4.3.0 Date:12/03/98
	MACBSNMP.C:
	----------------------------------------------------------------------------------
	A. Changes to the get_spanning_tree_mib_variable () function:

		1. Updated the  prototype declaration and the functionality to 
		   process the MIB request.
	 	   	    
	 	2. Pre-penned the "stp" keyword to spanning tree snmp handler 
	 	   function.

	B. Header file change:
		1. Removed the inclusion of the  <visnpstr.h>  header file 
	 	   and add it to the macbridg.h file after the declaration 
	 	   of <LSLPROTO.H>.
    
	MACBRINI.C:
	----------------------------------------------------------------------------------
	A. Registered the SNMP handler function with LSL module.

	B. The check_for_stp_initialization_breakpoint () function was
	   	1. added to the initialize_bridge () function. 
 			   
	C. Change to compare_addresses () function:
		1. change the address_1 and address_2 pointers from USHORT to 
 		   BYTE.
 			   
	D. Removed the routerware_control () function 			   
	
	
	MACBRCFG.C:
	----------------------------------------------------------------------------------
	A. Changes to mac_bridge_control () function:
			
   		1. Updated the type casting of "parameter_1" argument 
		   to BYTE_ENUM and USHORT_ENUM macros. The following command 
		   statement where changed.

	   	   	IS_PROTOCOL_STACK_ENABLE
			GET_NUMBER_OF_PROTOCOL_STACKS_VIRTUAL_PORT
			GET_PROTOCOL_STACK_TYPE
			GET_PROTOCOL_STACK_PROTOCOL_ID
			GET_PROTOCOL_STACK_SSAP
			GET_PROTOCOL_STACK_DSAP
			GET_PROTOCOL_STACK_VIRTUAL_PORT_PACKET_TYPE
			      
		 2. Added the CLOSE_PROTOCOL_STACK case statement.    
			   
	MACBRMGT.C
	----------------------------------------------------------------------------------
	 A. Added the STP_ALGORITHM_PRINT case statement to the 
	    printf_group in stp_printf () function. 



	MACBRRX.C
	----------------------------------------------------------------------------------
	A. Changes to send_broadcast_packet () function:
			
		1. The code to allocate memory for the received buffer 
		   was removed.  The LSL module handles sending a copy 
		   of the received buffer to all ports in forwarding state. 
		   In addition, the LSL module will due any buffer clean up. 
				   		       
		2. Assigned the default return value of PACKET_NOT_RECOGNIZED 
		   when no ports are in forwarding state.


	B. Change to the send_mac_bridge_completion_routine () function:
			
   	   	1. The functins calls the LSL module to clean up the transmitted
		   packet.  Note, the "buffer_free ()" routine was removed in 
   	           order to compily with the changes to send_broadcast_packet()
		   function.


	C. Change to mac_bridge_rx ( ) function:
			
		1. Removed the default assignment of the return value when 
		   receiving a broadcast.
			    
			   
	MACBRSPN.C	
	----------------------------------------------------------------------------------
	A. Changes to transmit_configuration () function:
		
		1. Type cast the topology_change_acknowledgement flag to 
		   BYTE boundary

		   stp_class.bridge_configuration_BPDU[port_number].flags.topology_change_acknowledgement =
					(BYTE) stp_class.port[port_number].topology_change_acknowledgement;

		2. Type cast the topology_change flag to BYTE boundary.

		   stp_class.bridge_configuration_BPDU[port_number].flags.topology_change = 
						(BYTE) stp_class.this_bridge.topology_change;

	B. Change to record_configuration_port_information () function:

		1. Removed the addition of 1 to the root path cost.


	C. Change to initialize_port () function:
			
		1. Initialized the following snmp port parameters. 
			
		    stp_class.port[port_number].dot1dBasePort = port_number;
		    stp_class.port[port_number].dot1dBasePortIfIndex = port_number;
		
	D. Change to setup_this_bridge_values () function:		
			
		1. Replaced the stp_class.this_bridge.hold_time variable from HELLO_TIME with HOLD_TIME.

	MACBRDB.C
	----------------------------------------------------------------------------------
	A. Added the following reserved to the forwarding table
			  				
		01-80-C2-00-00-01
		01-80-C2-00-00-02
		01-80-C2-00-00-03
		01-80-C2-00-00-04
		01-80-C2-00-00-05
		01-80-C2-00-00-06
		01-80-C2-00-00-07
		01-80-C2-00-00-08
		01-80-C2-00-00-09
		01-80-C2-00-00-0A
		01-80-C2-00-00-0B
		01-80-C2-00-00-0C
		01-80-C2-00-00-0D
		01-80-C2-00-00-0E
		01-80-C2-00-00-0F
			
	MACBRTIM.C
	----------------------------------------------------------------------------------
	A. Change to hello_timer_expired () function:

	   	1. Added the USHORT port_number argument.
				
	B. Change to topology_change_notice_timer_expired () function:	

   		1. Added the USHORT port_number argument.
			   
	c. Change to topology_change_timer_expired ( )   

   		1. Added the USHORT port_number argument.
			   

	VMACBSTR.H:
	----------------------------------------------------------------------------------
	A. The following new variables where added to the STP_CLASS.
			
	   	1. enum BOOLEAN		stp_algorithm_printing_enabled;
	   	2. BYTE_ENUM (BOOLEAN)  initialization_breakpoint_enabled;
			   
	B. Added packing directives to the following structures
			
		BRIDGE_IDENTIFIER	   
		PORT_IDENTIFIER
		BRIDGE_CONFIGURATION_BPDU

	C. Removed TURN_OFF_ALIGNMENT preprocessor directive

    

	VMACSNMP.H: 
	----------------------------------------------------------------------------------

	A. Update the "spanning_tree_snmp_table_parameters" and 
	   "spanning_tree_snmp_table" to reflect the changes to 
	   snmp component in the rwutils module.

	MACBRIDG.H: 
	----------------------------------------------------------------------------------	
   	A. Added the "visnpstr.h" header file

	VMACBSTR.H: 
	----------------------------------------------------------------------------------
	A. Added the prototype definition for "get_spanning_tree_mib_variable ()".


	VNVSTP.H:
	----------------------------------------------------------------------------------
	A. The following configuration string where added.
	
		1. Spanning Tree Initialization Breakpoint
			
		2. Spanning Tree Algorithm Printf
			  
  	B. Added the set_enum_enable function to the following configuration
	   parameters.
		 
	  	"Spanning Tree =",
  	 	"Spanning Tree Algorithm =",
 		"Spanning Tree Initialization Breakpoint =",
		"Spanning Tree Algorithm Printf ="
				
  	C. Removed the __MSC_VER__ spanning tree configuration parameter.
			  
		    
	D. Replaced the configuration set function for "Spanning Tree Number of Ports" 
  	   parameter.
		   

	KMACBR.H
	----------------------------------------------------------------------------------
   	A. New constant:
		1. DEFAULT_NUMBER_OF_FILTERING_DATABASE_ENTRIES  

	 	2. DEFAULT_NUMBER_OF_HASH_TABLE_ENTRIES 		   

	  	3. DEFAULT_PORT_MAXIMUM_FRAME_SIZE	  		   
			  
		4. HOLD_TIME    
			
			
   	B. Removed __MSDOS__ preprocessor directives				
		   
	C. Removed the enum RX_PACKET_STATE enumerated type. 



			
Algorithm Changes:
------------------


Management Changes:
------------------

Cosmetic Changes:
----------------

	1. Change the syntax to all the preprocessor directives.
	 	From: 
			#ifdef __DIRECTIVE__ and  #ifndef __DIRECTIVE__
	 	TO:	
			#if defined (__DIRECTIVE__) and #if !defined (__DIRECTIVE__)

	2. Updated the copyright notice to all include and source files.

	3. Change the MSC_VER directive to __WINROUTER__.

	4. Cosmetic changes were applied for LINT compilation.

	
File Name Additions/Changes:
-----------------
	
	
Upcoming Changes:
----------------



---------------------------------------------------------------------
Recent Changes up to and including Spanning Tree v2.17 2/6/96

Algorithm Changes:
-----------------

1.  Change timers so the snmp folks are happy (short->long).

Management Changes:
------------------

1.  Change snmp header files to match latest changes in agent.

Upcoming Changes:
----------------

1.  Minimizing hash table size.  

---------------------------------------------------------------------
Recent Changes up to and including Spanning Tree v2.16 6/27/95

Algorithm Changes:
-----------------

1.  Fixed allocation problem with broadcasts.

Management Changes:
------------------

Upcoming Changes:
----------------

1.  Removing #ifdefs which are not used.
2.  Minimizing hash table size.  

---------------------------------------------------------------------
Recent Changes up to and including Spanning Tree v2.15 3/31/95

Algorithm Changes:
-----------------

1.  Minor bug fixes.
2.  Added rwutils library.
3.  Added rwarebuf.h header file.
4.  Changed LSL conditional compile.


Management Changes:
------------------

Upcoming Changes:
----------------

1.  Removing #ifdefs which are not used.
2.  Minimizing hash table size.  

---------------------------------------------------------------------
Recent Changes up to and including Spanning Tree v2.14 8/25/94

Algorithm Changes:
-----------------

1.  Added support for BYTE_ENUM and USHORT_ENUM for compilers that
can't pack enumerated types.
2.  Removed check for designated port in forwarding timer expired in
macbrtim.c.  Courtesy of Sanjeev.
3.  Fixed bug with topology_change_acknowledgement changed TRUE to
FALSE.  In record_port_info added 1 to the root path cost.   
4.  Got rid of a warning using a cast.


Management Changes:
------------------

Upcoming Changes:
----------------

1.  Removing #ifdefs which are not used.
2.  Minimizing hash table size.  
3.  Allocation function indirection.

---------------------------------------------------------------------
Recent Changes up to and including Spanning Tree v2.13 6/15/94

Algorithm Changes:
-----------------

1.  Added snmp access routines.
2.  Cleanup for code style.

Management Changes:
------------------

Upcoming Changes:
----------------

---------------------------------------------------------------------
Recent Changes up to and including Spanning Tree v2.12 5/9/94

Algorithm Changes:
-----------------

1.  Added support for configurable SRT forwarding state.

Management Changes:
------------------

Upcoming Changes:
----------------

---------------------------------------------------------------------
Recent Changes up to and including Spanning Tree v2.11 3/23/94

Algorithm Changes:
-----------------

1.  Added support for new nvram.
2.  Fixed timer granularity bug courtesy of Rick.

Management Changes:
------------------

Upcoming Changes:
----------------