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 ## Path where custom repo variable definitions are kept
  91 ##
  92 ## Valid values: A directory
  93 ## Default value: {configdir}/vars.d
  94 ##
  95 ## Changing this undefines all custom repo variables. Built-in
  96 ## variables (like '$arch', '$basearch' or $releasever) are not
  97 ## affected, but reset to their default values.
  98 ##
  99 ## A custom repo variable is defined by creating a file inside the
 100 ## directory. The variable name equals the file name. The files fist
 101 ## line (up to but not including the newline character) defines the
 102 ## variables value.
 103 ##
 104 # varsdir = /etc/zypp/vars.d
 105
 106 ##
 107 ## Whether repository urls should be probed when added
 108 ##
 109 ## Valid values: boolean
 110 ## Default value: false
 111 ##
 112 ## If true, accessability of repositories is checked immediately (when added)
 113 ##   (e.g. 'zypper ar' will check immediately)
 114 ## If false, accessability of repositories is checked when refreshed
 115 ##   (e.g. 'zypper ar' will delay the check until the next refresh)
 116 ##
 117 # repo.add.probe = false
 118
 119
 120 ##
 121 ## Amount of time in minutes that must pass before another refresh.
 122 ##
 123 ## Valid values: Integer
 124 ## Default value: 10
 125 ##
 126 ## If you have autorefresh enabled for a repository, it is checked for
 127 ## up-to-date metadata not more often than every <repo.refresh.delay>
 128 ## minutes. If an automatic request for refresh comes before <repo.refresh.delay>
 129 ## minutes passed since the last check, the request is ignored.
 130 ##
 131 ## A value of 0 means the repository will always be checked. To get the opposite
 132 ## effect, disable autorefresh for your repositories.
 133 ##
 134 ## This option has no effect for repositories with autorefresh disabled, nor for
 135 ## user-requested refresh.
 136 ##
 137 # repo.refresh.delay = 10
 138
 139 ##
 140 ## Translated package descriptions to download from repos.
 141 ##
 142 ## A list of locales for which translated package descriptions should
 143 ## be downloaded, in case they are availavble and the repo supports this.
 144 ## Not all repo formats support downloading specific translations only.
 145 ##
 146 ## Valid values:  List of locales like 'en', 'en_US'...
 147 ## Default value: RequestedLocales
 148 ##
 149 ## If data for a specific locale are not available, we try to find some
 150 ## fallback. Translations for 'en' are always downloaded.
 151 ##
 152 # repo.refresh.locales = en, de
 153
 154 ##
 155 ## Maximum number of concurrent connections to use per transfer
 156 ##
 157 ## Valid values: Integer
 158 ## Default value: 5
 159 ##
 160 ## This setting is only used if more than one is possible
 161 ## Setting it to a reasonable number avoids flooding servers
 162 ##
 163 # download.max_concurrent_connections = 5
 164
 165 ##
 166 ## Sets the minimum download speed (bytes per second)
 167 ## until the connection is dropped
 168 ## This can be useful to prevent security attacks on hosts by
 169 ## providing updates at very low speeds.
 170 ##
 171 ## 0 means no limit
 172 ##
 173 # download.min_download_speed = 0
 174
 175 ## Maximum download speed (bytes per second)
 176 ## 0 means no limit
 177 # download.max_download_speed = 0
 178
 179 ## Number of tries per download which will be
 180 ## done without user interaction
 181 ## 0 means no limit (use with caution)
 182 # download.max_silent_tries = 5
 183
 184 ##
 185 ## Maximum time in seconds that you allow a transfer operation to take.
 186 ##
 187 ## This is useful for preventing your batch jobs from hanging for hours due
 188 ## to slow networks or links going down. Limiting operations to less than a
 189 ## few minutes risk aborting perfectly normal operations.
 190 ##
 191 ## Valid values:  [0,3600]
 192 ## Default value: 180
 193 ##
 194 # download.transfer_timeout = 180
 195
 196 ##
 197 ## Whether to consider using a .delta.rpm when downloading a package
 198 ##
 199 ## Valid values: boolean
 200 ## Default value: true
 201 ##
 202 ## Using a delta rpm will decrease the download size for package updates
 203 ## since it does not contain all files of the package but only the binary
 204 ## diff of changed ones. Recreating the rpm package on the local machine
 205 ## is an expensive operation (memory,CPU). If your network connection is
 206 ## not too slow, you benefit from disabling .delta.rpm.
 207 ##
 208 # download.use_deltarpm = true
 209
 210 ##
 211 ## Whether to consider using a deltarpm even when rpm is local
 212 ##
 213 ## Valid values: boolean
 214 ## Default value: false
 215 ##
 216 ## This option has no effect unless download.use_deltarpm is set true.
 217 ##
 218 #  download.use_deltarpm.always = false
 219
 220 ##
 221 ## Hint which media to prefer when installing packages (download vs. CD).
 222 ##
 223 ## Valid values:        download, volatile
 224 ## Default value:       download
 225 ##
 226 ## Note that this just a hint. First of all the solver will choose the 'best'
 227 ## package according to its repos priority, version and architecture. But if
 228 ## there is a choice, we will prefer packages from the desired media.
 229 ##
 230 ## Packages available locally are always preferred. The question is whether
 231 ## you prefer packages being downloaded via FTP/HTTP/HTTPS (download), rather
 232 ## than being prompted to insert a CD/DVD (volatile), in case they are available
 233 ## on both media.
 234 ##
 235 ##   Name             | Priority | URI
 236 ##   openSUSE-11.1      99         dvd:///
 237 ##   openSUSE-11.1-Oss  99         http://download.opensuse.org/distribution/11.1/repo/oss
 238 ##
 239 ## In the above example 2 repositories with similar content are used. Rather
 240 ## than raising the priority of one of them to 'prefer' a certain media, you
 241 ## should use the same priority for both and set download.media_preference
 242 ## instead.
 243 ##
 244 ## download.media_preference = download
 245
 246 ##
 247 ## Path where media are preferably mounted or downloaded
 248 ##
 249 ## Valid values:        A (writable) directory
 250 ## Default value:       /var/adm/mount
 251 ##
 252 ## The media backend will try to organize media mount points and download areas
 253 ## below this directory, unless a different location is requested by the application.
 254 ##
 255 ## If the directory is not accessible and read/writable for a specific user,
 256 ## the fallback is to use /var/tmp.
 257 ##
 258 ## download.media_mountdir = /var/adm/mount
 259
 260 ##
 261 ## Signature checking (repo metadata and downloaded rpm packages)
 262 ##
 263 ##   boolean    gpgcheck        (default: on)
 264 ##   boolean    repo_gpgcheck   (default: unset -> according to gpgcheck)
 265 ##   boolean    pkg_gpgcheck    (default: unset -> according to gpgcheck)
 266 ##
 267 ## Explicitly setting 'gpgcheck', 'repo_gpgcheck' 'pkg_gpgcheck' in a
 268 ## repositories .repo file will overwrite the defaults for this specific
 269 ## repo.
 270 ##
 271 ## If 'gpgcheck' is 'on' (the default) we will check the signature of repo metadata
 272 ## (packages are secured via checksum inside the metadata). Using unsigned repos
 273 ## needs to be confirmed.
 274 ## Packages from signed repos are accepted if their checksum matches the checksum
 275 ## stated in the repo metadata.
 276 ## Packages from unsigned repos need a valid gpg signature, using unsigned packages
 277 ## needs to be confirmed.
 278 ##
 279 ## The above default behavior can be tuned by explicitly setting 'repo_gpgcheck'
 280 ## and/or 'pkg_gpgcheck':
 281 ##
 282 ##   'repo_gpgcheck = on' same as the default.
 283 ##
 284 ##   'repo_gpgcheck = off' will silently accept unsigned repos. It will NOT turn off
 285 ##   signature checking on the whole, nevertheless it's not a secure setting.
 286 ##
 287 ##   'pkg_gpgcheck = on' will enforce the package signature checking and the need
 288 ##   to confirm unsigned packages for all repos (signed and unsigned).
 289 ##
 290 ##   'pkg_gpgcheck = off' will silently accept unsigned packages. It will NOT turn off
 291 ##   signature checking on the whole, nevertheless it's not a secure setting.
 292 ##
 293 ## If 'gpgCheck' is 'off' (not recommended), no checks are performed. You can still
 294 ## enable them individually by setting 'repo_gpgcheck' and/or 'pkg_gpgcheck' to 'on'.
 295 ##
 296 ##   DISABLING GPG CHECKS IS NOT RECOMMENDED.
 297 ##   Signing data enables the recipient to verify that no modifications
 298 ##   occurred after the data were signed. Accepting data with no, wrong
 299 ##   or unknown signature can lead to a corrupted system and in extreme
 300 ##   cases even to a system compromise.
 301 ##
 302 # repo_gpgcheck = unset -> according to gpgcheck
 303 # pkg_gpgcheck =  unset -> according to gpgcheck
 304
 305 ##
 306 ## Commit download policy to use as default.
 307 ##
 308 ##  DownloadOnly,       Just download all packages to the local cache.
 309 ##                      Do not install. Implies a dry-run.
 310 ##
 311 ##  DownloadInAdvance,  First download all packages to the local cache.
 312 ##                      Then start to install.
 313 ##
 314 ##  DownloadInHeaps,    Similar to DownloadInAdvance, but try to split
 315 ##                      the transaction into heaps, where at the end of
 316 ##                      each heap a consistent system state is reached.
 317 ##
 318 ##  DownloadAsNeeded    Alternating download and install. Packages are
 319 ##                      cached just to avid CD/DVD hopping. This is the
 320 ##                      traditional behaviour.
 321 ##
 322 ##  <UNSET>             If a value is not set, empty or unknown, we pick
 323 ##                      some sane default.
 324 ##
 325 ## commit.downloadMode =
 326
 327 ##
 328 ## Defining directory which contains vendor description files.
 329 ##
 330 ## Each file in this directory defines a (comma separated) list of
 331 ## equivalent vendors string prefixes (case-insensitive comparision):
 332 ## ------------------------- file begin -----------------------
 333 ## [main]
 334 ## vendors = MyVendor,AlternateName
 335 ## ------------------------- file end -----------------------
 336 ## By this vendor strings starting with "MyVendor" or "AlternateName"
 337 ## are considered to be equivalent. Packages from equivalent vendors
 338 ## may replace each other without being considered as a 'vendor change'.
 339 ##
 340 ## Valid values: A directory
 341 ## Default value: {configdir}/vendors.d
 342 ##
 343 # vendordir = /etc/zypp/vendors.d
 344
 345
 346 ##
 347 ## Whether only required packages are installed.
 348 ##
 349 ## Recommended packages, will not be regarded.
 350 ##
 351 ## Valid values: boolean
 352 ## Default value: false
 353 ##
 354 # solver.onlyRequires = false
 355
 356 ##
 357 ## EXPERTS ONLY: Per default the solver will not replace packages of
 358 ## different vendors, unless you explicitly ask to do so. Setting this
 359 ## option to TRUE will disable this vendor check (unless the application
 360 ## explicitly re-enables it). Packages will then be considered based on
 361 ## repository priority and version only. This may easily damage your system.
 362 ##
 363 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
 364 ##
 365 ## Valid values:  boolean
 366 ## Default value: false
 367 ##
 368 # solver.allowVendorChange = false
 369
 370 ##
 371 ## EXPERTS ONLY: TUNE DISTRIBUTION UPGRADE (DUP)
 372 ## Set whether to allow package version downgrades upon DUP.
 373 ##
 374 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
 375 ##
 376 ## Valid values:  boolean
 377 ## Default value: true
 378 ##
 379 # solver.dupAllowDowngrade = true
 380
 381 ##
 382 ## EXPERTS ONLY: TUNE DISTRIBUTION UPGRADE (DUP)
 383 ## Set whether follow package renames upon DUP.
 384 ##
 385 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
 386 ##
 387 ## Valid values:  boolean
 388 ## Default value: true
 389 ##
 390 # solver.dupAllowNameChange = true
 391
 392 ##
 393 ## EXPERTS ONLY: TUNE DISTRIBUTION UPGRADE (DUP)
 394 ## Set whether to allow changing the packages architecture upon DUP.
 395 ##
 396 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
 397 ##
 398 ## Valid values:  boolean
 399 ## Default value: true
 400 ##
 401 # solver.dupAllowArchChange = true
 402
 403 ##
 404 ## EXPERTS ONLY: TUNE DISTRIBUTION UPGRADE (DUP)
 405 ## Set whether to allow changing the packages vendor upon DUP. If you
 406 ## are following a continuous distribution like Tumbleweed or Factory
 407 ## where you use 'zypper dup --no-allow-vendor-change' quite frequently,
 408 ## you may indeed benefit from disabling the VendorChange. Packages from
 409 ## OBS repos will then be kept rather than being overwritten by Tumbleweeds
 410 ## version.
 411 ##
 412 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
 413 ##
 414 ## Valid values:  boolean
 415 ## Default value: true
 416 ##
 417 # solver.dupAllowVendorChange = true
 418
 419 ##
 420 ## EXPERTS ONLY: Cleanup when deleting packages. Whether the solver should
 421 ## per default try to remove packages exclusively required by the ones he's
 422 ## asked to delete.
 423 ##
 424 ## This option should be used on a case by case basis, enabled via
 425 ## command line options or switches the applications offer. Changing
 426 ## the global default on a system where unattended actions are performed,
 427 ## may easily damage your system.
 428 ##
 429 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
 430 ##
 431 ## Valid values:  boolean
 432 ## Default value: false
 433 ##
 434 # solver.cleandepsOnRemove = false
 435
 436 ##
 437 ## This file contains requirements/conflicts which fulfill the
 438 ## needs of a running system.
 439 ## For example the system would be broken if not glibc or kernel is
 440 ## installed.
 441 ## So the user will be informed if these packages will be deleted.
 442 ##
 443 ## Format: Each line represents one dependency:
 444 ##         e.g.
 445 ##         requires:kernel
 446 ##         requires:glibc
 447 ## Default value: {configdir}/systemCheck
 448 ##
 449 # solver.checkSystemFile = /etc/zypp/systemCheck
 450
 451 ##
 452 ## This directory can contain files that contain requirements/conflicts
 453 ## which fulfill the needs of a running system (see checkSystemFile).
 454 ##
 455 ## Files are read in alphabetical order.
 456 ##
 457 ## Default value: {configdir}/systemCheck.d
 458 ##
 459 # solver.checkSystemFileDir = /etc/zypp/systemCheck.d
 460
 461 ##
 462 ## When committing a dist upgrade (e.g. 'zypper dup') a solver testcase
 463 ## is written to /var/log/updateTestcase-<date>. It is needed in bugreports.
 464 ## This option returns the number of testcases to keep on the system. Old
 465 ## cases will be deleted, as new ones are created.
 466 ##
 467 ## Use 0 to write no testcase at all, or -1 to keep all testcases.
 468 ##
 469 ## Valid values:        Integer
 470 ## Default value:       2
 471 ##
 472 # solver.upgradeTestcasesToKeep = 2
 473
 474 ##
 475 ## Whether dist upgrade should remove a products dropped packages.
 476 ##
 477 ## A new product may suggest a list of old and no longer supported
 478 ## packages (dropped packages). Performing a dist upgrade the solver
 479 ## may try to delete them, even if they do not cause any dependency
 480 ## problem.
 481 ##
 482 ## Turning this option off, the solver will not try to remove those
 483 ## packages unless they actually do cause dependency trouble. You may
 484 ## do the cleanup manually, or simply leave them installed as long
 485 ## as you don't need the disk space.
 486 ##
 487 ## Valid values:        Boolean
 488 ## Default value:       true
 489 ##
 490 # solver.upgradeRemoveDroppedPackages = true
 491
 492 ##
 493 ## Packages which can be installed in different versions at the same time.
 494 ##
 495 ## Packages are selected either by name, or by provides. In the later case
 496 ## the string must start with "provides:" immediately followed by the capability.
 497 ##
 498 ## Example:
 499 ##      kernel                          - just packages whith name 'kernel'
 500 ##      provides:multiversion(kernel)   - all packages providing 'multiversion(kernel)'
 501 ##                                        (kenel and kmp packages should do this)
 502 ## Valid values:
 503 ##      Comma separated list of packages.
 504 ##
 505 ## Default value:
 506 ##      empty
 507 ##
 508 multiversion = provides:multiversion(kernel)
 509
 510 ##
 511 ## Defining directory which may contain additional multiversion definitions.
 512 ##
 513 ## If the directory exists, each file in this directory is scanned, expecting
 514 ## one valid multiversion list entry per line. Empty lines and lines starting
 515 ## with '#' are ignored.
 516 ## ------------------------- [/etc/zypp/multiversion.d/example file begin] -----------------------
 517 ## # An alternate way to enable kernel packages being
 518 ## # installed in parallel:
 519 ##
 520 ## provides:multiversion(kernel)
 521 ## ------------------------- [/etc/zypp/multiversion.d/example file end] -----------------------
 522 ##
 523 ## Valid values: A directory
 524 ## Default value: {configdir}/multiversion.d
 525 ##
 526 # multiversiondir = /etc/zypp/multiversion.d
 527
 528 ## Comma separated list of kernel packages to keep installed in parallel, if the
 529 ## above multiversion variable is set. Packages can be specified as
 530 ## 2.6.32.12-0.7 - Exact version to keep
 531 ## latest        - Keep kernel with the highest version number
 532 ## latest-N      - Keep kernel with the Nth highest version number
 533 ## running       - Keep the running kernel
 534 ## oldest        - Keep kernel with the lowest version number (the GA kernel)
 535 ## oldest+N      - Keep kernel with the Nth lowest version number
 536 ##
 537 ## Note: This entry is not evaluated by libzypp, but by the
 538 ##       purge-kernels service (via /sbin/purge-kernels).
 539 ##
 540 ## Default: Do not delete any kernels if multiversion = provides:multiversion(kernel) is set
 541 multiversion.kernels = latest,latest-1,running
 542
 543 ##
 544 ## Path to locks file. If not exist then is create.
 545 ## In this file is saved also UI locks.
 546 ##
 547 ## valid value: path to file or place where file can be created
 548 ## default value: {configdir}/locks
 549 ##
 550 # locksfile.path = /etc/zypp/locks
 551
 552 ##
 553 ## Whether to apply locks in locks file after zypp start.
 554 ##
 555 ## Valid values: boolean
 556 ## Default value: true
 557 ##
 558 # locksfile.apply = true
 559
 560 ##
 561 ## Where update items are stored
 562 ## (example: scripts, messages)
 563 ##
 564 ## Valid values: path to directory
 565 ## Default value: /var/adm
 566 ##
 567 # update.datadir = /var/adm
 568
 569 ##
 570 ## Where update messages are stored
 571 ##
 572 ## Valid values: path to directory
 573 ## Default value: {update.datadir}/update-messages
 574 ##
 575 # update.messagesdir = /var/adm/update-messages
 576
 577 ##
 578 ## Where update scripts are stored
 579 ##
 580 ## Valid values: path to directory
 581 ## Default value: {update.datadir}/update-scripts
 582 ##
 583 # update.scriptsdir = /var/adm/update-scripts
 584
 585 ##
 586 ## Command to be invoked to send update messages.
 587 ##
 588 ## Packages may leave an update message file in {update.messagesdir}.
 589 ## At the end of each commit, zypp collects those messages and may send
 590 ## a notification to the user.
 591 ##
 592 ## zypp will prepare the update messages according to the selected
 593 ## content format and pipe the content to the command.
 594 ##
 595 ## Format:
 596 ##     single - For each update message invoke the command and send
 597 ##              the message.
 598 ##     none   - For each update message invoke the command but don't
 599 ##              use a pipe to send any data. You probably want to pass
 600 ##              the message file on the commandline using %P (see
 601 ##              Substitutions).
 602 ##     digest - Single invocation of the command, sending the path
 603 ##              names of all update message. One per line.
 604 ##     bulk   - Single invocation of the command, sending the
 605 ##              concatenated content of all update messages, separated
 606 ##              by Ctrl-L.
 607 ##
 608 ## Substitutions:
 609 ##     %p     - package identification (name-version-release.arch)
 610 ##     %P     - full path to the update message file
 611 ##
 612 ## Valid values: The value is specified as "format | command".
 613 ##               An empty value will turn off any notification.
 614 ##
 615 ## Examples:     single | mail -s 'Update message from %p' root
 616 ##               none   | my-send-script -f %P
 617 ##
 618 ## Default value: <empty>
 619 ##
 620 # update.messages.notify =
 621
 622 ##
 623 ## Options for package installation: excludedocs
 624 ##
 625 ## Don't install any files which are marked as documentation.
 626 ##
 627 ## Valid values:  boolean
 628 ## Default value: no
 629 ##
 630 # rpm.install.excludedocs = no
 631
 632 ##
 633 ## Location of history log file.
 634 ##
 635 ## The history log is described at
 636 ## http://en.opensuse.org/Libzypp/Package_History
 637 ##
 638 ## Valid values: absolute path to a file
 639 ## Default value: /var/log/zypp/history
 640 ##
 641 # history.logfile = /var/log/zypp/history
 642
 643 ##
 644 ## Global credentials directory path.
 645 ##
 646 ## If a URL contains ?credentials=<filename> parameter, the credentials will
 647 ## be stored and looked for in a file named <filename> in this directory.
 648 ##
 649 ## Valid values: absolute path to a directory
 650 ## Default value: /etc/zypp/credentials.d
 651 ##
 652 # credentials.global.dir = /etc/zypp/credentials.d
 653
 654 ##
 655 ## Global credentials catalog file path.
 656 ##
 657 ## This file contains a catalog of all known user credentials which were
 658 ## not stored via the ?credentials=<filename> URL parameter, i.e. passed
 659 ## in URL as username:password component, or entered by user in
 660 ## an authentication dialog.
 661 ##
 662 ## Valid values: absolute path to a file
 663 ## Default value: /etc/zypp/credentials.cat
 664 ##
 665 # credentials.global.file = /etc/zypp/credentials.cat