GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  UPGRADE (8)

NAME

upgrade - upgrade the sources and rebuild the world

CONTENTS

Synopsis
Description
Options
Files
Diagnostics
Compatibility
See Also
History
Authors
Bugs

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
.Fx 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
.Fx 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
.Fx 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
.An The Anarcat Aq anarcat@anarcat.ath.cx .

BUGS

No known bugs.
Search for    or go to Top of page |  Section 8 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.