===================================================================
RCS file: /cvsrepo/anoncvs/cvs/www/Attic/ctm.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -c -r1.18 -r1.19
*** www/Attic/ctm.html	2001/10/16 19:02:21	1.18
--- www/Attic/ctm.html	2001/11/02 21:17:19	1.19
***************
*** 9,27 ****
  <img alt="CTM for OpenBSD" src="images/bsdctm.gif" width="401" height="126">
  </center>
  
! <H3>What is CTM?</H3>
  
  <P>
  CTM is a system which was designed by Poul-Henning Kamp for making 
! changes to a source tree available on a daily basis by email.
  This is a good way to stay up to date with the current source tree or
  CVS repository if you have a slow Internet connection, for instance via modem.
  
  <P>
  CTM uses very low bandwidth for distributing the changes to the tree,
  and compresses them using <tt><b>gzip -9</b></tt>.  In contrast to
  <a href="cvsup.html">CVSup</a>, CTM is written in plain C language
  and therefore available for every platform supported by OpenBSD.
  
  <p>
  For <b>any</b> problems, suggestions, reports and questions regarding CTM,
--- 9,31 ----
  <img alt="CTM for OpenBSD" src="images/bsdctm.gif" width="401" height="126">
  </center>
  
! <H3><font color="#0000e0">What is CTM?</font></H3>
  
  <P>
  CTM is a system which was designed by Poul-Henning Kamp for making 
! changes to a source tree available on a regular basis by email.
  This is a good way to stay up to date with the current source tree or
  CVS repository if you have a slow Internet connection, for instance via modem.
  
  <P>
+ OpenBSD CTM distributes all modules of the OpenBSD CVS repository
+ plus checked out versions of several of theses modules.
  CTM uses very low bandwidth for distributing the changes to the tree,
  and compresses them using <tt><b>gzip -9</b></tt>.  In contrast to
  <a href="cvsup.html">CVSup</a>, CTM is written in plain C language
  and therefore available for every platform supported by OpenBSD.
+ CTM implements a so called push system, while all other methods to
+ get access to the OpenBSD CVS repository are pull systems.
  
  <p>
  For <b>any</b> problems, suggestions, reports and questions regarding CTM,
***************
*** 30,40 ****
  <small>(Please do not ask other OpenBSD people for CTM support,
  as they are busy doing other things.  Thank you.)</small>
  
! <H3>How does it work?</H3>
  
  <P>
  The basic idea of CTM is that you subscribe to a special mailing list
! for a particular source tree. Each day you receive an email message
  containing all the changes to that tree during that period.
  One such set of differences is called a <b>delta</b>.
  Actually, the CTM server makes new deltas every twelve hours.
--- 34,44 ----
  <small>(Please do not ask other OpenBSD people for CTM support,
  as they are busy doing other things.  Thank you.)</small>
  
! <H3><font color="#0000e0">How does it work?</font></H3>
  
  <P>
  The basic idea of CTM is that you subscribe to a special mailing list
! for a particular CVS module or source tree. Each day you receive email messages
  containing all the changes to that tree during that period.
  One such set of differences is called a <b>delta</b>.
  Actually, the CTM server makes new deltas every twelve hours.
***************
*** 53,59 ****
  <P>
  There are currently two kinds of base set files.  For quite a while we
  were making <tt><b>tar.gz</b></tt> files manually, but we are
! switching back to real CTM base deltas.  The latter contain 
  <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=md5&sektion=1">md5(1)</a>
  checksums and are generated automatically, thus are a bit safer.  You
  can distinguish these two kinds of base sets by their filename.  An
--- 57,63 ----
  <P>
  There are currently two kinds of base set files.  For quite a while we
  were making <tt><b>tar.gz</b></tt> files manually, but we are
! back to real CTM base deltas.  The latter contain 
  <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=md5&sektion=1">md5(1)</a>
  checksums and are generated automatically, thus are a bit safer.  You
  can distinguish these two kinds of base sets by their filename.  An
