Date: Tue, 16 Jan 1996 21:45:11 -0600 From: Richard Wackerbarth <rkw@dataplex.net> To: hackers@freebsd.org Cc: jkh@time.cdrom.com, phk@freebsd.org, joerg@freebsd.org, jmb@freebsd.org Subject: Requesting comments on document describing -stable by CTM Message-ID: <v02140a00ad221ce2a318@[199.183.109.242]>
next in thread | raw e-mail | index | archive | help
--============_-1390272185==_============
Content-Type: text/plain; charset="us-ascii"
Since I received my 2.1-RELEASE CD at the end of December, I have been
generating CTM updates to support the 2.1 tree (aka -stable) in the same
manner that -current and -cvs are supported. I have a couple of testers who
are using the service successfully. I think that it is now time to go
public.
It is my contention that CTM is a resource effective method of
distribution. It can be used in either a "push" mode where the user
receives the updates automatically (Think of the advertising value
associated with automatic distribution of bug fixes) or it can be used in
"pull" mode whereby an occasional user can retrieve the changes on his own
schedule. The distribution is more efficient than SUP because there are far
fewer files involved.
In any case, I am arranging for the files to appear on the FTP sites so
that anyone interested in the 2.1 tree may use the service.
The attached page is intended to accompany those ctm update files placed on
the FTP sites and/or an announcement that the service is available.
Please make suggestions for changes or additions.
--============_-1390272185==_============
Content-Type: text/plain; name="CTM_README"; charset="us-ascii"
Content-Disposition: attachment; filename="CTM_README"
This directory contains the CTM base files and the distribution
archive.
The purpose of these files is to allow you to maintain an
up-to-date
copy of the source tree for FreeBSD 2.1.x (the current -stable
system)
1) Getting started
A. First read the FAQ and man page
documentation for ctm.
B. Remember that you MUST maintain the entire
source tree.
a) Select the origin for the source.
Although
everything references /usr/src, I suggest that you maintain
the
tree as ....../FreeBSD-2.1/src/ in some other location.
Create this
empty directory.
You can then reference it by a symbolic link. (See
"ln -s")
b) Create the directory to store the CTM files.
C. Build
your baseline tree.
a) If you have the 2.1 Release CD, you will use it
to establish your
initial baseline. Your baseline update will have
a "C" suffix.
Use the live file system. Copy the src/ tree to your
2.1/src/ tree.
b) If you do not have the CD, you will start with an
empty tree. Your
baseline update will have an "A" suffix. (WARNING!
These "A" files
are nearly 30Meg compressed. Use the CD if at all
possible.)
D. Determine which updates you need.
a) The first update
is the baseline. If there is more than one file with
the
appropriate suffix, choose the one with the larger number.
Fetch
this file to your CTM files directory.
b) Also fetch all files with a
larger number that do not have a suffix
letter. In considering this
criteria, ignore the trailing ".gz" which
indicates that the file
is compressed.
E. Apply the updates using the ctm command.
You will
now have an up-to-date tree.
2) Maintaining the tree
Determine how you
will continue to maintain your tree
A. If you wish to update every
infrequently, or some other reason applies,
you may look to the ftp
archives for additional updates.
B. If, as was intended, you wish the
receive the daily updates, although
you don't have to apply them that
often, subscribe to the mailing list
"ctm-src-2_1" by sending your
request to majordomo@freebsd.org.
3) Problems
A. Missing updates
a) Update Frequency
The updates are presently generated once a
day. However, there are
some days when there were no changes to
the tree. In that case, no
update is generated.
b) Missing
sequence numbers
If you find that you have some later updates but
are missing one,
ctm will refuse to apply the later updates until
you can supply all
prior ones. Refer to an FTP site to obtain the
missing file(s).
B. Corrupt tree
If your tree does not have the
EXACT files expected, CTM will refuse
to update.
a) Your might
be able to obtain a few files from one of the FTP or SUP
sites.
b) You can also rebuild the tree from scratch.
If I deam the
number or size of the updates to warrant it, I may
generate new
baseline updates so that you don't have to go back as
far to
rebuild. Check the FTP sites for the latest catalog.
c) Use the
proper baseline update for your situation.
The "A" files demand an
empty initial tree.
The "C" files DEMAND the tree from the "live
file system" CD.
Any other source of the files will probably not
work. However,
industrious individuals have been known to "force"
the situation
into an acceptable state. This is not recommended
and I will not
be inclined to be sympathetic to any difficulties
this creates.
Richard Wackerbarth <rkw@dataplex.net>
--============_-1390272185==_============
Content-Type: text/plain; charset="us-ascii"
----
Richard Wackerbarth
rkw@dataplex.net
--============_-1390272185==_============--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?v02140a00ad221ce2a318>