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
     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