Imported Upstream version 16.5.0
[platform/upstream/libzypp.git] / zypp.conf
index 7f737dc..62c6eb9 100644 (file)
--- a/zypp.conf
+++ b/zypp.conf
 ## minutes. If an automatic request for refresh comes before <repo.refresh.delay>
 ## minutes passed since the last check, the request is ignored.
 ##
-## A value of 0 means the repository will always be checked. To get the oposite
+## A value of 0 means the repository will always be checked. To get the opposite
 ## effect, disable autorefresh for your repositories.
 ##
 ## This option has no effect for repositories with autorefresh disabled, nor for
 ## Default value: RequestedLocales
 ##
 ## If data for a specific locale are not available, we try to find some
-## fallback. Translationss for 'en' are always downloaded.
+## fallback. Translations for 'en' are always downloaded.
 ##
 # repo.refresh.locales = en, de
 
 # download.max_silent_tries = 5
 
 ##
+## Maximum time in seconds that you allow a transfer operation to take.
+##
+## This is useful for preventing your batch jobs from hanging for hours due
+## to slow networks or links going down. Limiting operations to less than a
+## few minutes risk aborting perfectly normal operations.
+##
+## Valid values:  [0,3600]
+## Default value: 180
+##
+# download.transfer_timeout = 180
+
+##
 ## Whether to consider using a .delta.rpm when downloading a package
 ##
 ## Valid values: boolean
 ## download.media_preference = download
 
 ##
+## Path where media are preferably mounted or downloaded
+##
+## Valid values:       A (writable) directory
+## Default value:      /var/adm/mount
+##
+## The media backend will try to organize media mount points and download areas
+## below this directory, unless a different location is requested by the application.
+##
+## If the directory is not accessible and read/writable for a specific user,
+## the fallback is to use /var/tmp.
+##
+## download.media_mountdir = /var/adm/mount
+
+##
+## Signature checking (repodata and rpm packages)
+##
+##   boolean   gpgcheck        (default: on)
+##   boolean   repo_gpgcheck   (default: unset -> according to gpgcheck)
+##   boolean   pkg_gpgcheck    (default: unset -> according to gpgcheck)
+##
+## If 'gpgcheck' is 'on' we will either check the signature of repo metadata
+## (packages are secured via checksum in the metadata), or the signature of
+## an rpm package to install if it's repo metadata are not signed or not
+## checked.
+##
+## The default behavior can be altered by explicitly setting 'repo_gpgcheck' and/or
+## 'pkg_gpgcheck' to perform those checks always (if 'on') or never (if 'off').
+##
+## Explicitly setting 'gpgcheck', 'repo_gpgcheck' 'pkg_gpgcheck' in a
+## repositories .repo file will overwrite the defaults here.
+##
+##   DISABLING GPG CHECKS IS NOT RECOMMENDED.
+##   Signing data enables the recipient to verify that no modifications
+##   occurred after the data were signed. Accepting data with no, wrong
+##   or unknown signature can lead to a corrupted system and in extreme
+##   cases even to a system compromise.
+##
+# repo_gpgcheck = unset -> according to gpgcheck
+# pkg_gpgcheck =  unset -> according to gpgcheck
+
+##
 ## Commit download policy to use as default.
 ##
 ##  DownloadOnly,      Just download all packages to the local cache.
 # solver.allowVendorChange = false
 
 ##
