blob: 96e448aac6723cf3761ee414baa994fff4657e6a [file] [log] [blame]
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 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/tlsdate 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:
tlsdate is part of the ChromeOS TCB; no install needed
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
To make an unsigned Debian package:
git checkout debian-master
make deb
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
To make a Debian source package:
git checkout master
./autogen.sh
./configure && make debian_orig
git checkout debian-master
fakeroot debian/rules clean
cd ../
dpkg-source -i'.*' -b tlsdate
Example of how to build a package for Debian:
# First build the source package above
scp tlsdate_* dixie.torproject.org:~/src/debian-builds/
~/bin/sbuild-stuff tlsdate_0.0.1-1.dsc
# Download or build the package locally
# and sign the .changes or .dsc file
debsign -k0xD81D840E tlsdate_0.0.1-1.dsc
Example of how to upload it (after a Debian sponsor signs off on it):
dget http://www.example.com/tlsdate_0.0.1-1_amd64.changes
dput tlsdate_0.0.1-1_amd64.changes
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