Imported Upstream version 17.15.0
[platform/upstream/libzypp.git] / 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 ## The solvers general attitude when resolving jobs.
348 ##
349 ## Valid values:
350 ##
351 ##   Job       - Focus on installing the best version of the requested packages.
352 ##               Add missing dependencies as needed. This is the solvers default.
353 ##
354 ##   Installed - Focus on applying as little changes to the installed packages
355 ##               as needed. Choosing an older version of a package is valid if
356 ##               it's dependencies require less changes to the system.
357 ##
358 ##   Update    - Focus on updating requested packages and their dependencies as
359 ##               much as possible.
360 ##
361 ##   Default   - If the value is not set, empty or unknown, we use the default.
362 ##
363 # solver.focus =
364
365 ##
366 ## Whether only required packages are installed.
367 ##
368 ## Recommended packages, will not be regarded.
369 ##
370 ## Valid values: boolean
371 ## Default value: false
372 ##
373 # solver.onlyRequires = false
374
375 ##
376 ## EXPERTS ONLY: Per default the solver will not replace packages of
377 ## different vendors, unless you explicitly ask to do so. Setting this
378 ## option to TRUE will disable this vendor check (unless the application
379 ## explicitly re-enables it). Packages will then be considered based on
380 ## repository priority and version only. This may easily damage your system.
381 ##
382 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
383 ##
384 ## Valid values:  boolean
385 ## Default value: false
386 ##
387 # solver.allowVendorChange = false
388
389 ##
390 ## EXPERTS ONLY: TUNE DISTRIBUTION UPGRADE (DUP)
391 ## Set whether to allow package version downgrades upon DUP.
392 ##
393 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
394 ##
395 ## Valid values:  boolean
396 ## Default value: true
397 ##
398 # solver.dupAllowDowngrade = true
399
400 ##
401 ## EXPERTS ONLY: TUNE DISTRIBUTION UPGRADE (DUP)
402 ## Set whether follow package renames upon DUP.
403 ##
404 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
405 ##
406 ## Valid values:  boolean
407 ## Default value: true
408 ##
409 # solver.dupAllowNameChange = true
410
411 ##
412 ## EXPERTS ONLY: TUNE DISTRIBUTION UPGRADE (DUP)
413 ## Set whether to allow changing the packages architecture upon DUP.
414 ##
415 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
416 ##
417 ## Valid values:  boolean
418 ## Default value: true
419 ##
420 # solver.dupAllowArchChange = true
421
422 ##
423 ## EXPERTS ONLY: TUNE DISTRIBUTION UPGRADE (DUP)
424 ## Set whether to allow changing the packages vendor upon DUP. If you
425 ## are following a continuous distribution like Tumbleweed or Factory
426 ## where you use 'zypper dup --no-allow-vendor-change' quite frequently,
427 ## you may indeed benefit from disabling the VendorChange. Packages from
428 ## OBS repos will then be kept rather than being overwritten by Tumbleweeds
429 ## version.
430 ##
431 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
432 ##
433 ## Valid values:  boolean
434 ## Default value: true
435 ##
436 # solver.dupAllowVendorChange = true
437
438 ##
439 ## EXPERTS ONLY: Cleanup when deleting packages. Whether the solver should
440 ## per default try to remove packages exclusively required by the ones he's
441 ## asked to delete.
442 ##
443 ## This option should be used on a case by case basis, enabled via
444 ## command line options or switches the applications offer. Changing
445 ## the global default on a system where unattended actions are performed,
446 ## may easily damage your system.
447 ##
448 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
449 ##
450 ## Valid values:  boolean
451 ## Default value: false
452 ##
453 # solver.cleandepsOnRemove = false
454
455 ##
456 ## This file contains requirements/conflicts which fulfill the
457 ## needs of a running system.
458 ## For example the system would be broken if not glibc or kernel is
459 ## installed.
460 ## So the user will be informed if these packages will be deleted.
461 ##
462 ## Format: Each line represents one dependency:
463 ##         e.g.
464 ##         requires:kernel
465 ##         requires:glibc
466 ## Default value: {configdir}/systemCheck
467 ##
468 # solver.checkSystemFile = /etc/zypp/systemCheck
469
470 ##
471 ## This directory can contain files that contain requirements/conflicts
472 ## which fulfill the needs of a running system (see checkSystemFile).
473 ##
474 ## Files are read in alphabetical order.
475 ##
476 ## Default value: {configdir}/systemCheck.d
477 ##
478 # solver.checkSystemFileDir = /etc/zypp/systemCheck.d
479
480 ##
481 ## When committing a dist upgrade (e.g. 'zypper dup') a solver testcase
482 ## is written to /var/log/updateTestcase-<date>. It is needed in bugreports.
483 ## This option returns the number of testcases to keep on the system. Old
484 ## cases will be deleted, as new ones are created.
485 ##
486 ## Use 0 to write no testcase at all, or -1 to keep all testcases.
487 ##
488 ## Valid values:        Integer
489 ## Default value:       2
490 ##
491 # solver.upgradeTestcasesToKeep = 2
492
493 ##
494 ## Whether dist upgrade should remove a products dropped packages.
495 ##
496 ## A new product may suggest a list of old and no longer supported
497 ## packages (dropped packages). Performing a dist upgrade the solver
498 ## may try to delete them, even if they do not cause any dependency
499 ## problem.
500 ##
501 ## Turning this option off, the solver will not try to remove those
502 ## packages unless they actually do cause dependency trouble. You may
503 ## do the cleanup manually, or simply leave them installed as long
504 ## as you don't need the disk space.
505 ##
506 ## Valid values:        Boolean
507 ## Default value:       true
508 ##
509 # solver.upgradeRemoveDroppedPackages = true
510
511 ##
512 ## Packages which can be installed in different versions at the same time.
513 ##
514 ## Packages are selected either by name, or by provides. In the later case
515 ## the string must start with "provides:" immediately followed by the capability.
516 ##
517 ## Example:
518 ##      kernel                          - just packages whith name 'kernel'
519 ##      provides:multiversion(kernel)   - all packages providing 'multiversion(kernel)'
520 ##                                        (kenel and kmp packages should do this)
521 ## Valid values:
522 ##      Comma separated list of packages.
523 ##
524 ## Default value:
525 ##      empty
526 ##
527 multiversion = provides:multiversion(kernel)
528
529 ##
530 ## Defining directory which may contain additional multiversion definitions.
531 ##
532 ## If the directory exists, each file in this directory is scanned, expecting
533 ## one valid multiversion list entry per line. Empty lines and lines starting
534 ## with '#' are ignored.
535 ## ------------------------- [/etc/zypp/multiversion.d/example file begin] -----------------------
536 ## # An alternate way to enable kernel packages being
537 ## # installed in parallel:
538 ##
539 ## provides:multiversion(kernel)
540 ## ------------------------- [/etc/zypp/multiversion.d/example file end] -----------------------
541 ##
542 ## Valid values: A directory
543 ## Default value: {configdir}/multiversion.d
544 ##
545 # multiversiondir = /etc/zypp/multiversion.d
546
547 ## Comma separated list of kernel packages to keep installed in parallel, if the
548 ## above multiversion variable is set. Packages can be specified as
549 ## 2.6.32.12-0.7 - Exact version to keep
550 ## latest        - Keep kernel with the highest version number
551 ## latest-N      - Keep kernel with the Nth highest version number
552 ## running       - Keep the running kernel
553 ## oldest        - Keep kernel with the lowest version number (the GA kernel)
554 ## oldest+N      - Keep kernel with the Nth lowest version number
555 ##
556 ## Note: This entry is not evaluated by libzypp, but by the
557 ##       purge-kernels service (via /sbin/purge-kernels).
558 ##
559 ## Default: Do not delete any kernels if multiversion = provides:multiversion(kernel) is set
560 multiversion.kernels = latest,latest-1,running
561
562 ##
563 ## Path to locks file. If not exist then is create.
564 ## In this file is saved also UI locks.
565 ##
566 ## valid value: path to file or place where file can be created
567 ## default value: {configdir}/locks
568 ##
569 # locksfile.path = /etc/zypp/locks
570
571 ##
572 ## Whether to apply locks in locks file after zypp start.
573 ##
574 ## Valid values: boolean
575 ## Default value: true
576 ##
577 # locksfile.apply = true
578
579 ##
580 ## Where update items are stored
581 ## (example: scripts, messages)
582 ##
583 ## Valid values: path to directory
584 ## Default value: /var/adm
585 ##
586 # update.datadir = /var/adm
587
588 ##
589 ## Where update messages are stored
590 ##
591 ## Valid values: path to directory
592 ## Default value: {update.datadir}/update-messages
593 ##
594 # update.messagesdir = /var/adm/update-messages
595
596 ##
597 ## Where update scripts are stored
598 ##
599 ## Valid values: path to directory
600 ## Default value: {update.datadir}/update-scripts
601 ##
602 # update.scriptsdir = /var/adm/update-scripts
603
604 ##
605 ## Command to be invoked to send update messages.
606 ##
607 ## Packages may leave an update message file in {update.messagesdir}.
608 ## At the end of each commit, zypp collects those messages and may send
609 ## a notification to the user.
610 ##
611 ## zypp will prepare the update messages according to the selected
612 ## content format and pipe the content to the command.
613 ##
614 ## Format:
615 ##     single - For each update message invoke the command and send
616 ##              the message.
617 ##     none   - For each update message invoke the command but don't
618 ##              use a pipe to send any data. You probably want to pass
619 ##              the message file on the commandline using %P (see
620 ##              Substitutions).
621 ##     digest - Single invocation of the command, sending the path
622 ##              names of all update message. One per line.
623 ##     bulk   - Single invocation of the command, sending the
624 ##              concatenated content of all update messages, separated
625 ##              by Ctrl-L.
626 ##
627 ## Substitutions:
628 ##     %p     - package identification (name-version-release.arch)
629 ##     %P     - full path to the update message file
630 ##
631 ## Valid values: The value is specified as "format | command".
632 ##               An empty value will turn off any notification.
633 ##
634 ## Examples:     single | mail -s 'Update message from %p' root
635 ##               none   | my-send-script -f %P
636 ##
637 ## Default value: <empty>
638 ##
639 # update.messages.notify =
640
641 ##
642 ## Options for package installation: excludedocs
643 ##
644 ## Don't install any files which are marked as documentation.
645 ##
646 ## Valid values:  boolean
647 ## Default value: no
648 ##
649 # rpm.install.excludedocs = no
650
651 ##
652 ## Location of history log file.
653 ##
654 ## The history log is described at
655 ## http://en.opensuse.org/Libzypp/Package_History
656 ##
657 ## Valid values: absolute path to a file
658 ## Default value: /var/log/zypp/history
659 ##
660 # history.logfile = /var/log/zypp/history
661
662 ##
663 ## Global credentials directory path.
664 ##
665 ## If a URL contains ?credentials=<filename> parameter, the credentials will
666 ## be stored and looked for in a file named <filename> in this directory.
667 ##
668 ## Valid values: absolute path to a directory
669 ## Default value: /etc/zypp/credentials.d
670 ##
671 # credentials.global.dir = /etc/zypp/credentials.d
672
673 ##
674 ## Global credentials catalog file path.
675 ##
676 ## This file contains a catalog of all known user credentials which were
677 ## not stored via the ?credentials=<filename> URL parameter, i.e. passed
678 ## in URL as username:password component, or entered by user in
679 ## an authentication dialog.
680 ##
681 ## Valid values: absolute path to a file
682 ## Default value: /etc/zypp/credentials.cat
683 ##
684 # credentials.global.file = /etc/zypp/credentials.cat