***************
*** 62,80 ****
  would be named <tt><b>OpenBSD-cvs.1500A.gz</b></tt>.  See below for
  detailed instructions.
  
! <H3>How much bandwidth does CTM use?</H3>
  
  <P>
  You obtain the base set and all relative deltas up to the recent one
  via ftp from the sites listed below.  Sizes are:
  
  <ul>
! <li>Approximately 115MB for OpenBSD-cvs.
! <li>Approximately 37MB for OpenBSD-cvs-x11.
! <li>Approximately 56MB for OpenBSD-cvs-xf4.
! <li>Approximately 65MB for OpenBSD-src.
! <li>Approximately 35MB for OpenBSD-src-x11.
! <li>Approximately 2MB for OpenBSD-ports.
  <br>Keep in mind that these are compressed sizes.  The uncompressed
      files are about five times as large.
  <li>Relative deltas vary from 10kB to 500kB, and occasionally a couple of
--- 66,84 ----
  would be named <tt><b>OpenBSD-cvs.1500A.gz</b></tt>.  See below for
  detailed instructions.
  
! <H3><font color="#0000e0">How much bandwidth does CTM use?</font></H3>
  
  <P>
  You obtain the base set and all relative deltas up to the recent one
  via ftp from the sites listed below.  Sizes are:
  
  <ul>
! <li>Approximately 215MB for OpenBSD-cvs.
! <li>Approximately 40MB for OpenBSD-cvs-x11.
! <li>Approximately 65MB for OpenBSD-cvs-xf4.
! <li>Approximately 83MB for OpenBSD-src.
! <li>Approximately 36MB for OpenBSD-src-x11.
! <li>Approximately 4MB for OpenBSD-ports.
  <br>Keep in mind that these are compressed sizes.  The uncompressed
      files are about five times as large.
  <li>Relative deltas vary from 10kB to 500kB, and occasionally a couple of
***************
*** 84,94 ****
  <li>If a delta is larger than 5MB, it is not sent via mail.  Instead,
      you will receive a notification to get the delta by ftp.  Larger
      CTM updates are rare, though, usually occurring only after a major
!     import of something like binutils, perl, gcc, etc, or applying a
!     CVS tag to the CVS repository.
  </ul>
  
! <H3>How do I use CTM?</H3>
  
  <UL>
  <LI>Subscribe to the CTM mailing list for the source set you want.
--- 88,98 ----
  <li>If a delta is larger than 5MB, it is not sent via mail.  Instead,
      you will receive a notification to get the delta by ftp.  Larger
      CTM updates are rare, though, usually occurring only after a major
!     import of something like binutils, Perl, gcc, XFree86, etc., or applying a
!     tag to the CVS repository.
  </ul>
  
! <H3><font color="#0000e0">How do I use CTM?</font></H3>
  
  <UL>
  <LI>Subscribe to the CTM mailing list for the source set you want.
***************
*** 100,106 ****
     <p>
     The following commands will subscribe you to the appropriate lists:
  <p>
! For the CVS repository (without the X11 and XF4 modules):
  <pre>
  	echo subscribe OpenBSD-cvs | mail majordomo@OpenBSD.org
  </pre>
--- 104,111 ----
     <p>
     The following commands will subscribe you to the appropriate lists:
  <p>
! For the CVS repository (CVSROOT, ports, src and www modules,
! but not X11 and XF4):
  <pre>
  	echo subscribe OpenBSD-cvs | mail majordomo@OpenBSD.org
  </pre>
***************
*** 108,122 ****
  <pre>
  	echo subscribe OpenBSD-cvs-x11 | mail majordomo@OpenBSD.org
  </pre>
! For the source tree (without the X11 and XF4 modules):
  <pre>
  	echo subscribe OpenBSD-src | mail majordomo@OpenBSD.org
  </pre>
! For the X11 module of the source tree:
  <pre>
  	echo subscribe OpenBSD-src-x11 | mail majordomo@OpenBSD.org
  </pre>
