mirror of
https://git.FreeBSD.org/src.git
synced 2025-01-22 15:47:37 +00:00
f024993b17
b) Put in names and email addresses of people who have claimed empty sections as their own. c) Incorporated MIRROR.SITES as the first section in the appendix titled "Obtaining FreeBSD". When adding, removing or otherwize twiddling with the mirror site info, do it in mirrors.sgml! d) A couple other odds and ends. e) NOTE: You must update your your /usr/bin/sgmlfmt and /usr/share/sgml to process this edition of the handbook!
92 lines
3.5 KiB
Plaintext
92 lines
3.5 KiB
Plaintext
<!-- $Id: sup.sgml,v 1.5 1995/07/07 22:25:54 jfieber Exp $ -->
|
|
<!-- 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>Getting setup</heading>
|
|
|
|
<p>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:
|
|
<verb>
|
|
ftp://ftp.FreeBSD.ORG:/pub/FreeBSD/packages/sup.tgz
|
|
</verb>
|
|
Install the sup package using pkg_add and add the following line to
|
|
your /etc/services file:
|
|
<verb>
|
|
sup 871/tcp #sup
|
|
</verb>
|
|
|
|
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 seperating
|
|
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 <em>but</em> 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
|
|
with a # at the begining of the distribution line.
|
|
|
|
Once this is setup, you're 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'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 <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.
|
|
|
|
<sect1><heading>Description of FreeBSD SUP distributions</heading>
|
|
|
|
<p>For the main FreeBSD distribution:
|
|
<verb>
|
|
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!
|
|
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
|
|
share: /usr/src/share various shared resources
|
|
sbin: /usr/src/sbin even more system binaries
|
|
usrbin: /usr/src/usr.bin user binaries
|
|
usrsbin: /usr/src/usr.sbin that's it for the system binaries
|
|
</verb>
|
|
|
|
And for the ports collection:
|
|
<verb>
|
|
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
|
|
</verb>
|