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