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

DESCRIPTION

sboinstall is used to install SlackBuilds. If the -r flag is not specified, sboinstall will pull the list of requirements from the info file for any specified SlackBuild. This is a recursive operation over all dependencies. sboinstall will offer to install any non-installed dependencies in the build queue. This program will not handle circular dependencies.

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

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

sboinstall will attempt 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 will be attempted from ftp://slackware.uk/sbosrcarch/ as a fallback measure.

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 SBO_HOME/distfiles by default. The package archive (in /tmp by default) will also be 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 will be 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 so that the contents of the package can be inspected prior to installation. If the base package and compat32 package are to be built at the same time, ensure that the DISTCLEAN option is set to FALSE. GitHub Issues are welcome in case of unexpected failure.

-r|--nointeractive

Bypass all user prompts and all dependency resolution for the requested SlackBuilds. Unless it is obvious that dependency resolution and build options are not required, consider using a template instead.

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

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).

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>