sboconfigPermalink

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


NAMEPermalink

sboconfig - set sbotools configuration options

SYNOPSISPermalink

sboconfig [-h|-v]

sboconfig [-l|-n]

sboconfig [--reset]

sboconfig [-CKPORScbdegw TRUE|FALSE] [-j #|FALSE] [-Lpo /path\|FALSE] \
          [-s /path|/usr/sbo] [-B branch_name|FALSE] [-V #.#|FALSE] \
          [-r url|FALSE]

DESCRIPTIONPermalink

sboconfig is a front-end for managing sbotools configuration options. Using sboconfig without any flags starts an interactive menu to specify settings; all options are accompanied by an explanatory message, and no changes are applied without user confirmation.

The sbotools.conf(5) file can also be manually edited; any fields not relevant to sbotools configuration are ignored. 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.

Non-root users can only call sboconfig with the --list, --non-default, --help and --version flags.

OPTIONSPermalink

-l|--list

List the current configuration options, including unmodified defaults. --list also shows the sboconfig flag used to set each option for reference. The --list flag can be used without root privileges.

--non-default

List current non-default configuration options. --non-default also shows the sboconfig flag used to set each option for reference. The --non-default flag can be used without root privileges.

--reset

Restore the default configuration to /etc/sbotools/sbotools.conf.

-B|--branch (FALSE|branch_name)

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

-b|--build-ignore (FALSE|TRUE)

BUILD_IGNORE: If TRUE, do not perform upgrades unless the version number differs. By default, upgrades also occur when the build number differs.

-C|--classic (FALSE|TRUE)

CLASSIC: If TRUE, automatically enable RSYNC_DEFAULTand BUILD_IGNORE, and disable COLOR (overriding the contents of sbotools.conf(5)). 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.

-c|--noclean (FALSE|TRUE)

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

-d|--distclean (FALSE|TRUE)

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

-e|--etc-profile (FALSE|TRUE)

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

-g|--gpg-verify (FALSE|TRUE)

GPG_VERIFY: 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. Only rsync repositories can be verified on Slackware 14.0 and Slackware 14.1.

-j|--jobs (FALSE|#)

JOBS: If numerical, pass to the -j argument when a SlackBuild invoking make is run.

-K|--nocolor (FALSE|TRUE)

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

-L|--log-dir (FALSE|/path)

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

-O|--obsolete-check (FALSE|TRUE)

OBSOLETE_CHECK: If TRUE, download an updated copy of the obsolete script list to /etc/sbotools/obsolete from the sbotools home page at https://pghvlaans.github.io/sbotools when running sbocheck(1) in Slackware -current.

-P|--cpan-ignore (FALSE|TRUE)

CPAN_IGNORE: If TRUE, install scripts even if they are already installed from the CPAN.

-p|--pkg-dir (FALSE|/path)

PKG_DIR: If set to a path, packages are stored there after installation. This overrides the DISTCLEAN setting for saved packages.

-s|--sbo-home (/usr/sbo|/path)

SBO_HOME: 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 if the SBO_HOME setting changes.

-o|--local-overrides (FALSE|/path)

LOCAL_OVERRIDES: 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). README, slack-desc, an info file and a SlackBuild must all be present.

-V|--slackware-version (FALSE|#.#)

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

-r|--repo (FALSE|url)

REPO: 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 for Slackware versions prior to 14.2, 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.

-R|--rsync (FALSE|TRUE)

RSYNC_DEFAULT: If set to TRUE, use rsync default mirrors except for Slackware -current.

-S|--strict-upgrades (FALSE|TRUE)

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

-w|--nowrap (FALSE|TRUE)

NOWRAP: If set to TRUE, do not wrap sbotools output.

SBOTESTPermalink

sboconfig is called when running sbotest config; the following default values change in this situation:

-A|--sbo-archive

Defaults to /usr/sbotest/archive. This setting is specific to sbotest.

-e|--etc-profile

Defaults to TRUE.

-L|--log-dir

Defaults to /usr/sbotest/logs.

-P|--cpan-ignore

Defaults to TRUE.

-p|--pkg-dir

Defaults to /usr/sbotest/tests.

-s|--sbo-home

Defaults to /usr/sbotest.

-h|--help

Show help information.

-v|--version

Show version information.

EXIT CODESPermalink

sboconfig can exit with the following codes:

0: all operations were successful.
1: a usage error occurred (e.g. passing invalid option specifications)
2: a script or module error occurred.
6: a required file handle could not be obtained.
16: reading keyboard input failed.

BUGSPermalink

None known. If found, Issues and Pull Requests to https://github.com/pghvlaans/sbotools/ are always welcome.

SEE ALSOPermalink

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

AUTHORSPermalink

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

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

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

MAINTAINERPermalink

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