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:

show ptp clock-info

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
Current Status
  Offset from master: 543021312.000000
  Mean path delay: -98.000000
  Steps removed: 2
Time Properties
  Current UTC offset: 0
  Current UTC offset valid: True
  Leap 59: False
  Leap 61: False
  Parent clock accuracy: 0x20
  Time traceable: True
  Frequency traceable: True
  Time source: GPS
  Time of day: Fri Dec 12 2025 11:03:38.062676 UTC

show ptp peer

This command displays detailed information about the PTP peers discovered on the interface ifp-0/1/61.

Syntax:

show ptp peer <interface>

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.

The following example displays the output of the show ptp peer command for interface ifp-0/1/8. 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/8
 Peer address: d8:3a:dd:aa:4d:9d
 Clock id: d8:3a:00:ff:fe:aa:4d:9d
 Mode: 0
 Port state: Uncalibrated
 Mean path delay: 685
 Log announce interval: -3
 Log sync interval: -4
 Log delay req interval: -4
 Rx sync: 163344
 Rx delay req: 0
 Rx delay resp: 163336
 Rx follow up: 163344
 Rx pdelay follow up: 0
 Rx announce: 81672
 Rx signalling: 0
 Rx management: 0
 Tx sync: 0
 Tx delay req: 163336
 Tx delay resp: 0
 Tx follow up: 0
 Tx pdelay follow up: 0
 Tx announce: 0
 Tx signalling: 0
 Tx management: 0

The following example displays the output of the show ptp peer interface ifp-0/1/8 command, providing details about a PTP peer on interface ifp-0/1/8. 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/8
ifp-0/1/8
  Peer address: d8:3a:dd:aa:4d:9d
  Clock id: d8:3a:00:ff:fe:aa:4d:9d
  Port state: Uncalibrated
  Mean path delay: 685
  Mode: 0
  Log announce interval: -3
  Log sync interval: -4
  Log delay req interval: -4
  Rx sync: 163344
  Rx delay req: 0
  Rx delay resp: 163336
  Rx follow up: 163344
  Rx pdelay follow up: 0
  Rx announce: 81672
  Rx signalling: 0
  Rx management: 0
  Tx sync: 0
  Tx delay req: 163336
  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:

show ptp servo

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 statistics

This command displays the PTP packet statistics for a device.

Syntax:

show ptp statistics <interface>

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

SyncE ESMC Show CLIs

show synce statistics

This command displays the SyncE statistics.

Syntax:

show synce statistics <interface>

Option Description

-

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 ifp-0/1/20.

supervisor@rtbrick>switch: op> show synce statistics interface ifp-0/1/20
ifp-0/1/20
    ESMC Rx: 0
    ESMC Tx: 10269
    Total: 10269