Banyan VINES Commands

This chapter describes the function and displays the syntax for Banyan Virtual Network System (VINES) commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Network Protocols Command Reference, Part 3.

clear vines cache

To delete entries from the VINES fast-switching cache, use the clear vines cache EXEC command.

clear vines cache [interface interface | neighbor address | server network]

interface interface	(Optional) Deletes from the fast-switching cache table any entry that has one or more paths that go through the specified interface.
neighbor address	(Optional) Deletes from the fast-switching cache table any entry that has one or more paths via the specified neighbor router.
server network	(Optional) Deletes from the fast-switching cache table any entry whose network number part of the destination address matches the specified network address. The argument network can be either a 4-byte hexadecimal number or a 4-byte decimal number (if you have issued a vines decimal command).

clear vines ipc

To delete VINES Interprocess Communications Protocol (IPC) connection blocks, use the clear vines ipc EXEC command.

clear vines ipc number

number

Hexadecimal number of the IPC connection to delete.

clear vines neighbor

To delete entries from the neighbor table, use the clear vines neighbor EXEC command.

clear vines neighbor {network | *}

network	Network number of the neighbor whose entry should be deleted from the neighbor table. The argument network can be either a 4-byte hexadecimal number or a 4-byte decimal number (if you have issued a vines decimal command).
*	Deletes all entries from the neighbor path table except the entry for the local router.

clear vines route

To delete network addresses from the routing table, use the clear vines route EXEC command.

clear vines route {network | *}

network	Network number of the entry to delete from the routing table. The argument network can be either a 4-byte hexadecimal number, a 4-byte decimal number (if you have issued a vines decimal command), or a host name (if you have issued a vines host command).
*	Deletes all entries from the routing table.

clear vines traffic

To clear all VINES-related statistics that are displayed by the show vines traffic command, use the clear vines traffic EXEC command.

clear vines traffic

ping

To determine basic network connectivity, use the ping EXEC command.

ping [vines] [address]

vines	(Optional) Specifies the VINES protocol. If you omit this keyword, the Cisco IOS software prompts for it.
address	(Optional) Address of system to ping. If you omit the address, the software prompts for it.

show vines access

To display the VINES access lists currently defined, use the show vines access EXEC command.

show vines access [access-list-number]

access-list-number

(Optional) Number of the access list to display.

show vines cache

To display the contents of the VINES fast-switching cache, use the show vines cache EXEC command.

show vines cache [address | interface type number | neighbor address | server network]

address	(Optional) Displays the entry in the fast-switching cache for the specified station.
interface type number	(Optional) Displays all neighbors in the fast-switching cache that are accessible via the specified interface type and number.
neighbor address	(Optional) Displays all routes in the VINES fast-switching cache that have the specified neighbor as their first hop. The argument address is a 6-byte hexadecimal number in the format network:host, where network is 4 bytes and host is 2 bytes, a 4-byte decimal number in the same format (if you have issued a vines decimal command), or a host name (if you have issued a vines host command).
server network	(Optional) Displays all entries in the VINES fast-switching cache that are in the specified logical network. The argument network can be either a 4-byte hexadecimal number or a 4-byte decimal number (if you have issued a vines decimal command).

show vines host

To display the entries in the VINES host name table, use the show vines host EXEC command.

show vines host [name]

name

(Optional) Displays the entry in the VINES name table that has the specified name.

show vines interface

To display status of the VINES interfaces configured in the Cisco IOS software and the parameters configured on each interface, use the show vines interface EXEC command.

show vines interface [type number]

type	(Optional) Interface type.
number	(Optional) Interface number.

show vines ipc

To display information about any currently active IPC connections, use the show vines ipc EXEC command.

show vines ipc

show vines neighbor

To display the entries in the VINES neighbor table, use the show vines neighbor EXEC command.

show vines neighbor [address | interface type number | server number]

address	(Optional) Displays the entry for the specified neighbor.
interface type number	(Optional) Displays all neighbor paths in the neighbor table that use the specified interface.
server number	(Optional) Displays all entries in the neighbor table that have the specified network number.

show vines route

To display the contents of the VINES routing table, use the show vines route EXEC command.

show vines route [number | neighbor address]

number	(Optional) Displays the routing table entry for the specified network.
neighbor address	(Optional) Displays all routes in the VINES routing table that have the specified neighbor as their first hop.

show vines service

To display information about the application layer support, use the show vines service EXEC command.

show vines service [fs | nsm | ss | vs]

fs	(Optional) Displays file service information.
nsm	(Optional) Displays network and system management service information.
ss	(Optional) Displays server service information.
vs	(Optional) Displays security service information.

show vines traffic

To display the statistics maintained about VINES protocol traffic, use the show vines traffic EXEC command.

