Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix descriptions of root-delay and root-dispersion #1024

Closed
wants to merge 1 commit into from

Conversation

nkitchen
Copy link
Contributor

  • Remove the comment about reconsidering units of root-delay. As long as it's uint32, milliseconds are the smallest possible units that allow it to have sufficient range. (The root delay values in NTP packets have a maximum value of about 18 hours. The range of a uint32 as milliseconds is 2^32 * 0.001 seconds = about 1193 hours. That's big enough, by far. The range of a uint32 as microseconds is about 1.193 hour = too small.)
  • The old description of root-delay matched the (single-server = non-"root") delay, but the root delay is accumulated across strata.
  • The old description of root-dispersion was not clearly differentiated from the (single-server = non-"root") dispersion.

This change suggests the question: Does it make sense for these leaf nodes to be the root values, rather than the single-server values? I think the answer is yes, because the root delay and dispersion are included among the fields in NTP packets.

Change Scope

  • This change affects only node descriptions. It is backwards compatible.

Platform Implementations

  • N/A

 * Remove the comment about reconsidering units of root-delay.
   As long as it's uint32, milliseconds are the smallest possible units
   that allow it to have sufficient range.  (The root delay values in
   NTP packets have a maximum value of about 18 hours.  The range of
   a uint32 as milliseconds is 2^32 * 0.001 seconds = about 1193 hours.
   That's big enough, by far.  The range of a uint32 as microseconds is
   about 1.193 hour = too small.)
 * The old description of root-delay matched the (single-server =
   non-"root") delay, but the *root* delay is accumulated across strata.
 * The old description of root-dispersion was not clearly differentiated
   from the (single-server = non-"root") dispersion.

This change suggests the question: Does it make sense for these leaf
nodes to be the root values, rather than the single-server values?
I think the answer is yes, because the root delay and dispersion are
included among the fields in NTP packets.
@nkitchen nkitchen requested a review from a team as a code owner December 21, 2023 02:01
@OpenConfigBot
Copy link

No major YANG version changes in commit dd5df4d

@nkitchen
Copy link
Contributor Author

I included these description updates in #1023, so this PR is no longer needed.

@nkitchen nkitchen closed this Jan 15, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

3 participants