sbofind(1)

NAME

sbofind - search the local copy of the SlackBuilds.org tree for a given name or names

SYNOPSIS

sbofind [-h|-v]

sbofind [-AEFRTeiqrt] [-d] search_term (search_term)

sbofind [-AEFRTeiqrt] [-M] search_term (search_term)

sbofind [--color|--nocolor] [--wrap|--nowrap] ...

sbofind [--raw] ...

DESCRIPTION

sbofind searches the names of all available SlackBuilds for one or more search terms. It reports any SlackBuilds found along with path, version, maintainer, installation status information and a short description. Use the --descriptions option to search descriptions as well. If the repository includes a TAGS.txt file, these tags are searched to generate additional results.

SlackBuilds that have been designated as orphaned upstream are subject to future removal; orphaned builds are marked with a warning to that effect.

sbofind issues a warning if the directory specified with LOCAL_OVERRIDES does not exist (see sboconfig(1) or sbotools.conf(5)). If an invalid configuration is detected in /etc/sbotools/sbotools.conf, the script exits with a diagnostic message.

OPTIONS

-A|--all-reverse
    Show all reverse dependencies in the repository for each SlackBuild found.

-d|--descriptions
    Search for SlackBuilds by short description in addition to name and tag. Incompatible with --maintainers.

-E|--exact-case
    Exact matching only (case-sensitive).

-e|--exact
    Exact matching only (case-insensitive).

-F|--first-reverse
    Show all first-level reverse dependencies in the repository for each SlackBuild found.

-M|--maintainers
    Search for SlackBuilds by maintainer. Incompatible with --descriptions.

-t|--no-tags
    Exclude tags from the search.

-i|--info
    Show the contents of the info file for each SlackBuild found.

-q|--queue
    Show the build queue for each SlackBuild found given the contents of /etc/sbotools/sbotools.hints.

-R|--reverse
    Show any reverse dependencies installed on the system. Please note that optional dependencies must be specified in sbotools.hints(5) to be included. Packages with tags other than _SBo are not included.

-r|--readme
    Show the contents of the README file for each SlackBuild found.

-T|--top-reverse
    Show the top-level reverse dependencies, installed or not, for one or more scripts.

--raw
    Print a space-delineated list of matches in alphabetical order without a newline. All options not related to search results, such as --exact, are effectively ignored.

-h|--help
    Show help information.

-v|--version
    Show version information.

--color
    Turn on sbotools color output (default). See also sbotools.colors(5).

--nocolor
    Turn off sbotools color output.

--wrap
    Turn on sbotools word wrapping (default).

--nowrap
    Turn off sbotools word wrapping.

SBOTEST
sbofind is called when running sbotest find; flags are unchanged. Scripts with an up-to-date package in the archive are indicated.

EXIT CODES

sbofind can exit with the following codes:
    0: all operations were succesful.
    1: a usage error occured (e.g., incorrect options were passed to sbofind).
    2: a script or module error occurred.
    6: a required handle could not be obtained.
    13: circular dependencies detected.
    16: reading keyboard input failed.

BUGS

None known. If found, Issues and Pull Requests to https://github.com/pghvlaans/sbotools/ are always welcome.

SEE ALSO

sbocheck(1), sboclean(1), sboconfig(1), sbocutleaves(1), sbohints(1), sboinstall(1), sboremove(1), sbotool(1), sboupgrade(1), sbotools.colors(5), sbotools.conf(5), sbotools.hints(5)

AUTHORS

Jacob Pipkin <jacob.pipkin@icloud.com>

Luke Williams <xocel@iquidus.org>

Andreas Guldstrand <andreas.guldstrand@gmail.com>

MAINTAINER

K. Eugene Carlson <kvngncrlsn@gmail.com>