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 -LAOUnzvpSC
  11 ]
  12                 d) localdb="$OPTARG" ;;
  13                 P) packagepath="$OPTARG" ;;
  14                 D) packagepath="$OPTARG:$packagepath" ;;
  15                 R) rootdir="$OPTARG" ;;
  16
  17                 b) backup=1 ;;
  18                 B) backup=0 ;;
  19                 l) justlist=1 ;;
  20 .RI [ \fB[+|-]\fIpackage ...]
  21 .SH DESCRIPTION
  22 \fBzpm-update\fR changes the set of installed packages.
  23 It can install, remove, or update a set of packages as given on the command
  24 line.  It will search defined repositories for packages, and download, merge,
  25 and prepare the packages and the local database.  By itself, zpm-update just
  26 prepares the system for the file operations and runs package scripts.  Actual
  27 filesystem actions (i.e. removing or installing of files in the file system)
  28 is delegated to zpm-syncfs.
  29 .PP
  30 Packages may be specified by a full package id triple, or any
  31 shortened version of one (i.e. a package may be given by name, name
  32 and version, or name, version, and release).
  33 .PP
  34 Packages may have an optional '+' or '-' prefix.  Packages
  35 marked with '+' are set to be installed, or updated if a package
  36 with the same name is already installed.  Packages marked with
  37 a '-' are set to be uninstalled if they are installed.
  38 By default, unmarked packages are treated as marked with a '+'.
  39 The default can be changed to uninstall with the \fB-U\fR option.
  40 .PP
  41 Once the set of packages to installed or uninstalled is determined and set up,
  42 zpm-syncfs is called to do the actual file operations.  This is an
  43 "all-at-once" action in the sense that the whole set of file actions is
  44 considered and no concern is given to which specific package a file belongs to.
  45 In other words, all of the packages given are updated, removed, installed at
  46 the same time, rather than taking each package one at a time and installing,
  47 updating, or removing it.  If the admin wants to do the packages one at a time,
  48 zpm-update can be run multiple times.
  49 .SS Package Search
  50 Packages will be searched for in *.repo files, the local database, and
  51 in individual zpm package files.  These are looked for by default
  52 in /var/lib/zpm/*.repo /var/lib/zpm/packages/*.zpm and the usual
  53 location for the local database.
  54 .SH OPTIONS
  55 .TP
  56 \-f
  57 specify the package file to find packages in
  58 .TP
  59 \-n
  60 perform a dry run.  This option calls zpm-syncfs in dry-run mode,
  61 and doesn't run any package scripts.  Since scripts aren't run
  62 and no files are changed, this can only detect and report some
  63 types of errors.
  64 .TP
  65 \-R \fIrootdir\fR
  66 Specify a root directory for the package installs.  Files will be
  67 installed relative to this directory.
  68 .TP
  69 \-S
  70 Don't run any package pre or post scripts.  Normally zpm-update will run
  71 package pre and post scripts associated with packages being removed, updated,
  72 or installed.  See zpm-script(8) for details.  If any scripts are skipped due
  73 to the option, a note will be added.
  74 .TP
  75 \-C
  76 Don't run package configure scripts.  Any skipped scripts will have a note
  77 added.
  78 .TP
  79 \-v
  80 Run syncfs in verbose mode.  This flag is passed on to zpm-syncfs.
  81 .TP
  82 \-p
  83 Passed to zpm-syncfs to control the type of progress meter.
  84 .TP
  85 \-z
  86 Don't pull remote repositories before searching for packages, by
  87 default all remote repos are refreshed with repo pull before
  88 commencing a search for new packages.
  89 .TP
  90 \-L
  91 Don't check for library dependencies, passed on to zpm-search.
  92 .TP
  93 \-A
  94 run zpm-syncfs in accept mode
  95 .TP
  96 \-O
  97 run zpm-syncfs in overwrite mode mode
  98 .TP
  99 \-U
 100 Treat unmarked packages as packages to be uninstalled.
 101 .SH EXAMPLES
 102 .TP
 103 zpm update vim
 104 Install or update the vim package to the latest package found.
 105 .TP
 106 zpm update -- -vim
 107 Uninstall the vim package if it installed.  The '--' is necessary
 108 to the system doesn't think you are passing a -v option to zpm update.
 109 .TP
 110 zpm update -U vim
 111 Uninstall the vim package if it installed.
 112 .TP
 113 zpm update ed -vim
 114 Install or update ed to the latest version available, and remove
 115 the vim package.
 116 .SH EXIT STATUS
 117 0 on success non zero on failure
 118 .SH FILES
 119 /var/lib/zpm/local.db
 120 .SH ENVIRONMENT
 121 ZPMDB ZPM_ROOT_DIR
 122 .SH AUTHOR
 123 Nathan Wagner
 124 .SH SEE ALSO
 125 .BR zpm (8)
 126 .BR zpm-search (8)
 127 .BR zpm-script (8)
 128 .BR zpm-repo (8)
 129 .BR zpm-syncfs (8)