Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   44335 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

UPGRADE(8)		  BSD 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 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 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.

BSD				August 27, 2003				   BSD

Vote for polarhome