P Commands

This chapter describes the system management commands that begin with P.

poweroff module

form of this command.

 
Syntax Description

Module number. The range is from 1 to 18.

 
Defaults

None

 
Command Default

Global configuration (config)

 
Supported User Roles

network-admin

vdc-admin

 
Command History

Release
Modification

5.0(3)

The command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to power off module 2:

switch# poweroff module 2

 
Related Commands

Command
Description

Displays information about modules.

ptp announce

form of this command.

}

 
Syntax Description

The number of log seconds between PTP announcement messages. The range is from 0 to 4 seconds.

The number of PTP intervals before a timeout occurs on the interface. The range is from 2 to 10.

 
Command Default

The default interval is 1 log second.

The default timeout is 3 announce intervals.

 
Command Modes

Interfaces configuration mode

 
Command History

Release
Modification

5.2(1)N1(1)

This command was introduced.

Examples

This example shows how to set the announcement interval on interface 5/1 to 1:

switch# configure terminal
switch(config) # interface ethernet 5/1
switch(config-if)# ptp announce interval 1
switch(config-if)

 
Related Commands

Command
Description

Enables or disables PTP on the device.

Configures the minimum interval allowed between PTP delay-request messages when the port is in the master state.

Configures the interval between PTP synchronization messages on an interface.

Configures the VLAN for the interface where PTP is being enabled.

Displays the PTP status.

Displays the status of the PTP port on the switch.

ptp delay request minimum interval

form of this command.

 
Syntax Description

The number of log seconds between PTP delay request messages. The range is from -1 to 6 seconds.

 
Command Default

0 log seconds

 
Command Modes

Interface configuration mode

 
Command History

Release
Modification

5.2(1)N1(1)

This command was introduced.

Examples

This example shows how to set the minimum delay request interval to 3:

switch# configure terminal
switch(config) # interface ethernet 5/1
switch(config-if) # ptp delay request minimum interval 3

 
Related Commands

Command
Description

Enables or disables PTP on the device.

Configures the interval between PTP announce messages on an interface or the number of PTP intervals before a timeout occurs on an interface.

Configures the interval between PTP synchronization messages on an interface.

Configures the VLAN for the interface where PTP is being enabled.

Displays the PTP status.

Displays the status of the PTP port on the switch.

ptp domain

command. PTP domains allow you touse multiple independent PTP clocking subdomains on a single network.

 
Syntax Description

Configures the domain number to use for this clock. The range is from 0 to 128.

 
Command Default

0

 
Command Modes

Global configuration mode

 
Command History

Release
Modification

5.2(1)N1(1)

This command was introduced.

Examples

This example shows how to configure the domain number for use with a clock:

switch(config)# ptp domain 1
 

 
Related Commands

Command
Description

Enables or disables PTP on the device.

Configures the source IP address for all PTP packets.

Configures the priority 1 value to use when advertising this clock.

Configures the priority 1 value to use when advertising this clock.

Displays the PTP status.

Displays the properties of the local clock.

ptp priority1

command.

 
Syntax Description

The configured value overrides the default criteria (clock quality, clock class, etc.) for best master clock selection. Lower values take precedence. The range is from 0 to 255.

 
Command Default

255 when advertising the clock

 
Command Modes

Global configuration mode

 
Command History

Release
Modification

5.2(1)N1(1)

This command was introduced.

Examples

This example shows how to set the priority1 value used to advertise this clock:

switch(config)# ptp priority1 10
 

 
Related Commands

Command
Description

Enables or disables PTP on the device.

Configures the source IP address for all PTP packets.

Configures the domain number to use for this clock.

Configures the priority2 value to use when advertising this clock.

Displays the PTP status.

Displays the properties of the local clock.

ptp priority2

command.

 
Syntax Description

The configured value is used to decide between two devices that are otherwise equally matched in the default criteria. For example, you can use the priority2 value to give a specific switch priority over other identical switches. The range is from 0 to 255.

 
Command Default

255 when advertising the clock

 
Command Modes

Global configuration mode

 
Command History

Release
Modification

5.2(1)N1(1)

This command was introduced.

Examples

This example shows how to set the priority2 value used to advertise this clock:

switch(config)# ptp priority2 20
 

 
Related Commands

Command
Description

Enables or disables PTP on the device.

Configures the source IP address for all PTP packets.

Configures the domain number to use for this clock.

Configures the priority1 value to use when advertising this clock.

Displays the PTP status.

Displays the properties of the local clock.

ptp source

form of this command.

 
Syntax Description

Specifies the source IP address for all PTP packets. The IP address can be in IPv4 or IPv6 format.

Specifies the VRF.

 
Command Default

None

 
Command Modes

Global configuration mode

 
Command History

Release
Modification

5.2(1)N1(1)

This command was introduced.

Examples

This example shows how to configure the source IP address for all PTP packets:

switch(config)# ptp source 192.0.2.1
 

 
Related Commands

Command
Description

Enables or disables PTP on the device.

Configures the domain number to use for this clock.

Configures the priority 1 value to use when advertising this clock.

Configures the priority 1 value to use when advertising this clock.

Displays the PTP status.

Displays the properties of the local clock.

ptp sync interval

form of this command.

 
Syntax Description

The number of log seconds between PTP synchronization messages on an interface. The range is from -3 seconds to 1 second.

 
Command Default

None

 
Command Modes

Interface configuration mode

 
Command History

Release
Modification

5.2(1)N1(1)

This command was introduced.

Examples

This example shows how to set the PTP synchronization interval to -3:

switch# configure terminal
switch(config) # interface ethernet 5/1
switch(config-if) # ptp sync interval -3

 
Related Commands

Command
Description

Enables or disables PTP on the device.

Configures the interval between PTP announce messages on an interface or the number of PTP intervals before a timeout occurs on an interface.

Configures the minimum interval allowed between PTP delay-request messages when the port is in the master state.

Configures the VLAN for the interface where PTP is being enabled.

Displays the PTP status.

Displays the status of the PTP port on the switch.

ptp vlan

form of this command.

 
Syntax Description

The VLAN ID for the interface where PTP is being enabled. The range is from 1 to 4094.

 
Command Default

1

 
Command Modes

Interface configuration mode

 
Command History

Release
Modification

5.2(1)N1(1)

This command was introduced.

 
Usage Guidelines

PTP can only be enabled on one VLAN on an interface.

Examples

This example shows how to specify VLAN 10 as the interface where PTP is being enabled:

switch# configure terminal
switch(config) # interface ethernet 5/1
switch(config-if) # ptp vlan 10

 
Related Commands

Command
Description

Enables or disables PTP on the device.

Configures the interval between PTP announce messages on an interface or the number of PTP intervals before a timeout occurs on an interface.

Configures the minimum interval allowed between PTP delay-request messages when the port is in the master state.

Configures the interval between PTP synchronization messages on an interface.

Displays the PTP status.

Displays the status of the PTP port on the switch.