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

   1 .TH zpm-search 8 2019-02-16 "ZPM 0.5"
   2 .SH NAME
   3 zpm-search \- search repositories for packages
   4 .SH SYNOPSIS
   5 .B zpm search
   6 [
   7 .B -ljqiIOfPRDMvn
   8 ]
   9 [
  10 .BI -d " localdb"
  11 ]
  12 [
  13 .BI -p " packagedir"
  14 ]
  15 [
  16 .BI -r " repodir"
  17 ]
  18 .RI [ package ...]
  19 .SH DESCRIPTION
  20 \fBzpm-search\fR
  21 searches for packages in repositories, the local database, and
  22 a directory of package files.  Packages needed for library
  23 dependencies will be recursively searched for.
  24 .SH OPTIONS
  25 .TP
  26 .BI \-d localdb
  27 Specify the local database, if other than the default local database.
  28 .TP
  29 .BI \-p packagedir
  30 Specify a directory to search for packages in.  Defaults to
  31 /var/lib/zpm/packages
  32 .TP
  33 .BI \-r repodir
  34 Specify the directory to find repository information in.  Defaults
  35 to /var/lib/zpm/repo
  36 .TP
  37 .B \-i
  38 Match against installed packages.  Normally, packages are searched
  39 for against the local database, but the output omits packages that
  40 are already installed.  This option adds found but installed packages
  41 to the output.
  42 .TP
  43 .B \-l
  44 In addition to finding packages, also find packages supplying libraries
  45 needed by found packages.
  46 .TP
  47 .B \-I
  48 Suppress installed.
  49 .TP
  50 .B \-O
  51 Only local installed.
  52 .TP
  53 .B \-j
  54 Output results in json format.  You will get a list with the \-n option,
  55 or an object of package id to location without the \-n option.  A list
  56 of object is always output, even if empty.
  57 .TP
  58 .B \-f
  59 Only output found packages.  Normally it is an error if a package
  60 can't be found.  This option makes that not an error, and suppresses
  61 printing unfound packages to stderr.
  62 .TP
  63 .B \-q
  64 Suppress output.  The exit status is the same as it would otherwise be.
  65 .TP
  66 .B \-v
  67 Increase verbosity.  May be given multiple times.
  68 .TP
  69 .B \-M
  70 Match all package files.  Normally when looking at files ending in .zpm,
  71 packages will only be searched for if the filename has the package id
  72 as a prefix.  This is an optimization to speed up the search.
  73 .TP
  74 .B \-P
  75 Don't look in the package directory.
  76 .TP
  77 .B \-R
  78 Don't search repositories.
  79 .TP
  80 .B \-D
  81 Don't search the local database.
  82 .TP
  83 .B \-n
  84 list package names only, not name and location found.
  85 .SH EXAMPLES
  86 .TP
  87 .B zpm search
  88 lists all files in the local database
  89 .SH EXIT STATUS
  90 0 on success non zero on failure
  91 .SH FILES
  92 /var/lib/zpm/local.db
  93 .SH ENVIRONMENT
  94 ZPMDB
  95 .SH AUTHOR
  96 Nathan Wagner
  97 .SH SEE ALSO
  98 .BR zpm (8)