Banyan VINES Commands: vines access-group Through vines update interval

This chapter explains the function and syntax of the Banyan Virtual Network System (VINES) protocol commands: vines access-group through vines update interval. For more information about defaults and usage guidelines, see the corresponding chapter of the Cisco IOS Apollo Domain, Banyan VINES, DECnet, ISO CLNS, and XNS Command Reference, Release 12.1.

vines access-group

To apply an access list to an interface, use the vines access-group command in interface configuration mode. 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

Syntax Description

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.

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 command in global configuration mode. 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

Syntax Description

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 the source-port argument. 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.

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 the source-port argument. 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 command in global configuration mode. 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

Syntax Description

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.

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 command in global configuration mode. 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

Syntax Description

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.

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 command in interface configuration mode. To disable the processing of ARP packets, use the no form of this command.

vines arp-enable [dynamic]

no vines arp-enable [dynamic]

Syntax Description

dynamic

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

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 command in global configuration mode. To return to displaying the addresses in hexadecimal, use the no form of this command.

vines decimal

no vines decimal

Syntax Description

This command has no arguments or keywords.

vines encapsulation

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

vines encapsulation [arpa | snap | vines-tr]

no vines encapsulation

Syntax Description

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.

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 enhancements

To enable split-horizon for routing updates and to generate flash updates, use the vines enhancements command in global configuration mode. To turn VINES enhancement off, use the no form of this command.

vines enhancements

no vines enhancements

Syntax Description

This command has no arguments or keywords.

vines host

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

vines host name address

no vines host name

Syntax Description

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.

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 command in interface configuration mode. To disable this filtering, use the no form of this command.

vines input-network-filter access-list-number

no vines input-network-filter

Syntax Description

access-list-number

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

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 command in interface configuration mode. To disable this filtering, use the no form of this command.

vines input-router-filter access-list-number

no vines input-router-filter

Syntax Description

access-list-number

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

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 command in interface configuration mode. To disable VINES routing, use the no form of this command.

vines metric [whole [fractional]]

no vines metric

Syntax Description

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.

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 command in interface configuration mode. 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

Syntax Description

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.

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 command in interface configuration mode. To disable this filtering, use the no form of this command.

vines output-network-filter access-list-number

no vines output-network-filter

Syntax Description

access-list-number

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

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 command in interface configuration mode. To return to the default forwarding scheme, use the no form of this command.

vines propagate [dynamic]

no vines propagate [dynamic]

Syntax Description

dynamic

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

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 command in interface configuration mode. To restore the default, use the no form of this command.

vines redirect [seconds]

no vines redirect

Syntax Description

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.

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 command in global configuration mode. 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]]

Syntax Description

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.

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 command in interface configuration mode. To disable fast switching, use the no form of this command.

vines route-cache

no vines route-cache

Syntax Description

The command has no arguments or keywords.

vines routing

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

vines routing [address | recompute]

no vines routing

Syntax Description

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 redetermines network address of the router.

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 redetermines network address of the router.

vines serverless

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

vines serverless [dynamic | broadcast]

no vines serverless [dynamic | broadcast]

Syntax Description

dynamic

(Optional) Forwards broadcasts toward one server only if there are no servers present on this interface.

broadcast

(Optional) Always floods broadcasts out all other router interfaces to reach all servers.

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

vines single-route

To maintain only one route per server, use the vines single-route command in global configuration mode. To allow multiple routes per server, use the no form of this command.

vines single-route

no vines single route

Syntax Description

This command has no arguments or keywords.

vines split-horizon

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

vines split-horizon

no vines split-horizon

Syntax Description

This command has no arguments or keywords.

vines srtp-enabled

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

vines srtp-enabled

no vines srtp-enabled

Syntax Description

This command has no arguments or keywords.

vines time access-group

To control the servers from which the router will accept VINES network time, use the vines time access-group command in global configuration mode. 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

Syntax Description

access-list-number

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

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 command in global configuration mode. To send VINES network time messages to all servers, use the no form of this command.

vines time destination address

no vines time destination

Syntax Description

address

Destination VINES address for the network time messages.

address	Destination VINES address for the network time messages.

vines time participate

To enable participation in synchronizing time across a VINES network, use the vines time participate command in global configuration mode. To disable this participation, use the no form of this command.

vines time participate

no vines time participate

Syntax Description

This command has no arguments or keywords.

vines time services

To enable the Cisco IOS software to provide time services for VINES clients and to enable participation in the synchronization of time across a VINES network, use the vines time services command in global configuration mode. To disable participation in time synchronization and services, use the no form of this command.

vines time services

no vines time services

Syntax Description

This command has no arguments or keywords.

vines time set-system

To set the internal time based upon the received VINES network time, use the vines time set-system command in global configuration mode. To uncouple the time from VINES network time, use the no form of this command.

vines time set-system

no vines time set-system

Syntax Description

This command has no arguments or keywords.

vines time use-system

To set VINES network time based on the internal time, use the vines time use-system command in global configuration mode. To uncouple VINES network time from the time, use the no form of this command.

vines time use-system

no vines time use-system

Syntax Description

This command has no arguments or keywords.

vines update deltas

To modify the manner in which routing updates are sent, use the vines update deltas command in interface configuration mode. To return to the default method, use the no form of this command.

vines update deltas

no vines update deltas

Syntax Description

This command has no arguments or keywords.

vines update interval

To modify the frequency at which routing updates are sent, use the vines update interval command in interface configuration mode. To return to the default frequency, use the no form of this command.

vines update interval [seconds]

no vines update interval [seconds]

Syntax Description

seconds

(Optional) Interval, in seconds, between the sending of periodic VINES routing updates. This can be a number in the range 0 to 2³² 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: vines access-group Through vines update interval