sboinstall

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXIT CODES
BUGS
SEE ALSO
AUTHORS
MAINTAINER

NAME

sboinstall - install SlackBuilds

SYNOPSIS

sboinstall [-h|-v]

sboinstall [-d TRUE|FALSE] [-j #|FALSE] [-c TRUE|FALSE] \
           [-ipRr] [--create-template FILE] sbo_name (sbo_name)

sboinstall [-d TRUE|FALSE] [-j #|FALSE] [-c TRUE|FALSE] \
           [-i] --use-template FILE

sboinstall [-d TRUE|FALSE] [-j #|FALSE] [-c TRUE|FALSE] \
           [-iqr] [--create-template FILE] --mass-rebuild

DESCRIPTION

sboinstall is used to install SlackBuilds. If the -r flag is not specified, sboinstall pulls the list of requirements from the info file for any specified SlackBuild. This is a recursive operation over all dependencies. sboinstall offers to install any non-installed dependencies in the build queue, taking blacklisted scripts and optional dependency specifications in sbotools.hints(5) into account. If circular dependencies are detected, the script exits with an error message.

README files are parsed for groupadd and useradd commands, and sboinstall offers to run them prior to building. If the README is judged to document options in KEY=VALUE form, a prompt for setting options appears. Any build options, whether passed interactively or in a template, are saved to /var/log/sbotools when the SlackBuild runs.

Please note that saved build options are not displayed when CLASSIC is set to TRUE. See sboconfig(1) or sbotools.conf(5).

sboinstall attempts to download the sources from the DOWNLOAD or DOWNLOAD_x86_64 variables in the info file. If either the download or the md5sum check fails, a new download is attempted from ftp://slackware.uk/sbosrcarch/ as a fallback measure.

sboinstall verifies the local repository with gpg if GPG_VERIFY is TRUE. Only rsync repositories can be verified on Slackware 14.0 and Slackware 14.1.

Root privileges are required to run sboinstall. If an invalid configuration is detected in /etc/sbotools/sbotools.conf, the script exits with a diagnostic message.

OPTIONS

-h|--help

Show help information.

-v|--version

Show version information.

-c|--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). Cleaning these directories can be set as default via the sboconfig(1) command. See also sbotools.conf(5). This option overrides the default.

-d|--distclean (FALSE|TRUE)

If TRUE, then remove the source archives after building. They are retained in md5sum-designated directories under SBO_HOME/distfiles by default. The package archive (in /tmp by default) is also removed. This option can be set as default via the sboconfig(1) command. See also sbotools.conf(5). This option overrides the default.

-i|--noinstall

Do not install the package at the end of the build process. It is left in /tmp (or $OUTPUT) if DISTCLEAN is FALSE. Packages are retained in PKG_DIR if so defined regardless of DISTCLEAN. See sboconfig(1) and sbotools.conf(5).

-j|--jobs (FALSE|#)

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

-p|--compat32

Create a compat32 package on multilib x86_64 systems. This requires the compat32-tools package by Eric Hameleers. Please note that this operation is not necessarily foolproof, and is unsupported by anyone in principle. As a best practice, --compat32 should be combined with --noinstall and --distclean FALSE so that the contents of the package can be inspected prior to installation. GitHub Issues are welcome in case of unexpected failure.

-q|--reverse-rebuild

Rebuild the reverse dependencies for the requested SlackBuilds. The build queue also includes any missing dependencies for those scripts. If run with --nointeractive, any saved build options are used again. Incompatible with --compat32, --norequirements, --use-template and --mass-rebuild.

-r|--nointeractive

Bypass all user prompts for the requested SlackBuilds. Dependency resolution is bypassed as well except for --mass-rebuild and --reverse-rebuild. Unless it is obvious that dependency resolution and build options are not required, consider using a template instead.

If an operation with --nointeractive would install an in-tree _SBo package in place of a package without this tag, a warning message with a default “no” option appears.

-R|--norequirements

Bypass dependency resolution, but still show README and the user prompts before proceeding with the build.

--reinstall

Offer to reinstall all packages in the build queue.

--create-template (FILE)

Create a template for one or more SlackBuilds including any pre-build commands and build options and save to the specified FILE.

--use-template (FILE)

Build using the template saved to FILE. This disables all user prompts.

--mass-rebuild

Generate build queues, rebuild and reinstall all in-tree _SBo SlackBuilds except for compat32 builds. This is generally only useful when the Slackware version has been upgraded or (occasionally) on -current. Additional SlackBuilds may be installed when dependencies have been added. If dependencies are installed with tags other than _SBo, or with no tag, a warning message (default “no”) appears even with --nointeractive before they are added to the build queue.

In combination with --nointeractive, saved build options are reused automatically. Incompatible with --reverse-rebuild, --compat32, --use-template and --norequirements.

If the mass rebuild process is interrupted after downloading has been completed, whether by signal or by build failure, a template named resume.temp is saved to SBO_HOME. If this file is present, the mass rebuild restarts from the script after the script that failed when --mass-rebuild is used again.

EXIT CODES

sboinstall can exit with the following codes:

0: all operations were succesful.
1: a usage error occured, such as specifying invalid options.
3: a SlackBuild exited non-zero.
4: unable to md5sum verify the source file(s).
5: unable to download the source file(s).
6: unable to obtain a required file handle.
7: unable to get required info from the info file.
8: unable to unset the exec-on-close bit on a temporary file.
9: multilib has not been set up (where required).
10: convertpkg-compat32 exited non-zero.
11: the convertpkg-compat32 script cannot be found (where required).
12: interrupt signal received.
13: circular dependencies detected.

BUGS

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

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>