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

   1 .TH zpm-findpkg 8 2019-02-22 "ZPM 0.3"
   2 .SH NAME
   3 zpm-findpkg \- find package ids
   4 .SH SYNOPSIS
   5 .B zpm findpkg
   6 [
   7 .BI \-f " pkgfile"
   8 ]
   9 [
  10 .B \-Imre
  11 ]
  12 [
  13 .BI \-s status
  14 ]
  15 [
  16 .BI \-S status
  17 ]
  18 .I package
  19 [
  20 .I package
  21 ]
  22 .SH DESCRIPTION
  23 \fBzpm-findpkg\fR
  24 finds packages in package databases.  A package may be specified as
  25 an incomplete package id.  If found, the full package id will
  26 be printed to stdout.  Where more than one package matches,
  27 the latest one (as if by zpm-vercmp) will be found.
  28 .PP
  29 If two arguments are given, they form an inclusive range of packages.
  30 Either may be a partial package id, but both must have the same
  31 package name.
  32 .SH OPTIONS
  33 .TP
  34 .BI \-f package
  35 specify the package file to find packages in
  36 .TP
  37 .B \-I
  38 Only find installed packages.  Equivalent to \fB\-s installed\fR.
  39 .TP
  40 .B \-m
  41 This reverses the sense of the arguments.  The first argument is
  42 taken as the maximum package version to find.  A second argument,
  43 if given, is taken as the minimum.  Implies \-r.
  44 .TP
  45 .B \-r
  46 Find package within a range, rather than an exact match.  The
  47 first package argument is the inclusive lower bound.  The second
  48 argument, if provides, is the inclusive upper bound.  If no
  49 second argument is given, there is no upper bound.
  50 This option is implied if two arguments are given.
  51 .TP
  52 .B \-l
  53 Find the earliest package in a range, as if compared by zpm-vercmp.
  54 Implies \-r.
  55 .TP
  56 .BI \-s status
  57 Add \fIstatus\fR to the set of package statuses to match.  If the
  58 list is empty, any status will match.
  59 .TP
  60 .BI \-S status
  61 Add \fIstatus\fR to the set of package statuses to exclude from
  62 matching.  If a given status is listed both in include and exclude,
  63 the package status will be excluded.
  64 .SH EXAMPLES
  65 .TP
  66 .B zpm findpkg foo
  67 find the latest version of foo in the default database.
  68 .SH EXIT STATUS
  69 0 on success non zero on failure
  70 .SH FILES
  71 /var/lib/zpm/local.db
  72 .SH ENVIRONMENT
  73 ZPMDB
  74 .SH AUTHOR
  75 Nathan Wagner
  76 .SH SEE ALSO
  77 .BR zpm (8)
  78 .BR zpm-vercmp (8)