Interface Commands

This chapter describes the function and displays the syntax of each interface command. For more information about defaults and usage guidelines, see the corresponding chapter of the Router Products Command Reference publication.

To assign the interface address that is used by the device connecting to the router via PPP or SLIP, unless you override the address at the command line, use the async default ip address interface configuration command. Use the no form of the command to remove the address from your configuration.

To specify an address on an asynchronous interface (rather than using the default address), use the async dynamic address interface configuration command. Use the no form of this command to disable dynamic addressing.

To implement asynchronous routing on an interface, use the async dynamic routing interface configuration command. The no form of this command disables use of routing protocols; static routing will still be used.

To place a line into network mode using SLIP or PPP encapsulation, use the async mode dedicated interface configuration command. The no form of this command returns the line to interactive mode.

To enable the slip and ppp EXEC commands, use the async mode interactive line configuration command. Use the no form of this command to prevent users from implementing SLIP and PPP at the EXEC level.

atm-dxi map protocol address vpi vci [broadcast]
no atm-dxi map protocol address

To map a given VPI and VCI to a DXI frame address, use the atm-dxi map interface configuration command. Use the no form of this command to remove the definition.

protocol	Specifies the protocol: apollo, appletalk, bridge, clns, decnet, ip, ipx, vines, xns.
address	Protocol-specific address.
vpi	Specifies the Virtual Path Identifier in the range 0 to 15.
vci	Specifies the Virtual Circuit Identifier in the range 0 to 63.
broadcast	(Optional) Broadcasts should be forwarded to this address.

To enable automatic receiver polarity reversal on a hub port connected to an Ethernet interface of a Cisco 2505 or Cisco 2507, use the auto-polarity hub configuration command. To disable this feature, use the no form of this command.

[no] backup delay {enable-delay | never} {disable-delay | never}

To define how much time should elapse before a secondary line is set up or taken down after a primary line transition, use the backup delay interface configuration command. Use the no form of this command to remove the definition.

enable-delay	Integer that specifies the delay in seconds after the primary line goes down before the secondary line is activated.
never	Prevents the secondary line from being activated.
disable-delay	Integer that specifies the delay in seconds after the primary line goes up before the secondary line is deactivated.
never	Prevents the secondary line from being deactivated.

[no] backup interface interface-name
[no] backup interface interface-name slot/port
(for the Cisco 7000 series)

To configure the serial interface as a secondary, or dial backup line, use the backup interface interface configuration command. Use the no form of this command with the appropriate serial port designation to disable this feature.

To set the traffic load thresholds for dial backup service, use the backup load interface configuration command. Use the no form of this command to remove the setting.

enable-threshold	Integer that specifies a percentage of the primary line's available bandwidth.
never	Sets the secondary line to never be activated due to load.
disable-load	Integer that specifies a percentage of the primary line's available bandwidth.
never	Sets the secondary line to never be deactivated due to load.

To set a bandwidth value for an interface, use the bandwidth interface configuration command. Use the no form of this command to restore the default values.

Use the channel-group controller configuration command to define the timeslots that belong to each T1 circuit.

number	Channel-group number. When configuring a T1 data line, channel-group numbers can be a value from 0 to 23. When configuring an E1 data line, channel-group numbers can be a value from 0 to 29.
timeslots range	Timeslot or range of timeslots belonging to the channel-group. The first timeslot is numbered 1. For a T1 controller, the timeslot range is from 1 to 24. For an E1 controller, the timeslot range is from 1 to 31.
speed {48 \| 56 \| 64}	(Optional) Specifies the line speed (in kilobits per second) of the T1 or E1 link.

clear controller lex number [prom]
clear controller lex slot/port [prom] (for the Cisco 7000 series)

To reboot the LAN Extender and restart its operating software, use the clear controller lex privileged EXEC command.

number	Number of the LAN Extender interface corresponding to the LAN Extender to be rebooted.
prom	(Optional) Forces a reload of the PROM image, regardless of any Flash image.
slot	On the Cisco 7000 series, specifies the backplane slot number. On the Cisco 7000, the value can be 0, 1, 2, 3, or 4. On the Cisco 7010, the value can be 0, 1, or 2.
port	On the Cisco 7000 series, specifies the port number of the interface. The value can be 0, 1, 2, or 3 for the serial interface.

Use the clear controller t1 EXEC command to reset the T1 controller interface on the Cisco 7000.

clear counters [type number] [ethernet | serial]
clear counters [type slot/port] [ethernet | serial] (for the Cisco 7000
series)

