]>
Commit | Line | Data |
---|---|---|
1 | # Translation of apt manpages and documentation to LANGUAGE | |
2 | # This file is distributed under the same license as the apt-doc package. | |
3 | # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. | |
4 | # | |
5 | #, fuzzy | |
6 | msgid "" | |
7 | msgstr "" | |
8 | "Project-Id-Version: apt-doc 1.1.5~20151214\n" | |
9 | "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n" | |
10 | "POT-Creation-Date: 2015-12-14 16:56+0100\n" | |
11 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" | |
12 | "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" | |
13 | "Language-Team: LANGUAGE <LL@li.org>\n" | |
14 | "Language: \n" | |
15 | "MIME-Version: 1.0\n" | |
16 | "Content-Type: text/plain; charset=UTF-8\n" | |
17 | "Content-Transfer-Encoding: 8bit\n" | |
18 | ||
19 | #. type: Plain text | |
20 | #: apt.ent:1 | |
21 | #, no-wrap | |
22 | msgid "" | |
23 | "<!ENTITY apt-author.team \"\n" | |
24 | " <author>\n" | |
25 | " <othername>APT team</othername>\n" | |
26 | " <contrib></contrib>\n" | |
27 | " </author>\n" | |
28 | "\">\n" | |
29 | msgstr "" | |
30 | ||
31 | #. type: Plain text | |
32 | #: apt.ent:1 | |
33 | #, no-wrap | |
34 | msgid "" | |
35 | "<!ENTITY apt-qapage \"\n" | |
36 | "\t<para>\n" | |
37 | "\t\t<ulink url='http://packages.qa.debian.org/a/apt.html'>QA Page</ulink>\n" | |
38 | "\t</para>\n" | |
39 | "\">\n" | |
40 | msgstr "" | |
41 | ||
42 | #. type: Plain text | |
43 | #: apt.ent:1 | |
44 | #, no-wrap | |
45 | msgid "" | |
46 | "<!-- Boiler plate Bug reporting section -->\n" | |
47 | "<!ENTITY manbugs \"\n" | |
48 | " <refsect1><title>Bugs</title>\n" | |
49 | " <para><ulink url='http://bugs.debian.org/src:apt'>APT bug page</ulink>.\n" | |
50 | " If you wish to report a bug in APT, please see\n" | |
51 | " <filename>/usr/share/doc/debian/bug-reporting.txt</filename> or the\n" | |
52 | " &reportbug; command.\n" | |
53 | " </para>\n" | |
54 | " </refsect1>\n" | |
55 | "\">\n" | |
56 | msgstr "" | |
57 | ||
58 | #. type: Plain text | |
59 | #: apt.ent:1 | |
60 | #, no-wrap | |
61 | msgid "" | |
62 | "<!-- Boiler plate Author section -->\n" | |
63 | "<!ENTITY manauthor \"\n" | |
64 | " <refsect1><title>Author</title>\n" | |
65 | " <para>APT was written by the APT team " | |
66 | "<email>apt@packages.debian.org</email>.\n" | |
67 | " </para>\n" | |
68 | " </refsect1>\n" | |
69 | "\">\n" | |
70 | msgstr "" | |
71 | ||
72 | #. type: Plain text | |
73 | #: apt.ent:1 | |
74 | #, no-wrap | |
75 | msgid "" | |
76 | "<!-- Should be used within the option section of the text to\n" | |
77 | " put in the blurb about -h, -v, -c and -o -->\n" | |
78 | "<!ENTITY apt-commonoptions \"\n" | |
79 | " <varlistentry><term><option>-h</option></term>\n" | |
80 | " <term><option>--help</option></term>\n" | |
81 | " <listitem><para>Show a short usage summary.\n" | |
82 | " </para>\n" | |
83 | " </listitem>\n" | |
84 | " </varlistentry>\n" | |
85 | msgstr "" | |
86 | ||
87 | #. type: Plain text | |
88 | #: apt.ent:1 | |
89 | #, no-wrap | |
90 | msgid "" | |
91 | " <varlistentry>\n" | |
92 | " <term><option>-v</option></term>\n" | |
93 | " <term><option>--version</option></term>\n" | |
94 | " <listitem><para>Show the program version.\n" | |
95 | " </para>\n" | |
96 | " </listitem>\n" | |
97 | " </varlistentry>\n" | |
98 | msgstr "" | |
99 | ||
100 | #. type: Plain text | |
101 | #: apt.ent:1 | |
102 | #, no-wrap | |
103 | msgid "" | |
104 | " <varlistentry>\n" | |
105 | " <term><option>-c</option></term>\n" | |
106 | " <term><option>--config-file</option></term>\n" | |
107 | " <listitem><para>Configuration File; Specify a configuration file to " | |
108 | "use. \n" | |
109 | " The program will read the default configuration file and then this \n" | |
110 | " configuration file. If configuration settings need to be set before " | |
111 | "the\n" | |
112 | " default configuration files are parsed specify a file with the " | |
113 | "<envar>APT_CONFIG</envar>\n" | |
114 | " environment variable. See &apt-conf; for syntax information.\n" | |
115 | " </para>\n" | |
116 | " </listitem>\n" | |
117 | " </varlistentry>\n" | |
118 | msgstr "" | |
119 | ||
120 | #. type: Plain text | |
121 | #: apt.ent:1 | |
122 | #, no-wrap | |
123 | msgid "" | |
124 | " <varlistentry>\n" | |
125 | " <term><option>-o</option></term>\n" | |
126 | " <term><option>--option</option></term>\n" | |
127 | " <listitem><para>Set a Configuration Option; This will set an " | |
128 | "arbitrary\n" | |
129 | " configuration option. The syntax is <option>-o " | |
130 | "Foo::Bar=bar</option>.\n" | |
131 | " <option>-o</option> and <option>--option</option> can be used " | |
132 | "multiple\n" | |
133 | " times to set different options.\n" | |
134 | " </para>\n" | |
135 | " </listitem>\n" | |
136 | " </varlistentry>\n" | |
137 | "\">\n" | |
138 | msgstr "" | |
139 | ||
140 | #. type: Plain text | |
141 | #: apt.ent:1 | |
142 | #, no-wrap | |
143 | msgid "" | |
144 | "<!-- Should be used within the option section of the text to\n" | |
145 | " put in the blurb about -h, -v, -c and -o -->\n" | |
146 | "<!ENTITY apt-cmdblurb \"\n" | |
147 | " <para>All command line options may be set using the configuration file, " | |
148 | "the\n" | |
149 | " descriptions indicate the configuration option to set. For boolean\n" | |
150 | " options you can override the config file by using something like \n" | |
151 | " <option>-f-</option>,<option>--no-f</option>, <option>-f=no</option>\n" | |
152 | " or several other variations.\n" | |
153 | " </para>\n" | |
154 | "\">\n" | |
155 | msgstr "" | |
156 | ||
157 | #. type: Plain text | |
158 | #: apt.ent:1 | |
159 | #, no-wrap | |
160 | msgid "" | |
161 | "<!ENTITY file-aptconf \"\n" | |
162 | " <varlistentry><term><filename>/etc/apt/apt.conf</filename></term>\n" | |
163 | " <listitem><para>APT configuration file.\n" | |
164 | " Configuration Item: " | |
165 | "<literal>Dir::Etc::Main</literal>.</para></listitem>\n" | |
166 | " </varlistentry>\n" | |
167 | msgstr "" | |
168 | ||
169 | #. type: Plain text | |
170 | #: apt.ent:1 | |
171 | #, no-wrap | |
172 | msgid "" | |
173 | " <varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term>\n" | |
174 | " <listitem><para>APT configuration file fragments.\n" | |
175 | " Configuration Item: " | |
176 | "<literal>Dir::Etc::Parts</literal>.</para></listitem>\n" | |
177 | " </varlistentry>\n" | |
178 | "\">\n" | |
179 | msgstr "" | |
180 | ||
181 | #. type: Plain text | |
182 | #: apt.ent:1 | |
183 | #, no-wrap | |
184 | msgid "" | |
185 | "<!ENTITY file-cachearchives \"\n" | |
186 | " <varlistentry><term><filename>&cachedir;/archives/</filename></term>\n" | |
187 | " <listitem><para>Storage area for retrieved package files.\n" | |
188 | " Configuration Item: " | |
189 | "<literal>Dir::Cache::Archives</literal>.</para></listitem>\n" | |
190 | " </varlistentry>\n" | |
191 | msgstr "" | |
192 | ||
193 | #. type: Plain text | |
194 | #: apt.ent:1 | |
195 | #, no-wrap | |
196 | msgid "" | |
197 | " " | |
198 | "<varlistentry><term><filename>&cachedir;/archives/partial/</filename></term>\n" | |
199 | " <listitem><para>Storage area for package files in transit.\n" | |
200 | " Configuration Item: <literal>Dir::Cache::Archives</literal> " | |
201 | "(<filename>partial</filename> will be implicitly " | |
202 | "appended)</para></listitem>\n" | |
203 | " </varlistentry>\n" | |
204 | "\">\n" | |
205 | msgstr "" | |
206 | ||
207 | #. type: Plain text | |
208 | #: apt.ent:1 | |
209 | #, no-wrap | |
210 | msgid "" | |
211 | "<!ENTITY file-preferences \"\n" | |
212 | " <varlistentry><term><filename>/etc/apt/preferences</filename></term>\n" | |
213 | " <listitem><para>Version preferences file.\n" | |
214 | " This is where you would specify "pinning",\n" | |
215 | " i.e. a preference to get certain packages\n" | |
216 | " from a separate source\n" | |
217 | " or from a different version of a distribution.\n" | |
218 | " Configuration Item: " | |
219 | "<literal>Dir::Etc::Preferences</literal>.</para></listitem>\n" | |
220 | " </varlistentry>\n" | |
221 | msgstr "" | |
222 | ||
223 | #. type: Plain text | |
224 | #: apt.ent:1 | |
225 | #, no-wrap | |
226 | msgid "" | |
227 | " " | |
228 | "<varlistentry><term><filename>/etc/apt/preferences.d/</filename></term>\n" | |
229 | " <listitem><para>File fragments for the version preferences.\n" | |
230 | " Configuration Item: " | |
231 | "<literal>Dir::Etc::PreferencesParts</literal>.</para></listitem>\n" | |
232 | " </varlistentry>\n" | |
233 | "\">\n" | |
234 | msgstr "" | |
235 | ||
236 | #. type: Plain text | |
237 | #: apt.ent:1 | |
238 | #, no-wrap | |
239 | msgid "" | |
240 | "<!ENTITY file-sourceslist \"\n" | |
241 | " <varlistentry><term><filename>/etc/apt/sources.list</filename></term>\n" | |
242 | " <listitem><para>Locations to fetch packages from.\n" | |
243 | " Configuration Item: " | |
244 | "<literal>Dir::Etc::SourceList</literal>.</para></listitem>\n" | |
245 | " </varlistentry>\n" | |
246 | msgstr "" | |
247 | ||
248 | #. type: Plain text | |
249 | #: apt.ent:1 | |
250 | #, no-wrap | |
251 | msgid "" | |
252 | " " | |
253 | "<varlistentry><term><filename>/etc/apt/sources.list.d/</filename></term>\n" | |
254 | " <listitem><para>File fragments for locations to fetch packages from.\n" | |
255 | " Configuration Item: " | |
256 | "<literal>Dir::Etc::SourceParts</literal>.</para></listitem>\n" | |
257 | " </varlistentry>\n" | |
258 | "\">\n" | |
259 | msgstr "" | |
260 | ||
261 | #. type: Plain text | |
262 | #: apt.ent:1 | |
263 | #, no-wrap | |
264 | msgid "" | |
265 | "<!ENTITY file-statelists \"\n" | |
266 | " <varlistentry><term><filename>&statedir;/lists/</filename></term>\n" | |
267 | " <listitem><para>Storage area for state information for each package " | |
268 | "resource specified in\n" | |
269 | " &sources-list;\n" | |
270 | " Configuration Item: " | |
271 | "<literal>Dir::State::Lists</literal>.</para></listitem>\n" | |
272 | " </varlistentry>\n" | |
273 | msgstr "" | |
274 | ||
275 | #. type: Plain text | |
276 | #: apt.ent:1 | |
277 | #, no-wrap | |
278 | msgid "" | |
279 | " " | |
280 | "<varlistentry><term><filename>&statedir;/lists/partial/</filename></term>\n" | |
281 | " <listitem><para>Storage area for state information in transit.\n" | |
282 | " Configuration Item: <literal>Dir::State::Lists</literal> " | |
283 | "(<filename>partial</filename> will be implicitly " | |
284 | "appended)</para></listitem>\n" | |
285 | " </varlistentry>\n" | |
286 | "\">\n" | |
287 | msgstr "" | |
288 | ||
289 | #. type: Plain text | |
290 | #: apt.ent:1 | |
291 | #, no-wrap | |
292 | msgid "" | |
293 | "<!ENTITY file-trustedgpg \"\n" | |
294 | " <varlistentry><term><filename>/etc/apt/trusted.gpg</filename></term>\n" | |
295 | " <listitem><para>Keyring of local trusted keys, new keys will be added " | |
296 | "here.\n" | |
297 | " Configuration Item: " | |
298 | "<literal>Dir::Etc::Trusted</literal>.</para></listitem>\n" | |
299 | " </varlistentry>\n" | |
300 | msgstr "" | |
301 | ||
302 | #. type: Plain text | |
303 | #: apt.ent:1 | |
304 | #, no-wrap | |
305 | msgid "" | |
306 | " " | |
307 | "<varlistentry><term><filename>/etc/apt/trusted.gpg.d/</filename></term>\n" | |
308 | " <listitem><para>File fragments for the trusted keys, additional " | |
309 | "keyrings can\n" | |
310 | " be stored here (by other packages or the administrator).\n" | |
311 | " Configuration Item " | |
312 | "<literal>Dir::Etc::TrustedParts</literal>.</para></listitem>\n" | |
313 | " </varlistentry>\n" | |
314 | "\">\n" | |
315 | msgstr "" | |
316 | ||
317 | #. type: Plain text | |
318 | #: apt.ent:1 | |
319 | #, no-wrap | |
320 | msgid "" | |
321 | "<!ENTITY file-extended_states \"\n" | |
322 | " " | |
323 | "<varlistentry><term><filename>/var/lib/apt/extended_states</filename></term>\n" | |
324 | " <listitem><para>Status list of auto-installed packages.\n" | |
325 | " Configuration Item: <literal>Dir::State::extended_states</literal>.\n" | |
326 | " </para></listitem>\n" | |
327 | " </varlistentry>\n" | |
328 | "\">\n" | |
329 | msgstr "" | |
330 | ||
331 | #. type: Plain text | |
332 | #: apt.ent:1 | |
333 | #, no-wrap | |
334 | msgid "" | |
335 | "<!-- TRANSLATOR: This is the section header for the following paragraphs - " | |
336 | "comparable\n" | |
337 | " to the other headers like NAME and DESCRIPTION and should therefore be " | |
338 | "uppercase. -->\n" | |
339 | "<!ENTITY translation-title \"TRANSLATION\">\n" | |
340 | msgstr "" | |
341 | ||
342 | #. type: Plain text | |
343 | #: apt.ent:1 | |
344 | #, no-wrap | |
345 | msgid "" | |
346 | "<!-- TRANSLATOR: This is a placeholder. You should write here who has " | |
347 | "contributed\n" | |
348 | " to the translation in the past, who is responsible now and maybe " | |
349 | "further information\n" | |
350 | " specially related to your translation. -->\n" | |
351 | "<!ENTITY translation-holder \"\n" | |
352 | " The english translation was done by John Doe " | |
353 | "<email>john@doe.org</email> in 2009,\n" | |
354 | " 2010 and Daniela Acme <email>daniela@acme.us</email> in 2010 together " | |
355 | "with the\n" | |
356 | " Debian Dummy l10n Team " | |
357 | "<email>debian-l10n-dummy@lists.debian.org</email>.\n" | |
358 | "\">\n" | |
359 | msgstr "" | |
360 | ||
361 | #. type: Plain text | |
362 | #: apt.ent:1 | |
363 | #, no-wrap | |
364 | msgid "" | |
365 | "<!-- TRANSLATOR: As a translation is allowed to have 20% of " | |
366 | "untranslated/fuzzy strings\n" | |
367 | " in a shipped manpage newer/modified paragraphs will maybe appear in " | |
368 | "english in\n" | |
369 | " the generated manpage. This sentence is therefore here to tell the " | |
370 | "reader that this\n" | |
371 | " is not a mistake by the translator - obviously the target is that at " | |
372 | "least for stable\n" | |
373 | " releases this sentence is not needed. :) -->\n" | |
374 | "<!ENTITY translation-english \"\n" | |
375 | " Note that this translated document may contain untranslated parts.\n" | |
376 | " This is done on purpose, to avoid losing content when the\n" | |
377 | " translation is lagging behind the original content.\n" | |
378 | "\">\n" | |
379 | msgstr "" | |
380 | ||
381 | #. type: Plain text | |
382 | #: apt.ent:1 | |
383 | msgid "" | |
384 | "<!-- TRANSLATOR: used as in -o=config_string " | |
385 | "e.g. -o=Debug::pkgProblemResolver=1 --> <!ENTITY synopsis-config-string " | |
386 | "\"config_string\">" | |
387 | msgstr "" | |
388 | ||
389 | #. type: Plain text | |
390 | #: apt.ent:1 | |
391 | msgid "" | |
392 | "<!-- TRANSLATOR: used as in -c=config_file e.g. -c=./apt.conf --> <!ENTITY " | |
393 | "synopsis-config-file \"config_file\">" | |
394 | msgstr "" | |
395 | ||
396 | #. type: Plain text | |
397 | #: apt.ent:1 | |
398 | msgid "" | |
399 | "<!-- TRANSLATOR: used as in -t=target_release or pkg/target_release " | |
400 | "e.g. -t=squeeze apt/experimental --> <!ENTITY synopsis-target-release " | |
401 | "\"target_release\">" | |
402 | msgstr "" | |
403 | ||
404 | #. type: Plain text | |
405 | #: apt.ent:1 | |
406 | msgid "" | |
407 | "<!-- TRANSLATOR: used as in -a=architecture e.g. -a=armel --> <!ENTITY " | |
408 | "synopsis-architecture \"architecture\">" | |
409 | msgstr "" | |
410 | ||
411 | #. type: Plain text | |
412 | #: apt.ent:1 | |
413 | msgid "" | |
414 | "<!-- TRANSLATOR: used as in apt-get install pkg e.g. apt-get install awesome " | |
415 | "--> <!ENTITY synopsis-pkg \"pkg\">" | |
416 | msgstr "" | |
417 | ||
418 | #. type: Plain text | |
419 | #: apt.ent:1 | |
420 | msgid "" | |
421 | "<!-- TRANSLATOR: used as in pkg=pkg_version_number e.g. apt=0.8.15 --> " | |
422 | "<!ENTITY synopsis-pkg-ver-number \"pkg_version_number\">" | |
423 | msgstr "" | |
424 | ||
425 | #. type: Plain text | |
426 | #: apt.ent:1 | |
427 | msgid "" | |
428 | "<!-- TRANSLATOR: used as in apt-cache pkgnames prefix e.g. apt-cache " | |
429 | "pkgnames apt --> <!ENTITY synopsis-prefix \"prefix\">" | |
430 | msgstr "" | |
431 | ||
432 | #. type: Plain text | |
433 | #: apt.ent:1 | |
434 | msgid "" | |
435 | "<!-- TRANSLATOR: used as in apt-cache search regex e.g. apt-cache search " | |
436 | "awesome --> <!ENTITY synopsis-regex \"regex\">" | |
437 | msgstr "" | |
438 | ||
439 | #. type: Plain text | |
440 | #: apt.ent:1 | |
441 | msgid "" | |
442 | "<!-- TRANSLATOR: used as in apt-cdrom -d=cdrom_mount_point e.g. apt-cdrom " | |
443 | "-d=/media/cdrom --> <!ENTITY synopsis-cdrom-mount \"cdrom_mount_point\">" | |
444 | msgstr "" | |
445 | ||
446 | #. type: Plain text | |
447 | #: apt.ent:1 | |
448 | msgid "" | |
449 | "<!-- TRANSLATOR: used as in apt-extracttemplates -t=temporary_directory " | |
450 | "e.g. apt-extracttemplates -t=/tmp --> <!ENTITY synopsis-tmp-directory " | |
451 | "\"temporary_directory\">" | |
452 | msgstr "" | |
453 | ||
454 | #. type: Plain text | |
455 | #: apt.ent:1 | |
456 | msgid "" | |
457 | "<!-- TRANSLATOR: used as in apt-extracttemplates filename --> <!ENTITY " | |
458 | "synopsis-filename \"filename\">" | |
459 | msgstr "" | |
460 | ||
461 | #. type: Plain text | |
462 | #: apt.ent:1 | |
463 | msgid "" | |
464 | "<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive " | |
465 | "packages path override-file pathprefix --> <!ENTITY synopsis-path \"path\">" | |
466 | msgstr "" | |
467 | ||
468 | #. type: Plain text | |
469 | #: apt.ent:1 | |
470 | msgid "" | |
471 | "<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive " | |
472 | "packages path override-file pathprefix --> <!ENTITY synopsis-override " | |
473 | "\"override-file\">" | |
474 | msgstr "" | |
475 | ||
476 | #. type: Plain text | |
477 | #: apt.ent:1 | |
478 | msgid "" | |
479 | "<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive " | |
480 | "packages path override-file pathprefix --> <!ENTITY synopsis-pathprefix " | |
481 | "\"pathprefix\">" | |
482 | msgstr "" | |
483 | ||
484 | #. type: Plain text | |
485 | #: apt.ent:1 | |
486 | msgid "" | |
487 | "<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive " | |
488 | "generate section --> <!ENTITY synopsis-section \"section\">" | |
489 | msgstr "" | |
490 | ||
491 | #. type: Plain text | |
492 | #: apt.ent:1 | |
493 | msgid "" | |
494 | "<!-- TRANSLATOR: used as in apt-key export keyid e.g. apt-key export " | |
495 | "473041FA --> <!ENTITY synopsis-keyid \"keyid\">" | |
496 | msgstr "" | |
497 | ||
498 | #. type: Content of: <refentry><refmeta><manvolnum> | |
499 | #: apt.8.xml:1 apt-get.8.xml:1 apt-cache.8.xml:1 apt-key.8.xml:1 | |
500 | #: apt-mark.8.xml:1 apt-secure.8.xml:1 apt-cdrom.8.xml:1 apt-config.8.xml:1 | |
501 | msgid "8" | |
502 | msgstr "" | |
503 | ||
504 | #. type: Content of: <refentry><refmeta><refmiscinfo> | |
505 | #: apt.8.xml:1 apt-get.8.xml:1 apt-cache.8.xml:1 apt-key.8.xml:1 | |
506 | #: apt-mark.8.xml:1 apt-secure.8.xml:1 apt-cdrom.8.xml:1 apt-config.8.xml:1 | |
507 | #: apt.conf.5.xml:1 apt_preferences.5.xml:1 sources.list.5.xml:1 | |
508 | #: apt-extracttemplates.1.xml:1 apt-sortpkgs.1.xml:1 apt-ftparchive.1.xml:1 | |
509 | msgid "APT" | |
510 | msgstr "" | |
511 | ||
512 | #. type: Content of: <refentry><refnamediv><refpurpose> | |
513 | #: apt.8.xml:1 | |
514 | msgid "command-line interface" | |
515 | msgstr "" | |
516 | ||
517 | #. type: Content of: <refentry><refsect1><title> | |
518 | #: apt.8.xml:1 apt-get.8.xml:1 apt-cache.8.xml:1 apt-key.8.xml:1 | |
519 | #: apt-mark.8.xml:1 apt-secure.8.xml:1 apt-cdrom.8.xml:1 apt-config.8.xml:1 | |
520 | #: apt.conf.5.xml:1 apt_preferences.5.xml:1 sources.list.5.xml:1 | |
521 | #: apt-extracttemplates.1.xml:1 apt-sortpkgs.1.xml:1 apt-ftparchive.1.xml:1 | |
522 | msgid "Description" | |
523 | msgstr "" | |
524 | ||
525 | #. type: Content of: <refentry><refsect1><para> | |
526 | #: apt.8.xml:1 | |
527 | msgid "" | |
528 | "<command>apt</command> provides a high-level commandline interface for the " | |
529 | "package management system. It is intended as an end user interface and " | |
530 | "enables some options better suited for interactive usage by default compared " | |
531 | "to more specialized APT tools like &apt-get; and &apt-cache;." | |
532 | msgstr "" | |
533 | ||
534 | #. type: Content of: <refentry><refsect1><para> | |
535 | #: apt.8.xml:1 | |
536 | msgid "" | |
537 | "Much like <command>apt</command> itself, its manpage is intended as an end " | |
538 | "user interface and as such only mentions the most used commands and options " | |
539 | "partly to not duplicate information in multiple places and partly to avoid " | |
540 | "overwhelming readers with a cornucopia of options and details." | |
541 | msgstr "" | |
542 | ||
543 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> | |
544 | #: apt.8.xml:1 apt.8.xml:1 apt.8.xml:1 apt.8.xml:1 apt.8.xml:1 | |
545 | msgid "(&apt-get;)" | |
546 | msgstr "" | |
547 | ||
548 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
549 | #: apt.8.xml:1 | |
550 | msgid "" | |
551 | "<option>update</option> is used to download package information from all " | |
552 | "configured sources. Other commands operate on this data to e.g. perform " | |
553 | "package upgrades or search in and display details about all packages " | |
554 | "available for installation." | |
555 | msgstr "" | |
556 | ||
557 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
558 | #: apt.8.xml:1 | |
559 | msgid "" | |
560 | "<option>upgrade</option> is used to install available upgrades of all " | |
561 | "packages currently installed on the system from the sources configured via " | |
562 | "&sources-list;. New packages will be installed if required to statisfy " | |
563 | "dependencies, but existing packages will never be removed. If an upgrade for " | |
564 | "a package requires the remove of an installed package the upgrade for this " | |
565 | "package isn't performed." | |
566 | msgstr "" | |
567 | ||
568 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
569 | #: apt.8.xml:1 | |
570 | msgid "" | |
571 | "<literal>full-upgrade</literal> performs the function of upgrade but will " | |
572 | "remove currently installed packages if this is needed to upgrade the system " | |
573 | "as a whole." | |
574 | msgstr "" | |
575 | ||
576 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> | |
577 | #: apt.8.xml:1 apt.8.xml:1 | |
578 | msgid "," | |
579 | msgstr "" | |
580 | ||
581 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
582 | #: apt.8.xml:1 | |
583 | msgid "" | |
584 | "Performs the requested action on one or more packages specified via ®ex;, " | |
585 | "&glob; or exact match. The requested action can be overridden for specific " | |
586 | "packages by append a plus (+) to the package name to install this package or " | |
587 | "a minus (-) to remove it." | |
588 | msgstr "" | |
589 | ||
590 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
591 | #: apt.8.xml:1 | |
592 | msgid "" | |
593 | "A specific version of a package can be selected for installation by " | |
594 | "following the package name with an equals (=) and the version of the package " | |
595 | "to select. Alternatively the version from a specific release can be selected " | |
596 | "by following the package name with a forward slash (/) and codename " | |
597 | "(&stable-codename;, &testing-codename;, sid …) or suite name (stable, " | |
598 | "testing, unstable). This will also select versions from this release for " | |
599 | "dependencies of this package if needed to satisfy the request." | |
600 | msgstr "" | |
601 | ||
602 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
603 | #: apt.8.xml:1 | |
604 | msgid "" | |
605 | "Removing a package removes all packaged data, but leaves usually small " | |
606 | "(modified) user configuration files behind, in case the remove was an " | |
607 | "accident. Just issuing an installation request for the accidentally removed " | |
608 | "package will restore its function as before in that case. On the other hand " | |
609 | "you can get rid of these leftovers by calling <command>purge</command> even " | |
610 | "on already removed packages. Note that this does not affect any data or " | |
611 | "configuration stored in your home directory." | |
612 | msgstr "" | |
613 | ||
614 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
615 | #: apt.8.xml:1 | |
616 | msgid "" | |
617 | "<literal>autoremove</literal> is used to remove packages that were " | |
618 | "automatically installed to satisfy dependencies for other packages and are " | |
619 | "now no longer needed as dependencies changed or the package(s) needing them " | |
620 | "were removed in the meantime." | |
621 | msgstr "" | |
622 | ||
623 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
624 | #: apt.8.xml:1 | |
625 | msgid "" | |
626 | "You should check that the list does not include applications you have grown " | |
627 | "to like even though they were once installed just as a dependency of another " | |
628 | "package. You can mark such a package as manually installed by using " | |
629 | "&apt-mark;. Packages which you have installed explicitly via " | |
630 | "<command>install</command> are also never proposed for automatic removal." | |
631 | msgstr "" | |
632 | ||
633 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> | |
634 | #: apt.8.xml:1 apt.8.xml:1 | |
635 | msgid "(&apt-cache;)" | |
636 | msgstr "" | |
637 | ||
638 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
639 | #: apt.8.xml:1 | |
640 | msgid "" | |
641 | "<option>search</option> can be used to search for the given ®ex; term(s) " | |
642 | "in the list of available packages and display matches. This can e.g. be " | |
643 | "useful if you are looking for packages having a specific feature. If you " | |
644 | "are looking for a package including a specific file try &apt-file;." | |
645 | msgstr "" | |
646 | ||
647 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
648 | #: apt.8.xml:1 | |
649 | msgid "" | |
650 | "Show information about the given package(s) including its dependencies, " | |
651 | "installation and download size, sources the package is available from, the " | |
652 | "description of the packages content and much more. It can e.g. be helpful to " | |
653 | "look at this information before allowing &apt; to remove a package or while " | |
654 | "searching for new packages to install." | |
655 | msgstr "" | |
656 | ||
657 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> | |
658 | #: apt.8.xml:1 apt.8.xml:1 | |
659 | msgid "(work-in-progress)" | |
660 | msgstr "" | |
661 | ||
662 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
663 | #: apt.8.xml:1 | |
664 | msgid "" | |
665 | "<option>list</option> is somewhat similar to <command>dpkg-query " | |
666 | "--list</command> in that it can display a list of packages satisfying " | |
667 | "certain criteria. It supports &glob; patterns for matching package names as " | |
668 | "well as options to list installed (<option>--installed</option>), " | |
669 | "upgradeable (<option>--upgradeable</option>) or all available " | |
670 | "(<option>--all-versions</option>) versions." | |
671 | msgstr "" | |
672 | ||
673 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
674 | #: apt.8.xml:1 | |
675 | msgid "" | |
676 | "<literal>edit-sources</literal> lets you edit your &sources-list; files in " | |
677 | "your preferred texteditor while also providing basic sanity checks." | |
678 | msgstr "" | |
679 | ||
680 | #. type: Content of: <refentry><refsect1><title> | |
681 | #: apt.8.xml:1 | |
682 | msgid "Script Usage and Differences from Other APT Tools" | |
683 | msgstr "" | |
684 | ||
685 | #. type: Content of: <refentry><refsect1><para> | |
686 | #: apt.8.xml:1 | |
687 | msgid "" | |
688 | "The &apt; commandline is designed as an end-user tool and it may change " | |
689 | "behavior between versions. While it tries not to break backward " | |
690 | "compatibility this is not guaranteed either if a change seems beneficial for " | |
691 | "interactive use." | |
692 | msgstr "" | |
693 | ||
694 | #. type: Content of: <refentry><refsect1><para> | |
695 | #: apt.8.xml:1 | |
696 | msgid "" | |
697 | "All features of &apt; are available in dedicated APT tools like &apt-get; " | |
698 | "and &apt-cache; as well. &apt; just changes the default value of some " | |
699 | "options (see &apt-conf; and specifically the Binary scope). So you should " | |
700 | "prefer using these commands (potentially with some additional options " | |
701 | "enabled) in your scripts as they keep backward compatibility as much as " | |
702 | "possible." | |
703 | msgstr "" | |
704 | ||
705 | #. type: Content of: <refentry><refsect1><title> | |
706 | #: apt.8.xml:1 apt-get.8.xml:1 apt-cache.8.xml:1 apt-key.8.xml:1 | |
707 | #: apt-mark.8.xml:1 apt-secure.8.xml:1 apt-cdrom.8.xml:1 apt-config.8.xml:1 | |
708 | #: apt.conf.5.xml:1 apt_preferences.5.xml:1 sources.list.5.xml:1 | |
709 | #: apt-extracttemplates.1.xml:1 apt-sortpkgs.1.xml:1 apt-ftparchive.1.xml:1 | |
710 | msgid "See Also" | |
711 | msgstr "" | |
712 | ||
713 | #. type: Content of: <refentry><refsect1><para> | |
714 | #: apt.8.xml:1 | |
715 | msgid "" | |
716 | "&apt-get;, &apt-cache;, &sources-list;, &apt-conf;, &apt-config;, The APT " | |
717 | "User's guide in &guidesdir;, &apt-preferences;, the APT Howto." | |
718 | msgstr "" | |
719 | ||
720 | #. type: Content of: <refentry><refsect1><title> | |
721 | #: apt.8.xml:1 apt-get.8.xml:1 apt-cache.8.xml:1 apt-mark.8.xml:1 | |
722 | #: apt-cdrom.8.xml:1 apt-config.8.xml:1 apt-extracttemplates.1.xml:1 | |
723 | #: apt-sortpkgs.1.xml:1 apt-ftparchive.1.xml:1 | |
724 | msgid "Diagnostics" | |
725 | msgstr "" | |
726 | ||
727 | #. type: Content of: <refentry><refsect1><para> | |
728 | #: apt.8.xml:1 | |
729 | msgid "" | |
730 | "<command>apt</command> returns zero on normal operation, decimal 100 on " | |
731 | "error." | |
732 | msgstr "" | |
733 | ||
734 | #. type: Content of: <refentry><refnamediv><refpurpose> | |
735 | #: apt-get.8.xml:1 | |
736 | msgid "APT package handling utility -- command-line interface" | |
737 | msgstr "" | |
738 | ||
739 | #. type: Content of: <refentry><refsect1><para> | |
740 | #: apt-get.8.xml:1 | |
741 | msgid "" | |
742 | "<command>apt-get</command> is the command-line tool for handling packages, " | |
743 | "and may be considered the user's \"back-end\" to other tools using the APT " | |
744 | "library. Several \"front-end\" interfaces exist, such as &aptitude;, " | |
745 | "&synaptic; and &wajig;." | |
746 | msgstr "" | |
747 | ||
748 | #. type: Content of: <refentry><refsect1><para> | |
749 | #: apt-get.8.xml:1 apt-cache.8.xml:1 apt-cdrom.8.xml:1 apt-config.8.xml:1 | |
750 | #: apt-ftparchive.1.xml:1 | |
751 | msgid "" | |
752 | "Unless the <option>-h</option>, or <option>--help</option> option is given, " | |
753 | "one of the commands below must be present." | |
754 | msgstr "" | |
755 | ||
756 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
757 | #: apt-get.8.xml:1 | |
758 | msgid "" | |
759 | "<literal>update</literal> is used to resynchronize the package index files " | |
760 | "from their sources. The indexes of available packages are fetched from the " | |
761 | "location(s) specified in <filename>/etc/apt/sources.list</filename>. For " | |
762 | "example, when using a Debian archive, this command retrieves and scans the " | |
763 | "<filename>Packages.gz</filename> files, so that information about new and " | |
764 | "updated packages is available. An <literal>update</literal> should always be " | |
765 | "performed before an <literal>upgrade</literal> or " | |
766 | "<literal>dist-upgrade</literal>. Please be aware that the overall progress " | |
767 | "meter will be incorrect as the size of the package files cannot be known in " | |
768 | "advance." | |
769 | msgstr "" | |
770 | ||
771 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
772 | #: apt-get.8.xml:1 | |
773 | msgid "" | |
774 | "<literal>upgrade</literal> is used to install the newest versions of all " | |
775 | "packages currently installed on the system from the sources enumerated in " | |
776 | "<filename>/etc/apt/sources.list</filename>. Packages currently installed " | |
777 | "with new versions available are retrieved and upgraded; under no " | |
778 | "circumstances are currently installed packages removed, or packages not " | |
779 | "already installed retrieved and installed. New versions of currently " | |
780 | "installed packages that cannot be upgraded without changing the install " | |
781 | "status of another package will be left at their current version. An " | |
782 | "<literal>update</literal> must be performed first so that " | |
783 | "<command>apt-get</command> knows that new versions of packages are " | |
784 | "available." | |
785 | msgstr "" | |
786 | ||
787 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
788 | #: apt-get.8.xml:1 | |
789 | msgid "" | |
790 | "<literal>dist-upgrade</literal> in addition to performing the function of " | |
791 | "<literal>upgrade</literal>, also intelligently handles changing dependencies " | |
792 | "with new versions of packages; <command>apt-get</command> has a \"smart\" " | |
793 | "conflict resolution system, and it will attempt to upgrade the most " | |
794 | "important packages at the expense of less important ones if necessary. The " | |
795 | "<literal>dist-upgrade</literal> command may therefore remove some packages. " | |
796 | "The <filename>/etc/apt/sources.list</filename> file contains a list of " | |
797 | "locations from which to retrieve desired package files. See also " | |
798 | "&apt-preferences; for a mechanism for overriding the general settings for " | |
799 | "individual packages." | |
800 | msgstr "" | |
801 | ||
802 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
803 | #: apt-get.8.xml:1 | |
804 | msgid "" | |
805 | "<literal>dselect-upgrade</literal> is used in conjunction with the " | |
806 | "traditional Debian packaging front-end, " | |
807 | "&dselect;. <literal>dselect-upgrade</literal> follows the changes made by " | |
808 | "&dselect; to the <literal>Status</literal> field of available packages, and " | |
809 | "performs the actions necessary to realize that state (for instance, the " | |
810 | "removal of old and the installation of new packages)." | |
811 | msgstr "" | |
812 | ||
813 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
814 | #: apt-get.8.xml:1 | |
815 | msgid "" | |
816 | "<literal>install</literal> is followed by one or more packages desired for " | |
817 | "installation or upgrading. Each package is a package name, not a fully " | |
818 | "qualified filename (for instance, in a Debian system, " | |
819 | "<package>apt-utils</package> would be the argument provided, not " | |
820 | "<filename>apt-utils_&apt-product-version;_amd64.deb</filename>). All " | |
821 | "packages required by the package(s) specified for installation will also be " | |
822 | "retrieved and installed. The <filename>/etc/apt/sources.list</filename> " | |
823 | "file is used to locate the desired packages. If a hyphen is appended to the " | |
824 | "package name (with no intervening space), the identified package will be " | |
825 | "removed if it is installed. Similarly a plus sign can be used to designate " | |
826 | "a package to install. These latter features may be used to override " | |
827 | "decisions made by apt-get's conflict resolution system." | |
828 | msgstr "" | |
829 | ||
830 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
831 | #: apt-get.8.xml:1 | |
832 | msgid "" | |
833 | "A specific version of a package can be selected for installation by " | |
834 | "following the package name with an equals and the version of the package to " | |
835 | "select. This will cause that version to be located and selected for " | |
836 | "install. Alternatively a specific distribution can be selected by following " | |
837 | "the package name with a slash and the version of the distribution or the " | |
838 | "Archive name (stable, testing, unstable)." | |
839 | msgstr "" | |
840 | ||
841 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
842 | #: apt-get.8.xml:1 | |
843 | msgid "" | |
844 | "Both of the version selection mechanisms can downgrade packages and must be " | |
845 | "used with care." | |
846 | msgstr "" | |
847 | ||
848 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
849 | #: apt-get.8.xml:1 | |
850 | msgid "" | |
851 | "This is also the target to use if you want to upgrade one or more " | |
852 | "already-installed packages without upgrading every package you have on your " | |
853 | "system. Unlike the \"upgrade\" target, which installs the newest version of " | |
854 | "all currently installed packages, \"install\" will install the newest " | |
855 | "version of only the package(s) specified. Simply provide the name of the " | |
856 | "package(s) you wish to upgrade, and if a newer version is available, it (and " | |
857 | "its dependencies, as described above) will be downloaded and installed." | |
858 | msgstr "" | |
859 | ||
860 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
861 | #: apt-get.8.xml:1 | |
862 | msgid "" | |
863 | "Finally, the &apt-preferences; mechanism allows you to create an alternative " | |
864 | "installation policy for individual packages." | |
865 | msgstr "" | |
866 | ||
867 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
868 | #: apt-get.8.xml:1 | |
869 | msgid "" | |
870 | "If no package matches the given expression and the expression contains one " | |
871 | "of '.', '?' or '*' then it is assumed to be a POSIX regular expression, and " | |
872 | "it is applied to all package names in the database. Any matches are then " | |
873 | "installed (or removed). Note that matching is done by substring so 'lo.*' " | |
874 | "matches 'how-lo' and 'lowest'. If this is undesired, anchor the regular " | |
875 | "expression with a '^' or '$' character, or create a more specific regular " | |
876 | "expression." | |
877 | msgstr "" | |
878 | ||
879 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
880 | #: apt-get.8.xml:1 | |
881 | msgid "" | |
882 | "<literal>remove</literal> is identical to <literal>install</literal> except " | |
883 | "that packages are removed instead of installed. Note that removing a package " | |
884 | "leaves its configuration files on the system. If a plus sign is appended to " | |
885 | "the package name (with no intervening space), the identified package will be " | |
886 | "installed instead of removed." | |
887 | msgstr "" | |
888 | ||
889 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
890 | #: apt-get.8.xml:1 | |
891 | msgid "" | |
892 | "<literal>purge</literal> is identical to <literal>remove</literal> except " | |
893 | "that packages are removed and purged (any configuration files are deleted " | |
894 | "too)." | |
895 | msgstr "" | |
896 | ||
897 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
898 | #: apt-get.8.xml:1 | |
899 | msgid "" | |
900 | "<literal>source</literal> causes <command>apt-get</command> to fetch source " | |
901 | "packages. APT will examine the available packages to decide which source " | |
902 | "package to fetch. It will then find and download into the current directory " | |
903 | "the newest available version of that source package while respecting the " | |
904 | "default release, set with the option " | |
905 | "<literal>APT::Default-Release</literal>, the <option>-t</option> option or " | |
906 | "per package with the <literal>pkg/release</literal> syntax, if possible." | |
907 | msgstr "" | |
908 | ||
909 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
910 | #: apt-get.8.xml:1 | |
911 | msgid "" | |
912 | "Source packages are tracked separately from binary packages via " | |
913 | "<literal>deb-src</literal> lines in the &sources-list; file. This means that " | |
914 | "you will need to add such a line for each repository you want to get sources " | |
915 | "from; otherwise you will probably get either the wrong (too old/too new) " | |
916 | "source versions or none at all." | |
917 | msgstr "" | |
918 | ||
919 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
920 | #: apt-get.8.xml:1 | |
921 | msgid "" | |
922 | "If the <option>--compile</option> option is specified then the package will " | |
923 | "be compiled to a binary .deb using <command>dpkg-buildpackage</command> for " | |
924 | "the architecture as defined by the <command>--host-architecture</command> " | |
925 | "option. If <option>--download-only</option> is specified then the source " | |
926 | "package will not be unpacked." | |
927 | msgstr "" | |
928 | ||
929 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
930 | #: apt-get.8.xml:1 | |
931 | msgid "" | |
932 | "A specific source version can be retrieved by postfixing the source name " | |
933 | "with an equals and then the version to fetch, similar to the mechanism used " | |
934 | "for the package files. This enables exact matching of the source package " | |
935 | "name and version, implicitly enabling the " | |
936 | "<literal>APT::Get::Only-Source</literal> option." | |
937 | msgstr "" | |
938 | ||
939 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
940 | #: apt-get.8.xml:1 | |
941 | msgid "" | |
942 | "Note that source packages are not installed and tracked in the " | |
943 | "<command>dpkg</command> database like binary packages; they are simply " | |
944 | "downloaded to the current directory, like source tarballs." | |
945 | msgstr "" | |
946 | ||
947 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
948 | #: apt-get.8.xml:1 | |
949 | msgid "" | |
950 | "<literal>build-dep</literal> causes apt-get to install/remove packages in an " | |
951 | "attempt to satisfy the build dependencies for a source package. By default " | |
952 | "the dependencies are satisfied to build the package natively. If desired a " | |
953 | "host-architecture can be specified with the " | |
954 | "<option>--host-architecture</option> option instead." | |
955 | msgstr "" | |
956 | ||
957 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
958 | #: apt-get.8.xml:1 | |
959 | msgid "" | |
960 | "<literal>check</literal> is a diagnostic tool; it updates the package cache " | |
961 | "and checks for broken dependencies." | |
962 | msgstr "" | |
963 | ||
964 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
965 | #: apt-get.8.xml:1 | |
966 | msgid "" | |
967 | "<literal>download</literal> will download the given binary package into the " | |
968 | "current directory." | |
969 | msgstr "" | |
970 | ||
971 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
972 | #: apt-get.8.xml:1 | |
973 | msgid "" | |
974 | "<literal>clean</literal> clears out the local repository of retrieved " | |
975 | "package files. It removes everything but the lock file from " | |
976 | "<filename>&cachedir;/archives/</filename> and " | |
977 | "<filename>&cachedir;/archives/partial/</filename>." | |
978 | msgstr "" | |
979 | ||
980 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> | |
981 | #: apt-get.8.xml:1 apt-get.8.xml:1 | |
982 | msgid "(and the" | |
983 | msgstr "" | |
984 | ||
985 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> | |
986 | #: apt-get.8.xml:1 apt-get.8.xml:1 | |
987 | msgid "alias since 1.1)" | |
988 | msgstr "" | |
989 | ||
990 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
991 | #: apt-get.8.xml:1 | |
992 | msgid "" | |
993 | "Like <literal>clean</literal>, <literal>autoclean</literal> clears out the " | |
994 | "local repository of retrieved package files. The difference is that it only " | |
995 | "removes package files that can no longer be downloaded, and are largely " | |
996 | "useless. This allows a cache to be maintained over a long period without it " | |
997 | "growing out of control. The configuration option " | |
998 | "<literal>APT::Clean-Installed</literal> will prevent installed packages from " | |
999 | "being erased if it is set to off." | |
1000 | msgstr "" | |
1001 | ||
1002 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1003 | #: apt-get.8.xml:1 | |
1004 | msgid "" | |
1005 | "<literal>autoremove</literal> is used to remove packages that were " | |
1006 | "automatically installed to satisfy dependencies for other packages and are " | |
1007 | "now no longer needed." | |
1008 | msgstr "" | |
1009 | ||
1010 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1011 | #: apt-get.8.xml:1 | |
1012 | msgid "" | |
1013 | "<literal>changelog</literal> tries to download the changelog of a package " | |
1014 | "and displays it through <command>sensible-pager</command>. By default it " | |
1015 | "displays the changelog for the version that is installed. However, you can " | |
1016 | "specify the same options as for the <option>install</option> command." | |
1017 | msgstr "" | |
1018 | ||
1019 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1020 | #: apt-get.8.xml:1 | |
1021 | msgid "" | |
1022 | "Displays by default a deb822 formatted listing of information about all data " | |
1023 | "files (aka index targets) <command>apt-get update</command> would " | |
1024 | "download. Supports a <option>--format</option> option to modify the output " | |
1025 | "format as well as accepts lines of the default output to filter the records " | |
1026 | "by. The command is mainly used as an interface for external tools working " | |
1027 | "with APT to get information as well as filenames for downloaded files so " | |
1028 | "they can use them as well instead of downloading them again on their " | |
1029 | "own. Detailed documentation is omitted here and can instead be found in the " | |
1030 | "source tree in " | |
1031 | "<literal><filename>doc/acquire-additional-files.txt</filename></literal>." | |
1032 | msgstr "" | |
1033 | ||
1034 | #. type: Content of: <refentry><refsect1><title> | |
1035 | #: apt-get.8.xml:1 apt-cache.8.xml:1 apt-config.8.xml:1 | |
1036 | #: apt-extracttemplates.1.xml:1 apt-sortpkgs.1.xml:1 apt-ftparchive.1.xml:1 | |
1037 | msgid "options" | |
1038 | msgstr "" | |
1039 | ||
1040 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1041 | #: apt-get.8.xml:1 | |
1042 | msgid "" | |
1043 | "Do not consider recommended packages as a dependency for installing. " | |
1044 | "Configuration Item: <literal>APT::Install-Recommends</literal>." | |
1045 | msgstr "" | |
1046 | ||
1047 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1048 | #: apt-get.8.xml:1 | |
1049 | msgid "" | |
1050 | "Consider suggested packages as a dependency for installing. Configuration " | |
1051 | "Item: <literal>APT::Install-Suggests</literal>." | |
1052 | msgstr "" | |
1053 | ||
1054 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1055 | #: apt-get.8.xml:1 | |
1056 | msgid "" | |
1057 | "Download only; package files are only retrieved, not unpacked or installed. " | |
1058 | "Configuration Item: <literal>APT::Get::Download-Only</literal>." | |
1059 | msgstr "" | |
1060 | ||
1061 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1062 | #: apt-get.8.xml:1 | |
1063 | msgid "" | |
1064 | "Fix; attempt to correct a system with broken dependencies in place. This " | |
1065 | "option, when used with install/remove, can omit any packages to permit APT " | |
1066 | "to deduce a likely solution. If packages are specified, these have to " | |
1067 | "completely correct the problem. The option is sometimes necessary when " | |
1068 | "running APT for the first time; APT itself does not allow broken package " | |
1069 | "dependencies to exist on a system. It is possible that a system's dependency " | |
1070 | "structure can be so corrupt as to require manual intervention (which usually " | |
1071 | "means using <command>dpkg --remove</command> to eliminate some of the " | |
1072 | "offending packages). Use of this option together with <option>-m</option> " | |
1073 | "may produce an error in some situations. Configuration Item: " | |
1074 | "<literal>APT::Get::Fix-Broken</literal>." | |
1075 | msgstr "" | |
1076 | ||
1077 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1078 | #: apt-get.8.xml:1 | |
1079 | msgid "" | |
1080 | "Ignore missing packages; if packages cannot be retrieved or fail the " | |
1081 | "integrity check after retrieval (corrupted package files), hold back those " | |
1082 | "packages and handle the result. Use of this option together with " | |
1083 | "<option>-f</option> may produce an error in some situations. If a package is " | |
1084 | "selected for installation (particularly if it is mentioned on the command " | |
1085 | "line) and it could not be downloaded then it will be silently held back. " | |
1086 | "Configuration Item: <literal>APT::Get::Fix-Missing</literal>." | |
1087 | msgstr "" | |
1088 | ||
1089 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1090 | #: apt-get.8.xml:1 | |
1091 | msgid "" | |
1092 | "Disables downloading of packages. This is best used with " | |
1093 | "<option>--ignore-missing</option> to force APT to use only the .debs it has " | |
1094 | "already downloaded. Configuration Item: " | |
1095 | "<literal>APT::Get::Download</literal>." | |
1096 | msgstr "" | |
1097 | ||
1098 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1099 | #: apt-get.8.xml:1 | |
1100 | msgid "" | |
1101 | "Quiet; produces output suitable for logging, omitting progress indicators. " | |
1102 | "More q's will produce more quiet up to a maximum of 2. You can also use " | |
1103 | "<option>-q=#</option> to set the quiet level, overriding the configuration " | |
1104 | "file. Note that quiet level 2 implies <option>-y</option>; you should never " | |
1105 | "use -qq without a no-action modifier such as -d, --print-uris or -s as APT " | |
1106 | "may decide to do something you did not expect. Configuration Item: " | |
1107 | "<literal>quiet</literal>." | |
1108 | msgstr "" | |
1109 | ||
1110 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1111 | #: apt-get.8.xml:1 | |
1112 | msgid "" | |
1113 | "No action; perform a simulation of events that would occur based on the " | |
1114 | "current system state but do not actually change the system. Locking will be " | |
1115 | "disabled (<option>Debug::NoLocking</option>) so the system state could " | |
1116 | "change while <command>apt-get</command> is running. Simulations can also be " | |
1117 | "executed by non-root users which might not have read access to all apt " | |
1118 | "configuration distorting the simulation. A notice expressing this warning " | |
1119 | "is also shown by default for non-root users " | |
1120 | "(<option>APT::Get::Show-User-Simulation-Note</option>). Configuration Item: " | |
1121 | "<literal>APT::Get::Simulate</literal>." | |
1122 | msgstr "" | |
1123 | ||
1124 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1125 | #: apt-get.8.xml:1 | |
1126 | msgid "" | |
1127 | "Simulated runs print out a series of lines, each representing a " | |
1128 | "<command>dpkg</command> operation: configure (<literal>Conf</literal>), " | |
1129 | "remove (<literal>Remv</literal>) or unpack " | |
1130 | "(<literal>Inst</literal>). Square brackets indicate broken packages, and " | |
1131 | "empty square brackets indicate breaks that are of no consequence (rare)." | |
1132 | msgstr "" | |
1133 | ||
1134 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1135 | #: apt-get.8.xml:1 | |
1136 | msgid "" | |
1137 | "Automatic yes to prompts; assume \"yes\" as answer to all prompts and run " | |
1138 | "non-interactively. If an undesirable situation, such as changing a held " | |
1139 | "package, trying to install a unauthenticated package or removing an " | |
1140 | "essential package occurs then <literal>apt-get</literal> will abort. " | |
1141 | "Configuration Item: <literal>APT::Get::Assume-Yes</literal>." | |
1142 | msgstr "" | |
1143 | ||
1144 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1145 | #: apt-get.8.xml:1 | |
1146 | msgid "" | |
1147 | "Automatic \"no\" to all prompts. Configuration Item: " | |
1148 | "<literal>APT::Get::Assume-No</literal>." | |
1149 | msgstr "" | |
1150 | ||
1151 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1152 | #: apt-get.8.xml:1 | |
1153 | msgid "" | |
1154 | "Show upgraded packages; print out a list of all packages that are to be " | |
1155 | "upgraded. Configuration Item: <literal>APT::Get::Show-Upgraded</literal>." | |
1156 | msgstr "" | |
1157 | ||
1158 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1159 | #: apt-get.8.xml:1 | |
1160 | msgid "" | |
1161 | "Show full versions for upgraded and installed packages. Configuration Item: " | |
1162 | "<literal>APT::Get::Show-Versions</literal>." | |
1163 | msgstr "" | |
1164 | ||
1165 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1166 | #: apt-get.8.xml:1 | |
1167 | msgid "" | |
1168 | "This option controls the architecture packages are built for by " | |
1169 | "<command>apt-get source --compile</command> and how cross-builddependencies " | |
1170 | "are satisfied. By default is it not set which means that the host " | |
1171 | "architecture is the same as the build architecture (which is defined by " | |
1172 | "<literal>APT::Architecture</literal>). Configuration Item: " | |
1173 | "<literal>APT::Get::Host-Architecture</literal>." | |
1174 | msgstr "" | |
1175 | ||
1176 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1177 | #: apt-get.8.xml:1 | |
1178 | msgid "" | |
1179 | "This option controls the activated build profiles for which a source package " | |
1180 | "is built by <command>apt-get source --compile</command> and how build " | |
1181 | "dependencies are satisfied. By default no build profile is active. More " | |
1182 | "than one build profile can be activated at a time by concatenating them with " | |
1183 | "a comma. Configuration Item: <literal>APT::Build-Profiles</literal>." | |
1184 | msgstr "" | |
1185 | ||
1186 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1187 | #: apt-get.8.xml:1 | |
1188 | msgid "" | |
1189 | "Compile source packages after downloading them. Configuration Item: " | |
1190 | "<literal>APT::Get::Compile</literal>." | |
1191 | msgstr "" | |
1192 | ||
1193 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1194 | #: apt-get.8.xml:1 | |
1195 | msgid "" | |
1196 | "Ignore package holds; this causes <command>apt-get</command> to ignore a " | |
1197 | "hold placed on a package. This may be useful in conjunction with " | |
1198 | "<literal>dist-upgrade</literal> to override a large number of undesired " | |
1199 | "holds. Configuration Item: <literal>APT::Ignore-Hold</literal>." | |
1200 | msgstr "" | |
1201 | ||
1202 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1203 | #: apt-get.8.xml:1 | |
1204 | msgid "" | |
1205 | "Allow installing new packages when used in conjunction with " | |
1206 | "<literal>upgrade</literal>. This is useful if the update of a installed " | |
1207 | "package requires new dependencies to be installed. Instead of holding the " | |
1208 | "package back <literal>upgrade</literal> will upgrade the package and install " | |
1209 | "the new dependencies. Note that <literal>upgrade</literal> with this option " | |
1210 | "will never remove packages, only allow adding new ones. Configuration Item: " | |
1211 | "<literal>APT::Get::Upgrade-Allow-New</literal>." | |
1212 | msgstr "" | |
1213 | ||
1214 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1215 | #: apt-get.8.xml:1 | |
1216 | msgid "" | |
1217 | "Do not upgrade packages; when used in conjunction with " | |
1218 | "<literal>install</literal>, <literal>no-upgrade</literal> will prevent " | |
1219 | "packages on the command line from being upgraded if they are already " | |
1220 | "installed. Configuration Item: <literal>APT::Get::Upgrade</literal>." | |
1221 | msgstr "" | |
1222 | ||
1223 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1224 | #: apt-get.8.xml:1 | |
1225 | msgid "" | |
1226 | "Do not install new packages; when used in conjunction with " | |
1227 | "<literal>install</literal>, <literal>only-upgrade</literal> will install " | |
1228 | "upgrades for already installed packages only and ignore requests to install " | |
1229 | "new packages. Configuration Item: " | |
1230 | "<literal>APT::Get::Only-Upgrade</literal>." | |
1231 | msgstr "" | |
1232 | ||
1233 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1234 | #: apt-get.8.xml:1 | |
1235 | msgid "" | |
1236 | "This is a dangerous option that will cause apt to continue without prompting " | |
1237 | "if it is doing downgrades. It should not be used except in very special " | |
1238 | "situations. Using it can potentially destroy your system! Configuration " | |
1239 | "Item: <literal>APT::Get::allow-downgrades</literal>. Introduced in APT 1.1." | |
1240 | msgstr "" | |
1241 | ||
1242 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1243 | #: apt-get.8.xml:1 | |
1244 | msgid "" | |
1245 | "Force yes; this is a dangerous option that will cause apt to continue " | |
1246 | "without prompting if it is removing essentials. It should not be used except " | |
1247 | "in very special situations. Using it can potentially destroy your system! " | |
1248 | "Configuration Item: " | |
1249 | "<literal>APT::Get::allow-remove-essential</literal>. Introduced in APT 1.1." | |
1250 | msgstr "" | |
1251 | ||
1252 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1253 | #: apt-get.8.xml:1 | |
1254 | msgid "" | |
1255 | "Force yes; this is a dangerous option that will cause apt to continue " | |
1256 | "without prompting if it is changing held packages. It should not be used " | |
1257 | "except in very special situations. Using it can potentially destroy your " | |
1258 | "system! Configuration Item: " | |
1259 | "<literal>APT::Get::allow-change-held-packages</literal>. Introduced in APT " | |
1260 | "1.1." | |
1261 | msgstr "" | |
1262 | ||
1263 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1264 | #: apt-get.8.xml:1 | |
1265 | msgid "" | |
1266 | "Force yes; this is a dangerous option that will cause apt to continue " | |
1267 | "without prompting if it is doing something potentially harmful. It should " | |
1268 | "not be used except in very special situations. Using " | |
1269 | "<literal>force-yes</literal> can potentially destroy your system! " | |
1270 | "Configuration Item: <literal>APT::Get::force-yes</literal>. This is " | |
1271 | "deprecated and replaced by <option>--allow-downgrades</option>, " | |
1272 | "<option>--allow-remove-essential</option>, " | |
1273 | "<option>--allow-change-held-packages</option> in 1.1." | |
1274 | msgstr "" | |
1275 | ||
1276 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1277 | #: apt-get.8.xml:1 | |
1278 | msgid "" | |
1279 | "Instead of fetching the files to install their URIs are printed. Each URI " | |
1280 | "will have the path, the destination file name, the size and the expected MD5 " | |
1281 | "hash. Note that the file name to write to will not always match the file " | |
1282 | "name on the remote site! This also works with the <literal>source</literal> " | |
1283 | "and <literal>update</literal> commands. When used with the " | |
1284 | "<literal>update</literal> command the MD5 and size are not included, and it " | |
1285 | "is up to the user to decompress any compressed files. Configuration Item: " | |
1286 | "<literal>APT::Get::Print-URIs</literal>." | |
1287 | msgstr "" | |
1288 | ||
1289 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1290 | #: apt-get.8.xml:1 | |
1291 | msgid "" | |
1292 | "Use purge instead of remove for anything that would be removed. An asterisk " | |
1293 | "(\"*\") will be displayed next to packages which are scheduled to be " | |
1294 | "purged. <option>remove --purge</option> is equivalent to the " | |
1295 | "<option>purge</option> command. Configuration Item: " | |
1296 | "<literal>APT::Get::Purge</literal>." | |
1297 | msgstr "" | |
1298 | ||
1299 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1300 | #: apt-get.8.xml:1 | |
1301 | msgid "" | |
1302 | "Re-install packages that are already installed and at the newest version. " | |
1303 | "Configuration Item: <literal>APT::Get::ReInstall</literal>." | |
1304 | msgstr "" | |
1305 | ||
1306 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1307 | #: apt-get.8.xml:1 | |
1308 | msgid "" | |
1309 | "This option is on by default; use <literal>--no-list-cleanup</literal> to " | |
1310 | "turn it off. When it is on, <command>apt-get</command> will automatically " | |
1311 | "manage the contents of <filename>&statedir;/lists</filename> to ensure that " | |
1312 | "obsolete files are erased. The only reason to turn it off is if you " | |
1313 | "frequently change your sources list. Configuration Item: " | |
1314 | "<literal>APT::Get::List-Cleanup</literal>." | |
1315 | msgstr "" | |
1316 | ||
1317 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1318 | #: apt-get.8.xml:1 | |
1319 | msgid "" | |
1320 | "This option controls the default input to the policy engine; it creates a " | |
1321 | "default pin at priority 990 using the specified release string. This " | |
1322 | "overrides the general settings in " | |
1323 | "<filename>/etc/apt/preferences</filename>. Specifically pinned packages are " | |
1324 | "not affected by the value of this option. In short, this option lets you " | |
1325 | "have simple control over which distribution packages will be retrieved " | |
1326 | "from. Some common examples might be <option>-t '2.1*'</option>, <option>-t " | |
1327 | "unstable</option> or <option>-t sid</option>. Configuration Item: " | |
1328 | "<literal>APT::Default-Release</literal>; see also the &apt-preferences; " | |
1329 | "manual page." | |
1330 | msgstr "" | |
1331 | ||
1332 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1333 | #: apt-get.8.xml:1 | |
1334 | msgid "" | |
1335 | "Only perform operations that are 'trivial'. Logically this can be considered " | |
1336 | "related to <option>--assume-yes</option>; where " | |
1337 | "<option>--assume-yes</option> will answer yes to any prompt, " | |
1338 | "<option>--trivial-only</option> will answer no. Configuration Item: " | |
1339 | "<literal>APT::Get::Trivial-Only</literal>." | |
1340 | msgstr "" | |
1341 | ||
1342 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1343 | #: apt-get.8.xml:1 | |
1344 | msgid "" | |
1345 | "If any packages are to be removed apt-get immediately aborts without " | |
1346 | "prompting. Configuration Item: <literal>APT::Get::Remove</literal>." | |
1347 | msgstr "" | |
1348 | ||
1349 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1350 | #: apt-get.8.xml:1 | |
1351 | msgid "" | |
1352 | "If the command is either <literal>install</literal> or " | |
1353 | "<literal>remove</literal>, then this option acts like running the " | |
1354 | "<literal>autoremove</literal> command, removing unused dependency " | |
1355 | "packages. Configuration Item: <literal>APT::Get::AutomaticRemove</literal>." | |
1356 | msgstr "" | |
1357 | ||
1358 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1359 | #: apt-get.8.xml:1 | |
1360 | msgid "" | |
1361 | "Only has meaning for the <literal>source</literal> and " | |
1362 | "<literal>build-dep</literal> commands. Indicates that the given source " | |
1363 | "names are not to be mapped through the binary table. This means that if " | |
1364 | "this option is specified, these commands will only accept source package " | |
1365 | "names as arguments, rather than accepting binary package names and looking " | |
1366 | "up the corresponding source package. Configuration Item: " | |
1367 | "<literal>APT::Get::Only-Source</literal>." | |
1368 | msgstr "" | |
1369 | ||
1370 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1371 | #: apt-get.8.xml:1 | |
1372 | msgid "" | |
1373 | "Download only the diff, dsc, or tar file of a source archive. Configuration " | |
1374 | "Item: <literal>APT::Get::Diff-Only</literal>, " | |
1375 | "<literal>APT::Get::Dsc-Only</literal>, and " | |
1376 | "<literal>APT::Get::Tar-Only</literal>." | |
1377 | msgstr "" | |
1378 | ||
1379 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1380 | #: apt-get.8.xml:1 | |
1381 | msgid "" | |
1382 | "Only process architecture-dependent build-dependencies. Configuration Item: " | |
1383 | "<literal>APT::Get::Arch-Only</literal>." | |
1384 | msgstr "" | |
1385 | ||
1386 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1387 | #: apt-get.8.xml:1 | |
1388 | msgid "" | |
1389 | "Ignore if packages can't be authenticated and don't prompt about it. This " | |
1390 | "can be useful while working with local repositories, but is a huge security " | |
1391 | "risk if data authenticity isn't ensured in another way by the user itself. " | |
1392 | "The usage of the <option>Trusted</option> option for &sources-list; entries " | |
1393 | "should usually be preferred over this global override. Configuration Item: " | |
1394 | "<literal>APT::Get::AllowUnauthenticated</literal>." | |
1395 | msgstr "" | |
1396 | ||
1397 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1398 | #: apt-get.8.xml:1 | |
1399 | msgid "" | |
1400 | "Forbid the update command to acquire unverifiable data from configured " | |
1401 | "sources. Apt will fail at the update command for repositories without valid " | |
1402 | "cryptographically signatures. Configuration Item: " | |
1403 | "<literal>Acquire::AllowInsecureRepositories</literal>." | |
1404 | msgstr "" | |
1405 | ||
1406 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1407 | #: apt-get.8.xml:1 | |
1408 | msgid "" | |
1409 | "Show user friendly progress information in the terminal window when packages " | |
1410 | "are installed, upgraded or removed. For a machine parsable version of this " | |
1411 | "data see README.progress-reporting in the apt doc directory. Configuration " | |
1412 | "Item: <literal>Dpkg::Progress</literal> and " | |
1413 | "<literal>Dpkg::Progress-Fancy</literal>." | |
1414 | msgstr "" | |
1415 | ||
1416 | #. type: Content of: <refentry><refsect1><title> | |
1417 | #: apt-get.8.xml:1 apt-cache.8.xml:1 apt-key.8.xml:1 apt-mark.8.xml:1 | |
1418 | #: apt.conf.5.xml:1 apt_preferences.5.xml:1 | |
1419 | msgid "Files" | |
1420 | msgstr "" | |
1421 | ||
1422 | #. type: Content of: <refentry><refsect1><para> | |
1423 | #: apt-get.8.xml:1 | |
1424 | msgid "" | |
1425 | "&apt-cache;, &apt-cdrom;, &dpkg;, &sources-list;, &apt-conf;, &apt-config;, " | |
1426 | "&apt-secure;, The APT User's guide in &guidesdir;, &apt-preferences;, the " | |
1427 | "APT Howto." | |
1428 | msgstr "" | |
1429 | ||
1430 | #. type: Content of: <refentry><refsect1><para> | |
1431 | #: apt-get.8.xml:1 | |
1432 | msgid "" | |
1433 | "<command>apt-get</command> returns zero on normal operation, decimal 100 on " | |
1434 | "error." | |
1435 | msgstr "" | |
1436 | ||
1437 | #. type: Content of: <refentry><refnamediv><refpurpose> | |
1438 | #: apt-cache.8.xml:1 | |
1439 | msgid "query the APT cache" | |
1440 | msgstr "" | |
1441 | ||
1442 | #. type: Content of: <refentry><refsect1><para> | |
1443 | #: apt-cache.8.xml:1 | |
1444 | msgid "" | |
1445 | "<command>apt-cache</command> performs a variety of operations on APT's " | |
1446 | "package cache. <command>apt-cache</command> does not manipulate the state of " | |
1447 | "the system but does provide operations to search and generate interesting " | |
1448 | "output from the package metadata. The metadata is acquired and updated via " | |
1449 | "the 'update' command of e.g. <command>apt-get</command>, so that it can be " | |
1450 | "outdated if the last update is too long ago, but in exchange " | |
1451 | "<command>apt-cache</command> works independently of the availability of the " | |
1452 | "configured sources (e.g. offline)." | |
1453 | msgstr "" | |
1454 | ||
1455 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1456 | #: apt-cache.8.xml:1 | |
1457 | msgid "" | |
1458 | "<literal>gencaches</literal> creates APT's package cache. This is done " | |
1459 | "implicitly by all commands needing this cache if it is missing or outdated." | |
1460 | msgstr "" | |
1461 | ||
1462 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term><option><replaceable> | |
1463 | #: apt-cache.8.xml:1 apt-cache.8.xml:1 apt-cache.8.xml:1 apt-cache.8.xml:1 | |
1464 | #: apt-cache.8.xml:1 apt-cache.8.xml:1 apt-cache.8.xml:1 apt-cache.8.xml:1 | |
1465 | msgid "&synopsis-pkg;" | |
1466 | msgstr "" | |
1467 | ||
1468 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1469 | #: apt-cache.8.xml:1 | |
1470 | msgid "" | |
1471 | "<literal>showpkg</literal> displays information about the packages listed on " | |
1472 | "the command line. Remaining arguments are package names. The available " | |
1473 | "versions and reverse dependencies of each package listed are listed, as well " | |
1474 | "as forward dependencies for each version. Forward (normal) dependencies are " | |
1475 | "those packages upon which the package in question depends; reverse " | |
1476 | "dependencies are those packages that depend upon the package in " | |
1477 | "question. Thus, forward dependencies must be satisfied for a package, but " | |
1478 | "reverse dependencies need not be. For instance, <command>apt-cache showpkg " | |
1479 | "libreadline2</command> would produce output similar to the following:" | |
1480 | msgstr "" | |
1481 | ||
1482 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting> | |
1483 | #: apt-cache.8.xml:1 | |
1484 | #, no-wrap | |
1485 | msgid "" | |
1486 | "Package: libreadline2\n" | |
1487 | "Versions: 2.1-12(/var/state/apt/lists/foo_Packages),\n" | |
1488 | "Reverse Depends: \n" | |
1489 | " libreadlineg2,libreadline2\n" | |
1490 | " libreadline2-altdev,libreadline2\n" | |
1491 | "Dependencies:\n" | |
1492 | "2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))\n" | |
1493 | "Provides:\n" | |
1494 | "2.1-12 - \n" | |
1495 | "Reverse Provides: \n" | |
1496 | msgstr "" | |
1497 | ||
1498 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1499 | #: apt-cache.8.xml:1 | |
1500 | msgid "" | |
1501 | "Thus it may be seen that libreadline2, version 2.1-12, depends on libc5 and " | |
1502 | "ncurses3.0 which must be installed for libreadline2 to work. In turn, " | |
1503 | "libreadlineg2 and libreadline2-altdev depend on libreadline2. If " | |
1504 | "libreadline2 is installed, libc5 and ncurses3.0 (and ldso) must also be " | |
1505 | "installed; libreadlineg2 and libreadline2-altdev do not have to be " | |
1506 | "installed. For the specific meaning of the remainder of the output it is " | |
1507 | "best to consult the apt source code." | |
1508 | msgstr "" | |
1509 | ||
1510 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1511 | #: apt-cache.8.xml:1 | |
1512 | msgid "" | |
1513 | "<literal>stats</literal> displays some statistics about the cache. No " | |
1514 | "further arguments are expected. Statistics reported are:" | |
1515 | msgstr "" | |
1516 | ||
1517 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> | |
1518 | #: apt-cache.8.xml:1 | |
1519 | msgid "" | |
1520 | "<literal>Total package names</literal> is the number of package names found " | |
1521 | "in the cache." | |
1522 | msgstr "" | |
1523 | ||
1524 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> | |
1525 | #: apt-cache.8.xml:1 | |
1526 | msgid "" | |
1527 | "<literal>Normal packages</literal> is the number of regular, ordinary " | |
1528 | "package names; these are packages that bear a one-to-one correspondence " | |
1529 | "between their names and the names used by other packages for them in " | |
1530 | "dependencies. The majority of packages fall into this category." | |
1531 | msgstr "" | |
1532 | ||
1533 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> | |
1534 | #: apt-cache.8.xml:1 | |
1535 | msgid "" | |
1536 | "<literal>Pure virtual packages</literal> is the number of packages that " | |
1537 | "exist only as a virtual package name; that is, packages only \"provide\" the " | |
1538 | "virtual package name, and no package actually uses the name. For instance, " | |
1539 | "\"mail-transport-agent\" in the Debian system is a pure virtual package; " | |
1540 | "several packages provide \"mail-transport-agent\", but there is no package " | |
1541 | "named \"mail-transport-agent\"." | |
1542 | msgstr "" | |
1543 | ||
1544 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> | |
1545 | #: apt-cache.8.xml:1 | |
1546 | msgid "" | |
1547 | "<literal>Single virtual packages</literal> is the number of packages with " | |
1548 | "only one package providing a particular virtual package. For example, in the " | |
1549 | "Debian system, \"X11-text-viewer\" is a virtual package, but only one " | |
1550 | "package, xless, provides \"X11-text-viewer\"." | |
1551 | msgstr "" | |
1552 | ||
1553 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> | |
1554 | #: apt-cache.8.xml:1 | |
1555 | msgid "" | |
1556 | "<literal>Mixed virtual packages</literal> is the number of packages that " | |
1557 | "either provide a particular virtual package or have the virtual package name " | |
1558 | "as the package name. For instance, in the Debian system, \"debconf\" is both " | |
1559 | "an actual package, and provided by the debconf-tiny package." | |
1560 | msgstr "" | |
1561 | ||
1562 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> | |
1563 | #: apt-cache.8.xml:1 | |
1564 | msgid "" | |
1565 | "<literal>Missing</literal> is the number of package names that were " | |
1566 | "referenced in a dependency but were not provided by any package. Missing " | |
1567 | "packages may be an evidence if a full distribution is not accessed, or if a " | |
1568 | "package (real or virtual) has been dropped from the distribution. Usually " | |
1569 | "they are referenced from Conflicts or Breaks statements." | |
1570 | msgstr "" | |
1571 | ||
1572 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> | |
1573 | #: apt-cache.8.xml:1 | |
1574 | msgid "" | |
1575 | "<literal>Total distinct</literal> versions is the number of package versions " | |
1576 | "found in the cache. If more than one distribution is being accessed (for " | |
1577 | "instance, \"stable\" and \"unstable\"), this value can be considerably " | |
1578 | "larger than the number of total package names." | |
1579 | msgstr "" | |
1580 | ||
1581 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> | |
1582 | #: apt-cache.8.xml:1 | |
1583 | msgid "" | |
1584 | "<literal>Total dependencies</literal> is the number of dependency " | |
1585 | "relationships claimed by all of the packages in the cache." | |
1586 | msgstr "" | |
1587 | ||
1588 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1589 | #: apt-cache.8.xml:1 | |
1590 | msgid "" | |
1591 | "<literal>showsrc</literal> displays all the source package records that " | |
1592 | "match the given package names. All versions are shown, as well as all " | |
1593 | "records that declare the name to be a binary package. Use " | |
1594 | "<option>--only-source</option> to display only source package names." | |
1595 | msgstr "" | |
1596 | ||
1597 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1598 | #: apt-cache.8.xml:1 | |
1599 | msgid "" | |
1600 | "<literal>dump</literal> shows a short listing of every package in the " | |
1601 | "cache. It is primarily for debugging." | |
1602 | msgstr "" | |
1603 | ||
1604 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1605 | #: apt-cache.8.xml:1 | |
1606 | msgid "" | |
1607 | "<literal>dumpavail</literal> prints out an available list to stdout. This is " | |
1608 | "suitable for use with &dpkg; and is used by the &dselect; method." | |
1609 | msgstr "" | |
1610 | ||
1611 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1612 | #: apt-cache.8.xml:1 | |
1613 | msgid "" | |
1614 | "<literal>unmet</literal> displays a summary of all unmet dependencies in the " | |
1615 | "package cache." | |
1616 | msgstr "" | |
1617 | ||
1618 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1619 | #: apt-cache.8.xml:1 | |
1620 | msgid "" | |
1621 | "<literal>show</literal> performs a function similar to <command>dpkg " | |
1622 | "--print-avail</command>; it displays the package records for the named " | |
1623 | "packages." | |
1624 | msgstr "" | |
1625 | ||
1626 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term><option><replaceable> | |
1627 | #: apt-cache.8.xml:1 | |
1628 | msgid "&synopsis-regex;" | |
1629 | msgstr "" | |
1630 | ||
1631 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1632 | #: apt-cache.8.xml:1 | |
1633 | msgid "" | |
1634 | "<literal>search</literal> performs a full text search on all available " | |
1635 | "package lists for the POSIX regex pattern given, see ®ex;. It searches " | |
1636 | "the package names and the descriptions for an occurrence of the regular " | |
1637 | "expression and prints out the package name and the short description, " | |
1638 | "including virtual package names. If <option>--full</option> is given then " | |
1639 | "output identical to <literal>show</literal> is produced for each matched " | |
1640 | "package, and if <option>--names-only</option> is given then the long " | |
1641 | "description is not searched, only the package name and provided packages " | |
1642 | "are." | |
1643 | msgstr "" | |
1644 | ||
1645 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1646 | #: apt-cache.8.xml:1 | |
1647 | msgid "" | |
1648 | "Separate arguments can be used to specify multiple search patterns that are " | |
1649 | "and'ed together." | |
1650 | msgstr "" | |
1651 | ||
1652 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1653 | #: apt-cache.8.xml:1 | |
1654 | msgid "" | |
1655 | "<literal>depends</literal> shows a listing of each dependency a package has " | |
1656 | "and all the possible other packages that can fulfill that dependency." | |
1657 | msgstr "" | |
1658 | ||
1659 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1660 | #: apt-cache.8.xml:1 | |
1661 | msgid "" | |
1662 | "<literal>rdepends</literal> shows a listing of each reverse dependency a " | |
1663 | "package has." | |
1664 | msgstr "" | |
1665 | ||
1666 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> | |
1667 | #: apt-cache.8.xml:1 | |
1668 | msgid "<optional><replaceable>&synopsis-prefix;</replaceable></optional>" | |
1669 | msgstr "" | |
1670 | ||
1671 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1672 | #: apt-cache.8.xml:1 | |
1673 | msgid "" | |
1674 | "This command prints the name of each package APT knows. The optional " | |
1675 | "argument is a prefix match to filter the name list. The output is suitable " | |
1676 | "for use in a shell tab complete function and the output is generated " | |
1677 | "extremely quickly. This command is best used with the " | |
1678 | "<option>--generate</option> option." | |
1679 | msgstr "" | |
1680 | ||
1681 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1682 | #: apt-cache.8.xml:1 | |
1683 | msgid "" | |
1684 | "Note that a package which APT knows of is not necessarily available to " | |
1685 | "download, installable or installed, e.g. virtual packages are also listed in " | |
1686 | "the generated list." | |
1687 | msgstr "" | |
1688 | ||
1689 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1690 | #: apt-cache.8.xml:1 | |
1691 | msgid "" | |
1692 | "<literal>dotty</literal> takes a list of packages on the command line and " | |
1693 | "generates output suitable for use by dotty from the <ulink " | |
1694 | "url=\"http://www.research.att.com/sw/tools/graphviz/\">GraphViz</ulink> " | |
1695 | "package. The result will be a set of nodes and edges representing the " | |
1696 | "relationships between the packages. By default the given packages will trace " | |
1697 | "out all dependent packages; this can produce a very large graph. To limit " | |
1698 | "the output to only the packages listed on the command line, set the " | |
1699 | "<literal>APT::Cache::GivenOnly</literal> option." | |
1700 | msgstr "" | |
1701 | ||
1702 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1703 | #: apt-cache.8.xml:1 | |
1704 | msgid "" | |
1705 | "The resulting nodes will have several shapes; normal packages are boxes, " | |
1706 | "pure virtual packages are triangles, mixed virtual packages are diamonds, " | |
1707 | "missing packages are hexagons. Orange boxes mean recursion was stopped (leaf " | |
1708 | "packages), blue lines are pre-depends, green lines are conflicts." | |
1709 | msgstr "" | |
1710 | ||
1711 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1712 | #: apt-cache.8.xml:1 | |
1713 | msgid "Caution, dotty cannot graph larger sets of packages." | |
1714 | msgstr "" | |
1715 | ||
1716 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1717 | #: apt-cache.8.xml:1 | |
1718 | msgid "" | |
1719 | "The same as <literal>dotty</literal>, only for xvcg from the <ulink " | |
1720 | "url=\"http://rw4.cs.uni-sb.de/users/sander/html/gsvcg1.html\">VCG " | |
1721 | "tool</ulink>." | |
1722 | msgstr "" | |
1723 | ||
1724 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> | |
1725 | #: apt-cache.8.xml:1 | |
1726 | msgid "<optional><replaceable>&synopsis-pkg;</replaceable>…</optional>" | |
1727 | msgstr "" | |
1728 | ||
1729 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1730 | #: apt-cache.8.xml:1 | |
1731 | msgid "" | |
1732 | "<literal>policy</literal> is meant to help debug issues relating to the " | |
1733 | "preferences file. With no arguments it will print out the priorities of each " | |
1734 | "source. Otherwise it prints out detailed information about the priority " | |
1735 | "selection of the named package." | |
1736 | msgstr "" | |
1737 | ||
1738 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1739 | #: apt-cache.8.xml:1 | |
1740 | msgid "" | |
1741 | "<literal>apt-cache</literal>'s <literal>madison</literal> command attempts " | |
1742 | "to mimic the output format and a subset of the functionality of the Debian " | |
1743 | "archive management tool, <literal>madison</literal>. It displays available " | |
1744 | "versions of a package in a tabular format. Unlike the original " | |
1745 | "<literal>madison</literal>, it can only display information for the " | |
1746 | "architecture for which APT has retrieved package lists " | |
1747 | "(<literal>APT::Architecture</literal>)." | |
1748 | msgstr "" | |
1749 | ||
1750 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1751 | #: apt-cache.8.xml:1 | |
1752 | msgid "" | |
1753 | "Select the file to store the package cache. The package cache is the primary " | |
1754 | "cache used by all operations. Configuration Item: " | |
1755 | "<literal>Dir::Cache::pkgcache</literal>." | |
1756 | msgstr "" | |
1757 | ||
1758 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1759 | #: apt-cache.8.xml:1 | |
1760 | msgid "" | |
1761 | "Select the file to store the source cache. The source is used only by " | |
1762 | "<literal>gencaches</literal> and it stores a parsed version of the package " | |
1763 | "information from remote sources. When building the package cache the source " | |
1764 | "cache is used to avoid reparsing all of the package files. Configuration " | |
1765 | "Item: <literal>Dir::Cache::srcpkgcache</literal>." | |
1766 | msgstr "" | |
1767 | ||
1768 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1769 | #: apt-cache.8.xml:1 | |
1770 | msgid "" | |
1771 | "Quiet; produces output suitable for logging, omitting progress indicators. " | |
1772 | "More q's will produce more quietness up to a maximum of 2. You can also use " | |
1773 | "<option>-q=#</option> to set the quietness level, overriding the " | |
1774 | "configuration file. Configuration Item: <literal>quiet</literal>." | |
1775 | msgstr "" | |
1776 | ||
1777 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1778 | #: apt-cache.8.xml:1 | |
1779 | msgid "" | |
1780 | "Print only important dependencies; for use with <literal>unmet</literal> and " | |
1781 | "<literal>depends</literal>. Causes only Depends and Pre-Depends relations to " | |
1782 | "be printed. Configuration Item: <literal>APT::Cache::Important</literal>." | |
1783 | msgstr "" | |
1784 | ||
1785 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1786 | #: apt-cache.8.xml:1 | |
1787 | msgid "" | |
1788 | "Per default the <command>depends</command> and <command>rdepends</command> " | |
1789 | "print all dependencies. This can be tweaked with these flags which will omit " | |
1790 | "the specified dependency type. Configuration Item: " | |
1791 | "<literal>APT::Cache::Show<replaceable>DependencyType</replaceable></literal> " | |
1792 | "e.g. <literal>APT::Cache::ShowRecommends</literal>." | |
1793 | msgstr "" | |
1794 | ||
1795 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1796 | #: apt-cache.8.xml:1 | |
1797 | msgid "" | |
1798 | "Per default <command>depends</command> and <command>rdepends</command> print " | |
1799 | "only dependencies explicitly expressed in the metadata. With this flag it " | |
1800 | "will also show dependencies implicitely added based on the encountered " | |
1801 | "data. A <literal>Conflicts: foo</literal> e.g. expresses implicitely that " | |
1802 | "this package also conflicts with the package foo from any other " | |
1803 | "architecture. Configuration Item: " | |
1804 | "<literal>APT::Cache::ShowImplicit</literal>." | |
1805 | msgstr "" | |
1806 | ||
1807 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1808 | #: apt-cache.8.xml:1 | |
1809 | msgid "" | |
1810 | "Print full package records when searching. Configuration Item: " | |
1811 | "<literal>APT::Cache::ShowFull</literal>." | |
1812 | msgstr "" | |
1813 | ||
1814 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1815 | #: apt-cache.8.xml:1 | |
1816 | msgid "" | |
1817 | "Print full records for all available versions. This is the default; to turn " | |
1818 | "it off, use <option>--no-all-versions</option>. If " | |
1819 | "<option>--no-all-versions</option> is specified, only the candidate version " | |
1820 | "will be displayed (the one which would be selected for installation). This " | |
1821 | "option is only applicable to the <literal>show</literal> command. " | |
1822 | "Configuration Item: <literal>APT::Cache::AllVersions</literal>." | |
1823 | msgstr "" | |
1824 | ||
1825 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1826 | #: apt-cache.8.xml:1 | |
1827 | msgid "" | |
1828 | "Perform automatic package cache regeneration, rather than use the cache as " | |
1829 | "it is. This is the default; to turn it off, use " | |
1830 | "<option>--no-generate</option>. Configuration Item: " | |
1831 | "<literal>APT::Cache::Generate</literal>." | |
1832 | msgstr "" | |
1833 | ||
1834 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1835 | #: apt-cache.8.xml:1 | |
1836 | msgid "" | |
1837 | "Only search on the package and provided package names, not the long " | |
1838 | "descriptions. Configuration Item: <literal>APT::Cache::NamesOnly</literal>." | |
1839 | msgstr "" | |
1840 | ||
1841 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1842 | #: apt-cache.8.xml:1 | |
1843 | msgid "" | |
1844 | "Make <literal>pkgnames</literal> print all names, including virtual packages " | |
1845 | "and missing dependencies. Configuration Item: " | |
1846 | "<literal>APT::Cache::AllNames</literal>." | |
1847 | msgstr "" | |
1848 | ||
1849 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1850 | #: apt-cache.8.xml:1 | |
1851 | msgid "" | |
1852 | "Make <literal>depends</literal> and <literal>rdepends</literal> recursive so " | |
1853 | "that all packages mentioned are printed once. Configuration Item: " | |
1854 | "<literal>APT::Cache::RecurseDepends</literal>." | |
1855 | msgstr "" | |
1856 | ||
1857 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1858 | #: apt-cache.8.xml:1 | |
1859 | msgid "" | |
1860 | "Limit the output of <literal>depends</literal> and " | |
1861 | "<literal>rdepends</literal> to packages which are currently installed. " | |
1862 | "Configuration Item: <literal>APT::Cache::Installed</literal>." | |
1863 | msgstr "" | |
1864 | ||
1865 | #. type: Content of: <refentry><refsect1><para> | |
1866 | #: apt-cache.8.xml:1 | |
1867 | msgid "&apt-conf;, &sources-list;, &apt-get;" | |
1868 | msgstr "" | |
1869 | ||
1870 | #. type: Content of: <refentry><refsect1><para> | |
1871 | #: apt-cache.8.xml:1 | |
1872 | msgid "" | |
1873 | "<command>apt-cache</command> returns zero on normal operation, decimal 100 " | |
1874 | "on error." | |
1875 | msgstr "" | |
1876 | ||
1877 | #. type: Content of: <refentry><refnamediv><refpurpose> | |
1878 | #: apt-key.8.xml:1 | |
1879 | msgid "APT key management utility" | |
1880 | msgstr "" | |
1881 | ||
1882 | #. type: Content of: <refentry><refsect1><para> | |
1883 | #: apt-key.8.xml:1 | |
1884 | msgid "" | |
1885 | "<command>apt-key</command> is used to manage the list of keys used by apt to " | |
1886 | "authenticate packages. Packages which have been authenticated using these " | |
1887 | "keys will be considered trusted." | |
1888 | msgstr "" | |
1889 | ||
1890 | #. type: Content of: <refentry><refsect1><title> | |
1891 | #: apt-key.8.xml:1 | |
1892 | msgid "Commands" | |
1893 | msgstr "" | |
1894 | ||
1895 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1896 | #: apt-key.8.xml:1 | |
1897 | msgid "" | |
1898 | "Add a new key to the list of trusted keys. The key is read from the " | |
1899 | "filename given with the parameter &synopsis-param-filename; or if the " | |
1900 | "filename is <literal>-</literal> from standard input." | |
1901 | msgstr "" | |
1902 | ||
1903 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1904 | #: apt-key.8.xml:1 | |
1905 | msgid "" | |
1906 | "It is critical that keys added manually via <command>apt-key</command> are " | |
1907 | "verified to belong to the owner of the repositories they claim to be for " | |
1908 | "otherwise the &apt-secure; infrastructure is completely undermined." | |
1909 | msgstr "" | |
1910 | ||
1911 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1912 | #: apt-key.8.xml:1 | |
1913 | msgid "Remove a key from the list of trusted keys." | |
1914 | msgstr "" | |
1915 | ||
1916 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1917 | #: apt-key.8.xml:1 | |
1918 | msgid "Output the key &synopsis-param-keyid; to standard output." | |
1919 | msgstr "" | |
1920 | ||
1921 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1922 | #: apt-key.8.xml:1 | |
1923 | msgid "Output all trusted keys to standard output." | |
1924 | msgstr "" | |
1925 | ||
1926 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1927 | #: apt-key.8.xml:1 | |
1928 | msgid "List trusted keys." | |
1929 | msgstr "" | |
1930 | ||
1931 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1932 | #: apt-key.8.xml:1 | |
1933 | msgid "List fingerprints of trusted keys." | |
1934 | msgstr "" | |
1935 | ||
1936 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1937 | #: apt-key.8.xml:1 | |
1938 | msgid "" | |
1939 | "Pass advanced options to gpg. With <command>adv --recv-key</command> you can " | |
1940 | "e.g. download key from keyservers directly into the the trusted set of " | |
1941 | "keys. Note that there are <emphasis>no</emphasis> checks performed, so it is " | |
1942 | "easy to completely undermine the &apt-secure; infrastructure if used without " | |
1943 | "care." | |
1944 | msgstr "" | |
1945 | ||
1946 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1947 | #: apt-key.8.xml:1 | |
1948 | msgid "" | |
1949 | "Update the local keyring with the archive keyring and remove from the local " | |
1950 | "keyring the archive keys which are no longer valid. The archive keyring is " | |
1951 | "shipped in the <literal>archive-keyring</literal> package of your " | |
1952 | "distribution, e.g. the &keyring-package; package in &keyring-distro;." | |
1953 | msgstr "" | |
1954 | ||
1955 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1956 | #: apt-key.8.xml:1 | |
1957 | msgid "" | |
1958 | "Perform an update working similarly to the <command>update</command> command " | |
1959 | "above, but get the archive keyring from a URI instead and validate it " | |
1960 | "against a master key. This requires an installed &wget; and an APT build " | |
1961 | "configured to have a server to fetch from and a master keyring to validate. " | |
1962 | "APT in Debian does not support this command, relying on " | |
1963 | "<command>update</command> instead, but Ubuntu's APT does." | |
1964 | msgstr "" | |
1965 | ||
1966 | #. type: Content of: <refentry><refsect1><title> | |
1967 | #: apt-key.8.xml:1 apt-mark.8.xml:1 apt-mark.8.xml:1 apt-cdrom.8.xml:1 | |
1968 | msgid "Options" | |
1969 | msgstr "" | |
1970 | ||
1971 | #. type: Content of: <refentry><refsect1><para> | |
1972 | #: apt-key.8.xml:1 | |
1973 | msgid "" | |
1974 | "Note that options need to be defined before the commands described in the " | |
1975 | "previous section." | |
1976 | msgstr "" | |
1977 | ||
1978 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1979 | #: apt-key.8.xml:1 | |
1980 | msgid "" | |
1981 | "With this option it is possible to specify a particular keyring file the " | |
1982 | "command should operate on. The default is that a command is executed on the " | |
1983 | "<filename>trusted.gpg</filename> file as well as on all parts in the " | |
1984 | "<filename>trusted.gpg.d</filename> directory, though " | |
1985 | "<filename>trusted.gpg</filename> is the primary keyring which means that " | |
1986 | "e.g. new keys are added to this one." | |
1987 | msgstr "" | |
1988 | ||
1989 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> | |
1990 | #: apt-key.8.xml:1 | |
1991 | msgid "<filename>/etc/apt/trustdb.gpg</filename>" | |
1992 | msgstr "" | |
1993 | ||
1994 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
1995 | #: apt-key.8.xml:1 | |
1996 | msgid "Local trust database of archive keys." | |
1997 | msgstr "" | |
1998 | ||
1999 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> | |
2000 | #: apt-key.8.xml:1 | |
2001 | msgid "&keyring-filename;" | |
2002 | msgstr "" | |
2003 | ||
2004 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2005 | #: apt-key.8.xml:1 | |
2006 | msgid "Keyring of &keyring-distro; archive trusted keys." | |
2007 | msgstr "" | |
2008 | ||
2009 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> | |
2010 | #: apt-key.8.xml:1 | |
2011 | msgid "&keyring-removed-filename;" | |
2012 | msgstr "" | |
2013 | ||
2014 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2015 | #: apt-key.8.xml:1 | |
2016 | msgid "Keyring of &keyring-distro; archive removed trusted keys." | |
2017 | msgstr "" | |
2018 | ||
2019 | #. type: Content of: <refentry><refsect1><para> | |
2020 | #: apt-key.8.xml:1 | |
2021 | msgid "&apt-get;, &apt-secure;" | |
2022 | msgstr "" | |
2023 | ||
2024 | #. type: Content of: <refentry><refnamediv><refpurpose> | |
2025 | #: apt-mark.8.xml:1 | |
2026 | msgid "show, set and unset various settings for a package" | |
2027 | msgstr "" | |
2028 | ||
2029 | #. type: Content of: <refentry><refsect1><para> | |
2030 | #: apt-mark.8.xml:1 | |
2031 | msgid "" | |
2032 | "<command>apt-mark</command> can be used as a unified front-end to set " | |
2033 | "various settings for a package, such as marking a package as being " | |
2034 | "automatically/manually installed or changing <command>dpkg</command> " | |
2035 | "selections such as hold, install, deinstall and purge which are respected " | |
2036 | "e.g. by <command>apt-get dselect-upgrade</command> or " | |
2037 | "<command>aptitude</command>." | |
2038 | msgstr "" | |
2039 | ||
2040 | #. type: Content of: <refentry><refsect1><title> | |
2041 | #: apt-mark.8.xml:1 | |
2042 | msgid "Automatically and Manually Installed Packages" | |
2043 | msgstr "" | |
2044 | ||
2045 | #. type: Content of: <refentry><refsect1><para> | |
2046 | #: apt-mark.8.xml:1 | |
2047 | msgid "" | |
2048 | "When you request that a package is installed, and as a result other packages " | |
2049 | "are installed to satisfy its dependencies, the dependencies are marked as " | |
2050 | "being automatically installed, while the package you installed explicitly is " | |
2051 | "marked as manually installed. Once an automatically installed package is no " | |
2052 | "longer depended on by any manually installed package it is considered no " | |
2053 | "longer needed and e.g. <command>apt-get</command> or " | |
2054 | "<command>aptitude</command> will at least suggest removing them." | |
2055 | msgstr "" | |
2056 | ||
2057 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2058 | #: apt-mark.8.xml:1 | |
2059 | msgid "" | |
2060 | "<literal>auto</literal> is used to mark a package as being automatically " | |
2061 | "installed, which will cause the package to be removed when no more manually " | |
2062 | "installed packages depend on this package." | |
2063 | msgstr "" | |
2064 | ||
2065 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2066 | #: apt-mark.8.xml:1 | |
2067 | msgid "" | |
2068 | "<literal>manual</literal> is used to mark a package as being manually " | |
2069 | "installed, which will prevent the package from being automatically removed " | |
2070 | "if no other packages depend on it." | |
2071 | msgstr "" | |
2072 | ||
2073 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2074 | #: apt-mark.8.xml:1 | |
2075 | msgid "" | |
2076 | "<literal>showauto</literal> is used to print a list of automatically " | |
2077 | "installed packages with each package on a new line. All automatically " | |
2078 | "installed packages will be listed if no package is given. If packages are " | |
2079 | "given only those which are automatically installed will be shown." | |
2080 | msgstr "" | |
2081 | ||
2082 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2083 | #: apt-mark.8.xml:1 | |
2084 | msgid "" | |
2085 | "<literal>showmanual</literal> can be used in the same way as " | |
2086 | "<literal>showauto</literal> except that it will print a list of manually " | |
2087 | "installed packages instead." | |
2088 | msgstr "" | |
2089 | ||
2090 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
2091 | #: apt-mark.8.xml:1 | |
2092 | msgid "" | |
2093 | "Read/Write package stats from the filename given with the parameter " | |
2094 | "&synopsis-param-filename; instead of from the default location, which is " | |
2095 | "<filename>extended_status</filename> in the directory defined by the " | |
2096 | "Configuration Item: <literal>Dir::State</literal>." | |
2097 | msgstr "" | |
2098 | ||
2099 | #. type: Content of: <refentry><refsect1><title> | |
2100 | #: apt-mark.8.xml:1 | |
2101 | msgid "Prevent Changes for a Package" | |
2102 | msgstr "" | |
2103 | ||
2104 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2105 | #: apt-mark.8.xml:1 | |
2106 | msgid "" | |
2107 | "<literal>hold</literal> is used to mark a package as held back, which will " | |
2108 | "prevent the package from being automatically installed, upgraded or removed." | |
2109 | msgstr "" | |
2110 | ||
2111 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2112 | #: apt-mark.8.xml:1 | |
2113 | msgid "" | |
2114 | "<literal>unhold</literal> is used to cancel a previously set hold on a " | |
2115 | "package to allow all actions again." | |
2116 | msgstr "" | |
2117 | ||
2118 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2119 | #: apt-mark.8.xml:1 | |
2120 | msgid "" | |
2121 | "<literal>showhold</literal> is used to print a list of packages on hold in " | |
2122 | "the same way as for the other show commands." | |
2123 | msgstr "" | |
2124 | ||
2125 | #. type: Content of: <refentry><refsect1><title> | |
2126 | #: apt-mark.8.xml:1 | |
2127 | msgid "Schedule Packages for Install, Remove and Purge" | |
2128 | msgstr "" | |
2129 | ||
2130 | #. type: Content of: <refentry><refsect1><para> | |
2131 | #: apt-mark.8.xml:1 | |
2132 | msgid "" | |
2133 | "Some front-ends like <command>apt-get dselect-upgrade</command> can be used " | |
2134 | "to apply previously scheduled changes to the install state of packages. Such " | |
2135 | "changes can be scheduled with the <option>install</option>, " | |
2136 | "<option>remove</option> (also known as <option>deinstall</option>) and " | |
2137 | "<option>purge</option> commands. Packages with a specific selection can be " | |
2138 | "displayed with <option>showinstall</option>, <option>showremove</option> and " | |
2139 | "<option>showpurge</option> respectively. More information about these so " | |
2140 | "called dpkg selections can be found in &dpkg;." | |
2141 | msgstr "" | |
2142 | ||
2143 | #. type: Content of: <refentry><refsect1><para> | |
2144 | #: apt-mark.8.xml:1 | |
2145 | msgid "" | |
2146 | "<command>apt-mark</command> returns zero on normal operation, non-zero on " | |
2147 | "error." | |
2148 | msgstr "" | |
2149 | ||
2150 | #. type: Content of: <refentry><refnamediv><refpurpose> | |
2151 | #: apt-secure.8.xml:1 | |
2152 | msgid "Archive authentication support for APT" | |
2153 | msgstr "" | |
2154 | ||
2155 | #. type: Content of: <refentry><refsect1><para> | |
2156 | #: apt-secure.8.xml:1 | |
2157 | msgid "" | |
2158 | "Starting with version 0.6, <command>APT</command> contains code that does " | |
2159 | "signature checking of the Release file for all repositories. This ensures " | |
2160 | "that data like packages in the archive can't be modified by people who have " | |
2161 | "no access to the Release file signing key." | |
2162 | msgstr "" | |
2163 | ||
2164 | #. type: Content of: <refentry><refsect1><para> | |
2165 | #: apt-secure.8.xml:1 | |
2166 | msgid "" | |
2167 | "If an archive has an unsigned Release file or no Release file at all current " | |
2168 | "APT versions will raise a warning in <command>update</command> operations " | |
2169 | "and front-ends like <command>apt-get</command> will require explicit " | |
2170 | "confirmation if an installation request includes a package from such an " | |
2171 | "unauthenticated archive." | |
2172 | msgstr "" | |
2173 | ||
2174 | #. type: Content of: <refentry><refsect1><para> | |
2175 | #: apt-secure.8.xml:1 | |
2176 | msgid "" | |
2177 | "In the future APT will refuse to work with unauthenticated repositories by " | |
2178 | "default until support for them is removed entirely. Users have the option to " | |
2179 | "opt-in to this behavior already by setting the configuration option " | |
2180 | "<option>Acquire::AllowInsecureRepositories</option> to " | |
2181 | "<literal>false</literal>." | |
2182 | msgstr "" | |
2183 | ||
2184 | #. type: Content of: <refentry><refsect1><para> | |
2185 | #: apt-secure.8.xml:1 | |
2186 | msgid "" | |
2187 | "Note: All APT-based package management front-ends like &apt-get;, &aptitude; " | |
2188 | "and &synaptic; support this authentication feature, so this manpage uses " | |
2189 | "<literal>APT</literal> to refer to them all for simplicity only." | |
2190 | msgstr "" | |
2191 | ||
2192 | #. type: Content of: <refentry><refsect1><title> | |
2193 | #: apt-secure.8.xml:1 | |
2194 | msgid "Trusted Repositories" | |
2195 | msgstr "" | |
2196 | ||
2197 | #. type: Content of: <refentry><refsect1><para> | |
2198 | #: apt-secure.8.xml:1 | |
2199 | msgid "" | |
2200 | "The chain of trust from an APT archive to the end user is made up of several " | |
2201 | "steps. <command>apt-secure</command> is the last step in this chain; " | |
2202 | "trusting an archive does not mean that you trust its packages not to contain " | |
2203 | "malicious code, but means that you trust the archive maintainer. It's the " | |
2204 | "archive maintainer's responsibility to ensure that the archive's integrity " | |
2205 | "is preserved." | |
2206 | msgstr "" | |
2207 | ||
2208 | #. type: Content of: <refentry><refsect1><para> | |
2209 | #: apt-secure.8.xml:1 | |
2210 | msgid "" | |
2211 | "apt-secure does not review signatures at a package level. If you require " | |
2212 | "tools to do this you should look at <command>debsig-verify</command> and " | |
2213 | "<command>debsign</command> (provided in the debsig-verify and devscripts " | |
2214 | "packages respectively)." | |
2215 | msgstr "" | |
2216 | ||
2217 | #. type: Content of: <refentry><refsect1><para> | |
2218 | #: apt-secure.8.xml:1 | |
2219 | msgid "" | |
2220 | "The chain of trust in Debian starts (e.g.) when a maintainer uploads a new " | |
2221 | "package or a new version of a package to the Debian archive. In order to " | |
2222 | "become effective, this upload needs to be signed by a key contained in one " | |
2223 | "of the Debian package maintainer keyrings (available in the debian-keyring " | |
2224 | "package). Maintainers' keys are signed by other maintainers following " | |
2225 | "pre-established procedures to ensure the identity of the key holder. Similar " | |
2226 | "procedures exist in all Debian-based distributions." | |
2227 | msgstr "" | |
2228 | ||
2229 | #. type: Content of: <refentry><refsect1><para> | |
2230 | #: apt-secure.8.xml:1 | |
2231 | msgid "" | |
2232 | "Once the uploaded package is verified and included in the archive, the " | |
2233 | "maintainer signature is stripped off, and checksums of the package are " | |
2234 | "computed and put in the Packages file. The checksums of all of the Packages " | |
2235 | "files are then computed and put into the Release file. The Release file is " | |
2236 | "then signed by the archive key for this &keyring-distro; release, and " | |
2237 | "distributed alongside the packages and the Packages files on " | |
2238 | "&keyring-distro; mirrors. The keys are in the &keyring-distro; archive " | |
2239 | "keyring available in the &keyring-package; package." | |
2240 | msgstr "" | |
2241 | ||
2242 | #. type: Content of: <refentry><refsect1><para> | |
2243 | #: apt-secure.8.xml:1 | |
2244 | msgid "" | |
2245 | "End users can check the signature of the Release file, extract a checksum of " | |
2246 | "a package from it and compare it with the checksum of the package they " | |
2247 | "downloaded by hand - or rely on APT doing this automatically." | |
2248 | msgstr "" | |
2249 | ||
2250 | #. type: Content of: <refentry><refsect1><para> | |
2251 | #: apt-secure.8.xml:1 | |
2252 | msgid "" | |
2253 | "Notice that this is distinct from checking signatures on a per package " | |
2254 | "basis. It is designed to prevent two possible attacks:" | |
2255 | msgstr "" | |
2256 | ||
2257 | #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> | |
2258 | #: apt-secure.8.xml:1 | |
2259 | msgid "" | |
2260 | "<literal>Network \"man in the middle\" attacks</literal>. Without signature " | |
2261 | "checking, malicious agents can introduce themselves into the package " | |
2262 | "download process and provide malicious software either by controlling a " | |
2263 | "network element (router, switch, etc.) or by redirecting traffic to a rogue " | |
2264 | "server (through ARP or DNS spoofing attacks)." | |
2265 | msgstr "" | |
2266 | ||
2267 | #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> | |
2268 | #: apt-secure.8.xml:1 | |
2269 | msgid "" | |
2270 | "<literal>Mirror network compromise</literal>. Without signature checking, a " | |
2271 | "malicious agent can compromise a mirror host and modify the files in it to " | |
2272 | "propagate malicious software to all users downloading packages from that " | |
2273 | "host." | |
2274 | msgstr "" | |
2275 | ||
2276 | #. type: Content of: <refentry><refsect1><para> | |
2277 | #: apt-secure.8.xml:1 | |
2278 | msgid "" | |
2279 | "However, it does not defend against a compromise of the master server itself " | |
2280 | "(which signs the packages) or against a compromise of the key used to sign " | |
2281 | "the Release files. In any case, this mechanism can complement a per-package " | |
2282 | "signature." | |
2283 | msgstr "" | |
2284 | ||
2285 | #. type: Content of: <refentry><refsect1><title> | |
2286 | #: apt-secure.8.xml:1 | |
2287 | msgid "User Configuration" | |
2288 | msgstr "" | |
2289 | ||
2290 | #. type: Content of: <refentry><refsect1><para> | |
2291 | #: apt-secure.8.xml:1 | |
2292 | msgid "" | |
2293 | "<command>apt-key</command> is the program that manages the list of keys used " | |
2294 | "by APT to trust repositories. It can be used to add or remove keys as well " | |
2295 | "as list the trusted keys. Limiting which key(s) are able to sign which " | |
2296 | "archive is possible via the <option>Signed-By</option> in &sources-list;." | |
2297 | msgstr "" | |
2298 | ||
2299 | #. type: Content of: <refentry><refsect1><para> | |
2300 | #: apt-secure.8.xml:1 | |
2301 | msgid "" | |
2302 | "Note that a default installation already contains all keys to securely " | |
2303 | "acquire packages from the default repositories, so fiddling with " | |
2304 | "<command>apt-key</command> is only needed if third-party repositories are " | |
2305 | "added." | |
2306 | msgstr "" | |
2307 | ||
2308 | #. type: Content of: <refentry><refsect1><para> | |
2309 | #: apt-secure.8.xml:1 | |
2310 | msgid "" | |
2311 | "In order to add a new key you need to first download it (you should make " | |
2312 | "sure you are using a trusted communication channel when retrieving it), add " | |
2313 | "it with <command>apt-key</command> and then run <command>apt-get " | |
2314 | "update</command> so that apt can download and verify the " | |
2315 | "<filename>InRelease</filename> or <filename>Release.gpg</filename> files " | |
2316 | "from the archives you have configured." | |
2317 | msgstr "" | |
2318 | ||
2319 | #. type: Content of: <refentry><refsect1><title> | |
2320 | #: apt-secure.8.xml:1 | |
2321 | msgid "Archive Configuration" | |
2322 | msgstr "" | |
2323 | ||
2324 | #. type: Content of: <refentry><refsect1><para> | |
2325 | #: apt-secure.8.xml:1 | |
2326 | msgid "" | |
2327 | "If you want to provide archive signatures in an archive under your " | |
2328 | "maintenance you have to:" | |
2329 | msgstr "" | |
2330 | ||
2331 | #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> | |
2332 | #: apt-secure.8.xml:1 | |
2333 | msgid "" | |
2334 | "<emphasis>Create a toplevel Release file</emphasis>, if it does not exist " | |
2335 | "already. You can do this by running <command>apt-ftparchive " | |
2336 | "release</command> (provided in apt-utils)." | |
2337 | msgstr "" | |
2338 | ||
2339 | #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> | |
2340 | #: apt-secure.8.xml:1 | |
2341 | msgid "" | |
2342 | "<emphasis>Sign it</emphasis>. You can do this by running <command>gpg " | |
2343 | "--clearsign -o InRelease Release</command> and <command>gpg -abs -o " | |
2344 | "Release.gpg Release</command>." | |
2345 | msgstr "" | |
2346 | ||
2347 | #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> | |
2348 | #: apt-secure.8.xml:1 | |
2349 | msgid "" | |
2350 | "<emphasis>Publish the key fingerprint</emphasis>, so that your users will " | |
2351 | "know what key they need to import in order to authenticate the files in the " | |
2352 | "archive. It is best to ship your key in its own keyring package like " | |
2353 | "&keyring-distro; does with &keyring-package; to be able to distribute " | |
2354 | "updates and key transitions automatically later." | |
2355 | msgstr "" | |
2356 | ||
2357 | #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> | |
2358 | #: apt-secure.8.xml:1 | |
2359 | msgid "" | |
2360 | "<emphasis>Provide instructions on how to add your archive and " | |
2361 | "key</emphasis>. If your users can't acquire your key securely the chain of " | |
2362 | "trust described above is broken. How you can help users add your key " | |
2363 | "depends on your archive and target audience ranging from having your keyring " | |
2364 | "package included in another archive users already have configured (like the " | |
2365 | "default repositories of their distribution) to leveraging the web of trust." | |
2366 | msgstr "" | |
2367 | ||
2368 | #. type: Content of: <refentry><refsect1><para> | |
2369 | #: apt-secure.8.xml:1 | |
2370 | msgid "" | |
2371 | "Whenever the contents of the archive change (new packages are added or " | |
2372 | "removed) the archive maintainer has to follow the first two steps outlined " | |
2373 | "above." | |
2374 | msgstr "" | |
2375 | ||
2376 | #. type: Content of: <refentry><refsect1><para> | |
2377 | #: apt-secure.8.xml:1 | |
2378 | msgid "" | |
2379 | "&apt-conf;, &apt-get;, &sources-list;, &apt-key;, &apt-ftparchive;, " | |
2380 | "&debsign;, &debsig-verify;, &gpg;" | |
2381 | msgstr "" | |
2382 | ||
2383 | #. type: Content of: <refentry><refsect1><para> | |
2384 | #: apt-secure.8.xml:1 | |
2385 | msgid "" | |
2386 | "For more background information you might want to review the <ulink " | |
2387 | "url=\"https://www.debian.org/doc/manuals/securing-debian-howto/ch7\">Debian " | |
2388 | "Security Infrastructure</ulink> chapter of the Securing Debian Manual (also " | |
2389 | "available in the harden-doc package) and the <ulink " | |
2390 | "url=\"http://www.cryptnet.net/fdp/crypto/strong_distro.html\" >Strong " | |
2391 | "Distribution HOWTO</ulink> by V. Alex Brennen." | |
2392 | msgstr "" | |
2393 | ||
2394 | #. type: Content of: <refentry><refsect1><title> | |
2395 | #: apt-secure.8.xml:1 | |
2396 | msgid "Manpage Authors" | |
2397 | msgstr "" | |
2398 | ||
2399 | #. type: Content of: <refentry><refsect1><para> | |
2400 | #: apt-secure.8.xml:1 | |
2401 | msgid "" | |
2402 | "This man-page is based on the work of Javier Fernández-Sanguino Peña, Isaac " | |
2403 | "Jones, Colin Walters, Florian Weimer and Michael Vogt." | |
2404 | msgstr "" | |
2405 | ||
2406 | #. type: Content of: <refentry><refnamediv><refpurpose> | |
2407 | #: apt-cdrom.8.xml:1 | |
2408 | msgid "APT CD-ROM management utility" | |
2409 | msgstr "" | |
2410 | ||
2411 | #. type: Content of: <refentry><refsect1><para> | |
2412 | #: apt-cdrom.8.xml:1 | |
2413 | msgid "" | |
2414 | "<command>apt-cdrom</command> is used to add a new CD-ROM to APT's list of " | |
2415 | "available sources. <command>apt-cdrom</command> takes care of determining " | |
2416 | "the structure of the disc as well as correcting for several possible " | |
2417 | "mis-burns and verifying the index files." | |
2418 | msgstr "" | |
2419 | ||
2420 | #. type: Content of: <refentry><refsect1><para> | |
2421 | #: apt-cdrom.8.xml:1 | |
2422 | msgid "" | |
2423 | "It is necessary to use <command>apt-cdrom</command> to add CDs to the APT " | |
2424 | "system; it cannot be done by hand. Furthermore each disc in a multi-CD set " | |
2425 | "must be inserted and scanned separately to account for possible mis-burns." | |
2426 | msgstr "" | |
2427 | ||
2428 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2429 | #: apt-cdrom.8.xml:1 | |
2430 | msgid "" | |
2431 | "<literal>add</literal> is used to add a new disc to the source list. It will " | |
2432 | "unmount the CD-ROM device, prompt for a disc to be inserted and then proceed " | |
2433 | "to scan it and copy the index files. If the disc does not have a proper " | |
2434 | "<filename>.disk</filename> directory you will be prompted for a descriptive " | |
2435 | "title." | |
2436 | msgstr "" | |
2437 | ||
2438 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2439 | #: apt-cdrom.8.xml:1 | |
2440 | msgid "" | |
2441 | "APT uses a CD-ROM ID to track which disc is currently in the drive and " | |
2442 | "maintains a database of these IDs in " | |
2443 | "<filename>&statedir;/cdroms.list</filename>" | |
2444 | msgstr "" | |
2445 | ||
2446 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2447 | #: apt-cdrom.8.xml:1 | |
2448 | msgid "" | |
2449 | "A debugging tool to report the identity of the current disc as well as the " | |
2450 | "stored file name" | |
2451 | msgstr "" | |
2452 | ||
2453 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2454 | #: apt-cdrom.8.xml:1 | |
2455 | msgid "" | |
2456 | "Do not try to auto-detect the CD-ROM path. Usually combined with the " | |
2457 | "<option>--cdrom</option> option. Configuration Item: " | |
2458 | "<literal>Acquire::cdrom::AutoDetect</literal>." | |
2459 | msgstr "" | |
2460 | ||
2461 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2462 | #: apt-cdrom.8.xml:1 | |
2463 | msgid "" | |
2464 | "Mount point; specify the location to mount the CD-ROM. This mount point must " | |
2465 | "be listed in <filename>/etc/fstab</filename> and properly configured. " | |
2466 | "Configuration Item: <literal>Acquire::cdrom::mount</literal>." | |
2467 | msgstr "" | |
2468 | ||
2469 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2470 | #: apt-cdrom.8.xml:1 | |
2471 | msgid "" | |
2472 | "Rename a disc; change the label of a disc or override the disc's given " | |
2473 | "label. This option will cause <command>apt-cdrom</command> to prompt for a " | |
2474 | "new label. Configuration Item: <literal>APT::CDROM::Rename</literal>." | |
2475 | msgstr "" | |
2476 | ||
2477 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2478 | #: apt-cdrom.8.xml:1 | |
2479 | msgid "" | |
2480 | "No mounting; prevent <command>apt-cdrom</command> from mounting and " | |
2481 | "unmounting the mount point. Configuration Item: " | |
2482 | "<literal>APT::CDROM::NoMount</literal>." | |
2483 | msgstr "" | |
2484 | ||
2485 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2486 | #: apt-cdrom.8.xml:1 | |
2487 | msgid "" | |
2488 | "Fast Copy; Assume the package files are valid and do not check every " | |
2489 | "package. This option should be used only if <command>apt-cdrom</command> has " | |
2490 | "been run on this disc before and did not detect any errors. Configuration " | |
2491 | "Item: <literal>APT::CDROM::Fast</literal>." | |
2492 | msgstr "" | |
2493 | ||
2494 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2495 | #: apt-cdrom.8.xml:1 | |
2496 | msgid "" | |
2497 | "Thorough Package Scan; This option may be needed with some old Debian " | |
2498 | "1.1/1.2 discs that have Package files in strange places. It takes much " | |
2499 | "longer to scan the CD but will pick them all up." | |
2500 | msgstr "" | |
2501 | ||
2502 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2503 | #: apt-cdrom.8.xml:1 | |
2504 | msgid "" | |
2505 | "No Changes; Do not change the &sources-list; file and do not write index " | |
2506 | "files. Everything is still checked however. Configuration Item: " | |
2507 | "<literal>APT::CDROM::NoAct</literal>." | |
2508 | msgstr "" | |
2509 | ||
2510 | #. type: Content of: <refentry><refsect1><para> | |
2511 | #: apt-cdrom.8.xml:1 | |
2512 | msgid "&apt-conf;, &apt-get;, &sources-list;" | |
2513 | msgstr "" | |
2514 | ||
2515 | #. type: Content of: <refentry><refsect1><para> | |
2516 | #: apt-cdrom.8.xml:1 | |
2517 | msgid "" | |
2518 | "<command>apt-cdrom</command> returns zero on normal operation, decimal 100 " | |
2519 | "on error." | |
2520 | msgstr "" | |
2521 | ||
2522 | #. type: Content of: <refentry><refnamediv><refpurpose> | |
2523 | #: apt-config.8.xml:1 | |
2524 | msgid "APT Configuration Query program" | |
2525 | msgstr "" | |
2526 | ||
2527 | #. type: Content of: <refentry><refsect1><para> | |
2528 | #: apt-config.8.xml:1 | |
2529 | msgid "" | |
2530 | "<command>apt-config</command> is an internal program used by various " | |
2531 | "portions of the APT suite to provide consistent configurability. It accesses " | |
2532 | "the main configuration file <filename>/etc/apt/apt.conf</filename> in a " | |
2533 | "manner that is easy to use for scripted applications." | |
2534 | msgstr "" | |
2535 | ||
2536 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2537 | #: apt-config.8.xml:1 | |
2538 | msgid "" | |
2539 | "shell is used to access the configuration information from a shell " | |
2540 | "script. It is given pairs of arguments, the first being a shell variable and " | |
2541 | "the second the configuration value to query. As output it lists shell " | |
2542 | "assignment commands for each value present. In a shell script it should be " | |
2543 | "used as follows:" | |
2544 | msgstr "" | |
2545 | ||
2546 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting> | |
2547 | #: apt-config.8.xml:1 | |
2548 | #, no-wrap | |
2549 | msgid "" | |
2550 | "OPTS=\"-f\"\n" | |
2551 | "RES=`apt-config shell OPTS MyApp::options`\n" | |
2552 | "eval $RES\n" | |
2553 | msgstr "" | |
2554 | ||
2555 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2556 | #: apt-config.8.xml:1 | |
2557 | msgid "" | |
2558 | "This will set the shell environment variable $OPTS to the value of " | |
2559 | "MyApp::options with a default of <option>-f</option>." | |
2560 | msgstr "" | |
2561 | ||
2562 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2563 | #: apt-config.8.xml:1 | |
2564 | msgid "" | |
2565 | "The configuration item may be postfixed with a /[fdbi]. f returns file " | |
2566 | "names, d returns directories, b returns true or false and i returns an " | |
2567 | "integer. Each of the returns is normalized and verified internally." | |
2568 | msgstr "" | |
2569 | ||
2570 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2571 | #: apt-config.8.xml:1 | |
2572 | msgid "Just show the contents of the configuration space." | |
2573 | msgstr "" | |
2574 | ||
2575 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2576 | #: apt-config.8.xml:1 | |
2577 | msgid "" | |
2578 | "Include options which have an empty value. This is the default, so use " | |
2579 | "--no-empty to remove them from the output." | |
2580 | msgstr "" | |
2581 | ||
2582 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term><option><replaceable> | |
2583 | #: apt-config.8.xml:1 | |
2584 | msgid "%f "%v";%n" | |
2585 | msgstr "" | |
2586 | ||
2587 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2588 | #: apt-config.8.xml:1 | |
2589 | msgid "" | |
2590 | "Defines the output of each config option. %t will be replaced with " | |
2591 | "its individual name, %f with its full hierarchical name and %v " | |
2592 | "with its value. Use uppercase letters and special characters in the value " | |
2593 | "will be encoded to ensure that it can e.g. be safely used in a quoted-string " | |
2594 | "as defined by RFC822. Additionally %n will be replaced by a newline, " | |
2595 | "and %N by a tab. A % can be printed by using %%." | |
2596 | msgstr "" | |
2597 | ||
2598 | #. type: Content of: <refentry><refsect1><para> | |
2599 | #: apt-config.8.xml:1 apt-extracttemplates.1.xml:1 apt-sortpkgs.1.xml:1 | |
2600 | #: apt-ftparchive.1.xml:1 | |
2601 | msgid "&apt-conf;" | |
2602 | msgstr "" | |
2603 | ||
2604 | #. type: Content of: <refentry><refsect1><para> | |
2605 | #: apt-config.8.xml:1 | |
2606 | msgid "" | |
2607 | "<command>apt-config</command> returns zero on normal operation, decimal 100 " | |
2608 | "on error." | |
2609 | msgstr "" | |
2610 | ||
2611 | #. type: Content of: <refentry><refentryinfo><author><contrib> | |
2612 | #: apt.conf.5.xml:1 | |
2613 | msgid "Initial documentation of Debug::*." | |
2614 | msgstr "" | |
2615 | ||
2616 | #. type: Content of: <refentry><refentryinfo><author><email> | |
2617 | #: apt.conf.5.xml:1 | |
2618 | msgid "dburrows@debian.org" | |
2619 | msgstr "" | |
2620 | ||
2621 | #. type: Content of: <refentry><refmeta><manvolnum> | |
2622 | #: apt.conf.5.xml:1 apt_preferences.5.xml:1 sources.list.5.xml:1 | |
2623 | msgid "5" | |
2624 | msgstr "" | |
2625 | ||
2626 | #. type: Content of: <refentry><refnamediv><refpurpose> | |
2627 | #: apt.conf.5.xml:1 | |
2628 | msgid "Configuration file for APT" | |
2629 | msgstr "" | |
2630 | ||
2631 | #. type: Content of: <refentry><refsect1><para> | |
2632 | #: apt.conf.5.xml:1 | |
2633 | msgid "" | |
2634 | "<filename>/etc/apt/apt.conf</filename> is the main configuration file shared " | |
2635 | "by all the tools in the APT suite of tools, though it is by no means the " | |
2636 | "only place options can be set. The suite also shares a common command line " | |
2637 | "parser to provide a uniform environment." | |
2638 | msgstr "" | |
2639 | ||
2640 | #. type: Content of: <refentry><refsect1><orderedlist><para> | |
2641 | #: apt.conf.5.xml:1 | |
2642 | msgid "" | |
2643 | "When an APT tool starts up it will read the configuration files in the " | |
2644 | "following order:" | |
2645 | msgstr "" | |
2646 | ||
2647 | #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> | |
2648 | #: apt.conf.5.xml:1 | |
2649 | msgid "" | |
2650 | "the file specified by the <envar>APT_CONFIG</envar> environment variable (if " | |
2651 | "any)" | |
2652 | msgstr "" | |
2653 | ||
2654 | #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> | |
2655 | #: apt.conf.5.xml:1 | |
2656 | msgid "" | |
2657 | "all files in <literal>Dir::Etc::Parts</literal> in alphanumeric ascending " | |
2658 | "order which have either no or \"<literal>conf</literal>\" as filename " | |
2659 | "extension and which only contain alphanumeric, hyphen (-), underscore (_) " | |
2660 | "and period (.) characters. Otherwise APT will print a notice that it has " | |
2661 | "ignored a file, unless that file matches a pattern in the " | |
2662 | "<literal>Dir::Ignore-Files-Silently</literal> configuration list - in which " | |
2663 | "case it will be silently ignored." | |
2664 | msgstr "" | |
2665 | ||
2666 | #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> | |
2667 | #: apt.conf.5.xml:1 | |
2668 | msgid "the main configuration file specified by <literal>Dir::Etc::main</literal>" | |
2669 | msgstr "" | |
2670 | ||
2671 | #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> | |
2672 | #: apt.conf.5.xml:1 | |
2673 | msgid "" | |
2674 | "all options set in the binary specific configuration subtree are moved into " | |
2675 | "the root of the tree." | |
2676 | msgstr "" | |
2677 | ||
2678 | #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> | |
2679 | #: apt.conf.5.xml:1 | |
2680 | msgid "" | |
2681 | "the command line options are applied to override the configuration " | |
2682 | "directives or to load even more configuration files." | |
2683 | msgstr "" | |
2684 | ||
2685 | #. type: Content of: <refentry><refsect1><title> | |
2686 | #: apt.conf.5.xml:1 | |
2687 | msgid "Syntax" | |
2688 | msgstr "" | |
2689 | ||
2690 | #. type: Content of: <refentry><refsect1><para> | |
2691 | #: apt.conf.5.xml:1 | |
2692 | msgid "" | |
2693 | "The configuration file is organized in a tree with options organized into " | |
2694 | "functional groups. Option specification is given with a double colon " | |
2695 | "notation; for instance <literal>APT::Get::Assume-Yes</literal> is an option " | |
2696 | "within the APT tool group, for the Get tool. Options do not inherit from " | |
2697 | "their parent groups." | |
2698 | msgstr "" | |
2699 | ||
2700 | #. type: Content of: <refentry><refsect1><para> | |
2701 | #: apt.conf.5.xml:1 | |
2702 | msgid "" | |
2703 | "Syntactically the configuration language is modeled after what the ISC tools " | |
2704 | "such as bind and dhcp use. Lines starting with <literal>//</literal> are " | |
2705 | "treated as comments (ignored), as well as all text between " | |
2706 | "<literal>/*</literal> and <literal>*/</literal>, just like C/C++ comments. " | |
2707 | "Each line is of the form <literal>APT::Get::Assume-Yes \"true\";</literal>. " | |
2708 | "The quotation marks and trailing semicolon are required. The value must be " | |
2709 | "on one line, and there is no kind of string concatenation. Values must not " | |
2710 | "include backslashes or extra quotation marks. Option names are made up of " | |
2711 | "alphanumeric characters and the characters \"/-:._+\". A new scope can be " | |
2712 | "opened with curly braces, like this:" | |
2713 | msgstr "" | |
2714 | ||
2715 | #. type: Content of: <refentry><refsect1><informalexample><programlisting> | |
2716 | #: apt.conf.5.xml:1 | |
2717 | #, no-wrap | |
2718 | msgid "" | |
2719 | "APT {\n" | |
2720 | " Get {\n" | |
2721 | " Assume-Yes \"true\";\n" | |
2722 | " Fix-Broken \"true\";\n" | |
2723 | " };\n" | |
2724 | "};\n" | |
2725 | msgstr "" | |
2726 | ||
2727 | #. type: Content of: <refentry><refsect1><para> | |
2728 | #: apt.conf.5.xml:1 | |
2729 | msgid "" | |
2730 | "with newlines placed to make it more readable. Lists can be created by " | |
2731 | "opening a scope and including a single string enclosed in quotes followed by " | |
2732 | "a semicolon. Multiple entries can be included, separated by a semicolon." | |
2733 | msgstr "" | |
2734 | ||
2735 | #. type: Content of: <refentry><refsect1><informalexample><programlisting> | |
2736 | #: apt.conf.5.xml:1 | |
2737 | #, no-wrap | |
2738 | msgid "DPkg::Pre-Install-Pkgs {\"/usr/sbin/dpkg-preconfigure --apt\";};\n" | |
2739 | msgstr "" | |
2740 | ||
2741 | #. type: Content of: <refentry><refsect1><para> | |
2742 | #: apt.conf.5.xml:1 | |
2743 | msgid "" | |
2744 | "In general the sample configuration file &configureindex; is a good guide " | |
2745 | "for how it should look." | |
2746 | msgstr "" | |
2747 | ||
2748 | #. type: Content of: <refentry><refsect1><para> | |
2749 | #: apt.conf.5.xml:1 | |
2750 | msgid "" | |
2751 | "Case is not significant in names of configuration items, so in the previous " | |
2752 | "example you could use <literal>dpkg::pre-install-pkgs</literal>." | |
2753 | msgstr "" | |
2754 | ||
2755 | #. type: Content of: <refentry><refsect1><para> | |
2756 | #: apt.conf.5.xml:1 | |
2757 | msgid "" | |
2758 | "Names for the configuration items are optional if a list is defined as can " | |
2759 | "be seen in the <literal>DPkg::Pre-Install-Pkgs</literal> example above. If " | |
2760 | "you don't specify a name a new entry will simply add a new option to the " | |
2761 | "list. If you specify a name you can override the option in the same way as " | |
2762 | "any other option by reassigning a new value to the option." | |
2763 | msgstr "" | |
2764 | ||
2765 | #. type: Content of: <refentry><refsect1><para> | |
2766 | #: apt.conf.5.xml:1 | |
2767 | msgid "" | |
2768 | "Two special commands are defined: <literal>#include</literal> (which is " | |
2769 | "deprecated and not supported by alternative implementations) and " | |
2770 | "<literal>#clear</literal>. <literal>#include</literal> will include the " | |
2771 | "given file, unless the filename ends in a slash, in which case the whole " | |
2772 | "directory is included. <literal>#clear</literal> is used to erase a part of " | |
2773 | "the configuration tree. The specified element and all its descendants are " | |
2774 | "erased. (Note that these lines also need to end with a semicolon.)" | |
2775 | msgstr "" | |
2776 | ||
2777 | #. type: Content of: <refentry><refsect1><para> | |
2778 | #: apt.conf.5.xml:1 | |
2779 | msgid "" | |
2780 | "The <literal>#clear</literal> command is the only way to delete a list or a " | |
2781 | "complete scope. Reopening a scope (or using the syntax described below with " | |
2782 | "an appended <literal>::</literal>) will <emphasis>not</emphasis> override " | |
2783 | "previously written entries. Options can only be overridden by addressing a " | |
2784 | "new value to them - lists and scopes can't be overridden, only cleared." | |
2785 | msgstr "" | |
2786 | ||
2787 | #. type: Content of: <refentry><refsect1><para> | |
2788 | #: apt.conf.5.xml:1 | |
2789 | msgid "" | |
2790 | "All of the APT tools take an -o option which allows an arbitrary " | |
2791 | "configuration directive to be specified on the command line. The syntax is a " | |
2792 | "full option name (<literal>APT::Get::Assume-Yes</literal> for instance) " | |
2793 | "followed by an equals sign then the new value of the option. To append a new " | |
2794 | "element to a list, add a trailing <literal>::</literal> to the name of the " | |
2795 | "list. (As you might suspect, the scope syntax can't be used on the command " | |
2796 | "line.)" | |
2797 | msgstr "" | |
2798 | ||
2799 | #. type: Content of: <refentry><refsect1><para> | |
2800 | #: apt.conf.5.xml:1 | |
2801 | msgid "" | |
2802 | "Note that appending items to a list using <literal>::</literal> only works " | |
2803 | "for one item per line, and that you should not use it in combination with " | |
2804 | "the scope syntax (which adds <literal>::</literal> implicitly). Using both " | |
2805 | "syntaxes together will trigger a bug which some users unfortunately depend " | |
2806 | "on: an option with the unusual name \"<literal>::</literal>\" which acts " | |
2807 | "like every other option with a name. This introduces many problems; for one " | |
2808 | "thing, users who write multiple lines in this <emphasis>wrong</emphasis> " | |
2809 | "syntax in the hope of appending to a list will achieve the opposite, as only " | |
2810 | "the last assignment for this option \"<literal>::</literal>\" will be " | |
2811 | "used. Future versions of APT will raise errors and stop working if they " | |
2812 | "encounter this misuse, so please correct such statements now while APT " | |
2813 | "doesn't explicitly complain about them." | |
2814 | msgstr "" | |
2815 | ||
2816 | #. type: Content of: <refentry><refsect1><title> | |
2817 | #: apt.conf.5.xml:1 | |
2818 | msgid "The APT Group" | |
2819 | msgstr "" | |
2820 | ||
2821 | #. type: Content of: <refentry><refsect1><para> | |
2822 | #: apt.conf.5.xml:1 | |
2823 | msgid "" | |
2824 | "This group of options controls general APT behavior as well as holding the " | |
2825 | "options for all of the tools." | |
2826 | msgstr "" | |
2827 | ||
2828 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2829 | #: apt.conf.5.xml:1 | |
2830 | msgid "" | |
2831 | "System Architecture; sets the architecture to use when fetching files and " | |
2832 | "parsing package lists. The internal default is the architecture apt was " | |
2833 | "compiled for." | |
2834 | msgstr "" | |
2835 | ||
2836 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2837 | #: apt.conf.5.xml:1 | |
2838 | msgid "" | |
2839 | "All Architectures the system supports. For instance, CPUs implementing the " | |
2840 | "<literal>amd64</literal> (also called <literal>x86-64</literal>) " | |
2841 | "instruction set are also able to execute binaries compiled for the " | |
2842 | "<literal>i386</literal> (<literal>x86</literal>) instruction set. This list " | |
2843 | "is used when fetching files and parsing package lists. The initial default " | |
2844 | "is always the system's native architecture " | |
2845 | "(<literal>APT::Architecture</literal>), and foreign architectures are added " | |
2846 | "to the default list when they are registered via <command>dpkg " | |
2847 | "--add-architecture</command>." | |
2848 | msgstr "" | |
2849 | ||
2850 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2851 | #: apt.conf.5.xml:1 | |
2852 | msgid "" | |
2853 | "List of all build profiles enabled for build-dependency resolution, without " | |
2854 | "the \"<literal>profile.</literal>\" namespace prefix. By default this list " | |
2855 | "is empty. The <envar>DEB_BUILD_PROFILES</envar> as used by " | |
2856 | "&dpkg-buildpackage; overrides the list notation." | |
2857 | msgstr "" | |
2858 | ||
2859 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2860 | #: apt.conf.5.xml:1 | |
2861 | msgid "" | |
2862 | "Default release to install packages from if more than one version is " | |
2863 | "available. Contains release name, codename or release version. Examples: " | |
2864 | "'stable', 'testing', 'unstable', '&stable-codename;', '&testing-codename;', " | |
2865 | "'4.0', '5.0*'. See also &apt-preferences;." | |
2866 | msgstr "" | |
2867 | ||
2868 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2869 | #: apt.conf.5.xml:1 | |
2870 | msgid "" | |
2871 | "Ignore held packages; this global option causes the problem resolver to " | |
2872 | "ignore held packages in its decision making." | |
2873 | msgstr "" | |
2874 | ||
2875 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2876 | #: apt.conf.5.xml:1 | |
2877 | msgid "" | |
2878 | "Defaults to on. When turned on the autoclean feature will remove any " | |
2879 | "packages which can no longer be downloaded from the cache. If turned off " | |
2880 | "then packages that are locally installed are also excluded from cleaning - " | |
2881 | "but note that APT provides no direct means to reinstall them." | |
2882 | msgstr "" | |
2883 | ||
2884 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2885 | #: apt.conf.5.xml:1 | |
2886 | msgid "" | |
2887 | "Defaults to on, which will cause APT to install essential and important " | |
2888 | "packages as soon as possible in an install/upgrade operation, in order to " | |
2889 | "limit the effect of a failing &dpkg; call. If this option is disabled, APT " | |
2890 | "treats an important package in the same way as an extra package: between the " | |
2891 | "unpacking of the package A and its configuration there can be many other " | |
2892 | "unpack or configuration calls for other unrelated packages B, C etc. If " | |
2893 | "these cause the &dpkg; call to fail (e.g. because package B's maintainer " | |
2894 | "scripts generate an error), this results in a system state in which package " | |
2895 | "A is unpacked but unconfigured - so any package depending on A is now no " | |
2896 | "longer guaranteed to work, as its dependency on A is no longer satisfied." | |
2897 | msgstr "" | |
2898 | ||
2899 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2900 | #: apt.conf.5.xml:1 | |
2901 | msgid "" | |
2902 | "The immediate configuration marker is also applied in the potentially " | |
2903 | "problematic case of circular dependencies, since a dependency with the " | |
2904 | "immediate flag is equivalent to a Pre-Dependency. In theory this allows APT " | |
2905 | "to recognise a situation in which it is unable to perform immediate " | |
2906 | "configuration, abort, and suggest to the user that the option should be " | |
2907 | "temporarily deactivated in order to allow the operation to proceed. Note " | |
2908 | "the use of the word \"theory\" here; in the real world this problem has " | |
2909 | "rarely been encountered, in non-stable distribution versions, and was caused " | |
2910 | "by wrong dependencies of the package in question or by a system in an " | |
2911 | "already broken state; so you should not blindly disable this option, as the " | |
2912 | "scenario mentioned above is not the only problem it can help to prevent in " | |
2913 | "the first place." | |
2914 | msgstr "" | |
2915 | ||
2916 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2917 | #: apt.conf.5.xml:1 | |
2918 | msgid "" | |
2919 | "Before a big operation like <literal>dist-upgrade</literal> is run with this " | |
2920 | "option disabled you should try to explicitly <literal>install</literal> the " | |
2921 | "package APT is unable to configure immediately; but please make sure you " | |
2922 | "also report your problem to your distribution and to the APT team with the " | |
2923 | "buglink below, so they can work on improving or correcting the upgrade " | |
2924 | "process." | |
2925 | msgstr "" | |
2926 | ||
2927 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2928 | #: apt.conf.5.xml:1 | |
2929 | msgid "" | |
2930 | "Never enable this option unless you <emphasis>really</emphasis> know what " | |
2931 | "you are doing. It permits APT to temporarily remove an essential package to " | |
2932 | "break a Conflicts/Conflicts or Conflicts/Pre-Depends loop between two " | |
2933 | "essential packages. <emphasis>Such a loop should never exist and is a grave " | |
2934 | "bug</emphasis>. This option will work if the essential packages are not " | |
2935 | "<command>tar</command>, <command>gzip</command>, <command>libc</command>, " | |
2936 | "<command>dpkg</command>, <command>dash</command> or anything that those " | |
2937 | "packages depend on." | |
2938 | msgstr "" | |
2939 | ||
2940 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2941 | #: apt.conf.5.xml:1 | |
2942 | msgid "" | |
2943 | "APT uses since version 0.7.26 a resizable memory mapped cache file to store " | |
2944 | "the available information. <literal>Cache-Start</literal> acts as a hint of " | |
2945 | "the size the cache will grow to, and is therefore the amount of memory APT " | |
2946 | "will request at startup. The default value is 20971520 bytes (~20 MB). Note " | |
2947 | "that this amount of space needs to be available for APT; otherwise it will " | |
2948 | "likely fail ungracefully, so for memory restricted devices this value should " | |
2949 | "be lowered while on systems with a lot of configured sources it should be " | |
2950 | "increased. <literal>Cache-Grow</literal> defines in bytes with the default " | |
2951 | "of 1048576 (~1 MB) how much the cache size will be increased in the event " | |
2952 | "the space defined by <literal>Cache-Start</literal> is not enough. This " | |
2953 | "value will be applied again and again until either the cache is big enough " | |
2954 | "to store all information or the size of the cache reaches the " | |
2955 | "<literal>Cache-Limit</literal>. The default of " | |
2956 | "<literal>Cache-Limit</literal> is 0 which stands for no limit. If " | |
2957 | "<literal>Cache-Grow</literal> is set to 0 the automatic growth of the cache " | |
2958 | "is disabled." | |
2959 | msgstr "" | |
2960 | ||
2961 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2962 | #: apt.conf.5.xml:1 | |
2963 | msgid "Defines which packages are considered essential build dependencies." | |
2964 | msgstr "" | |
2965 | ||
2966 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2967 | #: apt.conf.5.xml:1 | |
2968 | msgid "" | |
2969 | "The Get subsection controls the &apt-get; tool; please see its documentation " | |
2970 | "for more information about the options here." | |
2971 | msgstr "" | |
2972 | ||
2973 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2974 | #: apt.conf.5.xml:1 | |
2975 | msgid "" | |
2976 | "The Cache subsection controls the &apt-cache; tool; please see its " | |
2977 | "documentation for more information about the options here." | |
2978 | msgstr "" | |
2979 | ||
2980 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
2981 | #: apt.conf.5.xml:1 | |
2982 | msgid "" | |
2983 | "The CDROM subsection controls the &apt-cdrom; tool; please see its " | |
2984 | "documentation for more information about the options here." | |
2985 | msgstr "" | |
2986 | ||
2987 | #. type: Content of: <refentry><refsect1><title> | |
2988 | #: apt.conf.5.xml:1 | |
2989 | msgid "The Acquire Group" | |
2990 | msgstr "" | |
2991 | ||
2992 | #. type: Content of: <refentry><refsect1><para> | |
2993 | #: apt.conf.5.xml:1 | |
2994 | msgid "" | |
2995 | "The <literal>Acquire</literal> group of options controls the download of " | |
2996 | "packages as well as the various \"acquire methods\" responsible for the " | |
2997 | "download itself (see also &sources-list;)." | |
2998 | msgstr "" | |
2999 | ||
3000 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3001 | #: apt.conf.5.xml:1 | |
3002 | msgid "" | |
3003 | "Security related option defaulting to true, as giving a Release file's " | |
3004 | "validation an expiration date prevents replay attacks over a long timescale, " | |
3005 | "and can also for example help users to identify mirrors that are no longer " | |
3006 | "updated - but the feature depends on the correctness of the clock on the " | |
3007 | "user system. Archive maintainers are encouraged to create Release files with " | |
3008 | "the <literal>Valid-Until</literal> header, but if they don't or a stricter " | |
3009 | "value is desired the <literal>Max-ValidTime</literal> option below can be " | |
3010 | "used. The <option>Check-Valid-Until</option> option of &sources-list; " | |
3011 | "entries should be preferred to disable the check selectively instead of " | |
3012 | "using this global override." | |
3013 | msgstr "" | |
3014 | ||
3015 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3016 | #: apt.conf.5.xml:1 | |
3017 | msgid "" | |
3018 | "Maximum time (in seconds) after its creation (as indicated by the " | |
3019 | "<literal>Date</literal> header) that the <filename>Release</filename> file " | |
3020 | "should be considered valid. If the Release file itself includes a " | |
3021 | "<literal>Valid-Until</literal> header the earlier date of the two is used as " | |
3022 | "the expiration date. The default value is <literal>0</literal> which stands " | |
3023 | "for \"valid forever\". Archive specific settings can be made by appending " | |
3024 | "the label of the archive to the option name. Preferably, the same can be " | |
3025 | "achieved for specific &sources-list; entries by using the " | |
3026 | "<option>Valid-Until-Max</option> option there." | |
3027 | msgstr "" | |
3028 | ||
3029 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3030 | #: apt.conf.5.xml:1 | |
3031 | msgid "" | |
3032 | "Minimum time (in seconds) after its creation (as indicated by the " | |
3033 | "<literal>Date</literal> header) that the <filename>Release</filename> file " | |
3034 | "should be considered valid. Use this if you need to use a seldom updated " | |
3035 | "(local) mirror of a more frequently updated archive with a " | |
3036 | "<literal>Valid-Until</literal> header instead of completely disabling the " | |
3037 | "expiration date checking. Archive specific settings can and should be used " | |
3038 | "by appending the label of the archive to the option name. Preferably, the " | |
3039 | "same can be achieved for specific &sources-list; entries by using the " | |
3040 | "<option>Valid-Until-Min</option> option there." | |
3041 | msgstr "" | |
3042 | ||
3043 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3044 | #: apt.conf.5.xml:1 | |
3045 | msgid "" | |
3046 | "Try to download deltas called <literal>PDiffs</literal> for indexes (like " | |
3047 | "<filename>Packages</filename> files) instead of downloading whole ones. True " | |
3048 | "by default. Preferably, this can be set for specific &sources-list; entries " | |
3049 | "or index files by using the <option>PDiffs</option> option there." | |
3050 | msgstr "" | |
3051 | ||
3052 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3053 | #: apt.conf.5.xml:1 | |
3054 | msgid "" | |
3055 | "Two sub-options to limit the use of PDiffs are also available: " | |
3056 | "<literal>FileLimit</literal> can be used to specify a maximum number of " | |
3057 | "PDiff files should be downloaded to update a " | |
3058 | "file. <literal>SizeLimit</literal> on the other hand is the maximum " | |
3059 | "percentage of the size of all patches compared to the size of the targeted " | |
3060 | "file. If one of these limits is exceeded the complete file is downloaded " | |
3061 | "instead of the patches." | |
3062 | msgstr "" | |
3063 | ||
3064 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3065 | #: apt.conf.5.xml:1 | |
3066 | msgid "" | |
3067 | "Try to download indexes via an URI constructed from a hashsum of the " | |
3068 | "expected file rather than downloaded via a well-known stable filename. True " | |
3069 | "by default, but automatically disabled if the source indicates no support " | |
3070 | "for it. Usage can be forced with the special value \"force\". Preferably, " | |
3071 | "this can be set for specific &sources-list; entries or index files by using " | |
3072 | "the <option>By-Hash</option> option there." | |
3073 | msgstr "" | |
3074 | ||
3075 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3076 | #: apt.conf.5.xml:1 | |
3077 | msgid "" | |
3078 | "Queuing mode; <literal>Queue-Mode</literal> can be one of " | |
3079 | "<literal>host</literal> or <literal>access</literal> which determines how " | |
3080 | "APT parallelizes outgoing connections. <literal>host</literal> means that " | |
3081 | "one connection per target host will be opened, <literal>access</literal> " | |
3082 | "means that one connection per URI type will be opened." | |
3083 | msgstr "" | |
3084 | ||
3085 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3086 | #: apt.conf.5.xml:1 | |
3087 | msgid "" | |
3088 | "Number of retries to perform. If this is non-zero APT will retry failed " | |
3089 | "files the given number of times." | |
3090 | msgstr "" | |
3091 | ||
3092 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3093 | #: apt.conf.5.xml:1 | |
3094 | msgid "" | |
3095 | "Use symlinks for source archives. If set to true then source archives will " | |
3096 | "be symlinked when possible instead of copying. True is the default." | |
3097 | msgstr "" | |
3098 | ||
3099 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3100 | #: apt.conf.5.xml:1 | |
3101 | msgid "" | |
3102 | "<literal>http::Proxy</literal> sets the default proxy to use for HTTP " | |
3103 | "URIs. It is in the standard form of " | |
3104 | "<literal>http://[[user][:pass]@]host[:port]/</literal>. Per host proxies " | |
3105 | "can also be specified by using the form " | |
3106 | "<literal>http::Proxy::<host></literal> with the special keyword " | |
3107 | "<literal>DIRECT</literal> meaning to use no proxies. If no one of the above " | |
3108 | "settings is specified, <envar>http_proxy</envar> environment variable will " | |
3109 | "be used." | |
3110 | msgstr "" | |
3111 | ||
3112 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3113 | #: apt.conf.5.xml:1 | |
3114 | msgid "" | |
3115 | "Three settings are provided for cache control with HTTP/1.1 compliant proxy " | |
3116 | "caches. <literal>No-Cache</literal> tells the proxy not to use its cached " | |
3117 | "response under any circumstances. <literal>Max-Age</literal> sets the " | |
3118 | "allowed maximum age (in seconds) of an index file in the cache of the " | |
3119 | "proxy. <literal>No-Store</literal> specifies that the proxy should not " | |
3120 | "store the requested archive files in its cache, which can be used to prevent " | |
3121 | "the proxy from polluting its cache with (big) .deb files." | |
3122 | msgstr "" | |
3123 | ||
3124 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3125 | #: apt.conf.5.xml:1 apt.conf.5.xml:1 | |
3126 | msgid "" | |
3127 | "The option <literal>timeout</literal> sets the timeout timer used by the " | |
3128 | "method; this value applies to the connection as well as the data timeout." | |
3129 | msgstr "" | |
3130 | ||
3131 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3132 | #: apt.conf.5.xml:1 | |
3133 | msgid "" | |
3134 | "The setting <literal>Acquire::http::Pipeline-Depth</literal> can be used to " | |
3135 | "enable HTTP pipelining (RFC 2616 section 8.1.2.2) which can be beneficial " | |
3136 | "e.g. on high-latency connections. It specifies how many requests are sent in " | |
3137 | "a pipeline. APT tries to detect and workaround misbehaving webservers and " | |
3138 | "proxies at runtime, but if you know that yours does not conform to the " | |
3139 | "HTTP/1.1 specification pipelining can be disabled by setting the value to " | |
3140 | "0. It is enabled by default with the value 10." | |
3141 | msgstr "" | |
3142 | ||
3143 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3144 | #: apt.conf.5.xml:1 | |
3145 | msgid "" | |
3146 | "<literal>Acquire::http::AllowRedirect</literal> controls whether APT will " | |
3147 | "follow redirects, which is enabled by default." | |
3148 | msgstr "" | |
3149 | ||
3150 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3151 | #: apt.conf.5.xml:1 | |
3152 | msgid "" | |
3153 | "The used bandwidth can be limited with " | |
3154 | "<literal>Acquire::http::Dl-Limit</literal> which accepts integer values in " | |
3155 | "kilobytes per second. The default value is 0 which deactivates the limit and " | |
3156 | "tries to use all available bandwidth. Note that this option implicitly " | |
3157 | "disables downloading from multiple servers at the same time." | |
3158 | msgstr "" | |
3159 | ||
3160 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3161 | #: apt.conf.5.xml:1 | |
3162 | msgid "" | |
3163 | "<literal>Acquire::http::User-Agent</literal> can be used to set a different " | |
3164 | "User-Agent for the http download method as some proxies allow access for " | |
3165 | "clients only if the client uses a known identifier." | |
3166 | msgstr "" | |
3167 | ||
3168 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3169 | #: apt.conf.5.xml:1 | |
3170 | msgid "" | |
3171 | "<literal>Acquire::http::Proxy-Auto-Detect</literal> can be used to specify " | |
3172 | "an external command to discover the http proxy to use. Apt expects the " | |
3173 | "command to output the proxy on stdout in the style " | |
3174 | "<literal>http://proxy:port/</literal>. This will override the generic " | |
3175 | "<literal>Acquire::http::Proxy</literal> but not any specific host proxy " | |
3176 | "configuration set via <literal>Acquire::http::Proxy::$HOST</literal>. See " | |
3177 | "the &squid-deb-proxy-client; package for an example implementation that uses " | |
3178 | "avahi. This option takes precedence over the legacy option name " | |
3179 | "<literal>ProxyAutoDetect</literal>." | |
3180 | msgstr "" | |
3181 | ||
3182 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3183 | #: apt.conf.5.xml:1 | |
3184 | msgid "" | |
3185 | "The <literal>Cache-control</literal>, <literal>Timeout</literal>, " | |
3186 | "<literal>AllowRedirect</literal>, <literal>Dl-Limit</literal> and " | |
3187 | "<literal>proxy</literal> options work for HTTPS URIs in the same way as for " | |
3188 | "the <literal>http</literal> method, and default to the same values if they " | |
3189 | "are not explicitly set. The <literal>Pipeline-Depth</literal> option is not " | |
3190 | "yet supported." | |
3191 | msgstr "" | |
3192 | ||
3193 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3194 | #: apt.conf.5.xml:1 | |
3195 | msgid "" | |
3196 | "<literal>CaInfo</literal> suboption specifies place of file that holds info " | |
3197 | "about trusted certificates. <literal><host>::CaInfo</literal> is the " | |
3198 | "corresponding per-host option. <literal>Verify-Peer</literal> boolean " | |
3199 | "suboption determines whether or not the server's host certificate should be " | |
3200 | "verified against trusted certificates. " | |
3201 | "<literal><host>::Verify-Peer</literal> is the corresponding per-host " | |
3202 | "option. <literal>Verify-Host</literal> boolean suboption determines whether " | |
3203 | "or not the server's hostname should be verified. " | |
3204 | "<literal><host>::Verify-Host</literal> is the corresponding per-host " | |
3205 | "option. <literal>SslCert</literal> determines what certificate to use for " | |
3206 | "client authentication. <literal><host>::SslCert</literal> is the " | |
3207 | "corresponding per-host option. <literal>SslKey</literal> determines what " | |
3208 | "private key to use for client " | |
3209 | "authentication. <literal><host>::SslKey</literal> is the corresponding " | |
3210 | "per-host option. <literal>SslForceVersion</literal> overrides default SSL " | |
3211 | "version to use. It can contain either of the strings " | |
3212 | "'<literal>TLSv1</literal>' or '<literal>SSLv3</literal>'. " | |
3213 | "<literal><host>::SslForceVersion</literal> is the corresponding " | |
3214 | "per-host option." | |
3215 | msgstr "" | |
3216 | ||
3217 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3218 | #: apt.conf.5.xml:1 | |
3219 | msgid "" | |
3220 | "<literal>ftp::Proxy</literal> sets the default proxy to use for FTP URIs. " | |
3221 | "It is in the standard form of " | |
3222 | "<literal>ftp://[[user][:pass]@]host[:port]/</literal>. Per host proxies can " | |
3223 | "also be specified by using the form " | |
3224 | "<literal>ftp::Proxy::<host></literal> with the special keyword " | |
3225 | "<literal>DIRECT</literal> meaning to use no proxies. If no one of the above " | |
3226 | "settings is specified, <envar>ftp_proxy</envar> environment variable will be " | |
3227 | "used. To use an FTP proxy you will have to set the " | |
3228 | "<literal>ftp::ProxyLogin</literal> script in the configuration file. This " | |
3229 | "entry specifies the commands to send to tell the proxy server what to " | |
3230 | "connect to. Please see &configureindex; for an example of how to do " | |
3231 | "this. The substitution variables representing the corresponding URI " | |
3232 | "component are <literal>$(PROXY_USER)</literal>, " | |
3233 | "<literal>$(PROXY_PASS)</literal>, <literal>$(SITE_USER)</literal>, " | |
3234 | "<literal>$(SITE_PASS)</literal>, <literal>$(SITE)</literal> and " | |
3235 | "<literal>$(SITE_PORT)</literal>." | |
3236 | msgstr "" | |
3237 | ||
3238 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3239 | #: apt.conf.5.xml:1 | |
3240 | msgid "" | |
3241 | "Several settings are provided to control passive mode. Generally it is safe " | |
3242 | "to leave passive mode on; it works in nearly every environment. However, " | |
3243 | "some situations require that passive mode be disabled and port mode FTP used " | |
3244 | "instead. This can be done globally or for connections that go through a " | |
3245 | "proxy or for a specific host (see the sample config file for examples)." | |
3246 | msgstr "" | |
3247 | ||
3248 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3249 | #: apt.conf.5.xml:1 | |
3250 | msgid "" | |
3251 | "It is possible to proxy FTP over HTTP by setting the " | |
3252 | "<envar>ftp_proxy</envar> environment variable to an HTTP URL - see the " | |
3253 | "discussion of the http method above for syntax. You cannot set this in the " | |
3254 | "configuration file and it is not recommended to use FTP over HTTP due to its " | |
3255 | "low efficiency." | |
3256 | msgstr "" | |
3257 | ||
3258 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3259 | #: apt.conf.5.xml:1 | |
3260 | msgid "" | |
3261 | "The setting <literal>ForceExtended</literal> controls the use of RFC2428 " | |
3262 | "<literal>EPSV</literal> and <literal>EPRT</literal> commands. The default is " | |
3263 | "false, which means these commands are only used if the control connection is " | |
3264 | "IPv6. Setting this to true forces their use even on IPv4 connections. Note " | |
3265 | "that most FTP servers do not support RFC2428." | |
3266 | msgstr "" | |
3267 | ||
3268 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><literallayout> | |
3269 | #: apt.conf.5.xml:1 | |
3270 | #, no-wrap | |
3271 | msgid "/cdrom/::Mount \"foo\";" | |
3272 | msgstr "" | |
3273 | ||
3274 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3275 | #: apt.conf.5.xml:1 | |
3276 | msgid "" | |
3277 | "For URIs using the <literal>cdrom</literal> method, the only configurable " | |
3278 | "option is the mount point, <literal>cdrom::Mount</literal>, which must be " | |
3279 | "the mount point for the CD-ROM (or DVD, or whatever) drive as specified in " | |
3280 | "<filename>/etc/fstab</filename>. It is possible to provide alternate mount " | |
3281 | "and unmount commands if your mount point cannot be listed in the fstab. The " | |
3282 | "syntax is to put <placeholder type=\"literallayout\" id=\"0\"/> within the " | |
3283 | "<literal>cdrom</literal> block. It is important to have the trailing slash. " | |
3284 | "Unmount commands can be specified using UMount." | |
3285 | msgstr "" | |
3286 | ||
3287 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3288 | #: apt.conf.5.xml:1 | |
3289 | msgid "" | |
3290 | "For GPGV URIs the only configurable option is " | |
3291 | "<literal>gpgv::Options</literal>, which passes additional parameters to " | |
3292 | "gpgv." | |
3293 | msgstr "" | |
3294 | ||
3295 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><synopsis> | |
3296 | #: apt.conf.5.xml:1 | |
3297 | #, no-wrap | |
3298 | msgid "" | |
3299 | "Acquire::CompressionTypes::<replaceable>FileExtension</replaceable> " | |
3300 | "\"<replaceable>Methodname</replaceable>\";" | |
3301 | msgstr "" | |
3302 | ||
3303 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3304 | #: apt.conf.5.xml:1 | |
3305 | msgid "" | |
3306 | "List of compression types which are understood by the acquire methods. " | |
3307 | "Files like <filename>Packages</filename> can be available in various " | |
3308 | "compression formats. By default the acquire methods can decompress " | |
3309 | "<command>bzip2</command>, <command>lzma</command> and " | |
3310 | "<command>gzip</command> compressed files; with this setting more formats can " | |
3311 | "be added on the fly or the used method can be changed. The syntax for this " | |
3312 | "is: <placeholder type=\"synopsis\" id=\"0\"/>" | |
3313 | msgstr "" | |
3314 | ||
3315 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><synopsis> | |
3316 | #: apt.conf.5.xml:1 | |
3317 | #, no-wrap | |
3318 | msgid "Acquire::CompressionTypes::Order:: \"gz\";" | |
3319 | msgstr "" | |
3320 | ||
3321 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><synopsis> | |
3322 | #: apt.conf.5.xml:1 | |
3323 | #, no-wrap | |
3324 | msgid "Acquire::CompressionTypes::Order { \"lzma\"; \"gz\"; };" | |
3325 | msgstr "" | |
3326 | ||
3327 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3328 | #: apt.conf.5.xml:1 | |
3329 | msgid "" | |
3330 | "Also, the <literal>Order</literal> subgroup can be used to define in which " | |
3331 | "order the acquire system will try to download the compressed files. The " | |
3332 | "acquire system will try the first and proceed with the next compression type " | |
3333 | "in this list on error, so to prefer one over the other type simply add the " | |
3334 | "preferred type first - default types not already added will be implicitly " | |
3335 | "appended to the end of the list, so e.g. <placeholder type=\"synopsis\" " | |
3336 | "id=\"0\"/> can be used to prefer <command>gzip</command> compressed files " | |
3337 | "over <command>bzip2</command> and <command>lzma</command>. If " | |
3338 | "<command>lzma</command> should be preferred over <command>gzip</command> and " | |
3339 | "<command>bzip2</command> the configure setting should look like this: " | |
3340 | "<placeholder type=\"synopsis\" id=\"1\"/> It is not needed to add " | |
3341 | "<literal>bz2</literal> to the list explicitly as it will be added " | |
3342 | "automatically." | |
3343 | msgstr "" | |
3344 | ||
3345 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><literallayout> | |
3346 | #: apt.conf.5.xml:1 | |
3347 | #, no-wrap | |
3348 | msgid "Dir::Bin::bzip2 \"/bin/bzip2\";" | |
3349 | msgstr "" | |
3350 | ||
3351 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3352 | #: apt.conf.5.xml:1 | |
3353 | msgid "" | |
3354 | "Note that the " | |
3355 | "<literal>Dir::Bin::<replaceable>Methodname</replaceable></literal> will be " | |
3356 | "checked at run time. If this option has been set, the method will only be " | |
3357 | "used if this file exists; e.g. for the <literal>bzip2</literal> method (the " | |
3358 | "inbuilt) setting is: <placeholder type=\"literallayout\" id=\"0\"/> Note " | |
3359 | "also that list entries specified on the command line will be added at the " | |
3360 | "end of the list specified in the configuration files, but before the default " | |
3361 | "entries. To prefer a type in this case over the ones specified in the " | |
3362 | "configuration files you can set the option direct - not in list style. This " | |
3363 | "will not override the defined list; it will only prefix the list with this " | |
3364 | "type." | |
3365 | msgstr "" | |
3366 | ||
3367 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3368 | #: apt.conf.5.xml:1 | |
3369 | msgid "" | |
3370 | "The special type <literal>uncompressed</literal> can be used to give " | |
3371 | "uncompressed files a preference, but note that most archives don't provide " | |
3372 | "uncompressed files so this is mostly only useable for local mirrors." | |
3373 | msgstr "" | |
3374 | ||
3375 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3376 | #: apt.conf.5.xml:1 | |
3377 | msgid "" | |
3378 | "When downloading <literal>gzip</literal> compressed indexes (Packages, " | |
3379 | "Sources, or Translations), keep them gzip compressed locally instead of " | |
3380 | "unpacking them. This saves quite a lot of disk space at the expense of more " | |
3381 | "CPU requirements when building the local package caches. False by default." | |
3382 | msgstr "" | |
3383 | ||
3384 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3385 | #: apt.conf.5.xml:1 | |
3386 | msgid "" | |
3387 | "The Languages subsection controls which <filename>Translation</filename> " | |
3388 | "files are downloaded and in which order APT tries to display the " | |
3389 | "description-translations. APT will try to display the first available " | |
3390 | "description in the language which is listed first. Languages can be defined " | |
3391 | "with their short or long language codes. Note that not all archives provide " | |
3392 | "<filename>Translation</filename> files for every language - the long " | |
3393 | "language codes are especially rare." | |
3394 | msgstr "" | |
3395 | ||
3396 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><programlisting> | |
3397 | #: apt.conf.5.xml:1 | |
3398 | #, no-wrap | |
3399 | msgid "Acquire::Languages { \"environment\"; \"de\"; \"en\"; \"none\"; \"fr\"; };" | |
3400 | msgstr "" | |
3401 | ||
3402 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3403 | #: apt.conf.5.xml:1 | |
3404 | msgid "" | |
3405 | "The default list includes \"environment\" and " | |
3406 | "\"en\". \"<literal>environment</literal>\" has a special meaning here: it " | |
3407 | "will be replaced at runtime with the language codes extracted from the " | |
3408 | "<literal>LC_MESSAGES</literal> environment variable. It will also ensure " | |
3409 | "that these codes are not included twice in the list. If " | |
3410 | "<literal>LC_MESSAGES</literal> is set to \"C\" only the " | |
3411 | "<filename>Translation-en</filename> file (if available) will be used. To " | |
3412 | "force APT to use no Translation file use the setting " | |
3413 | "<literal>Acquire::Languages=none</literal>. \"<literal>none</literal>\" is " | |
3414 | "another special meaning code which will stop the search for a suitable " | |
3415 | "<filename>Translation</filename> file. This tells APT to download these " | |
3416 | "translations too, without actually using them unless the environment " | |
3417 | "specifies the languages. So the following example configuration will result " | |
3418 | "in the order \"en, de\" in an English locale or \"de, en\" in a German " | |
3419 | "one. Note that \"fr\" is downloaded, but not used unless APT is used in a " | |
3420 | "French locale (where the order would be \"fr, de, en\"). <placeholder " | |
3421 | "type=\"programlisting\" id=\"0\"/>" | |
3422 | msgstr "" | |
3423 | ||
3424 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3425 | #: apt.conf.5.xml:1 | |
3426 | msgid "" | |
3427 | "Note: To prevent problems resulting from APT being executed in different " | |
3428 | "environments (e.g. by different users or by other programs) all Translation " | |
3429 | "files which are found in <filename>/var/lib/apt/lists/</filename> will be " | |
3430 | "added to the end of the list (after an implicit " | |
3431 | "\"<literal>none</literal>\")." | |
3432 | msgstr "" | |
3433 | ||
3434 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3435 | #: apt.conf.5.xml:1 | |
3436 | msgid "When downloading, force to use only the IPv4 protocol." | |
3437 | msgstr "" | |
3438 | ||
3439 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3440 | #: apt.conf.5.xml:1 | |
3441 | msgid "When downloading, force to use only the IPv6 protocol." | |
3442 | msgstr "" | |
3443 | ||
3444 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3445 | #: apt.conf.5.xml:1 | |
3446 | msgid "" | |
3447 | "The maximum file size of Release/Release.gpg/InRelease files. The default " | |
3448 | "is 10MB." | |
3449 | msgstr "" | |
3450 | ||
3451 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3452 | #: apt.conf.5.xml:1 | |
3453 | msgid "" | |
3454 | "This option controls if apt will use the DNS SRV server record as specified " | |
3455 | "in RFC 2782 to select an alternative server to connect to. The default is " | |
3456 | "\"true\"." | |
3457 | msgstr "" | |
3458 | ||
3459 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3460 | #: apt.conf.5.xml:1 | |
3461 | msgid "" | |
3462 | "Allow the update operation to load data files from a repository without a " | |
3463 | "trusted signature. If enabled this option no data files will be loaded and " | |
3464 | "the update operation fails with a error for this source. The default is " | |
3465 | "false for backward compatibility. This will be changed in the future." | |
3466 | msgstr "" | |
3467 | ||
3468 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3469 | #: apt.conf.5.xml:1 | |
3470 | msgid "" | |
3471 | "Allow that a repository that was previously gpg signed to become unsigned " | |
3472 | "durign a update operation. When there is no valid signature of a perviously " | |
3473 | "trusted repository apt will refuse the update. This option can be used to " | |
3474 | "override this protection. You almost certainly never want to enable " | |
3475 | "this. The default is false. Note that apt will still consider packages from " | |
3476 | "this source untrusted and warn about them if you try to install them." | |
3477 | msgstr "" | |
3478 | ||
3479 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> | |
3480 | #: apt.conf.5.xml:1 | |
3481 | msgid "scope" | |
3482 | msgstr "" | |
3483 | ||
3484 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3485 | #: apt.conf.5.xml:1 | |
3486 | msgid "" | |
3487 | "Acquiring changelogs can only be done if an URI is known from where to get " | |
3488 | "them. Preferable the Release file indicates this in a 'Changelogs' " | |
3489 | "field. If this isn't available the Label/Origin field of the Release file is " | |
3490 | "used to check if a " | |
3491 | "<literal>Acquire::Changelogs::URI::Label::<replaceable>LABEL</replaceable></literal> " | |
3492 | "or " | |
3493 | "<literal>Acquire::Changelogs::URI::Origin::<replaceable>ORIGIN</replaceable></literal> " | |
3494 | "option exists and if so this value is taken. The value in the Release file " | |
3495 | "can be overridden with " | |
3496 | "<literal>Acquire::Changelogs::URI::Override::Label::<replaceable>LABEL</replaceable></literal> " | |
3497 | "or " | |
3498 | "<literal>Acquire::Changelogs::URI::Override::Origin::<replaceable>ORIGIN</replaceable></literal>. " | |
3499 | "The value should be a normal URI to a text file, expect that package " | |
3500 | "specific data is replaced with the placeholder " | |
3501 | "<literal>@CHANGEPATH@</literal>. The value for it is: 1. if the package is " | |
3502 | "from a component (e.g. <literal>main</literal>) this is the first part " | |
3503 | "otherwise it is omitted, 2. the first letter of source package name, expect " | |
3504 | "if the source package name starts with '<literal>lib</literal>' in which " | |
3505 | "case it will be the first four letters. 3. The complete source package " | |
3506 | "name. 4. the complete name again and 5. the source version. The first (if " | |
3507 | "present), second, third and fourth part are separated by a slash " | |
3508 | "('<literal>/</literal>') and between the fourth and fifth part is an " | |
3509 | "underscore ('<literal>_</literal>'). The special value " | |
3510 | "'<literal>no</literal>' is available for this option indicating that this " | |
3511 | "source can't be used to acquire changelog files from. Another source will be " | |
3512 | "tried if available in this case." | |
3513 | msgstr "" | |
3514 | ||
3515 | #. type: Content of: <refentry><refsect1><title> | |
3516 | #: apt.conf.5.xml:1 | |
3517 | msgid "Binary specific configuration" | |
3518 | msgstr "" | |
3519 | ||
3520 | #. type: Content of: <refentry><refsect1><para> | |
3521 | #: apt.conf.5.xml:1 | |
3522 | msgid "" | |
3523 | "Especially with the introduction of the <command>apt</command> binary it can " | |
3524 | "be useful to set certain options only for a specific binary as even options " | |
3525 | "which look like they would effect only a certain binary like " | |
3526 | "<option>APT::Get::Show-Versions</option> effect <command>apt-get</command> " | |
3527 | "as well as <command>apt</command>." | |
3528 | msgstr "" | |
3529 | ||
3530 | #. type: Content of: <refentry><refsect1><para> | |
3531 | #: apt.conf.5.xml:1 | |
3532 | msgid "" | |
3533 | "Setting an option for a specific binary only can be achieved by setting the " | |
3534 | "option inside the " | |
3535 | "<option>Binary::<replaceable>specific-binary</replaceable></option> " | |
3536 | "scope. Setting the option <option>APT::Get::Show-Versions</option> for the " | |
3537 | "<command>apt</command> only can e.g. by done by setting " | |
3538 | "<option>Binary::apt::APT::Get::Show-Versions</option> instead." | |
3539 | msgstr "" | |
3540 | ||
3541 | #. type: Content of: <refentry><refsect1><para> | |
3542 | #: apt.conf.5.xml:1 | |
3543 | msgid "" | |
3544 | "Note that as seen in the DESCRIPTION section further above you can't set " | |
3545 | "binary-specific options on the commandline itself nor in configuration files " | |
3546 | "loaded via the commandline." | |
3547 | msgstr "" | |
3548 | ||
3549 | #. type: Content of: <refentry><refsect1><title> | |
3550 | #: apt.conf.5.xml:1 | |
3551 | msgid "Directories" | |
3552 | msgstr "" | |
3553 | ||
3554 | #. type: Content of: <refentry><refsect1><para> | |
3555 | #: apt.conf.5.xml:1 | |
3556 | msgid "" | |
3557 | "The <literal>Dir::State</literal> section has directories that pertain to " | |
3558 | "local state information. <literal>lists</literal> is the directory to place " | |
3559 | "downloaded package lists in and <literal>status</literal> is the name of the " | |
3560 | "&dpkg; status file. <literal>preferences</literal> is the name of the APT " | |
3561 | "<filename>preferences</filename> file. <literal>Dir::State</literal> " | |
3562 | "contains the default directory to prefix on all sub-items if they do not " | |
3563 | "start with <filename>/</filename> or <filename>./</filename>." | |
3564 | msgstr "" | |
3565 | ||
3566 | #. type: Content of: <refentry><refsect1><para> | |
3567 | #: apt.conf.5.xml:1 | |
3568 | msgid "" | |
3569 | "<literal>Dir::Cache</literal> contains locations pertaining to local cache " | |
3570 | "information, such as the two package caches <literal>srcpkgcache</literal> " | |
3571 | "and <literal>pkgcache</literal> as well as the location to place downloaded " | |
3572 | "archives, <literal>Dir::Cache::archives</literal>. Generation of caches can " | |
3573 | "be turned off by setting <literal>pkgcache</literal> or " | |
3574 | "<literal>srcpkgcache</literal> to <literal>\"\"</literal>. This will slow " | |
3575 | "down startup but save disk space. It is probably preferable to turn off the " | |
3576 | "pkgcache rather than the srcpkgcache. Like <literal>Dir::State</literal> " | |
3577 | "the default directory is contained in <literal>Dir::Cache</literal>" | |
3578 | msgstr "" | |
3579 | ||
3580 | #. type: Content of: <refentry><refsect1><para> | |
3581 | #: apt.conf.5.xml:1 | |
3582 | msgid "" | |
3583 | "<literal>Dir::Etc</literal> contains the location of configuration files, " | |
3584 | "<literal>sourcelist</literal> gives the location of the sourcelist and " | |
3585 | "<literal>main</literal> is the default configuration file (setting has no " | |
3586 | "effect, unless it is done from the config file specified by " | |
3587 | "<envar>APT_CONFIG</envar>)." | |
3588 | msgstr "" | |
3589 | ||
3590 | #. type: Content of: <refentry><refsect1><para> | |
3591 | #: apt.conf.5.xml:1 | |
3592 | msgid "" | |
3593 | "The <literal>Dir::Parts</literal> setting reads in all the config fragments " | |
3594 | "in lexical order from the directory specified. After this is done then the " | |
3595 | "main config file is loaded." | |
3596 | msgstr "" | |
3597 | ||
3598 | #. type: Content of: <refentry><refsect1><para> | |
3599 | #: apt.conf.5.xml:1 | |
3600 | msgid "" | |
3601 | "Binary programs are pointed to by " | |
3602 | "<literal>Dir::Bin</literal>. <literal>Dir::Bin::Methods</literal> specifies " | |
3603 | "the location of the method handlers and <literal>gzip</literal>, " | |
3604 | "<literal>bzip2</literal>, <literal>lzma</literal>, <literal>dpkg</literal>, " | |
3605 | "<literal>apt-get</literal> <literal>dpkg-source</literal> " | |
3606 | "<literal>dpkg-buildpackage</literal> and <literal>apt-cache</literal> " | |
3607 | "specify the location of the respective programs." | |
3608 | msgstr "" | |
3609 | ||
3610 | #. type: Content of: <refentry><refsect1><para> | |
3611 | #: apt.conf.5.xml:1 | |
3612 | msgid "" | |
3613 | "The configuration item <literal>RootDir</literal> has a special meaning. If " | |
3614 | "set, all paths will be relative to <literal>RootDir</literal>, " | |
3615 | "<emphasis>even paths that are specified absolutely</emphasis>. So, for " | |
3616 | "instance, if <literal>RootDir</literal> is set to " | |
3617 | "<filename>/tmp/staging</filename> and <literal>Dir::State::status</literal> " | |
3618 | "is set to <filename>/var/lib/dpkg/status</filename>, then the status file " | |
3619 | "will be looked up in <filename>/tmp/staging/var/lib/dpkg/status</filename>. " | |
3620 | "If you want to prefix only relative paths, set <literal>Dir</literal> " | |
3621 | "instead." | |
3622 | msgstr "" | |
3623 | ||
3624 | #. type: Content of: <refentry><refsect1><para> | |
3625 | #: apt.conf.5.xml:1 | |
3626 | msgid "" | |
3627 | "The <literal>Ignore-Files-Silently</literal> list can be used to specify " | |
3628 | "which files APT should silently ignore while parsing the files in the " | |
3629 | "fragment directories. Per default a file which end with " | |
3630 | "<literal>.disabled</literal>, <literal>~</literal>, <literal>.bak</literal> " | |
3631 | "or <literal>.dpkg-[a-z]+</literal> is silently ignored. As seen in the last " | |
3632 | "default value these patterns can use regular expression syntax." | |
3633 | msgstr "" | |
3634 | ||
3635 | #. type: Content of: <refentry><refsect1><title> | |
3636 | #: apt.conf.5.xml:1 | |
3637 | msgid "APT in DSelect" | |
3638 | msgstr "" | |
3639 | ||
3640 | #. type: Content of: <refentry><refsect1><para> | |
3641 | #: apt.conf.5.xml:1 | |
3642 | msgid "" | |
3643 | "When APT is used as a &dselect; method several configuration directives " | |
3644 | "control the default behavior. These are in the <literal>DSelect</literal> " | |
3645 | "section." | |
3646 | msgstr "" | |
3647 | ||
3648 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3649 | #: apt.conf.5.xml:1 | |
3650 | msgid "" | |
3651 | "Cache Clean mode; this value may be one of <literal>always</literal>, " | |
3652 | "<literal>prompt</literal>, <literal>auto</literal>, " | |
3653 | "<literal>pre-auto</literal> and <literal>never</literal>. " | |
3654 | "<literal>always</literal> and <literal>prompt</literal> will remove all " | |
3655 | "packages from the cache after upgrading, <literal>prompt</literal> (the " | |
3656 | "default) does so conditionally. <literal>auto</literal> removes only those " | |
3657 | "packages which are no longer downloadable (replaced with a new version for " | |
3658 | "instance). <literal>pre-auto</literal> performs this action before " | |
3659 | "downloading new packages." | |
3660 | msgstr "" | |
3661 | ||
3662 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3663 | #: apt.conf.5.xml:1 | |
3664 | msgid "" | |
3665 | "The contents of this variable are passed to &apt-get; as command line " | |
3666 | "options when it is run for the install phase." | |
3667 | msgstr "" | |
3668 | ||
3669 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3670 | #: apt.conf.5.xml:1 | |
3671 | msgid "" | |
3672 | "The contents of this variable are passed to &apt-get; as command line " | |
3673 | "options when it is run for the update phase." | |
3674 | msgstr "" | |
3675 | ||
3676 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3677 | #: apt.conf.5.xml:1 | |
3678 | msgid "" | |
3679 | "If true the [U]pdate operation in &dselect; will always prompt to continue. " | |
3680 | "The default is to prompt only on error." | |
3681 | msgstr "" | |
3682 | ||
3683 | #. type: Content of: <refentry><refsect1><title> | |
3684 | #: apt.conf.5.xml:1 | |
3685 | msgid "How APT calls &dpkg;" | |
3686 | msgstr "" | |
3687 | ||
3688 | #. type: Content of: <refentry><refsect1><para> | |
3689 | #: apt.conf.5.xml:1 | |
3690 | msgid "" | |
3691 | "Several configuration directives control how APT invokes &dpkg;. These are " | |
3692 | "in the <literal>DPkg</literal> section." | |
3693 | msgstr "" | |
3694 | ||
3695 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3696 | #: apt.conf.5.xml:1 | |
3697 | msgid "" | |
3698 | "This is a list of options to pass to &dpkg;. The options must be specified " | |
3699 | "using the list notation and each list item is passed as a single argument to " | |
3700 | "&dpkg;." | |
3701 | msgstr "" | |
3702 | ||
3703 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3704 | #: apt.conf.5.xml:1 | |
3705 | msgid "" | |
3706 | "This is a list of shell commands to run before/after invoking &dpkg;. Like " | |
3707 | "<literal>options</literal> this must be specified in list notation. The " | |
3708 | "commands are invoked in order using <filename>/bin/sh</filename>; should any " | |
3709 | "fail APT will abort." | |
3710 | msgstr "" | |
3711 | ||
3712 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3713 | #: apt.conf.5.xml:1 | |
3714 | msgid "" | |
3715 | "This is a list of shell commands to run before invoking &dpkg;. Like " | |
3716 | "<literal>options</literal> this must be specified in list notation. The " | |
3717 | "commands are invoked in order using <filename>/bin/sh</filename>; should any " | |
3718 | "fail APT will abort. APT will pass the filenames of all .deb files it is " | |
3719 | "going to install to the commands, one per line on the requested file " | |
3720 | "descriptor, defaulting to standard input." | |
3721 | msgstr "" | |
3722 | ||
3723 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3724 | #: apt.conf.5.xml:1 | |
3725 | msgid "" | |
3726 | "Version 2 of this protocol sends more information through the requested file " | |
3727 | "descriptor: a line with the text <literal>VERSION 2</literal>, the APT " | |
3728 | "configuration space, and a list of package actions with filename and version " | |
3729 | "information." | |
3730 | msgstr "" | |
3731 | ||
3732 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3733 | #: apt.conf.5.xml:1 | |
3734 | msgid "" | |
3735 | "Each configuration directive line has the form " | |
3736 | "<literal>key=value</literal>. Special characters (equal signs, newlines, " | |
3737 | "nonprintable characters, quotation marks, and percent signs in " | |
3738 | "<literal>key</literal> and newlines, nonprintable characters, and percent " | |
3739 | "signs in <literal>value</literal>) are %-encoded. Lists are represented by " | |
3740 | "multiple <literal>key::=value</literal> lines with the same key. The " | |
3741 | "configuration section ends with a blank line." | |
3742 | msgstr "" | |
3743 | ||
3744 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3745 | #: apt.conf.5.xml:1 | |
3746 | msgid "" | |
3747 | "Package action lines consist of five fields in Version 2: old version, " | |
3748 | "direction of version change (< for upgrades, > for downgrades, = for " | |
3749 | "no change), new version, action. The version fields are \"-\" for no version " | |
3750 | "at all (for example when installing a package for the first time; no version " | |
3751 | "is treated as earlier than any real version, so that is an upgrade, " | |
3752 | "indicated as <literal>- < 1.23.4</literal>). The action field is " | |
3753 | "\"**CONFIGURE**\" if the package is being configured, \"**REMOVE**\" if it " | |
3754 | "is being removed, or the filename of a .deb file if it is being unpacked." | |
3755 | msgstr "" | |
3756 | ||
3757 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3758 | #: apt.conf.5.xml:1 | |
3759 | msgid "" | |
3760 | "In Version 3 after each version field follows the architecture of this " | |
3761 | "version, which is \"-\" if there is no version, and a field showing the " | |
3762 | "MultiArch type \"same\", foreign\", \"allowed\" or \"none\". Note that " | |
3763 | "\"none\" is an incorrect typename which is just kept to remain compatible, " | |
3764 | "it should be read as \"no\" and users are encouraged to support both." | |
3765 | msgstr "" | |
3766 | ||
3767 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3768 | #: apt.conf.5.xml:1 | |
3769 | msgid "" | |
3770 | "The version of the protocol to be used for the command " | |
3771 | "<literal><replaceable>cmd</replaceable></literal> can be chosen by setting " | |
3772 | "<literal>DPkg::Tools::options::<replaceable>cmd</replaceable>::Version</literal> " | |
3773 | "accordingly, the default being version 1. If APT isn't supporting the " | |
3774 | "requested version it will send the information in the highest version it has " | |
3775 | "support for instead." | |
3776 | msgstr "" | |
3777 | ||
3778 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3779 | #: apt.conf.5.xml:1 | |
3780 | msgid "" | |
3781 | "The file descriptor to be used to send the information can be requested with " | |
3782 | "<literal>DPkg::Tools::options::<replaceable>cmd</replaceable>::InfoFD</literal> " | |
3783 | "which defaults to <literal>0</literal> for standard input and is available " | |
3784 | "since version 0.9.11. Support for the option can be detected by looking for " | |
3785 | "the environment variable <envar>APT_HOOK_INFO_FD</envar> which contains the " | |
3786 | "number of the used file descriptor as a confirmation." | |
3787 | msgstr "" | |
3788 | ||
3789 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3790 | #: apt.conf.5.xml:1 | |
3791 | msgid "" | |
3792 | "APT chdirs to this directory before invoking &dpkg;, the default is " | |
3793 | "<filename>/</filename>." | |
3794 | msgstr "" | |
3795 | ||
3796 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3797 | #: apt.conf.5.xml:1 | |
3798 | msgid "" | |
3799 | "These options are passed to &dpkg-buildpackage; when compiling packages; the " | |
3800 | "default is to disable signing and produce all binaries." | |
3801 | msgstr "" | |
3802 | ||
3803 | #. type: Content of: <refentry><refsect1><refsect2><title> | |
3804 | #: apt.conf.5.xml:1 | |
3805 | msgid "dpkg trigger usage (and related options)" | |
3806 | msgstr "" | |
3807 | ||
3808 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
3809 | #: apt.conf.5.xml:1 | |
3810 | msgid "" | |
3811 | "APT can call &dpkg; in such a way as to let it make aggressive use of " | |
3812 | "triggers over multiple calls of &dpkg;. Without further options &dpkg; will " | |
3813 | "use triggers once each time it runs. Activating these options can therefore " | |
3814 | "decrease the time needed to perform the install or upgrade. Note that it is " | |
3815 | "intended to activate these options per default in the future, but as it " | |
3816 | "drastically changes the way APT calls &dpkg; it needs a lot more testing. " | |
3817 | "<emphasis>These options are therefore currently experimental and should not " | |
3818 | "be used in production environments.</emphasis> It also breaks progress " | |
3819 | "reporting such that all front-ends will currently stay around half (or more) " | |
3820 | "of the time in the 100% state while it actually configures all packages." | |
3821 | msgstr "" | |
3822 | ||
3823 | #. type: Content of: <refentry><refsect1><refsect2><para><literallayout> | |
3824 | #: apt.conf.5.xml:1 | |
3825 | #, no-wrap | |
3826 | msgid "" | |
3827 | "DPkg::NoTriggers \"true\";\n" | |
3828 | "PackageManager::Configure \"smart\";\n" | |
3829 | "DPkg::ConfigurePending \"true\";\n" | |
3830 | "DPkg::TriggersPending \"true\";" | |
3831 | msgstr "" | |
3832 | ||
3833 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
3834 | #: apt.conf.5.xml:1 | |
3835 | msgid "" | |
3836 | "Note that it is not guaranteed that APT will support these options or that " | |
3837 | "these options will not cause (big) trouble in the future. If you have " | |
3838 | "understand the current risks and problems with these options, but are brave " | |
3839 | "enough to help testing them, create a new configuration file and test a " | |
3840 | "combination of options. Please report any bugs, problems and improvements " | |
3841 | "you encounter and make sure to note which options you have used in your " | |
3842 | "reports. Asking &dpkg; for help could also be useful for debugging proposes, " | |
3843 | "see e.g. <command>dpkg --audit</command>. A defensive option combination " | |
3844 | "would be <placeholder type=\"literallayout\" id=\"0\"/>" | |
3845 | msgstr "" | |
3846 | ||
3847 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
3848 | #: apt.conf.5.xml:1 | |
3849 | msgid "" | |
3850 | "Add the no triggers flag to all &dpkg; calls (except the ConfigurePending " | |
3851 | "call). See &dpkg; if you are interested in what this actually means. In " | |
3852 | "short: &dpkg; will not run the triggers when this flag is present unless it " | |
3853 | "is explicitly called to do so in an extra call. Note that this option " | |
3854 | "exists (undocumented) also in older APT versions with a slightly different " | |
3855 | "meaning: Previously these option only append --no-triggers to the configure " | |
3856 | "calls to &dpkg; - now APT will also add this flag to the unpack and remove " | |
3857 | "calls." | |
3858 | msgstr "" | |
3859 | ||
3860 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
3861 | #: apt.conf.5.xml:1 | |
3862 | msgid "" | |
3863 | "Valid values are \"<literal>all</literal>\", \"<literal>smart</literal>\" " | |
3864 | "and \"<literal>no</literal>\". The default value is " | |
3865 | "\"<literal>all</literal>\", which causes APT to configure all packages. The " | |
3866 | "\"<literal>smart</literal>\" way is to configure only packages which need to " | |
3867 | "be configured before another package can be unpacked (Pre-Depends), and let " | |
3868 | "the rest be configured by &dpkg; with a call generated by the " | |
3869 | "ConfigurePending option (see below). On the other hand, " | |
3870 | "\"<literal>no</literal>\" will not configure anything, and totally relies on " | |
3871 | "&dpkg; for configuration (which at the moment will fail if a Pre-Depends is " | |
3872 | "encountered). Setting this option to any value other than " | |
3873 | "<literal>all</literal> will implicitly also activate the next option by " | |
3874 | "default, as otherwise the system could end in an unconfigured and " | |
3875 | "potentially unbootable state." | |
3876 | msgstr "" | |
3877 | ||
3878 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
3879 | #: apt.conf.5.xml:1 | |
3880 | msgid "" | |
3881 | "If this option is set APT will call <command>dpkg --configure " | |
3882 | "--pending</command> to let &dpkg; handle all required configurations and " | |
3883 | "triggers. This option is activated automatically per default if the previous " | |
3884 | "option is not set to <literal>all</literal>, but deactivating it could be " | |
3885 | "useful if you want to run APT multiple times in a row - e.g. in an " | |
3886 | "installer. In these sceneries you could deactivate this option in all but " | |
3887 | "the last run." | |
3888 | msgstr "" | |
3889 | ||
3890 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
3891 | #: apt.conf.5.xml:1 | |
3892 | msgid "" | |
3893 | "Useful for the <literal>smart</literal> configuration as a package which has " | |
3894 | "pending triggers is not considered as <literal>installed</literal>, and " | |
3895 | "&dpkg; treats them as <literal>unpacked</literal> currently which is a " | |
3896 | "showstopper for Pre-Dependencies (see debbugs #526774). Note that this will " | |
3897 | "process all triggers, not only the triggers needed to configure this " | |
3898 | "package." | |
3899 | msgstr "" | |
3900 | ||
3901 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para><literallayout> | |
3902 | #: apt.conf.5.xml:1 | |
3903 | #, no-wrap | |
3904 | msgid "" | |
3905 | "OrderList::Score {\n" | |
3906 | "\tDelete 500;\n" | |
3907 | "\tEssential 200;\n" | |
3908 | "\tImmediate 10;\n" | |
3909 | "\tPreDepends 50;\n" | |
3910 | "};" | |
3911 | msgstr "" | |
3912 | ||
3913 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
3914 | #: apt.conf.5.xml:1 | |
3915 | msgid "" | |
3916 | "Essential packages (and their dependencies) should be configured immediately " | |
3917 | "after unpacking. It is a good idea to do this quite early in the upgrade " | |
3918 | "process as these configure calls also currently require " | |
3919 | "<literal>DPkg::TriggersPending</literal> which will run quite a few triggers " | |
3920 | "(which may not be needed). Essentials get per default a high score but the " | |
3921 | "immediate flag is relatively low (a package which has a Pre-Depends is rated " | |
3922 | "higher). These option and the others in the same group can be used to " | |
3923 | "change the scoring. The following example shows the settings with their " | |
3924 | "default values. <placeholder type=\"literallayout\" id=\"0\"/>" | |
3925 | msgstr "" | |
3926 | ||
3927 | #. type: Content of: <refentry><refsect1><title> | |
3928 | #: apt.conf.5.xml:1 | |
3929 | msgid "Periodic and Archives options" | |
3930 | msgstr "" | |
3931 | ||
3932 | #. type: Content of: <refentry><refsect1><para> | |
3933 | #: apt.conf.5.xml:1 | |
3934 | msgid "" | |
3935 | "<literal>APT::Periodic</literal> and <literal>APT::Archives</literal> groups " | |
3936 | "of options configure behavior of apt periodic updates, which is done by the " | |
3937 | "<literal>/etc/cron.daily/apt</literal> script. See the top of this script " | |
3938 | "for the brief documentation of these options." | |
3939 | msgstr "" | |
3940 | ||
3941 | #. type: Content of: <refentry><refsect1><title> | |
3942 | #: apt.conf.5.xml:1 | |
3943 | msgid "Debug options" | |
3944 | msgstr "" | |
3945 | ||
3946 | #. type: Content of: <refentry><refsect1><para> | |
3947 | #: apt.conf.5.xml:1 | |
3948 | msgid "" | |
3949 | "Enabling options in the <literal>Debug::</literal> section will cause " | |
3950 | "debugging information to be sent to the standard error stream of the program " | |
3951 | "utilizing the <literal>apt</literal> libraries, or enable special program " | |
3952 | "modes that are primarily useful for debugging the behavior of " | |
3953 | "<literal>apt</literal>. Most of these options are not interesting to a " | |
3954 | "normal user, but a few may be:" | |
3955 | msgstr "" | |
3956 | ||
3957 | #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> | |
3958 | #: apt.conf.5.xml:1 | |
3959 | msgid "" | |
3960 | "<literal>Debug::pkgProblemResolver</literal> enables output about the " | |
3961 | "decisions made by <literal>dist-upgrade, upgrade, install, remove, " | |
3962 | "purge</literal>." | |
3963 | msgstr "" | |
3964 | ||
3965 | #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> | |
3966 | #: apt.conf.5.xml:1 | |
3967 | msgid "" | |
3968 | "<literal>Debug::NoLocking</literal> disables all file locking. This can be " | |
3969 | "used to run some operations (for instance, <literal>apt-get -s " | |
3970 | "install</literal>) as a non-root user." | |
3971 | msgstr "" | |
3972 | ||
3973 | #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> | |
3974 | #: apt.conf.5.xml:1 | |
3975 | msgid "" | |
3976 | "<literal>Debug::pkgDPkgPM</literal> prints out the actual command line each " | |
3977 | "time that <literal>apt</literal> invokes &dpkg;." | |
3978 | msgstr "" | |
3979 | ||
3980 | #. TODO: provide a | |
3981 | #. motivating example, except I haven't a clue why you'd want | |
3982 | #. to do this. | |
3983 | #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> | |
3984 | #: apt.conf.5.xml:1 | |
3985 | msgid "" | |
3986 | "<literal>Debug::IdentCdrom</literal> disables the inclusion of statfs data " | |
3987 | "in CD-ROM IDs." | |
3988 | msgstr "" | |
3989 | ||
3990 | #. type: Content of: <refentry><refsect1><para> | |
3991 | #: apt.conf.5.xml:1 | |
3992 | msgid "A full list of debugging options to apt follows." | |
3993 | msgstr "" | |
3994 | ||
3995 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
3996 | #: apt.conf.5.xml:1 | |
3997 | msgid "Print information related to accessing <literal>cdrom://</literal> sources." | |
3998 | msgstr "" | |
3999 | ||
4000 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4001 | #: apt.conf.5.xml:1 | |
4002 | msgid "Print information related to downloading packages using FTP." | |
4003 | msgstr "" | |
4004 | ||
4005 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4006 | #: apt.conf.5.xml:1 | |
4007 | msgid "Print information related to downloading packages using HTTP." | |
4008 | msgstr "" | |
4009 | ||
4010 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4011 | #: apt.conf.5.xml:1 | |
4012 | msgid "Print information related to downloading packages using HTTPS." | |
4013 | msgstr "" | |
4014 | ||
4015 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4016 | #: apt.conf.5.xml:1 | |
4017 | msgid "" | |
4018 | "Print information related to verifying cryptographic signatures using " | |
4019 | "<literal>gpg</literal>." | |
4020 | msgstr "" | |
4021 | ||
4022 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4023 | #: apt.conf.5.xml:1 | |
4024 | msgid "" | |
4025 | "Output information about the process of accessing collections of packages " | |
4026 | "stored on CD-ROMs." | |
4027 | msgstr "" | |
4028 | ||
4029 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4030 | #: apt.conf.5.xml:1 | |
4031 | msgid "Describes the process of resolving build-dependencies in &apt-get;." | |
4032 | msgstr "" | |
4033 | ||
4034 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4035 | #: apt.conf.5.xml:1 | |
4036 | msgid "" | |
4037 | "Output each cryptographic hash that is generated by the " | |
4038 | "<literal>apt</literal> libraries." | |
4039 | msgstr "" | |
4040 | ||
4041 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4042 | #: apt.conf.5.xml:1 | |
4043 | msgid "" | |
4044 | "Do not include information from <literal>statfs</literal>, namely the number " | |
4045 | "of used and free blocks on the CD-ROM filesystem, when generating an ID for " | |
4046 | "a CD-ROM." | |
4047 | msgstr "" | |
4048 | ||
4049 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4050 | #: apt.conf.5.xml:1 | |
4051 | msgid "" | |
4052 | "Disable all file locking. For instance, this will allow two instances of " | |
4053 | "<quote><literal>apt-get update</literal></quote> to run at the same time." | |
4054 | msgstr "" | |
4055 | ||
4056 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4057 | #: apt.conf.5.xml:1 | |
4058 | msgid "Log when items are added to or removed from the global download queue." | |
4059 | msgstr "" | |
4060 | ||
4061 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4062 | #: apt.conf.5.xml:1 | |
4063 | msgid "" | |
4064 | "Output status messages and errors related to verifying checksums and " | |
4065 | "cryptographic signatures of downloaded files." | |
4066 | msgstr "" | |
4067 | ||
4068 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4069 | #: apt.conf.5.xml:1 | |
4070 | msgid "" | |
4071 | "Output information about downloading and applying package index list diffs, " | |
4072 | "and errors relating to package index list diffs." | |
4073 | msgstr "" | |
4074 | ||
4075 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4076 | #: apt.conf.5.xml:1 | |
4077 | msgid "" | |
4078 | "Output information related to patching apt package lists when downloading " | |
4079 | "index diffs instead of full indices." | |
4080 | msgstr "" | |
4081 | ||
4082 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4083 | #: apt.conf.5.xml:1 | |
4084 | msgid "Log all interactions with the sub-processes that actually perform downloads." | |
4085 | msgstr "" | |
4086 | ||
4087 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4088 | #: apt.conf.5.xml:1 | |
4089 | msgid "" | |
4090 | "Log events related to the automatically-installed status of packages and to " | |
4091 | "the removal of unused packages." | |
4092 | msgstr "" | |
4093 | ||
4094 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4095 | #: apt.conf.5.xml:1 | |
4096 | msgid "" | |
4097 | "Generate debug messages describing which packages are being automatically " | |
4098 | "installed to resolve dependencies. This corresponds to the initial " | |
4099 | "auto-install pass performed in, e.g., <literal>apt-get install</literal>, " | |
4100 | "and not to the full <literal>apt</literal> dependency resolver; see " | |
4101 | "<literal>Debug::pkgProblemResolver</literal> for that." | |
4102 | msgstr "" | |
4103 | ||
4104 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4105 | #: apt.conf.5.xml:1 | |
4106 | msgid "" | |
4107 | "Generate debug messages describing which packages are marked as " | |
4108 | "keep/install/remove while the ProblemResolver does his work. Each addition " | |
4109 | "or deletion may trigger additional actions; they are shown indented two " | |
4110 | "additional spaces under the original entry. The format for each line is " | |
4111 | "<literal>MarkKeep</literal>, <literal>MarkDelete</literal> or " | |
4112 | "<literal>MarkInstall</literal> followed by <literal>package-name <a.b.c " | |
4113 | "-> d.e.f | x.y.z> (section)</literal> where <literal>a.b.c</literal> " | |
4114 | "is the current version of the package, <literal>d.e.f</literal> is the " | |
4115 | "version considered for installation and <literal>x.y.z</literal> is a newer " | |
4116 | "version, but not considered for installation (because of a low pin " | |
4117 | "score). The later two can be omitted if there is none or if it is the same " | |
4118 | "as the installed version. <literal>section</literal> is the name of the " | |
4119 | "section the package appears in." | |
4120 | msgstr "" | |
4121 | ||
4122 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4123 | #: apt.conf.5.xml:1 | |
4124 | msgid "" | |
4125 | "When invoking &dpkg;, output the precise command line with which it is being " | |
4126 | "invoked, with arguments separated by a single space character." | |
4127 | msgstr "" | |
4128 | ||
4129 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4130 | #: apt.conf.5.xml:1 | |
4131 | msgid "" | |
4132 | "Output all the data received from &dpkg; on the status file descriptor and " | |
4133 | "any errors encountered while parsing it." | |
4134 | msgstr "" | |
4135 | ||
4136 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4137 | #: apt.conf.5.xml:1 | |
4138 | msgid "" | |
4139 | "Generate a trace of the algorithm that decides the order in which " | |
4140 | "<literal>apt</literal> should pass packages to &dpkg;." | |
4141 | msgstr "" | |
4142 | ||
4143 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4144 | #: apt.conf.5.xml:1 | |
4145 | msgid "Output status messages tracing the steps performed when invoking &dpkg;." | |
4146 | msgstr "" | |
4147 | ||
4148 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4149 | #: apt.conf.5.xml:1 | |
4150 | msgid "Output the priority of each package list on startup." | |
4151 | msgstr "" | |
4152 | ||
4153 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4154 | #: apt.conf.5.xml:1 | |
4155 | msgid "" | |
4156 | "Trace the execution of the dependency resolver (this applies only to what " | |
4157 | "happens when a complex dependency problem is encountered)." | |
4158 | msgstr "" | |
4159 | ||
4160 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4161 | #: apt.conf.5.xml:1 | |
4162 | msgid "" | |
4163 | "Display a list of all installed packages with their calculated score used by " | |
4164 | "the pkgProblemResolver. The description of the package is the same as " | |
4165 | "described in <literal>Debug::pkgDepCache::Marker</literal>" | |
4166 | msgstr "" | |
4167 | ||
4168 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4169 | #: apt.conf.5.xml:1 | |
4170 | msgid "" | |
4171 | "Print information about the vendors read from " | |
4172 | "<filename>/etc/apt/vendors.list</filename>." | |
4173 | msgstr "" | |
4174 | ||
4175 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
4176 | #: apt.conf.5.xml:1 | |
4177 | msgid "" | |
4178 | "Display the external commands that are called by apt hooks. This includes " | |
4179 | "e.g. the config options <literal>DPkg::{Pre,Post}-Invoke</literal> or " | |
4180 | "<literal>APT::Update::{Pre,Post}-Invoke</literal>." | |
4181 | msgstr "" | |
4182 | ||
4183 | #. type: Content of: <refentry><refsect1><title> | |
4184 | #: apt.conf.5.xml:1 apt_preferences.5.xml:1 sources.list.5.xml:1 | |
4185 | #: apt-ftparchive.1.xml:1 | |
4186 | msgid "Examples" | |
4187 | msgstr "" | |
4188 | ||
4189 | #. type: Content of: <refentry><refsect1><para> | |
4190 | #: apt.conf.5.xml:1 | |
4191 | msgid "" | |
4192 | "&configureindex; is a configuration file showing example values for all " | |
4193 | "possible options." | |
4194 | msgstr "" | |
4195 | ||
4196 | #. ? reading apt.conf | |
4197 | #. type: Content of: <refentry><refsect1><para> | |
4198 | #: apt.conf.5.xml:1 | |
4199 | msgid "&apt-cache;, &apt-config;, &apt-preferences;." | |
4200 | msgstr "" | |
4201 | ||
4202 | #. type: Content of: <refentry><refnamediv><refpurpose> | |
4203 | #: apt_preferences.5.xml:1 | |
4204 | msgid "Preference control file for APT" | |
4205 | msgstr "" | |
4206 | ||
4207 | #. type: Content of: <refentry><refsect1><para> | |
4208 | #: apt_preferences.5.xml:1 | |
4209 | msgid "" | |
4210 | "The APT preferences file <filename>/etc/apt/preferences</filename> and the " | |
4211 | "fragment files in the <filename>/etc/apt/preferences.d/</filename> folder " | |
4212 | "can be used to control which versions of packages will be selected for " | |
4213 | "installation." | |
4214 | msgstr "" | |
4215 | ||
4216 | #. type: Content of: <refentry><refsect1><para> | |
4217 | #: apt_preferences.5.xml:1 | |
4218 | msgid "" | |
4219 | "Several versions of a package may be available for installation when the " | |
4220 | "&sources-list; file contains references to more than one distribution (for " | |
4221 | "example, <literal>stable</literal> and <literal>testing</literal>). APT " | |
4222 | "assigns a priority to each version that is available. Subject to dependency " | |
4223 | "constraints, <command>apt-get</command> selects the version with the highest " | |
4224 | "priority for installation. The APT preferences override the priorities that " | |
4225 | "APT assigns to package versions by default, thus giving the user control " | |
4226 | "over which one is selected for installation." | |
4227 | msgstr "" | |
4228 | ||
4229 | #. type: Content of: <refentry><refsect1><para> | |
4230 | #: apt_preferences.5.xml:1 | |
4231 | msgid "" | |
4232 | "Several instances of the same version of a package may be available when the " | |
4233 | "&sources-list; file contains references to more than one source. In this " | |
4234 | "case <command>apt-get</command> downloads the instance listed earliest in " | |
4235 | "the &sources-list; file. The APT preferences do not affect the choice of " | |
4236 | "instance, only the choice of version." | |
4237 | msgstr "" | |
4238 | ||
4239 | #. type: Content of: <refentry><refsect1><para> | |
4240 | #: apt_preferences.5.xml:1 | |
4241 | msgid "" | |
4242 | "Preferences are a strong power in the hands of a system administrator but " | |
4243 | "they can become also their biggest nightmare if used without care! APT will " | |
4244 | "not question the preferences, so wrong settings can lead to uninstallable " | |
4245 | "packages or wrong decisions while upgrading packages. Even more problems " | |
4246 | "will arise if multiple distribution releases are mixed without a good " | |
4247 | "understanding of the following paragraphs. Packages included in a specific " | |
4248 | "release aren't tested in (and therefore don't always work as expected in) " | |
4249 | "older or newer releases, or together with other packages from different " | |
4250 | "releases. You have been warned." | |
4251 | msgstr "" | |
4252 | ||
4253 | #. type: Content of: <refentry><refsect1><para> | |
4254 | #: apt_preferences.5.xml:1 | |
4255 | msgid "" | |
4256 | "Note that the files in the <filename>/etc/apt/preferences.d</filename> " | |
4257 | "directory are parsed in alphanumeric ascending order and need to obey the " | |
4258 | "following naming convention: The files have either no or " | |
4259 | "\"<literal>pref</literal>\" as filename extension and only contain " | |
4260 | "alphanumeric, hyphen (-), underscore (_) and period (.) characters. " | |
4261 | "Otherwise APT will print a notice that it has ignored a file, unless that " | |
4262 | "file matches a pattern in the <literal>Dir::Ignore-Files-Silently</literal> " | |
4263 | "configuration list - in which case it will be silently ignored." | |
4264 | msgstr "" | |
4265 | ||
4266 | #. type: Content of: <refentry><refsect1><refsect2><title> | |
4267 | #: apt_preferences.5.xml:1 | |
4268 | msgid "APT's Default Priority Assignments" | |
4269 | msgstr "" | |
4270 | ||
4271 | #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> | |
4272 | #: apt_preferences.5.xml:1 | |
4273 | #, no-wrap | |
4274 | msgid "" | |
4275 | "<command>apt-get install -t testing " | |
4276 | "<replaceable>some-package</replaceable></command>\n" | |
4277 | msgstr "" | |
4278 | ||
4279 | #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> | |
4280 | #: apt_preferences.5.xml:1 | |
4281 | #, no-wrap | |
4282 | msgid "APT::Default-Release \"stable\";\n" | |
4283 | msgstr "" | |
4284 | ||
4285 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4286 | #: apt_preferences.5.xml:1 | |
4287 | msgid "" | |
4288 | "If there is no preferences file or if there is no entry in the file that " | |
4289 | "applies to a particular version then the priority assigned to that version " | |
4290 | "is the priority of the distribution to which that version belongs. It is " | |
4291 | "possible to single out a distribution, \"the target release\", which " | |
4292 | "receives a higher priority than other distributions do by default. The " | |
4293 | "target release can be set on the <command>apt-get</command> command line or " | |
4294 | "in the APT configuration file <filename>/etc/apt/apt.conf</filename>. Note " | |
4295 | "that this has precedence over any general priority you set in the " | |
4296 | "<filename>/etc/apt/preferences</filename> file described later, but not over " | |
4297 | "specifically pinned packages. For example, <placeholder " | |
4298 | "type=\"programlisting\" id=\"0\"/> <placeholder type=\"programlisting\" " | |
4299 | "id=\"1\"/>" | |
4300 | msgstr "" | |
4301 | ||
4302 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4303 | #: apt_preferences.5.xml:1 | |
4304 | msgid "" | |
4305 | "If the target release has been specified then APT uses the following " | |
4306 | "algorithm to set the priorities of the versions of a package. Assign:" | |
4307 | msgstr "" | |
4308 | ||
4309 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> | |
4310 | #: apt_preferences.5.xml:1 | |
4311 | msgid "priority 1" | |
4312 | msgstr "" | |
4313 | ||
4314 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4315 | #: apt_preferences.5.xml:1 | |
4316 | msgid "" | |
4317 | "to the versions coming from archives which in their " | |
4318 | "<filename>Release</filename> files are marked as \"NotAutomatic: yes\" but " | |
4319 | "<emphasis>not</emphasis> as \"ButAutomaticUpgrades: yes\" like the Debian " | |
4320 | "<literal>experimental</literal> archive." | |
4321 | msgstr "" | |
4322 | ||
4323 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> | |
4324 | #: apt_preferences.5.xml:1 | |
4325 | msgid "priority 100" | |
4326 | msgstr "" | |
4327 | ||
4328 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4329 | #: apt_preferences.5.xml:1 | |
4330 | msgid "" | |
4331 | "to the version that is already installed (if any) and to the versions coming " | |
4332 | "from archives which in their <filename>Release</filename> files are marked " | |
4333 | "as \"NotAutomatic: yes\" and \"ButAutomaticUpgrades: yes\" like the Debian " | |
4334 | "backports archive since <literal>squeeze-backports</literal>." | |
4335 | msgstr "" | |
4336 | ||
4337 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> | |
4338 | #: apt_preferences.5.xml:1 | |
4339 | msgid "priority 500" | |
4340 | msgstr "" | |
4341 | ||
4342 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4343 | #: apt_preferences.5.xml:1 | |
4344 | msgid "to the versions that do not belong to the target release." | |
4345 | msgstr "" | |
4346 | ||
4347 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> | |
4348 | #: apt_preferences.5.xml:1 | |
4349 | msgid "priority 990" | |
4350 | msgstr "" | |
4351 | ||
4352 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4353 | #: apt_preferences.5.xml:1 | |
4354 | msgid "to the versions that belong to the target release." | |
4355 | msgstr "" | |
4356 | ||
4357 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4358 | #: apt_preferences.5.xml:1 | |
4359 | msgid "" | |
4360 | "The highest of those priorities whose description matches the version is " | |
4361 | "assigned to the version." | |
4362 | msgstr "" | |
4363 | ||
4364 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4365 | #: apt_preferences.5.xml:1 | |
4366 | msgid "" | |
4367 | "If the target release has not been specified then APT simply assigns " | |
4368 | "priority 100 to all installed package versions and priority 500 to all " | |
4369 | "uninstalled package versions, except versions coming from archives which in " | |
4370 | "their <filename>Release</filename> files are marked as \"NotAutomatic: yes\" " | |
4371 | "- these versions get the priority 1 or priority 100 if it is additionally " | |
4372 | "marked as \"ButAutomaticUpgrades: yes\"." | |
4373 | msgstr "" | |
4374 | ||
4375 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4376 | #: apt_preferences.5.xml:1 | |
4377 | msgid "" | |
4378 | "APT then applies the following rules, listed in order of precedence, to " | |
4379 | "determine which version of a package to install." | |
4380 | msgstr "" | |
4381 | ||
4382 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> | |
4383 | #: apt_preferences.5.xml:1 | |
4384 | msgid "" | |
4385 | "Never downgrade unless the priority of an available version exceeds 1000. " | |
4386 | "(\"Downgrading\" is installing a less recent version of a package in place " | |
4387 | "of a more recent version. Note that none of APT's default priorities " | |
4388 | "exceeds 1000; such high priorities can only be set in the preferences file. " | |
4389 | "Note also that downgrading a package can be risky.)" | |
4390 | msgstr "" | |
4391 | ||
4392 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> | |
4393 | #: apt_preferences.5.xml:1 | |
4394 | msgid "Install the highest priority version." | |
4395 | msgstr "" | |
4396 | ||
4397 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> | |
4398 | #: apt_preferences.5.xml:1 | |
4399 | msgid "" | |
4400 | "If two or more versions have the same priority, install the most recent one " | |
4401 | "(that is, the one with the higher version number)." | |
4402 | msgstr "" | |
4403 | ||
4404 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> | |
4405 | #: apt_preferences.5.xml:1 | |
4406 | msgid "" | |
4407 | "If two or more versions have the same priority and version number but either " | |
4408 | "the packages differ in some of their metadata or the " | |
4409 | "<literal>--reinstall</literal> option is given, install the uninstalled one." | |
4410 | msgstr "" | |
4411 | ||
4412 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4413 | #: apt_preferences.5.xml:1 | |
4414 | msgid "" | |
4415 | "In a typical situation, the installed version of a package (priority 100) " | |
4416 | "is not as recent as one of the versions available from the sources listed in " | |
4417 | "the &sources-list; file (priority 500 or 990). Then the package will be " | |
4418 | "upgraded when <command>apt-get install " | |
4419 | "<replaceable>some-package</replaceable></command> or <command>apt-get " | |
4420 | "upgrade</command> is executed." | |
4421 | msgstr "" | |
4422 | ||
4423 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4424 | #: apt_preferences.5.xml:1 | |
4425 | msgid "" | |
4426 | "More rarely, the installed version of a package is <emphasis>more</emphasis> " | |
4427 | "recent than any of the other available versions. The package will not be " | |
4428 | "downgraded when <command>apt-get install " | |
4429 | "<replaceable>some-package</replaceable></command> or <command>apt-get " | |
4430 | "upgrade</command> is executed." | |
4431 | msgstr "" | |
4432 | ||
4433 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4434 | #: apt_preferences.5.xml:1 | |
4435 | msgid "" | |
4436 | "Sometimes the installed version of a package is more recent than the version " | |
4437 | "belonging to the target release, but not as recent as a version belonging to " | |
4438 | "some other distribution. Such a package will indeed be upgraded when " | |
4439 | "<command>apt-get install <replaceable>some-package</replaceable></command> " | |
4440 | "or <command>apt-get upgrade</command> is executed, because at least " | |
4441 | "<emphasis>one</emphasis> of the available versions has a higher priority " | |
4442 | "than the installed version." | |
4443 | msgstr "" | |
4444 | ||
4445 | #. type: Content of: <refentry><refsect1><refsect2><title> | |
4446 | #: apt_preferences.5.xml:1 | |
4447 | msgid "The Effect of APT Preferences" | |
4448 | msgstr "" | |
4449 | ||
4450 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4451 | #: apt_preferences.5.xml:1 | |
4452 | msgid "" | |
4453 | "The APT preferences file allows the system administrator to control the " | |
4454 | "assignment of priorities. The file consists of one or more multi-line " | |
4455 | "records separated by blank lines. Records can have one of two forms, a " | |
4456 | "specific form and a general form." | |
4457 | msgstr "" | |
4458 | ||
4459 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> | |
4460 | #: apt_preferences.5.xml:1 | |
4461 | msgid "" | |
4462 | "The specific form assigns a priority (a \"Pin-Priority\") to one or more " | |
4463 | "specified packages with a specified version or version range. For example, " | |
4464 | "the following record assigns a high priority to all versions of the " | |
4465 | "<filename>perl</filename> package whose version number begins with " | |
4466 | "\"<literal>&good-perl;</literal>\". Multiple packages can be separated by " | |
4467 | "spaces." | |
4468 | msgstr "" | |
4469 | ||
4470 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting> | |
4471 | #: apt_preferences.5.xml:1 | |
4472 | #, no-wrap | |
4473 | msgid "" | |
4474 | "Package: perl\n" | |
4475 | "Pin: version &good-perl;*\n" | |
4476 | "Pin-Priority: 1001\n" | |
4477 | msgstr "" | |
4478 | ||
4479 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> | |
4480 | #: apt_preferences.5.xml:1 | |
4481 | msgid "" | |
4482 | "The general form assigns a priority to all of the package versions in a " | |
4483 | "given distribution (that is, to all the versions of packages that are listed " | |
4484 | "in a certain <filename>Release</filename> file) or to all of the package " | |
4485 | "versions coming from a particular Internet site, as identified by the site's " | |
4486 | "fully qualified domain name." | |
4487 | msgstr "" | |
4488 | ||
4489 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> | |
4490 | #: apt_preferences.5.xml:1 | |
4491 | msgid "" | |
4492 | "This general-form entry in the APT preferences file applies only to groups " | |
4493 | "of packages. For example, the following record assigns a high priority to " | |
4494 | "all package versions available from the local site." | |
4495 | msgstr "" | |
4496 | ||
4497 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting> | |
4498 | #: apt_preferences.5.xml:1 | |
4499 | #, no-wrap | |
4500 | msgid "" | |
4501 | "Package: *\n" | |
4502 | "Pin: origin \"\"\n" | |
4503 | "Pin-Priority: 999\n" | |
4504 | msgstr "" | |
4505 | ||
4506 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> | |
4507 | #: apt_preferences.5.xml:1 | |
4508 | msgid "" | |
4509 | "A note of caution: the keyword used here is \"<literal>origin</literal>\" " | |
4510 | "which can be used to match a hostname. The following record will assign a " | |
4511 | "high priority to all versions available from the server identified by the " | |
4512 | "hostname \"ftp.de.debian.org\"" | |
4513 | msgstr "" | |
4514 | ||
4515 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting> | |
4516 | #: apt_preferences.5.xml:1 | |
4517 | #, no-wrap | |
4518 | msgid "" | |
4519 | "Package: *\n" | |
4520 | "Pin: origin \"ftp.de.debian.org\"\n" | |
4521 | "Pin-Priority: 999\n" | |
4522 | msgstr "" | |
4523 | ||
4524 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> | |
4525 | #: apt_preferences.5.xml:1 | |
4526 | msgid "" | |
4527 | "This should <emphasis>not</emphasis> be confused with the Origin of a " | |
4528 | "distribution as specified in a <filename>Release</filename> file. What " | |
4529 | "follows the \"Origin:\" tag in a <filename>Release</filename> file is not an " | |
4530 | "Internet address but an author or vendor name, such as \"Debian\" or " | |
4531 | "\"Ximian\"." | |
4532 | msgstr "" | |
4533 | ||
4534 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> | |
4535 | #: apt_preferences.5.xml:1 | |
4536 | msgid "" | |
4537 | "The following record assigns a low priority to all package versions " | |
4538 | "belonging to any distribution whose Archive name is " | |
4539 | "\"<literal>unstable</literal>\"." | |
4540 | msgstr "" | |
4541 | ||
4542 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting> | |
4543 | #: apt_preferences.5.xml:1 | |
4544 | #, no-wrap | |
4545 | msgid "" | |
4546 | "Package: *\n" | |
4547 | "Pin: release a=unstable\n" | |
4548 | "Pin-Priority: 50\n" | |
4549 | msgstr "" | |
4550 | ||
4551 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> | |
4552 | #: apt_preferences.5.xml:1 | |
4553 | msgid "" | |
4554 | "The following record assigns a high priority to all package versions " | |
4555 | "belonging to any distribution whose Codename is " | |
4556 | "\"<literal>&testing-codename;</literal>\"." | |
4557 | msgstr "" | |
4558 | ||
4559 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting> | |
4560 | #: apt_preferences.5.xml:1 | |
4561 | #, no-wrap | |
4562 | msgid "" | |
4563 | "Package: *\n" | |
4564 | "Pin: release n=&testing-codename;\n" | |
4565 | "Pin-Priority: 900\n" | |
4566 | msgstr "" | |
4567 | ||
4568 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> | |
4569 | #: apt_preferences.5.xml:1 | |
4570 | msgid "" | |
4571 | "The following record assigns a high priority to all package versions " | |
4572 | "belonging to any release whose Archive name is \"<literal>stable</literal>\" " | |
4573 | "and whose release Version number is \"<literal>&stable-version;</literal>\"." | |
4574 | msgstr "" | |
4575 | ||
4576 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting> | |
4577 | #: apt_preferences.5.xml:1 | |
4578 | #, no-wrap | |
4579 | msgid "" | |
4580 | "Package: *\n" | |
4581 | "Pin: release a=stable, v=&stable-version;\n" | |
4582 | "Pin-Priority: 500\n" | |
4583 | msgstr "" | |
4584 | ||
4585 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4586 | #: apt_preferences.5.xml:1 | |
4587 | msgid "" | |
4588 | "The effect of the comma operator is similar to an \"and\" in logic: All " | |
4589 | "conditions must be satisfied for the pin to match. There is one exception: " | |
4590 | "For any type of condition (such as two \"a\" conditions), only the last such " | |
4591 | "condition is checked." | |
4592 | msgstr "" | |
4593 | ||
4594 | #. type: Content of: <refentry><refsect1><refsect2><title> | |
4595 | #: apt_preferences.5.xml:1 | |
4596 | msgid "Regular expressions and &glob; syntax" | |
4597 | msgstr "" | |
4598 | ||
4599 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4600 | #: apt_preferences.5.xml:1 | |
4601 | msgid "" | |
4602 | "APT also supports pinning by &glob; expressions, and regular expressions " | |
4603 | "surrounded by slashes. For example, the following example assigns the " | |
4604 | "priority 500 to all packages from experimental where the name starts with " | |
4605 | "gnome (as a &glob;-like expression) or contains the word kde (as a POSIX " | |
4606 | "extended regular expression surrounded by slashes)." | |
4607 | msgstr "" | |
4608 | ||
4609 | #. type: Content of: <refentry><refsect1><refsect2><programlisting> | |
4610 | #: apt_preferences.5.xml:1 | |
4611 | #, no-wrap | |
4612 | msgid "" | |
4613 | "Package: gnome* /kde/\n" | |
4614 | "Pin: release a=experimental\n" | |
4615 | "Pin-Priority: 500\n" | |
4616 | msgstr "" | |
4617 | ||
4618 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4619 | #: apt_preferences.5.xml:1 | |
4620 | msgid "" | |
4621 | "The rule for those expressions is that they can occur anywhere where a " | |
4622 | "string can occur. Thus, the following pin assigns the priority 990 to all " | |
4623 | "packages from a release starting with &ubuntu-codename;." | |
4624 | msgstr "" | |
4625 | ||
4626 | #. type: Content of: <refentry><refsect1><refsect2><programlisting> | |
4627 | #: apt_preferences.5.xml:1 | |
4628 | #, no-wrap | |
4629 | msgid "" | |
4630 | "Package: *\n" | |
4631 | "Pin: release n=&ubuntu-codename;*\n" | |
4632 | "Pin-Priority: 990\n" | |
4633 | msgstr "" | |
4634 | ||
4635 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4636 | #: apt_preferences.5.xml:1 | |
4637 | msgid "" | |
4638 | "If a regular expression occurs in a <literal>Package</literal> field, the " | |
4639 | "behavior is the same as if this regular expression were replaced with a list " | |
4640 | "of all package names it matches. It is undecided whether this will change in " | |
4641 | "the future; thus you should always list wild-card pins first, so later " | |
4642 | "specific pins override it. The pattern \"<literal>*</literal>\" in a " | |
4643 | "Package field is not considered a &glob; expression in itself." | |
4644 | msgstr "" | |
4645 | ||
4646 | #. type: Content of: <refentry><refsect1><refsect2><title> | |
4647 | #: apt_preferences.5.xml:1 | |
4648 | msgid "How APT Interprets Priorities" | |
4649 | msgstr "" | |
4650 | ||
4651 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4652 | #: apt_preferences.5.xml:1 | |
4653 | msgid "" | |
4654 | "Priorities (P) assigned in the APT preferences file must be positive or " | |
4655 | "negative integers. They are interpreted as follows (roughly speaking):" | |
4656 | msgstr "" | |
4657 | ||
4658 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> | |
4659 | #: apt_preferences.5.xml:1 | |
4660 | msgid "P >= 1000" | |
4661 | msgstr "" | |
4662 | ||
4663 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4664 | #: apt_preferences.5.xml:1 | |
4665 | msgid "" | |
4666 | "causes a version to be installed even if this constitutes a downgrade of the " | |
4667 | "package" | |
4668 | msgstr "" | |
4669 | ||
4670 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> | |
4671 | #: apt_preferences.5.xml:1 | |
4672 | msgid "990 <= P < 1000" | |
4673 | msgstr "" | |
4674 | ||
4675 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4676 | #: apt_preferences.5.xml:1 | |
4677 | msgid "" | |
4678 | "causes a version to be installed even if it does not come from the target " | |
4679 | "release, unless the installed version is more recent" | |
4680 | msgstr "" | |
4681 | ||
4682 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> | |
4683 | #: apt_preferences.5.xml:1 | |
4684 | msgid "500 <= P < 990" | |
4685 | msgstr "" | |
4686 | ||
4687 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4688 | #: apt_preferences.5.xml:1 | |
4689 | msgid "" | |
4690 | "causes a version to be installed unless there is a version available " | |
4691 | "belonging to the target release or the installed version is more recent" | |
4692 | msgstr "" | |
4693 | ||
4694 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> | |
4695 | #: apt_preferences.5.xml:1 | |
4696 | msgid "100 <= P < 500" | |
4697 | msgstr "" | |
4698 | ||
4699 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4700 | #: apt_preferences.5.xml:1 | |
4701 | msgid "" | |
4702 | "causes a version to be installed unless there is a version available " | |
4703 | "belonging to some other distribution or the installed version is more recent" | |
4704 | msgstr "" | |
4705 | ||
4706 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> | |
4707 | #: apt_preferences.5.xml:1 | |
4708 | msgid "0 < P < 100" | |
4709 | msgstr "" | |
4710 | ||
4711 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4712 | #: apt_preferences.5.xml:1 | |
4713 | msgid "" | |
4714 | "causes a version to be installed only if there is no installed version of " | |
4715 | "the package" | |
4716 | msgstr "" | |
4717 | ||
4718 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> | |
4719 | #: apt_preferences.5.xml:1 | |
4720 | msgid "P < 0" | |
4721 | msgstr "" | |
4722 | ||
4723 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4724 | #: apt_preferences.5.xml:1 | |
4725 | msgid "prevents the version from being installed" | |
4726 | msgstr "" | |
4727 | ||
4728 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> | |
4729 | #: apt_preferences.5.xml:1 | |
4730 | msgid "P = 0" | |
4731 | msgstr "" | |
4732 | ||
4733 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4734 | #: apt_preferences.5.xml:1 | |
4735 | msgid "has undefined behaviour, do not use it." | |
4736 | msgstr "" | |
4737 | ||
4738 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4739 | #: apt_preferences.5.xml:1 | |
4740 | msgid "" | |
4741 | "The first specific-form record matching an available package version " | |
4742 | "determines the priority of the package version. Failing that, the priority " | |
4743 | "of the package is defined as the maximum of all priorities defined by " | |
4744 | "generic-form records matching the version. Records defined using patterns " | |
4745 | "in the Pin field other than \"*\" are treated like specific-form records." | |
4746 | msgstr "" | |
4747 | ||
4748 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4749 | #: apt_preferences.5.xml:1 | |
4750 | msgid "" | |
4751 | "For example, suppose the APT preferences file contains the three records " | |
4752 | "presented earlier:" | |
4753 | msgstr "" | |
4754 | ||
4755 | #. type: Content of: <refentry><refsect1><refsect2><programlisting> | |
4756 | #: apt_preferences.5.xml:1 | |
4757 | #, no-wrap | |
4758 | msgid "" | |
4759 | "Package: perl\n" | |
4760 | "Pin: version &good-perl;*\n" | |
4761 | "Pin-Priority: 1001\n" | |
4762 | "\n" | |
4763 | "Package: *\n" | |
4764 | "Pin: origin \"\"\n" | |
4765 | "Pin-Priority: 999\n" | |
4766 | "\n" | |
4767 | "Package: *\n" | |
4768 | "Pin: release unstable\n" | |
4769 | "Pin-Priority: 50\n" | |
4770 | msgstr "" | |
4771 | ||
4772 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4773 | #: apt_preferences.5.xml:1 | |
4774 | msgid "Then:" | |
4775 | msgstr "" | |
4776 | ||
4777 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> | |
4778 | #: apt_preferences.5.xml:1 | |
4779 | msgid "" | |
4780 | "The most recent available version of the <literal>perl</literal> package " | |
4781 | "will be installed, so long as that version's version number begins with " | |
4782 | "\"<literal>&good-perl;</literal>\". If <emphasis>any</emphasis> " | |
4783 | "&good-perl;* version of <literal>perl</literal> is available and the " | |
4784 | "installed version is &bad-perl;*, then <literal>perl</literal> will be " | |
4785 | "downgraded." | |
4786 | msgstr "" | |
4787 | ||
4788 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> | |
4789 | #: apt_preferences.5.xml:1 | |
4790 | msgid "" | |
4791 | "A version of any package other than <literal>perl</literal> that is " | |
4792 | "available from the local system has priority over other versions, even " | |
4793 | "versions belonging to the target release." | |
4794 | msgstr "" | |
4795 | ||
4796 | #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> | |
4797 | #: apt_preferences.5.xml:1 | |
4798 | msgid "" | |
4799 | "A version of a package whose origin is not the local system but some other " | |
4800 | "site listed in &sources-list; and which belongs to an " | |
4801 | "<literal>unstable</literal> distribution is only installed if it is selected " | |
4802 | "for installation and no version of the package is already installed." | |
4803 | msgstr "" | |
4804 | ||
4805 | #. type: Content of: <refentry><refsect1><refsect2><title> | |
4806 | #: apt_preferences.5.xml:1 | |
4807 | msgid "Determination of Package Version and Distribution Properties" | |
4808 | msgstr "" | |
4809 | ||
4810 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4811 | #: apt_preferences.5.xml:1 | |
4812 | msgid "" | |
4813 | "The locations listed in the &sources-list; file should provide " | |
4814 | "<filename>Packages</filename> and <filename>Release</filename> files to " | |
4815 | "describe the packages available at that location." | |
4816 | msgstr "" | |
4817 | ||
4818 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4819 | #: apt_preferences.5.xml:1 | |
4820 | msgid "" | |
4821 | "The <filename>Packages</filename> file is normally found in the directory " | |
4822 | "<filename>.../dists/<replaceable>dist-name</replaceable>/<replaceable>component</replaceable>/<replaceable>arch</replaceable></filename>: " | |
4823 | "for example, " | |
4824 | "<filename>.../dists/stable/main/binary-i386/Packages</filename>. It " | |
4825 | "consists of a series of multi-line records, one for each package available " | |
4826 | "in that directory. Only two lines in each record are relevant for setting " | |
4827 | "APT priorities:" | |
4828 | msgstr "" | |
4829 | ||
4830 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> | |
4831 | #: apt_preferences.5.xml:1 | |
4832 | msgid "the <literal>Package:</literal> line" | |
4833 | msgstr "" | |
4834 | ||
4835 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4836 | #: apt_preferences.5.xml:1 | |
4837 | msgid "gives the package name" | |
4838 | msgstr "" | |
4839 | ||
4840 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> | |
4841 | #: apt_preferences.5.xml:1 apt_preferences.5.xml:1 | |
4842 | msgid "the <literal>Version:</literal> line" | |
4843 | msgstr "" | |
4844 | ||
4845 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4846 | #: apt_preferences.5.xml:1 | |
4847 | msgid "gives the version number for the named package" | |
4848 | msgstr "" | |
4849 | ||
4850 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4851 | #: apt_preferences.5.xml:1 | |
4852 | msgid "" | |
4853 | "The <filename>Release</filename> file is normally found in the directory " | |
4854 | "<filename>.../dists/<replaceable>dist-name</replaceable></filename>: for " | |
4855 | "example, <filename>.../dists/stable/Release</filename>, or " | |
4856 | "<filename>.../dists/&stable-codename;/Release</filename>. It consists of a " | |
4857 | "single multi-line record which applies to <emphasis>all</emphasis> of the " | |
4858 | "packages in the directory tree below its parent. Unlike the " | |
4859 | "<filename>Packages</filename> file, nearly all of the lines in a " | |
4860 | "<filename>Release</filename> file are relevant for setting APT priorities:" | |
4861 | msgstr "" | |
4862 | ||
4863 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> | |
4864 | #: apt_preferences.5.xml:1 | |
4865 | msgid "the <literal>Archive:</literal> or <literal>Suite:</literal> line" | |
4866 | msgstr "" | |
4867 | ||
4868 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4869 | #: apt_preferences.5.xml:1 | |
4870 | msgid "" | |
4871 | "names the archive to which all the packages in the directory tree belong. " | |
4872 | "For example, the line \"Archive: stable\" or \"Suite: stable\" specifies " | |
4873 | "that all of the packages in the directory tree below the parent of the " | |
4874 | "<filename>Release</filename> file are in a <literal>stable</literal> " | |
4875 | "archive. Specifying this value in the APT preferences file would require " | |
4876 | "the line:" | |
4877 | msgstr "" | |
4878 | ||
4879 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting> | |
4880 | #: apt_preferences.5.xml:1 | |
4881 | #, no-wrap | |
4882 | msgid "Pin: release a=stable\n" | |
4883 | msgstr "" | |
4884 | ||
4885 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> | |
4886 | #: apt_preferences.5.xml:1 | |
4887 | msgid "the <literal>Codename:</literal> line" | |
4888 | msgstr "" | |
4889 | ||
4890 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4891 | #: apt_preferences.5.xml:1 | |
4892 | msgid "" | |
4893 | "names the codename to which all the packages in the directory tree belong. " | |
4894 | "For example, the line \"Codename: &testing-codename;\" specifies that all of " | |
4895 | "the packages in the directory tree below the parent of the " | |
4896 | "<filename>Release</filename> file belong to a version named " | |
4897 | "<literal>&testing-codename;</literal>. Specifying this value in the APT " | |
4898 | "preferences file would require the line:" | |
4899 | msgstr "" | |
4900 | ||
4901 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting> | |
4902 | #: apt_preferences.5.xml:1 | |
4903 | #, no-wrap | |
4904 | msgid "Pin: release n=&testing-codename;\n" | |
4905 | msgstr "" | |
4906 | ||
4907 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4908 | #: apt_preferences.5.xml:1 | |
4909 | msgid "" | |
4910 | "names the release version. For example, the packages in the tree might " | |
4911 | "belong to Debian release version &stable-version;. Note that there is " | |
4912 | "normally no version number for the <literal>testing</literal> and " | |
4913 | "<literal>unstable</literal> distributions because they have not been " | |
4914 | "released yet. Specifying this in the APT preferences file would require one " | |
4915 | "of the following lines." | |
4916 | msgstr "" | |
4917 | ||
4918 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting> | |
4919 | #: apt_preferences.5.xml:1 | |
4920 | #, no-wrap | |
4921 | msgid "" | |
4922 | "Pin: release v=&stable-version;\n" | |
4923 | "Pin: release a=stable, v=&stable-version;\n" | |
4924 | "Pin: release &stable-version;\n" | |
4925 | msgstr "" | |
4926 | ||
4927 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> | |
4928 | #: apt_preferences.5.xml:1 | |
4929 | msgid "the <literal>Component:</literal> line" | |
4930 | msgstr "" | |
4931 | ||
4932 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4933 | #: apt_preferences.5.xml:1 | |
4934 | msgid "" | |
4935 | "names the licensing component associated with the packages in the directory " | |
4936 | "tree of the <filename>Release</filename> file. For example, the line " | |
4937 | "\"Component: main\" specifies that all the packages in the directory tree " | |
4938 | "are from the <literal>main</literal> component, which entails that they are " | |
4939 | "licensed under terms listed in the Debian Free Software Guidelines. " | |
4940 | "Specifying this component in the APT preferences file would require the " | |
4941 | "line:" | |
4942 | msgstr "" | |
4943 | ||
4944 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting> | |
4945 | #: apt_preferences.5.xml:1 | |
4946 | #, no-wrap | |
4947 | msgid "Pin: release c=main\n" | |
4948 | msgstr "" | |
4949 | ||
4950 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> | |
4951 | #: apt_preferences.5.xml:1 | |
4952 | msgid "the <literal>Origin:</literal> line" | |
4953 | msgstr "" | |
4954 | ||
4955 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4956 | #: apt_preferences.5.xml:1 | |
4957 | msgid "" | |
4958 | "names the originator of the packages in the directory tree of the " | |
4959 | "<filename>Release</filename> file. Most commonly, this is " | |
4960 | "<literal>Debian</literal>. Specifying this origin in the APT preferences " | |
4961 | "file would require the line:" | |
4962 | msgstr "" | |
4963 | ||
4964 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting> | |
4965 | #: apt_preferences.5.xml:1 | |
4966 | #, no-wrap | |
4967 | msgid "Pin: release o=Debian\n" | |
4968 | msgstr "" | |
4969 | ||
4970 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> | |
4971 | #: apt_preferences.5.xml:1 | |
4972 | msgid "the <literal>Label:</literal> line" | |
4973 | msgstr "" | |
4974 | ||
4975 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> | |
4976 | #: apt_preferences.5.xml:1 | |
4977 | msgid "" | |
4978 | "names the label of the packages in the directory tree of the " | |
4979 | "<filename>Release</filename> file. Most commonly, this is " | |
4980 | "<literal>Debian</literal>. Specifying this label in the APT preferences " | |
4981 | "file would require the line:" | |
4982 | msgstr "" | |
4983 | ||
4984 | #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting> | |
4985 | #: apt_preferences.5.xml:1 | |
4986 | #, no-wrap | |
4987 | msgid "Pin: release l=Debian\n" | |
4988 | msgstr "" | |
4989 | ||
4990 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
4991 | #: apt_preferences.5.xml:1 | |
4992 | msgid "" | |
4993 | "All of the <filename>Packages</filename> and <filename>Release</filename> " | |
4994 | "files retrieved from locations listed in the &sources-list; file are stored " | |
4995 | "in the directory <filename>/var/lib/apt/lists</filename>, or in the file " | |
4996 | "named by the variable <literal>Dir::State::Lists</literal> in the " | |
4997 | "<filename>apt.conf</filename> file. For example, the file " | |
4998 | "<filename>debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release</filename> " | |
4999 | "contains the <filename>Release</filename> file retrieved from the site " | |
5000 | "<literal>debian.lcs.mit.edu</literal> for <literal>binary-i386</literal> " | |
5001 | "architecture files from the <literal>contrib</literal> component of the " | |
5002 | "<literal>unstable</literal> distribution." | |
5003 | msgstr "" | |
5004 | ||
5005 | #. type: Content of: <refentry><refsect1><refsect2><title> | |
5006 | #: apt_preferences.5.xml:1 | |
5007 | msgid "Optional Lines in an APT Preferences Record" | |
5008 | msgstr "" | |
5009 | ||
5010 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
5011 | #: apt_preferences.5.xml:1 | |
5012 | msgid "" | |
5013 | "Each record in the APT preferences file can optionally begin with one or " | |
5014 | "more lines beginning with the word <literal>Explanation:</literal>. This " | |
5015 | "provides a place for comments." | |
5016 | msgstr "" | |
5017 | ||
5018 | #. type: Content of: <refentry><refsect1><refsect2><title> | |
5019 | #: apt_preferences.5.xml:1 | |
5020 | msgid "Tracking Stable" | |
5021 | msgstr "" | |
5022 | ||
5023 | #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> | |
5024 | #: apt_preferences.5.xml:1 | |
5025 | #, no-wrap | |
5026 | msgid "" | |
5027 | "Explanation: Uninstall or do not install any Debian-originated\n" | |
5028 | "Explanation: package versions other than those in the stable distro\n" | |
5029 | "Package: *\n" | |
5030 | "Pin: release a=stable\n" | |
5031 | "Pin-Priority: 900\n" | |
5032 | "\n" | |
5033 | "Package: *\n" | |
5034 | "Pin: release o=Debian\n" | |
5035 | "Pin-Priority: -10\n" | |
5036 | msgstr "" | |
5037 | ||
5038 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
5039 | #: apt_preferences.5.xml:1 | |
5040 | msgid "" | |
5041 | "The following APT preferences file will cause APT to assign a priority " | |
5042 | "higher than the default (500) to all package versions belonging to a " | |
5043 | "<literal>stable</literal> distribution and a prohibitively low priority to " | |
5044 | "package versions belonging to other <literal>Debian</literal> " | |
5045 | "distributions. <placeholder type=\"programlisting\" id=\"0\"/>" | |
5046 | msgstr "" | |
5047 | ||
5048 | #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> | |
5049 | #: apt_preferences.5.xml:1 apt_preferences.5.xml:1 apt_preferences.5.xml:1 | |
5050 | #, no-wrap | |
5051 | msgid "" | |
5052 | "apt-get install <replaceable>package-name</replaceable>\n" | |
5053 | "apt-get upgrade\n" | |
5054 | "apt-get dist-upgrade\n" | |
5055 | msgstr "" | |
5056 | ||
5057 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
5058 | #: apt_preferences.5.xml:1 | |
5059 | msgid "" | |
5060 | "With a suitable &sources-list; file and the above preferences file, any of " | |
5061 | "the following commands will cause APT to upgrade to the latest " | |
5062 | "<literal>stable</literal> version(s). <placeholder type=\"programlisting\" " | |
5063 | "id=\"0\"/>" | |
5064 | msgstr "" | |
5065 | ||
5066 | #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> | |
5067 | #: apt_preferences.5.xml:1 | |
5068 | #, no-wrap | |
5069 | msgid "apt-get install <replaceable>package</replaceable>/testing\n" | |
5070 | msgstr "" | |
5071 | ||
5072 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
5073 | #: apt_preferences.5.xml:1 | |
5074 | msgid "" | |
5075 | "The following command will cause APT to upgrade the specified package to the " | |
5076 | "latest version from the <literal>testing</literal> distribution; the package " | |
5077 | "will not be upgraded again unless this command is given again. <placeholder " | |
5078 | "type=\"programlisting\" id=\"0\"/>" | |
5079 | msgstr "" | |
5080 | ||
5081 | #. type: Content of: <refentry><refsect1><refsect2><title> | |
5082 | #: apt_preferences.5.xml:1 | |
5083 | msgid "Tracking Testing or Unstable" | |
5084 | msgstr "" | |
5085 | ||
5086 | #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> | |
5087 | #: apt_preferences.5.xml:1 | |
5088 | #, no-wrap | |
5089 | msgid "" | |
5090 | "Package: *\n" | |
5091 | "Pin: release a=testing\n" | |
5092 | "Pin-Priority: 900\n" | |
5093 | "\n" | |
5094 | "Package: *\n" | |
5095 | "Pin: release a=unstable\n" | |
5096 | "Pin-Priority: 800\n" | |
5097 | "\n" | |
5098 | "Package: *\n" | |
5099 | "Pin: release o=Debian\n" | |
5100 | "Pin-Priority: -10\n" | |
5101 | msgstr "" | |
5102 | ||
5103 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
5104 | #: apt_preferences.5.xml:1 | |
5105 | msgid "" | |
5106 | "The following APT preferences file will cause APT to assign a high priority " | |
5107 | "to package versions from the <literal>testing</literal> distribution, a " | |
5108 | "lower priority to package versions from the <literal>unstable</literal> " | |
5109 | "distribution, and a prohibitively low priority to package versions from " | |
5110 | "other <literal>Debian</literal> distributions. <placeholder " | |
5111 | "type=\"programlisting\" id=\"0\"/>" | |
5112 | msgstr "" | |
5113 | ||
5114 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
5115 | #: apt_preferences.5.xml:1 | |
5116 | msgid "" | |
5117 | "With a suitable &sources-list; file and the above preferences file, any of " | |
5118 | "the following commands will cause APT to upgrade to the latest " | |
5119 | "<literal>testing</literal> version(s). <placeholder type=\"programlisting\" " | |
5120 | "id=\"0\"/>" | |
5121 | msgstr "" | |
5122 | ||
5123 | #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> | |
5124 | #: apt_preferences.5.xml:1 | |
5125 | #, no-wrap | |
5126 | msgid "apt-get install <replaceable>package</replaceable>/unstable\n" | |
5127 | msgstr "" | |
5128 | ||
5129 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
5130 | #: apt_preferences.5.xml:1 | |
5131 | msgid "" | |
5132 | "The following command will cause APT to upgrade the specified package to the " | |
5133 | "latest version from the <literal>unstable</literal> distribution. " | |
5134 | "Thereafter, <command>apt-get upgrade</command> will upgrade the package to " | |
5135 | "the most recent <literal>testing</literal> version if that is more recent " | |
5136 | "than the installed version, otherwise, to the most recent " | |
5137 | "<literal>unstable</literal> version if that is more recent than the " | |
5138 | "installed version. <placeholder type=\"programlisting\" id=\"0\"/>" | |
5139 | msgstr "" | |
5140 | ||
5141 | #. type: Content of: <refentry><refsect1><refsect2><title> | |
5142 | #: apt_preferences.5.xml:1 | |
5143 | msgid "Tracking the evolution of a codename release" | |
5144 | msgstr "" | |
5145 | ||
5146 | #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> | |
5147 | #: apt_preferences.5.xml:1 | |
5148 | #, no-wrap | |
5149 | msgid "" | |
5150 | "Explanation: Uninstall or do not install any Debian-originated package " | |
5151 | "versions\n" | |
5152 | "Explanation: other than those in the distribution codenamed with " | |
5153 | "&testing-codename; or sid\n" | |
5154 | "Package: *\n" | |
5155 | "Pin: release n=&testing-codename;\n" | |
5156 | "Pin-Priority: 900\n" | |
5157 | "\n" | |
5158 | "Explanation: Debian unstable is always codenamed with sid\n" | |
5159 | "Package: *\n" | |
5160 | "Pin: release n=sid\n" | |
5161 | "Pin-Priority: 800\n" | |
5162 | "\n" | |
5163 | "Package: *\n" | |
5164 | "Pin: release o=Debian\n" | |
5165 | "Pin-Priority: -10\n" | |
5166 | msgstr "" | |
5167 | ||
5168 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
5169 | #: apt_preferences.5.xml:1 | |
5170 | msgid "" | |
5171 | "The following APT preferences file will cause APT to assign a priority " | |
5172 | "higher than the default (500) to all package versions belonging to a " | |
5173 | "specified codename of a distribution and a prohibitively low priority to " | |
5174 | "package versions belonging to other <literal>Debian</literal> distributions, " | |
5175 | "codenames and archives. Note that with this APT preference APT will follow " | |
5176 | "the migration of a release from the archive <literal>testing</literal> to " | |
5177 | "<literal>stable</literal> and later <literal>oldstable</literal>. If you " | |
5178 | "want to follow for example the progress in <literal>testing</literal> " | |
5179 | "notwithstanding the codename changes you should use the example " | |
5180 | "configurations above. <placeholder type=\"programlisting\" id=\"0\"/>" | |
5181 | msgstr "" | |
5182 | ||
5183 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
5184 | #: apt_preferences.5.xml:1 | |
5185 | msgid "" | |
5186 | "With a suitable &sources-list; file and the above preferences file, any of " | |
5187 | "the following commands will cause APT to upgrade to the latest version(s) in " | |
5188 | "the release codenamed with <literal>&testing-codename;</literal>. " | |
5189 | "<placeholder type=\"programlisting\" id=\"0\"/>" | |
5190 | msgstr "" | |
5191 | ||
5192 | #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> | |
5193 | #: apt_preferences.5.xml:1 | |
5194 | #, no-wrap | |
5195 | msgid "apt-get install <replaceable>package</replaceable>/sid\n" | |
5196 | msgstr "" | |
5197 | ||
5198 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
5199 | #: apt_preferences.5.xml:1 | |
5200 | msgid "" | |
5201 | "The following command will cause APT to upgrade the specified package to the " | |
5202 | "latest version from the <literal>sid</literal> distribution. Thereafter, " | |
5203 | "<command>apt-get upgrade</command> will upgrade the package to the most " | |
5204 | "recent <literal>&testing-codename;</literal> version if that is more recent " | |
5205 | "than the installed version, otherwise, to the most recent " | |
5206 | "<literal>sid</literal> version if that is more recent than the installed " | |
5207 | "version. <placeholder type=\"programlisting\" id=\"0\"/>" | |
5208 | msgstr "" | |
5209 | ||
5210 | #. type: Content of: <refentry><refsect1><para> | |
5211 | #: apt_preferences.5.xml:1 | |
5212 | msgid "&apt-get; &apt-cache; &apt-conf; &sources-list;" | |
5213 | msgstr "" | |
5214 | ||
5215 | #. type: Content of: <refentry><refnamediv><refpurpose> | |
5216 | #: sources.list.5.xml:1 | |
5217 | msgid "List of configured APT data sources" | |
5218 | msgstr "" | |
5219 | ||
5220 | #. type: Content of: <refentry><refsect1><para> | |
5221 | #: sources.list.5.xml:1 | |
5222 | msgid "" | |
5223 | "The source list <filename>/etc/apt/sources.list</filename> and the files " | |
5224 | "contained in <filename>/etc/apt/sources.list.d/</filename> are designed to " | |
5225 | "support any number of active sources and a variety of source media. The " | |
5226 | "files list one source per line (one-line style) or contain multiline stanzas " | |
5227 | "defining one or more sources per stanza (deb822 style), with the most " | |
5228 | "preferred source listed first (in case a single version is available from " | |
5229 | "more than one source). The information available from the configured sources " | |
5230 | "is acquired by <command>apt-get update</command> (or by an equivalent " | |
5231 | "command from another APT front-end)." | |
5232 | msgstr "" | |
5233 | ||
5234 | #. type: Content of: <refentry><refsect1><title> | |
5235 | #: sources.list.5.xml:1 | |
5236 | msgid "sources.list.d" | |
5237 | msgstr "" | |
5238 | ||
5239 | #. type: Content of: <refentry><refsect1><para> | |
5240 | #: sources.list.5.xml:1 | |
5241 | msgid "" | |
5242 | "The <filename>/etc/apt/sources.list.d</filename> directory provides a way to " | |
5243 | "add sources.list entries in separate files. Two different file formats are " | |
5244 | "allowed as described in the next two sections. Filenames need to have " | |
5245 | "either the extension <filename>.list</filename> or " | |
5246 | "<filename>.sources</filename> depending on the contained format. The " | |
5247 | "filenames may only contain letters (a-z and A-Z), digits (0-9), underscore " | |
5248 | "(_), hyphen (-) and period (.) characters. Otherwise APT will print a " | |
5249 | "notice that it has ignored a file, unless that file matches a pattern in the " | |
5250 | "<literal>Dir::Ignore-Files-Silently</literal> configuration list - in which " | |
5251 | "case it will be silently ignored." | |
5252 | msgstr "" | |
5253 | ||
5254 | #. type: Content of: <refentry><refsect1><title> | |
5255 | #: sources.list.5.xml:1 | |
5256 | msgid "One-Line-Style Format" | |
5257 | msgstr "" | |
5258 | ||
5259 | #. type: Content of: <refentry><refsect1><para> | |
5260 | #: sources.list.5.xml:1 | |
5261 | msgid "" | |
5262 | "Files in this format have the extension <filename>.list</filename>. Each " | |
5263 | "line specifying a source starts with a type " | |
5264 | "(e.g. <literal>deb-src</literal>) followed by options and arguments for " | |
5265 | "this type. Individual entries cannot be continued onto a following " | |
5266 | "line. Empty lines are ignored, and a <literal>#</literal> character anywhere " | |
5267 | "on a line marks the remainder of that line as a comment. Consequently an " | |
5268 | "entry can be disabled by commenting out the entire line. If options should " | |
5269 | "be provided they are separated by spaces and all of them together are " | |
5270 | "enclosed by square brackets (<literal>[]</literal>) included in the line " | |
5271 | "after the type separated from it with a space. If an option allows multiple " | |
5272 | "values these are separated from each other with a comma " | |
5273 | "(<literal>,</literal>). An option name is separated from its value(s) by an " | |
5274 | "equals sign (<literal>=</literal>). Multivalue options also have " | |
5275 | "<literal>-=</literal> and <literal>+=</literal> as separators, which instead " | |
5276 | "of replacing the default with the given value(s) modify the default value(s) " | |
5277 | "to remove or include the given values." | |
5278 | msgstr "" | |
5279 | ||
5280 | #. type: Content of: <refentry><refsect1><para> | |
5281 | #: sources.list.5.xml:1 | |
5282 | msgid "" | |
5283 | "This is the traditional format and supported by all apt versions. Note that " | |
5284 | "not all options as described below are supported by all apt versions. Note " | |
5285 | "also that some older applications parsing this format on their own might not " | |
5286 | "expect to encounter options as they were uncommon before the introduction of " | |
5287 | "multi-architecture support." | |
5288 | msgstr "" | |
5289 | ||
5290 | #. type: Content of: <refentry><refsect1><title> | |
5291 | #: sources.list.5.xml:1 | |
5292 | msgid "deb822-Style Format" | |
5293 | msgstr "" | |
5294 | ||
5295 | #. type: Content of: <refentry><refsect1><para> | |
5296 | #: sources.list.5.xml:1 | |
5297 | msgid "" | |
5298 | "Files in this format have the extension <filename>.sources</filename>. The " | |
5299 | "format is similar in syntax to other files used by Debian and its " | |
5300 | "derivatives, such as the metadata files that apt will download from the " | |
5301 | "configured sources or the <filename>debian/control</filename> file in a " | |
5302 | "Debian source package. Individual entries are separated by an empty line; " | |
5303 | "additional empty lines are ignored, and a <literal>#</literal> character at " | |
5304 | "the start of the line marks the entire line as a comment. An entry can hence " | |
5305 | "be disabled by commenting out each line belonging to the stanza, but it is " | |
5306 | "usually easier to add the field \"Enabled: no\" to the stanza to disable the " | |
5307 | "entry. Removing the field or setting it to yes reenables it. Options have " | |
5308 | "the same syntax as every other field: A fieldname separated by a colon " | |
5309 | "(<literal>:</literal>) and optionally spaces from its value(s). Note " | |
5310 | "especially that multiple values are separated by spaces, not by commas as in " | |
5311 | "the one-line format. Multivalue fields like <literal>Architectures</literal> " | |
5312 | "also have <literal>Architectures-Add</literal> and " | |
5313 | "<literal>Architectures-Remove</literal> to modify the default value rather " | |
5314 | "than replacing it." | |
5315 | msgstr "" | |
5316 | ||
5317 | #. type: Content of: <refentry><refsect1><para> | |
5318 | #: sources.list.5.xml:1 | |
5319 | msgid "" | |
5320 | "This is a new format supported by apt itself since version 1.1. Previous " | |
5321 | "versions ignore such files with a notice message as described earlier. It " | |
5322 | "is intended to make this format gradually the default format, deprecating " | |
5323 | "the previously described one-line-style format, as it is easier to create, " | |
5324 | "extend and modify for humans and machines alike especially if a lot of " | |
5325 | "sources and/or options are involved. Developers who are working with and/or " | |
5326 | "parsing apt sources are highly encouraged to add support for this format and " | |
5327 | "to contact the APT team to coordinate and share this work. Users can freely " | |
5328 | "adopt this format already, but may encounter problems with software not " | |
5329 | "supporting the format yet." | |
5330 | msgstr "" | |
5331 | ||
5332 | #. type: Content of: <refentry><refsect1><title> | |
5333 | #: sources.list.5.xml:1 | |
5334 | msgid "The deb and deb-src Types: General Format" | |
5335 | msgstr "" | |
5336 | ||
5337 | #. type: Content of: <refentry><refsect1><para> | |
5338 | #: sources.list.5.xml:1 | |
5339 | msgid "" | |
5340 | "The <literal>deb</literal> type references a typical two-level Debian " | |
5341 | "archive, <filename>distribution/component</filename>. The " | |
5342 | "<literal>distribution</literal> is generally a suite name like " | |
5343 | "<literal>stable</literal> or <literal>testing</literal> or a codename like " | |
5344 | "<literal>&stable-codename;</literal> or " | |
5345 | "<literal>&testing-codename;</literal> while component is one of " | |
5346 | "<literal>main</literal>, <literal>contrib</literal> or " | |
5347 | "<literal>non-free</literal>. The <literal>deb-src</literal> type references " | |
5348 | "a Debian distribution's source code in the same form as the " | |
5349 | "<literal>deb</literal> type. A <literal>deb-src</literal> line is required " | |
5350 | "to fetch source indexes." | |
5351 | msgstr "" | |
5352 | ||
5353 | #. type: Content of: <refentry><refsect1><para> | |
5354 | #: sources.list.5.xml:1 | |
5355 | msgid "" | |
5356 | "The format for two one-line-style entries using the <literal>deb</literal> " | |
5357 | "and <literal>deb-src</literal> types is:" | |
5358 | msgstr "" | |
5359 | ||
5360 | #. type: Content of: <refentry><refsect1><literallayout> | |
5361 | #: sources.list.5.xml:1 | |
5362 | #, no-wrap | |
5363 | msgid "" | |
5364 | "deb [ option1=value1 option2=value2 ] uri suite [component1] [component2] " | |
5365 | "[...]\n" | |
5366 | "deb-src [ option1=value1 option2=value2 ] uri suite [component1] " | |
5367 | "[component2] [...]" | |
5368 | msgstr "" | |
5369 | ||
5370 | #. type: Content of: <refentry><refsect1><para><literallayout> | |
5371 | #: sources.list.5.xml:1 | |
5372 | #, no-wrap | |
5373 | msgid "" | |
5374 | " Types: deb deb-src\n" | |
5375 | " URIs: uri\n" | |
5376 | " Suites: suite\n" | |
5377 | " Components: [component1] [component2] [...]\n" | |
5378 | " option1: value1\n" | |
5379 | " option2: value2\n" | |
5380 | " " | |
5381 | msgstr "" | |
5382 | ||
5383 | #. type: Content of: <refentry><refsect1><para> | |
5384 | #: sources.list.5.xml:1 | |
5385 | msgid "" | |
5386 | "Alternatively the equivalent entry in deb822 style looks like this: " | |
5387 | "<placeholder type=\"literallayout\" id=\"0\"/>" | |
5388 | msgstr "" | |
5389 | ||
5390 | #. type: Content of: <refentry><refsect1><para> | |
5391 | #: sources.list.5.xml:1 | |
5392 | msgid "" | |
5393 | "The URI for the <literal>deb</literal> type must specify the base of the " | |
5394 | "Debian distribution, from which APT will find the information it needs. " | |
5395 | "<literal>suite</literal> can specify an exact path, in which case the " | |
5396 | "components must be omitted and <literal>suite</literal> must end with a " | |
5397 | "slash (<literal>/</literal>). This is useful for the case when only a " | |
5398 | "particular sub-directory of the archive denoted by the URI is of interest. " | |
5399 | "If <literal>suite</literal> does not specify an exact path, at least one " | |
5400 | "<literal>component</literal> must be present." | |
5401 | msgstr "" | |
5402 | ||
5403 | #. type: Content of: <refentry><refsect1><para> | |
5404 | #: sources.list.5.xml:1 | |
5405 | msgid "" | |
5406 | "<literal>suite</literal> may also contain a variable, " | |
5407 | "<literal>$(ARCH)</literal> which expands to the Debian architecture (such as " | |
5408 | "<literal>amd64</literal> or <literal>armel</literal>) used on the " | |
5409 | "system. This permits architecture-independent " | |
5410 | "<filename>sources.list</filename> files to be used. In general this is only " | |
5411 | "of interest when specifying an exact path; <literal>APT</literal> will " | |
5412 | "automatically generate a URI with the current architecture otherwise." | |
5413 | msgstr "" | |
5414 | ||
5415 | #. type: Content of: <refentry><refsect1><para> | |
5416 | #: sources.list.5.xml:1 | |
5417 | msgid "" | |
5418 | "Especially in the one-line-style format since only one distribution can be " | |
5419 | "specified per line it may be necessary to have multiple lines for the same " | |
5420 | "URI, if a subset of all available distributions or components at that " | |
5421 | "location is desired. APT will sort the URI list after it has generated a " | |
5422 | "complete set internally, and will collapse multiple references to the same " | |
5423 | "Internet host, for instance, into a single connection, so that it does not " | |
5424 | "inefficiently establish a connection, close it, do something else, and then " | |
5425 | "re-establish a connection to that same host. APT also parallelizes " | |
5426 | "connections to different hosts to more effectively deal with sites with low " | |
5427 | "bandwidth." | |
5428 | msgstr "" | |
5429 | ||
5430 | #. type: Content of: <refentry><refsect1><para> | |
5431 | #: sources.list.5.xml:1 | |
5432 | msgid "" | |
5433 | "It is important to list sources in order of preference, with the most " | |
5434 | "preferred source listed first. Typically this will result in sorting by " | |
5435 | "speed from fastest to slowest (CD-ROM followed by hosts on a local network, " | |
5436 | "followed by distant Internet hosts, for example)." | |
5437 | msgstr "" | |
5438 | ||
5439 | #. type: Content of: <refentry><refsect1><para><literallayout> | |
5440 | #: sources.list.5.xml:1 | |
5441 | #, no-wrap | |
5442 | msgid "&sourceslist-list-format;" | |
5443 | msgstr "" | |
5444 | ||
5445 | #. type: Content of: <refentry><refsect1><para><literallayout> | |
5446 | #: sources.list.5.xml:1 | |
5447 | #, no-wrap | |
5448 | msgid "&sourceslist-sources-format;" | |
5449 | msgstr "" | |
5450 | ||
5451 | #. type: Content of: <refentry><refsect1><para> | |
5452 | #: sources.list.5.xml:1 | |
5453 | msgid "" | |
5454 | "As an example, the sources for your distribution could look like this in " | |
5455 | "one-line-style format: <placeholder type=\"literallayout\" id=\"0\"/> or " | |
5456 | "like this in deb822 style format: <placeholder type=\"literallayout\" " | |
5457 | "id=\"1\"/>" | |
5458 | msgstr "" | |
5459 | ||
5460 | #. type: Content of: <refentry><refsect1><title> | |
5461 | #: sources.list.5.xml:1 | |
5462 | msgid "The deb and deb-src types: Options" | |
5463 | msgstr "" | |
5464 | ||
5465 | #. type: Content of: <refentry><refsect1><para> | |
5466 | #: sources.list.5.xml:1 | |
5467 | msgid "" | |
5468 | "Each source entry can have options specified to modify which source is " | |
5469 | "accessed and how data is acquired from it. Format, syntax and names of the " | |
5470 | "options vary between the one-line-style and deb822-style formats as " | |
5471 | "described, but they both have the same options available. For simplicity we " | |
5472 | "list the deb822 fieldname and provide the one-line name in brackets. " | |
5473 | "Remember that besides setting multivalue options explicitly, there is also " | |
5474 | "the option to modify them based on the default, but we aren't listing those " | |
5475 | "names explicitly here. Unsupported options are silently ignored by all APT " | |
5476 | "versions." | |
5477 | msgstr "" | |
5478 | ||
5479 | #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> | |
5480 | #: sources.list.5.xml:1 | |
5481 | msgid "" | |
5482 | "<option>Architectures</option> (<option>arch</option>) is a multivalue " | |
5483 | "option defining for which architectures information should be downloaded. If " | |
5484 | "this option isn't set the default is all architectures as defined by the " | |
5485 | "<option>APT::Architectures</option> config option." | |
5486 | msgstr "" | |
5487 | ||
5488 | #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> | |
5489 | #: sources.list.5.xml:1 | |
5490 | msgid "" | |
5491 | "<option>Languages</option> (<option>lang</option>) is a multivalue option " | |
5492 | "defining for which languages information such as translated package " | |
5493 | "descriptions should be downloaded. If this option isn't set the default is " | |
5494 | "all languages as defined by the <option>Acquire::Languages</option> config " | |
5495 | "option." | |
5496 | msgstr "" | |
5497 | ||
5498 | #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> | |
5499 | #: sources.list.5.xml:1 | |
5500 | msgid "" | |
5501 | "<option>Targets</option> (<option>target</option>) is a multivalue option " | |
5502 | "defining which download targets apt will try to acquire from this source. If " | |
5503 | "not specified, the default set is defined by the " | |
5504 | "<option>Acquire::IndexTargets</option> configuration scope. Additionally, " | |
5505 | "specific targets can be enabled or disabled by using the identifier as field " | |
5506 | "name instead of using this multivalue option." | |
5507 | msgstr "" | |
5508 | ||
5509 | #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> | |
5510 | #: sources.list.5.xml:1 | |
5511 | msgid "" | |
5512 | "<option>PDiffs</option> (<option>pdiffs</option>) is a yes/no value which " | |
5513 | "controls if APT should try to use PDiffs to update old indexes instead of " | |
5514 | "downloading the new indexes entirely. The value of this option is ignored if " | |
5515 | "the repository doesn't announce the availability of PDiffs. Defaults to the " | |
5516 | "value of the option with the same name for a specific index file defined in " | |
5517 | "the <option>Acquire::IndexTargets</option> scope, which itself defaults to " | |
5518 | "the value of configuration option <option>Acquire::PDiffs</option> which " | |
5519 | "defaults to <literal>yes</literal>." | |
5520 | msgstr "" | |
5521 | ||
5522 | #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> | |
5523 | #: sources.list.5.xml:1 | |
5524 | msgid "" | |
5525 | "<option>By-Hash</option> (<option>by-hash</option>) can have the value " | |
5526 | "<literal>yes</literal>, <literal>no</literal> or <literal>force</literal> " | |
5527 | "and controls if APT should try to acquire indexes via a URI constructed from " | |
5528 | "a hashsum of the expected file instead of using the well-known stable " | |
5529 | "filename of the index. Using this can avoid hashsum mismatches, but requires " | |
5530 | "a supporting mirror. A <literal>yes</literal> or <literal>no</literal> value " | |
5531 | "activates/disables the use of this feature if this source indicates support " | |
5532 | "for it, while <literal>force</literal> will enable the feature regardless of " | |
5533 | "what the source indicates. Defaults to the value of the option of the same " | |
5534 | "name for a specific index file defined in the " | |
5535 | "<option>Acquire::IndexTargets</option> scope, which itself defaults to the " | |
5536 | "value of configuration option <option>Acquire::By-Hash</option> which " | |
5537 | "defaults to <literal>yes</literal>." | |
5538 | msgstr "" | |
5539 | ||
5540 | #. type: Content of: <refentry><refsect1><para> | |
5541 | #: sources.list.5.xml:1 | |
5542 | msgid "" | |
5543 | "Furthermore, there are options which if set affect <emphasis>all</emphasis> " | |
5544 | "sources with the same URI and Suite, so they have to be set on all such " | |
5545 | "entries and can not be varied between different components. APT will try to " | |
5546 | "detect and error out on such anomalies." | |
5547 | msgstr "" | |
5548 | ||
5549 | #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> | |
5550 | #: sources.list.5.xml:1 | |
5551 | msgid "" | |
5552 | "<option>Trusted</option> (<option>trusted</option>) is a tri-state value " | |
5553 | "which defaults to APT deciding if a source is considered trusted or if " | |
5554 | "warnings should be raised before e.g. packages are installed from this " | |
5555 | "source. This option can be used to override that decision. The value " | |
5556 | "<literal>yes</literal> tells APT always to consider this source as trusted, " | |
5557 | "even if it doesn't pass authentication checks. It disables parts of " | |
5558 | "&apt-secure;, and should therefore only be used in a local and trusted " | |
5559 | "context (if at all) as otherwise security is breached. The value " | |
5560 | "<literal>no</literal> does the opposite, causing the source to be handled as " | |
5561 | "untrusted even if the authentication checks passed successfully. The default " | |
5562 | "value can't be set explicitly." | |
5563 | msgstr "" | |
5564 | ||
5565 | #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> | |
5566 | #: sources.list.5.xml:1 | |
5567 | msgid "" | |
5568 | "<option>Signed-By</option> (<option>signed-by</option>) is either an " | |
5569 | "absolute path to a keyring file (has to be accessible and readable for the " | |
5570 | "<literal>_apt</literal> user, so ensure everyone has read-permissions on the " | |
5571 | "file) or a fingerprint of a key either in the " | |
5572 | "<filename>trusted.gpg</filename> keyring or in one of the keyrings in the " | |
5573 | "<filename>trusted.gpg.d/</filename> directory (see <command>apt-key " | |
5574 | "fingerprint</command>). If the option is set, only the key(s) in this " | |
5575 | "keyring or only the key with this fingerprint is used for the &apt-secure; " | |
5576 | "verification of this repository. Otherwise all keys in the trusted keyrings " | |
5577 | "are considered valid signers for this repository." | |
5578 | msgstr "" | |
5579 | ||
5580 | #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> | |
5581 | #: sources.list.5.xml:1 | |
5582 | msgid "" | |
5583 | "<option>Check-Valid-Until</option> (<option>check-valid-until</option>) is " | |
5584 | "a yes/no value which controls if APT should try to detect replay attacks. A " | |
5585 | "repository creator can declare a time until which the data provided in the " | |
5586 | "repository should be considered valid, and if this time is reached, but no " | |
5587 | "new data is provided, the data is considered expired and an error is " | |
5588 | "raised. Besides increasing security, as a malicious attacker can't send old " | |
5589 | "data forever to prevent a user from upgrading to a new version, this also " | |
5590 | "helps users identify mirrors which are no longer updated. However, some " | |
5591 | "repositories such as historic archives are not updated any more by design, " | |
5592 | "so this check can be disabled by setting this option to " | |
5593 | "<literal>no</literal>. Defaults to the value of configuration option " | |
5594 | "<option>Acquire::Check-Valid-Until</option> which itself defaults to " | |
5595 | "<literal>yes</literal>." | |
5596 | msgstr "" | |
5597 | ||
5598 | #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> | |
5599 | #: sources.list.5.xml:1 | |
5600 | msgid "" | |
5601 | "<option>Valid-Until-Min</option> (<option>valid-until-min</option>) and " | |
5602 | "<option>Valid-Until-Max</option> (<option>valid-until-max</option>) can be " | |
5603 | "used to raise or lower the time period in seconds in which the data from " | |
5604 | "this repository is considered valid. -Max can be especially useful if the " | |
5605 | "repository provides no Valid-Until field on its Release file to set your own " | |
5606 | "value, while -Min can be used to increase the valid time on seldom updated " | |
5607 | "(local) mirrors of a more frequently updated but less accessible archive " | |
5608 | "(which is in the sources.list as well) instead of disabling the check " | |
5609 | "entirely. Default to the value of the configuration options " | |
5610 | "<option>Acquire::Min-ValidTime</option> and " | |
5611 | "<option>Acquire::Max-ValidTime</option> which are both unset by default." | |
5612 | msgstr "" | |
5613 | ||
5614 | #. type: Content of: <refentry><refsect1><title> | |
5615 | #: sources.list.5.xml:1 | |
5616 | msgid "URI Specification" | |
5617 | msgstr "" | |
5618 | ||
5619 | #. type: Content of: <refentry><refsect1><para> | |
5620 | #: sources.list.5.xml:1 | |
5621 | msgid "The currently recognized URI types are:" | |
5622 | msgstr "" | |
5623 | ||
5624 | #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> | |
5625 | #: sources.list.5.xml:1 | |
5626 | msgid "" | |
5627 | "The file scheme allows an arbitrary directory in the file system to be " | |
5628 | "considered an archive. This is useful for NFS mounts and local mirrors or " | |
5629 | "archives." | |
5630 | msgstr "" | |
5631 | ||
5632 | #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> | |
5633 | #: sources.list.5.xml:1 | |
5634 | msgid "" | |
5635 | "The cdrom scheme allows APT to use a local CD-ROM drive with media " | |
5636 | "swapping. Use the &apt-cdrom; program to create cdrom entries in the source " | |
5637 | "list." | |
5638 | msgstr "" | |
5639 | ||
5640 | #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> | |
5641 | #: sources.list.5.xml:1 | |
5642 | msgid "" | |
5643 | "The http scheme specifies an HTTP server for the archive. If an environment " | |
5644 | "variable <envar>http_proxy</envar> is set with the format " | |
5645 | "http://server:port/, the proxy server specified in <envar>http_proxy</envar> " | |
5646 | "will be used. Users of authenticated HTTP/1.1 proxies may use a string of " | |
5647 | "the format http://user:pass@server:port/. Note that this is an insecure " | |
5648 | "method of authentication." | |
5649 | msgstr "" | |
5650 | ||
5651 | #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> | |
5652 | #: sources.list.5.xml:1 | |
5653 | msgid "" | |
5654 | "The ftp scheme specifies an FTP server for the archive. APT's FTP behavior " | |
5655 | "is highly configurable; for more information see the &apt-conf; manual " | |
5656 | "page. Please note that an FTP proxy can be specified by using the " | |
5657 | "<envar>ftp_proxy</envar> environment variable. It is possible to specify an " | |
5658 | "HTTP proxy (HTTP proxy servers often understand FTP URLs) using this " | |
5659 | "environment variable and <emphasis>only</emphasis> this environment " | |
5660 | "variable. Proxies using HTTP specified in the configuration file will be " | |
5661 | "ignored." | |
5662 | msgstr "" | |
5663 | ||
5664 | #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> | |
5665 | #: sources.list.5.xml:1 | |
5666 | msgid "" | |
5667 | "The copy scheme is identical to the file scheme except that packages are " | |
5668 | "copied into the cache directory instead of used directly at their location. " | |
5669 | "This is useful for people using removable media to copy files around with " | |
5670 | "APT." | |
5671 | msgstr "" | |
5672 | ||
5673 | #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> | |
5674 | #: sources.list.5.xml:1 | |
5675 | msgid "" | |
5676 | "The rsh/ssh method invokes RSH/SSH to connect to a remote host and access " | |
5677 | "the files as a given user. Prior configuration of rhosts or RSA keys is " | |
5678 | "recommended. The standard <command>find</command> and <command>dd</command> " | |
5679 | "commands are used to perform the file transfers from the remote host." | |
5680 | msgstr "" | |
5681 | ||
5682 | #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term> | |
5683 | #: sources.list.5.xml:1 | |
5684 | msgid "adding more recognizable URI types" | |
5685 | msgstr "" | |
5686 | ||
5687 | #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> | |
5688 | #: sources.list.5.xml:1 | |
5689 | msgid "" | |
5690 | "APT can be extended with more methods shipped in other optional packages, " | |
5691 | "which should follow the naming scheme " | |
5692 | "<package>apt-transport-<replaceable>method</replaceable></package>. For " | |
5693 | "instance, the APT team also maintains the package " | |
5694 | "<package>apt-transport-https</package>, which provides access methods for " | |
5695 | "HTTPS URIs with features similar to the http method. Methods for using " | |
5696 | "e.g. debtorrent are also available - see &apt-transport-debtorrent;." | |
5697 | msgstr "" | |
5698 | ||
5699 | #. type: Content of: <refentry><refsect1><para> | |
5700 | #: sources.list.5.xml:1 | |
5701 | msgid "" | |
5702 | "Uses the archive stored locally (or NFS mounted) at /home/apt/debian for " | |
5703 | "stable/main, stable/contrib, and stable/non-free." | |
5704 | msgstr "" | |
5705 | ||
5706 | #. type: Content of: <refentry><refsect1><literallayout> | |
5707 | #: sources.list.5.xml:1 | |
5708 | #, no-wrap | |
5709 | msgid "deb file:/home/apt/debian stable main contrib non-free" | |
5710 | msgstr "" | |
5711 | ||
5712 | #. type: Content of: <refentry><refsect1><literallayout> | |
5713 | #: sources.list.5.xml:1 | |
5714 | #, no-wrap | |
5715 | msgid "" | |
5716 | "Types: deb\n" | |
5717 | "URIs: file:/home/apt/debian\n" | |
5718 | "Suites: stable\n" | |
5719 | "Components: main contrib non-free" | |
5720 | msgstr "" | |
5721 | ||
5722 | #. type: Content of: <refentry><refsect1><para> | |
5723 | #: sources.list.5.xml:1 | |
5724 | msgid "As above, except this uses the unstable (development) distribution." | |
5725 | msgstr "" | |
5726 | ||
5727 | #. type: Content of: <refentry><refsect1><literallayout> | |
5728 | #: sources.list.5.xml:1 | |
5729 | #, no-wrap | |
5730 | msgid "deb file:/home/apt/debian unstable main contrib non-free" | |
5731 | msgstr "" | |
5732 | ||
5733 | #. type: Content of: <refentry><refsect1><literallayout> | |
5734 | #: sources.list.5.xml:1 | |
5735 | #, no-wrap | |
5736 | msgid "" | |
5737 | "Types: deb\n" | |
5738 | "URIs: file:/home/apt/debian\n" | |
5739 | "Suites: unstable\n" | |
5740 | "Components: main contrib non-free" | |
5741 | msgstr "" | |
5742 | ||
5743 | #. type: Content of: <refentry><refsect1><para> | |
5744 | #: sources.list.5.xml:1 | |
5745 | msgid "Sources specification for the above." | |
5746 | msgstr "" | |
5747 | ||
5748 | #. type: Content of: <refentry><refsect1><literallayout> | |
5749 | #: sources.list.5.xml:1 | |
5750 | #, no-wrap | |
5751 | msgid "deb-src file:/home/apt/debian unstable main contrib non-free" | |
5752 | msgstr "" | |
5753 | ||
5754 | #. type: Content of: <refentry><refsect1><literallayout> | |
5755 | #: sources.list.5.xml:1 | |
5756 | #, no-wrap | |
5757 | msgid "" | |
5758 | "Types: deb-src\n" | |
5759 | "URIs: file:/home/apt/debian\n" | |
5760 | "Suites: unstable\n" | |
5761 | "Components: main contrib non-free" | |
5762 | msgstr "" | |
5763 | ||
5764 | #. type: Content of: <refentry><refsect1><para> | |
5765 | #: sources.list.5.xml:1 | |
5766 | msgid "" | |
5767 | "The first line gets package information for the architectures in " | |
5768 | "<literal>APT::Architectures</literal> while the second always retrieves " | |
5769 | "<literal>amd64</literal> and <literal>armel</literal>." | |
5770 | msgstr "" | |
5771 | ||
5772 | #. type: Content of: <refentry><refsect1><literallayout> | |
5773 | #: sources.list.5.xml:1 | |
5774 | #, no-wrap | |
5775 | msgid "" | |
5776 | "deb http://httpredir.debian.org/debian &stable-codename; main\n" | |
5777 | "deb [ arch=amd64,armel ] http://httpredir.debian.org/debian " | |
5778 | "&stable-codename; main" | |
5779 | msgstr "" | |
5780 | ||
5781 | #. type: Content of: <refentry><refsect1><literallayout> | |
5782 | #: sources.list.5.xml:1 | |
5783 | #, no-wrap | |
5784 | msgid "" | |
5785 | "Types: deb\n" | |
5786 | "URIs: http://httpredir.debian.org/debian\n" | |
5787 | "Suites: &stable-codename;\n" | |
5788 | "Components: main\n" | |
5789 | "\n" | |
5790 | "Types: deb\n" | |
5791 | "URIs: http://httpredir.debian.org/debian\n" | |
5792 | "Suites: &stable-codename;\n" | |
5793 | "Components: main\n" | |
5794 | "Architectures: amd64 armel\n" | |
5795 | msgstr "" | |
5796 | ||
5797 | #. type: Content of: <refentry><refsect1><para> | |
5798 | #: sources.list.5.xml:1 | |
5799 | msgid "" | |
5800 | "Uses HTTP to access the archive at archive.debian.org, and uses only the " | |
5801 | "hamm/main area." | |
5802 | msgstr "" | |
5803 | ||
5804 | #. type: Content of: <refentry><refsect1><literallayout> | |
5805 | #: sources.list.5.xml:1 | |
5806 | #, no-wrap | |
5807 | msgid "deb http://archive.debian.org/debian-archive hamm main" | |
5808 | msgstr "" | |
5809 | ||
5810 | #. type: Content of: <refentry><refsect1><literallayout> | |
5811 | #: sources.list.5.xml:1 | |
5812 | #, no-wrap | |
5813 | msgid "" | |
5814 | "Types: deb\n" | |
5815 | "URIs: http://archive.debian.org/debian-archive\n" | |
5816 | "Suites: hamm\n" | |
5817 | "Components: main" | |
5818 | msgstr "" | |
5819 | ||
5820 | #. type: Content of: <refentry><refsect1><para> | |
5821 | #: sources.list.5.xml:1 | |
5822 | msgid "" | |
5823 | "Uses FTP to access the archive at ftp.debian.org, under the debian " | |
5824 | "directory, and uses only the &stable-codename;/contrib area." | |
5825 | msgstr "" | |
5826 | ||
5827 | #. type: Content of: <refentry><refsect1><literallayout> | |
5828 | #: sources.list.5.xml:1 | |
5829 | #, no-wrap | |
5830 | msgid "deb ftp://ftp.debian.org/debian &stable-codename; contrib" | |
5831 | msgstr "" | |
5832 | ||
5833 | #. type: Content of: <refentry><refsect1><literallayout> | |
5834 | #: sources.list.5.xml:1 | |
5835 | #, no-wrap | |
5836 | msgid "" | |
5837 | "Types: deb\n" | |
5838 | "URIs: ftp://ftp.debian.org/debian\n" | |
5839 | "Suites: &stable-codename;\n" | |
5840 | "Components: contrib" | |
5841 | msgstr "" | |
5842 | ||
5843 | #. type: Content of: <refentry><refsect1><para> | |
5844 | #: sources.list.5.xml:1 | |
5845 | msgid "" | |
5846 | "Uses FTP to access the archive at ftp.debian.org, under the debian " | |
5847 | "directory, and uses only the unstable/contrib area. If this line appears as " | |
5848 | "well as the one in the previous example in <filename>sources.list</filename> " | |
5849 | "a single FTP session will be used for both resource lines." | |
5850 | msgstr "" | |
5851 | ||
5852 | #. type: Content of: <refentry><refsect1><literallayout> | |
5853 | #: sources.list.5.xml:1 | |
5854 | #, no-wrap | |
5855 | msgid "deb ftp://ftp.debian.org/debian unstable contrib" | |
5856 | msgstr "" | |
5857 | ||
5858 | #. type: Content of: <refentry><refsect1><literallayout> | |
5859 | #: sources.list.5.xml:1 | |
5860 | #, no-wrap | |
5861 | msgid "" | |
5862 | "Types: deb\n" | |
5863 | "URIs: ftp://ftp.debian.org/debian\n" | |
5864 | "Suites: unstable\n" | |
5865 | "Components: contrib" | |
5866 | msgstr "" | |
5867 | ||
5868 | #. type: Content of: <refentry><refsect1><para><literallayout> | |
5869 | #: sources.list.5.xml:1 | |
5870 | #, no-wrap | |
5871 | msgid "deb http://ftp.tlh.debian.org/universe unstable/binary-$(ARCH)/" | |
5872 | msgstr "" | |
5873 | ||
5874 | #. type: Content of: <refentry><refsect1><para><literallayout> | |
5875 | #: sources.list.5.xml:1 | |
5876 | #, no-wrap | |
5877 | msgid "" | |
5878 | "Types: deb\n" | |
5879 | "URIs: http://ftp.tlh.debian.org/universe\n" | |
5880 | "Suites: unstable/binary-$(ARCH)/" | |
5881 | msgstr "" | |
5882 | ||
5883 | #. type: Content of: <refentry><refsect1><para> | |
5884 | #: sources.list.5.xml:1 | |
5885 | msgid "" | |
5886 | "Uses HTTP to access the archive at ftp.tlh.debian.org, under the universe " | |
5887 | "directory, and uses only files found under " | |
5888 | "<filename>unstable/binary-i386</filename> on i386 machines, " | |
5889 | "<filename>unstable/binary-amd64</filename> on amd64, and so forth for other " | |
5890 | "supported architectures. [Note this example only illustrates how to use the " | |
5891 | "substitution variable; official debian archives are not structured like " | |
5892 | "this] <placeholder type=\"literallayout\" id=\"0\"/> <placeholder " | |
5893 | "type=\"literallayout\" id=\"1\"/>" | |
5894 | msgstr "" | |
5895 | ||
5896 | #. type: Content of: <refentry><refsect1><para> | |
5897 | #: sources.list.5.xml:1 | |
5898 | msgid "" | |
5899 | "Uses HTTP to get binary packages as well as sources from the stable, testing " | |
5900 | "and unstable suites and the components main and contrib." | |
5901 | msgstr "" | |
5902 | ||
5903 | #. type: Content of: <refentry><refsect1><literallayout> | |
5904 | #: sources.list.5.xml:1 | |
5905 | #, no-wrap | |
5906 | msgid "" | |
5907 | "deb http://httpredir.debian.org/debian stable main contrib\n" | |
5908 | "deb-src http://httpredir.debian.org/debian stable main contrib\n" | |
5909 | "deb http://httpredir.debian.org/debian testing main contrib\n" | |
5910 | "deb-src http://httpredir.debian.org/debian testing main contrib\n" | |
5911 | "deb http://httpredir.debian.org/debian unstable main contrib\n" | |
5912 | "deb-src http://httpredir.debian.org/debian unstable main contrib" | |
5913 | msgstr "" | |
5914 | ||
5915 | #. type: Content of: <refentry><refsect1><literallayout> | |
5916 | #: sources.list.5.xml:1 | |
5917 | #, no-wrap | |
5918 | msgid "" | |
5919 | "Types: deb deb-src\n" | |
5920 | "URIs: http://httpredir.debian.org/debian\n" | |
5921 | "Suites: stable testing unstable\n" | |
5922 | "Components: main contrib\n" | |
5923 | msgstr "" | |
5924 | ||
5925 | #. type: Content of: <refentry><refsect1><para> | |
5926 | #: sources.list.5.xml:1 | |
5927 | msgid "&apt-get;, &apt-conf;" | |
5928 | msgstr "" | |
5929 | ||
5930 | #. type: Content of: <refentry><refmeta><manvolnum> | |
5931 | #: apt-extracttemplates.1.xml:1 apt-sortpkgs.1.xml:1 apt-ftparchive.1.xml:1 | |
5932 | msgid "1" | |
5933 | msgstr "" | |
5934 | ||
5935 | #. type: Content of: <refentry><refnamediv><refpurpose> | |
5936 | #: apt-extracttemplates.1.xml:1 | |
5937 | msgid "" | |
5938 | "Utility to extract <command>debconf</command> config and templates from " | |
5939 | "Debian packages" | |
5940 | msgstr "" | |
5941 | ||
5942 | #. type: Content of: <refentry><refsect1><para> | |
5943 | #: apt-extracttemplates.1.xml:1 | |
5944 | msgid "" | |
5945 | "<command>apt-extracttemplates</command> will take one or more Debian package " | |
5946 | "files as input and write out (to a temporary directory) all associated " | |
5947 | "config scripts and template files. For each passed in package that contains " | |
5948 | "config scripts and templates, one line of output will be generated in the " | |
5949 | "format:" | |
5950 | msgstr "" | |
5951 | ||
5952 | #. type: Content of: <refentry><refsect1><para> | |
5953 | #: apt-extracttemplates.1.xml:1 | |
5954 | msgid "package version template-file config-script" | |
5955 | msgstr "" | |
5956 | ||
5957 | #. type: Content of: <refentry><refsect1><para> | |
5958 | #: apt-extracttemplates.1.xml:1 | |
5959 | msgid "" | |
5960 | "template-file and config-script are written to the temporary directory " | |
5961 | "specified by the <option>-t</option> or <option>--tempdir</option> " | |
5962 | "(<literal>APT::ExtractTemplates::TempDir</literal>) directory, with " | |
5963 | "filenames of the form <filename>package.template.XXXXXX</filename> and " | |
5964 | "<filename>package.config.XXXXXX</filename>" | |
5965 | msgstr "" | |
5966 | ||
5967 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
5968 | #: apt-extracttemplates.1.xml:1 | |
5969 | msgid "" | |
5970 | "Temporary directory in which to write extracted <command>debconf</command> " | |
5971 | "template files and config scripts. Configuration Item: " | |
5972 | "<literal>APT::ExtractTemplates::TempDir</literal>" | |
5973 | msgstr "" | |
5974 | ||
5975 | #. type: Content of: <refentry><refsect1><para> | |
5976 | #: apt-extracttemplates.1.xml:1 | |
5977 | msgid "" | |
5978 | "<command>apt-extracttemplates</command> returns zero on normal operation, " | |
5979 | "decimal 100 on error." | |
5980 | msgstr "" | |
5981 | ||
5982 | #. type: Content of: <refentry><refnamediv><refpurpose> | |
5983 | #: apt-sortpkgs.1.xml:1 | |
5984 | msgid "Utility to sort package index files" | |
5985 | msgstr "" | |
5986 | ||
5987 | #. type: Content of: <refentry><refsect1><para> | |
5988 | #: apt-sortpkgs.1.xml:1 | |
5989 | msgid "" | |
5990 | "<command>apt-sortpkgs</command> will take an index file (source index or " | |
5991 | "package index) and sort the records so that they are ordered by the package " | |
5992 | "name. It will also sort the internal fields of each record according to the " | |
5993 | "internal sorting rules." | |
5994 | msgstr "" | |
5995 | ||
5996 | #. type: Content of: <refentry><refsect1><para> | |
5997 | #: apt-sortpkgs.1.xml:1 | |
5998 | msgid "All output is sent to standard output; the input must be a seekable file." | |
5999 | msgstr "" | |
6000 | ||
6001 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6002 | #: apt-sortpkgs.1.xml:1 | |
6003 | msgid "" | |
6004 | "Use source index field ordering. Configuration Item: " | |
6005 | "<literal>APT::SortPkgs::Source</literal>." | |
6006 | msgstr "" | |
6007 | ||
6008 | #. type: Content of: <refentry><refsect1><para> | |
6009 | #: apt-sortpkgs.1.xml:1 | |
6010 | msgid "" | |
6011 | "<command>apt-sortpkgs</command> returns zero on normal operation, decimal " | |
6012 | "100 on error." | |
6013 | msgstr "" | |
6014 | ||
6015 | #. type: Content of: <refentry><refnamediv><refpurpose> | |
6016 | #: apt-ftparchive.1.xml:1 | |
6017 | msgid "Utility to generate index files" | |
6018 | msgstr "" | |
6019 | ||
6020 | #. type: Content of: <refentry><refsect1><para> | |
6021 | #: apt-ftparchive.1.xml:1 | |
6022 | msgid "" | |
6023 | "<command>apt-ftparchive</command> is the command line tool that generates " | |
6024 | "the index files that APT uses to access a distribution source. The index " | |
6025 | "files should be generated on the origin site based on the content of that " | |
6026 | "site." | |
6027 | msgstr "" | |
6028 | ||
6029 | #. type: Content of: <refentry><refsect1><para> | |
6030 | #: apt-ftparchive.1.xml:1 | |
6031 | msgid "" | |
6032 | "<command>apt-ftparchive</command> is a superset of the &dpkg-scanpackages; " | |
6033 | "program, incorporating its entire functionality via the " | |
6034 | "<literal>packages</literal> command. It also contains a contents file " | |
6035 | "generator, <literal>contents</literal>, and an elaborate means to 'script' " | |
6036 | "the generation process for a complete archive." | |
6037 | msgstr "" | |
6038 | ||
6039 | #. type: Content of: <refentry><refsect1><para> | |
6040 | #: apt-ftparchive.1.xml:1 | |
6041 | msgid "" | |
6042 | "Internally <command>apt-ftparchive</command> can make use of binary " | |
6043 | "databases to cache the contents of a .deb file and it does not rely on any " | |
6044 | "external programs aside from &gzip;. When doing a full generate it " | |
6045 | "automatically performs file-change checks and builds the desired compressed " | |
6046 | "output files." | |
6047 | msgstr "" | |
6048 | ||
6049 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6050 | #: apt-ftparchive.1.xml:1 | |
6051 | msgid "" | |
6052 | "The packages command generates a package file from a directory tree. It " | |
6053 | "takes the given directory and recursively searches it for .deb files, " | |
6054 | "emitting a package record to stdout for each. This command is approximately " | |
6055 | "equivalent to &dpkg-scanpackages;." | |
6056 | msgstr "" | |
6057 | ||
6058 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6059 | #: apt-ftparchive.1.xml:1 apt-ftparchive.1.xml:1 | |
6060 | msgid "The option <option>--db</option> can be used to specify a binary caching DB." | |
6061 | msgstr "" | |
6062 | ||
6063 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6064 | #: apt-ftparchive.1.xml:1 | |
6065 | msgid "" | |
6066 | "The <literal>sources</literal> command generates a source index file from a " | |
6067 | "directory tree. It takes the given directory and recursively searches it " | |
6068 | "for .dsc files, emitting a source record to stdout for each. This command is " | |
6069 | "approximately equivalent to &dpkg-scansources;." | |
6070 | msgstr "" | |
6071 | ||
6072 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6073 | #: apt-ftparchive.1.xml:1 | |
6074 | msgid "" | |
6075 | "If an override file is specified then a source override file will be looked " | |
6076 | "for with an extension of .src. The --source-override option can be used to " | |
6077 | "change the source override file that will be used." | |
6078 | msgstr "" | |
6079 | ||
6080 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6081 | #: apt-ftparchive.1.xml:1 | |
6082 | msgid "" | |
6083 | "The <literal>contents</literal> command generates a contents file from a " | |
6084 | "directory tree. It takes the given directory and recursively searches it for " | |
6085 | ".deb files, and reads the file list from each file. It then sorts and writes " | |
6086 | "to stdout the list of files matched to packages. Directories are not written " | |
6087 | "to the output. If multiple packages own the same file then each package is " | |
6088 | "separated by a comma in the output." | |
6089 | msgstr "" | |
6090 | ||
6091 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6092 | #: apt-ftparchive.1.xml:1 | |
6093 | msgid "" | |
6094 | "The <literal>release</literal> command generates a Release file from a " | |
6095 | "directory tree. It recursively searches the given directory for uncompressed " | |
6096 | "<filename>Packages</filename> and <filename>Sources</filename> files and " | |
6097 | "ones compressed with <command>gzip</command>, <command>bzip2</command> or " | |
6098 | "<command>lzma</command> as well as <filename>Release</filename> and " | |
6099 | "<filename>md5sum.txt</filename> files by default " | |
6100 | "(<literal>APT::FTPArchive::Release::Default-Patterns</literal>). Additional " | |
6101 | "filename patterns can be added by listing them in " | |
6102 | "<literal>APT::FTPArchive::Release::Patterns</literal>. It then writes to " | |
6103 | "stdout a <filename>Release</filename> file containing (by default) an MD5, " | |
6104 | "SHA1, SHA256 and SHA512 digest for each file." | |
6105 | msgstr "" | |
6106 | ||
6107 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6108 | #: apt-ftparchive.1.xml:1 | |
6109 | msgid "" | |
6110 | "Values for the additional metadata fields in the Release file are taken from " | |
6111 | "the corresponding variables under " | |
6112 | "<literal>APT::FTPArchive::Release</literal>, " | |
6113 | "e.g. <literal>APT::FTPArchive::Release::Origin</literal>. The supported " | |
6114 | "fields are: <literal>Origin</literal>, <literal>Label</literal>, " | |
6115 | "<literal>Suite</literal>, <literal>Version</literal>, " | |
6116 | "<literal>Codename</literal>, <literal>Date</literal>, " | |
6117 | "<literal>Valid-Until</literal>, <literal>Architectures</literal>, " | |
6118 | "<literal>Components</literal>, <literal>Description</literal>." | |
6119 | msgstr "" | |
6120 | ||
6121 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6122 | #: apt-ftparchive.1.xml:1 | |
6123 | msgid "" | |
6124 | "The <literal>generate</literal> command is designed to be runnable from a " | |
6125 | "cron script and builds indexes according to the given config file. The " | |
6126 | "config language provides a flexible means of specifying which index files " | |
6127 | "are built from which directories, as well as providing a simple means of " | |
6128 | "maintaining the required settings." | |
6129 | msgstr "" | |
6130 | ||
6131 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6132 | #: apt-ftparchive.1.xml:1 | |
6133 | msgid "" | |
6134 | "The <literal>clean</literal> command tidies the databases used by the given " | |
6135 | "configuration file by removing any records that are no longer necessary." | |
6136 | msgstr "" | |
6137 | ||
6138 | #. type: Content of: <refentry><refsect1><title> | |
6139 | #: apt-ftparchive.1.xml:1 | |
6140 | msgid "The Generate Configuration" | |
6141 | msgstr "" | |
6142 | ||
6143 | #. type: Content of: <refentry><refsect1><para> | |
6144 | #: apt-ftparchive.1.xml:1 | |
6145 | msgid "" | |
6146 | "The <literal>generate</literal> command uses a configuration file to " | |
6147 | "describe the archives that are going to be generated. It follows the typical " | |
6148 | "ISC configuration format as seen in ISC tools like bind 8 and dhcpd. " | |
6149 | "&apt-conf; contains a description of the syntax. Note that the generate " | |
6150 | "configuration is parsed in sectional manner, but &apt-conf; is parsed in a " | |
6151 | "tree manner. This only effects how the scope tag is handled." | |
6152 | msgstr "" | |
6153 | ||
6154 | #. type: Content of: <refentry><refsect1><para> | |
6155 | #: apt-ftparchive.1.xml:1 | |
6156 | msgid "The generate configuration has four separate sections, each described below." | |
6157 | msgstr "" | |
6158 | ||
6159 | #. type: Content of: <refentry><refsect1><refsect2><title> | |
6160 | #: apt-ftparchive.1.xml:1 | |
6161 | msgid "<literal>Dir</literal> Section" | |
6162 | msgstr "" | |
6163 | ||
6164 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
6165 | #: apt-ftparchive.1.xml:1 | |
6166 | msgid "" | |
6167 | "The <literal>Dir</literal> section defines the standard directories needed " | |
6168 | "to locate the files required during the generation process. These " | |
6169 | "directories are prepended certain relative paths defined in later sections " | |
6170 | "to produce a complete an absolute path." | |
6171 | msgstr "" | |
6172 | ||
6173 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6174 | #: apt-ftparchive.1.xml:1 | |
6175 | msgid "" | |
6176 | "Specifies the root of the FTP archive, in a standard Debian configuration " | |
6177 | "this is the directory that contains the <filename>ls-LR</filename> and dist " | |
6178 | "nodes." | |
6179 | msgstr "" | |
6180 | ||
6181 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6182 | #: apt-ftparchive.1.xml:1 | |
6183 | msgid "Specifies the location of the override files." | |
6184 | msgstr "" | |
6185 | ||
6186 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6187 | #: apt-ftparchive.1.xml:1 | |
6188 | msgid "Specifies the location of the cache files." | |
6189 | msgstr "" | |
6190 | ||
6191 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6192 | #: apt-ftparchive.1.xml:1 | |
6193 | msgid "" | |
6194 | "Specifies the location of the file list files, if the " | |
6195 | "<literal>FileList</literal> setting is used below." | |
6196 | msgstr "" | |
6197 | ||
6198 | #. type: Content of: <refentry><refsect1><refsect2><title> | |
6199 | #: apt-ftparchive.1.xml:1 | |
6200 | msgid "<literal>Default</literal> Section" | |
6201 | msgstr "" | |
6202 | ||
6203 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
6204 | #: apt-ftparchive.1.xml:1 | |
6205 | msgid "" | |
6206 | "The <literal>Default</literal> section specifies default values, and " | |
6207 | "settings that control the operation of the generator. Other sections may " | |
6208 | "override these defaults with a per-section setting." | |
6209 | msgstr "" | |
6210 | ||
6211 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6212 | #: apt-ftparchive.1.xml:1 | |
6213 | msgid "" | |
6214 | "Sets the default compression schemes to use for the package index files. It " | |
6215 | "is a string that contains a space separated list of at least one of: '.' (no " | |
6216 | "compression), 'gzip' and 'bzip2'. The default for all compression schemes is " | |
6217 | "'. gzip'." | |
6218 | msgstr "" | |
6219 | ||
6220 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6221 | #: apt-ftparchive.1.xml:1 | |
6222 | msgid "" | |
6223 | "Sets the default list of file extensions that are package files. This " | |
6224 | "defaults to '.deb'." | |
6225 | msgstr "" | |
6226 | ||
6227 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6228 | #: apt-ftparchive.1.xml:1 | |
6229 | msgid "" | |
6230 | "This is similar to <literal>Packages::Compress</literal> except that it " | |
6231 | "controls the compression for the Sources files." | |
6232 | msgstr "" | |
6233 | ||
6234 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6235 | #: apt-ftparchive.1.xml:1 | |
6236 | msgid "" | |
6237 | "Sets the default list of file extensions that are source files. This " | |
6238 | "defaults to '.dsc'." | |
6239 | msgstr "" | |
6240 | ||
6241 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6242 | #: apt-ftparchive.1.xml:1 | |
6243 | msgid "" | |
6244 | "This is similar to <literal>Packages::Compress</literal> except that it " | |
6245 | "controls the compression for the Contents files." | |
6246 | msgstr "" | |
6247 | ||
6248 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6249 | #: apt-ftparchive.1.xml:1 | |
6250 | msgid "" | |
6251 | "This is similar to <literal>Packages::Compress</literal> except that it " | |
6252 | "controls the compression for the Translation-en master file." | |
6253 | msgstr "" | |
6254 | ||
6255 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6256 | #: apt-ftparchive.1.xml:1 | |
6257 | msgid "" | |
6258 | "Specifies the number of kilobytes to delink (and replace with hard links) " | |
6259 | "per run. This is used in conjunction with the per-section " | |
6260 | "<literal>External-Links</literal> setting." | |
6261 | msgstr "" | |
6262 | ||
6263 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6264 | #: apt-ftparchive.1.xml:1 | |
6265 | msgid "" | |
6266 | "Specifies the mode of all created index files. It defaults to 0644. All " | |
6267 | "index files are set to this mode with no regard to the umask." | |
6268 | msgstr "" | |
6269 | ||
6270 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6271 | #: apt-ftparchive.1.xml:1 apt-ftparchive.1.xml:1 | |
6272 | msgid "" | |
6273 | "Specifies whether long descriptions should be included in the " | |
6274 | "<filename>Packages</filename> file or split out into a master " | |
6275 | "<filename>Translation-en</filename> file." | |
6276 | msgstr "" | |
6277 | ||
6278 | #. type: Content of: <refentry><refsect1><refsect2><title> | |
6279 | #: apt-ftparchive.1.xml:1 | |
6280 | msgid "<literal>TreeDefault</literal> Section" | |
6281 | msgstr "" | |
6282 | ||
6283 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
6284 | #: apt-ftparchive.1.xml:1 | |
6285 | msgid "" | |
6286 | "Sets defaults specific to <literal>Tree</literal> sections. All of these " | |
6287 | "variables are substitution variables and have the strings $(DIST), " | |
6288 | "$(SECTION) and $(ARCH) replaced with their respective values." | |
6289 | msgstr "" | |
6290 | ||
6291 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6292 | #: apt-ftparchive.1.xml:1 | |
6293 | msgid "" | |
6294 | "Sets the number of kilobytes of contents files that are generated each " | |
6295 | "day. The contents files are round-robined so that over several days they " | |
6296 | "will all be rebuilt." | |
6297 | msgstr "" | |
6298 | ||
6299 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6300 | #: apt-ftparchive.1.xml:1 | |
6301 | msgid "" | |
6302 | "Controls the number of days a contents file is allowed to be checked without " | |
6303 | "changing. If this limit is passed the mtime of the contents file is " | |
6304 | "updated. This case can occur if the package file is changed in such a way " | |
6305 | "that does not result in a new contents file [override edit for instance]. A " | |
6306 | "hold off is allowed in hopes that new .debs will be installed, requiring a " | |
6307 | "new file anyhow. The default is 10, the units are in days." | |
6308 | msgstr "" | |
6309 | ||
6310 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6311 | #: apt-ftparchive.1.xml:1 | |
6312 | msgid "" | |
6313 | "Sets the top of the .deb directory tree. Defaults to " | |
6314 | "<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/</filename>" | |
6315 | msgstr "" | |
6316 | ||
6317 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6318 | #: apt-ftparchive.1.xml:1 | |
6319 | msgid "" | |
6320 | "Sets the top of the source package directory tree. Defaults to " | |
6321 | "<filename>$(DIST)/$(SECTION)/source/</filename>" | |
6322 | msgstr "" | |
6323 | ||
6324 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6325 | #: apt-ftparchive.1.xml:1 | |
6326 | msgid "" | |
6327 | "Sets the output Packages file. Defaults to " | |
6328 | "<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/Packages</filename>" | |
6329 | msgstr "" | |
6330 | ||
6331 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6332 | #: apt-ftparchive.1.xml:1 | |
6333 | msgid "" | |
6334 | "Sets the output Sources file. Defaults to " | |
6335 | "<filename>$(DIST)/$(SECTION)/source/Sources</filename>" | |
6336 | msgstr "" | |
6337 | ||
6338 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6339 | #: apt-ftparchive.1.xml:1 | |
6340 | msgid "" | |
6341 | "Sets the output Translation-en master file with the long descriptions if " | |
6342 | "they should be not included in the Packages file. Defaults to " | |
6343 | "<filename>$(DIST)/$(SECTION)/i18n/Translation-en</filename>" | |
6344 | msgstr "" | |
6345 | ||
6346 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6347 | #: apt-ftparchive.1.xml:1 | |
6348 | msgid "" | |
6349 | "Sets the path prefix that causes a symlink to be considered an internal link " | |
6350 | "instead of an external link. Defaults to " | |
6351 | "<filename>$(DIST)/$(SECTION)/</filename>" | |
6352 | msgstr "" | |
6353 | ||
6354 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6355 | #: apt-ftparchive.1.xml:1 | |
6356 | msgid "" | |
6357 | "Sets the output Contents file. Defaults to " | |
6358 | "<filename>$(DIST)/$(SECTION)/Contents-$(ARCH)</filename>. If this setting " | |
6359 | "causes multiple Packages files to map onto a single Contents file (as is the " | |
6360 | "default) then <command>apt-ftparchive</command> will integrate those " | |
6361 | "package files together automatically." | |
6362 | msgstr "" | |
6363 | ||
6364 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6365 | #: apt-ftparchive.1.xml:1 | |
6366 | msgid "Sets header file to prepend to the contents output." | |
6367 | msgstr "" | |
6368 | ||
6369 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6370 | #: apt-ftparchive.1.xml:1 | |
6371 | msgid "" | |
6372 | "Sets the binary cache database to use for this section. Multiple sections " | |
6373 | "can share the same database." | |
6374 | msgstr "" | |
6375 | ||
6376 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6377 | #: apt-ftparchive.1.xml:1 | |
6378 | msgid "" | |
6379 | "Specifies that instead of walking the directory tree, " | |
6380 | "<command>apt-ftparchive</command> should read the list of files from the " | |
6381 | "given file. Relative files names are prefixed with the archive directory." | |
6382 | msgstr "" | |
6383 | ||
6384 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6385 | #: apt-ftparchive.1.xml:1 | |
6386 | msgid "" | |
6387 | "Specifies that instead of walking the directory tree, " | |
6388 | "<command>apt-ftparchive</command> should read the list of files from the " | |
6389 | "given file. Relative files names are prefixed with the archive directory. " | |
6390 | "This is used when processing source indexes." | |
6391 | msgstr "" | |
6392 | ||
6393 | #. type: Content of: <refentry><refsect1><refsect2><title> | |
6394 | #: apt-ftparchive.1.xml:1 | |
6395 | msgid "<literal>Tree</literal> Section" | |
6396 | msgstr "" | |
6397 | ||
6398 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
6399 | #: apt-ftparchive.1.xml:1 | |
6400 | msgid "" | |
6401 | "The <literal>Tree</literal> section defines a standard Debian file tree " | |
6402 | "which consists of a base directory, then multiple sections in that base " | |
6403 | "directory and finally multiple Architectures in each section. The exact " | |
6404 | "pathing used is defined by the <literal>Directory</literal> substitution " | |
6405 | "variable." | |
6406 | msgstr "" | |
6407 | ||
6408 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
6409 | #: apt-ftparchive.1.xml:1 | |
6410 | msgid "" | |
6411 | "The <literal>Tree</literal> section takes a scope tag which sets the " | |
6412 | "<literal>$(DIST)</literal> variable and defines the root of the tree (the " | |
6413 | "path is prefixed by <literal>ArchiveDir</literal>). Typically this is a " | |
6414 | "setting such as <filename>dists/&stable-codename;</filename>." | |
6415 | msgstr "" | |
6416 | ||
6417 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
6418 | #: apt-ftparchive.1.xml:1 | |
6419 | msgid "" | |
6420 | "All of the settings defined in the <literal>TreeDefault</literal> section " | |
6421 | "can be used in a <literal>Tree</literal> section as well as three new " | |
6422 | "variables." | |
6423 | msgstr "" | |
6424 | ||
6425 | #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> | |
6426 | #: apt-ftparchive.1.xml:1 | |
6427 | #, no-wrap | |
6428 | msgid "" | |
6429 | "for i in Sections do \n" | |
6430 | " for j in Architectures do\n" | |
6431 | " Generate for DIST=scope SECTION=i ARCH=j\n" | |
6432 | " " | |
6433 | msgstr "" | |
6434 | ||
6435 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
6436 | #: apt-ftparchive.1.xml:1 | |
6437 | msgid "" | |
6438 | "When processing a <literal>Tree</literal> section " | |
6439 | "<command>apt-ftparchive</command> performs an operation similar to: " | |
6440 | "<placeholder type=\"programlisting\" id=\"0\"/>" | |
6441 | msgstr "" | |
6442 | ||
6443 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6444 | #: apt-ftparchive.1.xml:1 | |
6445 | msgid "" | |
6446 | "This is a space separated list of sections which appear under the " | |
6447 | "distribution; typically this is something like <literal>main contrib " | |
6448 | "non-free</literal>" | |
6449 | msgstr "" | |
6450 | ||
6451 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6452 | #: apt-ftparchive.1.xml:1 | |
6453 | msgid "" | |
6454 | "This is a space separated list of all the architectures that appear under " | |
6455 | "search section. The special architecture 'source' is used to indicate that " | |
6456 | "this tree has a source archive. The architecture 'all' signals that " | |
6457 | "architecture specific files like <filename>Packages</filename> should not " | |
6458 | "include information about architecture <literal>all</literal> packages in " | |
6459 | "all files as they will be available in a dedicated file." | |
6460 | msgstr "" | |
6461 | ||
6462 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6463 | #: apt-ftparchive.1.xml:1 | |
6464 | msgid "" | |
6465 | "Sets the binary override file. The override file contains section, priority " | |
6466 | "and maintainer address information." | |
6467 | msgstr "" | |
6468 | ||
6469 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6470 | #: apt-ftparchive.1.xml:1 | |
6471 | msgid "" | |
6472 | "Sets the source override file. The override file contains section " | |
6473 | "information." | |
6474 | msgstr "" | |
6475 | ||
6476 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6477 | #: apt-ftparchive.1.xml:1 apt-ftparchive.1.xml:1 | |
6478 | msgid "Sets the binary extra override file." | |
6479 | msgstr "" | |
6480 | ||
6481 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6482 | #: apt-ftparchive.1.xml:1 apt-ftparchive.1.xml:1 | |
6483 | msgid "Sets the source extra override file." | |
6484 | msgstr "" | |
6485 | ||
6486 | #. type: Content of: <refentry><refsect1><refsect2><title> | |
6487 | #: apt-ftparchive.1.xml:1 | |
6488 | msgid "<literal>BinDirectory</literal> Section" | |
6489 | msgstr "" | |
6490 | ||
6491 | #. type: Content of: <refentry><refsect1><refsect2><para> | |
6492 | #: apt-ftparchive.1.xml:1 | |
6493 | msgid "" | |
6494 | "The <literal>bindirectory</literal> section defines a binary directory tree " | |
6495 | "with no special structure. The scope tag specifies the location of the " | |
6496 | "binary directory and the settings are similar to the <literal>Tree</literal> " | |
6497 | "section with no substitution variables or " | |
6498 | "<literal>Section</literal><literal>Architecture</literal> settings." | |
6499 | msgstr "" | |
6500 | ||
6501 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6502 | #: apt-ftparchive.1.xml:1 | |
6503 | msgid "Sets the Packages file output." | |
6504 | msgstr "" | |
6505 | ||
6506 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6507 | #: apt-ftparchive.1.xml:1 | |
6508 | msgid "" | |
6509 | "Sets the Sources file output. At least one of <literal>Packages</literal> or " | |
6510 | "<literal>Sources</literal> is required." | |
6511 | msgstr "" | |
6512 | ||
6513 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6514 | #: apt-ftparchive.1.xml:1 | |
6515 | msgid "Sets the Contents file output (optional)." | |
6516 | msgstr "" | |
6517 | ||
6518 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6519 | #: apt-ftparchive.1.xml:1 | |
6520 | msgid "Sets the binary override file." | |
6521 | msgstr "" | |
6522 | ||
6523 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6524 | #: apt-ftparchive.1.xml:1 | |
6525 | msgid "Sets the source override file." | |
6526 | msgstr "" | |
6527 | ||
6528 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6529 | #: apt-ftparchive.1.xml:1 | |
6530 | msgid "Sets the cache DB." | |
6531 | msgstr "" | |
6532 | ||
6533 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6534 | #: apt-ftparchive.1.xml:1 | |
6535 | msgid "Appends a path to all the output paths." | |
6536 | msgstr "" | |
6537 | ||
6538 | #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> | |
6539 | #: apt-ftparchive.1.xml:1 | |
6540 | msgid "Specifies the file list file." | |
6541 | msgstr "" | |
6542 | ||
6543 | #. type: Content of: <refentry><refsect1><title> | |
6544 | #: apt-ftparchive.1.xml:1 | |
6545 | msgid "The Binary Override File" | |
6546 | msgstr "" | |
6547 | ||
6548 | #. type: Content of: <refentry><refsect1><para> | |
6549 | #: apt-ftparchive.1.xml:1 | |
6550 | msgid "" | |
6551 | "The binary override file is fully compatible with &dpkg-scanpackages;. It " | |
6552 | "contains four fields separated by spaces. The first field is the package " | |
6553 | "name, the second is the priority to force that package to, the third is the " | |
6554 | "section to force that package to and the final field is the maintainer " | |
6555 | "permutation field." | |
6556 | msgstr "" | |
6557 | ||
6558 | #. type: Content of: <refentry><refsect1><para><literallayout> | |
6559 | #: apt-ftparchive.1.xml:1 | |
6560 | #, no-wrap | |
6561 | msgid "old [// oldn]* => new" | |
6562 | msgstr "" | |
6563 | ||
6564 | #. type: Content of: <refentry><refsect1><para><literallayout> | |
6565 | #: apt-ftparchive.1.xml:1 | |
6566 | #, no-wrap | |
6567 | msgid "new" | |
6568 | msgstr "" | |
6569 | ||
6570 | #. type: Content of: <refentry><refsect1><para> | |
6571 | #: apt-ftparchive.1.xml:1 | |
6572 | msgid "" | |
6573 | "The general form of the maintainer field is: <placeholder " | |
6574 | "type=\"literallayout\" id=\"0\"/> or simply, <placeholder " | |
6575 | "type=\"literallayout\" id=\"1\"/> The first form allows a double-slash " | |
6576 | "separated list of old email addresses to be specified. If any of those are " | |
6577 | "found then new is substituted for the maintainer field. The second form " | |
6578 | "unconditionally substitutes the maintainer field." | |
6579 | msgstr "" | |
6580 | ||
6581 | #. type: Content of: <refentry><refsect1><title> | |
6582 | #: apt-ftparchive.1.xml:1 | |
6583 | msgid "The Source Override File" | |
6584 | msgstr "" | |
6585 | ||
6586 | #. type: Content of: <refentry><refsect1><para> | |
6587 | #: apt-ftparchive.1.xml:1 | |
6588 | msgid "" | |
6589 | "The source override file is fully compatible with &dpkg-scansources;. It " | |
6590 | "contains two fields separated by spaces. The first field is the source " | |
6591 | "package name, the second is the section to assign it." | |
6592 | msgstr "" | |
6593 | ||
6594 | #. type: Content of: <refentry><refsect1><title> | |
6595 | #: apt-ftparchive.1.xml:1 | |
6596 | msgid "The Extra Override File" | |
6597 | msgstr "" | |
6598 | ||
6599 | #. type: Content of: <refentry><refsect1><para> | |
6600 | #: apt-ftparchive.1.xml:1 | |
6601 | msgid "" | |
6602 | "The extra override file allows any arbitrary tag to be added or replaced in " | |
6603 | "the output. It has three columns, the first is the package, the second is " | |
6604 | "the tag and the remainder of the line is the new value." | |
6605 | msgstr "" | |
6606 | ||
6607 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6608 | #: apt-ftparchive.1.xml:1 | |
6609 | msgid "" | |
6610 | "Generate the given checksum. These options default to on, when turned off " | |
6611 | "the generated index files will not have the checksum fields where possible. " | |
6612 | "Configuration Items: " | |
6613 | "<literal>APT::FTPArchive::<replaceable>Checksum</replaceable></literal> and " | |
6614 | "<literal>APT::FTPArchive::<replaceable>Index</replaceable>::<replaceable>Checksum</replaceable></literal> " | |
6615 | "where <literal><replaceable>Index</replaceable></literal> can be " | |
6616 | "<literal>Packages</literal>, <literal>Sources</literal> or " | |
6617 | "<literal>Release</literal> and " | |
6618 | "<literal><replaceable>Checksum</replaceable></literal> can be " | |
6619 | "<literal>MD5</literal>, <literal>SHA1</literal>, <literal>SHA256</literal> " | |
6620 | "or <literal>SHA512</literal>." | |
6621 | msgstr "" | |
6622 | ||
6623 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6624 | #: apt-ftparchive.1.xml:1 | |
6625 | msgid "" | |
6626 | "Use a binary caching DB. This has no effect on the generate command. " | |
6627 | "Configuration Item: <literal>APT::FTPArchive::DB</literal>." | |
6628 | msgstr "" | |
6629 | ||
6630 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6631 | #: apt-ftparchive.1.xml:1 | |
6632 | msgid "" | |
6633 | "Quiet; produces output suitable for logging, omitting progress indicators. " | |
6634 | "More q's will produce more quiet up to a maximum of 2. You can also use " | |
6635 | "<option>-q=#</option> to set the quiet level, overriding the configuration " | |
6636 | "file. Configuration Item: <literal>quiet</literal>." | |
6637 | msgstr "" | |
6638 | ||
6639 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6640 | #: apt-ftparchive.1.xml:1 | |
6641 | msgid "" | |
6642 | "Perform Delinking. If the <literal>External-Links</literal> setting is used " | |
6643 | "then this option actually enables delinking of the files. It defaults to on " | |
6644 | "and can be turned off with <option>--no-delink</option>. Configuration " | |
6645 | "Item: <literal>APT::FTPArchive::DeLinkAct</literal>." | |
6646 | msgstr "" | |
6647 | ||
6648 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6649 | #: apt-ftparchive.1.xml:1 | |
6650 | msgid "" | |
6651 | "Perform contents generation. When this option is set and package indexes are " | |
6652 | "being generated with a cache DB then the file listing will also be extracted " | |
6653 | "and stored in the DB for later use. When using the generate command this " | |
6654 | "option also allows the creation of any Contents files. The default is on. " | |
6655 | "Configuration Item: <literal>APT::FTPArchive::Contents</literal>." | |
6656 | msgstr "" | |
6657 | ||
6658 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6659 | #: apt-ftparchive.1.xml:1 | |
6660 | msgid "" | |
6661 | "Select the source override file to use with the <literal>sources</literal> " | |
6662 | "command. Configuration Item: " | |
6663 | "<literal>APT::FTPArchive::SourceOverride</literal>." | |
6664 | msgstr "" | |
6665 | ||
6666 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6667 | #: apt-ftparchive.1.xml:1 | |
6668 | msgid "" | |
6669 | "Make the caching databases read only. Configuration Item: " | |
6670 | "<literal>APT::FTPArchive::ReadOnlyDB</literal>." | |
6671 | msgstr "" | |
6672 | ||
6673 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6674 | #: apt-ftparchive.1.xml:1 | |
6675 | msgid "" | |
6676 | "Accept in the <literal>packages</literal> and <literal>contents</literal> " | |
6677 | "commands only package files matching <literal>*_arch.deb</literal> or " | |
6678 | "<literal>*_all.deb</literal> instead of all package files in the given " | |
6679 | "path. Configuration Item: <literal>APT::FTPArchive::Architecture</literal>." | |
6680 | msgstr "" | |
6681 | ||
6682 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6683 | #: apt-ftparchive.1.xml:1 | |
6684 | msgid "" | |
6685 | "&apt-ftparchive; caches as much as possible of metadata in a cachedb. If " | |
6686 | "packages are recompiled and/or republished with the same version again, this " | |
6687 | "will lead to problems as the now outdated cached metadata like size and " | |
6688 | "checksums will be used. With this option enabled this will no longer happen " | |
6689 | "as it will be checked if the file was changed. Note that this option is set " | |
6690 | "to \"<literal>false</literal>\" by default as it is not recommend to upload " | |
6691 | "multiply versions/builds of a package with the same versionnumber, so in " | |
6692 | "theory nobody will have these problems and therefore all these extra checks " | |
6693 | "are useless." | |
6694 | msgstr "" | |
6695 | ||
6696 | #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> | |
6697 | #: apt-ftparchive.1.xml:1 | |
6698 | msgid "" | |
6699 | "This configuration option defaults to \"<literal>true</literal>\" and should " | |
6700 | "only be set to <literal>\"false\"</literal> if the Archive generated with " | |
6701 | "&apt-ftparchive; also provides <filename>Translation</filename> files. Note " | |
6702 | "that the <filename>Translation-en</filename> master file can only be created " | |
6703 | "in the generate command." | |
6704 | msgstr "" | |
6705 | ||
6706 | #. type: Content of: <refentry><refsect1><para><programlisting> | |
6707 | #: apt-ftparchive.1.xml:1 | |
6708 | #, no-wrap | |
6709 | msgid "" | |
6710 | "<command>apt-ftparchive</command> packages " | |
6711 | "<replaceable>directory</replaceable> | <command>gzip</command> > " | |
6712 | "<filename>Packages.gz</filename>\n" | |
6713 | msgstr "" | |
6714 | ||
6715 | #. type: Content of: <refentry><refsect1><para> | |
6716 | #: apt-ftparchive.1.xml:1 | |
6717 | msgid "" | |
6718 | "To create a compressed Packages file for a directory containing binary " | |
6719 | "packages (.deb): <placeholder type=\"programlisting\" id=\"0\"/>" | |
6720 | msgstr "" | |
6721 | ||
6722 | #. type: Content of: <refentry><refsect1><para> | |
6723 | #: apt-ftparchive.1.xml:1 | |
6724 | msgid "" | |
6725 | "<command>apt-ftparchive</command> returns zero on normal operation, decimal " | |
6726 | "100 on error." | |
6727 | msgstr "" | |
6728 | ||
6729 | #. type: Attribute 'lang' of: <book> | |
6730 | #: guide.dbk:1 offline.dbk:1 | |
6731 | msgid "en" | |
6732 | msgstr "" | |
6733 | ||
6734 | #. type: Content of: <book><title> | |
6735 | #: guide.dbk:1 | |
6736 | msgid "APT User's Guide" | |
6737 | msgstr "" | |
6738 | ||
6739 | #. type: Content of: <book><bookinfo><authorgroup><author><personname> | |
6740 | #: guide.dbk:1 offline.dbk:1 | |
6741 | msgid "Jason Gunthorpe" | |
6742 | msgstr "" | |
6743 | ||
6744 | #. type: Content of: <book><bookinfo><authorgroup><author><email> | |
6745 | #: guide.dbk:1 offline.dbk:1 | |
6746 | msgid "jgg@debian.org" | |
6747 | msgstr "" | |
6748 | ||
6749 | #. type: Content of: <book><bookinfo><releaseinfo> | |
6750 | #: guide.dbk:1 offline.dbk:1 | |
6751 | msgid "Version &apt-product-version;" | |
6752 | msgstr "" | |
6753 | ||
6754 | #. type: Content of: <book><bookinfo><abstract><para> | |
6755 | #: guide.dbk:1 | |
6756 | msgid "" | |
6757 | "This document provides an overview of how to use the the APT package " | |
6758 | "manager." | |
6759 | msgstr "" | |
6760 | ||
6761 | #. type: Content of: <book><bookinfo> | |
6762 | #: guide.dbk:1 | |
6763 | msgid "<copyright><year>1998</year><holder>Jason Gunthorpe</holder></copyright>" | |
6764 | msgstr "" | |
6765 | ||
6766 | #. type: Content of: <book><bookinfo><legalnotice><title> | |
6767 | #: guide.dbk:1 offline.dbk:1 | |
6768 | msgid "License Notice" | |
6769 | msgstr "" | |
6770 | ||
6771 | #. type: Content of: <book><bookinfo><legalnotice><para> | |
6772 | #: guide.dbk:1 offline.dbk:1 | |
6773 | msgid "" | |
6774 | "\"APT\" and this document are free software; you can redistribute them " | |
6775 | "and/or modify them under the terms of the GNU General Public License as " | |
6776 | "published by the Free Software Foundation; either version 2 of the License, " | |
6777 | "or (at your option) any later version." | |
6778 | msgstr "" | |
6779 | ||
6780 | #. type: Content of: <book><bookinfo><legalnotice><para> | |
6781 | #: guide.dbk:1 offline.dbk:1 | |
6782 | msgid "" | |
6783 | "For more details, on Debian systems, see the file " | |
6784 | "/usr/share/common-licenses/GPL for the full license." | |
6785 | msgstr "" | |
6786 | ||
6787 | #. type: Content of: <book><chapter><title> | |
6788 | #: guide.dbk:1 | |
6789 | msgid "General" | |
6790 | msgstr "" | |
6791 | ||
6792 | #. type: Content of: <book><chapter><para> | |
6793 | #: guide.dbk:1 | |
6794 | msgid "" | |
6795 | "The APT package currently contains two sections, the APT " | |
6796 | "<command>dselect</command> method and the <command>apt-get</command> command " | |
6797 | "line user interface. Both provide a way to install and remove packages as " | |
6798 | "well as download new packages from the Internet." | |
6799 | msgstr "" | |
6800 | ||
6801 | #. type: Content of: <book><chapter><section><title> | |
6802 | #: guide.dbk:1 | |
6803 | msgid "Anatomy of the Package System" | |
6804 | msgstr "" | |
6805 | ||
6806 | #. type: Content of: <book><chapter><section><para> | |
6807 | #: guide.dbk:1 | |
6808 | msgid "" | |
6809 | "The Debian packaging system has a large amount of information associated " | |
6810 | "with each package to help assure that it integrates cleanly and easily into " | |
6811 | "the system. The most prominent of its features is the dependency system." | |
6812 | msgstr "" | |
6813 | ||
6814 | #. type: Content of: <book><chapter><section><para> | |
6815 | #: guide.dbk:1 | |
6816 | msgid "" | |
6817 | "The dependency system allows individual programs to make use of shared " | |
6818 | "elements in the system such as libraries. It simplifies placing infrequently " | |
6819 | "used portions of a program in separate packages to reduce the number of " | |
6820 | "things the average user is required to install. Also, it allows for choices " | |
6821 | "in mail transport agents, X servers and so on." | |
6822 | msgstr "" | |
6823 | ||
6824 | #. type: Content of: <book><chapter><section><para> | |
6825 | #: guide.dbk:1 | |
6826 | msgid "" | |
6827 | "The first step to understanding the dependency system is to grasp the " | |
6828 | "concept of a simple dependency. The meaning of a simple dependency is that a " | |
6829 | "package requires another package to be installed at the same time to work " | |
6830 | "properly." | |
6831 | msgstr "" | |
6832 | ||
6833 | #. type: Content of: <book><chapter><section><para> | |
6834 | #: guide.dbk:1 | |
6835 | msgid "" | |
6836 | "For instance, mailcrypt is an emacs extension that aids in encrypting email " | |
6837 | "with GPG. Without GPGP installed mailcrypt is useless, so mailcrypt has a " | |
6838 | "simple dependency on GPG. Also, because it is an emacs extension it has a " | |
6839 | "simple dependency on emacs, without emacs it is completely useless." | |
6840 | msgstr "" | |
6841 | ||
6842 | #. type: Content of: <book><chapter><section><para> | |
6843 | #: guide.dbk:1 | |
6844 | msgid "" | |
6845 | "The other important dependency to understand is a conflicting dependency. It " | |
6846 | "means that a package, when installed with another package, will not work and " | |
6847 | "may possibly be extremely harmful to the system. As an example consider a " | |
6848 | "mail transport agent such as sendmail, exim or qmail. It is not possible to " | |
6849 | "have two mail transport agents installed because both need to listen to the " | |
6850 | "network to receive mail. Attempting to install two will seriously damage the " | |
6851 | "system so all mail transport agents have a conflicting dependency with all " | |
6852 | "other mail transport agents." | |
6853 | msgstr "" | |
6854 | ||
6855 | #. type: Content of: <book><chapter><section><para> | |
6856 | #: guide.dbk:1 | |
6857 | msgid "" | |
6858 | "As an added complication there is the possibility for a package to pretend " | |
6859 | "to be another package. Consider that exim and sendmail for many intents are " | |
6860 | "identical, they both deliver mail and understand a common interface. Hence, " | |
6861 | "the package system has a way for them to declare that they are both " | |
6862 | "mail-transport-agents. So, exim and sendmail both declare that they provide " | |
6863 | "a mail-transport-agent and other packages that need a mail transport agent " | |
6864 | "depend on mail-transport-agent. This can add a great deal of confusion when " | |
6865 | "trying to manually fix packages." | |
6866 | msgstr "" | |
6867 | ||
6868 | #. type: Content of: <book><chapter><section><para> | |
6869 | #: guide.dbk:1 | |
6870 | msgid "" | |
6871 | "At any given time a single dependency may be met by packages that are " | |
6872 | "already installed or it may not be. APT attempts to help resolve dependency " | |
6873 | "issues by providing a number of automatic algorithms that help in selecting " | |
6874 | "packages for installation." | |
6875 | msgstr "" | |
6876 | ||
6877 | #. type: Content of: <book><chapter><title> | |
6878 | #: guide.dbk:1 | |
6879 | msgid "apt-get" | |
6880 | msgstr "" | |
6881 | ||
6882 | #. type: Content of: <book><chapter><para> | |
6883 | #: guide.dbk:1 | |
6884 | msgid "" | |
6885 | "<command>apt-get</command> provides a simple way to install packages from " | |
6886 | "the command line. Unlike <command>dpkg</command>, <command>apt-get</command> " | |
6887 | "does not understand .deb files, it works with the package's proper name and " | |
6888 | "can only install .deb archives from a <emphasis>Source</emphasis>." | |
6889 | msgstr "" | |
6890 | ||
6891 | #. type: Content of: <book><chapter><para><footnote><para> | |
6892 | #: guide.dbk:1 | |
6893 | msgid "" | |
6894 | "If you are using an http proxy server you must set the http_proxy " | |
6895 | "environment variable first, see sources.list(5)" | |
6896 | msgstr "" | |
6897 | ||
6898 | #. type: Content of: <book><chapter><para> | |
6899 | #: guide.dbk:1 | |
6900 | msgid "" | |
6901 | "The first <placeholder type=\"footnote\" id=\"0\"/> thing that should be " | |
6902 | "done before using <command>apt-get</command> is to fetch the package lists " | |
6903 | "from the <emphasis>Sources</emphasis> so that it knows what packages are " | |
6904 | "available. This is done with <literal>apt-get update</literal>. For " | |
6905 | "instance," | |
6906 | msgstr "" | |
6907 | ||
6908 | #. type: Content of: <book><chapter><screen> | |
6909 | #: guide.dbk:1 | |
6910 | #, no-wrap | |
6911 | msgid "" | |
6912 | "# apt-get update\n" | |
6913 | "Get http://ftp.de.debian.org/debian-non-US/ stable/binary-i386/ Packages\n" | |
6914 | "Get http://llug.sep.bnl.gov/debian/ testing/contrib Packages\n" | |
6915 | "Reading Package Lists... Done\n" | |
6916 | "Building Dependency Tree... Done\n" | |
6917 | msgstr "" | |
6918 | ||
6919 | #. type: Content of: <book><chapter><para> | |
6920 | #: guide.dbk:1 | |
6921 | msgid "Once updated there are several commands that can be used:" | |
6922 | msgstr "" | |
6923 | ||
6924 | #. type: Content of: <book><chapter><variablelist><varlistentry><term> | |
6925 | #: guide.dbk:1 | |
6926 | msgid "upgrade" | |
6927 | msgstr "" | |
6928 | ||
6929 | #. type: Content of: <book><chapter><variablelist><varlistentry><listitem><para> | |
6930 | #: guide.dbk:1 | |
6931 | msgid "" | |
6932 | "Upgrade will attempt to gently upgrade the whole system. Upgrade will never " | |
6933 | "install a new package or remove an existing package, nor will it ever " | |
6934 | "upgrade a package that might cause some other package to break. This can be " | |
6935 | "used daily to relatively safely upgrade the system. Upgrade will list all of " | |
6936 | "the packages that it could not upgrade, this usually means that they depend " | |
6937 | "on new packages or conflict with some other " | |
6938 | "package. <command>dselect</command> or <literal>apt-get install</literal> " | |
6939 | "can be used to force these packages to install." | |
6940 | msgstr "" | |
6941 | ||
6942 | #. type: Content of: <book><chapter><variablelist><varlistentry><term> | |
6943 | #: guide.dbk:1 | |
6944 | msgid "install" | |
6945 | msgstr "" | |
6946 | ||
6947 | #. type: Content of: <book><chapter><variablelist><varlistentry><listitem><para> | |
6948 | #: guide.dbk:1 | |
6949 | msgid "" | |
6950 | "Install is used to install packages by name. The package is automatically " | |
6951 | "fetched and installed. This can be useful if you already know the name of " | |
6952 | "the package to install and do not want to go into a GUI to select it. Any " | |
6953 | "number of packages may be passed to install, they will all be " | |
6954 | "fetched. Install automatically attempts to resolve dependency problems with " | |
6955 | "the listed packages and will print a summary and ask for confirmation if " | |
6956 | "anything other than its arguments are changed." | |
6957 | msgstr "" | |
6958 | ||
6959 | #. type: Content of: <book><chapter><variablelist><varlistentry><term> | |
6960 | #: guide.dbk:1 | |
6961 | msgid "dist-upgrade" | |
6962 | msgstr "" | |
6963 | ||
6964 | #. type: Content of: <book><chapter><variablelist><varlistentry><listitem><para> | |
6965 | #: guide.dbk:1 | |
6966 | msgid "" | |
6967 | "Dist-upgrade is a complete upgrader designed to simplify upgrading between " | |
6968 | "releases of Debian. It uses a sophisticated algorithm to determine the best " | |
6969 | "set of packages to install, upgrade and remove to get as much of the system " | |
6970 | "to the newest release. In some situations it may be desired to use " | |
6971 | "dist-upgrade rather than spend the time manually resolving dependencies in " | |
6972 | "<command>dselect</command>. Once dist-upgrade has completed then " | |
6973 | "<command>dselect</command> can be used to install any packages that may have " | |
6974 | "been left out." | |
6975 | msgstr "" | |
6976 | ||
6977 | #. type: Content of: <book><chapter><variablelist><varlistentry><listitem><para> | |
6978 | #: guide.dbk:1 | |
6979 | msgid "" | |
6980 | "It is important to closely look at what dist-upgrade is going to do, its " | |
6981 | "decisions may sometimes be quite surprising." | |
6982 | msgstr "" | |
6983 | ||
6984 | #. type: Content of: <book><chapter><para> | |
6985 | #: guide.dbk:1 | |
6986 | msgid "" | |
6987 | "<command>apt-get</command> has several command line options that are " | |
6988 | "detailed in its man page, " | |
6989 | "<citerefentry><refentrytitle>apt-get</refentrytitle><manvolnum>8</manvolnum></citerefentry>. " | |
6990 | "The most useful option is <literal>-d</literal> which does not install the " | |
6991 | "fetched files. If the system has to download a large number of package it " | |
6992 | "would be undesired to start installing them in case something goes " | |
6993 | "wrong. When <literal>-d</literal> is used the downloaded archives can be " | |
6994 | "installed by simply running the command that caused them to be downloaded " | |
6995 | "again without <literal>-d</literal>." | |
6996 | msgstr "" | |
6997 | ||
6998 | #. type: Content of: <book><chapter><title> | |
6999 | #: guide.dbk:1 | |
7000 | msgid "DSelect" | |
7001 | msgstr "" | |
7002 | ||
7003 | #. type: Content of: <book><chapter><para> | |
7004 | #: guide.dbk:1 | |
7005 | msgid "" | |
7006 | "The APT <command>dselect</command> method provides the complete APT system " | |
7007 | "with the <command>dselect</command> package selection " | |
7008 | "GUI. <command>dselect</command> is used to select the packages to be " | |
7009 | "installed or removed and APT actually installs them." | |
7010 | msgstr "" | |
7011 | ||
7012 | #. type: Content of: <book><chapter><para> | |
7013 | #: guide.dbk:1 | |
7014 | msgid "" | |
7015 | "To enable the APT method you need to select [A]ccess in " | |
7016 | "<command>dselect</command> and then choose the APT method. You will be " | |
7017 | "prompted for a set of <emphasis>Sources</emphasis> which are places to fetch " | |
7018 | "archives from. These can be remote Internet sites, local Debian mirrors or " | |
7019 | "CD-ROMs. Each source can provide a fragment of the total Debian archive, APT " | |
7020 | "will automatically combine them to form a complete set of packages. If you " | |
7021 | "have a CD-ROM then it is a good idea to specify it first and then specify a " | |
7022 | "mirror so that you have access to the latest bug fixes. APT will " | |
7023 | "automatically use packages on your CD-ROM before downloading from the " | |
7024 | "Internet." | |
7025 | msgstr "" | |
7026 | ||
7027 | #. type: Content of: <book><chapter><screen> | |
7028 | #: guide.dbk:1 | |
7029 | #, no-wrap | |
7030 | msgid "" | |
7031 | " Set up a list of distribution source locations\n" | |
7032 | "\n" | |
7033 | " Please give the base URL of the debian distribution.\n" | |
7034 | " The access schemes I know about are: http file\n" | |
7035 | "\n" | |
7036 | " For example:\n" | |
7037 | " file:/mnt/debian,\n" | |
7038 | " ftp://ftp.debian.org/debian,\n" | |
7039 | " http://ftp.de.debian.org/debian,\n" | |
7040 | "\n" | |
7041 | "\n" | |
7042 | " URL [http://llug.sep.bnl.gov/debian]:\n" | |
7043 | msgstr "" | |
7044 | ||
7045 | #. type: Content of: <book><chapter><para> | |
7046 | #: guide.dbk:1 | |
7047 | msgid "" | |
7048 | "The <emphasis>Sources</emphasis> setup starts by asking for the base of the " | |
7049 | "Debian archive, defaulting to a HTTP mirror. Next it asks for the " | |
7050 | "distribution to get." | |
7051 | msgstr "" | |
7052 | ||
7053 | #. type: Content of: <book><chapter><screen> | |
7054 | #: guide.dbk:1 | |
7055 | #, no-wrap | |
7056 | msgid "" | |
7057 | " Please give the distribution tag to get or a path to the\n" | |
7058 | " package file ending in a /. The distribution\n" | |
7059 | " tags are typically something like: stable unstable testing non-US\n" | |
7060 | "\n" | |
7061 | " Distribution [stable]:\n" | |
7062 | msgstr "" | |
7063 | ||
7064 | #. type: Content of: <book><chapter><para> | |
7065 | #: guide.dbk:1 | |
7066 | msgid "" | |
7067 | "The distribution refers to the Debian version in the archive, " | |
7068 | "<emphasis>stable</emphasis> refers to the latest released version and " | |
7069 | "<emphasis>unstable</emphasis> refers to the developmental " | |
7070 | "version. <emphasis>non-US</emphasis> is only available on some mirrors and " | |
7071 | "refers to packages that contain encryption technology or other things that " | |
7072 | "cannot be exported from the United States. Importing these packages into the " | |
7073 | "US is legal however." | |
7074 | msgstr "" | |
7075 | ||
7076 | #. type: Content of: <book><chapter><screen> | |
7077 | #: guide.dbk:1 | |
7078 | #, no-wrap | |
7079 | msgid "" | |
7080 | " Please give the components to get\n" | |
7081 | " The components are typically something like: main contrib non-free\n" | |
7082 | "\n" | |
7083 | " Components [main contrib non-free]:\n" | |
7084 | msgstr "" | |
7085 | ||
7086 | #. type: Content of: <book><chapter><para> | |
7087 | #: guide.dbk:1 | |
7088 | msgid "" | |
7089 | "The components list refers to the list of sub distributions to fetch. The " | |
7090 | "distribution is split up based on software licenses, main being DFSG free " | |
7091 | "packages while contrib and non-free contain things that have various " | |
7092 | "restrictions placed on their use and distribution." | |
7093 | msgstr "" | |
7094 | ||
7095 | #. type: Content of: <book><chapter><para> | |
7096 | #: guide.dbk:1 | |
7097 | msgid "" | |
7098 | "Any number of sources can be added, the setup script will continue to prompt " | |
7099 | "until you have specified all that you want." | |
7100 | msgstr "" | |
7101 | ||
7102 | #. type: Content of: <book><chapter><para> | |
7103 | #: guide.dbk:1 | |
7104 | msgid "" | |
7105 | "Before starting to use <command>dselect</command> it is necessary to update " | |
7106 | "the available list by selecting [U]pdate from the menu. This is a superset " | |
7107 | "of <literal>apt-get update</literal> that makes the fetched information " | |
7108 | "available to <command>dselect</command>. [U]pdate must be performed even if " | |
7109 | "<literal>apt-get update</literal> has been run before." | |
7110 | msgstr "" | |
7111 | ||
7112 | #. type: Content of: <book><chapter><para> | |
7113 | #: guide.dbk:1 | |
7114 | msgid "" | |
7115 | "You can then go on and make your selections using [S]elect and then perform " | |
7116 | "the installation using [I]nstall. When using the APT method the [C]onfig and " | |
7117 | "[R]emove commands have no meaning, the [I]nstall command performs both of " | |
7118 | "them together." | |
7119 | msgstr "" | |
7120 | ||
7121 | #. type: Content of: <book><chapter><para> | |
7122 | #: guide.dbk:1 | |
7123 | msgid "" | |
7124 | "By default APT will automatically remove the package (.deb) files once they " | |
7125 | "have been successfully installed. To change this behavior place " | |
7126 | "<literal>Dselect::clean \"prompt\";</literal> in /etc/apt/apt.conf." | |
7127 | msgstr "" | |
7128 | ||
7129 | #. type: Content of: <book><chapter><title> | |
7130 | #: guide.dbk:1 | |
7131 | msgid "The Interface" | |
7132 | msgstr "" | |
7133 | ||
7134 | #. type: Content of: <book><chapter><para><footnote><para> | |
7135 | #: guide.dbk:1 | |
7136 | msgid "" | |
7137 | "The <command>dselect</command> method actually is a set of wrapper scripts " | |
7138 | "to <command>apt-get</command>. The method actually provides more " | |
7139 | "functionality than is present in <command>apt-get</command> alone." | |
7140 | msgstr "" | |
7141 | ||
7142 | #. type: Content of: <book><chapter><para> | |
7143 | #: guide.dbk:1 | |
7144 | msgid "" | |
7145 | "Both that APT <command>dselect</command> method and " | |
7146 | "<command>apt-get</command> share the same interface. It is a simple system " | |
7147 | "that generally tells you what it will do and then goes and does " | |
7148 | "it. <placeholder type=\"footnote\" id=\"0\"/> After printing out a summary " | |
7149 | "of what will happen APT then will print out some informative status messages " | |
7150 | "so that you can estimate how far along it is and how much is left to do." | |
7151 | msgstr "" | |
7152 | ||
7153 | #. type: Content of: <book><chapter><section><title> | |
7154 | #: guide.dbk:1 | |
7155 | msgid "Startup" | |
7156 | msgstr "" | |
7157 | ||
7158 | #. type: Content of: <book><chapter><section><para> | |
7159 | #: guide.dbk:1 | |
7160 | msgid "" | |
7161 | "Before all operations except update, APT performs a number of actions to " | |
7162 | "prepare its internal state. It also does some checks of the system's " | |
7163 | "state. At any time these operations can be performed by running " | |
7164 | "<literal>apt-get check</literal>." | |
7165 | msgstr "" | |
7166 | ||
7167 | #. type: Content of: <book><chapter><section><screen> | |
7168 | #: guide.dbk:1 | |
7169 | #, no-wrap | |
7170 | msgid "" | |
7171 | "# apt-get check\n" | |
7172 | "Reading Package Lists... Done\n" | |
7173 | "Building Dependency Tree... Done\n" | |
7174 | msgstr "" | |
7175 | ||
7176 | #. type: Content of: <book><chapter><section><para> | |
7177 | #: guide.dbk:1 | |
7178 | msgid "" | |
7179 | "The first thing it does is read all the package files into memory. APT uses " | |
7180 | "a caching scheme so this operation will be faster the second time it is " | |
7181 | "run. If some of the package files are not found then they will be ignored " | |
7182 | "and a warning will be printed when apt-get exits." | |
7183 | msgstr "" | |
7184 | ||
7185 | #. type: Content of: <book><chapter><section><para> | |
7186 | #: guide.dbk:1 | |
7187 | msgid "" | |
7188 | "The final operation performs a detailed analysis of the system's " | |
7189 | "dependencies. It checks every dependency of every installed or unpacked " | |
7190 | "package and considers if it is OK. Should this find a problem then a report " | |
7191 | "will be printed out and <command>apt-get</command> will refuse to run." | |
7192 | msgstr "" | |
7193 | ||
7194 | #. type: Content of: <book><chapter><section><screen> | |
7195 | #: guide.dbk:1 | |
7196 | #, no-wrap | |
7197 | msgid "" | |
7198 | "# apt-get check\n" | |
7199 | "Reading Package Lists... Done\n" | |
7200 | "Building Dependency Tree... Done\n" | |
7201 | "You might want to run apt-get -f install' to correct these.\n" | |
7202 | "Sorry, but the following packages have unmet dependencies:\n" | |
7203 | " 9fonts: Depends: xlib6g but it is not installed\n" | |
7204 | " uucp: Depends: mailx but it is not installed\n" | |
7205 | " blast: Depends: xlib6g (>= 3.3-5) but it is not installed\n" | |
7206 | " adduser: Depends: perl-base but it is not installed\n" | |
7207 | " aumix: Depends: libgpmg1 but it is not installed\n" | |
7208 | " debiandoc-sgml: Depends: sgml-base but it is not installed\n" | |
7209 | " bash-builtins: Depends: bash (>= 2.01) but 2.0-3 is installed\n" | |
7210 | " cthugha: Depends: svgalibg1 but it is not installed\n" | |
7211 | " Depends: xlib6g (>= 3.3-5) but it is not installed\n" | |
7212 | " libreadlineg2: Conflicts:libreadline2 (<< 2.1-2.1)\n" | |
7213 | msgstr "" | |
7214 | ||
7215 | #. type: Content of: <book><chapter><section><para> | |
7216 | #: guide.dbk:1 | |
7217 | msgid "" | |
7218 | "In this example the system has many problems, including a serious problem " | |
7219 | "with libreadlineg2. For each package that has unmet dependencies a line is " | |
7220 | "printed out indicating the package with the problem and the dependencies " | |
7221 | "that are unmet. A short explanation of why the package has a dependency " | |
7222 | "problem is also included." | |
7223 | msgstr "" | |
7224 | ||
7225 | #. type: Content of: <book><chapter><section><para><footnote><para> | |
7226 | #: guide.dbk:1 | |
7227 | msgid "" | |
7228 | "APT however considers all known dependencies and attempts to prevent broken " | |
7229 | "packages" | |
7230 | msgstr "" | |
7231 | ||
7232 | #. type: Content of: <book><chapter><section><para> | |
7233 | #: guide.dbk:1 | |
7234 | msgid "" | |
7235 | "There are two ways a system can get into a broken state like this. The first " | |
7236 | "is caused by <command>dpkg</command> missing some subtle relationships " | |
7237 | "between packages when performing upgrades. <placeholder type=\"footnote\" " | |
7238 | "id=\"0\"/>. The second is if a package installation fails during an " | |
7239 | "operation. In this situation a package may have been unpacked without its " | |
7240 | "dependents being installed." | |
7241 | msgstr "" | |
7242 | ||
7243 | #. type: Content of: <book><chapter><section><para> | |
7244 | #: guide.dbk:1 | |
7245 | msgid "" | |
7246 | "The second situation is much less serious than the first because APT places " | |
7247 | "certain constraints on the order that packages are installed. In both cases " | |
7248 | "supplying the <literal>-f</literal> option to <command>apt-get</command> " | |
7249 | "will cause APT to deduce a possible solution to the problem and then " | |
7250 | "continue on. The APT <command>dselect</command> method always supplies the " | |
7251 | "<literal>-f</literal> option to allow for easy continuation of failed " | |
7252 | "maintainer scripts." | |
7253 | msgstr "" | |
7254 | ||
7255 | #. type: Content of: <book><chapter><section><para> | |
7256 | #: guide.dbk:1 | |
7257 | msgid "" | |
7258 | "However, if the <literal>-f</literal> option is used to correct a seriously " | |
7259 | "broken system caused by the first case then it is possible that it will " | |
7260 | "either fail immediately or the installation sequence will fail. In either " | |
7261 | "case it is necessary to manually use dpkg (possibly with forcing options) to " | |
7262 | "correct the situation enough to allow APT to proceed." | |
7263 | msgstr "" | |
7264 | ||
7265 | #. type: Content of: <book><chapter><section><title> | |
7266 | #: guide.dbk:1 | |
7267 | msgid "The Status Report" | |
7268 | msgstr "" | |
7269 | ||
7270 | #. type: Content of: <book><chapter><section><para> | |
7271 | #: guide.dbk:1 | |
7272 | msgid "" | |
7273 | "Before proceeding <command>apt-get</command> will present a report on what " | |
7274 | "will happen. Generally the report reflects the type of operation being " | |
7275 | "performed but there are several common elements. In all cases the lists " | |
7276 | "reflect the final state of things, taking into account the " | |
7277 | "<literal>-f</literal> option and any other relevant activities to the " | |
7278 | "command being executed." | |
7279 | msgstr "" | |
7280 | ||
7281 | #. type: Content of: <book><chapter><section><section><title> | |
7282 | #: guide.dbk:1 | |
7283 | msgid "The Extra Package list" | |
7284 | msgstr "" | |
7285 | ||
7286 | #. type: Content of: <book><chapter><section><section><screen> | |
7287 | #: guide.dbk:1 | |
7288 | #, no-wrap | |
7289 | msgid "" | |
7290 | "The following extra packages will be installed:\n" | |
7291 | " libdbd-mysql-perl xlib6 zlib1 xzx libreadline2 libdbd-msql-perl\n" | |
7292 | " mailpgp xdpkg fileutils pinepgp zlib1g xlib6g perl-base\n" | |
7293 | " bin86 libgdbm1 libgdbmg1 quake-lib gmp2 bcc xbuffy\n" | |
7294 | " squake pgp-i python-base debmake ldso perl libreadlineg2\n" | |
7295 | " ssh\n" | |
7296 | msgstr "" | |
7297 | ||
7298 | #. type: Content of: <book><chapter><section><section><para> | |
7299 | #: guide.dbk:1 | |
7300 | msgid "" | |
7301 | "The Extra Package list shows all of the packages that will be installed or " | |
7302 | "upgraded in excess of the ones mentioned on the command line. It is only " | |
7303 | "generated for an <literal>install</literal> command. The listed packages are " | |
7304 | "often the result of an Auto Install." | |
7305 | msgstr "" | |
7306 | ||
7307 | #. type: Content of: <book><chapter><section><section><title> | |
7308 | #: guide.dbk:1 | |
7309 | msgid "The Packages to Remove" | |
7310 | msgstr "" | |
7311 | ||
7312 | #. type: Content of: <book><chapter><section><section><screen> | |
7313 | #: guide.dbk:1 | |
7314 | #, no-wrap | |
7315 | msgid "" | |
7316 | "The following packages will be REMOVED:\n" | |
7317 | " xlib6-dev xpat2 tk40-dev xkeycaps xbattle xonix\n" | |
7318 | " xdaliclock tk40 tk41 xforms0.86 ghostview xloadimage xcolorsel\n" | |
7319 | " xadmin xboard perl-debug tkined xtetris libreadline2-dev perl-suid\n" | |
7320 | " nas xpilot xfig\n" | |
7321 | msgstr "" | |
7322 | ||
7323 | #. type: Content of: <book><chapter><section><section><para> | |
7324 | #: guide.dbk:1 | |
7325 | msgid "" | |
7326 | "The Packages to Remove list shows all of the packages that will be removed " | |
7327 | "from the system. It can be shown for any of the operations and should be " | |
7328 | "given a careful inspection to ensure nothing important is to be taken " | |
7329 | "off. The <literal>-f</literal> option is especially good at generating " | |
7330 | "packages to remove so extreme care should be used in that case. The list may " | |
7331 | "contain packages that are going to be removed because they are only " | |
7332 | "partially installed, possibly due to an aborted installation." | |
7333 | msgstr "" | |
7334 | ||
7335 | #. type: Content of: <book><chapter><section><section><title> | |
7336 | #: guide.dbk:1 | |
7337 | msgid "The New Packages list" | |
7338 | msgstr "" | |
7339 | ||
7340 | #. type: Content of: <book><chapter><section><section><screen> | |
7341 | #: guide.dbk:1 | |
7342 | #, no-wrap | |
7343 | msgid "" | |
7344 | "The following NEW packages will installed:\n" | |
7345 | " zlib1g xlib6g perl-base libgdbmg1 quake-lib gmp2 pgp-i python-base\n" | |
7346 | msgstr "" | |
7347 | ||
7348 | #. type: Content of: <book><chapter><section><section><para> | |
7349 | #: guide.dbk:1 | |
7350 | msgid "" | |
7351 | "The New Packages list is simply a reminder of what will happen. The packages " | |
7352 | "listed are not presently installed in the system but will be when APT is " | |
7353 | "done." | |
7354 | msgstr "" | |
7355 | ||
7356 | #. type: Content of: <book><chapter><section><section><title> | |
7357 | #: guide.dbk:1 | |
7358 | msgid "The Kept Back list" | |
7359 | msgstr "" | |
7360 | ||
7361 | #. type: Content of: <book><chapter><section><section><screen> | |
7362 | #: guide.dbk:1 | |
7363 | #, no-wrap | |
7364 | msgid "" | |
7365 | "The following packages have been kept back\n" | |
7366 | " compface man-db tetex-base msql libpaper svgalib1\n" | |
7367 | " gs snmp arena lynx xpat2 groff xscreensaver\n" | |
7368 | msgstr "" | |
7369 | ||
7370 | #. type: Content of: <book><chapter><section><section><para> | |
7371 | #: guide.dbk:1 | |
7372 | msgid "" | |
7373 | "Whenever the whole system is being upgraded there is the possibility that " | |
7374 | "new versions of packages cannot be installed because they require new things " | |
7375 | "or conflict with already installed things. In this case the package will " | |
7376 | "appear in the Kept Back list. The best way to convince packages listed there " | |
7377 | "to install is with <literal>apt-get install</literal> or by using " | |
7378 | "<command>dselect</command> to resolve their problems." | |
7379 | msgstr "" | |
7380 | ||
7381 | #. type: Content of: <book><chapter><section><section><title> | |
7382 | #: guide.dbk:1 | |
7383 | msgid "Held Packages warning" | |
7384 | msgstr "" | |
7385 | ||
7386 | #. type: Content of: <book><chapter><section><section><screen> | |
7387 | #: guide.dbk:1 | |
7388 | #, no-wrap | |
7389 | msgid "" | |
7390 | "The following held packages will be changed:\n" | |
7391 | " cvs\n" | |
7392 | msgstr "" | |
7393 | ||
7394 | #. type: Content of: <book><chapter><section><section><para> | |
7395 | #: guide.dbk:1 | |
7396 | msgid "" | |
7397 | "Sometimes you can ask APT to install a package that is on hold, in such a " | |
7398 | "case it prints out a warning that the held package is going to be " | |
7399 | "changed. This should only happen during dist-upgrade or install." | |
7400 | msgstr "" | |
7401 | ||
7402 | #. type: Content of: <book><chapter><section><section><title> | |
7403 | #: guide.dbk:1 | |
7404 | msgid "Final summary" | |
7405 | msgstr "" | |
7406 | ||
7407 | #. type: Content of: <book><chapter><section><section><para> | |
7408 | #: guide.dbk:1 | |
7409 | msgid "Finally, APT will print out a summary of all the changes that will occur." | |
7410 | msgstr "" | |
7411 | ||
7412 | #. type: Content of: <book><chapter><section><section><screen> | |
7413 | #: guide.dbk:1 | |
7414 | #, no-wrap | |
7415 | msgid "" | |
7416 | "206 packages upgraded, 8 newly installed, 23 to remove and 51 not " | |
7417 | "upgraded.\n" | |
7418 | "12 packages not fully installed or removed.\n" | |
7419 | "Need to get 65.7M/66.7M of archives. After unpacking 26.5M will be used.\n" | |
7420 | msgstr "" | |
7421 | ||
7422 | #. type: Content of: <book><chapter><section><section><para> | |
7423 | #: guide.dbk:1 | |
7424 | msgid "" | |
7425 | "The first line of the summary simply is a reduced version of all of the " | |
7426 | "lists and includes the number of upgrades - that is packages already " | |
7427 | "installed that have new versions available. The second line indicates the " | |
7428 | "number of poorly configured packages, possibly the result of an aborted " | |
7429 | "installation. The final line shows the space requirements that the " | |
7430 | "installation needs. The first pair of numbers refer to the size of the " | |
7431 | "archive files. The first number indicates the number of bytes that must be " | |
7432 | "fetched from remote locations and the second indicates the total size of all " | |
7433 | "the archives required. The next number indicates the size difference between " | |
7434 | "the presently installed packages and the newly installed packages. It is " | |
7435 | "roughly equivalent to the space required in /usr after everything is " | |
7436 | "done. If a large number of packages are being removed then the value may " | |
7437 | "indicate the amount of space that will be freed." | |
7438 | msgstr "" | |
7439 | ||
7440 | #. type: Content of: <book><chapter><section><section><para> | |
7441 | #: guide.dbk:1 | |
7442 | msgid "" | |
7443 | "Some other reports can be generated by using the -u option to show packages " | |
7444 | "to upgrade, they are similar to the previous examples." | |
7445 | msgstr "" | |
7446 | ||
7447 | #. type: Content of: <book><chapter><section><title> | |
7448 | #: guide.dbk:1 | |
7449 | msgid "The Status Display" | |
7450 | msgstr "" | |
7451 | ||
7452 | #. type: Content of: <book><chapter><section><para> | |
7453 | #: guide.dbk:1 | |
7454 | msgid "" | |
7455 | "During the download of archives and package files APT prints out a series of " | |
7456 | "status messages." | |
7457 | msgstr "" | |
7458 | ||
7459 | #. type: Content of: <book><chapter><section><screen> | |
7460 | #: guide.dbk:1 | |
7461 | #, no-wrap | |
7462 | msgid "" | |
7463 | "# apt-get update\n" | |
7464 | "Get:1 http://ftp.de.debian.org/debian-non-US/ stable/non-US/ Packages\n" | |
7465 | "Get:2 http://llug.sep.bnl.gov/debian/ testing/contrib Packages\n" | |
7466 | "Hit http://llug.sep.bnl.gov/debian/ testing/main Packages\n" | |
7467 | "Get:4 http://ftp.de.debian.org/debian-non-US/ unstable/binary-i386/ " | |
7468 | "Packages\n" | |
7469 | "Get:5 http://llug.sep.bnl.gov/debian/ testing/non-free Packages\n" | |
7470 | "11% [5 testing/non-free `Waiting for file' 0/32.1k 0%] 2203b/s 1m52s\n" | |
7471 | msgstr "" | |
7472 | ||
7473 | #. type: Content of: <book><chapter><section><para> | |
7474 | #: guide.dbk:1 | |
7475 | msgid "" | |
7476 | "The lines starting with <emphasis>Get</emphasis> are printed out when APT " | |
7477 | "begins to fetch a file while the last line indicates the progress of the " | |
7478 | "download. The first percent value on the progress line indicates the total " | |
7479 | "percent done of all files. Unfortunately since the size of the Package files " | |
7480 | "is unknown <literal>apt-get update</literal> estimates the percent done " | |
7481 | "which causes some inaccuracies." | |
7482 | msgstr "" | |
7483 | ||
7484 | #. type: Content of: <book><chapter><section><para> | |
7485 | #: guide.dbk:1 | |
7486 | msgid "" | |
7487 | "The next section of the status line is repeated once for each download " | |
7488 | "thread and indicates the operation being performed and some useful " | |
7489 | "information about what is happening. Sometimes this section will simply read " | |
7490 | "<emphasis>Forking</emphasis> which means the OS is loading the download " | |
7491 | "module. The first word after the [ is the fetch number as shown on the " | |
7492 | "history lines. The next word is the short form name of the object being " | |
7493 | "downloaded. For archives it will contain the name of the package that is " | |
7494 | "being fetched." | |
7495 | msgstr "" | |
7496 | ||
7497 | #. type: Content of: <book><chapter><section><para> | |
7498 | #: guide.dbk:1 | |
7499 | msgid "" | |
7500 | "Inside of the single quote is an informative string indicating the progress " | |
7501 | "of the negotiation phase of the download. Typically it progresses from " | |
7502 | "<emphasis>Connecting</emphasis> to <emphasis>Waiting for file</emphasis> to " | |
7503 | "<emphasis>Downloading</emphasis> or <emphasis>Resuming</emphasis>. The final " | |
7504 | "value is the number of bytes downloaded from the remote site. Once the " | |
7505 | "download begins this is represented as <literal>102/10.2k</literal> " | |
7506 | "indicating that 102 bytes have been fetched and 10.2 kilobytes is " | |
7507 | "expected. The total size is always shown in 4 figure notation to preserve " | |
7508 | "space. After the size display is a percent meter for the file itself. The " | |
7509 | "second last element is the instantaneous average speed. This values is " | |
7510 | "updated every 5 seconds and reflects the rate of data transfer for that " | |
7511 | "period. Finally is shown the estimated transfer time. This is updated " | |
7512 | "regularly and reflects the time to complete everything at the shown transfer " | |
7513 | "rate." | |
7514 | msgstr "" | |
7515 | ||
7516 | #. type: Content of: <book><chapter><section><para> | |
7517 | #: guide.dbk:1 | |
7518 | msgid "" | |
7519 | "The status display updates every half second to provide a constant feedback " | |
7520 | "on the download progress while the Get lines scroll back whenever a new file " | |
7521 | "is started. Since the status display is constantly updated it is unsuitable " | |
7522 | "for logging to a file, use the <literal>-q</literal> option to remove the " | |
7523 | "status display." | |
7524 | msgstr "" | |
7525 | ||
7526 | #. type: Content of: <book><chapter><section><title> | |
7527 | #: guide.dbk:1 | |
7528 | msgid "Dpkg" | |
7529 | msgstr "" | |
7530 | ||
7531 | #. type: Content of: <book><chapter><section><para> | |
7532 | #: guide.dbk:1 | |
7533 | msgid "" | |
7534 | "APT uses <command>dpkg</command> for installing the archives and will switch " | |
7535 | "over to the <command>dpkg</command> interface once downloading is " | |
7536 | "completed. <command>dpkg</command> will also ask a number of questions as it " | |
7537 | "processes the packages and the packages themselves may also ask several " | |
7538 | "questions. Before each question there is usually a description of what it is " | |
7539 | "asking and the questions are too varied to discuss completely here." | |
7540 | msgstr "" | |
7541 | ||
7542 | #. type: Content of: <book><title> | |
7543 | #: offline.dbk:1 | |
7544 | msgid "Using APT Offline" | |
7545 | msgstr "" | |
7546 | ||
7547 | #. type: Content of: <book><bookinfo><abstract><para> | |
7548 | #: offline.dbk:1 | |
7549 | msgid "" | |
7550 | "This document describes how to use APT in a non-networked environment, " | |
7551 | "specifically a 'sneaker-net' approach for performing upgrades." | |
7552 | msgstr "" | |
7553 | ||
7554 | #. type: Content of: <book><bookinfo> | |
7555 | #: offline.dbk:1 | |
7556 | msgid "<copyright><year>1999</year><holder>Jason Gunthorpe</holder></copyright>" | |
7557 | msgstr "" | |
7558 | ||
7559 | #. type: Content of: <book><chapter><title> | |
7560 | #: offline.dbk:1 | |
7561 | msgid "Introduction" | |
7562 | msgstr "" | |
7563 | ||
7564 | #. type: Content of: <book><chapter><section><title> | |
7565 | #: offline.dbk:1 offline.dbk:1 offline.dbk:1 | |
7566 | msgid "Overview" | |
7567 | msgstr "" | |
7568 | ||
7569 | #. type: Content of: <book><chapter><section><para> | |
7570 | #: offline.dbk:1 | |
7571 | msgid "" | |
7572 | "Normally APT requires direct access to a Debian archive, either from a local " | |
7573 | "media or through a network. Another common complaint is that a Debian " | |
7574 | "machine is on a slow link, such as a modem and another machine has a very " | |
7575 | "fast connection but they are physically distant." | |
7576 | msgstr "" | |
7577 | ||
7578 | #. type: Content of: <book><chapter><section><para> | |
7579 | #: offline.dbk:1 | |
7580 | msgid "" | |
7581 | "The solution to this is to use large removable media such as a Zip disc or a " | |
7582 | "SuperDisk disc. These discs are not large enough to store the entire Debian " | |
7583 | "archive but can easily fit a subset large enough for most users. The idea is " | |
7584 | "to use APT to generate a list of packages that are required and then fetch " | |
7585 | "them onto the disc using another machine with good connectivity. It is even " | |
7586 | "possible to use another Debian machine with APT or to use a completely " | |
7587 | "different OS and a download tool like wget. Let <emphasis>remote " | |
7588 | "host</emphasis> mean the machine downloading the packages, and " | |
7589 | "<emphasis>target host</emphasis> the one with bad or no connection." | |
7590 | msgstr "" | |
7591 | ||
7592 | #. type: Content of: <book><chapter><section><para> | |
7593 | #: offline.dbk:1 | |
7594 | msgid "" | |
7595 | "This is achieved by creatively manipulating the APT configuration file. The " | |
7596 | "essential premise to tell APT to look on a disc for it's archive files. Note " | |
7597 | "that the disc should be formatted with a filesystem that can handle long " | |
7598 | "file names such as ext2, fat32 or vfat." | |
7599 | msgstr "" | |
7600 | ||
7601 | #. type: Content of: <book><chapter><title> | |
7602 | #: offline.dbk:1 | |
7603 | msgid "Using APT on both machines" | |
7604 | msgstr "" | |
7605 | ||
7606 | #. type: Content of: <book><chapter><section><para> | |
7607 | #: offline.dbk:1 | |
7608 | msgid "" | |
7609 | "APT being available on both machines gives the simplest configuration. The " | |
7610 | "basic idea is to place a copy of the status file on the disc and use the " | |
7611 | "remote machine to fetch the latest package files and decide which packages " | |
7612 | "to download. The disk directory structure should look like:" | |
7613 | msgstr "" | |
7614 | ||
7615 | #. type: Content of: <book><chapter><section><screen> | |
7616 | #: offline.dbk:1 | |
7617 | #, no-wrap | |
7618 | msgid "" | |
7619 | " /disc/\n" | |
7620 | " archives/\n" | |
7621 | " partial/\n" | |
7622 | " lists/\n" | |
7623 | " partial/\n" | |
7624 | " status\n" | |
7625 | " sources.list\n" | |
7626 | " apt.conf\n" | |
7627 | msgstr "" | |
7628 | ||
7629 | #. type: Content of: <book><chapter><section><title> | |
7630 | #: offline.dbk:1 | |
7631 | msgid "The configuration file" | |
7632 | msgstr "" | |
7633 | ||
7634 | #. type: Content of: <book><chapter><section><para> | |
7635 | #: offline.dbk:1 | |
7636 | msgid "" | |
7637 | "The configuration file should tell APT to store its files on the disc and to " | |
7638 | "use the configuration files on the disc as well. The sources.list should " | |
7639 | "contain the proper sites that you wish to use from the remote machine, and " | |
7640 | "the status file should be a copy of " | |
7641 | "<emphasis>/var/lib/dpkg/status</emphasis> from the <emphasis>target " | |
7642 | "host</emphasis>. Please note, if you are using a local archive you must use " | |
7643 | "copy URIs, the syntax is identical to file URIs." | |
7644 | msgstr "" | |
7645 | ||
7646 | #. type: Content of: <book><chapter><section><para> | |
7647 | #: offline.dbk:1 | |
7648 | msgid "" | |
7649 | "<emphasis>apt.conf</emphasis> must contain the necessary information to make " | |
7650 | "APT use the disc:" | |
7651 | msgstr "" | |
7652 | ||
7653 | #. type: Content of: <book><chapter><section><screen> | |
7654 | #: offline.dbk:1 | |
7655 | #, no-wrap | |
7656 | msgid "" | |
7657 | " APT\n" | |
7658 | " {\n" | |
7659 | " /* This is not necessary if the two machines are the same arch, it " | |
7660 | "tells\n" | |
7661 | " the remote APT what architecture the target machine is */\n" | |
7662 | " Architecture \"i386\";\n" | |
7663 | "\n" | |
7664 | " Get::Download-Only \"true\";\n" | |
7665 | " };\n" | |
7666 | "\n" | |
7667 | " Dir\n" | |
7668 | " {\n" | |
7669 | " /* Use the disc for state information and redirect the status file from\n" | |
7670 | " the /var/lib/dpkg default */\n" | |
7671 | " State \"/disc/\";\n" | |
7672 | " State::status \"status\";\n" | |
7673 | "\n" | |
7674 | " // Binary caches will be stored locally\n" | |
7675 | " Cache::archives \"/disc/archives/\";\n" | |
7676 | " Cache \"/tmp/\";\n" | |
7677 | "\n" | |
7678 | " // Location of the source list.\n" | |
7679 | " Etc \"/disc/\";\n" | |
7680 | " };\n" | |
7681 | msgstr "" | |
7682 | ||
7683 | #. type: Content of: <book><chapter><section><para> | |
7684 | #: offline.dbk:1 | |
7685 | msgid "" | |
7686 | "More details can be seen by examining the apt.conf man page and the sample " | |
7687 | "configuration file in " | |
7688 | "<emphasis>/usr/share/doc/apt/examples/apt.conf</emphasis>." | |
7689 | msgstr "" | |
7690 | ||
7691 | #. type: Content of: <book><chapter><section><para> | |
7692 | #: offline.dbk:1 | |
7693 | msgid "" | |
7694 | "On the target machine the first thing to do is mount the disc and copy " | |
7695 | "<emphasis>/var/lib/dpkg/status</emphasis> to it. You will also need to " | |
7696 | "create the directories outlined in the Overview, " | |
7697 | "<emphasis>archives/partial/</emphasis> and " | |
7698 | "<emphasis>lists/partial/</emphasis>. Then take the disc to the remote " | |
7699 | "machine and configure the sources.list. On the remote machine execute the " | |
7700 | "following:" | |
7701 | msgstr "" | |
7702 | ||
7703 | #. type: Content of: <book><chapter><section><screen> | |
7704 | #: offline.dbk:1 | |
7705 | #, no-wrap | |
7706 | msgid "" | |
7707 | " # export APT_CONFIG=\"/disc/apt.conf\"\n" | |
7708 | " # apt-get update\n" | |
7709 | " [ APT fetches the package files ]\n" | |
7710 | " # apt-get dist-upgrade\n" | |
7711 | " [ APT fetches all the packages needed to upgrade the target machine ]\n" | |
7712 | msgstr "" | |
7713 | ||
7714 | #. type: Content of: <book><chapter><section><para> | |
7715 | #: offline.dbk:1 | |
7716 | msgid "" | |
7717 | "The dist-upgrade command can be replaced with any other standard APT " | |
7718 | "commands, particularly dselect-upgrade. You can even use an APT front end " | |
7719 | "such as <emphasis>dselect</emphasis>. However this presents a problem in " | |
7720 | "communicating your selections back to the local computer." | |
7721 | msgstr "" | |
7722 | ||
7723 | #. type: Content of: <book><chapter><section><para> | |
7724 | #: offline.dbk:1 | |
7725 | msgid "" | |
7726 | "Now the disc contains all of the index files and archives needed to upgrade " | |
7727 | "the target machine. Take the disc back and run:" | |
7728 | msgstr "" | |
7729 | ||
7730 | #. type: Content of: <book><chapter><section><screen> | |
7731 | #: offline.dbk:1 | |
7732 | #, no-wrap | |
7733 | msgid "" | |
7734 | " # export APT_CONFIG=\"/disc/apt.conf\"\n" | |
7735 | " # apt-get check\n" | |
7736 | " [ APT generates a local copy of the cache files ]\n" | |
7737 | " # apt-get --no-d -o dir::state::status=/var/lib/dpkg/status dist-upgrade\n" | |
7738 | " [ Or any other APT command ]\n" | |
7739 | msgstr "" | |
7740 | ||
7741 | #. type: Content of: <book><chapter><section><para> | |
7742 | #: offline.dbk:1 | |
7743 | msgid "" | |
7744 | "It is necessary for proper function to re-specify the status file to be the " | |
7745 | "local one. This is very important!" | |
7746 | msgstr "" | |
7747 | ||
7748 | #. type: Content of: <book><chapter><section><para> | |
7749 | #: offline.dbk:1 | |
7750 | msgid "" | |
7751 | "If you are using dselect you can do the very risky operation of copying " | |
7752 | "disc/status to /var/lib/dpkg/status so that any selections you made on the " | |
7753 | "remote machine are updated. I highly recommend that people only make " | |
7754 | "selections on the local machine - but this may not always be possible. DO " | |
7755 | "NOT copy the status file if dpkg or APT have been run in the mean time!!" | |
7756 | msgstr "" | |
7757 | ||
7758 | #. type: Content of: <book><chapter><title> | |
7759 | #: offline.dbk:1 | |
7760 | msgid "Using APT and wget" | |
7761 | msgstr "" | |
7762 | ||
7763 | #. type: Content of: <book><chapter><section><para> | |
7764 | #: offline.dbk:1 | |
7765 | msgid "" | |
7766 | "<emphasis>wget</emphasis> is a popular and portable download tool that can " | |
7767 | "run on nearly any machine. Unlike the method above this requires that the " | |
7768 | "Debian machine already has a list of available packages." | |
7769 | msgstr "" | |
7770 | ||
7771 | #. type: Content of: <book><chapter><section><para> | |
7772 | #: offline.dbk:1 | |
7773 | msgid "" | |
7774 | "The basic idea is to create a disc that has only the archive files " | |
7775 | "downloaded from the remote site. This is done by using the --print-uris " | |
7776 | "option to apt-get and then preparing a wget script to actually fetch the " | |
7777 | "packages." | |
7778 | msgstr "" | |
7779 | ||
7780 | #. type: Content of: <book><chapter><section><title> | |
7781 | #: offline.dbk:1 | |
7782 | msgid "Operation" | |
7783 | msgstr "" | |
7784 | ||
7785 | #. type: Content of: <book><chapter><section><para> | |
7786 | #: offline.dbk:1 | |
7787 | msgid "" | |
7788 | "Unlike the previous technique no special configuration files are " | |
7789 | "required. We merely use the standard APT commands to generate the file list." | |
7790 | msgstr "" | |
7791 | ||
7792 | #. type: Content of: <book><chapter><section><screen> | |
7793 | #: offline.dbk:1 | |
7794 | #, no-wrap | |
7795 | msgid "" | |
7796 | " # apt-get dist-upgrade\n" | |
7797 | " [ Press no when prompted, make sure you are happy with the actions ]\n" | |
7798 | " # apt-get -qq --print-uris dist-upgrade > uris\n" | |
7799 | " # awk '{print \"wget -O \" $2 \" \" $1}' < uris > /disc/wget-script\n" | |
7800 | msgstr "" | |
7801 | ||
7802 | #. type: Content of: <book><chapter><section><para> | |
7803 | #: offline.dbk:1 | |
7804 | msgid "" | |
7805 | "Any command other than dist-upgrade could be used here, including " | |
7806 | "dselect-upgrade." | |
7807 | msgstr "" | |
7808 | ||
7809 | #. type: Content of: <book><chapter><section><para> | |
7810 | #: offline.dbk:1 | |
7811 | msgid "" | |
7812 | "The /disc/wget-script file will now contain a list of wget commands to " | |
7813 | "execute in order to fetch the necessary archives. This script should be run " | |
7814 | "with the current directory as the disc's mount point so as to save the " | |
7815 | "output on the disc." | |
7816 | msgstr "" | |
7817 | ||
7818 | #. type: Content of: <book><chapter><section><para> | |
7819 | #: offline.dbk:1 | |
7820 | msgid "The remote machine would do something like" | |
7821 | msgstr "" | |
7822 | ||
7823 | #. type: Content of: <book><chapter><section><screen> | |
7824 | #: offline.dbk:1 | |
7825 | #, no-wrap | |
7826 | msgid "" | |
7827 | " # cd /disc\n" | |
7828 | " # sh -x ./wget-script\n" | |
7829 | " [ wait.. ]\n" | |
7830 | msgstr "" | |
7831 | ||
7832 | #. type: Content of: <book><chapter><section><para> | |
7833 | #: offline.dbk:1 | |
7834 | msgid "" | |
7835 | "Once the archives are downloaded and the disc returned to the Debian machine " | |
7836 | "installation can proceed using," | |
7837 | msgstr "" | |
7838 | ||
7839 | #. type: Content of: <book><chapter><section><screen> | |
7840 | #: offline.dbk:1 | |
7841 | #, no-wrap | |
7842 | msgid " # apt-get -o dir::cache::archives=\"/disc/\" dist-upgrade\n" | |
7843 | msgstr "" | |
7844 | ||
7845 | #. type: Content of: <book><chapter><section><para> | |
7846 | #: offline.dbk:1 | |
7847 | msgid "Which will use the already fetched archives on the disc." | |
7848 | msgstr "" |