Clock Synchronization Operational Commands
Validating the Configurations Using the ufi-ptp-cli Shell
To validate the configuration, use the ufi-ptp-cli shell as shown in the following example.
The following example displays the output of the show ptp clock info command, detailing the PTP clock’s configuration. It includes information such as the clock identity, profile type (G.8275.1), clock type (Time Slave Clock), and various PTP interval settings.
supervisor@rtbrick>rtbrick.net:~ $ ufi-ptp-cli Check UFI PTP Service Status ... Ready. Read configuration successfully Build On Jun 3 2025 02:14:45 ufi-ptp> enable ufi-ptp# show ptp clock info Clock Identity : 5C:07:58:A2:CE:5C:00:01 Profile : G.8275.1 profile Clock Type : Time Slave Clock Servo Alg : Full-On-Path Number Of Ports : 32 Clock Class : 255 Domain Number : 24 Scaled Log Variance : 0xFFFF Priority1 : 128 Priority2 : 255 Slave Only : True Two Step : False Announce Receipt Timeout (min) : 3 Announce Receipt Timeout (def) : 3 Announce Receipt Timeout (max) : 10 Log Announce Interval (min) : -3 Log Announce Interval (def) : -3 Log Announce Interval (max) : -3 Log Sync Interval (min) : -4 Log Sync Interval (def) : -4 Log Sync Interval (max) : -4 Log Min Delay Req Interval (min) : -4 Log Min Delay Req Interval (def) : -4 Log Min Delay Req Interval (max) : -4 Domain # (min) : 24 Domain # (def) : 24 Domain # (max) : 43 Priority 1 : 128 Priority 2 (min) : 0 Priority 2 (def) : 128 Priority 2 (max) : 225 Local Priority : 128
The following example displays the output of the show ptp port 67 peer command, detailing PTP packet statistics for peer 0 on Port 67. It provides counts of various received and transmitted PTP messages, such as Sync, Delay Request, Delay Response, and Announce messages.
ufi-ptp# show ptp port 9 peer Port 9: Peer #0 L2 address : D8:3A:DD:AA:4D:9D Clock Identity : D8:3A:00:FF:FE:AA:4D:9D Received Sync : 138913 Received Delay Request : 0 Received Delay Response : 138904 Received Peer Delay Request : 0 Received Peer Delay Response : 0 Received Followup : 138913 Received Peer Delay Followup : 0 Received Announce : 69457 Received Signalling : 0 Received Management : 0 Transmitted Sync : 0 Transmitted Delay Request : 138904 Transmitted Delay Response : 0 Transmitted Peer Delay Request : 0 Transmitted Peer Delay Response : 0 Transmitted Followup : 0 Transmitted Peer Delay Followup : 0 Transmitted Announce : 0 Transmitted Signalling : 0 Transmitted Management : 0
The show ptp port 67 master command output displays that port 67 has one PTP master identified as E1:C1:1A:G5:L2:15.
ufi-ptp# show ptp port 67 master Port 67: Master #0 : E1:C1:1A:G5:L2:15 ufi-ptp#
PTP Show CLIs
show ptp clock-info
This command displays detailed information about the PTP clock running on the device.
Syntax:
The following example displays detailed information about the PTP clock. Key details include the clock identifier, profile (g8275.1), clock type (Slave Clock), domain number, and various PTP interval settings.
supervisor@rtbrick>switch: op> show ptp clock-info Clock Information Clock identifier: 5c:07:58:a2:ce:5c:00:01 Profile: g8275.1 Clock type: Slave Clock Max number of ports: 32 Clock class: 255 Domain number: 24 Scaled log variance: 0xFFFF Priority1: 128 Priority2: 255 Slave only: True Announce receipt timeout (Min): 3 Announce receipt timeout (Def): 3 Announce receipt timeout (Max): 10 Log announce interval (Min): -3 Log announce interval (Def): -3 Log announce interval (Max): -3 Log sync interval (Min): -4 Log sync interval (Def): -4 Log sync interval (Max): -4 Log delay req interval (Min): -4 Log delay req interval (Def): -4 Log delay req interval (Max): -4 Domain min: 24 Domain default: 24 Domain max: 43 Priority2 min: 0 Priority2 default: 128 Priority2 max: 225 Local priority: 128 PTP Timescale: False
show ptp clock dataset
This command displays detailed information about the PTP clock dataset, including the current, default, parent, and time-properties datasets.
Syntax:
The following table provides the new command options and descriptions.
| Option | Description |
|---|---|
|
This option provides a real-time view of the PTP clock dataset, specifically tracking dynamic metrics such as Mean Path Delay, Offset from Master, and Steps Removed. |
|
Displays the default PTP clock dataset, including Clock Quality, Domain Number, and other largely static parameters. |
|
Displays parent clock information, including parent clock port, parent clock identity, and parent clock quality. Parent clock quality is sent to slaves when the device is acting as a PTP master on this port. |
|
Displays time properties, including current UTC offset, leap second status, and time traceable status. |
The following example output displays the current PTP clock information, including dynamic metrics such as Mean Path Delay, Offset from Master, and Steps Removed.
supervisor@rtbrick.net: op> show ptp clock dataset current Offset from master: -294937568.000000 nsec Mean path delay: 577.000000 nsec Steps removed: 2
The following example output displays the default PTP clock information, including static parameters such as clock identity and clock quality.
supervisor@rtbrick.net: op> show ptp clock dataset default Two step flag: No Clock identity: 5c:07:58:a2:ce:5c:00:01 Number of ports: 32 Clock priority 1: 128 Clock priority 2: 255 Slave only: Yes Local priority: 128 Max step removed: 255 Domain number: 24 Clock Quality Clock class: 255 Clock accuracy: 0xFE Clock offset: 0xFFFF
The following example output displays the parent PTP clock information, including parent clock identity, parent clock class and parent clock accuracy.
supervisor@rtbrick.net: op> show ptp clock dataset parent Parent Port Clock identity: d8:3a:00:ff:fe:aa:4d:9d Port Number: 2 Parent stats: No Observed parent offset: Invalid Observed parent phase change rate: Invalid Grandmaster identity: d8:3a:00:ff:fe:aa:4d:9d Grandmaster clock priority 1: 128 Grandmaster clock priority 2: 0 Grandmaster Clock Quality Clock class: 255 Clock accuracy: 0x20 Clock offset: 0xFFFF
The following example output displays the time properties dataset information, including current UTC offset, leap second status, and time traceable status.
supervisor@rtbrick.net: op> show ptp clock dataset time-properties Current UTC offset: 0 Current UTC offset valid: True Leap 59: False Leap 61: False Time traceable: True Frequency traceable: True PTP Timescale: False Time source: GPS Time of day: Wed Jun 03 2026 11:29:52.814493 UTC
show ptp servo
This command displays the status and configuration of the PTP servo mechanism on a device. The servo is a critical component in PTP that adjusts the local clock to synchronize with a master clock.
Syntax:
The following example displays the output of the show ptp servo command, providing the PTP servo statistics for Clock 0. It details the servo’s configuration, current state ("Frequency Locked"), lock status ("Locked"), and various correction and packet rate values.
supervisor@rtbrick>switch: op> show ptp servo Servo Stat for Clock 0 Servo config: Freq + Phase Correction Servo state: Frequency Locked Servo state duration: 2:49:37 Lock status: Locked APTS mode: N/A Frequency correction: 12000.000000 ppb Phase correction: 542500000.000000 nsec Offset from master: -542543518.000000 nsec Mean path delay: 458.000000 nsec APTS GPS to PTP offset: N/A Sync packet rate: 16 Delay packet rate: 16
show ptp servo history
The "show ptp servo history" command displays detailed PTP timing information and servo state changes. This command displays the most recent 100 state changes.
Syntax:
The following example output provides a log of PTP servo states, including specific lock statuses, correction metrics, and timing data recorded for a device.
supervisor@rtbrick.net: cfg> show ptp servo history Total number of recorded changes: 6 Servo recorded at 2026-06-12 07:45:52 Servo config: Freq + Phase Correction Servo state: Frequency Locked Servo state duration: 0:00:24 Lock status: Locked APTS mode: N/A Frequency correction: 48.000000 ppb Phase correction: 294500000.000000 nsec Offset from master: -4000206155.000000 nsec Mean path delay: 299.000000 nsec APTS GPS to PTP offset: N/A Sync packet rate: 16 Delay packet rate: 16 Servo recorded at 2026-06-12 07:45:22 Servo config: Freq + Phase Correction Servo state: Holdover Out Of Spec Servo state duration: 0:00:04 Lock status: Holdover APTS mode: N/A Frequency correction: 11125.000000 ppb Phase correction: -294750000.000000 nsec Offset from master: -4294720968.000000 nsec Mean path delay: 205.000000 nsec APTS GPS to PTP offset: N/A Sync packet rate: 16 Delay packet rate: 16 Servo recorded at 2026-06-12 07:40:21 Servo config: Freq + Phase Correction Servo state: Frequency Locked Servo state duration: 0:00:23 Lock status: Locked APTS mode: N/A Frequency correction: 42.000000 ppb Phase correction: -294500000.000000 nsec Offset from master: -294883100.000000 nsec Mean path delay: 292.000000 nsec APTS GPS to PTP offset: N/A Sync packet rate: 16 Delay packet rate: 16 Servo recorded at 2026-06-12 07:39:51 Servo config: Freq + Phase Correction Servo state: Holdover Out Of Spec Servo state duration: 0:00:03 Lock status: Holdover APTS mode: N/A Frequency correction: -11125.000000 ppb Phase correction: 294750000.000000 nsec Offset from master: -282462.000000 nsec Mean path delay: 391.000000 nsec APTS GPS to PTP offset: N/A Sync packet rate: 16 Delay packet rate: 16 Servo recorded at 2026-06-12 07:05:49 Servo config: Freq + Phase Correction Servo state: Frequency Locked Servo state duration: 0:00:21 Lock status: Locked APTS mode: N/A Frequency correction: 12000.000000 ppb Phase correction: 294500000.000000 nsec Offset from master: -141093.000000 nsec Mean path delay: 204.000000 nsec APTS GPS to PTP offset: N/A Sync packet rate: 16 Delay packet rate: 16 Servo recorded at 2026-06-12 07:04:49 Servo config: Freq + Phase Correction Servo state: Acquiring Servo state duration: 0:00:23 Lock status: Acquiring APTS mode: N/A Frequency correction: 5875.000000 ppb Phase correction: 294500000.000000 nsec Offset from master: -170559.000000 nsec Mean path delay: 238.000000 nsec APTS GPS to PTP offset: N/A Sync packet rate: 16 Delay packet rate: 16
show ptp statistics
This command displays the PTP packet statistics for a device.
Syntax:
| Option | Description |
|---|---|
- |
Without any option, the commands displays the PTP packet statistics for all interfaces. |
<interface> |
Displays the PTP packet statistics for the specified interface. |
The following example displays the output of the show ptp statistics command, detailing both global and interface-specific (ifp-0/1/8) PTP packet transmission, reception, and discard counts.
supervisor@rtbrick>switch: op> show ptp statistics Total PTP statistics Tx: 161895 Rx: 566652 Discarded: 16 Interface Tx Rx Discarded ifp-0/1/8 161895 566652 16
The following example displays PTP packet statistics for interface ifp-0/1/8, showing 161895 packets transmitted, 566652 received, and 16 discarded.
supervisor@rtbrick>switch: op> show ptp statistics interface ifp-0/1/8 ifp-0/1/8 Tx: 161895 Rx: 566652 Discarded: 16
show ptp interface <interface-name>
The show ptp interface <interface-name>` command allows you to retrieve specific PTP information for a specified interface.
Syntax:
| Attribute | Description |
|---|---|
|
Specifies the interface for which the PTP information is displayed.
|
The example output below displays the detailed operational dataset for the PTP interface ifp-0/1/8, providing details about its current port state, configuration parameters, and information about the associated foreign master clock.
supervisor@rtbrick.net: cfg> show ptp interface ifp-0/1/8 dataset ifp-0/1/8 Port state: Uncalibrated Port identity: 5C:07:58:A2:CE:5C:00:01:0009 Port mean path delay: 297 Log announce interval: -3 Log sync interval: -4 Log min delay req interval: -4 Announce receipt timeout: 3 Delay mechanism: End to End Version number: 2 Local priority: 128 Master only: False Network interface: ifp-0/1/8 TTL: 64 DSCP: 46 Unicast grant duration: 0 seconds Configured delay asymmetry: 0 Acceptable master table: Disabled Acceptable slave table: Disabled Number of foreign masters: 1 Current foreign master: 0 Foreign master #0 L2 address: D8:3A:DD:AA:4D:9D GM identity: D8:3A:00:FF:FE:AA:4D:9D Port ID: D8:3A:00:FF:FE:AA:4D:9D:0002 GM clock class: 13 GM clock accuracy: 0x20 GM clock offset: 0xFFFF GM priority1: 128 GM priority2: 0 GM steps removed: 2 GM sync uncertainty: No
show ptp event history
You can now run the show ptp event history command (with specific filters for grand-master, parent, and interval) to track dataset changes, servo states, and clock transitions. These commands provide real-time visibility into the health of network synchronization and Grandmaster selection directly from the CLI.
Syntax:
| Attribute | Description |
|---|---|
|
Displays historical PTP dataset events, including dataset changes, servo states, and clock transitions. |
|
Displays PTP protocol message interval values. |
|
Filters the PTP event history output by parent clock identity, showing dataset events only for the selected parent clock. |
|
Filters the PTP event history output by grandmaster clock identity, showing dataset events only for the selected grandmaster clock. |
The example below displays historical PTP dataset events, detailing parent and grandmaster clock identifiers, clock classes, and other synchronization attributes recorded on the system.
supervisor@rtbrick: op> show ptp event history Total number of PTP dataset events: 35 Dataset change recorded at 2026-06-29 06:55:56 Protocol event type: ptp_event_protocol_parent_data_set_change Parent clock identity: D8:3A:00:FF:FE:AA:4D:9D Parent clock port: 2 Parent stats: No Parent offset scaled log variance: Invalid Parent clock phase change rate: Invalid Grandmaster identity: D8:3A:00:FF:FE:AA:4D:9D Grandmaster clock class: 13 Grandmaster clock accuracy: 0x20 Grandmaster clock offset: 0xFFFF Grandmaster priority 1: 128 Grandmaster priority 2: 0 Dataset change recorded at 2026-06-29 06:55:53 Protocol event type: ptp_event_protocol_parent_data_set_change Parent clock identity: D8:3A:00:FF:FE:AA:4D:9D Parent clock port: 2 Parent stats: No Parent offset scaled log variance: Invalid Parent clock phase change rate: Invalid Grandmaster identity: D8:3A:00:FF:FE:AA:4D:9D Grandmaster clock class: 13 Grandmaster clock accuracy: 0x21 Grandmaster clock offset: 0xFFFF Grandmaster priority 1: 128 Grandmaster priority 2: 0 <...>
The example below displays historical PTP interval interrupt logs.
supervisor@rtbrick: op> show ptp event history interval Total interval interrupts: 2 Delay Request interrupt recorded at 2026-06-29 06:30:42 Last interval: 127 Current interval: -4 Delay Request interrupt recorded at 2026-06-29 06:28:29 Last interval: 127 Current interval: -4
The example below displays historical changes to the PTP parent data set, documenting three specific events with their associated timestamps, parent clock identities, and port information.
supervisor@rtbrick: op> show ptp event history parent Total records: 3 Parent data set change recorded at 2026-06-29 06:30:39 Parent clock identity: D8:3A:00:FF:FE:AA:4D:9D Parent clock port: 2 Parent stats: No Parent offset scaled log variance: Invalid Parent clock phase change rate: Invalid Parent data set change recorded at 2026-06-29 06:30:13 Parent clock identity: 5C:07:58:A2:CE:5C:00:01 Parent clock port: 0 Parent stats: No Parent offset scaled log variance: Invalid Parent clock phase change rate: Invalid Parent data set change recorded at 2026-06-29 06:28:26 Parent clock identity: D8:3A:00:FF:FE:AA:4D:9D Parent clock port: 2 Parent stats: No Parent offset scaled log variance: Invalid Parent clock phase change rate: Invalid
The example below displays historical PTP Grandmaster change events, listing their specific timestamps, clock identities, and synchronization attributes.
supervisor@rtbrick: op> show ptp event history grand-master Total records: 35 Grandmaster change recorded at 2026-06-29 06:55:56 Identity: D8:3A:00:FF:FE:AA:4D:9D Clock class: 13 Clock accuracy: 0x20 Clock offset: 0xFFFF Priority 1: 128 Priority 2: 0 Grandmaster change recorded at 2026-06-29 06:55:53 Identity: D8:3A:00:FF:FE:AA:4D:9D Clock class: 13 Clock accuracy: 0x21 Clock offset: 0xFFFF Priority 1: 128 Priority 2: 0 Grandmaster change recorded at 2026-06-29 06:54:20 Identity: D8:3A:00:FF:FE:AA:4D:9D Clock class: 13 Clock accuracy: 0x20 Clock offset: 0xFFFF Priority 1: 128 Priority 2: 0 <...>
show ptp bmca
You can run show ptp bmca and show ptp bmca interface <interface> to view critical troubleshooting data, including selected GM clock IDs, clock classes, and selection timelines. These commands provide clearer network visibility into clock selection and synchronization health directly from the CLI.
Syntax:
| Attribute | Description |
|---|---|
|
Without any option, it displays all the BMCA details. |
|
Specifies name of the BMCA interface. |
supervisor@rtbrick: cfg> show ptp bmca Selected master clock identity D8:3A:00:FF:FE:AA:4D:9D Clock port: 2 Parent stats: No Parent offset scaled log variance: Invalid Parent clock phase change rate: Invalid Time of selection: 2026-06-29 15:55:05 UTC GM Identity: D8:3A:00:FF:FE:AA:4D:9D Number of times changed: 6
supervisor@rtbrick: cfg> show ptp bmca interface ifp-0/1/8
SyncE ESMC Show CLIs
show synce statistics
This command displays the SyncE statistics.
Syntax:
| Option | Description |
|---|---|
<cr> |
Without any option, the commands displays the SyncE statistics for all interfaces. |
<interface> |
Displays the SyncE statistics for the specified interface. |
The following example displays the output of the show synce statistics command for all interfaces.
supervisor@rtbrick>switch: op> show synce statistics
ifp-0/1/20
ESMC Rx: 0
ESMC Tx: 10719
Total: 10719
ifp-0/1/69
ESMC Rx: 0
ESMC Tx: 30
Total: 30
The following example displays SyncE statistics for the interface.
supervisor@rtbrick>switch: op> show synce statistics interface ifp-0/1/20
ifp-0/1/20
ESMC Rx: 0
ESMC Tx: 10269
Total: 10269
show synce details
This command displays the SyncE details.
Syntax:
| Option | Description |
|---|---|
details |
Displays detailed information about the SyncE configurations. |
The following example displays the output of the show synce details command, providing detailed information about the SyncE configurations.
supervisor@rtbrick>switch: op> show synce details Clock-selection: QL-enabled Equipment clock: EEC-option1 Extended QL-TLV: Disabled Switchover-mode: Revertive Hop-count mode: Disable SyncE clock state: Holdover DPLL clock state: Holdover SyncE state duration: 06:33:59 10MHz holdover duration: 10 min
show synce input-source
This command displays the SyncE input source.
Syntax:
| Option | Description |
|---|---|
input-sources |
Displays the SyncE input sources. |
The following example displays the output of the show synce input-source command, providing detailed information about the SyncE input sources, including source priority, quality level (QL) status, hold-off timer settings, link status, and clock source ID.
supervisor@rtbrick>switch: op> show synce input-source Interface: ptp Source priority: 1 QL configured: N/A QL received: N/A QL operational: N/A ESMC status: N/A Selected source: False Hold off timer: 300 ms Hold off timer status: False WTR timer: 5 mins Link status: Down WTR timer status: False Clock source id: 256 Signal fail state: True Timing loop: False Lockout mode: False
show synce interface <interface_name>
This command displays the SyncE interface information for the specified interface.
Syntax:
| Option | Description |
|---|---|
<interface_name> |
Displays the SyncE interface information for the specified interface. |
The following example displays the output of the show synce interface ifp-0/1/8 command, providing detailed information about the SyncE status on interface ifp-0/1/8. It includes the source type (Output), link status (Up), and quality level (QL) details.
supervisor@rtbrick>switch: op> show synce interface ifp-0/1/8 Interface: ifp-0/1/8 Source: Output Link status: Up QL received: N/A QL operational: N/A QL operational out: QL_DNU
show synce interface summary
This command displays a summary of the SyncE interface information for all interfaces.
Syntax:
This example displays the SyncE interface summary, including details of Interface, QL received, QL operational, Out QL Operational, and Link Status.
supervisor@rtbrick>switch: op> show synce interface summary Interface QL received QL operational Out QL Operational Link Status ifp-0/1/20 N/A N/A QL_SEC Up ifp-0/1/69 N/A N/A QL_SEC Up ifp-0/1/8 N/A N/A QL_DNU Up ptp N/A N/A N/A Down
show synce interface <interface-name>
This command displays SyncE interface information for the specified interface.
Syntax:
This example displays the SyncE interface information for the specified interface.
supervisor@rtbrick>switch: op> show synce interface interface ifp-0/1/20 Interface QL received QL operational Out QL Operational Link Status ifp-0/1/20 N/A N/A QL_SEC Up ifp-0/1/69 N/A N/A QL_SEC Up ifp-0/1/8 N/A N/A QL_DNU Up ptp N/A N/A N/A Down
show synce output-source
This command displays the detailed configuration and status information for the selected SyncE source.
Syntax:
The following example displays the output of the show synce output-sourcecommand, providing detailed information about the selected SyncE source, including interface name, link status, and quality level (QL) details.
supervisor@rtbrick>switch: op> show synce output-source Interface: ifp-0/1/20 Link status: Up QL configured: N/A QL operational: QL_SEC Interface: ifp-0/1/69 Link status: Up QL configured: N/A QL operational: QL_SEC Interface: ifp-0/1/8 Link status: Up QL configured: QL_DNU QL operational: QL_DNU
show synce selected-source
This command displays detailed view of the selected SyncE source.
Syntax:
This example provides a detailed view of the selected SyncE source, including key parameters such as Interface, Source Priority, QL (configured, received, and operational), ESMC status, Hold off and WTR timers, Clock source ID, Signal fail state, Timing loop, and Lockout mode.
supervisor@rtbrick>switch: op> show synce synce selected-source Interface: ptp Source priority: 1 QL configured: N/A QL received: QL_PRC QL operational: QL_PRC ESMC status: N/A Selected source: True Hold off timer: 300 ms Hold off timer status: False WTR timer: 5 mins Link status: Up WTR timer status: False Clock source id: 256 Signal fail state: False Timing loop: False Lockout mode: False