type	(Optional) Specifies the interface type; it is one of the keywords listed in the "Clear Counters Interface Type Keywords" table.
number	(Optional) Specifies the interface counter displayed with the show interfaces command.
ethernet	(Optional) If the type is lex, you can clear the interface counters on the Ethernet interface.
serial	(Optional) If the type is lex, you can clear the interface counters on the serial interface.
slot	(Optional) On the Cisco 7000 series, specifies the backplane slot number. On the 7000, value can be 0, 1, 2, 3, or 4. On the 7010, value can be 0, 1, or 2.
port	(Optional) On the Cisco 7000 series, specifies the port number of the interface. Value can be 0, 1, 2, or 3 for the serial interface.

To reset and reinitialize the hub hardware connected to an interface of a Cisco 2505 or Cisco 2507, use the clear hub EXEC command.

To set to zero the hub counters on an interface of a Cisco 2505 or Cisco 2507, use the clear hub counters EXEC command.

ether	(Optional) Indicates the hub in front of an Ethernet interface.
number	(Optional) Hub number for which to clear counters. Since there is currently only one hub, this number is 0. If the keyword ether is specified, the number is required.
port	(Optional) Port number on the hub. On the Cisco 2505, port numbers range from 1 through 8. On the Cisco 2507, port numbers range from 1 through 16. If a second port number follows, then this port number indicates the beginning of a port range. If no port number is specified, counters for all ports are cleared.
end-port	(Optional) Ending port number of a range.

clear interface type number
clear interface type slot/port (on a Cisco 7000 series)
clear interface type slot/port [:channel-group] (on a Cisco 7000 series
MIP T1 interface)

To reset the hardware logic on an interface, use the clear interface EXEC command.

type	Specifies the interface type; it is one of the keywords listed in the "Interface Type Keywords" table of the Router Products Command Reference publication.
number	Specifies the port, connector, or interface card number.
slot	In a Cisco 7000, specifies the backplane slot number and can be 0, 1, 2, 3, or 4. In a Cisco 7010, the value can be 0, 1, or 2.
port	On a Cisco 7000 series, specifies the port number of the interface and can be 0, 1, 2, 3, 4 or 5 depending on the type of interface, as follows: AIP (ATM Interface Processor)—0 EIP (Ethernet Interface Processor)—0, 1, 2, 3, 4, or 5 FIP (FDDI Interface Processor)—0 HIP (HSSI Interface Processor)—0 TRIP (Token Ring Interface Processor)—0, 1, 2, or 3
:channel- group	(Optional) On the Cisco 7000 series supporting Channelized T1, specifies the channel in the range of 0 to 23.

To clear entries from the Routing Information Field (RIF) cache, use the clear rif-cache EXEC command.

To configure the clock rate for appliques (connector hardware) on the serial interface of the MCI and SCI cards to an acceptable bit rate, use the clock rate interface configuration command. Use the no clock rate command to remove the clock rate if you change the interface from a DCE to a DTE device.

Use the clock source controller configuration command to set the T1-line clock-source for the MIP in the Cisco 7000 series.

To control which clock a G.703-E1 interface will use to clock its transmitted data from, use the clock source interface configuration command. The no form of this command restores the default value.

To start the processes that perform the connection management (CMT) function and allow the ring on one fiber to be started, use the cmt connect EXEC command.

To stop the processes that perform the connection management (CMT) function and allow the ring on one fiber to be stopped, use the cmt disconnect EXEC command.

To configure point-to-point software compression for LAPB, HDLC, or PPP, use the compress interface configuration command. To disable compression, use the no form of this command.

To configure a T1 or E1 controller and enter controller configuration mode, use the controller global configuration command. This command is used only on a Cisco 7000.

t1	T1 controller.
e1	E1 controller.
slot	Backplane slot number; can be 0, 1, 2, 3, or 4. On the 7010, the slot number can be 0, 1, or 2. The slots are numbered from left to right.
port	Port number of the interface. It can be 0 or 1 for the MIP (MultiChannel Interface Processor). Ports on each interface processor are numbered from the top down.

To download an executable image from Flash memory on the core router to the LAN Extender, use the copy flash lex privileged EXEC command.

To download an executable image from a TFTP server to the LAN Extender, use the copy tftp lex privileged EXEC command.

To set the length of the cyclic redundancy check (CRC) on a Fast Serial Interface Processor (FSIP) of the Cisco 7000 series, use the crc interface configuration command. To set the CRC length to 16 bits, use the no form of this command.

To enable generation of the G.703-E1 CRC4, use the crc4 interface configuration command. To disable this feature, use the no form of this command.

When running a line at high speeds and long distances, use the dce-terminal-timing enable interface configuration command to prevent phase shifting of the data with respect to the clock. If SCTE is not available from the DTE, use the no form of this command, which causes the DCE to use its own clock instead of SCTE from the DTE.

To set a delay value for an interface, use the delay interface configuration command. Use the no form of this command to restore the default delay value.

