pd.if.org Git - zpackage/blob - doc/zpm-rmpackage.8

   1 .TH zpm-rmpackage 8 2019-02-28 "ZPM 0.3"
   2 .SH NAME
   3 zpm-rmpackage \- remove packages from a database
   4 .SH SYNOPSIS
   5 .B zpm rmpackage
   6 [
   7 .BI -f " pkgfile"
   8 ]
   9 [
  10 .BI -m " message"
  11 ]
  12 [
  13 .BI -s " status"
  14 ]
  15 [
  16 .BI -S " status"
  17 ]
  18 [
  19 .B -v
  20 ]
  21 .RI [ package ...]
  22 .SH DESCRIPTION
  23 \fBzpm-rmpackage\fR
  24 removes packages from a zpm database and logs a message.  This is
  25 potentially dangerous.  No checking as to the status of the
  26 package is made, so it is possible to remove a package from the
  27 database even if it is installed.  This program is intended to
  28 be run from garbage collection utilities or by package maintainers
  29 rather than as a normal part of system administration.
  30 .PP
  31 Packages to be removed are given as package id arguments, which
  32 may be abbreviated, and will be looked up via
  33 .BR zpm-findpkg (8).
  34 If a package is not found, it is not an error.  A message will
  35 be printed to stderr in this case if the -v option is given.
  36 .PP
  37 A log message will be entered into the zpm log for each package removed with an
  38 action of 'rmpackage'.
  39 An optional message to put in the log can be given with the -m option.
  40 .SH OPTIONS
  41 .TP
  42 .BI \-f path
  43 specify the package file to find packages in
  44 .TP
  45 .BI \-m message
  46 specify a message for each log message.
  47 .TP
  48 .BI \-s status
  49 Require that packages listed have the given status.  This is primarily
  50 a safety feature so that you don't accidentally remove installed packages
  51 from the database.
  52 Passed through to zpm-findpkg and may be given more than once.
  53 .TP
  54 .BI \-S status
  55 Require that packages not have the given status.  Useful for excluding
  56 installed packages without specifying other statuses explicitly.
  57 Passed through to zpm-findpkg and may be given more than once.
  58 .TP
  59 .B \-v
  60 Verbose mode.
  61 .SH EXAMPLES
  62 .TP
  63 .B zpm rmpackage foo
  64 Removes a foo package as found with zpm-findpkg from the default database.
  65 .SH EXIT STATUS
  66 0 on success non zero on failure
  67 .SH FILES
  68 /var/lib/zpm/local.db
  69 .SH ENVIRONMENT
  70 ZPMDB
  71 ZPM_PACKAGEFILE
  72 .SH AUTHOR
  73 Nathan Wagner
  74 .SH SEE ALSO
  75 .BR zpm (8)
  76 .BR zpm-findpkg (8)
  77 .BR zpm-log (8)