Table Of Contents
Banyan VINES Commands
clear vines cache
clear vines ipc
clear vines neighbor
clear vines route
clear vines traffic
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)
Banyan VINES Commands
The Banyan Virtual Network System (VINES) protocol is a networking system for personal computers. This proprietary protocol was developed by Banyan and is derived from the Xerox Network Systems (XNS) protocol. Cisco's implementation of VINES was designed in conjunction with Banyan.
Cisco's implementation of Banyan VINES provides routing of VINES packets on all media. 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 is also supported, as are access lists to filter outgoing packets.
Note 
Not all Cisco access servers support Banyan VINES. For more information, refer to the release notes for the release that you are running.
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 Cisco IOS Apollo Domain, Banyan VINES, DECnet, ISO CLNS, and XNS Configuration Guide.
clear vines cache
To delete entries from the VINES fast-switching cache, use the clear vines cache command in EXEC mode.
clear vines cache [interface interface | neighbor address | server network | counters]
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).
|
counters
|
(Optional) Deletes the fast-switching cache and counters.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
The fast-switching cache is a table of routes used when fast switching is enabled.
If you do not specify any keywords or arguments, all entries in the fast-switching cache are deleted.
Examples
The following example deletes 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
Command
|
Description
|
show vines cache
|
Displays the contents of the VINES fast-switching cache.
|
vines decimal
|
Displays VINES addresses in decimal notation.
|
vines route-cache
|
Enables fast switching.
|
clear vines ipc
To delete VINES Interprocess Communications Protocol (IPC) connection blocks, use the clear vines ipc command in EXEC mode.
clear vines ipc number
Syntax Description
number
|
Hexadecimal number of the IPC connection to delete.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
An IPC connection entry is built each time Cisco IOS software 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 Commands
Command
|
Description
|
show vines ipc
|
Displays information about any currently active IPC connections.
|
clear vines neighbor
To delete entries from the neighbor table, use the clear vines neighbor command in EXEC mode.
clear vines neighbor {address | *}
Syntax Description
address
|
Address of the neighbor entry whose entry should be deleted from the neighbor table. The argument is a 6-byte hexadecimal number in the format network:host where network is 4 bytes and host is 2 bytes.
|
*
|
Deletes all entries from the neighbor path table except the entry for the local router.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
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.
Examples
The following example deletes all entries from the neighbor table:
Related Commands
Command
|
Description
|
clear vines route
|
Deletes network addresses from the routing table.
|
show vines neighbor
|
Displays the entries in the VINES neighbor table.
|
show vines route
|
Displays the contents of the VINES routing table.
|
vines decimal
|
Displays VINES addresses in decimal notation.
|
vines neighbor
|
Specifies a static path to a neighbor station.
|
vines route
|
Specifies a static route to a server.
|
clear vines route
To delete network addresses from the routing table, use the clear vines route command in EXEC mode.
clear vines route {network | *}
Syntax Description
network
|
Network number of the entry to delete from the routing table. The argument network can be 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 enhancements command).
|
*
|
Deletes all entries from the routing table.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
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.
Examples
The following example deletes all entries from the VINES routing table:
Related Commands
Command
|
Description
|
clear vines route
|
Deletes network addresses from the routing table.
|
show vines neighbor
|
Displays the entries in the VINES neighbor table.
|
show vines route
|
Displays the contents of the VINES routing table.
|
vines decimal
|
Displays VINES addresses in decimal notation.
|
vines host
|
Associates a host name with a VINES address.
|
vines route
|
Specifies a static route to a server.
|
clear vines traffic
To clear all VINES-related statistics that are displayed by the show vines traffic command, use the clear vines traffic command in EXEC mode.
clear vines traffic
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
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 Simple Network Management Protocol (SNMP).
Examples
The following example zeros all VINES-related traffic statistics:
Related Commands
Command
|
Description
|
show vines traffic
|
Displays the statistics maintained about VINES protocol traffic.
|
show vines access
To display the VINES access lists currently defined, use the show vines access command in EXEC mode.
show vines access [access-list-number]
Syntax Description
access-list-number
|
(Optional) Number of the access list to display.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
If no access list number is specified, all access lists are displayed.
Examples
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 7 describes the fields shown in the display.
Table 7 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
Command
|
Description
|
vines access-list (extended)
|
Creates an extended VINES access list.
|
vines access-list (simple)
|
Creates a simple VINES access list.
|
vines access-list (standard)
|
Specifies a standard VINES access list.
|
show vines cache
To display the contents of the VINES fast-switching cache, use the show vines cache command in EXEC mode.
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 enhancements 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 Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
If no keywords or arguments are specified, all entries in the fast-switching cache are displayed.
Examples
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 8 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 8 show vines cache Field Descriptions
Field
|
Description
|
Current:
|
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
Command
|
Description
|
clear vines route
|
Deletes network addresses from the routing table.
|
show vines neighbor
|
Displays the entries in the VINES neighbor table.
|
show vines route
|
Displays the contents of the VINES routing table.
|
vines decimal
|
Displays VINES addresses in decimal notation.
|
vines route-cache
|
Enables fast switching.
|
show vines host
To display the entries in the VINES host-name table, use the show vines host command in EXEC mode.
show vines host [name]
Syntax Description
name
|
(Optional) Displays the entry in the VINES name table that has the specified name.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
If no name is specified, all entries in the host-name table are displayed.
Examples
The following is sample output from the show vines host command:
Table 9 describes the fields shown in the display.
Table 9 show vines host Field Descriptions
Field
|
Description
|
Name
|
Name of the VINES host.
|
Address
|
Address of the VINES host.
|
Related Commands
Command
|
Description
|
vines host
|
Associates a host name with a VINES address.
|
show vines interface
To display status of the VINES interfaces configured in Cisco IOS software and the parameters configured on each interface, use the show vines interface command in EXEC mode.
show vines interface [type number]
Syntax Description
type
|
(Optional) Interface type.
|
number
|
(Optional) Interface number.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
If you omit all keywords, this command displays values for all interfaces and displays all VINES global parameters.
Examples
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 10 describes the significant fields shown in the display.
Table 10 show vines interface Field Descriptions
Field
|
Description
|
VINES address
|
Address of the router.
|
Next client will be
|
Address the router assigns to the next client that requests an address. This line is important only if the router has been configured via the vines arp-enable command to respond to address assignment requests.
|
Addresses
|
Indicates whether addresses are 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 a Routing Table Protocol (RTP) request is sent on a regular basis, and the interval until that timer expires.
|
Sequence
|
Current Sequenced Routing Update Protocol (SRTP) sequence number for this router.
|
Packet ID
|
Identifier number that is 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/Fddi0 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: none
|
List of all VINES neighbors on that interface and what version of the RTP protocol they are running (0 means RTP, and 1 means SRTP).
|
Related Commands
Command
|
Description
|
vines arp-enable
|
Enables the processing of ARP packets.
|
vines encapsulation
|
Sets the MAC-level encapsulation used for VINES broadcast packets.
|
vines metric
|
Enables VINES routing on an interface.
|
vines route-cache
|
Enables fast switching.
|
show vines ipc
To display information about any currently active interprocess communication (IPC) connections, use the show vines ipc command in EXEC mode.
show vines ipc
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
Information about the IPC protocol formats, data sequences, and state machines can be found in Banyan documentation.
Examples
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 11 describes the fields shown in the display.
Table 11 show vines ipc Field Descriptions
Field
|
Description
|
Next Port:
|
IPC port number that the router uses when a new, unique IPC port number is needed.
|
Next Connection:
|
IPC connection number that Cisco IOS software uses when a new, unique IPC connection number is needed.
|
Next check in:
|
When the software makes 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 is 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 is 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 command in EXEC mode.
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 Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
If no keywords or arguments are specified, all entries in the neighbor table are displayed.
Examples
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
The following is sample output from the show vines neighbor command for a specific server. This sample shows all entries in the VINES neighbor table for Router 3.
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
Table 12 describes the fields shown in the display.
Table 12 show vines neighbor Field Descriptions
Field
|
Description
|
neighbors
|
Number of neighbors in the neighbor table.
|
paths
|
Number of paths to the neighbor.
|
version
|
Version number of the VINES neighbor table. The number is incremented each time a route or path is added to or deleted from this table.
|
next update
|
Time, in seconds, until the next routing update is sent.
|
Address
|
Address of the neighbor station. The neighbor's name is displayed if you have issued a vines enhancements command.
|
Hardware Address
|
MAC address of the router interface through which the VINES neighbor in this entry can be reached.
|
Type
|
Type of MAC-level encapsulation used to communicate with this neighbor.
|
Int
|
Type and number of interface through which the VINES neighbor can be reached.
|
Flag
|
This field is a three-column field.
The first column indicates how the path was learned. It can be one of the following values:
•C—Connected (that is, this is the entry for this router).
•D—Learned via an RTP redirect message.
•P—Placeholder. This neighbor is currently used as the next hop for a static route.
•R—Learned via an RTP update message.
•S—Static path entry (entered with the vines neighbor command).
The second column indicates what version of the RTP protocol this neighbor is running. It can be one of the following values:
•0—Version 0 of the RTP protocol. This is the version used by VINES servers prior to VINES version 5.50.
•1—Version 1 of the RTP protocol, commonly called SRTP. This is the version used by VINES servers in VINES version 5.50 and later.
The third column indicates how this path is used. It can be one of the following values:
•*—An asterisk means that this is the next path used when forwarding a frame to that neighbor.
•.—A dot means that this is the alternate path used in round-robin fashion.
•Blank—No value means this is a backup path that is not used.
In the sample output, there are two paths to Router4 with the same metric. These two paths will be used in a round-robin fashion, and the Token Ring path will be the next one of the two used. There is a third path to Router4 via the serial line, but this will not be used unless both of the other paths are lost.
|
Age
|
Age of this VINES neighbor table entry, in seconds. This entry shows an age of "n/a" for RTP Version 0 neighbors on WAN interfaces, when the interface has been configured for delta-only updates. In all other cases, this entry contains a number.
|
Metric
|
Distance to this neighbor. This normally is the same as the interface metric, but may be different because of network topology or router configuration.
|
Uses
|
For all entries except placeholders, indicates the number of times that path was used to forward a packet. For placeholder entries, indicates the number of static routes that use the neighbor as the first hop.
|
RTP Counters:
|
This section shows counters that are specific to a neighbor port that is running the RTP protocol only. If the neighbor has multiple interfaces, multiple sections show up in this part of the display.
|
Interface...
|
Identifies the network interface and full identifier for a neighbor port.
|
Timers:
Roll Call
|
Identifies whether the roll call timer is active for this neighbor, and if so, when it will expire.
|
Received Counters
|
Indicates the number and type of RTP packets received from this neighbor port.
|
SRTP Counter:
|
This section shows counters that are specific to a neighbor port that is running the SRTP protocol. If the neighbor has multiple interfaces, multiple sections show up in this part of the display.
|
Interface
|
Identifies the network interface and full identifier for a neighbor port.
|
Timers:
Reassembly
|
Identifies whether the reassembly timer is active for this neighbor, and if so, when it will expire.
|
Timers:
Retry
|
Identifies whether the retry timer is active for this neighbor, and if so, when it will expire.
|
Received Counters
|
Indicates the number, type, and sequence number of matching SRTP packets received from this neighbor port.
|
Transmitted Counters
|
Indicated the number and type of SRTP packets transmitted explicitly to this neighbor port.
|
Related Commands
Command
|
Description
|
clear vines neighbor
|
Deletes entries from the neighbor table.
|
clear vines route
|
Deletes network addresses from the routing table.
|
show vines cache
|
Displays the contents of the VINES fast-switching cache.
|
vines enhancements
|
Enables split-horizon for routing updates and to generate flash updates.
|
vines neighbor
|
Specifies a static path to a neighbor station.
|
vines update deltas
|
Modifies the manner in which routing updates are sent.
|
vines update interval
|
Modifies the frequency at which routing updates are sent.
|
show vines route
To display the contents of the VINES routing table, use the show vines route command in EXEC mode.
show vines route [number | neighbor address | metric]
Syntax Description
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.
|
metric
|
(Optional) Display routes by metric.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
If no keywords or arguments are specified, all entries in the routing table are displayed.
Examples
The following is sample output from the show vines route command. This sample shows all entries in the VINES routing table.
Succubus Succubus R1* 2 2 0
The following is sample output from the show vines route command for a specific neighbor. This sample shows all entries in the VINES routing table for Router1.
Router# show vines route router1
8 servers, 10 routes, version 58, next update 32 seconds
Network Neighbor Flags Age Metric Uses Origin Local Flags
Router1 Router2 R0* n/a 0250 0 001AFE7B 00010FCA 0009
Table 13 describes the fields shown in the display.
Table 13 show vines route Field Descriptions
Field
|
Description
|
servers
|
Number of servers in the routing table.
|
routes
|
Number of routes in the routing table.
|
version
|
Version number of the VINES routing table. This number is incremented each time a server or route is added to or deleted from this table.
|
next update
|
Time, in seconds, until the next routing update is sent.
|
Hash
|
Position of this entry in the routing table.
|
Network
|
Name or number of the remote network. Networks take the name of the server that defines the network.
|
Neighbor
|
Next hop to the destination network.
|
Flags
|
This field is a series of single-column fields.
The first column indicates how the route was learned. It can be one of the following values:
•C—Connected (that is, this is the entry for this router).
•D—Learned via an RTP redirect message.
•R—Learned via an RTP update message.
•S—Static entry (entered with the vines route command).
The second column indicates what version of the RTP protocol this router is running. It can be one of the following values:
•0—Version 0 of the RTP protocol. This is the version used by VINES servers prior to VINES version 5.50. This version number is also shown if the route was learned via a pre-5.50 server, and thus the version information was lost.
•1—Version 1 of the RTP protocol, commonly called SRTP. This is the version used by VINES servers in VINES version 5.50 and later.
An asterisk in the third column indicates that this route is used next when forwarding a frame to that server.
The fourth column indicates whether that route is used to forward a broadcast from a serverless network. It can be one of the following values:
•N—This server is considered to be the nearest server and is on a directly connected network.
•n—This server is considered to be the nearest server but is not on a directly connected network.
The fifth column contains the letter "S" if the route is in a suppression state.
The sixth column contains the letter "h" if this path has a metric that is higher than the best metric for this neighbor. This indicates that the path is not eligible for use in load sharing.
|
Age
|
Age of this VINES routing table entry, in seconds. An age of n/a indicates the destination is accessible via a neighbor that is sending delta-only updates. Note that even though the neighbor entry for Pica has an age, there is no age available for its routing table entry or other routing entries reachable via Pica. This is because the periodic hello messages from Pica contain no routing information, only neighbor reachability information.
|
Metric
|
Distance to this server. This normally is the distance to the neighbor router plus the distance advertised by that neighbor. This does not hold for static routes.
|
Uses
|
Number of times this route has been used to forward a packet.
|
Origin
|
Last known timestamp that originated from this server. If this field is not valid, as indicated by the following set of flags, it will be zero.
|
Local
|
Local timestamp then this route entry was learned or last changed.
|
Flags
|
This field is a series of bit flags presented as a hexadecimal number. The following are the defined values:
•0001—The neighbor of this server reaches it through a LAN interface.
•0002—The neighbor of this server reaches it through a WAN interface.
•0004—The neighbor of this server reaches it through a non-VINES interface.
•0008—The origin timestamp for this entry is not valid. The entry is either for a pre-5.50 server, or the entry was learned via a pre-5.50 server.
|
Related Commands
Command
|
Description
|
clear vines neighbor
|
Deletes entries from the neighbor table.
|
clear vines route
|
Deletes network addresses from the routing table.
|
show vines cache
|
Displays the contents of the VINES fast-switching cache.
|
vines route
|
Specifies a static route to a server.
|
vines neighbor
|
Specifies a static path to a neighbor station.
|
vines update deltas
|
Modifies the manner in which routing updates are sent.
|
vines update interval
|
Modifies the frequency at which routing updates are sent.
|
show vines service
To display information about the application layer support, use the show vines service command in EXEC mode.
show vines service [fs | nsm | ss | vs]
Syntax Description
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.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Examples
The following is sample output from the show vines service command:
Router# show vines service
Name: FS@Doc-ags+1@Servers (FS)
Ports: Well Known 6, Transient 0
Network & System Management Service:
Name: NSM@Doc-ags+1@Servers (NSM)
Ports: Well Known 25, Transient 0
Name: SS@Doc-ags+1@Servers (SS)
Ports: Well Known 7, Transient 0
Emulates: 5.50(0), Supports: 3.22(49) - 6.99(49)
Name: VS@Doc-ags+1@Servers (VS)
Ports: Well Known 19, Transient 0
Table 14 describes the fields shown in the display.
Table 14 show vines service Field Descriptions
Field
|
Description
|
Name:
|
Name of the service.
|
Ports:
|
Ports on which the service is running.
|
Timer:
|
Time at which this service will wake up and perform some periodic functions.
|
The following is sample output from the show vines service command using the fs, nsm, ss, and vs keywords:
Router# show vines service fs
Periodic timer not running.
Router# show vines service nsm
Network & System Management Service:
Router# show vines service ss
Time is 07:52:31 ET Sep 11 1998
Time last set by 300EF792:0001, 00:10:13 ago.
Time epoch is SS@Rdtp-10@Servers-1, started 00:10:14 ago.
Capable of providing time services to clients.
Listening to VINES time of day synchronization.
Participating in vines time of day synchronization.
Sending time messages to the broadcast address.
Router# show vines service vs
Periodic timer not running.
Table 15 describes the fields shown in the displays.
Table 15 show vines service (fs, nsm, ss, and vs) Field Descriptions
Field
|
Description
|
Periodic timer not running
|
Indicates that this service has no periodic functions to perform.
|
Next wakeup in...
|
Time, in seconds, until the service performs its periodic actions. For the Server service, this is to send a time synchronization message. For the Network System and Management (NSM) service, this is to send any requested trace packets. The periodic interval for the NSM service is 30 seconds when no trace messages are pending.
|
Time is...
|
Current time (in the format hours:minutes:seconds) and date.
|
Time last set...
|
Server that last adjusted the time, how much it adjusted the time, and how long ago it was adjusted. For times within the last 24 hours, the time format is hours:minutes:seconds. For times longer ago than 24 hours, the time format is weekswdaysd.
|
Time epoch is...
|
Name of the current time epoch (in the format name-number) and when it was established.
|
Related Commands
Command
|
Description
|
vines time access-group
|
Controls the servers from which the router will accept VINES network time.
|
vines time participate
|
Enables participation in synchronizing time across a VINES network.
|
vines time services
|
Enables Cisco IOS to provide time services for VINES clients and enables participation in the synchronization of time across a VINES network.
|
vines time use-system
|
Sets VINES network time based on the internal time.
|
show vines traffic
To display the statistics maintained about VINES protocol traffic, use the show vines traffic command in EXEC mode.
show vines traffic [type number]
Syntax Description
type
|
(Optional) Interface type.
|
number
|
(Optional) Interface number.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
If no interface is specified, values for all interfaces are displayed.
Examples
The following is sample output from the show vines traffic command:
Router# show vines traffic
Rcvd: 204 total, 12708 bytes, 0 format errors, 0 not enabled,
15 local dst, 189 bcast, 0 forwarded
0 checksum errors, 3 IP unknown, 0 IPC unknown
3 bcast forwarded, 1 bcast helpered, 0 dup bcast
Sent: 21 packets, 1278 bytes
0 unicast, 21 bcast, 0 forwarded
0 encap failed, 0 access failed, 0 down
0 bcast fwd, 3 not fwd (toward source)
0 notlan, 0 not gt4800, 0 no pp charge
ARPv0: Rcvd 0/0/0/0/0, Sent 0/0/0/0
ARPv1: Rcvd 0/0/0/0/0, Sent 0/0/0/0
ICP: Rcvd 0/0/0, Send 0/0
RTPv0: Rcvd 2/10/0/0/170/0/0/5, Sent 0/6/00/0/91/10/0
RTPv1: Rcvd 0/0/0/0/0/0, Sent 0/3/60/0
IPC TRAFFIC BY PORT NUMBER:
Broadcast: Other:00000000, 01:00000000, 02:00000000, 03:00000000, 04:00000000
05:00000000, 06:00000000, 07:00000000, 08:00000000, 09:00000000
0A:00000000, 0B:00000000, 0C:00000000, 0D:00000000, 0E:00000000
0F:00000000, 10:00000000, 11:00000000, 12:00000000, 13:00000000
14:00000000, 15:00000000, 16:00000000, 17:00000000, 18:00000000
Helpered: Other:00000000, 01:00000000, 02:00000000, 03:00000000, 04:00000000
05:00000000, 06:00000000, 07:00000000, 08:00000000, 09:00000000
0A:00000000, 0B:00000000, 0C:00000000, 0D:00000000, 0E:00000000
0F:00000000, 10:00000000, 11:00000000, 12:00000000, 13:00000000
14:00000000, 15:00000000, 16:00000000, 17:00000000, 18:00000000
Unicast: Other:00000000, 01:00000000, 02:00000000, 03:00000000, 04:00000000
05:00000000, 06:00000000, 07:00000000, 08:00000000, 09:00000000
0A:00000000, 0B:00000000, 0C:00000000, 0D:00000000, 0E:00000000
0F:00000000, 10:00000000, 11:00000000, 12:00000000, 13:00000000
14:00000000, 15:00000000, 16:00000000, 17:00000000, 18:00000000
Proxied: Other:00000000, 01:00000000, 02:00000000, 03:00000000, 04:00000000
05:00000000, 06:00000000, 07:00000000, 08:00000000, 09:00000000
0A:00000000, 0B:00000000, 0C:00000000, 0D:00000000, 0E:00000000
0F:00000000, 10:00000000, 11:00000000, 12:00000000, 13:00000000
14:00000000, 15:00000000, 16:00000000, 17:00000000, 18:00000000
P_Replies: Other:00000000, 01:00000000, 02:00000000, 03:00000000, 04:00000000
05:00000000, 06:00000000, 07:00000000, 08:00000000, 09:00000000
0A:00000000, 0B:00000000, 0C:00000000, 0D:00000000, 0E:00000000
0F:00000000, 10:00000000, 11:00000000, 12:00000000, 13:00000000
14:00000000, 15:00000000, 16:00000000, 17:00000000, 18:00000000
Rcvd: 0 packets, 0 bytes, 0 format errors, 0 not enabled,
0 local dst, 0 bcast, 0 forwarded,
0 checksum errors, 0 IP unknown, 0 IPX unknown
0 bcast forwarded, 0 bcast helpered, 0 dup bcast
0 unicast, 0 bcast, 0 forwarded
0 encap failed, 0 access failed, 0 down
0 bcast fwd, 0 not fwd (toward source)
0 notlan, 0 not gt4800, 0 no pp charge
ARPv0: Rcvd 0/0/0/0/0, Sent 0/0/0/0
ARPv1: Rcvd 0/0/0/0/0, Sent 0/0/0/0
ICP: Rcvd 0/0/0, Send 0/0
RTPv0: Rcvd 0/10/0/0/0/0/0/0, Sent 0/0/00/0/0/0/0
RTPv1: Rcvd 0/0/0/0/0/0, Sent 0/3/60/0
Table 16 describes the fields shown in the display.
Table 16 show vines traffic Field Descriptions
Field
|
Description
|
SYSTEM TRAFFIC:
|
This section displays statistics about all VINES packets handled by Cisco IOS software.
|
Rcvd:
|
This section displays statistics about VINES packets received by the software.
|
packets
|
Total number of VINES packets received.
|
bytes
|
Total bytes in all the VINES packets received.
|
format errors
|
Number of VINES packets that had errors in the format of the VINES IP header. Currently, the only thing checked is the length field in the header. The number of packets with format errors is included in the count of total packets received (in the Rcvd: field).
|
not enabled
|
Number of VINES packets received on an interface on which VINES was not enabled. These packets are not included when counting the total packets received (in the Rcvd: field).
|
local dst
|
Number of packets accepted for further processing because they were addressed to the router's unicast address.
|
bcast
|
Number of packets accepted for further processing because they were addressed to the router's broadcast address.
|
forwarded
|
Number of packets not accepted for further processing but that were simply forwarded out another interface.
|
no route
|
Number of packets discarded because Cisco IOS software did not know how to reach the destination.
|
zero hops
|
Number of packets discarded because the hop count field in the VINES IP header was zero.
|
checksum errors
|
Number of packets accepted for further processing (the sum of the "local dest" and "bcast" fields) that were discarded because the checksum was bad.
|
IP unknown
|
Number of packets accepted (the sum of the "local dest" and "bcast" fields) that were discarded because the VINES IP protocol type was unknown
|
IPC unknown
|
Number of packets accepted for further processing (the sum of the "local dest" and "bcast" fields) that were discarded because the IPC port number was unknown.
|
bcast forwarded
|
Number of broadcast packets accepted for further processing (as shown in the "bcast" field) that were forwarded because they had a nonzero hop count. (Note that the sum of the "bcast forwarded," "bcast helpered," and "dup bcast" fields will not equal the total number of broadcast packets received.)
|
bcast helpered
|
Number of broadcast packets accepted (as shown in the "bcast" field) that were "helpered" to a Banyan server. (Note that the sum of the "bcast forwarded," "bcast helpered," and "dup bcast" fields will not equal the total number of broadcast packets received.)
|
dup bcast
|
Number of broadcast packets accepted (as shown in the "bcast" field) that were classified as duplicates and discarded. (Note that the sum of the "bcast forwarded," "bcast helpered," and "dup bcast" fields will not equal the total number of broadcast packets received.)
|
Sent:
|
This section displays statistics about VINES packets sent by the router.
|
packets
|
Total number of VINES packets sent.
|
bytes
|
Total bytes in all the VINES packets sent.
|
unicast
|
Number of unicast packets originating at the router.
|
bcast
|
Number of broadcast packets originating at the router.
|
forwarded
|
Number of unicast packets that were forwarded from another interface.
|
encap failed
|
Number of packets not sent because of an encapsulation failure. This usually happens when entries in a map for a public data network, such as X.25 or Frame Relay, are missing.
|
access failed
|
Number of packets not sent because the destination was denied by an access list.
|
down
|
Number of packets not sent because the interface was down.
|
bcast fwd
|
Number of broadcast packets that were forwarded from another interface.
|
not fwd (toward source)
|
Number of broadcast packets that were not forwarded because this interface is the interface on which the broadcast was received.
|
not lan
|
Number of broadcast packets that were not forwarded because they were marked for LANs only and this interface is not a LAN (for example, it might be a serial interface.)
|
not gt
|
Number of broadcast packets that were not forwarded because they were marked for high-speed interfaces only and this interface is a low-speed interface (line speed of 4800 baud or less).
|
no pp charge
|
Number of broadcast packets that were not forwarded because they were marked to send only to networks that do not have per-packet charging and this interface is to a network that has per-packet charging.
|
ARPv0:
|
This section displays statistics about VINES ARP packets sent and received.
|
Rcvd x/x/x/x/x
|
Number of ARP packets received of type 0, 1, 2, 3, and other.
|
Sent x/x/x/x
|
Number of ARP packets sent of type 0, 1, 2, and 3.
|
ARPv1:
|
This section displays statistics about VINES SARP packets sent and received.
|
Rcvd x/x/x/x/x
|
Number of SARP packets received of type 0, 1, 2, 3, and other.
|
Sent x/x/x/x
|
Number of SARP packets sent of type 0, 1, 2, and 3.
|
ICP:
|
This section displays statistics about VINES ICP packets sent and received.
|
Rcvd x/x/x
|
Number of ICP packets received of type 0, 1, and other.
|
Sent x/x
|
Number of ICP packets sent of type 0 and 1.
|
IPC:
|
This section displays statistics about VINES IPC packets sent and received.
|
Rcvd
|
Number of IPC packets received.
|
Sent
|
Number of IPC packets sent.
|
RTPv0:
|
This section displays statistics about VINES RTP packets sent and received.
|
Rcvd x/x/x/x/x/x/x/x
|
Number of RTP packets received of type 0, 1, 2, 3, 4, 5, 6, and other. The counts of type 0, type 2, type 3, and other RTP packets should always be zero.
|
Sent x/x/x/x/x/x/x
|
Number of RTP packets sent of type 0, 1, 2, 3, 4, 5, and 6.
|
RTPv1:
|
This section displays statistics about VINES SRTP packets sent and received.
|
Rcvd x/x/x/x/x
|
Number of SRTP packets received of type 0, 1, 2, 3, and other. The count of other SRTP packets should always be zero.
|
Sent x/x/x/x/x
|
Number of SRTP packets sent of type 0, 1, 2, 3.
|
SPP:
|
This section displays statistics about VINES Sequence Packet Protocol (SPP) packets sent and received.
|
Rcvd
|
Number of SPP packets received
|
Sent
|
Number of SPP packets sent.
|
Echo:
|
This section displays statistics about VINES echo packets sent and received.
|
Rcvd
|
Number of MAC-level echo packets received.
|
Sent
|
Number of MAC-level echo packets sent.
|
Proxy:
|
This section displays statistics about VINES proxies sent and received. A proxy is when a client sends a query directly to the router for which the router does not have the intelligence to respond. Cisco IOS software then sends these queries to a Banyan server, and when it receives the response from the server, the software relays it back to the client.
|
Rcvd
|
Number of proxy queries received.
|
Sent
|
Number of proxy queries sent.
|
IPC TRAFFIC BY PORT NUMBER:
|
This section displays statistics about VINES IPC packets. The information displayed in this section is particularly useful when a serverless network is connected to the router.
|
Broadcast:
|
Number of VINES IPC messages, by destination port number, received by the router because they were addressed to the VINES IP broadcast address.
|
Helpered:
|
Number of broadcast messages that were sent toward a Banyan server because they were received on an interface for a serverless network.
|
Unicast:
|
Number of VINES IPC messages, by destination port number, received by the router because they were specifically addressed to the VINES IP address of the router.
|
Proxied:
|
Number of unicast messages received that were sent to a Banyan server because they were received on a serverless interface and because the router did not know how to respond to the message.
|
P_Replies:
|
Number of responses to a proxy query that were received from a Banyan server.
|
Interface
|
This section displays statistics about the individual interfaces in the router. The fields in this section have the same meanings as the fields of the same name in the "SYSTEM TRAFFIC" section, except that the statistics are for the particular interface, not for the entire router.
|
Related Commands
Command
|
Description
|
clear vines traffic
|
Clears all VINES-related statistics that are displayed by the show vines traffic command.
|
vines serverless
|
Configures a Banyan VINES network that does not have a server.
|
trace (VINES)
To determine the path that a packet takes when traversing a VINES network, use the trace command in EXEC mode.
trace [vines | oldvines] [address]
Syntax Description
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.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
10.3
|
The oldvines keyword was added.
|
Usage Guidelines
The trace EXEC command supports the Banyan traceroute function. This enables trace requests on a VINES network to reach all servers on the network.
This command does not produce the names of any VINES servers that are traversed.
Examples
The following is sample output from the trace (VINES) command when you specify the vines keyword:
Target Vines address: wayfinder
Source Vines address: coinspinner
From: 0002801578 Coinspinner To: 0002609380 Wayfinder
Server Gate metric media address
0002801578 Coinspinner 0805371606 Router 4 40 000030C0FEB6
0805371606 Router 0002609380 Wayfinder 2 2560 10005A746A36
The following is sample output from the trace (VINES) command when you specify the oldvines keyword:
Target vines address: 27AF92:1
Minimum Time to Live [0]:
Maximum Time to Live [15]:
Type escape sequence to abort.
Tracing the route to COINSPINNER (27AF92:1)
0 Farslayer (30002A2D:1) 0 msec 4 msec 4 msec
1 Coinspinner (27AF92:1) 4 msec 4 msec 8 msec
The route trace indicates the round-trip time for each probe, in milliseconds, for each node.
