diff options
Diffstat (limited to 'share/doc/handbook/sup.sgml')
-rw-r--r-- | share/doc/handbook/sup.sgml | 163 |
1 files changed, 0 insertions, 163 deletions
diff --git a/share/doc/handbook/sup.sgml b/share/doc/handbook/sup.sgml deleted file mode 100644 index 19c3144..0000000 --- a/share/doc/handbook/sup.sgml +++ /dev/null @@ -1,163 +0,0 @@ -<!-- $Id: sup.sgml,v 1.28 1997/04/27 00:32:37 asami Exp $ --> -<!-- The FreeBSD Documentation Project --> - - -<sect1><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. - -<sect2><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">. - -<sect2><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-contrib: /usr/src/contrib contributed software -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-converters: /usr/ports/converters character code converters -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-korean: /usr/ports/korean Korean 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-textproc: /usr/ports/textproc text processing utilities (does not include desktop publishing) -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> ---> |