SBOUI-BACKEND(8)

NAME
sboui-backend - command-line utility for installing software from SlackBuilds.org

SYNOPSIS
sboui-backend update sboui-backend [OPTIONS] install NAME(s) sboui-backend info NAME sboui-backend {search|search-readmes} PATTERN sboui-backend list-groups sboui-backend browse-group NAME sboui-backend --help, -h

DESCRIPTION
sboui-backend is a tool to easily install software from SlackBuilds.org. It is the "built-in" package manager for sboui, but it can also be used standalone from the command line. It is similar to sbopkg and sbotools, but simpler; it is intended to be a minimal SBo package manager for sboui, which adds in more advanced features such as automatic forward and inverse dependency resolution. sboui can function equally well with any of these three package managers (sbopkg, sbotools, or sboui-backend), but sboui-backend allows sboui to run without any separate SBo package manager installed.

Instructions

Before running sboui-backend, select the desired repository and branch in /etc/sboui/sboui-backend.conf. sboui-backend uses git to manage the local SBo repository. You should select the proper repository to match your Slackware installation. See sboui-backend.conf(5) for more information about the configuration file. To create the local repository, run sboui-backend update or use the sync command within sboui with the package_manager set to built-in. This will create the local repository if it does not yet exist or update it if it does. After that, packages can be built and installed or upgraded using the install action. There are also several commands for searching and browsing the repository, as will be discussed in the next session.

ACTIONS

update
    Create or sync the local SBo repository.

install [OPTIONS] NAME(s)
    Install or upgrade an SBo package, or packages, by name. If multiple SlackBuild names are listed, the action will be applied to each one. OPTIONS -f or --force: if a requested package is already installed and up-to-date, reinstall without asking for confirmation first. sourcedir=DIRECTORY: instead of downloading source code, copy it from the specified directory.

info NAME
    Display the contents of README and README.SLACKWARE / README.Slackware files corresponding to the named SlackBuild.

search PATTERN
    Searches for SlackBuilds whose name matches all or part of the given pattern. For any matches, lists the group it belongs to and whether it is installed.

search-readmes PATTERN
    Searches in README files for the given pattern. For any matches, lists the name of the SlackBuild whose README contains the pattern. Note that the search READMEs function in sboui is much faster than this method and finds matches both in the README files and the SlackBuild name.

list-groups
    Displays a list of all groups (e.g., academic, desktop, libraries, etc.) in the repository.

browse-group NAME
    Displays a list of all SlackBuilds in a given group.

-h or --help
    Displays a short description of each action in sboui-backend.

EXIT STATUS
The exit status is 0 if all commands executed as expected. Returns non-zero if:

•   The git clone or git pull commands initiated by the update action fail. This can happen if permissions in repo directory are incorrect or if the REPO or BRANCH variables in sboui-backend.conf are invalid.

•   An invalid option or nonexistent SlackBuild is specified for the install action.

•   The sourcedir option is specified for the install command, but the sources are not found in the specified directory.

•   Source code failed to download or failed the MD5sum check.

•   Building the package failed.

•   Invalid command line options were specified.

ENVIRONMENT

CONF
    Configuration file to read. By default, it is /etc/sboui/sboui-backend.conf, but this environment variable can be set to read a different file instead.

OUTPUT
    Directory to drop built package. By default, it is /tmp.

TMP
    Directory where temporary source and package directories are placed. By default, it is /tmp/SBo.

FILES

/etc/sboui/sboui-backend.conf
    Default configuration file for sboui-backend. See sboui-backend.conf(5) for more information about the entries in this file.

BUGS
Please report bugs to the email address below or on the issue tracker for sboui's project page, https://github.com/montagdude/sboui.

SEE ALSO
sboui(8), sboui-backend(8), sboui-update-notifier(1), sbopkg(8), sboinstall(1)

AUTHORS
Daniel Prosser <dpross1100@msn.com>