To add a description to a T1 or E1 controller on a Cisco 7000 series router, use the description controller configuration command. Use the no form of this command to remove the description.

To add a description to an interface configuration, use the description interface configuration command. Use the no form of this command to remove the description.

To configure an interface to inform the system it is down when loopback is detected, use the down-when-looped interface configuration command.

On the Cisco 4000 platform, you can specify the serial Network Interface Module timing signal configuration. When the board is operating as a DTE, the dte-invert-txc command inverts the TXC clock signal it gets from the DCE that the DTE uses to transmit data. Use the no form of this command if the DCE accepts SCTE from the DTE.

To enable early token release, a method whereby the Token Ring interfaces can release the token back onto the ring immediately after transmitting rather than waiting for the frame to return, use the early-token-release interface configuration command. This feature helps increase the total bandwidth of the Token Ring.

The CSC-C2CTR, CSC-R16 (or CSC-R16M),CSC-2R, and CSC-1R cards and the Token Ring Interface Processor (TRIP) on the Cisco 7000 all support early token release. Once enabled, use the no form of this command to disable this feature.

To set the encapsulation method used by the interface, use the encapsulation interface configuration command.

Use the encapsulation atm-dxi interface configuration command to enable ATM-DXI encapsulation. The no encapsulation atm-dxi command disables ATM-DXI encapsulation.

To allow the FCI card to preallocate buffers to handle bursty FDDI traffic (for example, NFS bursty traffic), use the fddi burst-count interface configuration command. Use the no form of this command to revert to the default value.

To set the C-Min timer on the PCM, use the fddi c-min interface configuration command. Use the no form of this command to revert to the default value.

To control the information transmitted during the connection management (CMT) signaling phase, use the fddi cmt-signal-bits interface configuration command. If neither the phy-a nor phy-b keyword is specified, the signal bits apply to both physical connections.

signal-bits	A hexadecimal number preceded by 0x; for example, 0x208. The FDDI standard defines ten bits of signaling information that must be transmitted, as follows: bit 0—Escape bit. Reserved for future assignment by the FDDI standards committee. bits 1 and 2—Physical type, as defined in "FDDI Physical Type Bit Specifications" table of the Router Products Command Reference publication. bit 3—Physical compatibility. Set if topology rules include the connection of a physical-to-physical type at the end of the connection. bits 4 and 5—Link Confidence test duration; set as defined in the "FDDI Link Confidence Test Duration Bit Specification" table of the Router Products Command Reference publication.
signal-bits (continued)	bit 6—Media Access Control (MAC) available for link confidence test. bit 7—Link confidence test failed. The setting of bit 7 indicates that the link confidence was failed by the Cisco end of the connection. bit 8—MAC for local loop. bit 9—MAC on physical output.
phy-a	(Optional) Selects Physical Sublayer A.
phy-b	(Optional) Selects Physical Sublayer B.

To enable the duplicate address detection capability on the FDDI, use the fddi duplicate-address-check interface configuration command. Use the no form of this command to disable this feature.

To specify encapsulating bridge mode on the CSC-C2/FCIT interface card, use the fddi encapsulate interface configuration command. Use the no form of this command to turn off encapsulation bridging and return the FCIT interface to its translational, nonencapsulating mode.

To enable the SMT frame processing capability on the FDDI, use the fddi smt-frames interface configuration command. Use the no form of this command to disable this feature, in which case the router will not generate or respond to SMT frames.

To set the TB-Min timer in the physical connection management (PCM), use the fddi tb-min interface configuration command. Use the no form of this command to revert to the default value.

To control the TL-Min time (the minimum time to transmit a Physical Sublayer, or PHY line state, before advancing to the next physical connection management (PCM) state, as defined by the X3T9.5 specification), use the fddi tl-min-time interface configuration command.

To control ring scheduling during normal operation and to detect and recover from serious ring error situations, use the fddi token-rotation-time interface configuration command.

To set the timeout timer in the physical connection management (PCM), use the fddi t-out interface configuration command. Use the no form of this command to revert to the default value.

To recover from a transient ring error, use the fddi valid-transmission-time interface configuration command.

Use the framing controller configuration command to select the frame type for the T1 or E1 data line.

sf	Specifies super frame as the T1 frame type.
esf	Specifies extended super frame as the T1 frame type.
crc4	Specifies CRC4 frame as the E1 frame type.
no-crc4	Specifies no CRC4 frame as the E1 frame type.

To specify the hold-queue limit of an interface, use the hold-queue interface configuration command. Use the no form of this command with the appropriate keyword to restore the default values for an interface.

length	Integer that specifies the maximum number of packets in the queue. Default input hold-queue limit is 75 packets. Default output hold-queue limit is 40 packets.
in	Specifies the input queue.
out	Specifies the output queue.