! For the ports tree:
  <pre>
  	echo subscribe OpenBSD-ports-ctm | mail majordomo@OpenBSD.org
  </pre>
--- 113,131 ----
  <pre>
  	echo subscribe OpenBSD-cvs-x11 | mail majordomo@OpenBSD.org
  </pre>
! For the XF4 module of the CVS repository:
  <pre>
+ 	echo subscribe OpenBSD-cvs-xf4 | mail majordomo@OpenBSD.org
+ </pre>
+ For a checked out copy of the src module:
+ <pre>
  	echo subscribe OpenBSD-src | mail majordomo@OpenBSD.org
  </pre>
! For a checked out copy of the X11 module:
  <pre>
  	echo subscribe OpenBSD-src-x11 | mail majordomo@OpenBSD.org
  </pre>
! For a checked out copy of the ports module:
  <pre>
  	echo subscribe OpenBSD-ports-ctm | mail majordomo@OpenBSD.org
  </pre>
***************
*** 125,133 ****
  	echo subscribe ctm-log | mail majordomo@OpenBSD.org
  </pre>
  
- There is no mailing list for the XF4 module, yet.  It is available
- via FTP only.
- 
  <p>
  <li>Install the CTM program from a package or from the ports
  collection.  You'll find the port at
--- 134,139 ----
***************
*** 154,162 ****
  or
  
  <pre>
! 	cat split/OpenBSD-cvs.1500.tar.gz.* &gt; OpenBSD-cvs.1500.tar.gz
  	cd target
! 	tar -xzvf .../OpenBSD-cvs.1500.tar.gz
  </pre>
  
  <p>
--- 160,168 ----
  or
  
  <pre>
! 	cat split/OpenBSD-cvs.1450.tar.gz.* &gt; OpenBSD-cvs.1450.tar.gz
  	cd target
! 	tar -xzvf .../OpenBSD-cvs.1450.tar.gz
  </pre>
  
  <p>
***************
*** 171,177 ****
  
  <p>
  <li>You now need to get the deltas which have been generated since the
! base set.  Go to the FTP site in the subdirectory
  <tt><b>OpenBSD-cvs</b></tt> and download every file whose number is
  <em>larger</em> than the number of the base set you used. Then apply
  these deltas:
--- 177,183 ----
  
  <p>
  <li>You now need to get the deltas which have been generated since the
! base set.  Go to one of the FTP sites listed below into the subdirectory
  <tt><b>OpenBSD-cvs</b></tt> and download every file whose number is
  <em>larger</em> than the number of the base set you used. Then apply
  these deltas:
***************
*** 207,218 ****
  
  <p>
  Repeat this last step every time you receive a delta from the
! mailing list.  If you like, you can automate this step using procmail
! or any similar program.
  </ul>
  
  <p>
! The addresses of the FTP servers carrying CTM deltas are:
  
  <ul>
  <li>The primary FTP server can be reached at:
--- 213,225 ----
  
  <p>
  Repeat this last step every time you receive a delta from the
! mailing list.  If you like, you can automate this step using procmail,
! maildrop, or any similar program from the
! <a href="ports.html">ports collection</a>.
  </ul>
  
  <p>
! Here is the list of FTP servers carrying CTM deltas:
  
  <ul>
  <li>The primary FTP server can be reached at:
***************
*** 234,240 ****
  <p>
  This server is updated by CTM deltas received from the mailing lists.  It
  additionally has the split base deltas in the <tt><b>base</b></tt>
! subdirectory.
  </ul>
  
  <ul>
--- 241,250 ----
  <p>
  This server is updated by CTM deltas received from the mailing lists.  It
  additionally has the split base deltas in the <tt><b>base</b></tt>
! subdirectory, mirrored from
! <a href="ftp://openbsd.rug.ac.be:/pub/OpenBSD-ctm/">
!      ftp://openbsd.rug.ac.be:/pub/OpenBSD-ctm/
! </a>.
  </ul>
  
  <ul>
***************
*** 261,285 ****
        mirror these deltas.
  <p>
  
