cc/td/doc/product/software/ios113ed/113ed_cr/dial_r
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Virtual Template Interface Commands

Virtual Template Interface Commands

The Virtual Template Interface Service feature provides a generic service that can be used to apply predefined configurations (virtual template interfaces) in dynamically creating and freeing virtual access interfaces as needed.

This feature is supported on all platforms that support Multilink PPP.

For virtual template interface configuration tasks and examples, refer to the "Configuring Virtual Template Interfaces" chapter in the Dial Solutions Configuration Guide.

clear interface virtual-access

To tear down the virtual access interface and free the memory for other dial-in uses, use the clear interface virtual-access EXEC command.

clear interface virtual-access number
Syntax Description
number Number used to identify the virtual access interface.
Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 11.2 F.

This command does not free the memory for uses unrelated to dial-in access.

Example

The following example clears a specified virtual access interface. You can use the show interfaces virtual-access command to display the interface numbers before you clear any specific one.

clear interface virtual access 1
Related Commands

You can use the master indexes or search online to find documentation of related commands.

interface virtual-template

interface virtual-template

To create a virtual template interface that can be configured and applied dynamically in creating virtual access interfaces, use the interface virtual-template global configuration command.

interface virtual-template number
Syntax Description
number Number used to identify the virtual template interface.
Default

Disabled. No virtual template number is defined.

Command Mode

Global configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 11.2 F.

A virtual template interface is used to provide the configuration for dynamically created virtual access interfaces. It is created by users and can be saved in nonvolatile RAM (NVRAM).

Once the virtual template interface is created, it can be configured in the same way as a serial interface.

Virtual template interfaces can be created and applied by various applications such as Virtual Profiles, virtual private dialup networks (VPDN), PPP over ATM, protocol translation, and Multichassis Multilink PPP (MMP).

Example

The following example creates and configures virtual template interface 1:

interface virtual-template 1
 ip unnumbered ethernet 0
 ppp multilink
 ppp authentication chap 

show interfaces virtual-access

To display status, traffic data, and configuration information about a specified virtual access interface, use the show interfaces virtual-access EXEC command.

show interfaces virtual-access number [configuration]
Syntax Description
number Number of the virtual access interface.
configuration (Optional) Restricts output to configuration information.
Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 11.2 F.

Sample Display

The following is sample output of the show interfaces virtual-access EXEC command.

Router# show interfaces virtual-access 1 
Virtual-Access1 is up, line protocol is up 
  Hardware is Virtual Access interface
  Interface is unnumbered.  Using address of Ethernet0 (172.21.114.132)
  MTU 1500 bytes, BW 64 Kbit, DLY 100000 usec, rely 255/255, load 1/255
  Encapsulation PPP, loopback not set, keepalive set (10 sec)
  DTR is pulsed for 5 seconds on reset
  LCP Open, multilink Closed
  Open: IPCP, CDP
  Last input 5d04h, output never, output hang never
  Last clearing of "show interface" counters 00:06:42
  Queueing strategy: fifo
  Output queue 0/40, 0 drops; input queue 0/75, 0 drops
  5 minute input rate 0 bits/sec, 0 packets/sec
  5 minute output rate 0 bits/sec, 0 packets/sec
     76 packets input, 3658 bytes, 0 no buffer
     Received 0 broadcasts, 0 runts, 0 giants
     0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
     141 packets output, 2909 bytes, 0 underruns
     0 output errors, 0 collisions, 0 interface resets
     0 output buffer failures, 0 output buffers swapped out
     0 carrier transitions

Table 117 describes the fields in this output that are most significant to virtual access interfaces.


Table 117: Show Interfaces Virtual-Access Field Descriptions
Field Description
Virtual-Access1 is up, line protocol is up Virtual access interface is up and the line can be used.
Hardware is Virtual Access interface Hardware used for the incoming calls is not a static characteristic of virtual access interfaces.
Interface is unnumbered. Using address of Ethernet0 Virtual template interface cloned on this interface included the ip unnumbered ethernet 0 command.
Encapsulation PPP Virtual template interface cloned on this interface included the encapsulation ppp command.
LCP Open, multilink Closed Link Control Protocol has established a connection and the Opened state is in effect, but no Multilink PPP connection is established.
Open: IPCP, CDP Internet Protocol Control Protocol ahs reached the Opened state.

show ip interface virtual-access

To display network layer IP information about a specified virtual access interface, use the show ip interface virtual-access EXEC command.

show ip interface virtual-access number
Syntax Description
number Number of the virtual access interface.
Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 11.2 F.

Sample Display

The following is output from the show ip interface virtual-access command. This virtual access interface has been configured with a virtual template interface that applies the ip unnumbered ethernet 0 command.

Router# show ip interface virtual-access 1 
Virtual-Access1 is up, line protocol is up
  Interface is unnumbered. Using address of Ethernet0 (172.21.114.132)
  Broadcast address is 255.255.255.255 
  Peer address is 20.0.0.1 
  MTU is 1500 bytes 
  Helper address is not set 
  Directed broadcast forwarding is enabled 
  Outgoing access list is not set 
  Inbound  access list is Virtual-Access1#0 
  Proxy ARP is enabled 
  Security level is default 
  Split horizon is enabled
  ICMP redirects are always sent 
  ICMP unreachables are always sent 
  ICMP mask replies are never sent 
  IP fast switching is disabled 

Table 118 describes only the output fields that are significant to virtual access interfaces and not described in other IP commands.


Table 118: Show IP Interface Virtual-Access Field Descriptions
Field Description
Virtual-Access1 is up, line protocol is up Virtual access interface is up and the upper layers consider the line usable.
Interface is unnumbered. Using address of Ethernet0 (172.21.114.132) ip unnumbered ethernet 0 command was included in the virtual template interface cloned on this interface.

hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1997 © Cisco Systems Inc.