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.

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.