sbofind

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SBOTEST
EXIT CODES
BUGS
SEE ALSO
AUTHORS
MAINTAINER

---

NAME

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

SYNOPSIS

sbofind [-h|-v]

sbofind [-AEFRTdeiqrt] 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 back any SlackBuilds found along with path, version, installation status information and a short description. Use the --descriptions option to search descriptions as well. This is akin to running

cd /usr/ports; make search name=$search_term display=name,path

on a FreeBSD system. If the repository includes a TAGS.txt file, these tags are searched to generate additional results.

Non-root users can call sbofind with any flags. 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.

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

-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. 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), sbohints(1), sboinstall(1), sboremove(1), sbotool(1), sboupgrade(1), sbotools.colors(5), sbotools.conf(5), sbotools.hints(5)

AUTHORS

Jacob Pipkin <j (at) dawnrazor (dot) net>

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>

---