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 SBo repository before running the command
-F FILE       Use FILE as the configuration file
-R REPO_NAME  Use SBo repository REPO_NAME instead of REPO_PRIMARY
-S            Sync SBo repository before running the command
-T            Exit if the SBo repository hasn't been cloned yet

Commands:

install|in    Install or upgrade packages
build|bu      Build but don't install packages
remove|rm     Remove packages
query|qr      Query for information about a package
search|se     Search for a package using a Perl regex
null|nu       Do nothing, useful in conjunction with -C or -S opts

Examples:

sbozyp --help
sbozyp --version
sbozyp install --help
sbozyp install -S -R $REPO -f xclip system/password-store
sbozyp -T build -f mu
sbozyp remove xclip password-store
sbozyp query -q password-store
sbozyp search -n system/.+
sbozyp -R $REPO -C null

CONFIGURATION

Sbozyp is configured via the /etc/sbozyp/sbozyp.conf file. An alternative configuration file can be specified with the -F option.

REPOSITORY DEFINITIONS

You can define as many repositories as you want 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.

Repo names should never contain any forward slash characters (/).

OTHER CONFIGURATION VARIABLES

REPO_PRIMARY

The name of 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.

COMMANDS

INSTALL

Usage: sbozyp <install|in> [-h] [-f] [-i] [-k] [-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            No interactive prompt
-k            Keep the built package (resides in TMPDIR)
-n            Do not install package dependencies

Examples:

sbozyp install --help
sbozyp in password-store
sbozyp in xclip mu password-store
sbozyp in -k system/password-store
sbozyp in -f -i -n password-store
sbozyp -S -R $REPO in -f password-store
sbozyp in $(sbozyp -S qr -u | cut -d' ' -f1) ### upgrade all packages

BUILD

Usage: sbozyp <build|bu> [-h] [-f] [-i] <pkgname...>

Build but don't install packages.

Options are:

-h|--help     Print help message
-f            Force rebuilding the package even if it's already built
-i            No confirmation prompt

Examples:

sbozyp build --help
sbozyp bu password-store
sbozyp bu -f password-store
sbozyp bu -f -i system/password-store
sbozyp -S -R $REPO bu password-store
sbozyp bu -i system/password-store xclip mu

REMOVE

Usage: sbozyp <remove|rm> [-h] [-f] [-i] [-r] <pkgname...>

Remove packages.

Options are:

-h|--help     Print help message
-f            Disable removal safety check (DANGEROUS)
-i            No confirmation prompt
-r            Recursively remove package dependencies that are safe to remove

Examples:

sbozyp remove --help
sbozyp rm xclip mu system/password-store
sbozyp rm -i -r password-store
sbozyp -S -R $REPO rm password-store

QUERY

Usage: sbozyp <query|qr> [-h] [-a] [-b] [-d] [-i] [-m] [-n] [-o] [-p] [-q] [-r] [-s] [-u] PKGNAME?

Query for package related information.

Exactly one option must be used in a single query command.

Options are:

-h|--help     Print help message
-a            Print all installed SBo packages
-b            Print the path to PKGNAME's local package directory
-d            Print PKGNAME's slack-desc file
-i            Print PKGNAME's info file
-m            Print all installed SBo packages with no dependents
-n            Print PKGNAME's recursive dependents
-o            Print PKGNAME'S direct dependents
-p            If PKGNAME is installed print the installed version number
-q            Print PKGNAME's installation queue (finds PKGNAMES dependencies)
-r            Print PKGNAME's README file
-s            Print PKGNAME's .SlackBuild file
-u            Print all packages that have upgrades available

Examples:

sbozyp query --help
sbozyp qr -q password-store
sbozyp qr -m
sbozyp -S qr -u
cd $(sbozyp qr -b password-store)
sbozyp -S -R $REPO qr password-store

SEARCH

Usage: sbozyp <search|se> [-h] [-c] [-n] [-p] <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
-p            Print just the PRGNAM of matched packages

Examples:

sbozyp search --help
sbozyp se password-store
sbozyp se -p password.+
sbozyp se -c -n system/.+
sbozyp -S -R $REPO se 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) a repository.

Options are:

-h|--help     Print help message

Examples:

sbozyp null --help
sbozyp nu
sbozyp -R $REPO -S nu
sbozyp -S nu

AUTHOR

Nicholas Hubbard (nicholashubbard@posteo.net)

CONTRIBUTORS

Kat Nguyen
pghvlaans

COPYRIGHT

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

To install App::sbozyp, copy and paste the appropriate command in to your terminal.

cpanm

cpanm App::sbozyp

CPAN shell

perl -MCPAN -e shell
install App::sbozyp

For more information on module installation, please visit the detailed CPAN module installation guide.

	Global
`s`	Focus search bar
`?`	Bring up this help dialog

	GitHub
`g` `p`	Go to pull requests
`g` `i`	go to github issues (only if github is preferred repository)

	POD
`g` `a`	Go to author
`g` `c`	Go to changes
`g` `i`	Go to issues
`g` `d`	Go to dist
`g` `r`	Go to repository/SCM
`g` `s`	Go to source
`g` `b`	Go to file browse

	Search terms
module: (e.g. module:Plugin)
distribution: (e.g. distribution:Dancer auth)
author: (e.g. author:SONGMU Redis)
version: (e.g. version:1.00)

NAME

DESCRIPTION

OVERVIEW

CONFIGURATION

REPOSITORY DEFINITIONS

OTHER CONFIGURATION VARIABLES

REPO_PRIMARY

REPO_ROOT

TMPDIR

COMMANDS

INSTALL

BUILD

REMOVE

QUERY

SEARCH

NULL

AUTHOR

CONTRIBUTORS

COPYRIGHT

LICENSE

Module Install Instructions