Annotation of www/anoncvs.html, Revision 1.82
1.1 deraadt 1: <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML Strict//EN">
2: <html>
3: <head>
1.49 ian 4: <title>OpenBSD AnonCVS</title>
5: <link rev=made href=mailto:www@openbsd.org>
6: <meta name="resource-type"
7: content="document">
8: <meta name="description"
9: content="How to get OpenBSD updates via Internet using Anonymous CVS">
10: <meta name="keywords"
11: content="openbsd,anoncvs,updates">
12: <meta name="distribution"
13: content="global">
14: <meta name="copyright"
15: content="This document copyright 1996-1998 by OpenBSD.">
1.1 deraadt 16: </head>
17:
1.14 downsj 18: <BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#23238E">
1.1 deraadt 19:
1.58 pauls 20: <img alt="[OpenBSD]" height=30 width=141 SRC="images/smalltitle.gif">
1.14 downsj 21:
1.43 deraadt 22: <h3><font color=#0000e0>Anonymous CVS Access:</font></h3>
1.15 grr 23: <p>
24: Anonymous CVS is a method of keeping your local copy of the OpenBSD source
25: tree up to date with respect to changes made to current OpenBSD sources.
1.14 downsj 26: <p>
1.15 grr 27: The major advantage of Anonymous CVS over other source code update
28: techniques is that it works directly against a central source code
29: repository or mirror. This means that you have the full set of CVS
30: commands available to control merging and updating your changes with
31: other source changes and for performing diff's, change histories
32: and other queries against the central repository.
1.36 deraadt 33: <p>
34: You can use anoncvs to access our three main source repositories:
35: <strong>src</strong>, <strong>ports</strong>, and <strong>www</strong>.
36: <p>
1.43 deraadt 37: <h3><font color=#0000e0>CVS:</font></h3>
1.36 deraadt 38: <a href=why-cvs.html>
39: CVS is the source code control system used to manage the OpenBSD source tree.</a>
1.16 deraadt 40: It implements a central repository for all officially released source code
1.15 grr 41: and changes, while permitting developers to maintain local copies of the
42: source code with their working changes. Developers with "write access"
43: can commit changes directly to the OpenBSD source tree, while "Anonymous
44: CVS" users have "read access" and can keep their local copies of the source
45: up to date and issue queries against the central depository.
46: <p>
1.22 niklas 47: The major strength of CVS is that it has the ability to perform intelligent
1.15 grr 48: merges of changes to the central repository with changes that you make to
49: your local copy. This means that if you make a change to a module and
50: perform an update, your changes are not "blown away", rather CVS makes
51: best efforts to merge the changes made to the central sources with changes
52: you've made to your local copy.
53: <p>
54: In the event that the changes can't be completely merged, CVS provides a
55: "soft fallback", in terms of providing you with annotated changes to your
1.39 todd 56: local copy, preserving an unmodified copy of your version and continuing
1.15 grr 57: to update any other source modules you requested.
1.22 niklas 58: <p>
1.23 mickey 59: People who own an OpenBSD CD may have seen the CVS/ dirs on it.
1.22 niklas 60: Actually there is a reason, the CD has a checkout of the OpenBSD src/ module
1.23 mickey 61: usable to continue updating from. Using this tree will results in a much
62: faster initial CVS update than a fresh checkout of the full OpenBSD
63: source tree. There are two ways of using the CD:
64: <ul>
65: <li>copy the tree off it, (assuming the CD is mounted on /mnt):
1.22 niklas 66: <pre>
1.23 mickey 67: <b>#</b> cd /mnt; cp -Rp CVS Makefile bin distrib etc games gnu \
68: <b>></b> include kerberosIV lib libexec lkm regress sbin share \
69: <b>></b> sys usr.bin usr.sbin /usr/src
1.22 niklas 70: </pre>
1.23 mickey 71: <li>use a union mount with the CD below a writable directory.
1.22 niklas 72: <pre>
1.23 mickey 73: <b>#</b> mount -t union -o -b /mnt /usr/src
1.22 niklas 74: </pre>
1.23 mickey 75: </ul>
1.22 niklas 76: After this, /usr/src will be a nice checkout area where all cvs(1) commands
77: will work OK.
1.15 grr 78: <h4>CVS COMMAND SUMMARY</h4>
1.27 todd 79: <dt> cvs [cvs args] [cvs command] [cvs command args]
80: <dd> below is a listing of commonly used cvs commands.
1.15 grr 81: <dl>
82: <DT>add
83: <dd>Add a new file or directory to the repository.
84: <dt>get
85: <dd>Make a working directory of source files for editing.
86: <dt>commit
87: <dd>Apply changes to the source repository (write access)
88: <dt>diff
89: <dd>Show differences between local files and the source repository.
90: <dt>history
91: <dd>Show reports on cvs commands against the source repository.
92: <dt>log
93: <dd>Display CVS log information.
94: <dt>rdiff
95: <dd>Prepare a collection of diffs reflecting changes between release.
96: <dt>status
97: <dd>Show current status of files in the repository and local copies.
98: <dt>update
99: <DD>Bring your working directory up to date with the repository.
100: </dl>
1.1 deraadt 101: <p>
1.39 todd 102: To summarize, the real strength of using Anonymous CVS is that it is
1.15 grr 103: a "tolerant" source code control system - it <strong>respects</strong>
104: changes that you have made to your local sources and makes <strong>
105: "best efforts"</strong> to update your entire source tree, rather than
106: leaving you a list of arcane problems that have to be resolved before
107: continuing.
1.1 deraadt 108:
1.43 deraadt 109: <h3><font color=#0000e0>Using Anonymous CVS:</font></h3>
1.1 deraadt 110: <p>
111: The latest version of CVS is available at
1.47 pauls 112: <a href=http://download.cyclic.com/pub/>Cyclic</a>.
1.1 deraadt 113: Versions earlier than 1.6 are not recommended, and may not work.
114: If you already have OpenBSD installed, CVS is included.
115:
116: <p>
117: There are two levels of source tree access:
118:
119: <dl>
120: <dt><strong>Read-write access for developers:</strong>
121: <dd>Developers who need to commit changes to the source tree must have
122: an account on the OpenBSD machines. Getting this access will be a
123: natural result of working on the sources with other OpenBSD developers.
124: If someone does some good work and shows they can work with the team,
125: they will get an account.
126: </dl>
127:
128: <dl>
129: <dt><strong>Read-only access for everyone:</strong>
130: <dd>Anyone can access the read-only CVS repositories. These copies
131: of the read-write CVS repository are mirrored often. To use one,
132: set your <strong>CVSROOT</strong> environment variable to one of
133: the following values:
1.12 grr 134: <p>
135: <strong>Please see the note about using ssh vs. rsh below!</strong>
136: <p>
1.1 deraadt 137: <ul>
138: <p>
139: <li><strong>CVSROOT=anoncvs@anoncvs.usa.openbsd.org:/cvs</strong><br>
1.10 millert 140: Host also known as <strong>anoncvs.openbsd.org</strong>,
141: <strong>anoncvs@anoncvs1.usa.openbsd.org</strong>,
142: <strong>anoncvs@anoncvs4.usa.openbsd.org</strong> and
143: <strong>anoncvs2.isc.org</strong>.<br>
144: located in California, western USA.<br>
1.46 millert 145: maintained by <a href=mailto:millert@openbsd.org>Todd Miller</a>.<br>
1.10 millert 146: protocols: ssh only.<br>
1.1 deraadt 147: updated every 4 hours.<br>
1.66 millert 148: Currently DOWN!<br>
1.1 deraadt 149: <p>
150: <li><strong>CVSROOT=anoncvs@anoncvs3.usa.openbsd.org:/cvs</strong><br>
1.82 ! millert 151: Host also known as <strong>anonopenbsd.cs.colorado.edu</strong>.<br>
1.1 deraadt 152: located at the University of Colorado, Boulder, western USA.<br>
153: maintained by <a href=mailto:Todd.Miller@cs.colorado.edu>Todd Miller</a>.<br>
1.71 millert 154: protocols: ssh, ssh port 2022, pserver.<br>
1.1 deraadt 155: updated every 6 hours.<br>
156: <p>
1.76 deraadt 157: <li><strong>CVSROOT=anoncvs@anoncvs5.usa.openbsd.org:/cvs</strong><br>
158: Host also known as <strong>squid.nas.nasa.gov</strong>.<br>
159: located at Ames Research Center, Moffett Field, California, USA.<br>
1.78 deraadt 160: maintained by <a href=mailto:allison@mail.arc.nasa.gov>Tyler Allison</a>.<br>
1.77 deraadt 161: protocols: ssh only.<br>
162: updated every 3 hours.<br>
1.76 deraadt 163: <p>
1.31 deraadt 164: <li><strong>CVSROOT=anoncvs@anoncvs6.usa.openbsd.org:/cvs</strong><br>
165: Host also known as <strong>openbsd.citi.umich.edu</strong>.<br>
166: located at the University of Michigan, central USA.<br>
167: maintained by <a href=mailto:rees@umich.edu>Jim Rees</a>.<br>
168: protocols: ssh, ssh port 2022.<br>
169: updated every 12 hours.<br>
170: <p>
1.24 deraadt 171: <li><strong>CVSROOT=anoncvs@anoncvs1.ca.openbsd.org:/cvs</strong><br>
1.40 beck 172: Host also known as <strong>anoncvs.ca.openbsd.org</strong>,
1.74 beck 173: <strong>openbsd.sunsite.ualberta.ca</strong><br>
1.24 deraadt 174: located in Edmonton, Alberta, Canada.<br>
1.80 beck 175: maintained by <A HREF="mailto:beck@ualberta.ca">Bob Beck</A><br>
1.53 beck 176: protocols: ssh, rsh, ssh port 2022, pserver<br>
1.45 beck 177: updated every 2 hours.<br>
1.24 deraadt 178: <p>
1.1 deraadt 179: <li><strong>CVSROOT=anoncvs@anoncvs.uk.openbsd.org:/cvs</strong><br>
180: Host also known as <strong>dumpty.wonderland.org</strong>.<br>
181: located in London, UK.<br>
182: maintained by <a href=mailto:peter@wonderland.org>Peter Galbavy</a>.<br>
183: protocols: rsh.<br>
184: updated every 12 hours.<br>
185: <p>
186: <li><strong>CVSROOT=anoncvs@anoncvs.tw.openbsd.org:/cvs</strong><br>
1.64 deraadt 187: Host also known as <strong>OpenBSD.csie.NCTU.edu.tw</strong>.<br>
1.1 deraadt 188: located in Taipei, Taiwan.<br>
1.63 deraadt 189: maintained by <a href=mailto:lkchu@OpenBSD.csie.NCTU.edu.tw>Liang-Kai Chu</a>.<br>
1.1 deraadt 190: protocols: rsh, ssh, ssh port 2022.<br>
191: updated every 12 hours.<br>
192: <p>
193: <li><strong>CVSROOT=anoncvs@anoncvs.no.openbsd.org:/cvs</strong><br>
1.64 deraadt 194: Host also known as <strong>cvs.inet.no</strong>.<br>
1.1 deraadt 195: located in Norway.<br>
1.64 deraadt 196: maintained by <a href=mailto:cvsadmin@inet.no>Michael Shuldman</a>.<br>
1.1 deraadt 197: protocols: rsh, ssh, ssh port 2022.<br>
198: updated every 4 hours.<br>
199: <p>
1.33 deraadt 200: <li><strong>CVSROOT=anoncvs@anoncvs.se.openbsd.org:/cvs</strong><br>
1.54 art 201: Host also known as <strong>anoncvs.stacken.kth.se</strong>.<br>
1.33 deraadt 202: located in Sweden.<br>
203: maintained by <a href=mailto:anoncvs@stacken.kth.se>Magnus Holmberg</a>.<br>
204: protocols: rsh, ssh, ssh port 2022.<br>
1.57 art 205: updated every 3 hours.<br>
1.68 wvdputte 206: <p>
207: <li><strong>CVSROOT=anoncvs@anoncvs.be.openbsd.org:/cvs</strong><br>
208: Host also known as <strong>badlands.rug.ac.be</strong>.<br>
209: located in Belgium.<br>
210: maintained by <a href=mailto:wvdputte@reptile.rug.ac.be>Wim Vandeputte</a>.<br>
211: protocols: ssh, ssh port 2022.<br>
212: updated every 3 hours.<br>
1.69 deraadt 213: <p>
214: <li><strong>CVSROOT=anoncvs@anoncvs.jp.openbsd.org:/cvs</strong><br>
215: Host also known as <strong>kankoromochi.econ.nagasaki-u.ac.jp</strong>.<br>
216: located at Nagasaki Univ. Faculty of Economics, JAPAN.<br>
217: maintained by <a href=mailto:sigh@net.nagasaki-u.ac.jp>SUZUKI Hitoshi</a>.<br>
1.79 deraadt 218: protocols: ssh, pserver.<br>
219: updated every 3 hours.<br>
1.73 deraadt 220: <li><strong>CVSROOT=anoncvs@anoncvs.cz.openbsd.org:/cvs</strong><br>
221: Host also known as <strong>com-os2.ms.mff.cuni.cz</strong>.<br>
222: located at Faculty Math & Physics, Charles University, Prague, Czech republic.<br>
223: maintained by <a href=mailto:galambos@com-os2.ms.mff.cuni.cz>Leo Galambos</a>.<br>
224: protocols: ssh, ssh port 2022.<br>
225: updated every 3 hours.<br>
1.80 beck 226:
227: <li><strong>CVSROOT=anoncvs@exokernel.lcs.mit.edu:/cvs</strong><br>
228: located at M.I.T, Eastern USA.<br>
229: maintained by ????<br>
230: protocols: ssh, ???<br>
231: updated every ? hours.<br>
232:
233: <li><strong>CVSROOT=anoncvs@xyzzy.gsnig.net:/cvs</strong><br>
234: Located in Goteborg, Sweden<br>
235: maintained by martin@openbsd.org<br>
236: protocols: ssh, ???<br>
237: updated every ? hours.<br>
238:
239: <li><strong>CVSROOT=anoncvs@stl-isaas.ey.com:/cvs</strong><br>
1.81 beck 240: Located in the St. Louis, MO, Eastern USA<br>
241: maintained by <A HREF="mailto:aaron11@sprynet.com">Aaron Miller</A><br>
242: protocols: ssh, ssh port 2022, pserver<br>
243: updated every 3 hours.<br>
1.80 beck 244:
245: <li><strong>CVSROOT=anoncvs@headend-vlan1-cm19.fibertel.com.ar:/cvs</strong><br>
246: Located in Buenos Aires, Argentina<br>
247: maintained by ????<br>
248: protocols: ssh?, ???<br>
249: updated every ? hours.<br>
1.73 deraadt 250: </ul>
251: <p>
1.80 beck 252: <EM>Note:</EM>, If your server is listed on here with inaccurate or
253: unknown information, please contact <A
254: HREF="mailto:beck@openbsd.org"><tt>beck@openbsd.org></tt></A>
255: <p>
1.1 deraadt 256: You may want to use `traceroute' to find out which server is nearest you.
1.11 michaels 257: Problems with a server should be reported to the <b>maintainer</b> of the
258: server in question.
1.1 deraadt 259: </dl>
260: <p>
261: <strong>IMPORTANT NOTE:</strong>
262: There are a few issues relating to cryptographic software that everyone
263: should be aware of:
264: <ul>
265: <li>The OpenBSD sources are from Canada.
1.9 deraadt 266: As
267: <a href=http://insight.mcmaster.ca/org/efc/pages/doc/crypto-export.html>
268: researched by a Canadian individual</a>
269: and as
270: <a href=http://axion.physics.ubc.ca/ECL.html>
271: described in the Export Control list of Canada</a>
272: is legal to export crypto software from Canada to the world.
1.1 deraadt 273: <p>
274: <li>However, if you are outside the USA or Canada, you should not
275: fetch the cryptographic sections of the OpenBSD sources from an
276: anoncvs server located in the USA. The files in question are...
277: <ul>
278: <li>src/kerberosIV/*
1.57 art 279: <li>src/lib/libdes/*
1.1 deraadt 280: <li>src/lib/libc/crypt/crypt.c
281: <li>src/lib/libc/crypt/morecrypt.c
1.36 deraadt 282: <li>src/sys/netinet
1.67 art 283: <li>src/usr.sbin/afs/src/rxkad/*
1.56 matthieu 284: <li>X11/xc/lib/Xdmcp/Wraphelp.c
1.1 deraadt 285: </ul>
286: Because of the USA ITAR munitions list,
287: crypto software may only be exported to Canada from the USA.
288: <p>
289: <li>The OpenBSD project is looking for more anoncvs servers -- read
290: on to find out how you can help.
291: </ul>
292:
293: <p>
294: A sample use of an anoncvs CVS server would be:
1.27 todd 295: <ul>
1.1 deraadt 296: <pre>
1.59 beck 297: % setenv CVSROOT anoncvs@anoncvs.ca.openbsd.org:/cvs
1.1 deraadt 298: % cd /tmp
299: % cvs get src/sys/arch/sparc
1.12 grr 300: [copies the files from the repository to your machine]
1.1 deraadt 301: % cvs log src/sys/arch/sparc/sparc/locore.s
1.12 grr 302: [shows the commit log for the chosen file ]
1.1 deraadt 303: % cvs diff -bc -r1.1 -r1.5 src/sys/arch/sparc/sparc/locore.s
1.12 grr 304: [shows the changes between revisions 1.1 and rev 1.5]
1.1 deraadt 305: </pre>
1.27 todd 306: </ul>
1.1 deraadt 307:
308: <p>
1.18 todd 309: <a name=pserver>In order to use a cvs ``pserver'' (a direct tcp connection instead of using ssh or rsh) you must login once:</a>
310: <pre>
311: [ *NOTE* You must be using cvs version 1.8 or higher to do this ]
1.59 beck 312: % setenv CVSROOT :pserver:anoncvs@anoncvs.ca.openbsd.org:/cvs
1.18 todd 313: % cvs login
1.59 beck 314: (Logging in to anoncvs@anoncvs1.ca.openbsd.org)
1.71 millert 315: CVS password: anoncvs
1.18 todd 316: [this writes a line to ~/.cvspass (filename over-ridden by CVS_PASSFILE).]
317: [An example line from my ~/.cvspass after typing 'blah' for the above ]
318: [password is: ]
319: [:pserver:anoncvs@anoncvs5.usa.openbsd.org:/cvs Au'yc ]
320: [...after logging in ONCE every other use of the above CVSROOT will work ]
321: % cvs -z9 get ksrc-i386 ksrc-common
322: [allows you to retrieve ONLY that necessary to rebuild an i386 kernel ]
323: [ -z9 allows gzip -9 compression, GOOD medicine for slow links ]
324: </pre>
325:
326: <p>
1.39 todd 327: Here is how someone using anoncvs regularly would update his
1.1 deraadt 328: source tree:
1.60 millert 329: <ul><li>First, start out by `get'-ing an initial tree:
1.27 todd 330:
1.1 deraadt 331: <pre>
1.59 beck 332: # setenv CVSROOT anoncvs@anoncvs.ca.openbsd.org:/cvs
1.1 deraadt 333: # cd /usr
334: # cvs -q get -PA src
335: </pre>
1.27 todd 336: </li>
1.37 todd 337:
1.27 todd 338: <li> Anytime afterwards, to `update' this tree:
1.1 deraadt 339: <pre>
1.41 deraadt 340: # cd /usr/src
341: # cvs -q up -PAd
1.1 deraadt 342: </pre>
1.27 todd 343:
1.39 todd 344: Everytime you ran this it would synchronize your /usr/src tree. It would
1.1 deraadt 345: not destroy any of your local changes, rather it would attempt to merge
346: changes in. If you use obj directories (not obj symbolic links) you may
347: wish to append "-I obj" to the cvs command line, this will keep cvs from
348: spitting out a warning about all the obj directories it is going to
349: encounter which are not in the repository.
1.72 millert 350:
351: <p>
352: <li> NOTE: if you are updating a source tree that you initially fetched
353: from a different server, or from a CD, you <strong>must</strong>
354: add the <em>-d $CVSROOT</em> options to cvs. You must also set the
355: <em>CVS_IGNORE_REMOTE_ROOT</em> environment variable.
356:
357: <pre>
358: # cd /usr/src
359: # cvs -d $CVSROOT -q up -PAd
360: </pre>
361:
1.27 todd 362: </li>
363: </ul>
364:
1.37 todd 365: <p>
366: To <a name=ports>use</a> <a href=ports.html>ports</a>, it is similar to src:
367: <ul><li>
368: <pre>
1.59 beck 369: # setenv CVSROOT anoncvs@anoncvs.ca.openbsd.org:/cvs
1.37 todd 370: # cd /usr
371: # cvs -q get -PA ports
1.38 deraadt 372: </pre>
1.37 todd 373: </li>
374: <li> Anytime afterwards, to `update' this tree:
375: <pre>
376: # cd /usr
377: # cvs -q up -PAd ports
378: </pre>
379: </li>
380: </p>
381: </ul>
382:
1.27 todd 383: In the above example, '-q' is optional, only intended to minimize
384: cvs's output. For those who like to see screenfulls of output, it
385: can be omitted.
1.1 deraadt 386:
387: <p>
1.12 grr 388: or to make a diff of a locally patched module (here cd.c) to include with
389: a bug report:
390: <pre>
391: # cd /usr
392: # cvs diff -u src/sys/scsi/cd.c > /tmp/patch
393: </pre>
1.37 todd 394: </p>
1.12 grr 395:
396: <p>
1.1 deraadt 397: The CVS man page (included with the CVS sources) has much more
398: information about how CVS can be used.
399:
400: <p>
1.12 grr 401: <strong>Warning:</strong>
402: When using cvs you should take care that your current directory is either
403: the root of the tree you're referencing or in a separate place such as /tmp.
404: Some commands such as "get" can create an arbitrary sub-tree in the current
405: directory, and a subsequent update will recursively flesh out this sub-tree.
406:
407: <p>
1.1 deraadt 408: The anoncvs service gives fledgling developers a chance to learn CVS
409: operation and get thoroughly involved in the development process
410: before getting "commit" access -- as a result of showing useful
411: skills and high quality results they will naturally later be given
412: developer access. As well, people providing patches can create
413: their "diff"s relative to the CVS tree, which will ease integration.
414:
415: <p>
1.15 grr 416: <strong>Anoncvs: rsh vs. ssh</strong>
1.12 grr 417: <br>
418: By default, the CVS client uses rsh to talk to the CVS server. Many
1.39 todd 419: of the CVS sites no longer support rsh for security reasons or a local
1.12 grr 420: problem like a firewall or imperfect protocol emulator such as slirp
421: may prevent you from using rsh.
422: The alternative is a to use a "secure shell" connection using
1.48 ryker 423: <a href=http://www.cs.hut.fi/ssh/>ssh</a>. This is a commercial product
1.12 grr 424: offered by <a href=http://www.ssh.fi>SSH Communications Security Ltd</a>,
425: however they make a free unix version available that can be easily
1.68 wvdputte 426: installed under OpenBSD. Make sure you read the LICENSING doc! If you have
427: installed the OpenBSD <A HREF="ports.html">ports tree</A> you can download,
428: compile, and install the free UNIX version just by changing directory into the
429: directory /usr/ports/security/ssh and typing <KBD>make install</KBD>.
430: If you installed "ports" from the OpenBSD 2.4 CD-ROM, you get ssh
431: version 1.2.26 and should eventually "cvs update ports" and rebuild it as above
1.49 ian 432: after you get ssh and anoncvs working, to get the latest version.
1.68 wvdputte 433: Alternately, you can manually download the latest 1.2.* Unix version from
434: <a href= "ftp://ftp.funet.fi/pub/unix/security/login/ssh/">
435: ftp://ftp.funet.fi/pub/unix/security/login/ssh/</a> or
436: <a href= "http://www.datafellows.com/f-secure/fnetsys.htm">
437: http://www.datafellows.com/f-secure/fnetsys.htm</a>,
438: compile, and install it yourself.
439:
440: <p>
441: The OpenBSD anoncvs repositries support the SSH1 protocol, not the SSH2 protocol
442: due to the use of a "strict non-commercial use licensing policy".
1.28 beck 443:
1.75 millert 444: <p>
445: Once ssh is installed, one sets the environment variable
1.28 beck 446: <strong>CVS_RSH</strong> to point to ssh (typically
447: <strong>/usr/local/bin/ssh</strong>). If your local site prevents you
448: from connecting out to port 22 (which ssh defaults to using) use port
449: 2022.
1.1 deraadt 450:
451: <p>
452: Do not be tempted to turn on compression since CVS already compresses.
453: Use something like the following in your <strong>$HOME/.ssh/config</strong>
1.10 millert 454: file. Note that not all anoncvs servers allow ssh connections on
1.21 millert 455: port 2022. Also note that most anoncvs servers no longer accept
456: the <strong>none</strong> cipher as it is disabled in recent
457: versions of ssh for security reasons.
1.1 deraadt 458: <pre>
1.59 beck 459: Host anoncvs.ca.openbsd.org
1.1 deraadt 460: Port 2022
461: </pre>
462:
463: <p>
464: CVS is a little noisy starting up; to quiet it a bit you may want to
465: do this:
466: <pre>
467: setenv CVS_CLIENT_PORT -1
468: </pre>
469:
470: <p>
1.8 deraadt 471: If you wish to change from one CVS server to another (say your normal one is
472: down, or for any other reason), the environment variable which will let you
473: do this is
474: <pre>
475: setenv CVS_IGNORE_REMOTE_ROOT
476: </pre>
1.72 millert 477: Note that you will also need to use the <strong>-d</strong> flag
478: as mentioned above.
1.8 deraadt 479:
1.65 matthieu 480: <p><strong>X11 Source tree</strong>
481: <br>
482: Anoncvs mirrors also carry the OpenBSD X11 source tree. You can adapt
483: the recipe above to update your X11 source tree from the second CD.
484: Either copy or use a union mount to get the X11 sources in /usr/X11:
485: <ul>
486: <li>copy the tree off it (assuming the 2nd CD is mounted on /mnt):
487: <pre>
488: <b>#</b> cd /mnt; cp -Rp X11 /usr
489: </pre>
490: <li>use a union mount with the CD below a writable directory.
491: <pre>
492: <b>#</b> mount -t union -o -b /mnt/X11 /usr/X11
493: </pre>
494: </ul>
495: After this, /usr/X11 will be ready to be used by cvs. You can for
496: example update it to -current source (assuming you've already set
497: the <b>CVSROOT</b> environment variable):
498: <pre>
499: <b>#</b> cd /usr/X11
500: <b>#</b> cvs -q update -PAd
501: </pre>
502:
503: <p><strong>Setting up a new anoncvs mirror</strong>
504: <br>
1.1 deraadt 505: If you wish to be a new anoncvs mirror site, please contact the anoncvs
506: <a href=mailto:deraadt@theos.com>maintainer</a>.
1.30 beck 507: Anoncvs mirrors require about 500MB of disk, and use up to 4MB of swap
1.1 deraadt 508: per anoncvs user (assuming the user does a large operation; while smaller
509: operations use fewer resources, anoncvs still makes much more of an
510: impact than ftp or sup). Such anoncvs machines should have excellent
511: network connectivity for the area they are expected to serve. A
512: <a href=anoncvs.shar>document</a>
513: which describes the setup of anoncvs servers is available.
514:
1.60 millert 515: <h3><font color=#0000e0>Final notes:</font></h3>
516: After upgrading your source tree, you should read the comments
517: at the top of <KBD>/usr/src/Makefile</KBD> before attemping
518: a build. Also, you should build a new kernel <strong>before</strong>
519: doing a <KBD>make build</KBD> if possible. In some cases it make be
520: necessary to rebuild and install the <KBD>config</KBD> utility before
521: you can build the kernel. If <KBD>config GENERIC</KBD> fails this
522: is probably the case.
523: <p>
524: It is important to note that upgrading from a release to the current tree
525: by rebuilding the sources can be rather difficult due to dependencies
526: that are often not obvious. Therefore, it is suggested that you first
527: install the latest snapshot before attemping a tree build from source.
1.1 deraadt 528:
529: <hr>
1.58 pauls 530: <a href=index.html><img height=24 width=24 src=back.gif border=0 alt=OpenBSD></a>
1.1 deraadt 531: <a href=mailto:www@openbsd.org>www@openbsd.org</a>
1.82 ! millert 532: <br><small>$OpenBSD: anoncvs.html,v 1.81 1999/03/05 16:08:18 beck Exp $</small>
1.1 deraadt 533:
534: </body>
535: </html>