UPGRADE(8) BSD System Manager's Manual UPGRADE(8)NAMEupgrade — upgrade the sources and rebuild the world
SYNOPSISupgrade [-mnh] [-l logfile] [-s supfile] [-H host] file
DESCRIPTION
The upgrade command is a wrapper script for the buildit(8) and
whereintheworld(8) commands. It was made to ease the process of upgrading
a FreeBSD system.
The upgrade command will, in order, update the source tree using the
cvsup(1) command then run make buildworld to recompile the whole source
tree. Both commands are run in the buildit(8) wrapper, but only the
buildworld can have email notification enabled, to avoid unecessary email
traffic.
OPTIONS
The options are as follows:
-m do not send email when finished (passed directly to
buildit(8).
-c args pass args to the cvsup(1) call.
-M args pass args to the make buildworld call.
-n do not update the source tree using cvsup(1).
-h print out a simple help and exit.
-l logfile log all output to logfile.
-s supfile tell cvsup(1) to use supfile as its configuration file.
-H hostname tell cvsup(1) to connect to hostname to update the sources.
FILES
/usr/share/examples/cvsup/standard-supfile
The default supfile passed to cvsup(1).
/var/log/build.log
The default logfile location. This file can safely be removed
when the script is finished.
DIAGNOSTICS
The cvsup(1) and make buildworld commands are both started using
buildit(8) so all diagnostics will be the same as buildit(8).
COMPATIBILITY
The upgrade command is severly FreeBSD centric and is only relevant on
that platform.
CAVEAT
make buildworld is called instead of a full make world because the recom‐
mended way of upgrading a FreeBSD system is to do the installworld part
of the make world in single user mode. So after calling upgrade, you will
still need to manually run mergemaster(8) and make installworld just as
before.
By default, upgrade will make cvsup(1) connect to cvsup.freebsd.org. You
are encouraged to use the -H flag in order to choose a mirror closer to
your location and alleviate the load on the main servers.
SEE ALSObuildit(8), whereintheworld(8), cvsup(1), mergemaster(8), /usr/src/README
http://www.FreeBSD.org/handbook/makeworld.html
http://www.FreeBSD.org/handbook/cvsup.html#CVSUP-MIRRORS
HISTORY
The upgrade manual page first appeared in worldtools 1.2.
AUTHORS
This manual page and the upgrade command were written by The Anarcat
⟨anarcat@anarcat.ath.cx⟩.
BUGS
No known bugs.
BSD August 27, 2003 BSD