Add zypp.conf option commit.downloadMode to set the default commit download policy.
[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 oposite
116 ## effect, disable autorefresh for your repositories.
117 ##
118 ## This option has no effect for repositories with autorefresh disabled, nor for
119 ## user-requested refresh.
120 ##
121 # repo.refresh.delay = 10
122
123 ##
124 ## Maximum number of concurrent connections to use per transfer
125 ## This setting is only used if more than one is possible
126 ## Setting it to a reasonable number avoids flooding servers
127 ##
128 # download.max_concurrent_connections = 2
129
130 ##
131 ## Sets the minimum download speed (bytes per second)
132 ## until the connection is dropped
133 ## This can be useful to prevent security attacks on hosts by
134 ## providing updates at very low speeds.
135 ##
136 ## 0 means no limit
137 ##
138 # download.min_download_speed = 0
139
140 ## Maximum download speed (bytes per second)
141 ## 0 means no limit
142 # download.max_download_speed = 0
143
144 ## Number of tries per download which will be
145 ## done without user interaction
146 ## 0 means no limit (use with caution)
147 # download.max_silent_tries = 5
148
149 ##
150 ## Whether to consider using a .delta.rpm when downloading a package
151 ##
152 ## Valid values: boolean
153 ## Default value: true
154 ##
155 ## Using a delta rpm will decrease the download size for package updates
156 ## since it does not contain all files of the package but only the binary
157 ## diff of changed ones. Recreating the rpm package on the local machine
158 ## is an expensive operation (memory,CPU). If your network connection is
159 ## not too slow, you benefit from disabling .delta.rpm.
160 ##
161 # download.use_deltarpm = true
162
163 ##
164 ## Whether to consider using a deltarpm even when rpm is local
165 ##
166 ## Valid values: boolean
167 ## Default value: false
168 ##
169 ## This option has no effect unless download.use_deltarpm is set true.
170 ##
171 #  download.use_deltarpm.always = false
172
173 ##
174 ## Hint which media to prefer when installing packages (download vs. CD).
175 ##
176 ## Valid values:        download, volatile
177 ## Default value:       download
178 ##
179 ## Note that this just a hint. First of all the solver will choose the 'best'
180 ## package according to its repos priority, version and architecture. But if
181 ## there is a choice, we will prefer packages from the desired media.
182 ##
183 ## Packages available locally are always preferred. The question is whether
184 ## you prefer packages being downloaded via FTP/HTTP/HTTPS (download), rather
185 ## than being prompted to insert a CD/DVD (volatile), in case they are available
186 ## on both media.
187 ##
188 ##   Name             | Priority | URI
189 ##   openSUSE-11.1      99         dvd:///
190 ##   openSUSE-11.1-Oss  99         http://download.opensuse.org/distribution/11.1/repo/oss
191 ##
192 ## In the above example 2 repositories with similar content are used. Rather
193 ## than raising the priority of one of them to 'prefer' a certain media, you
194 ## should use the same priority for both and set download.media_preference
195 ## instead.
196 ##
197 ## download.media_preference = download
198
199 ##
200 ## Commit download policy to use as default.
201 ##
202 ##  DownloadOnly,       Just download all packages to the local cache.
203 ##                      Do not install. Implies a dry-run.
204 ##
205 ##  DownloadInAdvance,  First download all packages to the local cache.
206 ##                      Then start to install.
207 ##
208 ##  DownloadInHeaps,    Similar to DownloadInAdvance, but try to split
209 ##                      the transaction into heaps, where at the end of
210 ##                      each heap a consistent system state is reached.
211 ##
212 ##  DownloadAsNeeded    Alternating download and install. Packages are
213 ##                      cached just to avid CD/DVD hopping. This is the
214 ##                      traditional behaviour.
215 ##
216 ##  <UNSET>             If a value is not set, empty or unknown, we pick
217 ##                      some save default.
218 ##
219 ## commit.downloadMode =
220
221 ##
222 ## Defining directory which contains vendor description files.
223 ##
224 ## One file in this directory reflects a group of equivalent vendors. e.G.:
225 ## (filename is "nvidia" but could be any other name):
226 ## ------------------------- file contains begin -----------------------
227 ## [main]
228 ##
229 ## vendors = nvidia,suse,opensuse
230 ##
231 ## ------------------------- file contains end -----------------------
232 ## Libzypp makes an string comparision (like strncmp, case-insensitive)
233 ## whereas the beginning of the strings are compared only.
234 ## e.G. vendor "opensuse11.0" is compatible to "openSuSE".
235 ##
236 ## Valid values: A directory
237 ## Default value: {configdir}/vendors.d
238 ##
239 # vendordir = /etc/zypp/vendors.d
240
241
242 ##
243 ## Whether required packages are installed ONLY
244 ## So recommended packages, language packages and packages which depend
245 ## on hardware (modalias) will not be regarded.
246 ##
247 ## Valid values: boolean
248 ## Default value: false
249 ##
250 # solver.onlyRequires = false
251
252 ##
253 ## EXPERTS ONLY: Per default the solver will not replace packages of
254 ## different vendors, unless you explicitly ask to do so. Setting this
255 ## option to TRUE will disable this vendor check (unless the application
256 ## explicitly re-enables it). Packages will then be considered based on
257 ## repository priority and version only. This may easily damage your system.
258 ##
259 ## CHANGING THE DEFAULT IS NOT RECOMMENDED.
260 ##
261 ## Valid values:  boolean
262 ## Default value: false
263 ##
264 # solver.allowVendorChange = false
265
266 ##
267 ## This file contains requirements/conflicts which fulfill the
268 ## needs of a running system.
269 ## For example the system would be broken if not glibc or kernel is
270 ## installed.
271 ## So the user will be informed if these packages will be deleted.
272 ##
273 ## Format: Each line represents one dependency:
274 ##         e.g.
275 ##         requires:kernel
276 ##         requires:glibc
277 ## Default value: {configdir}/systemCheck
278 ##
279 # solver.checkSystemFile = /etc/zypp/systemCheck
280
281 ##
282 ## When committing a dist upgrade (e.g. 'zypper dup') a solver testcase
283 ## is written to /var/log/updateTestcase-<date>. It is needed in bugreports.
284 ## This optin returns the number of testcases to keep on the system. Old
285 ## cases will be deleted, as new ones are created.
286 ##
287 ## Use 0 to write no testcase at all, or -1 to keep all testcases.
288 ##
289 ## Valid values:        Integer
290 ## Default value:       2
291 ##
292 # solver.upgradeTestcasesToKeep = 2
293
294 ##
295 ## Packages which are parallel installable with
296 ## diffent versions
297 ##
298 # multiversion = kernel-default,kernel-smp
299
300 ##
301 ## Path to locks file. If not exist then is create.
302 ## In this file is saved also UI locks.
303 ##
304 ## valid value: path to file or place where file can be created
305 ## default value: {configdir}/locks
306 ##
307 # locksfile.path = /etc/zypp/locks
308
309 ##
310 ## Whetever to apply locks in locks file after zypp start.
311 ##
312 ## Valid values: boolean
313 ## Default value: true
314 ##
315 # locksfile.apply = true
316
317 ##
318 ## Where update items are stored
319 ## (example: scripts, messages)
320 ##
321 ## Valid values: path to directory
322 ## Default value: /var/adm
323 ##
324 # update.datadir = /var/adm
325
326 ##
327 ## Where update messages are stored
328 ##
329 ## Valid values: path to directory
330 ## Default value: {update.datadir}/update-messages
331 ##
332 # update.messagesdir = /var/adm/update-messages
333
334 ##
335 ## Where update scripts are stored
336 ##
337 ## Valid values: path to directory
338 ## Default value: {update.datadir}/update-scripts
339 ##
340 # update.scriptsdir = /var/adm/update-scripts
341
342 ##
343 ## Options for package installation: excludedocs
344 ##
345 ## Don't install any files which are marked as documentation.
346 ##
347 ## Valid values:  boolean
348 ## Default value: no
349 ##
350 # rpm.install.excludedocs = no
351
352 ##
353 ## Location of history log file.
354 ##
355 ## The history log is described at
356 ## http://en.opensuse.org/Libzypp/Package_History
357 ##
358 ## Valid values: absolute path to a file
359 ## Default value: /var/log/zypp/history
360 ##
361 # history.logfile = /var/log/zypp/history
362
363 ##
364 ## Global credentials directory path.
365 ##
366 ## If a URL contains ?credentials=<filename> parameter, the credentials will
367 ## be stored and looked for in a file named <filename> in this directory.
368 ##
369 ## Valid values: absolute path to a directory
370 ## Default value: /etc/zypp/credentials.d
371 ##
372 # credentials.global.dir = /etc/zypp/credentials.d
373
374 ##
375 ## Global credentials catalog file path.
376 ##
377 ## This file contains a catalog of all known user credentials which were
378 ## not stored via the ?credentials=<filename> URL parameter, i.e. passed
379 ## in URL as username:password component, or entered by user in
380 ## an authentication dialog.
381 ##
382 ## Valid values: absolute path to a file
383 ## Default value: /etc/zypp/credentials.cat
384 ##
385 # credentials.global.file = /etc/zypp/credentials.cat