|
|
This chapter explains the function and syntax of the source-route bridging commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Cisco IOS Bridging and IBM Networking Command Reference, Volume 1, Release 12.1.
Syntax Description
in | out Either in or out is specified to indicate whether the access expression is applied to packets entering or leaving this interface. You can specify both an input and an output access expression for an interface, but only one of each. expression Boolean access list expression.
To configure the access list mechanism for filtering frames by protocol type or vendor code, use the access-list global configuration command. Use the no form of this command to remove the single specified entry from the access list.
access-list access-list-number {permit | deny} {type-code wild-mask | address mask}
Syntax Description
access-list-number Integer that identifies the access list. If the type-code wild-mask arguments are included, this integer ranges from 200 to 299, indicating that filtering is by protocol type. If the address and mask arguments are included, this integer ranges from 700 to 799, indicating that filtering is by vendor code. permit Permits the frame. deny Denies the frame. type-code 16-bit hexadecimal number written with a leading 0x; for example, 0x6000. Specify either a Link Service Access Point (LSAP) type code for 802-encapsulated packets or a SNAP type code for SNAP-encapsulated packets. (LSAP, sometimes called SAP, refers to the type codes found in the DSAP and SSAP fields of the 802 header.) wild-mask 16-bit hexadecimal number whose ones bits correspond to bits in the type-code argument. The wild-mask indicates which bits in the type-code argument should be ignored when making a comparison. (A mask for a DSAP/SSAP pair should always be 0x0101 because these two bits are used for purposes other than identifying the SAP code.) address 48-bit Token Ring address written in dotted triplet form. This field is used for filtering by vendor code. mask 48-bit Token Ring address written in dotted triplet form. The ones bits in mask are the bits to be ignored in address. This field is used for filtering by vendor code.
For source address filtering, the mask always should have the high-order bit set. This is because the IEEE 802 standard uses this bit to indicate whether a RIF is present, not as part of the source address.
To create a bridge group that runs the automatic spanning-tree function, use the bridge protocol ibm global configuration command. Use the no form of this command to cancel the previous assignment.
bridge bridge-group protocol ibm
Syntax Description
bridge-group Number in the range 1 to 9 that you choose to refer to a particular set of bridged interfaces.
To clear the entries of all dynamically learned NetBIOS names, use the clear netbios-cache privileged EXEC command. This command will not remove statically defined name cache entries.
clear netbios-cacheSyntax Description
This command has no arguments or keywords.
To clear the entire RIF cache, use the clear rif-cache privileged EXEC command.
clear rif-cacheSyntax Description
This command has no arguments or keywords.
To clear the source-bridge statistical counters, use the clear source-bridge privileged EXEC command.
clear source-bridgeSyntax Description
This command has no arguments or keywords.
To reinitialize the Silicon Switch Processor (SSP) on the Cisco 7000 series routers with RSP7000, use the clear sse privileged EXEC command.
clear sseSyntax Description
This command has no arguments or keywords.
To choose the Organizational Unique Identifier (OUI) code to be used in the encapsulation of Ethernet Type II frames across Token Ring backbone networks, use the ethernet-transit-oui interface configuration command. Various versions of this OUI code are used by Ethernet/Token Ring translational bridges. Use the no form of this command to return the default OUI code.
ethernet-transit-oui [90-compatible | standard | cisco]
Syntax Description
90-compatible (Optional) Default OUI form. standard (Optional) Standard OUI form. cisco (Optional) Cisco's OUI form.
To specify the threshold reporting link number, use the lnm alternate interface configuration command. In order for a LAN Reporting Manager (LRM) to change parameters, it must be attached to the reporting link with the lowest reporting link number, and that reporting link number must be lower than this threshold reporting link number. Use the no form of this command to restore the default of 0.
lnm alternate number
Syntax Description
number Threshold reporting link number. It must be in the range 0 to 3.
To monitor the current logical configuration of a Token Ring, use the lnm crs interface configuration command. Use the no form of this command to disable this function.
lnm crsSyntax Description
This command has no arguments or keywords.
To disable LNM functionality, use the lnm disabled global configuration command. Use the no form of this command to restore LNM functionality.
lnm disabledSyntax Description
This command has no arguments or keywords.
To enable the LNM RPS express buffer function, use the lnm express-buffer interface configuration command. Use the no form of this command to disable the function.
lnm express-bufferSyntax Description
This command has no arguments or keywords.
To set the threshold at which the Cisco IOS software sends a message informing all attached LNMs that it is dropping frames, use the lnm loss-threshold interface configuration command. Use the no form of this command to return to the default value.
lnm loss-threshold number
Syntax Description
number Single number expressing the percentage loss rate in hundredths of a percent. The valid range is 0 to 9999.
Syntax Description
number Number of the reporting link to which to apply the password. This value should be in the range 0 to 3. string Password you enter at the keyboard.
To disable pathtrace reporting to LNM stations, use the lnm pathtrace-disabled global configuration command. Use the no form of this command to restore pathtrace reporting functionality.
lnm pathtrace-disabled [all | origin]
Syntax Description
all (Optional) Disable pathtrace reporting to the LNM and originating stations. origin (Optional) Disable pathtrace reporting to originating stations only.
To monitor errors reported by any station on the ring, use the lnm rem interface configuration command. Use the no form of this command to disable this function.
lnm remSyntax Description
This command has no arguments or keywords.
To ensure that all stations on a ring are using a consistent set of reporting parameters, use the lnm rps interface configuration command. Use the no form of this command to disable this function.
lnm rpsSyntax Description
This command has no arguments or keywords.
To prevent any LNM stations from modifying parameters in the Cisco IOS software, use the lnm snmp-only global configuration command. Use the no form of this command to allow modifications.
lnm snmp-onlySyntax Description
This command has no arguments or keywords.
To set the time interval in which the Cisco IOS software will accumulate error messages before sending them, use the lnm softerr interface configuration command. Use the no form of this command to return to the default value.
lnm softerr milliseconds
Syntax Description
milliseconds Time interval in tens of milliseconds between error messages. The valid range is 0 to 65535.
To set the MAC layer address of the Cisco Token Ring, use the mac-address interface configuration command.
mac-address ieee-address
Syntax Description
ieee-address 48-bit IEEE MAC address written as a dotted triplet of four-digit hexadecimal numbers.
To enable collection and use of RIF information, use the multiring interface configuration command. Use the no form of this command to disable the use of RIF information for the protocol specified.
multiring {protocol-keyword [all-routes | spanning] | all | other}
Syntax Description
protocol-keyword Specifies a protocol. all-routes (Optional) Uses all-routes explorers. spanning (Optional) Uses spanning-tree explorers. all Enables the multiring for all frames. other Enables the multiring for any routed frame not included in the previous list of supported protocols.
To define the offset and hexadecimal patterns with which to match byte offsets in NetBIOS packets, use the netbios access-list bytes global configuration command. Use the no form of this command to remove an entire list or the entry specified with the pattern argument.
netbios access-list bytes name {permit | deny} offset pattern
Syntax Description
name Name of the access list being defined. permit Permits the condition. deny Denies the condition. offset Decimal number indicating the number of bytes into the packet where the byte comparison should begin. An offset of zero points to the very beginning of the NetBIOS header. Therefore, the NetBIOS delimiter string (0xFFEF), for example, begins at offset 2. pattern Hexadecimal string of digits representing a byte pattern.
To assign the name of the access list to a station or set of stations on the network, use the netbios access-list host global configuration command. The NetBIOS station access list contains the station name to match, along with a permit or deny condition. Use the no form of this command to remove either an entire list or just a single entry from a list, depending upon the argument given for pattern.
netbios access-list host name {permit | deny} pattern
Syntax Description
name Name of the access list being defined. permit Permits the condition. deny Denies the condition. pattern A set of characters. The characters can be the name of the station, or a combination of characters and pattern-matching symbols that establish a pattern for a set of NetBIOS station names. This combination can be especially useful when stations have names with the same characters, such as a prefix.
To enable NetBIOS name caching, use the netbios enable-name-cache interface configuration command. Use the no form of this command to disable the name-cache behavior.
netbios enable-name-cacheSyntax Description
This command has no arguments or keywords.
To define a byte access list filter on incoming messages, use the netbios input-access-filter bytes interface configuration command. The actual access filter byte offsets and patterns used are defined in one or more netbios-access-list bytes commands. Use the no form of this command with the appropriate name to remove the entire access list.
netbios input-access-filter bytes name
Syntax Description
name Name of a NetBIOS access filter previously defined with one or more of the netbios access-list bytes global configuration commands.
To define a station access list filter on incoming messages, use the netbios input-access-filter host interface configuration command. The access lists of station names are defined in netbios access-list host commands. Use the no form of this command with the appropriate argument to remove the entire access list.
netbios input-access-filter host name
Syntax Description
name Name of a NetBIOS access filter previously defined with one or more of the netbios access-list host global configuration commands.
To define a static NetBIOS name cache entry, tying the server with the name netbios-name to the mac-address, and specifying that the server is accessible either locally via the interface-name specified, or remotely, via the ring-group group-number specified, use the netbios name-cache global configuration command. Use the no form of this command to remove the entry.
netbios name-cache mac-address netbios-name {interface-name | ring-group group-number}
Syntax Description
mac-address The MAC address. netbios-name Server name linked to the MAC address. interface-name Name of the interface by which the server is accessible locally. ring-group Specifies that the link is accessible remotely. group-number Number of the ring group by which the server is accessible remotely. This ring group number must match the number you have specified with the source-bridge ring-group command. The valid range is 1 to 4095.
To specify how many characters of the NetBIOS type name the name cache will validate, use the netbios name-cache name-len global configuration command.
netbios name-cache name-len length
Syntax Description
length Length of the NetBIOS type name. The range is 8 to 16 characters.
To enable the Cisco IOS software to act as a proxy and send NetBIOS datagram type frames, use the netbios name-cache proxy-datagram global configuration command.
netbios name-cache proxy-datagram seconds
Syntax Description
seconds Time interval, in seconds, that the software forwards a route broadcast datagram type packet. The valid range is any number greater than 0.
To specify the "dead" time, in seconds, that starts when a host sends any ADD_NAME_QUERY, ADD_GROUP_NAME, or STATUS_QUERY frame, use the netbios name-cache query-timeout global configuration command. During this dead time, the Cisco IOS software drops any repeat, duplicate ADD_NAME_QUERY, ADD_GROUP_NAME, or STATUS_QUERY frame sent by the same host. This timeout is only effective at the time of the login negotiation process. Use the no form of this command to bring the time back to the default of 6 seconds.
netbios name-cache query-timeout seconds
Syntax Description
seconds Dead time period in seconds. Default is 6 seconds.
To specify the "dead" time, in seconds, that starts when a host sends any FIND_NAME or NAME_RECOGNIZED frame, use the netbios name-cache recognized-timeout global configuration command. During this dead time, the Cisco IOS software drops any repeat, duplicate FIND_NAME or NAME_RECOGNIZED frame sent by the same host. This timeout is only effective at the time of the login negotiation process. Use the no form of this command to bring the time back to the default of 6 seconds.
netbios name-cache recognized-timeout seconds
Syntax Description
seconds Dead time period in seconds. Default is 6 seconds.
Syntax Description
minutes Time, in minutes, that entries can remain in the NetBIOS name cache. Once the time expires, the entry will be deleted from the cache. Default is 15 minutes.
Syntax Description
name Name of a NetBIOS access filter previously defined with one or more of the netbios access-list bytes global configuration commands.
Syntax Description
name Name of a NetBIOS access filter previously defined with one or more of the netbios access-list host global configuration commands.
To enter static source-route information into the Routing Information Field (RIF) cache, use the rif global configuration command. If a Token Ring host does not support the use of IEEE 802.2 TEST or XID datagrams as explorer packets, you may need to add static information to the RIF cache of the router. Use the no form of this command to remove an entry from the cache.
rif mac-address rif-string {interface-name | ring-group ring}
Syntax Description
mac-address 12-digit hexadecimal string written as a dotted triplet; for example, 0010.0a00.20a6. rif-string Series of 4-digit hexadecimal numbers separated by a period (.). This RIF string is inserted into the packets sent to the specified MAC address. interface-name Interface name (for example, tokenring 0) that indicates the origin of the RIF. ring-group Specifies the origin of the RIF is a ring group. ring Ring group number that indicates the origin of the RIF. This ring group number must match the number you have specified with the source-bridge ring-group command. The valid range is 1 to 4095.
To determine the number of minutes an inactive RIF entry is kept, use the rif timeout global configuration command. RIF information is maintained in a cache whose entries are aged. Use the no form of this command to restore the default.
rif timeout minutes
Syntax Description
minutes Number of minutes an inactive RIF entry is kept. The value must be greater than 0. Default is 15 minutes.
To define the validation time when the Cisco IOS software is acting as a proxy for NetBIOS NAME_QUERY packet or for explorer frames, use the rif validate-age global configuration command.
rif validate-age seconds
Syntax Description
seconds Interval, in seconds, at which a proxy is sent. The valid range is any number greater than 0. Default is 2 seconds.
To enable RIF validation for entries learned on an interface (Token Ring or FDDI), use the rif validate-enable global configuration command. Use the no form of this command to disable the specification.
rif validate-enableSyntax Description
This command has no arguments or keywords.
To enable RIF validation for stations on a source-route bridge network that do not respond to an IEEE TEST command, use the rif validate-enable-age global configuration command. Use the no form of this command to disable the specification.
rif validate-enable-ageSyntax Description
This command has no arguments or keywords.
To enable synchronization of the RIF cache with the protocol route cache, use the rif validate-enable-route-cache global configuration command. Use the no form of this command to disable the specification.
rif validate-enable-route-cacheSyntax Description
This command has no arguments or keywords.
Syntax Description
This command has no arguments or keywords.
To display information about the Token Ring interface and the state of source-route bridging, use the show interfaces tokenring privileged EXEC command.
show interfaces tokenring [number]
Syntax Description
number (Optional) Interface number. If you do not provide a value, the command will display statistics for all Token Ring interfaces.
To display all currently configured bridges and all parameters that are related to the bridge as a whole, not to one of its interfaces, use the show lnm bridge privileged EXEC command.
show lnm bridgeSyntax Description
This command has no arguments or keywords.
To display the logical configuration of all bridges configured in a router, use the show lnm config privileged EXEC command. This information is needed to configure an LNM Management Station to communicate with a router. This is especially important when the router is configured as a multiport bridge, thus employing the concept of a virtual ring.
show lnm configSyntax Description
This command has no arguments or keywords.
To display all LNM-related information about a specific interface or all interfaces, use the show lnm interface privileged EXEC command.
show lnm interface [type number]
Syntax Description
type (Optional) Interface type. number (Optional) Interface number.
To display all LNM information about a specific Token Ring or all Token Rings, use the show lnm ring privileged EXEC command. If a specific interface is requested, it also displays a list of all currently active stations on that interface.
show lnm ring [ring-number]
Syntax Description
ring-number (Optional) Number of a specific Token Ring. It can be a value in the range 1 to 4095.
To display LNM-related information about a specific station or all known stations on all rings, use the show lnm station privileged EXEC command. If a specific station is requested, it also displays a detailed list of that station's current MAC-level parameters.
show lnm station [address]
Syntax Description
address (Optional) Address of a specific LNM station.
To display a list of NetBIOS cache entries, use the show netbios-cache privileged EXEC command.
show netbios cacheSyntax Description
This command has no arguments or keywords.
To display the current contents of the RIF cache, use the show rif privileged EXEC command.
show rifSyntax Description
This command has no arguments or keywords.
To display the current source bridge configuration and miscellaneous statistics, use the show source-bridge privileged EXEC command.
show source-bridgeSyntax Description
This command has no arguments or keywords.
To display the spanning-tree topology known to the router, use the show span EXEC command.
show spanSyntax Description
This command has no arguments or keywords.
To configure an interface for source-route bridging, use the source-bridge interface configuration command. Use the no form of this command to disable source-route bridging on an interface.
source-bridge source-ring-number bridge-number target-ring-number [conserve-ring]
Syntax Description
source-ring-number Ring number for the interface's Token Ring or FDDI ring. It must be a decimal number in the range 1 to 4095 that uniquely identifies a network segment or ring within the bridged Token Ring or FDDI network bridge-number Number that uniquely identifies the bridge connecting the source and target rings. It must be a decimal number in the range 1 to 15. target-ring-number Ring number of the destination ring on this router. It must be unique within the bridged Token Ring or FDDI network. The target ring can also be a ring group. Must be a decimal number. conserve-ring (Optional) Keyword to enable SRB over Frame Relay. When this option is configured, the SRB software does not add the ring number associated with the Frame Relay PVC (the partner's virtual ring) to outbound explorer frames. This option is permitted for Frame Relay subinterfaces only.
To establish the interval of time between first attempt to open a connection until a timeout is declared, use the source-bridge connection-timeout global configuration command. Use the no form of this command to disable this feature.
source-bridge connection-timeout seconds
Syntax Description
seconds Interval of time, in seconds, before a connection attempt to a remote peer is aborted.
To change the router's Token Ring to Ethernet translation behavior, use the source-bridge enable-80d5 global configuration command. Use the no form of this command to disable this function.
source-bridge enable-80d5Syntax Description
This command has no arguments or keywords.
To prevent excessive forwarding of explorers in networks with redundant topologies, use the source-bridge explorer-dup-ARE-filter global configuration command. Use the no form of this command to disable this feature.
source-bridge explorer-dup-ARE-filterSyntax Description
This command has no arguments or keywords.
To enable explorer fast switching, use the source-bridge explorer-fastswitch global configuration command. To disable explorer fast switching, use the no form of this command.
source-bridge explorer-fastswitchSyntax Description
This command has no arguments or keywords.
To set the maximum byte rate of explorers per ring, use the source-bridge explorer-maxrate global configuration command. To reset the default rate, use the no form of this command.
source-bridge explorer-maxrate maxrate
Syntax Description
maxrate Number in the range 100 to 1000000000 (in bytes per second). The default maximum byte rate is 38400 bytes per second.
To set the maximum explorer queue depth, use the source-bridge explorerq-depth global configuration command. To reset the default value, use the no form of this command.
source-bridge explorerq-depth depth
Syntax Description
depth The maximum number of incoming packets. The valid range is 1 to 500.
To apply an access list to an interface configured for source-route bridging, use the source-bridge input-address-list interface configuration command. This command filters source-routed packets received from the router interface based upon the source mac address. Use the no form of this command to remove the application of the access list.
source-bridge input-address-list access-list-number
Syntax Description
access-list-number Number of the access list. The value must be in the range 700 to 799.
Syntax Description
access-list-number Number of the access list. This access list is applied to all IEEE 802 or FDDI frames received on that interface prior to the source-routing process. Specify zero (0) to disable the filter. The value must be in the range 200 to 299.
Syntax Description
access-list-number Number of the access list. This access list is applied to all SNAP frames received on that interface prior to the source-routing process. Specify zero (0) to disable the application of the access list on the bridge group. The value must be in the range 200 to 299.
To control the forwarding or blocking of all-routes explorer frames received on an interface, use the source-bridge max-hops interface configuration command. Use the no form of this command to reset the count to the maximum value.
source-bridge max-hops count
Syntax Description
count Determines the number of bridges an explorer packet can traverse. Typically, the maximum number of bridges for interoperability with IBM equipment is seven.
To control the forwarding or blocking of spanning-tree explorer frames received on an interface, use the source-bridge max-in-hops interface configuration command. Use the no form of this command to reset the count to the maximum value.
source-bridge max-in-hops count
Syntax Description
count Determines the number of bridges an explorer packet can traverse. Typically, the maximum number of bridges for interoperability with IBM equipment is seven.
To control the forwarding or blocking of spanning-tree explorer frames sent from this interface, use the source-bridge max-out-hops interface configuration command. Use the no form of this command to reset the count to the maximum value.
source-bridge max-out-hops count
Syntax Description
count Determines the number of bridges an explorer packet can traverse. Typically, the maximum number of bridges for interoperability with IBM equipment is seven.
To apply an access list to an interface configured for source-route bridging, use the source-bridge output-address-list interface configuration command . This command filters source-routed packets sent to the router interface based upon the destination mac address. Use the no form of this command to remove the application of the access list.
source-bridge output-address-list access-list-number
Syntax Description
access-list-number Number of the access list. The value must be in the range 700 to 799.
To filter, on output, FDDI and IEEE 802-encapsulated packets that have destination service access point (DSAP) and source service access point (SSAP) fields in their frame formats, use the source-bridge output-lsap-list interface configuration command.
source-bridge output-lsap-list access-list-number
Syntax Description
access-list-number Number of the access list. This access list is applied just before sending out a frame to an interface. Specify zero (0) to disable the filter. The value must be in the range 200 to 299.
Syntax Description
access-list-number Number of the access list. This access list is applied just before sending out a frame to an interface. Specify zero (0) to disable the application of the access list on the bridge group. The value must be in the range 200 to 299.
To configure the interface to respond to any explorer packets from a source node that meet the conditions described below, use the source-bridge proxy-explorer interface configuration command. Use the no form of this command to cancel responding to explorer packets with proxy explorers.
source-bridge proxy-explorerSyntax Description
This command has no arguments or keywords.
To enable proxy explorers for the NetBIOS name-caching function, use the source-bridge proxy-netbios-only global configuration command. Use the no form of this command to disable the NetBIOS name-caching function.
source-bridge proxy-netbios-onlySyntax Description
This command has no arguments or keywords.
To define or remove a ring group from the configuration, use the source-bridge ring-group global configuration command. Use the no form of this command to cancel previous assignments.
source-bridge ring-group ring-group [virtual-mac-address]
Syntax Description
ring-group Ring group number. The valid range is 1 to 4095. virtual-mac-address (Optional) 12-digit hexadecimal string written as a dotted triplet (for example, 0010.0a00.20a6).
Syntax Description
This command has no arguments or keywords.
Syntax Description
This command has no arguments or keywords.
To enable Cisco's silicon switching engine (SSE) switching function, use the source-bridge route-cache sse interface configuration command. Use the no form of this command to disable SSE switching.
source-bridge route-cache sseSyntax Description
This command has no arguments or keywords.
To allow non-IBM hosts (attached to a router with 80d5 processing enabled) to use the standard Token Ring to Ethernet LLC2 translation instead of the nonstandard Token Ring to Ethernet 80d5 translation, use the source-bridge sap-80d5 global configuration command. This command allows you to set the translation on a per-DSAP basis. Use the no form of this command to disable this feature.
source-bridge sap-80d5 dsap
Syntax Description
dsap Destination service access point (DSAP).
To enable the automatic spanning-tree function for a specified group of bridged interfaces, use the automatic version of the source-bridge spanning interface configuration command. Use the no form of the command to return to the default disabled state. Use the no source-bridge spanning path-cost command to return an assigned path cost to the default path cost of 16.
source-bridge spanning bridge-group [path-cost path-cost]
Syntax Description
bridge-group Number in the range 1 to 9 that you choose to refer to a particular group of bridged interfaces. This must be the same number as assigned in the (Optional) Assign a path cost for a specified interface. path-cost (Optional) Path cost for the interface. The valid range is 0 to 65535.
bridge protocol ibm command.
To enable use of spanning explorers, use the source-bridge spanning interface configuration command. The no form of this command disables their use. Only spanning explorers will be blocked; everything else will be forwarded.
source-bridge spanningSyntax Description
This command has no arguments or keywords.
To establish bridging between transparent bridging and source-route bridging, use the source-bridge transparent global configuration command. Use the no form of this command to disable a previously established link between a source-bridge ring group and a transparent bridge group.
source-bridge transparent ring-group pseudo-ring bridge-number tb-group [oui]
Syntax Description
ring-group Virtual ring group created by the source-bridge ring-group command. This is the source-bridge virtual ring to associate with the transparent bridge group. This ring group number must match the number you have specified with the source-bridge ring-group command. The valid range is 1 to 4095. pseudo-ring Ring number used to represent the transparent bridging domain to the source-route bridged domain. This number must be a unique number, not used by any other ring in your source-route bridged network. bridge-number Bridge number of the bridge that leads to the transparent bridging domain. tb-group Number of the transparent bridge group that you want to tie into your source-route bridged domain. The no form of this command disables this feature. oui (Optional) Organizational unique identifier. Possible values include the following:
To enable fast switching of packets between the SRB and transparent domains, use the source-bridge transparent fastswitch global configuration command. Use the no form of this command to disable fast switching of packets.
source-bridge transparent ring-group fastswitch
Syntax Description
Posted: Wed Jul 26 11:21:39 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.