cleanup commit for trigger processing:
[ntk/apt.git] / doc / po / apt-doc.pot
CommitLineData
2a52e8c5
DK
1# SOME DESCRIPTIVE TITLE
2# Copyright (C) YEAR Free Software Foundation, Inc.
3# This file is distributed under the same license as the PACKAGE package.
4# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
5#
6#, fuzzy
7msgid ""
8msgstr ""
9"Project-Id-Version: PACKAGE VERSION\n"
d5081aee 10"POT-Creation-Date: 2009-09-18 16:44+0300\n"
2a52e8c5
DK
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"MIME-Version: 1.0\n"
15"Content-Type: text/plain; charset=utf-8\n"
16"Content-Transfer-Encoding: ENCODING"
17
18#. type: TH
19#: apt.8:17
20#, no-wrap
21msgid "apt"
22msgstr ""
23
24#. type: TH
25#: apt.8:17
26#, no-wrap
27msgid "16 June 1998"
28msgstr ""
29
30#. type: TH
31#: apt.8:17
32#, no-wrap
33msgid "Debian GNU/Linux"
34msgstr ""
35
36#. type: SH
37#: apt.8:18
38#, no-wrap
39msgid "NAME"
40msgstr ""
41
42#. type: Plain text
43#: apt.8:20
44msgid "apt - Advanced Package Tool"
45msgstr ""
46
47#. type: SH
48#: apt.8:20
49#, no-wrap
50msgid "SYNOPSIS"
51msgstr ""
52
53#. type: Plain text
54#: apt.8:22
55msgid "B<apt>"
56msgstr ""
57
58#. type: SH
59#: apt.8:22
60#, no-wrap
61msgid "DESCRIPTION"
62msgstr ""
63
64#. type: Plain text
65#: apt.8:31
66msgid ""
67"APT is a management system for software packages. For normal day to day "
68"package management there are several frontends available, such as "
69"B<aptitude>(8) for the command line or B<synaptic>(8) for the X Window "
70"System. Some options are only implemented in B<apt-get>(8) though."
71msgstr ""
72
73#. type: SH
74#: apt.8:31
75#, no-wrap
76msgid "OPTIONS"
77msgstr ""
78
79#. type: Plain text
80#: apt.8:33 apt.8:35
81msgid "None."
82msgstr ""
83
84#. type: SH
85#: apt.8:33
86#, no-wrap
87msgid "FILES"
88msgstr ""
89
90#. type: SH
91#: apt.8:35
92#, no-wrap
93msgid "SEE ALSO"
94msgstr ""
95
96#. type: Plain text
97#: apt.8:42
98msgid ""
99"B<apt-cache>(8), B<apt-get>(8), B<apt.conf>(5), B<sources.list>(5), "
100"B<apt_preferences>(5), B<apt-secure>(8)"
101msgstr ""
102
103#. type: SH
104#: apt.8:42
105#, no-wrap
106msgid "DIAGNOSTICS"
107msgstr ""
108
109#. type: Plain text
110#: apt.8:44
111msgid "apt returns zero on normal operation, decimal 100 on error."
112msgstr ""
113
114#. type: SH
115#: apt.8:44
116#, no-wrap
117msgid "BUGS"
118msgstr ""
119
120#. type: Plain text
121#: apt.8:46
122msgid "This manpage isn't even started."
123msgstr ""
124
125#. type: Plain text
126#: apt.8:55
127msgid ""
128"See E<lt>http://bugs.debian.org/aptE<gt>. If you wish to report a bug in "
129"B<apt>, please see I</usr/share/doc/debian/bug-reporting.txt> or the "
130"B<reportbug>(1) command."
131msgstr ""
132
133#. type: SH
134#: apt.8:55
135#, no-wrap
136msgid "AUTHOR"
137msgstr ""
138
139#. type: Plain text
140#: apt.8:56
141msgid "apt was written by the APT team E<lt>apt@packages.debian.orgE<gt>."
142msgstr ""
143
144#. type: Plain text
145#: apt.ent:2
146msgid "<!-- -*- mode: sgml; mode: fold -*- -->"
147msgstr ""
148
149#. type: Plain text
150#: apt.ent:10
151msgid ""
152"<!-- Some common paths.. --> <!ENTITY docdir \"/usr/share/doc/apt/\"> "
153"<!ENTITY guidesdir \"/usr/share/doc/apt-doc/\"> <!ENTITY configureindex "
154"\"<filename>&docdir;examples/configure-index.gz</filename>\"> <!ENTITY "
155"aptconfdir \"<filename>/etc/apt.conf</filename>\"> <!ENTITY statedir "
156"\"/var/lib/apt\"> <!ENTITY cachedir \"/var/cache/apt\">"
157msgstr ""
158
159#. type: Plain text
160#: apt.ent:17
161#, no-wrap
162msgid ""
163"<!-- Cross references to other man pages -->\n"
164"<!ENTITY apt-conf \"<citerefentry>\n"
165" <refentrytitle><filename>apt.conf</filename></refentrytitle>\n"
166" <manvolnum>5</manvolnum>\n"
167" </citerefentry>\"\n"
168">\n"
169msgstr ""
170
171#. type: Plain text
172#: apt.ent:23
173#, no-wrap
174msgid ""
175"<!ENTITY apt-get \"<citerefentry>\n"
176" <refentrytitle><command>apt-get</command></refentrytitle>\n"
177" <manvolnum>8</manvolnum>\n"
178" </citerefentry>\"\n"
179">\n"
180msgstr ""
181
182#. type: Plain text
183#: apt.ent:29
184#, no-wrap
185msgid ""
186"<!ENTITY apt-config \"<citerefentry>\n"
187" <refentrytitle><command>apt-config</command></refentrytitle>\n"
188" <manvolnum>8</manvolnum>\n"
189" </citerefentry>\"\n"
190">\n"
191msgstr ""
192
193#. type: Plain text
194#: apt.ent:35
195#, no-wrap
196msgid ""
197"<!ENTITY apt-cdrom \"<citerefentry>\n"
198" <refentrytitle><command>apt-cdrom</command></refentrytitle>\n"
199" <manvolnum>8</manvolnum>\n"
200" </citerefentry>\"\n"
201">\n"
202msgstr ""
203
204#. type: Plain text
205#: apt.ent:41
206#, no-wrap
207msgid ""
208"<!ENTITY apt-cache \"<citerefentry>\n"
209" <refentrytitle><command>apt-cache</command></refentrytitle>\n"
210" <manvolnum>8</manvolnum>\n"
211" </citerefentry>\"\n"
212">\n"
213msgstr ""
214
215#. type: Plain text
216#: apt.ent:47
217#, no-wrap
218msgid ""
219"<!ENTITY apt-preferences \"<citerefentry>\n"
220" <refentrytitle><command>apt_preferences</command></refentrytitle>\n"
221" <manvolnum>5</manvolnum>\n"
222" </citerefentry>\"\n"
223">\n"
224msgstr ""
225
226#. type: Plain text
227#: apt.ent:53
228#, no-wrap
229msgid ""
230"<!ENTITY apt-key \"<citerefentry>\n"
231" <refentrytitle><command>apt-key</command></refentrytitle>\n"
232" <manvolnum>8</manvolnum>\n"
233" </citerefentry>\"\n"
234">\n"
235msgstr ""
236
237#. type: Plain text
238#: apt.ent:59
239#, no-wrap
240msgid ""
241"<!ENTITY apt-secure \"<citerefentry>\n"
242" <refentrytitle>apt-secure</refentrytitle>\n"
243" <manvolnum>8</manvolnum>\n"
244" </citerefentry>\"\n"
245">\n"
246msgstr ""
247
248#. type: Plain text
249#: apt.ent:65
250#, no-wrap
251msgid ""
252"<!ENTITY apt-ftparchive \"<citerefentry>\n"
253" <refentrytitle><filename>apt-ftparchive</filename></refentrytitle>\n"
254" <manvolnum>1</manvolnum>\n"
255" </citerefentry>\"\n"
256">\n"
257msgstr ""
258
259#. type: Plain text
260#: apt.ent:72
261#, no-wrap
262msgid ""
263"<!ENTITY sources-list \"<citerefentry>\n"
264" <refentrytitle><filename>sources.list</filename></refentrytitle>\n"
265" <manvolnum>5</manvolnum>\n"
266" </citerefentry>\"\n"
267">\n"
268msgstr ""
269
270#. type: Plain text
271#: apt.ent:78
272#, no-wrap
273msgid ""
274"<!ENTITY reportbug \"<citerefentry>\n"
275" <refentrytitle><command>reportbug</command></refentrytitle>\n"
276" <manvolnum>1</manvolnum>\n"
277" </citerefentry>\"\n"
278">\n"
279msgstr ""
280
281#. type: Plain text
282#: apt.ent:84
283#, no-wrap
284msgid ""
285"<!ENTITY dpkg \"<citerefentry>\n"
286" <refentrytitle><command>dpkg</command></refentrytitle>\n"
287" <manvolnum>8</manvolnum>\n"
288" </citerefentry>\"\n"
289">\n"
290msgstr ""
291
292#. type: Plain text
293#: apt.ent:90
294#, no-wrap
295msgid ""
296"<!ENTITY dpkg-buildpackage \"<citerefentry>\n"
297" <refentrytitle><command>dpkg-buildpackage</command></refentrytitle>\n"
298" <manvolnum>1</manvolnum>\n"
299" </citerefentry>\"\n"
300">\n"
301msgstr ""
302
303#. type: Plain text
304#: apt.ent:96
305#, no-wrap
306msgid ""
307"<!ENTITY gzip \"<citerefentry>\n"
308" <refentrytitle><command>gzip</command></refentrytitle>\n"
309" <manvolnum>1</manvolnum>\n"
310" </citerefentry>\"\n"
311">\n"
312msgstr ""
313
314#. type: Plain text
315#: apt.ent:102
316#, no-wrap
317msgid ""
318"<!ENTITY dpkg-scanpackages \"<citerefentry>\n"
319" <refentrytitle><command>dpkg-scanpackages</command></refentrytitle>\n"
320" <manvolnum>8</manvolnum>\n"
321" </citerefentry>\"\n"
322">\n"
323msgstr ""
324
325#. type: Plain text
326#: apt.ent:108
327#, no-wrap
328msgid ""
329"<!ENTITY dpkg-scansources \"<citerefentry>\n"
330" <refentrytitle><command>dpkg-scansources</command></refentrytitle>\n"
331" <manvolnum>8</manvolnum>\n"
332" </citerefentry>\"\n"
333">\n"
334msgstr ""
335
336#. type: Plain text
337#: apt.ent:114
338#, no-wrap
339msgid ""
340"<!ENTITY dselect \"<citerefentry>\n"
341" <refentrytitle><command>dselect</command></refentrytitle>\n"
342" <manvolnum>8</manvolnum>\n"
343" </citerefentry>\"\n"
344">\n"
345msgstr ""
346
347#. type: Plain text
348#: apt.ent:120
349#, no-wrap
350msgid ""
351"<!ENTITY aptitude \"<citerefentry>\n"
352" <refentrytitle><command>aptitude</command></refentrytitle>\n"
353" <manvolnum>8</manvolnum>\n"
354" </citerefentry>\"\n"
355">\n"
356msgstr ""
357
358#. type: Plain text
359#: apt.ent:126
360#, no-wrap
361msgid ""
362"<!ENTITY synaptic \"<citerefentry>\n"
363" <refentrytitle><command>synaptic</command></refentrytitle>\n"
364" <manvolnum>8</manvolnum>\n"
365" </citerefentry>\"\n"
366">\n"
367msgstr ""
368
369#. type: Plain text
370#: apt.ent:132
371#, no-wrap
372msgid ""
373"<!ENTITY debsign \"<citerefentry>\n"
374" <refentrytitle><command>debsign</command></refentrytitle>\n"
375" <manvolnum>1</manvolnum>\n"
376" </citerefentry>\"\n"
377">\n"
378msgstr ""
379
380#. type: Plain text
381#: apt.ent:138
382#, no-wrap
383msgid ""
384"<!ENTITY debsig-verify \"<citerefentry>\n"
385" <refentrytitle><command>debsig-verify</command></refentrytitle>\n"
386" <manvolnum>1</manvolnum>\n"
387" </citerefentry>\"\n"
388">\n"
389msgstr ""
390
391#. type: Plain text
392#: apt.ent:144
393#, no-wrap
394msgid ""
395"<!ENTITY gpg \"<citerefentry>\n"
396" <refentrytitle><command>gpg</command></refentrytitle>\n"
397" <manvolnum>1</manvolnum>\n"
398" </citerefentry>\"\n"
399">\n"
400msgstr ""
401
402#. type: Plain text
403#: apt.ent:150
404#, no-wrap
405msgid ""
406"<!ENTITY gnome-apt \"<citerefentry>\n"
407" <refentrytitle><command>gnome-apt</command></refentrytitle>\n"
408" <manvolnum>1</manvolnum>\n"
409" </citerefentry>\"\n"
410">\n"
411msgstr ""
412
413#. type: Plain text
414#: apt.ent:156
415#, no-wrap
416msgid ""
417"<!ENTITY wajig \"<citerefentry>\n"
418" <refentrytitle><command>wajig</command></refentrytitle>\n"
419" <manvolnum>1</manvolnum>\n"
420" </citerefentry>\"\n"
421">\n"
422msgstr ""
423
424#. type: Plain text
bcf91c1b 425#: apt.ent:168
2a52e8c5
DK
426#, no-wrap
427msgid ""
428"<!-- Boiler plate docinfo section -->\n"
429"<!ENTITY apt-docinfo \"\n"
430" <refentryinfo>\n"
431" <address><email>apt@packages.debian.org</email></address>\n"
bcf91c1b
DK
432" <author>\n"
433" <firstname>Jason</firstname> <surname>Gunthorpe</surname>\n"
434" <contrib></contrib>\n"
435" </author>\n"
2a52e8c5
DK
436" <copyright><year>1998-2001</year> <holder>Jason "
437"Gunthorpe</holder></copyright>\n"
438" <date>28 October 2008</date>\n"
439" <productname>Linux</productname>\n"
440msgstr ""
441
442#. type: Plain text
bcf91c1b 443#: apt.ent:171
2a52e8c5
DK
444#, no-wrap
445msgid ""
446" </refentryinfo>\n"
447"\"> \n"
448msgstr ""
449
450#. type: Plain text
bcf91c1b 451#: apt.ent:177
2a52e8c5
DK
452#, no-wrap
453msgid ""
454"<!ENTITY apt-email \"\n"
455" <address>\n"
456" <email>apt@packages.debian.org</email>\n"
457" </address>\n"
458"\">\n"
459msgstr ""
460
461#. type: Plain text
bcf91c1b 462#: apt.ent:185
2a52e8c5
DK
463#, no-wrap
464msgid ""
465"<!ENTITY apt-author.jgunthorpe \"\n"
466" <author>\n"
467" <firstname>Jason</firstname>\n"
468" <surname>Gunthorpe</surname>\n"
bcf91c1b 469" <contrib></contrib>\n"
2a52e8c5
DK
470" </author>\n"
471"\">\n"
472msgstr ""
473
474#. type: Plain text
bcf91c1b 475#: apt.ent:193
2a52e8c5
DK
476#, no-wrap
477msgid ""
478"<!ENTITY apt-author.moconnor \"\n"
479" <author>\n"
480" <firstname>Mike</firstname>\n"
481" <surname>O'Connor</surname>\n"
bcf91c1b 482" <contrib></contrib>\n"
2a52e8c5
DK
483" </author>\n"
484"\">\n"
485msgstr ""
486
487#. type: Plain text
bcf91c1b 488#: apt.ent:200
2a52e8c5
DK
489#, no-wrap
490msgid ""
491"<!ENTITY apt-author.team \"\n"
492" <author>\n"
493" <othername>APT team</othername>\n"
bcf91c1b 494" <contrib></contrib>\n"
2a52e8c5
DK
495" </author>\n"
496"\">\n"
497msgstr ""
498
499#. type: Plain text
bcf91c1b 500#: apt.ent:204 apt.ent:215
2a52e8c5
DK
501#, no-wrap
502msgid ""
503"<!ENTITY apt-product \"\n"
504" <productname>Linux</productname>\n"
505"\">\n"
506msgstr ""
507
508#. type: Plain text
bcf91c1b 509#: apt.ent:211
2a52e8c5
DK
510#, no-wrap
511msgid ""
512"<!ENTITY apt-copyright \"\n"
513" <copyright>\n"
514" <holder>Jason Gunthorpe</holder>\n"
515" <year>1998-2001</year>\n"
516" </copyright>\n"
517"\">\n"
518msgstr ""
519
520#. type: Plain text
bcf91c1b 521#: apt.ent:221
2a52e8c5
DK
522#, no-wrap
523msgid ""
524"<!ENTITY apt-qapage \"\n"
525"\t<para>\n"
526"\t\t<ulink url='http://packages.qa.debian.org/a/apt.html'>QA Page</ulink>\n"
527"\t</para>\n"
528"\">\n"
529msgstr ""
530
531#. type: Plain text
bcf91c1b 532#: apt.ent:232
2a52e8c5
DK
533#, no-wrap
534msgid ""
535"<!-- Boiler plate Bug reporting section -->\n"
536"<!ENTITY manbugs \"\n"
537" <refsect1><title>Bugs</title>\n"
538" <para><ulink url='http://bugs.debian.org/src:apt'>APT bug "
539"page</ulink>. \n"
540" If you wish to report a bug in APT, please see\n"
541" <filename>/usr/share/doc/debian/bug-reporting.txt</filename> or the\n"
542" &reportbug; command.\n"
543" </para>\n"
544" </refsect1>\n"
545"\">\n"
546msgstr ""
547
548#. type: Plain text
bcf91c1b 549#: apt.ent:240
2a52e8c5
DK
550#, no-wrap
551msgid ""
552"<!-- Boiler plate Author section -->\n"
553"<!ENTITY manauthor \"\n"
554" <refsect1><title>Author</title>\n"
555" <para>APT was written by the APT team "
556"<email>apt@packages.debian.org</email>.\n"
557" </para>\n"
558" </refsect1>\n"
559"\">\n"
560msgstr ""
561
562#. type: Plain text
bcf91c1b 563#: apt.ent:250
2a52e8c5
DK
564#, no-wrap
565msgid ""
566"<!-- Should be used within the option section of the text to\n"
567" put in the blurb about -h, -v, -c and -o -->\n"
568"<!ENTITY apt-commonoptions \"\n"
569" <varlistentry><term><option>-h</option></term>\n"
570" <term><option>--help</option></term>\n"
571" <listitem><para>Show a short usage summary.\n"
572" </para>\n"
573" </listitem>\n"
574" </varlistentry>\n"
575msgstr ""
576
577#. type: Plain text
bcf91c1b 578#: apt.ent:258
2a52e8c5
DK
579#, no-wrap
580msgid ""
581" <varlistentry>\n"
582" <term><option>-v</option></term>\n"
583" <term><option>--version</option></term>\n"
584" <listitem><para>Show the program version.\n"
585" </para>\n"
586" </listitem>\n"
587" </varlistentry>\n"
588msgstr ""
589
590#. type: Plain text
bcf91c1b 591#: apt.ent:268
2a52e8c5
DK
592#, no-wrap
593msgid ""
594" <varlistentry>\n"
595" <term><option>-c</option></term>\n"
596" <term><option>--config-file</option></term>\n"
597" <listitem><para>Configuration File; Specify a configuration file to "
598"use. \n"
599" The program will read the default configuration file and then this \n"
600" configuration file. See &apt-conf; for syntax information. \n"
601" </para>\n"
602" </listitem>\n"
603" </varlistentry>\n"
604msgstr ""
605
606#. type: Plain text
bcf91c1b 607#: apt.ent:280
2a52e8c5
DK
608#, no-wrap
609msgid ""
610" <varlistentry>\n"
611" <term><option>-o</option></term>\n"
612" <term><option>--option</option></term>\n"
613" <listitem><para>Set a Configuration Option; This will set an "
614"arbitrary\n"
615" configuration option. The syntax is <option>-o "
616"Foo::Bar=bar</option>.\n"
617" <option>-o</option> and <option>--option</option> can be used "
618"multiple\n"
619" times to set different options.\n"
620" </para>\n"
621" </listitem>\n"
622" </varlistentry>\n"
623"\">\n"
624msgstr ""
625
626#. type: Plain text
bcf91c1b 627#: apt.ent:291
2a52e8c5
DK
628#, no-wrap
629msgid ""
630"<!-- Should be used within the option section of the text to\n"
631" put in the blurb about -h, -v, -c and -o -->\n"
632"<!ENTITY apt-cmdblurb \"\n"
633" <para>All command line options may be set using the configuration file, "
634"the\n"
635" descriptions indicate the configuration option to set. For boolean\n"
636" options you can override the config file by using something like \n"
637" <option>-f-</option>,<option>--no-f</option>, <option>-f=no</option>\n"
638" or several other variations.\n"
639" </para>\n"
640"\">\n"
641msgstr ""
642
bcf91c1b
DK
643#. type: Plain text
644#: apt.ent:297
645#, no-wrap
646msgid ""
647"<!ENTITY file-aptconf \"\n"
648" <varlistentry><term><filename>/etc/apt/apt.conf</filename></term>\n"
649" <listitem><para>APT configuration file.\n"
650" Configuration Item: "
651"<literal>Dir::Etc::Main</literal>.</para></listitem>\n"
652" </varlistentry>\n"
653msgstr ""
654
655#. type: Plain text
656#: apt.ent:303
657#, no-wrap
658msgid ""
659" <varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term>\n"
660" <listitem><para>APT configuration file fragments.\n"
661" Configuration Item: "
662"<literal>Dir::Etc::Parts</literal>.</para></listitem>\n"
663" </varlistentry>\n"
664"\">\n"
665msgstr ""
666
667#. type: Plain text
668#: apt.ent:309
669#, no-wrap
670msgid ""
671"<!ENTITY file-cachearchives \"\n"
672" <varlistentry><term><filename>&cachedir;/archives/</filename></term>\n"
673" <listitem><para>Storage area for retrieved package files.\n"
674" Configuration Item: "
675"<literal>Dir::Cache::Archives</literal>.</para></listitem>\n"
676" </varlistentry>\n"
677msgstr ""
678
679#. type: Plain text
680#: apt.ent:315
681#, no-wrap
682msgid ""
683" "
684"<varlistentry><term><filename>&cachedir;/archives/partial/</filename></term>\n"
685" <listitem><para>Storage area for package files in transit.\n"
686" Configuration Item: <literal>Dir::Cache::Archives</literal> (implicit "
687"partial). </para></listitem>\n"
688" </varlistentry>\n"
689"\">\n"
690msgstr ""
691
692#. type: Plain text
693#: apt.ent:325
694#, no-wrap
695msgid ""
696"<!ENTITY file-preferences \"\n"
697" <varlistentry><term><filename>/etc/apt/preferences</filename></term>\n"
698" <listitem><para>Version preferences file.\n"
699" This is where you would specify &quot;pinning&quot;,\n"
700" i.e. a preference to get certain packages\n"
701" from a separate source\n"
702" or from a different version of a distribution.\n"
703" Configuration Item: "
704"<literal>Dir::Etc::Preferences</literal>.</para></listitem>\n"
705" </varlistentry>\n"
706msgstr ""
707
708#. type: Plain text
709#: apt.ent:331
710#, no-wrap
711msgid ""
712" "
713"<varlistentry><term><filename>/etc/apt/preferences.d/</filename></term>\n"
714" <listitem><para>File fragments for the version preferences.\n"
715" Configuration Item: "
716"<literal>Dir::Etc::PreferencesParts</literal>.</para></listitem>\n"
717" </varlistentry>\n"
718"\">\n"
719msgstr ""
720
721#. type: Plain text
722#: apt.ent:337
723#, no-wrap
724msgid ""
725"<!ENTITY file-sourceslist \"\n"
726" <varlistentry><term><filename>/etc/apt/sources.list</filename></term>\n"
727" <listitem><para>Locations to fetch packages from.\n"
728" Configuration Item: "
729"<literal>Dir::Etc::SourceList</literal>.</para></listitem>\n"
730" </varlistentry>\n"
731msgstr ""
732
733#. type: Plain text
734#: apt.ent:343
735#, no-wrap
736msgid ""
737" "
738"<varlistentry><term><filename>/etc/apt/sources.list.d/</filename></term>\n"
739" <listitem><para>File fragments for locations to fetch packages from.\n"
740" Configuration Item: "
741"<literal>Dir::Etc::SourceParts</literal>.</para></listitem>\n"
742" </varlistentry>\n"
743"\">\n"
744msgstr ""
745
746#. type: Plain text
747#: apt.ent:350
748#, no-wrap
749msgid ""
750"<!ENTITY file-statelists \"\n"
751" <varlistentry><term><filename>&statedir;/lists/</filename></term>\n"
752" <listitem><para>Storage area for state information for each package "
753"resource specified in\n"
754" &sources-list;\n"
755" Configuration Item: "
756"<literal>Dir::State::Lists</literal>.</para></listitem>\n"
757" </varlistentry>\n"
758msgstr ""
759
760#. type: Plain text
761#: apt.ent:355
762#, no-wrap
763msgid ""
764" "
765"<varlistentry><term><filename>&statedir;/lists/partial/</filename></term>\n"
766" <listitem><para>Storage area for state information in transit.\n"
767" Configuration Item: <literal>Dir::State::Lists</literal> (implicit "
768"partial).</para></listitem>\n"
769" </varlistentry>\n"
770"\">\n"
771msgstr ""
772
2a52e8c5
DK
773#. The last update date
774#. type: Content of: <refentry><refentryinfo>
775#: apt-cache.8.xml:13 apt-config.8.xml:13 apt-extracttemplates.1.xml:13 apt-ftparchive.1.xml:13 apt-sortpkgs.1.xml:13 sources.list.5.xml:13
776msgid ""
777"&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>29 "
778"February 2004</date>"
779msgstr ""
780
781#. type: Content of: <refentry><refnamediv><refname>
bcf91c1b 782#: apt-cache.8.xml:22 apt-cache.8.xml:29
2a52e8c5
DK
783msgid "apt-cache"
784msgstr ""
785
786#. type: Content of: <refentry><refmeta><manvolnum>
787#: apt-cache.8.xml:23 apt-cdrom.8.xml:22 apt-config.8.xml:23 apt-get.8.xml:23 apt-key.8.xml:15 apt-mark.8.xml:23 apt-secure.8.xml:15
788msgid "8"
789msgstr ""
790
bcf91c1b
DK
791#. type: Content of: <refentry><refmeta><refmiscinfo>
792#: apt-cache.8.xml:24 apt-cdrom.8.xml:23 apt-config.8.xml:24 apt-extracttemplates.1.xml:24 apt-ftparchive.1.xml:24 apt-get.8.xml:24 apt-key.8.xml:16 apt-mark.8.xml:24 apt-secure.8.xml:16 apt-sortpkgs.1.xml:24 apt.conf.5.xml:30 apt_preferences.5.xml:23 sources.list.5.xml:24
793msgid "APT"
794msgstr ""
795
2a52e8c5 796#. type: Content of: <refentry><refnamediv><refpurpose>
bcf91c1b 797#: apt-cache.8.xml:30
2a52e8c5
DK
798msgid "APT package handling utility -- cache manipulator"
799msgstr ""
800
801#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
bcf91c1b 802#: apt-cache.8.xml:36
2a52e8c5
DK
803msgid ""
804"<command>apt-cache</command> <arg><option>-hvsn</option></arg> "
805"<arg><option>-o=<replaceable>config string</replaceable></option></arg> "
806"<arg><option>-c=<replaceable>file</replaceable></option></arg> <group "
807"choice=\"req\"> <arg>add <arg choice=\"plain\" "
808"rep=\"repeat\"><replaceable>file</replaceable></arg></arg> "
809"<arg>gencaches</arg> <arg>showpkg <arg choice=\"plain\" "
810"rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg>showsrc <arg "
811"choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
812"<arg>stats</arg> <arg>dump</arg> <arg>dumpavail</arg> <arg>unmet</arg> "
813"<arg>search <arg "
814"choice=\"plain\"><replaceable>regex</replaceable></arg></arg> <arg>show <arg "
815"choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
816"<arg>depends <arg choice=\"plain\" "
817"rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg>rdepends <arg "
818"choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
819"<arg>pkgnames <arg "
820"choice=\"plain\"><replaceable>prefix</replaceable></arg></arg> <arg>dotty "
821"<arg choice=\"plain\" "
822"rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg>xvcg <arg "
823"choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
824"<arg>policy <arg choice=\"plain\" "
825"rep=\"repeat\"><replaceable>pkgs</replaceable></arg></arg> <arg>madison <arg "
826"choice=\"plain\" rep=\"repeat\"><replaceable>pkgs</replaceable></arg></arg> "
827"</group>"
828msgstr ""
829
830#. type: Content of: <refentry><refsect1><title>
bcf91c1b 831#: apt-cache.8.xml:62 apt-cdrom.8.xml:47 apt-config.8.xml:47 apt-extracttemplates.1.xml:43 apt-ftparchive.1.xml:55 apt-get.8.xml:125 apt-key.8.xml:34 apt-mark.8.xml:52 apt-secure.8.xml:40 apt-sortpkgs.1.xml:44 apt.conf.5.xml:39 apt_preferences.5.xml:33 sources.list.5.xml:33
2a52e8c5
DK
832msgid "Description"
833msgstr ""
834
835#. type: Content of: <refentry><refsect1><para>
bcf91c1b 836#: apt-cache.8.xml:63
2a52e8c5
DK
837msgid ""
838"<command>apt-cache</command> performs a variety of operations on APT's "
839"package cache. <command>apt-cache</command> does not manipulate the state of "
840"the system but does provide operations to search and generate interesting "
841"output from the package metadata."
842msgstr ""
843
844#. type: Content of: <refentry><refsect1><para>
bcf91c1b 845#: apt-cache.8.xml:68 apt-get.8.xml:131
2a52e8c5
DK
846msgid ""
847"Unless the <option>-h</option>, or <option>--help</option> option is given, "
848"one of the commands below must be present."
849msgstr ""
850
851#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 852#: apt-cache.8.xml:72
2a52e8c5
DK
853msgid "add <replaceable>file(s)</replaceable>"
854msgstr ""
855
856#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 857#: apt-cache.8.xml:73
2a52e8c5
DK
858msgid ""
859"<literal>add</literal> adds the named package index files to the package "
860"cache. This is for debugging only."
861msgstr ""
862
863#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 864#: apt-cache.8.xml:77
2a52e8c5
DK
865msgid "gencaches"
866msgstr ""
867
868#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 869#: apt-cache.8.xml:78
2a52e8c5
DK
870msgid ""
871"<literal>gencaches</literal> performs the same operation as <command>apt-get "
872"check</command>. It builds the source and package caches from the sources in "
873"&sources-list; and from <filename>/var/lib/dpkg/status</filename>."
874msgstr ""
875
876#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 877#: apt-cache.8.xml:84
2a52e8c5
DK
878msgid "showpkg <replaceable>pkg(s)</replaceable>"
879msgstr ""
880
881#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 882#: apt-cache.8.xml:85
2a52e8c5
DK
883msgid ""
884"<literal>showpkg</literal> displays information about the packages listed on "
885"the command line. Remaining arguments are package names. The available "
886"versions and reverse dependencies of each package listed are listed, as well "
887"as forward dependencies for each version. Forward (normal) dependencies are "
888"those packages upon which the package in question depends; reverse "
889"dependencies are those packages that depend upon the package in "
890"question. Thus, forward dependencies must be satisfied for a package, but "
891"reverse dependencies need not be. For instance, <command>apt-cache showpkg "
892"libreadline2</command> would produce output similar to the following:"
893msgstr ""
894
895#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting>
bcf91c1b 896#: apt-cache.8.xml:97
2a52e8c5
DK
897#, no-wrap
898msgid ""
899"Package: libreadline2\n"
900"Versions: 2.1-12(/var/state/apt/lists/foo_Packages),\n"
901"Reverse Depends: \n"
902" libreadlineg2,libreadline2\n"
903" libreadline2-altdev,libreadline2\n"
904"Dependencies:\n"
905"2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))\n"
906"Provides:\n"
907"2.1-12 - \n"
908"Reverse Provides: \n"
909msgstr ""
910
911#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 912#: apt-cache.8.xml:109
2a52e8c5
DK
913msgid ""
914"Thus it may be seen that libreadline2, version 2.1-12, depends on libc5 and "
915"ncurses3.0 which must be installed for libreadline2 to work. In turn, "
916"libreadlineg2 and libreadline2-altdev depend on libreadline2. If "
917"libreadline2 is installed, libc5 and ncurses3.0 (and ldso) must also be "
918"installed; libreadlineg2 and libreadline2-altdev do not have to be "
919"installed. For the specific meaning of the remainder of the output it is "
920"best to consult the apt source code."
921msgstr ""
922
923#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 924#: apt-cache.8.xml:118
2a52e8c5
DK
925msgid "stats"
926msgstr ""
927
928#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 929#: apt-cache.8.xml:118
2a52e8c5
DK
930msgid ""
931"<literal>stats</literal> displays some statistics about the cache. No "
932"further arguments are expected. Statistics reported are:"
933msgstr ""
934
935#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
bcf91c1b 936#: apt-cache.8.xml:121
2a52e8c5
DK
937msgid ""
938"<literal>Total package names</literal> is the number of package names found "
939"in the cache."
940msgstr ""
941
942#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
bcf91c1b 943#: apt-cache.8.xml:125
2a52e8c5
DK
944msgid ""
945"<literal>Normal packages</literal> is the number of regular, ordinary "
946"package names; these are packages that bear a one-to-one correspondence "
947"between their names and the names used by other packages for them in "
948"dependencies. The majority of packages fall into this category."
949msgstr ""
950
951#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
bcf91c1b 952#: apt-cache.8.xml:131
2a52e8c5
DK
953msgid ""
954"<literal>Pure virtual packages</literal> is the number of packages that "
955"exist only as a virtual package name; that is, packages only \"provide\" the "
956"virtual package name, and no package actually uses the name. For instance, "
957"\"mail-transport-agent\" in the Debian GNU/Linux system is a pure virtual "
958"package; several packages provide \"mail-transport-agent\", but there is no "
959"package named \"mail-transport-agent\"."
960msgstr ""
961
962#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
bcf91c1b 963#: apt-cache.8.xml:139
2a52e8c5
DK
964msgid ""
965"<literal>Single virtual packages</literal> is the number of packages with "
966"only one package providing a particular virtual package. For example, in the "
967"Debian GNU/Linux system, \"X11-text-viewer\" is a virtual package, but only "
968"one package, xless, provides \"X11-text-viewer\"."
969msgstr ""
970
971#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
bcf91c1b 972#: apt-cache.8.xml:145
2a52e8c5
DK
973msgid ""
974"<literal>Mixed virtual packages</literal> is the number of packages that "
975"either provide a particular virtual package or have the virtual package name "
976"as the package name. For instance, in the Debian GNU/Linux system, "
977"\"debconf\" is both an actual package, and provided by the debconf-tiny "
978"package."
979msgstr ""
980
981#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
bcf91c1b 982#: apt-cache.8.xml:152
2a52e8c5
DK
983msgid ""
984"<literal>Missing</literal> is the number of package names that were "
985"referenced in a dependency but were not provided by any package. Missing "
986"packages may be in evidence if a full distribution is not accessed, or if a "
987"package (real or virtual) has been dropped from the distribution. Usually "
988"they are referenced from Conflicts or Breaks statements."
989msgstr ""
990
991#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
bcf91c1b 992#: apt-cache.8.xml:159
2a52e8c5
DK
993msgid ""
994"<literal>Total distinct</literal> versions is the number of package versions "
995"found in the cache; this value is therefore at least equal to the number of "
996"total package names. If more than one distribution (both \"stable\" and "
997"\"unstable\", for instance), is being accessed, this value can be "
998"considerably larger than the number of total package names."
999msgstr ""
1000
1001#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
bcf91c1b 1002#: apt-cache.8.xml:166
2a52e8c5
DK
1003msgid ""
1004"<literal>Total dependencies</literal> is the number of dependency "
1005"relationships claimed by all of the packages in the cache."
1006msgstr ""
1007
1008#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1009#: apt-cache.8.xml:173
2a52e8c5
DK
1010msgid "showsrc <replaceable>pkg(s)</replaceable>"
1011msgstr ""
1012
1013#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1014#: apt-cache.8.xml:174
2a52e8c5
DK
1015msgid ""
1016"<literal>showsrc</literal> displays all the source package records that "
1017"match the given package names. All versions are shown, as well as all "
1018"records that declare the name to be a Binary."
1019msgstr ""
1020
1021#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1022#: apt-cache.8.xml:179 apt-config.8.xml:84
2a52e8c5
DK
1023msgid "dump"
1024msgstr ""
1025
1026#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1027#: apt-cache.8.xml:180
2a52e8c5
DK
1028msgid ""
1029"<literal>dump</literal> shows a short listing of every package in the "
1030"cache. It is primarily for debugging."
1031msgstr ""
1032
1033#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1034#: apt-cache.8.xml:184
2a52e8c5
DK
1035msgid "dumpavail"
1036msgstr ""
1037
1038#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1039#: apt-cache.8.xml:185
2a52e8c5
DK
1040msgid ""
1041"<literal>dumpavail</literal> prints out an available list to stdout. This is "
1042"suitable for use with &dpkg; and is used by the &dselect; method."
1043msgstr ""
1044
1045#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1046#: apt-cache.8.xml:189
2a52e8c5
DK
1047msgid "unmet"
1048msgstr ""
1049
1050#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1051#: apt-cache.8.xml:190
2a52e8c5
DK
1052msgid ""
1053"<literal>unmet</literal> displays a summary of all unmet dependencies in the "
1054"package cache."
1055msgstr ""
1056
1057#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1058#: apt-cache.8.xml:194
2a52e8c5
DK
1059msgid "show <replaceable>pkg(s)</replaceable>"
1060msgstr ""
1061
1062#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1063#: apt-cache.8.xml:195
2a52e8c5
DK
1064msgid ""
1065"<literal>show</literal> performs a function similar to <command>dpkg "
1066"--print-avail</command>; it displays the package records for the named "
1067"packages."
1068msgstr ""
1069
1070#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1071#: apt-cache.8.xml:200
2a52e8c5
DK
1072msgid "search <replaceable>regex [ regex ... ]</replaceable>"
1073msgstr ""
1074
1075#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1076#: apt-cache.8.xml:201
2a52e8c5
DK
1077msgid ""
1078"<literal>search</literal> performs a full text search on all available "
1079"package lists for the POSIX regex pattern given, see "
1080"<citerefentry><refentrytitle><command>regex</command></refentrytitle> "
1081"<manvolnum>7</manvolnum></citerefentry>. It searches the package names and "
1082"the descriptions for an occurrence of the regular expression and prints out "
1083"the package name and the short description, including virtual package "
1084"names. If <option>--full</option> is given then output identical to "
1085"<literal>show</literal> is produced for each matched package, and if "
1086"<option>--names-only</option> is given then the long description is not "
1087"searched, only the package name is."
1088msgstr ""
1089
1090#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1091#: apt-cache.8.xml:214
2a52e8c5
DK
1092msgid ""
1093"Separate arguments can be used to specify multiple search patterns that are "
1094"and'ed together."
1095msgstr ""
1096
1097#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1098#: apt-cache.8.xml:218
2a52e8c5
DK
1099msgid "depends <replaceable>pkg(s)</replaceable>"
1100msgstr ""
1101
1102#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1103#: apt-cache.8.xml:219
2a52e8c5
DK
1104msgid ""
1105"<literal>depends</literal> shows a listing of each dependency a package has "
1106"and all the possible other packages that can fulfill that dependency."
1107msgstr ""
1108
1109#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1110#: apt-cache.8.xml:223
2a52e8c5
DK
1111msgid "rdepends <replaceable>pkg(s)</replaceable>"
1112msgstr ""
1113
1114#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1115#: apt-cache.8.xml:224
2a52e8c5
DK
1116msgid ""
1117"<literal>rdepends</literal> shows a listing of each reverse dependency a "
1118"package has."
1119msgstr ""
1120
1121#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1122#: apt-cache.8.xml:228
2a52e8c5
DK
1123msgid "pkgnames <replaceable>[ prefix ]</replaceable>"
1124msgstr ""
1125
1126#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1127#: apt-cache.8.xml:229
2a52e8c5
DK
1128msgid ""
1129"This command prints the name of each package in the system. The optional "
1130"argument is a prefix match to filter the name list. The output is suitable "
1131"for use in a shell tab complete function and the output is generated "
1132"extremely quickly. This command is best used with the "
1133"<option>--generate</option> option."
1134msgstr ""
1135
1136#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1137#: apt-cache.8.xml:236
2a52e8c5
DK
1138msgid "dotty <replaceable>pkg(s)</replaceable>"
1139msgstr ""
1140
1141#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1142#: apt-cache.8.xml:237
2a52e8c5
DK
1143msgid ""
1144"<literal>dotty</literal> takes a list of packages on the command line and "
1145"generates output suitable for use by dotty from the <ulink "
1146"url=\"http://www.research.att.com/sw/tools/graphviz/\">GraphViz</ulink> "
1147"package. The result will be a set of nodes and edges representing the "
1148"relationships between the packages. By default the given packages will trace "
1149"out all dependent packages; this can produce a very large graph. To limit "
1150"the output to only the packages listed on the command line, set the "
1151"<literal>APT::Cache::GivenOnly</literal> option."
1152msgstr ""
1153
1154#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1155#: apt-cache.8.xml:246
2a52e8c5
DK
1156msgid ""
1157"The resulting nodes will have several shapes; normal packages are boxes, "
1158"pure provides are triangles, mixed provides are diamonds, missing packages "
1159"are hexagons. Orange boxes mean recursion was stopped [leaf packages], blue "
1160"lines are pre-depends, green lines are conflicts."
1161msgstr ""
1162
1163#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1164#: apt-cache.8.xml:251
2a52e8c5
DK
1165msgid "Caution, dotty cannot graph larger sets of packages."
1166msgstr ""
1167
1168#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1169#: apt-cache.8.xml:254
2a52e8c5
DK
1170msgid "xvcg <replaceable>pkg(s)</replaceable>"
1171msgstr ""
1172
1173#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1174#: apt-cache.8.xml:255
2a52e8c5
DK
1175msgid ""
1176"The same as <literal>dotty</literal>, only for xvcg from the <ulink "
1177"url=\"http://rw4.cs.uni-sb.de/users/sander/html/gsvcg1.html\">VCG "
1178"tool</ulink>."
1179msgstr ""
1180
1181#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1182#: apt-cache.8.xml:259
2a52e8c5
DK
1183msgid "policy <replaceable>[ pkg(s) ]</replaceable>"
1184msgstr ""
1185
1186#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1187#: apt-cache.8.xml:260
2a52e8c5
DK
1188msgid ""
1189"<literal>policy</literal> is meant to help debug issues relating to the "
1190"preferences file. With no arguments it will print out the priorities of each "
1191"source. Otherwise it prints out detailed information about the priority "
1192"selection of the named package."
1193msgstr ""
1194
1195#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1196#: apt-cache.8.xml:266
2a52e8c5
DK
1197msgid "madison <replaceable>/[ pkg(s) ]</replaceable>"
1198msgstr ""
1199
1200#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1201#: apt-cache.8.xml:267
2a52e8c5
DK
1202msgid ""
1203"<literal>apt-cache</literal>'s <literal>madison</literal> command attempts "
1204"to mimic the output format and a subset of the functionality of the Debian "
1205"archive management tool, <literal>madison</literal>. It displays available "
1206"versions of a package in a tabular format. Unlike the original "
1207"<literal>madison</literal>, it can only display information for the "
1208"architecture for which APT has retrieved package lists "
1209"(<literal>APT::Architecture</literal>)."
1210msgstr ""
1211
1212#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1213#: apt-cache.8.xml:278 apt-config.8.xml:93 apt-extracttemplates.1.xml:56 apt-ftparchive.1.xml:492 apt-get.8.xml:319 apt-mark.8.xml:89 apt-sortpkgs.1.xml:54 apt.conf.5.xml:408 apt.conf.5.xml:430
2a52e8c5
DK
1214msgid "options"
1215msgstr ""
1216
1217#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1218#: apt-cache.8.xml:282
2a52e8c5
DK
1219msgid "<option>-p</option>"
1220msgstr ""
1221
1222#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1223#: apt-cache.8.xml:282
2a52e8c5
DK
1224msgid "<option>--pkg-cache</option>"
1225msgstr ""
1226
1227#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1228#: apt-cache.8.xml:283
2a52e8c5
DK
1229msgid ""
1230"Select the file to store the package cache. The package cache is the primary "
1231"cache used by all operations. Configuration Item: "
1232"<literal>Dir::Cache::pkgcache</literal>."
1233msgstr ""
1234
1235#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1236#: apt-cache.8.xml:288 apt-ftparchive.1.xml:535 apt-get.8.xml:376 apt-sortpkgs.1.xml:58
2a52e8c5
DK
1237msgid "<option>-s</option>"
1238msgstr ""
1239
1240#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1241#: apt-cache.8.xml:288
2a52e8c5
DK
1242msgid "<option>--src-cache</option>"
1243msgstr ""
1244
1245#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1246#: apt-cache.8.xml:289
2a52e8c5
DK
1247msgid ""
1248"Select the file to store the source cache. The source is used only by "
1249"<literal>gencaches</literal> and it stores a parsed version of the package "
1250"information from remote sources. When building the package cache the source "
1251"cache is used to avoid reparsing all of the package files. Configuration "
1252"Item: <literal>Dir::Cache::srcpkgcache</literal>."
1253msgstr ""
1254
1255#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1256#: apt-cache.8.xml:296 apt-ftparchive.1.xml:509 apt-get.8.xml:366
2a52e8c5
DK
1257msgid "<option>-q</option>"
1258msgstr ""
1259
1260#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1261#: apt-cache.8.xml:296 apt-ftparchive.1.xml:509 apt-get.8.xml:366
2a52e8c5
DK
1262msgid "<option>--quiet</option>"
1263msgstr ""
1264
1265#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1266#: apt-cache.8.xml:297
2a52e8c5
DK
1267msgid ""
1268"Quiet; produces output suitable for logging, omitting progress indicators. "
1269"More q's will produce more quietness up to a maximum of 2. You can also use "
1270"<option>-q=#</option> to set the quietness level, overriding the "
1271"configuration file. Configuration Item: <literal>quiet</literal>."
1272msgstr ""
1273
1274#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1275#: apt-cache.8.xml:303
2a52e8c5
DK
1276msgid "<option>-i</option>"
1277msgstr ""
1278
1279#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1280#: apt-cache.8.xml:303
2a52e8c5
DK
1281msgid "<option>--important</option>"
1282msgstr ""
1283
1284#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1285#: apt-cache.8.xml:304
2a52e8c5
DK
1286msgid ""
1287"Print only important dependencies; for use with unmet and depends. Causes "
1288"only Depends and Pre-Depends relations to be printed. Configuration Item: "
1289"<literal>APT::Cache::Important</literal>."
1290msgstr ""
1291
1292#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1293#: apt-cache.8.xml:309 apt-cdrom.8.xml:121 apt-get.8.xml:333
2a52e8c5
DK
1294msgid "<option>-f</option>"
1295msgstr ""
1296
1297#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1298#: apt-cache.8.xml:309
2a52e8c5
DK
1299msgid "<option>--full</option>"
1300msgstr ""
1301
1302#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1303#: apt-cache.8.xml:310
2a52e8c5
DK
1304msgid ""
1305"Print full package records when searching. Configuration Item: "
1306"<literal>APT::Cache::ShowFull</literal>."
1307msgstr ""
1308
1309#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1310#: apt-cache.8.xml:314 apt-cdrom.8.xml:131
2a52e8c5
DK
1311msgid "<option>-a</option>"
1312msgstr ""
1313
1314#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1315#: apt-cache.8.xml:314
2a52e8c5
DK
1316msgid "<option>--all-versions</option>"
1317msgstr ""
1318
1319#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1320#: apt-cache.8.xml:315
2a52e8c5
DK
1321msgid ""
1322"Print full records for all available versions. This is the default; to turn "
1323"it off, use <option>--no-all-versions</option>. If "
1324"<option>--no-all-versions</option> is specified, only the candidate version "
1325"will displayed (the one which would be selected for installation). This "
1326"option is only applicable to the <literal>show</literal> command. "
1327"Configuration Item: <literal>APT::Cache::AllVersions</literal>."
1328msgstr ""
1329
1330#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1331#: apt-cache.8.xml:323
2a52e8c5
DK
1332msgid "<option>-g</option>"
1333msgstr ""
1334
1335#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1336#: apt-cache.8.xml:323
2a52e8c5
DK
1337msgid "<option>--generate</option>"
1338msgstr ""
1339
1340#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1341#: apt-cache.8.xml:324
2a52e8c5
DK
1342msgid ""
1343"Perform automatic package cache regeneration, rather than use the cache as "
1344"it is. This is the default; to turn it off, use "
1345"<option>--no-generate</option>. Configuration Item: "
1346"<literal>APT::Cache::Generate</literal>."
1347msgstr ""
1348
1349#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1350#: apt-cache.8.xml:329
2a52e8c5
DK
1351msgid "<option>--names-only</option>"
1352msgstr ""
1353
1354#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1355#: apt-cache.8.xml:329 apt-cdrom.8.xml:139
2a52e8c5
DK
1356msgid "<option>-n</option>"
1357msgstr ""
1358
1359#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1360#: apt-cache.8.xml:330
2a52e8c5
DK
1361msgid ""
1362"Only search on the package names, not the long descriptions. Configuration "
1363"Item: <literal>APT::Cache::NamesOnly</literal>."
1364msgstr ""
1365
1366#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1367#: apt-cache.8.xml:334
2a52e8c5
DK
1368msgid "<option>--all-names</option>"
1369msgstr ""
1370
1371#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1372#: apt-cache.8.xml:335
2a52e8c5
DK
1373msgid ""
1374"Make <literal>pkgnames</literal> print all names, including virtual packages "
1375"and missing dependencies. Configuration Item: "
1376"<literal>APT::Cache::AllNames</literal>."
1377msgstr ""
1378
1379#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1380#: apt-cache.8.xml:340
2a52e8c5
DK
1381msgid "<option>--recurse</option>"
1382msgstr ""
1383
1384#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1385#: apt-cache.8.xml:341
2a52e8c5
DK
1386msgid ""
1387"Make <literal>depends</literal> and <literal>rdepends</literal> recursive so "
1388"that all packages mentioned are printed once. Configuration Item: "
1389"<literal>APT::Cache::RecurseDepends</literal>."
1390msgstr ""
1391
1392#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1393#: apt-cache.8.xml:346
2a52e8c5
DK
1394msgid "<option>--installed</option>"
1395msgstr ""
1396
1397#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1398#: apt-cache.8.xml:348
2a52e8c5
DK
1399msgid ""
1400"Limit the output of <literal>depends</literal> and "
1401"<literal>rdepends</literal> to packages which are currently installed. "
1402"Configuration Item: <literal>APT::Cache::Installed</literal>."
1403msgstr ""
1404
1405#. type: Content of: <refentry><refsect1><variablelist>
bcf91c1b 1406#: apt-cache.8.xml:353 apt-cdrom.8.xml:150 apt-config.8.xml:98 apt-extracttemplates.1.xml:67 apt-ftparchive.1.xml:547 apt-get.8.xml:554 apt-sortpkgs.1.xml:64
2a52e8c5
DK
1407msgid "&apt-commonoptions;"
1408msgstr ""
1409
1410#. type: Content of: <refentry><refsect1><title>
d5081aee 1411#: apt-cache.8.xml:358 apt-get.8.xml:559 apt-key.8.xml:138 apt-mark.8.xml:122 apt.conf.5.xml:940 apt_preferences.5.xml:615
2a52e8c5
DK
1412msgid "Files"
1413msgstr ""
1414
bcf91c1b
DK
1415#. type: Content of: <refentry><refsect1><variablelist>
1416#: apt-cache.8.xml:360
1417msgid "&file-sourceslist; &file-statelists;"
2a52e8c5
DK
1418msgstr ""
1419
1420#. type: Content of: <refentry><refsect1><title>
d5081aee 1421#: apt-cache.8.xml:365 apt-cdrom.8.xml:155 apt-config.8.xml:103 apt-extracttemplates.1.xml:74 apt-ftparchive.1.xml:563 apt-get.8.xml:569 apt-key.8.xml:162 apt-mark.8.xml:133 apt-secure.8.xml:181 apt-sortpkgs.1.xml:69 apt.conf.5.xml:946 apt_preferences.5.xml:622 sources.list.5.xml:221
2a52e8c5
DK
1422msgid "See Also"
1423msgstr ""
1424
1425#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1426#: apt-cache.8.xml:366
2a52e8c5
DK
1427msgid "&apt-conf;, &sources-list;, &apt-get;"
1428msgstr ""
1429
1430#. type: Content of: <refentry><refsect1><title>
bcf91c1b 1431#: apt-cache.8.xml:370 apt-cdrom.8.xml:160 apt-config.8.xml:108 apt-extracttemplates.1.xml:78 apt-ftparchive.1.xml:567 apt-get.8.xml:575 apt-mark.8.xml:137 apt-sortpkgs.1.xml:73
2a52e8c5
DK
1432msgid "Diagnostics"
1433msgstr ""
1434
1435#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1436#: apt-cache.8.xml:371
2a52e8c5
DK
1437msgid ""
1438"<command>apt-cache</command> returns zero on normal operation, decimal 100 "
1439"on error."
1440msgstr ""
1441
1442#. type: Content of: <refentry><refentryinfo>
1443#: apt-cdrom.8.xml:13
1444msgid ""
1445"&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>14 "
1446"February 2004</date>"
1447msgstr ""
1448
1449#. type: Content of: <refentry><refnamediv><refname>
bcf91c1b 1450#: apt-cdrom.8.xml:21 apt-cdrom.8.xml:28
2a52e8c5
DK
1451msgid "apt-cdrom"
1452msgstr ""
1453
1454#. type: Content of: <refentry><refnamediv><refpurpose>
bcf91c1b 1455#: apt-cdrom.8.xml:29
2a52e8c5
DK
1456msgid "APT CDROM management utility"
1457msgstr ""
1458
1459#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
bcf91c1b 1460#: apt-cdrom.8.xml:35
2a52e8c5
DK
1461msgid ""
1462"<command>apt-cdrom</command> <arg><option>-hvrmfan</option></arg> "
1463"<arg><option>-d=<replaceable>cdrom mount point</replaceable></option></arg> "
1464"<arg><option>-o=<replaceable>config string</replaceable></option></arg> "
1465"<arg><option>-c=<replaceable>file</replaceable></option></arg> <group> "
1466"<arg>add</arg> <arg>ident</arg> </group>"
1467msgstr ""
1468
1469#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1470#: apt-cdrom.8.xml:48
2a52e8c5
DK
1471msgid ""
1472"<command>apt-cdrom</command> is used to add a new CDROM to APTs list of "
1473"available sources. <command>apt-cdrom</command> takes care of determining "
1474"the structure of the disc as well as correcting for several possible "
1475"mis-burns and verifying the index files."
1476msgstr ""
1477
1478#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1479#: apt-cdrom.8.xml:55
2a52e8c5
DK
1480msgid ""
1481"It is necessary to use <command>apt-cdrom</command> to add CDs to the APT "
1482"system, it cannot be done by hand. Furthermore each disk in a multi-cd set "
1483"must be inserted and scanned separately to account for possible mis-burns."
1484msgstr ""
1485
1486#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
bcf91c1b 1487#: apt-cdrom.8.xml:65
2a52e8c5
DK
1488msgid "add"
1489msgstr ""
1490
1491#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 1492#: apt-cdrom.8.xml:66
2a52e8c5
DK
1493msgid ""
1494"<literal>add</literal> is used to add a new disc to the source list. It will "
1495"unmount the CDROM device, prompt for a disk to be inserted and then procceed "
1496"to scan it and copy the index files. If the disc does not have a proper "
1497"<filename>disk</filename> directory you will be prompted for a descriptive "
1498"title."
1499msgstr ""
1500
1501#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 1502#: apt-cdrom.8.xml:74
2a52e8c5
DK
1503msgid ""
1504"APT uses a CDROM ID to track which disc is currently in the drive and "
1505"maintains a database of these IDs in "
1506"<filename>&statedir;/cdroms.list</filename>"
1507msgstr ""
1508
1509#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
bcf91c1b 1510#: apt-cdrom.8.xml:81
2a52e8c5
DK
1511msgid "ident"
1512msgstr ""
1513
1514#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 1515#: apt-cdrom.8.xml:82
2a52e8c5
DK
1516msgid ""
1517"A debugging tool to report the identity of the current disc as well as the "
1518"stored file name"
1519msgstr ""
1520
1521#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1522#: apt-cdrom.8.xml:61
2a52e8c5
DK
1523msgid ""
1524"Unless the <option>-h</option>, or <option>--help</option> option is given "
1525"one of the commands below must be present. <placeholder "
1526"type=\"variablelist\" id=\"0\"/>"
1527msgstr ""
1528
1529#. type: Content of: <refentry><refsect1><title>
bcf91c1b 1530#: apt-cdrom.8.xml:91
2a52e8c5
DK
1531msgid "Options"
1532msgstr ""
1533
1534#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1535#: apt-cdrom.8.xml:95 apt-ftparchive.1.xml:503 apt-get.8.xml:328
2a52e8c5
DK
1536msgid "<option>-d</option>"
1537msgstr ""
1538
1539#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1540#: apt-cdrom.8.xml:95
2a52e8c5
DK
1541msgid "<option>--cdrom</option>"
1542msgstr ""
1543
1544#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1545#: apt-cdrom.8.xml:96
2a52e8c5
DK
1546msgid ""
1547"Mount point; specify the location to mount the cdrom. This mount point must "
1548"be listed in <filename>/etc/fstab</filename> and properly configured. "
1549"Configuration Item: <literal>Acquire::cdrom::mount</literal>."
1550msgstr ""
1551
1552#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1553#: apt-cdrom.8.xml:104
2a52e8c5
DK
1554msgid "<option>-r</option>"
1555msgstr ""
1556
1557#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1558#: apt-cdrom.8.xml:104
2a52e8c5
DK
1559msgid "<option>--rename</option>"
1560msgstr ""
1561
1562#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1563#: apt-cdrom.8.xml:105
2a52e8c5
DK
1564msgid ""
1565"Rename a disc; change the label of a disk or override the disks given "
1566"label. This option will cause <command>apt-cdrom</command> to prompt for a "
1567"new label. Configuration Item: <literal>APT::CDROM::Rename</literal>."
1568msgstr ""
1569
1570#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1571#: apt-cdrom.8.xml:113 apt-get.8.xml:347
2a52e8c5
DK
1572msgid "<option>-m</option>"
1573msgstr ""
1574
1575#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1576#: apt-cdrom.8.xml:113
2a52e8c5
DK
1577msgid "<option>--no-mount</option>"
1578msgstr ""
1579
1580#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1581#: apt-cdrom.8.xml:114
2a52e8c5
DK
1582msgid ""
1583"No mounting; prevent <command>apt-cdrom</command> from mounting and "
1584"unmounting the mount point. Configuration Item: "
1585"<literal>APT::CDROM::NoMount</literal>."
1586msgstr ""
1587
1588#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1589#: apt-cdrom.8.xml:121
2a52e8c5
DK
1590msgid "<option>--fast</option>"
1591msgstr ""
1592
1593#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1594#: apt-cdrom.8.xml:122
2a52e8c5
DK
1595msgid ""
1596"Fast Copy; Assume the package files are valid and do not check every "
1597"package. This option should be used only if <command>apt-cdrom</command> has "
1598"been run on this disc before and did not detect any errors. Configuration "
1599"Item: <literal>APT::CDROM::Fast</literal>."
1600msgstr ""
1601
1602#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1603#: apt-cdrom.8.xml:131
2a52e8c5
DK
1604msgid "<option>--thorough</option>"
1605msgstr ""
1606
1607#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1608#: apt-cdrom.8.xml:132
2a52e8c5
DK
1609msgid ""
1610"Thorough Package Scan; This option may be needed with some old Debian "
1611"1.1/1.2 discs that have Package files in strange places. It takes much "
1612"longer to scan the CD but will pick them all up."
1613msgstr ""
1614
1615#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1616#: apt-cdrom.8.xml:140 apt-get.8.xml:378
2a52e8c5
DK
1617msgid "<option>--just-print</option>"
1618msgstr ""
1619
1620#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1621#: apt-cdrom.8.xml:141 apt-get.8.xml:380
2a52e8c5
DK
1622msgid "<option>--recon</option>"
1623msgstr ""
1624
1625#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1626#: apt-cdrom.8.xml:142 apt-get.8.xml:381
2a52e8c5
DK
1627msgid "<option>--no-act</option>"
1628msgstr ""
1629
1630#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1631#: apt-cdrom.8.xml:143
2a52e8c5
DK
1632msgid ""
1633"No Changes; Do not change the &sources-list; file and do not write index "
1634"files. Everything is still checked however. Configuration Item: "
1635"<literal>APT::CDROM::NoAct</literal>."
1636msgstr ""
1637
1638#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1639#: apt-cdrom.8.xml:156
2a52e8c5
DK
1640msgid "&apt-conf;, &apt-get;, &sources-list;"
1641msgstr ""
1642
1643#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1644#: apt-cdrom.8.xml:161
2a52e8c5
DK
1645msgid ""
1646"<command>apt-cdrom</command> returns zero on normal operation, decimal 100 "
1647"on error."
1648msgstr ""
1649
1650#. type: Content of: <refentry><refnamediv><refname>
bcf91c1b 1651#: apt-config.8.xml:22 apt-config.8.xml:29
2a52e8c5
DK
1652msgid "apt-config"
1653msgstr ""
1654
1655#. type: Content of: <refentry><refnamediv><refpurpose>
bcf91c1b 1656#: apt-config.8.xml:30
2a52e8c5
DK
1657msgid "APT Configuration Query program"
1658msgstr ""
1659
1660#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
bcf91c1b 1661#: apt-config.8.xml:36
2a52e8c5
DK
1662msgid ""
1663"<command>apt-config</command> <arg><option>-hv</option></arg> "
1664"<arg><option>-o=<replaceable>config string</replaceable></option></arg> "
1665"<arg><option>-c=<replaceable>file</replaceable></option></arg> <group "
1666"choice=\"req\"> <arg>shell</arg> <arg>dump</arg> </group>"
1667msgstr ""
1668
1669#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1670#: apt-config.8.xml:48
2a52e8c5
DK
1671msgid ""
1672"<command>apt-config</command> is an internal program used by various "
1673"portions of the APT suite to provide consistent configurability. It accesses "
1674"the main configuration file <filename>/etc/apt/apt.conf</filename> in a "
1675"manner that is easy to use by scripted applications."
1676msgstr ""
1677
1678#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1679#: apt-config.8.xml:53 apt-ftparchive.1.xml:71
2a52e8c5
DK
1680msgid ""
1681"Unless the <option>-h</option>, or <option>--help</option> option is given "
1682"one of the commands below must be present."
1683msgstr ""
1684
1685#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1686#: apt-config.8.xml:58
2a52e8c5
DK
1687msgid "shell"
1688msgstr ""
1689
1690#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1691#: apt-config.8.xml:60
2a52e8c5
DK
1692msgid ""
1693"shell is used to access the configuration information from a shell "
1694"script. It is given pairs of arguments, the first being a shell variable and "
1695"the second the configuration value to query. As output it lists a series of "
1696"shell assignments commands for each present value. In a shell script it "
1697"should be used like:"
1698msgstr ""
1699
1700#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting>
bcf91c1b 1701#: apt-config.8.xml:68
2a52e8c5
DK
1702#, no-wrap
1703msgid ""
1704"OPTS=\"-f\"\n"
1705"RES=`apt-config shell OPTS MyApp::options`\n"
1706"eval $RES\n"
1707msgstr ""
1708
1709#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1710#: apt-config.8.xml:73
2a52e8c5
DK
1711msgid ""
1712"This will set the shell environment variable $OPTS to the value of "
1713"MyApp::options with a default of <option>-f</option>."
1714msgstr ""
1715
1716#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1717#: apt-config.8.xml:77
2a52e8c5
DK
1718msgid ""
1719"The configuration item may be postfixed with a /[fdbi]. f returns file "
1720"names, d returns directories, b returns true or false and i returns an "
1721"integer. Each of the returns is normalized and verified internally."
1722msgstr ""
1723
1724#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1725#: apt-config.8.xml:86
2a52e8c5
DK
1726msgid "Just show the contents of the configuration space."
1727msgstr ""
1728
1729#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1730#: apt-config.8.xml:104 apt-extracttemplates.1.xml:75 apt-ftparchive.1.xml:564 apt-sortpkgs.1.xml:70
2a52e8c5
DK
1731msgid "&apt-conf;"
1732msgstr ""
1733
1734#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1735#: apt-config.8.xml:109
2a52e8c5
DK
1736msgid ""
1737"<command>apt-config</command> returns zero on normal operation, decimal 100 "
1738"on error."
1739msgstr ""
1740
1741#. type: Content of: <refentry><refnamediv><refname>
bcf91c1b 1742#: apt-extracttemplates.1.xml:22 apt-extracttemplates.1.xml:29
2a52e8c5
DK
1743msgid "apt-extracttemplates"
1744msgstr ""
1745
1746#. type: Content of: <refentry><refmeta><manvolnum>
1747#: apt-extracttemplates.1.xml:23 apt-ftparchive.1.xml:23 apt-sortpkgs.1.xml:23
1748msgid "1"
1749msgstr ""
1750
1751#. type: Content of: <refentry><refnamediv><refpurpose>
bcf91c1b 1752#: apt-extracttemplates.1.xml:30
2a52e8c5
DK
1753msgid "Utility to extract DebConf config and templates from Debian packages"
1754msgstr ""
1755
1756#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
bcf91c1b 1757#: apt-extracttemplates.1.xml:36
2a52e8c5
DK
1758msgid ""
1759"<command>apt-extracttemplates</command> <arg><option>-hv</option></arg> "
1760"<arg><option>-t=<replaceable>temporary "
1761"directory</replaceable></option></arg> <arg choice=\"plain\" "
1762"rep=\"repeat\"><replaceable>file</replaceable></arg>"
1763msgstr ""
1764
1765#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1766#: apt-extracttemplates.1.xml:44
2a52e8c5
DK
1767msgid ""
1768"<command>apt-extracttemplates</command> will take one or more Debian package "
1769"files as input and write out (to a temporary directory) all associated "
1770"config scripts and template files. For each passed in package that contains "
1771"config scripts and templates, one line of output will be generated in the "
1772"format:"
1773msgstr ""
1774
1775#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1776#: apt-extracttemplates.1.xml:49
2a52e8c5
DK
1777msgid "package version template-file config-script"
1778msgstr ""
1779
1780#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1781#: apt-extracttemplates.1.xml:50
2a52e8c5
DK
1782msgid ""
1783"template-file and config-script are written to the temporary directory "
1784"specified by the -t or --tempdir "
1785"(<literal>APT::ExtractTemplates::TempDir</literal>) directory, with "
1786"filenames of the form <filename>package.template.XXXX</filename> and "
1787"<filename>package.config.XXXX</filename>"
1788msgstr ""
1789
1790#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1791#: apt-extracttemplates.1.xml:60 apt-get.8.xml:488
2a52e8c5
DK
1792msgid "<option>-t</option>"
1793msgstr ""
1794
1795#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1796#: apt-extracttemplates.1.xml:60
2a52e8c5
DK
1797msgid "<option>--tempdir</option>"
1798msgstr ""
1799
1800#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1801#: apt-extracttemplates.1.xml:62
2a52e8c5
DK
1802msgid ""
1803"Temporary directory in which to write extracted debconf template files and "
1804"config scripts Configuration Item: "
1805"<literal>APT::ExtractTemplates::TempDir</literal>"
1806msgstr ""
1807
1808#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1809#: apt-extracttemplates.1.xml:79
2a52e8c5
DK
1810msgid ""
1811"<command>apt-extracttemplates</command> returns zero on normal operation, "
1812"decimal 100 on error."
1813msgstr ""
1814
1815#. type: Content of: <refentry><refnamediv><refname>
bcf91c1b 1816#: apt-ftparchive.1.xml:22 apt-ftparchive.1.xml:29
2a52e8c5
DK
1817msgid "apt-ftparchive"
1818msgstr ""
1819
1820#. type: Content of: <refentry><refnamediv><refpurpose>
bcf91c1b 1821#: apt-ftparchive.1.xml:30
2a52e8c5
DK
1822msgid "Utility to generate index files"
1823msgstr ""
1824
1825#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
bcf91c1b 1826#: apt-ftparchive.1.xml:36
2a52e8c5
DK
1827msgid ""
1828"<command>apt-ftparchive</command> <arg><option>-hvdsq</option></arg> "
1829"<arg><option>--md5</option></arg> <arg><option>--delink</option></arg> "
1830"<arg><option>--readonly</option></arg> "
1831"<arg><option>--contents</option></arg> <arg><option>-o=<replaceable>config "
1832"string</replaceable></option></arg> "
1833"<arg><option>-c=<replaceable>file</replaceable></option></arg> <group "
1834"choice=\"req\"> <arg>packages<arg choice=\"plain\" "
1835"rep=\"repeat\"><replaceable>path</replaceable></arg><arg><replaceable>override</replaceable><arg><replaceable>pathprefix</replaceable></arg></arg></arg> "
1836"<arg>sources<arg choice=\"plain\" "
1837"rep=\"repeat\"><replaceable>path</replaceable></arg><arg><replaceable>override</replaceable><arg><replaceable>pathprefix</replaceable></arg></arg></arg> "
1838"<arg>contents <arg "
1839"choice=\"plain\"><replaceable>path</replaceable></arg></arg> <arg>release "
1840"<arg choice=\"plain\"><replaceable>path</replaceable></arg></arg> "
1841"<arg>generate <arg "
1842"choice=\"plain\"><replaceable>config-file</replaceable></arg> <arg "
1843"choice=\"plain\" "
1844"rep=\"repeat\"><replaceable>section</replaceable></arg></arg> <arg>clean "
1845"<arg choice=\"plain\"><replaceable>config-file</replaceable></arg></arg> "
1846"</group>"
1847msgstr ""
1848
1849#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1850#: apt-ftparchive.1.xml:56
2a52e8c5
DK
1851msgid ""
1852"<command>apt-ftparchive</command> is the command line tool that generates "
1853"the index files that APT uses to access a distribution source. The index "
1854"files should be generated on the origin site based on the content of that "
1855"site."
1856msgstr ""
1857
1858#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1859#: apt-ftparchive.1.xml:60
2a52e8c5
DK
1860msgid ""
1861"<command>apt-ftparchive</command> is a superset of the &dpkg-scanpackages; "
1862"program, incorporating its entire functionality via the "
1863"<literal>packages</literal> command. It also contains a contents file "
1864"generator, <literal>contents</literal>, and an elaborate means to 'script' "
1865"the generation process for a complete archive."
1866msgstr ""
1867
1868#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1869#: apt-ftparchive.1.xml:66
2a52e8c5
DK
1870msgid ""
1871"Internally <command>apt-ftparchive</command> can make use of binary "
1872"databases to cache the contents of a .deb file and it does not rely on any "
1873"external programs aside from &gzip;. When doing a full generate it "
1874"automatically performs file-change checks and builds the desired compressed "
1875"output files."
1876msgstr ""
1877
1878#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1879#: apt-ftparchive.1.xml:75
2a52e8c5
DK
1880msgid "packages"
1881msgstr ""
1882
1883#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1884#: apt-ftparchive.1.xml:77
2a52e8c5
DK
1885msgid ""
1886"The packages command generates a package file from a directory tree. It "
1887"takes the given directory and recursively searches it for .deb files, "
1888"emitting a package record to stdout for each. This command is approximately "
1889"equivalent to &dpkg-scanpackages;."
1890msgstr ""
1891
1892#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1893#: apt-ftparchive.1.xml:82 apt-ftparchive.1.xml:106
2a52e8c5
DK
1894msgid "The option <option>--db</option> can be used to specify a binary caching DB."
1895msgstr ""
1896
1897#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1898#: apt-ftparchive.1.xml:85
2a52e8c5
DK
1899msgid "sources"
1900msgstr ""
1901
1902#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1903#: apt-ftparchive.1.xml:87
2a52e8c5
DK
1904msgid ""
1905"The <literal>sources</literal> command generates a source index file from a "
1906"directory tree. It takes the given directory and recursively searches it "
1907"for .dsc files, emitting a source record to stdout for each. This command is "
1908"approximately equivalent to &dpkg-scansources;."
1909msgstr ""
1910
1911#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1912#: apt-ftparchive.1.xml:92
2a52e8c5
DK
1913msgid ""
1914"If an override file is specified then a source override file will be looked "
1915"for with an extension of .src. The --source-override option can be used to "
1916"change the source override file that will be used."
1917msgstr ""
1918
1919#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1920#: apt-ftparchive.1.xml:97
2a52e8c5
DK
1921msgid "contents"
1922msgstr ""
1923
1924#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1925#: apt-ftparchive.1.xml:99
2a52e8c5
DK
1926msgid ""
1927"The <literal>contents</literal> command generates a contents file from a "
1928"directory tree. It takes the given directory and recursively searches it for "
1929".deb files, and reads the file list from each file. It then sorts and writes "
1930"to stdout the list of files matched to packages. Directories are not written "
1931"to the output. If multiple packages own the same file then each package is "
1932"separated by a comma in the output."
1933msgstr ""
1934
1935#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1936#: apt-ftparchive.1.xml:109
2a52e8c5
DK
1937msgid "release"
1938msgstr ""
1939
1940#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1941#: apt-ftparchive.1.xml:111
2a52e8c5
DK
1942msgid ""
1943"The <literal>release</literal> command generates a Release file from a "
1944"directory tree. It recursively searches the given directory for Packages, "
1945"Packages.gz, Packages.bz2, Sources, Sources.gz, Sources.bz2, Release and "
1946"md5sum.txt files. It then writes to stdout a Release file containing an MD5 "
1947"digest and SHA1 digest for each file."
1948msgstr ""
1949
1950#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1951#: apt-ftparchive.1.xml:118
2a52e8c5
DK
1952msgid ""
1953"Values for the additional metadata fields in the Release file are taken from "
1954"the corresponding variables under "
1955"<literal>APT::FTPArchive::Release</literal>, "
1956"e.g. <literal>APT::FTPArchive::Release::Origin</literal>. The supported "
1957"fields are: <literal>Origin</literal>, <literal>Label</literal>, "
1958"<literal>Suite</literal>, <literal>Version</literal>, "
1959"<literal>Codename</literal>, <literal>Date</literal>, "
1960"<literal>Architectures</literal>, <literal>Components</literal>, "
1961"<literal>Description</literal>."
1962msgstr ""
1963
1964#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1965#: apt-ftparchive.1.xml:128
2a52e8c5
DK
1966msgid "generate"
1967msgstr ""
1968
1969#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1970#: apt-ftparchive.1.xml:130
2a52e8c5
DK
1971msgid ""
1972"The <literal>generate</literal> command is designed to be runnable from a "
1973"cron script and builds indexes according to the given config file. The "
1974"config language provides a flexible means of specifying which index files "
1975"are built from which directories, as well as providing a simple means of "
1976"maintaining the required settings."
1977msgstr ""
1978
1979#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 1980#: apt-ftparchive.1.xml:137 apt-get.8.xml:292
2a52e8c5
DK
1981msgid "clean"
1982msgstr ""
1983
1984#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 1985#: apt-ftparchive.1.xml:139
2a52e8c5
DK
1986msgid ""
1987"The <literal>clean</literal> command tidies the databases used by the given "
1988"configuration file by removing any records that are no longer necessary."
1989msgstr ""
1990
1991#. type: Content of: <refentry><refsect1><title>
bcf91c1b 1992#: apt-ftparchive.1.xml:145
2a52e8c5
DK
1993msgid "The Generate Configuration"
1994msgstr ""
1995
1996#. type: Content of: <refentry><refsect1><para>
bcf91c1b 1997#: apt-ftparchive.1.xml:147
2a52e8c5
DK
1998msgid ""
1999"The <literal>generate</literal> command uses a configuration file to "
2000"describe the archives that are going to be generated. It follows the typical "
2001"ISC configuration format as seen in ISC tools like bind 8 and dhcpd. "
2002"&apt-conf; contains a description of the syntax. Note that the generate "
2003"configuration is parsed in sectional manner, but &apt-conf; is parsed in a "
2004"tree manner. This only effects how the scope tag is handled."
2005msgstr ""
2006
2007#. type: Content of: <refentry><refsect1><para>
bcf91c1b 2008#: apt-ftparchive.1.xml:155
2a52e8c5
DK
2009msgid "The generate configuration has 4 separate sections, each described below."
2010msgstr ""
2011
2012#. type: Content of: <refentry><refsect1><refsect2><title>
bcf91c1b 2013#: apt-ftparchive.1.xml:157
2a52e8c5
DK
2014msgid "Dir Section"
2015msgstr ""
2016
2017#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 2018#: apt-ftparchive.1.xml:159
2a52e8c5
DK
2019msgid ""
2020"The <literal>Dir</literal> section defines the standard directories needed "
2021"to locate the files required during the generation process. These "
2022"directories are prepended to certain relative paths defined in later "
2023"sections to produce a complete an absolute path."
2024msgstr ""
2025
2026#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2027#: apt-ftparchive.1.xml:164
2a52e8c5
DK
2028msgid "ArchiveDir"
2029msgstr ""
2030
2031#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2032#: apt-ftparchive.1.xml:166
2a52e8c5
DK
2033msgid ""
2034"Specifies the root of the FTP archive, in a standard Debian configuration "
2035"this is the directory that contains the <filename>ls-LR</filename> and dist "
2036"nodes."
2037msgstr ""
2038
2039#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2040#: apt-ftparchive.1.xml:171
2a52e8c5
DK
2041msgid "OverrideDir"
2042msgstr ""
2043
2044#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2045#: apt-ftparchive.1.xml:173
2a52e8c5
DK
2046msgid "Specifies the location of the override files."
2047msgstr ""
2048
2049#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2050#: apt-ftparchive.1.xml:176
2a52e8c5
DK
2051msgid "CacheDir"
2052msgstr ""
2053
2054#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2055#: apt-ftparchive.1.xml:178
2a52e8c5
DK
2056msgid "Specifies the location of the cache files"
2057msgstr ""
2058
2059#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2060#: apt-ftparchive.1.xml:181
2a52e8c5
DK
2061msgid "FileListDir"
2062msgstr ""
2063
2064#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2065#: apt-ftparchive.1.xml:183
2a52e8c5
DK
2066msgid ""
2067"Specifies the location of the file list files, if the "
2068"<literal>FileList</literal> setting is used below."
2069msgstr ""
2070
2071#. type: Content of: <refentry><refsect1><refsect2><title>
bcf91c1b 2072#: apt-ftparchive.1.xml:189
2a52e8c5
DK
2073msgid "Default Section"
2074msgstr ""
2075
2076#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 2077#: apt-ftparchive.1.xml:191
2a52e8c5
DK
2078msgid ""
2079"The <literal>Default</literal> section specifies default values, and "
2080"settings that control the operation of the generator. Other sections may "
2081"override these defaults with a per-section setting."
2082msgstr ""
2083
2084#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2085#: apt-ftparchive.1.xml:195
2a52e8c5
DK
2086msgid "Packages::Compress"
2087msgstr ""
2088
2089#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2090#: apt-ftparchive.1.xml:197
2a52e8c5
DK
2091msgid ""
2092"Sets the default compression schemes to use for the Package index files. It "
2093"is a string that contains a space separated list of at least one of: '.' (no "
2094"compression), 'gzip' and 'bzip2'. The default for all compression schemes is "
2095"'. gzip'."
2096msgstr ""
2097
2098#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2099#: apt-ftparchive.1.xml:203
2a52e8c5
DK
2100msgid "Packages::Extensions"
2101msgstr ""
2102
2103#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2104#: apt-ftparchive.1.xml:205
2a52e8c5
DK
2105msgid ""
2106"Sets the default list of file extensions that are package files. This "
2107"defaults to '.deb'."
2108msgstr ""
2109
2110#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2111#: apt-ftparchive.1.xml:209
2a52e8c5
DK
2112msgid "Sources::Compress"
2113msgstr ""
2114
2115#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2116#: apt-ftparchive.1.xml:211
2a52e8c5
DK
2117msgid ""
2118"This is similar to <literal>Packages::Compress</literal> except that it "
2119"controls the compression for the Sources files."
2120msgstr ""
2121
2122#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2123#: apt-ftparchive.1.xml:215
2a52e8c5
DK
2124msgid "Sources::Extensions"
2125msgstr ""
2126
2127#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2128#: apt-ftparchive.1.xml:217
2a52e8c5
DK
2129msgid ""
2130"Sets the default list of file extensions that are source files. This "
2131"defaults to '.dsc'."
2132msgstr ""
2133
2134#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2135#: apt-ftparchive.1.xml:221
2a52e8c5
DK
2136msgid "Contents::Compress"
2137msgstr ""
2138
2139#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2140#: apt-ftparchive.1.xml:223
2a52e8c5
DK
2141msgid ""
2142"This is similar to <literal>Packages::Compress</literal> except that it "
2143"controls the compression for the Contents files."
2144msgstr ""
2145
2146#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2147#: apt-ftparchive.1.xml:227
2a52e8c5
DK
2148msgid "DeLinkLimit"
2149msgstr ""
2150
2151#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2152#: apt-ftparchive.1.xml:229
2a52e8c5
DK
2153msgid ""
2154"Specifies the number of kilobytes to delink (and replace with hard links) "
2155"per run. This is used in conjunction with the per-section "
2156"<literal>External-Links</literal> setting."
2157msgstr ""
2158
2159#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2160#: apt-ftparchive.1.xml:234
2a52e8c5
DK
2161msgid "FileMode"
2162msgstr ""
2163
2164#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2165#: apt-ftparchive.1.xml:236
2a52e8c5
DK
2166msgid ""
2167"Specifies the mode of all created index files. It defaults to 0644. All "
2168"index files are set to this mode with no regard to the umask."
2169msgstr ""
2170
2171#. type: Content of: <refentry><refsect1><refsect2><title>
bcf91c1b 2172#: apt-ftparchive.1.xml:243
2a52e8c5
DK
2173msgid "TreeDefault Section"
2174msgstr ""
2175
2176#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 2177#: apt-ftparchive.1.xml:245
2a52e8c5
DK
2178msgid ""
2179"Sets defaults specific to <literal>Tree</literal> sections. All of these "
2180"variables are substitution variables and have the strings $(DIST), "
2181"$(SECTION) and $(ARCH) replaced with their respective values."
2182msgstr ""
2183
2184#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2185#: apt-ftparchive.1.xml:250
2a52e8c5
DK
2186msgid "MaxContentsChange"
2187msgstr ""
2188
2189#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2190#: apt-ftparchive.1.xml:252
2a52e8c5
DK
2191msgid ""
2192"Sets the number of kilobytes of contents files that are generated each "
2193"day. The contents files are round-robined so that over several days they "
2194"will all be rebuilt."
2195msgstr ""
2196
2197#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2198#: apt-ftparchive.1.xml:257
2a52e8c5
DK
2199msgid "ContentsAge"
2200msgstr ""
2201
2202#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2203#: apt-ftparchive.1.xml:259
2a52e8c5
DK
2204msgid ""
2205"Controls the number of days a contents file is allowed to be checked without "
2206"changing. If this limit is passed the mtime of the contents file is "
2207"updated. This case can occur if the package file is changed in such a way "
2208"that does not result in a new contents file [override edit for instance]. A "
2209"hold off is allowed in hopes that new .debs will be installed, requiring a "
2210"new file anyhow. The default is 10, the units are in days."
2211msgstr ""
2212
2213#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2214#: apt-ftparchive.1.xml:268
2a52e8c5
DK
2215msgid "Directory"
2216msgstr ""
2217
2218#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2219#: apt-ftparchive.1.xml:270
2a52e8c5
DK
2220msgid ""
2221"Sets the top of the .deb directory tree. Defaults to "
2222"<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/</filename>"
2223msgstr ""
2224
2225#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2226#: apt-ftparchive.1.xml:274
2a52e8c5
DK
2227msgid "SrcDirectory"
2228msgstr ""
2229
2230#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2231#: apt-ftparchive.1.xml:276
2a52e8c5
DK
2232msgid ""
2233"Sets the top of the source package directory tree. Defaults to "
2234"<filename>$(DIST)/$(SECTION)/source/</filename>"
2235msgstr ""
2236
2237#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2238#: apt-ftparchive.1.xml:280 apt-ftparchive.1.xml:406
2a52e8c5
DK
2239msgid "Packages"
2240msgstr ""
2241
2242#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2243#: apt-ftparchive.1.xml:282
2a52e8c5
DK
2244msgid ""
2245"Sets the output Packages file. Defaults to "
2246"<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/Packages</filename>"
2247msgstr ""
2248
2249#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2250#: apt-ftparchive.1.xml:286 apt-ftparchive.1.xml:411
2a52e8c5
DK
2251msgid "Sources"
2252msgstr ""
2253
2254#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2255#: apt-ftparchive.1.xml:288
2a52e8c5
DK
2256msgid ""
2257"Sets the output Packages file. Defaults to "
2258"<filename>$(DIST)/$(SECTION)/source/Sources</filename>"
2259msgstr ""
2260
2261#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2262#: apt-ftparchive.1.xml:292
2a52e8c5
DK
2263msgid "InternalPrefix"
2264msgstr ""
2265
2266#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2267#: apt-ftparchive.1.xml:294
2a52e8c5
DK
2268msgid ""
2269"Sets the path prefix that causes a symlink to be considered an internal link "
2270"instead of an external link. Defaults to "
2271"<filename>$(DIST)/$(SECTION)/</filename>"
2272msgstr ""
2273
2274#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2275#: apt-ftparchive.1.xml:299 apt-ftparchive.1.xml:417
2a52e8c5
DK
2276msgid "Contents"
2277msgstr ""
2278
2279#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2280#: apt-ftparchive.1.xml:301
2a52e8c5
DK
2281msgid ""
2282"Sets the output Contents file. Defaults to "
2283"<filename>$(DIST)/Contents-$(ARCH)</filename>. If this setting causes "
2284"multiple Packages files to map onto a single Contents file (such as the "
2285"default) then <command>apt-ftparchive</command> will integrate those "
2286"package files together automatically."
2287msgstr ""
2288
2289#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2290#: apt-ftparchive.1.xml:308
2a52e8c5
DK
2291msgid "Contents::Header"
2292msgstr ""
2293
2294#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2295#: apt-ftparchive.1.xml:310
2a52e8c5
DK
2296msgid "Sets header file to prepend to the contents output."
2297msgstr ""
2298
2299#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2300#: apt-ftparchive.1.xml:313 apt-ftparchive.1.xml:442
2a52e8c5
DK
2301msgid "BinCacheDB"
2302msgstr ""
2303
2304#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2305#: apt-ftparchive.1.xml:315
2a52e8c5
DK
2306msgid ""
2307"Sets the binary cache database to use for this section. Multiple sections "
2308"can share the same database."
2309msgstr ""
2310
2311#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2312#: apt-ftparchive.1.xml:319
2a52e8c5
DK
2313msgid "FileList"
2314msgstr ""
2315
2316#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2317#: apt-ftparchive.1.xml:321
2a52e8c5
DK
2318msgid ""
2319"Specifies that instead of walking the directory tree, "
2320"<command>apt-ftparchive</command> should read the list of files from the "
2321"given file. Relative files names are prefixed with the archive directory."
2322msgstr ""
2323
2324#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2325#: apt-ftparchive.1.xml:326
2a52e8c5
DK
2326msgid "SourceFileList"
2327msgstr ""
2328
2329#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2330#: apt-ftparchive.1.xml:328
2a52e8c5
DK
2331msgid ""
2332"Specifies that instead of walking the directory tree, "
2333"<command>apt-ftparchive</command> should read the list of files from the "
2334"given file. Relative files names are prefixed with the archive directory. "
2335"This is used when processing source indexes."
2336msgstr ""
2337
2338#. type: Content of: <refentry><refsect1><refsect2><title>
bcf91c1b 2339#: apt-ftparchive.1.xml:336
2a52e8c5
DK
2340msgid "Tree Section"
2341msgstr ""
2342
2343#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 2344#: apt-ftparchive.1.xml:338
2a52e8c5
DK
2345msgid ""
2346"The <literal>Tree</literal> section defines a standard Debian file tree "
2347"which consists of a base directory, then multiple sections in that base "
2348"directory and finally multiple Architectures in each section. The exact "
2349"pathing used is defined by the <literal>Directory</literal> substitution "
2350"variable."
2351msgstr ""
2352
2353#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 2354#: apt-ftparchive.1.xml:343
2a52e8c5
DK
2355msgid ""
2356"The <literal>Tree</literal> section takes a scope tag which sets the "
2357"<literal>$(DIST)</literal> variable and defines the root of the tree (the "
2358"path is prefixed by <literal>ArchiveDir</literal>). Typically this is a "
2359"setting such as <filename>dists/woody</filename>."
2360msgstr ""
2361
2362#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 2363#: apt-ftparchive.1.xml:348
2a52e8c5
DK
2364msgid ""
2365"All of the settings defined in the <literal>TreeDefault</literal> section "
2366"can be use in a <literal>Tree</literal> section as well as three new "
2367"variables."
2368msgstr ""
2369
2370#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 2371#: apt-ftparchive.1.xml:351
2a52e8c5
DK
2372msgid ""
2373"When processing a <literal>Tree</literal> section "
2374"<command>apt-ftparchive</command> performs an operation similar to:"
2375msgstr ""
2376
2377#. type: Content of: <refentry><refsect1><refsect2><para><informalexample><programlisting>
bcf91c1b 2378#: apt-ftparchive.1.xml:354
2a52e8c5
DK
2379#, no-wrap
2380msgid ""
2381"for i in Sections do \n"
2382" for j in Architectures do\n"
2383" Generate for DIST=scope SECTION=i ARCH=j\n"
2384msgstr ""
2385
2386#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2387#: apt-ftparchive.1.xml:360
2a52e8c5
DK
2388msgid "Sections"
2389msgstr ""
2390
2391#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2392#: apt-ftparchive.1.xml:362
2a52e8c5
DK
2393msgid ""
2394"This is a space separated list of sections which appear under the "
2395"distribution, typically this is something like <literal>main contrib "
2396"non-free</literal>"
2397msgstr ""
2398
2399#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2400#: apt-ftparchive.1.xml:367
2a52e8c5
DK
2401msgid "Architectures"
2402msgstr ""
2403
2404#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2405#: apt-ftparchive.1.xml:369
2a52e8c5
DK
2406msgid ""
2407"This is a space separated list of all the architectures that appear under "
2408"search section. The special architecture 'source' is used to indicate that "
2409"this tree has a source archive."
2410msgstr ""
2411
2412#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2413#: apt-ftparchive.1.xml:374 apt-ftparchive.1.xml:422
2a52e8c5
DK
2414msgid "BinOverride"
2415msgstr ""
2416
2417#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2418#: apt-ftparchive.1.xml:376
2a52e8c5
DK
2419msgid ""
2420"Sets the binary override file. The override file contains section, priority "
2421"and maintainer address information."
2422msgstr ""
2423
2424#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2425#: apt-ftparchive.1.xml:380 apt-ftparchive.1.xml:427
2a52e8c5
DK
2426msgid "SrcOverride"
2427msgstr ""
2428
2429#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2430#: apt-ftparchive.1.xml:382
2a52e8c5
DK
2431msgid ""
2432"Sets the source override file. The override file contains section "
2433"information."
2434msgstr ""
2435
2436#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2437#: apt-ftparchive.1.xml:386 apt-ftparchive.1.xml:432
2a52e8c5
DK
2438msgid "ExtraOverride"
2439msgstr ""
2440
2441#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2442#: apt-ftparchive.1.xml:388 apt-ftparchive.1.xml:434
2a52e8c5
DK
2443msgid "Sets the binary extra override file."
2444msgstr ""
2445
2446#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2447#: apt-ftparchive.1.xml:391 apt-ftparchive.1.xml:437
2a52e8c5
DK
2448msgid "SrcExtraOverride"
2449msgstr ""
2450
2451#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2452#: apt-ftparchive.1.xml:393 apt-ftparchive.1.xml:439
2a52e8c5
DK
2453msgid "Sets the source extra override file."
2454msgstr ""
2455
2456#. type: Content of: <refentry><refsect1><refsect2><title>
bcf91c1b 2457#: apt-ftparchive.1.xml:398
2a52e8c5
DK
2458msgid "BinDirectory Section"
2459msgstr ""
2460
2461#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 2462#: apt-ftparchive.1.xml:400
2a52e8c5
DK
2463msgid ""
2464"The <literal>bindirectory</literal> section defines a binary directory tree "
2465"with no special structure. The scope tag specifies the location of the "
2466"binary directory and the settings are similar to the <literal>Tree</literal> "
2467"section with no substitution variables or "
2468"<literal>Section</literal><literal>Architecture</literal> settings."
2469msgstr ""
2470
2471#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2472#: apt-ftparchive.1.xml:408
2a52e8c5
DK
2473msgid "Sets the Packages file output."
2474msgstr ""
2475
2476#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2477#: apt-ftparchive.1.xml:413
2a52e8c5
DK
2478msgid ""
2479"Sets the Sources file output. At least one of <literal>Packages</literal> or "
2480"<literal>Sources</literal> is required."
2481msgstr ""
2482
2483#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2484#: apt-ftparchive.1.xml:419
2a52e8c5
DK
2485msgid "Sets the Contents file output. (optional)"
2486msgstr ""
2487
2488#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2489#: apt-ftparchive.1.xml:424
2a52e8c5
DK
2490msgid "Sets the binary override file."
2491msgstr ""
2492
2493#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2494#: apt-ftparchive.1.xml:429
2a52e8c5
DK
2495msgid "Sets the source override file."
2496msgstr ""
2497
2498#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2499#: apt-ftparchive.1.xml:444
2a52e8c5
DK
2500msgid "Sets the cache DB."
2501msgstr ""
2502
2503#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2504#: apt-ftparchive.1.xml:447
2a52e8c5
DK
2505msgid "PathPrefix"
2506msgstr ""
2507
2508#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2509#: apt-ftparchive.1.xml:449
2a52e8c5
DK
2510msgid "Appends a path to all the output paths."
2511msgstr ""
2512
2513#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
bcf91c1b 2514#: apt-ftparchive.1.xml:452
2a52e8c5
DK
2515msgid "FileList, SourceFileList"
2516msgstr ""
2517
2518#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
bcf91c1b 2519#: apt-ftparchive.1.xml:454
2a52e8c5
DK
2520msgid "Specifies the file list file."
2521msgstr ""
2522
2523#. type: Content of: <refentry><refsect1><title>
bcf91c1b 2524#: apt-ftparchive.1.xml:461
2a52e8c5
DK
2525msgid "The Binary Override File"
2526msgstr ""
2527
2528#. type: Content of: <refentry><refsect1><para>
bcf91c1b 2529#: apt-ftparchive.1.xml:462
2a52e8c5
DK
2530msgid ""
2531"The binary override file is fully compatible with &dpkg-scanpackages;. It "
2532"contains 4 fields separated by spaces. The first field is the package name, "
2533"the second is the priority to force that package to, the third is the the "
2534"section to force that package to and the final field is the maintainer "
2535"permutation field."
2536msgstr ""
2537
2538#. type: Content of: <refentry><refsect1><para><literallayout>
bcf91c1b 2539#: apt-ftparchive.1.xml:468
2a52e8c5
DK
2540#, no-wrap
2541msgid "old [// oldn]* => new"
2542msgstr ""
2543
2544#. type: Content of: <refentry><refsect1><para><literallayout>
bcf91c1b 2545#: apt-ftparchive.1.xml:470
2a52e8c5
DK
2546#, no-wrap
2547msgid "new"
2548msgstr ""
2549
2550#. type: Content of: <refentry><refsect1><para>
bcf91c1b 2551#: apt-ftparchive.1.xml:467
2a52e8c5
DK
2552msgid ""
2553"The general form of the maintainer field is: <placeholder "
2554"type=\"literallayout\" id=\"0\"/> or simply, <placeholder "
2555"type=\"literallayout\" id=\"1\"/> The first form allows a double-slash "
2556"separated list of old email addresses to be specified. If any of those are "
2557"found then new is substituted for the maintainer field. The second form "
2558"unconditionally substitutes the maintainer field."
2559msgstr ""
2560
2561#. type: Content of: <refentry><refsect1><title>
bcf91c1b 2562#: apt-ftparchive.1.xml:478
2a52e8c5
DK
2563msgid "The Source Override File"
2564msgstr ""
2565
2566#. type: Content of: <refentry><refsect1><para>
bcf91c1b 2567#: apt-ftparchive.1.xml:480
2a52e8c5
DK
2568msgid ""
2569"The source override file is fully compatible with &dpkg-scansources;. It "
2570"contains 2 fields separated by spaces. The first fields is the source "
2571"package name, the second is the section to assign it."
2572msgstr ""
2573
2574#. type: Content of: <refentry><refsect1><title>
bcf91c1b 2575#: apt-ftparchive.1.xml:485
2a52e8c5
DK
2576msgid "The Extra Override File"
2577msgstr ""
2578
2579#. type: Content of: <refentry><refsect1><para>
bcf91c1b 2580#: apt-ftparchive.1.xml:487
2a52e8c5
DK
2581msgid ""
2582"The extra override file allows any arbitrary tag to be added or replaced in "
2583"the output. It has 3 columns, the first is the package, the second is the "
2584"tag and the remainder of the line is the new value."
2585msgstr ""
2586
2587#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 2588#: apt-ftparchive.1.xml:496
2a52e8c5
DK
2589msgid "<option>--md5</option>"
2590msgstr ""
2591
2592#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2593#: apt-ftparchive.1.xml:498
2a52e8c5
DK
2594msgid ""
2595"Generate MD5 sums. This defaults to on, when turned off the generated index "
2596"files will not have MD5Sum fields where possible. Configuration Item: "
2597"<literal>APT::FTPArchive::MD5</literal>"
2598msgstr ""
2599
2600#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 2601#: apt-ftparchive.1.xml:503
2a52e8c5
DK
2602msgid "<option>--db</option>"
2603msgstr ""
2604
2605#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2606#: apt-ftparchive.1.xml:505
2a52e8c5
DK
2607msgid ""
2608"Use a binary caching DB. This has no effect on the generate command. "
2609"Configuration Item: <literal>APT::FTPArchive::DB</literal>."
2610msgstr ""
2611
2612#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2613#: apt-ftparchive.1.xml:511
2a52e8c5
DK
2614msgid ""
2615"Quiet; produces output suitable for logging, omitting progress indicators. "
2616"More q's will produce more quiet up to a maximum of 2. You can also use "
2617"<option>-q=#</option> to set the quiet level, overriding the configuration "
2618"file. Configuration Item: <literal>quiet</literal>."
2619msgstr ""
2620
2621#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 2622#: apt-ftparchive.1.xml:517
2a52e8c5
DK
2623msgid "<option>--delink</option>"
2624msgstr ""
2625
2626#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2627#: apt-ftparchive.1.xml:519
2a52e8c5
DK
2628msgid ""
2629"Perform Delinking. If the <literal>External-Links</literal> setting is used "
2630"then this option actually enables delinking of the files. It defaults to on "
2631"and can be turned off with <option>--no-delink</option>. Configuration "
2632"Item: <literal>APT::FTPArchive::DeLinkAct</literal>."
2633msgstr ""
2634
2635#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 2636#: apt-ftparchive.1.xml:525
2a52e8c5
DK
2637msgid "<option>--contents</option>"
2638msgstr ""
2639
2640#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2641#: apt-ftparchive.1.xml:527
2a52e8c5
DK
2642msgid ""
2643"Perform contents generation. When this option is set and package indexes are "
2644"being generated with a cache DB then the file listing will also be extracted "
2645"and stored in the DB for later use. When using the generate command this "
2646"option also allows the creation of any Contents files. The default is on. "
2647"Configuration Item: <literal>APT::FTPArchive::Contents</literal>."
2648msgstr ""
2649
2650#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 2651#: apt-ftparchive.1.xml:535
2a52e8c5
DK
2652msgid "<option>--source-override</option>"
2653msgstr ""
2654
2655#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2656#: apt-ftparchive.1.xml:537
2a52e8c5
DK
2657msgid ""
2658"Select the source override file to use with the <literal>sources</literal> "
2659"command. Configuration Item: "
2660"<literal>APT::FTPArchive::SourceOverride</literal>."
2661msgstr ""
2662
2663#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 2664#: apt-ftparchive.1.xml:541
2a52e8c5
DK
2665msgid "<option>--readonly</option>"
2666msgstr ""
2667
2668#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2669#: apt-ftparchive.1.xml:543
2a52e8c5
DK
2670msgid ""
2671"Make the caching databases read only. Configuration Item: "
2672"<literal>APT::FTPArchive::ReadOnlyDB</literal>."
2673msgstr ""
2674
2675#. type: Content of: <refentry><refsect1><title>
d5081aee 2676#: apt-ftparchive.1.xml:552 apt.conf.5.xml:934 apt_preferences.5.xml:462 sources.list.5.xml:181
2a52e8c5
DK
2677msgid "Examples"
2678msgstr ""
2679
2680#. type: Content of: <refentry><refsect1><para><programlisting>
bcf91c1b 2681#: apt-ftparchive.1.xml:558
2a52e8c5
DK
2682#, no-wrap
2683msgid ""
2684"<command>apt-ftparchive</command> packages "
2685"<replaceable>directory</replaceable> | <command>gzip</command> > "
2686"<filename>Packages.gz</filename>\n"
2687msgstr ""
2688
2689#. type: Content of: <refentry><refsect1><para>
bcf91c1b 2690#: apt-ftparchive.1.xml:554
2a52e8c5
DK
2691msgid ""
2692"To create a compressed Packages file for a directory containing binary "
2693"packages (.deb): <placeholder type=\"programlisting\" id=\"0\"/>"
2694msgstr ""
2695
2696#. type: Content of: <refentry><refsect1><para>
bcf91c1b 2697#: apt-ftparchive.1.xml:568
2a52e8c5
DK
2698msgid ""
2699"<command>apt-ftparchive</command> returns zero on normal operation, decimal "
2700"100 on error."
2701msgstr ""
2702
2703#. The last update date
2704#. type: Content of: <refentry><refentryinfo>
2705#: apt-get.8.xml:13
2706msgid ""
2707"&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>08 "
2708"November 2008</date>"
2709msgstr ""
2710
2711#. type: Content of: <refentry><refnamediv><refname>
bcf91c1b 2712#: apt-get.8.xml:22 apt-get.8.xml:29
2a52e8c5
DK
2713msgid "apt-get"
2714msgstr ""
2715
2716#. type: Content of: <refentry><refnamediv><refpurpose>
bcf91c1b 2717#: apt-get.8.xml:30
2a52e8c5
DK
2718msgid "APT package handling utility -- command-line interface"
2719msgstr ""
2720
2721#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
bcf91c1b 2722#: apt-get.8.xml:36
2a52e8c5
DK
2723msgid ""
2724"<command>apt-get</command> <arg><option>-sqdyfmubV</option></arg> <arg> "
2725"<option>-o= <replaceable>config_string</replaceable> </option> </arg> <arg> "
2726"<option>-c= <replaceable>config_file</replaceable> </option> </arg> <arg> "
2727"<option>-t=</option> <group choice='req'> <arg choice='plain'> "
2728"<replaceable>target_release_name</replaceable> </arg> <arg choice='plain'> "
2729"<replaceable>target_release_number_expression</replaceable> </arg> <arg "
2730"choice='plain'> <replaceable>target_release_codename</replaceable> </arg> "
2731"</group> </arg> <group choice=\"req\"> <arg choice='plain'>update</arg> <arg "
2732"choice='plain'>upgrade</arg> <arg choice='plain'>dselect-upgrade</arg> <arg "
2733"choice='plain'>dist-upgrade</arg> <arg choice='plain'>install <arg "
2734"choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable> <arg> <group "
2735"choice='req'> <arg choice='plain'> "
2736"=<replaceable>pkg_version_number</replaceable> </arg> <arg choice='plain'> "
2737"/<replaceable>target_release_name</replaceable> </arg> <arg choice='plain'> "
2738"/<replaceable>target_release_codename</replaceable> </arg> </group> </arg> "
2739"</arg> </arg> <arg choice='plain'>remove <arg choice=\"plain\" "
2740"rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg "
2741"choice='plain'>purge <arg choice=\"plain\" "
2742"rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg "
2743"choice='plain'>source <arg choice=\"plain\" "
bcf91c1b
DK
2744"rep=\"repeat\"><replaceable>pkg</replaceable> <arg> <group choice='req'> "
2745"<arg choice='plain'> =<replaceable>pkg_version_number</replaceable> </arg> "
2746"<arg choice='plain'> /<replaceable>target_release_name</replaceable> </arg> "
2747"<arg choice='plain'> /<replaceable>target_release_codename</replaceable> "
2748"</arg> </group> </arg> </arg> </arg> <arg choice='plain'>build-dep <arg "
2749"choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
2750"<arg choice='plain'>check</arg> <arg choice='plain'>clean</arg> <arg "
2a52e8c5
DK
2751"choice='plain'>autoclean</arg> <arg choice='plain'>autoremove</arg> <arg "
2752"choice='plain'> <group choice='req'> <arg choice='plain'>-v</arg> <arg "
2753"choice='plain'>--version</arg> </group> </arg> <arg choice='plain'> <group "
2754"choice='req'> <arg choice='plain'>-h</arg> <arg choice='plain'>--help</arg> "
2755"</group> </arg> </group>"
2756msgstr ""
2757
2758#. type: Content of: <refentry><refsect1><para>
bcf91c1b 2759#: apt-get.8.xml:126
2a52e8c5
DK
2760msgid ""
2761"<command>apt-get</command> is the command-line tool for handling packages, "
2762"and may be considered the user's \"back-end\" to other tools using the APT "
2763"library. Several \"front-end\" interfaces exist, such as &dselect;, "
2764"&aptitude;, &synaptic;, &gnome-apt; and &wajig;."
2765msgstr ""
2766
2767#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 2768#: apt-get.8.xml:135 apt-key.8.xml:123
2a52e8c5
DK
2769msgid "update"
2770msgstr ""
2771
2772#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2773#: apt-get.8.xml:136
2a52e8c5
DK
2774msgid ""
2775"<literal>update</literal> is used to resynchronize the package index files "
2776"from their sources. The indexes of available packages are fetched from the "
2777"location(s) specified in <filename>/etc/apt/sources.list</filename>. For "
2778"example, when using a Debian archive, this command retrieves and scans the "
2779"<filename>Packages.gz</filename> files, so that information about new and "
2780"updated packages is available. An <literal>update</literal> should always be "
2781"performed before an <literal>upgrade</literal> or "
2782"<literal>dist-upgrade</literal>. Please be aware that the overall progress "
2783"meter will be incorrect as the size of the package files cannot be known in "
2784"advance."
2785msgstr ""
2786
2787#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 2788#: apt-get.8.xml:147
2a52e8c5
DK
2789msgid "upgrade"
2790msgstr ""
2791
2792#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2793#: apt-get.8.xml:148
2a52e8c5
DK
2794msgid ""
2795"<literal>upgrade</literal> is used to install the newest versions of all "
2796"packages currently installed on the system from the sources enumerated in "
2797"<filename>/etc/apt/sources.list</filename>. Packages currently installed "
2798"with new versions available are retrieved and upgraded; under no "
2799"circumstances are currently installed packages removed, or packages not "
2800"already installed retrieved and installed. New versions of currently "
2801"installed packages that cannot be upgraded without changing the install "
2802"status of another package will be left at their current version. An "
2803"<literal>update</literal> must be performed first so that "
2804"<command>apt-get</command> knows that new versions of packages are "
2805"available."
2806msgstr ""
2807
2808#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 2809#: apt-get.8.xml:160
2a52e8c5
DK
2810msgid "dselect-upgrade"
2811msgstr ""
2812
2813#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2814#: apt-get.8.xml:161
2a52e8c5
DK
2815msgid ""
2816"<literal>dselect-upgrade</literal> is used in conjunction with the "
2817"traditional Debian packaging front-end, "
2818"&dselect;. <literal>dselect-upgrade</literal> follows the changes made by "
2819"&dselect; to the <literal>Status</literal> field of available packages, and "
2820"performs the actions necessary to realize that state (for instance, the "
2821"removal of old and the installation of new packages)."
2822msgstr ""
2823
2824#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 2825#: apt-get.8.xml:170
2a52e8c5
DK
2826msgid "dist-upgrade"
2827msgstr ""
2828
2829#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2830#: apt-get.8.xml:171
2a52e8c5
DK
2831msgid ""
2832"<literal>dist-upgrade</literal> in addition to performing the function of "
2833"<literal>upgrade</literal>, also intelligently handles changing dependencies "
2834"with new versions of packages; <command>apt-get</command> has a \"smart\" "
2835"conflict resolution system, and it will attempt to upgrade the most "
2836"important packages at the expense of less important ones if necessary. So, "
2837"<literal>dist-upgrade</literal> command may remove some packages. The "
2838"<filename>/etc/apt/sources.list</filename> file contains a list of locations "
2839"from which to retrieve desired package files. See also &apt-preferences; "
2840"for a mechanism for overriding the general settings for individual packages."
2841msgstr ""
2842
2843#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 2844#: apt-get.8.xml:183
2a52e8c5
DK
2845msgid "install"
2846msgstr ""
2847
2848#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2849#: apt-get.8.xml:185
2a52e8c5
DK
2850msgid ""
2851"<literal>install</literal> is followed by one or more packages desired for "
2852"installation or upgrading. Each package is a package name, not a fully "
2853"qualified filename (for instance, in a Debian GNU/Linux system, libc6 would "
2854"be the argument provided, not <literal>libc6_1.9.6-2.deb</literal>). All "
2855"packages required by the package(s) specified for installation will also be "
2856"retrieved and installed. The <filename>/etc/apt/sources.list</filename> "
2857"file is used to locate the desired packages. If a hyphen is appended to the "
2858"package name (with no intervening space), the identified package will be "
2859"removed if it is installed. Similarly a plus sign can be used to designate "
2860"a package to install. These latter features may be used to override "
2861"decisions made by apt-get's conflict resolution system."
2862msgstr ""
2863
2864#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2865#: apt-get.8.xml:203
2a52e8c5
DK
2866msgid ""
2867"A specific version of a package can be selected for installation by "
2868"following the package name with an equals and the version of the package to "
2869"select. This will cause that version to be located and selected for "
2870"install. Alternatively a specific distribution can be selected by following "
2871"the package name with a slash and the version of the distribution or the "
2872"Archive name (stable, testing, unstable)."
2873msgstr ""
2874
2875#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2876#: apt-get.8.xml:210
2a52e8c5
DK
2877msgid ""
2878"Both of the version selection mechanisms can downgrade packages and must be "
2879"used with care."
2880msgstr ""
2881
2882#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2883#: apt-get.8.xml:213
2a52e8c5
DK
2884msgid ""
2885"This is also the target to use if you want to upgrade one or more "
2886"already-installed packages without upgrading every package you have on your "
2887"system. Unlike the \"upgrade\" target, which installs the newest version of "
2888"all currently installed packages, \"install\" will install the newest "
2889"version of only the package(s) specified. Simply provide the name of the "
2890"package(s) you wish to upgrade, and if a newer version is available, it (and "
2891"its dependencies, as described above) will be downloaded and installed."
2892msgstr ""
2893
2894#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2895#: apt-get.8.xml:224
2a52e8c5
DK
2896msgid ""
2897"Finally, the &apt-preferences; mechanism allows you to create an alternative "
2898"installation policy for individual packages."
2899msgstr ""
2900
2901#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2902#: apt-get.8.xml:228
2a52e8c5
DK
2903msgid ""
2904"If no package matches the given expression and the expression contains one "
2905"of '.', '?' or '*' then it is assumed to be a POSIX regular expression, and "
2906"it is applied to all package names in the database. Any matches are then "
2907"installed (or removed). Note that matching is done by substring so 'lo.*' "
2908"matches 'how-lo' and 'lowest'. If this is undesired, anchor the regular "
2909"expression with a '^' or '$' character, or create a more specific regular "
2910"expression."
2911msgstr ""
2912
2913#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 2914#: apt-get.8.xml:237
2a52e8c5
DK
2915msgid "remove"
2916msgstr ""
2917
2918#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2919#: apt-get.8.xml:238
2a52e8c5
DK
2920msgid ""
2921"<literal>remove</literal> is identical to <literal>install</literal> except "
2922"that packages are removed instead of installed. Note the removing a package "
2923"leaves its configuration files in system. If a plus sign is appended to the "
2924"package name (with no intervening space), the identified package will be "
2925"installed instead of removed."
2926msgstr ""
2927
2928#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 2929#: apt-get.8.xml:245
2a52e8c5
DK
2930msgid "purge"
2931msgstr ""
2932
2933#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2934#: apt-get.8.xml:246
2a52e8c5
DK
2935msgid ""
2936"<literal>purge</literal> is identical to <literal>remove</literal> except "
2937"that packages are removed and purged (any configuration files are deleted "
2938"too)."
2939msgstr ""
2940
2941#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 2942#: apt-get.8.xml:250
2a52e8c5
DK
2943msgid "source"
2944msgstr ""
2945
2946#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2947#: apt-get.8.xml:251
2a52e8c5
DK
2948msgid ""
2949"<literal>source</literal> causes <command>apt-get</command> to fetch source "
2950"packages. APT will examine the available packages to decide which source "
2951"package to fetch. It will then find and download into the current directory "
bcf91c1b
DK
2952"the newest available version of that source package while respect the "
2953"default release, set with the option "
2954"<literal>APT::Default-Release</literal>, the <option>-t</option> option or "
2955"per package with with the <literal>pkg/release</literal> syntax, if "
2956"possible."
2a52e8c5
DK
2957msgstr ""
2958
2959#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b
DK
2960#: apt-get.8.xml:259
2961msgid ""
2962"Source packages are tracked separately from binary packages via "
2963"<literal>deb-src</literal> type lines in the &sources-list; file. This means "
2964"that you will need to add such a line for each repository you want to get "
2965"sources from. If you don't do this you will properly get another (newer, "
2966"older or none) source version than the one you have installed or could "
2967"install."
2968msgstr ""
2969
2970#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2971#: apt-get.8.xml:266
2972msgid ""
2973"If the <option>--compile</option> options is specified then the package will "
2974"be compiled to a binary .deb using <command>dpkg-buildpackage</command>, if "
2975"<option>--download-only</option> is specified then the source package will "
2976"not be unpacked."
2977msgstr ""
2978
2979#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2980#: apt-get.8.xml:271
2a52e8c5
DK
2981msgid ""
2982"A specific source version can be retrieved by postfixing the source name "
2983"with an equals and then the version to fetch, similar to the mechanism used "
2984"for the package files. This enables exact matching of the source package "
2985"name and version, implicitly enabling the "
2986"<literal>APT::Get::Only-Source</literal> option."
2987msgstr ""
2988
2989#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 2990#: apt-get.8.xml:277
2a52e8c5
DK
2991msgid ""
2992"Note that source packages are not tracked like binary packages, they exist "
2993"only in the current directory and are similar to downloading source tar "
2994"balls."
2995msgstr ""
2996
2997#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 2998#: apt-get.8.xml:282
2a52e8c5
DK
2999msgid "build-dep"
3000msgstr ""
3001
3002#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3003#: apt-get.8.xml:283
2a52e8c5
DK
3004msgid ""
3005"<literal>build-dep</literal> causes apt-get to install/remove packages in an "
3006"attempt to satisfy the build dependencies for a source package."
3007msgstr ""
3008
3009#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3010#: apt-get.8.xml:287
2a52e8c5
DK
3011msgid "check"
3012msgstr ""
3013
3014#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3015#: apt-get.8.xml:288
2a52e8c5
DK
3016msgid ""
3017"<literal>check</literal> is a diagnostic tool; it updates the package cache "
3018"and checks for broken dependencies."
3019msgstr ""
3020
3021#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3022#: apt-get.8.xml:293
2a52e8c5
DK
3023msgid ""
3024"<literal>clean</literal> clears out the local repository of retrieved "
3025"package files. It removes everything but the lock file from "
3026"<filename>&cachedir;/archives/</filename> and "
3027"<filename>&cachedir;/archives/partial/</filename>. When APT is used as a "
3028"&dselect; method, <literal>clean</literal> is run automatically. Those who "
3029"do not use dselect will likely want to run <literal>apt-get clean</literal> "
3030"from time to time to free up disk space."
3031msgstr ""
3032
3033#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3034#: apt-get.8.xml:302
2a52e8c5
DK
3035msgid "autoclean"
3036msgstr ""
3037
3038#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3039#: apt-get.8.xml:303
2a52e8c5
DK
3040msgid ""
3041"Like <literal>clean</literal>, <literal>autoclean</literal> clears out the "
3042"local repository of retrieved package files. The difference is that it only "
3043"removes package files that can no longer be downloaded, and are largely "
3044"useless. This allows a cache to be maintained over a long period without it "
3045"growing out of control. The configuration option "
3046"<literal>APT::Clean-Installed</literal> will prevent installed packages from "
3047"being erased if it is set to off."
3048msgstr ""
3049
3050#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3051#: apt-get.8.xml:312
2a52e8c5
DK
3052msgid "autoremove"
3053msgstr ""
3054
3055#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3056#: apt-get.8.xml:313
2a52e8c5
DK
3057msgid ""
3058"<literal>autoremove</literal> is used to remove packages that were "
3059"automatically installed to satisfy dependencies for some package and that "
3060"are no more needed."
3061msgstr ""
3062
3063#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3064#: apt-get.8.xml:323 apt-get.8.xml:429
2a52e8c5
DK
3065msgid "<option>--no-install-recommends</option>"
3066msgstr ""
3067
3068#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3069#: apt-get.8.xml:324
2a52e8c5
DK
3070msgid ""
3071"Do not consider recommended packages as a dependency for installing. "
3072"Configuration Item: <literal>APT::Install-Recommends</literal>."
3073msgstr ""
3074
3075#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3076#: apt-get.8.xml:328
2a52e8c5
DK
3077msgid "<option>--download-only</option>"
3078msgstr ""
3079
3080#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3081#: apt-get.8.xml:329
2a52e8c5
DK
3082msgid ""
3083"Download only; package files are only retrieved, not unpacked or installed. "
3084"Configuration Item: <literal>APT::Get::Download-Only</literal>."
3085msgstr ""
3086
3087#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3088#: apt-get.8.xml:333
2a52e8c5
DK
3089msgid "<option>--fix-broken</option>"
3090msgstr ""
3091
3092#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3093#: apt-get.8.xml:334
2a52e8c5
DK
3094msgid ""
3095"Fix; attempt to correct a system with broken dependencies in place. This "
3096"option, when used with install/remove, can omit any packages to permit APT "
3097"to deduce a likely solution. Any Package that are specified must completely "
3098"correct the problem. The option is sometimes necessary when running APT for "
3099"the first time; APT itself does not allow broken package dependencies to "
3100"exist on a system. It is possible that a system's dependency structure can "
3101"be so corrupt as to require manual intervention (which usually means using "
3102"&dselect; or <command>dpkg --remove</command> to eliminate some of the "
3103"offending packages). Use of this option together with <option>-m</option> "
3104"may produce an error in some situations. Configuration Item: "
3105"<literal>APT::Get::Fix-Broken</literal>."
3106msgstr ""
3107
3108#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3109#: apt-get.8.xml:347
2a52e8c5
DK
3110msgid "<option>--ignore-missing</option>"
3111msgstr ""
3112
3113#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3114#: apt-get.8.xml:348
2a52e8c5
DK
3115msgid "<option>--fix-missing</option>"
3116msgstr ""
3117
3118#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3119#: apt-get.8.xml:349
2a52e8c5
DK
3120msgid ""
3121"Ignore missing packages; If packages cannot be retrieved or fail the "
3122"integrity check after retrieval (corrupted package files), hold back those "
3123"packages and handle the result. Use of this option together with "
3124"<option>-f</option> may produce an error in some situations. If a package is "
3125"selected for installation (particularly if it is mentioned on the command "
3126"line) and it could not be downloaded then it will be silently held back. "
3127"Configuration Item: <literal>APT::Get::Fix-Missing</literal>."
3128msgstr ""
3129
3130#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3131#: apt-get.8.xml:359
2a52e8c5
DK
3132msgid "<option>--no-download</option>"
3133msgstr ""
3134
3135#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3136#: apt-get.8.xml:360
2a52e8c5
DK
3137msgid ""
3138"Disables downloading of packages. This is best used with "
3139"<option>--ignore-missing</option> to force APT to use only the .debs it has "
3140"already downloaded. Configuration Item: "
3141"<literal>APT::Get::Download</literal>."
3142msgstr ""
3143
3144#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3145#: apt-get.8.xml:367
2a52e8c5
DK
3146msgid ""
3147"Quiet; produces output suitable for logging, omitting progress indicators. "
3148"More q's will produce more quiet up to a maximum of 2. You can also use "
3149"<option>-q=#</option> to set the quiet level, overriding the configuration "
3150"file. Note that quiet level 2 implies <option>-y</option>, you should never "
3151"use -qq without a no-action modifier such as -d, --print-uris or -s as APT "
3152"may decided to do something you did not expect. Configuration Item: "
3153"<literal>quiet</literal>."
3154msgstr ""
3155
3156#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3157#: apt-get.8.xml:377
2a52e8c5
DK
3158msgid "<option>--simulate</option>"
3159msgstr ""
3160
3161#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3162#: apt-get.8.xml:379
2a52e8c5
DK
3163msgid "<option>--dry-run</option>"
3164msgstr ""
3165
3166#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3167#: apt-get.8.xml:382
2a52e8c5
DK
3168msgid ""
3169"No action; perform a simulation of events that would occur but do not "
3170"actually change the system. Configuration Item: "
3171"<literal>APT::Get::Simulate</literal>."
3172msgstr ""
3173
3174#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3175#: apt-get.8.xml:386
2a52e8c5
DK
3176msgid ""
3177"Simulation run as user will deactivate locking "
bcf91c1b 3178"(<literal>Debug::NoLocking</literal>) automatic. Also a notice will be "
2a52e8c5
DK
3179"displayed indicating that this is only a simulation, if the option "
3180"<literal>APT::Get::Show-User-Simulation-Note</literal> is set (Default: "
bcf91c1b 3181"true). Neither NoLocking nor the notice will be triggered if run as root "
2a52e8c5
DK
3182"(root should know what he is doing without further warnings by "
3183"<literal>apt-get</literal>)."
3184msgstr ""
3185
3186#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3187#: apt-get.8.xml:392
2a52e8c5
DK
3188msgid ""
3189"Simulate prints out a series of lines each one representing a dpkg "
3190"operation, Configure (Conf), Remove (Remv), Unpack (Inst). Square brackets "
3191"indicate broken packages with and empty set of square brackets meaning "
3192"breaks that are of no consequence (rare)."
3193msgstr ""
3194
3195#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3196#: apt-get.8.xml:399
2a52e8c5
DK
3197msgid "<option>-y</option>"
3198msgstr ""
3199
3200#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3201#: apt-get.8.xml:399
2a52e8c5
DK
3202msgid "<option>--yes</option>"
3203msgstr ""
3204
3205#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3206#: apt-get.8.xml:400
2a52e8c5
DK
3207msgid "<option>--assume-yes</option>"
3208msgstr ""
3209
3210#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3211#: apt-get.8.xml:401
2a52e8c5
DK
3212msgid ""
3213"Automatic yes to prompts; assume \"yes\" as answer to all prompts and run "
3214"non-interactively. If an undesirable situation, such as changing a held "
3215"package, trying to install a unauthenticated package or removing an "
3216"essential package occurs then <literal>apt-get</literal> will abort. "
3217"Configuration Item: <literal>APT::Get::Assume-Yes</literal>."
3218msgstr ""
3219
3220#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3221#: apt-get.8.xml:408
2a52e8c5
DK
3222msgid "<option>-u</option>"
3223msgstr ""
3224
3225#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3226#: apt-get.8.xml:408
2a52e8c5
DK
3227msgid "<option>--show-upgraded</option>"
3228msgstr ""
3229
3230#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3231#: apt-get.8.xml:409
2a52e8c5
DK
3232msgid ""
3233"Show upgraded packages; Print out a list of all packages that are to be "
3234"upgraded. Configuration Item: <literal>APT::Get::Show-Upgraded</literal>."
3235msgstr ""
3236
3237#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3238#: apt-get.8.xml:414
2a52e8c5
DK
3239msgid "<option>-V</option>"
3240msgstr ""
3241
3242#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3243#: apt-get.8.xml:414
2a52e8c5
DK
3244msgid "<option>--verbose-versions</option>"
3245msgstr ""
3246
3247#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3248#: apt-get.8.xml:415
2a52e8c5
DK
3249msgid ""
3250"Show full versions for upgraded and installed packages. Configuration Item: "
3251"<literal>APT::Get::Show-Versions</literal>."
3252msgstr ""
3253
3254#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3255#: apt-get.8.xml:419
2a52e8c5
DK
3256msgid "<option>-b</option>"
3257msgstr ""
3258
3259#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3260#: apt-get.8.xml:419
2a52e8c5
DK
3261msgid "<option>--compile</option>"
3262msgstr ""
3263
3264#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3265#: apt-get.8.xml:420
2a52e8c5
DK
3266msgid "<option>--build</option>"
3267msgstr ""
3268
3269#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3270#: apt-get.8.xml:421
2a52e8c5
DK
3271msgid ""
3272"Compile source packages after downloading them. Configuration Item: "
3273"<literal>APT::Get::Compile</literal>."
3274msgstr ""
3275
3276#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3277#: apt-get.8.xml:425
2a52e8c5
DK
3278msgid "<option>--install-recommends</option>"
3279msgstr ""
3280
3281#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3282#: apt-get.8.xml:426
2a52e8c5
DK
3283msgid "Also install recommended packages."
3284msgstr ""
3285
3286#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3287#: apt-get.8.xml:430
2a52e8c5
DK
3288msgid "Do not install recommended packages."
3289msgstr ""
3290
3291#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3292#: apt-get.8.xml:433
2a52e8c5
DK
3293msgid "<option>--ignore-hold</option>"
3294msgstr ""
3295
3296#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3297#: apt-get.8.xml:434
2a52e8c5
DK
3298msgid ""
3299"Ignore package Holds; This causes <command>apt-get</command> to ignore a "
3300"hold placed on a package. This may be useful in conjunction with "
3301"<literal>dist-upgrade</literal> to override a large number of undesired "
3302"holds. Configuration Item: <literal>APT::Ignore-Hold</literal>."
3303msgstr ""
3304
3305#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3306#: apt-get.8.xml:440
2a52e8c5
DK
3307msgid "<option>--no-upgrade</option>"
3308msgstr ""
3309
3310#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3311#: apt-get.8.xml:441
2a52e8c5
DK
3312msgid ""
3313"Do not upgrade packages; When used in conjunction with "
3314"<literal>install</literal>, <literal>no-upgrade</literal> will prevent "
3315"packages on the command line from being upgraded if they are already "
3316"installed. Configuration Item: <literal>APT::Get::Upgrade</literal>."
3317msgstr ""
3318
3319#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3320#: apt-get.8.xml:447
2a52e8c5
DK
3321msgid "<option>--force-yes</option>"
3322msgstr ""
3323
3324#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3325#: apt-get.8.xml:448
2a52e8c5
DK
3326msgid ""
3327"Force yes; This is a dangerous option that will cause apt to continue "
3328"without prompting if it is doing something potentially harmful. It should "
3329"not be used except in very special situations. Using "
3330"<literal>force-yes</literal> can potentially destroy your system! "
3331"Configuration Item: <literal>APT::Get::force-yes</literal>."
3332msgstr ""
3333
3334#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3335#: apt-get.8.xml:455
2a52e8c5
DK
3336msgid "<option>--print-uris</option>"
3337msgstr ""
3338
3339#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3340#: apt-get.8.xml:456
2a52e8c5
DK
3341msgid ""
3342"Instead of fetching the files to install their URIs are printed. Each URI "
3343"will have the path, the destination file name, the size and the expected md5 "
3344"hash. Note that the file name to write to will not always match the file "
3345"name on the remote site! This also works with the <literal>source</literal> "
3346"and <literal>update</literal> commands. When used with the "
3347"<literal>update</literal> command the MD5 and size are not included, and it "
3348"is up to the user to decompress any compressed files. Configuration Item: "
3349"<literal>APT::Get::Print-URIs</literal>."
3350msgstr ""
3351
3352#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3353#: apt-get.8.xml:466
2a52e8c5
DK
3354msgid "<option>--purge</option>"
3355msgstr ""
3356
3357#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3358#: apt-get.8.xml:467
2a52e8c5
DK
3359msgid ""
3360"Use purge instead of remove for anything that would be removed. An asterisk "
3361"(\"*\") will be displayed next to packages which are scheduled to be "
3362"purged. <option>remove --purge</option> is equivalent for "
3363"<option>purge</option> command. Configuration Item: "
3364"<literal>APT::Get::Purge</literal>."
3365msgstr ""
3366
3367#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3368#: apt-get.8.xml:474
2a52e8c5
DK
3369msgid "<option>--reinstall</option>"
3370msgstr ""
3371
3372#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3373#: apt-get.8.xml:475
2a52e8c5
DK
3374msgid ""
3375"Re-Install packages that are already installed and at the newest version. "
3376"Configuration Item: <literal>APT::Get::ReInstall</literal>."
3377msgstr ""
3378
3379#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3380#: apt-get.8.xml:479
2a52e8c5
DK
3381msgid "<option>--list-cleanup</option>"
3382msgstr ""
3383
3384#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3385#: apt-get.8.xml:480
2a52e8c5
DK
3386msgid ""
3387"This option defaults to on, use <literal>--no-list-cleanup</literal> to turn "
3388"it off. When on <command>apt-get</command> will automatically manage the "
3389"contents of <filename>&statedir;/lists</filename> to ensure that obsolete "
3390"files are erased. The only reason to turn it off is if you frequently "
3391"change your source list. Configuration Item: "
3392"<literal>APT::Get::List-Cleanup</literal>."
3393msgstr ""
3394
3395#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3396#: apt-get.8.xml:489
2a52e8c5
DK
3397msgid "<option>--target-release</option>"
3398msgstr ""
3399
3400#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3401#: apt-get.8.xml:490
2a52e8c5
DK
3402msgid "<option>--default-release</option>"
3403msgstr ""
3404
3405#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3406#: apt-get.8.xml:491
2a52e8c5
DK
3407msgid ""
3408"This option controls the default input to the policy engine, it creates a "
3409"default pin at priority 990 using the specified release string. This "
3410"overrides the general settings in "
3411"<filename>/etc/apt/preferences</filename>. Specifically pinned packages are "
3412"not affected by the value of this option. In short, this option lets you "
3413"have simple control over which distribution packages will be retrieved "
3414"from. Some common examples might be <option>-t '2.1*'</option>, <option>-t "
3415"unstable</option> or <option>-t sid</option>. Configuration Item: "
3416"<literal>APT::Default-Release</literal>; see also the &apt-preferences; "
3417"manual page."
3418msgstr ""
3419
3420#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3421#: apt-get.8.xml:504
2a52e8c5
DK
3422msgid "<option>--trivial-only</option>"
3423msgstr ""
3424
3425#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3426#: apt-get.8.xml:506
2a52e8c5
DK
3427msgid ""
3428"Only perform operations that are 'trivial'. Logically this can be considered "
3429"related to <option>--assume-yes</option>, where "
3430"<option>--assume-yes</option> will answer yes to any prompt, "
3431"<option>--trivial-only</option> will answer no. Configuration Item: "
3432"<literal>APT::Get::Trivial-Only</literal>."
3433msgstr ""
3434
3435#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3436#: apt-get.8.xml:512
2a52e8c5
DK
3437msgid "<option>--no-remove</option>"
3438msgstr ""
3439
3440#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3441#: apt-get.8.xml:513
2a52e8c5
DK
3442msgid ""
3443"If any packages are to be removed apt-get immediately aborts without "
3444"prompting. Configuration Item: <literal>APT::Get::Remove</literal>."
3445msgstr ""
3446
3447#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3448#: apt-get.8.xml:518
2a52e8c5
DK
3449msgid "<option>--auto-remove</option>"
3450msgstr ""
3451
3452#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3453#: apt-get.8.xml:519
2a52e8c5
DK
3454msgid ""
3455"If the command is either <literal>install</literal> or "
3456"<literal>remove</literal>, then this option acts like running "
3457"<literal>autoremove</literal> command, removing the unused dependency "
3458"packages. Configuration Item: <literal>APT::Get::AutomaticRemove</literal>."
3459msgstr ""
3460
3461#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3462#: apt-get.8.xml:525
2a52e8c5
DK
3463msgid "<option>--only-source</option>"
3464msgstr ""
3465
3466#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3467#: apt-get.8.xml:526
2a52e8c5
DK
3468msgid ""
3469"Only has meaning for the <literal>source</literal> and "
3470"<literal>build-dep</literal> commands. Indicates that the given source "
3471"names are not to be mapped through the binary table. This means that if "
3472"this option is specified, these commands will only accept source package "
3473"names as arguments, rather than accepting binary package names and looking "
3474"up the corresponding source package. Configuration Item: "
3475"<literal>APT::Get::Only-Source</literal>."
3476msgstr ""
3477
3478#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3479#: apt-get.8.xml:536
2a52e8c5
DK
3480msgid "<option>--diff-only</option>"
3481msgstr ""
3482
3483#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3484#: apt-get.8.xml:536
2a52e8c5
DK
3485msgid "<option>--dsc-only</option>"
3486msgstr ""
3487
3488#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3489#: apt-get.8.xml:536
2a52e8c5
DK
3490msgid "<option>--tar-only</option>"
3491msgstr ""
3492
3493#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3494#: apt-get.8.xml:537
2a52e8c5
DK
3495msgid ""
3496"Download only the diff, dsc, or tar file of a source archive. Configuration "
3497"Item: <literal>APT::Get::Diff-Only</literal>, "
3498"<literal>APT::Get::Dsc-Only</literal>, and "
3499"<literal>APT::Get::Tar-Only</literal>."
3500msgstr ""
3501
3502#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3503#: apt-get.8.xml:542
2a52e8c5
DK
3504msgid "<option>--arch-only</option>"
3505msgstr ""
3506
3507#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3508#: apt-get.8.xml:543
2a52e8c5
DK
3509msgid ""
3510"Only process architecture-dependent build-dependencies. Configuration Item: "
3511"<literal>APT::Get::Arch-Only</literal>."
3512msgstr ""
3513
3514#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3515#: apt-get.8.xml:547
2a52e8c5
DK
3516msgid "<option>--allow-unauthenticated</option>"
3517msgstr ""
3518
3519#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3520#: apt-get.8.xml:548
2a52e8c5
DK
3521msgid ""
3522"Ignore if packages can't be authenticated and don't prompt about it. This "
3523"is useful for tools like pbuilder. Configuration Item: "
3524"<literal>APT::Get::AllowUnauthenticated</literal>."
3525msgstr ""
3526
bcf91c1b
DK
3527#. type: Content of: <refentry><refsect1><variablelist>
3528#: apt-get.8.xml:561
2a52e8c5 3529msgid ""
bcf91c1b
DK
3530"&file-sourceslist; &file-aptconf; &file-preferences; &file-cachearchives; "
3531"&file-statelists;"
2a52e8c5
DK
3532msgstr ""
3533
3534#. type: Content of: <refentry><refsect1><para>
bcf91c1b 3535#: apt-get.8.xml:570
2a52e8c5
DK
3536msgid ""
3537"&apt-cache;, &apt-cdrom;, &dpkg;, &dselect;, &sources-list;, &apt-conf;, "
3538"&apt-config;, &apt-secure;, The APT User's guide in &guidesdir;, "
3539"&apt-preferences;, the APT Howto."
3540msgstr ""
3541
3542#. type: Content of: <refentry><refsect1><para>
bcf91c1b 3543#: apt-get.8.xml:576
2a52e8c5
DK
3544msgid ""
3545"<command>apt-get</command> returns zero on normal operation, decimal 100 on "
3546"error."
3547msgstr ""
3548
3549#. type: Content of: <refentry><refsect1><title>
bcf91c1b 3550#: apt-get.8.xml:579
2a52e8c5
DK
3551msgid "ORIGINAL AUTHORS"
3552msgstr ""
3553
3554#. type: Content of: <refentry><refsect1><para>
bcf91c1b 3555#: apt-get.8.xml:580
2a52e8c5
DK
3556msgid "&apt-author.jgunthorpe;"
3557msgstr ""
3558
3559#. type: Content of: <refentry><refsect1><title>
bcf91c1b 3560#: apt-get.8.xml:583
2a52e8c5
DK
3561msgid "CURRENT AUTHORS"
3562msgstr ""
3563
3564#. type: Content of: <refentry><refsect1><para>
bcf91c1b 3565#: apt-get.8.xml:585
2a52e8c5
DK
3566msgid "&apt-author.team;"
3567msgstr ""
3568
3569#. type: Content of: <refentry><refnamediv><refname>
bcf91c1b 3570#: apt-key.8.xml:14 apt-key.8.xml:21
2a52e8c5
DK
3571msgid "apt-key"
3572msgstr ""
3573
3574#. type: Content of: <refentry><refnamediv><refpurpose>
bcf91c1b 3575#: apt-key.8.xml:22
2a52e8c5
DK
3576msgid "APT key management utility"
3577msgstr ""
3578
3579#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
bcf91c1b 3580#: apt-key.8.xml:28
2a52e8c5
DK
3581msgid ""
3582"<command>apt-key</command> <arg><replaceable>command</replaceable>/</arg> "
3583"<arg "
3584"rep=\"repeat\"><option><replaceable>arguments</replaceable></option></arg>"
3585msgstr ""
3586
3587#. type: Content of: <refentry><refsect1><para>
bcf91c1b 3588#: apt-key.8.xml:36
2a52e8c5
DK
3589msgid ""
3590"<command>apt-key</command> is used to manage the list of keys used by apt to "
3591"authenticate packages. Packages which have been authenticated using these "
3592"keys will be considered trusted."
3593msgstr ""
3594
3595#. type: Content of: <refentry><refsect1><title>
bcf91c1b 3596#: apt-key.8.xml:42
2a52e8c5
DK
3597msgid "Commands"
3598msgstr ""
3599
3600#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3601#: apt-key.8.xml:44
2a52e8c5
DK
3602msgid "add <replaceable>filename</replaceable>"
3603msgstr ""
3604
3605#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3606#: apt-key.8.xml:48
2a52e8c5
DK
3607msgid ""
3608"Add a new key to the list of trusted keys. The key is read from "
3609"<replaceable>filename</replaceable>, or standard input if "
3610"<replaceable>filename</replaceable> is <literal>-</literal>."
3611msgstr ""
3612
3613#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3614#: apt-key.8.xml:56
2a52e8c5
DK
3615msgid "del <replaceable>keyid</replaceable>"
3616msgstr ""
3617
3618#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3619#: apt-key.8.xml:60
2a52e8c5
DK
3620msgid "Remove a key from the list of trusted keys."
3621msgstr ""
3622
3623#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3624#: apt-key.8.xml:67
2a52e8c5
DK
3625msgid "export <replaceable>keyid</replaceable>"
3626msgstr ""
3627
3628#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3629#: apt-key.8.xml:71
2a52e8c5
DK
3630msgid "Output the key <replaceable>keyid</replaceable> to standard output."
3631msgstr ""
3632
3633#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3634#: apt-key.8.xml:78
2a52e8c5
DK
3635msgid "exportall"
3636msgstr ""
3637
3638#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3639#: apt-key.8.xml:82
2a52e8c5
DK
3640msgid "Output all trusted keys to standard output."
3641msgstr ""
3642
3643#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3644#: apt-key.8.xml:89
2a52e8c5
DK
3645msgid "list"
3646msgstr ""
3647
3648#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3649#: apt-key.8.xml:93
2a52e8c5
DK
3650msgid "List trusted keys."
3651msgstr ""
3652
3653#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3654#: apt-key.8.xml:100
2a52e8c5
DK
3655msgid "finger"
3656msgstr ""
3657
3658#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3659#: apt-key.8.xml:104
2a52e8c5
DK
3660msgid "List fingerprints of trusted keys."
3661msgstr ""
3662
3663#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3664#: apt-key.8.xml:111
2a52e8c5
DK
3665msgid "adv"
3666msgstr ""
3667
3668#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3669#: apt-key.8.xml:115
2a52e8c5
DK
3670msgid ""
3671"Pass advanced options to gpg. With adv --recv-key you can download the "
3672"public key."
3673msgstr ""
3674
3675#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3676#: apt-key.8.xml:127
2a52e8c5
DK
3677msgid ""
3678"Update the local keyring with the keyring of Debian archive keys and removes "
3679"from the keyring the archive keys which are no longer valid."
3680msgstr ""
3681
3682#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3683#: apt-key.8.xml:140
2a52e8c5
DK
3684msgid "<filename>/etc/apt/trusted.gpg</filename>"
3685msgstr ""
3686
3687#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3688#: apt-key.8.xml:141
2a52e8c5
DK
3689msgid "Keyring of local trusted keys, new keys will be added here."
3690msgstr ""
3691
3692#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3693#: apt-key.8.xml:144
2a52e8c5
DK
3694msgid "<filename>/etc/apt/trustdb.gpg</filename>"
3695msgstr ""
3696
3697#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3698#: apt-key.8.xml:145
2a52e8c5
DK
3699msgid "Local trust database of archive keys."
3700msgstr ""
3701
3702#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3703#: apt-key.8.xml:148
2a52e8c5
DK
3704msgid "<filename>/usr/share/keyrings/debian-archive-keyring.gpg</filename>"
3705msgstr ""
3706
3707#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3708#: apt-key.8.xml:149
2a52e8c5
DK
3709msgid "Keyring of Debian archive trusted keys."
3710msgstr ""
3711
3712#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3713#: apt-key.8.xml:152
2a52e8c5
DK
3714msgid "<filename>/usr/share/keyrings/debian-archive-removed-keys.gpg</filename>"
3715msgstr ""
3716
3717#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3718#: apt-key.8.xml:153
2a52e8c5
DK
3719msgid "Keyring of Debian archive removed trusted keys."
3720msgstr ""
3721
3722#. type: Content of: <refentry><refsect1><para>
bcf91c1b 3723#: apt-key.8.xml:164
2a52e8c5
DK
3724msgid "&apt-get;, &apt-secure;"
3725msgstr ""
3726
3727#. The last update date
3728#. type: Content of: <refentry><refentryinfo>
3729#: apt-mark.8.xml:13
3730msgid ""
bcf91c1b
DK
3731"&apt-author.moconnor; &apt-author.team; &apt-email; &apt-product; <date>9 "
3732"August 2009</date>"
2a52e8c5
DK
3733msgstr ""
3734
3735#. type: Content of: <refentry><refnamediv><refname>
bcf91c1b 3736#: apt-mark.8.xml:22 apt-mark.8.xml:29
2a52e8c5
DK
3737msgid "apt-mark"
3738msgstr ""
3739
3740#. type: Content of: <refentry><refnamediv><refpurpose>
bcf91c1b 3741#: apt-mark.8.xml:30
2a52e8c5
DK
3742msgid "mark/unmark a package as being automatically-installed"
3743msgstr ""
3744
3745#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
bcf91c1b 3746#: apt-mark.8.xml:36
2a52e8c5 3747msgid ""
bcf91c1b 3748" <command>apt-mark</command> <arg><option>-hv</option></arg> "
2a52e8c5 3749"<arg><option>-f=<replaceable>FILENAME</replaceable></option></arg> <group "
bcf91c1b
DK
3750"choice=\"plain\"> <arg choice=\"plain\"> <group choice=\"req\"> <arg "
3751"choice=\"plain\">markauto</arg> <arg choice=\"plain\">unmarkauto</arg> "
3752"</group> <arg choice=\"plain\" "
3753"rep=\"repeat\"><replaceable>package</replaceable></arg> </arg> <arg "
3754"choice=\"plain\">showauto</arg> </group>"
2a52e8c5
DK
3755msgstr ""
3756
3757#. type: Content of: <refentry><refsect1><para>
bcf91c1b 3758#: apt-mark.8.xml:53
2a52e8c5
DK
3759msgid ""
3760"<command>apt-mark</command> will change whether a package has been marked as "
3761"being automatically installed."
3762msgstr ""
3763
3764#. type: Content of: <refentry><refsect1><para>
bcf91c1b 3765#: apt-mark.8.xml:57
2a52e8c5
DK
3766msgid ""
3767"When you request that a package is installed, and as a result other packages "
3768"are installed to satisfy its dependencies, the dependencies are marked as "
3769"being automatically installed. Once these automatically installed packages "
3770"are no longer depended on by any manually installed packages, they will be "
bcf91c1b 3771"removed by e.g. <command>apt-get</command> or <command>aptitude</command>."
2a52e8c5
DK
3772msgstr ""
3773
3774#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3775#: apt-mark.8.xml:65
2a52e8c5
DK
3776msgid "markauto"
3777msgstr ""
3778
3779#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3780#: apt-mark.8.xml:66
2a52e8c5
DK
3781msgid ""
3782"<literal>markauto</literal> is used to mark a package as being automatically "
3783"installed, which will cause the package to be removed when no more manually "
3784"installed packages depend on this package."
3785msgstr ""
3786
3787#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3788#: apt-mark.8.xml:73
2a52e8c5
DK
3789msgid "unmarkauto"
3790msgstr ""
3791
3792#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3793#: apt-mark.8.xml:74
2a52e8c5
DK
3794msgid ""
3795"<literal>unmarkauto</literal> is used to mark a package as being manually "
3796"installed, which will prevent the package from being automatically removed "
3797"if no other packages depend on it."
3798msgstr ""
3799
3800#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b
DK
3801#: apt-mark.8.xml:81
3802msgid "showauto"
3803msgstr ""
3804
3805#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3806#: apt-mark.8.xml:82
3807msgid ""
3808"<literal>showauto</literal> is used to print a list of manually installed "
3809"packages with each package on a new line."
3810msgstr ""
3811
3812#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3813#: apt-mark.8.xml:93
3814msgid "<option>-f=<filename><replaceable>FILENAME</replaceable></filename></option>"
2a52e8c5
DK
3815msgstr ""
3816
3817#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b
DK
3818#: apt-mark.8.xml:94
3819msgid "<option>--file=<filename><replaceable>FILENAME</replaceable></filename></option>"
2a52e8c5
DK
3820msgstr ""
3821
3822#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3823#: apt-mark.8.xml:97
2a52e8c5 3824msgid ""
bcf91c1b
DK
3825"Read/Write package stats from "
3826"<filename><replaceable>FILENAME</replaceable></filename> instead of the "
2a52e8c5
DK
3827"default location, which is <filename>extended_status</filename> in the "
3828"directory defined by the Configuration Item: <literal>Dir::State</literal>."
3829msgstr ""
3830
3831#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3832#: apt-mark.8.xml:103
2a52e8c5
DK
3833msgid "<option>-h</option>"
3834msgstr ""
3835
3836#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3837#: apt-mark.8.xml:104
2a52e8c5
DK
3838msgid "<option>--help</option>"
3839msgstr ""
3840
3841#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3842#: apt-mark.8.xml:105
2a52e8c5
DK
3843msgid "Show a short usage summary."
3844msgstr ""
3845
3846#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3847#: apt-mark.8.xml:111
2a52e8c5
DK
3848msgid "<option>-v</option>"
3849msgstr ""
3850
3851#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 3852#: apt-mark.8.xml:112
2a52e8c5
DK
3853msgid "<option>--version</option>"
3854msgstr ""
3855
3856#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 3857#: apt-mark.8.xml:113
2a52e8c5
DK
3858msgid "Show the program version."
3859msgstr ""
3860
bcf91c1b
DK
3861#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3862#: apt-mark.8.xml:124
3863msgid "<filename>/var/lib/apt/extended_states</filename>"
3864msgstr ""
3865
3866#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3867#: apt-mark.8.xml:125
3868msgid ""
3869"Status list of auto-installed packages. Configuration Item: "
3870"<literal>Dir::State</literal> sets the path to the "
3871"<filename>extended_states</filename> file."
3872msgstr ""
3873
2a52e8c5 3874#. type: Content of: <refentry><refsect1><para>
bcf91c1b
DK
3875#: apt-mark.8.xml:134
3876msgid "&apt-get;,&aptitude;,&apt-conf;"
3877msgstr ""
3878
3879#. type: Content of: <refentry><refsect1><para>
3880#: apt-mark.8.xml:138
2a52e8c5
DK
3881msgid ""
3882"<command>apt-mark</command> returns zero on normal operation, non-zero on "
3883"error."
3884msgstr ""
3885
3886#. type: Content of: <refentry><refnamediv><refname>
bcf91c1b 3887#: apt-secure.8.xml:14 apt-secure.8.xml:36
2a52e8c5
DK
3888msgid "apt-secure"
3889msgstr ""
3890
3891#. type: Content of: <refentry><refnamediv><refpurpose>
bcf91c1b 3892#: apt-secure.8.xml:37
2a52e8c5
DK
3893msgid "Archive authentication support for APT"
3894msgstr ""
3895
3896#. type: Content of: <refentry><refsect1><para>
bcf91c1b 3897#: apt-secure.8.xml:42
2a52e8c5
DK
3898msgid ""
3899"Starting with version 0.6, <command>apt</command> contains code that does "
3900"signature checking of the Release file for all archives. This ensures that "
3901"packages in the archive can't be modified by people who have no access to "
3902"the Release file signing key."
3903msgstr ""
3904
3905#. type: Content of: <refentry><refsect1><para>
bcf91c1b 3906#: apt-secure.8.xml:50
2a52e8c5
DK
3907msgid ""
3908"If a package comes from a archive without a signature or with a signature "
3909"that apt does not have a key for that package is considered untrusted and "
3910"installing it will result in a big warning. <command>apt-get</command> will "
3911"currently only warn for unsigned archives, future releases might force all "
3912"sources to be verified before downloading packages from them."
3913msgstr ""
3914
3915#. type: Content of: <refentry><refsect1><para>
bcf91c1b 3916#: apt-secure.8.xml:59
2a52e8c5
DK
3917msgid ""
3918"The package frontends &apt-get;, &aptitude; and &synaptic; support this new "
3919"authentication feature."
3920msgstr ""
3921
3922#. type: Content of: <refentry><refsect1><title>
bcf91c1b 3923#: apt-secure.8.xml:64
2a52e8c5
DK
3924msgid "Trusted archives"
3925msgstr ""
3926
3927#. type: Content of: <refentry><refsect1><para>
bcf91c1b 3928#: apt-secure.8.xml:67
2a52e8c5
DK
3929msgid ""
3930"The chain of trust from an apt archive to the end user is made up of "
3931"different steps. <command>apt-secure</command> is the last step in this "
3932"chain, trusting an archive does not mean that the packages that you trust it "
3933"do not contain malicious code but means that you trust the archive "
3934"maintainer. Its the archive maintainer responsibility to ensure that the "
3935"archive integrity is correct."
3936msgstr ""
3937
3938#. type: Content of: <refentry><refsect1><para>
bcf91c1b 3939#: apt-secure.8.xml:75
2a52e8c5
DK
3940msgid ""
3941"apt-secure does not review signatures at a package level. If you require "
3942"tools to do this you should look at <command>debsig-verify</command> and "
3943"<command>debsign</command> (provided in the debsig-verify and devscripts "
3944"packages respectively)."
3945msgstr ""
3946
3947#. type: Content of: <refentry><refsect1><para>
bcf91c1b 3948#: apt-secure.8.xml:82
2a52e8c5
DK
3949msgid ""
3950"The chain of trust in Debian starts when a maintainer uploads a new package "
3951"or a new version of a package to the Debian archive. This upload in order to "
3952"become effective needs to be signed by a key of a maintainer within the "
3953"Debian maintainer's keyring (available in the debian-keyring "
3954"package). Maintainer's keys are signed by other maintainers following "
3955"pre-established procedures to ensure the identity of the key holder."
3956msgstr ""
3957
3958#. type: Content of: <refentry><refsect1><para>
bcf91c1b 3959#: apt-secure.8.xml:92
2a52e8c5
DK
3960msgid ""
3961"Once the uploaded package is verified and included in the archive, the "
3962"maintainer signature is stripped off, an MD5 sum of the package is computed "
3963"and put in the Packages file. The MD5 sum of all of the packages files are "
3964"then computed and put into the Release file. The Release file is then signed "
3965"by the archive key (which is created once a year and distributed through the "
3966"FTP server. This key is also on the Debian keyring."
3967msgstr ""
3968
3969#. type: Content of: <refentry><refsect1><para>
bcf91c1b 3970#: apt-secure.8.xml:102
2a52e8c5
DK
3971msgid ""
3972"Any end user can check the signature of the Release file, extract the MD5 "
3973"sum of a package from it and compare it with the MD5 sum of the package he "
3974"downloaded. Prior to version 0.6 only the MD5 sum of the downloaded Debian "
3975"package was checked. Now both the MD5 sum and the signature of the Release "
3976"file are checked."
3977msgstr ""
3978
3979#. type: Content of: <refentry><refsect1><para>
bcf91c1b 3980#: apt-secure.8.xml:109
2a52e8c5
DK
3981msgid ""
3982"Notice that this is distinct from checking signatures on a per package "
3983"basis. It is designed to prevent two possible attacks:"
3984msgstr ""
3985
3986#. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
bcf91c1b 3987#: apt-secure.8.xml:114
2a52e8c5
DK
3988msgid ""
3989"<literal>Network \"man in the middle\" attacks</literal>. Without signature "
3990"checking, a malicious agent can introduce himself in the package download "
3991"process and provide malicious software either by controlling a network "
3992"element (router, switch, etc.) or by redirecting traffic to a rogue server "
3993"(through arp or DNS spoofing attacks)."
3994msgstr ""
3995
3996#. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
bcf91c1b 3997#: apt-secure.8.xml:122
2a52e8c5
DK
3998msgid ""
3999"<literal>Mirror network compromise</literal>. Without signature checking, a "
4000"malicious agent can compromise a mirror host and modify the files in it to "
4001"propagate malicious software to all users downloading packages from that "
4002"host."
4003msgstr ""
4004
4005#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4006#: apt-secure.8.xml:129
2a52e8c5
DK
4007msgid ""
4008"However, it does not defend against a compromise of the Debian master server "
4009"itself (which signs the packages) or against a compromise of the key used to "
4010"sign the Release files. In any case, this mechanism can complement a "
4011"per-package signature."
4012msgstr ""
4013
4014#. type: Content of: <refentry><refsect1><title>
bcf91c1b 4015#: apt-secure.8.xml:135
2a52e8c5
DK
4016msgid "User configuration"
4017msgstr ""
4018
4019#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4020#: apt-secure.8.xml:137
2a52e8c5
DK
4021msgid ""
4022"<command>apt-key</command> is the program that manages the list of keys used "
4023"by apt. It can be used to add or remove keys although an installation of "
4024"this release will automatically provide the default Debian archive signing "
4025"keys used in the Debian package repositories."
4026msgstr ""
4027
4028#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4029#: apt-secure.8.xml:144
2a52e8c5
DK
4030msgid ""
4031"In order to add a new key you need to first download it (you should make "
4032"sure you are using a trusted communication channel when retrieving it), add "
4033"it with <command>apt-key</command> and then run <command>apt-get "
4034"update</command> so that apt can download and verify the "
4035"<filename>Release.gpg</filename> files from the archives you have "
4036"configured."
4037msgstr ""
4038
4039#. type: Content of: <refentry><refsect1><title>
bcf91c1b 4040#: apt-secure.8.xml:153
2a52e8c5
DK
4041msgid "Archive configuration"
4042msgstr ""
4043
4044#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4045#: apt-secure.8.xml:155
2a52e8c5
DK
4046msgid ""
4047"If you want to provide archive signatures in an archive under your "
4048"maintenance you have to:"
4049msgstr ""
4050
4051#. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
bcf91c1b 4052#: apt-secure.8.xml:160
2a52e8c5
DK
4053msgid ""
4054"<literal>Create a toplevel Release file</literal>. if it does not exist "
4055"already. You can do this by running <command>apt-ftparchive "
4056"release</command> (provided in apt-utils)."
4057msgstr ""
4058
4059#. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
bcf91c1b 4060#: apt-secure.8.xml:165
2a52e8c5
DK
4061msgid ""
4062"<literal>Sign it</literal>. You can do this by running <command>gpg -abs -o "
4063"Release.gpg Release</command>."
4064msgstr ""
4065
4066#. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
bcf91c1b 4067#: apt-secure.8.xml:168
2a52e8c5
DK
4068msgid ""
4069"<literal>Publish the key fingerprint</literal>, that way your users will "
4070"know what key they need to import in order to authenticate the files in the "
4071"archive."
4072msgstr ""
4073
4074#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4075#: apt-secure.8.xml:175
2a52e8c5
DK
4076msgid ""
4077"Whenever the contents of the archive changes (new packages are added or "
4078"removed) the archive maintainer has to follow the first two steps previously "
4079"outlined."
4080msgstr ""
4081
4082#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4083#: apt-secure.8.xml:183
2a52e8c5
DK
4084msgid ""
4085"&apt-conf;, &apt-get;, &sources-list;, &apt-key;, &apt-ftparchive;, "
4086"&debsign; &debsig-verify;, &gpg;"
4087msgstr ""
4088
4089#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4090#: apt-secure.8.xml:187
2a52e8c5
DK
4091msgid ""
4092"For more background information you might want to review the <ulink "
4093"url=\"http://www.debian.org/doc/manuals/securing-debian-howto/ch7.en.html\">Debian "
4094"Security Infrastructure</ulink> chapter of the Securing Debian Manual "
4095"(available also in the harden-doc package) and the <ulink "
4096"url=\"http://www.cryptnet.net/fdp/crypto/strong_distro.html\" >Strong "
4097"Distribution HOWTO</ulink> by V. Alex Brennen."
4098msgstr ""
4099
4100#. type: Content of: <refentry><refsect1><title>
bcf91c1b 4101#: apt-secure.8.xml:200
2a52e8c5
DK
4102msgid "Manpage Authors"
4103msgstr ""
4104
4105#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4106#: apt-secure.8.xml:202
2a52e8c5
DK
4107msgid ""
4108"This man-page is based on the work of Javier Fernández-Sanguino Peña, Isaac "
4109"Jones, Colin Walters, Florian Weimer and Michael Vogt."
4110msgstr ""
4111
4112#. type: Content of: <refentry><refnamediv><refname>
bcf91c1b 4113#: apt-sortpkgs.1.xml:22 apt-sortpkgs.1.xml:29
2a52e8c5
DK
4114msgid "apt-sortpkgs"
4115msgstr ""
4116
4117#. type: Content of: <refentry><refnamediv><refpurpose>
bcf91c1b 4118#: apt-sortpkgs.1.xml:30
2a52e8c5
DK
4119msgid "Utility to sort package index files"
4120msgstr ""
4121
4122#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
bcf91c1b 4123#: apt-sortpkgs.1.xml:36
2a52e8c5
DK
4124msgid ""
4125"<command>apt-sortpkgs</command> <arg><option>-hvs</option></arg> "
4126"<arg><option>-o=<replaceable>config string</replaceable></option></arg> "
4127"<arg><option>-c=<replaceable>file</replaceable></option></arg> <arg "
4128"choice=\"plain\" rep=\"repeat\"><replaceable>file</replaceable></arg>"
4129msgstr ""
4130
4131#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4132#: apt-sortpkgs.1.xml:45
2a52e8c5
DK
4133msgid ""
4134"<command>apt-sortpkgs</command> will take an index file (Source index or "
4135"Package index) and sort the records so that they are ordered by the package "
4136"name. It will also sort the internal fields of each record according to the "
4137"internal sorting rules."
4138msgstr ""
4139
4140#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4141#: apt-sortpkgs.1.xml:51
2a52e8c5
DK
4142msgid "All output is sent to stdout, the input must be a seekable file."
4143msgstr ""
4144
4145#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4146#: apt-sortpkgs.1.xml:58
2a52e8c5
DK
4147msgid "<option>--source</option>"
4148msgstr ""
4149
4150#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4151#: apt-sortpkgs.1.xml:60
2a52e8c5
DK
4152msgid ""
4153"Use Source index field ordering. Configuration Item: "
4154"<literal>APT::SortPkgs::Source</literal>."
4155msgstr ""
4156
4157#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4158#: apt-sortpkgs.1.xml:74
2a52e8c5
DK
4159msgid ""
4160"<command>apt-sortpkgs</command> returns zero on normal operation, decimal "
4161"100 on error."
4162msgstr ""
4163
4164#. The last update date
4165#. type: Content of: <refentry><refentryinfo>
4166#: apt.conf.5.xml:13
4167msgid ""
4168"&apt-author.jgunthorpe; &apt-author.team; <author> "
4169"<firstname>Daniel</firstname> <surname>Burrows</surname> <contrib>Initial "
4170"documentation of Debug::*.</contrib> <email>dburrows@debian.org</email> "
4171"</author> &apt-email; &apt-product; <date>10 December 2008</date>"
4172msgstr ""
4173
4174#. type: Content of: <refentry><refnamediv><refname>
bcf91c1b 4175#: apt.conf.5.xml:28 apt.conf.5.xml:35
2a52e8c5
DK
4176msgid "apt.conf"
4177msgstr ""
4178
4179#. type: Content of: <refentry><refmeta><manvolnum>
4180#: apt.conf.5.xml:29 apt_preferences.5.xml:22 sources.list.5.xml:23
4181msgid "5"
4182msgstr ""
4183
4184#. type: Content of: <refentry><refnamediv><refpurpose>
bcf91c1b 4185#: apt.conf.5.xml:36
2a52e8c5
DK
4186msgid "Configuration file for APT"
4187msgstr ""
4188
4189#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4190#: apt.conf.5.xml:40
2a52e8c5
DK
4191msgid ""
4192"<filename>apt.conf</filename> is the main configuration file for the APT "
4193"suite of tools, all tools make use of the configuration file and a common "
4194"command line parser to provide a uniform environment. When an APT tool "
4195"starts up it will read the configuration specified by the "
4196"<envar>APT_CONFIG</envar> environment variable (if any) and then read the "
4197"files in <literal>Dir::Etc::Parts</literal> then read the main configuration "
4198"file specified by <literal>Dir::Etc::main</literal> then finally apply the "
4199"command line options to override the configuration directives, possibly "
4200"loading even more config files."
4201msgstr ""
4202
4203#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4204#: apt.conf.5.xml:50
2a52e8c5
DK
4205msgid ""
4206"The configuration file is organized in a tree with options organized into "
4207"functional groups. option specification is given with a double colon "
4208"notation, for instance <literal>APT::Get::Assume-Yes</literal> is an option "
4209"within the APT tool group, for the Get tool. options do not inherit from "
4210"their parent groups."
4211msgstr ""
4212
4213#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4214#: apt.conf.5.xml:56
2a52e8c5
DK
4215msgid ""
4216"Syntactically the configuration language is modeled after what the ISC tools "
4217"such as bind and dhcp use. Lines starting with <literal>//</literal> are "
4218"treated as comments (ignored), as well as all text between "
4219"<literal>/*</literal> and <literal>*/</literal>, just like C/C++ comments. "
4220"Each line is of the form <literal>APT::Get::Assume-Yes \"true\";</literal> "
4221"The trailing semicolon is required and the quotes are optional. A new scope "
4222"can be opened with curly braces, like:"
4223msgstr ""
4224
4225#. type: Content of: <refentry><refsect1><informalexample><programlisting>
bcf91c1b 4226#: apt.conf.5.xml:66
2a52e8c5
DK
4227#, no-wrap
4228msgid ""
4229"APT {\n"
4230" Get {\n"
4231" Assume-Yes \"true\";\n"
4232" Fix-Broken \"true\";\n"
4233" };\n"
4234"};\n"
4235msgstr ""
4236
4237#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4238#: apt.conf.5.xml:74
2a52e8c5
DK
4239msgid ""
4240"with newlines placed to make it more readable. Lists can be created by "
4241"opening a scope and including a single string enclosed in quotes followed by "
4242"a semicolon. Multiple entries can be included, each separated by a "
4243"semicolon."
4244msgstr ""
4245
4246#. type: Content of: <refentry><refsect1><informalexample><programlisting>
bcf91c1b 4247#: apt.conf.5.xml:79
2a52e8c5
DK
4248#, no-wrap
4249msgid "DPkg::Pre-Install-Pkgs {\"/usr/sbin/dpkg-preconfigure --apt\";};\n"
4250msgstr ""
4251
4252#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4253#: apt.conf.5.xml:82
2a52e8c5
DK
4254msgid ""
4255"In general the sample configuration file in "
4256"<filename>&docdir;examples/apt.conf</filename> &configureindex; is a good "
4257"guide for how it should look."
4258msgstr ""
4259
4260#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4261#: apt.conf.5.xml:86
2a52e8c5
DK
4262msgid ""
4263"The names of the configuration items are not case-sensitive. So in the "
4264"previous example you could use <literal>dpkg::pre-install-pkgs</literal>."
4265msgstr ""
4266
4267#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4268#: apt.conf.5.xml:89
2a52e8c5
DK
4269msgid ""
4270"Two specials are allowed, <literal>#include</literal> and "
4271"<literal>#clear</literal> <literal>#include</literal> will include the given "
4272"file, unless the filename ends in a slash, then the whole directory is "
4273"included. <literal>#clear</literal> is used to erase a part of the "
bcf91c1b 4274"configuration tree. The specified element and all its descendants are "
2a52e8c5
DK
4275"erased."
4276msgstr ""
4277
4278#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4279#: apt.conf.5.xml:95
2a52e8c5
DK
4280msgid ""
4281"All of the APT tools take a -o option which allows an arbitrary "
4282"configuration directive to be specified on the command line. The syntax is a "
4283"full option name (<literal>APT::Get::Assume-Yes</literal> for instance) "
4284"followed by an equals sign then the new value of the option. Lists can be "
4285"appended too by adding a trailing :: to the list name."
4286msgstr ""
4287
4288#. type: Content of: <refentry><refsect1><title>
bcf91c1b 4289#: apt.conf.5.xml:102
2a52e8c5
DK
4290msgid "The APT Group"
4291msgstr ""
4292
4293#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4294#: apt.conf.5.xml:103
2a52e8c5
DK
4295msgid ""
4296"This group of options controls general APT behavior as well as holding the "
4297"options for all of the tools."
4298msgstr ""
4299
4300#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4301#: apt.conf.5.xml:107
2a52e8c5
DK
4302msgid "Architecture"
4303msgstr ""
4304
4305#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4306#: apt.conf.5.xml:108
2a52e8c5
DK
4307msgid ""
4308"System Architecture; sets the architecture to use when fetching files and "
4309"parsing package lists. The internal default is the architecture apt was "
4310"compiled for."
4311msgstr ""
4312
4313#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4314#: apt.conf.5.xml:113
2a52e8c5
DK
4315msgid "Default-Release"
4316msgstr ""
4317
4318#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4319#: apt.conf.5.xml:114
2a52e8c5
DK
4320msgid ""
4321"Default release to install packages from if more than one version "
4322"available. Contains release name, codename or release version. Examples: "
4323"'stable', 'testing', 'unstable', 'lenny', 'squeeze', '4.0', '5.0*'. See also "
4324"&apt-preferences;."
4325msgstr ""
4326
4327#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4328#: apt.conf.5.xml:118
2a52e8c5
DK
4329msgid "Ignore-Hold"
4330msgstr ""
4331
4332#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4333#: apt.conf.5.xml:119
2a52e8c5
DK
4334msgid ""
4335"Ignore Held packages; This global option causes the problem resolver to "
4336"ignore held packages in its decision making."
4337msgstr ""
4338
4339#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4340#: apt.conf.5.xml:123
2a52e8c5
DK
4341msgid "Clean-Installed"
4342msgstr ""
4343
4344#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4345#: apt.conf.5.xml:124
2a52e8c5
DK
4346msgid ""
4347"Defaults to on. When turned on the autoclean feature will remove any "
4348"packages which can no longer be downloaded from the cache. If turned off "
4349"then packages that are locally installed are also excluded from cleaning - "
4350"but note that APT provides no direct means to reinstall them."
4351msgstr ""
4352
4353#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4354#: apt.conf.5.xml:130
2a52e8c5
DK
4355msgid "Immediate-Configure"
4356msgstr ""
4357
4358#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4359#: apt.conf.5.xml:131
2a52e8c5
DK
4360msgid ""
4361"Disable Immediate Configuration; This dangerous option disables some of "
4362"APT's ordering code to cause it to make fewer dpkg calls. Doing so may be "
4363"necessary on some extremely slow single user systems but is very dangerous "
4364"and may cause package install scripts to fail or worse. Use at your own "
4365"risk."
4366msgstr ""
4367
4368#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4369#: apt.conf.5.xml:138
2a52e8c5
DK
4370msgid "Force-LoopBreak"
4371msgstr ""
4372
4373#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4374#: apt.conf.5.xml:139
2a52e8c5
DK
4375msgid ""
4376"Never Enable this option unless you -really- know what you are doing. It "
4377"permits APT to temporarily remove an essential package to break a "
4378"Conflicts/Conflicts or Conflicts/Pre-Depend loop between two essential "
4379"packages. SUCH A LOOP SHOULD NEVER EXIST AND IS A GRAVE BUG. This option "
4380"will work if the essential packages are not tar, gzip, libc, dpkg, bash or "
4381"anything that those packages depend on."
4382msgstr ""
4383
4384#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4385#: apt.conf.5.xml:147
2a52e8c5
DK
4386msgid "Cache-Limit"
4387msgstr ""
4388
4389#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4390#: apt.conf.5.xml:148
2a52e8c5
DK
4391msgid ""
4392"APT uses a fixed size memory mapped cache file to store the 'available' "
4393"information. This sets the size of that cache (in bytes)."
4394msgstr ""
4395
4396#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4397#: apt.conf.5.xml:152
2a52e8c5
DK
4398msgid "Build-Essential"
4399msgstr ""
4400
4401#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4402#: apt.conf.5.xml:153
2a52e8c5
DK
4403msgid "Defines which package(s) are considered essential build dependencies."
4404msgstr ""
4405
4406#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4407#: apt.conf.5.xml:156
2a52e8c5
DK
4408msgid "Get"
4409msgstr ""
4410
4411#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4412#: apt.conf.5.xml:157
2a52e8c5
DK
4413msgid ""
4414"The Get subsection controls the &apt-get; tool, please see its documentation "
4415"for more information about the options here."
4416msgstr ""
4417
4418#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4419#: apt.conf.5.xml:161
2a52e8c5
DK
4420msgid "Cache"
4421msgstr ""
4422
4423#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4424#: apt.conf.5.xml:162
2a52e8c5
DK
4425msgid ""
4426"The Cache subsection controls the &apt-cache; tool, please see its "
4427"documentation for more information about the options here."
4428msgstr ""
4429
4430#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4431#: apt.conf.5.xml:166
2a52e8c5
DK
4432msgid "CDROM"
4433msgstr ""
4434
4435#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4436#: apt.conf.5.xml:167
2a52e8c5
DK
4437msgid ""
4438"The CDROM subsection controls the &apt-cdrom; tool, please see its "
4439"documentation for more information about the options here."
4440msgstr ""
4441
4442#. type: Content of: <refentry><refsect1><title>
bcf91c1b 4443#: apt.conf.5.xml:173
2a52e8c5
DK
4444msgid "The Acquire Group"
4445msgstr ""
4446
4447#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
bcf91c1b 4448#: apt.conf.5.xml:178
2a52e8c5
DK
4449msgid "PDiffs"
4450msgstr ""
4451
4452#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 4453#: apt.conf.5.xml:179
2a52e8c5
DK
4454msgid ""
4455"Try to download deltas called <literal>PDiffs</literal> for Packages or "
4456"Sources files instead of downloading whole ones. True by default."
4457msgstr ""
4458
4459#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
bcf91c1b 4460#: apt.conf.5.xml:184
2a52e8c5
DK
4461msgid "Queue-Mode"
4462msgstr ""
4463
4464#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 4465#: apt.conf.5.xml:185
2a52e8c5
DK
4466msgid ""
4467"Queuing mode; <literal>Queue-Mode</literal> can be one of "
4468"<literal>host</literal> or <literal>access</literal> which determines how "
4469"APT parallelizes outgoing connections. <literal>host</literal> means that "
4470"one connection per target host will be opened, <literal>access</literal> "
4471"means that one connection per URI type will be opened."
4472msgstr ""
4473
4474#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
bcf91c1b 4475#: apt.conf.5.xml:192
2a52e8c5
DK
4476msgid "Retries"
4477msgstr ""
4478
4479#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 4480#: apt.conf.5.xml:193
2a52e8c5
DK
4481msgid ""
4482"Number of retries to perform. If this is non-zero APT will retry failed "
4483"files the given number of times."
4484msgstr ""
4485
4486#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
bcf91c1b 4487#: apt.conf.5.xml:197
2a52e8c5
DK
4488msgid "Source-Symlinks"
4489msgstr ""
4490
4491#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 4492#: apt.conf.5.xml:198
2a52e8c5
DK
4493msgid ""
4494"Use symlinks for source archives. If set to true then source archives will "
4495"be symlinked when possible instead of copying. True is the default."
4496msgstr ""
4497
4498#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
bcf91c1b 4499#: apt.conf.5.xml:202 sources.list.5.xml:139
2a52e8c5
DK
4500msgid "http"
4501msgstr ""
4502
4503#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 4504#: apt.conf.5.xml:203
2a52e8c5
DK
4505msgid ""
4506"HTTP URIs; http::Proxy is the default http proxy to use. It is in the "
4507"standard form of <literal>http://[[user][:pass]@]host[:port]/</literal>. Per "
4508"host proxies can also be specified by using the form "
4509"<literal>http::Proxy::&lt;host&gt;</literal> with the special keyword "
bcf91c1b
DK
4510"<literal>DIRECT</literal> meaning to use no proxies. If no one of the above "
4511"settings is specified, <envar>http_proxy</envar> environment variable will "
4512"be used."
2a52e8c5
DK
4513msgstr ""
4514
4515#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 4516#: apt.conf.5.xml:211
2a52e8c5
DK
4517msgid ""
4518"Three settings are provided for cache control with HTTP/1.1 compliant proxy "
4519"caches. <literal>No-Cache</literal> tells the proxy to not use its cached "
4520"response under any circumstances, <literal>Max-Age</literal> is sent only "
4521"for index files and tells the cache to refresh its object if it is older "
4522"than the given number of seconds. Debian updates its index files daily so "
4523"the default is 1 day. <literal>No-Store</literal> specifies that the cache "
4524"should never store this request, it is only set for archive files. This may "
4525"be useful to prevent polluting a proxy cache with very large .deb "
4526"files. Note: Squid 2.0.2 does not support any of these options."
4527msgstr ""
4528
4529#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 4530#: apt.conf.5.xml:221 apt.conf.5.xml:273
2a52e8c5
DK
4531msgid ""
4532"The option <literal>timeout</literal> sets the timeout timer used by the "
4533"method, this applies to all things including connection timeout and data "
4534"timeout."
4535msgstr ""
4536
4537#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 4538#: apt.conf.5.xml:224
2a52e8c5
DK
4539msgid ""
4540"One setting is provided to control the pipeline depth in cases where the "
4541"remote server is not RFC conforming or buggy (such as Squid 2.0.2) "
4542"<literal>Acquire::http::Pipeline-Depth</literal> can be a value from 0 to 5 "
4543"indicating how many outstanding requests APT should send. A value of zero "
4544"MUST be specified if the remote host does not properly linger on TCP "
4545"connections - otherwise data corruption will occur. Hosts which require this "
4546"are in violation of RFC 2068."
4547msgstr ""
4548
4549#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
bcf91c1b 4550#: apt.conf.5.xml:233
2a52e8c5
DK
4551msgid "https"
4552msgstr ""
4553
4554#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 4555#: apt.conf.5.xml:234
2a52e8c5
DK
4556msgid ""
4557"HTTPS URIs. Cache-control and proxy options are the same as for "
4558"<literal>http</literal> method. <literal>Pipeline-Depth</literal> option is "
4559"not supported yet."
4560msgstr ""
4561
4562#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 4563#: apt.conf.5.xml:238
2a52e8c5
DK
4564msgid ""
4565"<literal>CaInfo</literal> suboption specifies place of file that holds info "
4566"about trusted certificates. <literal>&lt;host&gt;::CaInfo</literal> is "
4567"corresponding per-host option. <literal>Verify-Peer</literal> boolean "
4568"suboption determines whether verify server's host certificate against "
4569"trusted certificates or not. <literal>&lt;host&gt;::Verify-Peer</literal> "
4570"is corresponding per-host option. <literal>Verify-Host</literal> boolean "
4571"suboption determines whether verify server's hostname or not. "
4572"<literal>&lt;host&gt;::Verify-Host</literal> is corresponding per-host "
4573"option. <literal>SslCert</literal> determines what certificate to use for "
4574"client authentication. <literal>&lt;host&gt;::SslCert</literal> is "
4575"corresponding per-host option. <literal>SslKey</literal> determines what "
4576"private key to use for client "
4577"authentication. <literal>&lt;host&gt;::SslKey</literal> is corresponding "
4578"per-host option. <literal>SslForceVersion</literal> overrides default SSL "
4579"version to use. Can contain 'TLSv1' or 'SSLv3' string. "
4580"<literal>&lt;host&gt;::SslForceVersion</literal> is corresponding per-host "
4581"option."
4582msgstr ""
4583
4584#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
bcf91c1b 4585#: apt.conf.5.xml:256 sources.list.5.xml:150
2a52e8c5
DK
4586msgid "ftp"
4587msgstr ""
4588
4589#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b
DK
4590#: apt.conf.5.xml:257
4591msgid ""
4592"FTP URIs; ftp::Proxy is the default ftp proxy to use. It is in the standard "
4593"form of <literal>ftp://[[user][:pass]@]host[:port]/</literal>. Per host "
4594"proxies can also be specified by using the form "
4595"<literal>ftp::Proxy::&lt;host&gt;</literal> with the special keyword "
4596"<literal>DIRECT</literal> meaning to use no proxies. If no one of the above "
4597"settings is specified, <envar>ftp_proxy</envar> environment variable will be "
4598"used. To use a ftp proxy you will have to set the "
4599"<literal>ftp::ProxyLogin</literal> script in the configuration file. This "
4600"entry specifies the commands to send to tell the proxy server what to "
4601"connect to. Please see &configureindex; for an example of how to do "
4602"this. The substitution variables available are "
2a52e8c5
DK
4603"<literal>$(PROXY_USER)</literal> <literal>$(PROXY_PASS)</literal> "
4604"<literal>$(SITE_USER)</literal> <literal>$(SITE_PASS)</literal> "
4605"<literal>$(SITE)</literal> and <literal>$(SITE_PORT)</literal> Each is taken "
4606"from it's respective URI component."
4607msgstr ""
4608
4609#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 4610#: apt.conf.5.xml:276
2a52e8c5
DK
4611msgid ""
4612"Several settings are provided to control passive mode. Generally it is safe "
4613"to leave passive mode on, it works in nearly every environment. However "
4614"some situations require that passive mode be disabled and port mode ftp used "
4615"instead. This can be done globally, for connections that go through a proxy "
4616"or for a specific host (See the sample config file for examples)."
4617msgstr ""
4618
4619#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 4620#: apt.conf.5.xml:283
2a52e8c5
DK
4621msgid ""
4622"It is possible to proxy FTP over HTTP by setting the "
4623"<envar>ftp_proxy</envar> environment variable to a http url - see the "
4624"discussion of the http method above for syntax. You cannot set this in the "
4625"configuration file and it is not recommended to use FTP over HTTP due to its "
4626"low efficiency."
4627msgstr ""
4628
4629#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 4630#: apt.conf.5.xml:288
2a52e8c5
DK
4631msgid ""
4632"The setting <literal>ForceExtended</literal> controls the use of RFC2428 "
4633"<literal>EPSV</literal> and <literal>EPRT</literal> commands. The default is "
4634"false, which means these commands are only used if the control connection is "
4635"IPv6. Setting this to true forces their use even on IPv4 connections. Note "
4636"that most FTP servers do not support RFC2428."
4637msgstr ""
4638
4639#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
bcf91c1b 4640#: apt.conf.5.xml:295 sources.list.5.xml:132
2a52e8c5
DK
4641msgid "cdrom"
4642msgstr ""
4643
4644#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><literallayout>
bcf91c1b 4645#: apt.conf.5.xml:301
2a52e8c5
DK
4646#, no-wrap
4647msgid "\"/cdrom/\"::Mount \"foo\";"
4648msgstr ""
4649
4650#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 4651#: apt.conf.5.xml:296
2a52e8c5
DK
4652msgid ""
4653"CDROM URIs; the only setting for CDROM URIs is the mount point, "
4654"<literal>cdrom::Mount</literal> which must be the mount point for the CDROM "
4655"drive as specified in <filename>/etc/fstab</filename>. It is possible to "
4656"provide alternate mount and unmount commands if your mount point cannot be "
4657"listed in the fstab (such as an SMB mount and old mount packages). The "
4658"syntax is to put <placeholder type=\"literallayout\" id=\"0\"/> within the "
4659"cdrom block. It is important to have the trailing slash. Unmount commands "
4660"can be specified using UMount."
4661msgstr ""
4662
4663#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
bcf91c1b 4664#: apt.conf.5.xml:306
2a52e8c5
DK
4665msgid "gpgv"
4666msgstr ""
4667
4668#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 4669#: apt.conf.5.xml:307
2a52e8c5
DK
4670msgid ""
4671"GPGV URIs; the only option for GPGV URIs is the option to pass additional "
4672"parameters to gpgv. <literal>gpgv::Options</literal> Additional options "
4673"passed to gpgv."
4674msgstr ""
4675
bcf91c1b
DK
4676#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
4677#: apt.conf.5.xml:312
4678msgid "CompressionTypes"
4679msgstr ""
4680
4681#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><synopsis>
4682#: apt.conf.5.xml:318
4683#, no-wrap
4684msgid ""
4685"Acquire::CompressionTypes::<replaceable>FileExtension</replaceable> "
4686"\"<replaceable>Methodname</replaceable>\";"
4687msgstr ""
4688
4689#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
4690#: apt.conf.5.xml:313
4691msgid ""
4692"List of compression types which are understood by the acquire methods. "
4693"Files like <filename>Packages</filename> can be available in various "
4694"compression formats. Per default the acquire methods can decompress "
4695"<command>bzip2</command>, <command>lzma</command> and "
4696"<command>gzip</command> compressed files, with this setting more formats can "
4697"be added on the fly or the used method can be changed. The syntax for this "
4698"is: <placeholder type=\"synopsis\" id=\"0\"/>"
4699msgstr ""
4700
4701#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><synopsis>
4702#: apt.conf.5.xml:323
4703#, no-wrap
4704msgid "Acquire::CompressionTypes::Order:: \"gz\";"
4705msgstr ""
4706
4707#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><synopsis>
4708#: apt.conf.5.xml:326
4709#, no-wrap
4710msgid "Acquire::CompressionTypes::Order { \"lzma\"; \"gz\"; };"
4711msgstr ""
4712
4713#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
4714#: apt.conf.5.xml:319
4715msgid ""
4716"Also the <literal>Order</literal> subgroup can be used to define in which "
4717"order the acquire system will try to download the compressed files. The "
4718"acquire system will try the first and proceed with the next compression type "
4719"in this list on error, so to prefer one over the other type simple add the "
4720"preferred type at first - not already added default types will be added at "
4721"run time to the end of the list, so e.g. <placeholder type=\"synopsis\" "
4722"id=\"0\"/> can be used to prefer <command>gzip</command> compressed files "
4723"over <command>bzip2</command> and <command>lzma</command>. If "
4724"<command>lzma</command> should be preferred over <command>gzip</command> and "
4725"<command>bzip2</command> the configure setting should look like this "
4726"<placeholder type=\"synopsis\" id=\"1\"/> It is not needed to add "
4727"<literal>bz2</literal> explicit to the list as it will be added automatic."
4728msgstr ""
4729
4730#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><literallayout>
4731#: apt.conf.5.xml:330
4732#, no-wrap
4733msgid "Dir::Bin::bzip2 \"/bin/bzip2\";"
4734msgstr ""
4735
4736#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
4737#: apt.conf.5.xml:328
4738msgid ""
4739"Note that at run time the "
4740"<literal>Dir::Bin::<replaceable>Methodname</replaceable></literal> will be "
4741"checked: If this setting exists the method will only be used if this file "
4742"exists, e.g. for the bzip2 method (the inbuilt) setting is <placeholder "
4743"type=\"literallayout\" id=\"0\"/> Note also that list entries specified on "
4744"the commandline will be added at the end of the list specified in the "
4745"configuration files, but before the default entries. To prefer a type in "
4746"this case over the ones specified in in the configuration files you can set "
4747"the option direct - not in list style. This will not override the defined "
4748"list, it will only prefix the list with this type."
4749msgstr ""
4750
4751#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
4752#: apt.conf.5.xml:335
4753msgid ""
4754"While it is possible to add an empty compression type to the order list, but "
4755"APT in its current version doesn't understand it correctly and will display "
4756"many warnings about not downloaded files - these warnings are most of the "
4757"time false negatives. Future versions will maybe include a way to really "
4758"prefer uncompressed files to support the usage of local mirrors."
4759msgstr ""
4760
2a52e8c5 4761#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4762#: apt.conf.5.xml:174
2a52e8c5
DK
4763msgid ""
4764"The <literal>Acquire</literal> group of options controls the download of "
4765"packages and the URI handlers. <placeholder type=\"variablelist\" "
4766"id=\"0\"/>"
4767msgstr ""
4768
4769#. type: Content of: <refentry><refsect1><title>
bcf91c1b 4770#: apt.conf.5.xml:344
2a52e8c5
DK
4771msgid "Directories"
4772msgstr ""
4773
4774#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4775#: apt.conf.5.xml:346
2a52e8c5
DK
4776msgid ""
4777"The <literal>Dir::State</literal> section has directories that pertain to "
4778"local state information. <literal>lists</literal> is the directory to place "
4779"downloaded package lists in and <literal>status</literal> is the name of the "
4780"dpkg status file. <literal>preferences</literal> is the name of the APT "
4781"preferences file. <literal>Dir::State</literal> contains the default "
4782"directory to prefix on all sub items if they do not start with "
4783"<filename>/</filename> or <filename>./</filename>."
4784msgstr ""
4785
4786#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4787#: apt.conf.5.xml:353
2a52e8c5
DK
4788msgid ""
4789"<literal>Dir::Cache</literal> contains locations pertaining to local cache "
4790"information, such as the two package caches <literal>srcpkgcache</literal> "
4791"and <literal>pkgcache</literal> as well as the location to place downloaded "
4792"archives, <literal>Dir::Cache::archives</literal>. Generation of caches can "
4793"be turned off by setting their names to be blank. This will slow down "
4794"startup but save disk space. It is probably preferred to turn off the "
4795"pkgcache rather than the srcpkgcache. Like <literal>Dir::State</literal> the "
4796"default directory is contained in <literal>Dir::Cache</literal>"
4797msgstr ""
4798
4799#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4800#: apt.conf.5.xml:362
2a52e8c5
DK
4801msgid ""
4802"<literal>Dir::Etc</literal> contains the location of configuration files, "
4803"<literal>sourcelist</literal> gives the location of the sourcelist and "
4804"<literal>main</literal> is the default configuration file (setting has no "
4805"effect, unless it is done from the config file specified by "
4806"<envar>APT_CONFIG</envar>)."
4807msgstr ""
4808
4809#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4810#: apt.conf.5.xml:368
2a52e8c5
DK
4811msgid ""
4812"The <literal>Dir::Parts</literal> setting reads in all the config fragments "
4813"in lexical order from the directory specified. After this is done then the "
4814"main config file is loaded."
4815msgstr ""
4816
4817#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4818#: apt.conf.5.xml:372
2a52e8c5
DK
4819msgid ""
4820"Binary programs are pointed to by "
4821"<literal>Dir::Bin</literal>. <literal>Dir::Bin::Methods</literal> specifies "
4822"the location of the method handlers and <literal>gzip</literal>, "
bcf91c1b
DK
4823"<literal>bzip2</literal>, <literal>lzma</literal>, <literal>dpkg</literal>, "
4824"<literal>apt-get</literal> <literal>dpkg-source</literal> "
4825"<literal>dpkg-buildpackage</literal> and <literal>apt-cache</literal> "
4826"specify the location of the respective programs."
2a52e8c5
DK
4827msgstr ""
4828
4829#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4830#: apt.conf.5.xml:380
2a52e8c5
DK
4831msgid ""
4832"The configuration item <literal>RootDir</literal> has a special meaning. If "
4833"set, all paths in <literal>Dir::</literal> will be relative to "
4834"<literal>RootDir</literal>, <emphasis>even paths that are specified "
4835"absolutely</emphasis>. So, for instance, if <literal>RootDir</literal> is "
4836"set to <filename>/tmp/staging</filename> and "
4837"<literal>Dir::State::status</literal> is set to "
4838"<filename>/var/lib/dpkg/status</filename>, then the status file will be "
4839"looked up in <filename>/tmp/staging/var/lib/dpkg/status</filename>."
4840msgstr ""
4841
4842#. type: Content of: <refentry><refsect1><title>
bcf91c1b 4843#: apt.conf.5.xml:393
2a52e8c5
DK
4844msgid "APT in DSelect"
4845msgstr ""
4846
4847#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4848#: apt.conf.5.xml:395
2a52e8c5
DK
4849msgid ""
4850"When APT is used as a &dselect; method several configuration directives "
4851"control the default behaviour. These are in the <literal>DSelect</literal> "
4852"section."
4853msgstr ""
4854
4855#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4856#: apt.conf.5.xml:399
2a52e8c5
DK
4857msgid "Clean"
4858msgstr ""
4859
4860#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4861#: apt.conf.5.xml:400
2a52e8c5
DK
4862msgid ""
4863"Cache Clean mode; this value may be one of always, prompt, auto, pre-auto "
4864"and never. always and prompt will remove all packages from the cache after "
4865"upgrading, prompt (the default) does so conditionally. auto removes only "
4866"those packages which are no longer downloadable (replaced with a new version "
4867"for instance). pre-auto performs this action before downloading new "
4868"packages."
4869msgstr ""
4870
4871#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4872#: apt.conf.5.xml:409
2a52e8c5
DK
4873msgid ""
4874"The contents of this variable is passed to &apt-get; as command line options "
4875"when it is run for the install phase."
4876msgstr ""
4877
4878#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4879#: apt.conf.5.xml:413
2a52e8c5
DK
4880msgid "Updateoptions"
4881msgstr ""
4882
4883#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4884#: apt.conf.5.xml:414
2a52e8c5
DK
4885msgid ""
4886"The contents of this variable is passed to &apt-get; as command line options "
4887"when it is run for the update phase."
4888msgstr ""
4889
4890#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4891#: apt.conf.5.xml:418
2a52e8c5
DK
4892msgid "PromptAfterUpdate"
4893msgstr ""
4894
4895#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4896#: apt.conf.5.xml:419
2a52e8c5
DK
4897msgid ""
4898"If true the [U]pdate operation in &dselect; will always prompt to continue. "
4899"The default is to prompt only on error."
4900msgstr ""
4901
4902#. type: Content of: <refentry><refsect1><title>
bcf91c1b 4903#: apt.conf.5.xml:425
2a52e8c5
DK
4904msgid "How APT calls dpkg"
4905msgstr ""
4906
4907#. type: Content of: <refentry><refsect1><para>
bcf91c1b 4908#: apt.conf.5.xml:426
2a52e8c5
DK
4909msgid ""
4910"Several configuration directives control how APT invokes &dpkg;. These are "
4911"in the <literal>DPkg</literal> section."
4912msgstr ""
4913
4914#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4915#: apt.conf.5.xml:431
2a52e8c5
DK
4916msgid ""
4917"This is a list of options to pass to dpkg. The options must be specified "
4918"using the list notation and each list item is passed as a single argument to "
4919"&dpkg;."
4920msgstr ""
4921
4922#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4923#: apt.conf.5.xml:436
2a52e8c5
DK
4924msgid "Pre-Invoke"
4925msgstr ""
4926
4927#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4928#: apt.conf.5.xml:436
2a52e8c5
DK
4929msgid "Post-Invoke"
4930msgstr ""
4931
4932#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4933#: apt.conf.5.xml:437
2a52e8c5
DK
4934msgid ""
4935"This is a list of shell commands to run before/after invoking &dpkg;. Like "
4936"<literal>options</literal> this must be specified in list notation. The "
4937"commands are invoked in order using <filename>/bin/sh</filename>, should any "
4938"fail APT will abort."
4939msgstr ""
4940
4941#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4942#: apt.conf.5.xml:443
2a52e8c5
DK
4943msgid "Pre-Install-Pkgs"
4944msgstr ""
4945
4946#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4947#: apt.conf.5.xml:444
2a52e8c5
DK
4948msgid ""
4949"This is a list of shell commands to run before invoking dpkg. Like "
4950"<literal>options</literal> this must be specified in list notation. The "
4951"commands are invoked in order using <filename>/bin/sh</filename>, should any "
4952"fail APT will abort. APT will pass to the commands on standard input the "
4953"filenames of all .deb files it is going to install, one per line."
4954msgstr ""
4955
4956#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4957#: apt.conf.5.xml:450
2a52e8c5
DK
4958msgid ""
4959"Version 2 of this protocol dumps more information, including the protocol "
4960"version, the APT configuration space and the packages, files and versions "
4961"being changed. Version 2 is enabled by setting "
4962"<literal>DPkg::Tools::options::cmd::Version</literal> to "
4963"2. <literal>cmd</literal> is a command given to "
4964"<literal>Pre-Install-Pkgs</literal>."
4965msgstr ""
4966
4967#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4968#: apt.conf.5.xml:457
2a52e8c5
DK
4969msgid "Run-Directory"
4970msgstr ""
4971
4972#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4973#: apt.conf.5.xml:458
2a52e8c5
DK
4974msgid ""
4975"APT chdirs to this directory before invoking dpkg, the default is "
4976"<filename>/</filename>."
4977msgstr ""
4978
4979#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
bcf91c1b 4980#: apt.conf.5.xml:462
2a52e8c5
DK
4981msgid "Build-options"
4982msgstr ""
4983
4984#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
bcf91c1b 4985#: apt.conf.5.xml:463
2a52e8c5
DK
4986msgid ""
4987"These options are passed to &dpkg-buildpackage; when compiling packages, the "
4988"default is to disable signing and produce all binaries."
4989msgstr ""
4990
3e9c4f70
DK
4991#. type: Content of: <refentry><refsect1><refsect2><title>
4992#: apt.conf.5.xml:468
5e312de7 4993msgid "dpkg trigger usage (and related options)"
3e9c4f70
DK
4994msgstr ""
4995
4996#. type: Content of: <refentry><refsect1><refsect2><para>
4997#: apt.conf.5.xml:469
4998msgid ""
4999"APT can call dpkg in a way so it can make aggressive use of triggers over "
5000"multiply calls of dpkg. Without further options dpkg will use triggers only "
5e312de7 5001"in between his own run. Activating these options can therefore decrease the "
3e9c4f70
DK
5002"time needed to perform the install / upgrade. Note that it is intended to "
5003"activate these options per default in the future, but as it changes the way "
5e312de7 5004"APT calling dpkg drastical it needs a lot more testing. <emphasis>These "
3e9c4f70
DK
5005"options are therefore currently experimental and should not be used in "
5006"productive environments.</emphasis> Also it breaks the progress reporting so "
5007"all frontends will currently stay around half (or more) of the time in the "
5008"100% state while it actually configures all packages."
5009msgstr ""
5010
5011#. type: Content of: <refentry><refsect1><refsect2><para><literallayout>
5e312de7 5012#: apt.conf.5.xml:484
3e9c4f70
DK
5013#, no-wrap
5014msgid ""
5015"DPkg::NoTriggers \"true\";\n"
5e312de7
DK
5016"PackageManager::Configure \"smart\";\n"
5017"DPkg::ConfigurePending \"true\";\n"
d5081aee 5018"DPkg::TriggersPending \"true\";"
3e9c4f70
DK
5019msgstr ""
5020
5021#. type: Content of: <refentry><refsect1><refsect2><para>
5022#: apt.conf.5.xml:478
5023msgid ""
5e312de7
DK
5024"Note that it is not garanteed that APT will support these options or that "
5025"these options will not cause (big) trouble in the future. If you have "
5026"understand the current risks and problems with these options, but are brave "
5027"enough to help testing them create a new configuration file and test a "
5028"combination of options. Please report any bugs, problems and improvements "
5029"you encounter and make sure to note which options you have used in your "
3e9c4f70 5030"reports. Asking dpkg for help could also be useful for debugging proposes, "
5e312de7
DK
5031"see e.g. <command>dpkg --audit</command>. A defensive option combination "
5032"would be <placeholder type=\"literallayout\" id=\"0\"/>"
3e9c4f70
DK
5033msgstr ""
5034
5035#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
d5081aee 5036#: apt.conf.5.xml:490
5e312de7 5037msgid "DPkg::NoTriggers"
3e9c4f70
DK
5038msgstr ""
5039
5040#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
d5081aee 5041#: apt.conf.5.xml:491
3e9c4f70
DK
5042msgid ""
5043"Add the no triggers flag to all dpkg calls (expect the ConfigurePending "
5044"call). See &dpkg; if you are interested in what this actually means. In "
5045"short: dpkg will not run the triggers then this flag is present unless it is "
5046"explicit called to do so in an extra call. Note that this option exists "
5047"(undocumented) also in older apt versions with a slightly different meaning: "
5048"Previously these option only append --no-triggers to the configure calls to "
5049"dpkg - now apt will add these flag also to the unpack and remove calls."
5050msgstr ""
5051
5052#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
d5081aee 5053#: apt.conf.5.xml:498
5e312de7 5054msgid "PackageManager::Configure"
3e9c4f70
DK
5055msgstr ""
5056
5057#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
d5081aee 5058#: apt.conf.5.xml:499
5e312de7
DK
5059msgid ""
5060"Valid values are \"<literal>all</literal>\", \"<literal>smart</literal>\" "
5061"and \"<literal>no</literal>\". \"<literal>all</literal>\" is the default "
5062"value and causes APT to configure all packages explicit. The "
5063"\"<literal>smart</literal>\" way is it to configure only packages which need "
5064"to be configured before another package can be unpacked (Pre-Depends) and "
5065"let the rest configure by dpkg with a call generated by the next "
5066"option. \"<literal>no</literal>\" on the other hand will not configure "
5067"anything and totally relay on dpkg for configuration (which will at the "
5068"moment fail if a Pre-Depends is encountered). Setting this option to "
5069"another than the all value will implicit activate also the next option per "
5070"default as otherwise the system could end in an unconfigured status which "
5071"could be unbootable!"
3e9c4f70
DK
5072msgstr ""
5073
5074#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
d5081aee 5075#: apt.conf.5.xml:509
5e312de7 5076msgid "DPkg::ConfigurePending"
3e9c4f70
DK
5077msgstr ""
5078
5079#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
d5081aee 5080#: apt.conf.5.xml:510
3e9c4f70
DK
5081msgid ""
5082"If this option is set apt will call <command>dpkg --configure "
5083"--pending</command> to let dpkg handle all required configurations and "
5e312de7
DK
5084"triggers. This option is activated automatic per default if the previous "
5085"option is not set to <literal>all</literal>, but deactivating could be "
5086"useful if you want to run APT multiple times in a row - e.g. in an "
5087"installer. In this sceneries you could deactivate this option in all but the "
5088"last run."
5089msgstr ""
5090
5091#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
d5081aee 5092#: apt.conf.5.xml:516
5e312de7
DK
5093msgid "DPkg::TriggersPending"
5094msgstr ""
5095
5096#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
d5081aee 5097#: apt.conf.5.xml:517
5e312de7
DK
5098msgid ""
5099"Useful for <literal>smart</literal> configuration as a package which has "
d5081aee
DK
5100"pending triggers is not considered as \"<literal>installed</literal>\" and "
5101"dpkg treats them as \"<literal>unpacked</literal>\" currently which is a "
5102"dealbreaker for Pre-Dependencies (see also debbugs #526774). Note that this "
5103"will process all triggers, not only the triggers needed to configure this "
5104"package."
5e312de7
DK
5105msgstr ""
5106
5107#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
d5081aee 5108#: apt.conf.5.xml:522
5e312de7
DK
5109msgid "PackageManager::UnpackAll"
5110msgstr ""
5111
5112#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
d5081aee 5113#: apt.conf.5.xml:523
5e312de7
DK
5114msgid ""
5115"As the configuration can be deferred to be done at the end by dpkg it can be "
5116"tried to order the unpack series only by critical needs, e.g. by "
5117"Pre-Depends. Default is true and therefore the \"old\" method of ordering in "
5118"verious steps by everything. While both method were present in earlier APT "
5119"versions the <literal>OrderCritical</literal> method was unused, so this "
5120"method is very experimental and needs further improvements before becoming "
5121"really useful."
5122msgstr ""
5123
5124#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
d5081aee 5125#: apt.conf.5.xml:530
5e312de7
DK
5126msgid "OrderList::Score::Immediate"
5127msgstr ""
5128
5129#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para><literallayout>
d5081aee 5130#: apt.conf.5.xml:538
5e312de7
DK
5131#, no-wrap
5132msgid ""
5133"OrderList::Score {\n"
5134"\tDelete 500;\n"
5135"\tEssential 200;\n"
5136"\tImmediate 10;\n"
5137"\tPreDepends 50;\n"
5138"};"
5139msgstr ""
5140
5141#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
d5081aee 5142#: apt.conf.5.xml:531
5e312de7
DK
5143msgid ""
5144"Essential packages (and there dependencies) should be configured immediately "
5145"after unpacking. It will be a good idea to do this quite early in the "
5146"upgrade process as these these configure calls require currently also "
5147"<literal>DPkg::TriggersPending</literal> which will run quite a few triggers "
5148"(which maybe not needed). Essentials get per default a high score but the "
5149"immediate flag is relativly low (a package which has a Pre-Depends is higher "
5150"rated). These option and the others in the same group can be used to change "
5151"the scoring. The following example shows the settings with there default "
5152"values. <placeholder type=\"literallayout\" id=\"0\"/>"
3e9c4f70
DK
5153msgstr ""
5154
2a52e8c5 5155#. type: Content of: <refentry><refsect1><title>
d5081aee 5156#: apt.conf.5.xml:551
2a52e8c5
DK
5157msgid "Periodic and Archives options"
5158msgstr ""
5159
5160#. type: Content of: <refentry><refsect1><para>
d5081aee 5161#: apt.conf.5.xml:552
2a52e8c5
DK
5162msgid ""
5163"<literal>APT::Periodic</literal> and <literal>APT::Archives</literal> groups "
5164"of options configure behavior of apt periodic updates, which is done by "
5165"<literal>/etc/cron.daily/apt</literal> script. See header of this script for "
5166"the brief documentation of these options."
5167msgstr ""
5168
5169#. type: Content of: <refentry><refsect1><title>
d5081aee 5170#: apt.conf.5.xml:560
2a52e8c5
DK
5171msgid "Debug options"
5172msgstr ""
5173
5174#. type: Content of: <refentry><refsect1><para>
d5081aee 5175#: apt.conf.5.xml:562
2a52e8c5
DK
5176msgid ""
5177"Enabling options in the <literal>Debug::</literal> section will cause "
5178"debugging information to be sent to the standard error stream of the program "
5179"utilizing the <literal>apt</literal> libraries, or enable special program "
5180"modes that are primarily useful for debugging the behavior of "
5181"<literal>apt</literal>. Most of these options are not interesting to a "
5182"normal user, but a few may be:"
5183msgstr ""
5184
5185#. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
d5081aee 5186#: apt.conf.5.xml:573
2a52e8c5
DK
5187msgid ""
5188"<literal>Debug::pkgProblemResolver</literal> enables output about the "
5189"decisions made by <literal>dist-upgrade, upgrade, install, remove, "
5190"purge</literal>."
5191msgstr ""
5192
5193#. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
d5081aee 5194#: apt.conf.5.xml:581
2a52e8c5
DK
5195msgid ""
5196"<literal>Debug::NoLocking</literal> disables all file locking. This can be "
5197"used to run some operations (for instance, <literal>apt-get -s "
5198"install</literal>) as a non-root user."
5199msgstr ""
5200
5201#. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
d5081aee 5202#: apt.conf.5.xml:590
2a52e8c5
DK
5203msgid ""
5204"<literal>Debug::pkgDPkgPM</literal> prints out the actual command line each "
5205"time that <literal>apt</literal> invokes &dpkg;."
5206msgstr ""
5207
5208#. TODO: provide a
5209#. motivating example, except I haven't a clue why you'd want
5210#. to do this.
5211#. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
d5081aee 5212#: apt.conf.5.xml:598
2a52e8c5
DK
5213msgid ""
5214"<literal>Debug::IdentCdrom</literal> disables the inclusion of statfs data "
5215"in CDROM IDs."
5216msgstr ""
5217
5218#. type: Content of: <refentry><refsect1><para>
d5081aee 5219#: apt.conf.5.xml:608
2a52e8c5
DK
5220msgid "A full list of debugging options to apt follows."
5221msgstr ""
5222
5223#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5224#: apt.conf.5.xml:613
2a52e8c5
DK
5225msgid "<literal>Debug::Acquire::cdrom</literal>"
5226msgstr ""
5227
5228#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5229#: apt.conf.5.xml:617
2a52e8c5
DK
5230msgid "Print information related to accessing <literal>cdrom://</literal> sources."
5231msgstr ""
5232
5233#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5234#: apt.conf.5.xml:624
2a52e8c5
DK
5235msgid "<literal>Debug::Acquire::ftp</literal>"
5236msgstr ""
5237
5238#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5239#: apt.conf.5.xml:628
2a52e8c5
DK
5240msgid "Print information related to downloading packages using FTP."
5241msgstr ""
5242
5243#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5244#: apt.conf.5.xml:635
2a52e8c5
DK
5245msgid "<literal>Debug::Acquire::http</literal>"
5246msgstr ""
5247
5248#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5249#: apt.conf.5.xml:639
2a52e8c5
DK
5250msgid "Print information related to downloading packages using HTTP."
5251msgstr ""
5252
5253#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5254#: apt.conf.5.xml:646
2a52e8c5
DK
5255msgid "<literal>Debug::Acquire::https</literal>"
5256msgstr ""
5257
5258#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5259#: apt.conf.5.xml:650
2a52e8c5
DK
5260msgid "Print information related to downloading packages using HTTPS."
5261msgstr ""
5262
5263#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5264#: apt.conf.5.xml:657
2a52e8c5
DK
5265msgid "<literal>Debug::Acquire::gpgv</literal>"
5266msgstr ""
5267
5268#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5269#: apt.conf.5.xml:661
2a52e8c5
DK
5270msgid ""
5271"Print information related to verifying cryptographic signatures using "
5272"<literal>gpg</literal>."
5273msgstr ""
5274
5275#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5276#: apt.conf.5.xml:668
2a52e8c5
DK
5277msgid "<literal>Debug::aptcdrom</literal>"
5278msgstr ""
5279
5280#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5281#: apt.conf.5.xml:672
2a52e8c5
DK
5282msgid ""
5283"Output information about the process of accessing collections of packages "
5284"stored on CD-ROMs."
5285msgstr ""
5286
5287#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5288#: apt.conf.5.xml:679
2a52e8c5
DK
5289msgid "<literal>Debug::BuildDeps</literal>"
5290msgstr ""
5291
5292#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5293#: apt.conf.5.xml:682
2a52e8c5
DK
5294msgid "Describes the process of resolving build-dependencies in &apt-get;."
5295msgstr ""
5296
5297#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5298#: apt.conf.5.xml:689
2a52e8c5
DK
5299msgid "<literal>Debug::Hashes</literal>"
5300msgstr ""
5301
5302#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5303#: apt.conf.5.xml:692
2a52e8c5
DK
5304msgid ""
5305"Output each cryptographic hash that is generated by the "
5306"<literal>apt</literal> libraries."
5307msgstr ""
5308
5309#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5310#: apt.conf.5.xml:699
2a52e8c5
DK
5311msgid "<literal>Debug::IdentCDROM</literal>"
5312msgstr ""
5313
5314#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5315#: apt.conf.5.xml:702
2a52e8c5
DK
5316msgid ""
5317"Do not include information from <literal>statfs</literal>, namely the number "
5318"of used and free blocks on the CD-ROM filesystem, when generating an ID for "
5319"a CD-ROM."
5320msgstr ""
5321
5322#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5323#: apt.conf.5.xml:710
2a52e8c5
DK
5324msgid "<literal>Debug::NoLocking</literal>"
5325msgstr ""
5326
5327#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5328#: apt.conf.5.xml:713
2a52e8c5
DK
5329msgid ""
5330"Disable all file locking. For instance, this will allow two instances of "
5331"<quote><literal>apt-get update</literal></quote> to run at the same time."
5332msgstr ""
5333
5334#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5335#: apt.conf.5.xml:721
2a52e8c5
DK
5336msgid "<literal>Debug::pkgAcquire</literal>"
5337msgstr ""
5338
5339#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5340#: apt.conf.5.xml:725
2a52e8c5
DK
5341msgid "Log when items are added to or removed from the global download queue."
5342msgstr ""
5343
5344#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5345#: apt.conf.5.xml:732
2a52e8c5
DK
5346msgid "<literal>Debug::pkgAcquire::Auth</literal>"
5347msgstr ""
5348
5349#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5350#: apt.conf.5.xml:735
2a52e8c5
DK
5351msgid ""
5352"Output status messages and errors related to verifying checksums and "
5353"cryptographic signatures of downloaded files."
5354msgstr ""
5355
5356#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5357#: apt.conf.5.xml:742
2a52e8c5
DK
5358msgid "<literal>Debug::pkgAcquire::Diffs</literal>"
5359msgstr ""
5360
5361#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5362#: apt.conf.5.xml:745
2a52e8c5
DK
5363msgid ""
5364"Output information about downloading and applying package index list diffs, "
5365"and errors relating to package index list diffs."
5366msgstr ""
5367
5368#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5369#: apt.conf.5.xml:753
2a52e8c5
DK
5370msgid "<literal>Debug::pkgAcquire::RRed</literal>"
5371msgstr ""
5372
5373#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5374#: apt.conf.5.xml:757
2a52e8c5
DK
5375msgid ""
5376"Output information related to patching apt package lists when downloading "
5377"index diffs instead of full indices."
5378msgstr ""
5379
5380#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5381#: apt.conf.5.xml:764
2a52e8c5
DK
5382msgid "<literal>Debug::pkgAcquire::Worker</literal>"
5383msgstr ""
5384
5385#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5386#: apt.conf.5.xml:768
2a52e8c5
DK
5387msgid "Log all interactions with the sub-processes that actually perform downloads."
5388msgstr ""
5389
5390#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5391#: apt.conf.5.xml:775
2a52e8c5
DK
5392msgid "<literal>Debug::pkgAutoRemove</literal>"
5393msgstr ""
5394
5395#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5396#: apt.conf.5.xml:779
2a52e8c5
DK
5397msgid ""
5398"Log events related to the automatically-installed status of packages and to "
5399"the removal of unused packages."
5400msgstr ""
5401
5402#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5403#: apt.conf.5.xml:786
2a52e8c5
DK
5404msgid "<literal>Debug::pkgDepCache::AutoInstall</literal>"
5405msgstr ""
5406
5407#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5408#: apt.conf.5.xml:789
2a52e8c5
DK
5409msgid ""
5410"Generate debug messages describing which packages are being automatically "
5411"installed to resolve dependencies. This corresponds to the initial "
5412"auto-install pass performed in, e.g., <literal>apt-get install</literal>, "
5413"and not to the full <literal>apt</literal> dependency resolver; see "
5414"<literal>Debug::pkgProblemResolver</literal> for that."
5415msgstr ""
5416
5417#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5418#: apt.conf.5.xml:800
2a52e8c5
DK
5419msgid "<literal>Debug::pkgDepCache::Marker</literal>"
5420msgstr ""
5421
5422#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5423#: apt.conf.5.xml:803
2a52e8c5
DK
5424msgid ""
5425"Generate debug messages describing which package is marked as "
5426"keep/install/remove while the ProblemResolver does his work. Each addition "
5427"or deletion may trigger additional actions; they are shown indented two "
5428"additional space under the original entry. The format for each line is "
5429"<literal>MarkKeep</literal>, <literal>MarkDelete</literal> or "
5430"<literal>MarkInstall</literal> followed by <literal>package-name &lt;a.b.c "
5431"-&gt; d.e.f | x.y.z&gt; (section)</literal> where <literal>a.b.c</literal> "
5432"is the current version of the package, <literal>d.e.f</literal> is the "
5433"version considered for installation and <literal>x.y.z</literal> is a newer "
5434"version, but not considered for installation (because of a low pin "
5435"score). The later two can be omitted if there is none or if it is the same "
5436"version as the installed. <literal>section</literal> is the name of the "
5437"section the package appears in."
5438msgstr ""
5439
5440#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5441#: apt.conf.5.xml:822
2a52e8c5
DK
5442msgid "<literal>Debug::pkgInitConfig</literal>"
5443msgstr ""
5444
5445#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5446#: apt.conf.5.xml:825
2a52e8c5
DK
5447msgid "Dump the default configuration to standard error on startup."
5448msgstr ""
5449
5450#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5451#: apt.conf.5.xml:832
2a52e8c5
DK
5452msgid "<literal>Debug::pkgDPkgPM</literal>"
5453msgstr ""
5454
5455#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5456#: apt.conf.5.xml:835
2a52e8c5
DK
5457msgid ""
5458"When invoking &dpkg;, output the precise command line with which it is being "
5459"invoked, with arguments separated by a single space character."
5460msgstr ""
5461
5462#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5463#: apt.conf.5.xml:843
2a52e8c5
DK
5464msgid "<literal>Debug::pkgDPkgProgressReporting</literal>"
5465msgstr ""
5466
5467#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5468#: apt.conf.5.xml:846
2a52e8c5
DK
5469msgid ""
5470"Output all the data received from &dpkg; on the status file descriptor and "
5471"any errors encountered while parsing it."
5472msgstr ""
5473
5474#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5475#: apt.conf.5.xml:853
2a52e8c5
DK
5476msgid "<literal>Debug::pkgOrderList</literal>"
5477msgstr ""
5478
5479#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5480#: apt.conf.5.xml:857
2a52e8c5
DK
5481msgid ""
5482"Generate a trace of the algorithm that decides the order in which "
5483"<literal>apt</literal> should pass packages to &dpkg;."
5484msgstr ""
5485
5486#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5487#: apt.conf.5.xml:865
2a52e8c5
DK
5488msgid "<literal>Debug::pkgPackageManager</literal>"
5489msgstr ""
5490
5491#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5492#: apt.conf.5.xml:869
2a52e8c5
DK
5493msgid "Output status messages tracing the steps performed when invoking &dpkg;."
5494msgstr ""
5495
5496#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5497#: apt.conf.5.xml:876
2a52e8c5
DK
5498msgid "<literal>Debug::pkgPolicy</literal>"
5499msgstr ""
5500
5501#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5502#: apt.conf.5.xml:880
2a52e8c5
DK
5503msgid "Output the priority of each package list on startup."
5504msgstr ""
5505
5506#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5507#: apt.conf.5.xml:886
2a52e8c5
DK
5508msgid "<literal>Debug::pkgProblemResolver</literal>"
5509msgstr ""
5510
5511#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5512#: apt.conf.5.xml:890
2a52e8c5
DK
5513msgid ""
5514"Trace the execution of the dependency resolver (this applies only to what "
5515"happens when a complex dependency problem is encountered)."
5516msgstr ""
5517
5518#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5519#: apt.conf.5.xml:898
2a52e8c5
DK
5520msgid "<literal>Debug::pkgProblemResolver::ShowScores</literal>"
5521msgstr ""
5522
5523#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5524#: apt.conf.5.xml:901
2a52e8c5
DK
5525msgid ""
5526"Display a list of all installed packages with their calculated score used by "
5527"the pkgProblemResolver. The description of the package is the same as "
5528"described in <literal>Debug::pkgDepCache::Marker</literal>"
5529msgstr ""
5530
5531#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
d5081aee 5532#: apt.conf.5.xml:909
2a52e8c5
DK
5533msgid "<literal>Debug::sourceList</literal>"
5534msgstr ""
5535
5536#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
d5081aee 5537#: apt.conf.5.xml:913
2a52e8c5
DK
5538msgid ""
5539"Print information about the vendors read from "
5540"<filename>/etc/apt/vendors.list</filename>."
5541msgstr ""
5542
5543#. type: Content of: <refentry><refsect1><para>
d5081aee 5544#: apt.conf.5.xml:935
2a52e8c5
DK
5545msgid ""
5546"&configureindex; is a configuration file showing example values for all "
5547"possible options."
5548msgstr ""
5549
bcf91c1b 5550#. type: Content of: <refentry><refsect1><variablelist>
d5081aee 5551#: apt.conf.5.xml:942
bcf91c1b
DK
5552msgid "&file-aptconf;"
5553msgstr ""
5554
2a52e8c5
DK
5555#. ? reading apt.conf
5556#. type: Content of: <refentry><refsect1><para>
d5081aee 5557#: apt.conf.5.xml:947
2a52e8c5
DK
5558msgid "&apt-cache;, &apt-config;, &apt-preferences;."
5559msgstr ""
5560
5561#. The last update date
5562#. type: Content of: <refentry><refentryinfo>
5563#: apt_preferences.5.xml:13
5564msgid "&apt-author.team; &apt-email; &apt-product; <date>04 May 2009</date>"
5565msgstr ""
5566
5567#. type: Content of: <refentry><refnamediv><refname>
bcf91c1b 5568#: apt_preferences.5.xml:21 apt_preferences.5.xml:28
2a52e8c5
DK
5569msgid "apt_preferences"
5570msgstr ""
5571
5572#. type: Content of: <refentry><refnamediv><refpurpose>
bcf91c1b 5573#: apt_preferences.5.xml:29
2a52e8c5
DK
5574msgid "Preference control file for APT"
5575msgstr ""
5576
5577#. type: Content of: <refentry><refsect1><para>
bcf91c1b 5578#: apt_preferences.5.xml:34
2a52e8c5 5579msgid ""
bcf91c1b
DK
5580"The APT preferences file <filename>/etc/apt/preferences</filename> and the "
5581"fragment files in the <filename>/etc/apt/preferences.d/</filename> folder "
5582"can be used to control which versions of packages will be selected for "
2a52e8c5
DK
5583"installation."
5584msgstr ""
5585
5586#. type: Content of: <refentry><refsect1><para>
bcf91c1b 5587#: apt_preferences.5.xml:39
2a52e8c5
DK
5588msgid ""
5589"Several versions of a package may be available for installation when the "
5590"&sources-list; file contains references to more than one distribution (for "
5591"example, <literal>stable</literal> and <literal>testing</literal>). APT "
5592"assigns a priority to each version that is available. Subject to dependency "
5593"constraints, <command>apt-get</command> selects the version with the highest "
5594"priority for installation. The APT preferences file overrides the "
5595"priorities that APT assigns to package versions by default, thus giving the "
5596"user control over which one is selected for installation."
5597msgstr ""
5598
5599#. type: Content of: <refentry><refsect1><para>
bcf91c1b 5600#: apt_preferences.5.xml:49
2a52e8c5
DK
5601msgid ""
5602"Several instances of the same version of a package may be available when the "
5603"&sources-list; file contains references to more than one source. In this "
5604"case <command>apt-get</command> downloads the instance listed earliest in "
5605"the &sources-list; file. The APT preferences file does not affect the "
5606"choice of instance, only the choice of version."
5607msgstr ""
5608
5609#. type: Content of: <refentry><refsect1><refsect2><title>
bcf91c1b 5610#: apt_preferences.5.xml:56
2a52e8c5
DK
5611msgid "APT's Default Priority Assignments"
5612msgstr ""
5613
5614#. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
bcf91c1b 5615#: apt_preferences.5.xml:71
2a52e8c5
DK
5616#, no-wrap
5617msgid ""
5618"<command>apt-get install -t testing "
5619"<replaceable>some-package</replaceable></command>\n"
5620msgstr ""
5621
5622#. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
bcf91c1b 5623#: apt_preferences.5.xml:74
2a52e8c5
DK
5624#, no-wrap
5625msgid "APT::Default-Release \"stable\";\n"
5626msgstr ""
5627
5628#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 5629#: apt_preferences.5.xml:58
2a52e8c5
DK
5630msgid ""
5631"If there is no preferences file or if there is no entry in the file that "
5632"applies to a particular version then the priority assigned to that version "
5633"is the priority of the distribution to which that version belongs. It is "
5634"possible to single out a distribution, \"the target release\", which "
5635"receives a higher priority than other distributions do by default. The "
5636"target release can be set on the <command>apt-get</command> command line or "
5637"in the APT configuration file <filename>/etc/apt/apt.conf</filename>. Note "
5638"that this has precedence over any general priority you set in the "
5639"<filename>/etc/apt/preferences</filename> file described later, but not over "
5640"specifically pinned packages. For example, <placeholder "
5641"type=\"programlisting\" id=\"0\"/> <placeholder type=\"programlisting\" "
5642"id=\"1\"/>"
5643msgstr ""
5644
5645#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
bcf91c1b 5646#: apt_preferences.5.xml:83
2a52e8c5
DK
5647msgid "priority 100"
5648msgstr ""
5649
5650#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
bcf91c1b 5651#: apt_preferences.5.xml:84
2a52e8c5
DK
5652msgid "to the version that is already installed (if any)."
5653msgstr ""
5654
5655#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
bcf91c1b 5656#: apt_preferences.5.xml:88
2a52e8c5
DK
5657msgid "priority 500"
5658msgstr ""
5659
5660#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
bcf91c1b 5661#: apt_preferences.5.xml:89
2a52e8c5
DK
5662msgid ""
5663"to the versions that are not installed and do not belong to the target "
5664"release."
5665msgstr ""
5666
5667#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
bcf91c1b 5668#: apt_preferences.5.xml:93
2a52e8c5
DK
5669msgid "priority 990"
5670msgstr ""
5671
5672#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
bcf91c1b 5673#: apt_preferences.5.xml:94
2a52e8c5
DK
5674msgid "to the versions that are not installed and belong to the target release."
5675msgstr ""
5676
5677#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 5678#: apt_preferences.5.xml:78
2a52e8c5
DK
5679msgid ""
5680"If the target release has been specified then APT uses the following "
5681"algorithm to set the priorities of the versions of a package. Assign: "
5682"<placeholder type=\"variablelist\" id=\"0\"/>"
5683msgstr ""
5684
5685#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 5686#: apt_preferences.5.xml:99
2a52e8c5
DK
5687msgid ""
5688"If the target release has not been specified then APT simply assigns "
5689"priority 100 to all installed package versions and priority 500 to all "
5690"uninstalled package versions."
5691msgstr ""
5692
5693#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 5694#: apt_preferences.5.xml:103
2a52e8c5
DK
5695msgid ""
5696"APT then applies the following rules, listed in order of precedence, to "
5697"determine which version of a package to install."
5698msgstr ""
5699
5700#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
bcf91c1b 5701#: apt_preferences.5.xml:106
2a52e8c5
DK
5702msgid ""
5703"Never downgrade unless the priority of an available version exceeds 1000. "
5704"(\"Downgrading\" is installing a less recent version of a package in place "
5705"of a more recent version. Note that none of APT's default priorities "
5706"exceeds 1000; such high priorities can only be set in the preferences file. "
5707"Note also that downgrading a package can be risky.)"
5708msgstr ""
5709
5710#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
bcf91c1b 5711#: apt_preferences.5.xml:112
2a52e8c5
DK
5712msgid "Install the highest priority version."
5713msgstr ""
5714
5715#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
bcf91c1b 5716#: apt_preferences.5.xml:113
2a52e8c5
DK
5717msgid ""
5718"If two or more versions have the same priority, install the most recent one "
5719"(that is, the one with the higher version number)."
5720msgstr ""
5721
5722#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
bcf91c1b 5723#: apt_preferences.5.xml:116
2a52e8c5
DK
5724msgid ""
5725"If two or more versions have the same priority and version number but either "
5726"the packages differ in some of their metadata or the "
5727"<literal>--reinstall</literal> option is given, install the uninstalled one."
5728msgstr ""
5729
5730#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 5731#: apt_preferences.5.xml:122
2a52e8c5
DK
5732msgid ""
5733"In a typical situation, the installed version of a package (priority 100) "
5734"is not as recent as one of the versions available from the sources listed in "
5735"the &sources-list; file (priority 500 or 990). Then the package will be "
5736"upgraded when <command>apt-get install "
5737"<replaceable>some-package</replaceable></command> or <command>apt-get "
5738"upgrade</command> is executed."
5739msgstr ""
5740
5741#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 5742#: apt_preferences.5.xml:129
2a52e8c5
DK
5743msgid ""
5744"More rarely, the installed version of a package is <emphasis>more</emphasis> "
5745"recent than any of the other available versions. The package will not be "
5746"downgraded when <command>apt-get install "
5747"<replaceable>some-package</replaceable></command> or <command>apt-get "
5748"upgrade</command> is executed."
5749msgstr ""
5750
5751#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 5752#: apt_preferences.5.xml:134
2a52e8c5
DK
5753msgid ""
5754"Sometimes the installed version of a package is more recent than the version "
5755"belonging to the target release, but not as recent as a version belonging to "
5756"some other distribution. Such a package will indeed be upgraded when "
5757"<command>apt-get install <replaceable>some-package</replaceable></command> "
5758"or <command>apt-get upgrade</command> is executed, because at least "
5759"<emphasis>one</emphasis> of the available versions has a higher priority "
5760"than the installed version."
5761msgstr ""
5762
5763#. type: Content of: <refentry><refsect1><refsect2><title>
bcf91c1b 5764#: apt_preferences.5.xml:143
2a52e8c5
DK
5765msgid "The Effect of APT Preferences"
5766msgstr ""
5767
5768#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 5769#: apt_preferences.5.xml:145
2a52e8c5
DK
5770msgid ""
5771"The APT preferences file allows the system administrator to control the "
5772"assignment of priorities. The file consists of one or more multi-line "
5773"records separated by blank lines. Records can have one of two forms, a "
5774"specific form and a general form."
5775msgstr ""
5776
5777#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
bcf91c1b 5778#: apt_preferences.5.xml:151
2a52e8c5
DK
5779msgid ""
5780"The specific form assigns a priority (a \"Pin-Priority\") to one or more "
5781"specified packages and specified version or version range. For example, the "
5782"following record assigns a high priority to all versions of the "
5783"<filename>perl</filename> package whose version number begins with "
5784"\"<literal>5.8</literal>\". Multiple packages can be separated by spaces."
5785msgstr ""
5786
5787#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
bcf91c1b 5788#: apt_preferences.5.xml:158
2a52e8c5
DK
5789#, no-wrap
5790msgid ""
5791"Package: perl\n"
5792"Pin: version 5.8*\n"
5793"Pin-Priority: 1001\n"
5794msgstr ""
5795
5796#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
bcf91c1b 5797#: apt_preferences.5.xml:164
2a52e8c5
DK
5798msgid ""
5799"The general form assigns a priority to all of the package versions in a "
5800"given distribution (that is, to all the versions of packages that are listed "
5801"in a certain <filename>Release</filename> file) or to all of the package "
5802"versions coming from a particular Internet site, as identified by the site's "
5803"fully qualified domain name."
5804msgstr ""
5805
5806#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
bcf91c1b 5807#: apt_preferences.5.xml:170
2a52e8c5
DK
5808msgid ""
5809"This general-form entry in the APT preferences file applies only to groups "
5810"of packages. For example, the following record assigns a high priority to "
5811"all package versions available from the local site."
5812msgstr ""
5813
5814#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
bcf91c1b 5815#: apt_preferences.5.xml:175
2a52e8c5
DK
5816#, no-wrap
5817msgid ""
5818"Package: *\n"
5819"Pin: origin \"\"\n"
5820"Pin-Priority: 999\n"
5821msgstr ""
5822
5823#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
bcf91c1b 5824#: apt_preferences.5.xml:180
2a52e8c5
DK
5825msgid ""
5826"A note of caution: the keyword used here is \"<literal>origin</literal>\". "
5827"This should not be confused with the Origin of a distribution as specified "
5828"in a <filename>Release</filename> file. What follows the \"Origin:\" tag in "
5829"a <filename>Release</filename> file is not an Internet address but an author "
5830"or vendor name, such as \"Debian\" or \"Ximian\"."
5831msgstr ""
5832
5833#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
bcf91c1b 5834#: apt_preferences.5.xml:186
2a52e8c5
DK
5835msgid ""
5836"The following record assigns a low priority to all package versions "
5837"belonging to any distribution whose Archive name is "
5838"\"<literal>unstable</literal>\"."
5839msgstr ""
5840
5841#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
bcf91c1b 5842#: apt_preferences.5.xml:190
2a52e8c5
DK
5843#, no-wrap
5844msgid ""
5845"Package: *\n"
5846"Pin: release a=unstable\n"
5847"Pin-Priority: 50\n"
5848msgstr ""
5849
5850#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
bcf91c1b 5851#: apt_preferences.5.xml:195
2a52e8c5
DK
5852msgid ""
5853"The following record assigns a high priority to all package versions "
5854"belonging to any distribution whose Codename is "
5855"\"<literal>squeeze</literal>\"."
5856msgstr ""
5857
5858#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
bcf91c1b 5859#: apt_preferences.5.xml:199
2a52e8c5
DK
5860#, no-wrap
5861msgid ""
5862"Package: *\n"
5863"Pin: release n=squeeze\n"
5864"Pin-Priority: 900\n"
5865msgstr ""
5866
5867#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
bcf91c1b 5868#: apt_preferences.5.xml:204
2a52e8c5
DK
5869msgid ""
5870"The following record assigns a high priority to all package versions "
5871"belonging to any release whose Archive name is \"<literal>stable</literal>\" "
5872"and whose release Version number is \"<literal>3.0</literal>\"."
5873msgstr ""
5874
5875#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
bcf91c1b 5876#: apt_preferences.5.xml:209
2a52e8c5
DK
5877#, no-wrap
5878msgid ""
5879"Package: *\n"
5880"Pin: release a=stable, v=3.0\n"
5881"Pin-Priority: 500\n"
5882msgstr ""
5883
5884#. type: Content of: <refentry><refsect1><refsect2><title>
bcf91c1b 5885#: apt_preferences.5.xml:220
2a52e8c5
DK
5886msgid "How APT Interprets Priorities"
5887msgstr ""
5888
5889#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
bcf91c1b 5890#: apt_preferences.5.xml:228
2a52e8c5
DK
5891msgid "P &gt; 1000"
5892msgstr ""
5893
5894#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
bcf91c1b 5895#: apt_preferences.5.xml:229
2a52e8c5
DK
5896msgid ""
5897"causes a version to be installed even if this constitutes a downgrade of the "
5898"package"
5899msgstr ""
5900
5901#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
bcf91c1b 5902#: apt_preferences.5.xml:233
2a52e8c5
DK
5903msgid "990 &lt; P &lt;=1000"
5904msgstr ""
5905
5906#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
bcf91c1b 5907#: apt_preferences.5.xml:234
2a52e8c5
DK
5908msgid ""
5909"causes a version to be installed even if it does not come from the target "
5910"release, unless the installed version is more recent"
5911msgstr ""
5912
5913#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
bcf91c1b 5914#: apt_preferences.5.xml:239
2a52e8c5
DK
5915msgid "500 &lt; P &lt;=990"
5916msgstr ""
5917
5918#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
bcf91c1b 5919#: apt_preferences.5.xml:240
2a52e8c5
DK
5920msgid ""
5921"causes a version to be installed unless there is a version available "
5922"belonging to the target release or the installed version is more recent"
5923msgstr ""
5924
5925#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
bcf91c1b 5926#: apt_preferences.5.xml:245
2a52e8c5
DK
5927msgid "100 &lt; P &lt;=500"
5928msgstr ""
5929
5930#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
bcf91c1b 5931#: apt_preferences.5.xml:246
2a52e8c5
DK
5932msgid ""
5933"causes a version to be installed unless there is a version available "
5934"belonging to some other distribution or the installed version is more recent"
5935msgstr ""
5936
5937#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
bcf91c1b 5938#: apt_preferences.5.xml:251
2a52e8c5
DK
5939msgid "0 &lt; P &lt;=100"
5940msgstr ""
5941
5942#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
bcf91c1b 5943#: apt_preferences.5.xml:252
2a52e8c5
DK
5944msgid ""
5945"causes a version to be installed only if there is no installed version of "
5946"the package"
5947msgstr ""
5948
5949#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
bcf91c1b 5950#: apt_preferences.5.xml:256
2a52e8c5
DK
5951msgid "P &lt; 0"
5952msgstr ""
5953
5954#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
bcf91c1b 5955#: apt_preferences.5.xml:257
2a52e8c5
DK
5956msgid "prevents the version from being installed"
5957msgstr ""
5958
5959#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 5960#: apt_preferences.5.xml:223
2a52e8c5
DK
5961msgid ""
5962"Priorities (P) assigned in the APT preferences file must be positive or "
5963"negative integers. They are interpreted as follows (roughly speaking): "
5964"<placeholder type=\"variablelist\" id=\"0\"/>"
5965msgstr ""
5966
5967#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 5968#: apt_preferences.5.xml:262
2a52e8c5
DK
5969msgid ""
5970"If any specific-form records match an available package version then the "
5971"first such record determines the priority of the package version. Failing "
5972"that, if any general-form records match an available package version then "
5973"the first such record determines the priority of the package version."
5974msgstr ""
5975
5976#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 5977#: apt_preferences.5.xml:268
2a52e8c5
DK
5978msgid ""
5979"For example, suppose the APT preferences file contains the three records "
5980"presented earlier:"
5981msgstr ""
5982
5983#. type: Content of: <refentry><refsect1><refsect2><programlisting>
bcf91c1b 5984#: apt_preferences.5.xml:272
2a52e8c5
DK
5985#, no-wrap
5986msgid ""
5987"Package: perl\n"
5988"Pin: version 5.8*\n"
5989"Pin-Priority: 1001\n"
5990"\n"
5991"Package: *\n"
5992"Pin: origin \"\"\n"
5993"Pin-Priority: 999\n"
5994"\n"
5995"Package: *\n"
5996"Pin: release unstable\n"
5997"Pin-Priority: 50\n"
5998msgstr ""
5999
6000#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 6001#: apt_preferences.5.xml:285
2a52e8c5
DK
6002msgid "Then:"
6003msgstr ""
6004
6005#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
bcf91c1b 6006#: apt_preferences.5.xml:287
2a52e8c5
DK
6007msgid ""
6008"The most recent available version of the <literal>perl</literal> package "
6009"will be installed, so long as that version's version number begins with "
6010"\"<literal>5.8</literal>\". If <emphasis>any</emphasis> 5.8* version of "
6011"<literal>perl</literal> is available and the installed version is 5.9*, then "
6012"<literal>perl</literal> will be downgraded."
6013msgstr ""
6014
6015#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
bcf91c1b 6016#: apt_preferences.5.xml:292
2a52e8c5
DK
6017msgid ""
6018"A version of any package other than <literal>perl</literal> that is "
6019"available from the local system has priority over other versions, even "
6020"versions belonging to the target release."
6021msgstr ""
6022
6023#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
bcf91c1b 6024#: apt_preferences.5.xml:296
2a52e8c5
DK
6025msgid ""
6026"A version of a package whose origin is not the local system but some other "
6027"site listed in &sources-list; and which belongs to an "
6028"<literal>unstable</literal> distribution is only installed if it is selected "
6029"for installation and no version of the package is already installed."
6030msgstr ""
6031
6032#. type: Content of: <refentry><refsect1><refsect2><title>
bcf91c1b 6033#: apt_preferences.5.xml:306
2a52e8c5
DK
6034msgid "Determination of Package Version and Distribution Properties"
6035msgstr ""
6036
6037#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 6038#: apt_preferences.5.xml:308
2a52e8c5
DK
6039msgid ""
6040"The locations listed in the &sources-list; file should provide "
6041"<filename>Packages</filename> and <filename>Release</filename> files to "
6042"describe the packages available at that location."
6043msgstr ""
6044
6045#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
bcf91c1b 6046#: apt_preferences.5.xml:320
2a52e8c5
DK
6047msgid "the <literal>Package:</literal> line"
6048msgstr ""
6049
6050#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
bcf91c1b 6051#: apt_preferences.5.xml:321
2a52e8c5
DK
6052msgid "gives the package name"
6053msgstr ""
6054
6055#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
bcf91c1b 6056#: apt_preferences.5.xml:324 apt_preferences.5.xml:374
2a52e8c5
DK
6057msgid "the <literal>Version:</literal> line"
6058msgstr ""
6059
6060#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
bcf91c1b 6061#: apt_preferences.5.xml:325
2a52e8c5
DK
6062msgid "gives the version number for the named package"
6063msgstr ""
6064
6065#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 6066#: apt_preferences.5.xml:312
2a52e8c5
DK
6067msgid ""
6068"The <filename>Packages</filename> file is normally found in the directory "
6069"<filename>.../dists/<replaceable>dist-name</replaceable>/<replaceable>component</replaceable>/<replaceable>arch</replaceable></filename>: "
6070"for example, "
6071"<filename>.../dists/stable/main/binary-i386/Packages</filename>. It "
6072"consists of a series of multi-line records, one for each package available "
6073"in that directory. Only two lines in each record are relevant for setting "
6074"APT priorities: <placeholder type=\"variablelist\" id=\"0\"/>"
6075msgstr ""
6076
6077#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
bcf91c1b 6078#: apt_preferences.5.xml:341
2a52e8c5
DK
6079msgid "the <literal>Archive:</literal> or <literal>Suite:</literal> line"
6080msgstr ""
6081
6082#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
bcf91c1b 6083#: apt_preferences.5.xml:342
2a52e8c5
DK
6084msgid ""
6085"names the archive to which all the packages in the directory tree belong. "
6086"For example, the line \"Archive: stable\" or \"Suite: stable\" specifies "
6087"that all of the packages in the directory tree below the parent of the "
6088"<filename>Release</filename> file are in a <literal>stable</literal> "
6089"archive. Specifying this value in the APT preferences file would require "
6090"the line:"
6091msgstr ""
6092
6093#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
bcf91c1b 6094#: apt_preferences.5.xml:352
2a52e8c5
DK
6095#, no-wrap
6096msgid "Pin: release a=stable\n"
6097msgstr ""
6098
6099#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
bcf91c1b 6100#: apt_preferences.5.xml:358
2a52e8c5
DK
6101msgid "the <literal>Codename:</literal> line"
6102msgstr ""
6103
6104#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
bcf91c1b 6105#: apt_preferences.5.xml:359
2a52e8c5
DK
6106msgid ""
6107"names the codename to which all the packages in the directory tree belong. "
6108"For example, the line \"Codename: squeeze\" specifies that all of the "
6109"packages in the directory tree below the parent of the "
6110"<filename>Release</filename> file belong to a version named "
6111"<literal>squeeze</literal>. Specifying this value in the APT preferences "
6112"file would require the line:"
6113msgstr ""
6114
6115#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
bcf91c1b 6116#: apt_preferences.5.xml:368
2a52e8c5
DK
6117#, no-wrap
6118msgid "Pin: release n=squeeze\n"
6119msgstr ""
6120
6121#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
bcf91c1b 6122#: apt_preferences.5.xml:375
2a52e8c5
DK
6123msgid ""
6124"names the release version. For example, the packages in the tree might "
6125"belong to Debian GNU/Linux release version 3.0. Note that there is normally "
6126"no version number for the <literal>testing</literal> and "
6127"<literal>unstable</literal> distributions because they have not been "
6128"released yet. Specifying this in the APT preferences file would require one "
6129"of the following lines."
6130msgstr ""
6131
6132#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
bcf91c1b 6133#: apt_preferences.5.xml:384
2a52e8c5
DK
6134#, no-wrap
6135msgid ""
6136"Pin: release v=3.0\n"
6137"Pin: release a=stable, v=3.0\n"
6138"Pin: release 3.0\n"
6139msgstr ""
6140
6141#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
bcf91c1b 6142#: apt_preferences.5.xml:393
2a52e8c5
DK
6143msgid "the <literal>Component:</literal> line"
6144msgstr ""
6145
6146#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
bcf91c1b 6147#: apt_preferences.5.xml:394
2a52e8c5
DK
6148msgid ""
6149"names the licensing component associated with the packages in the directory "
6150"tree of the <filename>Release</filename> file. For example, the line "
6151"\"Component: main\" specifies that all the packages in the directory tree "
6152"are from the <literal>main</literal> component, which entails that they are "
6153"licensed under terms listed in the Debian Free Software Guidelines. "
6154"Specifying this component in the APT preferences file would require the "
6155"line:"
6156msgstr ""
6157
6158#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
bcf91c1b 6159#: apt_preferences.5.xml:403
2a52e8c5
DK
6160#, no-wrap
6161msgid "Pin: release c=main\n"
6162msgstr ""
6163
6164#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
bcf91c1b 6165#: apt_preferences.5.xml:409
2a52e8c5
DK
6166msgid "the <literal>Origin:</literal> line"
6167msgstr ""
6168
6169#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
bcf91c1b 6170#: apt_preferences.5.xml:410
2a52e8c5
DK
6171msgid ""
6172"names the originator of the packages in the directory tree of the "
6173"<filename>Release</filename> file. Most commonly, this is "
6174"<literal>Debian</literal>. Specifying this origin in the APT preferences "
6175"file would require the line:"
6176msgstr ""
6177
6178#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
bcf91c1b 6179#: apt_preferences.5.xml:416
2a52e8c5
DK
6180#, no-wrap
6181msgid "Pin: release o=Debian\n"
6182msgstr ""
6183
6184#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
bcf91c1b 6185#: apt_preferences.5.xml:422
2a52e8c5
DK
6186msgid "the <literal>Label:</literal> line"
6187msgstr ""
6188
6189#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
bcf91c1b 6190#: apt_preferences.5.xml:423
2a52e8c5
DK
6191msgid ""
6192"names the label of the packages in the directory tree of the "
6193"<filename>Release</filename> file. Most commonly, this is "
6194"<literal>Debian</literal>. Specifying this label in the APT preferences "
6195"file would require the line:"
6196msgstr ""
6197
6198#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
bcf91c1b 6199#: apt_preferences.5.xml:429
2a52e8c5
DK
6200#, no-wrap
6201msgid "Pin: release l=Debian\n"
6202msgstr ""
6203
6204#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 6205#: apt_preferences.5.xml:330
2a52e8c5
DK
6206msgid ""
6207"The <filename>Release</filename> file is normally found in the directory "
6208"<filename>.../dists/<replaceable>dist-name</replaceable></filename>: for "
6209"example, <filename>.../dists/stable/Release</filename>, or "
6210"<filename>.../dists/woody/Release</filename>. It consists of a single "
6211"multi-line record which applies to <emphasis>all</emphasis> of the packages "
6212"in the directory tree below its parent. Unlike the "
6213"<filename>Packages</filename> file, nearly all of the lines in a "
6214"<filename>Release</filename> file are relevant for setting APT priorities: "
6215"<placeholder type=\"variablelist\" id=\"0\"/>"
6216msgstr ""
6217
6218#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 6219#: apt_preferences.5.xml:436
2a52e8c5
DK
6220msgid ""
6221"All of the <filename>Packages</filename> and <filename>Release</filename> "
6222"files retrieved from locations listed in the &sources-list; file are stored "
6223"in the directory <filename>/var/lib/apt/lists</filename>, or in the file "
6224"named by the variable <literal>Dir::State::Lists</literal> in the "
6225"<filename>apt.conf</filename> file. For example, the file "
6226"<filename>debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release</filename> "
6227"contains the <filename>Release</filename> file retrieved from the site "
6228"<literal>debian.lcs.mit.edu</literal> for <literal>binary-i386</literal> "
6229"architecture files from the <literal>contrib</literal> component of the "
6230"<literal>unstable</literal> distribution."
6231msgstr ""
6232
6233#. type: Content of: <refentry><refsect1><refsect2><title>
bcf91c1b 6234#: apt_preferences.5.xml:449
2a52e8c5
DK
6235msgid "Optional Lines in an APT Preferences Record"
6236msgstr ""
6237
6238#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 6239#: apt_preferences.5.xml:451
2a52e8c5
DK
6240msgid ""
6241"Each record in the APT preferences file can optionally begin with one or "
6242"more lines beginning with the word <literal>Explanation:</literal>. This "
6243"provides a place for comments."
6244msgstr ""
6245
6246#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 6247#: apt_preferences.5.xml:455
2a52e8c5
DK
6248msgid ""
6249"The <literal>Pin-Priority:</literal> line in each APT preferences record is "
6250"optional. If omitted, APT assigns a priority of 1 less than the last value "
6251"specified on a line beginning with <literal>Pin-Priority: release "
6252"...</literal>."
6253msgstr ""
6254
6255#. type: Content of: <refentry><refsect1><refsect2><title>
bcf91c1b 6256#: apt_preferences.5.xml:464
2a52e8c5
DK
6257msgid "Tracking Stable"
6258msgstr ""
6259
6260#. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
bcf91c1b 6261#: apt_preferences.5.xml:472
2a52e8c5
DK
6262#, no-wrap
6263msgid ""
6264"Explanation: Uninstall or do not install any Debian-originated\n"
6265"Explanation: package versions other than those in the stable distro\n"
6266"Package: *\n"
6267"Pin: release a=stable\n"
6268"Pin-Priority: 900\n"
6269"\n"
6270"Package: *\n"
6271"Pin: release o=Debian\n"
6272"Pin-Priority: -10\n"
6273msgstr ""
6274
6275#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 6276#: apt_preferences.5.xml:466
2a52e8c5
DK
6277msgid ""
6278"The following APT preferences file will cause APT to assign a priority "
6279"higher than the default (500) to all package versions belonging to a "
6280"<literal>stable</literal> distribution and a prohibitively low priority to "
6281"package versions belonging to other <literal>Debian</literal> "
6282"distributions. <placeholder type=\"programlisting\" id=\"0\"/>"
6283msgstr ""
6284
6285#. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
bcf91c1b 6286#: apt_preferences.5.xml:489 apt_preferences.5.xml:535 apt_preferences.5.xml:593
2a52e8c5
DK
6287#, no-wrap
6288msgid ""
6289"apt-get install <replaceable>package-name</replaceable>\n"
6290"apt-get upgrade\n"
6291"apt-get dist-upgrade\n"
6292msgstr ""
6293
6294#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 6295#: apt_preferences.5.xml:484
2a52e8c5
DK
6296msgid ""
6297"With a suitable &sources-list; file and the above preferences file, any of "
6298"the following commands will cause APT to upgrade to the latest "
6299"<literal>stable</literal> version(s). <placeholder type=\"programlisting\" "
6300"id=\"0\"/>"
6301msgstr ""
6302
6303#. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
bcf91c1b 6304#: apt_preferences.5.xml:501
2a52e8c5
DK
6305#, no-wrap
6306msgid "apt-get install <replaceable>package</replaceable>/testing\n"
6307msgstr ""
6308
6309#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 6310#: apt_preferences.5.xml:495
2a52e8c5
DK
6311msgid ""
6312"The following command will cause APT to upgrade the specified package to the "
6313"latest version from the <literal>testing</literal> distribution; the package "
6314"will not be upgraded again unless this command is given again. <placeholder "
6315"type=\"programlisting\" id=\"0\"/>"
6316msgstr ""
6317
6318#. type: Content of: <refentry><refsect1><refsect2><title>
bcf91c1b 6319#: apt_preferences.5.xml:507
2a52e8c5
DK
6320msgid "Tracking Testing or Unstable"
6321msgstr ""
6322
6323#. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
bcf91c1b 6324#: apt_preferences.5.xml:516
2a52e8c5
DK
6325#, no-wrap
6326msgid ""
6327"Package: *\n"
6328"Pin: release a=testing\n"
6329"Pin-Priority: 900\n"
6330"\n"
6331"Package: *\n"
6332"Pin: release a=unstable\n"
6333"Pin-Priority: 800\n"
6334"\n"
6335"Package: *\n"
6336"Pin: release o=Debian\n"
6337"Pin-Priority: -10\n"
6338msgstr ""
6339
6340#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 6341#: apt_preferences.5.xml:509
2a52e8c5
DK
6342msgid ""
6343"The following APT preferences file will cause APT to assign a high priority "
6344"to package versions from the <literal>testing</literal> distribution, a "
6345"lower priority to package versions from the <literal>unstable</literal> "
6346"distribution, and a prohibitively low priority to package versions from "
6347"other <literal>Debian</literal> distributions. <placeholder "
6348"type=\"programlisting\" id=\"0\"/>"
6349msgstr ""
6350
6351#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 6352#: apt_preferences.5.xml:530
2a52e8c5
DK
6353msgid ""
6354"With a suitable &sources-list; file and the above preferences file, any of "
6355"the following commands will cause APT to upgrade to the latest "
6356"<literal>testing</literal> version(s). <placeholder type=\"programlisting\" "
6357"id=\"0\"/>"
6358msgstr ""
6359
6360#. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
bcf91c1b 6361#: apt_preferences.5.xml:550
2a52e8c5
DK
6362#, no-wrap
6363msgid "apt-get install <replaceable>package</replaceable>/unstable\n"
6364msgstr ""
6365
6366#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 6367#: apt_preferences.5.xml:541
2a52e8c5
DK
6368msgid ""
6369"The following command will cause APT to upgrade the specified package to the "
6370"latest version from the <literal>unstable</literal> distribution. "
6371"Thereafter, <command>apt-get upgrade</command> will upgrade the package to "
6372"the most recent <literal>testing</literal> version if that is more recent "
6373"than the installed version, otherwise, to the most recent "
6374"<literal>unstable</literal> version if that is more recent than the "
6375"installed version. <placeholder type=\"programlisting\" id=\"0\"/>"
6376msgstr ""
6377
6378#. type: Content of: <refentry><refsect1><refsect2><title>
bcf91c1b 6379#: apt_preferences.5.xml:557
2a52e8c5
DK
6380msgid "Tracking the evolution of a codename release"
6381msgstr ""
6382
6383#. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
bcf91c1b 6384#: apt_preferences.5.xml:571
2a52e8c5
DK
6385#, no-wrap
6386msgid ""
6387"Explanation: Uninstall or do not install any Debian-originated package "
6388"versions\n"
6389"Explanation: other than those in the distribution codenamed with squeeze or "
6390"sid\n"
6391"Package: *\n"
6392"Pin: release n=squeeze\n"
6393"Pin-Priority: 900\n"
6394"\n"
6395"Explanation: Debian unstable is always codenamed with sid\n"
6396"Package: *\n"
6397"Pin: release a=sid\n"
6398"Pin-Priority: 800\n"
6399"\n"
6400"Package: *\n"
6401"Pin: release o=Debian\n"
6402"Pin-Priority: -10\n"
6403msgstr ""
6404
6405#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 6406#: apt_preferences.5.xml:559
2a52e8c5
DK
6407msgid ""
6408"The following APT preferences file will cause APT to assign a priority "
6409"higher than the default (500) to all package versions belonging to a "
6410"specified codename of a distribution and a prohibitively low priority to "
6411"package versions belonging to other <literal>Debian</literal> distributions, "
6412"codenames and archives. Note that with this APT preference APT will follow "
6413"the migration of a release from the archive <literal>testing</literal> to "
6414"<literal>stable</literal> and later <literal>oldstable</literal>. If you "
6415"want to follow for example the progress in <literal>testing</literal> "
6416"notwithstanding the codename changes you should use the example "
6417"configurations above. <placeholder type=\"programlisting\" id=\"0\"/>"
6418msgstr ""
6419
6420#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 6421#: apt_preferences.5.xml:588
2a52e8c5
DK
6422msgid ""
6423"With a suitable &sources-list; file and the above preferences file, any of "
6424"the following commands will cause APT to upgrade to the latest version(s) in "
6425"the release codenamed with <literal>squeeze</literal>. <placeholder "
6426"type=\"programlisting\" id=\"0\"/>"
6427msgstr ""
6428
6429#. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
bcf91c1b 6430#: apt_preferences.5.xml:608
2a52e8c5
DK
6431#, no-wrap
6432msgid "apt-get install <replaceable>package</replaceable>/sid\n"
6433msgstr ""
6434
6435#. type: Content of: <refentry><refsect1><refsect2><para>
bcf91c1b 6436#: apt_preferences.5.xml:599
2a52e8c5
DK
6437msgid ""
6438"The following command will cause APT to upgrade the specified package to the "
6439"latest version from the <literal>sid</literal> distribution. Thereafter, "
6440"<command>apt-get upgrade</command> will upgrade the package to the most "
6441"recent <literal>squeeze</literal> version if that is more recent than the "
6442"installed version, otherwise, to the most recent <literal>sid</literal> "
6443"version if that is more recent than the installed version. <placeholder "
6444"type=\"programlisting\" id=\"0\"/>"
6445msgstr ""
6446
bcf91c1b
DK
6447#. type: Content of: <refentry><refsect1><variablelist>
6448#: apt_preferences.5.xml:617
6449msgid "&file-preferences;"
6450msgstr ""
6451
2a52e8c5 6452#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6453#: apt_preferences.5.xml:623
2a52e8c5
DK
6454msgid "&apt-get; &apt-cache; &apt-conf; &sources-list;"
6455msgstr ""
6456
6457#. type: Content of: <refentry><refnamediv><refname>
bcf91c1b 6458#: sources.list.5.xml:22 sources.list.5.xml:29
2a52e8c5
DK
6459msgid "sources.list"
6460msgstr ""
6461
6462#. type: Content of: <refentry><refnamediv><refpurpose>
bcf91c1b 6463#: sources.list.5.xml:30
2a52e8c5
DK
6464msgid "Package resource list for APT"
6465msgstr ""
6466
6467#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6468#: sources.list.5.xml:34
2a52e8c5
DK
6469msgid ""
6470"The package resource list is used to locate archives of the package "
6471"distribution system in use on the system. At this time, this manual page "
6472"documents only the packaging system used by the Debian GNU/Linux system. "
6473"This control file is located in <filename>/etc/apt/sources.list</filename>"
6474msgstr ""
6475
6476#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6477#: sources.list.5.xml:39
2a52e8c5
DK
6478msgid ""
6479"The source list is designed to support any number of active sources and a "
6480"variety of source media. The file lists one source per line, with the most "
6481"preferred source listed first. The format of each line is: <literal>type uri "
6482"args</literal> The first item, <literal>type</literal> determines the format "
6483"for <literal>args</literal> <literal>uri</literal> is a Universal Resource "
6484"Identifier (URI), which is a superset of the more specific and well-known "
6485"Universal Resource Locator, or URL. The rest of the line can be marked as a "
6486"comment by using a #."
6487msgstr ""
6488
6489#. type: Content of: <refentry><refsect1><title>
bcf91c1b 6490#: sources.list.5.xml:50
2a52e8c5
DK
6491msgid "sources.list.d"
6492msgstr ""
6493
6494#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6495#: sources.list.5.xml:51
2a52e8c5
DK
6496msgid ""
6497"The <filename>/etc/apt/sources.list.d</filename> directory provides a way to "
6498"add sources.list entries in separate files. The format is the same as for "
6499"the regular <filename>sources.list</filename> file. File names need to end "
6500"with <filename>.list</filename> and may only contain letters (a-z and A-Z), "
6501"digits (0-9), underscore (_), hyphen (-) and period (.) characters. "
6502"Otherwise they will be silently ignored."
6503msgstr ""
6504
6505#. type: Content of: <refentry><refsect1><title>
bcf91c1b 6506#: sources.list.5.xml:60
2a52e8c5
DK
6507msgid "The deb and deb-src types"
6508msgstr ""
6509
6510#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6511#: sources.list.5.xml:61
2a52e8c5
DK
6512msgid ""
6513"The <literal>deb</literal> type describes a typical two-level Debian "
6514"archive, <filename>distribution/component</filename>. Typically, "
6515"<literal>distribution</literal> is generally one of "
6516"<literal>stable</literal> <literal>unstable</literal> or "
6517"<literal>testing</literal> while component is one of <literal>main</literal> "
6518"<literal>contrib</literal> <literal>non-free</literal> or "
6519"<literal>non-us</literal> The <literal>deb-src</literal> type describes a "
6520"debian distribution's source code in the same form as the "
6521"<literal>deb</literal> type. A <literal>deb-src</literal> line is required "
6522"to fetch source indexes."
6523msgstr ""
6524
6525#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6526#: sources.list.5.xml:73
2a52e8c5
DK
6527msgid ""
6528"The format for a <filename>sources.list</filename> entry using the "
6529"<literal>deb</literal> and <literal>deb-src</literal> types are:"
6530msgstr ""
6531
6532#. type: Content of: <refentry><refsect1><literallayout>
bcf91c1b 6533#: sources.list.5.xml:76
2a52e8c5
DK
6534#, no-wrap
6535msgid "deb uri distribution [component1] [component2] [...]"
6536msgstr ""
6537
6538#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6539#: sources.list.5.xml:78
2a52e8c5
DK
6540msgid ""
6541"The URI for the <literal>deb</literal> type must specify the base of the "
6542"Debian distribution, from which APT will find the information it needs. "
6543"<literal>distribution</literal> can specify an exact path, in which case the "
6544"components must be omitted and <literal>distribution</literal> must end with "
6545"a slash (/). This is useful for when only a particular sub-section of the "
6546"archive denoted by the URI is of interest. If "
6547"<literal>distribution</literal> does not specify an exact path, at least one "
6548"<literal>component</literal> must be present."
6549msgstr ""
6550
6551#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6552#: sources.list.5.xml:87
2a52e8c5
DK
6553msgid ""
6554"<literal>distribution</literal> may also contain a variable, "
6555"<literal>$(ARCH)</literal> which expands to the Debian architecture (i386, "
6556"m68k, powerpc, ...) used on the system. This permits "
6557"architecture-independent <filename>sources.list</filename> files to be "
6558"used. In general this is only of interest when specifying an exact path, "
6559"<literal>APT</literal> will automatically generate a URI with the current "
6560"architecture otherwise."
6561msgstr ""
6562
6563#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6564#: sources.list.5.xml:95
2a52e8c5
DK
6565msgid ""
6566"Since only one distribution can be specified per line it may be necessary to "
6567"have multiple lines for the same URI, if a subset of all available "
6568"distributions or components at that location is desired. APT will sort the "
6569"URI list after it has generated a complete set internally, and will collapse "
6570"multiple references to the same Internet host, for instance, into a single "
6571"connection, so that it does not inefficiently establish an FTP connection, "
6572"close it, do something else, and then re-establish a connection to that same "
6573"host. This feature is useful for accessing busy FTP sites with limits on the "
6574"number of simultaneous anonymous users. APT also parallelizes connections to "
6575"different hosts to more effectively deal with sites with low bandwidth."
6576msgstr ""
6577
6578#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6579#: sources.list.5.xml:107
2a52e8c5
DK
6580msgid ""
6581"It is important to list sources in order of preference, with the most "
6582"preferred source listed first. Typically this will result in sorting by "
6583"speed from fastest to slowest (CD-ROM followed by hosts on a local network, "
6584"followed by distant Internet hosts, for example)."
6585msgstr ""
6586
6587#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6588#: sources.list.5.xml:112
2a52e8c5
DK
6589msgid "Some examples:"
6590msgstr ""
6591
6592#. type: Content of: <refentry><refsect1><literallayout>
bcf91c1b 6593#: sources.list.5.xml:114
2a52e8c5
DK
6594#, no-wrap
6595msgid ""
6596"deb http://http.us.debian.org/debian stable main contrib non-free\n"
6597"deb http://http.us.debian.org/debian dists/stable-updates/\n"
6598" "
6599msgstr ""
6600
6601#. type: Content of: <refentry><refsect1><title>
bcf91c1b 6602#: sources.list.5.xml:120
2a52e8c5
DK
6603msgid "URI specification"
6604msgstr ""
6605
6606#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
bcf91c1b 6607#: sources.list.5.xml:125
2a52e8c5
DK
6608msgid "file"
6609msgstr ""
6610
6611#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 6612#: sources.list.5.xml:127
2a52e8c5
DK
6613msgid ""
6614"The file scheme allows an arbitrary directory in the file system to be "
6615"considered an archive. This is useful for NFS mounts and local mirrors or "
6616"archives."
6617msgstr ""
6618
6619#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 6620#: sources.list.5.xml:134
2a52e8c5
DK
6621msgid ""
6622"The cdrom scheme allows APT to use a local CDROM drive with media "
6623"swapping. Use the &apt-cdrom; program to create cdrom entries in the source "
6624"list."
6625msgstr ""
6626
6627#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 6628#: sources.list.5.xml:141
2a52e8c5
DK
6629msgid ""
6630"The http scheme specifies an HTTP server for the archive. If an environment "
6631"variable <envar>http_proxy</envar> is set with the format "
6632"http://server:port/, the proxy server specified in <envar>http_proxy</envar> "
6633"will be used. Users of authenticated HTTP/1.1 proxies may use a string of "
6634"the format http://user:pass@server:port/ Note that this is an insecure "
6635"method of authentication."
6636msgstr ""
6637
6638#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 6639#: sources.list.5.xml:152
2a52e8c5
DK
6640msgid ""
6641"The ftp scheme specifies an FTP server for the archive. APT's FTP behavior "
6642"is highly configurable; for more information see the &apt-conf; manual "
6643"page. Please note that a ftp proxy can be specified by using the "
6644"<envar>ftp_proxy</envar> environment variable. It is possible to specify a "
6645"http proxy (http proxy servers often understand ftp urls) using this method "
6646"and ONLY this method. ftp proxies using http specified in the configuration "
6647"file will be ignored."
6648msgstr ""
6649
6650#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
bcf91c1b 6651#: sources.list.5.xml:161
2a52e8c5
DK
6652msgid "copy"
6653msgstr ""
6654
6655#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 6656#: sources.list.5.xml:163
2a52e8c5
DK
6657msgid ""
6658"The copy scheme is identical to the file scheme except that packages are "
6659"copied into the cache directory instead of used directly at their location. "
6660"This is useful for people using a zip disk to copy files around with APT."
6661msgstr ""
6662
6663#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
bcf91c1b 6664#: sources.list.5.xml:168
2a52e8c5
DK
6665msgid "rsh"
6666msgstr ""
6667
6668#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
bcf91c1b 6669#: sources.list.5.xml:168
2a52e8c5
DK
6670msgid "ssh"
6671msgstr ""
6672
6673#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
bcf91c1b 6674#: sources.list.5.xml:170
2a52e8c5
DK
6675msgid ""
6676"The rsh/ssh method invokes rsh/ssh to connect to a remote host as a given "
6677"user and access the files. It is a good idea to do prior arrangements with "
6678"RSA keys or rhosts. Access to files on the remote uses standard "
6679"<command>find</command> and <command>dd</command> commands to perform the "
6680"file transfers from the remote."
6681msgstr ""
6682
6683#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6684#: sources.list.5.xml:122
2a52e8c5
DK
6685msgid ""
6686"The currently recognized URI types are cdrom, file, http, ftp, copy, ssh, "
6687"rsh. <placeholder type=\"variablelist\" id=\"0\"/>"
6688msgstr ""
6689
6690#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6691#: sources.list.5.xml:182
2a52e8c5
DK
6692msgid ""
6693"Uses the archive stored locally (or NFS mounted) at /home/jason/debian for "
6694"stable/main, stable/contrib, and stable/non-free."
6695msgstr ""
6696
6697#. type: Content of: <refentry><refsect1><literallayout>
bcf91c1b 6698#: sources.list.5.xml:184
2a52e8c5
DK
6699#, no-wrap
6700msgid "deb file:/home/jason/debian stable main contrib non-free"
6701msgstr ""
6702
6703#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6704#: sources.list.5.xml:186
2a52e8c5
DK
6705msgid "As above, except this uses the unstable (development) distribution."
6706msgstr ""
6707
6708#. type: Content of: <refentry><refsect1><literallayout>
bcf91c1b 6709#: sources.list.5.xml:187
2a52e8c5
DK
6710#, no-wrap
6711msgid "deb file:/home/jason/debian unstable main contrib non-free"
6712msgstr ""
6713
6714#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6715#: sources.list.5.xml:189
2a52e8c5
DK
6716msgid "Source line for the above"
6717msgstr ""
6718
6719#. type: Content of: <refentry><refsect1><literallayout>
bcf91c1b 6720#: sources.list.5.xml:190
2a52e8c5
DK
6721#, no-wrap
6722msgid "deb-src file:/home/jason/debian unstable main contrib non-free"
6723msgstr ""
6724
6725#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6726#: sources.list.5.xml:192
2a52e8c5
DK
6727msgid ""
6728"Uses HTTP to access the archive at archive.debian.org, and uses only the "
6729"hamm/main area."
6730msgstr ""
6731
6732#. type: Content of: <refentry><refsect1><literallayout>
bcf91c1b 6733#: sources.list.5.xml:194
2a52e8c5
DK
6734#, no-wrap
6735msgid "deb http://archive.debian.org/debian-archive hamm main"
6736msgstr ""
6737
6738#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6739#: sources.list.5.xml:196
2a52e8c5
DK
6740msgid ""
6741"Uses FTP to access the archive at ftp.debian.org, under the debian "
6742"directory, and uses only the stable/contrib area."
6743msgstr ""
6744
6745#. type: Content of: <refentry><refsect1><literallayout>
bcf91c1b 6746#: sources.list.5.xml:198
2a52e8c5
DK
6747#, no-wrap
6748msgid "deb ftp://ftp.debian.org/debian stable contrib"
6749msgstr ""
6750
6751#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6752#: sources.list.5.xml:200
2a52e8c5
DK
6753msgid ""
6754"Uses FTP to access the archive at ftp.debian.org, under the debian "
6755"directory, and uses only the unstable/contrib area. If this line appears as "
6756"well as the one in the previous example in "
6757"<filename>sources.list</filename>. a single FTP session will be used for "
6758"both resource lines."
6759msgstr ""
6760
6761#. type: Content of: <refentry><refsect1><literallayout>
bcf91c1b 6762#: sources.list.5.xml:204
2a52e8c5
DK
6763#, no-wrap
6764msgid "deb ftp://ftp.debian.org/debian unstable contrib"
6765msgstr ""
6766
6767#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6768#: sources.list.5.xml:206
2a52e8c5
DK
6769msgid ""
6770"Uses HTTP to access the archive at nonus.debian.org, under the debian-non-US "
6771"directory."
6772msgstr ""
6773
6774#. type: Content of: <refentry><refsect1><literallayout>
bcf91c1b 6775#: sources.list.5.xml:208
2a52e8c5
DK
6776#, no-wrap
6777msgid ""
6778"deb http://nonus.debian.org/debian-non-US stable/non-US main contrib "
6779"non-free"
6780msgstr ""
6781
6782#. type: Content of: <refentry><refsect1><para><literallayout>
bcf91c1b 6783#: sources.list.5.xml:217
2a52e8c5
DK
6784#, no-wrap
6785msgid "deb http://ftp.de.debian.org/debian-non-US unstable/binary-$(ARCH)/"
6786msgstr ""
6787
6788#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6789#: sources.list.5.xml:210
2a52e8c5
DK
6790msgid ""
6791"Uses HTTP to access the archive at nonus.debian.org, under the debian-non-US "
6792"directory, and uses only files found under "
6793"<filename>unstable/binary-i386</filename> on i386 machines, "
6794"<filename>unstable/binary-m68k</filename> on m68k, and so forth for other "
6795"supported architectures. [Note this example only illustrates how to use the "
6796"substitution variable; non-us is no longer structured like this] "
6797"<placeholder type=\"literallayout\" id=\"0\"/>"
6798msgstr ""
6799
6800#. type: Content of: <refentry><refsect1><para>
bcf91c1b 6801#: sources.list.5.xml:222
2a52e8c5
DK
6802msgid "&apt-cache; &apt-conf;"
6803msgstr ""