# sbofind

[NAME](#name)\
[SYNOPSIS](#synopsis)\
[DESCRIPTION](#description)\
[OPTIONS](#options)\
[SBOTEST](#sbotest)\
[EXIT CODES](#exit-codes)\
[BUGS](#bugs)\
[SEE ALSO](#see-also)\
[AUTHORS](#authors)\
[MAINTAINER](#maintainer)

------------------------------------------------------------------------

## 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)](sboconfig.1.md) or
[sbotools.conf(5)](sbotools.conf.5.md)). 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)](sbotools.hints.5.md) 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)](sbotools.colors.5.md).

**\--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)](sbocheck.1.md), [sboclean(1)](sboclean.1.md), [sboconfig(1)](sboconfig.1.md), [sbocutleaves(1)](sbocutleaves.1.md), [sbohints(1)](sbohints.1.md),
[sboinstall(1)](sboinstall.1.md), [sboremove(1)](sboremove.1.md), [sbotool(1)](sbotool.1.md), [sboupgrade(1)](sboupgrade.1.md),
[sbotools.colors(5)](sbotools.colors.5.md), [sbotools.conf(5)](sbotools.conf.5.md), [sbotools.hints(5)](sbotools.hints.5.md)

## AUTHORS

Jacob Pipkin \<jacob.pipkin (at) icloud (dot) com\>

Luke Williams \<xocel (at) iquidus (dot) org\>

Andreas Guldstrand \<andreas (dot) guldstrand (at) gmail (dot) com\>

## MAINTAINER

K. Eugene Carlson \<kvngncrlsn (at) gmail (dot) com\>

------------------------------------------------------------------------
