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

   1 .TH zpm-pathmod 8 2019-02-20 "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)