-
Cisco IOS Dial Services Command Reference, Release 12.1
-
About the Cisco IOS Software Documentation
-
Commands: A through B
-
Commands: C
-
Commands: D
-
Commands: E through IP
-
Commands IS through LAT
-
Commands: LC through MOD
-
Commands: MU through PPP
-
Commands: PRI through SGBP
-
Commands: SHOW A through E
-
Commands: SHOW I through L
-
Commands: SHOW M
-
Commands: SHOW N through X
-
Commands: SL through TN
-
Commands: TR through VIR
-
Commands: VPDN through X
- Appendixes
-
Index
-
Table Of Contents
slip
To start a serial connection to a remote host by using Serial Line Internet Protocol (SLIP), use the slip command in EXEC mode.
slip [/default] {remote-ip-address | remote-name} [@tacacs-server] [/routing]} [/compressed]
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
When you connect from a remote node computer to the EXEC facility on a router and want to connect from the router to a device on the network, issue the slip command.
If you specify an address for the TACACS server by using /default or tacacs-server options, the address must be the first parameter in the command after you enter slip. If you do not specify an address or enter /default, you are prompted for an IP address or host name. You can enter the /default keyword at this point.
If you do not use the tacacs-server argument to specify a TACACS server for SLIP address authentication, the TACACS server specified at login (if any) is used for the SLIP address query.
To optimize bandwidth on a line, SLIP enables compression of the SLIP packets using Van Jacobson TCP header compression as defined in RFC 1144.
Your system administrator must configure the system with the ip tcp header-compression passive command for the /compressed command option to be valid in EXEC mode. The ip tcp header-compression command forces header compression on or off. The default is to not compress the packets. The configuration file must have header compression on and the slip /compressed EXEC command must be entered for header compression to occur.
To terminate a session initiated with the slip command, disconnect from the device on the network using the command specific to that device. Then, exit from the EXEC by using the exit command.
Examples
The following example makes a connection when a default IP address is assigned. Once a correct password is entered, you are placed in SLIP mode, and the IP address is displayed.
router> slip Password:Entering SLIP mode.Your IP address is 192.31.7.28, MTU is 1524 bytesThe following example illustrates the prompts displayed and the response required when you use dynamic addressing to assign the SLIP address:
router> slip IP address or hostname? 192.31.6.15Password:Entering SLIP modeYour IP address is 192.31.6.15, MTU is 1524 bytesIn the preceding example, the address 192.31.6.15 has been assigned as the default. Password verification is still required before SLIP mode can be enabled.
router> slip /defaultPassword:Entering SLIP modeYour IP address is 192.31.6.15, MTU is 1524 bytesThe following example illustrates the implementation of header compression on the interface with the IP address 128.66.2.1:
router> slip 128.66.2.1 /compressedPassword:Entering SLIP mode.Interface IP address is 128.66.2.1, MTU is 1500 bytes.Header compression will match your system.In the preceding example, the interface is configured for the ip tcp header-compression passive command, which permits the user to enter the /compressed keyword at the EXEC mode prompt. The message "Header compression will match your system" indicates that the user specified compression. If the line was configured for the ip tcp header-compression on command, this line would read "Header compression is On."
The following example specifies a TACACS server named server1 for address authentication:
router> slip 1.0.0.1@server1Password:Entering SLIP mode.Interface IP address is 1.0.0.1, MTU is 1500 bytesHeader compression will match your system.snapshot client
To configure a client router for snapshot routing, use the snapshot client command in interface configuration mode. Use the no form of this command to disable a client router.
snapshot client active-time quiet-time [suppress-statechange-updates] [dialer]
no snapshot client active-time quiet-time [suppress-statechange-updates] [dialer]
Syntax Description
Defaults
Snapshot routing is disabled.
The active-time and quiet-time arguments have no default values.
Command Modes
Interface configuration
Command History
Usage Guidelines
The value of the active-time argument must be the same for the client and server routers.
To specify the remote server routers to be called by this client router during each active period, use the dialer map snapshot command.
Examples
The following example configures a client router for snapshot routing:
interface dialer 1snapshot client 5 600 suppress-statechange-updates dialerRelated Commands
snapshot server
To configure a server router for snapshot routing, use the snapshot server command in interface configuration mode. Use the no form of this command to disable a server router.
snapshot server active-time [dialer]
no snapshot server active-time [dialer]
Syntax Description
Defaults
Snapshot routing is disabled.
The active-time argument has no default value.
Command Modes
Interface configuration
Command History
Usage Guidelines
The value of the active-time argument must be the same for the client and server routers.
Examples
The following example configures a server router for snapshot routing:
interface dialer 1snapshot server 5Related Commands
show snapshot
Displays snapshot routing parameters associated with an interface.
snapshot client
Configures a client router for snapshot routing.
source template
To attach a configured customer profile template to a particular customer profile, use the source template command in customer profile configuration mode.
source template name
Syntax Description
Defaults
No templates are sourced or attached to a customer profile.
Command Modes
Customer profile configuration
Command History
Usage Guidelines
All PPP and peer-default commands are allowed for a particular customer profile template under this grouping.
Examples
The following example shows the creation and configuration of a customer profile template named acme-direct and its subsequent assignment to the customer profile acme1:
template acme-directmultilink {max-fragments num | max-links num | min-links num}peer match aaa-poolspeer default ip address pool acme-numbersppp ipcp dns 10.1.1.1 10.2.2.2ppp multilinkexitresource-pool profile customer acme1source template acme-directRelated Commands
template
Accesses the template configuration mode for configuring a particular customer profile template.
source-ip
To specify an alternate IP address for a Virtual Private Dialup Network (VPDN) tunnel that is different from the physical IP address used to open the tunnel, use the source-ip command in VPDN group configuration mode. To remove the alternate IP address, use the no form of this command.
source-ip ip-address
no source-ip
Syntax Description
ip-address
Alternate IP address (different from the physical IP address used to open the VPDN tunnel) that the router uses to identify the tunnel.
Defaults
Disabled
Command Modes
VPDN group configuration
Command History
Usage Guidelines
Each VPDN group on a router can be configured with a unique source-ip command.
Examples
The following example configures a LAC to accept L2TP dialout calls using the alternate IP address 172.23.33.7, which is different from the physical IP address used to open the L2TP tunnel:
vpdn-group 3accept-dialoutprotocol l2tpdialer 2terminate-from hostname orpheussource-ip 172.23.33.7Related Commands
spe
To access the SPE configuration mode and control the downloading of firmware into the modems, use the spe command in global configuration mode. There is no no version of this command.
spe {shelf/slot/module} {shelf/slot/module}
Syntax Description
Defaults
None
Command Modes
Global configuration
Command History
12.0(4)XI1
This command was introduced.
12.0(5)T
This document changed to reflect new information on the command.
Usage Guidelines
The spe global configuration command enables the SPE configuration mode. Configure your SPE by specifying a slot and an SPE associated with the slot; or, you can configure a range of SPEs by specifying the first and last SPE in the range. On AS5800 platforms, you must also specify the shelf associated with the slot and SPE.
When the access server is booted, the spe global configuration command specifies the location from where the firmware image is downloaded to the SPE. If the spe configuration command is used to download the firmware from flash memory and then subsequently the no version of the exact command is entered, then the spe command downloads the embedded firmware.
The spe command was first supported in Cisco IOS Release 12.0(4)XI1 along with the Resource Pool Management feature (although it can be used independently). For earlier images, use the copy command on the Cisco AS5200 and Cisco AS5300, and the modem-pool command on the Cisco AS5800. For the Cisco IOS Release 12.0(5)T images, the copy {flash | system | tftp} modem command will be disabled for firmware and newer version of Microcom modems (i.e., 56Kbps). Old V.34 Microcom modems still use the copy command for downloading in Cisco IOS Release 12.0(5)T images. For Cisco AS5800, downloading firmware through the modem-pool command is disabled.
Note
Use this command when traffic is low since the spe download does not begin until the modems have no active calls.
Note
Examples
The following example shows the spe command being used from global configuration mode to access the SPE configuration mode for the SPE range from 1/2 to 1/4:
spe 1/2 1/4Related Commands
spe recovery
To set a service processing element (SPE) port for recovery, use the spe recovery command in global configuration mode. To disable SPE recovery or to restore the default port-threshold value, use the no form of this command.
spe recovery {port-action {disable | recover} | port-threshold number-failures}
no spe recovery {port-action | port-threshold}
Syntax Description
Defaults
There is no default port-action value. SPE recovery is disabled.
The default port-threshold value is 30 failed attempts.Command Modes
Global configuration
Command History
12.1(1)XD
This command was introduced on the Cisco AS5400.
12.1(2.3)T1
This command was implemented on the Cisco AS5800.
Usage Guidelines
Failure of an SPE port to connect after repeated tries indicates that a problem exists in the SPE or firmware. An SPE port in this state is recovered by downloading firmware.
When an SPE port fails to connect consecutively for a number of times, as specified by the port-threshold number-failures keyword and argument, the SPE is moved to a state based on the port-action configuration.
If the spe recovery port-action recover command has been configured, when the port-threshold number-failures value is exceeded, the port is temporarily marked as disabled ("d" state) to avoid further incoming calls, and it is then marked for recovery ("r" state). Any SPE that has a port marked for recovery will download firmware when the SPE is idle (when none of the ports on the SPE have active calls).
If the spe recovery port-action disable command has been configured, when the port-threshold number-failures value is exceeded, the port is marked as bad ("BAD" state). An SPE with a port that is marked as bad must be explicitly cleared in order for that port to be used again.
If no port-action is configured, the port will be marked as not in use ("_" state). An SPE with a port marked as not in use will remain unusable until it is explicitly cleared, and the SPE will not accept incoming calls on any of the ports.
SPE recovery can be disabled by issuing the no spe recovery port-action command. If SPE recovery is disabled, the SPE will behave as if no port-action has been configured.
Note
Examples
The following example configures the SPE to recover ports that exceed the call failure threshold:
Router(config)# spe recovery port-action recoverThe following example sets a value of 50 for the number of consecutive failed attempts on the port before the port-action keyword is applied:
Router(config)# spe recovery port-threshold 50Related Commands
start-character
To set the flow control start character, use the start-character command in line configuration mode. Use the no form of this command to remove the character.
start-character ascii-number
no start-character
Syntax Description
Defaults
Decimal 17
Command Modes
Line configuration
Command History
Usage Guidelines
This command defines the character that signals the start of data transmission when software flow control is in effect. Refer to the "ASCII Character Set" appendix in the Cisco IOS Configuration Fundamentals Command Reference for a list of ASCII characters.
Examples
The following example changes the start character to Ctrl-B, which is decimal 2:
line 2start-character 2Related Commands
start-chat
To specify that a chat script start on a specified line at any point, use the start-chat command in privileged EXEC mode. Use the no form of this command to stop the chat script.
start-chat regexp [line-number [dialer-string]]
no start-chat
Syntax Description
Command Modes
Privileged EXEC
Command History
Usage Guidelines
This command provides modem dialing commands for a chat script that you want to apply immediately to a line. If you do not specify a line, the script runs on the current line. If the specified line is already in use, the script is not activated and an error message appears.
The argument regexp is used to specify the name of the modem script that is to be executed. The first script that matches the argument in this command and the dialer map command will be used. For more information about regular expressions, refer to the "Regular Expressions" appendix in this publication.
This command functions only on physical terminal (TTY) lines. It does not function on virtual terminal lines.
Examples
The following example forces a dialout on line 8 using the script telebit:
start-chat telebit line 8Related Commands
stop-character
To set the flow control stop character, use the stop-character command in line configuration mode. Use the no form of this command to remove the character.
stop-character ascii-number
no stop-character
Syntax Description
Defaults
Decimal 19
Command Modes
Line configuration
Command History
Usage Guidelines
This command defines the character that signals the end of data transmission when software flow control is in effect. Refer to the "ASCII Character Set" appendix in the Cisco IOS Configuration Fundamentals Command Reference for a list of ASCII characters.
Examples
The following example changes the stop character to Ctrl-E, which is decimal 5:
line 3stop-character 5Related Commands
telnet
To log in to a host that supports Telnet, use the telnet command in EXEC mode.
telnet host [port] [keyword]
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
Table 126 lists the optional telnet command keywords.
With the Cisco IOS implementation of TCP/IP, you are not required to enter the connect or telnet commands to establish a terminal connection. You can just enter the learned host name—as long as the following conditions are met:
•
•
To display a list of the available hosts, use the show hosts command. To display the status of all TCP connections, use the show tcp command.
The Cisco IOS software assigns a logical name to each connection, and several commands use these names to identify connections. The logical name is the same as the host name, unless that name is already in use, or you change the connection name with the name-connection EXEC command. If the name is already in use, the Cisco IOS software assigns a null name to the connection.
The Telnet software supports special Telnet commands in the form of Telnet sequences that map generic terminal control functions to operating system-specific functions. To issue a special Telnet command, enter the escape sequence and then a command character. The default escape sequence is Ctrl-^ (press and hold the Ctrl and Shift keys and the 6 key). You can enter the command character as you hold down Ctrl or with Ctrl released; you can use either uppercase or lowercase letters. Table 127 lists the special Telnet escape sequences.
Table 134 Special Telnet Escape Sequences
Ctrl-^ b
Break
Ctrl-^ c
Interrupt Process (IP)
Ctrl-^ h
Erase Character (EC)
Ctrl-^ o
Abort Output (AO)
Ctrl-^ t
Are You There? (AYT)
Ctrl-^ u
Erase Line (EL)
1 The caret (^) symbol refers to Shift-6 on your keyboard.
At any time during an active Telnet session, you can list the Telnet commands by pressing the escape sequence keys followed by a question mark at the system prompt:
Ctrl-^ ?
A sample of this list follows. In this sample output, the first caret (^) symbol represents the Ctrl key, while the second caret represents Shift-6 on your keyboard:
router> ^^?[Special telnet escape help]^^B sends telnet BREAK^^C sends telnet IP^^H sends telnet EC^^O sends telnet AO^^T sends telnet AYT^^U sends telnet ELYou can have several concurrent Telnet sessions open and switch back and forth between them. To open a subsequent session, first suspend the current connection by pressing the escape sequence (Ctrl-Shift-6 then x [Ctrl^x] by default) to return to the system command prompt. Then open a new connection with the telnet command.
To terminate an active Telnet session, enter any of the following commands at the prompt of the device to which you are connecting:
•
•
•
•
•
Examples
The following example establishes an encrypted Telnet session from a router to a remote host named host1:
router> telnet host1 /encrypt kerberosThe following example routes packets from the source system host1 to kl.sri.com, then to 10.1.0.11, and finally back to host1:
router> telnet host1 /route:kl.sri.com 10.1.0.11 host1The following example connects to a host with logical name host1:
router> host1The following example suppresses all onscreen messages from the Cisco IOS software during login and logout:
router> telnet host2 /quietThe following example shows the limited messages displayed when connection is done using the optional /quiet keyword:
login:User2Password:Welcome to OpenVMS VAX version V6.1 on node CRAWLast interactive login on Tuesday, 15-DEC-1998 11:01Last non-interactive login on Sunday, 3-JAN-1999 22:32Server3)logoutUser2 logged out at 16-FEB-2000 09:38:27.85Related Commands
telnet break-on-ip
To cause the system to generate a hardware BREAK signal on the EIA/TIA-232 line that is associated with a reverse Telnet connection when a Telnet Interrupt-Process command is received on that connection, use the telnet break-on-ip command in line configuration mode.
telnet break-on-ip
Syntax Description
This command has no arguments or keywords.
Defaults
No hardware Break signal is generated when an Interrupt-Process command is received.
Command Modes
Line configuration
Command History
Usage Guidelines
This command causes the system to generate a hardware BREAK signal on the RS-232 line that is associated with a reverse Telnet connection. It is useful when a Telnet Interrupt-Process command is received on that connection because it can control the translation of Telnet Interrupt-Process commands into X.25 BREAK indications. It is also a useful workaround in the following situations:
•
•
•
A hardware BREAK signal is generated when a Telnet BREAK command is received.
Examples
In the following example, line 5 is configured with the telnet break-on-ip command. The location text notes that this refers to the high-speed modem. The telnet transparent command sets end-of-line handling.
line 5location high-speed modemtelnet transparenttelnet break-on-ipRelated Commands
telnet refuse-negotiations
To set a line using Telnet to refuse to negotiate full-duplex, remote echo requests on incoming connections, use the telnet refuse-negotiations command in line configuration mode.
telnet refuse-negotiations
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Line configuration
Command History
Usage Guidelines
Use this command on reverse Telnet connections to allow the Cisco IOS software to refuse full-duplex, remote echo option connection requests from the other end. This command suppresses negotiation of the Telnet Remote Echo and Suppress Go Ahead options.
This command does not apply to protocol translation configurations. It is intended for applications wherein the router is functioning as a terminal server to allow terminal connections to remote devices through the asynchronous terminal ports of the router. Terminal server connections are those where the user types a command similar to the following to access network resources:
telnet access-server 2005
where access-server is the host name of the Cisco router functioning as a terminal server, and 2005 is the port number on the router to which the remote terminal is connected.
Examples
The following example shows how to set line 5 to refuse full-duplex, remote echo requests:
line 5telnet refuse-negotiationsRelated Commands
telnet speed
To allow the Cisco IOS software to negotiate transmission speed of the line to a connected device, use the telnet speed command in line configuration mode.
telnet speed default-speed maximum-speed
Syntax Description
Defaults
No default behavior or values.
Command Modes
Line configuration
Command History
Usage Guidelines
Negotiates speeds on reverse Telnet lines. You can match line speeds on remote systems in reverse Telnet, on host machines hooked up to a router used to access the network, or on a group of console lines hooked up to the router, when disparate line speeds are in use at the local and remote ends of the connection. Line speed negotiation adheres to the Remote Flow Control option, defined in RFC 1080.
Examples
The following example allows a router to negotiate a bit rate on the line using the Telnet option. If no speed is negotiated, the line will run at 2400 bits per second. If the remote host requests a speed of greater than 9600 bps, then 9600 will be used.
line 5telnet speed 2400 9600Related Commands
telnet sync-on-break
To configure the Cisco IOS software to cause an incoming connection to send a Telnet Synchronize signal when it receives a Telnet BREAK signal, use the telnet sync-on-break command in line configuration mode.
telnet sync-on-break
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Line configuration
Command History
Usage Guidelines
This command causes a reverse Telnet line to send a Telnet Synchronize signal when it receives a Telnet BREAK signal. This option is used very rarely to ensure the ordering of BREAK reception with respect to data characters sent after the BREAK.
Examples
The following example configures line 8 with the telnet sync-on-break command:
line aux 0telnet sync-on-breakRelated Commands
telnet transparent
To configure the Cisco IOS software to send a CARRIAGE RETURN (CR) as a CR followed by a NULL instead of a CR followed by a LINE FEED (LF), use the telnet transparent command in line configuration mode.
telnet transparent
Syntax Description
This command has no arguments or keywords.
Defaults
CARRIAGE RETURN followed by a LINE FEED.
Command Modes
Line configuration
Command History
Usage Guidelines
This command is useful for coping with different interpretations of end-of-line handling in the Telnet protocol specification.
Examples
The following example causes the Cisco IOS software, when sending a CR, to send a CR followed by a NULL character:
line 7telnet transparentRelated Commands
template
To access the template configuration mode for configuring a particular customer profile template, use the template command in global configuration mode. Use the no form of this command to delete the template of the specified name.
template name {
