Skip to content

buffcode/ntp-packet-parser

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NPM downloads Build Status NPM version

NTP packet parser

Library to parse NTP response packets according to RFC 5905 into a easy-to-use structure. It does not apply any validations or calculations regarding the time but solely parses the data.

See buffcode/ntp-time-sync for an implementation.

Installation

yarn add ntp-packet-parser

Usage

ES6 style

import { NtpPacketParser } from "ntp-packet-parser";

/** const udpPacket = new Buffer(...); **/
const result = NtpPacketParser.parse(udpPacket);

Legacy style

var NtpPacketParser = require("ntp-packet-parser").NtpPacketParser;

/** const udpPacket = new Buffer(...); **/
var result = NtpPacketParser.parse(udpPacket);

Structure

The response from NtpPacketParser.parse will return the following object structure:

Property Type Description
leapIndicator Integer Warning of an impending leap second to be inserted or deleted in the last minute of the current month
version Integer NTP version number, currently 4
mode Integer Request/response mode
stratum Integer Stratum of the server
poll Integer Integer representing the maximum interval in log2 seconds between successive messages (Note: you need to apply Math.pow(2, <value>) to get the real value)
precision Integer Integer representing the precision of the system clock in log2 seconds (Note: you need to apply Math.pow(2, <value>) to get the real value)
rootDelay Date Total round-trip delay to the reference clock
rootDispersion Date Total dispersion to the reference clock
referenceId String String to identify the particular server or reference clock
referenceTimestamp Date Time when the system clock was last set or corrected
originTimestamp Date Time at the client when the request departed for the server
receiveTimestamp Date Time at the server when the request arrived from the client
transmitTimestamp Date Time at the server when the response left for the client

To get the relative time for any Date property, calculate the difference between "Jan 01 1900 GMT" and the given date.

let rootDelayInMilliseconds = result.rootDelay.getTime() - new Date("Jan 01 1900 GMT").getTime(); 

For further explanations on the possible values of these properties please refer to RFC 5909, Page 19ff.

Testing

Some tests regarding structure, response and error handling exist. To run them locally:

yarn test

Contributing

Please file a PR against master.

License

GNU General Public License Version 3