CVS:
++To summarize, the real strength of using Anonymous CVS is that it is +a "tolerant" source code control system - it respects +changes that you have made to your local sources and makes +"best efforts" to update your entire source tree, rather than +leaving you a list of arcane problems that have to be resolved before +continuing. +
+ +What is CVS?
+CVS is the source code control system used to manage the OpenBSD source tree. @@ -71,7 +94,17 @@ to update any other source modules you requested.
+ +Getting Started Using Anonymous CVS.
++The latest version of CVS is available at +Cyclic. +Versions earlier than 1.6 are not recommended, and may not work. +If you already have OpenBSD installed, CVS is included. +
+ +People who own an OpenBSD CD may have seen the CVS/ dirs on it. Actually there is a reason, the CD has a checkout of the OpenBSD src module usable to continue updating from. Using this tree will result in a much @@ -89,49 +122,70 @@ # 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. +
+ +After this, /usr/src will be a nice checkout area where all cvs(1) commands will work OK. +
- -CVS COMMAND SUMMARY
--
-
- add -
- Add a new file or directory to the repository. -
- get -
- Make a working directory of source files for editing. -
- commit -
- Apply changes to the source repository (write access) -
- diff -
- Show differences between local files and the source repository. -
- history -
- Show reports on cvs commands against the source repository. -
- log -
- Display CVS log information. -
- rdiff -
- Prepare a collection of diffs reflecting changes between release. -
- status -
- Show current status of files in the repository and local copies. -
- update -
- Bring your working directory up to date with the repository. -
Using CVS(1) to get and update your source tree.
-To summarize, the real strength of using Anonymous CVS is that it is -a "tolerant" source code control system - it respects -changes that you have made to your local sources and makes -"best efforts" to update your entire source tree, rather than -leaving you a list of arcane problems that have to be resolved before -continuing. +CVS was designed to be a simple way to retrive and update your sources, therefore there +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 below. +Do, however, notice that there are only 3 ways to access these servers. +
-Using Anonymous CVS:
+-
+
- ssh - Secure Shell can be used to access the anonymous CVS servers. This is the recommended way of doing so, as it is encrypted. As of 2.6 OpenBSD has included OpenSSH in its standard distribution. +
- rsh - Remote Shell can be used on some of the servers for users who don't have access to ssh +
- pserver - pserver is primarily useful for users who are behind firewalls that block the other two connections. +
-The latest version of CVS is available at -Cyclic. -Versions earlier than 1.6 are not recommended, and may not work. -If you already have OpenBSD installed, CVS is included. +NOTE: - For users wishing to use ssh, you must first set the CVS_RSH variable to ssh. +
-
+
- For Korn/Bourne shells.
+
+ $ export CVS_RSH="/usr/bin/ssh" +
+ - For CSH based shells.
+
+ $ setenv CVS_RSH /usr/bin/ssh +
+
+Once you have chosen which Anonymous CVS Server 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 above 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 /usr/src. +
+ ++
+# cd /usr; cvs checkout src ++ + +
+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: +
+ ++
+# cd /usr; cvs checkout -rOPENBSD_2_6 src ++Or OPENBSD_2_5 for 2.5, etc. + + + + +
Available Anonymous CVS Servers.
+ +There are two levels of source tree access:
-
@@ -555,7 +609,7 @@
www@openbsd.org
-$OpenBSD: anoncvs.html,v 1.99 2000/01/26 22:48:30 ericj Exp $ +
$OpenBSD: anoncvs.html,v 1.100 2000/01/26 23:47:44 ericj Exp $