P Commands

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

poweroff module

To power off a module, use the poweroff module command. To return power to the module, use the no form of this command.

poweroff module module

no poweroff module module

 
Syntax Description

module

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

show module

Displays information about modules.

ptp announce

To configure the interval between PTP announcement messages on an interface or the number of PTP intervals before a timeout occurs on an interface, use the ptp announce command. To disable this feature, use the no form of this command.

ptp announce { interval log-seconds | timeout count }

no ptp announce

 
Syntax Description

interval log-seconds

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

timeout count

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

feature ptp

Enables or disables PTP on the device.

ptp delay request minimum interval

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

ptp sync interval

Configures the interval between PTP synchronization messages on an interface.

ptp vlan

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

show ptp brief

Displays the PTP status.

show ptp port interface ethernet

Displays the status of the PTP port on the switch.

ptp delay request minimum interval

To configure the minimum interval allowed between PTP delay request messages when the port is in the master state, use the ptp delay request minimum interval command. To disable this feature, use the no form of this command.

ptp delay request minimum interval log-seconds

no ptp delay request minimum interval

 
Syntax Description

log-seconds

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

feature ptp

Enables or disables PTP on the device.

ptp announce

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

ptp sync interval

Configures the interval between PTP synchronization messages on an interface.

ptp vlan

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

show ptp brief

Displays the PTP status.

show ptp port interface ethernet

Displays the status of the PTP port on the switch.

ptp domain

To configure the domain number to use for this clock, use the ptp domain command. PTP domains allow you touse multiple independent PTP clocking subdomains on a single network.

ptp domain number

no ptp domain number

 
Syntax Description

number

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

feature ptp

Enables or disables PTP on the device.

ptp source

Configures the source IP address for all PTP packets.

ptp priority1

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

ptp priority2

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

show ptp brief

Displays the PTP status.

show ptp clock

Displays the properties of the local clock.

ptp priority1

To configure the priority1 value to use when advertising this clock, use the ptp priority1 command.

ptp priority1 value

no ptp priority1 value

 
Syntax Description

value

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

feature ptp

Enables or disables PTP on the device.

ptp source

Configures the source IP address for all PTP packets.

ptp domain

Configures the domain number to use for this clock.

ptp priority2

Configures the priority2 value to use when advertising this clock.

show ptp brief

Displays the PTP status.

show ptp clock

Displays the properties of the local clock.

ptp priority2

To configure the priority2 value to use when advertising this clock, use the ptp priority2 command.

ptp priority2 value

no ptp priority2 value

 
Syntax Description

value

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

feature ptp

Enables or disables PTP on the device.

ptp source

Configures the source IP address for all PTP packets.

ptp domain

Configures the domain number to use for this clock.

ptp priority1

Configures the priority1 value to use when advertising this clock.

show ptp brief

Displays the PTP status.

show ptp clock

Displays the properties of the local clock.

ptp source

To configure the source IP address for all PTP packets, use the ptp source command. To unconfigure the source IP address for all PTP packets, use the no form of this command.

ptp source ip-address [ vrf vrf ]

no ptp source ip-address [ vrf vrf ]

 
Syntax Description

ip-address

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

vrf vrf

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

feature ptp

Enables or disables PTP on the device.

ptp domain

Configures the domain number to use for this clock.

ptp priority1

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

ptp priority2

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

show ptp brief

Displays the PTP status.

show ptp clock

Displays the properties of the local clock.

ptp sync interval

To configure the interval between PTP synchronization messages, use the ptp sync interval command. To disable this feature, use the no form of this command.

ptp sync interval log-seconds

no ptp sync interval

 
Syntax Description

log-seconds

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

feature ptp

Enables or disables PTP on the device.

ptp announce

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

ptp delay request minimum interval

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

ptp vlan

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

show ptp brief

Displays the PTP status.

show ptp port interface ethernet

Displays the status of the PTP port on the switch.

ptp vlan

To specify the VLAN for the interface where PTP is being enabled, use the ptp vlan command. To disable this feature, use the no form of this command.

ptp vlan vlan-id

no ptp vlan

 
Syntax Description

vlan-id

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

feature ptp

Enables or disables PTP on the device.

ptp announce

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

ptp delay request minimum interval

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

ptp sync interval

Configures the interval between PTP synchronization messages on an interface.

show ptp brief

Displays the PTP status.

show ptp port interface ethernet

Displays the status of the PTP port on the switch.