summaryrefslogtreecommitdiffstats
path: root/files/slackpkg.conf.5
diff options
context:
space:
mode:
Diffstat (limited to 'files/slackpkg.conf.5')
-rw-r--r--files/slackpkg.conf.5338
1 files changed, 338 insertions, 0 deletions
diff --git a/files/slackpkg.conf.5 b/files/slackpkg.conf.5
new file mode 100644
index 0000000..5af259a
--- /dev/null
+++ b/files/slackpkg.conf.5
@@ -0,0 +1,338 @@
+.TH SLACKPKG.CONF 5 "Oct 2017" slackpkg-2.82.2 ""
+.SH NAME
+.B slackpkg.conf
+\- Configuration data for slackpkg
+
+.SH DESCRIPTION
+
+The slackpkg.conf file contains information for
+.B slackpkg
+(8), an automated tool for managing Slackware Linux packages.
+
+The slackpkg.conf file is a sequence of shell script variables, and each
+variable controls one aspect of slackpkg. Comments begin with the #
+character and end at end of the line, and comments may appear anywhere
+inside the slackpkg.conf file. If some variable appears more than once
+in the file, slackpkg will use the value that was defined last.
+
+Many variables can be overridden by options passed to slackpkg on the command
+line. If you need to override the value of
+.B VARIABLE
+, pass
+.B -variable=value
+on the command line just before the slackpkg action. Multiple variables may
+be overridden.
+
+EXAMPLE: slackpkg -batch=on -default_answer=y upgrade-all
+
+For configuration options that have only two states, possible values are
+either "on" or "off" unless otherwise indicated.
+
+The different configuration options are:
+
+.TP 5
+.B ARCH
+.br
+Chooses the system architecture. Usually Slackpkg can find the correct
+value using "uname -m". The valid values are:
+
+.ds title MACHINE\t\tVALID ARCH VALUES
+.ds arm ARM\t\t\tarm
+.ds x86 x86 (32bits)\ti386, i486, i586 and i686
+.ds x86_64 x86 (64bits)\tx86_64
+.ds ppc PowerPC\t\tpowerpc
+.ds s390 S/390\t\t390
+.in +5
+.B \*[title]
+.br
+\*[arm]
+.br
+\*[x86]
+.br
+\*[x86_64]
+.br
+\*[ppc]
+.br
+\*[s390]
+.in
+
+The default value of
+.B ARCH
+depends on your architecture.
+
+.TP 5
+.B SLACKKEY
+.br
+Slackpkg checks the package signature file (.asc) against the GPG signature
+of the project. Different ports of Slackware can have different signatures,
+and Slackpkg tries to find the correct one based on the architecture of your
+system. If the automatically-detected
+.B SLACKKEY
+isn't correct, you can change it using this option.
+
+The default value of
+.B SLACKKEY
+depends on your Slackware port.
+
+.TP 5
+.B TEMP
+.br
+Defines the location to which slackpkg will download the packages before
+installing/upgrading them.
+
+The default value of
+.B TEMP
+is /var/cache/packages.
+
+.TP 5
+.B WORKDIR
+.br
+Defines the directory for package lists, file lists, and other information
+used by slackpkg as it works. Do not change the value of this variable
+unless you know what you are doing.
+
+The default value of
+.B WORKDIR
+is /var/lib/slackpkg.
+
+.TP 5
+.B WGETFLAGS
+.br
+Selects special options for wget. If you need to use multiple options,
+remember to put them between double quotes.
+
+The default value of
+.B WGETFLAGS
+is "\--passive-ftp"
+
+.TP 5
+.B DELALL
+.br
+If set to "on", all downloaded files will be removed after slackpkg performs
+install or upgrade (this does NOT have any impact when slackpkg is run with
+"download"). If set to "off", the files will be kept in the directory
+defined in
+.B TEMP
+(as described above).
+
+The default value of
+.B DELALL
+is "on".
+.br
+From command line, you can use -delall=value.
+
+.TP 5
+.B CHECKMD5
+.br
+Enables (on) or disables (off) the checking of MD5 checksums of all downloaded
+packages before installing or upgrading them.
+
+The default value of
+.B CHECKMD5
+is "on".
+.br
+From command line, you can use -checkmd5=value.
+
+.TP 5
+.B CHECKGPG
+.br
+Enables (on) or disables (off) the check of GPG signature for each package
+before install or upgrade.
+
+The default value of
+.B CHECKGPG
+is "on".
+.br
+From command line, you can use -checkgpg=value.
+
+.TP 5
+.B CHECKSIZE
+.br
+Enables (on) or disables (off) the check of available disk space for each
+package before install or upgrade.
+
+The default value of
+.B CHECKSIZE
+is "off".
+.br
+From command line, you can use -checksize=value.
+
+.TP 5
+.B PKGMAIN
+.br
+Defines the main distribution directory. Usually, you don't need to worry
+about this variable, as Slackpkg tries to find it based on your architecture.
+However, if you need to change it, then include this variable in your
+slackpkg.conf. This should always be the directory which contains the
+Slackware package set series (A, AP, D, E, F, ...).
+
+Default: depends on Slackware port
+
+.TP 5
+.B PRIORITY
+.br
+This array selects the priority at which directories on the mirror will have
+when slackpkg looks for packages. If a package is found in more than one
+place, the package in first directory gets priority, then second, then third,
+then fourth and finally, the package found in last listed directory. You can
+use %PKGMAIN to use the contents of PKGMAIN variable.
+
+Default values (in order): patches %PKGMAIN extra pasture testing
+
+.TP 5
+.B POSTINST
+.br
+Enables (on) or disables (off) slackpkg's post-installation features, such
+as checking for new (*.new) configuration files and new kernel images, and
+prompts you for what it should do.
+
+The default value of
+.B POSTINST
+is "on".
+.br
+From command line, you can use -postinst=value.
+
+.TP 5
+.B ONLY_NEW_DOTNEW
+.br
+When
+.B POSTINST
+is set to "on", slackpkg will search for all .new files inside /etc and
+prompt the user for what to do with them. However, some users prefer to
+see only the .new files installed in slackpkg's last execution, so if
+this applies to you, set
+.B ONLY_NEW_DOTNEW
+to "on".
+
+The default value of
+.B ONLY_NEW_DOTNEW
+is "off". Only change this if you know what are you doing...
+.br
+From command line, you can use -only_new_dotnew=value.
+
+.TP 5
+.B ONOFF
+.br
+The
+.B ONOFF
+variable sets the initial behavior of the dialog interface.
+If you set this to "on" then all packages will be selected by default.
+If you prefer the opposite option (all unchecked), then set this to "off".
+
+The default value of
+.B ONOFF
+is "on".
+.br
+From command line, you can use -onoff=value.
+
+.TP 5
+.B DOWNLOAD_ALL
+.br
+If this variable is set to "on", all files will be downloaded before the
+requested operation (install or upgrade) is performed. If set to "off",
+then the files will be downloaded and the operation (install/upgrade) performed
+one by one.
+
+The default value of
+.B DOWNLOAD_ALL
+is "off".
+.br
+From command line, you can use -download_all=value.
+
+.TP 5
+.B DIALOG
+.br
+Enables (on) or disables (off) the dialog interface.
+
+The default value of
+.B DIALOG
+is "on".
+.br
+From command line, you can use -dialog=value.
+
+.TP 5
+.B DIALOG_MAXARGS
+.br
+Set the max number of characters that will be send to "dialog". If this number
+is reached in upgrade, slackpkg removes the information about current installed
+version of each package. If even without this information the number is reached
+again, slackpkg returns an error to the user.
+
+If
+.B DIALOG_MAXARGS
+is unset, 19500 is the default value.
+.br
+From command line, you can use -dialog_maxargs=value.
+
+.TP 5
+.B BATCH
+.br
+Enables (on) or disables (off) the non-interactive mode. When run in batch
+mode, slackpkg will not prompt the user for anything; instead, all questions
+will get
+.B DEFAULT_ANSWER
+(see below).
+.br
+If you perform an upgrade using this mode, you will need to run
+"slackpkg new-config" later to find and merge .new files.
+
+The default value of
+.B BATCH
+is "off".
+.br
+From command line, you can use -batch=value.
+
+.TP 5
+.B DEFAULT_ANSWER
+.br
+This is the default answer to questions when slackpkg prompts the user for
+some information. This is used only in non-interactive mode (when
+.B BATCH
+is "yes" or the user turns batch mode on via the command line); otherwise,
+this variable has no effect.
+.br
+Valid values are "y" or "n".
+
+The default value of
+.B DEFAULT_ANSWER
+is "n".
+.br
+From command line, you can use -default_answer=value.
+
+.TP 5
+.B USE_INCLUDES
+.br
+Slackpkg templates can include other templates. This reduces the package
+duplication in many templates, but it can be a problem if you want to remove
+only a specific template. You can disable the #include parsing by setting
+this option to "off".
+
+The default value of
+.B USE_INCLUDES
+is "on".
+.br
+From command line, you can use -use_includes=value.
+
+.TP 5
+.B SPINNING
+.br
+When Slackpkg is doing an activity that takes some time, it gives visual
+feedback with a spinning bar. If you don't like the spinning bar, it can be
+disabled by setting this option to "off".
+
+The default value of
+.B SPINNING
+is "on".
+.br
+From command line, you can use -spinning=value.
+
+.SH FILES
+.TP 5
+.B /etc/slackpkg/slacpkg.conf
+
+.SH "SEE ALSO"
+.BR slackpkg (8)
+.BR pkgtool (8)
+.BR installpkg (8)
+.BR upgradepkg (8)
+.BR removepkg (8)