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
       whereintheworld(8) commands. It was made	to ease	the process of upgrad-
       ing 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 re-
		  moved	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 rec-
       ommended	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.

FreeBSD	ports 15.0		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.0>

home | help