]> pd.if.org Git - zpackage/blob - doc/zpm-update.8
96e700bb7e9315e5ad409e0e83f54bb5ace8ffe4
[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 .SS Package Search
40 Packages will be searched for in *.repo files, the local database, and
41 in individual zpm package files.  These are looked for by default
42 in /var/lib/zpm/*.repo /var/lib/zpm/packages/*.zpm and the usual
43 location for the local database.
44 .SH OPTIONS
45 .TP
46 \-f
47 specify the package file to find packages in
48 .TP
49 \-n
50 perform a dry run.  This option calls zpm-syncfs in dry-run mode,
51 and doesn't run any package scripts.  Since scripts aren't run
52 and no files are changed, this can only detect and report some
53 types of errors.
54 .TP
55 \-L
56 Don't check for library dependencies, passed on to zpm-search.
57 .TP
58 \-A
59 run zpm-syncfs in accept mode
60 .TP
61 \-O
62 run zpm-syncfs in overwrite mode mode
63 .TP
64 \-U
65 Treat unmarked packages as packages to be uninstalled.
66 .SH EXAMPLES
67 .TP
68 zpm update vim
69 Install or update the vim package to the latest package found.
70 .TP
71 zpm update -- -vim
72 Uninstall the vim package if it installed.  The '--' is necessary
73 to the system doesn't think you are passing a -v option to zpm update.
74 .TP
75 zpm update -U vim
76 Uninstall the vim package if it installed.
77 .TP
78 zpm update ed -vim
79 Install or update ed to the latest version available, and remove
80 the vim package.
81 .SH EXIT STATUS
82 0 on success non zero on failure
83 .SH FILES
84 /var/lib/zpm/local.db
85 .SH ENVIRONMENT
86 ZPMDB
87 .SH AUTHOR
88 Nathan Wagner
89 .SH SEE ALSO
90 .BR zpm (8)
91 .BR zpm-search (8)
92 .BR zpm-script (8)
93 .BR zpm-repo (8)
94 .BR zpm-syncfs (8)