To allow the router to support a CSU/DSU that uses the LC signal to request a loopback from the router, use the hssi external-loop-request interface configuration command. Use the no form of this command to disable the feature.

To convert the HSSI interface into a 45-MHz clock master, use the hssi internal-clock interface configuration command. Use the no form of this command to disable the clock master mode.

To enable and configure a port on an Ethernet hub of a Cisco 2505 or Cisco 2507, use the hub global configuration command.

ethernet	Indicates that the hub is in front of an Ethernet interface.
number	Hub number, starting with 0. Since there is currently only one hub, this number is 0.
port	Port number on the hub. On the Cisco 2505, port numbers range from 1 through 8. On the Cisco 2507, port numbers range from 1 through 16. If a second port number follows, then the first port number indicates the beginning of a port range.
end-port	(Optional) Last port number of a range.

interface type number
interface type slot/port (for the Cisco 7000 series)
interface type slot/port:channel-group
(for channelized T1 on the Cisco 7000 series)

interface type number.subinterface-number [multipoint |
point-to-point]
interface type slot/port.subinterface-number [multipoint |
point-to-point] (for the Cisco 7000 series)

To configure an interface or subinterface type and enter interface configuration mode, use the interface global configuration command.

type	Type of interface to be configured. See the "Interface Type Keywords" table of the Router Products Command Reference publication.
number	Port, connector, or interface card number. The numbers are assigned at the factory at the time of installation or when added to a system, and can be displayed with the show interfaces command.
slot	On the Cisco 7000 series, specifies the backplane slot number; can be 0, 1, 2, 3, or 4 on the Cisco 7000. On the Cisco 7010, can be 0, 1, or 2. The slots are numbered from left to right.
port	On the Cisco 7000 series, specifies the port number of the interface. It can be 0, 1, 2, 3, 4, or 5 depending on the type of interface, as follows: AIP (ATM Interface Processor)—0 EIP (Ethernet Interface Processor)—0, 1, 2, 3, 4, or 5 FIP (FDDI Interface Processor)—0 FSIP (Fast Serial Interface Processor)—0, 1, 2, or 3 HIP (HSSI Interface Processor)—0 TRIP (Token Ring Interface Processor)—0, 1, 2, or 3 Ports on each interface processor are numbered from the top down.
channel-group	On the Cisco 7000, specifies the T1 circuit number in the range of 0 to 23 defined with the channel-group controller configuration command.
.subinterface-number	Subinterface number in the range 1 to 4294967293. The number that precedes the period (.) must match the number this subinterface belongs to.
multipoint \| point-to-point	(Optional) Specifies a multipoint or point-to-point subinterface. The default is multipoint.

Delays between the SCTE clock and data transmission indicate that the transmit clock signal might not be appropriate for the interface rate and length of cable being used. Different ends of the wire may have variances that differ slightly. To invert the clock signal to compensate for these factors, use the invert-transmit-clock interface configuration command. This command applies to the Cisco 7000 series.

To make temporary IP addresses available for dial-in asynchronous clients using Serial Line Internet Protocol (SLIP)/PPP, use the ip address-pool global configuration command. Use the no form of the command to disable IP address pooling on all interfaces.

ip dhcp-server [ip-address | name]
no ip dhcp-server [ip-address | name]

To specify which Dynamic Host Configuration Protocol (DHCP) servers to use on your network, specify the IP address of one or more DHCP servers available on the network by using the ip dhcp-server global configuration command. Use the no form of the command to remove a DHCP server's IP address.

Use the keepalive interface configuration command to set the keepalive timer for a specific interface. The no form of this command turns off keepalives entirely.

To set the burned-in MAC address for a LAN Extender interface, use the lex burned-in-address interface configuration command. To clear the burned-in MAC address, use the no form of this command.

To assign an access list that filters on MAC addresses, use the lex input-address-list interface configuration command. To remove an access list from the interface, use the no form of this command.

To assign an access list that filters Ethernet packets by type code, use the lex input-type-list interface configuration command. To remove an access list from the interface, use the no form of this command.

To activate priority output queuing on the LAN Extender, use the lex priority-group interface configuration command. To disable priority output queuing, use the no form of this command.

To define the number of times to resend commands to the LAN Extender, use the lex retry-count interface configuration command. To return to the default value, use the no form of this command.

To define the amount of time to wait for a response from the LAN Extender, use the lex timeout interface configuration command. To return to the default time, use the no form of this command.

Use the linecode controller configuration command to select the line-code type for the T1 or E1 line.

ami	Specifies alternate mark inversion (AMI) as the line-code type. Valid for T1 or E1 controllers.
b8zs	Specifies B8ZS as the line-code type. Valid for T1 controller only.
hdb3	Specifies high-density bipolar 3 (hdb3) as the line-code type. Valid for E1 controller only.

