#ntp #date #system-time #date-time #time

app rsdate

rsdate connects to an ntp server, printing the returned time and/or sets the system clock

4 releases (breaking)

0.5.0 Jun 30, 2022
0.4.0 Jan 26, 2022
0.3.0 Oct 17, 2021
0.1.0 Oct 11, 2021

#300 in Date and time

MIT/Apache

14KB
267 lines

🦀📅
rsdate

rsdate connects to an ntp server, printing the returned time and/or sets the system clock.


Example:

$ rsdate pool.ntp.org
[2021-10-11T05:02:32Z INFO  rsdate] [pool.ntp.org]	Mon, 11 Oct 2021 15:02:32 +1000

Download

Pre-compiled binaries are available for a number of platforms.

Example to download and extract a binary:

curl https://releases.wezm.net/rsdate/0.5.0/rsdate-0.5.0-x86_64-unknown-linux-musl.tar.gz | tar zxf -

Usage

USAGE:
    rsdate [OPTIONS] <HOST>

ARGS:
    <HOST>
        The ntp server to contact.

OPTIONS:
    -h, --help
            Prints help information

    -p, --print
            Print the time returned by the server.

    -r, --retry NUMBER
            If retrieving the time fails retry NUMBER times. Retries are made
            at 1, 2, 4, 8, 16, etc. seconds.  A value of 0 disables retry
            (default). A negative value retries forever.

    -s, --set
            Set the system time to the returned time.

    -t, --timeout TIMEOUT
            Sets response timeout in seconds. [default: 10]

    -l, --syslog
            Print messages to syslog.

    -V, --version
            Prints version information

Build from Source

Minimum Supported Rust Version: 1.58.1

rsdate is implemented in Rust. See the Rust website for instructions on installing the toolchain.

From Git Checkout or Release Tarball

Build the binary with cargo build --release --locked. The binary will be in target/release/rsdate.

From crates.io

cargo install rsdate

Credits

This tool is inspired by rdate.

Licence

This project is dual licenced under either of:

at your option.

Dependencies

~1.5MB
~22K SLoC