! <h3>Should I choose the source tree or the CVS repository?</h3>
  
  <P>
  This depends on your diskspace, among other factors.  Since CTM
  doesn't deal very well with files which have been modified locally,
! the "better" choice is probably the <a href="anoncvs.html">CVS</a>
  repository.  You can check out your working copy of the source tree
! from your CVS repository then, and keep your local modifications in
  your source tree.  CVS is smart enough to merge in your local changes.
! You can also use the full range of CVS commands except <tt><b>cvs
! commit</b></tt>.
  
  <p>
  The drawback, however, is the amount of diskspace it takes.  A
! checked-out source tree takes about 350MB or so, but if you have your
  own CVS repository you need more than 1Gb for it, <b>plus</b> another
! 350MB for the checked out tree.
  This doesn't count the 100MB or more (depending on the architecture)
! you will need to do a build, i.e. compile the sources.
  
  <p>
  If you just get the source tree, you will need to deal with local
--- 271,296 ----
        mirror these deltas.
  <p>
  
! <h3><font color="#0000e0">Should I choose the source tree or the CVS repository?</font></h3>
  
  <P>
  This depends on your diskspace, among other factors.  Since CTM
  doesn't deal very well with files which have been modified locally,
! the better choice is surely the <a href="anoncvs.html">CVS</a>
  repository.  You can check out your working copy of the source tree
! from your CVS repository then, can track a stable branch,
! and keep your local modifications in
  your source tree.  CVS is smart enough to merge in your local changes.
! You can also use the full range of CVS commands except commands like
! <tt><b>cvs commit</b></tt> and <tt><b>cvs tag</b></tt>.
  
  <p>
  The drawback, however, is the amount of diskspace it takes.  A
! checked-out source tree takes about 370MB or so, but if you have your
  own CVS repository you need more than 1Gb for it, <b>plus</b> another
! 370MB for the checked out tree.
  This doesn't count the 100MB or more (depending on the architecture)
! you will need for generated files during a build, i.e. compiling the sources.
  
  <p>
  If you just get the source tree, you will need to deal with local
***************
*** 319,326 ****
  
  <p>
  The commands <tt><b>ls -W</b></tt> and <tt><b>rm -W</b></tt> will be
! useful too, as objects named "whiteouts" in <tt><b>/usr/src</b></tt> will also hide
! files in <tt><b>src-ctm</b></tt>.
  
  <p>
  If you get the CVS repository, you can use the <tt><b>cvs checkout</b></tt>
--- 330,337 ----
  
  <p>
  The commands <tt><b>ls -W</b></tt> and <tt><b>rm -W</b></tt> will be
! useful too, as objects named "whiteouts" in <tt><b>/usr/src</b></tt>
! will also hide files in <tt><b>src-ctm</b></tt>.
  
  <p>
  If you get the CVS repository, you can use the <tt><b>cvs checkout</b></tt>
***************
*** 332,338 ****
  To get an initial src repository:
  <pre>
  	cd /usr
! 	cvs -qd YOUR_CVS_REPOSITORY checkout -A src
  </pre>
  <p>
  and after each CTM update:
--- 343,349 ----
  To get an initial src repository:
  <pre>
  	cd /usr
! 	cvs -qd YOUR_CVS_REPOSITORY checkout -PA src
  </pre>
  <p>
  and after each CTM update:
***************
*** 341,352 ****
  	cvs -q update -PAd
  </pre>
  
! <H3>How stable is CTM for OpenBSD?</H3>
  
! CTM has been in use for over four years for OpenBSD, and for FreeBSD
  for an even longer period of time.  CTM is very reliable and stable.
  
! <h3>What does the future hold for CTM?</h3>
  
  There are numerous (small) changes and optimizations possible.
  Among them:
--- 352,363 ----
  	cvs -q update -PAd
  </pre>
  
! <H3><font color="#0000e0">How stable is CTM for OpenBSD?</font></H3>
  
! CTM has been in use for over five years for OpenBSD, and for FreeBSD
  for an even longer period of time.  CTM is very reliable and stable.
  
