Provided by: cupt_2.3.2_i386 bug

NAME

       cupt.conf - configuration file for Cupt

SYNOPSIS

       $APT_CONFIG, /etc/apt/apt.conf, /etc/apt/apt.conf.d/*,
       /etc/cupt/cupt.conf, /etc/cupt/cupt.conf.d/*

DESCRIPTION

       Cupt uses the same configuration syntax as apt.conf(5), which see.

CONFIGURATION VARIABLES

       Firstly, Cupt uses following APT configuration variables:

       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::state,
       dir::state::extendedstates, dir::state::status, dpkg::options,
       dpkg::pre-invoke, dpkg::post-invoke, dpkg::pre-install-pkgs,
       gpgv::trustedkeyring, quiet

       See apt.conf(5) for their meanings.

       Secondly, Cupt recognizes (but doesn't use) following configuration
       variables:

       apt::acquire::translation, apt::archives::*, acquire::pdiffs,
       acquire::languages, apt::cache-limit, apt::periodic::*, dir::log*,
       dir::state::lists, unattended-upgrade::*, acquire::compressiontypes,
       apt::get::show-upgraded, apt::get::build-dep-automatic,
       rpm::pre-invoke, rpm::post-invoke

       Thirdly, Cupt introduces cupt-specific configuration variables.

   variable types
       boolean
           false may be specified as "0" or "false" or "no", everything else
           interpretes as true

           if undefined, interpretes as false

       integer
           signed 32-bit integer on 32-bit systems, signed 64-bit integer on
           64-bit systems

           if undefined, interpretes as 0

       string
           interpreted as is

           if undefined, interpretes as empty string

       list
           list of strings

           if undefined, intepretes as empty list

   variables
       cupt::cache::limit-releases::by-*::type
           string, determines the type of limiting repository releases to use

           All repository indexes which are disallowed by this option are not
           added to the package cache, in other words, they are completely
           hidden.

           '*' can be 'archive' or 'codename'

           Possible values:

           none
               No limiting will be done for this category. The default.

           include
               Only values of the 'cupt::cache::limit-releases::by-*' option
               will be allowed.

           exclude
               Only values which are not present in the value of the
               'cupt::cache::limit-releases::by-*' option will be allowed.

           Example:

           If you set 'cupt::cache::limit-releases::by-archive::type' to
           'include' and 'cupt::cache::limit-releases::by-archive' to '{
           "stable", "testing" };', only repositories with archive names
           'stable' and 'testing' will be added to the cache.

       cupt::cache::limit-releases::by-*
           list of allowed/disallowed release attributes, see above

       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.

       cupt::cache::pin::addendums::downgrade
           integer, specifies priority change for versions that are smaller
           than currently installed. Defaults to -10000.

       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.

       cupt::cache::pin::addendums::not-automatic
           integer, specifies priority increase for versions that come only
           from 'not automatic' sources. Defaults to -4000.

           If you change the value of this option, you might want to change
           the value of the option
           "cupt::cache::pin::addendums::but-automatic-upgrades" accordingly.

       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.

           Warning! Setting this option to true will make the system
           vulnerable to a replay attack on package manager indexes.

       cupt::console::allow-untrusted
           boolean, don't treat using untrusted packages as dangerous action

       cupt::console::assume-yes
           boolean, see cupt(1) --assume-yes

       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'.

           Possible values:

           no  Do not show.

           for-upgrades
               Show for upgrade subcommands (namely, for "full-upgrade",
               "safe-upgrade" and the second part of "dist-upgrade").

           yes Show always.

       cupt::console::actions-preview::show-details
           boolean, if true, details of planned actions will be shown in the
           actions preview. True by default.

       cupt::console::actions-preview::show-summary
           boolean, if true, a summary of planned actions will be shown in the
           actions preview. True by default.

       cupt::console::use-colors
           string, specifies whether to use colors in the console interface.
           Defaults to "auto".

           For now concerns only the action preview.

           Available values:

           no  Don't use colors.

           yes Use colors.

           auto
               Use colors if the standard output is a terminal and a terminal
               type seem to allow colors.

       cupt::directory
           string, base directory for all cupt::directory::* options

       cupt::directory::configuration
           string, base directory for Cupt-specific configuration files

       cupt::directory::configuration::main
           string, relative file path for the Cupt main configuration file
           (same format as apt.conf(5))

       cupt::directory::configuration::main-parts
           string, relative directory path for additional Cupt configuration
           files (same format as apt.conf(5))

       cupt::directory::log
           string, relative file path for the log file

       cupt::directory::state
           string, directory which contains Cupt state info

       cupt::directory::state::lists
           string, directory for repository indexes

       cupt::downloader::max-simultaneous-downloads
           integer, positive, specifies maximum number of simultaneous
           downloads. Defaults to 2.

       cupt::downloader::protocols::protocol::priority
           integer, positive, defines the priority of download protocol
           protocol, determines an order in which different URIs for the same
           file will be tried. Defaults to 100.

       cupt::downloader::protocols::protocol::methods::method::priority
           positive number, defines the priority of download method method,
           the method with maximum priority will be used for downloading the
           URI of protocol protocol.  Defaults to 100.

       cupt::downloader::protocols::protocol::methods
           list, names of the methods available to download protocol protocol

       cupt::languages::indexes
           string, specifies localizations of what languages should be used
           for repository indexes. Defaults to "environment".

           The value is comma-delimited (no spaces allowed) list of
           localization specificators. Localization specificator is either:

           environment
               A special string which is substituted by the current locale
               (precisely, by a value of the environment variable
               LC_MESSAGES).

           none
               A special string which indicates no localization.

           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').

           If the localization specificator contains a country code, the
           additional specificator without a country code will be implicitly
           used as fallback.

           Localization specificators should be listed in the preference
           order. Duplicates are allowed but ignored.

           Examples:

           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.

           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.

           de,environment,fr_FR
               (Supposing LC_MESSAGES is 'pl_PL.UTF-8')

               Download and use these translations, in the following order:
               German, Polish (Poland), Polish, French (France), French.

       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.

       cupt::update::compression-types::*::priority
           integer, defines preference to download compressed files with
           higher priority first. 100 by default.

           '*' can be 'gz', 'bz2', 'lzma', 'xz', and 'uncompressed'.

           Set some option to <100 value to make it low-precedence than
           default, and >100 to make it high-precedence than default.

           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.

           Example:

           You have a low-speed CPU but rather high-speed internet connection
           and want to prefer gzip over lzma and lzma over bzip2. Then you
           have to set options like:

             cupt::update::compression-types
             {
               gz::priority "200";
               lzma::priority "150";
             }

           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

           cupt::update::compression-types::uncompressed::priority "300";

       cupt::update::keep-bad-signatures
           boolean, specifies whether to keep signature files that failed GPG
           check when doing update. True by default. Setting this option to
           false will not have an effect if the option
           cupt::update::check-release-files is set to false.

       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.

           When turned on, this option saves bandwidth but increases CPU 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.

       cupt::resolver::keep-recommends
           boolean, specifies whether should resolver try to keep already
           installed recommended packages or not. True by default.

       cupt::resolver::keep-suggests
           boolean, specifies whether should resolver try to keep already
           installed suggested packages or not. False by default.

       cupt::resolver::auto-remove
           boolean, see cupt(1) --no-auto-remove/

       cupt::resolver::max-solution-count
           integer, positive, see cupt(1) --max-solution-count

       cupt::resolver::no-remove
           boolean, see cupt(1) --no-remove

       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

           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.

           Possible values:

           none
               Don't attempt to synchronize. This is the default value.

           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.

           hard
               Forbid any modifications to the packages when at least one
               related binary package cannot be synchronized with the modified
               one.

       cupt::resolver::track-reasons
           boolean, see cupt(1) --show-reasons

       cupt::resolver::type
           string, see cupt(1) --resolver

       cupt::resolver::score::<part>
           The group of integer options which control internal resolver's
           score calculation. Values are absolute.

           <part> can be one of:

           new installing a new package

           removal
               removal of an existing package

           removal-of-essential
               removal of an existing essential package (a general removal
               option is applied as well)

           upgrade
               installing a higher version of an existing package

           downgrade
               installing a lower version of an existing package

           position-penalty
               when several actions may be performed to resolve a problem,
               apply N penalties to N-th action (counting from 0)

           quality-adjustment
               the value will be added to each action's score

           unsatisfied-recommends
               some 'recommends' dependency is not satisfied (when requested)

           unsatisfied-suggests
               some 'suggests' dependency is not satisfied (when requested)

           failed-synchronization
               some source version synchronization cannot be performed (when
               cupt::resolver::synchronize-source-versions is 'soft')

       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.

       cupt::worker::defer-triggers
           boolean, specifies whether should worker defer dpkg trigger
           processing to the end of the whole operation or not. Being set to
           true, 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. False by default due to tiresome dpkg bug
           (Debian BTS #526774).

       cupt::worker::download-only
           boolean, see cupt(1) --download-only

       cupt::worker::log
           boolean, whether to log performed actions or not. True by default.

       cupt::worker::log::levels::metadata
           non-negative integer, the log level for the metadata updates. 1 by
           default.

       cupt::worker::log::levels::packages
           non-negative integer, the log level for the package changes
           (install/upgrade/remove etc.). 2 by default.

       cupt::worker::log::levels::snapshots
           non-negative integer, the log level for the snapshot actions. 1 by
           default.

       cupt::worker::purge
           boolean, specifies whether purge packages in addition to removing
           or not.  False by default.

       cupt::worker::simulate
           boolean, see cupt(1) --simulate

       cupt::worker::use-locks
           boolean, specifies whether Cupt protects simultaneous runs of
           itself against the misuse of the common resources. True by default.

           Warning! Setting this option to false will allow several non-
           simulating Cupt instances to break the system when misused.

       debug::resolver
           boolean, if true, resolver will print a lot of debug information to
           the standard error. False by default.

       debug::worker
           boolean, if true, worker will print some debug information to the
           standard error. False by default.

       debug::gpgv
           boolean, if true, cache will print some debug information while
           verifying signatures to the standard error. False by default.

       debug::downloader
           boolean, if true, the downloader manager will print some debug
           messages. False by default.

       debug::logger
           boolean, if true, the logger will print some debug messages. False
           by default.

SEE ALSO

       cupt(1), apt.conf(5)