show vines traffic [type number]

type	(Optional) Interface type.
number	(Optional) Interface number.

trace

To determine the path that a packet takes when traversing a VINES network, use the trace EXEC command.

trace [vines | oldvines] [address]

vines	(Optional) Specifies the VINES protocol. This trace is compatible with the Banyan VINES traceroute function.
oldvines	(Optional) Specifies the VINES protocol. This trace is compatible with our trace function prior to Cisco IOS Release 10.2.
address	(Optional) Address of a node. This is a 6-byte hexadecimal number in the format network:host, where network is 4 bytes and host is 2 bytes.

vines access-group

To apply an access list to an interface, use the vines access-group interface configuration command. To remove the access list, use the no form of this command.

vines access-group access-list-number
no vines access-group access-list-number

access-list-number

Number of the access list. All outgoing packets defined with either standard or extended access lists and forwarded through the interface are filtered by the entries in this access list. For standard access lists, access-list-number is a decimal number from 1 to 100. For extended access lists, access-list-number is a decimal number from 101 to 200.

vines access-list (extended)

To create an extended VINES access list, use this version of the vines access-list global configuration command. To remove an extended access list, use the no form of this command.

vines access-list access-list-number {deny | permit} protocol source-address
source-mask [source-port source-port-mask] destination-address
destination-mask [destination-port destination-port-mask]
no vines access-list access-list-number

access-list-number	Number of the access list. This is a decimal number from 101 to 200.
deny	Denies access if the conditions are matched.
permit	Allows access if the conditions are matched.
protocol	VINES protocol ID number or name. The number can be a value from 1 to 255, or one of the following protocol keywords: · arp--Address Resolution Protocol (ARP) · icp--Internet Control Protocol (ICP) · ip--VINES Internet Protocol · ipc--Interprocess Communications (IPC) · rtp--Routing Table Protocol (RTP) · spp--Sequence Packet Protocol (SPP)
source-address	Address of the network from which the packet is being sent. This is a 6-byte hexadecimal number in the format network:host, where network is 4 bytes and host is 2 bytes.
source-mask	Mask to be applied to source-address. This is a 6-byte hexadecimal value. Place ones in the bit positions you want to mask. These bits correspond to the bits in the address that should be ignored.
source-port	(Optional) Number of the local port from which the packet is being sent. This argument is required when the protocol specified is IPC or SPP, and is not accepted when any other protocol is specified. It can be a number from 0x0000 to 0xFFFF. Well-known local port numbers have values from 0x0001 to 0x01FF. Transient local port numbers have values from 0x0200 to 0xFFFE.
source-port-mask	(Optional) Mask to be applied to source-port. This argument is required when the protocol specified is IPC or SPP, and is not accepted when any other protocol is specified. It can be a number from 0x0000 to 0xFFFF. These bits correspond to the bits in the port that should be ignored.
destination-address	VINES address of the network to which the packet is being sent. This is a 6-byte hexadecimal number in the format network:host, where network is 4 bytes and host is 2 bytes.
destination-mask	Mask to be applied to destination-address. This is a 6-byte hexadecimal value. Place ones in the bit positions you want to mask. These bits correspond to the bits in the address that should be ignored.
destination-port	(Optional) Number of the local port to which the packet is being sent. This argument is required when the protocol specified is IPC or SPP, and is not accepted when any other protocol is specified. It can be a number from 0x0000 to 0xFFFF. Well-known local port numbers have values from 0x0001 to 0x01FF. Transient local port numbers have values from 0x0200 to 0xFFFE.
destination-port-mask	(Optional) Mask to be applied to destination-port. This argument is required when the protocol specified is IPC or SPP, and is not accepted when any other protocol is specified. It can be a number from 0x0000 to 0xFFFF. These bits correspond to the bits in the port that should be ignored.

vines access-list (simple)

To create a simple VINES access list, use this version of the vines access-list global configuration command. To remove a simple access list, use the no form of this command.

vines access-list access-list-number {deny | permit} source-address source-mask
no vines access-list access-list-number

access-list-number	Access list number. It is a number from 201 to 300.
deny	Denies access if the conditions are matched.
permit	Allows access if the conditions are matched.
source-address	Address of the network from which the packet is being sent. This is a 6-byte hexadecimal number in the format network:host, where network is 4 bytes and host is 2 bytes.
source-mask	Mask to be applied to source-address. This is a 6-byte hexadecimal value. Place ones in the bit positions you want to mask. These bits correspond to the bits in the address that should be ignored.

vines access-list (standard)

To specify a standard VINES access list, use this version of the vines access-list global configuration command. To remove the access list, use the no form of this command.