+## EXPERTS ONLY: TUNE DISTRIBUTION UPGRADE (DUP)
+## Set whether to allow package version downgrades upon DUP.
+##
+## CHANGING THE DEFAULT IS NOT RECOMMENDED.
+##
+## Valid values:  boolean
+## Default value: true
+##
+# solver.dupAllowDowngrade = true
+
+##
+## EXPERTS ONLY: TUNE DISTRIBUTION UPGRADE (DUP)
+## Set whether follow package renames upon DUP.
+##
+## CHANGING THE DEFAULT IS NOT RECOMMENDED.
+##
+## Valid values:  boolean
+## Default value: true
+##
+# solver.dupAllowNameChange = true
+
+##
+## EXPERTS ONLY: TUNE DISTRIBUTION UPGRADE (DUP)
+## Set whether to allow changing the packages architecture upon DUP.
+##
+## CHANGING THE DEFAULT IS NOT RECOMMENDED.
+##
+## Valid values:  boolean
+## Default value: true
+##
+# solver.dupAllowArchChange = true
+
+##
+## EXPERTS ONLY: TUNE DISTRIBUTION UPGRADE (DUP)
+## Set whether to allow changing the packages vendor upon DUP. If you
+## are following a continuous distribution like Tumbleweed or Factory
+## where you use 'zypper dup --no-allow-vendor-change' quite frequently,
+## you may indeed benefit from disabling the VendorChange. Packages from
+## OBS repos will then be kept rather than being overwritten by Tumbleweeds
+## version.
+##
+## CHANGING THE DEFAULT IS NOT RECOMMENDED.
+##
+## Valid values:  boolean
+## Default value: true
+##
+# solver.dupAllowVendorChange = true
+
+##
 ## EXPERTS ONLY: Cleanup when deleting packages. Whether the solver should
 ## per default try to remove packages exclusively required by the ones he's
 ## asked to delete.
 # solver.checkSystemFile = /etc/zypp/systemCheck
 
 ##
+## This directory can contain files that contain requirements/conflicts
+## which fulfill the needs of a running system (see checkSystemFile).
+##
+## Files are read in alphabetical order.
+##
+## Default value: {configdir}/systemCheck.d
+##
+# solver.checkSystemFileDir = /etc/zypp/systemCheck.d
+
+##
 ## When committing a dist upgrade (e.g. 'zypper dup') a solver testcase
 ## is written to /var/log/updateTestcase-<date>. It is needed in bugreports.
-## This optin returns the number of testcases to keep on the system. Old
+## This option returns the number of testcases to keep on the system. Old
 ## cases will be deleted, as new ones are created.
 ##
 ## Use 0 to write no testcase at all, or -1 to keep all testcases.
 ## Default value:
 ##     empty
 ##
-# multiversion = provides:multiversion(kernel)
+multiversion = provides:multiversion(kernel)
+
+##
+## Defining directory which may contain additional multiversion definitions.
+##
+## If the directory exists, each file in this directory is scanned, expecting
+## one valid multiversion list entry per line. Empty lines and lines starting
+## with '#' are ignored.
+## ------------------------- [/etc/zypp/multiversion.d/example file begin] -----------------------
+## # An alternate way to enable kernel packages being
+## # installed in parallel:
+##
+## provides:multiversion(kernel)
+## ------------------------- [/etc/zypp/multiversion.d/example file end] -----------------------
+##
+## Valid values: A directory
+## Default value: {configdir}/multiversion.d
+##
+# multiversiondir = /etc/zypp/multiversion.d
 
 ## Comma separated list of kernel packages to keep installed in parallel, if the
 ## above multiversion variable is set. Packages can be specified as
 ## oldest        - Keep kernel with the lowest version number (the GA kernel)
 ## oldest+N      - Keep kernel with the Nth lowest version number
 ##
+## Note: This entry is not evaluated by libzypp, but by the
+##       purge-kernels service (via /sbin/purge-kernels).
+##
 ## Default: Do not delete any kernels if multiversion = provides:multiversion(kernel) is set
-# multiversion.kernels = latest,running
+multiversion.kernels = latest,latest-1,running
 
 ##
 ## Path to locks file. If not exist then is create.
 # locksfile.path = /etc/zypp/locks
 
 ##
-## Whetever to apply locks in locks file after zypp start.
+## Whether to apply locks in locks file after zypp start.
 ##
 ## Valid values: boolean
 ## Default value: true