cc/td/doc/product/software/ios121/121cgcr/apollo_r
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Banyan VINES Commands

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. Media Access Control (MAC)-level echo support is also available for Ethernet, IEEE 802.2, Token Ring, and Fiber Distributed Data Interface (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 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:

clear vines cache 
 

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 the 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:

clear vines ipc 1D

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:

clear vines neighbor *

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 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 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:

clear vines route *

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:

clear vines traffic 

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
 
Vines access list 1
 deny   SPP 30015800:0001 00000000:00000000 202 00123456:8005 00000000:0000 249
 permit IP 00000000:0000 FFFFFFFF:FFFF 00000000:0000 FFFFFFFF:FFFF
Vines access list 101
 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.

Router# show vines cache
 
VINES fast switching cache information:
  Current: 0 entries, 0 paths
  History:
      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:

Router# show vines host
 
Name          Address
Router1       0027AF9A:0001
Router2       0027D0E4:0001
Router3       002ABFAA:0001
Router4       30015800:0001
 

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 the 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
  Roll Call timer queue:
   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)
  Split horizon is enabled
  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
  Neighbors: none.
 

Table 10 describes the fields that may be 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 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:

Router# show vines ipc
 
Vines IPC Status:
 
Next Port: 513
Next Connection: 3
Next check in: 27 sec
 
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
 Idle check in 0 sec
 Retransmit queue contains 0 packets
 No packet in reassembly
 

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 the 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
Router2        -                  -     -      C1   -        -      -
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
 
  RTP Counters:
 
    Interface Ethernet2, address Router3-Et2-0000.0c01.24ea
      Timers:
        Roll Call: 00:03:00
      Received counters:
        Requests:   00000000
        Responses:  00000000
        Updates:    00000000
        Redirects:  00000000
        Unknown:    00000000

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.

Router# show vines route
 
Worf              Worf              R0*       2       2      0
Succubus          Succubus          R1*       2       2      0
Aloe              -                 C1        -       -      -
Vera              Vera              R0*       2       2      0
Falcon            Falcon            R0*       2       2      0
Zangbutt          Worf              R0*       2       4      0
Zangbutt          Vera              R0        2       4      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
 
Vines Files Service:
    Name:     FS@Doc-ags+1@Servers (FS)
    Ports:    Well Known 6, Transient 0
    Timer:    not running
 
Network & System Management Service:
    Name:     NSM@Doc-ags+1@Servers (NSM)
    Ports:    Well Known 25, Transient 0
    Timer:    not running
 
Server Service:
    Name:     SS@Doc-ags+1@Servers (SS)
    Ports:    Well Known 7, Transient 0
    Emulates: 5.50(0), Supports: 3.22(49) - 6.99(49)
    Timer:    not running
 
VINES Security Service:
    Name:     VS@Doc-ags+1@Servers (VS)
    Ports:    Well Known 19, Transient 0
    Timer:    not running
 

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
 
Vines Files Service:
  Periodic timer not running.
 
Router# show vines service nsm
 
Network & System Management Service:
  Next wakeup in 00:00:29.
 
Router# show vines service ss
 
Server Service:
  Next wakeup in 00:20:04.
  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.
  Configuration:
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
 
VINES Security Service:
  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 the 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
 
SYSTEM TRAFFIC:
  Rcvd: 204 total, 12708 bytes, 0 format errors, 0 not enabled,
        15 local dst, 189 bcast, 0 forwarded
        0 no route, 0 zero hops
        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
     IPC: Rcvd 17, Sent 8
   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
     SPP: Rcvd 0, Sent 0
    Echo: Rcvd 5, Sent 5
   Proxy: Rcvd 0, Sent 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
              19: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
              19: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
              19: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
              19: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
              19:00000000
 
Interface Hssi0:
  Rcvd: 0 packets, 0 bytes, 0 format errors, 0 not enabled,
        0 local dst, 0 bcast, 0 forwarded,
        0 no route, 0 zero hops
        0 checksum errors, 0 IP unknown, 0 IPX unknown
        0 bcast forwarded, 0 bcast helpered, 0 dup bcast
  Sent: 0 packets, 0 bytes
        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
     IPC: Rcvd 0, Sent 8
   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
     SPP: Rcvd 0, Sent 0
    Echo: Rcvd 0, Sent 0
   Proxy: Rcvd 0, Sent 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 the 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 the 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. The 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:

Router# trace vines
 
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:

Router# trace oldvines
 
Target vines address: 27AF92:1
Numeric display [n]:
Timeout in seconds [3]:
Probe count [3]:
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.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Fri Mar 17 08:20:40 PST 2000
Copyright 1989 - 2000©Cisco Systems Inc.