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.
This 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 : A1:B2:C3:D4:E5:F6:G7:H8 Profile : G.8275.1 profile Clock Type : Time Slave Clock Servo Alg : Default 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
This 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 67 peer Port 67: Peer #0 L2 address : E1:C1:1A:G5:L2:15 Clock Identity : A1:B2:C3:D4:E5:F6:G7:H8 Received Sync : 141970 Received Delay Request : 0 Received Delay Response : 141951 Received Peer Delay Request : 0 Received Peer Delay Response : 0 Received Followup : 0 Received Peer Delay Followup : 0 Received Announce : 70985 Received Signalling : 0 Received Management : 0 Transmitted Sync : 0 Transmitted Delay Request : 141959 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:
This 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 Identifier e8:c5:7a:b2:04:67:c6:69 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
show ptp peer
This command displays detailed information about the PTP peers discovered on the interface ifp-0/1/61.
Syntax:
| Option | Description |
|---|---|
- |
Without any option, the commands displays the PTP peer information for all interfaces. |
<interface> |
Displays the PTP peer information for the specified interface. |
This example displays the output of the show ptp peer command for interface ifp-0/1/61. It details information about a PTP peer, including its address, clock ID, port state (Uncalibrated), and counts of various PTP messages received and transmitted.
supervisor@rtbrick>ufi16.q2c.u13.r5.nbg.rtbrick.net: cfg> show ptp peer ifp-0/1/61 Peer Address 64:9d:99:b2:0b:96 Clock ID 64:9d:99:ff:fe:b2:0b:96 Mode 0 Port State Uncalibrated Mean Path Delay 0 Announce Interval 0.000000 Sync Interval 0.000000 Delay Req Interval 0.000000 Rx Sync 87832 Rx Delay Req 0 Rx Delay Resp 0 Rx Follow Up 87832 Rx PDelay Follow Up 0 Rx Announce 43943 Rx Signalling 0 Rx Management 0 Tx Sync 0 Tx Delay Req 87936 Tx Delay Resp 0 Tx Follow Up 0 Tx PDelay Follow Up 0 Tx Announce 0 Tx Signalling 0 Tx Management 0
This example displays the output of the show ptp peer interface ifp-0/1/61 command, providing details about a PTP peer on interface ifp-0/1/61. It includes the peer’s address and clock ID, its "Uncalibrated" port state, and various counts of PTP messages received and transmitted.
supervisor@rtbrick>switch: op> show ptp peer interface ifp-0/1/61 ifp-0/1/61 Peer Address 64:9d:99:b2:0b:96 Clock ID 64:9d:99:ff:fe:b2:0b:96 Mode 0 Port State Uncalibrated Mean Path Delay 0 Announce Interval 0.000000 Sync Interval 0.000000 Delay Req Interval 0.000000 Rx Sync 87832 Rx Delay Req 0 Rx Delay Resp 0 Rx Follow Up 87832 Rx PDelay Follow Up 0 Rx Announce 43943 Rx Signalling 0 Rx Management 0 Tx Sync 0 Tx Delay Req 87936 Tx Delay Resp 0 Tx Follow Up 0 Tx PDelay Follow Up 0 Tx Announce 0 Tx Signalling 0 Tx Management 0
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:
This 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 ("Holdover Out Of Spec"), lock status ("Holdover"), 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 Holdover Out Of Spec Servo State Duration 1:42:20 Lock Status Holdover APTS Mode N/A Frequency Correction 0 ppb Phase Correction 0 nsec Offset From Master 0 nsec Mean Path Delay 0 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. |
This example displays the output of the show ptp statistics command, detailing both global and interface-specific (ifp-0/1/61) PTP packet transmission, reception, and discard counts.
supervisor@rtbrick>switch: op> show ptp statistics PTP statistics Tx 91776 Rx 229198 Discarded 6 ifp-0/1/61 Tx 91776 Rx 229198 Discarded 6
The example displays PTP packet statistics for interface ifp-0/1/61, showing 91776 packets transmitted, 229198 received, and 6 discarded.
supervisor@rtbrick>switch: op> show ptp statistics interface ifp-0/1/61 ifp-0/1/61 Tx 91776 Rx 229198 Discarded 6