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 .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)