3.2.1.3 Time Peer Elements

  • Article

The following elements are defined for each time peer found in the PeerList of an NTP time provider. These elements are read-only.

ResolvedAttempts: An unsigned integer that indicates the number of consecutive times the NTP time provider attempted to resolve this time peer but was not successful. A value of 0 indicates that the last attempt to resolve the peer was successful. Resolution includes time source discovery and FQDN resolution, as specified in [RFC1305]. The value SHOULD NOT<27> wrap around to 0.

TimeRemaining: A 64-bit, unsigned integer value that indicates the amount of time remaining until the time provider repolls this time peer, in 100-nanosecond units.

LastSuccessfulSync: A 64-bit, unsigned integer value that indicates the amount of time that has passed since this time peer was last successfully synchronized, expressed as the number of 100-nanosecond intervals since midnight January 1, 1601, in UTC.

LastSyncError: An implementation specific error code that indicates success or failure of the last attempt to synchronize time with this time peer. A value of zero indicates success. A nonzero value indicates failure. All nonzero values MUST be treated as equivalent for the purposes of this protocol.<28>

LastSyncErrorMessageId: An unsigned integer that maps to a message identifier for a message that SHOULD describe the failure indicated in the LastSyncError element. The values in this field are implementation-specific. If an implementation receives a value it does not understand, the implementation MUST ignore the value.<29>

AuthenticationTypeMessageId: An unsigned integer that maps to a message identifier for a message that describes the authentication mechanism that this time peer uses for secure NTP communication. For more information on NTP authentication, see [WTSREF] and [MS-SNTP]. The values in this field are implementation-specific. If an implementation receives a value it does not understand, the implementation MUST ignore the value.<30>

ValidDataCounter: The number of valid time samples from this time peer that the NTP time provider currently has stored in its database.

PeerName: A null terminated string that represents the name of this time peer. This name is for informational or display purposes only and is implementation specific. This element MAY<31> be ignored for protocol purposes.