diff options
Diffstat (limited to 'share/FAQ/ctm.FAQ')
-rw-r--r-- | share/FAQ/ctm.FAQ | 162 |
1 files changed, 91 insertions, 71 deletions
diff --git a/share/FAQ/ctm.FAQ b/share/FAQ/ctm.FAQ index 75d8885..45d5929 100644 --- a/share/FAQ/ctm.FAQ +++ b/share/FAQ/ctm.FAQ @@ -1,3 +1,5 @@ +This is the ftp://freefall.cdrom.com/pub/CTM/README file: + # ---------------------------------------------------------------------------- # "THE BEER-WARE LICENSE" (Revision 42): # <phk@login.dknet.dk> wrote this file. As long as you retain this notice you @@ -5,97 +7,126 @@ # this stuff is worth it, you can buy me a beer in return. Poul-Henning Kamp # ---------------------------------------------------------------------------- # -# $Id$ +# Mon Feb 27 00:06:22 PST 1995 # Obtaining FreeBSD-current sources using CTM. ============================================ -CTM is a method to keep a remote directory-tree in sync with a central one. -It has been developed for FreeBSD usage, but other people might use it as -time goes by, but little if any documentations exists on this time on the -process of creating deltas. +CTM is a method for keeping a remote directory tree in sync with a +central one. It has been developed for usage with FreeBSD's source +trees, though other people may find it useful for other purposes as +time goes by. Little, if any, documentation currently exists at this +time on the process of creating deltas so talk to phk@FreeBSD.org for +more information should you wish to use CTM for other things. Why should I use CTM ? ---------------------- -CTM will give you a local copy of the "FreeBSD-current" sources. -If you are an active developer on FreeBSD, but have lousy or non-existent -TCP/IP connectivity, CTM is made for you. -You will need to pick up up to four deltas per day (or you can have them -arrive in email automatically) and sizes are as small as we can do it: -typically less than 5K, one delta in ten is like 10-50K and every now and -then a biggie of 100K+ comes around. +CTM will give you a local copy of the "FreeBSD-current" sources. If +you are an active developer on FreeBSD, but have lousy or non-existent +TCP/IP connectivity, CTM was made for you. You will need to transfer +up to four deltas per day (or you can have them arrive in email +automatically), the sizes for which are always kept as small as +possible. This is typically less than 5K, with the occasional (one in +ten) being 10-50K and every now and then a biggie of 100K+ or more +coming around. + +You will also need to make yourself aware of the various caveats in +running "current" sources, and for this it is recommended that you +refer to the relevant FAQ: /usr/share/FAQ/current-policy.FAQ + +If you have commit priviledges or are similary authorized by the +FreeBSD core team, you can also get access to the CVS repository tree +by the same means. Contact me (phk@FreeBSD.org) for details. + + +NOTE: + +All the "DES infected" (e.g. export controlled) source is not included. +You will get the "international" version only. If sufficient interest +appears, we will set up a "sec-cur" sequence too. -You need to make yourself aware of the caveats of following the "current" -sources, refer to the relevant FAQ for more info on that topic. +There is a sequence of deltas for the ports collection too, but interest +has not been all that high yet. Tell me if you want an email list for +that too and we'll consider setting it up. +What do I need to use CTM? +-------------------------- -What do I need to use CTM ? ---------------------------- -You need two things. The "ctm" program and the stuff to feed it. "ctm" is -in the FreeBSD-current tree from version 2.0.0 and forward. (src/usr.sbin/ctm) +You will need two things: The "ctm" program and the initial deltas to +feed it (to get up to "current" levels). -The "deltas" you feed ctm can be had two ways, ftp or email. +The ctm program is in the FreeBSD-current tree from version 2.0.0 and +forward (/usr/src/usr.sbin/ctm). If you are running an older version +of FreeBSD, you can fetch the current ctm sources directly from: + ftp://ftp.freebsd.org/pub/FreeBSD/FreeBSD-current/src/usr.sbin/ctm/ -FTP-access: ------------ -The CTM-deltas can be found on the following sites: +The "deltas" you feed ctm can be had two ways, ftp or email. If you +have general ftp access to the Internet, then the following ftp sites +support access to CTM: ftp://freefall.cdrom.com/pub/CTM +Ftp the the relevant directory and fetch the README file, starting +from there. -eMail-access: -------------- -Send email to majordomo@freebsd.org, subscribe to the list "ctm-src-cur". -Use the ctm_rmail program to unpack and apply the emails with. You can -actually use the ctm_rmail program directly from a entry in /etc/aliases -if you want. Check the "ctm_rmail" man page. +If you only have access to electronic mail or are otherwise blocked +from using ftp, then you may wish to receive your deltas via email: +Send email to majordomo@freebsd.org to subscribe to the list +"ctm-src-cur" (if you do not know how to subscribe yourself using +majordomo, send a message first containing the word `help' - it will +send you back usage instructions). -How to get started. -------------------- -You need to get up to speed. You have two choices: +When you begin receiving your CTM updates in the mail, you may use the +ctm_rmail program to unpack and apply them with. You can actually use +the ctm_rmail program directly from a entry in /etc/aliases if you +want. Check the "ctm_rmail" man page for more details. -Every now and then I will produce a special additional delta: a delta from -nothing. You can recognize these in two ways, the are large: 25 to 30 -Megabytes gzip'ed, and they have an 'A' appended to the number. -(src-cur.0341A.gz for instance). -The other option is if you have the 2.0-RELEASE already, either from the -internet or from the CDROM, you can pick up the src-cur.0372R20.gz file, -which is a delta from the 2.0R. +Starting off with CTM for the first time: +----------------------------------------- -In both cases will you need all deltas with higher numbers too. +Before you can start using CTM deltas, you will need to get a special +"base" delta that provides a starting point for all deltas produced +subsequently to it. You can recognize these in two ways: One is that +they are large! 25 to 30 Megabytes of gzip'ed data being common for a +base delta. Second, they also have an 'A' appended to the number +(src-cur.0341A.gz for instance). Once you've picked a base delta to +start from, you will also need all deltas with higher numbers +following it. + +Using CTM in your daily life: +----------------------------- -Now working... --------------- To apply the deltas, simply say cd /where/ever/you/want/the/stuff ctm -v -v /where/you/store/your/deltas/src-cur.* -Unless it feels very secure about the entire thing, ctm will not touch -your tree. To check out a delta you can add a "-c", then ctm will never -touch you tree. +Unless it feels very secure about the entire process, ctm will not +touch your tree. To check out a delta you can also use the "-c" flag +and CTM won't actually touch your tree. -There are other options to ctm as well, look in the sources. It's a -little bit confusing right now, but it will become better I hope. +There are other options to ctm as well, look in the sources. It's a +little bit confusing right now, but I promise to fix all of that very +shortly. -I would be very happy if somebody will help with the "user-interface" -part, as I have realized that I can't make up my mind on what options -should do what, how and when... +I would also be very happy if somebody could help with the "user +interface" portions, as I have realized that I can't make up my mind +on what options should do what, how and when... -ctm understands deltas which have been put through gzip, so you don't need -to gunzip them first. +CTM understands deltas which have been put through gzip, so you don't +need to gunzip them first. -That's really all there is to it. Everytime you get a new delta, you +That's really all there is to it. Everytime you get a new delta, you run it through ctm. -Don't remove the deltas, if they are hard to download again. You just might -want to keep them around in case something bad happens. Even if you only have -floppy disks, consider using "fdwrite" to make a copy. +Don't remove the deltas, if they are hard to download again. You just +might want to keep them around in case something bad happens. Even if +you only have floppy disks, consider using "fdwrite" to make a copy. Plans: @@ -105,21 +136,11 @@ Tons of them. Don't forget to tell me what you want though... Misc. stuff: ------------ -If you are a frequent or valuable contributor to FreeBSD, I will be willing -to arrange special services, one option is delivery via ftp or rcp to a -machine closer to you. You need to have earned this, since it takes time -to do, but I'll be all the more happy to do it for you then. - -Only if you have commit priviledge, or are similary authorized, can you get -access to the cvs tree by the same means. Contact phk@FreeBSD.org for that. - -All the "DES-infected" source is not included. You will get the -"international" version only. If sufficient interest appears, we will -setup a "sec-cur" sequence too. - -There is a sequence of deltas for the "ports" too, but the interest has not -been to big yet, tell me if you want an email list for that too. - +If you are a frequent or valuable contributor to FreeBSD, I will be +willing to arrange special services, one option is delivery via ftp or +rcp to a machine closer to you. You need to have earned this, since +it takes time to do, but I'll be all the more happy to do it for you +then. Thanks! ------- @@ -129,7 +150,6 @@ Stephen McKay, wrote ctm_[rs]mail, much appreceiated. Jordan Hubbard, for being so stubborn that I had to make it better. All the users, I hope you like it... - Comments ? ---------- email phk@FreeBSD.org |