sbotools(1)

NAME

sbotools - Perl scripts providing a ports-like interface to SlackBuilds.org

DESCRIPTION

sbotools is a set of Perl scripts that collectively provide a ports-like interface to SlackBuilds.org. Each tool is documented in its own man page.

sbocheck(1)
    Fetch the latest version of the upstream SlackBuilds repository. Check for version updates, build number changes and out-of-tree installed SlackBuilds with the _SBo tag.

sboclean(1)
    Remove cruft by cleaning source archives, build directories and saved build options.

sboconfig(1)
    A command line interface for changing /etc/sbotools/sbotools.conf.

sbofind(1)
    Search the local copy of the repository for SlackBuilds. Optionally, display build queues, README and info files and installed reverse dependencies.

sbohints(1)
    Query and modify script specific hints: blacklist, optional dependencies and reverse dependency rebuilds.

sboinstall(1)
    Install SlackBuilds with their dependencies. Handle compat32 packages and create or build from templates.

sboremove(1)
    Interactively remove installed SlackBuilds along with any unused dependencies.

sboupgrade(1)
    Upgrade previously-installed SlackBuilds.
By default, sboinstall(1) and sboupgrade(1) give prompts before adding items to the build queue. These scripts have a --batch flag available for non-interactive building with dependency resolution. Because --batch can install new dependencies without prompting, using it in a production environment without a well-maintained /etc/sbotools.hints file, or with unfamiliar scripts, can potentially lead to unwanted results. Consider passing --dry-run first, which prints the build queue with other information and exits. For details about all configuration options in sbotools.conf, see sbotools.conf(5). sbotools.hints(5) documents the /etc/sbotools/sbotools.hints file, which passes hints to sboinstall(1) and sboupgrade(1): blacklist, optional dependencies and automatic reverse dependency rebuilds.

STARTUP
When using sbotools for the first time, a copy of the SlackBuilds repository must be fetched with sbocheck(1):
    sbocheck
The local repository is saved to /usr/sbo/repo. To use an alternative location, give an absolute file path to the SBO_HOME setting with sboconfig(1) or by editing /etc/sbotools/sbotools.conf. The default mirror depends on the running version of Slackware. Stable releases beyond Slackware 14.1 use the appropriate branch on https://gitlab.com/SlackBuilds.org/slackbuilds/ and -current uses https://github.com/Ponce/slackbuilds/ with the current branch. Slackware 14.0 and 14.1 have default rsync mirrors. To use an rsync mirror with <rsync://slackbuilds.org/slackbuilds/*/> as the default, set RSYNC_DEFAULT to TRUE. The REPO setting overrides the default mirror with a git or rsync URL, and GIT_BRANCH sets a custom git branch. To update the local repository, run sbocheck(1). This generates a report with potential version upgrades, SlackBuilds with incremented build numbers and out-of-tree SlackBuilds installed with the _SBo tag. The simplest way to upgrade all eligible SlackBuilds is to run
    sboupgrade --all
Build number increments are ignored if BUILD_IGNORE is set to TRUE.

Using sboconfig(1) without flags enters an interactive settings menu. Each option is explained and no changes are made without verification. Using flags is faster, but new users may find this a helpful resource.

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

AUTHORS

Jacob Pipkin <j@dawnrazor.net>

Luke Williams <xocel@iquidus.org>

Andreas Guldstrand <andreas.guldstrand@gmail.com>

MAINTAINER

K. Eugene Carlson <kvngncrlsn@gmail.com>