1130b656e5
This will make a number of things easier in the future, as well as (finally!) avoiding the Id-smashing problem which has plagued developers for so long. Boy, I'm glad we're not using sup anymore. This update would have been insane otherwise.
160 lines
6.7 KiB
Plaintext
160 lines
6.7 KiB
Plaintext
<!-- $FreeBSD$ -->
|
|
<!-- The FreeBSD Documentation Project -->
|
|
|
|
|
|
<sect><heading>SUP<label id="sup"></heading>
|
|
|
|
<p><em>Contributed by &a.jkh; and &a.gclarkii;.</em>
|
|
|
|
SUP is a network based software update tool developed at CMU. The
|
|
purpose of this document is get the beginner up and running with sup.
|
|
|
|
<sect1><heading>Configuration<label id="sup:setup"></heading>
|
|
|
|
<p>SUP gets the information it needs to run from a configuration file
|
|
called a supfile. There are different example supfiles provided
|
|
for different source releases of FreeBSD. The
|
|
<url url="file:/usr/share/examples/sup/standard-supfile"
|
|
name="/usr/share/examples/sup/standard-supfile"> file, for example,
|
|
contains sup information for the latest standard FreeBSD source
|
|
distributions - it tells sup what collections it will be updating
|
|
and/or installing and where they go. Someone using this particular
|
|
supfile is said to be supping <ref id="current" name="-current">.
|
|
<p>For ports, please have a look at
|
|
<url url="file:/usr/share/examples/sup/ports-supfile"
|
|
name="/usr/share/examples/sup/ports-supfile">.<p>
|
|
If you are interested in obtaining the
|
|
<url url="http://www.freebsd.org/cgi/cvsweb.cgi" name="CVS"> files
|
|
that make up the source tree, refer to
|
|
<url url="file:/usr/share/examples/sup/cvs-supfile"
|
|
name="/usr/share/examples/sup/cvs-supfile">.<p>
|
|
If you would rather track changes to the -stable branch, refer to
|
|
<url url="file:/usr/share/examples/sup/stable-supfile"
|
|
name="/usr/share/examples/sup/stable-supfile"> instead.
|
|
|
|
If you are inside the United States, you may also uncomment
|
|
the `secure' and `eBones' collection lines to grab the DES code.
|
|
If you are outside the
|
|
U.S., you should NOT sup this code from sup.FreeBSD.ORG as this will
|
|
violate U.S. export restrictions. Instead you should use the
|
|
<url url="file:/usr/share/examples/sup/secure-supfile"
|
|
name="secure-supfile"> in the sup examples directory. This will
|
|
connect you to the international sup site that contains a secure distribution.
|
|
Any distributions you do not wish to receive can be commented out
|
|
with a # at the beginning of the distribution line.
|
|
|
|
Please consult the file
|
|
<url url="file:/usr/share/examples/sup/README"
|
|
name="/usr/share/examples/sup/README">
|
|
for a list of alternate sup servers. The default sup server (sup.FreeBSD.ORG)
|
|
listed in the above example files is currently overloaded and any traffic
|
|
that can be transfered to a different host will help relieve some of
|
|
the strain.
|
|
|
|
Once this is setup, you are ready to go. To start sup type:
|
|
<verb>
|
|
sup supfile
|
|
</verb>
|
|
If you wish to see what sup is doing "verbosely", give it the -v option,
|
|
like so:
|
|
<verb>
|
|
sup -v supfile
|
|
</verb>
|
|
Thats all there is to it! Remember that if you are running current,
|
|
which is what you will have if you sup with the standard-supfile, please
|
|
join the &a.current . You should also be sure to read
|
|
<ref id="current" name="Staying current with FreeBSD">
|
|
for important information on just what we can and cannot do for you as
|
|
a -current user. If you are using the stable-supfile, please
|
|
join the &a.stable and read
|
|
<ref id="stable" name="Staying stable with FreeBSD">.
|
|
|
|
<sect1><heading>Distributions<label id="sup:dists">
|
|
</heading>
|
|
|
|
<p>For the main FreeBSD distribution using the standard-supfile:
|
|
<verb>
|
|
src-base: /usr/src/... misc files at the top of /usr/src
|
|
src-bin: /usr/src/bin user and system binaries
|
|
src-secure: /usr/src/secure DES Sources (US/Canada ONLY)
|
|
src-eBones: /usr/src/eBones Kerberos and DES (US/Canada ONLY)
|
|
src-etc: /usr/src/etc system files
|
|
src-games: /usr/src/games games
|
|
src-gnu: /usr/src/gnu sources under the GNU Public License
|
|
src-include: /usr/src/include include files
|
|
src-sys: /usr/src/sys kernel sources
|
|
src-lib: /usr/src/lib libraries
|
|
src-libexec: /usr/src/libexec system binaries
|
|
src-release: /usr/src/release sources required to build a release
|
|
src-share: /usr/src/share various shared resources
|
|
src-sbin: /usr/src/sbin single user system binaries
|
|
src-tools: /usr/src/tools various management tools
|
|
src-usrbin: /usr/src/usr.bin user binaries
|
|
src-usrsbin: /usr/src/usr.sbin system binaries
|
|
</verb>
|
|
|
|
<p>For the international FreeBSD distribution using the secure-supfile:
|
|
<verb>
|
|
src-secure: /usr/src/secure DES Sources
|
|
src-eBones: /usr/src/eBones Kerberos and DES
|
|
</verb>
|
|
|
|
<p>There is also a collection including all of the above, except for
|
|
either (domestic or international) versions of the export-restricted
|
|
software (i.e., <tt>src-secure</tt> and <tt>src-eBones</tt>
|
|
collections):
|
|
<verb>
|
|
src-all: /usr/src the whole operating system (almost)
|
|
</verb>
|
|
|
|
<p>And for the ports collection:
|
|
<verb>
|
|
ports-base: /usr/ports/... misc files at the top of /usr/ports
|
|
ports-archivers: /usr/ports/archivers archiving tools
|
|
ports-astro: /usr/ports/astro astronomical ports
|
|
ports-audio: /usr/ports/audio sound support
|
|
ports-benchmarks: /usr/ports/benchmarks benchmarks
|
|
ports-cad: /usr/ports/cad CAD tools
|
|
ports-chinese: /usr/ports/chinese Chinese support
|
|
ports-comms: /usr/ports/comms communication software
|
|
ports-databases: /usr/ports/databases databases
|
|
ports-devel: /usr/ports/devel development utilities
|
|
ports-editors: /usr/ports/editors editors
|
|
ports-emulators: /usr/ports/emulators emulators for other OSes
|
|
ports-games: /usr/ports/games games
|
|
ports-graphics: /usr/ports/graphics various graphics utilities
|
|
ports-japanese: /usr/ports/japanese Japanese support
|
|
ports-lang: /usr/ports/lang programming languages
|
|
ports-mail: /usr/ports/mail mail software
|
|
ports-math: /usr/ports/math numerical computation software
|
|
ports-mbone: /usr/ports/mbone MBone applications
|
|
ports-misc: /usr/ports/misc miscellaneous utilities
|
|
ports-net: /usr/ports/net networking software
|
|
ports-news: /usr/ports/news USENET news software
|
|
ports-plan9: /usr/ports/plan9 various programs from Plan9
|
|
ports-print: /usr/ports/print printing software
|
|
ports-russian: /usr/ports/russian Russian support
|
|
ports-security: /usr/ports/security ``security'' utilities, for better or for worse
|
|
ports-shells: /usr/ports/shells various UN*X shells
|
|
ports-sysutils: /usr/ports/sysutils system utilities
|
|
ports-vietnamese: /usr/ports/vietnamese Vietnamese support
|
|
ports-www: /usr/ports/www software related to the world wide web
|
|
ports-x11: /usr/ports/x11 X11 software
|
|
</verb>
|
|
|
|
<p>There is also a collection including all of the above:
|
|
<verb>
|
|
ports-all: /usr/ports the whole ports tree
|
|
</verb>
|
|
|
|
<!-- The following is currently not available (and probably will never return)
|
|
<p>If you want to keep updated on the original source of the ports,
|
|
you can also add this to your supfile. But note that this collection
|
|
is <em>enormous</em>, and unless you are an ftp site mirroring the
|
|
entire FreeBSD tree (but cannot use ``mirror'' for some reason), you
|
|
(and us) are much better off not using sup to collect these:
|
|
<verb>
|
|
ports-distfiles: /usr/ports/distfiles original tarballs
|
|
</verb>
|
|
-->
|