Index: mirrors/chapter.sgml
===================================================================
RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml,v
retrieving revision 1.277
diff -u -r1.277 chapter.sgml
--- mirrors/chapter.sgml 13 Mar 2003 16:40:57 -0000 1.277
+++ mirrors/chapter.sgml 13 Mar 2003 16:52:34 -0000
@@ -308,7 +308,7 @@
ftp://ftp.at.FreeBSD.org/pub/FreeBSD/
-
+
ftp://ftp2.at.FreeBSD.org/pub/FreeBSD/
@@ -391,7 +391,7 @@
ftp://ftp.ca.FreeBSD.org/pub/FreeBSD/
-
+
ftp://ftp2.ca.FreeBSD.org/pub/FreeBSD/
@@ -641,7 +641,7 @@
In case of problems, please contact the hostmaster
mohacsi@ik.bme.hu for this domain.
-
+
-
Iceland
@@ -820,7 +819,7 @@
-
+
Netherlands
@@ -1092,11 +1091,11 @@
ftp://ftp.es.FreeBSD.org/pub/FreeBSD/
-
+
ftp://ftp2.es.FreeBSD.org/pub/FreeBSD/
-
+
ftp://ftp3.es.FreeBSD.org/pub/FreeBSD/
@@ -1525,7 +1524,7 @@
Checking Out the Version of &man.ls.1; in the 3.X-STABLE
Branch:
-
+
&prompt.user; setenv CVSROOT :pserver:anoncvs@anoncvs.FreeBSD.org:/home/ncvs
&prompt.user; cvs loginAt the prompt, enter the passwordanoncvs.
@@ -1585,8 +1584,8 @@
-
-
+
+
Using CTM
@@ -1633,7 +1632,7 @@
You will need two things: The CTM
program, and the initial deltas to feed it (to get up to
current levels).
-
+
The CTM program has been part of
FreeBSD ever since version 2.0 was released, and lives in
/usr/src/usr.sbin/ctm if you have a copy
@@ -1642,7 +1641,7 @@
If you are running a pre-2.0 version of FreeBSD, you can
fetch the current CTM sources
directly from:
-
+
ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/src/usr.sbin/ctm/
@@ -1870,7 +1869,7 @@
CTM Mirrors
-
+
CTM/FreeBSD is available via anonymous
FTP from the following mirror sites. If you choose to obtain CTM via
anonymous FTP, please try to use a site near you.
@@ -1935,17 +1934,17 @@
Using CVSup
-
+
Introduction
-
+
CVSup is a software package for
distributing and updating source trees from a master CVS
repository on a remote server host. The FreeBSD sources are
maintained in a CVS repository on a central development machine
in California. With CVSup, FreeBSD
users can easily keep their own source trees up to date.
-
+
CVSup uses the so-called
pull model of updating. Under the pull
model, each client asks the server for updates, if and when they
@@ -1955,7 +1954,7 @@
run the CVSup client manually to get
an update, or they must set up a cron job to
run it automatically on a regular basis.
-
+
The term CVSup, capitalized just
so, refers to the entire software package. Its main components
are the client cvsup which runs on each
@@ -1976,7 +1975,7 @@
Installation
-
+
The easiest way to install CVSup
is to use the precompiled net/cvsup package
from the FreeBSD packages collection.
@@ -1995,8 +1994,8 @@
CVSup GUI,
net/cvsup-without-gui.
-
- If you do not know anything about
+
+ If you do not know anything about
CVSup at all and want a
single package which will install it, set up the configuration
file and start the transfer via a pointy-clicky type of
@@ -2009,37 +2008,37 @@
CVSup Configuration
-
+
CVSup's operation is controlled
by a configuration file called the supfile.
There are some sample supfiles in the
directory /usr/share/examples/cvsup/.
-
+
The information in a supfile answers
the following questions for cvsup:
-
+
Which files do you
want to receive?
-
+
Which versions of them
do you want?
-
+
Where do you want to
get them from?
-
+
Where do you want to
put them on your own machine?
-
+
Where do you want to
put your status files?
@@ -2055,7 +2054,7 @@
begin with # and extend to the end of the
line. Lines that are blank and lines that contain only
comments are ignored.
-
+
Each remaining line describes a set of files that the user
wishes to receive. The line begins with the name of a
collection, a logical grouping of files defined by
@@ -2069,7 +2068,7 @@
keyword, but the keyword is followed without intervening white
space by = and a second word. For example,
release=cvs is a value field.
-
+
A supfile typically specifies more than
one collection to receive. One way to structure a
supfile is to specify all of the relevant
@@ -2096,7 +2095,7 @@
Which files do you want
to receive?
-
+
The files available via CVSup
are organized into named groups called
collections. The collections that are
@@ -2126,7 +2125,7 @@
specify which one of them you want using the
tag= and value
fields.
-
+
Be very careful to specify any tag=
fields correctly. Some tags are valid only for certain
@@ -2147,7 +2146,7 @@
a branch tag does not refer to a specific revision, it may
mean something different tomorrow than it means
today.
-
+
contains branch tags that
users might be interested in. When specifying a tag in
CVSup's configuration file, it
@@ -2177,7 +2176,7 @@
For our example, we wish to receive FreeBSD-CURRENT. We
add this line at the beginning of our
supfile:
-
+
*default tag=.There is an important special case that comes into play
@@ -2196,7 +2195,7 @@
Where do you want to get
them from?
-
+
We use the host= field to tell
cvsup where to obtain its updates. Any
of the CVSup mirror
@@ -2206,7 +2205,7 @@
cvsup666.FreeBSD.org:*default host=cvsup666.FreeBSD.org
-
+
You will need to change the host to one that actually
exists before running CVSup.
On any particular run of
@@ -2214,11 +2213,11 @@
on the command line, with .
-
+
Where do you want to put
them on your own machine?
-
+
The prefix= field tells
cvsup where to put the files it receives.
In this example, we will put the source files directly into
@@ -2226,7 +2225,7 @@
src directory is already implicit in
the collections we have chosen to receive, so this is the
correct specification:
-
+
*default prefix=/usr
@@ -2247,7 +2246,7 @@
This setting is used by default if it is not specified
in the supfile, so we actually do not
need the above line.
-
+
If your base directory does not already exist, now would
be a good time to create it. The cvsup
client will refuse to run if the base directory does not
@@ -2257,7 +2256,7 @@
Miscellaneous supfile
settings:
-
+
There is one more line of boiler plate that normally
needs to be present in the
supfile:
@@ -2269,7 +2268,7 @@
repository. This is virtually always the case, but there
are other possibilities which are beyond the scope of this
discussion.
-
+
delete gives
CVSup permission to delete files.
You should always specify this, so that
@@ -2278,7 +2277,7 @@
careful to delete only those files for which it is
responsible. Any extra files you happen to have will be
left strictly alone.
-
+
use-rel-suffix is ... arcane. If you
really want to know about it, see the &man.cvsup.1; manual
page. Otherwise, just specify it and do not worry about
@@ -2340,8 +2339,8 @@
base/sup/refuse.
base is defined in your supfile; by
default, base is
- /usr/local/etc/cvsup,
- which means that by default the refuse file is in
+ /usr/local/etc/cvsup,
+ which means that by default the refuse file is in
/usr/local/etc/cvsup/sup/refuse.The refuse file has a very simple format; it simply
@@ -2388,25 +2387,25 @@
to download files that they will never use. For more
information on refuse files and other neat
features of CVSup, please view its
- manual page.
+ manual page.
-
+
Running CVSup
-
+
You are now ready to try an update. The command line for
doing this is quite simple:&prompt.root; cvsup supfilewhere supfile
- is of course the name of the supfile you have just created.
+ is of course the name of the supfile you have just created.
Assuming you are running under X11, cvsup
will display a GUI window with some buttons to do the usual
things. Press the go button, and watch it
run.
-
+
Since you are updating your actual
/usr/src tree in this example, you will
need to run the program as root so that
@@ -2420,7 +2419,7 @@
&prompt.root; mkdir /var/tmp/dest
&prompt.root; cvsup supfile /var/tmp/dest
-
+
The directory you specify will be used as the destination
directory for all file updates.
CVSup will examine your usual files
@@ -2433,25 +2432,25 @@
directory. As long as you have read access to
/usr/src, you do not even need to be
root to perform this kind of trial run.
-
+
If you are not running X11 or if you just do not like GUIs,
you should add a couple of options to the command line when you
run cvsup:
-
+
&prompt.root; cvsup -g -L 2 supfile
-
+
The tells
CVSup not to use its GUI. This is
automatic if you are not running X11, but otherwise you have to
specify it.
-
- The tells
+
+ The tells
CVSup to print out the
details of all the file updates it is doing. There are three
levels of verbosity, from to
. The default is 0, which means total
silence except for error messages.
-
+
There are plenty of other options available. For a brief
list of them, type cvsup -H. For more
detailed descriptions, see the manual page.
@@ -2465,7 +2464,7 @@
CVSup File Collections
-
+
The file collections available via
CVSup are organized hierarchically.
There are a few large collections, and they are divided into
@@ -2473,31 +2472,31 @@
equivalent to receiving each of its sub-collections. The
hierarchical relationships among collections are reflected by
the use of indentation in the list below.
-
+
The most commonly used collections are
src-all, and
ports-all. The other collections are used
only by small groups of people for specialized purposes, and
some mirror sites may not carry all of them.
-
+
cvs-all release=cvs
-
+
The main FreeBSD CVS repository, including the
cryptography code.
-
+
distrib release=cvs
-
+
Files related to the distribution and mirroring
of FreeBSD.
-
+
doc-all release=cvs
@@ -2538,7 +2537,7 @@
ports-archivers
release=cvs
-
+
Archiving tools.
@@ -2547,7 +2546,7 @@
ports-astro
release=cvs
-
+
Astronomical ports.
@@ -2556,7 +2555,7 @@
ports-audio
release=cvs
-
+
Sound support.
@@ -2565,7 +2564,7 @@
ports-base
release=cvs
-
+
The Ports Collection build infrastructure -
various files located in the
@@ -2587,7 +2586,7 @@
ports-benchmarks
release=cvs
-
+
Benchmarks.
@@ -2605,7 +2604,7 @@
ports-cad
release=cvs
-
+
Computer aided design tools.
@@ -2614,7 +2613,7 @@
ports-chinese
release=cvs
-
+
Chinese language support.
@@ -2623,7 +2622,7 @@
ports-comms
release=cvs
-
+
Communication software.
@@ -2632,7 +2631,7 @@
ports-converters
release=cvs
-
+
character code converters.
@@ -2641,16 +2640,16 @@
ports-databases
release=cvs
-
+
Databases.
-
+
ports-deskutils
release=cvs
-
+
Things that used to be on the desktop
before computers were invented.
@@ -2678,7 +2677,7 @@
ports-emulators
release=cvs
-
+
Emulators for other operating
systems.
@@ -2688,7 +2687,7 @@
ports-finance
release=cvs
-
+
Monetary, financial and related applications.
@@ -2697,7 +2696,7 @@
ports-ftp
release=cvs
-
+
FTP client and server utilities.
@@ -2706,16 +2705,16 @@
ports-games
release=cvs
-
+
Games.
-
+
ports-german
release=cvs
-
+
German language support.
@@ -2733,7 +2732,7 @@
ports-hungarian
release=cvs
-
+
Hungarian language support.
@@ -2756,7 +2755,7 @@
Japanese language support.
-
+
ports-java
release=cvs
@@ -2832,7 +2831,7 @@
ports-net
release=cvs
-
+
Networking software.
@@ -2841,16 +2840,16 @@
ports-news
release=cvs
-
+
USENET news software.
-
+
ports-palm
release=cvs
-
+
Software support for Palm
series.
@@ -2860,7 +2859,7 @@
ports-portuguese
release=cvs
-
+
Portuguese language support.
@@ -2869,7 +2868,7 @@
ports-print
release=cvs
-
+
Printing software.
@@ -2878,7 +2877,7 @@
ports-russian
release=cvs
-
+
Russian language support.
@@ -2887,7 +2886,7 @@
ports-security
release=cvs
-
+
Security utilities.
@@ -2896,7 +2895,7 @@
ports-shells
release=cvs
-
+
Command line shells.
@@ -2905,7 +2904,7 @@
ports-sysutils
release=cvs
-
+
System utilities.
@@ -2914,7 +2913,7 @@
ports-textproc
release=cvs
-
+
text processing utilities (does not
include desktop publishing).
@@ -2924,7 +2923,7 @@
ports-vietnamese
release=cvs
-
+
Vietnamese language support.
@@ -2933,7 +2932,7 @@
ports-www
release=cvs
-
+
Software related to the World Wide
Web.
@@ -2943,7 +2942,7 @@
ports-x11
release=cvs
-
+
Ports to support the X window
system.
@@ -2953,7 +2952,7 @@
ports-x11-clocks
release=cvs
-
+
X11 clocks.
@@ -2971,7 +2970,7 @@
ports-x11-fonts
release=cvs
-
+
X11 fonts and font utilities.
@@ -2988,7 +2987,7 @@
ports-x11-servers
-
+
X11 servers.
@@ -2996,7 +2995,7 @@
ports-x11-wm
-
+
X11 window managers.
@@ -3007,7 +3006,7 @@
src-all release=cvs
-
+
The main FreeBSD sources, including the
cryptography code.
@@ -3058,7 +3057,7 @@
src-eBones release=cvs
-
+
Kerberos and DES
(/usr/src/eBones). Not
@@ -3079,7 +3078,7 @@
src-games
release=cvs
-
+
Games
(/usr/src/games).
@@ -3099,7 +3098,7 @@
src-include
release=cvs
-
+
Header files
(/usr/src/include).
@@ -3109,7 +3108,7 @@
src-kerberos5
release=cvs
-
+
Kerberos5 security package
(/usr/src/kerberos5).
@@ -3119,7 +3118,7 @@
src-kerberosIV
release=cvs
-
+
KerberosIV security package
(/usr/src/kerberosIV).
@@ -3146,11 +3145,11 @@
(/usr/src/libexec).
-
+
src-release
release=cvs
-
+
Files required to produce a FreeBSD
release
@@ -3166,7 +3165,7 @@
(/usr/src/sbin).
-
+
src-secure
release=cvs
@@ -3201,7 +3200,7 @@
src-sys-crypto
release=cvs
-
+
Kernel cryptography code
(/usr/src/sys/crypto).
@@ -3232,7 +3231,7 @@
src-usrsbin
release=cvs
-
+
System utilities
(/usr/src/usr.sbin).
@@ -3241,10 +3240,10 @@
-
+
www release=cvs
-
+
The sources for the FreeBSD WWW site.
@@ -3252,12 +3251,12 @@
-
+
distrib release=self
- The CVSup server's own
+ The CVSup server's own
configuration files. Used by CVSup
mirror sites.
@@ -3273,7 +3272,7 @@
mail-archive release=current
-
+
FreeBSD mailing list archive.
@@ -3293,7 +3292,7 @@
For More Information
- For the CVSup FAQ and other
+ For the CVSup FAQ and other
information about CVSup, see
The
CVSup Home Page.
@@ -3302,7 +3301,7 @@
CVSup takes place on the
&a.hackers;. New versions of the software are announced there,
as well as on the &a.announce;.
-
+
Questions and bug reports should be addressed to the author
of the program at cvsup-bugs@polstra.com.
@@ -4299,7 +4298,7 @@
-
+
CVS Tags
@@ -4342,7 +4341,7 @@
RELENG_5_0
- The release branch for FreeBSD-5.0, used only
+ The release branch for FreeBSD-5.0, used only
for security advisories and other seriously critical fixes.
@@ -4360,7 +4359,7 @@
RELENG_4_7
- The release branch for FreeBSD-4.7, used only
+ The release branch for FreeBSD-4.7, used only
for security advisories and other seriously critical fixes.
@@ -4510,7 +4509,7 @@
FreeBSD 4.0.
-
+
RELENG_3_5_0_RELEASE
@@ -4649,7 +4648,7 @@
much the same way as the rcp command,
but has more options and uses the rsync remote-update protocol
which transfers only the differences between two sets of files,
- thus greatly speeding up the synchronization over the network.
+ thus greatly speeding up the synchronization over the network.
This is most useful if you are a mirror site for the
FreeBSD FTP server, or the CVS repository. The
rsync suite is available for many
@@ -4717,7 +4716,7 @@
FreeBSD: The master archive of the FreeBSD
FTP server.acl: The FreeBSD master ACL
- list.
+ list.
rsync://ftp13.FreeBSD.org/
@@ -4730,7 +4729,7 @@
-
+