pd.if.org Git - zpackage/blob - 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)