PTP Commands
protocol ptp Enables PTP on the switch. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | config | |
History | 3.6.4110 | |
Example | switch (config) # protocol ptp | |
Related Commands | ||
Notes |
ptp amt <clock-id> Adds an acceptable master table entry. | ||
Syntax Description | clock-id | Clock ID |
Default | N/A | |
Configuration Mode | config | |
History | 3.6.8100 | |
Example | switch (config) # ptp amt 00:11:22:FF:FE:33:44:55:66 | |
Related Commands | show ptp amt | |
Notes |
ptp announce interval <interval> Configures PTP announce interval. | ||
Syntax Description | interval | Range: -3 to 1 |
Default | N/A | |
Configuration Mode | config interface port-channel | |
History | 3.6.4110 | |
3.6.8008 | Added “interface vlan” configuration mode | |
3.6.8100 | Added "interface port-channel" configuration mode | |
Example | switch (config 1/1) # ptp announce interval -2 | |
Related Commands | show ptp interface | |
Notes |
ptp announce timeout <timeout> Configures PTP announce timeout. | ||
Syntax Description | timeout | Range: 2-10 |
Default | N/A | |
Configuration Mode | config interface port-channel | |
History | 3.6.4110 | |
3.6.8008 | Added “interface vlan” configuration mode | |
3.6.8100 | Added "interface port-channel" configuration mode | |
Example | switch (config 1/1) # ptp announce timeout 3 | |
Related Commands | show ptp interface | |
Notes |
ptp delay-req interval <interval> Configures PTP delay-req interval. | ||
Syntax Description | interval | Range: 0-5 Default: 0 |
Default | N/A | |
Configuration Mode | config interface port-channel | |
History | 3.6.4110 | |
3.6.8008 | Added “interface vlan” configuration mode | |
3.8.8100 | "interface port-channel" configuration mode | |
3.9.0600 | Updated example and added note | |
Example | switch (config 1/1) # ptp delay-req interval 0 | |
Related Commands | show ptp interface | |
Notes | IEEE 1588 defines delay-request as an offset from Sync Interval (logSyncInt). A value of 0 therefore matches the defined logSyncInt value. |
ptp domain <domain number> Inserts the number of ptp domain. | ||
Syntax Description | domain number | Range: 0-127 |
Default | 127 | |
Configuration Mode | config | |
History | 3.6.4110 | |
Example | switch (config) # ptp domain | |
Related Commands | show ptp clock | |
Notes |
ptp enable Enables PTP per interface. | ||
Syntax Description | N/A | |
Default | no ptp enable | |
Configuration Mode | config interface ethernet | |
History | 3.6.4110 | |
3.6.8008 | Added “config interface vlan” configuration mode | |
3.6.8100 | Added “config interface port-channel” configuration mode | |
Example | switch (config interface ethernet 1/1) # ptp enable | |
Related Commands | show ptp | |
Notes |
ptp enable forced-master Configures PTP interfaces to forced master state. The command allows dropping both announce and mgmt PTP messages from other PTP peers in the network. | ||
Syntax Description | N/A | |
Default | no ptp enable forced-master | |
Configuration Mode | config interface ethernet | |
History | 3.6.8100 | |
3.9.2300 | Added note and modified command description. | |
Example | switch (config interface ethernet 1/1) # ptp enable forced-master | |
Related Commands | show ptp | |
Notes | In order to enable forced-master on the VLAN/LAG, it should be enabled on the VLAN/LAG members as well as on the VLAN/LAG itself. |
ptp enable forced-master allow-mgmt Configures PTP interfaces to forced master state. The command drops only announce PTP messages and allows passing mgmt PTP messages from other PTP peers in the network. | ||
Syntax Description | N/A | |
Default | no ptp enable forced-master allow-mgmt | |
Configuration Mode | config interface ethernet | |
History | 3.9.2300 | |
Example | switch (config 1/1) # ptp enable forced-master allow-mgmt | |
Related Commands | ptp enable forced-master | |
Notes | In order to enable forced-master allow-mgmt on the VLAN/LAG, it should be enabled on the VLAN/LAG members as well as on the VLAN/LAG itself. |
ptp enable [forced-master] [ipv6 [mcast-scope link-local]] no ptp enable [forced-master] [ipv6 [mcast-scope link-local]] Configures PTP on the ethernet interface and enables the forced-master and support of IPv6 with a specified scope. | ||
Syntax Description | mcast-scope link-local | Sets the IPv6 multicast scope to link-local. |
Default | no ptp enable ipv6 | |
Configuration Mode | config interface ethernet | |
History | 3.8.2000 | |
Example | switch (config interface ethernet 1/1) # ptp enable ipv6 mcast-scope link-local | |
Related Commands | show ptp | |
Notes | When configuring PTP IPv6, the "global" multicast scope is the default. |
ptp mean-path-delay <value> Enables logging of the mean path delay value if it exceeds the specified threshold. | ||
Syntax Description | value | 10-1000000000 (ns). Default 1000000000 |
Default | Enabled | |
Configuration Mode | config | |
History | 3.8.2100 | |
Example | switch (config) # ptp mean-path-delay 10000000 | |
Logging Examples | Example of ptp mean-path-delay 10: Nov 11 16:18:04 arc-switch142 ptp4l: [3083.530] PTP [Debuggability]: PTP Grandmaster clock has changed from ec0d9a.fffe.603848 to 248a07.fffe.9e9adc | |
Related Commands | show ptp clock | |
Notes | If the mean path delay exceeds the threshold, the following ptp4l log message will appear: “Oct 11 19:04:41 arc-switch142 ptp4l: [242.721] PTP slave port Eth1/10 High Mean Path Delay 65536 (ns)” |
ptp message-format {mixed | multicast} Configures PTP delay request messages format. | ||
Syntax Description | mixed | Sends unicast delay request packets |
multicast | Sends multicast delay request packets | |
Default | mixed | |
Configuration Mode | config | |
History | 3.6.8008 | |
Example | switch (config) # ptp message-format mixed | |
Related Commands | ||
Notes |
ptp monitor interval <interval> Configure the time interval in which summary statistics of the clock are printed. It is specified as a power of two in seconds. | ||
Syntax Description | interval | Range: 0 to 20, power of two in seconds. For example, when configuring the interval to 3, the time interval will be configured to 8 seconds (23= 8 seconds). |
Default | ptp monitor interval 0 | |
Configuration Mode | config | |
History | 3.10.2000 | |
Example |
Eth1/13 2022/03/02 18:37:28.305 1 2 +23 3 104 0 | |
Related Commands | ptp monitor interval phc | |
Notes | Configure the time interval in which summary statistics of the clock are printed both in the ‘show ptp monitor’ output and into the debug log from ptp4l process (if ‘ptp monitor logging enable’ is configured). |
ptp monitor interval phc <interval> Configure the time interval in which summary statistics of the PHC clock are printed. It is specified in seconds. | ||
Syntax Description | interval | Range: 0.0 to 100000.0 seconds |
Default | ptp monitor interval phc 1.0 | |
Configuration Mode | config | |
History | 3.10.2000 | |
Example |
Eth1/13 2022/03/02 18:37:22.506 5 5 +33 3 111 0
Eth1/13 2022/03/02 18:37:22.906 4 4 +13 4 101 1 | |
Related Commands | ptp monitor interval | |
Notes | Configure the time interval in which summary statistics of the clock are printed both in the ‘show ptp monitor phc’ output and into the debug log from phc2sys process (if ‘ptp monitor logging enable’ is configured). |
ptp monitor logging enable Enables PTP monitor logging into ‘/var/log/debug’ file. | ||
Syntax Description | N/A | |
Default | Disabled | |
Configuration Mode | config interface ethernet | |
History | 3.10.2000 | |
Example |
| |
Related Commands | ptp monitor interval | |
Notes | PTP monitor logs include such parameters for ptp4l and phc2sys clock: RMS: offset root mean square |
ptp offset-from-master <value> <value> Enables logging of the offset from master value if it exceeds the specified threshold. | ||
Syntax Description | values | [-1000000000; -10] [10; 1000000000]. Default [-100000; -10] [10; 100000] |
Default | Enabled | |
Configuration Mode | config | |
History | 3.8.2100 | |
Example | switch (config) # ptp offset-from-master -100 2345 | |
Logging Example |
| |
Related Commands | show log | |
Notes | If the mean path delay exceeds the threshold, the following ptp4l log message will appear: “Oct 11 19:04:41 arc-switch142 ptp4l: [242.721] PTP slave port Eth1/10 High offset from Master 36766720739 (ns)” |
ptp priority{1 | 2} <priority> Configures PTP primary priority. | ||
Syntax Description | priority | Range: 0-255 |
Default | 128 | |
Configuration Mode | config | |
History | 3.6.4110 | |
Example | switch (config) # ptp priority1 128 | |
Related Commands | show ptp clock | |
Notes |
ptp sync interval <interval> Configures PTP sync interval. | ||
Syntax Description | interval | Range: -7 to -1 |
Default | N/A | |
Configuration Mode | config interface port-channel | |
History | 3.6.4110 | |
3.6.8008 | Added “interface vlan” configuration mode | |
3.6.8100 | Added "interface port-channel" configuration mode | |
Example | switch (config 1/1) # ptp sync interval -3 | |
Related Commands | show ptp interface | |
Notes |
ptp ttl <ttl_value> Sets the TTL value of the PTP messages. | ||
Syntax Description | ttl_value | 1-255 |
Default | PTP TTL is 1 by default. | |
Configuration Mode | config | |
History | 3.9.2000 | |
Example | switch (config) # ptp ttl 10 | |
Related Commands | show ptp | |
Notes |
clear ptp amt log Clears log of received clock IDs outside of acceptable master table. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.8100 | |
Example | switch (config) # clear ptp amt log | |
Related Commands | show ptp amt | |
Notes |
clear ptp forced-master log Clears log of received clock IDs on forced master interface. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.8100 | |
Example | switch (config) # clear ptp forced-master log | |
Related Commands | show ptp forced-master | |
Notes |
clear ptp interface [vlan <id>] [port-channel <id>] [ethernet <slot>/<port>[/<subport>]] counters Clears PTP counters for specified VLAN member interface. | ||
Syntax Description | id | VLAN or LAG ID |
<slot>/<port>/<subport> | Ethernet port ID (e.g. 1/3/1) | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.8008 | |
3.8.2000 | Added example | |
Example | switch (config 1/1) # clear ptp interface vlan 2 ethernet 1/1 counters | |
Related Commands | show ptp interface <ethernet | port-channel | vlan> counters | |
Notes |
clear ptp timeout counters Clears global PTP timeout counters. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.10.2000 | |
Example | switch (config) # clearptp timeout counters | |
Related Commands | show ptp timeout counters | |
Notes |
clear ptp vrf <vrf-name> counters Clears the PTP VRF counters. | ||
Syntax Description | vrf-name | Name of PTP enabled VRF |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.7.1000 | |
Example | switch (config) # clear ptp vrf cust1 counters | |
Related Commands | show ptp vrf counters | |
Notes | This command clears interface statistics on all PTP enabled interfaces in a specific PTP enabled VRF. |
ptp vrf <vrf-name> enable [forced-master] This command enables PTP in VRF. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Configure terminal | |
History | 3.7.1000 | |
Example | switch (config) # ptp vrf cust1 enable forced-master | |
Related Commands | show ptp | |
Related Commands | PTP needs to be enabled on interfaces in VRF as well. |
show ptp Displays PTP configuration and operation data. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.4110 | |
3.6.8008 | Updated example | |
3.6.8100 | Updated example | |
3.8.2000 | Updated example | |
3.9.2000 | Updated example, adding TTL field | |
Example | switch (config) # show ptp PTP enabled interfaces: | |
Related Commands | ||
Notes |
show ptp monitor Displays last 100 entries of the PTP clock monitor data from ptp4l process. | ||
Syntax Description | N/A | |
Default | By default, 1 entry with clock monitor data is printed per 1 second. | |
Configuration Mode | Any command mode | |
History | 3.10.2000 | |
Example |
| |
Related Commands | ptp monitor logging enable | |
Notes | PTP monitor logs include such clock parameters from ptp4l process: RMS: offset root mean square |
show ptp monitor phc Displays last 100 entries of the PTP clock monitor data from phc2sys process. | ||
Syntax Description | N/A | |
Default | By default, 1 entry with clock monitor data is printed per 1 second. | |
Configuration Mode | Any command mode | |
History | 3.10.2000 | |
Example |
Eth1/13 2022/03/02 18:37:09.906 2 2 +33 2 109 0 | |
Related Commands | ptp monitor logging enable | |
Notes | PTP monitor logs include such clock parameters from phc2sys process: RMS: offset root mean square |
show ptp timeout counters Displays global PTP timeout counters. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.10.2000 | |
Example |
| |
Related Commands | clear ptp timeout counters | |
Notes |
|
show ptp vrf <vrf_name> Displays interfaces in VRF PTP related data. | ||
Syntax Description | vrf-name | Name of PTP enabled VRF |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.7.1000 | |
3.8.2000 | Updated example | |
Example | switch (config) # show ptp vrf Interface name: Eth1/2 Interface name: Eth1/1 | |
Related Commands | ||
Notes | Displays ptp state of all PTP-enabled interfaces in all PTP-enabled VRFs. |
show ptp vrf <vrf-name> counters Displays port statistics on interfaces in VRF. | ||
Syntax Description | vrf-name | Name of PTP enabled VRF |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.7.1000 | |
Example |
| |
Related Commands | ||
Notes | Display ptp counters of all PTP enabled interfaces in specific PTP enabled VRF. |
show ptp amt Displays acceptable master table. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.8100 | |
Example | switch (config) # show ptp amt | |
Related Commands | show ptp amt log | |
Notes |
show ptp interface port-channel <po-id> Displays LAG member interfaces PTP related data. | ||
Syntax Description | po-id | LAG ID |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.7.1000 | |
3.8.2000 | Updated example | |
Example | switch (config) # show ptp interface port-channel 3 VRF: default Interface name: Eth1/11 (Po 3) VRF: default | |
Related Commands | ||
Notes |
show ptp interface port-channel <po-id> counters Displays port statistics on LAG member interfaces. | ||
Syntax Description | po-id | LAG ID |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.7.1000 | |
Example |
| |
Related Commands | ||
Notes |
show ptp amt log Displays received GMC clock IDs outside of acceptable master table. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.8100 | |
Example | ||
switch (config) # show ptp amt log ------------------------------------------------------------------------------- | ||
Related Commands | show ptp amt | |
Notes |
show ptp clock Displays configuration and operation data of PTP clock. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.4110 | |
Example |
| |
Related Commands | ||
Notes |
show ptp clock parent Displays configuration and operation data of parent PTP clock. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.4110 | |
3.8.2100 | Updated example | |
Example |
Time Traceable : 1 (True) | |
Related Commands | ||
Notes |
show ptp forced-master Displays forced master PTP interfaces. | ||
Syntax Description | N/A | |
Default | N/A | |
onfiguration ode | Any command mode | |
History | 3.6.8100 | |
Example | switch (config) # show ptp forced-master | |
Related Commands | show ptp | |
Notes |
show ptp <slot>/<port>[/<subport>] Displays PTP configuration and operation data per Ethernet port. | ||
Syntax Description | <slot>/<port>/<subport> | Ethernet port ID (e.g. 1/3/1) |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.4110 | |
3.6.8100 | Updated example | |
3.8.2000 | Updated example | |
Example | switch (config) # show ptp 1/1 Interface name: Eth1/1 | |
Related Commands | ||
Notes |
show ptp clock foreign-masters Displays all PTP foreign masters per each PTP port. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | config | |
History | 3.8.2100 | |
Example | show ptp clock foreign-masters -------------------------------------------------------------- | |
Related Commands | show ptp | |
Notes |
show ptp interface ethernet <slot>/<port>[/<subport>] counters Displays PTP counters per Ethernet port. | ||
Syntax Description | <slot>/<port>/<subport> | Ethernet port ID (e.g. 1/3/1) |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.4110 | |
3.6.8008 | Added VLAN parameter | |
Example |
| |
Related Commands | ||
Notes |
show ptp interface Displays PTP configuration and operation data for all PTP-enabled interfaces. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.8.2000 | |
Example | switch (config) # show ptp interface
| |
Related Commands | show ptp interface ethernet show ptp interface vlan | |
Notes |
show ptp interface ethernet <id> Displays PTP configuration and operation data for the ethernet interface. | ||
Syntax Description | id | Ethernet ID |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.8.2000 | |
Example | switch (config) # show ptp interface ethernet 1/12 Interface name: Eth1/12 (VLAN 12) | |
Related Commands | ||
Notes |
show ptp interface vlan <vid> Displays PTP configuration and operation data per VLAN. | ||
Syntax Description | vid | VLAN ID |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.8008 | |
3.6.8100 | Updated example | |
3.8.2000 | Updated example | |
Example | switch (config) # show ptp interface vlan 1 | |
Related Commands | ||
Notes |
show ptp interface vlan <vid> ethernet <slot>/<port>[/<subport>] Displays PTP configuration and operation data for specified VLAN member interface for a specified Ethernet port. | ||
Syntax Description | vid | VLAN ID |
<slot>/<port>/<subport> | Ethernet port ID (e.g. 1/3/1) | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.8008 | |
3.8.2000 | Updated example | |
Example | switch (config) # show ptp interface vlan 1 ethernet 1/15/1 | |
Related Commands | ||
Notes |
show ptp interface vlan <vid> counters Displays PTP counters per VLAN. | ||
Syntax Description | vid | VLAN ID |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.8008 | |
3.8.2000 | Added example | |
Example | switch (config) # show ptp interface vlan 3 counters
| |
Related Commands | ||
Notes |
show ptp interface vlan <vid> ethernet <slot>/<port>[/<subport>] counters Displays PTP counters per VLAN for a specified Ethernet port. | ||
Syntax Description | vid | VLAN ID |
<slot>/<port>/<subport> | Ethernet port ID (e.g. 1/3/1) | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.8008 | |
Example |
| |
Related Commands | ||
Notes |
show ptp time-property Displays PTP time-property parameters (time source, current utc offset etc). | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.8.2100 | |
Example |
| |
Related Commands | ||
Notes |
show ptp status Displays the last 100 entries for Offset from Master and Mean Path Delay values. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Any configuration mode | |
History | 3.8.2100 | |
Example | switch (config) # show ptp status PTP mode : Boundary Clock Interface Time Offset from Master (ns) Mean Path Delay (ns) Eth1/15 2019/11/13 16:32:00.774 -21 424 | |
Related Commands | ||
Notes |
Change of the State of Particular PTP Port
Nov 11 15:33:09 arc-switch142 ptp4l: [351.341] PTP [Debuggability]: PTP Grandmaster clock has changed from 000000.0000.000000 to ec0d9a.fffe.603848 |
Change of Grandmaster Clock
Nov 11 15:33:09 arc-switch142 ptp4l: [351.341] PTP [Debuggability]: PTP Grandmaster clock has changed from 000000.0000.000000 to ec0d9a.fffe.603848 |
Announce Interval Mismatch Notification
Nov 11 15:41:10 arc-switch142 ptp4l: [869.220] PTP [Debuggability]: PTP Grandmaster clock has changed from 000000.0000.000000 to ec0d9a.fffe.603848 |
Sync Interval Mismatch Notification
Nov 11 16:05:34 arc-switch142 ptp4l: [2332.929] PTP [Debuggability]: PTP Grandmaster clock has changed from ec0d9a.fffe.603848 to ec0d9a.fffe.6037c8 |