aboutsummaryrefslogtreecommitdiff
path: root/INSTALL
blob: 03e91b6d4315a3ebef4c2c1eb5cb6de91818ec66 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
tlsdate should build and work on the following Operating Systems:

  Debian GNU/Linux squeeze, wheezy, jessie, sid
  Ubuntu lucid, natty, oneiric, precise, quantal
  CentOS 6.2, 6.3, 6.4
  Fedora 17, 18
  RedHat Enterprise Server 6.4
  OpenSUSE 11.2, 12.3
  FreeBSD 9.2, 10, 11
  Mac OS X 10.8.2, 10.8.3
  ChromeOS Release 25, 26, 27 and above
  Android with the Android NDK (use Makefile.android)
  Arch Linux (Don't forget to symlink to /dev/rtc to /dev/rtc0)
  NetBSD 6.0.1
  OpenBSD 5.2
  Gentoo 20130413
  DragonFly BSD 3.3-DEVELOPMENT
  Debian GNU/kFreeBSD 7.0 (8.2-1-amd64)
  Debian GNU/Hurd

tlsdate should build and might even work on the following Operating Systems:

  Win32 with Cygwin CYGWIN_NT-6.1 1.7.18(0.263/5/3
  Win32 with MinGW
  Haiku r1alpha4

Please file a bug or email the tlsdate team if you have successfully built or
use tlsdate on a platform that is not listed. We are specifically looking for
ports of tlsdate or for tlsdate integration on the following Operating Systems:

  Windows native
  OpenWRT
  pfsense
  OpenVMS
  Irix
  Minix
  Any of the other classic unix systems

Currently porting is in progress or partially documented for:

  Plan9 (with APE)
  Debian GNU/Hurd 7.0 (GNU-Mach 1.3.99-486-dbg/Hurd-0.3)
    Currently we report "server time 0 (difference is about 1367009757 s)"
Building and install of tlsdate on GNU/Linux and FreeBSD:

  ./autogen.sh
  ./configure
  make
  make install

Cleaning is the usual:

  make clean

On Debian Gnu/Linux sid/unstable:

  apt-get install tlsdate

On other versions of Debian GNU/Linux and with Debian backports, tlsdate may be
available:

  apt-get install tlsdate

On recent Debian GNU/Linux and related systems, we provide a systemd service.
It will notice network changes and regularly invoke tlsdate to keep the clock
in sync. Start it like so:

  service tlsdated start

On older Debian GNU/Linux and related systems, we provide an init.d script that
controls the tlsdated daemon. It will notice network changes and regularly
invoke tlsdate to keep the clock in sync. Start it like so:

  /etc/init.d/tlsdated start

Debian GNU/Hurd does not yet support autotools bootstrapping and users must
bootstrap with `make dist` on another platform from the tlsdate git
repository. With such a release tar.gz it is the expected process:

  ./configure
  make
  make install

Please note that setting time on GNU/Hurd has not yet been tested.

On ChromeOS:

 tlsdated and tlsdate are included in the ChromeOS TCB; no install needed. They
 run automatically and are the core ntp service for ChromeOS.

On Gentoo:

  emerge net-misc/tlsdate

On FreeBSD one may also use the ports system:

  cd /usr/ports/sysutils/tlsdate
  make
  make install

On Mac OS X, we require that you have XCode installed. You may also need brew
for autoconf and automake packages:

  brew install autoconf automake libtool pkg-config

It should also be possible to install tlsdate on OS X 10.8.x with brew directly:

  brew install tlsdate

On Fedora:

  yum install tlsdate

To run tlsdated as a service on Fedora:

  systemctl enable tlsdate.service
  systemctl start tlsdate.service

On Arch Linux there is a PKGBUILD in the Arch User Repository:

  https://aur.archlinux.org/packages/tlsdate
  https://aur.archlinux.org/packages/tl/tlsdate/PKGBUILD

Cygwin requires that the user installs openssl-dev, gcc, pkg-config, libtool, automake, autoconf:

  ./configure
  make

On Plan9 the start of building might look something like this:

  ip/ipconfig
  ndb/dns -r
  9fs sources
  /n/sources/contrib/fgb/root/rc/bin/contrib/install fgb/openssl
  mk install

On Haiku we must use gcc4:

  export CC=/boot/develop/abi/x86/gcc4/tools/gcc4.6.3-haiku-121101/bin/gcc
  export LDFLAGS="$LDFLAGS -lbsd"
  ./configure # This includes the above exports currently
  make

OpenBSD builds from source and is not yet in the port system:

  export AUTOCONF_VERSION=<your installed version>
  export AUTOMAKE_VERSION=<your installed version>
  ./autogen.sh
  ./configure
  make
  make install

If you wish to make a Debian package there are several other options. It is
expected that you are building for Sid and that you are familiar with how to
build Debian packages that are for upload into Debian directly. It is expected
that you should build in a chroot if you wish to have reliable and or
reproducible builds.
 
  # Prep your schroot
  mysid=sid$RANDOM;
  schroot -b -c sid -n $mysid;
  dd-schroot-cmd -c $mysid apt-get update;
  dd-schroot-cmd -c $mysid apt-get build-dep tlsdate;
  # If build-dep is building an older tlsdate, you may need these tools too:
  dd-schroot-cmd -c $mysid apt-get install git ca-certificates \
     lintian libevent-dev libseccomp-dev;
  echo "Your chroot is called: $mysid";
  schroot -r -c $mysid
  # Build tlsdate
  git clone https://www.github.com/ioerror/tlsdate/
  cd tlsdate/
  git checkout debian-master
  dpkg-buildpackage -B "-mMyName <MyEmail>" -uc

Building without schroot should work with dpkg-buildpackage but the build
environment will have to be manually configured.

To make a Debian package with git-buildpackage is the expected build process:

  # install dependencies
  apt-get install git ca-certificates \
     lintian libevent-dev libseccomp-dev build-essential \
     autoconf dh-autoreconf dh-systemd automake autotools-dev \
     dh-apparmor libssl-dev libevent-dev libtool pkg-config \
     debhelper fakeroot hardening-wrapper git-buildpackage;
  git clone https://www.github.com/ioerror/tlsdate/
  cd tlsdate/
  git checkout debian-master
  git-buildpackage --git-upstream-branch=master \
    --git-debian-branch=debian-master \
    --git-upstream-tree=master \
    --git-ignore-new

For Android:

To cross compile tlsdate for Android (tested on Linux) you must have the
Android NDK (>=r8) installed somewhere on your system, and define the
environment variable NDK_BASE to be the path to the NDK's root dir.

    export NDK_BASE=/home/user/src/android-ndk-r8d

The Android build also requires a cross-compiled OpenSSL. The Android Makefile
will attempt to build openssl, if you provide the path via the OPENSSL_ANDROID
env var.

    git clone https://github.com/guardianproject/openssl-android.git /path/to/android-openssl
    export OPENSSL_ANDROID=/path/to/android-openssl

Once NDK_BASE and OPENSSL_ANDROID are set properly, you can cross compile tlsdate with:

    make distclean # clean any previous builds
    rm configure   # distclean doesn't remove this file
    make -f Makefile.android

Android NDK: https://developer.android.com/tools/sdk/ndk/index.html
OpenSSL for Android: https://github.com/guardianproject/openssl-android