Many stylistic and grammar changes.
This commit is contained in:
jkh
parent
5fc253290d
commit
e40a3fdf4d
@ -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 need to make yourself aware of the caveats of following the "current"
|
||||
sources, refer to the relevant FAQ for more info on that topic.
|
||||
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.
|
||||
|
||||
|
||||
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)
|
||||
NOTE:
|
||||
|
||||
The "deltas" you feed ctm can be had two ways, ftp or email.
|
||||
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.
|
||||
|
||||
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.
|
||||
|
||||
FTP-access:
|
||||
-----------
|
||||
The CTM-deltas can be found on the following sites:
|
||||
What do I need to use CTM?
|
||||
--------------------------
|
||||
|
||||
You will need two things: The "ctm" program and the initial deltas to
|
||||
feed it (to get up to "current" levels).
|
||||
|
||||
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/
|
||||
|
||||
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).
|
||||
|
||||
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.
|
||||
|
||||
|
||||
How to get started.
|
||||
-------------------
|
||||
You need to get up to speed. You have two choices:
|
||||
Starting off with CTM for the first time:
|
||||
-----------------------------------------
|
||||
|
||||
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).
|
||||
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.
|
||||
|
||||
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.
|
||||
Using CTM in your daily life:
|
||||
-----------------------------
|
||||
|
||||
In both cases will you need all deltas with higher numbers too.
|
||||
|
||||
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
|
||||
|
||||
Loading…
Reference in New Issue
Block a user