-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathcvsync.html
324 lines (291 loc) · 11.2 KB
/
cvsync.html
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
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
<!-- DO NOT EDIT MANUALLY! See comments in www/build/mirrors.dat for details -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>OpenBSD CVSync</title>
<link rev="made" href="mailto:[email protected]">
<meta name="resource-type" content="document">
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="description" content="How to get OpenBSD updates via Internet using CVSync">
<meta name="keywords" content="openbsd,cvsync,updates">
<meta name="distribution" content="global">
<meta name="copyright" content="This document copyright 2003-2009 by OpenBSD.">
</head>
<body bgcolor="#FFFFFF" text="#000000" link="#23238E">
<a href="index.html"><img alt="[OpenBSD]" height="30" width="141" src="images/smalltitle.gif" border="0"></a>
<h2><font color="#e00000">CVSync</font></h2>
<hr>
<h3>Table of Contents</h3>
<ul>
<li><a href="#CVSync">What Is CVSync?</a></li>
<li><a href="#CVS">What Is CVS?</a></li>
<li><a href="#starting">Getting Started Using CVSync</a></li>
<li><a href="#using">Using CVS to Work With Your Repository</a></li>
<li><a href="#CVSROOT">Available CVSync Servers</a></li>
</ul>
<hr>
<h3><a name="CVSync"><font color="#0000e0">What Is CVSync?</font></a></h3>
<p>
<b>CVSync</b> is a software package for distributing and updating source
trees from a master <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&sektion=1">cvs(1)</a> repository on a remote server host. The OpenBSD
sources are maintained in a CVS repository on a central development machine
in Canada. With CVSync, OpenBSD users can easily keep their own source trees
up to date.
</p>
<p>
<b>CVSync</b> uses the so-called pull model of updating. Under the pull
model, each client asks the server for updates, if and when they are
wanted. The server waits passively for update requests from its clients.
Thus all updates are instigated by the client. The server never sends
unsolicited updates. Users must either run the <b>CVSync</b> client
manually to get an update, or they must set up a <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cron&sektion=8">cron(8)</a> job to run it
automatically on a regular basis.
</p>
<p>
The term <b>CVSync</b>, capitalized just so, refers to the entire software
package. Its main components are the client <tt>cvsync</tt> which runs on
each user's machine, and the server <tt>cvsyncd</tt> which runs at each of
the OpenBSD CVSync mirror sites.
</p>
<p>
<b>CVSync</b> is intended to be both faster and more flexible than
<a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sup&sektion=1&format=html">sup(1)</a>
and <a href="cvsup.html">CVSup</a>.
</p>
<p>
The OpenBSD Project currently has six main source repositories:
</p>
<ul>
<li><b>src</b> - Houses all source code for the OpenBSD Operating System.</li>
<li><b>ports</b> - Houses the <a href="./ports.html">OpenBSD Ports</a>.</li>
<li><b>www</b> - Houses all OpenBSD web pages (including this one).</li>
<li><b>X11</b> - Houses OpenBSD's adaptation of the
<a href="http://www.XFree86.org/">XFree86-3</a> software project.
This is here just for historical purposes, most users will have no
reason to use this tree, it is no longer being used.
<li><b>XF4</b> - Houses OpenBSD's adaptation of the XFree86-4 source tree.
<li><b>xenocara</b> - Houses OpenBSD's active X.org v7 source tree.
</ul>
<h3><a name="CVS"><font color="#0000e0">What Is CVS?</font></a></h3>
<p>
CVS is the source code control system used to manage the OpenBSD source
tree. It is described in more detail <a href="anoncvs.html#CVS">here</a>.
Note that CVS and CVSync are entirely different programs. Although
CVS can be used for remote file access, it is not optimized for
wholesale source tree distribution over the net, and CVSync can be
easily an order of magnitude more efficient for this task.
</p>
<h3>
<a name="starting"><font color="#0000e0">Getting Started Using CVSync</font></a>
</h3>
<p>
If you only care about running CVSync, it is recommended that you
download the cvsync package from the <a href="ftp.html">ftp mirror
sites</a> instead of building your own from the <tt>net/cvsync</tt>
port.
</p>
<p>
For further information about CVSync, see the
<a href="http://www.cvsync.org/">project homepage</a>.
</p>
<p>
In order to mirror the OpenBSD repository with CVSync,
the following configuration file might be used:
</p>
<pre>
config {
hostname cvsync.de.openbsd.org
# If your network link is a T1 or faster, comment out the following line.
compress
collection {
name openbsd release rcs
prefix /cvs
umask 002
}
}
</pre>
<p>
This directs cvsync to refresh all OpenBSD distributions from
<b>cvsync.de.openbsd.org</b> with a <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=umask&sektion=2">umask(2)</a> that permits group write
permission to the local repository.
</p>
<p>
Assuming this file is saved as <tt>cvs-syncfile</tt>, the
following command would be used to invoke cvsync
</p>
<pre>
cvsync -c cvs-syncfile
</pre>
<h3><a name="using">
<font color="#0000e0">Using CVS to Work With Your Repository</font>
</a></h3>
<p>
Now that you have a local copy of the CVS repository, it is now simple
to check out, update, or do any of the other CVS operations you would
normally do against a remote repository, locally.
For example:
<pre>
cvs -d/cvs checkout src -P
cvs -d/cvs up -Pd
cvs -d/cvs diff -u file.c
</pre>
More details on CVS operation can be found in
<a href="faq/faq5.html#BldGetSrc">FAQ5, Fetching appropriate source
code</a> and in the
<a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&sektion=1">cvs(1)</a>
man page.
<h3>
<a name="CVSROOT"><font color="#0000e0">Available CVSync Servers</font></a>
</h3>
<p>The following CVSync servers are available:</p>
<p>
<ul>
<li><strong>anoncvs.eu.openbsd.org</strong><br>
Location: Stockholm University, Stockholm, Sweden.<br>
Maintained by <a href="mailto:[email protected]">Janne Johansson</a>.<br>
Updated every 2 hours.<br>
<p>
<li><strong>anoncvs1.usa.openbsd.org</strong><br>
Host also known as <strong>anoncvs.usa.openbsd.org, anoncvs4.usa.openbsd.org</strong>.<br>
Location: Internet Software Consortium, Redwood City, CA, USA.<br>
Maintained by <a href="mailto:[email protected]">Todd C. Miller</a>.<br>
Updated every 2 hours.<br>
<p>
<li><strong>anoncvs3.usa.openbsd.org</strong><br>
Location: National Center for Atmospheric Research, Boulder, CO, USA.<br>
Maintained by <a href="mailto:[email protected]">Todd C. Miller</a>.<br>
Updated every 2 hours.<br>
<p>
<li><strong>obsd.cec.mtu.edu</strong><br>
Location: Michigan Technological University, Houghton, Michigan, USA.<br>
Maintained by <a href="mailto:[email protected]">Chris Linn</a>.<br>
Updated every 2 hours.<br>
<p>
<li><strong>anga.funkfeuer.at</strong><br>
Location: Vienna, Austria.<br>
Maintained by <a href="mailto:[email protected]">Martin Reindl</a>.<br>
Updated every 2 hours from anoncvs1.usa.openbsd.org.<br>
<p>
<li><strong>anoncvs.comstyle.com</strong><br>
Location: Toronto, Canada.<br>
Maintained by <a href="mailto:[email protected]">Brad Smith</a>.<br>
Updated hourly.<br>
<p>
<li><strong>anoncvs.estpak.ee</strong><br>
Location: Elion, Tallinn, Estonia.<br>
Maintained by <a href="mailto:[email protected]">Rivo Nurges</a>.<br>
Updated every 2 hours from cvsync.de.openbsd.org.<br>
<p>
<li><a href="http://mirror.osn.de/"><strong>mirror.osn.de</strong></a><br>
Location: Nürnberg, Germany.<br>
Maintained by <a href="mailto:[email protected]">Armin Wolfermann</a>.<br>
Updated every 3 hours.<br>
<p>
<li><a href="http://www.allbsd.org/"><strong>cvsync.allbsd.org</strong></a><br>
Location: Tokyo, Japan.<br>
Maintained by <a href="mailto:[email protected]">Hiroki Sato</a>.<br>
<p>
<li><a href="http://mirror.sg.depaul.edu/"><strong>mirror.sg.depaul.edu</strong></a><br>
Location: DePaul University, Chicago, IL, USA.<br>
Maintained by <a href="mailto:[email protected]">Eric Pancer</a>.<br>
Updated every 2 hours.<br>
<p>
<li><a href="http://csociety.org/cvsup.html"><strong>cvsync.csociety.org</strong></a><br>
Location: Purdue University, West Lafayette, IN, USA.<br>
Maintained by <a href="mailto:[email protected]">Will Andrews</a>.<br>
<p>
</ul>
<p>
<em>Note:</em> If your server is listed on here with inaccurate or
unknown information, please contact <a
href="mailto:[email protected]"><tt>[email protected]</tt></a>
or <a href="mailto:[email protected]"><tt>[email protected]</tt></a>
</p>
<p>
You may want to use <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=traceroute&sektion=8">traceroute(8)</a>
to find out which server is nearest you.
Problems with a server should be reported to the <b>maintainer</b> of the
server in question.
</p>
<p>
As of April, 2010, the CVS repository sizes are
</p>
<table>
<tr><td width="20"></td>
<td><strong>openbsd-ports</strong></td>
<td>- <b>425</b>MB</td></tr>
<tr><td></td>
<td><strong>openbsd-src</strong></td>
<td>- <b>1684</b>MB</td></tr>
<tr><td></td>
<td><strong>openbsd-www</strong></td>
<td>- <b>401</b>MB</td></tr>
<tr><td></td>
<td><strong>openbsd-xenocara</strong></td>
<td>- <b>723</b>MB</td></tr>
<tr><td></td>
<td><strong>openbsd-x11</strong></td>
<td>- <b>200</b>MB</td></tr>
<tr><td></td>
<td><strong>openbsd-xf4</strong></td>
<td>- <b>564</b>MB</td></tr>
<tr><td></td>
<td><strong>openbsd-cvsroot</strong></td>
<td>- <b>408</b>MB</td></tr>
</table>
<p>
The overall repository size currently increases at a rate
of about <b>400</b>MB per annum.
</p>
<p>
<strong>IMPORTANT NOTE:</strong>
There are a few issues relating to cryptographic software that everyone
should be aware of:
</p>
<ul>
<li>
<p>
The OpenBSD sources are from Canada. As
<a href="http://www.efc.ca/pages/doc/crypto-export.html">
researched by a Canadian individual</a> and as
<a href="http://axion.physics.ubc.ca/ECL.html">
described in the Export Control list of Canada</a>,
it is legal to export crypto software from Canada to the world.
</p>
</li>
<li>
<p>
However, if you are outside the USA or Canada, you should not
fetch the cryptographic sections of the OpenBSD sources from a
CVSync server located in the USA. The files in question are...
</p>
<ul>
<li><tt>src/kerberosIV/*</tt></li>
<li><tt>src/kerberosV/*</tt></li>
<li><tt>src/lib/libdes/*</tt></li>
<li><tt>src/lib/libc/crypt/crypt.c</tt></li>
<li><tt>src/lib/libc/crypt/morecrypt.c</tt></li>
<li><tt>src/sys/crypto</tt></li>
<li><tt>src/sys/netinet</tt></li>
<li><tt>src/usr.sbin/afs/src/rxkad/*</tt></li>
<li><tt>XF4/xc-mit/lib/Xdmcp/Wraphelp.c</tt></li>
<li><tt>XF4/xc-old/lib/Xdmcp/Wraphelp.c</tt></li>
<li><tt>XF4/xc/lib/Xdmcp/Wraphelp.c</tt></li>
</ul>
<p>
Because of the USA ITAR munitions list,
crypto software may only be exported to Canada from the USA.
</p>
</li>
</ul>
<p>
The OpenBSD project is looking for more CVSync servers -- if you are
interested, please contact <a href="mailto:[email protected]">Christian Weisgerber</a>
for configuration details.
</p>
<hr>
<a href="index.html"><img height="24" width="24" src="back.gif" border="0" alt="OpenBSD"></a>
<a href="mailto:[email protected]">[email protected]</a>
<br><small>$OpenBSD: cvsync.html,v 1.68 2010/04/05 12:28:49 matthieu Exp $</small>
</body>
</html>