=================================================================== RCS file: /cvsrepo/anoncvs/cvs/www/anoncvs.html,v retrieving revision 1.134 retrieving revision 1.135 diff -c -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 **** ! OpenBSD AnonCVS ! --- 1,8 ---- ! OpenBSD AnonCVS ! *************** *** 10,41 **** ! ! [OpenBSD]

!

Anonymous CVS

!

!

!

- -

What is Anonymous CVS?

-

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. --- 10,42 ---- ! ! [OpenBSD]

!

Anonymous CVS

!
! !

Table Of Contents

! ! !
+

What is Anonymous CVS?

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,65 ****

! The OpenBSD Project currently has three main source repositories:

--- 54,70 ----

! The OpenBSD Project currently has five main source repositories:

*************** *** 71,81 **** continuing.

! !

What is CVS?

! 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 --- 76,85 ---- continuing.

!

What is CVS?

! 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,112 **** 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.

--- 105,115 ---- 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.

*************** *** 124,145 **** 
  	# cd /mnt; pax -rw CVS Makefile [a-z]* /usr/src
!
  • Use a union mount (see mount_union(8)) with the CD below a writable directory. (This can be used when only compiling from the tree.) 
      	# 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.

    ! !

    Using CVS(1) to get and update your source tree.

    CVS was designed to be a simple way to retrieve and update your sources, --- 127,147 ---- 

      	# cd /mnt; pax -rw CVS Makefile [a-z]* /usr/src
    !
  • Use a union mount (see mount_union(8)) with the CD below a writable directory. (This can be used when only compiling from the tree.) 
      	# 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.

    !

    Using CVS to get and update your source tree

    CVS was designed to be a simple way to retrieve and update your sources, *************** *** 151,177 ****

    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 to access these servers.

    !

    ! NOTE: - For users wishing to use ssh, you must first set the CVS_RSH variable to ssh.

    --- 153,179 ----

    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 three ways to access these servers.

    !
    !
    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. !

    ! NOTE: For users wishing to use ssh, you must first set the CVS_RSH variable to ssh.

    *************** *** 179,189 **** 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.

    !

    !

    !

    The above will checkout the current source tree. Many of you will --- 181,189 ---- 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 -P src
!

    The above will checkout the current source tree. Many of you will *************** *** 191,208 **** specify a tag along with your command. Example:

    -

    Or OPENBSD_2_7 for 2.7, etc. -

    Currently only the OPENBSD_2_8 tag contains the release sources and errata already applied. ! !

    Available Anonymous CVS Servers.

    There are two levels of source tree access: --- 191,206 ---- specify a tag along with your command. Example:

    + 
    + 	# 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. !

    Available Anonymous CVS Servers

    There are two levels of source tree access: *************** *** 220,263 ****

    Read-only access for everyone:
    Anyone can access the read-only CVS repositories. These copies of the read-write CVS repository are mirrored often. To use one, ! set your CVSROOT environment variable to one of the following values:

    ! Please see the note about using ssh vs. rsh below!

    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,644 **** their "diff"s relative to the CVS tree, which will ease integration. ! !

    Use rsh(1) or ssh(1)?

    Anoncvs: rsh vs. ssh --- 630,636 ---- their "diff"s relative to the CVS tree, which will ease integration. !

    Use rsh(1) or ssh(1)?

    Anoncvs: rsh vs. ssh *************** *** 647,663 **** 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 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 /usr/bin/ssh). If your local site prevents you from connecting out to port 22 (which ssh defaults to using) use port 2022. --- 639,650 ---- 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 ! OpenSSH.

    Once ssh is installed, one sets the environment variable ! 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,701 **** CVS is a little noisy starting up; to quiet it a bit you may want to do this: !

    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 !

    Note that you will also need to use the -d flag as mentioned above. ! !

    Mirroring the CVS repository via sup(1).

    Users wishing to mirror the OpenBSD CVS tree itself may now do so --- 665,688 ---- CVS is a little noisy starting up; to quiet it a bit you may want to do this: ! 

    ! 	% 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
!
    +

    Note that you will also need to use the -d flag as mentioned above. !

    Mirroring the CVS repository via sup(1)

    Users wishing to mirror the OpenBSD CVS tree itself may now do so *************** *** 715,735 **** files ending up in /home/sup. The full OpenBSD cvs tree is currently about 1.3 gigabytes in size. ! !

    Setting up an anoncvs mirror.

    If you wish to be a new anoncvs mirror site, please contact the anoncvs ! 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 which describes the setup of anoncvs servers is available. !

    Final notes:

    After upgrading your source tree, you should read the comments at the top of /usr/src/Makefile before attemping a build. Also, you should build a new kernel before --- 702,721 ---- files ending up in /home/sup. The full OpenBSD cvs tree is currently about 1.3 gigabytes in size. !

    Setting up an anoncvs mirror

    If you wish to be a new anoncvs mirror site, please contact the anoncvs ! 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 which describes the setup of anoncvs servers is available. !

    Final notes

    After upgrading your source tree, you should read the comments at the top of /usr/src/Makefile before attemping a build. Also, you should build a new kernel before *************** *** 744,752 **** install the latest snapshot before attemping a tree build from source.
    ! OpenBSD ! www@openbsd.org !
    $OpenBSD: anoncvs.html,v 1.134 2001/02/21 15:30:46 millert Exp $ --- 730,738 ---- install the latest snapshot before attemping a tree build from source.
    ! OpenBSD ! www@openbsd.org !
    $OpenBSD: anoncvs.html,v 1.135 2001/02/22 15:53:14 naddy Exp $