! <h3><font color="#0000e0">What does the future hold for CTM?</font></h3>
  
  There are numerous (small) changes and optimizations possible.
  Among them:
***************
*** 366,373 ****
       new features, like signing CTM deltas with PGP.
  </ul>
  
! <H3>More information</H3>
  
  If you want to learn more about CTM, a good place to start with is the
  FreeBSD Handbook:
  
--- 377,386 ----
       new features, like signing CTM deltas with PGP.
  </ul>
  
! Mail <a href="mailto:hgw@d1906.inka.de">me</a> your opinions and wishes!
  
+ <H3><font color="#0000e0">More information</font></H3>
+ 
  If you want to learn more about CTM, a good place to start with is the
  FreeBSD Handbook:
  
***************
*** 379,394 ****
  
  There are also man pages for all of the CTM utilities.
  
! <h3>Summary:</h3>
  
  <p>
- 
  <ul>
  <li> Mailing lists:
  
     <ul>
     <li><tt>echo subscribe OpenBSD-cvs | mail majordomo@OpenBSD.org</tt>
     <li><tt>echo subscribe OpenBSD-cvs-x11 | mail majordomo@OpenBSD.org</tt>
     <li><tt>echo subscribe OpenBSD-src | mail majordomo@OpenBSD.org</tt>
     <li><tt>echo subscribe OpenBSD-src-x11 | mail majordomo@OpenBSD.org</tt>
     <li><tt>echo subscribe OpenBSD-ports-ctm | mail majordomo@OpenBSD.org</tt>
--- 392,407 ----
  
  There are also man pages for all of the CTM utilities.
  
! <h3><font color="#0000e0">Summary:</font></h3>
  
  <p>
  <ul>
  <li> Mailing lists:
  
     <ul>
     <li><tt>echo subscribe OpenBSD-cvs | mail majordomo@OpenBSD.org</tt>
     <li><tt>echo subscribe OpenBSD-cvs-x11 | mail majordomo@OpenBSD.org</tt>
+    <li><tt>echo subscribe OpenBSD-cvs-xf4 | mail majordomo@OpenBSD.org</tt>
     <li><tt>echo subscribe OpenBSD-src | mail majordomo@OpenBSD.org</tt>
     <li><tt>echo subscribe OpenBSD-src-x11 | mail majordomo@OpenBSD.org</tt>
     <li><tt>echo subscribe OpenBSD-ports-ctm | mail majordomo@OpenBSD.org</tt>
***************
*** 410,424 ****
  </ul>
  
  <p>
! Important notes and announcements about CTM will be posted to:
! <ul>
! <li> announce@OpenBSD.org
! <li> misc@OpenBSD.org
! </ul>
  
  <p>
  
! <H3>Acknowledgements</H3>
  
  <ul>
  <li> Poul-Henning Kamp (phk@FreeBSD.org) for making CTM possible and helping
--- 423,434 ----
  </ul>
  
  <p>
! Important notes and announcements about CTM will be posted to the
! announce@OpenBSD.org mailing list.
  
  <p>
  
! <H3><font color="#0000e0">Acknowledgements</font></H3>
  
  <ul>
  <li> Poul-Henning Kamp (phk@FreeBSD.org) for making CTM possible and helping
***************
*** 454,460 ****
  <a href="index.html"><img height="24" width="24" src="back.gif" border="0" alt="OpenBSD" /></a>
  <a href="mailto:www@openbsd.org">www@openbsd.org</a>
  <br>
! <small>$OpenBSD: ctm.html,v 1.18 2001/10/16 19:02:21 jufi Exp $</small>
  
  </body>
  </html>
--- 464,470 ----
  <a href="index.html"><img height="24" width="24" src="back.gif" border="0" alt="OpenBSD" /></a>
  <a href="mailto:www@openbsd.org">www@openbsd.org</a>
  <br>
! <small>$OpenBSD: ctm.html,v 1.19 2001/11/02 21:17:19 naddy Exp $</small>
  
  </body>
  </html>