2443
2443
"Configuration Items: "
2444
2444
"<literal>APT::FTPArchive::<replaceable>Checksum</replaceable></literal> and "
2445
2445
"<literal>APT::FTPArchive::<replaceable>Index</replaceable>::<replaceable>Checksum</replaceable></literal> "
2446
"where <literal>Index</literal> can be <literal>Packages</literal>, "
2447
"<literal>Sources</literal> or <literal>Release</literal> and "
2448
"<literal>Checksum</literal> can be <literal>MD5</literal>, "
2449
"<literal>SHA1</literal> or <literal>SHA256</literal>."
2446
"where <literal><replaceable>Index</replaceable></literal> can be "
2447
"<literal>Packages</literal>, <literal>Sources</literal> or "
2448
"<literal>Release</literal> and "
2449
"<literal><replaceable>Checksum</replaceable></literal> can be "
2450
"<literal>MD5</literal>, <literal>SHA1</literal> or "
2451
"<literal>SHA256</literal>."
2452
2454
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
2453
#: apt-ftparchive.1.xml:539
2455
#: apt-ftparchive.1.xml:540
2454
2456
msgid "<option>--db</option>"
2457
2459
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2458
#: apt-ftparchive.1.xml:541
2460
#: apt-ftparchive.1.xml:542
2460
2462
"Use a binary caching DB. This has no effect on the generate command. "
2461
2463
"Configuration Item: <literal>APT::FTPArchive::DB</literal>."
2464
2466
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2465
#: apt-ftparchive.1.xml:547
2467
#: apt-ftparchive.1.xml:548
2467
2469
"Quiet; produces output suitable for logging, omitting progress indicators. "
2468
2470
"More q's will produce more quiet up to a maximum of 2. You can also use "
2515
2517
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
2516
#: apt-ftparchive.1.xml:577
2518
#: apt-ftparchive.1.xml:578
2517
2519
msgid "<option>--readonly</option>"
2520
2522
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2521
#: apt-ftparchive.1.xml:579
2523
#: apt-ftparchive.1.xml:580
2523
2525
"Make the caching databases read only. Configuration Item: "
2524
2526
"<literal>APT::FTPArchive::ReadOnlyDB</literal>."
2527
2529
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
2528
#: apt-ftparchive.1.xml:583
2530
#: apt-ftparchive.1.xml:584
2529
2531
msgid "<option>--arch</option>"
2532
2534
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2533
#: apt-ftparchive.1.xml:584
2535
#: apt-ftparchive.1.xml:585
2535
2537
"Accept in the <literal>packages</literal> and <literal>contents</literal> "
2536
2538
"commands only package files matching <literal>*_arch.deb</literal> or "
3612
3614
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3613
3615
#: apt-key.8.xml:131
3615
"Update the local keyring with the keyring of Debian archive keys and removes "
3616
"from the keyring the archive keys which are no longer valid."
3617
"Update the local keyring with the archive keyring and remove from the local "
3618
"keyring the archive keys which are no longer valid. The archive keyring is "
3619
"shipped in the <literal>archive-keyring</literal> package of your "
3620
"distribution, e.g. the <literal>debian-archive-keyring</literal> package in "
3624
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3625
#: apt-key.8.xml:141
3629
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3630
#: apt-key.8.xml:145
3632
"Work similar to the <command>update</command> command above, but get the "
3633
"archive keyring from an URI instead and validate it against a master key. "
3634
"This requires an installed &wget; and an APT build configured to have a "
3635
"server to fetch from and a master keyring to validate. APT in Debian does "
3636
"not support this command and relies on <command>update</command> instead, "
3637
"but Ubuntu's APT does."
3619
3640
#. type: Content of: <refentry><refsect1><para>
3620
#: apt-key.8.xml:143
3641
#: apt-key.8.xml:162
3622
3643
"Note that options need to be defined before the commands described in the "
3623
3644
"previous section."
3626
3647
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3627
#: apt-key.8.xml:145
3648
#: apt-key.8.xml:164
3628
3649
msgid "--keyring <replaceable>filename</replaceable>"
3631
3652
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3632
#: apt-key.8.xml:146
3653
#: apt-key.8.xml:165
3634
3655
"With this option it is possible to specify a specific keyring file the "
3635
3656
"command should operate on. The default is that a command is executed on the "
3642
3663
#. type: Content of: <refentry><refsect1><variablelist>
3643
#: apt-key.8.xml:159
3664
#: apt-key.8.xml:178
3644
3665
msgid "&file-trustedgpg;"
3647
3668
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3648
#: apt-key.8.xml:161
3669
#: apt-key.8.xml:180
3649
3670
msgid "<filename>/etc/apt/trustdb.gpg</filename>"
3652
3673
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3653
#: apt-key.8.xml:162
3674
#: apt-key.8.xml:181
3654
3675
msgid "Local trust database of archive keys."
3657
3678
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3658
#: apt-key.8.xml:165
3679
#: apt-key.8.xml:184
3659
3680
msgid "<filename>/usr/share/keyrings/debian-archive-keyring.gpg</filename>"
3662
3683
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3663
#: apt-key.8.xml:166
3684
#: apt-key.8.xml:185
3664
3685
msgid "Keyring of Debian archive trusted keys."
3667
3688
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3668
#: apt-key.8.xml:169
3689
#: apt-key.8.xml:188
3669
3690
msgid "<filename>/usr/share/keyrings/debian-archive-removed-keys.gpg</filename>"
3672
3693
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3673
#: apt-key.8.xml:170
3694
#: apt-key.8.xml:189
3674
3695
msgid "Keyring of Debian archive removed trusted keys."
3677
3698
#. type: Content of: <refentry><refsect1><para>
3678
#: apt-key.8.xml:179
3699
#: apt-key.8.xml:198
3679
3700
msgid "&apt-get;, &apt-secure;"
3703
3724
" <command>apt-mark</command> <arg><option>-hv</option></arg> "
3704
3725
"<arg><option>-f=<replaceable>FILENAME</replaceable></option></arg> <group "
3705
3726
"choice=\"plain\"> <arg choice=\"plain\"> <group choice=\"req\"> <arg "
3706
"choice=\"plain\">markauto</arg> <arg choice=\"plain\">unmarkauto</arg> "
3727
"choice=\"plain\">auto</arg> <arg choice=\"plain\">manual</arg> <arg "
3728
"choice=\"plain\">showauto</arg> <arg choice=\"plain\">showmanual</arg> "
3707
3729
"</group> <arg choice=\"plain\" "
3708
"rep=\"repeat\"><replaceable>package</replaceable></arg> </arg> <arg "
3709
"choice=\"plain\">showauto</arg> </group>"
3730
"rep=\"repeat\"><replaceable>package</replaceable></arg> </arg> </group>"
3712
3733
#. type: Content of: <refentry><refsect1><para>
3713
#: apt-mark.8.xml:56
3734
#: apt-mark.8.xml:57
3715
3736
"<command>apt-mark</command> will change whether a package has been marked as "
3716
3737
"being automatically installed."
3719
3740
#. type: Content of: <refentry><refsect1><para>
3720
#: apt-mark.8.xml:60
3741
#: apt-mark.8.xml:61
3722
3743
"When you request that a package is installed, and as a result other packages "
3723
3744
"are installed to satisfy its dependencies, the dependencies are marked as "
3729
3750
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3730
#: apt-mark.8.xml:68
3734
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3735
3751
#: apt-mark.8.xml:69
3755
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3756
#: apt-mark.8.xml:70
3737
"<literal>markauto</literal> is used to mark a package as being automatically "
3758
"<literal>auto</literal> is used to mark a package as being automatically "
3738
3759
"installed, which will cause the package to be removed when no more manually "
3739
3760
"installed packages depend on this package."
3742
3763
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3743
#: apt-mark.8.xml:76
3747
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3748
3764
#: apt-mark.8.xml:77
3768
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3769
#: apt-mark.8.xml:78
3750
"<literal>unmarkauto</literal> is used to mark a package as being manually "
3771
"<literal>manual</literal> is used to mark a package as being manually "
3751
3772
"installed, which will prevent the package from being automatically removed "
3752
3773
"if no other packages depend on it."
3755
3776
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3756
#: apt-mark.8.xml:84
3777
#: apt-mark.8.xml:85
3781
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3782
#: apt-mark.8.xml:86
3784
"<literal>hold</literal> is used to mark a package as hold back, which will "
3785
"prevent the package from being automatically installed, upgraded or "
3786
"removed. The command is only a wrapper around <command>dpkg "
3787
"--set-selections</command> and the state is therefore maintained by &dpkg; "
3788
"and not effected by the <option>--filename</option> option."
3791
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3792
#: apt-mark.8.xml:95
3796
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3797
#: apt-mark.8.xml:96
3799
"<literal>unhold</literal> is used to cancel a previously set hold on a "
3800
"package to allow all actions again."
3803
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3804
#: apt-mark.8.xml:101
3757
3805
msgid "showauto"
3760
3808
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3761
#: apt-mark.8.xml:85
3809
#: apt-mark.8.xml:102
3763
3811
"<literal>showauto</literal> is used to print a list of automatically "
3764
"installed packages with each package on a new line."
3767
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3768
#: apt-mark.8.xml:96
3812
"installed packages with each package on a new line. All automatically "
3813
"installed packages will be listed if no package is given. If packages are "
3814
"given only those which are automatically installed will be shown."
3817
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3818
#: apt-mark.8.xml:109
3822
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3823
#: apt-mark.8.xml:110
3825
"<literal>showmanual</literal> can be used in the same way as "
3826
"<literal>showauto</literal> except that it will print a list of manually "
3827
"installed packages instead."
3830
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3831
#: apt-mark.8.xml:116
3835
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3836
#: apt-mark.8.xml:117
3838
"<literal>showhold</literal> is used to print a list of packages on hold in "
3839
"the same way as for the other show commands."
3842
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3843
#: apt-mark.8.xml:130
3769
3844
msgid "<option>-f=<filename><replaceable>FILENAME</replaceable></filename></option>"
3772
3847
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3773
#: apt-mark.8.xml:97
3848
#: apt-mark.8.xml:131
3774
3849
msgid "<option>--file=<filename><replaceable>FILENAME</replaceable></filename></option>"
3777
3852
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3778
#: apt-mark.8.xml:100
3853
#: apt-mark.8.xml:134
3780
3855
"Read/Write package stats from "
3781
3856
"<filename><replaceable>FILENAME</replaceable></filename> instead of the "
3783
3858
"directory defined by the Configuration Item: <literal>Dir::State</literal>."
3786
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3787
#: apt-mark.8.xml:106
3788
msgid "<option>-h</option>"
3791
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3792
#: apt-mark.8.xml:107
3793
msgid "<option>--help</option>"
3796
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3797
#: apt-mark.8.xml:108
3798
msgid "Show a short usage summary."
3801
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3802
#: apt-mark.8.xml:114
3803
msgid "<option>-v</option>"
3806
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3807
#: apt-mark.8.xml:115
3808
msgid "<option>--version</option>"
3811
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3812
#: apt-mark.8.xml:116
3813
msgid "Show the program version."
3816
3861
#. type: Content of: <refentry><refsect1><variablelist>
3817
#: apt-mark.8.xml:127
3862
#: apt-mark.8.xml:146
3818
3863
msgid " &file-extended_states;"
3821
3866
#. type: Content of: <refentry><refsect1><para>
3822
#: apt-mark.8.xml:132
3867
#: apt-mark.8.xml:151
3823
3868
msgid "&apt-get;,&aptitude;,&apt-conf;"
3826
3871
#. type: Content of: <refentry><refsect1><para>
3827
#: apt-mark.8.xml:136
3872
#: apt-mark.8.xml:155
3829
3874
"<command>apt-mark</command> returns zero on normal operation, non-zero on "
6152
6197
#. type: Content of: <refentry><refsect1><refsect2><title>
6153
#: apt_preferences.5.xml:263
6198
#: apt_preferences.5.xml:262
6199
msgid "Regular expressions and glob() syntax"
6202
#. type: Content of: <refentry><refsect1><refsect2><para>
6203
#: apt_preferences.5.xml:264
6205
"APT also supports pinning by glob() expressions and regular expressions "
6206
"surrounded by /. For example, the following example assigns the priority 500 "
6207
"to all packages from experimental where the name starts with gnome (as a "
6208
"glob()-like expression) or contains the word kde (as a POSIX extended "
6209
"regular expression surrounded by slashes)."
6212
#. type: Content of: <refentry><refsect1><refsect2><programlisting>
6213
#: apt_preferences.5.xml:273
6216
"Package: gnome* /kde/\n"
6217
"Pin: release n=experimental\n"
6218
"Pin-Priority: 500\n"
6221
#. type: Content of: <refentry><refsect1><refsect2><para>
6222
#: apt_preferences.5.xml:279
6224
"The rule for those expressions is that they can occur anywhere where a "
6225
"string can occur. Thus, the following pin assigns the priority 990 to all "
6226
"packages from a release starting with karmic."
6229
#. type: Content of: <refentry><refsect1><refsect2><programlisting>
6230
#: apt_preferences.5.xml:285
6234
"Pin: release n=karmic*\n"
6235
"Pin-Priority: 990\n"
6238
#. type: Content of: <refentry><refsect1><refsect2><literal>
6239
#: apt_preferences.5.xml:290
6243
#. type: Content of: <refentry><refsect1><refsect2><literal>
6244
#: apt_preferences.5.xml:296
6248
#. type: Content of: <refentry><refsect1><refsect2><title>
6249
#: apt_preferences.5.xml:306
6154
6250
msgid "How APT Interprets Priorities"
6157
6253
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
6158
#: apt_preferences.5.xml:271
6254
#: apt_preferences.5.xml:314
6159
6255
msgid "P > 1000"
6162
6258
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
6163
#: apt_preferences.5.xml:272
6259
#: apt_preferences.5.xml:315
6165
6261
"causes a version to be installed even if this constitutes a downgrade of the "
6169
6265
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
6170
#: apt_preferences.5.xml:276
6266
#: apt_preferences.5.xml:319
6171
6267
msgid "990 < P <=1000"
6174
6270
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
6175
#: apt_preferences.5.xml:277
6271
#: apt_preferences.5.xml:320
6177
6273
"causes a version to be installed even if it does not come from the target "
6178
6274
"release, unless the installed version is more recent"
6181
6277
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
6182
#: apt_preferences.5.xml:282
6278
#: apt_preferences.5.xml:325
6183
6279
msgid "500 < P <=990"
6186
6282
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
6187
#: apt_preferences.5.xml:283
6283
#: apt_preferences.5.xml:326
6189
6285
"causes a version to be installed unless there is a version available "
6190
6286
"belonging to the target release or the installed version is more recent"
6193
6289
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
6194
#: apt_preferences.5.xml:288
6290
#: apt_preferences.5.xml:331
6195
6291
msgid "100 < P <=500"
6198
6294
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
6199
#: apt_preferences.5.xml:289
6295
#: apt_preferences.5.xml:332
6201
6297
"causes a version to be installed unless there is a version available "
6202
6298
"belonging to some other distribution or the installed version is more recent"
6205
6301
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
6206
#: apt_preferences.5.xml:294
6302
#: apt_preferences.5.xml:337
6207
6303
msgid "0 < P <=100"
6210
6306
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
6211
#: apt_preferences.5.xml:295
6307
#: apt_preferences.5.xml:338
6213
6309
"causes a version to be installed only if there is no installed version of "
6217
6313
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
6218
#: apt_preferences.5.xml:299
6314
#: apt_preferences.5.xml:342
6219
6315
msgid "P < 0"
6222
6318
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
6223
#: apt_preferences.5.xml:300
6319
#: apt_preferences.5.xml:343
6224
6320
msgid "prevents the version from being installed"
6227
6323
#. type: Content of: <refentry><refsect1><refsect2><para>
6228
#: apt_preferences.5.xml:266
6324
#: apt_preferences.5.xml:309
6230
6326
"Priorities (P) assigned in the APT preferences file must be positive or "
6231
6327
"negative integers. They are interpreted as follows (roughly speaking): "
6313
6409
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
6314
#: apt_preferences.5.xml:363
6410
#: apt_preferences.5.xml:406
6315
6411
msgid "the <literal>Package:</literal> line"
6318
6414
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
6319
#: apt_preferences.5.xml:364
6415
#: apt_preferences.5.xml:407
6320
6416
msgid "gives the package name"
6323
6419
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
6324
#: apt_preferences.5.xml:367 apt_preferences.5.xml:417
6420
#: apt_preferences.5.xml:410 apt_preferences.5.xml:460
6325
6421
msgid "the <literal>Version:</literal> line"
6328
6424
#. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
6329
#: apt_preferences.5.xml:368
6425
#: apt_preferences.5.xml:411
6330
6426
msgid "gives the version number for the named package"
6333
6429
#. type: Content of: <refentry><refsect1><refsect2><para>
6334
#: apt_preferences.5.xml:355
6430
#: apt_preferences.5.xml:398
6336
6432
"The <filename>Packages</filename> file is normally found in the directory "
6337
6433
"<filename>.../dists/<replaceable>dist-name</replaceable>/<replaceable>component</replaceable>/<replaceable>arch</replaceable></filename>: "