display ptp

Function

The display ptp command displays information about the Precision Time Protocol (PTP).

Format

display ptp all [ config | state ] [ slot slot-id ]

display ptp interface interface-type interface-number

Parameters

Parameter	Description	Value
all	Displays all the statistics of a PTP device, such as the global configuration parameters, interface where the clock source resides, time trace status, and interface running status.	-
config	Displays configurations of all the modules related to PTP on the device.	-
state	Displays the running status of the protocol on all the modules related to PTP on the device.	-
slot slot-id	Displays the status information of the protocol on all the modules related to PTP based on a slot ID.	The value must be set according to the device configuration.
interface interface-type interface-number	Displays the BMC running status and the number of sent and received PTP packets on a specified interface. interface-type specifies the type of an interface. interface-number specifies the number of an interface.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

Using the display ptp command, you can view the running status of PTP and statistics information about the global configuration parameters, interface where the clock source resides, and clock lock status. In addition, the command also displays the grandmaster clock ID, receiver number, parent clock ID, parent port number, statistics, and status of interfaces or role list.

Precautions

The display ptp displays the configuration on the interface only when PTP is enabled globally and in the interface view.

Example

# Display the status and statistics of all the modules related to PTP.

<HUAWEI> display ptp all slot 0
  Device config info                                                            
  ------------------------------------------------------------------------      
  PTP state         :enabled    Domain  value      :0                           
  Slave only        :no         Device type        :E2ETCOC                     
  Set port state    :no         Local clock ID     :e468a3fffe552a30            
  Virtual clock ID  :no         Time lock success  :no                          
  PTP profile       :IEEE1588V2                                                 
                                                                                
  BMC run info                                                                                                                      
  ------------------------------------------------------------------------                                                          
  Grand clock ID    :9c8fd0fffecf3c87                                                                                               
  Receive number    :XGigabitEthernet0/0/3                                                                                           
  Parent clock ID   :9c8fd0fffecf3c87                                                                                               
  Parent portnumber :256                                                                                                            
  Priority1         :1          Priority2          :1                                                                               
  Step removed      :0          Clock accuracy     :0x21                                                                            
  Clock class       :6          Time Source        :0xa0                                                                            
  UTC Offset        :35         UTC Offset Valid   :False                                                                           
  Timescale         :PTP        Time Traceable     :False                                                                           
  Leap              :None       Frequence Traceable:True                                                                            
  Offset scaled     :0xffff
                                                                                                                                                                                                  
  Clock source info                                                             
  Clock Pri1 Pri2 Accuracy Class TimeSrc Signal Switch Direction In-Status      
  ------------------------------------------------------------------------      
  local 128  128  0x31     187   0xa0     -      -      -         -

# Display PTP interface status and packet statistics of XGigabitEthernet0/0/3.

<HUAWEI> display ptp interface xgigabitethernet 0/0/3
  Port State :faulty                                                            
  Port Number :3                                                                
                                                                                
  Recv Packet Statistics                                                        
  -----------------------------------------------------------------------       
  Announce               :0          Sync                       :0              
  Req                    :0          Resp                       :0              
  Followup               :0          Pdelay_resp_followup       :0              
                                                                                
  Send Packet Statistics                                                        
  -----------------------------------------------------------------------       
  Announce               :0          Sync                       :0              
  Req                    :0          Resp                       :0              
  Followup               :0          Pdelay_resp_followup       :0              
                                                                                
  Discard Packet Statistics                                                     
  -----------------------------------------------------------------------       
  Announce               :0          Sync                       :0              
  Delayreq               :0          Pdelayreq                  :0              
  Resp                   :0          Pdelayresp                 :0              
  Followup               :0          Pdelay_resp_followup       :0

**Table 1** Description of the **display ptp** command output
Item	Description
Device config info
PTP state	Whether PTP is enabled. The value is set through the ptp enable command.
Domain value	Domain that the PTP clock belongs to. The value is set through the ptp domain command.
Slave only	Whether the slave only mode is adopted. The value is set through the ptp slaveonly command.
Device-type	Type of the PTP device. The value is set through the ptp device-type command.
Set port state	Whether to manually enable tracing for a clock source.
Virtual clock ID	Whether a virtual clock ID is configured.
Time lock success	Whether the device time is locked.
PTP profile	PTP profile the device is using.
Local clock ID	ID of the local clock. The value is set through the ptp virtual-clock-id command.
BMC run info
Grand clock ID	ID of the grandmaster clock.
Receive number	Interface that receives signals of the clock source.
Parent clock ID	ID of the parent clock.
Parent portnumber	Interface that sends signals of the parent clock source.
Priority1	Priority1 of the clock source obtained from the master clock.
Priority2	Priority2 of the clock source obtained from the master clock.
Step removed	Number of communication channels between the local clock and the grandmaster clock, that is, number of BC devices.
Clock-accuracy	Accuracy of the clock source, which is obtained from the master clock.
Clock-class	Class of the clock source, which is obtained from the master clock.
Time Source	Time source of the clock source, which is obtained from the master clock.
UTC Offset	Offset between the Universal Time Coordinated (UTC) and International Atomic Time (TAI).
UTC Offset Valid	Whether the UTC offset takes effect.
Timescale	Time scale used by the PTP clock. The PTP protocol supports two types of time scales: ARB PTP
Time Traceable	Whether the time can be traced.
Frequence Traceable	Whether the clock frequency can be traced.
Source port	Clock source of the master clock.
Port info
Name	Name of the interface enabled with PTP.
State	Status of the interface enabled with PTP: Faulty: indicates that the interface is faulty. Listening: indicates that the interface is being monitored. Master: indicates that the interface is a master interface. Passive: indicates that the interface is a passive port. Premaster: indicates that the interface is a standby master interface. Slave: indicates that the interface is a slave interface.
Delay-mech	Delay measurement mechanism used on an interface. The value is set through the ptp delay-mechanism command.
Ann-timeout	Timeout interval for waiting the Announce message. The value is set through the ptp announce receipt-timeout command.
Type	Type of an interface, which is usually the same as the type of the device. If the device type is TCandBC, the value is set through the ptp port-type command.
Domain	The clock domain of an interface should be the same as the device type. If the device type is TCandBC, the clock domain of the interface is set by the ptp domain command.
Clock source info
Clock	Clock source.
Pri1	Priority1 of the clock source. The value is set through the ptp clock-source command.
Pri2	Priority2 of the clock source. The value is set through the ptp clock-source command.
Accuracy	Accuracy of the clock source. The value is set through the ptp clock-source command.
Class	Class of the clock source. The value is set through the ptp clock-source command.
TimeSrc	Time source of the clock source. The value is set through the ptp clock-source command.
In-Status	Whether the clock source is normal.
Port State	Port state.
Port Number	Port number of the clock source.
Recv Packet Statistics	Received packet statistics.
Send Packet Statistics	Sent packet statistics.
Discard Packet Statistics	Discarded packet statistics.