diff --git a/handbook/sup.sgml b/handbook/sup.sgml index a94da6bfe3..4836e3622e 100644 --- a/handbook/sup.sgml +++ b/handbook/sup.sgml @@ -1,108 +1,131 @@ - + 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

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. 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 with the standard-supfile, 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. 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: 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: 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 +ports-base: /usr/ports/... misc files at the top of /usr/ports +ports-archivers: /usr/ports/archivers archiving tools +ports-audio: /usr/ports/audio sound support +ports-benchmarks: /usr/ports/benchmarks benchmarks +ports-cad: /usr/ports/cad CAD tools +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 software. +ports-lang: /usr/ports/lang programming languages +ports-mail: /usr/ports/mail mail software +ports-math: /usr/ports/math numerical computation software +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 software +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-www: /usr/ports/www software related to the world wide web +ports-x11: /usr/ports/x11 X11 software + + +

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 enormous, and unless you are an ftp site mirroring the +entire FreeBSD tree (but can't use ``mirror'' for some reason), you +(and us) are much better off not using sup to collect these: + +ports-distfiles: /usr/ports/distfiles original tarballs