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>