Cisco Nexus 7000 Series NX-OS Unicast Routing Command Reference, Release 4.0
P Commands

Table Of Contents

P Commands

platform ip verify

platform ip verify address

platform ip verify length

platform ipv6 verify

policy statistics enable (OSPFv3)

preempt (GLBP)

preempt (HSRP)

preempt (VRRP)

priority (GLBP)

priority (HSRP)

priority (VRRP)

protocol shutdown (OSPF)

protocol shutdown (OSPFv3)


P Commands


This chapter describes the Cisco NX-OS unicast routing commands that begin with the letter P.

platform ip verify

To configure IP packet verification, use the platform ip verify command. To return to default, use the no form of this command.

platform ip verify {checksum | fragment | tcp tiny-frag | version}

no platform ip verify {checksum | fragment}

Syntax Description

checksum

Drops IPv4 or IPv6 packets if the checksum is invalid

fragment

Drops IPv4 or IPv6 packets if the packet fragment has a nonzero offset and the DF bit is active.

tcp tiny-frag

Drops IPv4 packets if the IP fragment offset is 1, or if the IP fragment offset is 0 and the IP payload length is less than 16.

version

Drops IPv4 packets if the ethertype is not set to 4 (IPv4).


Defaults

All address tests enabled.

Command Modes

Global configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

Use the platform ip verify command to configure packet verification tests on IPv4 and IPv6 packets based on checksum or fragments.

This command does not require a license.

Examples

This example shows how to drop fragmented IPv4 or IPv6 packets:

switch(config)# platform ip verify fragment 

Related Commands

Command
Description

platform ip verify address

Configures IPv4 and IPv6 packet verification checks based on addresses.

platform ip verify length

Configures IPv4 packet verification checks based on length.

platform ipv6 verify

Configures IPv6 packet verification.

show hardware forwarding ip verify

Displays information about IP packet verification checks.


platform ip verify address

To packet verification on IP addresses, use the platform ip verify address command. To return to default, use the no form of this command.

platform ip verify address {destination zero | identical | reserved | source {broadcast | multicast}}

no platform ip verify address {destination zero | identical | reserved | source {broadcast | multicast}}

Syntax Description

destination zero

Drops IP packets if the destination IPv4 address is 0.0.0.0 or if the IPv6 address is ::..

identical

Drops IP packets if the source IPv4 or IPv6 address is identical to the destination IPv4 or IPv6 address.

reserved

Drops IP packets if the IPv4 address is in the 127.x.x.x range or if the IPv6 address is in the ::1 range.

source

Drops IP packets based on the IP source address

broadcast

Drops IP packets if the IP source address is 255.255.255.255

multicast

Drops IP packets if the IPv4 source address is in the 224.x.x.x range or if the IPv6 source address is in the FF00::/8 range.


Defaults

All address tests enabled.

Command Modes

Global configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

Use the platform ip verify address command to configure packet verification tests on IPv4 and IPv6 packets based on addresses.

This command does not require a license.

Examples

This example shows how to drop broadcast IPv4 packets:

switch(config)# platform ip verify address source broadcast

Related Commands

Command
Description

platform ip verify

Configures IPv4 and IPv6 packet verification checks based on checksum or fragments.

platform ip verify length

Configures IPv4 packet verification checks based on length.

platform ipv6 verify

Configures IPv6 packet verification.

show hardware forwarding ip verify

Displays information about IP packet verification checks.


platform ip verify length

To configure IPv4 packet verification based on packet length, use the platform ip verify length command. To return to default, use the no form of this command.

platform ip verify length {consistent | maximum {max-frag | max-tcp | udp} | minimum}

no platform ip verify length {consistent | maximum {max-frag | max-tcp | udp} | minimum}

Syntax Description

consistent

Drops IPv4 packets where the Ethernet frame size is greater than or equal to the IP packet length plus the Ethernet header.

maximum {max-frag | max-tcp | udp}

Drops IPv4 packets based on the following:

max-frag—Drops IP packets if the maximum fragment offset is greater than 65536.

max-tcp—Drops IP packets if the TCP length is greater than the IP payload length.

udp—Drops IP packets if the IP payload length is less than the UDP packet length.

minimum

