session through set cgmp leave

set
set accounting commands
set accounting connect
set accounting exec
set accounting suppress
set accounting system
set accounting update
set alias
set arp
set authentication enable
set authentication login
set authorization commands
set authorization enable
set authorization exec
set banner motd
set boot auto-config
set boot config-register
set boot system flash
set bridge apart
set bridge fddicheck
set bridge ipx 8022toether
set bridge ipx 8023rawtofddi
set bridge ipx snaptoether
set cam
set cdp
set cdp holdtime
set cdp interval
set cdp version
set cgmp
set cgmp leave
set channel cost
set channel vlancost
set cops

set accounting commands

Use the set accounting commands command to enable accounting of the command events on the switch.

set accounting commands enable {config | all} {stop-only} tacacs+
set accounting commands disable

Syntax Description

enable	Keyword that specifies to enable the specified accounting method for commands.
config	Keyword that specifies to permit accounting for configuration commands only.
all	Keyword that specifies to permit accounting for all commands.
stop-only	Keyword that specifies the accounting method that applies at the conclusion of the command.
tacacs+	Keyword that specifies TACACS+ accounting for commands.
disable	Keyword that specifies to disable accounting for commands.

Default

Accounting is disabled by default.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

You must configure the TACACS+ servers before enabling accounting.

Example

This example shows how to enable accounting for configuration commands when sending records only upon termination of the event, using a TACACS+ server:

Console> (enable) set accounting commands enable config stop-only tacacs+
Accounting set to enable for commands-config events in stop-only mode.
Console> (enable)

This example shows how to disable command accounting:

Console> (enable) set accounting commands disable
Accounting set to disable for commands-config events.
Console> (enable)

set accounting connect

Use the set accounting connect command to enable accounting of outbound connection events on the switch.

set accounting connect enable {start-stop | stop-only} {tacacs+ | radius}
set accounting connect disable

Syntax Description

enable	Keyword that specifies to enable the specified accounting method for connection events.
start-stop	Keyword that specifies the accounting method that applies at the start and stop of the connection event.
stop-only	Keyword that specifies the accounting method that applies at the conclusion of the connection event.
tacacs+	Keyword that specifies TACACS+ accounting for connection events.
radius	Keyword that specifies RADIUS accounting for connection events.
disable	Keyword that specifies to disable accounting of connection events.

Default

Accounting is disabled by default.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

You must configure the RADIUS or TACACS+ servers and shared keys before enabling accounting.

Example

This example shows how to enable accounting on Telnet and rlogin sessions when generating records at stop only, using a TACACS+ server:

Console> (enable) set accounting connect enable stop-only tacacs+
Accounting set to enable for connect events in stop-only mode.
Console> (enable)

This example shows how to disable accounting:

Console> (enable) set accounting connect disable
Accounting set to disable for connect events.
Console> (enable)

set accounting exec

Use the set accounting exec command to enable accounting of normal mode sessions on the switch.

set accounting exec enable {start-stop | stop-only} {tacacs+ | radius}
set accounting exec disable

Syntax Description

enable	Keyword that specifies to enable the specified accounting method for normal mode events.
start-stop	Keyword that specifies the accounting method applies at the start and stop of the normal mode event.
stop-only	Keyword that specifies the accounting method applies at the conclusion of the normal mode event.
tacacs+	Keyword that specifies TACACS+ accounting for normal mode events.
radius	Keyword that specifies RADIUS accounting for normal mode events.
disable	Keyword that specifies to disable accounting for normal mode events.

Default

Accounting is disabled by default.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

You must configure the RADIUS or TACACS+ servers and shared keys before enabling accounting.

Example

This example shows how to enable accounting of normal login mode events when generating records at start and stop, using a RADIUS server:

Console> (enable) set accounting exec enable start-stop radius
Accounting set to enable for exec events in start-stop mode.
Console> (enable)

This example shows how to disable accounting of normal login mode events:

Console> (enable) set accounting exec disable
Accounting set to disable for exec events in start-stop mode.
Console> (enable)

set accounting suppress

Use the set accounting suppress command to enable or disable suppression of accounting information for a user who has logged in without a username.

set accounting suppress null-username {enable | disable}

Syntax Description

null-username	Keyword that specifies unknown users.
enable	Keyword that specifies to enable suppression for unknown users.
disable	Keyword that specifies to disable suppression unknown users.

Default

Accounting is disabled by default.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

You must configure the TACACS+ servers and shared keys before enabling accounting.

Examples

This example shows how to suppress accounting information for users without a username:

Console> (enable) set accounting suppress null-username enable
Accounting will be suppressed for user with no username.
Console> (enable)

This example shows how to include accounting-event information of users without usernames:

Console> (enable) set accounting suppress null-username disable
Accounting will be not be suppressed for user with no username.
Console> (enable)

set accounting system

Use the set accounting system command to enable accounting of system events on the switch.

set accounting system enable {start-stop | stop-only} {tacacs+ | radius}
set accounting system disable

Syntax Description

enable	Keyword that specifies to enable the specified accounting method for system events.
start-stop	Keyword that specifies the accounting method applies at the start and stop of the system event.
stop-only	Keyword that specifies the accounting method applies at the conclusion of the system event.
tacacs+	Keyword that specifies TACACS+ accounting for system events.
radius	Keyword that specifies RADIUS accounting for system events.
disable	Keyword that specifies to disable accounting for system events.

Default

Accounting is disabled by default.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

You must configure the RADIUS or TACACS+ servers and shared keys before enabling accounting.

Example

This example shows how to enable accounting for system events when sending records only upon termination of the event, using a RADIUS server:

Console> (enable) set accounting system enable stop-only radius
Accounting set to enable for system events in start-stop mode.
Console> (enable)

This example shows how to disable accounting for system events:

Console> (enable) set accounting system disable
Accounting set to disable for system events.
Console> (enable)

