]> pd.if.org Git - zpackage/blob - doc/zpm-rmpackage.8
add zpm-sign to package programs
[zpackage] / 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)