To re-enable the link test function on a port on an Ethernet hub of a Cisco 2505 or Cisco 2507, use the link-test hub configuration command. Disable this feature if a pre-10BaseT twisted-pair device not implementing link test is connected to the hub port with the no form of this command.

To enable Lanoptics Hub Networking Management of a PCbus Token Ring interface, use the local-lnm command. Use the no form of this command to disable management.

To diagnose equipment malfunctions between interface and device, use the loopback interface configuration command. The no form of this command disables the test.

To configure an internal loop on the HSSI applique, use the loopback applique interface configuration command. To remove the loop, use the no form of this command.

To loop packets to DTE internally within the CSU/DSU at the DTE interface, when the device supports this feature, use the loopback dte interface configuration command. To remove the loop, use the no form of this command.

To loop packets completely through the CSU/DSU to configure the CSU loop, when the device supports this feature, use the loopback line interface configuration command. To remove the loop, use the no form of this command.

To loop packets at the router physical interface on a T1 line, use the loopback local controller configuration command. To remove the loop, use the no form of this command.

To loop packets completely through the CSU/DSU, over the DS3 link, to the remote CSU/DSU and back, use the loopback remote controller configuration command. To remove the loop, use the no form of this command.

To specify the Ethernet Network Interface Module configuration on the Cisco 4000 series, use the media-type interface configuration command.

To enable an interface to support the Maintenance Operation Protocol (MOP), use the mop enabled interface configuration command. To disable MOP on an interface, use the no form of this command.

To enable an interface to send out periodic Maintenance Operation Protocol (MOP) system identification messages, use the mop sysid interface configuration command. To disable MOP message support on an interface, use the no form of this command.

To adjust the maximum packet size or maximum transmission unit (MTU) size, use the mtu interface configuration command. Use the no form of this command to restore the MTU value to its original default value.

To enable non-return to zero inverted (NRZI) line coding format, use the nrzi-encoding interface configuration command. Use the no form of this command to disable this capability.

You can selectively disable DHCP proxy-client status on an individual asynchronous interface on a router by using the no peer default ip address pool interface configuration command. You can turn a single interface back on by issuing the standard command after it is turned off.

To make an asynchronous connection from the auxiliary port using the Point-to-Point Protocol (PPP), enter the ppp EXEC command.

default	(Optional) Makes PPP connection when a default address has been configured.
client	(Optional) IP address or the name of the client workstation or PC.
@tacacs-server	(Optional) IP address or IP host name of the TACACS server to which the user's TACACS authentication request is to be sent.
/routing	(Optional) Indicates asynchronous routing is enabled.

ppp authentication {chap | pap} [if-needed] [listname]
no ppp authentication

To enable Challenge Handshake Authentication Protocol (CHAP) or Password Authentication Protocol (PAP), and to enable a TACACS+ authorization method on a serial interface, use the ppp authentication interface configuration command. Use the no form of the command to disable this authentication.

chap	Enables CHAP on a serial interface.
pap	Enables PAP on a serial interface.
if-needed	(Optional) Used with TACACS and XTACACS. Do not perform CHAP or PAP authentication if the user has already provided authentication. This option is available only on asynchronous interfaces.
list-name	(Optional) Used with AAA/TACACS+. Specify the name of a list of TACACS+ methods of authentication to use. If no listname is specified, the system uses the default. Lists and default are created with the aaa authentication ppp command.

To enable Challenge Handshake Authentication Protocol (CHAP) on a serial interface, use the ppp authentication chap interface configuration command. Use the no form of this command to disable this encapsulation.

To enable Password Authentication Protocol (PAP) on a serial interface, use the ppp authenticate pap interface configuration command. To disable this feature, use the no form of this command.

To enable Link Quality Monitoring (LQM) on a serial interface, use the ppp quality interface configuration command. Use the no form of this command to disable LQM.

To specify ISDN Primary Rate Interface (PRI) on a channelized T1 card on the Cisco 7000 series, use the pri-group controller configuration command. Use the no pri-group command to remove the ISDN PRI.

To enable pulsing DTR signal intervals on the serial interfaces, use the pulse-time interface configuration command. Use the no form of this command to restore the default interval.

To set the ring speed for the CSC-1R, CSC-2R, and IGS/TR Token Ring interfaces, use the ring-speed interface configuration command.

To list the status of the asynchronous interface 1 associated with the router auxiliary port, use the show async status user EXEC command.

Use the show controllers cbus privileged EXEC command on the AGS+ to display all information under the ciscoBus controller card. This command also shows the capabilities of the card and reports controller-related failures.

