Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show ptp lock-status

Syntax

Description

Display information about the lock status of the timeReceiver. The output verifies whether the timeReceiver is aligned to the reference (timeTransmitter clock) or not.

Options

detail

Display detailed information about the lock status of the timeReceiver.

Required Privilege Level

view

Output Fields

Table 1 lists the output fields for the show ptp lock-status command. Output fields are listed in the approximate order in which they appear.

Table 1: show ptp lock-status Output Fields

Field Name

Field Description

Lock State

State of the timeReceiver clock with respect to its timeTransmitter clock:

  • FREERUN

  • HOLDOVER

  • PHASE ALIGNED

  • ACQUIRING

  • INITIALIZING

  • FREQ LOCKED

Holdver State

In-specification indicates maintaining timing within specification using last known offset. Out-of-specification indicates that the holdover timer has expired, and timing accuracy has degraded.

Note:
  • This field is displayed only when the Lock State is in HOLDOVER state.

  • Holdover Timer: 

    • In case only synchronous Ethernet is active, and PTP is not ready, then the system moves to In-specification state without starting the holdover timer.

    • In all the other cases with GNSS, PTP, and synchronous Ethernet failed, the holdover timer would be an optional configurable parameter with a default value of 240 minutes. See, ptp.

Phase offset

Time offset information of a timeReceiver clock with respect to its timeTransmitter clock. Precision of this time offset is 1 nanosecond.

State since

Date, time, and how long ago the lock status of the PTP timeReceiver or timeReceiver clock changed. The format is State since: year-month-day hour:minute:second:timezone (hour:minute:second ago). For example, State since: 2002-04-26 10:52:40 PDT (04:33:20 ago). On ACX Series routers, this field is displayed in Junos OS Release 15.1 and later.

Current Source

Indicates the current timing source. It can be one of the following:

  • GNSS

  • PTP

  • SYNCE

  • PTP+SyncE

  • NONE

Primary Source

Indicates the state of the primary GNSS source.

  • GNSS Active indicates that the GNSS receiver’s data exchange is good and 1 PPS and 10 MHz from the receiver is available.

  • GNSS Inactive indicates one of the following:

    • No data exchange from the GNSS receiver.

    • 1 PPS is not available on the supported platform.

    • 10 MHz is not available on the supported platform.

  • GNSS Ready indicates that GNSS is active and GNSS receiver is in FINE LOCKED state.

  • GNSS Not Ready indicates one of the following:

    • GNSS is inactive

    • GNSS receiver is active, but not in FINE LOCKED state.

    • GNSS data exchange is proper, but data content is not good.

Secondary Source

Indicates the state of the secondary timing source

When the system is in normal state:

  • PTP Active indicates that the announce packet exchange is proper with the configured upstream G.8275.1 timeTransmitter.

  • PTP Inactive indicates that the announce packet exchange is improper with the configured upstream G.8275.1 timeTransmitter.

  • PTP Ready indicates that the PTP is active while the GNSS is also active, and the PTP timeTransmitter's clock class is < 135, and the PTP path calibration is complete (that is, the static offset seen in the PTP path with respect to the GNSS is computed). 

  • PTP Not Ready indicates one of the following:

    • PTP is inactive

    • PTP timeTransmitter's clock class >=135

    • The PTP path calibration is incomplete (that is, the static offset seen in the PTP path with respect to the GNSS is not computed)

  • SyncE Ready indicates that synchronous Ethernet is active while the GNSS is also active, and the clock is qualified.

  • SyncE Not Ready indicates that either synchronous Ethernet is inactive, or the clock is unqualified or has failed.

When the system is in HOLDOVER state, and PTP or synchronous Ethernet is restored while GNSS is not yet restored, then:

  • PTP Ready indicates that the PTP is active, and the PTP timeTransmitter's clock class is < 135, and the PTP is acquiring lock from the upstream G.8275.1 timeTransmitter. 

  • PTP Not Ready indicates one of the following:

    • PTP is inactive

    • PTP timeTransmitter's clock class >=135

    • The PTP is unable to lock to the upstream G.8275.1 timeTransmitter. 

  • SyncE Ready indicates that synchronous Ethernet is active and the clock is qualified.

  • SyncE Not Ready indicates that either synchronous Ethernet is inactive, or the clock is unqualified or has failed.

Selected Master Details

Details include the following:

  • Upstream Master address—The address of the remote timeTransmitter from which the timeReceiver acquires the clock.

  • Slave interface—The timeReceiver interface on this router corresponding to the timeTransmitter above.

Note:

On ACX Series router, if the PTP lock state is FREERUN, then the Selected Master Details field is not shown.

Sample Output

show ptp lock-status

show ptp lock-status

show ptp lock-status detail

show ptp lock-status detail

show ptp lock-status detail

show ptp lock-status detail (AFTS enabled)

show ptp lock-status detail (AFTS enabled with PTP over LAG)

show ptp lock-status detail

show ptp lock-status detail (QFX5120-48T)

show ptp lock-status detail (PTX10008)

Release Information

Command introduced in Junos OS Release 12.2.