vines access-list access-list-number {deny | permit} protocol source-address
source-mask [source-port] destination-address destination-mask
[destination-port]
no vines access-list access-list-number

access-list-number	Number of the access list. This is a decimal number from 1 to 100.
deny	Denies access if the conditions are matched.
permit	Allows access if the conditions are matched.
protocol	VINES protocol ID number or name. It can be a value from 1 to 255 or one of the following protocol keywords: · arp--Address Resolution Protocol (ARP) · icp--Internet Control Protocol (ICP) · ip--VINES Internet Protocol · ipc--Interprocess Communications (IPC) · rtp--Routing Table Protocol (RTP) · spp--Sequence Packet Protocol (SPP)
source-address	Address of the network from which the packet is being sent. This is a 6-byte hexadecimal number in the format network:host, where network is 4 bytes and host is 2 bytes.
source-mask	Mask to be applied to source-address. This is a 6-byte hexadecimal value. Place ones in the bit positions you want to mask. These bits correspond to the bit in the address that should be ignored.
source-port	(Optional) Number of the local port from which the packet is being sent. This argument is required when the protocol specified is IPC or SPP, and is not accepted when any other protocol is specified. It can be a number from 0x0000 to 0xFFFF. Well-known local port numbers have values from 0x0001 to 0x01FF. Transient local port numbers have values from 0x0200 to 0xFFFE.
destination-address	Address of the network to which the packet is being sent. This is a 6-byte hexadecimal number in the format network:host, where network is 4 bytes and host is 2 bytes.
destination-mask	Mask to be applied to destination-address. This is a 6-byte hexadecimal value. Place ones in the bit positions you want to mask. These bits correspond to the bits in the address that should be ignored.
destination-port	(Optional) Number of the local port to which the packet is being sent. This argument is required when the protocol specified is IPC or SPP, and is not accepted when any other protocol is specified. It can be a number from 0x0000 to 0xFFFF. Well-known local port numbers have values from 0x0001 to 0x01FF. Transient local port numbers have values from 0x0200 to 0xFFFE.

vines arp-enable

To enable the processing of ARP packets, use the vines arp-enable interface configuration command. To disable the processing of ARP packets, use the no form of this command.

vines arp-enable [dynamic]
no vines arp-enable [dynamic]

dynamic

(Optional) Responds to ARP and SARP requests on this interface only if there are no other VINES servers present.

vines decimal

To display VINES addresses in decimal notation, use the vines decimal global configuration command. To return to displaying the addresses in hexadecimal, use the no form of this command.

vines decimal
no vines decimal

vines encapsulation

To set the MAC-level encapsulation used for VINES broadcast packets, use the vines encapsulation interface configuration command. To disable encapsulation, use the no form of this command.

vines encapsulation [arpa | snap | vines-tr]
no vines encapsulation

arpa	(Optional) Advanced Research Projects Agency (ARPA) encapsulation. This is the default encapsulation for Ethernet interfaces.
snap	(Optional) Subnetwork Access Protocol (SNAP) encapsulation. This encapsulation uses an IEEE 802.2 SNAP header. It is the default encapsulation for all media except Ethernet and Token Ring.
vines-tr	(Optional) Our VINES Token Ring encapsulation. This is the default encapsulation for Token Ring interfaces.

vines host

To associate a host name with a VINES address, use the vines host global configuration command. To delete the association, use the no form of this command.

vines host name address
no vines host name

name	VINES host name. It can be any length and sequence of characters separated by white space.
address	Number of a VINES network. You enter it in the current VINES radix, in the format network:host, where network is 4 bytes and host is 2 bytes.

vines input-network-filter

To filter the information contained in routing messages received from other stations, use the vines input-network-filter interface configuration command. To disable this filtering, use the no form of this command.

vines input-network-filter access-list-number
no vines input-network-filter

access-list-number

Number of the access list. It is a decimal number from 201 to 300.

vines input-router-filter

To filter received routing messages based upon the address of the sending station, use the vines input-router-filter interface configuration command. To disable this filtering, use the no form of this command.

vines input-router-filter access-list-number
no vines input-router-filter

access-list-number

Number of the access list. It is a decimal number from 201 to 300.

vines metric

To enable VINES routing on an interface, use the vines metric interface configuration command. To disable VINES routing, use the no form of this command.

vines metric [whole [fractional]]
no vines metric

whole	(Optional) Integer cost value associated with the interface. It is optional for all interface types. If you omit whole, the Cisco IOS software automatically chooses a reasonable value. If whole is zero, then a fractional portion must be supplied.
fractional	(Optional) Fractional cost value associated with the interface expressed in 10,000ths. It is optional for all interface types, but may only be present if a whole number portion is specified. This number is rounded to the nearest 1/16. If you omit both whole and fractional numbers, the software automatically chooses a reasonable value.

