display ntp-service sessions

Function

The display ntp-service sessions command displays all session information maintained by NTP on the local end.

Format

display ntp-service sessions [ verbose ]

Parameters

Parameter	Description	Value
verbose	Displays detailed information about an NTP session. If verbose is not specified, only summary information about the NTP session is displayed.	-

Parameter

Description

Value

verbose

Displays detailed information about an NTP session.

If verbose is not specified, only summary information about the NTP session is displayed.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To monitor or locate faults on NTP sessions, run the display ntp-service sessions command to obtain status information about NTP sessions so that the fault can be located efficiently.

Precautions

If verbose is not specified, summary information about NTP sessions is displayed.
If verbose is specified, detailed information about NTP sessions is displayed.

Example

# Display NTP session information of the local device.

<HUAWEI> display ntp-service sessions
 clock source: 224.0.1.1                                                         
 clock stratum: 1                                                              
 clock status: configured, insane, valid, unsynced                              
 reference clock ID: LOCAL(0)                                                    
 reach: 0                                                                       
 current poll: 64                                                               
 now: 9                                                                         
 offset: 0.0000 ms                                   
 delay: 0.00 ms                                                  
 disper: 0.00 ms

**Table 1** Description of the display ntp-service sessions command output
Item	Description
clock source	Address of the clock source.
clock stratum	Stratum of the clock source. The clock stratum determines the precision of the clock, and its value ranges from 1 to 16. The higher the stratum value, the lower the clock precision. The value 1 indicates the highest precision, and the value 16 indicates the lowest precision. The clock with stratum 16 is in the unsynchronized status, and cannot be used as a reference clock.
clock status	Status of a clock, where configured: indicates that the session is set up by a configuration command. master: indicates that the clock source corresponding to the session is the primary clock source of the current system. selected: indicates that the clock source corresponding to the session passes the clock selecting algorithm. candidate: indicates that the clock source corresponding to the session is a candidate clock source. sane: indicates that the clock source corresponding to the session passes the saneness test. insane: indicates that the clock source corresponding to the session does not pass the saneness test. valid: indicates that the clock source corresponding to the session is valid. The clock source corresponding to the session passes the test, is in a synchronized status and is of an effective stratum. The root delay and the root dispersion are within the normal range. invalid: indicates that the clock source corresponding to the session is invalid. unsynced: indicates that the clock source corresponding to the session is not yet synchronized or the stratum is invalid.
reference clock ID	When the local system has been synchronized to a remote NTP server or a clock source, the address of the remote server or the identifier of the clock source is displayed.
reach	Reachability count of the clock source. The value 0 indicates that the clock source is unreachable.
current poll	Poll interval of NTP packets. The interval for sending two successive NTP packets, in seconds. To set the poll interval, run the ntp-service discard min-interval command.
now	Interval between the last synchronization and the current time.
offset	Offset to the superior clock source.
delay	Delay to the superior clock source.
disper	Dispersion to the superior clock source.

# Display detailed information about NTP sessions on the local device.

<HUAWEI> display ntp-service sessions verbose
 clock source: 172.16.12.1                                                        
 clock stratum: 1                                                              
 clock status: configured, insane, valid, unsynced                              
 reference clock ID: LOCAL(0)                                                    
 local mode: client, local poll: 64, current poll: 64                            
 peer mode: server, peer poll: 64, now: 21                                               
 offset: -3.2385 ms,delay: 26.97 ms,  disper: 14.85 ms                             
 root delay: 0.00 ms, root disper: 10.94 ms                                     
 reach: 255, sync dist: 0.058, sync state: 4                                   
 precision: 2^18, version: 3, peer interface: wildcard                          
 reftime: 10:01:38.546 UTC Sep 5 2005(C6C69602.8C00DA1A)                        
 orgtime: 10:01:43.463 UTC Sep 5 2005(C6C69607.76ACC921)                        
 rcvtime: 10:01:43.480 UTC Sep 5 2005(C6C69607.7AF4ADBC)                        
 xmttime: 10:01:43.452 UTC Sep 5 2005(C6C69607.73F1E8E6)                       
 filter delay :  0.03   0.02   0.03   0.02   0.02   0.02   0.04   0.02          
 filter offset:  0.00  -0.01   0.00   0.01   0.00   0.00   0.00   0.00          
 filter disper:  0.03   0.02   0.00   0.11   0.09   0.08   0.06   0.05
 reference clock status: normal

**Table 2** Description of the display ntp-service sessions verbose command output
Item	Description
clock source	Address of the clock source.
clock stratum	NTP stratum on which the local system is located.
clock status	Status of a clock, where configured: indicates that the session is set up by a configuration command. master: indicates that the clock source corresponding to the session is the primary clock source of the current system. selected: indicates that the clock source corresponding to the session passes the clock selecting algorithm. candidate: indicates that the clock source corresponding to the session is a candidate clock source. sane: indicates that the clock source corresponding to the session passes the saneness test. insane: indicates that the clock source corresponding to the session does not pass the saneness test. valid: indicates that the clock source corresponding to the session is valid. The clock source corresponding to the session passes the test, is in a synchronized status and is of an effective stratum. The root delay and the root dispersion are within the normal range. invalid: indicates that the clock source corresponding to the session is invalid. unsynced: indicates that the clock source corresponding to the session is not yet synchronized or the stratum is invalid.
reference clock ID	When the local system has been synchronized to a remote NTP server or a clock source, the address of the remote server or the identifier of the clock source is displayed. When the server is located on a certain VPN, the name of the VPN instance is displayed.
local mode	Local system mode.
peer mode	Peer system mode.
local poll	Local polling mode.
peer poll	Peer polling mode.
offset	Offset to the superior clock source.
delay	Delay to the superior clock source.
disper	Dispersion to the superior clock source.
root delay	Total system delay between the local end and the master reference clock. The default value is 0.
root disper	System dispersion of the local end to the master reference clock. The default value is 0.
reach	Reachability mark, indicating the reachability to the clock source.
sync dist	Synchronization distance to the superior clock source. This parameter evaluates and describes the clock source, and NTP chooses the clock source with the shortest synchronization distance.
sync state	Synchronization state: 0: The clock has never been synchronized. 1: Frequency information is obtained from configuration information. 2: The clock is set. 3: The clock is set, but the frequency is not yet determined. 4: The clock is synchronized. 5: An error is found.
precision	Precision of a peer clock.
version	NTP version.
peer interface	Peer interface.
reftime	Reference timestamp.
orgtime	Time when an NTP packet is sent for the last time.
rcvtime	Time when an NTP packet is received for the last time.
xmttime	Time when an NTP packet is forwarded for the last time.
filter delay	Filter delays of the 8 packets received for the last time.
filter offset	Filter offsets of the 8 packets received for the last time.
filter disper	Filter dispersions of the 8 packets received for the last time.
reference clock status	The status of the reference clock, including: normal: indicates that the peer clock is reachable. abnormal: indicates that the peer clock is unreachable.