OpenPKG Specs: openpkg/search.pod@a2c6460cfb16

Correct socket error reporting improvement with IPv6 portable code,
after helpful recommendation by Saúl Ibarra Corretgé on OSips devlist.

     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 ##

    24 =pod

    26 =head1 NAME

    28 B<openpkg search> - B<OpenPKG> Package Searching

    30 =head1 SYNOPSIS

    32 B<openpkg>

    33 B<search>

    34 [B<-r> I<resource>]

    35 [B<-v>]

    36 I<regex> ...

    38 =head1 DESCRIPTION

    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.

    45 =head1 OPTIONS

    47 The following command line options exist:

    49 =over 4

    51 =item B<-r> I<repository>

    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.

    61 =item B<-v>

    63 Produces itemized verbose output instead of the default brief tabular

    64 output.

    66 =back

    68 =head1 SEE ALSO

    70 index(8), build(8).

    72 =head1 HISTORY

    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>.

    78 =head1 AUTHORS

    80  Ralf S. Engelschall

    81  rse@engelschall.com

    83 =cut

OpenPKG Specs / file revision