=================================================================== RCS file: /cvsrepo/anoncvs/cvs/www/anoncvs.html,v retrieving revision 1.134 retrieving revision 1.135 diff -u -r1.134 -r1.135 --- www/anoncvs.html 2001/02/21 15:30:46 1.134 +++ www/anoncvs.html 2001/02/22 15:53:14 1.135 @@ -1,8 +1,8 @@ - +
-
-
Anonymous CVS is a method of keeping your local copy of the OpenBSD source tree up to date with respect to changes made to current OpenBSD sources. @@ -53,13 +54,17 @@
-The OpenBSD Project currently has three main source repositories: +The OpenBSD Project currently has five main source repositories:
@@ -71,11 +76,10 @@ continuing.
- -- + CVS is the source code control system used to manage the OpenBSD source tree. It implements a central repository for all officially released source code and changes, while permitting developers to maintain local copies of the @@ -101,12 +105,11 @@ to update any other source modules you requested.
- -The latest version of CVS is available at -Cyclic. +Cyclic. Versions earlier than 1.6 are not recommended, and may not work. If you already have OpenBSD installed, CVS is included.
@@ -124,22 +127,21 @@# cd /mnt; pax -rw CVS Makefile [a-z]* /usr/src-
# mount -t union -o -b /mnt /usr/src
-For people who don't have a CD on hand, you can use cvs(1) to "checkout" the source repository for you. This is discussed in the next section. +For people who don't have a CD on hand, you can use cvs(1) to "checkout" the source repository for you. This is discussed in the next section.
-After this, /usr/src will be a nice checkout area where all cvs(1) commands will work OK. +After this, /usr/src will be a nice checkout area where all cvs(1) commands will work OK.
- -CVS was designed to be a simple way to retrieve and update your sources, @@ -151,27 +153,27 @@
Once you have decided which tree to follow, you much choose which Anonymous CVS server you are going to use. A list of these servers is -below. Do, however, notice that there are 3 ways +below. Do, however, notice that there are three ways to access these servers.
--NOTE: - For users wishing to use ssh, you must first set the CVS_RSH variable to ssh. +NOTE: For users wishing to use ssh, you must first set the CVS_RSH variable to ssh.
- $ export CVS_RSH="/usr/bin/ssh" + $ export CVS_RSH=/usr/bin/ssh-
- $ setenv CVS_RSH /usr/bin/ssh + % setenv CVS_RSH /usr/bin/ssh
-
-# cd /usr; cvs checkout -P src -- +
+ # cd /usr; cvs checkout -P src +
The above will checkout the current source tree. Many of you will @@ -191,18 +191,16 @@ specify a tag along with your command. Example:
++ # cd /usr; cvs checkout -P -rOPENBSD_2_8 src +
-
-# cd /usr; cvs checkout -P -rOPENBSD_2_8 src -Or OPENBSD_2_7 for 2.7, etc. -
Currently only the OPENBSD_2_8 tag contains the release sources and errata already applied. - -
There are two levels of source tree access: @@ -220,44 +218,43 @@
-Please see the note about using ssh vs. rsh below! +Please see the note about using ssh vs. rsh below!
@@ -271,41 +268,41 @@
@@ -318,14 +315,14 @@
@@ -341,20 +338,20 @@
located in Moscow, Russia
maintained by John Chertihin
protocols: rsh, ssh
-updated every 24 hours (at 1 AM Moscow time)
+updated every 24 hours (at 1 AM Moscow time).
-Note:, If your server is listed on here with inaccurate or +Note: If your server is listed on here with inaccurate or unknown information, please contact -beck@openbsd.org +beck@openbsd.org
You may want to use -traceroute(8) +traceroute(8) to find out which server is nearest you. Problems with a server should be reported to the maintainer of the server in question. -
+ - -IMPORTANT NOTE: @@ -436,10 +432,10 @@
@@ -462,39 +458,37 @@ on to find out how you can help.
-A sample use of an anoncvs CVS server would be: -
+A sample use of an anoncvs server would be: +% setenv CVSROOT anoncvs@anoncvs.ca.openbsd.org:/cvs % cd /tmp % cvs get src/sys/arch/sparc [copies the files from the repository to your machine] % cvs log src/sys/arch/sparc/sparc/locore.s - [shows the commit log for the chosen file ] + [shows the commit log for the chosen file] % cvs diff -bc -r1.1 -r1.5 src/sys/arch/sparc/sparc/locore.s [shows the changes between revisions 1.1 and rev 1.5] -
-In order to use a cvs ``pserver'' (a direct tcp connection instead of using ssh or rsh) you must login once: +In order to use a cvs ``pserver'' (a direct TCP connection instead of using ssh or rsh) you must login once: -
- [ *NOTE* You must be using cvs version 1.8 or higher to do this ] +% setenv CVSROOT :pserver:anoncvs@anoncvs.ca.openbsd.org:/cvs % cvs login (Logging in to anoncvs@anoncvs1.ca.openbsd.org) CVS password: anoncvs - [this writes a line to ~/.cvspass (filename over-ridden by CVS_PASSFILE).] + [This writes a line to ~/.cvspass (filename over-ridden by CVS_PASSFILE).] [An example line from my ~/.cvspass after typing 'blah' for the above ] [password is: ] [:pserver:anoncvs@anoncvs5.usa.openbsd.org:/cvs Au'yc ] - [...after logging in ONCE every other use of the above CVSROOT will work ] + [After logging in ONCE every other use of the above CVSROOT will work. ] % cvs get ksrc-i386 ksrc-common - [allows you to retrieve ONLY that necessary to rebuild an i386 kernel ] -+ [Allows you to retrieve ONLY that necessary to rebuild an i386 kernel. ] +
Here is how someone using anoncvs regularly would update his @@ -502,32 +496,32 @@
(If you are following current): -
-# setenv CVSROOT anoncvs@anoncvs.ca.openbsd.org:/cvs -# cd /usr -# cvs -q get -PA src -
+ # setenv CVSROOT anoncvs@anoncvs.ca.openbsd.org:/cvs + # cd /usr + # cvs -q get -PA src +
(If you are following the patch branch for 2.8): -
-# setenv CVSROOT anoncvs@anoncvs.ca.openbsd.org:/cvs -# cd /usr -# cvs -q get -rOPENBSD_2_8 -P src -+
+ # setenv CVSROOT anoncvs@anoncvs.ca.openbsd.org:/cvs + # cd /usr + # cvs -q get -rOPENBSD_2_8 -P src +
(If you are following current): -
-# cd /usr/src -# cvs -q up -PAd -+
+ # cd /usr/src + # cvs -q up -PAd +
(If you are following the patch branch for 2.8): -
-# cd /usr/src -# cvs -q up -rOPENBSD_2_8 -Pd -+
+ # cd /usr/src + # cvs -q up -rOPENBSD_2_8 -Pd +Everytime you ran this it would synchronize your /usr/src tree. It would not destroy any of your local changes, rather it would attempt to merge @@ -545,37 +539,36 @@ flag to cvs, or you may find yourself tracking current instead.
(If you are following current): -
-# cd /usr/src -# cvs -d $CVSROOT -q up -PAd -+
+ # cd /usr/src + # cvs -d $CVSROOT -q up -PAd +
(If you are following a patch branch): -
-# cd /usr/src -# cvs -d $CVSROOT -q up -Pd -+
+ # cd /usr/src + # cvs -d $CVSROOT -q up -Pd +
-To use ports, it is similar to src: +To use ports, it is similar to src:
-# setenv CVSROOT anoncvs@anoncvs.ca.openbsd.org:/cvs -# cd /usr -# cvs -q get -PA ports + # setenv CVSROOT anoncvs@anoncvs.ca.openbsd.org:/cvs + # cd /usr + # cvs -q get -PA ports
-# cd /usr -# cvs -q up -PAd ports + # cd /usr + # cvs -q up -PAd ports
or to make a diff of a locally patched module (here cd.c) to include with a bug report: -
-# cd /usr -# cvs diff -u src/sys/scsi/cd.c > /tmp/patch -- +
+ # cd /usr + # cvs diff -u src/sys/scsi/cd.c > /tmp/patch +
-The CVS(1) man page +The cvs(1) man page (included with the CVS sources) has much more information about how CVS can be used. +
-X11 Source tree
-
Anoncvs mirrors also carry the OpenBSD X11 source tree. You can adapt
the recipe above to update your X11 source tree from the second CD.
Either copy or use a union mount to get the X11 sources in /usr/X11:
@@ -610,16 +602,17 @@
# mount -t union -o -b /mnt/X11 /usr/X11 -+ + After this, /usr/X11 will be ready to be used by cvs. You can for example update it to -current source (assuming you've already set the CVSROOT environment variable): -
+# cd /usr/X11 # cvs -q update -PAd -+
Warning: @@ -637,8 +630,7 @@ their "diff"s relative to the CVS tree, which will ease integration. - -
Anoncvs: rsh vs. ssh @@ -647,17 +639,12 @@ of the CVS sites no longer support rsh for security reasons or a local problem like a firewall or imperfect protocol emulator such as slirp may prevent you from using rsh. -The alternative is a to use a "secure shell" connection using either -OpenSSH (*FREE*) or -ssh (non-commercial and commercial). +The alternative is a to use a "secure shell" connection using +OpenSSH.
-The OpenBSD anoncvs repositries support the SSH1 protocol, not the SSH2 -protocol due to the use of a "strict non-commercial use licensing policy". - -
Once ssh is installed, one sets the environment variable -CVS_RSH to point to ssh (typically +CVS_RSH to point to ssh (typically /usr/bin/ssh). If your local site prevents you from connecting out to port 22 (which ssh defaults to using) use port 2022. @@ -678,24 +665,24 @@ CVS is a little noisy starting up; to quiet it a bit you may want to do this: -
-setenv CVS_CLIENT_PORT -1 -+
+ % setenv CVS_CLIENT_PORT -1 +
If you wish to change from one CVS server to another (say your normal one is down, or for any other reason), the environment variable which will let you do this is -
-setenv CVS_IGNORE_REMOTE_ROOT -+
+ % setenv CVS_IGNORE_REMOTE_ROOT ++
Note that you will also need to use the -d flag as mentioned above. - -
Users wishing to mirror the OpenBSD CVS tree itself may now do so @@ -715,21 +702,20 @@ files ending up in /home/sup. The full OpenBSD cvs tree is currently about 1.3 gigabytes in size. - -
If you wish to be a new anoncvs mirror site, please contact the anoncvs -maintainer. +maintainer. Anoncvs mirrors require about 1.2GB of disk, and use up to 32MB of swap per anoncvs user (assuming the user does a large operation; while smaller operations use fewer resources, anoncvs still makes much more of an impact than ftp or sup). Such anoncvs machines should have excellent network connectivity for the area they are expected to serve. A -document +document which describes the setup of anoncvs servers is available. -