]> pd.if.org Git - zpackage/blob - doc/zpm-search.8
ocb mode fixup
[zpackage] / 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)