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

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
FREEBSD-UPDATE(8)       FreeBSD System Manager's Manual      FREEBSD-UPDATE(8)

NAME
     freebsd-update -- fetch and install binary updates to FreeBSD

SYNOPSIS
     freebsd-update [-b basedir] [-d workdir] [-f conffile] [-k KEY]
                    [-s server] [-t address] command ...

DESCRIPTION
     The freebsd-update tool is used to fetch, install, and rollback binary
     updates to the FreeBSD base system.

OPTIONS
     The following options are supported

     -b basedir   Operate on a system mounted at basedir.  (default: /, or as
                  given in the configuration file.)

     -d workdir   Store working files in workdir.  (default:
                  /var/db/freebsd-update/, or as given in the configuration
                  file.)

     -f conffile  Read configuration options from conffile.  (default:
                  /etc/freebsd-update.conf)

     -k KEY       Trust an RSA key with SHA256 of KEY.  (default: read value
                  from configuration file.)

     -s server    Fetch files from the specified server or server pool.
                  (default: read value from configuration file.)

     -t address   Mail output of cron command, if any, to address.  (default:
                  root, or as given in the configuration file.)

COMMANDS
     The command can be any one of the following:

     fetch        Based on the currently installed world and the configuration
                  options set, fetch all available binary updates.

     cron         Sleep a random amount of time between 1 and 3600 seconds,
                  then download updates as if the fetch command was used.  If
                  updates are downloaded, an email will be sent (to root or a
                  different address if specified via the -t option or in the
                  configuration file).  As the name suggests, this command is
                  designed for running from cron(8); the random delay serves
                  to minimize the probability that a large number of machines
                  will simultaneously attempt to fetch updates.

     install      Install the most recently fetched updates.

     rollback     Uninstall the most recently installed updates.

TIPS
     +o   If your clock is set to local time, adding the line

               0 3 * * * root /usr/sbin/freebsd-update cron

         to /etc/crontab will check for updates every night.  If your block is
         set to UTC, please pick a random time other than 3AM, to avoid overly
         imposing an uneven load on the server(s) hosting the updates.

FILES
     /etc/freebsd-update.conf  Default location of the freebsd-update configu-
                               ration file.

     /var/db/freebsd-update/   Default location where freebsd-update stores
                               temporary files and downloaded updates.

SEE ALSO
     freebsd-update.conf(5)

AUTHORS
     Colin Percival <cperciva@FreeBSD.org>

FreeBSD                         August 30, 2006                        FreeBSD

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | COMMANDS | TIPS | FILES | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=freebsd-update&sektion=8&manpath=FreeBSD+6.2-RELEASE>

home | help