NAME

upgrade — upgrade the sources and rebuild the world

SYNOPSIS

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.