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 opposite
 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 ## Path where media are preferably mounted or downloaded
 232 ##
 233 ## Valid values:        A (writable) directory
 234 ## Default value:       /var/adm/mount
 235 ##
 236 ## The media backend will try to organize media mount points and download areas
 237 ## below this directory, unless a different location is requested by the application.
 238 ##
 239 ## If the directory is not accessible and read/writable for a specific user,
 240 ## the fallback is to use /var/tmp.
 241 ##
 242 ## download.media_mountdir = /var/adm/mount
 243
 244 ##
 245 ## Signature checking (repodata and rpm packages)
 246 ##
 247 ##   boolean    gpgcheck        (default: on)
 248 ##   boolean    repo_gpgcheck   (default: unset -> according to gpgcheck)
 249 ##   boolean    pkg_gpgcheck    (default: unset -> according to gpgcheck)
 250 ##
 251 ## If 'gpgcheck' is 'on' we will either check the signature of repo metadata
 252 ## (packages are secured via checksum in the metadata), or the signature of
 253 ## an rpm package to install if it's repo metadata are not signed or not
 254 ## checked.
 255 ##
 256 ## The default behavior can be altered by explicitly setting 'repo_gpgcheck' and/or
 257 ## 'pkg_gpgcheck' to perform those checks always (if 'on') or never (if 'off').
 258 ##
 259 ## Explicitly setting 'gpgcheck', 'repo_gpgcheck' 'pkg_gpgcheck' in a
 260 ## repositories .repo file will overwrite the defaults here.
 261 ##
 262 ##   DISABLING GPG CHECKS IS NOT RECOMMENDED.
 263 ##   Signing data enables the recipient to verify that no modifications
 264 ##   occurred after the data were signed. Accepting data with no, wrong
 265 ##   or unknown signature can lead to a corrupted system and in extreme
 266 ##   cases even to a system compromise.
 267 ##
 268 # repo_gpgcheck = unset -> according to gpgcheck
 269 # pkg_gpgcheck =  unset -> according to gpgcheck
 270
 271 ##
 272 ## Commit download policy to use as default.
 273 ##
 274 ##  DownloadOnly,       Just download all packages to the local cache.
 275 ##                      Do not install. Implies a dry-run.
 276 ##
 277 ##  DownloadInAdvance,  First download all packages to the local cache.
 278 ##                      Then start to install.
 279 ##
 280 ##  DownloadInHeaps,    Similar to DownloadInAdvance, but try to split
 281 ##                      the transaction into heaps, where at the end of
 282 ##                      each heap a consistent system state is reached.
 283 ##
 284 ##  DownloadAsNeeded    Alternating download and install. Packages are
 285 ##                      cached just to avid CD/DVD hopping. This is the
 286 ##                      traditional behaviour.
 287 ##
 288 ##  <UNSET>             If a value is not set, empty or unknown, we pick
 289 ##                      some sane default.
 290 ##
 291 ## commit.downloadMode =
 292
 293 ##
 294 ## Defining directory which contains vendor description files.
 295 ##
 296 ## Each file in this directory defines a (comma separated) list of
 297 ## equivalent vendors string prefixes (case-insensitive comparision):
 298 ## ------------------------- file begin -----------------------
 299 ## [main]
 300 ## vendors = MyVendor,AlternateName
 301 ## ------------------------- file end -----------------------
 302 ## By this vendor strings starting with "MyVendor" or "AlternateName"
 303 ## are considered to be equivalent. Packages from equivalent vendors
 304 ## may replace each other without being considered as a 'vendor change'.
 305 ##
 306 ## Valid values: A directory
 307 ## Default value: {configdir}/vendors.d
 308 ##
 309 # vendordir = /etc/zypp/vendors.d
 310
 311
 312 ##
 313 ## Whether required packages are installed ONLY
 314 ## So recommended packages, language packages and packages which depend
 315 ## on hardware (modalias) will not be regarded.
 316 ##
 317 ## Valid values: boolean
 318 ## Default value: false
 319 ##
 320 # solver.onlyRequires = false
 321
 322 ##
 323 ## EXPERTS ONLY: Per default the solver will not replace packages of
 324 ## different vendors, unless you explicitly ask to do so. Setting this
 325 ## option to TRUE will disable this vendor check (unless the application
 326 ## explicitly re-enables it). Packages will then be considered based on
 327 ## repository priority and version only. This may easily damage your system.
 328 ##
 329 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
 330 ##
 331 ## Valid values:  boolean
 332 ## Default value: false
 333 ##
 334 # solver.allowVendorChange = false
 335
 336 ##
 337 ## EXPERTS ONLY: TUNE DISTRIBUTION UPGRADE (DUP)
 338 ## Set whether to allow package version downgrades upon DUP.
 339 ##
 340 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
 341 ##
 342 ## Valid values:  boolean
 343 ## Default value: true
 344 ##
 345 # solver.dupAllowDowngrade = true
 346
 347 ##
 348 ## EXPERTS ONLY: TUNE DISTRIBUTION UPGRADE (DUP)
 349 ## Set whether follow package renames upon DUP.
 350 ##
 351 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
 352 ##
 353 ## Valid values:  boolean
 354 ## Default value: true
 355 ##
 356 # solver.dupAllowNameChange = true
 357
 358 ##
 359 ## EXPERTS ONLY: TUNE DISTRIBUTION UPGRADE (DUP)
 360 ## Set whether to allow changing the packages architecture upon DUP.
 361 ##
 362 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
 363 ##
 364 ## Valid values:  boolean
 365 ## Default value: true
 366 ##
 367 # solver.dupAllowArchChange = true
 368
 369 ##
 370 ## EXPERTS ONLY: TUNE DISTRIBUTION UPGRADE (DUP)
 371 ## Set whether to allow changing the packages vendor upon DUP. If you
 372 ## are following a continuous distribution like Tumbleweed or Factory
 373 ## where you use 'zypper dup --no-allow-vendor-change' quite frequently,
 374 ## you may indeed benefit from disabling the VendorChange. Packages from
 375 ## OBS repos will then be kept rather than being overwritten by Tumbleweeds
 376 ## version.
 377 ##
 378 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
 379 ##
 380 ## Valid values:  boolean
 381 ## Default value: true
 382 ##
 383 # solver.dupAllowVendorChange = true
 384
 385 ##
 386 ## EXPERTS ONLY: Cleanup when deleting packages. Whether the solver should
 387 ## per default try to remove packages exclusively required by the ones he's
 388 ## asked to delete.
 389 ##
 390 ## This option should be used on a case by case basis, enabled via
 391 ## command line options or switches the applications offer. Changing
 392 ## the global default on a system where unattended actions are performed,
 393 ## may easily damage your system.
 394 ##
 395 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
 396 ##
 397 ## Valid values:  boolean
 398 ## Default value: false
 399 ##
 400 # solver.cleandepsOnRemove = false
 401
 402 ##
 403 ## This file contains requirements/conflicts which fulfill the
 404 ## needs of a running system.
 405 ## For example the system would be broken if not glibc or kernel is
 406 ## installed.
 407 ## So the user will be informed if these packages will be deleted.
 408 ##
 409 ## Format: Each line represents one dependency:
 410 ##         e.g.
 411 ##         requires:kernel
 412 ##         requires:glibc
 413 ## Default value: {configdir}/systemCheck
 414 ##
 415 # solver.checkSystemFile = /etc/zypp/systemCheck
 416
 417 ##
 418 ## This directory can contain files that contain requirements/conflicts
 419 ## which fulfill the needs of a running system (see checkSystemFile).
 420 ##
 421 ## Files are read in alphabetical order.
 422 ##
 423 ## Default value: {configdir}/systemCheck.d
 424 ##
 425 # solver.checkSystemFileDir = /etc/zypp/systemCheck.d
 426
 427 ##
 428 ## When committing a dist upgrade (e.g. 'zypper dup') a solver testcase
 429 ## is written to /var/log/updateTestcase-<date>. It is needed in bugreports.
 430 ## This option returns the number of testcases to keep on the system. Old
 431 ## cases will be deleted, as new ones are created.
 432 ##
 433 ## Use 0 to write no testcase at all, or -1 to keep all testcases.
 434 ##
 435 ## Valid values:        Integer
 436 ## Default value:       2
 437 ##
 438 # solver.upgradeTestcasesToKeep = 2
 439
 440 ##
 441 ## Whether dist upgrade should remove a products dropped packages.
 442 ##
 443 ## A new product may suggest a list of old and no longer supported
 444 ## packages (dropped packages). Performing a dist upgrade the solver
 445 ## may try to delete them, even if they do not cause any dependency
 446 ## problem.
 447 ##
 448 ## Turning this option off, the solver will not try to remove those
 449 ## packages unless they actually do cause dependency trouble. You may
 450 ## do the cleanup manually, or simply leave them installed as long
 451 ## as you don't need the disk space.
 452 ##
 453 ## Valid values:        Boolean
 454 ## Default value:       true
 455 ##
 456 # solver.upgradeRemoveDroppedPackages = true
 457
 458 ##
 459 ## Packages which can be installed in different versions at the same time.
 460 ##
 461 ## Packages are selected either by name, or by provides. In the later case
 462 ## the string must start with "provides:" immediately followed by the capability.
 463 ##
 464 ## Example:
 465 ##      kernel                          - just packages whith name 'kernel'
 466 ##      provides:multiversion(kernel)   - all packages providing 'multiversion(kernel)'
 467 ##                                        (kenel and kmp packages should do this)
 468 ## Valid values:
 469 ##      Comma separated list of packages.
 470 ##
 471 ## Default value:
 472 ##      empty
 473 ##
 474 multiversion = provides:multiversion(kernel)
 475
 476 ##
 477 ## Defining directory which may contain additional multiversion definitions.
 478 ##
 479 ## If the directory exists, each file in this directory is scanned, expecting
 480 ## one valid multiversion list entry per line. Empty lines and lines starting
 481 ## with '#' are ignored.
 482 ## ------------------------- [/etc/zypp/multiversion.d/example file begin] -----------------------
 483 ## # An alternate way to enable kernel packages being
 484 ## # installed in parallel:
 485 ##
 486 ## provides:multiversion(kernel)
 487 ## ------------------------- [/etc/zypp/multiversion.d/example file end] -----------------------
 488 ##
 489 ## Valid values: A directory
 490 ## Default value: {configdir}/multiversion.d
 491 ##
 492 # multiversiondir = /etc/zypp/multiversion.d
 493
 494 ## Comma separated list of kernel packages to keep installed in parallel, if the
 495 ## above multiversion variable is set. Packages can be specified as
 496 ## 2.6.32.12-0.7 - Exact version to keep
 497 ## latest        - Keep kernel with the highest version number
 498 ## latest-N      - Keep kernel with the Nth highest version number
 499 ## running       - Keep the running kernel
 500 ## oldest        - Keep kernel with the lowest version number (the GA kernel)
 501 ## oldest+N      - Keep kernel with the Nth lowest version number
 502 ##
 503 ## Note: This entry is not evaluated by libzypp, but by the
 504 ##       purge-kernels service (via /sbin/purge-kernels).
 505 ##
 506 ## Default: Do not delete any kernels if multiversion = provides:multiversion(kernel) is set
 507 multiversion.kernels = latest,latest-1,running
 508
 509 ##
 510 ## Path to locks file. If not exist then is create.
 511 ## In this file is saved also UI locks.
 512 ##
 513 ## valid value: path to file or place where file can be created
 514 ## default value: {configdir}/locks
 515 ##
 516 # locksfile.path = /etc/zypp/locks
 517
 518 ##
 519 ## Whether to apply locks in locks file after zypp start.
 520 ##
 521 ## Valid values: boolean
 522 ## Default value: true
 523 ##
 524 # locksfile.apply = true
 525
 526 ##
 527 ## Where update items are stored
 528 ## (example: scripts, messages)
 529 ##
 530 ## Valid values: path to directory
 531 ## Default value: /var/adm
 532 ##
 533 # update.datadir = /var/adm
 534
 535 ##
 536 ## Where update messages are stored
 537 ##
 538 ## Valid values: path to directory
 539 ## Default value: {update.datadir}/update-messages
 540 ##
 541 # update.messagesdir = /var/adm/update-messages
 542
 543 ##
 544 ## Where update scripts are stored
 545 ##
 546 ## Valid values: path to directory
 547 ## Default value: {update.datadir}/update-scripts
 548 ##
 549 # update.scriptsdir = /var/adm/update-scripts
 550
 551 ##
 552 ## Command to be invoked to send update messages.
 553 ##
 554 ## Packages may leave an update message file in {update.messagesdir}.
 555 ## At the end of each commit, zypp collects those messages and may send
 556 ## a notification to the user.
 557 ##
 558 ## zypp will prepare the update messages according to the selected
 559 ## content format and pipe the content to the command.
 560 ##
 561 ## Format:
 562 ##     single - For each update message invoke the command and send
 563 ##              the message.
 564 ##     none   - For each update message invoke the command but don't
 565 ##              use a pipe to send any data. You probably want to pass
 566 ##              the message file on the commandline using %P (see
 567 ##              Substitutions).
 568 ##     digest - Single invocation of the command, sending the path
 569 ##              names of all update message. One per line.
 570 ##     bulk   - Single invocation of the command, sending the
 571 ##              concatenated content of all update messages, separated
 572 ##              by Ctrl-L.
 573 ##
 574 ## Substitutions:
 575 ##     %p     - package identification (name-version-release.arch)
 576 ##     %P     - full path to the update message file
 577 ##
 578 ## Valid values: The value is specified as "format | command".
 579 ##               An empty value will turn off any notification.
 580 ##
 581 ## Examples:     single | mail -s 'Update message from %p' root
 582 ##               none   | my-send-script -f %P
 583 ##
 584 ## Default value: single | /usr/lib/zypp/notify-message -p %p
 585 ##
 586 # update.messages.notify = single | /usr/lib/zypp/notify-message -p %p
 587
 588 ##
 589 ## Options for package installation: excludedocs
 590 ##
 591 ## Don't install any files which are marked as documentation.
 592 ##
 593 ## Valid values:  boolean
 594 ## Default value: no
 595 ##
 596 # rpm.install.excludedocs = no
 597
 598 ##
 599 ## Location of history log file.
 600 ##
 601 ## The history log is described at
 602 ## http://en.opensuse.org/Libzypp/Package_History
 603 ##
 604 ## Valid values: absolute path to a file
 605 ## Default value: /var/log/zypp/history
 606 ##
 607 # history.logfile = /var/log/zypp/history
 608
 609 ##
 610 ## Global credentials directory path.
 611 ##
 612 ## If a URL contains ?credentials=<filename> parameter, the credentials will
 613 ## be stored and looked for in a file named <filename> in this directory.
 614 ##
 615 ## Valid values: absolute path to a directory
 616 ## Default value: /etc/zypp/credentials.d
 617 ##
 618 # credentials.global.dir = /etc/zypp/credentials.d
 619
 620 ##
 621 ## Global credentials catalog file path.
 622 ##
 623 ## This file contains a catalog of all known user credentials which were
 624 ## not stored via the ?credentials=<filename> URL parameter, i.e. passed
 625 ## in URL as username:password component, or entered by user in
 626 ## an authentication dialog.
 627 ##
 628 ## Valid values: absolute path to a file
 629 ## Default value: /etc/zypp/credentials.cat
 630 ##
 631 # credentials.global.file = /etc/zypp/credentials.cat