sbotools

NAME
DESCRIPTION
STARTUP
BUGS
SEE ALSO
AUTHORS
MAINTAINER


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 the blacklist and optional dependency requests.

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.

For details about all configuration options in sbotools.conf, see sbotools.conf(5). sbotools.hints(5) documents the /etc/sbotools/sbotools.hints file, which can be used to blacklist scripts and request optional dependencies.

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