SWARET(8)

NAME
swaret - SlackWARE Tool

SYNOPSIS
swaret --ACTION [KEYWORD] [OPTION]

DESCRIPTION
swaret Upgrades, Installs, Re-Installs, Downloads,... Packages, Patches, Sources (with Build Scripts) and much more! swaret includes Dependency Support, which Tracks and Fixes missing Libraries. It uses several Slackware Linux Mirrors through http/ftp/rsync or a Local Repository. swaret has also Repository Support to create a Repository of Slackware Packages which will allow swaret to use it with the known --ACTIONS. swaret can also use 3rd-party Slackware Packages available on LinuxPackages DOT NET and other (Repository) Sites. swaret has also Internationalization (i18n) Support.
Settings are read from swaret.conf(5) and will be used at runtime.

When a KEYWORD is passed at the commandline, the action will be performed on the Packages and/or Patches and/or Sources matching that KEYWORD.
You can also use ANY EXTENDED REGEXP (Regular Expression) as Keyword!

ACTIONS - OPTIONS

--update
    Retrieve the latest List Files

--upgrade
    NO_OPTION : Upgrade all installed Packages manually
    -a : Upgrade all installed Packages automatically

--upgrade KEYWORD
    NO_OPTION : Upgrade installed Packages matching a Keyword manually
    -a : Upgrade installed Packages matching a Keyword automatically

--install
    NO_OPTION : Install all available Packages manually
    -a : Install all available Packages automatically
    -p : Install all available Patches manually
    -ap : Install all available Patches automatically

--install KEYWORD
    NO_OPTION : Install all available Packages matching a Keyword manually
    -a : Install all available Packages matching a Keyword automatically
    -p : Install all available Patches matching a Keyword manually
    -ap : Install all available Patches matching a Keyword automatically

--reinstall
    NO_OPTION : Re-Install all available Packages manually
    -a : Re-Install all available Packages automatically
    -p : Re-Install all available Patches manually
    -ap : Re-Install all available Patches automatically

--install KEYWORD
    NO_OPTION : Re-Install all available Packages matching a Keyword manually
    -a : Re-Install all available Packages matching a Keyword automatically
    -p : Re-Install all available Patches matching a Keyword manually
    -ap : Re-Install all available Patches matching a Keyword automatically

--get
    NO_OPTION : Get all available Packages manually
    -a : Get all available Packages automatically
    -p : Get all available Patches manually
    -ap : Get all available Patches automatically
    -s : Get all available Sources manually
    -as : Get all available Sources automatically
    -u : Get all available Upgrade Packages manually
    -au : Get all available Upgrade Packages automatically

--get KEYWORD
    NO_OPTION : Get all available Packages matching a Keyword manually
    -a : Get all available Packages matching a Keyword automatically
    -p : Get all available Patches matching a Keyword manually
    -ap : Get all available Patches matching a Keyword automatically
    -s : Get all available Sources matching a Keyword manually
    -as : Get all available Sources matching a Keyword automatically
    -u : Get all available Upgrade Packages matching a Keyword manually
    -au : Get all available Upgrade Packages matching a Keyword automatically

--compile KEYWORD : Download, compile and install source code
    *Experimental*-Your milelage may vary. May not work yet with all packages.

--dep
    Track and Fix all missing Libraries

--dep KEYWORD
    Track and Fix missing Libraries matching a Keyword

--resume
    NO_OPTION : Resume broken Packages
    -p : Resume broken Patches
    -s : Resume broken Sources

--list
    NO_OPTION : List available Packages
    -p : List all available Patches
    -s : List all available Sources
    -i : List all installed Packages
    -u : List all installed Packages ready for Upgrade
    -n : List all none-installed Packages
    -np : List all none-installed Patches

--search KEYWORD
    NO_OPTION : Search for available Packages matching a Keyword
    -p : Search for available Patches matching a Keyword
    -s : Search for available Sources matching a Keyword
    -i : Search for installed Packages matching a Keyword
    -u : Search for installed Packages ready for Upgrade matching a Keyword
    -n : Search for none-installed Packages matching a Keyword
    -np : Search for none-installed Patches matching a Keyword

--show
    NO_OPTION : Show all Descriptions for available Packages
    -p : Show all Descriptions for available Patches
    -i : Show all Descriptions for installed Packages

--show KEYWORD
    NO_OPTION : Show Descriptions for available Packages matching a Keyword
    -p : Show Descriptions for available Patches matching a Keyword
    -i : Show Descriptions for installed Packages matching a Keyword

--changelog
    Show the latest ChangeLog

--set
    Set any Variable found in /etc/swaret.conf using this action
    Just issue the Command: 'swaret --set' and press ENTER to see what you can set.

--extra
    -u mail user[@domain-name.domain] : Mail the List of Upgrade Packages to user[@domain-name.domain].
    -u save /path/to/file : Save the List of Upgrade Packages as /path/to/file
    -u get /path/to/file : Get Upgrade Packages matching a List of Packages found in: '/path/to/file'

--gpg
    -i : Import GPG Public Key

--log
    NO_OPTION : Show swaret Log File
    -t : Show tail swaret Log File
    -c : Clear swaret Log File

--purge
    NO_OPTION : Purge Cached Packages in Packages Cache Directory (default: /var/swaret)
    -s : Purge Cached Sources in Sources Cache Directory (default: /var/swaret/sources)
    -d # : Purge Cached Packages in Packages Cache Directory matching a number (#) of Days. (default: /var/swaret)
    -ds # : Purge Cached Sources in Sources Cache Directory matching a number (#) of Days. (default: /var/swaret)
    -w # : Purge Cached Packages in Packages Cache Directory matching a number (#) of Weeks. (default: /var/swaret)
    -ws # : Purge Cached Sources in Sources Cache Directory matching a number (#) of Weeks. (default: /var/swaret)

--check
    Check if swaret is up-to-date.

--config
    Show Example swaret Config File

--faq
    Show F.A.Q.

--faq KEYWORD
    Show F.A.Q. matching a Keyword

--htus
    Show How To Use Swaret

--htus KEYWORD
    Show How To Use Swaret matching a Keyword

--help
    Show simple Help Screen

--morehelp
    Show advanced Help Screen

--manual
    NO_OPTION : Show swaret Manual
    -c : Show swaret Config Manual

--version
    Show swaret Version

INTERACTIVE OPTIONS

y   Yes

n   No

A   All

Q   Quit

ENVIRONMENT VARIABLES
swaret can use Environment Variables.
List of available Environment Variables working with swaret:
- PAGER (e.g.: export PAGER=more)

FILES
/etc/swaret.conf: swaret Configuration File
/var/log/swaret: swaret Log File

BUGS
Before sending a Bug Report, first check out the swaret Forum on http://www.swaret.org for solutions... If you are sure you found a Bug, you may send us a Bug Report to: <bugs@swaret.org>. or post it on the swaret Forum.

SUGGESTIONS
Any suggestion is always welcome! We will try to create, to test and to implement reasonable suggestions. You can send us suggestions by E-Mail to: <sug@swaret.org> and/or post it on the swaret Forum at http://www.swaret.org.

AUTHORS
Luc Cottyn <luc@swaret.org>
Michael G. Manry <mgmanry@swaret.org>

SEE ALSO
swaret.conf(5)