slpkg/man/slpkg.8

.\"                                      -*- nroff -*-
.\" Copyright (C) 2014 Dimitris Zlatanidis
.\"
.\" 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.
.\"
.TH Slpkg "8" "5 2014" "slpkg"
.SH NAME
slpkg - Utility for easy management packages in Slackware
.SH SYNOPSIS
 \fBslpkg\fP \fB-h\fP \fB-v\fP \fB-a script [source ...]\fP \fB-l all, sbo, slack, noarch, other\fP
 \fB-t\fP \fB-n\fP \fB-c sbo, slack [sbo, slack ...]\fP \fB-s\ slack [sbo, slack ...] fP\fB-i [...]\fP
 \fB-u [...]\fP \fB-o [...]\fP \fB-r [...]\fP \fB-f [...]\fP \fB-d [...]\fP
.SH DESCRIPTION
\fBslpkg\fP is a terminal multitool in order to easy use Slackware packages.
.PP
It's a quick and easy way to manage your packages in slackware to a command.
.SH EXAMPLES
  \fB-h, --help            show this help message and exit\fP
  \fB-v, --verbose         print version and exit\fP
  \fB-a script [source ...]\fP
  \fB			           auto build packages\fP
  \fB-l all, sbo, slack, noarch, other\fP
  \fB                      list of installed packages\fP
  \fB-c sbo, slack [sbo, slack ...]\fp
  \fB                      check if your packages is up to date\fP
  \fB-s sbo, slack [sbo, slack ...]\fP
  \fB                      download, build & install packages\fP
  \fB                      list of installed packages\fP
  \fB-t                    packages tracking dependencies from SBo\fP
  \fB-n                    view packages from SBo repositority\fP
  \fB-i  [ ...]            install binary packages\fP
  \fB-u  [ ...]            upgrade binary packages\fP
  \fB-o  [ ...]            reinstall binary packages\fP
  \fB-r  [ ...]            remove binary packages\fP
  \fB-f  [ ...]            view installed packages\fP
  \fB-d  [ ...]            display the contents of the packages\fP

.SH GLOBAL OPTIONS
.TP
\fB\-v\fP, \fB\-\-verbose\fP
Print the version of program and exit.
.SH COMMANDS
.PP
The following commands are available.
.SS -a script source extra
\fBslpkg\fP \fB-a\fP <\fIscript\fP> <\fIsource\fP> <\fIextra sources\fP>
.PP
With this argument, build slackware package from source quickly and easy.
Support .tar.gz and .tar.bz2 slackbuilds archives.
.SS -l all, sbo, slack, noarch, other
\fBslpkg\fP \fB-l\fP <\fIall\fP> <\fIsbo\fP>
.PP
Two display options list, one for all packages and another
only for packages SBo.
.SS -t , tracking dependencies
\fBslpkg\fP \fB-t\fP <\fIname of package\fP>
.PP
Tracking all dependencies of that package.
The sequence shown is that you must follow to correctly install package.
.SS -n , find from SBo repositority
\fBslpkg\fP \fB-n\fP <\fIname of package\fP>
.PP
With this method you can find the SBo script that interests you through
the network. (www.slackbuilds.org)
.SS -c , sbo, slack [sbo, slack ...] check if your package is up to date
\fBslpkg\fP \fB-c\fP <\fIsbo\fP> <\fIslack\fP> <\fIname of package\fP>
.PP
Check your packages from Slackware official mirrors or from 
slackbuilds.org is up to date.
.SS -s , sbo, slack [sbo, slack ...] find, download, build and install package with all dependencies
\fBslpkg\fP \fB-s\fP <\fIsbo\fP> <\fIslack\fP> <\fIname of package\fP>
.PP
Find package from slackbuild.org with all dependencies,
download, build and install them if not installed or new version is 
available. Even download and install official packages from Slackware
official mirrors and install or reinstall if already installed.
.SS -i , install binary package
\fBslpkg\fP \fB-i\fP <\fIpackages.t?z\fP>
.PP
Installs single binary packages designed for use with the 
Slackware Linux distribution into your system.
.SS -u , install-upgrade package with new
\fBslpkg\fP \fB-u\fP <\fIpackages.t?z\fP>
.PP
Normally upgrade only upgrades packages that are already
installed on the system, and will skip any packages that do not
already have a version installed. 'Requires root privileges'
(like slackware command upgradepkg --install-new)
.SS -o reinstall binary package
\fBslpkg\fP \fB-o\fP <\fIpackages.t?z\fP>
.PP
Upgradepkg usually skips packages if the exact same package
(matching name, version, arch, and build number) is already
installed on the system.'Requires root privileges' (like 
slackware command upgradepkg --reinstall)
.SS -r , remove package
\fBslpkg\fP \fB-r\fP <\fIname of packages\fP>
.PP
Removes a previously installed Slackware package, while writing
a progress report to the standard output. A package may be 
specified either by the full package name (as you'd see listed in
/var/log/packages/), or by the base package name. If installed
packages with command 'slpkg -s sbo <package>' then write a file
in /var/log/slpkg/dep/ with all dependencies and it allows you  
can remove them all together. 'Requires root
privileges' (like slackware command removepkg)
.SS -f find packages
\fBslpkg\fP \fB-f\fP <\fIname of packages\fP>
.PP
Find if package allready installed or not.
.SS -d display contents
\fBslpkg\fP \fB-d\fP <\fIname of packages\fP>
.PP
Display the contents of the package with all descriptions.
.SH HELP OPTION
Specifying the help option displays help for slpkg itself, or a
command.
.br
For example:
  \fBslpkg \-\-help\fP - display help for slpkg
