diff --git a/handbook/sup.sgml b/handbook/sup.sgml index f1794ab588..1506b289aa 100644 --- a/handbook/sup.sgml +++ b/handbook/sup.sgml @@ -1,91 +1,101 @@ - + 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/sup.tgz + 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 SUP gets the information it needs to run from a configuration file -called a supfile. This file tells sup what collections it will be updating -and/or installing and where they go. The supfile in this directory will -sup both the source and ports collection - look for the blank line separating -the two collections; if you don't want ports, you can simply delete all the -ports entries. If you're inside the United States, you may also uncomment -the `secure' collection line to grab the DES code. If you're outside the -U.S., you should NOT sup this code from FreeBSD.ORG as this will -violate U.S. export restrictions. Simply sup everything but the secure -collection and then go look on braae.ru.ac.za, where it's available for -anonymous ftp for those outside the U.S. - -Any other distributions you do not wish to receive can be commented out +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. +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. 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. Description of FreeBSD SUP distributions -

For the main FreeBSD distribution: +

For the main FreeBSD distribution useing the standard-supfile: base: /usr/src/... misc files at the top of /usr/src -bin: /usr/src/bin system binaries -secure: /usr/src/secure DES Sources. U.S./Canada only! +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 more system binaries +libexec: /usr/src/libexec system binaries share: /usr/src/share various shared resources -sbin: /usr/src/sbin even more system binaries +sbin: /usr/src/sbin single user system binaries usrbin: /usr/src/usr.bin user binaries -usrsbin: /usr/src/usr.sbin that's it for the system binaries +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 -And for the ports collection: +

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