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

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