.SH EXAMPLES


$ \fBslpkg -t brasero\fP
  Reading package lists...... Done
  
  +=========================
  | brasero dependencies :
  +=========================
  \\ 
   +---[ Tree of dependencies ]
   |
   --1: orc
   |
   --2: gstreamer1
   |
   --3: gst1-plugins-base
   |
   --4: gst1-plugins-bad
   |
   --5: libunique

$ \fBslpkg -s sbo brasero\fP
  Building dependency tree...... Done
  The following packages will be automatically installed or upgraded with new version:
  +==============================================================================
  | Package                 Version       Arch         Repository
  +==============================================================================
  Installing:
    brasero                 3.11.3        x86_64       SBo
  Installing for dependencies:
    orc                     0.4.19        x86_64       SBo
    gstreamer1              1.2.2         x86_64       SBo
    gst1-plugins-base       1.2.2         x86_64       SBo
    gst1-plugins-bad        1.2.2         x86_64       SBo
    libunique               1.1.6         x86_64       SBo

  Installing summary
  ===============================================================================
  Total 6 packages.
  0 packages will be installed, 6 allready installed.

  Do you want to continue [Y/n]? y
  .
  .
  .
  +==============================================================================
  | Installing new package /tmp/brasero-3.11.3-x86_64-1_SBo.tgz
  +==============================================================================

  Verifying package brasero-3.11.3-x86_64-1_SBo.tgz.
  Installing package brasero-3.11.3-x86_64-1_SBo.tgz:
  PACKAGE DESCRIPTION:
  # brasero (CD/DVD burning application)
  #
  # Brasero is a application to burn CD/DVD for the Gnome Desktop. It is
  # designed to be as simple as possible and has some unique features to
  # enable users to create their discs easily and quickly.
  #
  # Homepage: http://projects.gnome.org/brasero
  #
  Executing install script for brasero-3.11.3-x86_64-1_SBo.tgz.
  Package brasero-3.11.3-x86_64-1_SBo.tgz installed.


$ \fBslpkg -c sbo flashplayer-plugin\fP
  Reading package lists. Done

  New version is available:
  +==============================================================================
  | Package: flashplayer-plugin 11.2.202.356 --> flashplayer-plugin 11.2.202.394
  +==============================================================================
 
  Would you like to install [Y/n]?

$ \fBslpkg -c slack upgrade\fp
  Reading package lists....... Done

  Slackware64 v14.1 distribution is up to date

$ \fBslpkg -n termcolor\fP
  Reading package lists. Done

  +==============================================================================
  | Package termcolor --> http://slackbuilds.org/repository/14.1/python/termcolor/
  +==============================================================================
  | SlackBuild : termcolor.tar.gz
  | Source : termcolor-1.1.0.tar.gz
  | Extra : 
  | Requirements :
  +===============================================================================
   README               View the README file
   SlackBuild           View the SlackBuild file
   Info                 View the Info file
   Download             Download this package
   Build                Download and build this package
   Install              Download/Build/Install

  _

  Two files termcolor.tar.gz and termcolor-1.1.0.tar.gz
  must be in the same directory.

$ \fBslpkg -a termcolor.tar.gz termcolor-1.1.0.tar.gz\fP

  Slackware package /tmp/termcolor-1.1.0-x86_64-1_SBo.tgz created.

$ \fBslpkg -u /tmp/termcolor-1.1.0-x86_64-1_SBo.tgz\fP

  Installing new package ./termcolor-1.1.0-x86_64-1_SBo.tgz

$ \fBslpkg -r termcolor yetris\fP
  
  Packages with name matching [ termcolor, yetris ]
  
  [ delete ] -- > termcolor-1.1.0-x86_64-1_SBo
  No such package yetris: Can't find

  Are you sure to remove 1 package(s) [Y/y]
    
  Package: termcolor-1.1.0-x86_64-1_SBo
  Package: yetris-2.0.1-x86_64-1_SBo
          Removing...

  Package termcolor removed

$ \fBslpkg -f termcolor\fP

  Packages with name matching [ termcolor ]
  
  No such package termcolor: Can't find

$ \fBslpkg -d termcolor\fP

  No such package termcolor: Can't dislpay

$ \fBslpkg -v\fP

  Version: x.x.x

.SH AUTHOR
Dimitris Zlatanidis <d.zlatanidis@gmail.com>
.SH COPYRIGHT
Copyright \(co 2014 Dimitris Zlatanidis

.SH SEE ALSO
installpkg(8), upgradepkg(8), removepkg(8), pkgtool(8), slackpkg(8)