12 releases

0.3.7 Jan 7, 2024
0.3.6 Jun 11, 2023
0.3.4 May 9, 2023
0.3.2 Nov 9, 2022
0.1.1 Feb 15, 2019

#29 in Date and time

Download history 393/week @ 2023-12-22 374/week @ 2023-12-29 699/week @ 2024-01-05 559/week @ 2024-01-12 671/week @ 2024-01-19 642/week @ 2024-01-26 672/week @ 2024-02-02 815/week @ 2024-02-09 1323/week @ 2024-02-16 1460/week @ 2024-02-23 1195/week @ 2024-03-01 1110/week @ 2024-03-08 1262/week @ 2024-03-15 1397/week @ 2024-03-22 1478/week @ 2024-03-29 1428/week @ 2024-04-05

5,812 downloads per month
Used in 4 crates

BSD-3-Clause

60KB
949 lines

sntpc test Build Status

Simple Rust SNTP client


This crate provides a method for sending requests to NTP servers and process responses, extracting received timestamp.

Supported SNTP protocol versions:

Documentation


https://docs.rs/sntpc

Installation


This crate works with Cargo and is on crates.io. Add it to your Cargo.toml like so:

[dependencies]
sntpc = "0.3.7"

By calling the get_time() method and providing a proper NTP pool or server you should get a valid synchronization timestamp:

use std::net::UdpSocket;
use std::time::Duration;

fn main() {
    let socket =
        UdpSocket::bind("0.0.0.0:0").expect("Unable to create UDP socket");
    socket
       .set_read_timeout(Some(Duration::from_secs(2)))
       .expect("Unable to set UDP socket read timeout");
    let result =
        sntpc::simple_get_time("time.google.com:123", socket);

    match result {
       Ok(time) => {
           let microseconds = sntpc::fraction_to_microseconds(time.sec_fraction());
           println!("Got time: {}.{}", time.sec(), microseconds);
       }
       Err(err) => println!("Err: {:?}", err),
    }
 }

no_std support


Currently, there are basic no_std support available, thanks to no-std-net crate. There is an example available on how to use smoltcp stack and that should provide general idea on how to bootstrap no_std networking and timestamping tools for sntpc library usage

async support


Feature async_tokio allows to use crate together with tokio. There is an example: examples/tokio.rs.

There is also no_std support with feature async, but it requires Rust >= 1.75-nightly version. The example can be found in separate repository.

Examples


You can find several examples that shows how to use the library in details under examples/ folder. Currently, there are examples that show:

  • usage of SNTP library in std environment
  • usage of SNTP library with smoltcp TCP/IP stack. Some std dependencies required only due to smoltcp available interfaces

Contribution


Contributions are always welcome! If you have an idea, it's best to float it by me before working on it to ensure no effort is wasted. If there's already an open issue for it, knock yourself out. See the contributing section for additional details

Thanks

  1. Frank A. Stevenson: for implementing stricter adherence to RFC4330 verification scheme
  2. Timothy Mertz: for fixing possible overflow in offset calculation
  3. HannesH: for fixing a typo in the README.md
  4. Richard Penney: for adding two indicators of the NTP server's accuracy into the NtpResult structure
  5. Vitali Pikulik: for adding async support

Really appreciate all your efforts! Please let me know if I forgot someone.

License


This project is licensed under:

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in time by you, as defined in the 3-Clause BSD license, shall be licensed as above, without any additional terms or conditions.

Dependencies

~0.2–8MB
~35K SLoC