Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
UPGRADE(8)		     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 whereinthe-
     world(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 cv-
     sup(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 be-
     fore.

     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.

FreeBSD ports 15.quarterly	 August 27, 2003		      UPGRADE(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=upgrade&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help