zypp.conf

   1 ## Configuration file for software management
   2 ## /etc/zypp/zypp.conf
   3 ##
   4 ## Boolean values are 0 1 yes no on off true false
   5
   6
   7 [main]
   8
   9
  10 ##
  11 ## Override the detected architecture
  12 ##
  13 ## Valid values:  i586, i686, x86_64, ppc, ppc64, ia64, s390, s390x, ..
  14 ## Default value: Autodetected
  15 ##
  16 ## ** CAUTION: Only set if you know what you're doing !
  17 ## ** Changing this needs a full refresh (incl. download)
  18 ## ** of all repository data.
  19 ##
  20 # arch = s390
  21
  22
  23 ##
  24 ## Path where the caches are kept.
  25 ##
  26 ## Valid values: A directory
  27 ## Default value: /var/cache/zypp
  28 ##
  29 # cachedir = /var/cache/zypp
  30
  31
  32 ##
  33 ## Path where the repo metadata is downloaded and kept.
  34 ##
  35 ## Valid values: A directory
  36 ## Default value: {cachedir}/raw
  37 ##
  38 ## Changing this needs a full refresh (incl. download) of all repository data
  39 ##
  40 # metadatadir = /var/cache/zypp/raw
  41
  42
  43 ##
  44 ## Path where the repo solv files are created and kept.
  45 ##
  46 ## Valid values: A directory
  47 ## Default value: {cachedir}/solv
  48 ##
  49 # solvfilesdir = /var/cache/zypp/solv
  50
  51
  52 ##
  53 ## Path where the repo packages are downloaded and kept.
  54 ##
  55 ## Valid values: A directory
  56 ## Default value: {cachedir}/packages
  57 ##
  58 # packagesdir = /var/cache/zypp/packages
  59
  60
  61 ##
  62 ## Path where the configuration files are kept.
  63 ##
  64 ## Valid values: A directory
  65 ## Default value: /etc/zypp
  66 ##
  67 # configdir = /etc/zypp
  68
  69 ##
  70 ## Path where the known repositories .repo files are kept
  71 ##
  72 ## Valid values: A directory
  73 ## Default value: {configdir}/repos.d
  74 ##
  75 ## Changing this invalidates all known repositories
  76 ##
  77 # reposdir = /etc/zypp/repos.d
  78
  79 ##
  80 ## Path where the known services .service files are kept
  81 ##
  82 ## Valid values: A directory
  83 ## Default value: {configdir}/services.d
  84 ##
  85 ## Changing this invalidates all known services
  86 ##
  87 # servicesdir = /etc/zypp/services.d
  88
  89
  90 ##
  91 ## Whether repository urls should be probed when added
  92 ##
  93 ## Valid values: boolean
  94 ## Default value: false
  95 ##
  96 ## If true, accessability of repositories is checked immediately (when added)
  97 ##   (e.g. 'zypper ar' will check immediately)
  98 ## If false, accessability of repositories is checked when refreshed
  99 ##   (e.g. 'zypper ar' will delay the check until the next refresh)
 100 ##
 101 # repo.add.probe = false
 102
 103
 104 ##
 105 ## Amount of time in minutes that must pass before another refresh.
 106 ##
 107 ## Valid values: Integer
 108 ## Default value: 10
 109 ##
 110 ## If you have autorefresh enabled for a repository, it is checked for
 111 ## up-to-date metadata not more often than every <repo.refresh.delay>
 112 ## minutes. If an automatic request for refresh comes before <repo.refresh.delay>
 113 ## minutes passed since the last check, the request is ignored.
 114 ##
 115 ## A value of 0 means the repository will always be checked. To get the oposite
 116 ## effect, disable autorefresh for your repositories.
 117 ##
 118 ## This option has no effect for repositories with autorefresh disabled, nor for
 119 ## user-requested refresh.
 120 ##
 121 # repo.refresh.delay = 10
 122
 123 ##
 124 ## Translated package descriptions to download from repos.
 125 ##
 126 ## A list of locales for which translated package descriptions should
 127 ## be downloaded, in case they are availavble and the repo supports this.
 128 ## Not all repo formats support downloading specific translations only.
 129 ##
 130 ## Valid values:  List of locales like 'en', 'en_US'...
 131 ## Default value: RequestedLocales
 132 ##
 133 ## If data for a specific locale are not available, we try to find some
 134 ## fallback. Translations for 'en' are always downloaded.
 135 ##
 136 # repo.refresh.locales = en, de
 137
 138 ##
 139 ## Maximum number of concurrent connections to use per transfer
 140 ##
 141 ## Valid values: Integer
 142 ## Default value: 5
 143 ##
 144 ## This setting is only used if more than one is possible
 145 ## Setting it to a reasonable number avoids flooding servers
 146 ##
 147 # download.max_concurrent_connections = 5
 148
 149 ##
 150 ## Sets the minimum download speed (bytes per second)
 151 ## until the connection is dropped
 152 ## This can be useful to prevent security attacks on hosts by
 153 ## providing updates at very low speeds.
 154 ##
 155 ## 0 means no limit
 156 ##
 157 # download.min_download_speed = 0
 158
 159 ## Maximum download speed (bytes per second)
 160 ## 0 means no limit
 161 # download.max_download_speed = 0
 162
 163 ## Number of tries per download which will be
 164 ## done without user interaction
 165 ## 0 means no limit (use with caution)
 166 # download.max_silent_tries = 5
 167
 168 ##
 169 ## Maximum time in seconds that you allow a transfer operation to take.
 170 ##
 171 ## This is useful for preventing your batch jobs from hanging for hours due
 172 ## to slow networks or links going down. Limiting operations to less than a
 173 ## few minutes risk aborting perfectly normal operations.
 174 ##
 175 ## Valid values:  [0,3600]
 176 ## Default value: 180
 177 ##
 178 # download.transfer_timeout = 180
 179
 180 ##
 181 ## Whether to consider using a .delta.rpm when downloading a package
 182 ##
 183 ## Valid values: boolean
 184 ## Default value: true
 185 ##
 186 ## Using a delta rpm will decrease the download size for package updates
 187 ## since it does not contain all files of the package but only the binary
 188 ## diff of changed ones. Recreating the rpm package on the local machine
 189 ## is an expensive operation (memory,CPU). If your network connection is
 190 ## not too slow, you benefit from disabling .delta.rpm.
 191 ##
 192 # download.use_deltarpm = true
 193
 194 ##
 195 ## Whether to consider using a deltarpm even when rpm is local
 196 ##
 197 ## Valid values: boolean
 198 ## Default value: false
 199 ##
 200 ## This option has no effect unless download.use_deltarpm is set true.
 201 ##
 202 #  download.use_deltarpm.always = false
 203
 204 ##
 205 ## Hint which media to prefer when installing packages (download vs. CD).
 206 ##
 207 ## Valid values:        download, volatile
 208 ## Default value:       download
 209 ##
 210 ## Note that this just a hint. First of all the solver will choose the 'best'
 211 ## package according to its repos priority, version and architecture. But if
 212 ## there is a choice, we will prefer packages from the desired media.
 213 ##
 214 ## Packages available locally are always preferred. The question is whether
 215 ## you prefer packages being downloaded via FTP/HTTP/HTTPS (download), rather
 216 ## than being prompted to insert a CD/DVD (volatile), in case they are available
 217 ## on both media.
 218 ##
 219 ##   Name             | Priority | URI
 220 ##   openSUSE-11.1      99         dvd:///
 221 ##   openSUSE-11.1-Oss  99         http://download.opensuse.org/distribution/11.1/repo/oss
 222 ##
 223 ## In the above example 2 repositories with similar content are used. Rather
 224 ## than raising the priority of one of them to 'prefer' a certain media, you
 225 ## should use the same priority for both and set download.media_preference
 226 ## instead.
 227 ##
 228 ## download.media_preference = download
 229
 230 ##
 231 ## Signature checking (repo metadata and downloaded rpm packages)
 232 ##
 233 ##   boolean    gpgcheck        (default: on)
 234 ##   boolean    repo_gpgcheck   (default: unset -> according to gpgcheck)
 235 ##   boolean    pkg_gpgcheck    (default: unset -> according to gpgcheck)
 236 ##
 237 ## Explicitly setting 'gpgcheck', 'repo_gpgcheck' 'pkg_gpgcheck' in a
 238 ## repositories .repo file will overwrite the defaults for this specific
 239 ## repo.
 240 ##
 241 ## If 'gpgcheck' is 'on' (the default) we will check the signature of repo metadata
 242 ## (packages are secured via checksum inside the metadata). Using unsigned repos
 243 ## needs to be confirmed.
 244 ## Packages from signed repos are accepted if their checksum matches the checksum
 245 ## stated in the repo metadata.
 246 ## Packages from unsigned repos need a valid gpg signature, using unsigned packages
 247 ## needs to be confirmed.
 248 ##
 249 ## The above default behavior can be tuned by explicitly setting 'repo_gpgcheck'
 250 ## and/or 'pkg_gpgcheck':
 251 ##
 252 ##   'repo_gpgcheck = on' same as the default.
 253 ##
 254 ##   'repo_gpgcheck = off' will silently accept unsigned repos. It will NOT turn off
 255 ##   signature checking on the whole, nevertheless it's not a secure setting.
 256 ##
 257 ##   'pkg_gpgcheck = on' will enforce the package signature checking and the need
 258 ##   to confirm unsigned packages for all repos (signed and unsigned).
 259 ##
 260 ##   'pkg_gpgcheck = off' will silently accept unsigned packages. It will NOT turn off
 261 ##   signature checking on the whole, nevertheless it's not a secure setting.
 262 ##
 263 ## If 'gpgCheck' is 'off' (not recommended), no checks are performed. You can still
 264 ## enable them individually by setting 'repo_gpgcheck' and/or 'pkg_gpgcheck' to 'on'.
 265 ##
 266 ##   NOTE:
 267 ##   BSC#1038984: For a short period of time, libzypp-16.15.x
 268 ##   will silently accept unsigned packages IFF a repositories gpgcheck
 269 ##   configuration is explicitly turned OFF like this:
 270 ##       gpgcheck      = 0
 271 ##       repo_gpgcheck = 0
 272 ##       pkg_gpgcheck  = 1
 273 ##   This will allow some already released products to adapt to the behavioral
 274 ##   changes introduced by fixing BSC#1038984, while systems with a default
 275 ##   configuration (gpgcheck = 1) already benefit from the fix in libzypp-16.15.x.
 276 ##   With libzypp-16.16.x the above configuration will reject unsigned packages
 277 ##   as it is supposed to do.
 278 ##
 279 ##   DISABLING GPG CHECKS IS NOT RECOMMENDED.
 280 ##   Signing data enables the recipient to verify that no modifications
 281 ##   occurred after the data were signed. Accepting data with no, wrong
 282 ##   or unknown signature can lead to a corrupted system and in extreme
 283 ##   cases even to a system compromise.
 284 ##
 285 # repo_gpgcheck = unset -> according to gpgcheck
 286 # pkg_gpgcheck =  unset -> according to gpgcheck
 287
 288 ##
 289 ## Commit download policy to use as default.
 290 ##
 291 ##  DownloadOnly,       Just download all packages to the local cache.
 292 ##                      Do not install. Implies a dry-run.
 293 ##
 294 ##  DownloadInAdvance,  First download all packages to the local cache.
 295 ##                      Then start to install.
 296 ##
 297 ##  DownloadInHeaps,    Similar to DownloadInAdvance, but try to split
 298 ##                      the transaction into heaps, where at the end of
 299 ##                      each heap a consistent system state is reached.
 300 ##
 301 ##  DownloadAsNeeded    Alternating download and install. Packages are
 302 ##                      cached just to avid CD/DVD hopping. This is the
 303 ##                      traditional behaviour.
 304 ##
 305 ##  <UNSET>             If a value is not set, empty or unknown, we pick
 306 ##                      some sane default.
 307 ##
 308 ## commit.downloadMode =
 309
 310 ##
 311 ## Defining directory which contains vendor description files.
 312 ##
 313 ## One file in this directory reflects a group of equivalent vendors. e.G.:
 314 ## (filename is "nvidia" but could be any other name):
 315 ## ------------------------- file contains begin -----------------------
 316 ## [main]
 317 ##
 318 ## vendors = nvidia,suse,opensuse
 319 ##
 320 ## ------------------------- file contains end -----------------------
 321 ## Libzypp makes an string comparision (like strncmp, case-insensitive)
 322 ## whereas the beginning of the strings are compared only.
 323 ## e.G. vendor "opensuse11.0" is compatible to "openSuSE".
 324 ##
 325 ## Valid values: A directory
 326 ## Default value: {configdir}/vendors.d
 327 ##
 328 # vendordir = /etc/zypp/vendors.d
 329
 330
 331 ##
 332 ## Whether required packages are installed ONLY
 333 ## So recommended packages, language packages and packages which depend
 334 ## on hardware (modalias) will not be regarded.
 335 ##
 336 ## Valid values: boolean
 337 ## Default value: false
 338 ##
 339 # solver.onlyRequires = false
 340
 341 ##
 342 ## EXPERTS ONLY: Per default the solver will not replace packages of
 343 ## different vendors, unless you explicitly ask to do so. Setting this
 344 ## option to TRUE will disable this vendor check (unless the application
 345 ## explicitly re-enables it). Packages will then be considered based on
 346 ## repository priority and version only. This may easily damage your system.
 347 ##
 348 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
 349 ##
 350 ## Valid values:  boolean
 351 ## Default value: false
 352 ##
 353 # solver.allowVendorChange = false
 354
 355 ##
 356 ## EXPERTS ONLY: Cleanup when deleting packages. Whether the solver should
 357 ## per default try to remove packages exclusively required by the ones he's
 358 ## asked to delete.
 359 ##
 360 ## This option should be used on a case by case basis, enabled via
 361 ## command line options or switches the applications offer. Changing
 362 ## the global default on a system where unattended actions are performed,
 363 ## may easily damage your system.
 364 ##
 365 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
 366 ##
 367 ## Valid values:  boolean
 368 ## Default value: false
 369 ##
 370 # solver.cleandepsOnRemove = false
 371
 372 ##
 373 ## This file contains requirements/conflicts which fulfill the
 374 ## needs of a running system.
 375 ## For example the system would be broken if not glibc or kernel is
 376 ## installed.
 377 ## So the user will be informed if these packages will be deleted.
 378 ##
 379 ## Format: Each line represents one dependency:
 380 ##         e.g.
 381 ##         requires:kernel
 382 ##         requires:glibc
 383 ## Default value: {configdir}/systemCheck
 384 ##
 385 # solver.checkSystemFile = /etc/zypp/systemCheck
 386
 387 ##
 388 ## When committing a dist upgrade (e.g. 'zypper dup') a solver testcase
 389 ## is written to /var/log/updateTestcase-<date>. It is needed in bugreports.
 390 ## This option returns the number of testcases to keep on the system. Old
 391 ## cases will be deleted, as new ones are created.
 392 ##
 393 ## Use 0 to write no testcase at all, or -1 to keep all testcases.
 394 ##
 395 ## Valid values:        Integer
 396 ## Default value:       2
 397 ##
 398 # solver.upgradeTestcasesToKeep = 2
 399
 400 ##
 401 ## Whether dist upgrade should remove a products dropped packages.
 402 ##
 403 ## A new product may suggest a list of old and no longer supported
 404 ## packages (dropped packages). Performing a dist upgrade the solver
 405 ## may try to delete them, even if they do not cause any dependency
 406 ## problem.
 407 ##
 408 ## Turning this option off, the solver will not try to remove those
 409 ## packages unless they actually do cause dependency trouble. You may
 410 ## do the cleanup manually, or simply leave them installed as long
 411 ## as you don't need the disk space.
 412 ##
 413 ## Valid values:        Boolean
 414 ## Default value:       true
 415 ##
 416 # solver.upgradeRemoveDroppedPackages = true
 417
 418 ##
 419 ## Packages which can be installed in different versions at the same time.
 420 ##
 421 ## Packages are selected either by name, or by provides. In the later case
 422 ## the string must start with "provides:" immediately followed by the capability.
 423 ##
 424 ## Example:
 425 ##      kernel                          - just packages whith name 'kernel'
 426 ##      provides:multiversion(kernel)   - all packages providing 'multiversion(kernel)'
 427 ##                                        (kenel and kmp packages should do this)
 428 ## Valid values:
 429 ##      Comma separated list of packages.
 430 ##
 431 ## Default value:
 432 ##      empty
 433 ##
 434 multiversion = provides:multiversion(kernel)
 435
 436 ##
 437 ## Defining directory which may contain additional multiversion definitions.
 438 ##
 439 ## If the directory exists, each file in this directory is scanned, expecting
 440 ## one valid multiversion list entry per line. Empty lines and lines starting
 441 ## with '#' are ignored.
 442 ## ------------------------- [/etc/zypp/multiversion.d/example file begin] -----------------------
 443 ## # An alternate way to enable kernel packages being
 444 ## # installed in parallel:
 445 ##
 446 ## provides:multiversion(kernel)
 447 ## ------------------------- [/etc/zypp/multiversion.d/example file end] -----------------------
 448 ##
 449 ## Valid values: A directory
 450 ## Default value: {configdir}/multiversion.d
 451 ##
 452 # multiversiondir = /etc/zypp/multiversion.d
 453
 454 ## Comma separated list of kernel packages to keep installed in parallel, if the
 455 ## above multiversion variable is set. Packages can be specified as
 456 ## 2.6.32.12-0.7 - Exact version to keep
 457 ## latest        - Keep kernel with the highest version number
 458 ## latest-N      - Keep kernel with the Nth highest version number
 459 ## running       - Keep the running kernel
 460 ## oldest        - Keep kernel with the lowest version number (the GA kernel)
 461 ## oldest+N      - Keep kernel with the Nth lowest version number
 462 ##
 463 ## Note: This entry is not evaluated by libzypp, but by the
 464 ##       purge-kernels service (via /sbin/purge-kernels).
 465 ##
 466 ## Default: Do not delete any kernels if multiversion = provides:multiversion(kernel) is set
 467 multiversion.kernels = latest,latest-1,running
 468
 469 ##
 470 ## Path to locks file. If not exist then is create.
 471 ## In this file is saved also UI locks.
 472 ##
 473 ## valid value: path to file or place where file can be created
 474 ## default value: {configdir}/locks
 475 ##
 476 # locksfile.path = /etc/zypp/locks
 477
 478 ##
 479 ## Whether to apply locks in locks file after zypp start.
 480 ##
 481 ## Valid values: boolean
 482 ## Default value: true
 483 ##
 484 # locksfile.apply = true
 485
 486 ##
 487 ## Where update items are stored
 488 ## (example: scripts, messages)
 489 ##
 490 ## Valid values: path to directory
 491 ## Default value: /var/adm
 492 ##
 493 # update.datadir = /var/adm
 494
 495 ##
 496 ## Where update messages are stored
 497 ##
 498 ## Valid values: path to directory
 499 ## Default value: {update.datadir}/update-messages
 500 ##
 501 # update.messagesdir = /var/adm/update-messages
 502
 503 ##
 504 ## Where update scripts are stored
 505 ##
 506 ## Valid values: path to directory
 507 ## Default value: {update.datadir}/update-scripts
 508 ##
 509 # update.scriptsdir = /var/adm/update-scripts
 510
 511 ##
 512 ## Command to be invoked to send update messages.
 513 ##
 514 ## Packages may leave an update message file in {update.messagesdir}.
 515 ## At the end of each commit, zypp collects those messages and may send
 516 ## a notification to the user.
 517 ##
 518 ## zypp will prepare the update messages according to the selected
 519 ## content format and pipe the content to the command.
 520 ##
 521 ## Format:
 522 ##     single - For each update message invoke the command and send
 523 ##              the message.
 524 ##     none   - For each update message invoke the command but don't
 525 ##              use a pipe to send any data. You probably want to pass
 526 ##              the message file on the commandline using %P (see
 527 ##              Substitutions).
 528 ##     digest - Single invocation of the command, sending the path
 529 ##              names of all update message. One per line.
 530 ##     bulk   - Single invocation of the command, sending the
 531 ##              concatenated content of all update messages, separated
 532 ##              by Ctrl-L.
 533 ##
 534 ## Substitutions:
 535 ##     %p     - package identification (name-version-release.arch)
 536 ##     %P     - full path to the update message file
 537 ##
 538 ## Valid values: The value is specified as "format | command".
 539 ##               An empty value will turn off any notification.
 540 ##
 541 ## Examples:     single | mail -s 'Update message from %p' root
 542 ##               none   | my-send-script -f %P
 543 ##
 544 ## Default value: single | /usr/lib/zypp/notify-message -p %p
 545 ##
 546 # update.messages.notify = single | /usr/lib/zypp/notify-message -p %p
 547
 548 ##
 549 ## Options for package installation: excludedocs
 550 ##
 551 ## Don't install any files which are marked as documentation.
 552 ##
 553 ## Valid values:  boolean
 554 ## Default value: no
 555 ##
 556 # rpm.install.excludedocs = no
 557
 558 ##
 559 ## Location of history log file.
 560 ##
 561 ## The history log is described at
 562 ## http://en.opensuse.org/Libzypp/Package_History
 563 ##
 564 ## Valid values: absolute path to a file
 565 ## Default value: /var/log/zypp/history
 566 ##
 567 # history.logfile = /var/log/zypp/history
 568
 569 ##
 570 ## Global credentials directory path.
 571 ##
 572 ## If a URL contains ?credentials=<filename> parameter, the credentials will
 573 ## be stored and looked for in a file named <filename> in this directory.
 574 ##
 575 ## Valid values: absolute path to a directory
 576 ## Default value: /etc/zypp/credentials.d
 577 ##
 578 # credentials.global.dir = /etc/zypp/credentials.d
 579
 580 ##
 581 ## Global credentials catalog file path.
 582 ##
 583 ## This file contains a catalog of all known user credentials which were
 584 ## not stored via the ?credentials=<filename> URL parameter, i.e. passed
 585 ## in URL as username:password component, or entered by user in
 586 ## an authentication dialog.
 587 ##
 588 ## Valid values: absolute path to a file
 589 ## Default value: /etc/zypp/credentials.cat
 590 ##
 591 # credentials.global.file = /etc/zypp/credentials.cat