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