499
499
#. type: Content of: <refentry><refmeta><manvolnum>
500
#: apt-get.8.xml:26 apt-cache.8.xml:26 apt-key.8.xml:25 apt-mark.8.xml:26 apt-secure.8.xml:25 apt-cdrom.8.xml:25 apt-config.8.xml:26
500
#: apt-get.8.xml:28 apt-cache.8.xml:28 apt-key.8.xml:27 apt-mark.8.xml:28 apt-secure.8.xml:27 apt-cdrom.8.xml:27 apt-config.8.xml:28
504
504
#. type: Content of: <refentry><refmeta><refmiscinfo>
505
#: apt-get.8.xml:27 apt-cache.8.xml:27 apt-key.8.xml:26 apt-mark.8.xml:27 apt-secure.8.xml:26 apt-cdrom.8.xml:26 apt-config.8.xml:27 apt.conf.5.xml:32 apt_preferences.5.xml:26 sources.list.5.xml:27 apt-extracttemplates.1.xml:27 apt-sortpkgs.1.xml:27 apt-ftparchive.1.xml:27
505
#: apt-get.8.xml:29 apt-cache.8.xml:29 apt-key.8.xml:28 apt-mark.8.xml:29 apt-secure.8.xml:28 apt-cdrom.8.xml:28 apt-config.8.xml:29 apt.conf.5.xml:34 apt_preferences.5.xml:28 sources.list.5.xml:29 apt-extracttemplates.1.xml:29 apt-sortpkgs.1.xml:29 apt-ftparchive.1.xml:29
509
509
#. type: Content of: <refentry><refnamediv><refpurpose>
511
511
msgid "APT package handling utility -- command-line interface"
514
514
#. type: Content of: <refentry><refsect1><title>
515
#: apt-get.8.xml:38 apt-cache.8.xml:38 apt-key.8.xml:37 apt-mark.8.xml:38 apt-secure.8.xml:50 apt-cdrom.8.xml:37 apt-config.8.xml:38 apt.conf.5.xml:41 apt_preferences.5.xml:36 sources.list.5.xml:36 apt-extracttemplates.1.xml:38 apt-sortpkgs.1.xml:38 apt-ftparchive.1.xml:38
515
#: apt-get.8.xml:40 apt-cache.8.xml:40 apt-key.8.xml:39 apt-mark.8.xml:40 apt-secure.8.xml:52 apt-cdrom.8.xml:39 apt-config.8.xml:40 apt.conf.5.xml:43 apt_preferences.5.xml:38 sources.list.5.xml:38 apt-extracttemplates.1.xml:40 apt-sortpkgs.1.xml:40 apt-ftparchive.1.xml:40
516
516
msgid "Description"
519
519
#. type: Content of: <refentry><refsect1><para>
522
522
"<command>apt-get</command> is the command-line tool for handling packages, "
523
523
"and may be considered the user's \"back-end\" to other tools using the APT "
528
528
#. type: Content of: <refentry><refsect1><para>
529
#: apt-get.8.xml:44 apt-cache.8.xml:44 apt-cdrom.8.xml:51 apt-config.8.xml:44 apt-ftparchive.1.xml:54
529
#: apt-get.8.xml:46 apt-cache.8.xml:46 apt-cdrom.8.xml:53 apt-config.8.xml:46 apt-ftparchive.1.xml:56
531
531
"Unless the <option>-h</option>, or <option>--help</option> option is given, "
532
532
"one of the commands below must be present."
535
535
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
538
538
"<literal>update</literal> is used to resynchronize the package index files "
539
539
"from their sources. The indexes of available packages are fetched from the "
797
797
#. type: Content of: <refentry><refsect1><title>
798
#: apt-get.8.xml:258 apt-cache.8.xml:248 apt-mark.8.xml:108 apt-config.8.xml:84 apt-extracttemplates.1.xml:52 apt-sortpkgs.1.xml:48 apt-ftparchive.1.xml:504
798
#: apt-get.8.xml:260 apt-cache.8.xml:250 apt-mark.8.xml:110 apt-config.8.xml:86 apt-extracttemplates.1.xml:54 apt-sortpkgs.1.xml:50 apt-ftparchive.1.xml:506
802
802
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
805
805
"Do not consider recommended packages as a dependency for installing. "
806
806
"Configuration Item: <literal>APT::Install-Recommends</literal>."
809
809
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
812
812
"Consider suggested packages as a dependency for installing. Configuration "
813
813
"Item: <literal>APT::Install-Suggests</literal>."
816
816
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
819
819
"Download only; package files are only retrieved, not unpacked or installed. "
820
820
"Configuration Item: <literal>APT::Get::Download-Only</literal>."
823
823
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
826
826
"Fix; attempt to correct a system with broken dependencies in place. This "
827
827
"option, when used with install/remove, can omit any packages to permit APT "
912
912
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
915
915
"Automatic \"no\" to all prompts. Configuration Item: "
916
916
"<literal>APT::Get::Assume-No</literal>."
919
919
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
922
922
"Show upgraded packages; print out a list of all packages that are to be "
923
923
"upgraded. Configuration Item: <literal>APT::Get::Show-Upgraded</literal>."
926
926
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
929
929
"Show full versions for upgraded and installed packages. Configuration Item: "
930
930
"<literal>APT::Get::Show-Versions</literal>."
933
933
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
936
936
"This option controls the architecture packages are built for by "
937
937
"<command>apt-get source --compile</command> and how cross-builddependencies "
1119
1119
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1120
#: apt-get.8.xml:525
1120
#: apt-get.8.xml:527
1122
1122
"Show user friendly progress information in the terminal window when packages "
1123
1123
"are installed, upgraded or removed. For a machine parsable version of this "
1124
"data see README.progress-reporting in the apt doc directory. "
1125
"<literal>DpkgPM::Progress</literal>."
1124
"data see README.progress-reporting in the apt doc directory. Configuration "
1125
"Item: <literal>DpkgPM::Progress</literal> and "
1126
"<literal>Dpkg::Progress-Fancy</literal>."
1128
1129
#. type: Content of: <refentry><refsect1><title>
1129
#: apt-get.8.xml:538 apt-cache.8.xml:343 apt-key.8.xml:174 apt-mark.8.xml:125 apt.conf.5.xml:1198 apt_preferences.5.xml:698
1130
#: apt-get.8.xml:540 apt-cache.8.xml:345 apt-key.8.xml:176 apt-mark.8.xml:127 apt.conf.5.xml:1200 apt_preferences.5.xml:700
1133
1134
#. type: Content of: <refentry><refsect1><title>
1134
#: apt-get.8.xml:548 apt-cache.8.xml:350 apt-key.8.xml:195 apt-mark.8.xml:131 apt-secure.8.xml:191 apt-cdrom.8.xml:152 apt-config.8.xml:109 apt.conf.5.xml:1204 apt_preferences.5.xml:705 sources.list.5.xml:256 apt-extracttemplates.1.xml:70 apt-sortpkgs.1.xml:63 apt-ftparchive.1.xml:607
1135
#: apt-get.8.xml:550 apt-cache.8.xml:352 apt-key.8.xml:197 apt-mark.8.xml:133 apt-secure.8.xml:193 apt-cdrom.8.xml:154 apt-config.8.xml:111 apt.conf.5.xml:1206 apt_preferences.5.xml:707 sources.list.5.xml:258 apt-extracttemplates.1.xml:72 apt-sortpkgs.1.xml:65 apt-ftparchive.1.xml:609
1135
1136
msgid "See Also"
1138
1139
#. type: Content of: <refentry><refsect1><para>
1139
#: apt-get.8.xml:549
1140
#: apt-get.8.xml:551
1141
1142
"&apt-cache;, &apt-cdrom;, &dpkg;, &dselect;, &sources-list;, &apt-conf;, "
1142
1143
"&apt-config;, &apt-secure;, The APT User's guide in &guidesdir;, "
1146
1147
#. type: Content of: <refentry><refsect1><title>
1147
#: apt-get.8.xml:554 apt-cache.8.xml:355 apt-mark.8.xml:135 apt-cdrom.8.xml:157 apt-config.8.xml:114 apt-extracttemplates.1.xml:74 apt-sortpkgs.1.xml:67 apt-ftparchive.1.xml:611
1148
#: apt-get.8.xml:556 apt-cache.8.xml:357 apt-mark.8.xml:137 apt-cdrom.8.xml:159 apt-config.8.xml:116 apt-extracttemplates.1.xml:76 apt-sortpkgs.1.xml:69 apt-ftparchive.1.xml:613
1148
1149
msgid "Diagnostics"
1151
1152
#. type: Content of: <refentry><refsect1><para>
1152
#: apt-get.8.xml:555
1153
#: apt-get.8.xml:557
1154
1155
"<command>apt-get</command> returns zero on normal operation, decimal 100 on "
1158
1159
#. type: Content of: <refentry><refnamediv><refpurpose>
1159
#: apt-cache.8.xml:33
1160
#: apt-cache.8.xml:35
1160
1161
msgid "query the APT cache"
1163
1164
#. type: Content of: <refentry><refsect1><para>
1164
#: apt-cache.8.xml:39
1165
#: apt-cache.8.xml:41
1166
1167
"<command>apt-cache</command> performs a variety of operations on APT's "
1167
1168
"package cache. <command>apt-cache</command> does not manipulate the state of "
1172
1173
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1173
#: apt-cache.8.xml:49
1174
#: apt-cache.8.xml:51
1175
1176
"<literal>gencaches</literal> creates APT's package cache. This is done "
1176
1177
"implicitly by all commands needing this cache if it is missing or outdated."
1179
1180
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term><option><replaceable>
1180
#: apt-cache.8.xml:53 apt-cache.8.xml:142 apt-cache.8.xml:163 apt-cache.8.xml:185 apt-cache.8.xml:190 apt-cache.8.xml:206 apt-cache.8.xml:224 apt-cache.8.xml:236
1181
#: apt-cache.8.xml:55 apt-cache.8.xml:144 apt-cache.8.xml:165 apt-cache.8.xml:187 apt-cache.8.xml:192 apt-cache.8.xml:208 apt-cache.8.xml:226 apt-cache.8.xml:238
1181
1182
msgid "&synopsis-pkg;"
1184
1185
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1185
#: apt-cache.8.xml:54
1186
#: apt-cache.8.xml:56
1187
1188
"<literal>showpkg</literal> displays information about the packages listed on "
1188
1189
"the command line. Remaining arguments are package names. The available "
1313
1314
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1314
#: apt-cache.8.xml:149
1315
#: apt-cache.8.xml:151
1316
1317
"<literal>dump</literal> shows a short listing of every package in the "
1317
1318
"cache. It is primarily for debugging."
1320
1321
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1321
#: apt-cache.8.xml:154
1322
#: apt-cache.8.xml:156
1323
1324
"<literal>dumpavail</literal> prints out an available list to stdout. This is "
1324
1325
"suitable for use with &dpkg; and is used by the &dselect; method."
1327
1328
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1328
#: apt-cache.8.xml:159
1329
#: apt-cache.8.xml:161
1330
1331
"<literal>unmet</literal> displays a summary of all unmet dependencies in the "
1331
1332
"package cache."
1334
1335
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1335
#: apt-cache.8.xml:164
1336
#: apt-cache.8.xml:166
1337
1338
"<literal>show</literal> performs a function similar to <command>dpkg "
1338
1339
"--print-avail</command>; it displays the package records for the named "
1360
1361
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1361
#: apt-cache.8.xml:181
1362
#: apt-cache.8.xml:183
1363
1364
"Separate arguments can be used to specify multiple search patterns that are "
1364
1365
"and'ed together."
1367
1368
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1368
#: apt-cache.8.xml:186
1369
#: apt-cache.8.xml:188
1370
1371
"<literal>depends</literal> shows a listing of each dependency a package has "
1371
1372
"and all the possible other packages that can fulfill that dependency."
1374
1375
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1375
#: apt-cache.8.xml:191
1376
#: apt-cache.8.xml:193
1377
1378
"<literal>rdepends</literal> shows a listing of each reverse dependency a "
1381
1382
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1382
#: apt-cache.8.xml:195
1383
#: apt-cache.8.xml:197
1383
1384
msgid "<optional><replaceable>&synopsis-prefix;</replaceable></optional>"
1386
1387
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1387
#: apt-cache.8.xml:196
1388
#: apt-cache.8.xml:198
1389
1390
"This command prints the name of each package APT knows. The optional "
1390
1391
"argument is a prefix match to filter the name list. The output is suitable "
1568
1569
#. type: Content of: <refentry><refsect1><para>
1569
#: apt-cache.8.xml:351
1570
#: apt-cache.8.xml:353
1570
1571
msgid "&apt-conf;, &sources-list;, &apt-get;"
1573
1574
#. type: Content of: <refentry><refsect1><para>
1574
#: apt-cache.8.xml:356
1575
#: apt-cache.8.xml:358
1576
1577
"<command>apt-cache</command> returns zero on normal operation, decimal 100 "
1580
1581
#. type: Content of: <refentry><refnamediv><refpurpose>
1582
1583
msgid "APT key management utility"
1585
1586
#. type: Content of: <refentry><refsect1><para>
1588
1589
"<command>apt-key</command> is used to manage the list of keys used by apt to "
1589
1590
"authenticate packages. Packages which have been authenticated using these "
1606
1607
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1608
1609
msgid "Remove a key from the list of trusted keys."
1611
1612
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1613
1614
msgid "Output the key &synopsis-param-keyid; to standard output."
1616
1617
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1618
1619
msgid "Output all trusted keys to standard output."
1621
1622
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1623
1624
msgid "List trusted keys."
1626
1627
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1627
#: apt-key.8.xml:107
1628
#: apt-key.8.xml:109
1628
1629
msgid "List fingerprints of trusted keys."
1631
1632
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1632
#: apt-key.8.xml:118
1633
#: apt-key.8.xml:120
1634
1635
"Pass advanced options to gpg. With adv --recv-key you can download the "
1638
1639
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1639
#: apt-key.8.xml:130
1640
#: apt-key.8.xml:132
1641
1642
"Update the local keyring with the archive keyring and remove from the local "
1642
1643
"keyring the archive keys which are no longer valid. The archive keyring is "
1643
1644
"shipped in the <literal>archive-keyring</literal> package of your "
1644
"distribution, e.g. the <literal>debian-archive-keyring</literal> package in "
1645
"distribution, e.g. the &keyring-package; package in &keyring-distro;."
1648
1648
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1649
#: apt-key.8.xml:144
1649
#: apt-key.8.xml:146
1651
1651
"Perform an update working similarly to the <command>update</command> command "
1652
1652
"above, but get the archive keyring from a URI instead and validate it "
1682
1682
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1683
#: apt-key.8.xml:179
1683
#: apt-key.8.xml:181
1684
1684
msgid "<filename>/etc/apt/trustdb.gpg</filename>"
1687
1687
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1688
#: apt-key.8.xml:180
1688
#: apt-key.8.xml:182
1689
1689
msgid "Local trust database of archive keys."
1692
1692
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1693
#: apt-key.8.xml:183
1694
msgid "<filename>/usr/share/keyrings/debian-archive-keyring.gpg</filename>"
1693
#: apt-key.8.xml:185
1694
msgid "&keyring-filename;"
1697
1697
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1698
#: apt-key.8.xml:184
1699
msgid "Keyring of Debian archive trusted keys."
1698
#: apt-key.8.xml:186
1699
msgid "Keyring of &keyring-distro; archive trusted keys."
1702
1702
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1703
#: apt-key.8.xml:187
1704
msgid "<filename>/usr/share/keyrings/debian-archive-removed-keys.gpg</filename>"
1703
#: apt-key.8.xml:189
1704
msgid "&keyring-removed-filename;"
1707
1707
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1708
#: apt-key.8.xml:188
1709
msgid "Keyring of Debian archive removed trusted keys."
1708
#: apt-key.8.xml:190
1709
msgid "Keyring of &keyring-distro; archive removed trusted keys."
1712
1712
#. type: Content of: <refentry><refsect1><para>
1713
#: apt-key.8.xml:197
1713
#: apt-key.8.xml:199
1714
1714
msgid "&apt-get;, &apt-secure;"
1717
1717
#. type: Content of: <refentry><refnamediv><refpurpose>
1718
#: apt-mark.8.xml:33
1718
#: apt-mark.8.xml:35
1719
1719
msgid "mark/unmark a package as being automatically-installed"
1722
1722
#. type: Content of: <refentry><refsect1><para>
1723
#: apt-mark.8.xml:39
1723
#: apt-mark.8.xml:41
1725
1725
"<command>apt-mark</command> will change whether a package has been marked as "
1726
1726
"being automatically installed."
1729
1729
#. type: Content of: <refentry><refsect1><para>
1730
#: apt-mark.8.xml:43
1730
#: apt-mark.8.xml:45
1732
1732
"When you request that a package is installed, and as a result other packages "
1733
1733
"are installed to satisfy its dependencies, the dependencies are marked as "
1879
1879
#. type: Content of: <refentry><refsect1><para>
1880
#: apt-secure.8.xml:102
1880
#: apt-secure.8.xml:104
1882
1882
"Once the uploaded package is verified and included in the archive, the "
1883
1883
"maintainer signature is stripped off, and checksums of the package are "
1884
1884
"computed and put in the Packages file. The checksums of all of the Packages "
1885
1885
"files are then computed and put into the Release file. The Release file is "
1886
"then signed by the archive key for this Debian release, and distributed "
1887
"alongside the packages and the Packages files on Debian mirrors. The keys "
1888
"are in the Debian archive keyring available in the "
1889
"<package>debian-archive-keyring</package> package."
1886
"then signed by the archive key for this &keyring-distro; release, and "
1887
"distributed alongside the packages and the Packages files on "
1888
"&keyring-distro; mirrors. The keys are in the &keyring-distro; archive "
1889
"keyring available in the &keyring-package; package."
1892
1892
#. type: Content of: <refentry><refsect1><para>
1893
#: apt-secure.8.xml:113
1893
#: apt-secure.8.xml:115
1895
1895
"End users can check the signature of the Release file, extract a checksum of "
1896
1896
"a package from it and compare it with the checksum of the package they "
2022
2022
#. type: Content of: <refentry><refsect1><title>
2023
#: apt-secure.8.xml:210
2023
#: apt-secure.8.xml:212
2024
2024
msgid "Manpage Authors"
2027
2027
#. type: Content of: <refentry><refsect1><para>
2028
#: apt-secure.8.xml:212
2028
#: apt-secure.8.xml:214
2030
2030
"This man-page is based on the work of Javier Fernández-Sanguino Peña, Isaac "
2031
2031
"Jones, Colin Walters, Florian Weimer and Michael Vogt."
2034
2034
#. type: Content of: <refentry><refnamediv><refpurpose>
2035
#: apt-cdrom.8.xml:32
2035
#: apt-cdrom.8.xml:34
2036
2036
msgid "APT CD-ROM management utility"
2039
2039
#. type: Content of: <refentry><refsect1><para>
2040
#: apt-cdrom.8.xml:38
2040
#: apt-cdrom.8.xml:40
2042
2042
"<command>apt-cdrom</command> is used to add a new CD-ROM to APT's list of "
2043
2043
"available sources. <command>apt-cdrom</command> takes care of determining "
2138
2138
#. type: Content of: <refentry><refsect1><para>
2139
#: apt-cdrom.8.xml:153
2139
#: apt-cdrom.8.xml:155
2140
2140
msgid "&apt-conf;, &apt-get;, &sources-list;"
2143
2143
#. type: Content of: <refentry><refsect1><para>
2144
#: apt-cdrom.8.xml:158
2144
#: apt-cdrom.8.xml:160
2146
2146
"<command>apt-cdrom</command> returns zero on normal operation, decimal 100 "
2150
2150
#. type: Content of: <refentry><refnamediv><refpurpose>
2151
#: apt-config.8.xml:33
2151
#: apt-config.8.xml:35
2152
2152
msgid "APT Configuration Query program"
2155
2155
#. type: Content of: <refentry><refsect1><para>
2156
#: apt-config.8.xml:39
2156
#: apt-config.8.xml:41
2158
2158
"<command>apt-config</command> is an internal program used by various "
2159
2159
"portions of the APT suite to provide consistent configurability. It accesses "
2198
2198
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2199
#: apt-config.8.xml:77
2199
#: apt-config.8.xml:79
2200
2200
msgid "Just show the contents of the configuration space."
2203
2203
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2204
#: apt-config.8.xml:90
2204
#: apt-config.8.xml:92
2206
2206
"Include options which have an empty value. This is the default, so use "
2207
2207
"--no-empty to remove them from the output."
2210
2210
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term><option><replaceable>
2211
#: apt-config.8.xml:95
2211
#: apt-config.8.xml:97
2212
2212
msgid "%f "%v";%n"
2215
2215
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2216
#: apt-config.8.xml:96
2216
#: apt-config.8.xml:98
2218
2218
"Defines the output of each config option. %t will be replaced with "
2219
2219
"its individual name, %f with its full hierarchical name and %v "
2226
2226
#. type: Content of: <refentry><refsect1><para>
2227
#: apt-config.8.xml:110 apt-extracttemplates.1.xml:71 apt-sortpkgs.1.xml:64 apt-ftparchive.1.xml:608
2227
#: apt-config.8.xml:112 apt-extracttemplates.1.xml:73 apt-sortpkgs.1.xml:66 apt-ftparchive.1.xml:610
2228
2228
msgid "&apt-conf;"
2231
2231
#. type: Content of: <refentry><refsect1><para>
2232
#: apt-config.8.xml:115
2232
#: apt-config.8.xml:117
2234
2234
"<command>apt-config</command> returns zero on normal operation, decimal 100 "
2238
2238
#. type: Content of: <refentry><refentryinfo><author><contrib>
2239
#: apt.conf.5.xml:20
2239
#: apt.conf.5.xml:22
2240
2240
msgid "Initial documentation of Debug::*."
2243
2243
#. type: Content of: <refentry><refentryinfo><author><email>
2244
#: apt.conf.5.xml:21
2244
#: apt.conf.5.xml:23
2245
2245
msgid "dburrows@debian.org"
2248
2248
#. type: Content of: <refentry><refmeta><manvolnum>
2249
#: apt.conf.5.xml:31 apt_preferences.5.xml:25 sources.list.5.xml:26
2249
#: apt.conf.5.xml:33 apt_preferences.5.xml:27 sources.list.5.xml:28
2253
2253
#. type: Content of: <refentry><refnamediv><refpurpose>
2254
#: apt.conf.5.xml:38
2254
#: apt.conf.5.xml:40
2255
2255
msgid "Configuration file for APT"
2258
2258
#. type: Content of: <refentry><refsect1><para>
2259
#: apt.conf.5.xml:42
2259
#: apt.conf.5.xml:44
2261
2261
"<filename>/etc/apt/apt.conf</filename> is the main configuration file shared "
2262
2262
"by all the tools in the APT suite of tools, though it is by no means the "
2355
2355
#. type: Content of: <refentry><refsect1><informalexample><programlisting>
2356
#: apt.conf.5.xml:98
2356
#: apt.conf.5.xml:100
2358
2358
msgid "DPkg::Pre-Install-Pkgs {\"/usr/sbin/dpkg-preconfigure --apt\";};\n"
2361
2361
#. type: Content of: <refentry><refsect1><para>
2362
#: apt.conf.5.xml:101
2362
#: apt.conf.5.xml:103
2364
2364
"In general the sample configuration file &configureindex; is a good guide "
2365
2365
"for how it should look."
2368
2368
#. type: Content of: <refentry><refsect1><para>
2369
#: apt.conf.5.xml:104
2369
#: apt.conf.5.xml:106
2371
2371
"Case is not significant in names of configuration items, so in the previous "
2372
2372
"example you could use <literal>dpkg::pre-install-pkgs</literal>."
2375
2375
#. type: Content of: <refentry><refsect1><para>
2376
#: apt.conf.5.xml:107
2376
#: apt.conf.5.xml:109
2378
2378
"Names for the configuration items are optional if a list is defined as can "
2379
2379
"be seen in the <literal>DPkg::Pre-Install-Pkgs</literal> example above. If "
2572
2572
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2573
#: apt.conf.5.xml:262
2573
#: apt.conf.5.xml:264
2574
2574
msgid "Defines which packages are considered essential build dependencies."
2577
2577
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2578
#: apt.conf.5.xml:266
2578
#: apt.conf.5.xml:268
2580
2580
"The Get subsection controls the &apt-get; tool; please see its documentation "
2581
2581
"for more information about the options here."
2584
2584
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2585
#: apt.conf.5.xml:271
2585
#: apt.conf.5.xml:273
2587
2587
"The Cache subsection controls the &apt-cache; tool; please see its "
2588
2588
"documentation for more information about the options here."
2591
2591
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2592
#: apt.conf.5.xml:276
2592
#: apt.conf.5.xml:278
2594
2594
"The CDROM subsection controls the &apt-cdrom; tool; please see its "
2595
2595
"documentation for more information about the options here."
2598
2598
#. type: Content of: <refentry><refsect1><title>
2599
#: apt.conf.5.xml:282
2599
#: apt.conf.5.xml:284
2600
2600
msgid "The Acquire Group"
2603
2603
#. type: Content of: <refentry><refsect1><para>
2604
#: apt.conf.5.xml:283
2604
#: apt.conf.5.xml:285
2606
2606
"The <literal>Acquire</literal> group of options controls the download of "
2607
2607
"packages as well as the various \"acquire methods\" responsible for the "
2678
2678
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2679
#: apt.conf.5.xml:348
2679
#: apt.conf.5.xml:350
2681
2681
"Number of retries to perform. If this is non-zero APT will retry failed "
2682
2682
"files the given number of times."
2685
2685
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2686
#: apt.conf.5.xml:353
2686
#: apt.conf.5.xml:355
2688
2688
"Use symlinks for source archives. If set to true then source archives will "
2689
2689
"be symlinked when possible instead of copying. True is the default."
2692
2692
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2693
#: apt.conf.5.xml:358
2693
#: apt.conf.5.xml:360
2695
2695
"<literal>http::Proxy</literal> sets the default proxy to use for HTTP "
2696
2696
"URIs. It is in the standard form of "
3148
3148
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3149
#: apt.conf.5.xml:666
3149
#: apt.conf.5.xml:668
3151
3151
"The contents of this variable are passed to &apt-get; as command line "
3152
3152
"options when it is run for the install phase."
3155
3155
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3156
#: apt.conf.5.xml:671
3156
#: apt.conf.5.xml:673
3158
3158
"The contents of this variable are passed to &apt-get; as command line "
3159
3159
"options when it is run for the update phase."
3162
3162
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3163
#: apt.conf.5.xml:676
3163
#: apt.conf.5.xml:678
3165
3165
"If true the [U]pdate operation in &dselect; will always prompt to continue. "
3166
3166
"The default is to prompt only on error."
3169
3169
#. type: Content of: <refentry><refsect1><title>
3170
#: apt.conf.5.xml:682
3170
#: apt.conf.5.xml:684
3171
3171
msgid "How APT calls &dpkg;"
3174
3174
#. type: Content of: <refentry><refsect1><para>
3175
#: apt.conf.5.xml:683
3175
#: apt.conf.5.xml:685
3177
3177
"Several configuration directives control how APT invokes &dpkg;. These are "
3178
3178
"in the <literal>DPkg</literal> section."
3181
3181
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3182
#: apt.conf.5.xml:688
3182
#: apt.conf.5.xml:690
3184
3184
"This is a list of options to pass to &dpkg;. The options must be specified "
3185
3185
"using the list notation and each list item is passed as a single argument to "
3240
3240
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3241
#: apt.conf.5.xml:730
3241
#: apt.conf.5.xml:732
3243
3243
"APT chdirs to this directory before invoking &dpkg;, the default is "
3244
3244
"<filename>/</filename>."
3247
3247
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3248
#: apt.conf.5.xml:735
3248
#: apt.conf.5.xml:737
3250
3250
"These options are passed to &dpkg-buildpackage; when compiling packages; the "
3251
3251
"default is to disable signing and produce all binaries."
3254
3254
#. type: Content of: <refentry><refsect1><refsect2><title>
3255
#: apt.conf.5.xml:740
3255
#: apt.conf.5.xml:742
3256
3256
msgid "dpkg trigger usage (and related options)"
3259
3259
#. type: Content of: <refentry><refsect1><refsect2><para>
3260
#: apt.conf.5.xml:741
3260
#: apt.conf.5.xml:743
3262
3262
"APT can call &dpkg; in such a way as to let it make aggressive use of "
3263
3263
"triggers over multiple calls of &dpkg;. Without further options &dpkg; will "
3432
3432
#. motivating example, except I haven't a clue why you'd want
3434
3434
#. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
3435
#: apt.conf.5.xml:866
3435
#: apt.conf.5.xml:868
3437
3437
"<literal>Debug::IdentCdrom</literal> disables the inclusion of statfs data "
3438
3438
"in CD-ROM IDs."
3441
3441
#. type: Content of: <refentry><refsect1><para>
3442
#: apt.conf.5.xml:876
3442
#: apt.conf.5.xml:878
3443
3443
msgid "A full list of debugging options to apt follows."
3446
3446
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3447
#: apt.conf.5.xml:885
3447
#: apt.conf.5.xml:887
3448
3448
msgid "Print information related to accessing <literal>cdrom://</literal> sources."
3451
3451
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3452
#: apt.conf.5.xml:896
3452
#: apt.conf.5.xml:898
3453
3453
msgid "Print information related to downloading packages using FTP."
3456
3456
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3457
#: apt.conf.5.xml:907
3457
#: apt.conf.5.xml:909
3458
3458
msgid "Print information related to downloading packages using HTTP."
3461
3461
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3462
#: apt.conf.5.xml:918
3462
#: apt.conf.5.xml:920
3463
3463
msgid "Print information related to downloading packages using HTTPS."
3466
3466
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3467
#: apt.conf.5.xml:929
3467
#: apt.conf.5.xml:931
3469
3469
"Print information related to verifying cryptographic signatures using "
3470
3470
"<literal>gpg</literal>."
3473
3473
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3474
#: apt.conf.5.xml:940
3474
#: apt.conf.5.xml:942
3476
3476
"Output information about the process of accessing collections of packages "
3477
3477
"stored on CD-ROMs."
3480
3480
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3481
#: apt.conf.5.xml:950
3481
#: apt.conf.5.xml:952
3482
3482
msgid "Describes the process of resolving build-dependencies in &apt-get;."
3485
3485
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3486
#: apt.conf.5.xml:960
3486
#: apt.conf.5.xml:962
3488
3488
"Output each cryptographic hash that is generated by the "
3489
3489
"<literal>apt</literal> libraries."
3492
3492
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3493
#: apt.conf.5.xml:970
3493
#: apt.conf.5.xml:972
3495
3495
"Do not include information from <literal>statfs</literal>, namely the number "
3496
3496
"of used and free blocks on the CD-ROM filesystem, when generating an ID for "
3500
3500
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3501
#: apt.conf.5.xml:981
3501
#: apt.conf.5.xml:983
3503
3503
"Disable all file locking. For instance, this will allow two instances of "
3504
3504
"<quote><literal>apt-get update</literal></quote> to run at the same time."
3507
3507
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3508
#: apt.conf.5.xml:993
3508
#: apt.conf.5.xml:995
3509
3509
msgid "Log when items are added to or removed from the global download queue."
3512
3512
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3513
#: apt.conf.5.xml:1003
3513
#: apt.conf.5.xml:1005
3515
3515
"Output status messages and errors related to verifying checksums and "
3516
3516
"cryptographic signatures of downloaded files."
3519
3519
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3520
#: apt.conf.5.xml:1013
3520
#: apt.conf.5.xml:1015
3522
3522
"Output information about downloading and applying package index list diffs, "
3523
3523
"and errors relating to package index list diffs."
3526
3526
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3527
#: apt.conf.5.xml:1025
3527
#: apt.conf.5.xml:1027
3529
3529
"Output information related to patching apt package lists when downloading "
3530
3530
"index diffs instead of full indices."
3533
3533
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3534
#: apt.conf.5.xml:1036
3534
#: apt.conf.5.xml:1038
3535
3535
msgid "Log all interactions with the sub-processes that actually perform downloads."
3538
3538
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3539
#: apt.conf.5.xml:1047
3539
#: apt.conf.5.xml:1049
3541
3541
"Log events related to the automatically-installed status of packages and to "
3542
3542
"the removal of unused packages."
3545
3545
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3546
#: apt.conf.5.xml:1057
3546
#: apt.conf.5.xml:1059
3548
3548
"Generate debug messages describing which packages are being automatically "
3549
3549
"installed to resolve dependencies. This corresponds to the initial "
3573
3573
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3574
#: apt.conf.5.xml:1092
3574
#: apt.conf.5.xml:1094
3576
3576
"When invoking &dpkg;, output the precise command line with which it is being "
3577
3577
"invoked, with arguments separated by a single space character."
3580
3580
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3581
#: apt.conf.5.xml:1103
3581
#: apt.conf.5.xml:1105
3583
3583
"Output all the data received from &dpkg; on the status file descriptor and "
3584
3584
"any errors encountered while parsing it."
3587
3587
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3588
#: apt.conf.5.xml:1114
3588
#: apt.conf.5.xml:1116
3590
3590
"Generate a trace of the algorithm that decides the order in which "
3591
3591
"<literal>apt</literal> should pass packages to &dpkg;."
3594
3594
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3595
#: apt.conf.5.xml:1126
3595
#: apt.conf.5.xml:1128
3596
3596
msgid "Output status messages tracing the steps performed when invoking &dpkg;."
3599
3599
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3600
#: apt.conf.5.xml:1137
3600
#: apt.conf.5.xml:1139
3601
3601
msgid "Output the priority of each package list on startup."
3604
3604
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3605
#: apt.conf.5.xml:1147
3605
#: apt.conf.5.xml:1149
3607
3607
"Trace the execution of the dependency resolver (this applies only to what "
3608
3608
"happens when a complex dependency problem is encountered)."
3611
3611
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3612
#: apt.conf.5.xml:1158
3612
#: apt.conf.5.xml:1160
3614
3614
"Display a list of all installed packages with their calculated score used by "
3615
3615
"the pkgProblemResolver. The description of the package is the same as "
3638
3638
#. ? reading apt.conf
3639
3639
#. type: Content of: <refentry><refsect1><para>
3640
#: apt.conf.5.xml:1205
3640
#: apt.conf.5.xml:1207
3641
3641
msgid "&apt-cache;, &apt-config;, &apt-preferences;."
3644
3644
#. type: Content of: <refentry><refnamediv><refpurpose>
3645
#: apt_preferences.5.xml:32
3645
#: apt_preferences.5.xml:34
3646
3646
msgid "Preference control file for APT"
3649
3649
#. type: Content of: <refentry><refsect1><para>
3650
#: apt_preferences.5.xml:37
3650
#: apt_preferences.5.xml:39
3652
3652
"The APT preferences file <filename>/etc/apt/preferences</filename> and the "
3653
3653
"fragment files in the <filename>/etc/apt/preferences.d/</filename> folder "
3744
3744
#. type: Content of: <refentry><refsect1><refsect2><para>
3745
#: apt_preferences.5.xml:101
3745
#: apt_preferences.5.xml:103
3747
3747
"If the target release has been specified then APT uses the following "
3748
3748
"algorithm to set the priorities of the versions of a package. Assign:"
3751
3751
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
3752
#: apt_preferences.5.xml:106
3752
#: apt_preferences.5.xml:108
3753
3753
msgid "priority 1"
3756
3756
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
3757
#: apt_preferences.5.xml:107
3757
#: apt_preferences.5.xml:109
3759
3759
"to the versions coming from archives which in their "
3760
3760
"<filename>Release</filename> files are marked as \"NotAutomatic: yes\" but "
3779
3779
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
3780
#: apt_preferences.5.xml:121
3780
#: apt_preferences.5.xml:123
3781
3781
msgid "priority 500"
3784
3784
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
3785
#: apt_preferences.5.xml:122
3785
#: apt_preferences.5.xml:124
3787
3787
"to the versions that are not installed and do not belong to the target "
3791
3791
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
3792
#: apt_preferences.5.xml:126
3792
#: apt_preferences.5.xml:128
3793
3793
msgid "priority 990"
3796
3796
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
3797
#: apt_preferences.5.xml:127
3797
#: apt_preferences.5.xml:129
3798
3798
msgid "to the versions that are not installed and belong to the target release."
3801
3801
#. type: Content of: <refentry><refsect1><refsect2><para>
3802
#: apt_preferences.5.xml:132
3802
#: apt_preferences.5.xml:134
3804
3804
"If the target release has not been specified then APT simply assigns "
3805
3805
"priority 100 to all installed package versions and priority 500 to all "
3812
3812
#. type: Content of: <refentry><refsect1><refsect2><para>
3813
#: apt_preferences.5.xml:139
3813
#: apt_preferences.5.xml:141
3815
3815
"APT then applies the following rules, listed in order of precedence, to "
3816
3816
"determine which version of a package to install."
3819
3819
#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
3820
#: apt_preferences.5.xml:142
3820
#: apt_preferences.5.xml:144
3822
3822
"Never downgrade unless the priority of an available version exceeds 1000. "
3823
3823
"(\"Downgrading\" is installing a less recent version of a package in place "
3829
3829
#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
3830
#: apt_preferences.5.xml:148
3830
#: apt_preferences.5.xml:150
3831
3831
msgid "Install the highest priority version."
3834
3834
#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
3835
#: apt_preferences.5.xml:149
3835
#: apt_preferences.5.xml:151
3837
3837
"If two or more versions have the same priority, install the most recent one "
3838
3838
"(that is, the one with the higher version number)."
3841
3841
#. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
3842
#: apt_preferences.5.xml:152
3842
#: apt_preferences.5.xml:154
3844
3844
"If two or more versions have the same priority and version number but either "
3845
3845
"the packages differ in some of their metadata or the "
4022
4022
#. type: Content of: <refentry><refsect1><refsect2><title>
4023
#: apt_preferences.5.xml:262
4023
#: apt_preferences.5.xml:264
4024
4024
msgid "Regular expressions and &glob; syntax"
4027
4027
#. type: Content of: <refentry><refsect1><refsect2><para>
4028
#: apt_preferences.5.xml:264
4028
#: apt_preferences.5.xml:266
4030
4030
"APT also supports pinning by &glob; expressions, and regular expressions "
4031
4031
"surrounded by slashes. For example, the following example assigns the "
4074
4074
#. type: Content of: <refentry><refsect1><refsect2><title>
4075
#: apt_preferences.5.xml:307
4075
#: apt_preferences.5.xml:309
4076
4076
msgid "How APT Interprets Priorities"
4079
4079
#. type: Content of: <refentry><refsect1><refsect2><para>
4080
#: apt_preferences.5.xml:310
4080
#: apt_preferences.5.xml:312
4082
4082
"Priorities (P) assigned in the APT preferences file must be positive or "
4083
4083
"negative integers. They are interpreted as follows (roughly speaking):"
4086
4086
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
4087
#: apt_preferences.5.xml:315
4087
#: apt_preferences.5.xml:317
4088
4088
msgid "P >= 1000"
4091
4091
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
4092
#: apt_preferences.5.xml:316
4092
#: apt_preferences.5.xml:318
4094
4094
"causes a version to be installed even if this constitutes a downgrade of the "
4098
4098
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
4099
#: apt_preferences.5.xml:320
4099
#: apt_preferences.5.xml:322
4100
4100
msgid "990 <= P < 1000"
4103
4103
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
4104
#: apt_preferences.5.xml:321
4104
#: apt_preferences.5.xml:323
4106
4106
"causes a version to be installed even if it does not come from the target "
4107
4107
"release, unless the installed version is more recent"
4110
4110
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
4111
#: apt_preferences.5.xml:326
4111
#: apt_preferences.5.xml:328
4112
4112
msgid "500 <= P < 990"
4115
4115
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
4116
#: apt_preferences.5.xml:327
4116
#: apt_preferences.5.xml:329
4118
4118
"causes a version to be installed unless there is a version available "
4119
4119
"belonging to the target release or the installed version is more recent"
4122
4122
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
4123
#: apt_preferences.5.xml:332
4123
#: apt_preferences.5.xml:334
4124
4124
msgid "100 <= P < 500"
4127
4127
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
4128
#: apt_preferences.5.xml:333
4128
#: apt_preferences.5.xml:335
4130
4130
"causes a version to be installed unless there is a version available "
4131
4131
"belonging to some other distribution or the installed version is more recent"
4134
4134
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
4135
#: apt_preferences.5.xml:338
4135
#: apt_preferences.5.xml:340
4136
4136
msgid "0 < P < 100"
4139
4139
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
4140
#: apt_preferences.5.xml:339
4140
#: apt_preferences.5.xml:341
4142
4142
"causes a version to be installed only if there is no installed version of "
4146
4146
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
4147
#: apt_preferences.5.xml:343
4147
#: apt_preferences.5.xml:345
4148
4148
msgid "P < 0"
4151
4151
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
4152
#: apt_preferences.5.xml:344
4152
#: apt_preferences.5.xml:346
4153
4153
msgid "prevents the version from being installed"
4156
4156
#. type: Content of: <refentry><refsect1><refsect2><para>
4157
#: apt_preferences.5.xml:349
4157
#: apt_preferences.5.xml:351
4159
4159
"If any specific-form records match an available package version then the "
4160
4160
"first such record determines the priority of the package version. Failing "
4247
4247
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
4248
#: apt_preferences.5.xml:407
4248
#: apt_preferences.5.xml:409
4249
4249
msgid "the <literal>Package:</literal> line"
4252
4252
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
4253
#: apt_preferences.5.xml:408
4253
#: apt_preferences.5.xml:410
4254
4254
msgid "gives the package name"
4257
4257
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
4258
#: apt_preferences.5.xml:411 apt_preferences.5.xml:461
4258
#: apt_preferences.5.xml:413 apt_preferences.5.xml:463
4259
4259
msgid "the <literal>Version:</literal> line"
4262
4262
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
4263
#: apt_preferences.5.xml:412
4263
#: apt_preferences.5.xml:414
4264
4264
msgid "gives the version number for the named package"
4267
4267
#. type: Content of: <refentry><refsect1><refsect2><para>
4268
#: apt_preferences.5.xml:417
4268
#: apt_preferences.5.xml:419
4270
4270
"The <filename>Release</filename> file is normally found in the directory "
4271
4271
"<filename>.../dists/<replaceable>dist-name</replaceable></filename>: for "
4280
4280
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
4281
#: apt_preferences.5.xml:428
4281
#: apt_preferences.5.xml:430
4282
4282
msgid "the <literal>Archive:</literal> or <literal>Suite:</literal> line"
4285
4285
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
4286
#: apt_preferences.5.xml:429
4286
#: apt_preferences.5.xml:431
4288
4288
"names the archive to which all the packages in the directory tree belong. "
4289
4289
"For example, the line \"Archive: stable\" or \"Suite: stable\" specifies "
4296
4296
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
4297
#: apt_preferences.5.xml:439
4297
#: apt_preferences.5.xml:441
4299
4299
msgid "Pin: release a=stable\n"
4302
4302
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
4303
#: apt_preferences.5.xml:445
4303
#: apt_preferences.5.xml:447
4304
4304
msgid "the <literal>Codename:</literal> line"
4307
4307
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
4308
#: apt_preferences.5.xml:446
4308
#: apt_preferences.5.xml:448
4310
4310
"names the codename to which all the packages in the directory tree belong. "
4311
4311
"For example, the line \"Codename: &testing-codename;\" specifies that all of "
4318
4318
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
4319
#: apt_preferences.5.xml:455
4319
#: apt_preferences.5.xml:457
4321
4321
msgid "Pin: release n=&testing-codename;\n"
4324
4324
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
4325
#: apt_preferences.5.xml:462
4325
#: apt_preferences.5.xml:464
4327
4327
"names the release version. For example, the packages in the tree might "
4328
4328
"belong to Debian release version &stable-version;. Note that there is "
4344
4344
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
4345
#: apt_preferences.5.xml:480
4345
#: apt_preferences.5.xml:482
4346
4346
msgid "the <literal>Component:</literal> line"
4349
4349
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
4350
#: apt_preferences.5.xml:481
4350
#: apt_preferences.5.xml:483
4352
4352
"names the licensing component associated with the packages in the directory "
4353
4353
"tree of the <filename>Release</filename> file. For example, the line "
4361
4361
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
4362
#: apt_preferences.5.xml:490
4362
#: apt_preferences.5.xml:492
4364
4364
msgid "Pin: release c=main\n"
4367
4367
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
4368
#: apt_preferences.5.xml:496
4368
#: apt_preferences.5.xml:498
4369
4369
msgid "the <literal>Origin:</literal> line"
4372
4372
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
4373
#: apt_preferences.5.xml:497
4373
#: apt_preferences.5.xml:499
4375
4375
"names the originator of the packages in the directory tree of the "
4376
4376
"<filename>Release</filename> file. Most commonly, this is "
4381
4381
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
4382
#: apt_preferences.5.xml:503
4382
#: apt_preferences.5.xml:505
4384
4384
msgid "Pin: release o=Debian\n"
4387
4387
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
4388
#: apt_preferences.5.xml:509
4388
#: apt_preferences.5.xml:511
4389
4389
msgid "the <literal>Label:</literal> line"
4392
4392
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
4393
#: apt_preferences.5.xml:510
4393
#: apt_preferences.5.xml:512
4395
4395
"names the label of the packages in the directory tree of the "
4396
4396
"<filename>Release</filename> file. Most commonly, this is "
4816
4816
#. type: Content of: <refentry><refsect1><title>
4817
#: sources.list.5.xml:145
4817
#: sources.list.5.xml:147
4818
4818
msgid "URI specification"
4821
4821
#. type: Content of: <refentry><refsect1><para>
4822
#: sources.list.5.xml:147
4822
#: sources.list.5.xml:149
4823
4823
msgid "The currently recognized URI types are:"
4826
4826
#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
4827
#: sources.list.5.xml:151
4827
#: sources.list.5.xml:153
4829
4829
"The file scheme allows an arbitrary directory in the file system to be "
4830
4830
"considered an archive. This is useful for NFS mounts and local mirrors or "
4901
4901
#. type: Content of: <refentry><refsect1><para>
4902
#: sources.list.5.xml:216
4902
#: sources.list.5.xml:218
4904
4904
"Uses the archive stored locally (or NFS mounted) at /home/jason/debian for "
4905
4905
"stable/main, stable/contrib, and stable/non-free."
4908
4908
#. type: Content of: <refentry><refsect1><literallayout>
4909
#: sources.list.5.xml:218
4909
#: sources.list.5.xml:220
4911
4911
msgid "deb file:/home/jason/debian stable main contrib non-free"
4914
4914
#. type: Content of: <refentry><refsect1><para>
4915
#: sources.list.5.xml:220
4915
#: sources.list.5.xml:222
4916
4916
msgid "As above, except this uses the unstable (development) distribution."
4919
4919
#. type: Content of: <refentry><refsect1><literallayout>
4920
#: sources.list.5.xml:221
4920
#: sources.list.5.xml:223
4922
4922
msgid "deb file:/home/jason/debian unstable main contrib non-free"
4925
4925
#. type: Content of: <refentry><refsect1><para>
4926
#: sources.list.5.xml:223
4926
#: sources.list.5.xml:225
4927
4927
msgid "Source line for the above"
4930
4930
#. type: Content of: <refentry><refsect1><literallayout>
4931
#: sources.list.5.xml:224
4931
#: sources.list.5.xml:226
4933
4933
msgid "deb-src file:/home/jason/debian unstable main contrib non-free"
4936
4936
#. type: Content of: <refentry><refsect1><para>
4937
#: sources.list.5.xml:226
4937
#: sources.list.5.xml:228
4939
4939
"The first line gets package information for the architectures in "
4940
4940
"<literal>APT::Architectures</literal> while the second always retrieves "
4952
4952
#. type: Content of: <refentry><refsect1><para>
4953
#: sources.list.5.xml:231
4953
#: sources.list.5.xml:233
4955
4955
"Uses HTTP to access the archive at archive.debian.org, and uses only the "
4956
4956
"hamm/main area."
4959
4959
#. type: Content of: <refentry><refsect1><literallayout>
4960
#: sources.list.5.xml:233
4960
#: sources.list.5.xml:235
4962
4962
msgid "deb http://archive.debian.org/debian-archive hamm main"
4965
4965
#. type: Content of: <refentry><refsect1><para>
4966
#: sources.list.5.xml:235
4966
#: sources.list.5.xml:237
4968
4968
"Uses FTP to access the archive at ftp.debian.org, under the debian "
4969
4969
"directory, and uses only the &stable-codename;/contrib area."
4972
4972
#. type: Content of: <refentry><refsect1><literallayout>
4973
#: sources.list.5.xml:237
4973
#: sources.list.5.xml:239
4975
4975
msgid "deb ftp://ftp.debian.org/debian &stable-codename; contrib"
4978
4978
#. type: Content of: <refentry><refsect1><para>
4979
#: sources.list.5.xml:239
4979
#: sources.list.5.xml:241
4981
4981
"Uses FTP to access the archive at ftp.debian.org, under the debian "
4982
4982
"directory, and uses only the unstable/contrib area. If this line appears as "
4987
4987
#. type: Content of: <refentry><refsect1><literallayout>
4988
#: sources.list.5.xml:243
4988
#: sources.list.5.xml:245
4990
4990
msgid "deb ftp://ftp.debian.org/debian unstable contrib"
4993
4993
#. type: Content of: <refentry><refsect1><para><literallayout>
4994
#: sources.list.5.xml:252
4994
#: sources.list.5.xml:254
4996
4996
msgid "deb http://ftp.tlh.debian.org/universe unstable/binary-$(ARCH)/"
4999
4999
#. type: Content of: <refentry><refsect1><para>
5000
#: sources.list.5.xml:245
5000
#: sources.list.5.xml:247
5002
5002
"Uses HTTP to access the archive at ftp.tlh.debian.org, under the universe "
5003
5003
"directory, and uses only files found under "
5011
5011
#. type: Content of: <refentry><refsect1><para>
5012
#: sources.list.5.xml:257
5012
#: sources.list.5.xml:259
5013
5013
msgid "&apt-cache; &apt-conf;"
5016
5016
#. type: Content of: <refentry><refmeta><manvolnum>
5017
#: apt-extracttemplates.1.xml:26 apt-sortpkgs.1.xml:26 apt-ftparchive.1.xml:26
5017
#: apt-extracttemplates.1.xml:28 apt-sortpkgs.1.xml:28 apt-ftparchive.1.xml:28
5021
5021
#. type: Content of: <refentry><refnamediv><refpurpose>
5022
#: apt-extracttemplates.1.xml:33
5022
#: apt-extracttemplates.1.xml:35
5024
5024
"Utility to extract <command>debconf</command> config and templates from "
5025
5025
"Debian packages"
5028
5028
#. type: Content of: <refentry><refsect1><para>
5029
#: apt-extracttemplates.1.xml:39
5029
#: apt-extracttemplates.1.xml:41
5031
5031
"<command>apt-extracttemplates</command> will take one or more Debian package "
5032
5032
"files as input and write out (to a temporary directory) all associated "
5082
5082
#. type: Content of: <refentry><refsect1><para>
5083
#: apt-sortpkgs.1.xml:45
5083
#: apt-sortpkgs.1.xml:47
5084
5084
msgid "All output is sent to standard output; the input must be a seekable file."
5087
5087
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5088
#: apt-sortpkgs.1.xml:54
5088
#: apt-sortpkgs.1.xml:56
5090
5090
"Use source index field ordering. Configuration Item: "
5091
5091
"<literal>APT::SortPkgs::Source</literal>."
5094
5094
#. type: Content of: <refentry><refsect1><para>
5095
#: apt-sortpkgs.1.xml:68
5095
#: apt-sortpkgs.1.xml:70
5097
5097
"<command>apt-sortpkgs</command> returns zero on normal operation, decimal "
5098
5098
"100 on error."
5101
5101
#. type: Content of: <refentry><refnamediv><refpurpose>
5102
#: apt-ftparchive.1.xml:33
5102
#: apt-ftparchive.1.xml:35
5103
5103
msgid "Utility to generate index files"
5106
5106
#. type: Content of: <refentry><refsect1><para>
5107
#: apt-ftparchive.1.xml:39
5107
#: apt-ftparchive.1.xml:41
5109
5109
"<command>apt-ftparchive</command> is the command line tool that generates "
5110
5110
"the index files that APT uses to access a distribution source. The index "
5217
5217
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5218
#: apt-ftparchive.1.xml:126
5218
#: apt-ftparchive.1.xml:128
5220
5220
"The <literal>clean</literal> command tidies the databases used by the given "
5221
5221
"configuration file by removing any records that are no longer necessary."
5224
5224
#. type: Content of: <refentry><refsect1><title>
5225
#: apt-ftparchive.1.xml:132
5225
#: apt-ftparchive.1.xml:134
5226
5226
msgid "The Generate Configuration"
5229
5229
#. type: Content of: <refentry><refsect1><para>
5230
#: apt-ftparchive.1.xml:134
5230
#: apt-ftparchive.1.xml:136
5232
5232
"The <literal>generate</literal> command uses a configuration file to "
5233
5233
"describe the archives that are going to be generated. It follows the typical "
5240
5240
#. type: Content of: <refentry><refsect1><para>
5241
#: apt-ftparchive.1.xml:142
5241
#: apt-ftparchive.1.xml:144
5242
5242
msgid "The generate configuration has four separate sections, each described below."
5245
5245
#. type: Content of: <refentry><refsect1><refsect2><title>
5246
#: apt-ftparchive.1.xml:144
5246
#: apt-ftparchive.1.xml:146
5247
5247
msgid "<literal>Dir</literal> Section"
5250
5250
#. type: Content of: <refentry><refsect1><refsect2><para>
5251
#: apt-ftparchive.1.xml:146
5251
#: apt-ftparchive.1.xml:148
5253
5253
"The <literal>Dir</literal> section defines the standard directories needed "
5254
5254
"to locate the files required during the generation process. These "
5267
5267
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5268
#: apt-ftparchive.1.xml:160
5268
#: apt-ftparchive.1.xml:162
5269
5269
msgid "Specifies the location of the override files."
5272
5272
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5273
#: apt-ftparchive.1.xml:165
5273
#: apt-ftparchive.1.xml:167
5274
5274
msgid "Specifies the location of the cache files."
5277
5277
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5278
#: apt-ftparchive.1.xml:170
5278
#: apt-ftparchive.1.xml:172
5280
5280
"Specifies the location of the file list files, if the "
5281
5281
"<literal>FileList</literal> setting is used below."
5284
5284
#. type: Content of: <refentry><refsect1><refsect2><title>
5285
#: apt-ftparchive.1.xml:176
5285
#: apt-ftparchive.1.xml:178
5286
5286
msgid "<literal>Default</literal> Section"
5289
5289
#. type: Content of: <refentry><refsect1><refsect2><para>
5290
#: apt-ftparchive.1.xml:178
5290
#: apt-ftparchive.1.xml:180
5292
5292
"The <literal>Default</literal> section specifies default values, and "
5293
5293
"settings that control the operation of the generator. Other sections may "
5306
5306
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5307
#: apt-ftparchive.1.xml:192
5307
#: apt-ftparchive.1.xml:194
5309
5309
"Sets the default list of file extensions that are package files. This "
5310
5310
"defaults to '.deb'."
5313
5313
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5314
#: apt-ftparchive.1.xml:198
5314
#: apt-ftparchive.1.xml:200
5316
5316
"This is similar to <literal>Packages::Compress</literal> except that it "
5317
5317
"controls the compression for the Sources files."
5320
5320
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5321
#: apt-ftparchive.1.xml:204
5321
#: apt-ftparchive.1.xml:206
5323
5323
"Sets the default list of file extensions that are source files. This "
5324
5324
"defaults to '.dsc'."
5327
5327
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5328
#: apt-ftparchive.1.xml:210
5328
#: apt-ftparchive.1.xml:212
5330
5330
"This is similar to <literal>Packages::Compress</literal> except that it "
5331
5331
"controls the compression for the Contents files."
5334
5334
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5335
#: apt-ftparchive.1.xml:216
5335
#: apt-ftparchive.1.xml:218
5337
5337
"This is similar to <literal>Packages::Compress</literal> except that it "
5338
5338
"controls the compression for the Translation-en master file."
5341
5341
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5342
#: apt-ftparchive.1.xml:222
5342
#: apt-ftparchive.1.xml:224
5344
5344
"Specifies the number of kilobytes to delink (and replace with hard links) "
5345
5345
"per run. This is used in conjunction with the per-section "
5349
5349
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5350
#: apt-ftparchive.1.xml:229
5350
#: apt-ftparchive.1.xml:231
5352
5352
"Specifies the mode of all created index files. It defaults to 0644. All "
5353
5353
"index files are set to this mode with no regard to the umask."
5356
5356
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5357
#: apt-ftparchive.1.xml:236 apt-ftparchive.1.xml:382
5357
#: apt-ftparchive.1.xml:238 apt-ftparchive.1.xml:384
5359
5359
"Specifies whether long descriptions should be included in the "
5360
5360
"<filename>Packages</filename> file or split out into a master "
5396
5396
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5397
#: apt-ftparchive.1.xml:269
5397
#: apt-ftparchive.1.xml:271
5399
5399
"Sets the top of the .deb directory tree. Defaults to "
5400
5400
"<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/</filename>"
5403
5403
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5404
#: apt-ftparchive.1.xml:275
5404
#: apt-ftparchive.1.xml:277
5406
5406
"Sets the top of the source package directory tree. Defaults to "
5407
5407
"<filename>$(DIST)/$(SECTION)/source/</filename>"
5410
5410
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5411
#: apt-ftparchive.1.xml:281
5411
#: apt-ftparchive.1.xml:283
5413
5413
"Sets the output Packages file. Defaults to "
5414
5414
"<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/Packages</filename>"
5417
5417
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5418
#: apt-ftparchive.1.xml:287
5418
#: apt-ftparchive.1.xml:289
5420
5420
"Sets the output Sources file. Defaults to "
5421
5421
"<filename>$(DIST)/$(SECTION)/source/Sources</filename>"
5424
5424
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5425
#: apt-ftparchive.1.xml:293
5425
#: apt-ftparchive.1.xml:295
5427
5427
"Sets the output Translation-en master file with the long descriptions if "
5428
5428
"they should be not included in the Packages file. Defaults to "
5450
5450
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5451
#: apt-ftparchive.1.xml:316
5451
#: apt-ftparchive.1.xml:318
5452
5452
msgid "Sets header file to prepend to the contents output."
5455
5455
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5456
#: apt-ftparchive.1.xml:321
5456
#: apt-ftparchive.1.xml:323
5458
5458
"Sets the binary cache database to use for this section. Multiple sections "
5459
5459
"can share the same database."
5462
5462
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5463
#: apt-ftparchive.1.xml:327
5463
#: apt-ftparchive.1.xml:329
5465
5465
"Specifies that instead of walking the directory tree, "
5466
5466
"<command>apt-ftparchive</command> should read the list of files from the "
5545
5545
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5546
#: apt-ftparchive.1.xml:388
5546
#: apt-ftparchive.1.xml:390
5548
5548
"Sets the binary override file. The override file contains section, priority "
5549
5549
"and maintainer address information."
5552
5552
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5553
#: apt-ftparchive.1.xml:394
5553
#: apt-ftparchive.1.xml:396
5555
5555
"Sets the source override file. The override file contains section "
5559
5559
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5560
#: apt-ftparchive.1.xml:400 apt-ftparchive.1.xml:446
5560
#: apt-ftparchive.1.xml:402 apt-ftparchive.1.xml:448
5561
5561
msgid "Sets the binary extra override file."
5564
5564
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5565
#: apt-ftparchive.1.xml:405 apt-ftparchive.1.xml:451
5565
#: apt-ftparchive.1.xml:407 apt-ftparchive.1.xml:453
5566
5566
msgid "Sets the source extra override file."
5569
5569
#. type: Content of: <refentry><refsect1><refsect2><title>
5570
#: apt-ftparchive.1.xml:410
5570
#: apt-ftparchive.1.xml:412
5571
5571
msgid "<literal>BinDirectory</literal> Section"
5574
5574
#. type: Content of: <refentry><refsect1><refsect2><para>
5575
#: apt-ftparchive.1.xml:412
5575
#: apt-ftparchive.1.xml:414
5577
5577
"The <literal>bindirectory</literal> section defines a binary directory tree "
5578
5578
"with no special structure. The scope tag specifies the location of the "
5584
5584
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5585
#: apt-ftparchive.1.xml:420
5585
#: apt-ftparchive.1.xml:422
5586
5586
msgid "Sets the Packages file output."
5589
5589
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5590
#: apt-ftparchive.1.xml:425
5590
#: apt-ftparchive.1.xml:427
5592
5592
"Sets the Sources file output. At least one of <literal>Packages</literal> or "
5593
5593
"<literal>Sources</literal> is required."
5596
5596
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5597
#: apt-ftparchive.1.xml:431
5597
#: apt-ftparchive.1.xml:433
5598
5598
msgid "Sets the Contents file output (optional)."
5601
5601
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5602
#: apt-ftparchive.1.xml:436
5602
#: apt-ftparchive.1.xml:438
5603
5603
msgid "Sets the binary override file."
5606
5606
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5607
#: apt-ftparchive.1.xml:441
5607
#: apt-ftparchive.1.xml:443
5608
5608
msgid "Sets the source override file."
5611
5611
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5612
#: apt-ftparchive.1.xml:456
5612
#: apt-ftparchive.1.xml:458
5613
5613
msgid "Sets the cache DB."
5616
5616
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5617
#: apt-ftparchive.1.xml:461
5617
#: apt-ftparchive.1.xml:463
5618
5618
msgid "Appends a path to all the output paths."
5621
5621
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5622
#: apt-ftparchive.1.xml:466
5622
#: apt-ftparchive.1.xml:468
5623
5623
msgid "Specifies the file list file."
5626
5626
#. type: Content of: <refentry><refsect1><title>
5627
#: apt-ftparchive.1.xml:473
5627
#: apt-ftparchive.1.xml:475
5628
5628
msgid "The Binary Override File"
5631
5631
#. type: Content of: <refentry><refsect1><para>
5632
#: apt-ftparchive.1.xml:474
5632
#: apt-ftparchive.1.xml:476
5634
5634
"The binary override file is fully compatible with &dpkg-scanpackages;. It "
5635
5635
"contains four fields separated by spaces. The first field is the package "
5641
5641
#. type: Content of: <refentry><refsect1><para><literallayout>
5642
#: apt-ftparchive.1.xml:480
5642
#: apt-ftparchive.1.xml:482
5644
5644
msgid "old [// oldn]* => new"
5647
5647
#. type: Content of: <refentry><refsect1><para><literallayout>
5648
#: apt-ftparchive.1.xml:482
5648
#: apt-ftparchive.1.xml:484
5653
5653
#. type: Content of: <refentry><refsect1><para>
5654
#: apt-ftparchive.1.xml:479
5654
#: apt-ftparchive.1.xml:481
5656
5656
"The general form of the maintainer field is: <placeholder "
5657
5657
"type=\"literallayout\" id=\"0\"/> or simply, <placeholder "
5706
5706
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5707
#: apt-ftparchive.1.xml:521
5707
#: apt-ftparchive.1.xml:523
5709
5709
"Use a binary caching DB. This has no effect on the generate command. "
5710
5710
"Configuration Item: <literal>APT::FTPArchive::DB</literal>."
5713
5713
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5714
#: apt-ftparchive.1.xml:527
5714
#: apt-ftparchive.1.xml:529
5716
5716
"Quiet; produces output suitable for logging, omitting progress indicators. "
5717
5717
"More q's will produce more quiet up to a maximum of 2. You can also use "
5749
5749
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5750
#: apt-ftparchive.1.xml:559
5750
#: apt-ftparchive.1.xml:561
5752
5752
"Make the caching databases read only. Configuration Item: "
5753
5753
"<literal>APT::FTPArchive::ReadOnlyDB</literal>."
5756
5756
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5757
#: apt-ftparchive.1.xml:564
5757
#: apt-ftparchive.1.xml:566
5759
5759
"Accept in the <literal>packages</literal> and <literal>contents</literal> "
5760
5760
"commands only package files matching <literal>*_arch.deb</literal> or "