.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "CUPT.CONF 5"
.TH CUPT.CONF 5 "2020-12-27" "perl v5.32.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
cupt.conf \- configuration file for Cupt
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\f(CW$APT_CONFIG\fR, /etc/apt/apt.conf, /etc/apt/apt.conf.d/*,
\&\f(CW$CUPT_PRE_CONFIG\fR, /etc/cupt/pre.conf, /etc/cupt/cupt.conf, /etc/cupt/cupt.conf.d/*
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Cupt uses the same configuration syntax as \fBapt.conf\fR\|(5), which see.
.SH "CONFIGURATION VARIABLES"
.IX Header "CONFIGURATION VARIABLES"
Firstly, Cupt uses following \s-1APT\s0 configuration variables:
.PP
acquire::*::dl\-limit, acquire::*::timeout, acquire::*::proxy,
acquire::http::allowredirect, acquire::retries, apt::cache::allversions,
apt::cache::important, apt::cache::namesonly, apt::cache::recursedepends,
apt::default\-release, apt::install\-recommends, apt::install\-suggests,
apt::neverautoremove, apt::get::assume\-yes, apt::get::allowunauthenticated,
apt::get::automaticremove, apt::get::list\-cleanup, apt::get::purge,
apt::update::pre\-invoke, apt::update::post\-invoke,
apt::update::post\-invoke\-success, dir, dir::bin::dpkg, dir::cache,
dir::cache::archives, dir::etc, dir::etc::sourcelist, dir::etc::sourceparts,
dir::etc::parts, dir::etc::main, dir::etc::preferences,
dir::ignore\-files\-silently, dir::state, dir::state::extendedstates,
dir::state::status, dir::etc::trusted, dir::etc::trustedparts
dpkg::options, dpkg::pre\-invoke, dpkg::post\-invoke,
dpkg::pre\-install\-pkgs, quiet
.PP
See \fBapt.conf\fR\|(5) for their meanings.
.PP
Secondly, Cupt introduces cupt-specific configuration variables.
.SS "variable types"
.IX Subsection "variable types"
.IP "boolean" 4
.IX Item "boolean"
false may be specified as \*(L"0\*(R" or \*(L"false\*(R" or \*(L"no\*(R", everything else interpretes as true
.Sp
if undefined, interpretes as false
.IP "integer" 4
.IX Item "integer"
signed 32\-bit integer on 32\-bit systems, signed 64\-bit integer on 64\-bit systems
.Sp
if undefined, interpretes as 0
.IP "string" 4
.IX Item "string"
interpreted as is
.Sp
if undefined, interpretes as empty string
.IP "list" 4
.IX Item "list"
list of strings
.Sp
if undefined, intepretes as empty list
.SS "variables"
.IX Subsection "variables"
.IP "cupt::cache::limit\-releases::by\-*::type" 4
.IX Item "cupt::cache::limit-releases::by-*::type"
string, determines the type of limiting repository releases to use
.Sp
All repository indexes which are disallowed by this option are not added to
the package cache, in other words, they are completely hidden.
.Sp
\&'*' can be 'archive' or 'codename'
.Sp
Possible values:
.RS 4
.IP "none" 4
.IX Item "none"
No limiting will be done for this category. The default.
.IP "include" 4
.IX Item "include"
Only values of the 'cupt::cache::limit\-releases::by\-*' option will be allowed.
.IP "exclude" 4
.IX Item "exclude"
Only values which are not present in the value of the 'cupt::cache::limit\-releases::by\-*' option will be allowed.
.RE
.RS 4
.Sp
Example:
.Sp
If you set 'cupt::cache::limit\-releases::by\-archive::type' to 'include' and
\&'cupt::cache::limit\-releases::by\-archive' to '{ \*(L"stable\*(R", \*(L"testing\*(R" };', only
repositories with archive names 'stable' and 'testing' will be added to the
cache.
.RE
.IP "cupt::cache::limit\-releases::by\-*" 4
.IX Item "cupt::cache::limit-releases::by-*"
list of allowed/disallowed release attributes, see above
.IP "cupt::cache::pin::addendums::but\-automatic\-upgrades" 4
.IX Item "cupt::cache::pin::addendums::but-automatic-upgrades"
integer, specifies priority change for versions that come only from sources
which have both 'not automatic' and 'but automatic upgrades' flags.
Defaults to 4200.
.IP "cupt::cache::pin::addendums::downgrade" 4
.IX Item "cupt::cache::pin::addendums::downgrade"
integer, specifies priority change for versions that are smaller than currently
installed. Defaults to \-10000.
.IP "cupt::cache::pin::addendums::hold" 4
.IX Item "cupt::cache::pin::addendums::hold"
integer, specifies priority increase for versions that are put on hold.
Defaults to 1000000. Set this option to 0 if you do not want to obey holds.
You may want to increase this option in (very unlikely to happen) situations:
when you have thousands of manually installed packages and very large query;
when you have a manually crafted pin priorities system with very large pin
values.
.IP "cupt::cache::pin::addendums::not\-automatic" 4
.IX Item "cupt::cache::pin::addendums::not-automatic"
integer, specifies priority increase for versions that come only from 'not
automatic' sources. Defaults to \-4000.
.Sp
If you change the value of this option, you might want to change the value of
the option \*(L"cupt::cache::pin::addendums::but\-automatic\-upgrades\*(R"
accordingly.
.IP "cupt::cache::release\-file\-expiration::ignore" 4
.IX Item "cupt::cache::release-file-expiration::ignore"
boolean, if set to true, Cupt will ignore the fact that a Release file is
expired and use it anyway. False by default.
.Sp
\&\fBWarning! Setting this option to true will make the system vulnerable to a replay attack on package manager indexes.\fR
.IP "cupt::console::allow\-untrusted" 4
.IX Item "cupt::console::allow-untrusted"
boolean, don't treat using untrusted packages as dangerous action
.IP "cupt::console::assume\-yes" 4
.IX Item "cupt::console::assume-yes"
boolean, see \fBcupt\fR\|(1) \-\-assume\-yes
.IP "cupt::console::actions\-preview::package\-indicators::manually\-installed" 4
.IX Item "cupt::console::actions-preview::package-indicators::manually-installed"
boolean, whether to print \f(CW\*(C`{m}\*(C'\fR prefix for manually installed packages
in non-color mode. Enabled by default.
.IP "cupt::console::actions\-preview::package\-indicators::automatically\-installed" 4
.IX Item "cupt::console::actions-preview::package-indicators::automatically-installed"
boolean, whether to print \f(CW\*(C`{a}\*(C'\fR prefix for automatically installed packages
in non-color mode. Disabled by default.
.IP "cupt::console::actions\-preview::show\-not\-preferred" 4
.IX Item "cupt::console::actions-preview::show-not-preferred"
string, determines whether packages which will have a not preferred version
after the proposed changes are done should be shown in the actions preview.
Defaults to 'for\-upgrades'.
.Sp
Possible values:
.RS 4
.IP "no" 4
.IX Item "no"
Do not show.
.IP "for-upgrades" 4
.IX Item "for-upgrades"
Show for upgrade subcommands (namely, for \*(L"full-upgrade\*(R", \*(L"safe-upgrade\*(R"
and the second part of \*(L"dist-upgrade\*(R").
.IP "yes" 4
.IX Item "yes"
Show always.
.RE
.RS 4
.RE
.IP "cupt::console::actions\-preview::show\-archives" 4
.IX Item "cupt::console::actions-preview::show-archives"
boolean, if true, release archive(s) will be shown for each package in the
actions preview. False by default.
.IP "cupt::console::actions\-preview::show\-codenames" 4
.IX Item "cupt::console::actions-preview::show-codenames"
boolean, if true, release codename(s) will be shown for each package in the
actions preview. False by default.
.IP "cupt::console::actions\-preview::show\-components" 4
.IX Item "cupt::console::actions-preview::show-components"
boolean, if true, release component(s) will be shown for each package in the
actions preview. False by default.
.IP "cupt::console::actions\-preview::show\-details" 4
.IX Item "cupt::console::actions-preview::show-details"
boolean, if true, details of planned actions will be shown in the
actions preview. True by default.
.IP "cupt::console::actions\-preview::show\-empty\-versions" 4
.IX Item "cupt::console::actions-preview::show-empty-versions"
boolean, if true, empty versions (i.e. removed or not installed packages) will
be shown as '<empty>' instead of being omitted
.IP "cupt::console::actions\-preview::show\-size\-changes" 4
.IX Item "cupt::console::actions-preview::show-size-changes"
boolean, if true, a change in the disk space usage will be shown for each
package in the actions preview. False by default.
.IP "cupt::console::actions\-preview::show\-reasons" 4
.IX Item "cupt::console::actions-preview::show-reasons"
boolean, see \fBcupt\fR\|(1) \-\-show\-reasons
.IP "cupt::console::actions\-preview::show\-summary" 4
.IX Item "cupt::console::actions-preview::show-summary"
string, tristate (\*(L"yes\*(R", \*(L"no\*(R" or \*(L"auto\*(R"), controls whether summary of planned
actions will be shown in the actions preview or not. Defaults to \*(L"yes\*(R".
.Sp
Currently, \*(L"auto\*(R" means that summary will be shown when there are >= 100 change
entries in total.
.IP "cupt::console::actions\-preview::show\-versions" 4
.IX Item "cupt::console::actions-preview::show-versions"
boolean, if true, a version will be shown for each package in the
actions preview. False by default.
.IP "cupt::console::actions\-preview::show\-vendors" 4
.IX Item "cupt::console::actions-preview::show-vendors"
boolean, if true, a version will be shown for each package in the actions
preview. False by default.
.IP "cupt::console::show\-progress\-messages" 4
.IX Item "cupt::console::show-progress-messages"
boolean, if true, package management actions will print stage messages
(\*(L"Building a cache\*(R", \*(L"Resolving possible unmet dependencies\*(R" etc.). True by default.
.IP "cupt::console::use\-colors" 4
.IX Item "cupt::console::use-colors"
string, specifies whether to use colors in the console interface. Defaults to
\&\*(L"auto\*(R".
.Sp
For now concerns only the action preview.
.Sp
Available values:
.RS 4
.IP "no" 4
.IX Item "no"
Don't use colors.
.IP "yes" 4
.IX Item "yes"
Use colors.
.IP "auto" 4
.IX Item "auto"
Use colors if the standard output is a terminal and a terminal type seem to
allow colors.
.RE
.RS 4
.RE
.IP "cupt::console::warnings::removal\-of\-essential" 4
.IX Item "cupt::console::warnings::removal-of-essential"
boolean, treat removals of essential packages as dangerous action. True
by default.
.IP "cupt::console::warnings::removal\-of\-important" 4
.IX Item "cupt::console::warnings::removal-of-important"
boolean, treat removals of important packages as dangreous action. True
by default.
.IP "cupt::directory" 4
.IX Item "cupt::directory"
string, base directory for all cupt::directory::* options
.IP "cupt::directory::configuration" 4
.IX Item "cupt::directory::configuration"
string, base directory for Cupt-specific configuration files
.IP "cupt::directory::configuration::main" 4
.IX Item "cupt::directory::configuration::main"
string, relative file path for the Cupt main configuration file (same format as
\&\fBapt.conf\fR\|(5))
.IP "cupt::directory::configuration::main\-parts" 4
.IX Item "cupt::directory::configuration::main-parts"
string, relative directory path for additional Cupt configuration files (same
format as \fBapt.conf\fR\|(5))
.IP "cupt::directory::configuration::pre" 4
.IX Item "cupt::directory::configuration::pre"
string, relative file path for the Cupt preconfiguration file which is read
before paths of any other configuration files are calculated. This is the only
place where one can effectively override default values of dir::etc and
cupt::directory::configuration options and/or their suboptions. The
environment variable \fB\s-1CUPT_PRE_CONFIG\s0\fR overrides this option if defined.
.IP "cupt::directory::log" 4
.IX Item "cupt::directory::log"
string, relative file path for the log file
.IP "cupt::directory::state" 4
.IX Item "cupt::directory::state"
string, directory which contains Cupt state info
.IP "cupt::directory::state::lists" 4
.IX Item "cupt::directory::state::lists"
string, directory for repository indexes
.IP "cupt::downloader::max\-simultaneous\-downloads" 4
.IX Item "cupt::downloader::max-simultaneous-downloads"
integer, positive, specifies maximum number of simultaneous downloads. Defaults to 2.
.IP "cupt::downloader::protocols::\fIprotocol\fR::priority" 4
.IX Item "cupt::downloader::protocols::protocol::priority"
integer, positive, defines the priority of download protocol \fIprotocol\fR, determines an order in which
different URIs for the same file will be tried. Defaults to 100.
.IP "cupt::downloader::protocols::\fIprotocol\fR::methods::\fImethod\fR::priority" 4
.IX Item "cupt::downloader::protocols::protocol::methods::method::priority"
positive number, defines the priority of download method \fImethod\fR, the method
with maximum priority will be used for downloading the \s-1URI\s0 of protocol
\&\fIprotocol\fR.
Defaults to 100.
.IP "cupt::downloader::protocols::\fIprotocol\fR::methods" 4
.IX Item "cupt::downloader::protocols::protocol::methods"
list, names of the methods available to download protocol \fIprotocol\fR
.IP "cupt::languages::indexes" 4
.IX Item "cupt::languages::indexes"
string, specifies localizations of what languages should be used for repository
indexes. Defaults to \*(L"environment,en\*(R".
.Sp
The value is comma-delimited (no spaces allowed) list of localization specificators. Localization specificator is either:
.RS 4
.IP "environment" 4
.IX Item "environment"
A special string which is substituted by the current locale (precisely, by a
value of the environment variable \s-1LC_MESSAGES\s0).
.IP "none" 4
.IX Item "none"
A special string which indicates no localization.
.IP "\fIlanguage_code\fR[_\fIcountry_code\fR]" 4
.IX Item "language_code[_country_code]"
A language code (for example: 'fi', 'fr', 'ru') or a language code with a
country code (for example, 'pt_BR', 'zh_CN').
.RE
.RS 4
.Sp
If the localization specificator contains a country code, the additional
specificator without a country code will be implicitly used as fallback.
.Sp
Localization specificators should be listed in the preference order. Duplicates
are allowed but ignored.
.Sp
Examples:
.IP "fi,ru,fr" 4
.IX Item "fi,ru,fr"
Download Finnish, Russian and French translations. For every description, try
to use Finnish translation; if it's not available, try to use Russian one; if
it's also not available; try to use French one; else use an original one.
.IP "pt_BR" 4
.IX Item "pt_BR"
Download Portuguese (Brazil) and Portuguese localizations. Use Portuguese
(Brazil) translation; if it's not available, use Portuguese translation; else
use an original one.
.IP "de,environment,fr_FR" 4
.IX Item "de,environment,fr_FR"
(Supposing \s-1LC_MESSAGES\s0 is 'pl_PL.UTF\-8')
.Sp
Download and use these translations, in the following order: German, Polish
(Poland), Polish, French (France), French.
.RE
.RS 4
.RE
.IP "cupt::update::check\-release\-files" 4
.IX Item "cupt::update::check-release-files"
boolean, if set, Release files will be checked for the validity (including the
expiration check and a signature if present) at the download stage. True by default.
.IP "cupt::update::compression\-types::*::priority" 4
.IX Item "cupt::update::compression-types::*::priority"
integer, defines preference to download compressed files with higher priority first. 100 by default.
.Sp
\&'*' can be 'gz', 'bz2', 'lzma', 'xz', and 'uncompressed'.
.Sp
Set some option to <100 value to make it low-precedence than default, and >100
to make it high-precedence than default.
.Sp
If some methods have the equal priority (which is the default setting), then
files with smaller size with be chosen over the files with bigger size.
.Sp
Example:
.Sp
You have a low-speed \s-1CPU\s0 but rather high-speed internet connection and want to
prefer gzip over lzma and lzma over bzip2. Then you have to set options like:
.Sp
.Vb 5
\&  cupt::update::compression\-types
\&  {
\&    gz::priority "200";
\&    lzma::priority "150";
\&  }
.Ve
.Sp
Also, if you have a local mirror, which may store uncompressed indexes too
(an official Debian archive doesn't store them), you may set also
.Sp
cupt::update::compression\-types::uncompressed::priority \*(L"300\*(R";
.IP "cupt::update::generate\-index\-of\-index" 4
.IX Item "cupt::update::generate-index-of-index"
boolean, specifies whether to build \*(L"index-of-index\*(R" for every Packages and
Sources. If set to true, slightly increases the time of postprocessing after
downloading new metadata files but speedes up significantly the initialization
time for every invocation. True by default.
.IP "cupt::update::use\-index\-diffs" 4
.IX Item "cupt::update::use-index-diffs"
boolean, specifies whether to try downloading repository index deltas and apply
them locally before downloading the full index. True by default.
.Sp
When turned on, this option saves bandwidth but increases \s-1CPU\s0 and disk usage
while updating. On the fast unlimited connections (say, >= 2 Mbit/s, but
heavily depends on many other factors) you would likely want to turn off this
option.
.IP "cupt::resolver::keep\-recommends" 4
.IX Item "cupt::resolver::keep-recommends"
boolean, specifies whether should resolver try to keep already installed
recommended packages or not. True by default.
.IP "cupt::resolver::keep\-suggests" 4
.IX Item "cupt::resolver::keep-suggests"
boolean, specifies whether should resolver try to keep already installed
suggested packages or not. False by default.
.IP "cupt::resolver::auto\-remove" 4
.IX Item "cupt::resolver::auto-remove"
boolean, see \fBcupt\fR\|(1) \-\-no\-auto\-remove
.IP "cupt::resolver::max\-leaf\-count" 4
.IX Item "cupt::resolver::max-leaf-count"
integer, specifies how many leaves the solution tree will grow before resolver
will give up. \-1 means infinite. \-1 by default.
.IP "cupt::resolver::max\-solution\-count" 4
.IX Item "cupt::resolver::max-solution-count"
integer, positive, see \fBcupt\fR\|(1) \-\-max\-solution\-count
.IP "cupt::resolver::no\-autoremove\-if\-rdepends\-exist" 4
.IX Item "cupt::resolver::no-autoremove-if-rdepends-exist"
list of regular expressions; if the package name matches to any of those
regular expressions it will be not considered for auto-removal if there are any
reverse dependencies installed. Empty by default.
.Sp
Example (simplified real situation):
.Sp
.Vb 2
\& Package: xserver\-xorg
\& Depends: xserver\-xorg\-video\-all | xorg\-driver\-video
\& 
\& Package: xserver\-xorg\-video\-nv
\& Provides: xorg\-driver\-video
\& 
\& Package: xserver\-xorg\-video\-radeon
\& Provides: xorg\-driver\-video
\& 
\& You have:
\& xserver\-xorg: manually installed
\& xserver\-xorg\-video\-all: not installed
\& xserver\-xorg\-video\-nv: automatically installed
\& xserver\-xorg\-video\-radeon: automatically installed
.Ve
.Sp
Both xserver-xorg-video-nv and xserver-xorg-video-radeon satisfy the dependency
of xserver-xorg, so only one of them is needed in the system. Therefore, by
default one of these two will be considered for auto-removal. If you add a
regular expression 'xserver\-xorg\-video.*' to the value of this option, none of
packages providing xorg-driver-video will be considered for auto-removal as
long as xserver-xorg is installed.
.IP "cupt::resolver::no\-remove" 4
.IX Item "cupt::resolver::no-remove"
boolean, see \fBcupt\fR\|(1) \-\-no\-remove
.IP "cupt::resolver::synchronize\-by\-source\-versions" 4
.IX Item "cupt::resolver::synchronize-by-source-versions"
string, this option controls whether and how the native resolver will attempt to keep
all binary packages from the same source package at the same source version
.Sp
This option uses the information from source packages. No synchronization will
be performed for the versions which have not a corresponding source version in
the repository.
.Sp
Possible values:
.RS 4
.IP "none" 4
.IX Item "none"
Don't attempt to synchronize. This is the default value.
.IP "soft" 4
.IX Item "soft"
Don't forbid any modifications to the packages and attempt to synchronize
related binary packages when possible upon the modifications of certain binary
package.
.IP "hard" 4
.IX Item "hard"
Forbid any modifications to the packages when at least one related binary
package cannot be synchronized with the modified one.
.RE
.RS 4
.RE
.IP "cupt::resolver::track\-reasons" 4
.IX Item "cupt::resolver::track-reasons"
boolean, specifies whether 'suggestedPackages::reasons' is filled in the Resolver::Offer. False by default.
.IP "cupt::resolver::type" 4
.IX Item "cupt::resolver::type"
string, see \fBcupt\fR\|(1) \-\-resolver
.IP "cupt::resolver::score::<part>" 4
.IX Item "cupt::resolver::score::<part>"
The group of integer options which control internal resolver's score
calculation. Values are absolute.
.Sp
<part> can be one of:
.RS 4
.IP "new" 4
.IX Item "new"
installing a new package
.IP "removal" 4
.IX Item "removal"
removal of an existing package
.IP "removal-of-essential" 4
.IX Item "removal-of-essential"
removal of an existing essential package (a general \fBremoval\fR option is applied as well)
.IP "removal-of-autoinstalled" 4
.IX Item "removal-of-autoinstalled"
removal of an automatically installed package (a general \fBremoval\fR option is applied as well)
.IP "upgrade" 4
.IX Item "upgrade"
installing a higher version of an existing package
.IP "downgrade" 4
.IX Item "downgrade"
installing a lower version of an existing package
.IP "position-penalty" 4
.IX Item "position-penalty"
when several actions may be performed to resolve a problem, apply N penalties
to N\-th action (counting from 0)
.IP "quality-adjustment" 4
.IX Item "quality-adjustment"
the value will be added to each action's score
.IP "unsatisfied-recommends" 4
.IX Item "unsatisfied-recommends"
some 'recommends' dependency is not satisfied (when requested)
.IP "unsatisfied-suggests" 4
.IX Item "unsatisfied-suggests"
some 'suggests' dependency is not satisfied (when requested)
.IP "failed-synchronization" 4
.IX Item "failed-synchronization"
some source version synchronization cannot be performed (when
cupt::resolver::synchronize\-source\-versions
is 'soft')
.IP "version\-factor::common" 4
.IX Item "version-factor::common"
defines (in percents), how much version score difference affects the action score
.IP "version\-factor::negative" 4
.IX Item "version-factor::negative"
defines (in percents) scaling of negative version scores (applied after
\&\fBversion-factor\fR)
.IP "version\-factor::priority\-downgrade" 4
.IX Item "version-factor::priority-downgrade"
defines (in percents) scaling of version score if version priority difference
is negative. For calculations regarding this factor, if there is no original
version, its priority is 0, if there is no supposed version, its priority is
the default priority for versions from a default package archive.
.RE
.RS 4
.RE
.IP "cupt::worker::archives\-space\-limit" 4
.IX Item "cupt::worker::archives-space-limit"
integer, bytes, positive, if set, limits the worker to not download more than specified
amount of archives, and use download-install-clean algorithm (download
archives, install packages, clean just downloaded archives).  Worker will try
to split all actions into unrelated changesets so each changeset require only
limited download space. Any system changes will be started only if changesets
are generated successfully.
.IP "cupt::worker::defer\-triggers" 4
.IX Item "cupt::worker::defer-triggers"
string, specifies whether should worker defer dpkg trigger processing to
the end of the whole operation or not. When enabled, speeds up
large-amount actions, but if the operation will somewhy be interrupted, leaves
system in the interim trigger state, which can be fixed by manual run of 'dpkg
\&\-\-triggers\-only \-\-pending' command. Defaults to \*(L"auto\*(R".
.Sp
Available values:
.RS 4
.IP "no" 4
.IX Item "no"
Disable deferring triggers.
.IP "yes" 4
.IX Item "yes"
Enable deferring triggers.
.IP "auto" 4
.IX Item "auto"
Enable deferring triggers if enough recent version of dpkg (1.16.1, where
tiresome trigger-related bug (Debian \s-1BTS\s0 #526774) is fixed) is installed.
.RE
.RS 4
.RE
.IP "cupt::worker::download\-only" 4
.IX Item "cupt::worker::download-only"
boolean, see \fBcupt\fR\|(1) \-\-download\-only
.IP "cupt::worker::log" 4
.IX Item "cupt::worker::log"
boolean, whether to log performed actions or not. True by default.
.IP "cupt::worker::log::levels::metadata" 4
.IX Item "cupt::worker::log::levels::metadata"
non-negative integer, the log level for the metadata updates. 1 by default.
.IP "cupt::worker::log::levels::packages" 4
.IX Item "cupt::worker::log::levels::packages"
non-negative integer, the log level for the package changes
(install/upgrade/remove etc.). 2 by default.
.IP "cupt::worker::log::levels::snapshots" 4
.IX Item "cupt::worker::log::levels::snapshots"
non-negative integer, the log level for the snapshot actions. 1 by default.
.IP "cupt::worker::purge" 4
.IX Item "cupt::worker::purge"
boolean, specifies whether purge packages in addition to removing or not.
False by default.
.IP "cupt::worker::simulate" 4
.IX Item "cupt::worker::simulate"
boolean, see \fBcupt\fR\|(1) \-\-simulate
.IP "cupt::worker::use\-locks" 4
.IX Item "cupt::worker::use-locks"
boolean, specifies whether Cupt protects simultaneous runs of itself against
the misuse of the common resources. True by default.
.Sp
\&\fBWarning! Setting this option to false will allow several non-simulating Cupt
instances to break the system when misused.\fR
.IP "debug::resolver" 4
.IX Item "debug::resolver"
boolean, if true, resolver will print a lot of debug information to the
standard error. False by default.
.IP "debug::worker" 4
.IX Item "debug::worker"
boolean, if true, worker will print some debug information to the
standard error. False by default.
.IP "debug::gpgv" 4
.IX Item "debug::gpgv"
boolean, if true, cache will print some debug information while verifying
signatures to the standard error. False by default.
.IP "debug::downloader" 4
.IX Item "debug::downloader"
boolean, if true, the downloader manager will print some debug messages. False
by default.
.IP "debug::logger" 4
.IX Item "debug::logger"
boolean, if true, the logger will print some debug messages. False by default.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBcupt\fR\|(1), \fBapt.conf\fR\|(5)