| |
1 ## |
| |
2 ## search.pod -- OpenPKG Package Searching |
| |
3 ## Copyright (c) 2000-2012 OpenPKG GmbH <http://openpkg.com/> |
| |
4 ## |
| |
5 ## This software is property of the OpenPKG GmbH, DE MUC HRB 160208. |
| |
6 ## All rights reserved. Licenses which grant limited permission to use, |
| |
7 ## copy, modify and distribute this software are available from the |
| |
8 ## OpenPKG GmbH. |
| |
9 ## |
| |
10 ## THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED |
| |
11 ## WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF |
| |
12 ## MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. |
| |
13 ## IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR |
| |
14 ## CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| |
15 ## SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| |
16 ## LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF |
| |
17 ## USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND |
| |
18 ## ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, |
| |
19 ## OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT |
| |
20 ## OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
| |
21 ## SUCH DAMAGE. |
| |
22 ## |
| |
23 |
| |
24 =pod |
| |
25 |
| |
26 =head1 NAME |
| |
27 |
| |
28 B<openpkg search> - B<OpenPKG> Package Searching |
| |
29 |
| |
30 =head1 SYNOPSIS |
| |
31 |
| |
32 B<openpkg> |
| |
33 B<search> |
| |
34 [B<-r> I<resource>] |
| |
35 [B<-v>] |
| |
36 I<regex> ... |
| |
37 |
| |
38 =head1 DESCRIPTION |
| |
39 |
| |
40 The B<openpkg search> tool is a frontend for searching indexed RPM |
| |
41 packages. It downloads XML/RDF based resource index files from an RPM |
| |
42 package repository and does a regular expression based search on each |
| |
43 package's name, summary and description texts. |
| |
44 |
| |
45 =head1 OPTIONS |
| |
46 |
| |
47 The following command line options exist: |
| |
48 |
| |
49 =over 4 |
| |
50 |
| |
51 =item B<-r> I<repository> |
| |
52 |
| |
53 Specify the path to an OpenPKG RPM package repository. |
| |
54 This can be a URL (including "file://") to download packages from or |
| |
55 an absolute directory path (identified by leading "/") or |
| |
56 a relative directory path (identified by leading "./") to access packages directly. |
| |
57 The name of the package file is appended to this path. |
| |
58 The default is to use a URL pointing to the B<OpenPKG> download service |
| |
59 as determined by the "B<openpkg release>" command. |
| |
60 |
| |
61 =item B<-v> |
| |
62 |
| |
63 Produces itemized verbose output instead of the default brief tabular |
| |
64 output. |
| |
65 |
| |
66 =back |
| |
67 |
| |
68 =head1 SEE ALSO |
| |
69 |
| |
70 index(8), build(8). |
| |
71 |
| |
72 =head1 HISTORY |
| |
73 |
| |
74 The B<openpkg search> command was invented in May 2012 by I<Ralf S. |
| |
75 Engelschall> E<lt>rse@engelschall.comE<gt> for use inside the B<OpenPKG> |
| |
76 project E<lt>http://www.openpkg.org/E<gt>. |
| |
77 |
| |
78 =head1 AUTHORS |
| |
79 |
| |
80 Ralf S. Engelschall |
| |
81 rse@engelschall.com |
| |
82 |
| |
83 =cut |
| |
84 |