.TH zpm-update 8 2019-02-19 "ZPM 0.4"
.SH NAME
zpm-update \- update set of installed packages
.SH SYNOPSIS
.B zpm update
[
.BI -f " pkgfile"
]
[
.B -LAOUnzvpSCl
]
.RI [ \fB[+|-]\fIpackage ...]
.SH DESCRIPTION
\fBzpm-update\fR changes the set of installed packages.
It can install, remove, or update a set of packages as given on the command
line.  It will search defined repositories for packages, and download, merge,
and prepare the packages and the local database.  By itself, zpm-update just
prepares the system for the file operations and runs package scripts.  Actual
filesystem actions (i.e. removing or installing of files in the file system)
is delegated to zpm-syncfs.
.PP
Packages may be specified by a full package id triple, or any
shortened version of one (i.e. a package may be given by name, name
and version, or name, version, and release).
.PP
Packages may have an optional '+' or '-' prefix.  Packages
marked with '+' are set to be installed, or updated if a package
with the same name is already installed.  Packages marked with
a '-' are set to be uninstalled if they are installed.
By default, unmarked packages are treated as marked with a '+'.
The default can be changed to uninstall with the \fB-U\fR option.
.PP
Once the set of packages to installed or uninstalled is determined and set up,
zpm-syncfs is called to do the actual file operations.  This is an
"all-at-once" action in the sense that the whole set of file actions is
considered and no concern is given to which specific package a file belongs to.
In other words, all of the packages given are updated, removed, installed at
the same time, rather than taking each package one at a time and installing,
updating, or removing it.  If the admin wants to do the packages one at a time,
zpm-update can be run multiple times.
.PP
Either the package update process, or package scripts may
put notes in the database with information for the sysadmin.
zpm-note should be run after updates to check for these.
.SS Package Search
Packages will be searched for in *.repo files, the local database, and
in individual zpm package files.  These are looked for by default
in /var/lib/zpm/*.repo /var/lib/zpm/packages/*.zpm and the usual
location for the local database.
.SH OPTIONS
.TP
.B \-f
specify the package file to find packages in
.TP
.B \-n
perform a dry run.  This option calls zpm-syncfs in dry-run mode,
and doesn't run any package scripts.  Since scripts aren't run
and no files are changed, this can only detect and report some
types of errors.
.TP
.B \-l
Just list the computed set of packages to update.
.TP
.BI \-R rootdir
Specify a root directory for the package installs.  Files will be
installed relative to this directory.
.TP
.B \-S
Don't run any package pre or post scripts.  Normally zpm-update will run
package pre and post scripts associated with packages being removed, updated,
or installed.  See zpm-script(8) for details.  If any scripts are skipped due
to the option, a note will be added.
.TP
.B \-C
Don't run package configure scripts.  Any skipped scripts will have a note
added.
.TP
.B \-v
Run syncfs in verbose mode.  This flag is passed on to zpm-syncfs.
.TP
.B \-p
Passed to zpm-syncfs to control the type of progress meter.
.TP
.B \-z
Don't pull remote repositories before searching for packages, by
default all remote repos are refreshed with repo pull before
commencing a search for new packages.
.TP
.B \-L
Don't check for library dependencies, passed on to zpm-search.
.TP
.B \-A
run zpm-syncfs in accept mode
.TP
.B \-O
run zpm-syncfs in overwrite mode mode
.TP
.B \-U
Treat unmarked packages as packages to be uninstalled.
.SH EXAMPLES
.TP
zpm update vim
Install or update the vim package to the latest package found.
.TP
zpm update -- -vim
Uninstall the vim package if it installed.  The '--' is necessary
to the system doesn't think you are passing a -v option to zpm update.
.TP
zpm update -U vim
Uninstall the vim package if it installed.
.TP
zpm update ed -vim
Install or update ed to the latest version available, and remove
the vim package.
.SH EXIT STATUS
0 on success non zero on failure
.SH FILES
/var/lib/zpm/local.db
.SH ENVIRONMENT
ZPMDB ZPM_ROOT_DIR
.SH AUTHOR
Nathan Wagner
.SH SEE ALSO
.BR zpm (8)
.BR zpm-search (8)
.BR zpm-script (8)
.BR zpm-repo (8)
.BR zpm-syncfs (8)