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