vines neighbor

To specify a static path to a neighbor station, use the vines neighbor interface configuration command. To remove a static path from the neighbor table, use the no form of this command.

vines neighbor address mac-address encapsulation [whole [fractional]]
no vines neighbor address mac-address

address	VINES IP address of the station to which to add or remove a static path.
mac-address	MAC-level address used to reach the neighbor station.
encapsulation	Encapsulation type to use on the media. It can be one of the following values: · arpa--Use ARPA encapsulation. This is recommended for Ethernet interfaces. · snap--Use an IEEE 802.2 SNAP header. This is recommended for FDDI interfaces. · vines-tr--Use our VINES Token Ring encapsulation. This is recommended for Token Ring interfaces.
whole	(Optional) Delay metric to use on the neighbor. If you omit this argument, the metric used is that specified with the vines metric command for the selected interface.
fractional	(Optional) Fractional metric value associated with this neighbor. This number is rounded to the nearest 1/16. If you omit both whole and fractional numbers, the interface metric is used.

vines output-network-filter

To filter the information contained in routing updates transmitted to other stations, use the vines output-network-filter interface configuration command. To disable this filtering, use the no form of this command.

vines output-network-filter access-list-number
no vines output-network-filter

access-list-number

Number of the access list. It is a decimal number from 201 to 300.

vines propagate

To modify how the Cisco IOS software forwards a broadcast packet, use the vines propagate interface configuration command. To return to the default forwarding scheme, use the dynamic form of this command.

vines propagate [dynamic]
no vines propagate [dynamic]

dynamic

(Optional) Propagate broadcasts on this interface only if there are no servers on any local network.

vines redirect

To determine how frequently the Cisco IOS software sends an RTP redirect message on an interface, use the vines redirect interface configuration command. To restore the default, use the no form of this command.

vines redirect [seconds]
no vines redirect

seconds

(Optional) Interval, in seconds, that the software waits after sending a redirect message on an interface before it sends another redirect message on that same interface. If you specify a value of 0, the software never sends redirect messages on that interface.

vines route

To specify a static route to a server, use the vines route global configuration command. To remove a static route from the routing table, use the no form of this command.

vines route number address [whole [fractional]]
no vines route number address [whole [fractional]]

number	Number of the server to which to add or remove the static route.
address	VINES IP address of the neighbor station to use to reach the server.
whole	(Optional) Metric value assigned to this route.
fractional	(Optional) Fractional cost value associated with this route.

vines route-cache

To enable fast switching, use the vines route-cache interface configuration command. To disable fast switching, use the no form of this command.

vines route-cache
no vines route-cache

vines routing

To enable VINES routing, use the vines routing global configuration command. To disable VINES routing, use the no form of this command.

vines routing [address | recompute]
no vines routing

address	(Optional) Network address of the router. You should specify an address on a router that does not have any Ethernet or FDDI interfaces. You also can specify an address in the unlikely event that two routers map themselves to the same address.
recompute	(Optional) Dynamically redetermine the router's network address.

vines serverless

To configure a Banyan VINES network that does not have a server, use the vines serverless interface configuration command. To disable this feature, use the no form of this command.

vines serverless [dynamic | broadcast]
no vines serverless [dynamic | broadcast]

dynamic	(Optional) Forward broadcasts toward one server only if there are no servers present on this interface.
broadcast	(Optional) Always flood broadcasts out all other router interfaces to reach all servers.

vines split-horizon

To use split horizon when sending routing updates, use the vines split-horizon interface configuration command. To disable split horizon, use the no form of this command.

vines split-horizon
no vines split-horizon

vines srtp-enabled

To enable SRTP, use the vines srtp-enabled global configuration command. To disable SRTP, use the no form of this command.

vines srtp-enabled
no vines srtp-enabled

vines time access-group

To control the servers from which the router will accept VINES network time, use the vines time access-group global configuration command. To accept VINES network time messages from any server, use the no form of this command.

vines time access-group access-list-number
no vines time access-group

access-list-number

Number of the access list. It is a decimal number from 201 to 300.

vines time destination

To control the servers to which the Cisco IOS software sends VINES network time, use the vines time destination global configuration command. To send VINES network time messages to all servers, use the no form of this command.

vines time destination address
no vines time destination

address

Destination VINES address for the network time messages.

seconds

(Optional) Interval, in seconds, between the sending of periodic VINES routing updates. This can be a number in the range 0 to 232 and is rounded up to the nearest 5 seconds. The default value is 90 seconds. If you omit seconds or specify a value of 0, the default value of 90 seconds is used.

Table of Contents

Banyan VINES Commands