]> pd.if.org Git - zpackage/blob - doc/zpm-pathmod.8
fix rmpackage quoting
[zpackage] / doc / zpm-pathmod.8
1 .TH zpm-contents 8 2018-12-08 "ZPM 0.3"
2 .SH NAME
3 zpm-pathmod \- modify package file metadata
4 .SH SYNOPSIS
5 .B zpm pathmod
6 [
7 .BI -f " pkgfile"
8 ]
9 [
10 .B -g
11 ]
12 [
13 .I path action \fR...
14 ]
15 [
16 .BI \fB:\fIpkgid
17 ]
18 .SH DESCRIPTION
19 \fBzpm-pathmod\fR modifies package file metadata taking the specified
20 action on each path.  An action can be \fBdelete\fR which will
21 delete the path from the package, \fIfield\fB=\fIvalue\fR which
22 sets the value of the given field, or \fIfield\fR which will
23 print the value of the given field.
24 .PP
25 The package being modified can be changed by prefixing an argument
26 with ':', and the path being modified can be changed by prefixing
27 and argument with a '+'.
28 .PP
29 Everything happens in a single transaction, so either all of
30 the changes specified will take place, or none of them will.
31 The actions will fail if a non-existent field is given.
32 .SH OPTIONS
33 .TP
34 \-g
35 take file paths as glob patterns
36 .SH EXAMPLES
37 .TP
38 zpm pathmod foo /var/lib/foo delete
39 delete the /var/lib/foo file from the foo package
40 .TP
41 zpm pathmod foo /var/lib/foo mode=2755
42 set the mode of /var/lib/foo to 2755
43 .TP
44 zpm pathmod foo /var/lib/foo username
45 print the username of the owner of the /var/lib/foo file
46 .SH EXIT STATUS
47 0 on success non zero on failure
48 .SH FILES
49 /var/lib/zpm/local.db
50 .SH ENVIRONMENT
51 ZPMDB
52 .SH AUTHOR
53 Nathan Wagner
54 .SH SEE ALSO
55 zpm(8)