]> pd.if.org Git - zpackage/blob - doc/zpm-update.8
fixup
[zpackage] / doc / zpm-update.8
1 .TH zpm-update 8 2018-12-10 "ZPM 0.4"
2 .SH NAME
3 zpm-update \- update set of installed packages
4 .SH SYNOPSIS
5 .B zpm update
6 [
7 .BI -f " pkgfile"
8 ]
9 [
10 .B -LAOUn
11 ]
12 .RI [ \fB[+|-]\fIpackage ...]
13 .SH DESCRIPTION
14 \fBzpm-update\fR changes the set of installed packages.
15 It can install, remove, or update a set of packages as given on the command
16 line.  It will search defined repositories for packages, and download, merge,
17 and prepare the packages and the local database.  By itself, zpm-update just
18 prepares the system for the file operations and runs package scripts.
19 .PP
20 Packages may be specified by a full package id triple, or any
21 shortened version of one (i.e. a package may be given by name, name
22 and version, or name, version, and release).
23 .PP
24 Packages may have an optional '+' or '-' prefix.  Packages
25 marked with '+' are set to be installed, or updated if a package
26 with the same name is already installed.  Packages marked with
27 a '-' are set to be uninstalled if they are installed.
28 By default, unmarked packages are treated as marked with a '+'.
29 The default can be changed to uninstall with the \fB-U\fR option.
30 .PP
31 Once the set of packages to installed or uninstalled is determined and set up,
32 zpm-syncfs is called to do the actual file operations.  This is an
33 "all-at-once" action in the sense that the whole set of file actions is
34 considered and no concern is given to which specific package a file belongs to.
35 In other words, all of the packages given are updated, removed, installed at
36 the same time, rather than taking each package one at a time and installing,
37 updating, or removing it.  If the admin wants to do the packages one at a time,
38 zpm-update can be run multiple times.
39 .SH OPTIONS
40 .TP
41 \-f
42 specify the package file to find packages in
43 .TP
44 \-n
45 perform a dry run.  This option calls zpm-syncfs in dry-run mode,
46 and doesn't run any package scripts.  Since scripts aren't run
47 and no files are changed, this can only detect and report some
48 types of errors.
49 .TP
50 \-L
51 Don't check for library dependencies
52 .TP
53 \-A
54 run zpm-syncfs in accept mode
55 .TP
56 \-O
57 run zpm-syncfs in overwrite mode mode
58 .TP
59 \-U
60 Treat unmarked packages as packages to be uninstalled.
61 .SH EXAMPLES
62 .TP
63 zpm update vim
64 Install or update the vim package to the latest package found.
65 .TP
66 zpm update -- -vim
67 Uninstall the vim package if it installed.  The '--' is necessary
68 to the system doesn't think you are passing a -v option to zpm update.
69 .TP
70 zpm update -U vim
71 Uninstall the vim package if it installed.
72 .TP
73 zpm update ed -vim
74 Install or update ed to the latest version available, and remove
75 the vim package.
76 .SH EXIT STATUS
77 0 on success non zero on failure
78 .SH FILES
79 /var/lib/zpm/local.db
80 .SH ENVIRONMENT
81 ZPMDB
82 .SH AUTHOR
83 Nathan Wagner
84 .SH SEE ALSO
85 .BR zpm (8)
86 .BR zpm-script (8)
87 .BR zpm-repo (8)
88 .BR zpm-syncfs (8)