Use the show controllers cxbus privileged EXEC command to display information about the switch processor (SP) CxBus controller on the Cisco 7000 series. This command displays information that is specific to the interface hardware. The information displayed is generally useful for diagnostic tasks performed by technical support personnel only.

Use the show controllers e1 privileged EXEC command on the Cisco 7000 to display information about the E1 links supported by the MultiChannel Interface Processor (MIP). This command displays controller status that is specific to the controller hardware. The information displayed is generally useful for diagnostic tasks performed by technical support personnel only.

Use the show controllers ethernet EXEC command to display information on the Cisco 2500, Cisco 3000, or Cisco 4000.

Use the show controllers fddi user EXEC command to display all information under the FDDI controller card on the AGS+ or FDDI Interface Processor (FIP) on the Cisco 7000 series.

show controllers lex [number]
show controllers lex [slot/port] (for the Cisco 7000 series)

To show hardware and software information about the LAN Extender, use the show controllers lex EXEC command.

number	(Optional) Number of the LAN Extender interface about which to display information.
slot	(Optional) Specifies the backplane slot number on the Cisco 7000 series, and can be 0, 1, 2, 3, or 4.
port	(Optional) Specifies the port number of the controller and can be 0 or 1.

Use the show controllers mci privileged EXEC command to display all information under the Multiport Communications Interface card or the SCI. This command displays information the system uses for bridging and routing that is specific to the interface hardware. The information displayed is generally useful for diagnostic tasks performed by technical support personnel only.

Use the show controllers serial privileged EXEC command to display information specific to the interface hardware. The information displayed is generally useful for diagnostic tasks performed by technical support personnel only.

Use the show controllers t1 privileged EXEC command on the Cisco 7000 to display information about the T1 links supported by the MultiChannel Interface Processor (MIP). This command displays controller status information that is specific to the controller hardware. The information displayed is generally useful for diagnostic tasks performed by technical support personnel only.

Use the show controllers token privileged EXEC command to display information about memory management, error counters, and the CSC-R, CSC-1R, CSC-2R, C2CTR, and CSC-R16 (or CSC-R16M) Token Ring interface cards or Token Ring Interface Processor (TRIP), in the case of the Cisco 7000 series.

To display information about the hub on an Ethernet interface of a Cisco 2505 or Cisco 2507, use the show hub EXEC command.

ether	(Optional) Indicates that this is an Ethernet hub.
number	(Optional) Hub number, starting with 0. Since there is currently only one hub, this number is 0.
port	(Optional) Port number on the hub. On the Cisco 2505, port numbers range from 1 through 8. On the Cisco 2507, port numbers range from 1 through 16. If a second port number follows, then this port number indicates the beginning of a port range.
end-port	(Optional) Ending port number of a range.