Drops IP packets if the Ethernet frame length is less than the IP packet length plus four octets (the CRC length).


Defaults

All address tests enabled.

Command Modes

Global configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

Use the platform ip verify length command to configure packet verification tests on IPv4 and IPv6 packets based on packet length

This command does not require a license.

Examples

This example shows how to drop minimum-length IPv4 packets:

switch(config)# platform ip verify length minimum

Related Commands

Command
Description

platform ip verify

Configures IPv4 packet verification checks based on checksum or fragments.

platform ip verify address

Configures IPv4 and IPv6 packet verification checks based on addresses.

platform ipv6 verify

Configures IPv6 packet verification.

show hardware forwarding ip verify

Displays information about IP packet verification checks.


platform ipv6 verify

To configure IPv6 packet verification, use the platform ipv6 verify command. To return to default, use the no form of this command.

platform ipv6 verify {length {consistent | maximum {max-frag | max-tcp | udp} | tcp tiny-frag | version}

no platform ip verify {checksum | fragment}

Syntax Description

length

Drops IPv6 packets based on length.

consistent

Drops IPv6 packets where the Ethernet frame size is greater than or equal to the IPv6 packet length plus the Ethernet header.

maximum {max-frag | max-tcp | udp}

Drops IPv6 packets based on the following:

max-frag—Drops IPv6 packets if the formula (IPv6 Payload Length - IPv6 Extension Header Bytes) + (Fragment Offset * 8) is greater than 65536.

max-tcp—Drops IPv6 packets if the TCP length is greater than the IP payload length.

udp—Drops IPv6 packets if the IP payload length is less than the UDP packet length.

tcp tiny-frag

Drops IPv6 packets if the IP fragment offset is 1, or if the IPv6 fragment offset is 0 and the IPv6 payload length is less than 16.

version

Drops IPv6packets if the ethertype is not set to 6 (IPv6).


Defaults

All address tests enabled.

Command Modes

Global configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

Use the platform ipv6 verify command to configure packet verification tests on IPv6 packets.

This command does not require a license.

Examples

This example shows how to drop all IPv4 packets:

switch(config)# platform ipv6 verify version 

Related Commands

Command
Description

platform ip verify address

Configures IPv4 and IPv6 packet verification checks based on addresses.

platform ip verify length

Configures IPv4 packet verification checks based on length.

show hardware forwarding ip verify

Displays information about IP packet verification checks.


policy statistics enable (OSPFv3)

To enable Open Shortest Path First version 3 (OSPFv3) policy statistics, use the policy statistics enable command. To disable policy statistics, use the no form of this command.

policy statistics enable

no policy statistics enable

Syntax Description

This command has no keywords or arguments.

Defaults

Policy statistics are disabled.

Command Modes

Router configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

Use the policy statistics enable command to enable statistics gathering based on route policies applied to this OSPFv3 instance.

This command requires the Enterprise Services license.

Examples

This example shows how to enable policy statistics gathering on OSPFv3 2:

switch(config)# ospfv3 2
switch(config-router)# policy statistics enable

Related Commands

Command
Description

show ospfv3 policy statistics

Shows policy statistics.


preempt (GLBP)

To configure the gateway to take over as active virtual gateway (AVG) for a Gateway Load Balancing Protocol (GLBP) group if it has a higher priority than the current AVG, use the glbp preempt command. To disable this feature, use the no form of this command.

preempt [delay minimum seconds | sync seconds]

no preempt [delay minimum seconds | sync seconds]

Syntax Description

delay minimum seconds

(Optional) Specifies a minimum number of seconds that the gateway delays before taking over the role of AVG. The range is from 0 to 3600 seconds with a default delay of 30 seconds.

sync seconds

(Optional) Specifies a number of seconds that the gateway waits for the synchronization to complete. The range is from 0 to 3600 seconds.


Defaults

A GLBP gateway with a higher priority than the current AVG cannot assume the role of AVG.
The default delay value is 30 seconds.

Command Modes

GLBP configuration

Supported User Roles

Network Administrator
VDC Administrator

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

The following example shows how to configure a router to preempt the current AVG when its priority of 254 is higher than the current AVG. If the router preempts the current AVG, it waits 60 seconds before assuming the role of AVG.

switch(config-if)# glbp 10 
switch(config-glbp)# preempt delay minimum 60
switch(config-glbp)# priority 254

Related Commands

Command
Description

glbp

Enters GLBP configuration mode and creates a GLBP group.

priority

Sets the priority level of the router within a GLBP group.


preempt (HSRP)

To configure a preemption delay, use the preempt command. To disable this feature, use the no form of this command.

preempt [delay {minimum min-delay | reload rel-delay | sync sync-delay}]

no preempt [delay {minimum min-delay | reload rel-delay | sync sync-delay}]

Syntax Description

delay minimum min-delay

(Optional) The minimum number of seconds that preemption is delayed to allow routing tables to be updated before a router becomes active. The default value is 0.

reload rel-delay

(Optional) The time delay after the router has reloaded. This period applies only to the first interface-up event after the router has reloaded. The default value is 0.

sync seconds

(Optional) Specifies the maximum number of seconds to allow IP redundancy clients to prevent preemption. When this period expires, preemption occurs regardless of the state of the IP redundancy clients. The default value is 0.


Defaults

The default delay time for all options is 0 seconds.

Command Modes

Interface configuration or HSRP template mode

Supported User Roles

Network administrator
VDC administrator

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Specifying a minimum delay allows routing tables to be updated before a router becomes active. When a router first comes up, it does not have a complete routing table. Note that a high-priority router will only delay preemption if it first receives a Hello packet from a low-priority active router. If the high-priority router does not receive a Hello packet from the low-priority active router when it is starting up, then it assumes there is no active router for the group and will become active as soon as possible.

Examples

This example shows how to configure a delay when a router becomes active when its priority 110.

switch# configure terminal
switch(config)# interface ethernet 0/1
switch(config-if)# ip address 10.0.0.1 255.255.255.0
switch(config-if)# hsrp 4
switch(config-if-hsrp)# priority 110
switch(config-if-hsrp)# preempt
switch(config-if-hsrp)# authentication text sanjose
switch(config-if-hsrp)# ip 10.0.0.3
switch(config-if-hsrp)# end

Related Commands

Command
Description

feature hsrp

Enables HSRP configuration.

show hsrp

Displays HSRP information.


preempt (VRRP)

To enable a high-priority backup virtual router to preempt the low-priority master virtual router, use the preempt command. To disable a high-priority backup virtual router from preempting the low-priority master virtual router, use the no form of this command.

preempt

no preempt

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

VRRP configuration mode

Supported User Roles

Superuser
VDC administrator

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

VRRP enables you to preempt a virtual router backup that has taken over for a failing virtual router master with a high-priority virtual router backup that has become available.

By default, a preemptive scheme is enabled. A backup high-priority virtual router that becomes available takes over for the backup virtual router that was elected to become the virtual router master. If you disable preemption, then the backup virtual router that is elected to become the virtual router master remains the master until the original virtual router master recovers and becomes the master again.

If the virtual IP address is also the IP address for the interface, then preemption is applied.

No license is required to use this command.

Examples

This example shows how to enable the backup high-priority virtual router to preempt the low-priority master virtual router:


Note This preemption does not apply to the primary IP address.


switch# config t
switch(config)# interface ethernet 2/1
switch(config-if)# vrrp 250 
switch(config-if-vrrp)# preempt 

Related Commands

Command
Description

show vrrp

Displays VRRP configuration information.

clear vrrp

Clears all the software counters for the specified virtual router.


priority (GLBP)

To set the priority level of the gateway within a Gateway Load Balancing Protocol (GLBP) group, use the priority command. To remove the priority level of the gateway, use the no form of this command.

priority level

no priority

Syntax Description

level

Priority of the gateway within the GLBP group. The range is from 1 to 255. The default is 100.


Defaults

level: 100

Command Modes

GLBP configuration

Supported User Roles

Network Administrator
VDC Administrator

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

Use the priority command to control which virtual gateway becomes the active virtual gateway (AVG). GLBP compares the priorities of all virtual gateways in the GLBP group and selects the gateway with the numerically highest priority as the AVG. If two virtual gateways have equal priority, GLBP selects the gateway with the highest IP address.

This command does not require a license.

Examples

The following example shows how to configure a virtual gateway with a priority of 254:

switch(config-if)# glbp 10 
switch(config-glbp)# priority 254

Related Commands

Command
Description

glbp

Enters GLBP configuration mode and creates a GLBP group.

preempt

Configures a gateway to take over as the AVG for a GLBP group if it has a higher priority than the current AVG.


priority (HSRP)

To set the priority level within a Hot Standby Router Protocol (HSRP) group, use the priority command. To remove the priority level, use the no form of this command.

priority level

no priority

Syntax Description

level

Interface priority for a virtual router. The range of values is from 1 to 255. If this router is the owner of the IP addresses, then the value is automatically set to 255. The default is 100.


Defaults

level: 100

Command Modes

HSRP configuration or HSRP template mode

Supported User Roles

Network administrator
VDC administrator

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

Use the priority command to control which virtual router becomes the active router. HSRP compares the priorities of all virtual routers in the HSRP group and selects the router with the numerically highest priority. If two virtual routers have equal priority, HSRP selects the router with the highest IP address.

This command does not require a license.

Examples

This example shows how to configure a virtual router with a priority of 254:

switch# configure terminal
switch(config)# interface ethernet 0/1
switch(config-if)# ip address 10.0.0.1 255.255.255.0
switch(config-if)# hsrp 4
switch(config-if-hsrp)# priority 254

Related Commands

Command
Description

feature hsrp

Enables HSRP configuration.

show hsrp

Displays HSRP information.


priority (VRRP)

To set the priority for the Virtual Router Redundancy Protocol (VRRP), use the priority command. To revert to the default value, use the no form of this command.

priority value

no priority

Syntax Description

value

Interface priority for a virtual router. The range of values is from 1 to 255. If this router is the owner of the IP addresses, then the value is automatically set to 255.


Defaults

The default value is 100. For switches whose interface IP address is the same as the primary virtual IP address, the default value is 255.

Command Modes

VRRP configuration mode

Supported User Roles

Superuser
VDC administrator

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

The priority determines whether or not a VRRP router functions as a virtual router backup, the order of ascendancy for the VRRP router to become a virtual router master if the virtual router master fails, the role that each VRRP router plays, and what happens if the virtual router master fails.

If a VRRP router owns the IP address of the virtual router and the IP address of the physical interface, then this router will function as a virtual router master.

By default, a preemptive scheme is enabled. A backup high-priority virtual router that becomes available takes over for the backup virtual router that was elected to become the virtual router master. If you disable preemption, then the backup virtual router that is elected to become the virtual router master remains the master until the original virtual router master recovers and becomes the master again.

No license is required to use this command.

Examples

This example shows how to specify the priority for a virtual router:

switch# config t
switch(config)# interface ethernet 2/1
switch(config-if)# vrrp 250 
switch(config-if-vrrp)# priority 2

Related Commands

Command
Description

feature vrrp

Enables VRRP.

show vrrp

Displays VRRP configuration information.


protocol shutdown (OSPF)

To shut down an Open Shortest Path First (OSPF) instance, use the protocol shutdown command. To disable this function, use the no form of this command.

protocol shutdown

no protocol shutdown

Syntax Description

This command has no keywords or arguments.

Defaults

The OSPF instance is enabled by default when configured.

Command Modes

Router configuration
Router VRF configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

Use the protocol shutdown command to configure disable an instance of OSPF without removing the configuration.

This command requires the Enterprise Services license.

Examples

The following example shows how to disable OSPF 209:

switch(config) router ospf 209
switch(config-router)# protocol shutdown

protocol shutdown (OSPFv3)

To shut down an Open Shortest Path First version 3 (OSPFv3) instance, use the protocol shutdown command. To disable this function, use the no form of this command.

protocol shutdown

no protocol shutdown

Syntax Description

This command has no keywords or arguments.

Defaults

The OSPFv3 instance is enabled by default when configured.

Command Modes

Router configuration
Router VRF configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

Use the protocol shutdown command to configure disable an instance of OSPFv3 without removing the configuration.

This command requires the Enterprise Services license.

Examples

This example shows how to disable OSPFv3 209:

switch(config) router ospfv3 209
switch(config-router)# protocol shutdown