From 406e0e84f5321652fa1a539d80be6ca5df1ffb1b Mon Sep 17 00:00:00 2001 From: Robby Workman Date: Thu, 19 Oct 2017 13:49:43 -0500 Subject: *: Initial commit of slackpkg (as of 2.82.2 release) --- files/slackpkg.conf.5 | 338 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 338 insertions(+) create mode 100644 files/slackpkg.conf.5 (limited to 'files/slackpkg.conf.5') 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) -- cgit v1.2.3