DragonFly On-Line Manual Pages

Search: Section:  

UPGRADE(8)             DragonFly System Manager's Manual            UPGRADE(8)


NAME

     upgrade - upgrade the sources and rebuild the world


SYNOPSIS

     upgrade [-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
     recommended 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 ALSO

     buildit(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.

DragonFly 6.5-DEVELOPMENT       August 27, 2003      DragonFly 6.5-DEVELOPMENT

Search: Section: