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. |
Command Default
Global configuration (config)
network-admin
vdc-admin
Command History
|
|
6.0(2)N1(1) |
This 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
|
|
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
|
|
6.0(2)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
Related Commands
|
|
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
|
|
6.0(2)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
|
|
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 Modes
Global configuration mode
Command History
|
|
6.0(2)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
|
|
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
|
|
6.0(2)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
|
|
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
|
|
6.0(2)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
|
|
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 Modes
Global configuration mode
Command History
|
|
6.0(2)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
|
|
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 Modes
Interface configuration mode
Command History
|
|
6.0(2)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
|
|
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 Modes
Interface configuration mode
Command History
|
|
6.0(2)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
|
|
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. |