set accounting update

Use the set accounting update command to configure the frequency of accounting updates.

set accounting update {new-info | {periodic [interval]}}

Syntax Description

new-info	Keyword that specifies update when new information in available.
periodic	Keyword that specifies to update on a periodic basis.
interval	(Optional) Periodic update interval time; valid intervals are 1 to 71582 minutes.

Default

Accounting is disabled by default.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

You must configure the TACACS+ servers and shared keys before enabling accounting.

Example

This example shows how to send accounting updates every 200 minutes:

Console> (enable) set accounting update periodic 200
Accounting updates will be periodic at 200 minute intervals.
Console> (enable)

This example shows how to send accounting updates only when there is new information:

Console> (enable) set accounting update new-info
Accounting updates will be sent on new information only.
Console> (enable)

set authentication enable

Use the set authentication enable command to configure the switch to use TACACS+, Kerberos, RADIUS, or local authentication to authenticate privileged (enable) mode access on the switch.

set authentication enable {local | radius | tacacs | kerberos} enable [console | telnet | http |
all] [primary]
set authentication enable {local | radius | tacacs | kerberos} disable [console | telnet | http |
all]

Syntax Description

local	Keyword that specifies local authentication for privileged mode access.
radius	Keyword that specifies RADIUS authentication for privileged mode access.
tacacs	Keyword that specifies TACACS+ authentication for privileged mode access.
kerberos	Keyword that specifies Kerberos authentication for privileged mode access.
enable	Keyword that specifies to enable the specified authentication method for privileged mode access.
console	(Optional) Keyword that specifies the authentication method applies to console sessions.
telnet	(Optional) Keyword that specifies the authentication method applies to Telnet sessions.
http	(Optional) Keyword that specifies the authentication method applies to http sessions.
all	(Optional) Keyword that specifies the authentication method applies to all sessions.
primary	(Optional) Keyword that specifies the specified authentication method be tried first.
disable	Keyword that specifies to disable the specified authentication method for privileged mode access.

Default

The default setting of this command is local authentication is enabled and all other authentication methods are disabled.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

You can specify TACACS+ or RADIUS as the primary authentication method for login and enable access by entering the primary keyword. If you enter the primary keyword, the specified authentication method will be tried first. If you do not specify a primary authentication, authentication will be tried in the order in which you enabled them.

You can specify that the authentication method applies to console sessions, Telnet sessions, or both, by entering the console, telnet, or both keyword. If you do not specify console, telnet, or both, the authentication method applies to both console and Telnet sessions.

Examples

This example shows how to use the TACACS+ server to determine if a user has privileged access permission:

Console> (enable) set authentication enable tacacs enable
Tacacs Enable authentication set to enable.
Console> (enable)

This example shows how to use the local password to determine if the user has privileged access permission:

Console> (enable) set authentication enable local enable
Local Enable authentication set to enable.
Console> (enable)

This example shows how to use the RADIUS server to determine if the user has privileged access permission:

Console> (enable) set authentication enable radius enable both 
RADIUS Enable authentication set to enable for console and telnet sessions.
Console> (enable)

This example shows how to use the TACACS+ server as the primary method to determine if the user has privileged access permission:

Console> (enable) set authentication enable tacacs enable primary
Tacacs Enable authentication set to enable as primary authentication for console and telnet sessions.
Console> (enable)

The following example shows how to enable Kerberos as the login authentication method for Telnet:

kerberos> (enable) set authentication login kerberos enable telnet 
kerberos login authentication set to enable for telnet session.
kerberos> (enable)

The following example shows how to enable Kerberos as the login authentication method for the console:

kerberos> (enable) set authentication login  kerberos enable console 
kerberos login authentication set to enable for console session.
kerberos> (enable)

Related Commands

set authentication login
show authentication

set authentication login

Use the set authentication login command to configure the switch to use TACACS+, Kerberos, RADIUS, or local authentication to authenticate normal (login) mode access on the switch.

set authentication login {local | radius | tacacs | kerberos} enable [console | telnet | http | all] [primary]
set authentication login {local | radius | tacacs | kerberos} disable [console | telnet | http | all]

Syntax Description

local	Keyword that specifies local authentication for normal mode access.
radius	Keyword that specifies RADIUS authentication for normal mode access.
tacacs	Keyword that specifies TACACS+ authentication for normal mode access.
kerberos	Keyword that specifies Kerberos authentication for normal mode access.
enable	Keyword that specifies to enable the specified authentication method for normal mode access.
console	(Optional) Keyword that specifies the authentication method applies to console sessions.
telnet	(Optional) Keyword that specifies the authentication method applies to Telnet sessions.
http	(Optional) Keyword that specifies the authentication method applies to HTTP sessions.
all	(Optional) Keyword that specifies the authentication method applies to all sessions.
primary	(Optional) Keyword that specifies the specified authentication method be tried first.
disable	Keyword that specifies to disable the specified authentication method for normal mode access.

Default

The default setting of this command is local authentication is enabled and all other authentication methods are disabled.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

You can specify TACACS+ or RADIUS as the primary authentication method for normal (login) mode access. If you enter the primary keyword, the specified authentication method will be tried first. If you do not specify a primary authentication, authentication will be tried in the order in which you enabled them.

Examples

This example shows how to disable the TACACS+ server from determining if a Telnet user has normal (login) access permission:

Console> (enable) set authentication login tacacs disable telnet
TACACS Login authentication set to disable for the telnet sessions.
Console> (enable)

This example shows how to disable the RADIUS server from determining if a console user has normal (login) access permission:

Console> (enable) set authentication login radius disable console
RADIUS Login authentication set to disable for the console sessions.
Console> (enable)

This example shows how to disable the local password from determining if the user has normal (login) access permission:

