SWARET.CONF(5)

NAME
swaret.conf - swaret Configuration File

DESCRIPTION
The Configuration File for swaret(8) is located in the system wide /etc directory, and contains several Settings that are read by swaret on each runtime.

OPTIONS

VERSION
    Set this to the Version of Slackware Linux to which you want to Upgrade. Possible values could be 8.1 or 9.0 or Higher also Current. The default setting is current, which will keep you up to date with the latest changes.

DISTRIBUTION
    Set this to the Linux Distribution you are using. If you are using Slackware, set it to 'slackware'. If you are using a Slackware based Linux Distribution, set up this Variable also.

ROOT
    Specify one or more valid HTTP URL or FTP URL or RSYNC URL to the Slackware Linux 8.1 or Higher or Current Root. You may specify multiple Slackware Linux Mirrors. A List of available Slackware Linux Mirrors can be found at www.slackware.com. You may also specify one valid File URL to a Local Slackware Linux Root. When using the file Protocol, it 's not possible to use the http/ftp/rsync Protocols!

DEP_ROOT
    Similar to ROOT, but contains the libraries-VERSION URL. This is only used if DEPENDENCY is set to 1.

PACKAGES_LOGDIR
    Set this to the Packages Log Directory

REMOVED_PACKAGES_LOGDIR
    Set this to the Removed Packages Log Directory

FORCE_PATH
    Newbie Users should not change this Variable. If the 'PATH' Variable in the Shell is wrong configured, the FORCE_PATH Variable will be added to the 'PATH' Variable in the Shell used by swaret.

PACKAGES
    Set to 1 if you want to use Packages, 0 if you don't.

PATCHES
    Set to 1 if you want to use Patches, 0 if you don't.

EXTRA
    Set to 1 if you want to use Extra Packages, 0 if you don't.

SOURCES
    Set to 1 if you want to download Sources, 0 if you don't.

IMPORTANT
    If you want swaret to Upgrade first some Important Packages above all other Packages, you can add the necessary KEYWORDS to the IMPORTANT Variable. For example, you want swaret to Upgrade first: glibc, bin and sed... Do it like this: IMPORTANT=glibc bin sed

ONLY
    If you only want swaret to Upgrade some Packages, add the KEYWORDS to the ONLY Variable. For example, you want swaret only to Upgrade: kde and xfree86... Do it like this: ONLY=kde xfree86

EXCLUDE
    If you don 't want swaret to Upgrade some Packages, add the KEYWORDS to the EXCLUDE Variable. For example, you want swaret to Upgrade everything, except: lilo and kernel... Do it like this: EXCLUDE=lilo kernel

DEPENDENCY
    Set to 1 if you want swaret to check for missing Dependencies, 0 if you don't.

DINTERACTIVE
    Set to 1 if you want to enable Interactive mode during Dependency Check? Ask the User for Confirmation.

DESC
    If this is set to NO, the Description of Packages/Patches/Extra Packages will not be shown during Install, Upgrade and Remove. So there will be no output. If set to YES, then you see all output during Install, Upgrade and Remove.

OFFSET
    Sets the number of Packages/Patches/Extra Packages to List on the Screen at a time for the --search and --list actions. The default value is 20. If set to 0, all Items will be listed at one time. If set to 20, then 20 Items will appear on the Screen each time.

CACHE_DIR
    The directory for fetched Packages/Patches/Extra Packages. The default value is /var/swaret.

LOG Set this to 1 to send important Information to a Log File. Set to 0 to disable this Feature.

LOG_FILE
    This is the File that logging Information is sent (if LOG set to 1). The default value is /var/log/swaret.

WARNINGS
    If you don 't want swaret to show Warnings, set to 0.

INFORMATION
    If you don 't want swaret to show Information, set to 0.

DEP_INSTALL
    Dependency Check will Install new Packages when set to 1. If set to 0, it will not Install new Packages.

DEP_UPGRADE
    Dependency Check will Upgrade installed Packages when set to 1. If set to 0, it will Install Packages and different versions of installed Packages will be the result.

DEP_REINSTALL
    Dependency Check will Re-Install installed Packages when set to 1. If a Package is already installed, swaret will Re-Install that Package (the installed Package can be broken, so Re-Install). If set to 0, nothing will be Re-Installed.

MD5CHECK
    Check the MD5 CHECKSUM of Packages/Patches/Extra Packages.

PGPCHECK
    Check the PGP Signature of Packages/Patches/Extra Packages.

NIC What Network Interface to use for outgoing Traffic. The default is eth0.

DINTERFACE
    Display the wget or rsync Interface, instead of the swaret % counter.

TIMEOUT
    The Timeout value to use for wget and/or rsync (in seconds). The default value is 25.

RETRIES
    The number of Retries for wget and/or rsync. The default value is 1.

PASSIVE_FTP
    If you run swaret behind a Firewall or use FTP Mirrors, set to 1. Otherwise, set to 0.

WGET_PROXY
    If you need wget Proxy Support, setup the Variables http_proxy, ftp_proxy and use_proxy in wgetrc. For more information check out the Examples in /etc/swaret.conf or use swaret --config.

RSYNC_PROXY
    If you need rsync Proxy Support, set this to your Proxy Address and Port in the form of IP/Host:Port.

RSYNC_PASSWORD
    If you need rsync Proxy Support, set this to your password.

FILES
/var/log/swaret
    The default swaret Log File.

BUGS
Before sending a Bug Report, first check out the swaret Forum on http://swaret.xbone.be for solutions... If you are sure you found a Bug, you may send us a Bug Report (check below for contact information) and/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 (check below for contact information) and/or post it on the swaret Forum (http://swaret.xbone.be).

AUTHORS
Luc Cottyn <luc@xbone.be>
Michael G. Manry <mgmanry@linuxorbit.com>

SEE ALSO
swaret(8)