show interfaces [type number] [first] [last] [accounting]
show interfaces [type [slot/port] [accounting] (for the Cisco 7000)

Use the show interfaces EXEC command to display statistics for all interfaces configured on the router. The resulting output varies, depending on the network for which an interface has been configured.

type number	(Optional) Specify that information for a particular interface controller be displayed. Allowed values for type include async, bri0, ethernet, fddi, hssi, loopback, null, serial, tokenring, and tunnel. For the Cisco 7000 series, type can be atm, ethernet, fddi, serial, or tokenring. The argument number must match a port number on the selected interface controller.
first last	(Optional) The Cisco 2500 and Cisco 3000 support the ISDN Basic Rate Interface (BRI). The argument first can be either 1 or 2. The argument last can only be 2, indicating B channels 1 and 2. D-channel information is obtained by using the command without the optional arguments.
accounting	(Optional) Displays the number of packets of each protocol type that has been sent through the interface. You can show these numbers for all interfaces, or you can specify a specific type and number.
slot	Specifies the backplane slot number and can be 0, 1, 2, 3, or 4.
port	Specifies the port number of the interface and can be 0, 1, 2, 3, 4, or 5 depending on the type of interface, as follows: AIP (ATM Interface Processor)—0 EIP (Ethernet Interface Processor)—0, 1, 2, 3, 4, or 5 FIP (FDDI Interface Processor)—0 FSIP (Fast Serial Interface Processor)—0, 1, 2, or 3 HIP (HSSI Interface Processor) 0 TRIP (Token Ring Interface Processor)—0, 1, 2, or 3

Use the show interfaces async privileged EXEC command to display information about the serial interface.

Use the show interfaces atm EXEC command to display information about the ATM interface.

Use the show interfaces bri privileged EXEC command to display information about the BRI D and B channels.

number	Interface number. The value is 0 through 7 if the router has one BRI NIM or 0 through 15 if the router has two BRI NIMs. Specifying just the interface-number will display the D channel and both B channels for that BRI interface. (On the Cisco 2500 or Cisco 3000, only the D channel would be displayed.)
first last	(Optional) The argument first can be either 1 or 2. The argument last can only be 2, indicating B channels 1 and 2. D-channel information is obtained by using the command without the optional arguments.
accounting	(Optional) Displays the number of packets of each protocol type that have been sent through the interface.

show interfaces ethernet number [accounting]
show interfaces ethernet [slot/port] [accounting] (for the Cisco 7000
series)

Use the show interfaces ethernet privileged EXEC command to display information about an Ethernet interface on the router.

number	Must match a port number on the selected interface.
accounting	(Optional) Displays the number of packets of each protocol type that have been sent through the interface.
slot	(Optional) On a Cisco 7000 series, slot location of the interface processor.
port	(Optional) On a Cisco 7000 series, port number on the interface.

show interfaces fddi number [accounting]
show interfaces fddi [slot/port] [accounting] (for the Cisco 7000 series)

Use the show interfaces fddi user EXEC command to display information about the FDDI interface.

number	Must match a port number on the selected interface.
accounting	(Optional) Displays the number of packets of each protocol type that have been sent through the interface.
slot	(Optional) On a Cisco 7000 series, slot location of the interface processor.
port	(Optional) On a Cisco 7000 series, port number on the interface.

show interfaces hssi number [accounting]
show interfaces hssi [slot/port] [accounting] (for the Cisco 7000 series)

Use the show interfaces hssi privileged EXEC command to display information about the HSSI interface.

number	Must match a port number on the selected interface.
accounting	(Optional) Displays the number of packets of each protocol type that have been sent through the interface.
slot	(Optional) On a Cisco 7000 series, slot location of the interface processor.
port	(Optional) On a Cisco 7000 series, port number on the interface.

To display statistics about a LAN Extender interface, use the show interface lex EXEC command.

number	Number of the LAN Extender interface that resides on the core router about which to display statistics.
ethernet	(Optional) Displays statistics about the Ethernet interface that resides on the LAN Extender.
serial	(Optional) Displays statistcs about the serial interface that resides on the LAN Extender.

Use the show interfaces loopback privileged EXEC command to display information about the dialer interface.

show interfaces serial [number] [accounting]
show interfaces serial [slot/port] [accounting] (for the Cisco 7000
series)

Use the show interfaces serial privileged EXEC command to display information about a serial interface.

number	(Optional) Must match an interface port number.
accounting	(Optional) Displays the number of packets of each protocol type that have been sent through the interface.
slot	(Optional) On a Cisco 7000 series, slot location of the interface processor.
port	(Optional) On a Cisco 7000 series, port number on interface.

show interfaces tokenring [number] [accounting]
show interfaces tokenring [slot/port] [accounting] (for the Cisco 7000
series)

Use the show interfaces tokenring privileged EXEC command to display information about the Token Ring interface and the state of source route bridging.

number	(Optional) Must match an interface port line number.
accounting	(Optional) Displays the number of packets of each protocol type that have been sent through the interface.
slot	On a Cisco 7000 series, optional slot location of the interface processor. Value can be 0, 1, 2, 3, or 4 in the Cisco 7000. In the Cisco 7010, value can be 0, 1, or 2.
port	On a Cisco 7000 series, optional port number on interface. Value can be 0, 1, 2, or 3.

To list tunnel interface information, use the show interfaces tunnel privileged EXEC command.

To list a summary of an interface's IP information and status, use the show ip interface privileged EXEC command.

brief	(Optional) Displays a brief summary of IP status and configuration.
type	(Optional) Specifies that information be displayed about that interface type only. The possible value depends on the type of interfaces the system has. For example, it could be ethernet, null, serial, tokenring, etc.
number	(Optional) Interface number.

Use the show interfaces vty EXEC command to display information about virtual asynchronous interfaces.

Use the show rif EXEC command to display the current contents of the RIF cache.

To disable an interface, use the shutdown interface configuration command. To restart a disabled interface, use the no form of this command.

To make a SLIP connection on the auxiliary port, use the slip user EXEC command.

default	(Optional) Makes a SLIP connection when a default address has been configured.
client	(Optional) IP address or the name of the client workstation or PC.
@tacacs-server	(Optional) IP address or IP hostname of the TACACS server to which the user's TACACS authentication request is sent.
/routing	(Optional) Indicates routing is enabled. Asynchronous interface 1 must be configured for async dynamic routing.
/compressed	(Optional) Indicates IP header compression should be used on the link.

To set the maximum number of unprocessed FDDI station management (SMT) frames that will be held for processing, use the smt-queue-threshold global configuration command. Use the no form of this command to restore the queue to the default.

To configure source address control on a port on an Ethernet hub (repeater) of a Cisco 2505 or Cisco 2507, use the source-address hub configuration command. To remove a previously defined source address, use the no form of this command.

To extend the Ethernet twisted-pair 10BaseT capability beyond the standard 100 meters on the Cisco 4000 platform, use the squelch interface configuration command. To restore the default, use the no form of this command.

To enable framed mode on a G.703-E1 interface, use the timeslot interface configuration command. To restore the default, use the no form of this command or set the start-slot to 0.

When a DTE does not return a transmit clock, use the transmit-clock-internal interface command to enable the internally generated clock on a serial interface on a Cisco 7000. Use the no form of this command to disable the feature.

To specify a minimum dead-time after transmitting a packet, use the transmitter-delay interface configuration command. The no form of this command restores the default.

To control the use of time slot 16 for data on a G.703-E1 interface, use the ts16 interface configuration command. To restore the default, use the no form of this command.

To enable encapsulator-to-decapsulator checksumming of packets on a tunnel interface, use the tunnel checksum interface configuration command. To disable checksumming, use the no form of this command.

To specify a tunnel interface's destination, use the tunnel destination interface configuration command. To remove the destination, use the no form of this command.

To enable an ID key for a tunnel interface, use the tunnel key interface configuration command. To remove the ID key, use the no form of this command.

To set the encapsulation mode for the tunnel interface, use the tunnel mode interface configuration command. To set to the default, use the no form of this command.

aurp	AppleTalk Update Routing Protocol (AURP).
cayman	Cayman TunnelTalk AppleTalk encapsulation.
dvmrp	Distance Vector Multicast Routing Protocol.
eon	EON compatible CLNS tunnel.
gre ip	Generic route encapsulation GRE) protocol over IP.
nos	KA9Q/NOS compatible IP over IP.

