diff --git a/handbook/sup.sgml b/handbook/sup.sgml index 153e757ee9..a94da6bfe3 100644 --- a/handbook/sup.sgml +++ b/handbook/sup.sgml @@ -1,101 +1,108 @@ - + SUP

Contributed by &a.jkh; and &a.gclarkii;. 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. Getting setup -

First off you will need to pick up the sup binaries. The easiest -way of doing this is to grab the sup.tgz package from: - - ftp://ftp.FreeBSD.ORG:/pub/FreeBSD/packages/All/sup-2.0.tgz - -Install the sup package using pkg_add and add the following line to -your /etc/services file (if it doesn't already exist): - - supfilesrv 871/tcp # for SUP - +

Starting with FreeBSD 2.1, sup is supplied as part of the base +system and no separate installation is required. SUP gets the information it needs to run from a configuration file called a supfile. This file should be found in /usr/share/examples/sup/standard-supfile for the standard distributions. This file tells sup what collections it will be updating and/or installing and where they go. This supfile will sup the current source collection. For ports please have a look at -/usr/share/examples/sup/ports-supfile. +/usr/share/examples/sup/ports-supfile. If you are interested +in obtaining the cvs files that make up the source tree, refer to +/usr/share/examples/sup/cvs-supfile. If you would rather +track changes to the -stable release, refer to +/usr/share/examples/sup/stable-supfile +instead. + If you're inside the United States, you may also uncomment the `secure' and `eBones' collection lines to grab the DES code. If you're 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 secure-supfile found within the above 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 +/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're ready to go. To start sup type: sup supfile If you wish to see what sup is doing "verbosely", give it the -v option, like so: sup -v supfile Thats all there is to it! Remember that if you're running current, -which is what you will have if you sup, please join the freebsd-current -mailing list. You should also be sure to read for important information on just what we can and cannot do for you as -a -current user. +a -current user. If you are using the stable-supfile, please +join the freebsd-stable mailing list. Description of FreeBSD SUP distributions

For the main FreeBSD distribution using the standard-supfile: -base: /usr/src/... misc files at the top of /usr/src -bin: /usr/src/bin user and system binaries -secure: /usr/src/secure DES Sources (US/Canada ONLY) -eBones: /usr/src/eBones Kerberos and DES (US/Canada ONLY) -etc: /usr/src/etc system files -games: /usr/src/games games -gnu: /usr/src/gnu sources under the GNU Public License -include: /usr/src/include include files -sys: /usr/src/sys kernel sources -lib: /usr/src/lib libraries -libexec: /usr/src/libexec system binaries -share: /usr/src/share various shared resources -sbin: /usr/src/sbin single user system binaries -usrbin: /usr/src/usr.bin user binaries -usrsbin: /usr/src/usr.sbin system binaries +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-share: /usr/src/share various shared resources +src-sbin: /usr/src/sbin single user system binaries +src-usrbin: /usr/src/usr.bin user binaries +src-usrsbin: /usr/src/usr.sbin system binaries

For the international FreeBSD distribution using the secure-supfile: -secure: /usr/src/secure DES Sources -eBones: /usr/src/eBones Kerberos and DES +src-secure: /usr/src/secure DES Sources +src-eBones: /usr/src/eBones Kerberos and DES

And for the ports collection: ports-base: /usr/ports/... misc files at the top of /usr/ports ports-editors: /usr/ports/editors text editors ports-game: /usr/ports/games games ports-lang: /usr/ports/lang programming languages ports-mail: /usr/ports/mail mail software ports-math: /usr/ports/math math software ports-net: /usr/ports/net networking software ports-news: /usr/ports/news USENET news software ports-print: /usr/ports/print printing software ports-russian: /usr/ports/russian russian software ports-shells: /usr/ports/shells various UN*X shells ports-utils: /usr/ports/utils miscellaneous utilities ports-x11: /usr/ports/x11 X11 software