xref: /freebsd/contrib/ntp/README.bk (revision 4b2eaea43fec8e8792be611dea204071a10b655a)
1In order to use the BitKeeper repository version of NTP you will have
2to have the following tools installed:
3
4	autoconf	2.52 or later
5	automake	1.5 or later
6	lynx
7
8Lynx is used to generate the COPYRIGHT file.  Don't ask.
9
10You can get bitkeeper by visiting:
11
12	http://www.bitkeeper.com/
13
14We are using bitkeeper under their free license program.  You can use
15bitkeeper for free to access NTP, too.  If you have questions about this,
16please ask.  The license is pretty easy to read.
17
18Once you have installed bitkeeper, you can clone any NTP repository.
19
20	Note: as of 2002-05, ntp.bkserver.net and ntp.bkbits.net are
21	being upgraded.  Depending on the "phase" of the upgrade, one
22	of the two machines may not answer.
23
24You can get the ntp-stable repository by either of the following commands:
25
26     bk clone bk://www.ntp.org/home/bk/ntp-stable ntp-stable
27
28     bk clone bk://ntp.bkserver.net/ntp-stable ntp-stable
29
30     bk clone bk://ntp.bkbits.net/ntp-stable ntp-stable
31
32You can get the ntp-dev repository by either of the following commands:
33
34     bk clone bk://www.ntp.org/home/bk/ntp-dev ntp-dev
35
36     bk clone bk://ntp.bkserver.net/ntp-dev ntp-dev
37
38     bk clone bk://ntp.bkbits.net/ntp-dev ntp-dev
39
40The IPV6 patch has been applied:
41
42     bk clone bk://www.ntp.org/home/bk/ntp-dev-ipv6 ntp-dev-ipv6
43
44     bk clone bk://ntp.bkserver.net/ntp-dev-ipv6 ntp-dev-ipv6
45
46     bk clone bk://ntp.bkbits.net/ntp-dev-ipv6 ntp-dev-ipv6
47
48The ntp-dev-ipv6 repository will be merged back in to the ntp-dev repo
49as soon as the code is stable.
50
51If you are stuck behind a firewall that blocks access to the default port
52used by bitkeeper (14690) but you can use port 80 instead, you can use
53http as a bk transport mechanism.  Just use:
54
55     bk clone http://ntp.bkserver.net/REPO REPO
56
57Finally, it's possible to use SMTP as a bk transport mechanism.  So far, we
58haven't tried this.
59
60Once you have obtained the sources, do the following:
61
62	cd REPO
63	bk -r edit		to check out the files
64	autoreconf -f -i	generates configure and Makefile.in's
65
66and you should be ready to go.  You will get some warning messages from
67autoreconf.  Ignore these messages.
68
69You can update your repository by incanting:
70
71	cd REPO
72	bk pull
73