Table of Contents
Banyan VINES Commands
clear vines cache
clear vines ipc
clear vines neighbor
clear vines route
clear vines traffic
ping
show vines access
show vines cache
show vines host
show vines interface
show vines ipc
show vines neighbor
show vines route
show vines service
show vines traffic
trace
vines access-group
vines access-list (standard)
vines access-list (extended)
vines access-list (simple)
vines arp-enable
vines decimal
vines encapsulation
vines host
vines input-network-filter
vines input-router-filter
vines metric
vines neighbor
vines output-network-filter
vines propagate
vines redirect
vines route
vines route-cache
vines routing
vines serverless
vines split-horizon
vines srtp-enabled
vines time access-group
vines time destination
vines time participate
vines time set-system
vines time use-system
vines update deltas
vines update interval
Banyan VINES Commands
The Banyan VINES protocol is a networking system for personal computers. "VINES" is an acronym for Virtual Network System. This proprietary protocol was developed by Banyan and is derived from Xerox's XNS protocol. Cisco's implementation of VINES has been designed in conjunction with Banyan.
Cisco's implementation of Banyan VINES provides routing of VINES packets on all media types. Although the software automatically determines a metric value that it uses to route updates based on the delay set for the interface, Cisco's software implementation allows you to customize the metric. Cisco's implementation also offers address resolution to respond to address requests. MAC-level echo support is also available for Ethernet, IEEE 802.2, Token Ring, and FDDI media. Name-to-address mapping for VINES host names also is supported, as are access lists to filter outgoing packets.
Use the commands in this chapter to configure and monitor VINES networks. For VINES configuration information and examples, refer to the "Configuring Banyan VINES" chapter in the Router Products Configuration Guide.
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]
Syntax Description
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).
|
Command Mode
EXEC
Usage Guidelines
If you do not specify any keywords or arguments, all entries in the fast-switch cache are deleted.
The fast-switching cache is a table of routes used when fast switching is enabled.
Examples
The following example deletes from the fast-switching cache table all entries from the VINES fast-switching cache table:
The following example deletes all entries whose destination server has the address 30002E6D:
clear vines cache server 30002E6D
Related Commands
show vines cache
vines decimal
vines route-cache
clear vines ipc
To delete VINES IPC connection blocks from the router, use the clear vines ipc EXEC command.
- clear vines ipc number
Syntax Description
number
|
Hexadecimal number of the IPC connection to delete.
|
Command Mode
EXEC
Usage Guidelines
An IPC connection entry is built each time the router initiates or receives an IPC DATA message from a router that is not already in this table.
Examples
The following example deletes IPC connection 0x1D from the table of VINES IPC connections:
Related Command
show vines ipc
clear vines neighbor
To delete entries from the neighbor table, use the clear vines neighbor EXEC command.
- clear vines neighbor {network | *}
Syntax Description
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.
|
Command Mode
EXEC
Usage Guidelines
The neighbor table contains an entry for each of the router's neighbor nodes.
Deleting an entry from the neighbor table also deletes any routes in the routing table that have that neighbor as the first hop and all fast-switching cache entries that have that neighbor as the first hop in any of their paths.
Example
The following example deletes all entries from the neighbor table:
Related Commands
clear vines route
show vines neighbor
show vines route
vines decimal
vines neighbor
vines route
clear vines route
To delete network addresses from the routing table, use the clear vines route EXEC command.
- clear vines route {network | *}
Syntax Description
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.
|
Command Mode
EXEC
Usage Guidelines
Deleting an entry from the routing table with the clear vines route command also deletes any entries in the fast-switching table that are a part of that logical network.
Example
The following example deletes all entries from the VINES routing table:
Related Commands
clear vines neighbor
show vines neighbor
show vines route
vines decimal
vines host
vines route
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
Syntax Description
This command has no arguments or keywords.
Command Mode
EXEC
Usage Guidelines
The clear vines traffic command clears only the statistics displayed by the show vines traffic command. It has no effect on the value of the VINES counters retrieved by SNMP.
Example
The following example zeros all VINES-related traffic statistics:
Related Command
show vines traffic
ping
To determine basic network connectivity, use the ping EXEC command.
- ping [vines] [address]
Syntax Description
vines
|
(Optional) Specifies the VINES protocol. If you omit this keyword, the router prompts for it.
|
address
|
(Optional) Address of system to ping. If you omit the address, the router prompts for it.
|
Command Mode
EXEC
Usage Guidelines
The ping command determines network connectivity by sending datagrams to another host on the network.
Sample Display
The following is sample output from the ping command:
Router#
ping vines 27AF92:1
Type escape sequence to abort.
Sending 5, 100-byte VINES Echos to 27AF92:1,
Success rate is 100 percent, round-trip min/avg/max = 4/7/8 ms
Target VINES address: 27AF92:1
Type escape sequence to abort.
Sending 10, 500-byte VINES Echos to 27AF92:1,
Success rate is 100 percent, round-trip min/avg/max = 4/7/8 ms
show vines access
To display the VINES access lists currently defined, use the show vines access EXEC command.
- show vines access [access-list-number]
Syntax Description
access-list-number
|
(Optional) Number of the access list to display.
|
Command Mode
EXEC
Usage Guidelines
If no access list number is specified, all access lists are displayed.
Sample Display
The following is sample output from the show vines access command:
Router#
show vines access
deny SPP 30015800:0001 00000000:00000000 202 00123456:8005 00000000:0000 249
permit IP 00000000:0000 FFFFFFFF:FFFF 00000000:0000 FFFFFFFF:FFFF
deny SPP 00112233:0001 00000000:0000 0006 0000
00123456:8005 00000000:00000000 0000 FFFF
permit IP 00000000:0000 FFFFFFFF:FFFF 00000000:0000 FFFFFFFF:FFFF
Table 15-1 describes the fields shown in the display.
Table 15-1 Show VINES Access Field Descriptions
| Field
|
Description
|
Vines access list ...
|
Number of the VINES access list.
|
deny
|
Networks to which access is denied.
|
permit
|
Networks to which access is permitted.
|
Related Commands
vines access-list (standard)
vines access-list (extended)
vines access-list (simple)
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]
Syntax Description
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).
|
Command Mode
EXEC
Usage Guidelines
If no keywords or arguments are specified, all entries in the fast-switching cache are displayed.
Sample Display
The following is sample output from show vines cache command. This sample shows all entries in the VINES fast-switching cache.
VINES fast switching cache information:
Current: 0 entries, 0 paths
Added: 0 server, 0 router, 0 client
Updated: 0 server, 0 router, 0 client
Expired: 0 server, 0 router, 0 client
Removed: 0 server, 0 router, 0 client
Flushes: 4 by neighbor, 1 by server
8 by interface, 1 entire table
Hash Destination Int Age Length Type MAC Header
13/00 Router1 *T0 46 16/18 1 10005A746A3600003080FB06BCBC03BA
27/00 Router2 E1 11 14/14 1 00000C01D87C00000C0158010BAD
*T0 11 16/18 1 00003000435500003080FB06BCBC03BA
3E/00 Router3 *T0 42 16/18 1 10005A6FBC15000003080FB06BCBC03BA
72/00 30002E6D:0001 E1 32 14/14 1 00000C01D87C00000C0158010BAD
*T0 32 16/18 1 00003000435500003080FB07BCBC03BA
T0 32 16/18 1 10005A6FBC1500003080FB06BCBC03BA
T0 32 16/18 1 10005A6FBC1500003080FB06BCBC03BA
FE/00 Router4 *E2 264 14/14 1 00000C0124EA00000C0151AF0BAD
Table 15-2 describes fields shown in the display.
Note that neighbor information is not explicitly displayed by the show vines cache command. However, you can determine it by looking at the neighbor and routing tables (using the show vines neighbor and show vines route commands, respectively).
Table 15-2 Show VINES Cache Field Descriptions
| Field
|
Description
|
Current:
|
The number of entries and paths currently in the cache.
|
History:
|
Number of events since the last time the counters were cleared.
|
Added:
|
Number of server, router, and client entries added to the cache.
|
Updated:
|
Number of server, router, and client entry updates.
|
Expired:
|
Number of server, router, and client entries that timed out.
|
Removed:
|
Number of server, router, and client entries removed from the cache.
|
Flushes:
|
Number of neighbor, server, interface, and entire table flushes.
|
Hash
|
Position of this entry in the neighbor table.
|
Destination
|
Name or address of the destination station.
|
Int
|
Interface out which the packet is sent. An asterisk preceding the interface name indicates that this is the next entry that will be used for the destination.
|
Age
|
Age of the entry, in seconds.
|
Length
|
Stored length of the packet's MAC header, followed by a slash and the actual length of the MAC header. Both lengths do not include the length of the Type field. These two lengths may differ because the initial bytes of Token Ring and FDDI frames are not stored.
|
Type
|
Local encapsulation type.
|
MAC Header
|
MAC header used to reach the destination.
|
Related Commands
clear vines cache
show vines neighbor
show vines route
vines decimal
vines route-cache
show vines host
To display the entries in the VINES host name table, use the show vines host EXEC command.
- show vines host [name]
Syntax Description
name
|
(Optional) Displays the entry in the VINES name table that has the specified name.
|
Command Mode
EXEC
Usage Guidelines
If no name is specified, all entries in the host name table are displayed.
Sample Display
The following is sample output from the show vines host command:
Table 15-3 describes the fields shown in the display.
Table 15-3 Show VINES Host Field Descriptions
| Field
|
Description
|
Name
|
Name of the VINES host.
|
Address
|
Address of the VINES host.
|
Related Command
vines host
show vines interface
To display status of the VINES interfaces configured in the router and the parameters configured on each interface, use the show vines interface EXEC command.
- show vines interface [type number]
Syntax Description
type
|
(Optional) Interface type.
|
number
|
(Optional) Interface number.
|
Command Mode
EXEC
Usage Guidelines
If you omit all keywords, this command displays values for all interfaces, and displays all VINES global parameters.
Sample Display
The following is sample output from the show vines interface command:
Router#
show vines interface
VINES address is 3000902D:0001
Next client will be 3000902D:8001
Addresses are displayed in hexadecimal format.
Slowest update interval is 90 seconds
Neighbor Router3-Et2-0000.0c01.24ea in 180 seconds
Sequence: 01029DD7, Packet ID: 00000003
Reassembly timer queue: (empty)
Retry timer queue: (empty)
Participating in vines time of day synchronization
Hssi0 is down, line protocol is down
VINES protocol processing disabled
Fddi0 is up, line protocol is up
VINES broadcast encapsulation is ARPA
Interface metric is 0008 [0 5000] (0.1000 seconds)
ARP processing is dynamic, state is learning (for another 18 seconds)
Special serverless net processing enabled
Outgoing access list is not set
Fast switching is enabled
Routing updates every 90 seconds. Next in 50 seconds.
Next synchronization update in 11:58:17.
Nodes present: 0 5.5x servers, 0 5.5x routers, 0 5.5x clients
0 4.11 servers, 0 4.11 routers, 0 4.11 clients
Table 15-4 describes the fields that may be shown in the display.
Table 15-4 Show VINES Interface Field Descriptions
| Field
|
Description
|
VINES address
|
Address of the router.
|
Next client will be
|
Address the router will assign to the next client that requests an address. This line is interesting only if the router has been configured via the vines arp-enablecommand to respond to address assignment requests.
|
Addresses
|
Indicates whether addresses will be displayed as decimal or hexadecimal numbers.
|
Slowest update interval
|
Indicates the longest time interval (in seconds) between routing updates on any of the router's interfaces.
|
Roll Call timer
Neighbor
|
Displays a list of all neighbor paths for which an RTP request will be sent on a regular basis, and the interval until that timer expires.
|
Sequence
|
Current SRTP sequence number for this router.
|
Packet ID
|
Identifier number that will be used on the last SRTP update message sent by this router
|
Reassembly timer
|
Displays a list of all neighbor paths for which an SRTP update is currently being reassembled, and the interval until that timer expires.
|
Retry timer
|
Displays a list of all neighbor paths for which an SRTP request is currently being retried, and the interval until that timer expires.
|
Participating in vines time of day synchronization
|
Indicates whether the router is participating in VINES time-of-day synchronization. This is controlled by the vines time participate global configuration command.
|
Hssi0/Ethernet 0/Ethernet 1 is up/down
|
Type and number of interface, and whether it is currently active and inserted into network (up) or inactive and not inserted (down).
|
Line protocol is
|
Indicates whether the software processes that handle the line protocol believe the interface is usable (that is, whether keepalives are successful). This field can report the values "up," "down," and "administratively down."
|
VINES protocol processing disabled
|
Indicates that VINES processing is not enabled on the interface (that is, you have not issued a vines metric command on the interface).
|
VINES broadcast encapsulation
|
Type of encapsulation used for VINES broadcast packets, as defined with the vines encapsulation command. This field can report the values "arpa," "vines-tr," and "snap."
|
Interface metric
|
Metric that has been configured for the interface with the vines metric command. The metric is shown in internal form, configuration form, and in seconds.
|
Split horizon
|
Indicates whether split horizon has been enabled or disabled (via the vines split-horizon command).
|
ARP processing
|
Indicates whether this interface will process ARP packets, as specified by the vines arp-enable command.
|
Special serverless net processing
|
Indicates whether this interface is defined via the vines serverless command as being connected to a serverless network.
|
Outgoing access list
|
Indicates whether an access list is set.
|
Fast switching
|
Indicates whether fast switching has been enabled via the vines route-cache command). The value reported in this field can be "enabled," "disabled," or "not supported."
|
Routing updates every
Next in
|
Frequency of routing updates, in seconds. This also indicates when the next routing update will be transmitted on the interface. You set the update interval with the vines update interval command.
|
Routing updates
|
Indicates whether routing updates contain all entries in the routing table or just changes to the table since the last update was sent. You set the method used with the vines update deltas command.
|
Next synchronization
|
Indicates when the next SRTP synchronization update will be sent.
|
Nodes Present
|
Indicates the number and type of all VINES-speaking devices present on the given physical network segment.
|
Neighbors
0 Router2
|
List of all VINES neighbor on that interface and what version of the RTP protocol they are running. 0 means RTP, and 1 means SRTP.
|
Related Commands
vines arp-enable
vines encapsulation
vines metric
vines route-cache
vines serverless
vines split-horizon
vines update deltas
vines update interval
show vines ipc
To display information about any currently active IPC connections, use the show vines ipc EXEC command.
- show vines ipc
Syntax Description
This command has no arguments or keywords.
Command Mode
EXEC
Usage Guidelines
Information about the IPC protocol formats, data sequences, and state machines can be found in Banyan documentation.
Sample Display
The following is sample output from the show vines ipc command:
Connection 2, state: connected
Local address: Router1, id 0002, last port: 0200
Remote address: Router2, id 0002, last port: 0001
Last send seq: 0005, Last rcvd seq: 0005
Next send ack: 0005, Last sent ack: 0005
Server metric 4, last hop 0, bias 0, total 800 (ms)
Send ACK in 0 ms, Retransmit in 0 ms
Retransmit queue contains 0 packets
Table 15-5 describes the fields shown in the display.
Table 15-5 Show VINES IPC Field Descriptions
| Field
|
Description
|
Next Port:
|
IPC port number that the router will use when a new, unique IPC port number is needed.
|
Next Connection:
|
IPC connection number that the router will use when a new, unique IPC connection number is needed.
|
Next check in:
|
When the router will make the next pass of the IPC connection table to examine each of the connection-specific timers.
|
Connection 2, state:
|
State of a particular connection. Possible states are connecting, connected, idle, and dead.
|
Local address:
|
VINES IP address of the local side of the connection.
|
last port:
|
Last port number used on this particular connection by the local host.
|
Remote address:
|
VINES IP address of the remote side of the connection.
|
last port:
|
Last port number used on this particular connection by the remote host.
|
Last send seq:
|
Last sequence number sent on this particular connection used by the local host.
|
Last rcvd seq:
|
Last sequence number received on this particular connection used by the local host.
|
Next send ack:
|
Next acknowledgment number that will be sent on this particular connection by the local host.
|
Last sent ack:
|
Last acknowledgment number that has been sent on this particular connection by the local host.
|
Server metric
|
Metric value from this host to the remote host's server or router.
|
last hop
|
Metric value from the remote host's server or router to the remote host itself. If the remote host is a server or router, this value should be zero.
|
bias
|
Bias added to the metric to account for variance in the round-trip delay of a message going to the remote host.
|
total
|
Total metric value used to reach the remote host. It is the sum of the three previous numbers.
|
Send ACK
|
Time, in seconds, until the next acknowledgment message is sent by the local host.
|
Retransmit
|
Time, in seconds, until a message is retransmitted by the local host.
|
Idle check in
|
Time, in seconds, until this connection will be checked to see if it has been idle for 30 seconds.
|
Retransmit queue contains ... packets
|
Number of messages that have been sent but not acknowledged.
|
No packet in reassembly
|
Number of packets that have been received and are being reassembled into a larger message.
|
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]
Syntax Description
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.
|
Command Mode
EXEC
Usage Guidelines
If no keywords or arguments are specified, all entries in the neighbor table are displayed.
Sample Displays
The following is sample output from the show vines neighbor command. This sample shows all entries in the VINES neighbor table.
Router#
show vines neighbor
6 neighbors, 7 paths, version 14, next update 34 seconds
Address Hardware Address Type Int Flag Age Metric Uses
Router1 - HDLC Se0 R0* n/a 0230 7
Router3 0000.0c01.24ea ARPA Et2 R0* 42 0020 9
Router4 - PPP Se1 R1 n/a 0230 0
Router4 0000.0c01.0506 ARPA Et0 R1. n/a 0020 0
Router4 0000.0c01.9ac9 VINES To0 R1* n/a 0020 0
Router#
show vines neighbor router3
3 neighbors, 4 paths, version 7, next update 24 seconds
Address Hardware Address Type Int Flag Age Metric Uses
Router3 0000.0c01.24ea ARPA Et2 R0* 42 0020 9
Interface Ethernet2, address Router3-Et2-0000.0c01.24ea
Router#
show vines neighbor router4
3 neighbors, 4 paths, version 7, next update 5 seconds
Address Hardware Address Type Int Flag Age Metric Uses
Interface Ethernet0, address Router4-Et0-0000.0c01.0506, state up
Origin 0001BE9A, Local 00006262, Flags 0001, ID 007F
Retry request: not active
Requests: specific changes full null unknown
00000000 00000000 00000000 00000000 00000000
Updates: failed less equal one more greater
null: 00000000 00000000 00000000 00000000 00000000
change: 00000000 00000000 00000000 00000000 00000000
full: 00000000 00000000 00000000 00000000 00000000
sync: 00000000 00000000 00000000 00000000 00000000
Requests: unknown specific changes full null
