sbotools.conf(5)

NAME

sbotools.conf - configuration file for sbotools commands

DESCRIPTION

/etc/sbotools/sbotools.conf contains KEY=VALUE configuration parameters, and is read by all sbotools commands.

If an invalid configuration is detected (or requested with sboconfig(1)), the script exits with a diagnostic message.

To quickly restore all default settings, run
    sboconfig --reset
To use a configuration directory other than /etc/sbotools, export an environment variable SBOTOOLS_CONF_DIR with an absolute path.

/root, /home, / and possible top-level directories under /home are not permitted as directory settings.

All values default to FALSE except for SBO_HOME. Recommended non-default settings include TRUE for:
    • COLOR • CPAN_IGNORE • ETC_PROFILE • GPG_VERIFY, provided the upstream repository is regularly signed with gpg(1). • SO_CHECK

The current configuration keys are as follows:

CLASSIC=(FALSE|TRUE)
    If TRUE, automatically enable RSYNC_DEFAULT and BUILD_IGNORE, and disable COLOR (overriding the contents of this file). Build increment and out-of-tree SlackBuild checks by sbocheck(1) are disabled, and previously-used build options are not displayed. This provides a more traditional sbotools look and feel for those who want it.

CPAN_IGNORE=(FALSE|TRUE)
    If TRUE, install scripts even if they are already installed from the CPAN.

    Recommended value: TRUE

DIALOGRC=(FALSE|/path)
    If set to an absolute path, use that file as dialogrc when running sbotool(1).

DISTCLEAN=(FALSE|TRUE)
    If TRUE, remove the package and source archives after building. Source archives are otherwise retained in md5sum-designated directories under /usr/sbo/distfiles (with SBO_HOME=/usr/sbo) by default. If PKG_DIR is set, package archives are saved there regardless of DISTCLEAN.

GPG_VERIFY=(FALSE|TRUE)
    If TRUE, use gpg(1) to verify the contents of the local repository (and, if applicable, /etc/sbotools/obsolete) when running sbocheck(1), sboinstall(1) and sboupgrade(1). Missing public keys are detected, and a download from keyserver.ubuntu.com on port 80 is offered if available.

    Recommended value: TRUE if the upstream repository is usually signed.

JOBS=(FALSE|#)
    If numerical, pass to the -j argument when a SlackBuild invoking make is run.

NOCLEAN=(FALSE|TRUE)
    If TRUE, do not clean working directories after building. These are the build and package-(sbo) directories under /tmp/SBo (or $TMP).

COLOR=(FALSE|TRUE)
    If TRUE, enable sbotools color output. To customize color output, edit the /etc/sbotools/sbotools.colors file directly. See sbotools.colors(5) for more details.

    Recommended value: TRUE

GIT_BRANCH=(FALSE|branch_name)
    If FALSE, use the default git branch for the Slackware version, if any. If branch_name, attempt to change branches to branch_name when using sbocheck(1) with an upstream git repository.

BUILD_IGNORE=(FALSE|TRUE)
    If TRUE, do not perform upgrades unless the version number differs. By default, upgrades also occur when the build number differs.

ETC_PROFILE=(FALSE|TRUE)
    If TRUE, source any executable scripts in /etc/profile.d named *.sh before running each SlackBuild in the build queue.

    Recommended value: TRUE

LOG_DIR=(FALSE|/path)
    If set to an absolute path, save build logs here. Logs are saved with the name of the script and a timestamp. Please note that because STDERR must be redirected for a complete log, colors and formatting may differ when running some SlackBuilds unless LOG_DIR is FALSE.

NONET=(FALSE|TRUE)
    If set to TRUE, do not allow network access when running SlackBuilds.

OBSOLETE_CHECK=(FALSE|TRUE)
    If TRUE, download updated copies of the obsolete script list and the perl version history file to /etc/sbotools/obsolete and /etc/sbotools/perl_vers, respectively, from the sbotools home page at https://pghvlaans.github.io/sbotools when running sbocheck(1) in Slackware -current.

PKG_DIR=(FALSE|/path)
    If set to a path, packages are stored there after installation. This overrides the DISTCLEAN setting for saved packages.

SBO_HOME=(/usr/sbo|/path)
    If set to a path, this is where the SlackBuilds.org tree is stored. The default setting is /usr/sbo. The tree must be re-downloaded with sbocheck(1) if the SBO_HOME setting changes.

LOCAL_OVERRIDES=(FALSE|/path)
    If set to a path, any directory name in the top level under that path matching a SlackBuild name is used in preference to the in-tree version. This works even if the SlackBuild is out-of-tree. Scripts installing packages not marked with the _SBo tag are neither upgradeable with sboupgrade(1) nor removable with sboremove(1). slack-desc, an info file and a SlackBuild must all be present.

SLACKWARE_VERSION=(FALSE|#.#)
    If set to a version number, use the SlackBuilds.org repository for that version of Slackware rather than the one specified in /etc/slackware-version.

SO_CHECK=(FALSE|TRUE)
    If set to TRUE, check for missing first-order shared object (solib) dependencies among _SBo packages when running sbocheck(1) and sboupgrade(1). Additionally, sbocheck(1) searches for incompatible perl, python and ruby _SBo packages.

    Recommended value: TRUE

REPO=(FALSE|url|/path)
    If set to a git or rsync URL, use that repository instead of the sbotools default for your SLACKWARE_VERSION. The default repositories are under rsync://slackbuilds.org/slackbuilds if RSYNC_DEFAULT is TRUE, and https://gitlab.com/SlackBuilds.org otherwise. The repository must be laid out in the same manner as one found at https://git.slackbuilds.org/slackbuilds such that SlackBuild directories are under the category directories.

RSYNC_DEFAULT=(FALSE|TRUE)
    If set to TRUE, use rsync default mirrors except for Slackware -current.

STRICT_UPGRADES=(FALSE|TRUE)
    If set to TRUE, upgrades are only attempted if the incoming version or build number is greater. This has no effect on scripts in the local overrides directory.

NOWRAP=(FALSE|TRUE)
    If set to TRUE, do not wrap sbotools output.

SEE ALSO

sbocheck(1), sboclean(1), sboconfig(1), sbofind(1), sbohints(1), sboinstall(1), sboremove(1), sbotool(1), sboupgrade(1), sbotool(1), sbotools.colors(5), sbotools.hints(5), dialog(1), gpg(1)

AUTHORS

Jacob Pipkin <j@dawnrazor.net>

Luke Williams <xocel@iquidus.org>

Andreas Guldstrand <andreas.guldstrand@gmail.com>

MAINTAINER

K. Eugene Carlson <kvngncrlsn@gmail.com>