Console> (enable) set authentication login local disable telnet
Local Login authentication set to disable for the telnet sessions.
Console> (enable)

Related Commands

set authentication enable
show authentication

set authorization commands

Use the set authorization commands command to enable authorization of command events on the switch.

set authorization commands enable {config | all} {option} {fallbackoption} [console | telnet | both]
set authorization commands disable [console | telnet | both]

Syntax Description

enable	Keyword that enables the specified authorization method for commands.
config	Keyword that permits authorization for configuration commands only.
all	Keyword that permits authorization for all commands.
option	Switch response to an authorization request; valid values are tacacs+, if-authenticated, and none. Refer to the "Usage Guidelines" section for valid value definitions.
fallbackoption	Switch fallback response to an authorization request if the TACACS+ server is down or not responding; valid values are tacacs+, deny, if-authenticated, and none. Refer to the "Usage Guidelines" section for valid value definitions.
console	(Optional) Keyword that specifies the authorization method applies to console sessions.
telnet	(Optional) Keyword that specifies the authorization method applies to Telnet sessions.
both	(Optional) Keyword that specifies the authorization method applies to both console and Telnet sessions.
disable	Keyword that specifies to disable authorization for commands.

Default

Authorization is disabled by default.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The tacacs+ values allows you to proceed with your action if you have authorization.

The deny value does not let you proceed if the TACACS+ server does not respond.

The if-authenticated value allows you to proceed with your action if you have been authenticated.

The none value allows you to proceed without further authorization in case the TACACS+ server does not respond.

Example

This example shows how to enable authorization for all commands with an if-authenticated option and no fallback option, in case the TACACS+ daemon is down or does not respond:

Console> (enable) set authorization commands enable all if-authenticated none
Successfully enabled commands authorization.
Console> (enable)

This example shows how to disable command authorization:

Console> (enable) set authorization commands disable
Successfully disabled commands authorization.
Console> (enable)

set authorization enable

Use the set authorization enable command to enable authorization of enable (privileged mode) session events on the switch.

set authorization enable enable {option} {fallbackoption} [console | telnet | both]
set authorization enable disable [console | telnet | both]

Syntax Description

enable	Keyword that specifies to enable the specified authorization method.
option	Switch response to an authorization request; valid values are tacacs+, if-authenticated, and none. Refer to the "Usage Guidelines" section for valid value definitions.
fallbackoption	Switch fallback response to an authorization request if the TACACS+ server is down or not responding; valid values are tacacs+, deny, if-authenticated, and none. Refer to the "Usage Guidelines" section for valid value definitions.
console	(Optional) Keyword that specifies the authorization method applies to console sessions.
telnet	(Optional) Keyword that specifies the authorization method applies to Telnet sessions.
both	(Optional) Keyword that specifies the authorization method applies to both console and Telnet sessions.
disable	Keyword that specifies to disable authorization method.

Default

Authorization is disabled by default.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The tacacs+ value allows you to proceed with your action if you have authorization.

The deny value does not let you proceed if the TACACS+ server does not respond.

The if-authenticated value allows you to proceed with your action if you have been authenticated.

The none value allows you to proceed without further authorization in case the TACACS+ server does not respond.

Example

This example shows how to enable authorization of configuration commands in enable mode sessions:

Console> (enable) set authorization enable enable if-authenticated none 
Successfully enabled enable authorization.
Console> (enable)

This example shows how to disable enable mode authorization:

Console> (enable) set authorization enable disable
Successfully disabled enable authorization.
Console> (enable)

set authorization exec

Use the set authorization exec command to enable authorization of exec (normal login mode) session events on the switch.

set authorization exec enable {option} {fallbackoption} [console | telnet | both]
set authorization exec disable [console | telnet | both]

Syntax Description

enable	Keyword that specifies to enable the specified authorization method.
option	Switch response to an authorization request; valid values are tacacs+, if-authenticated, and none. Refer to the "Usage Guidelines" section for valid value definitions.
fallbackoption	Switch fallback response to an authorization request if the TACACS+ server is down or not responding; valid values are tacacs+, deny, if-authenticated, and none. Refer to the "Usage Guidelines" section for valid value definitions.
console	(Optional) Keyword that specifies the authorization method applies to console sessions.
telnet	(Optional) Keyword that specifies the authorization method applies to Telnet sessions.
both	(Optional) Keyword that specifies the authorization method applies to both console and Telnet sessions.
disable	Keyword that specifies to disable authorization method.

Default

Authorization is disabled by default.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The tacacs+ value allows you to proceed with your action if you have authorization.

The deny value does not let you proceed if the TACACS+ server does not respond.

The if-authenticated value allows you to proceed with your action if you have been authenticated.

The none value allows you to proceed without further authorization in case the TACACS+ server does not respond.

Example

This example shows how to enable authorization of configuration commands in exec mode sessions:

Console> (enable) set authorization exec enable if-authenticated none 
Successfully enabled exec authorization.
Console> (enable)

This example shows how to disable exec mode authorization:

Console> (enable) set authorization exec disable
Successfully disabled exec authorization.
Console> (enable)

set banner motd

Use the set banner motd command to create a login banner to display when users access the switch.

set banner motd c [text] c

Syntax Description

c	Delimiting character used to begin and end the message.
text	(Optional) Message of the day.

Default

No MOTD banner is defined.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The banner cannot contain more than 3,070 characters, including tabs. Tabs display as eight characters but take only one character of memory.

You can use either the clear banner motd command or the set banner motd cc command to clear the message-of-the-day banner.

Examples

