view release on metacpan or  search on metacpan

bin/sbozyp  view on Meta::CPAN

The name of the repo to use by default when not specifying one with the C<-R>
flag. There is no default value for this variable.

=head3 REPO_ROOT

The directory to store local copies of SBo.

Defaults to C<REPO_ROOT=/var/lib/sbozyp/SBo>.

=head3 TMPDIR

The directory used for placing working files.

Defaults to C<TMPDIR=/tmp>.

=head3 SRCDIR

The directory used to save downloaded source files for reuse when using the
install and build commands -z flag.
 
Defaults to C<SRCDIR=/var/lib/sbozyp/source-cache>.

=head1 WORKING TREES

A package argument may be a package name or a SlackBuild package directory:

 sbozyp in -r ./office/mu
 sbozyp in system/foo ./office/mu
 cd office/mu
 sbozyp in -r .

The directory must be C<CATEGORY/PRGNAM> and contain matching C<PRGNAM.info>
and C<PRGNAM.SlackBuild> files. Relative directory arguments must begin with
C<./> or C<../>. The tree need not be a Git or configured repository. If any
package argument is a SlackBuild directory, its tree is used for the entire
command, regardless of argument order. All other packages and dependencies
come from that tree.

Use C<-W> from the tree root when giving package names:

 sbozyp -W in -r office/mu

C<-W> cannot be combined with C<-C>, C<-R>, or C<-S>.

=head1 COMMANDS

=head2 INSTALL

 Usage: sbozyp <install|in> [-h] [-b FILE] [-f] [-k] [-n] [-r] [-y] [-z] <pkgname...>

Install or update packages.

Options are:

 -h|--help     Print help message and exit
 -b FILE       Use FILE as blacklist instead of /etc/sbozyp/sbozyp.blacklist
 -f            Force install/update even if package is up to date or blacklisted
 -k            Keep the built package (resides in TMPDIR)
 -n            Skip md5sum verification of downloaded sources
 -r            Install package dependencies recursively
 -y            No interactive prompt
 -z            Keep and reuse downloaded sources (reside in SRCDIR)

Examples:

 sbozyp install --help
 sbozyp in password-store
 sbozyp in -r xclip mu password-store
 sbozyp in -k -r system/password-store
 sbozyp in -f -y -r password-store
 sbozyp -S -R $REPO in -f -r password-store
 sbozyp in -r ./office/mu
 sbozyp in -r $(sbozyp -S qr -u) ### update all packages

=head2 BUILD

 Usage: sbozyp <build|bu> [-h] [-f] [-n] [-y] [-z] <pkgname...>

Build but don't install packages.

Options are:

 -h|--help     Print help message and exit
 -f            Force rebuilding the package even if it's already built
 -n            Skip md5sum verification of downloaded sources
 -y            No confirmation prompt
 -z            Keep and reuse downloaded sources (reside in SRCDIR)

Examples:

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

=head2 REMOVE

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

Remove packages.

Options are:

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

Examples:

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

=head2 QUERY

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

Query for package related information.

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

Options are:

 -h|--help     Print help message and exit
 -a            Print all installed packages
 -b            Print the path to PKGNAME's local package directory
 -c            Print the path to the current repositories 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 updates available
 -v            Like -u, but also print the version information
 -x            Print all installed SBo packages not in the current repo

Examples:

 sbozyp query --help
 sbozyp qr -q password-store
 sbozyp qr -m
 sbozyp -S qr -u
 cd $(sbozyp qr -b password-store)
 removepkg $(sbozyp qr -x) # remove packages not in current repo
 sbozyp -S -R $REPO qr -r password-store
 sbozyp qr -q ./office/mu

=head2 SEARCH

 Usage: sbozyp <search|se> [-h] [-c] [-n] [-p] [-q] <regex>

Search for packages using a Perl regex.

Options are:

 -h|--help     Print help message and exit
 -c            Match case sensitive
 -n            Match against CATEGORY/PRGNAM instead of just PRGNAM
 -p            Print just the PRGNAM of matched packages
 -q            Suppress output if no matches are found