NAME
sbozyp - A package manager for Slackware's SlackBuilds.org
DESCRIPTION
Sbozyp is a command-line package manager for the SlackBuilds.org package repository. SlackBuilds.org is a collection of third-party SlackBuild scripts used to build Slackware packages. Sbozyp assumes an understanding of SlackBuilds and the SlackBuilds.org repository.
OVERVIEW
Usage: sbozyp [global_opts] <command> [command_opts] <command_args>
Every command has its own options, these are just the global ones:
-C Re-clone repository before running the command
-F FILE Use FILE as the configuration file
-R REPO_NAME Use repository REPO_NAME instead of REPO_PRIMARY
-S Sync repository before running the command
Commands are:
install|in Install or upgrade packages
null|nu Do nothing, useful in conjunction with -C or -S opts
query|qr Query for information about a package
remove|rm Remove packages
search|se Search for a package using a Perl regex
Examples:
sbozyp --help
sbozyp --version
sbozyp install -S -R $REPO -f xclip system/password-store
sbozyp query -q password-store
sbozyp remove xclip password-store
sbozyp search system/.+
sbozyp -R $REPO -C null
CONFIGURATION
Sbozyp is configured via the /etc/sbozyp/sbozyp.conf
file unless ~/.sbozyp.conf
is present. An alternate configuration file can be used with the -F
option.
REPOSITORY DEFINITIONS
You can define as many repositories as you wish in the configuration file. A repository definition requires these 3 variables to be set ($N is any non-negative integer):
REPO_$N_NAME
REPO_$N_GIT_URL
REPO_$N_GIT_BRANCH
Example:
REPO_7_NAME=fifteenpoint0
REPO_7_GIT_URL=git://git.slackbuilds.org/slackbuilds.git
REPO_7_GIT_BRANCH=15.0
This defines a repository that will be downloaded with git with a command like: git clone --branch $REPO_7_GIT_BRANCH $REPO_7_GIT_URL
.
You can use this repository with sbozyp by specifying its name (fifteenpoint0) with the -R
option. You can also make this repository the default (used when -R
is omitted) by setting REPO_PRIMARY=fifteenpoint0
in your configuration file.
OTHER CONFIGURATION VARIABLES
REPO_PRIMARY
The repo to use by default when not specifying one with the -R
flag. There is no default value for this variable.
REPO_ROOT
The directory to store local copies of SBo.
Defaults to REPO_ROOT=/var/lib/sbozyp/SBo
.
TMPDIR
The directory used for placing working files.
Defaults to TMPDIR=/tmp
.
CLEANUP
If 0
then keep built packages after installation. If 1
then remove them.
COMMANDS
INSTALL
Usage: sbozyp <install|in> [-h] [-f] [-i] [-n] <pkgname...>
Install or upgrade packages
Options are:
-h|--help Print help message
-f Force installation even if package is already up to date
-i Non-interactive (DANGEROUS)
-n Do not install package dependencies
Examples:
sbozyp install --help
sbozyp in password-store
sbozyp in xclip mu password-store
sbozyp in system/password-store
sbozyp in -f -i -n password-store
sbozyp -S -R $REPO in -f password-store
NULL
Usage: sbozyp <null|nu> [-h]
Do nothing, useful if you just want to re-clone (with global -C option) or sync (with global -S option) your repository.
Options are:
-h|--help Print help message
Examples:
sbozyp null --help
sbozyp nu
sbozyp -R $REPO -S nu
sbozyp -S nu
QUERY
Usage: sbozyp <query|qr> [-h] [-a] [-d] [-i] [-p] [-q] [-r] [-s] [-u] PKGNAME?
Query for package related information
If only PKGNAME and no options are provided, this command will drop you into an interactive prompt for viewing PKGNAME's files.
All options are mutually exclusive meaning only one can be used in a single invocation.
Options are:
-h|--help Print help message
-a Print a list of all SBo packages installed on the system
-d Print PKGNAME's slack-desc file
-i Print PKGNAME's info file
-p If PKGNAME is installed print the installed version, else exit with status 1
-q Print PKGNAME's dependencies (recursively and in order)
-r Print PKGNAME's README file
-s Print PKGNAME's .SlackBuild file
-u Print a list of all packages that have upgrades available
Examples:
sbozyp query --help
sbozyp qr system/password-store
sbozyp qr -q password-store
sbozyp qr -u
sbozyp -S -R $REPO qr password-store
REMOVE
Usage: sbozyp <remove|rm> [-h] [-i] <pkgname...>
Remove packages
Options are:
-h|--help Print help message
-i Non-interactive (DANGEROUS)
Examples:
sbozyp remove --help
sbozyp rm xclip mu system/password-store
sbozyp rm -i password-store
sbozyp -S -R $REPO rm password-store
SEARCH
Usage: sbozyp <search|se> [-h] [-c] [-n] <regex>
Search for a package using a Perl regex
Options are:
-h|--help Print help message
-c Match case sensitive
-n Match against CATEGORY/PRGNAM instead of just PRGNAM
Examples:
sbozyp search --help
sbozyp se password-store
sbozyp se password.+
sbozyp se -c -n system/.+
sbozyp -S -R $REPO se password-store
sbozyp in $(sbozyp -S qr -u) ### upgrade all packages
AUTHOR
Nicholas Hubbard (nicholashubbard@posteo.net)
CONTRIBUTORS
Kat Nguyen
COPYRIGHT
Copyright (c) 2023-2024 by Nicholas Hubbard (nicholashubbard@posteo.net)
LICENSE
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with sbozyp. If not, see http://www.gnu.org/licenses/.