INSTALL - chromiumos/third_party/tlsdate - Git at Google

 tlsdate should build and work on the following Operating Systems:

   Debian Gnu/Linux squeeze, wheezy, 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 10-CURRENT
   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)

 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
	tlsdate should build and work on the following Operating Systems:

	Debian Gnu/Linux squeeze, wheezy, 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 10-CURRENT
	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)

	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