To configure a tunnel interface to drop datagrams that arrive out of order, use the tunnel sequence-datagrams interface configuration command. To disable this function, use the no form of this command.

tunnel source {ip-address | interface-type interface-number}
no tunnel source

To set a tunnel interface's source address, use the tunnel source interface configuration command. To remove the source address, use the no form of this command.

ip-address	IP address to use as the source address for packets in the tunnel.
interface-type	All types.
interface-number	Specifies the port, connector, or interface card number. The numbers are assigned at the factory at the time of installation or when added to a system, and can be displayed with the show interfaces command.

To control the number of transmit buffers available to a specified interface on the MCI and SCI cards, use the tx-queue-limit interface configuration command.

line	Specifies the T1 line as the clock source.
internal	Specifies the MIP as the clock source.

line	Specifies that the interface will clock its transmitted data from a clock recovered from the line's receive data stream (default).
internal	Specifies that the interface will clock its transmitted data from its internal clock.

predictor	(Optional) Specifies that a predictor compression algorithm will be used on LAPB and PPP encapsulation.
stac	(Optional) Specifies that a Stacker (LZS) compression algorithm will be used on HDLC and PPP encapsulation.

aui	(Optional) Selects a 15-pin physical connection.
10baset	(Optional) Selects an RJ45 10BaseT physical connection.

normal	Allows normal capability. The default value is normal range.
reduced	Allows extended 10BaseT capability.

interface-name	Serial port to be set as the secondary interface line.
slot	On the Cisco 7000 series, specifies the slot number.
port	On the Cisco 7000 series, specifies the port number.

ethernet	Indicates the hub in front of an Ethernet interface.
number	Hub number to clear, starting with 0. Since there is currently only one hub, this number is 0.

interface-name	(Optional) Specifies the FDDI interface.
phy-a	(Optional) Selects Physical Sublayer A.
phy-b	(Optional) Selects Physical Sublayer B.

number	(Optional) Must be 1.
accounting	(Optional) Displays the number of packets of each protocol type that have been sent through the interface.

number	(Optional) Must match a port number on the selected interface.
accounting	(Optional) Displays the number of packets of each protocol type that have been sent through the interface.

number	Must match the interface port line number.
accounting	(Optional) Displays the number of packets of each protocol type that have been sent through the interface.

start-slot	The first subframe in the major frame. Range is 1 to 31 and must be less than or equal to stop-slot.
stop-slot	The last subframe in the major frame. Range is 1 to 31 and must be greater than or equal to start-slot.

microseconds	Approximate number of microseconds of minimum delay after transmitting a packet on the MCI and SCI interface cards. The default is 0 microseconds.
hdlc-flags	Minimum number of HDLC flags to be sent between each packet on the HIP, HSCI, FSIP, or HSSI. The valid range on the HSSI is 2 to 128000.

hostname	Name of the host destination.
ip-address	IP address of the host destination expressed in decimal in four-part, dotted notation.

Table of Contents

Interface Commands