513
#. The last update date
514
#. type: Content of: <refentry><refentryinfo>
515
#: apt-cache.8.xml:16
517
"&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>04 "
518
"February 2011</date>"
521
#. type: Content of: <refentry><refnamediv><refname>
522
#: apt-cache.8.xml:25 apt-cache.8.xml:32
385
"<!-- TRANSLATOR: used as in -o=config_string "
386
"e.g. -o=Debug::pkgProblemResolver=1 --> <!ENTITY synopsis-config-string "
393
"<!-- TRANSLATOR: used as in -c=config_file e.g. -c=./apt.conf --> <!ENTITY "
394
"synopsis-config-file \"config_file\">"
400
"<!-- TRANSLATOR: used as in -t=target_release or pkg/target_release "
401
"e.g. -t=squeeze apt/experimental --> <!ENTITY synopsis-target-release "
402
"\"target_release\">"
408
"<!-- TRANSLATOR: used as in -a=architecture e.g. -a=armel --> <!ENTITY "
409
"synopsis-architecture \"architecture\">"
415
"<!-- TRANSLATOR: used as in apt-get install pkg e.g. apt-get install awesome "
416
"--> <!ENTITY synopsis-pkg \"pkg\">"
422
"<!-- TRANSLATOR: used as in pkg=pkg_version_number e.g. apt=0.8.15 --> "
423
"<!ENTITY synopsis-pkg-ver-number \"pkg_version_number\">"
429
"<!-- TRANSLATOR: used as in apt-cache pkgnames prefix e.g. apt-cache "
430
"pkgnames apt --> <!ENTITY synopsis-prefix \"prefix\">"
436
"<!-- TRANSLATOR: used as in apt-cache search regex e.g. apt-cache search "
437
"awesome --> <!ENTITY synopsis-regex \"regex\">"
443
"<!-- TRANSLATOR: used as in apt-cdrom -d=cdrom_mount_point e.g. apt-cdrom "
444
"-d=/media/cdrom --> <!ENTITY synopsis-cdrom-mount \"cdrom_mount_point\">"
450
"<!-- TRANSLATOR: used as in apt-extracttemplates -t=temporary_directory "
451
"e.g. apt-extracttemplates -t=/tmp --> <!ENTITY synopsis-tmp-directory "
452
"\"temporary_directory\">"
458
"<!-- TRANSLATOR: used as in apt-extracttemplates filename --> <!ENTITY "
459
"synopsis-filename \"filename\">"
465
"<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive "
466
"packages path override-file pathprefix --> <!ENTITY synopsis-path \"path\">"
472
"<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive "
473
"packages path override-file pathprefix --> <!ENTITY synopsis-override "
480
"<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive "
481
"packages path override-file pathprefix --> <!ENTITY synopsis-pathprefix "
488
"<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive "
489
"generate section --> <!ENTITY synopsis-section \"section\">"
495
"<!-- TRANSLATOR: used as in apt-key export keyid e.g. apt-key export "
496
"473041FA --> <!ENTITY synopsis-keyid \"keyid\">"
526
499
#. type: Content of: <refentry><refmeta><manvolnum>
527
#: apt-cache.8.xml:26 apt-cdrom.8.xml:25 apt-config.8.xml:26 apt-get.8.xml:26 apt-key.8.xml:18 apt-mark.8.xml:26 apt-secure.8.xml:18
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
531
504
#. type: Content of: <refentry><refmeta><refmiscinfo>
532
#: apt-cache.8.xml:27 apt-cdrom.8.xml:26 apt-config.8.xml:27 apt-extracttemplates.1.xml:27 apt-ftparchive.1.xml:27 apt-get.8.xml:27 apt-key.8.xml:19 apt-mark.8.xml:27 apt-secure.8.xml:19 apt-sortpkgs.1.xml:27 apt.conf.5.xml:33 apt_preferences.5.xml:26 sources.list.5.xml:27
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
536
509
#. type: Content of: <refentry><refnamediv><refpurpose>
537
#: apt-cache.8.xml:33
538
msgid "query the APT cache"
541
#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
542
#: apt-cache.8.xml:39
544
"<command>apt-cache</command> <arg><option>-hvsn</option></arg> "
545
"<arg><option>-o=<replaceable>config string</replaceable></option></arg> "
546
"<arg><option>-c=<replaceable>file</replaceable></option></arg> <group "
547
"choice=\"req\"> <arg>gencaches</arg> <arg>showpkg <arg choice=\"plain\" "
548
"rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg>showsrc <arg "
549
"choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
550
"<arg>stats</arg> <arg>dump</arg> <arg>dumpavail</arg> <arg>unmet</arg> "
552
"choice=\"plain\"><replaceable>regex</replaceable></arg></arg> <arg>show <arg "
553
"choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
554
"<arg>depends <arg choice=\"plain\" "
555
"rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg>rdepends <arg "
556
"choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
557
"<arg>pkgnames <arg "
558
"choice=\"plain\"><replaceable>prefix</replaceable></arg></arg> <arg>dotty "
559
"<arg choice=\"plain\" "
560
"rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg>xvcg <arg "
561
"choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
562
"<arg>policy <arg choice=\"plain\" "
563
"rep=\"repeat\"><replaceable>pkgs</replaceable></arg></arg> <arg>madison <arg "
564
"choice=\"plain\" rep=\"repeat\"><replaceable>pkgs</replaceable></arg></arg> "
568
#. type: Content of: <refentry><refsect1><title>
569
#: apt-cache.8.xml:64 apt-cdrom.8.xml:50 apt-config.8.xml:50 apt-extracttemplates.1.xml:46 apt-ftparchive.1.xml:59 apt-get.8.xml:121 apt-key.8.xml:38 apt-mark.8.xml:56 apt-secure.8.xml:43 apt-sortpkgs.1.xml:47 apt.conf.5.xml:42 apt_preferences.5.xml:36 sources.list.5.xml:36
573
#. type: Content of: <refentry><refsect1><para>
574
#: apt-cache.8.xml:65
576
"<command>apt-cache</command> performs a variety of operations on APT's "
577
"package cache. <command>apt-cache</command> does not manipulate the state of "
578
"the system but does provide operations to search and generate interesting "
579
"output from the package metadata."
582
#. type: Content of: <refentry><refsect1><para>
583
#: apt-cache.8.xml:70 apt-get.8.xml:127
585
"Unless the <option>-h</option>, or <option>--help</option> option is given, "
586
"one of the commands below must be present."
589
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
590
#: apt-cache.8.xml:74
594
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
595
#: apt-cache.8.xml:75
597
"<literal>gencaches</literal> performs the same operation as <command>apt-get "
598
"check</command>. It builds the source and package caches from the sources in "
599
"&sources-list; and from <filename>/var/lib/dpkg/status</filename>."
602
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
603
#: apt-cache.8.xml:81
604
msgid "showpkg <replaceable>pkg(s)</replaceable>"
607
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
608
#: apt-cache.8.xml:82
610
"<literal>showpkg</literal> displays information about the packages listed on "
611
"the command line. Remaining arguments are package names. The available "
612
"versions and reverse dependencies of each package listed are listed, as well "
613
"as forward dependencies for each version. Forward (normal) dependencies are "
614
"those packages upon which the package in question depends; reverse "
615
"dependencies are those packages that depend upon the package in "
616
"question. Thus, forward dependencies must be satisfied for a package, but "
617
"reverse dependencies need not be. For instance, <command>apt-cache showpkg "
618
"libreadline2</command> would produce output similar to the following:"
621
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting>
622
#: apt-cache.8.xml:94
625
"Package: libreadline2\n"
626
"Versions: 2.1-12(/var/state/apt/lists/foo_Packages),\n"
627
"Reverse Depends: \n"
628
" libreadlineg2,libreadline2\n"
629
" libreadline2-altdev,libreadline2\n"
631
"2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))\n"
634
"Reverse Provides: \n"
637
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
638
#: apt-cache.8.xml:106
640
"Thus it may be seen that libreadline2, version 2.1-12, depends on libc5 and "
641
"ncurses3.0 which must be installed for libreadline2 to work. In turn, "
642
"libreadlineg2 and libreadline2-altdev depend on libreadline2. If "
643
"libreadline2 is installed, libc5 and ncurses3.0 (and ldso) must also be "
644
"installed; libreadlineg2 and libreadline2-altdev do not have to be "
645
"installed. For the specific meaning of the remainder of the output it is "
646
"best to consult the apt source code."
649
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
650
#: apt-cache.8.xml:115
654
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
655
#: apt-cache.8.xml:115
657
"<literal>stats</literal> displays some statistics about the cache. No "
658
"further arguments are expected. Statistics reported are:"
661
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
662
#: apt-cache.8.xml:118
664
"<literal>Total package names</literal> is the number of package names found "
668
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
669
#: apt-cache.8.xml:122
671
"<literal>Normal packages</literal> is the number of regular, ordinary "
672
"package names; these are packages that bear a one-to-one correspondence "
673
"between their names and the names used by other packages for them in "
674
"dependencies. The majority of packages fall into this category."
677
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
678
#: apt-cache.8.xml:128
680
"<literal>Pure virtual packages</literal> is the number of packages that "
681
"exist only as a virtual package name; that is, packages only \"provide\" the "
682
"virtual package name, and no package actually uses the name. For instance, "
683
"\"mail-transport-agent\" in the Debian GNU/Linux system is a pure virtual "
684
"package; several packages provide \"mail-transport-agent\", but there is no "
685
"package named \"mail-transport-agent\"."
688
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
689
#: apt-cache.8.xml:136
691
"<literal>Single virtual packages</literal> is the number of packages with "
692
"only one package providing a particular virtual package. For example, in the "
693
"Debian GNU/Linux system, \"X11-text-viewer\" is a virtual package, but only "
694
"one package, xless, provides \"X11-text-viewer\"."
697
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
698
#: apt-cache.8.xml:142
700
"<literal>Mixed virtual packages</literal> is the number of packages that "
701
"either provide a particular virtual package or have the virtual package name "
702
"as the package name. For instance, in the Debian GNU/Linux system, "
703
"\"debconf\" is both an actual package, and provided by the debconf-tiny "
707
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
708
#: apt-cache.8.xml:149
710
"<literal>Missing</literal> is the number of package names that were "
711
"referenced in a dependency but were not provided by any package. Missing "
712
"packages may be an evidence if a full distribution is not accessed, or if a "
713
"package (real or virtual) has been dropped from the distribution. Usually "
714
"they are referenced from Conflicts or Breaks statements."
717
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
718
#: apt-cache.8.xml:156
720
"<literal>Total distinct</literal> versions is the number of package versions "
721
"found in the cache; this value is therefore at least equal to the number of "
722
"total package names. If more than one distribution (both \"stable\" and "
723
"\"unstable\", for instance), is being accessed, this value can be "
724
"considerably larger than the number of total package names."
727
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
728
#: apt-cache.8.xml:163
730
"<literal>Total dependencies</literal> is the number of dependency "
731
"relationships claimed by all of the packages in the cache."
734
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
735
#: apt-cache.8.xml:170
736
msgid "showsrc <replaceable>pkg(s)</replaceable>"
739
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
740
#: apt-cache.8.xml:171
742
"<literal>showsrc</literal> displays all the source package records that "
743
"match the given package names. All versions are shown, as well as all "
744
"records that declare the name to be a Binary."
747
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
748
#: apt-cache.8.xml:176 apt-config.8.xml:87
752
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
753
#: apt-cache.8.xml:177
755
"<literal>dump</literal> shows a short listing of every package in the "
756
"cache. It is primarily for debugging."
759
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
760
#: apt-cache.8.xml:181
764
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
765
#: apt-cache.8.xml:182
767
"<literal>dumpavail</literal> prints out an available list to stdout. This is "
768
"suitable for use with &dpkg; and is used by the &dselect; method."
771
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
772
#: apt-cache.8.xml:186
776
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
777
#: apt-cache.8.xml:187
779
"<literal>unmet</literal> displays a summary of all unmet dependencies in the "
783
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
784
#: apt-cache.8.xml:191
785
msgid "show <replaceable>pkg(s)</replaceable>"
788
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
789
#: apt-cache.8.xml:192
791
"<literal>show</literal> performs a function similar to <command>dpkg "
792
"--print-avail</command>; it displays the package records for the named "
796
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
797
#: apt-cache.8.xml:197
798
msgid "search <replaceable>regex [ regex ... ]</replaceable>"
801
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
802
#: apt-cache.8.xml:198
804
"<literal>search</literal> performs a full text search on all available "
805
"package lists for the POSIX regex pattern given, see "
806
"<citerefentry><refentrytitle><command>regex</command></refentrytitle> "
807
"<manvolnum>7</manvolnum></citerefentry>. It searches the package names and "
808
"the descriptions for an occurrence of the regular expression and prints out "
809
"the package name and the short description, including virtual package "
810
"names. If <option>--full</option> is given then output identical to "
811
"<literal>show</literal> is produced for each matched package, and if "
812
"<option>--names-only</option> is given then the long description is not "
813
"searched, only the package name is."
816
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
817
#: apt-cache.8.xml:211
819
"Separate arguments can be used to specify multiple search patterns that are "
823
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
824
#: apt-cache.8.xml:215
825
msgid "depends <replaceable>pkg(s)</replaceable>"
828
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
829
#: apt-cache.8.xml:216
831
"<literal>depends</literal> shows a listing of each dependency a package has "
832
"and all the possible other packages that can fulfill that dependency."
835
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
836
#: apt-cache.8.xml:220
837
msgid "rdepends <replaceable>pkg(s)</replaceable>"
840
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
841
#: apt-cache.8.xml:221
843
"<literal>rdepends</literal> shows a listing of each reverse dependency a "
847
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
848
#: apt-cache.8.xml:225
849
msgid "pkgnames <replaceable>[ prefix ]</replaceable>"
852
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
853
#: apt-cache.8.xml:226
855
"This command prints the name of each package APT knows. The optional "
856
"argument is a prefix match to filter the name list. The output is suitable "
857
"for use in a shell tab complete function and the output is generated "
858
"extremely quickly. This command is best used with the "
859
"<option>--generate</option> option."
862
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
863
#: apt-cache.8.xml:231
865
"Note that a package which APT knows of is not necessarily available to "
866
"download, installable or installed, e.g. virtual packages are also listed in "
867
"the generated list."
870
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
871
#: apt-cache.8.xml:236
872
msgid "dotty <replaceable>pkg(s)</replaceable>"
875
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
876
#: apt-cache.8.xml:237
878
"<literal>dotty</literal> takes a list of packages on the command line and "
879
"generates output suitable for use by dotty from the <ulink "
880
"url=\"http://www.research.att.com/sw/tools/graphviz/\">GraphViz</ulink> "
881
"package. The result will be a set of nodes and edges representing the "
882
"relationships between the packages. By default the given packages will trace "
883
"out all dependent packages; this can produce a very large graph. To limit "
884
"the output to only the packages listed on the command line, set the "
885
"<literal>APT::Cache::GivenOnly</literal> option."
888
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
889
#: apt-cache.8.xml:246
891
"The resulting nodes will have several shapes; normal packages are boxes, "
892
"pure provides are triangles, mixed provides are diamonds, missing packages "
893
"are hexagons. Orange boxes mean recursion was stopped [leaf packages], blue "
894
"lines are pre-depends, green lines are conflicts."
897
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
898
#: apt-cache.8.xml:251
899
msgid "Caution, dotty cannot graph larger sets of packages."
902
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
903
#: apt-cache.8.xml:254
904
msgid "xvcg <replaceable>pkg(s)</replaceable>"
907
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
908
#: apt-cache.8.xml:255
910
"The same as <literal>dotty</literal>, only for xvcg from the <ulink "
911
"url=\"http://rw4.cs.uni-sb.de/users/sander/html/gsvcg1.html\">VCG "
915
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
916
#: apt-cache.8.xml:259
917
msgid "policy <replaceable>[ pkg(s) ]</replaceable>"
920
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
921
#: apt-cache.8.xml:260
923
"<literal>policy</literal> is meant to help debug issues relating to the "
924
"preferences file. With no arguments it will print out the priorities of each "
925
"source. Otherwise it prints out detailed information about the priority "
926
"selection of the named package."
929
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
930
#: apt-cache.8.xml:266
931
msgid "madison <replaceable>[ pkg(s) ]</replaceable>"
934
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
935
#: apt-cache.8.xml:267
937
"<literal>apt-cache</literal>'s <literal>madison</literal> command attempts "
938
"to mimic the output format and a subset of the functionality of the Debian "
939
"archive management tool, <literal>madison</literal>. It displays available "
940
"versions of a package in a tabular format. Unlike the original "
941
"<literal>madison</literal>, it can only display information for the "
942
"architecture for which APT has retrieved package lists "
943
"(<literal>APT::Architecture</literal>)."
946
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
947
#: apt-cache.8.xml:278 apt-config.8.xml:96 apt-extracttemplates.1.xml:59 apt-ftparchive.1.xml:525 apt-get.8.xml:342 apt-mark.8.xml:126 apt-sortpkgs.1.xml:57 apt.conf.5.xml:577 apt.conf.5.xml:599
951
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
952
#: apt-cache.8.xml:282
953
msgid "<option>-p</option>"
956
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
957
#: apt-cache.8.xml:282
958
msgid "<option>--pkg-cache</option>"
961
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
962
#: apt-cache.8.xml:283
964
"Select the file to store the package cache. The package cache is the primary "
965
"cache used by all operations. Configuration Item: "
966
"<literal>Dir::Cache::pkgcache</literal>."
969
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
970
#: apt-cache.8.xml:288 apt-ftparchive.1.xml:572 apt-get.8.xml:404 apt-sortpkgs.1.xml:61
971
msgid "<option>-s</option>"
974
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
975
#: apt-cache.8.xml:288
976
msgid "<option>--src-cache</option>"
979
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
980
#: apt-cache.8.xml:289
982
"Select the file to store the source cache. The source is used only by "
983
"<literal>gencaches</literal> and it stores a parsed version of the package "
984
"information from remote sources. When building the package cache the source "
985
"cache is used to avoid reparsing all of the package files. Configuration "
986
"Item: <literal>Dir::Cache::srcpkgcache</literal>."
989
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
990
#: apt-cache.8.xml:296 apt-ftparchive.1.xml:546 apt-get.8.xml:394
991
msgid "<option>-q</option>"
994
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
995
#: apt-cache.8.xml:296 apt-ftparchive.1.xml:546 apt-get.8.xml:394
996
msgid "<option>--quiet</option>"
999
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1000
#: apt-cache.8.xml:297
1002
"Quiet; produces output suitable for logging, omitting progress indicators. "
1003
"More q's will produce more quietness up to a maximum of 2. You can also use "
1004
"<option>-q=#</option> to set the quietness level, overriding the "
1005
"configuration file. Configuration Item: <literal>quiet</literal>."
1008
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1009
#: apt-cache.8.xml:303
1010
msgid "<option>-i</option>"
1013
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1014
#: apt-cache.8.xml:303
1015
msgid "<option>--important</option>"
1018
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1019
#: apt-cache.8.xml:304
1021
"Print only important dependencies; for use with unmet and depends. Causes "
1022
"only Depends and Pre-Depends relations to be printed. Configuration Item: "
1023
"<literal>APT::Cache::Important</literal>."
1026
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1027
#: apt-cache.8.xml:309
1028
msgid "<option>--no-pre-depends</option>"
1031
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1032
#: apt-cache.8.xml:310
1033
msgid "<option>--no-depends</option>"
1036
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1037
#: apt-cache.8.xml:311
1038
msgid "<option>--no-recommends</option>"
1041
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1042
#: apt-cache.8.xml:312
1043
msgid "<option>--no-suggests</option>"
1046
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1047
#: apt-cache.8.xml:313
1048
msgid "<option>--no-conflicts</option>"
1051
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1052
#: apt-cache.8.xml:314
1053
msgid "<option>--no-breaks</option>"
1056
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1057
#: apt-cache.8.xml:315
1058
msgid "<option>--no-replaces</option>"
1061
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1062
#: apt-cache.8.xml:316
1063
msgid "<option>--no-enhances</option>"
1066
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1067
#: apt-cache.8.xml:317
1069
"Per default the <literal>depends</literal> and <literal>rdepends</literal> "
1070
"print all dependencies. This can be tweaked with these flags which will omit "
1071
"the specified dependency type. Configuration Item: "
1072
"<literal>APT::Cache::Show<replaceable>DependencyType</replaceable></literal> "
1073
"e.g. <literal>APT::Cache::ShowRecommends</literal>."
1076
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1077
#: apt-cache.8.xml:323 apt-cdrom.8.xml:124 apt-get.8.xml:361
1078
msgid "<option>-f</option>"
1081
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1082
#: apt-cache.8.xml:323
1083
msgid "<option>--full</option>"
1086
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1087
#: apt-cache.8.xml:324
1089
"Print full package records when searching. Configuration Item: "
1090
"<literal>APT::Cache::ShowFull</literal>."
1093
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1094
#: apt-cache.8.xml:328 apt-cdrom.8.xml:134 apt-ftparchive.1.xml:584 apt-get.8.xml:452
1095
msgid "<option>-a</option>"
1098
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1099
#: apt-cache.8.xml:328
1100
msgid "<option>--all-versions</option>"
1103
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1104
#: apt-cache.8.xml:329
1106
"Print full records for all available versions. This is the default; to turn "
1107
"it off, use <option>--no-all-versions</option>. If "
1108
"<option>--no-all-versions</option> is specified, only the candidate version "
1109
"will displayed (the one which would be selected for installation). This "
1110
"option is only applicable to the <literal>show</literal> command. "
1111
"Configuration Item: <literal>APT::Cache::AllVersions</literal>."
1114
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1115
#: apt-cache.8.xml:337
1116
msgid "<option>-g</option>"
1119
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1120
#: apt-cache.8.xml:337
1121
msgid "<option>--generate</option>"
1124
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1125
#: apt-cache.8.xml:338
1127
"Perform automatic package cache regeneration, rather than use the cache as "
1128
"it is. This is the default; to turn it off, use "
1129
"<option>--no-generate</option>. Configuration Item: "
1130
"<literal>APT::Cache::Generate</literal>."
1133
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1134
#: apt-cache.8.xml:343
1135
msgid "<option>--names-only</option>"
1138
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1139
#: apt-cache.8.xml:343 apt-cdrom.8.xml:142
1140
msgid "<option>-n</option>"
1143
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1144
#: apt-cache.8.xml:344
1146
"Only search on the package names, not the long descriptions. Configuration "
1147
"Item: <literal>APT::Cache::NamesOnly</literal>."
1150
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1151
#: apt-cache.8.xml:348
1152
msgid "<option>--all-names</option>"
1155
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1156
#: apt-cache.8.xml:349
1158
"Make <literal>pkgnames</literal> print all names, including virtual packages "
1159
"and missing dependencies. Configuration Item: "
1160
"<literal>APT::Cache::AllNames</literal>."
1163
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1164
#: apt-cache.8.xml:354
1165
msgid "<option>--recurse</option>"
1168
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1169
#: apt-cache.8.xml:355
1171
"Make <literal>depends</literal> and <literal>rdepends</literal> recursive so "
1172
"that all packages mentioned are printed once. Configuration Item: "
1173
"<literal>APT::Cache::RecurseDepends</literal>."
1176
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1177
#: apt-cache.8.xml:360
1178
msgid "<option>--installed</option>"
1181
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1182
#: apt-cache.8.xml:362
1184
"Limit the output of <literal>depends</literal> and "
1185
"<literal>rdepends</literal> to packages which are currently installed. "
1186
"Configuration Item: <literal>APT::Cache::Installed</literal>."
1189
#. type: Content of: <refentry><refsect1><variablelist>
1190
#: apt-cache.8.xml:367 apt-cdrom.8.xml:153 apt-config.8.xml:101 apt-extracttemplates.1.xml:70 apt-ftparchive.1.xml:612 apt-get.8.xml:596 apt-mark.8.xml:140 apt-sortpkgs.1.xml:67
1191
msgid "&apt-commonoptions;"
1194
#. type: Content of: <refentry><refsect1><title>
1195
#: apt-cache.8.xml:372 apt-get.8.xml:601 apt-key.8.xml:175 apt-mark.8.xml:144 apt.conf.5.xml:1110 apt_preferences.5.xml:697
1199
#. type: Content of: <refentry><refsect1><variablelist>
1200
#: apt-cache.8.xml:374
1201
msgid "&file-sourceslist; &file-statelists;"
1204
#. type: Content of: <refentry><refsect1><title>
1205
#: apt-cache.8.xml:379 apt-cdrom.8.xml:158 apt-config.8.xml:106 apt-extracttemplates.1.xml:77 apt-ftparchive.1.xml:628 apt-get.8.xml:611 apt-key.8.xml:196 apt-mark.8.xml:150 apt-secure.8.xml:185 apt-sortpkgs.1.xml:72 apt.conf.5.xml:1116 apt_preferences.5.xml:704 sources.list.5.xml:255
1209
#. type: Content of: <refentry><refsect1><para>
1210
#: apt-cache.8.xml:380
1211
msgid "&apt-conf;, &sources-list;, &apt-get;"
1214
#. type: Content of: <refentry><refsect1><title>
1215
#: apt-cache.8.xml:384 apt-cdrom.8.xml:163 apt-config.8.xml:111 apt-extracttemplates.1.xml:81 apt-ftparchive.1.xml:632 apt-get.8.xml:617 apt-mark.8.xml:154 apt-sortpkgs.1.xml:76
1219
#. type: Content of: <refentry><refsect1><para>
1220
#: apt-cache.8.xml:385
1222
"<command>apt-cache</command> returns zero on normal operation, decimal 100 "
1226
#. type: Content of: <refentry><refentryinfo>
1227
#: apt-cdrom.8.xml:16
1229
"&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>14 "
1230
"February 2004</date>"
1233
#. type: Content of: <refentry><refnamediv><refname>
1234
#: apt-cdrom.8.xml:24 apt-cdrom.8.xml:31
1238
#. type: Content of: <refentry><refnamediv><refpurpose>
1239
#: apt-cdrom.8.xml:32
1240
msgid "APT CDROM management utility"
1243
#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
1244
#: apt-cdrom.8.xml:38
1246
"<command>apt-cdrom</command> <arg><option>-hvrmfan</option></arg> "
1247
"<arg><option>-d=<replaceable>cdrom mount point</replaceable></option></arg> "
1248
"<arg><option>-o=<replaceable>config string</replaceable></option></arg> "
1249
"<arg><option>-c=<replaceable>file</replaceable></option></arg> <group> "
1250
"<arg>add</arg> <arg>ident</arg> </group>"
1253
#. type: Content of: <refentry><refsect1><para>
1254
#: apt-cdrom.8.xml:51
1256
"<command>apt-cdrom</command> is used to add a new CDROM to APTs list of "
1257
"available sources. <command>apt-cdrom</command> takes care of determining "
1258
"the structure of the disc as well as correcting for several possible "
1259
"mis-burns and verifying the index files."
1262
#. type: Content of: <refentry><refsect1><para>
1263
#: apt-cdrom.8.xml:58
1265
"It is necessary to use <command>apt-cdrom</command> to add CDs to the APT "
1266
"system, it cannot be done by hand. Furthermore each disk in a multi-cd set "
1267
"must be inserted and scanned separately to account for possible mis-burns."
1270
#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
1271
#: apt-cdrom.8.xml:68
1275
#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
1276
#: apt-cdrom.8.xml:69
1278
"<literal>add</literal> is used to add a new disc to the source list. It will "
1279
"unmount the CDROM device, prompt for a disk to be inserted and then proceed "
1280
"to scan it and copy the index files. If the disc does not have a proper "
1281
"<filename>disk</filename> directory you will be prompted for a descriptive "
1285
#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
1286
#: apt-cdrom.8.xml:77
1288
"APT uses a CDROM ID to track which disc is currently in the drive and "
1289
"maintains a database of these IDs in "
1290
"<filename>&statedir;/cdroms.list</filename>"
1293
#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
1294
#: apt-cdrom.8.xml:84
1298
#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
1299
#: apt-cdrom.8.xml:85
1301
"A debugging tool to report the identity of the current disc as well as the "
1305
#. type: Content of: <refentry><refsect1><para>
1306
#: apt-cdrom.8.xml:64
1308
"Unless the <option>-h</option>, or <option>--help</option> option is given "
1309
"one of the commands below must be present. <placeholder "
1310
"type=\"variablelist\" id=\"0\"/>"
1313
#. type: Content of: <refentry><refsect1><title>
1314
#: apt-cdrom.8.xml:94 apt-key.8.xml:161
1318
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1319
#: apt-cdrom.8.xml:98 apt-ftparchive.1.xml:540 apt-get.8.xml:356
1320
msgid "<option>-d</option>"
1323
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1324
#: apt-cdrom.8.xml:98
1325
msgid "<option>--cdrom</option>"
1328
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1329
#: apt-cdrom.8.xml:99
1331
"Mount point; specify the location to mount the cdrom. This mount point must "
1332
"be listed in <filename>/etc/fstab</filename> and properly configured. "
1333
"Configuration Item: <literal>Acquire::cdrom::mount</literal>."
1336
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1337
#: apt-cdrom.8.xml:107
1338
msgid "<option>-r</option>"
1341
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1342
#: apt-cdrom.8.xml:107
1343
msgid "<option>--rename</option>"
1346
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1347
#: apt-cdrom.8.xml:108
1349
"Rename a disc; change the label of a disk or override the disks given "
1350
"label. This option will cause <command>apt-cdrom</command> to prompt for a "
1351
"new label. Configuration Item: <literal>APT::CDROM::Rename</literal>."
1354
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1355
#: apt-cdrom.8.xml:116 apt-get.8.xml:375
1356
msgid "<option>-m</option>"
1359
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1360
#: apt-cdrom.8.xml:116
1361
msgid "<option>--no-mount</option>"
1364
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1365
#: apt-cdrom.8.xml:117
1367
"No mounting; prevent <command>apt-cdrom</command> from mounting and "
1368
"unmounting the mount point. Configuration Item: "
1369
"<literal>APT::CDROM::NoMount</literal>."
1372
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1373
#: apt-cdrom.8.xml:124
1374
msgid "<option>--fast</option>"
1377
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1378
#: apt-cdrom.8.xml:125
1380
"Fast Copy; Assume the package files are valid and do not check every "
1381
"package. This option should be used only if <command>apt-cdrom</command> has "
1382
"been run on this disc before and did not detect any errors. Configuration "
1383
"Item: <literal>APT::CDROM::Fast</literal>."
1386
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1387
#: apt-cdrom.8.xml:134
1388
msgid "<option>--thorough</option>"
1391
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1392
#: apt-cdrom.8.xml:135
1394
"Thorough Package Scan; This option may be needed with some old Debian "
1395
"1.1/1.2 discs that have Package files in strange places. It takes much "
1396
"longer to scan the CD but will pick them all up."
1399
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1400
#: apt-cdrom.8.xml:143 apt-get.8.xml:406
1401
msgid "<option>--just-print</option>"
1404
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1405
#: apt-cdrom.8.xml:144 apt-get.8.xml:408
1406
msgid "<option>--recon</option>"
1409
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1410
#: apt-cdrom.8.xml:145 apt-get.8.xml:409
1411
msgid "<option>--no-act</option>"
1414
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1415
#: apt-cdrom.8.xml:146
1417
"No Changes; Do not change the &sources-list; file and do not write index "
1418
"files. Everything is still checked however. Configuration Item: "
1419
"<literal>APT::CDROM::NoAct</literal>."
1422
#. type: Content of: <refentry><refsect1><para>
1423
#: apt-cdrom.8.xml:159
1424
msgid "&apt-conf;, &apt-get;, &sources-list;"
1427
#. type: Content of: <refentry><refsect1><para>
1428
#: apt-cdrom.8.xml:164
1430
"<command>apt-cdrom</command> returns zero on normal operation, decimal 100 "
1434
#. The last update date
1435
#. type: Content of: <refentry><refentryinfo>
1436
#: apt-config.8.xml:16 apt-extracttemplates.1.xml:16 apt-sortpkgs.1.xml:16 sources.list.5.xml:16
1438
"&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>29 "
1439
"February 2004</date>"
1442
#. type: Content of: <refentry><refnamediv><refname>
1443
#: apt-config.8.xml:25 apt-config.8.xml:32
1447
#. type: Content of: <refentry><refnamediv><refpurpose>
1448
#: apt-config.8.xml:33
1449
msgid "APT Configuration Query program"
1452
#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
1453
#: apt-config.8.xml:39
1455
"<command>apt-config</command> <arg><option>-hv</option></arg> "
1456
"<arg><option>-o=<replaceable>config string</replaceable></option></arg> "
1457
"<arg><option>-c=<replaceable>file</replaceable></option></arg> <group "
1458
"choice=\"req\"> <arg>shell</arg> <arg>dump</arg> </group>"
1461
#. type: Content of: <refentry><refsect1><para>
1462
#: apt-config.8.xml:51
1464
"<command>apt-config</command> is an internal program used by various "
1465
"portions of the APT suite to provide consistent configurability. It accesses "
1466
"the main configuration file <filename>/etc/apt/apt.conf</filename> in a "
1467
"manner that is easy to use by scripted applications."
1470
#. type: Content of: <refentry><refsect1><para>
1471
#: apt-config.8.xml:56 apt-ftparchive.1.xml:75
1473
"Unless the <option>-h</option>, or <option>--help</option> option is given "
1474
"one of the commands below must be present."
1477
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1478
#: apt-config.8.xml:61
1482
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1483
#: apt-config.8.xml:63
1485
"shell is used to access the configuration information from a shell "
1486
"script. It is given pairs of arguments, the first being a shell variable and "
1487
"the second the configuration value to query. As output it lists a series of "
1488
"shell assignments commands for each present value. In a shell script it "
1489
"should be used like:"
1492
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting>
1493
#: apt-config.8.xml:71
1497
"RES=`apt-config shell OPTS MyApp::options`\n"
1501
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1502
#: apt-config.8.xml:76
1504
"This will set the shell environment variable $OPTS to the value of "
1505
"MyApp::options with a default of <option>-f</option>."
1508
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1509
#: apt-config.8.xml:80
1511
"The configuration item may be postfixed with a /[fdbi]. f returns file "
1512
"names, d returns directories, b returns true or false and i returns an "
1513
"integer. Each of the returns is normalized and verified internally."
1516
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1517
#: apt-config.8.xml:89
1518
msgid "Just show the contents of the configuration space."
1521
#. type: Content of: <refentry><refsect1><para>
1522
#: apt-config.8.xml:107 apt-extracttemplates.1.xml:78 apt-ftparchive.1.xml:629 apt-sortpkgs.1.xml:73
1526
#. type: Content of: <refentry><refsect1><para>
1527
#: apt-config.8.xml:112
1529
"<command>apt-config</command> returns zero on normal operation, decimal 100 "
1533
#. type: Content of: <refentry><refnamediv><refname>
1534
#: apt-extracttemplates.1.xml:25 apt-extracttemplates.1.xml:32
1535
msgid "apt-extracttemplates"
1538
#. type: Content of: <refentry><refmeta><manvolnum>
1539
#: apt-extracttemplates.1.xml:26 apt-ftparchive.1.xml:26 apt-sortpkgs.1.xml:26
1543
#. type: Content of: <refentry><refnamediv><refpurpose>
1544
#: apt-extracttemplates.1.xml:33
1545
msgid "Utility to extract DebConf config and templates from Debian packages"
1548
#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
1549
#: apt-extracttemplates.1.xml:39
1551
"<command>apt-extracttemplates</command> <arg><option>-hv</option></arg> "
1552
"<arg><option>-t=<replaceable>temporary "
1553
"directory</replaceable></option></arg> <arg choice=\"plain\" "
1554
"rep=\"repeat\"><replaceable>file</replaceable></arg>"
1557
#. type: Content of: <refentry><refsect1><para>
1558
#: apt-extracttemplates.1.xml:47
1560
"<command>apt-extracttemplates</command> will take one or more Debian package "
1561
"files as input and write out (to a temporary directory) all associated "
1562
"config scripts and template files. For each passed in package that contains "
1563
"config scripts and templates, one line of output will be generated in the "
1567
#. type: Content of: <refentry><refsect1><para>
1568
#: apt-extracttemplates.1.xml:52
1569
msgid "package version template-file config-script"
1572
#. type: Content of: <refentry><refsect1><para>
1573
#: apt-extracttemplates.1.xml:53
1575
"template-file and config-script are written to the temporary directory "
1576
"specified by the -t or --tempdir "
1577
"(<literal>APT::ExtractTemplates::TempDir</literal>) directory, with "
1578
"filenames of the form <filename>package.template.XXXX</filename> and "
1579
"<filename>package.config.XXXX</filename>"
1582
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1583
#: apt-extracttemplates.1.xml:63 apt-get.8.xml:530
1584
msgid "<option>-t</option>"
1587
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1588
#: apt-extracttemplates.1.xml:63
1589
msgid "<option>--tempdir</option>"
1592
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1593
#: apt-extracttemplates.1.xml:65
1595
"Temporary directory in which to write extracted debconf template files and "
1596
"config scripts. Configuration Item: "
1597
"<literal>APT::ExtractTemplates::TempDir</literal>"
1600
#. type: Content of: <refentry><refsect1><para>
1601
#: apt-extracttemplates.1.xml:82
1603
"<command>apt-extracttemplates</command> returns zero on normal operation, "
1604
"decimal 100 on error."
1607
#. The last update date
1608
#. type: Content of: <refentry><refentryinfo>
1609
#: apt-ftparchive.1.xml:16
1611
"&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>17 "
1612
"August 2009</date>"
1615
#. type: Content of: <refentry><refnamediv><refname>
1616
#: apt-ftparchive.1.xml:25 apt-ftparchive.1.xml:32
1617
msgid "apt-ftparchive"
1620
#. type: Content of: <refentry><refnamediv><refpurpose>
1621
#: apt-ftparchive.1.xml:33
1622
msgid "Utility to generate index files"
1625
#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
1626
#: apt-ftparchive.1.xml:39
1628
"<command>apt-ftparchive</command> <arg><option>-hvdsq</option></arg> "
1629
"<arg><option>--md5</option></arg> <arg><option>--delink</option></arg> "
1630
"<arg><option>--readonly</option></arg> "
1631
"<arg><option>--contents</option></arg> <arg><option>--arch "
1632
"<replaceable>architecture</replaceable></option></arg> <arg><option>-o "
1633
"<replaceable>config</replaceable>=<replaceable>string</replaceable></option></arg> "
1634
"<arg><option>-c=<replaceable>file</replaceable></option></arg> <group "
1635
"choice=\"req\"> <arg>packages<arg choice=\"plain\" "
1636
"rep=\"repeat\"><replaceable>path</replaceable></arg><arg><replaceable>override</replaceable><arg><replaceable>pathprefix</replaceable></arg></arg></arg> "
1637
"<arg>sources<arg choice=\"plain\" "
1638
"rep=\"repeat\"><replaceable>path</replaceable></arg><arg><replaceable>override</replaceable><arg><replaceable>pathprefix</replaceable></arg></arg></arg> "
1639
"<arg>contents <arg "
1640
"choice=\"plain\"><replaceable>path</replaceable></arg></arg> <arg>release "
1641
"<arg choice=\"plain\"><replaceable>path</replaceable></arg></arg> "
1642
"<arg>generate <arg "
1643
"choice=\"plain\"><replaceable>config-file</replaceable></arg> <arg "
1645
"rep=\"repeat\"><replaceable>section</replaceable></arg></arg> <arg>clean "
1646
"<arg choice=\"plain\"><replaceable>config-file</replaceable></arg></arg> "
1650
#. type: Content of: <refentry><refsect1><para>
1651
#: apt-ftparchive.1.xml:60
1653
"<command>apt-ftparchive</command> is the command line tool that generates "
1654
"the index files that APT uses to access a distribution source. The index "
1655
"files should be generated on the origin site based on the content of that "
1659
#. type: Content of: <refentry><refsect1><para>
1660
#: apt-ftparchive.1.xml:64
1662
"<command>apt-ftparchive</command> is a superset of the &dpkg-scanpackages; "
1663
"program, incorporating its entire functionality via the "
1664
"<literal>packages</literal> command. It also contains a contents file "
1665
"generator, <literal>contents</literal>, and an elaborate means to 'script' "
1666
"the generation process for a complete archive."
1669
#. type: Content of: <refentry><refsect1><para>
1670
#: apt-ftparchive.1.xml:70
1672
"Internally <command>apt-ftparchive</command> can make use of binary "
1673
"databases to cache the contents of a .deb file and it does not rely on any "
1674
"external programs aside from &gzip;. When doing a full generate it "
1675
"automatically performs file-change checks and builds the desired compressed "
1679
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1680
#: apt-ftparchive.1.xml:79
1684
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1685
#: apt-ftparchive.1.xml:81
1687
"The packages command generates a package file from a directory tree. It "
1688
"takes the given directory and recursively searches it for .deb files, "
1689
"emitting a package record to stdout for each. This command is approximately "
1690
"equivalent to &dpkg-scanpackages;."
1693
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1694
#: apt-ftparchive.1.xml:86 apt-ftparchive.1.xml:110
1695
msgid "The option <option>--db</option> can be used to specify a binary caching DB."
1698
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1699
#: apt-ftparchive.1.xml:89
1703
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1704
#: apt-ftparchive.1.xml:91
1706
"The <literal>sources</literal> command generates a source index file from a "
1707
"directory tree. It takes the given directory and recursively searches it "
1708
"for .dsc files, emitting a source record to stdout for each. This command is "
1709
"approximately equivalent to &dpkg-scansources;."
1712
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1713
#: apt-ftparchive.1.xml:96
1715
"If an override file is specified then a source override file will be looked "
1716
"for with an extension of .src. The --source-override option can be used to "
1717
"change the source override file that will be used."
1720
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1721
#: apt-ftparchive.1.xml:101
1725
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1726
#: apt-ftparchive.1.xml:103
1728
"The <literal>contents</literal> command generates a contents file from a "
1729
"directory tree. It takes the given directory and recursively searches it for "
1730
".deb files, and reads the file list from each file. It then sorts and writes "
1731
"to stdout the list of files matched to packages. Directories are not written "
1732
"to the output. If multiple packages own the same file then each package is "
1733
"separated by a comma in the output."
1736
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1737
#: apt-ftparchive.1.xml:113
1741
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1742
#: apt-ftparchive.1.xml:115
1744
"The <literal>release</literal> command generates a Release file from a "
1745
"directory tree. It recursively searches the given directory for uncompressed "
1746
"<filename>Packages</filename> and <filename>Sources</filename> files and the "
1747
"ones compressed with <command>gzip</command>, <command>bzip2</command> or "
1748
"<command>lzma</command> as well as <filename>Release</filename> and "
1749
"<filename>md5sum.txt</filename> files by default "
1750
"(<literal>APT::FTPArchive::Release::Default-Patterns</literal>). Additional "
1751
"filename patterns can be added by listing them in "
1752
"<literal>APT::FTPArchive::Release::Patterns</literal>. It then writes to "
1753
"stdout a Release file containing a MD5, SHA1 and SHA256 digest for each "
1757
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1758
#: apt-ftparchive.1.xml:125
1760
"Values for the additional metadata fields in the Release file are taken from "
1761
"the corresponding variables under "
1762
"<literal>APT::FTPArchive::Release</literal>, "
1763
"e.g. <literal>APT::FTPArchive::Release::Origin</literal>. The supported "
1764
"fields are: <literal>Origin</literal>, <literal>Label</literal>, "
1765
"<literal>Suite</literal>, <literal>Version</literal>, "
1766
"<literal>Codename</literal>, <literal>Date</literal>, "
1767
"<literal>Valid-Until</literal>, <literal>Architectures</literal>, "
1768
"<literal>Components</literal>, <literal>Description</literal>."
1771
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1772
#: apt-ftparchive.1.xml:136
1776
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1777
#: apt-ftparchive.1.xml:138
1779
"The <literal>generate</literal> command is designed to be runnable from a "
1780
"cron script and builds indexes according to the given config file. The "
1781
"config language provides a flexible means of specifying which index files "
1782
"are built from which directories, as well as providing a simple means of "
1783
"maintaining the required settings."
1786
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1787
#: apt-ftparchive.1.xml:145 apt-get.8.xml:298
1791
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1792
#: apt-ftparchive.1.xml:147
1794
"The <literal>clean</literal> command tidies the databases used by the given "
1795
"configuration file by removing any records that are no longer necessary."
1798
#. type: Content of: <refentry><refsect1><title>
1799
#: apt-ftparchive.1.xml:153
1800
msgid "The Generate Configuration"
1803
#. type: Content of: <refentry><refsect1><para>
1804
#: apt-ftparchive.1.xml:155
1806
"The <literal>generate</literal> command uses a configuration file to "
1807
"describe the archives that are going to be generated. It follows the typical "
1808
"ISC configuration format as seen in ISC tools like bind 8 and dhcpd. "
1809
"&apt-conf; contains a description of the syntax. Note that the generate "
1810
"configuration is parsed in sectional manner, but &apt-conf; is parsed in a "
1811
"tree manner. This only effects how the scope tag is handled."
1814
#. type: Content of: <refentry><refsect1><para>
1815
#: apt-ftparchive.1.xml:163
1816
msgid "The generate configuration has 4 separate sections, each described below."
1819
#. type: Content of: <refentry><refsect1><refsect2><title>
1820
#: apt-ftparchive.1.xml:165
1824
#. type: Content of: <refentry><refsect1><refsect2><para>
1825
#: apt-ftparchive.1.xml:167
1827
"The <literal>Dir</literal> section defines the standard directories needed "
1828
"to locate the files required during the generation process. These "
1829
"directories are prepended certain relative paths defined in later sections "
1830
"to produce a complete an absolute path."
1833
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
1834
#: apt-ftparchive.1.xml:172
1838
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
1839
#: apt-ftparchive.1.xml:174
1841
"Specifies the root of the FTP archive, in a standard Debian configuration "
1842
"this is the directory that contains the <filename>ls-LR</filename> and dist "
1846
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
1847
#: apt-ftparchive.1.xml:179
1851
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
1852
#: apt-ftparchive.1.xml:181
1853
msgid "Specifies the location of the override files."
1856
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
1857
#: apt-ftparchive.1.xml:184
1861
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
1862
#: apt-ftparchive.1.xml:186
1863
msgid "Specifies the location of the cache files"
1866
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
1867
#: apt-ftparchive.1.xml:189
1871
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
1872
#: apt-ftparchive.1.xml:191
1874
"Specifies the location of the file list files, if the "
1875
"<literal>FileList</literal> setting is used below."
1878
#. type: Content of: <refentry><refsect1><refsect2><title>
1879
#: apt-ftparchive.1.xml:197
1880
msgid "Default Section"
1883
#. type: Content of: <refentry><refsect1><refsect2><para>
1884
#: apt-ftparchive.1.xml:199
1886
"The <literal>Default</literal> section specifies default values, and "
1887
"settings that control the operation of the generator. Other sections may "
1888
"override these defaults with a per-section setting."
1891
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
1892
#: apt-ftparchive.1.xml:203
1893
msgid "Packages::Compress"
1896
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
1897
#: apt-ftparchive.1.xml:205
1899
"Sets the default compression schemes to use for the Package index files. It "
1900
"is a string that contains a space separated list of at least one of: '.' (no "
1901
"compression), 'gzip' and 'bzip2'. The default for all compression schemes is "
1905
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
1906
#: apt-ftparchive.1.xml:211
1907
msgid "Packages::Extensions"
1910
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
1911
#: apt-ftparchive.1.xml:213
1913
"Sets the default list of file extensions that are package files. This "
1914
"defaults to '.deb'."
1917
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
1918
#: apt-ftparchive.1.xml:217
1919
msgid "Sources::Compress"
1922
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
1923
#: apt-ftparchive.1.xml:219
1925
"This is similar to <literal>Packages::Compress</literal> except that it "
1926
"controls the compression for the Sources files."
1929
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
1930
#: apt-ftparchive.1.xml:223
1931
msgid "Sources::Extensions"
1934
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
1935
#: apt-ftparchive.1.xml:225
1937
"Sets the default list of file extensions that are source files. This "
1938
"defaults to '.dsc'."
1941
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
1942
#: apt-ftparchive.1.xml:229
1943
msgid "Contents::Compress"
1946
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
1947
#: apt-ftparchive.1.xml:231
1949
"This is similar to <literal>Packages::Compress</literal> except that it "
1950
"controls the compression for the Contents files."
1953
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
1954
#: apt-ftparchive.1.xml:235
1955
msgid "Translation::Compress"
1958
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
1959
#: apt-ftparchive.1.xml:237
1961
"This is similar to <literal>Packages::Compress</literal> except that it "
1962
"controls the compression for the Translation-en master file."
1965
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
1966
#: apt-ftparchive.1.xml:241
1970
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
1971
#: apt-ftparchive.1.xml:243
1973
"Specifies the number of kilobytes to delink (and replace with hard links) "
1974
"per run. This is used in conjunction with the per-section "
1975
"<literal>External-Links</literal> setting."
1978
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
1979
#: apt-ftparchive.1.xml:248
1983
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
1984
#: apt-ftparchive.1.xml:250
1986
"Specifies the mode of all created index files. It defaults to 0644. All "
1987
"index files are set to this mode with no regard to the umask."
1990
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
1991
#: apt-ftparchive.1.xml:255 apt-ftparchive.1.xml:401
1992
msgid "LongDescription"
1995
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
1996
#: apt-ftparchive.1.xml:257 apt-ftparchive.1.xml:403
1998
"Sets if long descriptions should be included in the Packages file or split "
1999
"out into a master Translation-en file."
2002
#. type: Content of: <refentry><refsect1><refsect2><title>
2003
#: apt-ftparchive.1.xml:263
2004
msgid "TreeDefault Section"
2007
#. type: Content of: <refentry><refsect1><refsect2><para>
2008
#: apt-ftparchive.1.xml:265
2010
"Sets defaults specific to <literal>Tree</literal> sections. All of these "
2011
"variables are substitution variables and have the strings $(DIST), "
2012
"$(SECTION) and $(ARCH) replaced with their respective values."
2015
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2016
#: apt-ftparchive.1.xml:270
2017
msgid "MaxContentsChange"
2020
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2021
#: apt-ftparchive.1.xml:272
2023
"Sets the number of kilobytes of contents files that are generated each "
2024
"day. The contents files are round-robined so that over several days they "
2025
"will all be rebuilt."
2028
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2029
#: apt-ftparchive.1.xml:277
2033
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2034
#: apt-ftparchive.1.xml:279
2036
"Controls the number of days a contents file is allowed to be checked without "
2037
"changing. If this limit is passed the mtime of the contents file is "
2038
"updated. This case can occur if the package file is changed in such a way "
2039
"that does not result in a new contents file [override edit for instance]. A "
2040
"hold off is allowed in hopes that new .debs will be installed, requiring a "
2041
"new file anyhow. The default is 10, the units are in days."
2044
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2045
#: apt-ftparchive.1.xml:288
2049
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2050
#: apt-ftparchive.1.xml:290
2052
"Sets the top of the .deb directory tree. Defaults to "
2053
"<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/</filename>"
2056
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2057
#: apt-ftparchive.1.xml:294
2058
msgid "SrcDirectory"
2061
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2062
#: apt-ftparchive.1.xml:296
2064
"Sets the top of the source package directory tree. Defaults to "
2065
"<filename>$(DIST)/$(SECTION)/source/</filename>"
2068
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2069
#: apt-ftparchive.1.xml:300 apt-ftparchive.1.xml:439
2073
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2074
#: apt-ftparchive.1.xml:302
2076
"Sets the output Packages file. Defaults to "
2077
"<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/Packages</filename>"
2080
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2081
#: apt-ftparchive.1.xml:306 apt-ftparchive.1.xml:444
2085
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2086
#: apt-ftparchive.1.xml:308
2088
"Sets the output Sources file. Defaults to "
2089
"<filename>$(DIST)/$(SECTION)/source/Sources</filename>"
2092
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2093
#: apt-ftparchive.1.xml:312
2097
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2098
#: apt-ftparchive.1.xml:314
2100
"Set the output Translation-en master file with the long descriptions if they "
2101
"should be not included in the Packages file. Defaults to "
2102
"<filename>$(DIST)/$(SECTION)/i18n/Translation-en</filename>"
2105
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2106
#: apt-ftparchive.1.xml:319
2107
msgid "InternalPrefix"
2110
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2111
#: apt-ftparchive.1.xml:321
2113
"Sets the path prefix that causes a symlink to be considered an internal link "
2114
"instead of an external link. Defaults to "
2115
"<filename>$(DIST)/$(SECTION)/</filename>"
2118
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2119
#: apt-ftparchive.1.xml:326 apt-ftparchive.1.xml:450
2123
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2124
#: apt-ftparchive.1.xml:328
2126
"Sets the output Contents file. Defaults to "
2127
"<filename>$(DIST)/Contents-$(ARCH)</filename>. If this setting causes "
2128
"multiple Packages files to map onto a single Contents file (such as the "
2129
"default) then <command>apt-ftparchive</command> will integrate those "
2130
"package files together automatically."
2133
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2134
#: apt-ftparchive.1.xml:335
2135
msgid "Contents::Header"
2138
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2139
#: apt-ftparchive.1.xml:337
2140
msgid "Sets header file to prepend to the contents output."
2143
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2144
#: apt-ftparchive.1.xml:340 apt-ftparchive.1.xml:475
2148
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2149
#: apt-ftparchive.1.xml:342
2151
"Sets the binary cache database to use for this section. Multiple sections "
2152
"can share the same database."
2155
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2156
#: apt-ftparchive.1.xml:346
2160
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2161
#: apt-ftparchive.1.xml:348
2163
"Specifies that instead of walking the directory tree, "
2164
"<command>apt-ftparchive</command> should read the list of files from the "
2165
"given file. Relative files names are prefixed with the archive directory."
2168
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2169
#: apt-ftparchive.1.xml:353
2170
msgid "SourceFileList"
2173
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2174
#: apt-ftparchive.1.xml:355
2176
"Specifies that instead of walking the directory tree, "
2177
"<command>apt-ftparchive</command> should read the list of files from the "
2178
"given file. Relative files names are prefixed with the archive directory. "
2179
"This is used when processing source indexes."
2182
#. type: Content of: <refentry><refsect1><refsect2><title>
2183
#: apt-ftparchive.1.xml:363
2184
msgid "Tree Section"
2187
#. type: Content of: <refentry><refsect1><refsect2><para>
2188
#: apt-ftparchive.1.xml:365
2190
"The <literal>Tree</literal> section defines a standard Debian file tree "
2191
"which consists of a base directory, then multiple sections in that base "
2192
"directory and finally multiple Architectures in each section. The exact "
2193
"pathing used is defined by the <literal>Directory</literal> substitution "
2197
#. type: Content of: <refentry><refsect1><refsect2><para>
2198
#: apt-ftparchive.1.xml:370
2200
"The <literal>Tree</literal> section takes a scope tag which sets the "
2201
"<literal>$(DIST)</literal> variable and defines the root of the tree (the "
2202
"path is prefixed by <literal>ArchiveDir</literal>). Typically this is a "
2203
"setting such as <filename>dists/&stable-codename;</filename>."
2206
#. type: Content of: <refentry><refsect1><refsect2><para>
2207
#: apt-ftparchive.1.xml:375
2209
"All of the settings defined in the <literal>TreeDefault</literal> section "
2210
"can be use in a <literal>Tree</literal> section as well as three new "
2214
#. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
2215
#: apt-ftparchive.1.xml:381
2218
"for i in Sections do \n"
2219
" for j in Architectures do\n"
2220
" Generate for DIST=scope SECTION=i ARCH=j\n"
2224
#. type: Content of: <refentry><refsect1><refsect2><para>
2225
#: apt-ftparchive.1.xml:378
2227
"When processing a <literal>Tree</literal> section "
2228
"<command>apt-ftparchive</command> performs an operation similar to: "
2229
"<placeholder type=\"programlisting\" id=\"0\"/>"
2232
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2233
#: apt-ftparchive.1.xml:387
2237
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2238
#: apt-ftparchive.1.xml:389
2240
"This is a space separated list of sections which appear under the "
2241
"distribution, typically this is something like <literal>main contrib "
2242
"non-free</literal>"
2245
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
2246
#: apt-ftparchive.1.xml:394 apt.conf.5.xml:157
2247
msgid "Architectures"
2250
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2251
#: apt-ftparchive.1.xml:396
2253
"This is a space separated list of all the architectures that appear under "
2254
"search section. The special architecture 'source' is used to indicate that "
2255
"this tree has a source archive."
2258
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2259
#: apt-ftparchive.1.xml:407 apt-ftparchive.1.xml:455
2263
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2264
#: apt-ftparchive.1.xml:409
2266
"Sets the binary override file. The override file contains section, priority "
2267
"and maintainer address information."
2270
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2271
#: apt-ftparchive.1.xml:413 apt-ftparchive.1.xml:460
2275
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2276
#: apt-ftparchive.1.xml:415
2278
"Sets the source override file. The override file contains section "
2282
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2283
#: apt-ftparchive.1.xml:419 apt-ftparchive.1.xml:465
2284
msgid "ExtraOverride"
2287
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2288
#: apt-ftparchive.1.xml:421 apt-ftparchive.1.xml:467
2289
msgid "Sets the binary extra override file."
2292
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2293
#: apt-ftparchive.1.xml:424 apt-ftparchive.1.xml:470
2294
msgid "SrcExtraOverride"
2297
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2298
#: apt-ftparchive.1.xml:426 apt-ftparchive.1.xml:472
2299
msgid "Sets the source extra override file."
2302
#. type: Content of: <refentry><refsect1><refsect2><title>
2303
#: apt-ftparchive.1.xml:431
2304
msgid "BinDirectory Section"
2307
#. type: Content of: <refentry><refsect1><refsect2><para>
2308
#: apt-ftparchive.1.xml:433
2310
"The <literal>bindirectory</literal> section defines a binary directory tree "
2311
"with no special structure. The scope tag specifies the location of the "
2312
"binary directory and the settings are similar to the <literal>Tree</literal> "
2313
"section with no substitution variables or "
2314
"<literal>Section</literal><literal>Architecture</literal> settings."
2317
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2318
#: apt-ftparchive.1.xml:441
2319
msgid "Sets the Packages file output."
2322
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2323
#: apt-ftparchive.1.xml:446
2325
"Sets the Sources file output. At least one of <literal>Packages</literal> or "
2326
"<literal>Sources</literal> is required."
2329
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2330
#: apt-ftparchive.1.xml:452
2331
msgid "Sets the Contents file output. (optional)"
2334
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2335
#: apt-ftparchive.1.xml:457
2336
msgid "Sets the binary override file."
2339
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2340
#: apt-ftparchive.1.xml:462
2341
msgid "Sets the source override file."
2344
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2345
#: apt-ftparchive.1.xml:477
2346
msgid "Sets the cache DB."
2349
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2350
#: apt-ftparchive.1.xml:480
2354
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2355
#: apt-ftparchive.1.xml:482
2356
msgid "Appends a path to all the output paths."
2359
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
2360
#: apt-ftparchive.1.xml:485
2361
msgid "FileList, SourceFileList"
2364
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
2365
#: apt-ftparchive.1.xml:487
2366
msgid "Specifies the file list file."
2369
#. type: Content of: <refentry><refsect1><title>
2370
#: apt-ftparchive.1.xml:494
2371
msgid "The Binary Override File"
2374
#. type: Content of: <refentry><refsect1><para>
2375
#: apt-ftparchive.1.xml:495
2377
"The binary override file is fully compatible with &dpkg-scanpackages;. It "
2378
"contains 4 fields separated by spaces. The first field is the package name, "
2379
"the second is the priority to force that package to, the third is the the "
2380
"section to force that package to and the final field is the maintainer "
2381
"permutation field."
2384
#. type: Content of: <refentry><refsect1><para><literallayout>
2385
#: apt-ftparchive.1.xml:501
2387
msgid "old [// oldn]* => new"
2390
#. type: Content of: <refentry><refsect1><para><literallayout>
2391
#: apt-ftparchive.1.xml:503
2396
#. type: Content of: <refentry><refsect1><para>
2397
#: apt-ftparchive.1.xml:500
2399
"The general form of the maintainer field is: <placeholder "
2400
"type=\"literallayout\" id=\"0\"/> or simply, <placeholder "
2401
"type=\"literallayout\" id=\"1\"/> The first form allows a double-slash "
2402
"separated list of old email addresses to be specified. If any of those are "
2403
"found then new is substituted for the maintainer field. The second form "
2404
"unconditionally substitutes the maintainer field."
2407
#. type: Content of: <refentry><refsect1><title>
2408
#: apt-ftparchive.1.xml:511
2409
msgid "The Source Override File"
2412
#. type: Content of: <refentry><refsect1><para>
2413
#: apt-ftparchive.1.xml:513
2415
"The source override file is fully compatible with &dpkg-scansources;. It "
2416
"contains 2 fields separated by spaces. The first fields is the source "
2417
"package name, the second is the section to assign it."
2420
#. type: Content of: <refentry><refsect1><title>
2421
#: apt-ftparchive.1.xml:518
2422
msgid "The Extra Override File"
2425
#. type: Content of: <refentry><refsect1><para>
2426
#: apt-ftparchive.1.xml:520
2428
"The extra override file allows any arbitrary tag to be added or replaced in "
2429
"the output. It has 3 columns, the first is the package, the second is the "
2430
"tag and the remainder of the line is the new value."
2433
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
2434
#: apt-ftparchive.1.xml:529
2435
msgid "<option>--md5</option>, <option>--sha1</option>, <option>--sha256</option>"
2438
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2439
#: apt-ftparchive.1.xml:531
2441
"Generate the given checksum. These options default to on, when turned off "
2442
"the generated index files will not have the checksum fields where possible. "
2443
"Configuration Items: "
2444
"<literal>APT::FTPArchive::<replaceable>Checksum</replaceable></literal> and "
2445
"<literal>APT::FTPArchive::<replaceable>Index</replaceable>::<replaceable>Checksum</replaceable></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>."
2454
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
2455
#: apt-ftparchive.1.xml:540
2456
msgid "<option>--db</option>"
2459
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2460
#: apt-ftparchive.1.xml:542
2462
"Use a binary caching DB. This has no effect on the generate command. "
2463
"Configuration Item: <literal>APT::FTPArchive::DB</literal>."
2466
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2467
#: apt-ftparchive.1.xml:548
2469
"Quiet; produces output suitable for logging, omitting progress indicators. "
2470
"More q's will produce more quiet up to a maximum of 2. You can also use "
2471
"<option>-q=#</option> to set the quiet level, overriding the configuration "
2472
"file. Configuration Item: <literal>quiet</literal>."
2475
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
2476
#: apt-ftparchive.1.xml:554
2477
msgid "<option>--delink</option>"
2480
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2481
#: apt-ftparchive.1.xml:556
2483
"Perform Delinking. If the <literal>External-Links</literal> setting is used "
2484
"then this option actually enables delinking of the files. It defaults to on "
2485
"and can be turned off with <option>--no-delink</option>. Configuration "
2486
"Item: <literal>APT::FTPArchive::DeLinkAct</literal>."
2489
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
2490
#: apt-ftparchive.1.xml:562
2491
msgid "<option>--contents</option>"
2494
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2495
#: apt-ftparchive.1.xml:564
2497
"Perform contents generation. When this option is set and package indexes are "
2498
"being generated with a cache DB then the file listing will also be extracted "
2499
"and stored in the DB for later use. When using the generate command this "
2500
"option also allows the creation of any Contents files. The default is on. "
2501
"Configuration Item: <literal>APT::FTPArchive::Contents</literal>."
2504
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
2505
#: apt-ftparchive.1.xml:572
2506
msgid "<option>--source-override</option>"
2509
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2510
#: apt-ftparchive.1.xml:574
2512
"Select the source override file to use with the <literal>sources</literal> "
2513
"command. Configuration Item: "
2514
"<literal>APT::FTPArchive::SourceOverride</literal>."
2517
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
2518
#: apt-ftparchive.1.xml:578
2519
msgid "<option>--readonly</option>"
2522
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2523
#: apt-ftparchive.1.xml:580
2525
"Make the caching databases read only. Configuration Item: "
2526
"<literal>APT::FTPArchive::ReadOnlyDB</literal>."
2529
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
2530
#: apt-ftparchive.1.xml:584
2531
msgid "<option>--arch</option>"
2534
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2535
#: apt-ftparchive.1.xml:585
2537
"Accept in the <literal>packages</literal> and <literal>contents</literal> "
2538
"commands only package files matching <literal>*_arch.deb</literal> or "
2539
"<literal>*_all.deb</literal> instead of all package files in the given "
2540
"path. Configuration Item: <literal>APT::FTPArchive::Architecture</literal>."
2543
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
2544
#: apt-ftparchive.1.xml:591
2545
msgid "<option>APT::FTPArchive::AlwaysStat</option>"
2548
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2549
#: apt-ftparchive.1.xml:593
2551
"&apt-ftparchive; caches as much as possible of metadata in a cachedb. If "
2552
"packages are recompiled and/or republished with the same version again, this "
2553
"will lead to problems as the now outdated cached metadata like size and "
2554
"checksums will be used. With this option enabled this will no longer happen "
2555
"as it will be checked if the file was changed. Note that this option is set "
2556
"to \"<literal>false</literal>\" by default as it is not recommend to upload "
2557
"multiply versions/builds of a package with the same versionnumber, so in "
2558
"theory nobody will have these problems and therefore all these extra checks "
2562
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
2563
#: apt-ftparchive.1.xml:603
2564
msgid "<option>APT::FTPArchive::LongDescription</option>"
2567
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2568
#: apt-ftparchive.1.xml:605
2570
"This configuration option defaults to \"<literal>true</literal>\" and should "
2571
"only be set to <literal>\"false\"</literal> if the Archive generated with "
2572
"&apt-ftparchive; also provides <filename>Translation</filename> files. Note "
2573
"that the <filename>Translation-en</filename> master file can only be created "
2574
"in the generate command."
2577
#. type: Content of: <refentry><refsect1><title>
2578
#: apt-ftparchive.1.xml:617 apt.conf.5.xml:1104 apt_preferences.5.xml:544 sources.list.5.xml:214
2582
#. type: Content of: <refentry><refsect1><para><programlisting>
2583
#: apt-ftparchive.1.xml:623
2586
"<command>apt-ftparchive</command> packages "
2587
"<replaceable>directory</replaceable> | <command>gzip</command> > "
2588
"<filename>Packages.gz</filename>\n"
2591
#. type: Content of: <refentry><refsect1><para>
2592
#: apt-ftparchive.1.xml:619
2594
"To create a compressed Packages file for a directory containing binary "
2595
"packages (.deb): <placeholder type=\"programlisting\" id=\"0\"/>"
2598
#. type: Content of: <refentry><refsect1><para>
2599
#: apt-ftparchive.1.xml:633
2601
"<command>apt-ftparchive</command> returns zero on normal operation, decimal "
2605
#. The last update date
2606
#. type: Content of: <refentry><refentryinfo>
2609
"&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>08 "
2610
"November 2008</date>"
2613
#. type: <heading></heading>
2614
#: apt-get.8.xml:25 apt-get.8.xml:32 guide.sgml:96
2618
#. type: Content of: <refentry><refnamediv><refpurpose>
2619
510
#: apt-get.8.xml:33
2620
511
msgid "APT package handling utility -- command-line interface"
2623
#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
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
519
#. type: Content of: <refentry><refsect1><para>
2624
520
#: apt-get.8.xml:39
2626
"<command>apt-get</command> <arg><option>-sqdyfmubV</option></arg> <arg> "
2627
"<option>-o= <replaceable>config_string</replaceable> </option> </arg> <arg> "
2628
"<option>-c= <replaceable>config_file</replaceable> </option> </arg> <arg> "
2629
"<option>-t=</option> <arg choice='plain'> "
2630
"<replaceable>target_release</replaceable> </arg> </arg> <arg> "
2631
"<option>-a=</option> <arg choice='plain'> "
2632
"<replaceable>default_architecture</replaceable> </arg> </arg> <group "
2633
"choice=\"req\"> <arg choice='plain'>update</arg> <arg "
2634
"choice='plain'>upgrade</arg> <arg choice='plain'>dselect-upgrade</arg> <arg "
2635
"choice='plain'>dist-upgrade</arg> <arg choice='plain'>install <arg "
2636
"choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable> <arg> <group "
2637
"choice='req'> <arg choice='plain'> "
2638
"=<replaceable>pkg_version_number</replaceable> </arg> <arg choice='plain'> "
2639
"/<replaceable>target_release</replaceable> </arg> </group> </arg> </arg> "
2640
"</arg> <arg choice='plain'>remove <arg choice=\"plain\" "
2641
"rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg "
2642
"choice='plain'>purge <arg choice=\"plain\" "
2643
"rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg "
2644
"choice='plain'>source <arg choice=\"plain\" "
2645
"rep=\"repeat\"><replaceable>pkg</replaceable> <arg> <group choice='req'> "
2646
"<arg choice='plain'> =<replaceable>pkg_version_number</replaceable> </arg> "
2647
"<arg choice='plain'> /<replaceable>target_release</replaceable> </arg> "
2648
"</group> </arg> </arg> </arg> <arg choice='plain'>build-dep <arg "
2649
"choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
2650
"<arg choice='plain'>check</arg> <arg choice='plain'>clean</arg> <arg "
2651
"choice='plain'>autoclean</arg> <arg choice='plain'>autoremove</arg> <arg "
2652
"choice='plain'> <group choice='req'> <arg choice='plain'>-v</arg> <arg "
2653
"choice='plain'>--version</arg> </group> </arg> <arg choice='plain'> <group "
2654
"choice='req'> <arg choice='plain'>-h</arg> <arg choice='plain'>--help</arg> "
2655
"</group> </arg> </group>"
2658
#. type: Content of: <refentry><refsect1><para>
2659
#: apt-get.8.xml:122
2661
522
"<command>apt-get</command> is the command-line tool for handling packages, "
2662
523
"and may be considered the user's \"back-end\" to other tools using the APT "
2663
524
"library. Several \"front-end\" interfaces exist, such as &dselect;, "
2664
525
"&aptitude;, &synaptic; and &wajig;."
2667
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
2668
#: apt-get.8.xml:131 apt-key.8.xml:127
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
531
"Unless the <option>-h</option>, or <option>--help</option> option is given, "
532
"one of the commands below must be present."
2672
535
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
2673
#: apt-get.8.xml:132
2675
538
"<literal>update</literal> is used to resynchronize the package index files "
2676
539
"from their sources. The indexes of available packages are fetched from the "
3471
1089
"<literal>APT::Get::Tar-Only</literal>."
3474
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3475
#: apt-get.8.xml:584
3476
msgid "<option>--arch-only</option>"
3479
1092
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3480
#: apt-get.8.xml:585
1093
#: apt-get.8.xml:502
3482
1095
"Only process architecture-dependent build-dependencies. Configuration Item: "
3483
1096
"<literal>APT::Get::Arch-Only</literal>."
3486
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
3487
#: apt-get.8.xml:589
3488
msgid "<option>--allow-unauthenticated</option>"
3491
1099
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
3492
#: apt-get.8.xml:590
1100
#: apt-get.8.xml:507
3494
1102
"Ignore if packages can't be authenticated and don't prompt about it. This "
3495
1103
"is useful for tools like pbuilder. Configuration Item: "
3496
1104
"<literal>APT::Get::AllowUnauthenticated</literal>."
3499
#. type: Content of: <refentry><refsect1><variablelist>
3500
#: apt-get.8.xml:603
3502
"&file-sourceslist; &file-aptconf; &file-preferences; &file-cachearchives; "
1107
#. type: Content of: <refentry><refsect1><title>
1108
#: apt-get.8.xml:518 apt-cache.8.xml:343 apt-key.8.xml:174 apt-mark.8.xml:125 apt.conf.5.xml:1156 apt_preferences.5.xml:698
1112
#. type: Content of: <refentry><refsect1><title>
1113
#: apt-get.8.xml:528 apt-cache.8.xml:350 apt-key.8.xml:195 apt-mark.8.xml:131 apt-secure.8.xml:191 apt-cdrom.8.xml:144 apt-config.8.xml:109 apt.conf.5.xml:1162 apt_preferences.5.xml:705 sources.list.5.xml:252 apt-extracttemplates.1.xml:70 apt-sortpkgs.1.xml:63 apt-ftparchive.1.xml:607
3506
1117
#. type: Content of: <refentry><refsect1><para>
3507
#: apt-get.8.xml:612
1118
#: apt-get.8.xml:529
3509
1120
"&apt-cache;, &apt-cdrom;, &dpkg;, &dselect;, &sources-list;, &apt-conf;, "
3510
1121
"&apt-config;, &apt-secure;, The APT User's guide in &guidesdir;, "
3511
1122
"&apt-preferences;, the APT Howto."
1125
#. type: Content of: <refentry><refsect1><title>
1126
#: apt-get.8.xml:534 apt-cache.8.xml:355 apt-mark.8.xml:135 apt-cdrom.8.xml:149 apt-config.8.xml:114 apt-extracttemplates.1.xml:74 apt-sortpkgs.1.xml:67 apt-ftparchive.1.xml:611
3514
1130
#. type: Content of: <refentry><refsect1><para>
3515
#: apt-get.8.xml:618
1131
#: apt-get.8.xml:535
3517
1133
"<command>apt-get</command> returns zero on normal operation, decimal 100 on "
3521
#. type: Content of: <refentry><refsect1><title>
3522
#: apt-get.8.xml:621
3523
msgid "ORIGINAL AUTHORS"
3526
#. type: Content of: <refentry><refsect1><para>
3527
#: apt-get.8.xml:622
3528
msgid "&apt-author.jgunthorpe;"
3531
#. type: Content of: <refentry><refsect1><title>
3532
#: apt-get.8.xml:625
3533
msgid "CURRENT AUTHORS"
3536
#. type: Content of: <refentry><refsect1><para>
3537
#: apt-get.8.xml:627
3538
msgid "&apt-author.team;"
3541
#. type: Content of: <refentry><refnamediv><refname>
3542
#: apt-key.8.xml:17 apt-key.8.xml:24
3546
#. type: Content of: <refentry><refnamediv><refpurpose>
1137
#. type: Content of: <refentry><refnamediv><refpurpose>
1138
#: apt-cache.8.xml:33
1139
msgid "query the APT cache"
1142
#. type: Content of: <refentry><refsect1><para>
1143
#: apt-cache.8.xml:39
1145
"<command>apt-cache</command> performs a variety of operations on APT's "
1146
"package cache. <command>apt-cache</command> does not manipulate the state of "
1147
"the system but does provide operations to search and generate interesting "
1148
"output from the package metadata."
1151
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1152
#: apt-cache.8.xml:49
1154
"<literal>gencaches</literal> creates APT's package cache. This is done "
1155
"implicitly by all commands needing this cache if it is missing or outdated."
1158
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term><option><replaceable>
1159
#: 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
1160
msgid "&synopsis-pkg;"
1163
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1164
#: apt-cache.8.xml:54
1166
"<literal>showpkg</literal> displays information about the packages listed on "
1167
"the command line. Remaining arguments are package names. The available "
1168
"versions and reverse dependencies of each package listed are listed, as well "
1169
"as forward dependencies for each version. Forward (normal) dependencies are "
1170
"those packages upon which the package in question depends; reverse "
1171
"dependencies are those packages that depend upon the package in "
1172
"question. Thus, forward dependencies must be satisfied for a package, but "
1173
"reverse dependencies need not be. For instance, <command>apt-cache showpkg "
1174
"libreadline2</command> would produce output similar to the following:"
1177
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting>
1178
#: apt-cache.8.xml:66
1181
"Package: libreadline2\n"
1182
"Versions: 2.1-12(/var/state/apt/lists/foo_Packages),\n"
1183
"Reverse Depends: \n"
1184
" libreadlineg2,libreadline2\n"
1185
" libreadline2-altdev,libreadline2\n"
1187
"2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))\n"
1190
"Reverse Provides: \n"
1193
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1194
#: apt-cache.8.xml:78
1196
"Thus it may be seen that libreadline2, version 2.1-12, depends on libc5 and "
1197
"ncurses3.0 which must be installed for libreadline2 to work. In turn, "
1198
"libreadlineg2 and libreadline2-altdev depend on libreadline2. If "
1199
"libreadline2 is installed, libc5 and ncurses3.0 (and ldso) must also be "
1200
"installed; libreadlineg2 and libreadline2-altdev do not have to be "
1201
"installed. For the specific meaning of the remainder of the output it is "
1202
"best to consult the apt source code."
1205
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1206
#: apt-cache.8.xml:87
1208
"<literal>stats</literal> displays some statistics about the cache. No "
1209
"further arguments are expected. Statistics reported are:"
1212
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
1213
#: apt-cache.8.xml:90
1215
"<literal>Total package names</literal> is the number of package names found "
1219
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
1220
#: apt-cache.8.xml:94
1222
"<literal>Normal packages</literal> is the number of regular, ordinary "
1223
"package names; these are packages that bear a one-to-one correspondence "
1224
"between their names and the names used by other packages for them in "
1225
"dependencies. The majority of packages fall into this category."
1228
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
1229
#: apt-cache.8.xml:100
1231
"<literal>Pure virtual packages</literal> is the number of packages that "
1232
"exist only as a virtual package name; that is, packages only \"provide\" the "
1233
"virtual package name, and no package actually uses the name. For instance, "
1234
"\"mail-transport-agent\" in the Debian system is a pure virtual package; "
1235
"several packages provide \"mail-transport-agent\", but there is no package "
1236
"named \"mail-transport-agent\"."
1239
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
1240
#: apt-cache.8.xml:108
1242
"<literal>Single virtual packages</literal> is the number of packages with "
1243
"only one package providing a particular virtual package. For example, in the "
1244
"Debian system, \"X11-text-viewer\" is a virtual package, but only one "
1245
"package, xless, provides \"X11-text-viewer\"."
1248
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
1249
#: apt-cache.8.xml:114
1251
"<literal>Mixed virtual packages</literal> is the number of packages that "
1252
"either provide a particular virtual package or have the virtual package name "
1253
"as the package name. For instance, in the Debian system, \"debconf\" is both "
1254
"an actual package, and provided by the debconf-tiny package."
1257
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
1258
#: apt-cache.8.xml:121
1260
"<literal>Missing</literal> is the number of package names that were "
1261
"referenced in a dependency but were not provided by any package. Missing "
1262
"packages may be an evidence if a full distribution is not accessed, or if a "
1263
"package (real or virtual) has been dropped from the distribution. Usually "
1264
"they are referenced from Conflicts or Breaks statements."
1267
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
1268
#: apt-cache.8.xml:128
1270
"<literal>Total distinct</literal> versions is the number of package versions "
1271
"found in the cache; this value is therefore at least equal to the number of "
1272
"total package names. If more than one distribution is being accessed (for "
1273
"instance, \"stable\" and \"unstable\"), this value can be considerably "
1274
"larger than the number of total package names."
1277
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
1278
#: apt-cache.8.xml:135
1280
"<literal>Total dependencies</literal> is the number of dependency "
1281
"relationships claimed by all of the packages in the cache."
1284
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1285
#: apt-cache.8.xml:143
1287
"<literal>showsrc</literal> displays all the source package records that "
1288
"match the given package names. All versions are shown, as well as all "
1289
"records that declare the name to be a binary package."
1292
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1293
#: apt-cache.8.xml:149
1295
"<literal>dump</literal> shows a short listing of every package in the "
1296
"cache. It is primarily for debugging."
1299
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1300
#: apt-cache.8.xml:154
1302
"<literal>dumpavail</literal> prints out an available list to stdout. This is "
1303
"suitable for use with &dpkg; and is used by the &dselect; method."
1306
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1307
#: apt-cache.8.xml:159
1309
"<literal>unmet</literal> displays a summary of all unmet dependencies in the "
1313
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1314
#: apt-cache.8.xml:164
1316
"<literal>show</literal> performs a function similar to <command>dpkg "
1317
"--print-avail</command>; it displays the package records for the named "
1321
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term><option><replaceable>
1322
#: apt-cache.8.xml:169
1323
msgid "&synopsis-regex;"
1326
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1327
#: apt-cache.8.xml:170
1329
"<literal>search</literal> performs a full text search on all available "
1330
"package lists for the POSIX regex pattern given, see ®ex;. It searches "
1331
"the package names and the descriptions for an occurrence of the regular "
1332
"expression and prints out the package name and the short description, "
1333
"including virtual package names. If <option>--full</option> is given then "
1334
"output identical to <literal>show</literal> is produced for each matched "
1335
"package, and if <option>--names-only</option> is given then the long "
1336
"description is not searched, only the package name is."
1339
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1340
#: apt-cache.8.xml:181
1342
"Separate arguments can be used to specify multiple search patterns that are "
1346
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1347
#: apt-cache.8.xml:186
1349
"<literal>depends</literal> shows a listing of each dependency a package has "
1350
"and all the possible other packages that can fulfill that dependency."
1353
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1354
#: apt-cache.8.xml:191
1356
"<literal>rdepends</literal> shows a listing of each reverse dependency a "
1360
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1361
#: apt-cache.8.xml:195
1362
msgid "<optional><replaceable>&synopsis-prefix;</replaceable></optional>"
1365
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1366
#: apt-cache.8.xml:196
1368
"This command prints the name of each package APT knows. The optional "
1369
"argument is a prefix match to filter the name list. The output is suitable "
1370
"for use in a shell tab complete function and the output is generated "
1371
"extremely quickly. This command is best used with the "
1372
"<option>--generate</option> option."
1375
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1376
#: apt-cache.8.xml:201
1378
"Note that a package which APT knows of is not necessarily available to "
1379
"download, installable or installed, e.g. virtual packages are also listed in "
1380
"the generated list."
1383
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1384
#: apt-cache.8.xml:207
1386
"<literal>dotty</literal> takes a list of packages on the command line and "
1387
"generates output suitable for use by dotty from the <ulink "
1388
"url=\"http://www.research.att.com/sw/tools/graphviz/\">GraphViz</ulink> "
1389
"package. The result will be a set of nodes and edges representing the "
1390
"relationships between the packages. By default the given packages will trace "
1391
"out all dependent packages; this can produce a very large graph. To limit "
1392
"the output to only the packages listed on the command line, set the "
1393
"<literal>APT::Cache::GivenOnly</literal> option."
1396
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1397
#: apt-cache.8.xml:216
1399
"The resulting nodes will have several shapes; normal packages are boxes, "
1400
"pure virtual packages are triangles, mixed virtual packages are diamonds, "
1401
"missing packages are hexagons. Orange boxes mean recursion was stopped (leaf "
1402
"packages), blue lines are pre-depends, green lines are conflicts."
1405
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1406
#: apt-cache.8.xml:221
1407
msgid "Caution, dotty cannot graph larger sets of packages."
1410
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1411
#: apt-cache.8.xml:225
1413
"The same as <literal>dotty</literal>, only for xvcg from the <ulink "
1414
"url=\"http://rw4.cs.uni-sb.de/users/sander/html/gsvcg1.html\">VCG "
1418
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
1419
#: apt-cache.8.xml:229
1420
msgid "<optional><replaceable>&synopsis-pkg;</replaceable>…</optional>"
1423
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1424
#: apt-cache.8.xml:230
1426
"<literal>policy</literal> is meant to help debug issues relating to the "
1427
"preferences file. With no arguments it will print out the priorities of each "
1428
"source. Otherwise it prints out detailed information about the priority "
1429
"selection of the named package."
1432
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1433
#: apt-cache.8.xml:237
1435
"<literal>apt-cache</literal>'s <literal>madison</literal> command attempts "
1436
"to mimic the output format and a subset of the functionality of the Debian "
1437
"archive management tool, <literal>madison</literal>. It displays available "
1438
"versions of a package in a tabular format. Unlike the original "
1439
"<literal>madison</literal>, it can only display information for the "
1440
"architecture for which APT has retrieved package lists "
1441
"(<literal>APT::Architecture</literal>)."
1444
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1445
#: apt-cache.8.xml:253
1447
"Select the file to store the package cache. The package cache is the primary "
1448
"cache used by all operations. Configuration Item: "
1449
"<literal>Dir::Cache::pkgcache</literal>."
1452
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1453
#: apt-cache.8.xml:259
1455
"Select the file to store the source cache. The source is used only by "
1456
"<literal>gencaches</literal> and it stores a parsed version of the package "
1457
"information from remote sources. When building the package cache the source "
1458
"cache is used to avoid reparsing all of the package files. Configuration "
1459
"Item: <literal>Dir::Cache::srcpkgcache</literal>."
1462
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1463
#: apt-cache.8.xml:267
1465
"Quiet; produces output suitable for logging, omitting progress indicators. "
1466
"More q's will produce more quietness up to a maximum of 2. You can also use "
1467
"<option>-q=#</option> to set the quietness level, overriding the "
1468
"configuration file. Configuration Item: <literal>quiet</literal>."
1471
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1472
#: apt-cache.8.xml:274
1474
"Print only important dependencies; for use with <literal>unmet</literal> and "
1475
"<literal>depends</literal>. Causes only Depends and Pre-Depends relations to "
1476
"be printed. Configuration Item: <literal>APT::Cache::Important</literal>."
1479
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1480
#: apt-cache.8.xml:288
1482
"Per default the <literal>depends</literal> and <literal>rdepends</literal> "
1483
"print all dependencies. This can be tweaked with these flags which will omit "
1484
"the specified dependency type. Configuration Item: "
1485
"<literal>APT::Cache::Show<replaceable>DependencyType</replaceable></literal> "
1486
"e.g. <literal>APT::Cache::ShowRecommends</literal>."
1489
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1490
#: apt-cache.8.xml:295
1492
"Print full package records when searching. Configuration Item: "
1493
"<literal>APT::Cache::ShowFull</literal>."
1496
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1497
#: apt-cache.8.xml:300
1499
"Print full records for all available versions. This is the default; to turn "
1500
"it off, use <option>--no-all-versions</option>. If "
1501
"<option>--no-all-versions</option> is specified, only the candidate version "
1502
"will be displayed (the one which would be selected for installation). This "
1503
"option is only applicable to the <literal>show</literal> command. "
1504
"Configuration Item: <literal>APT::Cache::AllVersions</literal>."
1507
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1508
#: apt-cache.8.xml:309
1510
"Perform automatic package cache regeneration, rather than use the cache as "
1511
"it is. This is the default; to turn it off, use "
1512
"<option>--no-generate</option>. Configuration Item: "
1513
"<literal>APT::Cache::Generate</literal>."
1516
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1517
#: apt-cache.8.xml:315
1519
"Only search on the package names, not the long descriptions. Configuration "
1520
"Item: <literal>APT::Cache::NamesOnly</literal>."
1523
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1524
#: apt-cache.8.xml:320
1526
"Make <literal>pkgnames</literal> print all names, including virtual packages "
1527
"and missing dependencies. Configuration Item: "
1528
"<literal>APT::Cache::AllNames</literal>."
1531
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1532
#: apt-cache.8.xml:326
1534
"Make <literal>depends</literal> and <literal>rdepends</literal> recursive so "
1535
"that all packages mentioned are printed once. Configuration Item: "
1536
"<literal>APT::Cache::RecurseDepends</literal>."
1539
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
1540
#: apt-cache.8.xml:333
1542
"Limit the output of <literal>depends</literal> and "
1543
"<literal>rdepends</literal> to packages which are currently installed. "
1544
"Configuration Item: <literal>APT::Cache::Installed</literal>."
1547
#. type: Content of: <refentry><refsect1><para>
1548
#: apt-cache.8.xml:351
1549
msgid "&apt-conf;, &sources-list;, &apt-get;"
1552
#. type: Content of: <refentry><refsect1><para>
1553
#: apt-cache.8.xml:356
1555
"<command>apt-cache</command> returns zero on normal operation, decimal 100 "
1559
#. type: Content of: <refentry><refnamediv><refpurpose>
3548
1561
msgid "APT key management utility"
3551
#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
3554
"<command>apt-key</command> <arg><option>--keyring "
3555
"<replaceable>filename</replaceable></option></arg> "
3556
"<arg><replaceable>command</replaceable></arg> <arg "
3557
"rep=\"repeat\"><option><replaceable>arguments</replaceable></option></arg>"
3560
1564
#. type: Content of: <refentry><refsect1><para>
3563
1567
"<command>apt-key</command> is used to manage the list of keys used by apt to "
3564
1568
"authenticate packages. Packages which have been authenticated using these "
7269
4928
#. type: Content of: <refentry><refsect1><para>
7270
#: sources.list.5.xml:256
4929
#: sources.list.5.xml:253
7271
4930
msgid "&apt-cache; &apt-conf;"
4933
#. type: Content of: <refentry><refmeta><manvolnum>
4934
#: apt-extracttemplates.1.xml:26 apt-sortpkgs.1.xml:26 apt-ftparchive.1.xml:26
4938
#. type: Content of: <refentry><refnamediv><refpurpose>
4939
#: apt-extracttemplates.1.xml:33
4941
"Utility to extract <command>debconf</command> config and templates from "
4945
#. type: Content of: <refentry><refsect1><para>
4946
#: apt-extracttemplates.1.xml:39
4948
"<command>apt-extracttemplates</command> will take one or more Debian package "
4949
"files as input and write out (to a temporary directory) all associated "
4950
"config scripts and template files. For each passed in package that contains "
4951
"config scripts and templates, one line of output will be generated in the "
4955
#. type: Content of: <refentry><refsect1><para>
4956
#: apt-extracttemplates.1.xml:44
4957
msgid "package version template-file config-script"
4960
#. type: Content of: <refentry><refsect1><para>
4961
#: apt-extracttemplates.1.xml:45
4963
"template-file and config-script are written to the temporary directory "
4964
"specified by the <option>-t</option> or <option>--tempdir</option> "
4965
"(<literal>APT::ExtractTemplates::TempDir</literal>) directory, with "
4966
"filenames of the form <filename>package.template.XXXX</filename> and "
4967
"<filename>package.config.XXXX</filename>"
4970
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
4971
#: apt-extracttemplates.1.xml:58
4973
"Temporary directory in which to write extracted <command>debconf</command> "
4974
"template files and config scripts. Configuration Item: "
4975
"<literal>APT::ExtractTemplates::TempDir</literal>"
4978
#. type: Content of: <refentry><refsect1><para>
4979
#: apt-extracttemplates.1.xml:75
4981
"<command>apt-extracttemplates</command> returns zero on normal operation, "
4982
"decimal 100 on error."
4985
#. type: Content of: <refentry><refnamediv><refpurpose>
4986
#: apt-sortpkgs.1.xml:33
4987
msgid "Utility to sort package index files"
4990
#. type: Content of: <refentry><refsect1><para>
4991
#: apt-sortpkgs.1.xml:39
4993
"<command>apt-sortpkgs</command> will take an index file (source index or "
4994
"package index) and sort the records so that they are ordered by the package "
4995
"name. It will also sort the internal fields of each record according to the "
4996
"internal sorting rules."
4999
#. type: Content of: <refentry><refsect1><para>
5000
#: apt-sortpkgs.1.xml:45
5001
msgid "All output is sent to standard output; the input must be a seekable file."
5004
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5005
#: apt-sortpkgs.1.xml:54
5007
"Use source index field ordering. Configuration Item: "
5008
"<literal>APT::SortPkgs::Source</literal>."
5011
#. type: Content of: <refentry><refsect1><para>
5012
#: apt-sortpkgs.1.xml:68
5014
"<command>apt-sortpkgs</command> returns zero on normal operation, decimal "
5018
#. type: Content of: <refentry><refnamediv><refpurpose>
5019
#: apt-ftparchive.1.xml:33
5020
msgid "Utility to generate index files"
5023
#. type: Content of: <refentry><refsect1><para>
5024
#: apt-ftparchive.1.xml:39
5026
"<command>apt-ftparchive</command> is the command line tool that generates "
5027
"the index files that APT uses to access a distribution source. The index "
5028
"files should be generated on the origin site based on the content of that "
5032
#. type: Content of: <refentry><refsect1><para>
5033
#: apt-ftparchive.1.xml:43
5035
"<command>apt-ftparchive</command> is a superset of the &dpkg-scanpackages; "
5036
"program, incorporating its entire functionality via the "
5037
"<literal>packages</literal> command. It also contains a contents file "
5038
"generator, <literal>contents</literal>, and an elaborate means to 'script' "
5039
"the generation process for a complete archive."
5042
#. type: Content of: <refentry><refsect1><para>
5043
#: apt-ftparchive.1.xml:49
5045
"Internally <command>apt-ftparchive</command> can make use of binary "
5046
"databases to cache the contents of a .deb file and it does not rely on any "
5047
"external programs aside from &gzip;. When doing a full generate it "
5048
"automatically performs file-change checks and builds the desired compressed "
5052
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5053
#: apt-ftparchive.1.xml:60
5055
"The packages command generates a package file from a directory tree. It "
5056
"takes the given directory and recursively searches it for .deb files, "
5057
"emitting a package record to stdout for each. This command is approximately "
5058
"equivalent to &dpkg-scanpackages;."
5061
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5062
#: apt-ftparchive.1.xml:65 apt-ftparchive.1.xml:89
5063
msgid "The option <option>--db</option> can be used to specify a binary caching DB."
5066
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5067
#: apt-ftparchive.1.xml:70
5069
"The <literal>sources</literal> command generates a source index file from a "
5070
"directory tree. It takes the given directory and recursively searches it "
5071
"for .dsc files, emitting a source record to stdout for each. This command is "
5072
"approximately equivalent to &dpkg-scansources;."
5075
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5076
#: apt-ftparchive.1.xml:75
5078
"If an override file is specified then a source override file will be looked "
5079
"for with an extension of .src. The --source-override option can be used to "
5080
"change the source override file that will be used."
5083
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5084
#: apt-ftparchive.1.xml:82
5086
"The <literal>contents</literal> command generates a contents file from a "
5087
"directory tree. It takes the given directory and recursively searches it for "
5088
".deb files, and reads the file list from each file. It then sorts and writes "
5089
"to stdout the list of files matched to packages. Directories are not written "
5090
"to the output. If multiple packages own the same file then each package is "
5091
"separated by a comma in the output."
5094
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5095
#: apt-ftparchive.1.xml:94
5097
"The <literal>release</literal> command generates a Release file from a "
5098
"directory tree. It recursively searches the given directory for uncompressed "
5099
"<filename>Packages</filename> and <filename>Sources</filename> files and "
5100
"ones compressed with <command>gzip</command>, <command>bzip2</command> or "
5101
"<command>lzma</command> as well as <filename>Release</filename> and "
5102
"<filename>md5sum.txt</filename> files by default "
5103
"(<literal>APT::FTPArchive::Release::Default-Patterns</literal>). Additional "
5104
"filename patterns can be added by listing them in "
5105
"<literal>APT::FTPArchive::Release::Patterns</literal>. It then writes to "
5106
"stdout a <filename>Release</filename> file containing an MD5, SHA1 and "
5107
"SHA256 digest for each file."
5110
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5111
#: apt-ftparchive.1.xml:104
5113
"Values for the additional metadata fields in the Release file are taken from "
5114
"the corresponding variables under "
5115
"<literal>APT::FTPArchive::Release</literal>, "
5116
"e.g. <literal>APT::FTPArchive::Release::Origin</literal>. The supported "
5117
"fields are: <literal>Origin</literal>, <literal>Label</literal>, "
5118
"<literal>Suite</literal>, <literal>Version</literal>, "
5119
"<literal>Codename</literal>, <literal>Date</literal>, "
5120
"<literal>Valid-Until</literal>, <literal>Architectures</literal>, "
5121
"<literal>Components</literal>, <literal>Description</literal>."
5124
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5125
#: apt-ftparchive.1.xml:117
5127
"The <literal>generate</literal> command is designed to be runnable from a "
5128
"cron script and builds indexes according to the given config file. The "
5129
"config language provides a flexible means of specifying which index files "
5130
"are built from which directories, as well as providing a simple means of "
5131
"maintaining the required settings."
5134
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5135
#: apt-ftparchive.1.xml:126
5137
"The <literal>clean</literal> command tidies the databases used by the given "
5138
"configuration file by removing any records that are no longer necessary."
5141
#. type: Content of: <refentry><refsect1><title>
5142
#: apt-ftparchive.1.xml:132
5143
msgid "The Generate Configuration"
5146
#. type: Content of: <refentry><refsect1><para>
5147
#: apt-ftparchive.1.xml:134
5149
"The <literal>generate</literal> command uses a configuration file to "
5150
"describe the archives that are going to be generated. It follows the typical "
5151
"ISC configuration format as seen in ISC tools like bind 8 and dhcpd. "
5152
"&apt-conf; contains a description of the syntax. Note that the generate "
5153
"configuration is parsed in sectional manner, but &apt-conf; is parsed in a "
5154
"tree manner. This only effects how the scope tag is handled."
5157
#. type: Content of: <refentry><refsect1><para>
5158
#: apt-ftparchive.1.xml:142
5159
msgid "The generate configuration has four separate sections, each described below."
5162
#. type: Content of: <refentry><refsect1><refsect2><title>
5163
#: apt-ftparchive.1.xml:144
5164
msgid "<literal>Dir</literal> Section"
5167
#. type: Content of: <refentry><refsect1><refsect2><para>
5168
#: apt-ftparchive.1.xml:146
5170
"The <literal>Dir</literal> section defines the standard directories needed "
5171
"to locate the files required during the generation process. These "
5172
"directories are prepended certain relative paths defined in later sections "
5173
"to produce a complete an absolute path."
5176
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5177
#: apt-ftparchive.1.xml:153
5179
"Specifies the root of the FTP archive, in a standard Debian configuration "
5180
"this is the directory that contains the <filename>ls-LR</filename> and dist "
5184
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5185
#: apt-ftparchive.1.xml:160
5186
msgid "Specifies the location of the override files."
5189
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5190
#: apt-ftparchive.1.xml:165
5191
msgid "Specifies the location of the cache files."
5194
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5195
#: apt-ftparchive.1.xml:170
5197
"Specifies the location of the file list files, if the "
5198
"<literal>FileList</literal> setting is used below."
5201
#. type: Content of: <refentry><refsect1><refsect2><title>
5202
#: apt-ftparchive.1.xml:176
5203
msgid "<literal>Default</literal> Section"
5206
#. type: Content of: <refentry><refsect1><refsect2><para>
5207
#: apt-ftparchive.1.xml:178
5209
"The <literal>Default</literal> section specifies default values, and "
5210
"settings that control the operation of the generator. Other sections may "
5211
"override these defaults with a per-section setting."
5214
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5215
#: apt-ftparchive.1.xml:184
5217
"Sets the default compression schemes to use for the package index files. It "
5218
"is a string that contains a space separated list of at least one of: '.' (no "
5219
"compression), 'gzip' and 'bzip2'. The default for all compression schemes is "
5223
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5224
#: apt-ftparchive.1.xml:192
5226
"Sets the default list of file extensions that are package files. This "
5227
"defaults to '.deb'."
5230
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5231
#: apt-ftparchive.1.xml:198
5233
"This is similar to <literal>Packages::Compress</literal> except that it "
5234
"controls the compression for the Sources files."
5237
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5238
#: apt-ftparchive.1.xml:204
5240
"Sets the default list of file extensions that are source files. This "
5241
"defaults to '.dsc'."
5244
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5245
#: apt-ftparchive.1.xml:210
5247
"This is similar to <literal>Packages::Compress</literal> except that it "
5248
"controls the compression for the Contents files."
5251
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5252
#: apt-ftparchive.1.xml:216
5254
"This is similar to <literal>Packages::Compress</literal> except that it "
5255
"controls the compression for the Translation-en master file."
5258
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5259
#: apt-ftparchive.1.xml:222
5261
"Specifies the number of kilobytes to delink (and replace with hard links) "
5262
"per run. This is used in conjunction with the per-section "
5263
"<literal>External-Links</literal> setting."
5266
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5267
#: apt-ftparchive.1.xml:229
5269
"Specifies the mode of all created index files. It defaults to 0644. All "
5270
"index files are set to this mode with no regard to the umask."
5273
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5274
#: apt-ftparchive.1.xml:236 apt-ftparchive.1.xml:382
5276
"Specifies whether long descriptions should be included in the "
5277
"<filename>Packages</filename> file or split out into a master "
5278
"<filename>Translation-en</filename> file."
5281
#. type: Content of: <refentry><refsect1><refsect2><title>
5282
#: apt-ftparchive.1.xml:242
5283
msgid "<literal>TreeDefault</literal> Section"
5286
#. type: Content of: <refentry><refsect1><refsect2><para>
5287
#: apt-ftparchive.1.xml:244
5289
"Sets defaults specific to <literal>Tree</literal> sections. All of these "
5290
"variables are substitution variables and have the strings $(DIST), "
5291
"$(SECTION) and $(ARCH) replaced with their respective values."
5294
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5295
#: apt-ftparchive.1.xml:251
5297
"Sets the number of kilobytes of contents files that are generated each "
5298
"day. The contents files are round-robined so that over several days they "
5299
"will all be rebuilt."
5302
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5303
#: apt-ftparchive.1.xml:258
5305
"Controls the number of days a contents file is allowed to be checked without "
5306
"changing. If this limit is passed the mtime of the contents file is "
5307
"updated. This case can occur if the package file is changed in such a way "
5308
"that does not result in a new contents file [override edit for instance]. A "
5309
"hold off is allowed in hopes that new .debs will be installed, requiring a "
5310
"new file anyhow. The default is 10, the units are in days."
5313
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5314
#: apt-ftparchive.1.xml:269
5316
"Sets the top of the .deb directory tree. Defaults to "
5317
"<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/</filename>"
5320
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5321
#: apt-ftparchive.1.xml:275
5323
"Sets the top of the source package directory tree. Defaults to "
5324
"<filename>$(DIST)/$(SECTION)/source/</filename>"
5327
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5328
#: apt-ftparchive.1.xml:281
5330
"Sets the output Packages file. Defaults to "
5331
"<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/Packages</filename>"
5334
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5335
#: apt-ftparchive.1.xml:287
5337
"Sets the output Sources file. Defaults to "
5338
"<filename>$(DIST)/$(SECTION)/source/Sources</filename>"
5341
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5342
#: apt-ftparchive.1.xml:293
5344
"Sets the output Translation-en master file with the long descriptions if "
5345
"they should be not included in the Packages file. Defaults to "
5346
"<filename>$(DIST)/$(SECTION)/i18n/Translation-en</filename>"
5349
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5350
#: apt-ftparchive.1.xml:300
5352
"Sets the path prefix that causes a symlink to be considered an internal link "
5353
"instead of an external link. Defaults to "
5354
"<filename>$(DIST)/$(SECTION)/</filename>"
5357
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5358
#: apt-ftparchive.1.xml:307
5360
"Sets the output Contents file. Defaults to "
5361
"<filename>$(DIST)/$(SECTION)/Contents-$(ARCH)</filename>. If this setting "
5362
"causes multiple Packages files to map onto a single Contents file (as is the "
5363
"default) then <command>apt-ftparchive</command> will integrate those "
5364
"package files together automatically."
5367
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5368
#: apt-ftparchive.1.xml:316
5369
msgid "Sets header file to prepend to the contents output."
5372
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5373
#: apt-ftparchive.1.xml:321
5375
"Sets the binary cache database to use for this section. Multiple sections "
5376
"can share the same database."
5379
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5380
#: apt-ftparchive.1.xml:327
5382
"Specifies that instead of walking the directory tree, "
5383
"<command>apt-ftparchive</command> should read the list of files from the "
5384
"given file. Relative files names are prefixed with the archive directory."
5387
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5388
#: apt-ftparchive.1.xml:334
5390
"Specifies that instead of walking the directory tree, "
5391
"<command>apt-ftparchive</command> should read the list of files from the "
5392
"given file. Relative files names are prefixed with the archive directory. "
5393
"This is used when processing source indexes."
5396
#. type: Content of: <refentry><refsect1><refsect2><title>
5397
#: apt-ftparchive.1.xml:342
5398
msgid "<literal>Tree</literal> Section"
5401
#. type: Content of: <refentry><refsect1><refsect2><para>
5402
#: apt-ftparchive.1.xml:344
5404
"The <literal>Tree</literal> section defines a standard Debian file tree "
5405
"which consists of a base directory, then multiple sections in that base "
5406
"directory and finally multiple Architectures in each section. The exact "
5407
"pathing used is defined by the <literal>Directory</literal> substitution "
5411
#. type: Content of: <refentry><refsect1><refsect2><para>
5412
#: apt-ftparchive.1.xml:349
5414
"The <literal>Tree</literal> section takes a scope tag which sets the "
5415
"<literal>$(DIST)</literal> variable and defines the root of the tree (the "
5416
"path is prefixed by <literal>ArchiveDir</literal>). Typically this is a "
5417
"setting such as <filename>dists/&stable-codename;</filename>."
5420
#. type: Content of: <refentry><refsect1><refsect2><para>
5421
#: apt-ftparchive.1.xml:354
5423
"All of the settings defined in the <literal>TreeDefault</literal> section "
5424
"can be used in a <literal>Tree</literal> section as well as three new "
5428
#. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
5429
#: apt-ftparchive.1.xml:360
5432
"for i in Sections do \n"
5433
" for j in Architectures do\n"
5434
" Generate for DIST=scope SECTION=i ARCH=j\n"
5438
#. type: Content of: <refentry><refsect1><refsect2><para>
5439
#: apt-ftparchive.1.xml:357
5441
"When processing a <literal>Tree</literal> section "
5442
"<command>apt-ftparchive</command> performs an operation similar to: "
5443
"<placeholder type=\"programlisting\" id=\"0\"/>"
5446
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5447
#: apt-ftparchive.1.xml:368
5449
"This is a space separated list of sections which appear under the "
5450
"distribution; typically this is something like <literal>main contrib "
5451
"non-free</literal>"
5454
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5455
#: apt-ftparchive.1.xml:375
5457
"This is a space separated list of all the architectures that appear under "
5458
"search section. The special architecture 'source' is used to indicate that "
5459
"this tree has a source archive."
5462
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5463
#: apt-ftparchive.1.xml:388
5465
"Sets the binary override file. The override file contains section, priority "
5466
"and maintainer address information."
5469
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5470
#: apt-ftparchive.1.xml:394
5472
"Sets the source override file. The override file contains section "
5476
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5477
#: apt-ftparchive.1.xml:400 apt-ftparchive.1.xml:446
5478
msgid "Sets the binary extra override file."
5481
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5482
#: apt-ftparchive.1.xml:405 apt-ftparchive.1.xml:451
5483
msgid "Sets the source extra override file."
5486
#. type: Content of: <refentry><refsect1><refsect2><title>
5487
#: apt-ftparchive.1.xml:410
5488
msgid "<literal>BinDirectory</literal> Section"
5491
#. type: Content of: <refentry><refsect1><refsect2><para>
5492
#: apt-ftparchive.1.xml:412
5494
"The <literal>bindirectory</literal> section defines a binary directory tree "
5495
"with no special structure. The scope tag specifies the location of the "
5496
"binary directory and the settings are similar to the <literal>Tree</literal> "
5497
"section with no substitution variables or "
5498
"<literal>Section</literal><literal>Architecture</literal> settings."
5501
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5502
#: apt-ftparchive.1.xml:420
5503
msgid "Sets the Packages file output."
5506
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5507
#: apt-ftparchive.1.xml:425
5509
"Sets the Sources file output. At least one of <literal>Packages</literal> or "
5510
"<literal>Sources</literal> is required."
5513
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5514
#: apt-ftparchive.1.xml:431
5515
msgid "Sets the Contents file output (optional)."
5518
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5519
#: apt-ftparchive.1.xml:436
5520
msgid "Sets the binary override file."
5523
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5524
#: apt-ftparchive.1.xml:441
5525
msgid "Sets the source override file."
5528
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5529
#: apt-ftparchive.1.xml:456
5530
msgid "Sets the cache DB."
5533
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5534
#: apt-ftparchive.1.xml:461
5535
msgid "Appends a path to all the output paths."
5538
#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
5539
#: apt-ftparchive.1.xml:466
5540
msgid "Specifies the file list file."
5543
#. type: Content of: <refentry><refsect1><title>
5544
#: apt-ftparchive.1.xml:473
5545
msgid "The Binary Override File"
5548
#. type: Content of: <refentry><refsect1><para>
5549
#: apt-ftparchive.1.xml:474
5551
"The binary override file is fully compatible with &dpkg-scanpackages;. It "
5552
"contains four fields separated by spaces. The first field is the package "
5553
"name, the second is the priority to force that package to, the third is the "
5554
"section to force that package to and the final field is the maintainer "
5555
"permutation field."
5558
#. type: Content of: <refentry><refsect1><para><literallayout>
5559
#: apt-ftparchive.1.xml:480
5561
msgid "old [// oldn]* => new"
5564
#. type: Content of: <refentry><refsect1><para><literallayout>
5565
#: apt-ftparchive.1.xml:482
5570
#. type: Content of: <refentry><refsect1><para>
5571
#: apt-ftparchive.1.xml:479
5573
"The general form of the maintainer field is: <placeholder "
5574
"type=\"literallayout\" id=\"0\"/> or simply, <placeholder "
5575
"type=\"literallayout\" id=\"1\"/> The first form allows a double-slash "
5576
"separated list of old email addresses to be specified. If any of those are "
5577
"found then new is substituted for the maintainer field. The second form "
5578
"unconditionally substitutes the maintainer field."
5581
#. type: Content of: <refentry><refsect1><title>
5582
#: apt-ftparchive.1.xml:490
5583
msgid "The Source Override File"
5586
#. type: Content of: <refentry><refsect1><para>
5587
#: apt-ftparchive.1.xml:492
5589
"The source override file is fully compatible with &dpkg-scansources;. It "
5590
"contains two fields separated by spaces. The first field is the source "
5591
"package name, the second is the section to assign it."
5594
#. type: Content of: <refentry><refsect1><title>
5595
#: apt-ftparchive.1.xml:497
5596
msgid "The Extra Override File"
5599
#. type: Content of: <refentry><refsect1><para>
5600
#: apt-ftparchive.1.xml:499
5602
"The extra override file allows any arbitrary tag to be added or replaced in "
5603
"the output. It has three columns, the first is the package, the second is "
5604
"the tag and the remainder of the line is the new value."
5607
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5608
#: apt-ftparchive.1.xml:510
5610
"Generate the given checksum. These options default to on, when turned off "
5611
"the generated index files will not have the checksum fields where possible. "
5612
"Configuration Items: "
5613
"<literal>APT::FTPArchive::<replaceable>Checksum</replaceable></literal> and "
5614
"<literal>APT::FTPArchive::<replaceable>Index</replaceable>::<replaceable>Checksum</replaceable></literal> "
5615
"where <literal><replaceable>Index</replaceable></literal> can be "
5616
"<literal>Packages</literal>, <literal>Sources</literal> or "
5617
"<literal>Release</literal> and "
5618
"<literal><replaceable>Checksum</replaceable></literal> can be "
5619
"<literal>MD5</literal>, <literal>SHA1</literal> or "
5620
"<literal>SHA256</literal>."
5623
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5624
#: apt-ftparchive.1.xml:521
5626
"Use a binary caching DB. This has no effect on the generate command. "
5627
"Configuration Item: <literal>APT::FTPArchive::DB</literal>."
5630
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5631
#: apt-ftparchive.1.xml:527
5633
"Quiet; produces output suitable for logging, omitting progress indicators. "
5634
"More q's will produce more quiet up to a maximum of 2. You can also use "
5635
"<option>-q=#</option> to set the quiet level, overriding the configuration "
5636
"file. Configuration Item: <literal>quiet</literal>."
5639
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5640
#: apt-ftparchive.1.xml:535
5642
"Perform Delinking. If the <literal>External-Links</literal> setting is used "
5643
"then this option actually enables delinking of the files. It defaults to on "
5644
"and can be turned off with <option>--no-delink</option>. Configuration "
5645
"Item: <literal>APT::FTPArchive::DeLinkAct</literal>."
5648
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5649
#: apt-ftparchive.1.xml:543
5651
"Perform contents generation. When this option is set and package indexes are "
5652
"being generated with a cache DB then the file listing will also be extracted "
5653
"and stored in the DB for later use. When using the generate command this "
5654
"option also allows the creation of any Contents files. The default is on. "
5655
"Configuration Item: <literal>APT::FTPArchive::Contents</literal>."
5658
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5659
#: apt-ftparchive.1.xml:553
5661
"Select the source override file to use with the <literal>sources</literal> "
5662
"command. Configuration Item: "
5663
"<literal>APT::FTPArchive::SourceOverride</literal>."
5666
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5667
#: apt-ftparchive.1.xml:559
5669
"Make the caching databases read only. Configuration Item: "
5670
"<literal>APT::FTPArchive::ReadOnlyDB</literal>."
5673
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5674
#: apt-ftparchive.1.xml:564
5676
"Accept in the <literal>packages</literal> and <literal>contents</literal> "
5677
"commands only package files matching <literal>*_arch.deb</literal> or "
5678
"<literal>*_all.deb</literal> instead of all package files in the given "
5679
"path. Configuration Item: <literal>APT::FTPArchive::Architecture</literal>."
5682
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5683
#: apt-ftparchive.1.xml:572
5685
"&apt-ftparchive; caches as much as possible of metadata in a cachedb. If "
5686
"packages are recompiled and/or republished with the same version again, this "
5687
"will lead to problems as the now outdated cached metadata like size and "
5688
"checksums will be used. With this option enabled this will no longer happen "
5689
"as it will be checked if the file was changed. Note that this option is set "
5690
"to \"<literal>false</literal>\" by default as it is not recommend to upload "
5691
"multiply versions/builds of a package with the same versionnumber, so in "
5692
"theory nobody will have these problems and therefore all these extra checks "
5696
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
5697
#: apt-ftparchive.1.xml:584
5699
"This configuration option defaults to \"<literal>true</literal>\" and should "
5700
"only be set to <literal>\"false\"</literal> if the Archive generated with "
5701
"&apt-ftparchive; also provides <filename>Translation</filename> files. Note "
5702
"that the <filename>Translation-en</filename> master file can only be created "
5703
"in the generate command."
5706
#. type: Content of: <refentry><refsect1><para><programlisting>
5707
#: apt-ftparchive.1.xml:602
5710
"<command>apt-ftparchive</command> packages "
5711
"<replaceable>directory</replaceable> | <command>gzip</command> > "
5712
"<filename>Packages.gz</filename>\n"
5715
#. type: Content of: <refentry><refsect1><para>
5716
#: apt-ftparchive.1.xml:598
5718
"To create a compressed Packages file for a directory containing binary "
5719
"packages (.deb): <placeholder type=\"programlisting\" id=\"0\"/>"
5722
#. type: Content of: <refentry><refsect1><para>
5723
#: apt-ftparchive.1.xml:612
5725
"<command>apt-ftparchive</command> returns zero on normal operation, decimal "
5738
msgid "16 June 1998"
5755
msgid "apt - Advanced Package Tool"
5778
"APT is a management system for software packages. For normal day to day "
5779
"package management there are several frontends available, such as "
5780
"B<aptitude>(8) for the command line or B<synaptic>(8) for the X Window "
5781
"System. Some options are only implemented in B<apt-get>(8) though."
5793
"B<apt-cache>(8), B<apt-get>(8), B<apt.conf>(5), B<sources.list>(5), "
5794
"B<apt_preferences>(5), B<apt-secure>(8)"
5805
msgid "apt returns zero on normal operation, decimal 100 on error."
5816
msgid "This manpage isn't even started."
5822
"See E<lt>http://bugs.debian.org/aptE<gt>. If you wish to report a bug in "
5823
"B<apt>, please see I</usr/share/doc/debian/bug-reporting.txt> or the "
5824
"B<reportbug>(1) command."
5835
msgid "apt was written by the APT team E<lt>apt@packages.debian.orgE<gt>."
7274
5838
#. type: <title></title>
7275
5839
#: guide.sgml:4
7276
5840
msgid "APT User's Guide"