• Home
Name Date Size #Lines LOC

..--

ca-roots/03-May-2024-4,7263,578

dbus/03-May-2024-11196

etc/03-May-2024-2518

init/03-May-2024-3420

m4/03-May-2024-476450

man/03-May-2024-286259

src/03-May-2024-11,9969,096

systemd/03-May-2024-119

tests/03-May-2024-183111

.gitignoreD03-May-2024451 4140

.travis.ymlD03-May-2024305 1312

AUTHORSD03-May-2024146 54

Android.mkD03-May-20242.7 KiB9971

CHANGELOGD03-May-20248.5 KiB169167

HACKING.mdD03-May-20242.7 KiB10963

HARDENINGD03-May-20243.2 KiB7754

INSTALLD03-May-20246.5 KiB218158

LICENSED03-May-20242.4 KiB5239

MODULE_LICENSE_BSD_LIKED03-May-20240

Makefile.amD03-May-20244.1 KiB150111

Makefile.androidD03-May-20242.4 KiB7746

NOTICED03-May-20242.4 KiB5239

READMED03-May-20241.5 KiB4828

TLSDATEPOOLD03-May-20241.4 KiB3223

TODOD03-May-20241.9 KiB4336

apparmor-profileD03-May-20244.2 KiB201162

autogen.shD03-May-2024485 3321

config.hD03-May-20247.5 KiB30477

configure.acD03-May-202424.4 KiB605552

events.dotD03-May-20241.7 KiB5951

mkfileD03-May-2024369 138

run-testsD03-May-20241 KiB4941

test.confD03-May-202449 32

tlsdate-brew-formula.rbD03-May-2024782 2821

tlsdate-seccomp-amd64.policyD03-May-2024729 4948

tlsdate-seccomp-arm.policyD03-May-2024777 5150

tlsdate-seccomp-x86.policyD03-May-2024659 4847

README

1tlsdate: secure parasitic rdate replacement
2
3 tlsdate sets the local clock by securely connecting with TLS to remote
4 servers and extracting the remote time out of the secure handshake. Unlike
5 ntpdate, tlsdate uses TCP, for instance connecting to a remote HTTPS or TLS
6 enabled service, and provides some protection against adversaries that try to
7 feed you malicious time information.
8
9On Debian GNU/Linux and related systems, we provide an init.d script that
10controls the tlsdated daemon. It will notice network changes and regularly
11invoke tlsdate to keep the clock in sync. Start it like so:
12
13  /etc/init.d/tlsdate start
14
15
16Here is an example an unprivileged user fetching the remote time:
17
18  % tlsdate -V -n -H encrypted.google.com
19  Fri Apr 19 17:56:46 PDT 2013
20
21
22This is an example run - starting as root and dropping to nobody, setting the
23clock and printing it:
24
25  % sudo tlsdate -V
26  Fri Apr 19 17:57:49 PDT 2013
27
28
29Here is an example with a custom host and custom port without verification:
30
31  % sudo tlsdate --skip-verification -p 80 -H rgnx.net
32
33Here is an example where a system may not have any kind of RTC at boot. Do the
34time warp to restore sanity and do so with a leap of faith:
35
36  % sudo tlsdate -V -l -t
37  Fri Apr 19 18:08:03 PDT 2013
38
39
40Some SSL/TLS services do not provide accurate time in their handshake process;
41tlsdate may also be used to fetch time by processing the HTTP Date headers of
42HTTP services:
43
44  % sudo tlsdate -V -l -t -w
45  Wed Oct 30 18:08:46 CET 2013
46
47
48