This example shows how to set the message of the day using the pound sign (#) as the delimiting character:

Console> (enable) set banner motd #
** System upgrade at 6:00am Tuesday.
** Please log out before leaving on Monday. #
MOTD banner set.
Console> (enable>

This example shows how to clear the message of the day:

Console> (enable) set banner motd ##
MOTD banner cleared.
Console> (enable>

Related Command

clear banner motd

set boot auto-config

Use the set boot auto-config command to specify one or more configuration files to use to configure the switch at startup and to set the recurrence option. A list of configuration files is stored in the config_file environment variable.

set boot auto-config device:filename [;<device:filename>...] [mod_num]
set boot auto-config {cfg1 | cfg2 | cfg1;cfg2}
set boot auto-config {recurring | non-recurring}

Syntax Description

device:	Device where the startup configuration file resides.
filename	Names of the startup configuration file.
mod_num	(Optional) Module number of the supervisor engine containing the Flash device.
cfg1	Keyword that specifies the first startup configuration file on the Supervisor Engine II G and III G. Use a semicolon-separated list to specify multiple cfg files.
cfg2	Keyword that specifies the second startup configuration file on the Supervisor Engine II G and III G. Use a semicolon-separated list to specify multiple cfg files.
recurring	Keyword that specifies to retain config_file variable settings. Available only on the Supervisor Engine II G and III G.
non-recurring	Keyword that specifies to clear config_file variable settings before the startup configuration file runs. Available only on the Supervisor Engine II G and III G.

Default

The default setting of this command is non-recurring and the CONFIG_FILE is not defined.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The set boot auto-config command always overwrites the existing CONFIG_FILE environment variable settings (you cannot prepend or append a file to the variable contents).

In the Catalyst 5000 family Supervisor Engine III or III F, and Catalyst 4000 family, 2926G series, and 2948G switches, multiple configuration files may be specified, but they must be separated by a semicolon (;).

In the Catalyst 5000 family Supervisor Engine II G and III G, two configuration files may be specified. Separate the files using a semicolon (;).

You can set recurring, non-recurring, cfg1, and cfg2 keywords in Supervisor Engines II G and
III G only.

To set the recurrence on other supervisor engines and switches, use the set boot config-register auto-config command.

Examples

This example shows how to specify the configuration file environment variable:

Console> (enable) set boot auto-config slot0:cfg1
CONFIG_FILE variable = slot0:cfg1
WARNING: nvram configuration may be lost during next bootup,
         and re-configured using the file(s) specified.
Console> (enable)

This example shows how to specify the configuration file environment variable on Supervisor Engines II G and III G:

Console> (enable) set boot auto-config cfg1
CONFIG_FILE variable = cfg1
WARNING: nvram configuration may be lost during next bootup,
         and re-configured using the file(s) specified.
Console> (enable)

This example shows how to specify multiple configuration files on Supervisor Engines II G
and III G:

Console> (enable) set boot auto-config cfg1;cfg2
CONFIG_FILE variable = cfg1;cfg2
WARNING: nvram configuration may be lost during next bootup,
         and re-configured using the file(s) specified.
Console> (enable)

This example shows how to set the auto-configuration to recurring on Supervisor Engines II G
and III G:

Console> (enable) set boot auto-config recurring
auto-config: recurring
Console> (enable)

Related Commands

set boot system flash

set boot config-register

Use the set boot config-register command to set the boot configuration register value.

set boot config-register 0xvalue [mod_num]
set boot config-register boot {rommon | bootflash | system} [mod_num]
set boot config-register baud {1200 | 2400 | 4800 | 9600} [mod_num]
set boot config-register ignore-config {enable | disable} [mod_num]
set boot config-register auto-config {recurring | non-recurring} [mod_num]

Syntax Description

0xvalue	Keyword to set the 16-bit configuration register value. This value is a hexadecimal value and the valid range is 0x0 to 0xFFFF.
mod_num	(Optional) Module number of the supervisor engine on which to set the configuration register value.
boot	Keyword that specifies the boot method to use the next time the switch is reset or power cycled.
rommon	Keyword that causes the switch to remain in ROM monitor mode the next time the switch is reset or power cycled.
bootflash	Keyword that causes the switch to boot using the first valid system image in bootflash the next time the switch is reset or power cycled.
system	Keyword that causes the switch to boot using the system images specified in the BOOT environment variable the next time the switch is reset or power cycled.
baud	Keyword that specifies to set the console baud rate.
1200 \| 2400 \| 4800 \| 9600	Keywords that specifies the ROM monitor console port baud rate.
ignore-config	Keyword that specifies whether the switch should ignore the configuration in NVRAM the next time the switch is restarted.
enable	Keyword that causes the switch to ignore the configuration in NVRAM the next time the switch is restarted.
disable	Keyword that prevents the switch from ignoring the configuration in NVRAM the next time the switch is restarted.
recurring	Keyword that causes the switch to retain the contents of the CONFIG_FILE environment variable after the switch is reset or power cycled and configured using the files specified by the CONFIG_FILE environment variable.
non-recurring	Keyword that causes the switch to clear the contents of the CONFIG_FILE environment variable after the switch is reset or power cycled and before the switch is configured using the files specified by the CONFIG_FILE environment variable.

Default

The default configuration register value is 0x10F, which specifies the following settings:

Boot method is "system" (the switch boots using the system images specified in the BOOT environment variable).
ROM monitor console port baud rate is set to 9600.
The ignore-config parameter is disabled.
The auto-config parameter is set to non-recurring.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

We recommend that you use only the rommon and system options to the set boot config-register boot command.

Each time you enter one of the set boot config-register commands, the system displays all current configuration register information (the equivalent of entering the show boot command).

The baud rate specified in the configuration register is used by the ROM monitor only and is different from the baud rate specified by the set system baud command.

The auto-config_file variable is slot0:switch.cfg for non-recurring and bootflash:switch.cfg for the Catalyst 4000 family switches.

Caution Enabling the ignore-config parameter is the same as entering the clear config all command; that is, it clears the entire configuration stored in NVRAM the next time the switch is restarted.

Examples

This example shows how to specify the default 16-bit configuration register value:

Console> (enable) set boot config-register 0x10f
Configuration register is 0x10f
ignore-config: disabled
auto-config: non-recurring
console baud: 9600
boot: image specified by the boot system commands
Console> (enable)

This example shows how to specify rommon as the boot image to use on the next restart:

Console> (enable) set boot config-register boot rommon
Configuration register is 0x100
ignore-config: disabled
auto-config: non-recurring
console baud: 9600
boot: the ROM monitor
Console> (enable)

This example shows how to change the ROM monitor console port baud rate to 4800:

Console> (enable) set boot config-register baud 4800
Configuration register is 0x900
ignore-config: disabled
auto-config: non-recurring
console baud: 4800
boot: the ROM monitor
Console> (enable)

This example shows how to cause the switch to ignore the configuration in NVRAM the next time the switch is reset or power cycled:

Console> (enable) set boot config-register ignore-config enable
Configuration register is 0x940
ignore-config: enabled
auto-config: non-recurring
console baud: 4800
boot: the ROM monitor
Console> (enable)

This example shows how to set the auto-configuration to recurring:

Console> (enable) set boot config-register auto-config recurring
Configuration register is 0x960
ignore-config: enabled
auto-config: recurring
console baud: 4800
boot: the ROM monitor
Console> (enable)

Related Commands

clear boot
show boot

set boot system flash

Use the set boot system flash command to set the BOOT environment variable, which specifies a list of software images that the switch attempts to load at startup.

set boot system flash device:filename [prepend] [mod_num]

Syntax Description

device:	Flash device where the software image is stored (the colon [:] is required).
filename	Name of the software image file on the Flash device.
prepend	(Optional) Keyword that specifies to place the software image file first in the list of images to attempt to boot.
mod_num	(Optional) Module number of the supervisor engine on which to modify the BOOT environment variable.

Default

This command has no default setting.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

This command is not supported on the Catalyst 5000 Supervisor Engine II.

The mod_num option is not supported on the Catalyst 2926G series switch.

You can enter several boot system commands to provide a fail-safe method for booting the switch. The system stores and executes the boot system commands in the order in which you enter them.

When you copy a new software image to a Flash device and want to switch to boot that image the next time the switch is reset, clear the BOOT environment variable using the clear boot system all command or use the prepend keyword to place the new software image file first in the list of images to attempt to boot.

If the file does not exist (for example, if you entered the wrong filename), then the filename is appended to the bootstring, and a message displays, "Warning: File not found but still added in the bootstring."

If the file does exist, but is not a supervisor engine software image, the file is not added to the bootstring, and a message displays, "Warning: file found but it is not a valid boot image."

Examples

This example shows how to append a software image file to the BOOT environment variable:

Console> (enable) set boot sys flash bootflash:cat5000-sup3.5-1-1.bin
BOOT variable = 
bootflash:cat5000-sup3.5-2-1.bin,1;bootflash:cat5000-sup3.5-1-1.bin,1;
Console> (enable)

This example shows how to prepend a software image file to the BOOT environment variable:

Console> (enable) set boot system flash slot0:cat5000-sup3.5-2-1.bin prepend
BOOT variable = 
slot0:cat5000-sup3.5-2-1.bin,1;bootflash:cat5000-sup3.4-5-2.bin,1;
Console> (enable)

Related Commands

clear boot
show boot

set bridge apart

Use the set bridge apart command to enable or disable APaRT on FDDI.

set bridge apart {enable | disable}

Syntax Description

enable	Keyword that specifies to activate APaRT on FDDI.
disable	Keyword that specifies to deactivate APaRT on FDDI.

Default

The default configuration has APaRT enabled.

Supported Platforms

Catalyst 5000 family switches

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to disable APaRT:

Console> (enable) set bridge apart disable
APaRT disabled
Console> (enable)

Related Command

set bridge fddicheck

set bridge fddicheck

Use the set bridge fddicheck command to enable or disable the relearning of MAC addresses (as FDDI MAC addresses) that were already learned from an Ethernet interface (as Ethernet MAC addresses).

set bridge fddicheck {enable | disable}

Syntax Description

enable	Keyword that specifies to permit FDDI to relearn MAC addresses learned from an Ethernet interface.
disable	Keyword that specifies to prevent FDDI from relearning MAC addresses learned from an Ethernet interface.

Default

The default configuration has fddicheck disabled.

Supported Platforms

Catalyst 5000 family switches

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

When fddicheck is enabled, a MAC address seen on the FDDI ring is not learned (stored in FDDI CAM) as an FDDI MAC address if the MAC address was previously learned from an Ethernet interface (as an Ethernet MAC address).

With fddicheck enabled, MAC addresses previously learned from an Ethernet interface will not be relearned on the FDDI interface until the CAM is cleared.

This command requires information from the FDDI CAM. If you disable APaRT, fiddicheck is also automatically disabled. To enable fddicheck, first enable APaRT.

Example

This example shows how to enable fddicheck on the switch:

Console> (enable) set bridge fddicheck enable
FDDICHECK enabled
Console> (enable)

Related Command

show bridge

set bridge ipx 8022toether

Use the set bridge ipx 8022toether command to set the default method for translating IPX packets from FDDI 802.2 to Ethernet. The default translation method specified is used only until the real protocol types are learned.

set bridge ipx 8022toether {8023 | snap | eii | 8023raw}

Syntax Description

8023	Keyword that specifies Ethernet 802.3 as the default translation method.
snap	Keyword that specifies Ethernet SNAP as the default translation method.
eii	Keyword that specifies Ethernet II as the default translation method.
8023raw	Keyword that specifies Ethernet 802.3 RAW as the default translation method.

Default

The default translation method for FDDI 802.2 to Ethernet networks is 8023 (Ethernet 802.3).

Supported Platforms

Catalyst 5000 family switches

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to set the default protocol to SNAP for translating IPX packets between FDDI 802.2 and Ethernet networks:

Console> (enable) set bridge ipx 8022toether snap
8022 to ETHER translation set.
Console> (enable)

Related Command

show bridge

set bridge ipx 8023rawtofddi

Use the set bridge ipx 8023rawtofddi command to set the default method for translating IPX packets from Ethernet 802.3 to FDDI. The default translation method specified is used only until the real protocol types are learned.

set bridge ipx 8023rawtofddi {8022 | snap | fddiraw}

Syntax Description

8022	Keyword that specifies FDDI 802.2 as the default translation method.
snap	Keyword that specifies FDDI SNAP as the default translation method.
fddiraw	Keyword that specifies FDDI RAW as the default translation method.

Default

The default translation method for Ethernet 802.3 to FDDI networks is SNAP (FDDI SNAP).

Supported Platforms

Catalyst 5000 family switches

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to set the default translation method to FDDI SNAP for translating IPX packets between Ethernet 802.3 and FDDI networks:

Console> (enable) set bridge ipx 8023rawtofddi snap
8023RAW to FDDI translation set.
Console> (enable)

Related Command

show bridge

set bridge ipx snaptoether

Use the set bridge ipx snaptoether command to set the default method for translating IPX FDDI SNAP frames to Ethernet frames. The default translation specified is used for all broadcast IPX SNAP frames and for any unlearned Ethernet MAC addresses.

set bridge ipx snaptoether {8023 | snap | eii | 8023raw}

Syntax Description

8023	Keyword that specifies Ethernet 802.3 as the default frame type.
snap	Keyword that specifies Ethernet SNAP as the default frame type.
eii	Keyword that specifies Ethernet II as the default frame type.
8023raw	Keyword that specifies Ethernet 802.3 RAW as the default frame type.

Default

The default translation method for translating IPX FDDI SNAP frames to Ethernet frames is 8023raw (Ethernet 802.3 RAW).

Supported Platforms

Catalyst 5000 family switches

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to set the default method for translating IPX FDDI SNAP frames to Ethernet frames to SNAP:

Console> (enable) set bridge ipx snaptoether snap
Bridge snaptoether default IPX translation set.
Console> (enable)

Related Command

show bridge

set cam

Use the set cam command to add entries into the CAM table and to set the aging time for the CAM table.

set cam {dynamic | static | permanent} {unicast_mac} {mod/port} [vlan]
set cam {dynamic | static | permanent} {route_descr} {mod/port} [vlan]
set cam {static | permanent} {multicast_mac} {mod/ports...} [vlan]
set cam agingtime vlan agingtime

Syntax Description

dynamic	Keyword that specifies that entries are subject to aging.
static	Keyword that specifies that entries are not subject to aging. Static (nonpermanent) entries will remain in the table until the system is reset.
permanent	Keyword that specifies that permanent entries are stored in NVRAM until they are removed by the clear cam or clear config command.
unicast_mac	MAC address of the destination host used for a unicast.
mod/port	Number of the module and the port.
vlan	(Optional) Number of the VLAN.
route_descr	Route descriptor of the "next hop" relative to this switch. This variable is entered as two hexadecimal bytes in the following format: 004F. Do not use a "-" to separate the bytes.
multicast_mac	MAC address of the destination host used for a multicast.
mod/ports...	Number of the module and the ports.
agingtime	Keyword that specifies to set the period of time after which an entry is removed from the table.
vlan	(Optional) Number of the VLAN. This number is optional unless you are setting CAM entries to dynamic, static, or permanent for a trunk port, or if you are using the agingtime keyword.
agingtime	Number of seconds (0 to 1,000,000 for the Catalyst 5000 family and 2926G series switches; 0 and 15 to 1,000,000 for the Catalyst 4000 family and 2948G switches) that dynamic entries remain in the table before being deleted. Setting aging time to 0 disables aging.

Default

The default aging time for all configured VLANs is 300 seconds.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The set cam {dynamic | static | permanent} {route_descr} {mod/port} [vlan] command is not supported by the Catalyst 4000 family, 2948G, and 2980G switches.

If the given MAC address is a multicast address (the least significant bit of the most significant byte is set to 1) or broadcast address (ff-ff-ff-ff-ff-ff) and multiple ports are specified, the ports must all be in the same VLAN. If the given address is a unicast address and multiple ports are specified, the ports must be in different VLANs.

The set cam command does not support the RSM.

If you enter a route descriptor with no VLAN parameter specified, the default is the VLAN already associated with the port. If you enter a route descriptor, you may only use a single port number (of the associated port).

The minimum configurable non-zero age time for the Catalyst 4000 family, 2948G, and 2980G switches is 15 seconds. You cannot configure an aging time between 1 and 15 seconds.

Examples

This example shows how to set the CAM table aging time for VLAN 1 to 300 seconds:

Console> (enable) set cam agingtime 1 300
Vlan 1 CAM aging time set to 300 seconds.
Console> (enable)

This example shows how to add a static unicast entry to the table for module 2, port 9:

Console> (enable) set cam static 00-00-0c-a0-03-fa 2/9
Static unicast entry added to CAM table.
Console> (enable)

This example shows how to add a permanent multicast entry to the table for a group of ports:

Console> (enable) set cam permanent 01-40-0b-a0-03-fa 1/1,2/1,2/3,2/8-12
Permanent multicast entry added to CAM table.
Console> (enable)

Related Commands

clear cam
show cam

set cdp

Use the set cdp command to enable or disable CDP globally or on specified ports, and to configure the CDP hold time.

set cdp {enable | disable} [mod/ports...]

Syntax Description

enable	Keyword that specifies to enable the CDP feature.
disable	Keyword that specifies to disable the CDP feature.
mod/ports...	(Optional) Number of the module and ports.

Default

The default system configuration has CDP enabled; the message interval is set to 60 seconds for every port.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

If you enter the global set cdp enable or disable command, CDP is globally configured. If CDP is globally disabled, CDP is automatically disabled on all ports, but the per-port enable (or disable) configuration is not changed. If CDP is globally enabled, whether CDP is running on a port or not depends on its per-port configuration.

If you configure CDP on a per-port basis, the mod/ports... can be entered as a single module and port or a range of ports; for example, 2/1-12,3/5-12.

Examples

This example shows how to enable the CDP on port 1 on module 2:

Console> (enable) set cdp enable 2/1
CDP enabled on port 2/1.
Console> (enable)

This example shows how to disable the CDP message display for port 1 on module 2:

Console> (enable) set cdp disable 2/1
CDP disabled on port 2/1.
Console> (enable)

Related Command

show cdp

set cdp holdtime

Use the set cdp holdtime command to configure the CDP hold time.

set cdp holdtime holdtime

Syntax Description

holdtime	Keyword that specifies the global CDP hold time value.
holdtime	Number of seconds for the global CDP hold time value; valid values are 10 to 255 seconds.

Default

The default CDP hold time value has the message interval globally set to 180 seconds.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The holdtime argument is not supported on Catalyst 5000 family and 2926G series switches with supervisor engine software release 4.2(2) and earlier and 3.2(4) and earlier, and Catalyst 4000 family, 2948G, and 2980G switches.

Examples

This example shows how to specify the global CDP hold time value:

Console> (enable) set cdp holdtime 200
CDP holdtime set to 200 seconds.
Console> (enable)

Related Command

show cdp

set cdp interval

Use the set cdp interval command to globally set the message interval for CDP.

set cdp interval interval

Syntax Description

interval

Number of seconds (5 to 900) the system waits between CDP message transmissions.

Default

The default is set to 60 seconds.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to set the CDP message interval to 100 seconds:

Console> (enable) set cdp interval 100
CDP message interval set to 100 seconds for all ports.
Console> (enable)

Related Commands

set cdp
show cdp

set cdp version

Use the set cdp version command to set the version of CDP to run on the switch.

set cdp version v1 | v2

Syntax Description

v1 | v2

Keywords that specify the version of CDP.

Default

The default CDP version is v2.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to set the CDP version to 1:

Console> (enable) set cdp version v1
CDP version set to v1
Console> (enable)

Related Commands

set cdp
show cdp

set cgmp

Use the set cgmp command to enable or disable CGMP on the switch.

set cgmp {enable | disable}

Syntax Description

enable	Keyword that specifies to enable CGMP on the switch.
disable	Keyword that specifies to disable CGMP on the switch.

Default

By default, CGMP is disabled.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

CGMP requires that you connect the switch to a router running CGMP.

Examples

This example shows how to enable CGMP on a device:

Console> (enable) set cgmp enable
CMGP support for IP multicast enabled.
Console> (enable)

This example shows how to disable CGMP on a device:

Console> (enable) set cgmp disable
CMGP support for IP multicast disabled.
Console> (enable)

This example shows what happens if you try to enable CGMP if IGMP snooping is already enabled:

Console> (enable) set cgmp enable
Disable IGMP Snooping feature to enable CGMP.
Console> (enable)

Related Commands

clear multicast router
set multicast router
show multicast group
show multicast group count

set cgmp leave

Use the set cgmp leave command to enable or disable CGMP leave processing.

set cgmp leave {enable | disable}

Syntax Description

enable	Keyword that specifies to enable CGMP leave processing.
disable	Keyword that specifies to disable CGMP leave processing.

Default

By default, CGMP leave processing is disabled.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Examples

This example shows how to enable CGMP leave processing:

Console> (enable) set cgmp leave enable
CMGP support for leave processing enabled.
Console> (enable)

This example shows how to disable CGMP leave processing:

Console> (enable) set cgmp leave disable
CMGP support for leave processing disabled.
Console> (enable)

Related Commands

clear multicast router
set multicast router
show multicast group
show multicast group count
show cgmp leave

set channel cost

Use the set channel cost command to set the spanning-tree port cost for an EtherChannel port bundle.

set channel cost {channel_id | all} [cost]

Syntax Description

channel_id	EtherChannel ID of the channel to modify.
all	Keyword that specifies all EtherChannel port bundles on the switch.
cost	(Optional) Spanning-tree port cost to apply to the EtherChannel.

Default

The default is the spanning-tree port cost is calculated automatically based on the current port costs of the ports in the EtherChannel.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

To determine the channel_id of an EtherChannel port bundle, use the show channel command.

If you do not specify the cost, the spanning-tree port cost is updated based on the current port costs of the channeling ports. If you change the channel port cost, the port costs of member ports in the channel are modified to reflect the new cost. A message appears listing the ports whose port costs were changed.

Examples

This example shows how to set the channel 768 path cost to 23:

Console> (enable) set channel cost 768 23
Port(s) 1/1-2,7/3,7/5 port path cost are updated to 60.
Channel 768 cost is set to 23.
Warning:channel cost may not be applicable if channel is broken.
Console> (enable)

This example shows how to set all channel path costs to 15:

Console> (enable) set channel cost all 15
Port(s) 4/1-4 port path cost are updated to 39.
Channel 768 cost is set to 15.
Warning:channel cost may not be applicable if channel is broken.
Console> (enable)

set channel vlancost

Use the set channel vlancost command to set the spanning-tree port-VLAN cost for an EtherChannel port bundle.

set channel vlancost channel_id [cost]

Syntax Description

channel_id	EtherChannel ID of the channel to modify.
cost	(Optional) Spanning-tree port-VLAN cost to apply to the EtherChannel.

Default

The default is the spanning-tree port-VLAN cost is calculated automatically based on the current port-VLAN costs of the ports in the EtherChannel.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Catalyst 2980G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

You can configure the port-VLAN cost of only one EtherChannel at a time.

To determine the channel_id of an EtherChannel port bundle, use the show channel command.

If you do not specify the cost, the spanning-tree port-VLAN cost is updated based on the current port-VLAN costs of the channeling ports. If you change the channel port-VLAN cost, the port-VLAN costs of member ports in the channel are modified to reflect the new cost. A message appears listing the ports whose port-VLAN costs were changed.

Example

This example shows how to set the channel 768 port-VLAN cost to 10:

Console> (enable) set channel vlancost 768 10
Port(s) 1/1-2 vlan cost are updated to 24.
Channel 768 vlancost is set to 10.
Console> (enable)

set cops

Use the set cops commands to configure COPS functionality.

set cops server ipaddress [port] [primary]
set cops domain-name domain_name
set cops retry-interval initial incr max
set cops roles {role_name}

Syntax Description

server	Keyword that specifies to set the name of the COPS server.
ipaddress	IP address or IP alias of the server.
port	(Optional) Number of the TCP port the switch connects to on the server.
primary	(Optional) Keyword that specifies the primary server.
domain-name domain_name	Keyword and variable that specifies the domain name of the switch.
retry-interval	Keyword that specifies the retry interval in seconds.
initial	Initial timeout value; valid values are 0 to 65535 seconds.
incr	Incremental value; valid values are 0 to 65535 seconds.
max	Maximum timeout value; valid values are 0 to 65535 seconds.
roles	Keyword that specifies a user designated characteristic.
role_name	Keyword that specifies a user-designated physical characteristic (such as backbone, branchoffice, etc.). A switch may have multiple roles, and up to 64 roles may be configured per switch.

Default

The defaults are as follows:

The retry interval default values are initial = 30 seconds, incr = 30 seconds, max = 5 minutes.
The default domain-name is a string of length zero.
No PDP servers are configured.

Supported Platforms

Catalyst 5000 family switches

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

You can configure the names or addresses of up to two PDP servers. One must be the primary, and the optional second server is a secondary, or backup, PDP server.

The COPS domain name can only be set globally; there is no option to set it for each COPS client.

Names such as the server, domain-name, and roles can contain a maximum of 31 characters; longer names are truncated to 31 characters. Valid letters are a-z and A-Z. Valid numbers are 0-9. Valid symbols are period (.), dash (-) and underscore (_). Names cannot start with an underscore (_). The names are not case sensitive for matching, but are case sensitive for display.

When specifying the retry-interval, the total of the initial timeout value and the incremental value (increment on each subsequent failure) may not exceed the maximum timeout value.

Examples

This example shows how to configure a server as a primary server:

Console> (enable) set cops server 171.21.34.56 primary
171.21.34.56 added to COPS server table as primary server.
Console> (enable)

This example shows how to configure a server as a primary RSVP+ server:

Console> (enable) set cops server 171.21.34.56 primary 
171.21.34.56 added to COPS server table as primary server.
Console> (enable)

This example shows how to configure a server as a secondary (or backup) server:

Console> (enable) set cops server my_server2
my_server2 added to the COPS server table as backup server.
Console> (enable)

This example shows how to set the domain name:

Console> (enable) set cops domain-name my_domain
Domain name set to my_domain.
Console> (enable)

This example shows how to set the retry interval:

Console> (enable) set cops retry-interval 15 1 30
Connection retry intervals set.
Console> (enable)

This example shows the display output if the total of the initial timeout value and the incremental value you entered exceeds the maximum timeout value:

Console> (enable) set cops retry-interval 15 1 10
The initial timeout plus the increment value may not exceed the max value.
Console> (enable)

This example shows how to set the switch with the role backbone:

Console> (enable) set cops roles backbone     
Role added successfully.
Console> (enable)

Related Commands

clear cops
show cops

name	Alias being created.
command	Command for which the alias is being created.
parameter	(Optional) Parameters that apply to the command for which an alias is being created. See the specific command for information about parameters that apply.

dynamic	(Optional) Keyword that specifies that entries are subject to ARP aging updates.
permanent	(Optional) Keyword that specifies that permanent entries are stored in NVRAM until they are removed by the clear arp or clear config command.
static	(Optional) Keyword that specifies that entries are not subject to ARP aging updates.
ip_addr	(Optional) IP address or IP alias to map to the specified MAC address.
hw_addr	(Optional) MAC address to map to the specified IP address or IP alias.
agingtime	Keyword to set the period of time after which an ARP entry is removed from the ARP table.
agingtime	Number of seconds (from 0 to 1,000,000) that entries will remain in the ARP table before being deleted. Setting this value to 0 disables aging.

Table of Contents

Syntax Description

Default

Supported Platforms

Command Type

Command Mode

Example

Related Command

Syntax Description

Default

Supported Platforms

Command Type

Command Mode

Usage Guidelines

Example

Related Command

Syntax Description

Default

Supported Platforms

Command Type

Command Mode

Usage Guidelines

Example

Related Command

Syntax Description

Default

Supported Platforms

Command Type

Command Mode

Usage Guidelines

Example

Related Command

Syntax Description

Default

Supported Platforms

Command Type

Command Mode

Usage Guidelines

Examples

Related Command

Syntax Description

Default

Supported Platforms

Command Type

Command Mode

Usage Guidelines

Example

Related Command

Syntax Description

Default

Supported Platforms

Command Type

Command Mode

Usage Guidelines

Example

Related Command

Syntax Description

Default

Supported Platforms

Command Type

Command Mode

Usage Guideline

Example

Related Commands

Syntax Description

Default

Supported Platforms

Command Type

Command Mode

Usage Guideline

Examples

Related Commands

Syntax Description

Default

Supported Platforms

Command Type

Command Mode

Usage Guidelines

Examples

Related Commands