manpage

esearch(1)                                                          esearch(1)



NAME
       esearch - replacement for 'emerge search' with search-index


SYNOPSIS
       esearch [ options ] 


DESCRIPTION
       esearch  is  a  small script which behaves exactly like emerge -s resp.
       emerge -S. The advantage of esearch over emerge is the search index  it
       uses. It is a lot faster than emerge -s/-S.


OPTIONS
       --help, -h
              Print help message

       --searchdesc, -S
              Search package descriptions as well

       --fullname, -F
              Search packages full name (includes category)

       --instonly, -I
              Find only packages which are installed

       --compact, -c
              More compact output format

       --verbose, -v
              Give a lot of additional information (slow!)

       --ebuild, -e
              View ebuilds of found packages

       --own=format, -o format
              Use user-defined output format, format is a string with may con-
              tain special characters, see FORMAT section for details

       --directory=dir, -d dir
              Use dir to store esearch index

       --nocolor, -n
              Don't use ANSI codes for colored output


FORMAT
       %c     category

       %n     package name

       %p     same as "%c/%n"

       %m     "masked" if package is masked, otherwise ""

       %va    latest version available

       %vi    latest version installed, or ""

       %s     size of downloaded files

       %h     Homepage

       %d     Description

       %l     License


EXAMPLES
       esearch -o "/usr/portage/%p/ChangeLog\n" ^package$
              Print the correct path to the ChangeLog file of 'package'.

       esearch -o "%n-%va.ebuild\n" pattern
              Print the names of the current ebuild files.

       esearch -o "%p\n" ^ > package-list
              Generate a list of all available packages.


SEE ALSO
       eupdatedb(1), esync(1), emerge(1)


BUGS
       No known bugs


AUTHOR
       David Peter 



esearch                          July 08, 2004                      esearch(1)