apt-doc 1.4 - en to ja translation catalogue (748 entries)

note: type: Plain text
en: <!ENTITY apt-author.team "
       <author>
        <othername>APT team</othername>
        <contrib></contrib>
       </author>
    ">
ja: <!ENTITY apt-author.team "
       <author>
        <othername>APT チーム</othername>
        <contrib></contrib>
       </author>
    ">

note: type: Plain text
en: <!ENTITY apt-qapage "
    	<para>
    		<ulink url='http://packages.qa.debian.org/a/apt.html'>QA Page</ulink>
    	</para>
    ">
ja: <!ENTITY apt-qapage "
    	<para>
    		<ulink url='http://packages.qa.debian.org/a/apt.html'>QA ページ</ulink>
    	</para>
    ">

note: type: Plain text
en: <!-- Boiler plate Bug reporting section -->
    <!ENTITY manbugs "
     <refsect1><title>Bugs</title>
       <para><ulink url='https://bugs.debian.org/src:apt'>APT bug page</ulink>.
       If you wish to report a bug in APT, please see
       <filename>/usr/share/doc/debian/bug-reporting.txt</filename> or the
       &reportbug; command.
       </para>
     </refsect1>
    ">
ja: <!-- Boiler plate Bug reporting section -->
    <!ENTITY manbugs "
     <refsect1><title>バグ</title>
       <para><ulink url='https://bugs.debian.org/src:apt'>APT バグページ</ulink> をご覧ください。 
       APT のバグを報告する場合は、
       <filename>/usr/share/doc/debian/bug-reporting.txt</filename> や
       &reportbug; コマンドをご覧ください。
       </para>
     </refsect1>
    ">

note: type: Plain text
en: <!-- Boiler plate Author section -->
    <!ENTITY manauthor "
     <refsect1><title>Author</title>
       <para>APT was written by the APT team <email>apt@packages.debian.org</email>.
       </para>
     </refsect1>
    ">
ja: <!-- Boiler plate Author section -->
    <!ENTITY manauthor "
     <refsect1><title>著者</title>
       <para>APT は APT チーム <email>apt@packages.debian.org</email> によって書かれました。
       </para>
     </refsect1>
    ">

note: type: Plain text
en: <!-- Should be used within the option section of the text to
         put in the blurb about -h, -v, -c and -o -->
    <!ENTITY apt-commonoptions "
         <varlistentry><term><option>-h</option></term>
         <term><option>--help</option></term>
         <listitem><para>Show a short usage summary.
         </para>
         </listitem>
         </varlistentry>
ja: <!-- Should be used within the option section of the text to
         put in the blurb about -h, -v, -c and -o -->
    <!ENTITY apt-commonoptions "
         <varlistentry><term><option>-h</option></term>
         <term><option>--help</option></term>
         <listitem><para>使い方の短い要約を表示します。
         </para>
         </listitem>
         </varlistentry>

note: type: Plain text
en:      <varlistentry>
          <term><option>-v</option></term>
          <term><option>--version</option></term>
          <listitem><para>Show the program version.
         </para>
         </listitem>
         </varlistentry>
ja:           <varlistentry>
          <term><option>-v</option></term>
          <term><option>--version</option></term>
          <listitem><para>プログラムのバージョンを表示します。
         </para>
         </listitem>
         </varlistentry>

note: type: Plain text
en:      <varlistentry>
          <term><option>-c</option></term>
          <term><option>--config-file</option></term>
         <listitem><para>Configuration File; Specify a configuration file to use. 
         The program will read the default configuration file and then this 
         configuration file. If configuration settings need to be set before the
         default configuration files are parsed specify a file with the <envar>APT_CONFIG</envar>
         environment variable. See &apt-conf; for syntax information.
         </para>
         </listitem>
         </varlistentry>
ja:      <varlistentry>
          <term><option>-c</option></term>
          <term><option>--config-file</option></term>
         <listitem><para>設定ファイル。 使用する設定ファイルを指定します。
         このプログラムは、デフォルト設定ファイルを読んでから、この設定ファイルを読みます。
         この設定をデフォルト設定ファイルよりも前に読む必要がある場合、
         <envar>APT_CONFIG</envar> 環境変数に指定してください。構文については &apt-conf; をご覧ください。
         </para>
         </listitem>
         </varlistentry>

note: type: Plain text
en: <!-- Should be used within the option section of the text to
         put in the blurb about -h, -v, -c and -o -->
    <!ENTITY apt-cmdblurb "
       <para>All command line options may be set using the configuration file, the
       descriptions indicate the configuration option to set. For boolean
       options you can override the config file by using something like 
       <option>-f-</option>,<option>--no-f</option>, <option>-f=no</option>
       or several other variations.
       </para>
    ">
ja: <!-- Should be used within the option section of the text to
         put in the blurb about -h, -v, -c and -o -->
    <!ENTITY apt-cmdblurb "
       <para>ここで設定オプションとして説明したコマンドラインオプションは、
       すべて設定ファイルを使用して設定できます。
       設定ファイルに書いた真偽値をとるオプションは
       <option>-f-</option>,<option>--no-f</option>, <option>-f=no</option>
       などのようにして上書きできます。
       </para>
    ">

note: type: Plain text
en: <!ENTITY file-aptconf "
         <varlistentry><term><filename>/etc/apt/apt.conf</filename></term>
         <listitem><para>APT configuration file.
         Configuration Item: <literal>Dir::Etc::Main</literal>.</para></listitem>
         </varlistentry>
ja: <!ENTITY file-aptconf "
         <varlistentry><term><filename>/etc/apt/apt.conf</filename></term>
         <listitem><para>APT 設定ファイル。
         設定項目: <literal>Dir::Etc::Main</literal></para></listitem>
         </varlistentry>

note: type: Plain text
en:      <varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term>
         <listitem><para>APT configuration file fragments.
         Configuration Item: <literal>Dir::Etc::Parts</literal>.</para></listitem>
         </varlistentry>
    ">
ja:      <varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term>
         <listitem><para>APT 設定ファイル断片。
         設定項目: <literal>Dir::Etc::Parts</literal></para></listitem>
         </varlistentry>
    ">

note: type: Plain text
en: <!ENTITY file-cachearchives "
         <varlistentry><term><filename>&cachedir;/archives/</filename></term>
         <listitem><para>Storage area for retrieved package files.
         Configuration Item: <literal>Dir::Cache::Archives</literal>.</para></listitem>
         </varlistentry>
ja: <!ENTITY file-cachearchives "
         <varlistentry><term><filename>&cachedir;/archives/</filename></term>
         <listitem><para>取得済みパッケージファイル格納エリア。
         設定項目: <literal>Dir::Cache::Archives</literal></para></listitem>
         </varlistentry>

note: type: Plain text
en:      <varlistentry><term><filename>&cachedir;/archives/partial/</filename></term>
         <listitem><para>Storage area for package files in transit.
         Configuration Item: <literal>Dir::Cache::Archives</literal> (<filename>partial</filename> will be implicitly appended)</para></listitem>
         </varlistentry>
    ">
ja:      <varlistentry><term><filename>&cachedir;/archives/partial/</filename></term>
         <listitem><para>取得中パッケージファイル格納エリア。
         設定項目: <literal>Dir::Cache::Archives</literal> (暗黙で <filename>partial</filename> を追加)</para></listitem>
         </varlistentry>
    ">

note: type: Plain text
en: <!ENTITY file-preferences "
         <varlistentry><term><filename>/etc/apt/preferences</filename></term>
         <listitem><para>Version preferences file.
         This is where you would specify &quot;pinning&quot;,
         i.e. a preference to get certain packages
         from a separate source
         or from a different version of a distribution.
         Configuration Item: <literal>Dir::Etc::Preferences</literal>.</para></listitem>
         </varlistentry>
ja: <!ENTITY file-preferences "
         <varlistentry><term><filename>/etc/apt/preferences</filename></term>
         <listitem><para>バージョンプリファレンスファイル。
         ここに &quot;pin&quot;の設定を行います。
         つまり、別々の取得元や異なるディストリビューションのバージョンの、
         どこからパッケージを取得するかを設定します。
         設定項目:  <literal>Dir::Etc::Preferences</literal></para></listitem>
         </varlistentry>

note: type: Plain text
en:      <varlistentry><term><filename>/etc/apt/preferences.d/</filename></term>
         <listitem><para>File fragments for the version preferences.
         Configuration Item: <literal>Dir::Etc::PreferencesParts</literal>.</para></listitem>
         </varlistentry>
    ">
ja:      <varlistentry><term><filename>/etc/apt/preferences.d/</filename></term>
         <listitem><para>バージョンプリファレンスファイル断片。
         設定項目: <literal>Dir::Etc::PreferencesParts</literal></para></listitem>
         </varlistentry>
    ">

note: type: Plain text
en: <!ENTITY file-sourceslist "
         <varlistentry><term><filename>/etc/apt/sources.list</filename></term>
         <listitem><para>Locations to fetch packages from.
         Configuration Item: <literal>Dir::Etc::SourceList</literal>.</para></listitem>
         </varlistentry>
ja: <!ENTITY file-sourceslist "
         <varlistentry><term><filename>/etc/apt/sources.list</filename></term>
         <listitem><para>パッケージ取得元の場所。
         設定項目: <literal>Dir::Etc::SourceList</literal></para></listitem>
         </varlistentry>

note: type: Plain text
en:      <varlistentry><term><filename>/etc/apt/sources.list.d/</filename></term>
         <listitem><para>File fragments for locations to fetch packages from.
         Configuration Item: <literal>Dir::Etc::SourceParts</literal>.</para></listitem>
         </varlistentry>
    ">
ja:      <varlistentry><term><filename>/etc/apt/sources.list.d/</filename></term>
         <listitem><para>パッケージ取得元の場所のファイル断片
         設定項目: <literal>Dir::Etc::SourceParts</literal></para></listitem>
         </varlistentry>
    ">

note: type: Plain text
en: <!ENTITY file-statelists "
         <varlistentry><term><filename>&statedir;/lists/</filename></term>
         <listitem><para>Storage area for state information for each package resource specified in
         &sources-list;
         Configuration Item: <literal>Dir::State::Lists</literal>.</para></listitem>
         </varlistentry>
ja: <!ENTITY file-statelists "
         <varlistentry><term><filename>&statedir;/lists/</filename></term>
         <listitem><para>&sources-list; に指定した、パッケージリソースごとの状態情報格納エリア。
         設定項目: <literal>Dir::State::Lists</literal></para></listitem>
         </varlistentry>

note: type: Plain text
en:      <varlistentry><term><filename>&statedir;/lists/partial/</filename></term>
         <listitem><para>Storage area for state information in transit.
         Configuration Item: <literal>Dir::State::Lists</literal> (<filename>partial</filename> will be implicitly appended)</para></listitem>
         </varlistentry>
    ">
ja:      <varlistentry><term><filename>&statedir;/lists/partial/</filename></term>
         <listitem><para>取得中状態情報格納エリア。
         設定項目: <literal>Dir::State::Lists</literal> (暗黙で <filename>partial</filename> を追加)</para></listitem>
         </varlistentry>
    ">

note: type: Plain text
en: <!ENTITY file-trustedgpg "
         <varlistentry><term><filename>/etc/apt/trusted.gpg</filename></term>
         <listitem><para>Keyring of local trusted keys, new keys will be added here.
         Configuration Item: <literal>Dir::Etc::Trusted</literal>.</para></listitem>
         </varlistentry>
ja: <!ENTITY file-trustedgpg "
         <varlistentry><term><filename>/etc/apt/trusted.gpg</filename></term>
         <listitem><para>ローカルで信頼済みキーのキーリング、新規キーはここに追加します。
         設定項目: <literal>Dir::Etc::Trusted</literal>.</para></listitem>
         </varlistentry>

note: type: Plain text
en: <!ENTITY file-extended_states "
          <varlistentry><term><filename>/var/lib/apt/extended_states</filename></term>
          <listitem><para>Status list of auto-installed packages.
          Configuration Item: <literal>Dir::State::extended_states</literal>.
          </para></listitem>
          </varlistentry>
    ">
ja: <!ENTITY file-extended_states "
          <varlistentry><term><filename>/var/lib/apt/extended_states</filename></term>
          <listitem><para>自動インストールされたパッケージの状態一覧です。
          設定項目: <literal>Dir::State::extended_states</literal>
          </para></listitem>
          </varlistentry>
    ">

note: type: Plain text
en: <!-- TRANSLATOR: This is the section header for the following paragraphs - comparable
         to the other headers like NAME and DESCRIPTION and should therefore be uppercase. -->
    <!ENTITY translation-title "TRANSLATION">
ja: <!-- TRANSLATOR: This is the section header for the following paragraphs - comparable
         to the other headers like NAME and DESCRIPTION and should therefore be uppercase. -->
    <!ENTITY translation-title "翻訳">

note: type: Plain text
en: <!-- TRANSLATOR: This is a placeholder. You should write here who has contributed
         to the translation in the past, who is responsible now and maybe further information
         specially related to your translation. -->
    <!ENTITY translation-holder "
         The english translation was done by John Doe <email>john@doe.org</email> in 2009,
         2010 and Daniela Acme <email>daniela@acme.us</email> in 2010 together with the
         Debian Dummy l10n Team <email>debian-l10n-dummy@lists.debian.org</email>.
    ">
ja: <!-- TRANSLATOR: This is a placeholder. You should write here who has contributed
         to the translation in the past, who is responsible now and maybe further information
         specially related to your translation. -->
    <!ENTITY translation-holder "
         倉澤 望 <email>nabetaro@debian.or.jp</email> (2003-2006,2009-2012),
         Takuma Yamada <email>tyamada@takumayamada.com</email> (2016),
         Debian JP Documentation ML <email>debian-doc@debian.or.jp</email>
    ">

note: type: Plain text
en: <!-- TRANSLATOR: As a translation is allowed to have 20% of untranslated/fuzzy strings
         in a shipped manpage newer/modified paragraphs will maybe appear in english in
         the generated manpage. This sentence is therefore here to tell the reader that this
         is not a mistake by the translator - obviously the target is that at least for stable
         releases this sentence is not needed. :) -->
    <!ENTITY translation-english "
         Note that this translated document may contain untranslated parts.
         This is done on purpose, to avoid losing content when the
         translation is lagging behind the original content.
    ">
ja: <!-- TRANSLATOR: As a translation is allowed to have 20% of untranslated/fuzzy strings
         in a shipped manpage newer/modified paragraphs will maybe appear in english in
         the generated manpage. This sentence is therefore here to tell the reader that this
         is not a mistake by the translator - obviously the target is that at least for stable
         releases this sentence is not needed. :) -->
    <!ENTITY translation-english "
         この翻訳文書には未訳部分が含まれている可能性があることに
         注意してください。
         翻訳がオリジナルに追従できていない場合、
         内容を失わないようにこのようにしています。
    ">

note: type: Plain text
en: <!-- TRANSLATOR: used as in -o=config_string e.g. -o=Debug::pkgProblemResolver=1 --> <!ENTITY synopsis-config-string "config_string">
ja: <!-- TRANSLATOR: used as in -o=config_string e.g. -o=Debug::pkgProblemResolver=1 --> <!ENTITY synopsis-config-string "設定文字列">

note: type: Plain text
en: <!-- TRANSLATOR: used as in -c=config_file e.g. -c=./apt.conf --> <!ENTITY synopsis-config-file "config_file">
ja: <!-- TRANSLATOR: used as in -c=config_file e.g. -c=./apt.conf --> <!ENTITY synopsis-config-file "設定ファイル">

note: type: Plain text
en: <!-- TRANSLATOR: used as in -t=target_release or pkg/target_release e.g. -t=squeeze apt/experimental --> <!ENTITY synopsis-target-release "target_release">
ja: <!-- TRANSLATOR: used as in -t=target_release or pkg/target_release e.g. -t=squeeze apt/experimental --> <!ENTITY synopsis-target-release "対象リリース">

note: type: Plain text
en: <!-- TRANSLATOR: used as in -a=architecture e.g. -a=armel --> <!ENTITY synopsis-architecture "architecture">
ja: <!-- TRANSLATOR: used as in -a=architecture e.g. -a=armel --> <!ENTITY synopsis-architecture "アーキテクチャ">

note: type: Plain text
en: <!-- TRANSLATOR: used as in apt-get install pkg e.g. apt-get install awesome --> <!ENTITY synopsis-pkg "pkg">
ja: <!-- TRANSLATOR: used as in apt-get install pkg e.g. apt-get install awesome --> <!ENTITY synopsis-pkg "パッケージ">

note: type: Plain text
en: <!-- TRANSLATOR: used as in pkg=pkg_version_number e.g. apt=0.8.15 --> <!ENTITY synopsis-pkg-ver-number "pkg_version_number">
ja: <!-- TRANSLATOR: used as in pkg=pkg_version_number e.g. apt=0.8.15 --> <!ENTITY synopsis-pkg-ver-number "パッケージバージョン番号">

note: type: Plain text
en: <!-- TRANSLATOR: used as in apt-cache search regex e.g. apt-cache search awesome --> <!ENTITY synopsis-regex "regex">
ja: <!-- TRANSLATOR: used as in apt-cache search regex e.g. apt-cache search awesome --> <!ENTITY synopsis-regex "正規表現">

note: type: Plain text
en: <!-- TRANSLATOR: used as in apt-cdrom -d=cdrom_mount_point e.g. apt-cdrom -d=/media/cdrom --> <!ENTITY synopsis-cdrom-mount "cdrom_mount_point">
ja: <!-- TRANSLATOR: used as in apt-cdrom -d=cdrom_mount_point e.g. apt-cdrom -d=/media/cdrom --> <!ENTITY synopsis-cdrom-mount "CDROMマウントポイント">

note: type: Plain text
en: <!-- TRANSLATOR: used as in apt-extracttemplates -t=temporary_directory e.g. apt-extracttemplates -t=/tmp --> <!ENTITY synopsis-tmp-directory "temporary_directory">
ja: <!-- TRANSLATOR: used as in apt-extracttemplates -t=temporary_directory e.g. apt-extracttemplates -t=/tmp --> <!ENTITY synopsis-tmp-directory "一時ディレクトリ">

note: type: Plain text
en: <!-- TRANSLATOR: used as in apt-extracttemplates filename --> <!ENTITY synopsis-filename "filename">
ja: <!-- TRANSLATOR: used as in apt-extracttemplates filename --> <!ENTITY synopsis-filename "ファイル名">

note: type: Plain text
en: <!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive packages path override-file pathprefix --> <!ENTITY synopsis-path "path">
ja: <!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive packages path override-file pathprefix --> <!ENTITY synopsis-path "パス">

note: type: Plain text
en: <!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive generate section --> <!ENTITY synopsis-section "section">
ja: <!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive generate section --> <!ENTITY synopsis-section "セクション">

note: type: Plain text
en: <!-- TRANSLATOR: used as in apt-key export keyid e.g. apt-key export 473041FA --> <!ENTITY synopsis-keyid "keyid">
ja: <!-- TRANSLATOR: used as in apt-key export keyid e.g. apt-key export 473041FA --> <!ENTITY synopsis-keyid "キーID">

note: type: Content of: <refentry><refnamediv><refpurpose>
en: command-line interface
ja: コマンドラインインターフェイス

note: type: Content of: <refentry><refsect1><title>
en: Description
ja: 説明

note: type: Content of: <refentry><refsect1><para>
en: <command>apt</command> provides a high-level commandline interface for the package management system. It is intended as an end user interface and enables some options better suited for interactive usage by default compared to more specialized APT tools like &apt-get; and &apt-cache;.
ja: <command>apt</command> は、パッケージ管理システム用の高レベルのコマンドラインインターフェースを提供します。エンドユーザインターフェースとして設計されています。また &apt-get; や &apt-cache; のような専用の APT ツールと比べて、デフォルトでインタラクティブな使用に適したいくつかのオプションが有効になっています。

note: type: Content of: <refentry><refsect1><para>
en: Much like <command>apt</command> itself, its manpage is intended as an end user interface and as such only mentions the most used commands and options partly to not duplicate information in multiple places and partly to avoid overwhelming readers with a cornucopia of options and details.
ja: <command>apt</command> 自身と同じように、man ページはエンドユーザインターフェースとして意図されています。さらに、一部のオプションや詳細の豊富さで読者を圧倒することを避けるため、複数の場所で部分的に情報を複製しないよう、最も使用されるコマンドとオプションを言及するように意図されています。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <option>update</option> is used to download package information from all configured sources. Other commands operate on this data to e.g. perform package upgrades or search in and display details about all packages available for installation.
ja: <option>update</option> は、設定されたすべての取得元からパッケージ情報をダウンロードするために使用されます。ほかのコマンドは、このデータを操作します。例えば、パッケージのアップグレードを実行したり、中を検索したり、インストール可能なすべてのパッケージに関する詳細情報を表示します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <option>upgrade</option> is used to install available upgrades of all packages currently installed on the system from the sources configured via &sources-list;. New packages will be installed if required to satisfy dependencies, but existing packages will never be removed. If an upgrade for a package requires the removal of an installed package the upgrade for this package isn't performed.
ja: <option>upgrade</option> は、&sources-list; で設定された取得元からシステムに現在インストール済みのすべてのパッケージで利用可能なアップグレードをインストールするために使用されます。依存関係を満たすために必要な場合は新しいパッケージがインストールされますが、既存のパッケージが削除されることはありません。パッケージのアップグレードにインストール済みパッケージの削除が必要な場合、そのパッケージのアップグレードは行われません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>full-upgrade</literal> performs the function of upgrade but will remove currently installed packages if this is needed to upgrade the system as a whole.
ja: <literal>full-upgrade</literal> はアップグレードの機能を実行しますが、システム全体をアップグレードするために必要とされる場合には、現在インストール済みのパッケージを削除することができます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Performs the requested action on one or more packages specified via &regex;, &glob; or exact match. The requested action can be overridden for specific packages by appending a plus (+) to the package name to install this package or a minus (-) to remove it.
ja: &regex;、&glob; または 完全な一致で指定された 1 つ以上のパッケージに対して要求された処理を実行します。要求された処理は、特定のパッケージに対してパッケージ名にプラス (+) を追加してパッケージのインストールを、マイナス (-) を追加してパッケージの削除を上書きすることができます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: A specific version of a package can be selected for installation by following the package name with an equals (=) and the version of the package to select. Alternatively the version from a specific release can be selected by following the package name with a forward slash (/) and codename (&debian-stable-codename;, &debian-testing-codename;, sid …) or suite name (stable, testing, unstable). This will also select versions from this release for dependencies of this package if needed to satisfy the request.
ja: パッケージ名にイコール (=) とパッケージのバージョンを続けることで、選択したバージョンのパッケージをインストールすることができます。代わりに、パッケージ名にスラッシュ (/) およびコード名 (&debian-stable-codename;、&debian-testing-codename;、sid …) またはスイート名 (stable、testing、unstable) を続けることで、特定のリリースのバージョンをインストールすることができます。また、必要な場合には、パッケージの依存関係を満たすリリースからバージョンを選択します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Removing a package removes all packaged data, but leaves usually small (modified) user configuration files behind, in case the remove was an accident. Just issuing an installation request for the accidentally removed package will restore its function as before in that case. On the other hand you can get rid of these leftovers by calling <command>purge</command> even on already removed packages. Note that this does not affect any data or configuration stored in your home directory.
ja: パッケージの削除はパッケージの全データを削除しますが、削除の事故に備えて、通常は隠れている小さな (修正された) ユーザ設定ファイルを残します。問題が発生したときは、誤って削除したパッケージのインストール要求を発行すると、以前のようにその機能を復元します。一方、<command>purge</command> を呼び出すことで、すでに削除したパッケージの残されたデータを削除することができます。これはあなたのホームディレクトリに保存しているデータや設定には影響を与えないことに注意してください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>autoremove</literal> is used to remove packages that were automatically installed to satisfy dependencies for other packages and are now no longer needed as dependencies changed or the package(s)  needing them were removed in the meantime.
ja: <literal>autoremove</literal> は、ほかのパッケージの依存関係を満たすために自動的にインストールされた後に、依存関係の変更あるいは必要としていたパッケージが削除されたことでもう必要なくなったパッケージの削除に使用することができます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: You should check that the list does not include applications you have grown to like even though they were once installed just as a dependency of another package. You can mark such a package as manually installed by using &apt-mark;. Packages which you have installed explicitly via <command>install</command> are also never proposed for automatic removal.
ja: 別のパッケージの依存関係のため一度インストールされたなどで増えたアプリケーションがリストに含まれていないことを確認する必要があります。&apt-mark; を使って、手動でパッケージをインストール済にマークすることができます。<command>install</command> 経由で明示的にインストールしたパッケージは、自動削除のために提案されることはありません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <option>search</option> can be used to search for the given &regex; term(s) in the list of available packages and display matches.  This can e.g. be useful if you are looking for packages having a specific feature.  If you are looking for a package including a specific file try &apt-file;.
ja: <option>search</option> は、利用可能なパッケージのリストを指定した &regex; 条件で検索してマッチした結果を表示するために使用することができます。これは、例えば特定の機能をもつパッケージを探している場合に有用です。特定のファイルを含むパッケージを探しているのなら、&apt-file; を試してください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Show information about the given package(s) including its dependencies, installation and download size, sources the package is available from, the description of the packages content and much more. It can e.g. be helpful to look at this information before allowing &apt; to remove a package or while searching for new packages to install.
ja: 指定されたパッケージに関する情報を表示します。依存関係、インストールおよびダウンロードサイズ、パッケージが入手可能な取得元、パッケージの内容の説明などを含みます。例えば &apt; にパッケージの削除をさせる前や、インストールする新しいパッケージを検索するときに、この情報を見て参考にすることができます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: (work-in-progress)
ja: (作業中)

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>edit-sources</literal> lets you edit your &sources-list; files in your preferred text editor while also providing basic sanity checks.
ja: <literal>edit-sources</literal> は、お好みのテキストエディタで &sources-list; ファイルを編集することができます。また、基本的な健全性チェックを提供します。

note: type: Content of: <refentry><refsect1><title>
en: Script Usage and Differences from Other APT Tools
ja: スクリプトの使い方およびほかの APT ツールとの違い

note: type: Content of: <refentry><refsect1><para>
en: The &apt; commandline is designed as an end-user tool and it may change behavior between versions. While it tries not to break backward compatibility this is not guaranteed either if a change seems beneficial for interactive use.
ja: &apt; コマンドラインはエンドユーザ向けツールとして設計されています。動作はバージョン間で変更される可能性があります。後方互換性を損なうことのないようには努めますが、変更がインタラクティブな使用に有益と思われる場合には、その保証はありません。

note: type: Content of: <refentry><refsect1><para>
en: All features of &apt; are available in dedicated APT tools like &apt-get; and &apt-cache; as well.  &apt; just changes the default value of some options (see &apt-conf; and specifically the Binary scope). So you should prefer using these commands (potentially with some additional options enabled) in your scripts as they keep backward compatibility as much as possible.
ja: &apt; のすべての機能は、&apt-get; や &apt-cache; など専用の APT ツールで利用可能です。&apt; は、単にいくつかのオプションのデフォルト値を変更します (&apt-conf; の特にバイナリ範囲を参照)。可能な限り下位互換性を保つように、スクリプトでは (潜在的に有効になっているいくつかの追加オプションをつけて) コマンドを使うべきです。

note: type: Content of: <refentry><refsect1><title>
en: See Also
ja: 関連項目

note: type: Content of: <refentry><refsect1><para>
en: &apt-get;, &apt-cache;, &sources-list;, &apt-conf;, &apt-config;, &apt-patterns;, The APT User's guide in &guidesdir;, &apt-preferences;, the APT Howto.
ja: &apt-get;、&apt-cache;、&sources-list;、&apt-conf;、&apt-config;、&apt-patterns;、&guidesdir; にある APT ユーザガイド、&apt-preferences;、APT Howto.

note: type: Content of: <refentry><refsect1><title>
en: Diagnostics
ja: 診断メッセージ

note: type: Content of: <refentry><refsect1><para>
en: <command>apt</command> returns zero on normal operation, decimal 100 on error.
ja: <command>apt</command> は正常終了時に 0 を返します。エラー時には十進の 100 を返します。

note: type: Content of: <refentry><refnamediv><refpurpose>
en: APT package handling utility -- command-line interface
ja: APT パッケージ操作ユーティリティ -- コマンドラインインターフェース

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-get</command> is the command-line tool for handling packages, and may be considered the user's "back-end" to other tools using the APT library.  Several "front-end" interfaces exist, such as &aptitude;, &synaptic; and &wajig;.
ja: <command>apt-get</command> は、パッケージを操作するコマンドラインツールで、APT ライブラリを用いる他のツールのユーザ側「バックエンド」といえるものです。「フロントエンド」インターフェースには、&aptitude;, &synaptic;, &wajig; などがあります。

note: type: Content of: <refentry><refsect1><para>
en: Unless the <option>-h</option>, or <option>--help</option> option is given, one of the commands below must be present.
ja: <option>-h</option> オプションや <option>--help</option> オプションを除き、以下に挙げるコマンドが必要です。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>update</literal> is used to resynchronize the package index files from their sources. The indexes of available packages are fetched from the location(s) specified in <filename>/etc/apt/sources.list</filename>.  For example, when using a Debian archive, this command retrieves and scans the <filename>Packages.gz</filename> files, so that information about new and updated packages is available. An <literal>update</literal> should always be performed before an <literal>upgrade</literal> or <literal>dist-upgrade</literal>. Please be aware that the overall progress meter will be incorrect as the size of the package files cannot be known in advance.
ja: <literal>update</literal>は、取得元からパッケージインデックスファイルの再同期を行うのに使用します。利用可能なパッケージのインデックスは、<filename>/etc/apt/sources.list</filename> に記述した場所から取得します。例えば Debian アーカイブを利用する際、このコマンドが <filename>Packages.gz</filename> ファイルを検索することで、新規または更新されたパッケージの情報が利用可能となります。<literal>update</literal> は、<literal>upgrade</literal> や <literal>dist-upgrade</literal> を行う前に常に実行してください。前もってパッケージファイルのサイズを知ることができないため、全体の進捗メータは正しく表示されません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>upgrade</literal> is used to install the newest versions of all packages currently installed on the system from the sources enumerated in <filename>/etc/apt/sources.list</filename>. Packages currently installed with new versions available are retrieved and upgraded; under no circumstances are currently installed packages removed, or packages not already installed retrieved and installed. New versions of currently installed packages that cannot be upgraded without changing the install status of another package will be left at their current version. An <literal>update</literal> must be performed first so that <command>apt-get</command> knows that new versions of packages are available.
ja: <literal>upgrade</literal> は、現在システムにインストールされている全パッケージの最新バージョンを、<filename>/etc/apt/sources.list</filename> に列挙した取得元からインストールするのに使用します。現在インストール中のパッケージに新しいバージョンがあれば更新しますが、いかなる時も現在インストール中のパッケージの削除は行いませんし、インストールしていないパッケー所の取得・インストールは行いません。対象のパッケージが、他のパッケージのインストール状態を変更せずに更新できない場合は、現在のバージョンのままとなります。最初に <literal>update</literal> を実行しておき、<command>apt-get</command> にパッケージの新しいバージョンがあることを知らせる必要があります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>dist-upgrade</literal> in addition to performing the function of <literal>upgrade</literal>, also intelligently handles changing dependencies with new versions of packages; <command>apt-get</command> has a "smart" conflict resolution system, and it will attempt to upgrade the most important packages at the expense of less important ones if necessary.  The <literal>dist-upgrade</literal> command may therefore remove some packages.  The <filename>/etc/apt/sources.list</filename> file contains a list of locations from which to retrieve desired package files.  See also &apt-preferences; for a mechanism for overriding the general settings for individual packages.
ja: <literal>dist-upgrade</literal> は、<literal>upgrade</literal> の機能に加え、新バージョンのパッケージに対する依存関係の変更を知的に操作します。<command>apt-get</command> は「洗練された」競合解決システムを持ち、必要とあらば比較的重要でないパッケージを犠牲にして、最重要パッケージの更新を試みます。そのため <literal>dist-upgrade</literal> は、いくつかのパッケージを削除する可能性があります。<filename>/etc/apt/sources.list</filename> ファイルには、必要なパッケージファイルを検索する場所のリストが含まれています。特定のパッケージ向けに、一般的な設定を上書きする機構については、&apt-preferences; をご覧ください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>dselect-upgrade</literal> is used in conjunction with the traditional Debian packaging front-end, &dselect;. <literal>dselect-upgrade</literal> follows the changes made by &dselect; to the <literal>Status</literal> field of available packages, and performs the actions necessary to realize that state (for instance, the removal of old and the installation of new packages).
ja: <literal>dselect-upgrade</literal> は、伝統的な Debian GNU/Linux パッケージ管理フロントエンドの &dselect; と共に使用されます。<literal>dselect-upgrade</literal> は、&dselect; で作られた利用可能パッケージの<literal>Status</literal> フィールドの変更を追跡し、その状態を反映させるのに必要なアクションを実行します。(例えば、古いパッケージの削除や新しいパッケージのインストールなど)

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>install</literal> is followed by one or more packages desired for installation or upgrading.  Each package is a package name, not a fully qualified filename (for instance, in a Debian system, <package>apt-utils</package> would be the argument provided, not <filename>apt-utils_&apt-product-version;_amd64.deb</filename>). All packages required by the package(s) specified for installation will also be retrieved and installed.  The <filename>/etc/apt/sources.list</filename> file is used to locate the desired packages. If a hyphen is appended to the package name (with no intervening space), the identified package will be removed if it is installed.  Similarly a plus sign can be used to designate a package to install. These latter features may be used to override decisions made by apt-get's conflict resolution system.
ja: <literal>install</literal> の後には、インストールや更新したいパッケージを 1 つ以上指定します。指定するパッケージは、完全なファイル名ではなくパッケージ名です (例えば Debian システムでは、<filename>apt-utils_&apt-product-version;_amd64.deb</filename> ではなく <package>apt-utils</package> を引数として与えます)。インストールするよう指定したすべてのパッケージに対し、依存パッケージも含めて取得・インストールを行います。<filename>/etc/apt/sources.list</filename> ファイルを、要求するパッケージの場所を特定するのに使用します。パッケージ名の後ろに (空白を含まず) ハイフンが追加されている場合、そのパッケージがインストールされていれば削除します。同様に、インストールするパッケージを明示するのにプラス記号も使用できます。この記号は apt-get の競合解決システムの判断を上書きするのに利用される可能性があります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: A specific version of a package can be selected for installation by following the package name with an equals and the version of the package to select. This will cause that version to be located and selected for install. Alternatively a specific distribution can be selected by following the package name with a slash and the version of the distribution or the Archive name (stable, testing, unstable).
ja: パッケージにイコール記号とバージョンを続けることで、選択したバージョンのパッケージをインストールすることができます。つまり、指定のバージョンのパッケージをインストールするように選択する、ということです。別の方法としては、ディストリビューションを特定するのに、パッケージ名に続けて、スラッシュとディストリビューションのバージョンやアーカイブ名 (stable, testing, unstable) を記述できます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Both of the version selection mechanisms can downgrade packages and must be used with care.
ja: バージョン選択機構はダウングレードにも使用できるため、注意して使用しなければなりません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This is also the target to use if you want to upgrade one or more already-installed packages without upgrading every package you have on your system. Unlike the "upgrade" target, which installs the newest version of all currently installed packages, "install" will install the newest version of only the package(s)  specified. Simply provide the name of the package(s) you wish to upgrade, and if a newer version is available, it (and its dependencies, as described above) will be downloaded and installed.
ja: システムにインストール済みのパッケージを、すべてアップグレードするのではなく、いくつかのパッケージをアップグレードする場合にも、このターゲットを使用できます。現在インストールされているパッケージすべての最新版をインストールする "upgrade" ターゲットと異なり、"install" は指定したパッケージの最新版のみをインストールします。単純にアップグレードしたいパッケージ名を指定してください。より新しいバージョンが利用できる場合、そのパッケージ (と前述の依存関係にあるパッケージ) をダウンロード・インストールします。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Finally, the &apt-preferences; mechanism allows you to create an alternative installation policy for individual packages.
ja: 最後に、&apt-preferences; 機構により、特定のパッケージに対するインストールポリシーを作成できます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: If no package matches the given expression and the expression contains one of '.', '?' or '*' then it is assumed to be a POSIX regular expression, and it is applied to all package names in the database. Any matches are then installed (or removed). Note that matching is done by substring so 'lo.*' matches 'how-lo' and 'lowest'. If this is undesired, anchor the regular expression with a '^' or '$' character, or create a more specific regular expression.
ja: 構文に '.', '?', '*' を含み、パッケージ名がマッチしなかった場合、POSIX 正規表現であると見なし、データベース内の全パッケージ名に対して適用します。マッチしたパッケージすべてがインストール(もしくは削除)されます。'lo.*' のような文字列は、'how-lo' や 'lowest' にマッチすることに注意してください。そうしたくなければ、'^' や '$' を付けるか、もっと詳しい正規表現を指定してください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>remove</literal> is identical to <literal>install</literal> except that packages are removed instead of installed. Note that removing a package leaves its configuration files on the system. If a plus sign is appended to the package name (with no intervening space), the identified package will be installed instead of removed.
ja: <literal>remove</literal> は、パッケージが削除されることを除き、<literal>install</literal> と同様です。削除されたパッケージの設定ファイルは、システムに残ったままになることに注意してください。プラス記号がパッケージ名に (間に空白を含まずに) 付加されると、識別されたパッケージを、削除ではなくインストールします。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>purge</literal> is identical to <literal>remove</literal> except that packages are removed and purged (any configuration files are deleted too).
ja: パッケージが削除かつ完全削除 (すべての設定ファイルも削除) されるのを除き、<literal>purge</literal> は <literal>remove</literal> と同じです。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>source</literal> causes <command>apt-get</command> to fetch source packages. APT will examine the available packages to decide which source package to fetch. It will then find and download into the current directory the newest available version of that source package while respecting the default release, set with the option <literal>APT::Default-Release</literal>, the <option>-t</option> option or per package with the <literal>pkg/release</literal> syntax, if possible.
ja: <literal>source</literal> は、<command>apt-get</command> にソースパッケージを取得させます。APT はどのソースパッケージを取得するか決めるため、利用可能なパッケージを検査します。その後、デフォルトリリースから最新の利用可能なソースパッケージを見つけ、カレントディレクトリへダウンロードします。デフォルトリリースは、可能であれば、<literal>APT::Default-Release</literal> オプション、<option>-t</option> オプション、パッケージごとの <literal>pkg/release</literal> 構文で指定します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Source packages are tracked separately from binary packages via <literal>deb-src</literal> lines in the &sources-list; file. This means that you will need to add such a line for each repository you want to get sources from; otherwise you will probably get either the wrong (too old/too new) source versions or none at all.
ja: ソースパッケージは、&sources-list; ファイルの <literal>deb-src</literal> 行により、バイナリパッケージと分けて管理されます。つまり、ソースを取得したいリポジトリを、それぞれ追加する必要があるということです。こうしないと、誤った (古すぎ・新しすぎな) ソースバージョンを取得したり、何も取得できなくなります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: If the <option>--compile</option> option is specified then the package will be compiled to a binary .deb using <command>dpkg-buildpackage</command> for the architecture as defined by the <command>--host-architecture</command> option.  If <option>--download-only</option> is specified then the source package will not be unpacked.
ja: <option>--compile</option> オプションを指定すると、<command>dpkg-buildpackage</command> を用いて、<command>--host-architecture</command> オプションで定義したアーキテクチャのバイナリ .deb パッケージをコンパイルします。<option>--download-only</option> を指定すると、ソースパッケージを展開しません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: A specific source version can be retrieved by postfixing the source name with an equals and then the version to fetch, similar to the mechanism used for the package files. This enables exact matching of the source package name and version, implicitly enabling the <literal>APT::Get::Only-Source</literal> option.
ja: パッケージと同様に、ソース名の後ろにイコールと取得したいバージョンを置くと、指定したバージョンのソースを取得できます。<literal>APT::Get::Only-Source</literal> オプションが暗黙のうちに有効になっているため、ソースパッケージ名とバージョンに厳密に一致させています。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Note that source packages are not installed and tracked in the <command>dpkg</command> database like binary packages; they are simply downloaded to the current directory, like source tarballs.
ja: ソースパッケージはインストールされず、バイナリパッケージのように <command>dpkg</command> データベースで管理されないことに注意してください。ソースの tarball のように、単にカレントディレクトリにダウンロードします。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>build-dep</literal> causes apt-get to install/remove packages in an attempt to satisfy the build dependencies for a source package. By default the dependencies are satisfied to build the package natively. If desired a host-architecture can be specified with the <option>--host-architecture</option> option instead.
ja: <literal>build-dep</literal> は、ソースパッケージの構築依存関係を満たすように、パッケージのインストール・削除を行います。デフォルトでは、パッケージをネイティブに構築する依存関係を満たします。お望みなら、<option>--host-architecture</option> オプションにより、別のホストアーキテクチャを指定できます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>check</literal> is a diagnostic tool; it updates the package cache and checks for broken dependencies.
ja: <literal>check</literal> は、パッケージキャッシュの更新や壊れた依存関係をチェックする診断ツールです。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>clean</literal> clears out the local repository of retrieved package files. It removes everything but the lock file from <filename>&cachedir;/archives/</filename> and <filename>&cachedir;/archives/partial/</filename>.
ja: <literal>clean</literal> は、取得したパッケージのローカルリポジトリを掃除します。<filename>&cachedir;/archives/</filename> と <filename>&cachedir;/archives/partial/</filename> からロックファイル以外すべて削除します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: (and the
ja: (および

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: alias since 1.1)
ja: 1.1 以降の別名)

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Like <literal>clean</literal>, <literal>autoclean</literal> clears out the local repository of retrieved package files. The difference is that it only removes package files that can no longer be downloaded, and are largely useless. This allows a cache to be maintained over a long period without it growing out of control. The configuration option <literal>APT::Clean-Installed</literal> will prevent installed packages from being erased if it is set to off.
ja: <literal>clean</literal> のように、<literal>autoclean</literal> は取得したパッケージのローカルリポジトリを掃除します。違いは、もうダウンロードされることがないパッケージファイルや、ほとんど不要なパッケージファイルのみを削除することです。このため、キャッシュは、制御不能になるほど成長することなく、長期にわたって維持することができます。設定オプション <literal>APT::Clean-Installed</literal> に off をセットしていれば、インストール済みのパッケージファイルが削除されるのを防ぐことができます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>autoremove</literal> is used to remove packages that were automatically installed to satisfy dependencies for other packages and are now no longer needed.
ja: <literal>autoremove</literal> は、他のパッケージの依存関係を満たすために自動的にインストールされ、もう必要なくなったパッケージを削除するのに使用します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>changelog</literal> tries to download the changelog of a package and displays it through <command>sensible-pager</command>.  By default it displays the changelog for the version that is installed.  However, you can specify the same options as for the <option>install</option> command.
ja: <literal>changelog</literal> は、パッケージの changelog をダウンロードし、<command>sensible-pager</command> で表示します。デフォルトでは、インストールされているバージョンの changelog を表示します。しかし、<option>install</option> コマンドと同じオプションを指定することができます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Displays by default a deb822 formatted listing of information about all data files (aka index targets) <command>apt-get update</command> would download. Supports a <option>--format</option> option to modify the output format as well as accepts lines of the default output to filter the records by. The command is mainly used as an interface for external tools working with APT to get information as well as filenames for downloaded files so they can use them as well instead of downloading them again on their own. Detailed documentation is omitted here and can instead be found in the file &apt-acquire-additional-files; shipped by the <package>apt-doc</package> package.
ja: デフォルトでは <command>apt-get update</command> でダウンロードすることができるすべてのデータファイル (別名インデックスターゲット) に関する情報の deb822 形式のリストを表示します。出力形式を変更する、またレコードをフィルタするデフォルト出力の行を受け付けるための <option>--format</option> オプションをサポートします。コマンドは主に、ダウンロードしたファイルの情報やファイル名を取得するために、APT を扱う外部ツール用のインターフェースとして使用されます。そして、外部ツールが自身で再度ダウンロードする代わりに使用することができます。詳細なドキュメントはここでは省略しますが、代わりに <package>apt-doc</package> パッケージに収録されている <literal><filename>doc/acquire-additional-files.txt</filename></literal> で見つけることができます。

note: type: Content of: <refentry><refsect1><title>
en: options
ja: オプション

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Do not consider recommended packages as a dependency for installing.  Configuration Item: <literal>APT::Install-Recommends</literal>.
ja: 「推奨」パッケージをインストールする依存関係と見なしません。設定項目: <literal>APT::Install-Recommends</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Consider suggested packages as a dependency for installing.  Configuration Item: <literal>APT::Install-Suggests</literal>.
ja: 「提案」パッケージをインストールする依存関係と見なします。設定項目: <literal>APT::Install-Suggests</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Download only; package files are only retrieved, not unpacked or installed.  Configuration Item: <literal>APT::Get::Download-Only</literal>.
ja: ダウンロードのみ - パッケージファイルの取得のみを行い、展開・インストールを行いません。設定項目: <literal>APT::Get::Download-Only</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Fix; attempt to correct a system with broken dependencies in place. This option, when used with install/remove, can omit any packages to permit APT to deduce a likely solution. If packages are specified, these have to completely correct the problem. The option is sometimes necessary when running APT for the first time; APT itself does not allow broken package dependencies to exist on a system. It is possible that a system's dependency structure can be so corrupt as to require manual intervention (which usually means using <command>dpkg --remove</command> to eliminate some of the offending packages). Use of this option together with <option>-m</option> may produce an error in some situations.  Configuration Item: <literal>APT::Get::Fix-Broken</literal>.
ja: 修復 - 依存関係が壊れたシステムの修正を試みます。このオプションを install や remove と一緒に使うときは、APT が解決法を推測するので、パッケージを指定しなくてもかまいません。どのパッケージを指定しても、完全に問題を解決します。APT 自体は、システムに存在する破損したパッケージ依存関係を許すことができないので、初めて APT を実行する場合、このオプションが必要になることがあります。システムの依存関係構造にかなり問題がある場合は、手動で修正するよう要求することもあります。(通常は、問題のあるパッケージを取り除くのに <command>dpkg --remove</command> を使用します) このオプションを <option>-m</option> オプションと同時に使用すると、エラーになる状況があるかもしれません。設定項目: <literal>APT::Get::Fix-Broken</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Ignore missing packages; if packages cannot be retrieved or fail the integrity check after retrieval (corrupted package files), hold back those packages and handle the result. Use of this option together with <option>-f</option> may produce an error in some situations. If a package is selected for installation (particularly if it is mentioned on the command line) and it could not be downloaded then it will be silently held back.  Configuration Item: <literal>APT::Get::Fix-Missing</literal>.
ja: 欠落パッケージの無視 - パッケージが取得できなかったり、(パッケージの破損で) 取得した後の整合性チェックに失敗した場合、そのパッケージの処理を保留し最後まで処理を続けます。このオプションを <option>-f</option> オプションと同時に使用すると、エラーになる状況があるかもしれません。パッケージをインストールするよう選択している (特にコマンドラインでの操作する) 場合や、ダウンロードできなかった場合に、なにも表示せず保留することになります。設定項目: <literal>APT::Get::Fix-Missing</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Disables downloading of packages. This is best used with <option>--ignore-missing</option> to force APT to use only the .debs it has already downloaded.  Configuration Item: <literal>APT::Get::Download</literal>.
ja: パッケージのダウンロードを無効にします。これはすでにダウンロードした .deb に対してのみ APT を行う場合に、<option>--ignore-missing</option> と併せて使うのがよいでしょう。設定項目: <literal>APT::Get::Download</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Quiet; produces output suitable for logging, omitting progress indicators.  More q's will produce more quiet up to a maximum of 2. You can also use <option>-q=#</option> to set the quiet level, overriding the configuration file.  Note that quiet level 2 implies <option>-y</option>; you should never use -qq without a no-action modifier such as -d, --print-uris or -s as APT may decide to do something you did not expect.  Configuration Item: <literal>quiet</literal>.
ja: 静粛 - 進捗表示を省略し、ログをとるのに便利な出力を行います。最大 2 つまで q を重ねることでより静粛にできます。また、<option>-q=#</option> のように静粛レベルを指定して、設定ファイルを上書きすることもできます。静粛レベル 2 は <option>-y</option> を含んでいることに注意してください。APT が意図しない決定を行うかもしれないので -d, --print-uris, -s のような操作を行わないオプションをつけずに -qq を使用するべきではありません。設定項目: <literal>quiet</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: No action; perform a simulation of events that would occur based on the current system state but do not actually change the system. Locking will be disabled (<option>Debug::NoLocking</option>)  so the system state could change while <command>apt-get</command> is running. Simulations can also be executed by non-root users which might not have read access to all apt configuration distorting the simulation.  A notice expressing this warning is also shown by default for non-root users (<option>APT::Get::Show-User-Simulation-Note</option>).  Configuration Item: <literal>APT::Get::Simulate</literal>.
ja: 何もしない - 現在のシステム状態に基づいて起こるイベントのシミュレーションを行い、実際にはシステムを変更しません。ロックは無効になる (<option>Debug::NoLocking</option>) ので、<command>apt-get</command> 実行中にシステムの状態が変化する可能性があります。シミュレーションは root 以外のユーザが実行できますが、シミュレーションを歪めるすべての apt 設定への読み取りアクセス権を持っていない可能性があります。この警告を表す通知は、root 以外のユーザではデフォルトで表示されます (<option>APT::Get::Show-User-Simulation-Note</option>)。設定項目: <literal>APT::Get::Simulate</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Simulated runs print out a series of lines, each representing a <command>dpkg</command> operation: configure (<literal>Conf</literal>), remove (<literal>Remv</literal>)  or unpack (<literal>Inst</literal>). Square brackets indicate broken packages, and empty square brackets indicate breaks that are of no consequence (rare).
ja: シミュレートの結果、<command>dpkg</command> の動作を表す一連の行のそれぞれに、設定 (<literal>Conf</literal>)、削除 (<literal>Remv</literal>)、展開 (<literal>Inst</literal>) を表示します。角カッコは壊れたパッケージを表し、(まれに) 空の角カッコは大した問題ではないことを表します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Automatic yes to prompts; assume "yes" as answer to all prompts and run non-interactively. If an undesirable situation, such as changing a held package, trying to install an unauthenticated package or removing an essential package occurs then <literal>apt-get</literal> will abort.  Configuration Item: <literal>APT::Get::Assume-Yes</literal>.
ja: プロンプトへの自動承諾 - すべてのプロンプトに自動的に "yes" と答え、非対話的に実行します。保留したパッケージの状態を変更したり、必須パッケージを削除するような不適切な状況の場合、<literal>apt-get</literal> は処理を中断します。設定項目: <literal>APT::Get::Assume-Yes</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Automatic "no" to all prompts.  Configuration Item: <literal>APT::Get::Assume-No</literal>.
ja: 全ての質問に、自動的に "no" と答えます。設定項目: <literal>APT::Get::Assume-No</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Do not show a list of all packages that are to be upgraded.  Configuration Item: <literal>APT::Get::Show-Upgraded</literal>.
ja: 更新される全パッケージの表示を行いません。設定項目: <literal>APT::Get::Show-Upgraded</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Show full versions for upgraded and installed packages.  Configuration Item: <literal>APT::Get::Show-Versions</literal>.
ja: 更新・インストールするパッケージのバージョンをすべて表示します。設定項目: <literal>APT::Get::Show-Versions</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This option controls the architecture packages are built for by <command>apt-get source --compile</command> and how cross-builddependencies are satisfied. By default is it not set which means that the host architecture is the same as the build architecture (which is defined by <literal>APT::Architecture</literal>).  Configuration Item: <literal>APT::Get::Host-Architecture</literal>.
ja: このオプションは、<command>apt-get source --compile</command> で構築するパッケージのアーキテクチャや、どのようにクロス依存関係を解決するかを制御します。デフォルトでは未定義で、これはホストアーキテクチャは、(<literal>APT::Architecture</literal> で定義した) ビルドアーキテクチャと同じという意味になります。設定項目: <literal>APT::Get::Host-Architecture</literal>。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This option controls the activated build profiles for which a source package is built by <command>apt-get source --compile</command> and how build dependencies are satisfied. By default no build profile is active.  More than one build profile can be activated at a time by concatenating them with a comma.  Configuration Item: <literal>APT::Build-Profiles</literal>.
ja: このオプションは、<command>apt-get source --compile</command> でパッケージをビルドする際に有効化するビルドプロファイルや、どのようにクロス依存関係を解決するかを制御します。デフォルトでは有効化するビルドプロファイルはありません。コンマで連結することで複数のビルドプロファイルを有効化できます。設定項目: <literal>APT::Get::Host-Architecture</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Compile source packages after downloading them.  Configuration Item: <literal>APT::Get::Compile</literal>.
ja: ソースパッケージをダウンロード後、コンパイルします。設定項目: <literal>APT::Get::Compile</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Ignore package holds; this causes <command>apt-get</command> to ignore a hold placed on a package. This may be useful in conjunction with <literal>dist-upgrade</literal> to override a large number of undesired holds.  Configuration Item: <literal>APT::Ignore-Hold</literal>.
ja: 保留パッケージの無視 - パッケージの保留指示を無視して <command>apt-get</command> を行います。<literal>dist-upgrade</literal> と共に使用し、パッケージを大量に、保留解除するのに便利です。設定項目: <literal>APT::Ignore-Hold</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Allow installing new packages when used in conjunction with <literal>upgrade</literal>.  This is useful if the update of an installed package requires new dependencies to be installed. Instead of holding the package back <literal>upgrade</literal> will upgrade the package and install the new dependencies. Note that <literal>upgrade</literal> with this option will never remove packages, only allow adding new ones.  Configuration Item: <literal>APT::Get::Upgrade-Allow-New</literal>.
ja: <literal>upgrade</literal> と併せて使った場合に新しいパッケージのインストールを許可します。これは新しい依存をインストールするために既にインストールされているパッケージを更新する必要がある場合に有用です。パッケージを保留する代わりに <literal>upgrade</literal> がパッケージをアップグレードして新しい依存をインストールします。このオプションと併せて使った場合、<literal>upgrade</literal> がパッケージを削除することはなく、新規追加を許可するだけであることに注意してください。設定項目: <literal>APT::Get::Upgrade-Allow-New</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Do not upgrade packages; when used in conjunction with <literal>install</literal>, <literal>no-upgrade</literal> will prevent packages on the command line from being upgraded if they are already installed.  Configuration Item: <literal>APT::Get::Upgrade</literal>.
ja: パッケージ更新なし -  <literal>install</literal> と同時に使用すると、<literal>no-upgrade</literal> は、コマンドラインで指定したパッケージが、すでにインストールしてある場合に更新を行いません。設定項目: <literal>APT::Get::Upgrade</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Do not install new packages; when used in conjunction with <literal>install</literal>, <literal>only-upgrade</literal> will install upgrades for already installed packages only and ignore requests to install new packages.  Configuration Item: <literal>APT::Get::Only-Upgrade</literal>.
ja: 新規パッケージインストールなし -  <literal>install</literal> と同時に使用すると、<literal>only-upgrade</literal> は、すでにインストールされているパッケージのみをアップグレードし、新しいパッケージのインストール要求を無視します。設定項目: <literal>APT::Get::Only-Upgrade</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This is a dangerous option that will cause apt to continue without prompting if it is doing downgrades. It should not be used except in very special situations. Using it can potentially destroy your system! Configuration Item: <literal>APT::Get::allow-downgrades</literal>. Introduced in APT 1.1.
ja: ダウングレードを行う場合でも、確認なしで実行してしまう危険なオプションです。よほどの状況でなければ、使うべきではありません。このオプションを使うと、システムを破壊しかねません! 設定項目: <literal>APT::Get::allow-downgrades</literal>。APT 1.1 で導入されました。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Force yes; this is a dangerous option that will cause apt to continue without prompting if it is removing essentials. It should not be used except in very special situations. Using it can potentially destroy your system! Configuration Item: <literal>APT::Get::allow-remove-essential</literal>. Introduced in APT 1.1.
ja: 強制承諾 - 必要不可欠なものを削除する場合でも、確認なしで実行してしまう危険なオプションです。よほどの状況でなければ、使うべきではありません。<literal>force-yes</literal> を使うと、システムを破壊しかねません! 設定項目: <literal>APT::Get::allow-remove-essential</literal>。APT 1.1 で導入されました。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Force yes; this is a dangerous option that will cause apt to continue without prompting if it is changing held packages. It should not be used except in very special situations. Using it can potentially destroy your system! Configuration Item: <literal>APT::Get::allow-change-held-packages</literal>. Introduced in APT 1.1.
ja: 強制承諾 - 保持されたパッケージを変更する場合でも、確認なしで実行してしまう危険なオプションです。よほどの状況でなければ、使うべきではありません。このオプションを使うと、システムを破壊しかねません! 設定項目: <literal>APT::Get::allow-change-held-packages</literal>。APT 1.1 で導入されました。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Instead of fetching the files to install their URIs are printed. Each URI will have the path, the destination file name, the size and the expected MD5 hash. Note that the file name to write to will not always match the file name on the remote site! This also works with the <literal>source</literal> and <literal>update</literal> commands. When used with the <literal>update</literal> command the MD5 and size are not included, and it is up to the user to decompress any compressed files.  Configuration Item: <literal>APT::Get::Print-URIs</literal>.
ja: インストールするファイルを取得する代わりに、その URI を表示します。URI には、パス、対象ファイル名、ファイルサイズ、予測される MD5 ハッシュが含まれています。出力したファイル名が、常にリモートサイトのファイル名と一致するわけではない、ということに注意してください! これは <literal>source</literal> コマンド、<literal>update</literal> コマンドでも動作します。<literal>update</literal> で使用したときには、MD5 やファイルサイズを含みません。このとき、圧縮ファイルの展開はユーザの責任において行ってください。設定項目: <literal>APT::Get::Print-URIs</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Use purge instead of remove for anything that would be removed.  An asterisk ("*") will be displayed next to packages which are scheduled to be purged. <option>remove --purge</option> is equivalent to the <option>purge</option> command.  Configuration Item: <literal>APT::Get::Purge</literal>.
ja: 削除する際、「削除」ではなく「完全削除」を行います。「完全削除」を行うと指示したパッケージ名の後には、アスタリスク ("*") が付きます。<option>remove --purge</option> は <option>purge</option> コマンドと等価です。 設定項目: <literal>APT::Get::Purge</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Re-install packages that are already installed and at the newest version.  Configuration Item: <literal>APT::Get::ReInstall</literal>.
ja: すでに最新版がインストールされていても、パッケージを再インストールします。設定項目: <literal>APT::Get::ReInstall</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This option is on by default; use <literal>--no-list-cleanup</literal> to turn it off. When it is on, <command>apt-get</command> will automatically manage the contents of <filename>&statedir;/lists</filename> to ensure that obsolete files are erased.  The only reason to turn it off is if you frequently change your sources list.  Configuration Item: <literal>APT::Get::List-Cleanup</literal>.
ja: この機能はデフォルトで ON になっています。OFF にするには <literal>--no-list-cleanup</literal> としてください。ON の場合、<command>apt-get</command> は古くなったファイルを確実に消去するため、自動的に <filename>&statedir;/lists</filename> の中身を管理します。これを OFF にするのは、取得元リストを頻繁に変更する時ぐらいでしょう。設定項目: <literal>APT::Get::List-Cleanup</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This option controls the default input to the policy engine; it creates a default pin at priority 990 using the specified release string.  This overrides the general settings in <filename>/etc/apt/preferences</filename>.  Specifically pinned packages are not affected by the value of this option. In short, this option lets you have simple control over which distribution packages will be retrieved from. Some common examples might be <option>-t '2.1*'</option>, <option>-t unstable</option> or <option>-t sid</option>.  Configuration Item: <literal>APT::Default-Release</literal>; see also the &apt-preferences; manual page.
ja: このオプションは、ポリシーエンジンへのデフォルト入力を制御します。また、指定されたリリース文字列を使用し、デフォルト pin を優先度 990 で作成します。これは、<filename>/etc/apt/preferences</filename> にある一般設定を上書きします。pin で留めるのを明示されたパッケージには、このオプションの値は影響を与えません。つまりこのオプションで、どの配布パッケージを取得するかを簡単に管理します。一般的な例としては、<option>-t '2.1*'</option>, <option>-t unstable</option>, <option>-t sid</option> のようになります。設定項目: <literal>APT::Default-Release</literal>。&apt-preferences; のマニュアルページも参照してください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Only perform operations that are 'trivial'. Logically this can be considered related to <option>--assume-yes</option>; where <option>--assume-yes</option> will answer yes to any prompt, <option>--trivial-only</option> will answer no.  Configuration Item: <literal>APT::Get::Trivial-Only</literal>.
ja: 「重要でない」操作のみを行います。これは論理的に <option>--assume-yes</option> の仲間と見なせます。<option>--assume-yes</option> は質問にすべて yes と答えますが、<option>--trivial-only</option> はすべて no と答えます。設定項目: <literal>APT::Get::Trivial-Only</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: If any packages are to be removed apt-get immediately aborts without prompting.  Configuration Item: <literal>APT::Get::Remove</literal>.
ja: パッケージが削除される状況になったとき、プロンプトを表示せず中断します。設定項目: <literal>APT::Get::Remove</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: If the command is either <literal>install</literal> or <literal>remove</literal>, then this option acts like running the <literal>autoremove</literal> command, removing unused dependency packages. Configuration Item: <literal>APT::Get::AutomaticRemove</literal>.
ja: コマンドが <literal>install</literal> か <literal>remove</literal> である場合、このオプションは使用していない依存しているパッケージを削除し、<literal>autoremove</literal> コマンドのように動作します。設定項目: <literal>APT::Get::AutomaticRemove</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Only has meaning for the <literal>source</literal> and <literal>build-dep</literal> commands.  Indicates that the given source names are not to be mapped through the binary table.  This means that if this option is specified, these commands will only accept source package names as arguments, rather than accepting binary package names and looking up the corresponding source package.  Configuration Item: <literal>APT::Get::Only-Source</literal>.
ja: <literal>source</literal> コマンドと <literal>build-dep</literal> コマンドでのみ意味があります。指定されたソース名がバイナリテーブルにマップされないようにします。これは、このオプションを指定すると、バイナリパッケージ名を受け付けて対応するソースパッケージを探すのではなく、引数にソースパッケージ名しか受け付けなくなる、ということです。設定項目: <literal>APT::Get::Only-Source</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Download only the diff, dsc, or tar file of a source archive.  Configuration Item: <literal>APT::Get::Diff-Only</literal>, <literal>APT::Get::Dsc-Only</literal>, and <literal>APT::Get::Tar-Only</literal>.
ja: ソースアーカイブの diff ファイルや dsc ファイル、tar ファイルのダウンロードのみを行います。設定項目: <literal>APT::Get::Diff-Only</literal>, <literal>APT::Get::Dsc-Only</literal>, <literal>APT::Get::Tar-Only</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Only process architecture-dependent build-dependencies.  Configuration Item: <literal>APT::Get::Arch-Only</literal>.
ja: 構築依存関係の解決を、アーキテクチャに依存したもののみ行います。設定項目: <literal>APT::Get::Arch-Only</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Only process architecture-independent build-dependencies.  Configuration Item: <literal>APT::Get::Indep-Only</literal>.
ja: 構築依存関係の解決を、アーキテクチャに依存しないもののみ行います。設定項目: <literal>APT::Get::Arch-Only</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Ignore if packages can't be authenticated and don't prompt about it.  This can be useful while working with local repositories, but is a huge security risk if data authenticity isn't ensured in another way by the user itself.  The usage of the <option>Trusted</option> option for &sources-list; entries should usually be preferred over this global override.  Configuration Item: <literal>APT::Get::AllowUnauthenticated</literal>.
ja: パッケージが認証できない場合は無視してください。プロンプトは表示されません。ローカルリポジトリでの作業中には有用ですが、ユーザ自身が別の方法でデータの信憑性を確保していない場合は、セキュリティ上の重大なリスクになります。&sources-list; エントリ用の <option>Trusted</option> オプションの使用は、通常グローバルオーバーライドよりも優先されるはずです。設定項目: <literal>APT::Get::AllowUnauthenticated</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Show user friendly progress information in the terminal window when packages are installed, upgraded or removed. For a machine parsable version of this data see README.progress-reporting in the apt doc directory.  Configuration Items: <literal>Dpkg::Progress</literal> and <literal>Dpkg::Progress-Fancy</literal>.
ja: パッケージのインストール、アップグレード、削除時にユーザにとってわかりやすい形で進捗情報をターミナルウィンドウ内に表示します。このデータの機械的に解析できるバージョンについては apt の doc ディレクトリにある README.progress-reporting を見てください。設定項目: <literal>Dpkg::Progress</literal>、 <literal>Dpkg::Progress-Fancy</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Adds the given file as a source for metadata. Can be repeated to add multiple files.  See <option>--with-source</option> description in &apt-cache; for further details.
ja: メタ情報のソースとして指定したファイルを追加します。指定を繰り返すと複数のファイルを追加できます。さらなる詳細については &apt-cache; の <option>--with-source</option> の説明を見てください。

note: type: Content of: <refentry><refsect1><title>
en: Files
ja: ファイル

note: type: Content of: <refentry><refsect1><para>
en: &apt-cache;, &apt-cdrom;, &dpkg;, &sources-list;, &apt-conf;, &apt-patterns;, &apt-config;, &apt-secure;, The APT User's guide in &guidesdir;, &apt-preferences;, the APT Howto.
ja: &apt-cache;, &apt-cdrom;, &dpkg;, &sources-list;, &apt-conf;, &apt-patterns;, &apt-config;, &apt-secure;, &guidesdir; にある APT ユーザガイド, &apt-preferences;, APT Howto

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-get</command> returns zero on normal operation, decimal 100 on error.
ja: <command>apt-get</command> は正常終了時に 0 を返します。エラー時には十進の 100 を返します。

note: type: Content of: <refentry><refnamediv><refpurpose>
en: query the APT cache
ja: APT キャッシュへの問い合わせ

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-cache</command> performs a variety of operations on APT's package cache. <command>apt-cache</command> does not manipulate the state of the system but does provide operations to search and generate interesting output from the package metadata. The metadata is acquired and updated via the 'update' command of e.g. <command>apt-get</command>, so that it can be outdated if the last update is too long ago, but in exchange <command>apt-cache</command> works independently of the availability of the configured sources (e.g. offline).
ja: <command>apt-cache</command> は APT のパッケージキャッシュに対して、さまざまな操作を行います。<command>apt-cache</command> は、システム状態の操作は行いませんが、パッケージのメタデータを検索したり、興味深い出力を生成するといった操作を提供します。メタデータは、例えば <command>apt-get</command> の 'update' コマンドで取得して更新します。そのため、最後の更新が古すぎる場合は、時代遅れです。ただし、引き換えに <command>apt-cache</command> は、設定された取得元の可用性とは独立して動作します (例えばオフライン)。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>gencaches</literal> creates APT's package cache. This is done implicitly by all commands needing this cache if it is missing or outdated.
ja: <literal>gencaches</literal> は APT のパッケージキャッシュを作成します。このキャッシュが見つからない、または古くなっている場合、キャッシュを必要とするすべてのコマンドによって、暗黙で実行されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>showpkg</literal> displays information about the packages listed on the command line. Remaining arguments are package names. The available versions and reverse dependencies of each package listed are listed, as well as forward dependencies for each version. Forward (normal)  dependencies are those packages upon which the package in question depends; reverse dependencies are those packages that depend upon the package in question. Thus, forward dependencies must be satisfied for a package, but reverse dependencies need not be.  For instance, <command>apt-cache showpkg libreadline2</command> would produce output similar to the following:
ja: <literal>showpkg</literal> は、コマンドライン上に列挙したパッケージの情報を表示します。後に続く引数はパッケージ名となります。各パッケージについて、有効なバージョンと被依存関係を列挙し、さらにその各バージョンについて依存関係を表示します。(通常の) 依存関係とは、対象のパッケージが依存しているパッケージを指します。また、被依存関係とは、対象のパッケージに依存しているパッケージを指します。従って、パッケージの依存関係は満たさなければなりませんが、被依存関係は満たす必要はありません。実例として、以下に <command>apt-cache showpkg libreadline2</command> の出力を掲げます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Thus it may be seen that libreadline2, version 2.1-12, depends on libc5 and ncurses3.0 which must be installed for libreadline2 to work.  In turn, libreadlineg2 and libreadline2-altdev depend on libreadline2. If libreadline2 is installed, libc5 and ncurses3.0 (and ldso) must also be installed; libreadlineg2 and libreadline2-altdev do not have to be installed. For the specific meaning of the remainder of the output it is best to consult the apt source code.
ja: つまり、libreadline2 の version 2.1-12 は、libc5 と ncurses3.0 に依存していて、libreadline2 が動作するには、これらをインストールする必要があるということが判ります。一方、libreadlineg2 と libreadline2-altdev は libreadline2 に依存しています。libreadline2 をインストールするためには、libc5, ncurses3.0, ldso をすべてインストールしなければなりませんが、libreadlineg2 と libreadline2-altdev はインストールする必要はありません。出力の残りの部分の意味については、apt のソースコードを調べるのが最良でしょう。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>stats</literal> displays some statistics about the cache.  No further arguments are expected. Statistics reported are:
ja: <literal>stats</literal> はキャッシュについての統計情報を表示します。それ以上、引数は必要ありません。以下の統計情報を表示します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
en: <literal>Total package names</literal> is the number of package names found in the cache.
ja: <literal>パッケージ名総数</literal>は、キャッシュに存在するパッケージ数を表します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
en: <literal>Normal packages</literal> is the number of regular, ordinary package names; these are packages that bear a one-to-one correspondence between their names and the names used by other packages for them in dependencies. The majority of packages fall into this category.
ja: <literal>通常パッケージ</literal>は、公式の普通のパッケージ数を表します。これは、他のパッケージの依存関係で使用された名称で、それが一対一に対応するパッケージです。大多数のパッケージはこのカテゴリに入ります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
en: <literal>Pure virtual packages</literal> is the number of packages that exist only as a virtual package name; that is, packages only "provide" the virtual package name, and no package actually uses the name. For instance, "mail-transport-agent" in the Debian system is a pure virtual package; several packages provide "mail-transport-agent", but there is no package named "mail-transport-agent".
ja: <literal>純粋仮想パッケージ</literal>は、仮想パッケージ名としてのみ存在するパッケージ (仮想パッケージ名のみを「提供」し、実際にはいかなるパッケージもその名称を持たない) の数を表します。例えば、Debian システムでは "mail-transport-agent" は純粋仮想パッケージです。"mail-transport-agent" を提供するパッケージはいくつもありますが、"mail-transport-agent" という名前のパッケージはありません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
en: <literal>Single virtual packages</literal> is the number of packages with only one package providing a particular virtual package. For example, in the Debian system, "X11-text-viewer" is a virtual package, but only one package, xless, provides "X11-text-viewer".
ja: <literal>単一仮想パッケージ</literal>は、特定の仮想パッケージ名を提供するパッケージが、ただ一つの場合の数を表します。例えば、Debian システムでは、"X11-text-viewer" は仮想パッケージですが、"X11-text-viewer" を提供するパッケージは、xless パッケージのみということです。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
en: <literal>Mixed virtual packages</literal> is the number of packages that either provide a particular virtual package or have the virtual package name as the package name. For instance, in the Debian system, "debconf" is both an actual package, and provided by the debconf-tiny package.
ja: <literal>複合仮想パッケージ</literal>は、その仮想パッケージ名を提供するパッケージが複数あるか、またパッケージ名と同じ仮想パッケージ名を持つパッケージの数を表します。例えば、Debian システムでは、"debconf" は実際のパッケージ名でもありますが、debconf-tiny によって提供もされています。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
en: <literal>Missing</literal> is the number of package names that were referenced in a dependency but were not provided by any package. Missing packages may be an evidence if a full distribution is not accessed, or if a package (real or virtual) has been dropped from the distribution. Usually they are referenced from Conflicts or Breaks statements.
ja: <literal>欠落</literal>は、依存関係中には存在するのに、どのパッケージにも提供されていないパッケージ名の数を表します。欠落パッケージは、全ディストリビューションにアクセスできていないか、(実ないし仮想) パッケージがディストリビューションからはずされたという兆候かもしれません。通常、構文が競合や破損するとこのようになります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
en: <literal>Total distinct</literal> versions is the number of package versions found in the cache. If more than one distribution is being accessed (for instance, "stable" and "unstable"), this value can be considerably larger than the number of total package names.
ja: <literal>個別バージョン総数</literal>は、キャッシュに存在するパッケージのバージョンの数を表します。もし複数のディストリビューション (例えば "stable" と "unstable") にアクセスする場合、この値はパッケージ名総数よりもかなり大きい数になります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
en: <literal>Total dependencies</literal> is the number of dependency relationships claimed by all of the packages in the cache.
ja: <literal>依存関係総数</literal>は、キャッシュにあるすべてのパッケージで要求された依存関係の数です。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>showsrc</literal> displays all the source package records that match the given package names. All versions are shown, as well as all records that declare the name to be a binary package. Use <option>--only-source</option> to display only source package names.
ja: <literal>showsrc</literal> は、指定したパッケージ名に一致するソースパッケージを、すべて表示します。バイナリパッケージになるときの名称を宣言したレコードとともに、すべてのバージョンについて表示します。ソースパッケージ名だけを表示するには、<option>--only-source</option> を使用してください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>dump</literal> shows a short listing of every package in the cache. It is primarily for debugging.
ja: <literal>dump</literal> は、キャッシュ内のパッケージそれぞれについて、短い一覧を表示します。主にデバッグ用です。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>dumpavail</literal> prints out an available list to stdout. This is suitable for use with &dpkg; and is used by the &dselect; method.
ja: <literal>dumpavail</literal> は、標準出力に利用可能なものの一覧を出力します。 &dpkg; と共に使用すると便利ですし、&dselect; でも使用されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>unmet</literal> displays a summary of all unmet dependencies in the package cache.
ja: <literal>unmet</literal> は、パッケージキャッシュ内にある、不適当な依存関係の概要を表示します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>show</literal> performs a function similar to <command>dpkg --print-avail</command>; it displays the package records for the named packages.
ja: <literal>show</literal> は、<command>dpkg --print-avail</command> と同様の機能を実行します。これは、指定したパッケージのパッケージレコードの表示です。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>search</literal> performs a full text search on all available package lists for the POSIX regex pattern given, see &regex;.  It searches the package names and the descriptions for an occurrence of the regular expression and prints out the package name and the short description, including virtual package names.  If <option>--full</option> is given then output identical to <literal>show</literal> is produced for each matched package, and if <option>--names-only</option> is given then the long description is not searched, only the package name and provided packages are.
ja: <literal>search</literal> は、与えられた POSIX の正規表現 (&regex; を参照) により、すべての利用可能なパッケージに対して全文検索を行います。パッケージ名と説明に対して正規表現で検索を行い、パッケージ名 (仮想パッケージ名を含む) と短い説明文を表示します。<option>--full</option> が与えられた場合、マッチしたパッケージに対し <literal>show</literal> と同じ情報を出力します。<option>--names-only</option> が与えられた場合は、長い説明文に対して検索を行わず、パッケージ名と提供されたパッケージのみ対象とします。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Separate arguments can be used to specify multiple search patterns that are and'ed together.
ja: 空白で区切った引数で、複数の検索パターンの and をとることができます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>depends</literal> shows a listing of each dependency a package has and all the possible other packages that can fulfill that dependency.
ja: <literal>depends</literal> は、パッケージが持っている依存関係と、その依存関係を満たす他のパッケージの一覧を表示します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>rdepends</literal> shows a listing of each reverse dependency a package has.
ja: <literal>rdepends</literal> は、パッケージが持つ被依存関係を一覧表示します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This command prints the name of each package APT knows. The optional argument is a prefix match to filter the name list. The output is suitable for use in a shell tab complete function and the output is generated extremely quickly. This command is best used with the <option>--generate</option> option.
ja: このコマンドは、APT が知っている各パッケージの名前を表示します。オプション引数は、名前一覧から先頭一致で抽出します。この出力はシェルのタブによる補完機能で使いやすく、また非常に高速に生成されます。このコマンドは <option>--generate</option> オプションと共に使用すると非常に便利です。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Note that a package which APT knows of is not necessarily available to download, installable or installed, e.g. virtual packages are also listed in the generated list.
ja: APT が知っているパッケージは、ダウンロード可能、インストール可能、インストール済みである必要がないことに注意してください。つまり、仮想パッケージも生成した一覧にあります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>dotty</literal> takes a list of packages on the command line and generates output suitable for use by dotty from the <ulink url="https://graphviz.org/">GraphViz</ulink> package. The result will be a set of nodes and edges representing the relationships between the packages. By default the given packages will trace out all dependent packages; this can produce a very large graph.  To limit the output to only the packages listed on the command line, set the <literal>APT::Cache::GivenOnly</literal> option.
ja: <literal>dotty</literal> は、コマンドライン上のパッケージ名から、<ulink url="https://graphviz.org/">GraphViz</ulink> パッケージの dotty コマンドで利用するのに便利な出力を生成します。結果はパッケージの関係を表わす、ノード・エッジのセットで表現されます。デフォルトでは、すべての依存パッケージをトレースするので、非常に大きい図が得られます。コマンドラインに列挙したパッケージだけを出力するように制限するには、<literal>APT::Cache::GivenOnly</literal> をセットしてください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The resulting nodes will have several shapes; normal packages are boxes, pure virtual packages are triangles, mixed virtual packages are diamonds, missing packages are hexagons. Orange boxes mean recursion was stopped (leaf packages), blue lines are pre-depends, green lines are conflicts.
ja: 結果のノードは数種の形状をとります。通常パッケージは四角、純粋仮想パッケージは三角、複合仮想パッケージは菱形、欠落パッケージは六角形で表します。オレンジの四角は再帰が終了した「リーフパッケージ」、青い線は先行依存、緑の線は競合を表します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Caution, dotty cannot graph larger sets of packages.
ja: 注意) dotty は、パッケージのより大きなセットのグラフは描けません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The same as <literal>dotty</literal>, only for xvcg from the <ulink url="https://www.rw.cdl.uni-saarland.de/people/sander/private/html/gsvcg1.html">VCG tool</ulink>.
ja: <literal>dotty</literal> と同様ですが、<ulink url="https://www.rw.cdl.uni-saarland.de/people/sander/private/html/gsvcg1.html">VCG tool</ulink> の xvcg 専用です。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>policy</literal> is meant to help debug issues relating to the preferences file. With no arguments it will print out the priorities of each source. Otherwise it prints out detailed information about the priority selection of the named package.
ja: <literal>policy</literal> は、プリファレンスファイル関係の問題について、デバッグを支援します。引数を指定しなかった場合、取得元ごとの優先順位を表示します。一方、パッケージ名を指定した場合、優先順の詳細情報を表示します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>apt-cache</literal>'s <literal>madison</literal> command attempts to mimic the output format and a subset of the functionality of the Debian archive management tool, <literal>madison</literal>.  It displays available versions of a package in a tabular format.  Unlike the original <literal>madison</literal>, it can only display information for the architecture for which APT has retrieved package lists (<literal>APT::Architecture</literal>).
ja: <literal>apt-cache</literal> の <literal>madison</literal> コマンドは、Debian アーカイブ管理ツール <literal>madison</literal> の機能のサブセットで、出力フォーマットを真似ようとします。パッケージの利用可能バージョンを表形式で表示します。オリジナルの <literal>madison</literal> と違い、APT がパッケージ一覧を検索したアーキテクチャ (<literal>APT::Architecture</literal>) の情報を表示するだけです。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Select the file to store the package cache. The package cache is the primary cache used by all operations.  Configuration Item: <literal>Dir::Cache::pkgcache</literal>.
ja: パッケージキャッシュを格納するファイルを選択します。パッケージキャッシュは、すべての操作で使用される一次キャッシュです。設定項目: <literal>Dir::Cache::pkgcache</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Select the file to store the source cache. The source is used only by <literal>gencaches</literal> and it stores a parsed version of the package information from remote sources. When building the package cache the source cache is used to avoid reparsing all of the package files.  Configuration Item: <literal>Dir::Cache::srcpkgcache</literal>.
ja: ソースキャッシュを格納するファイルを選択します。このソースキャッシュは <literal>gencaches</literal> でのみ使用され、ここに解析された取得元のパッケージ情報が格納されています。パッケージキャッシュを構築する際に、全パッケージファイルの再解析を避けるために、ソースキャッシュが使われます。設定項目: <literal>Dir::Cache::srcpkgcache</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Quiet; produces output suitable for logging, omitting progress indicators.  More q's will produce more quietness up to a maximum of 2. You can also use <option>-q=#</option> to set the quietness level, overriding the configuration file.  Configuration Item: <literal>quiet</literal>.
ja: 静粛 - 進捗表示を省略し、ログをとるのに便利な出力を行います。最大 2 つまで q を重ねることでさらに静粛にできます。また、<option>-q=#</option> のように静粛レベルを指定して、設定ファイルを上書きすることもできます。設定項目: <literal>quiet</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Print only important dependencies; for use with <literal>unmet</literal> and <literal>depends</literal>. Causes only Depends and Pre-Depends relations to be printed.  Configuration Item: <literal>APT::Cache::Important</literal>.
ja: 「重要」依存関係のみ表示 - <literal>unmet</literal> や <literal>depends</literal> と共に使用し、「依存」関係と「先行依存」関係のみを表示します。設定項目: <literal>APT::Cache::Important</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Per default the <command>depends</command> and <command>rdepends</command> print all dependencies. This can be tweaked with these flags which will omit the specified dependency type.  Configuration Item: <literal>APT::Cache::Show<replaceable>DependencyType</replaceable></literal> e.g. <literal>APT::Cache::ShowRecommends</literal>.
ja: デフォルトでは <command>depends</command> や <command>rdepends</command> は全依存関係を出力します。この挙動を、ここに挙げたフラグで指定した依存関係を省略できます。設定項目: <literal>APT::Cache::Show<replaceable>依存関係タイプ</replaceable></literal> 例: <literal>APT::Cache::ShowRecommends</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Per default <command>depends</command> and <command>rdepends</command> print only dependencies explicitly expressed in the metadata. With this flag it will also show dependencies implicitly added based on the encountered data.  A <literal>Conflicts: foo</literal> e.g. expresses implicitly that this package also conflicts with the package foo from any other architecture.  Configuration Item: <literal>APT::Cache::ShowImplicit</literal>.
ja: デフォルトでは <command>depends</command> や <command>rdepends</command> はメタデータ中に明示的に表現された依存関係のみを出力します。このフラグを指定すると、遭遇したデータにもとづいて追加の依存関係を表示します。<literal>Conflicts: foo</literal> は、例えば、このパッケージがほかのアーキテクチャからのパッケージ foo と競合していることを暗黙的に表現しています。設定項目: <literal>APT::Cache::ShowImplicit</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Print full package records when searching.  Configuration Item: <literal>APT::Cache::ShowFull</literal>.
ja: search 時に全パッケージレコードを表示します。設定項目: <literal>APT::Cache::ShowFull</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Print full records for all available versions. This is the default; to turn it off, use <option>--no-all-versions</option>.  If <option>--no-all-versions</option> is specified, only the candidate version will be displayed (the one which would be selected for installation).  This option is only applicable to the <literal>show</literal> command.  Configuration Item: <literal>APT::Cache::AllVersions</literal>.
ja: 全利用可能バージョンのレコード全体を表示します。これはデフォルトの動作で、無効にするには <option>--no-all-versions</option> を使用してください。<option>--no-all-versions</option> を指定すると、候補バージョン (インストールの際に選択されるもの) だけ表示します。このオプションは、<literal>show</literal> コマンドでのみ適用できます。設定項目: <literal>APT::Cache::AllVersions</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Perform automatic package cache regeneration, rather than use the cache as it is. This is the default; to turn it off, use <option>--no-generate</option>.  Configuration Item: <literal>APT::Cache::Generate</literal>.
ja: そのままキャッシュを使用するのではなく、自動的にパッケージキャッシュを再生成します。これはデフォルトの動作で、無効にするには <option>--no-generate</option> を使用してください。設定項目: <literal>APT::Cache::Generate</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Only search on the package and provided package names, not the long descriptions.  Configuration Item: <literal>APT::Cache::NamesOnly</literal>.
ja: 長い説明文ではなく、パッケージおよび提供されたパッケージ名のみ検索します。設定項目: <literal>APT::Cache::NamesOnly</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Make <literal>pkgnames</literal> print all names, including virtual packages and missing dependencies.  Configuration Item: <literal>APT::Cache::AllNames</literal>.
ja: <literal>pkgnames</literal> で、仮想パッケージや欠落依存関係を含めた全名称を表示します。設定項目: <literal>APT::Cache::AllNames</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Make <literal>depends</literal> and <literal>rdepends</literal> recursive so that all packages mentioned are printed once.  Configuration Item: <literal>APT::Cache::RecurseDepends</literal>.
ja: <literal>depends</literal> や <literal>rdepends</literal> で、指定した全パッケージを再帰的に一度に表示します。設定項目: <literal>APT::Cache::RecurseDepends</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Limit the output of <literal>depends</literal> and <literal>rdepends</literal> to packages which are currently installed.  Configuration Item: <literal>APT::Cache::Installed</literal>.
ja: <literal>depends</literal> や <literal>rdepends</literal> の出力を、現在インストールされているパッケージに限定します。設定項目: <literal>APT::Cache::Installed</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Adds the given file as a source for metadata. Can be repeated to add multiple files.  Supported are currently <literal>*.deb</literal>, <literal>*.dsc</literal>, <literal>*.changes</literal>, <literal>Sources</literal> and <literal>Packages</literal> files as well as source package directories.  Files are matched based on their name only, not their content!
ja: メタ情報のソースとして指定したファイルを追加します。指定を繰り返すと複数のファイルを追加できます。現在サポートしているのは <literal>*.deb</literal>、<literal>*.dsc</literal>、<literal>*.changes</literal>、<literal>Sources</literal>、<literal>Packages</literal> ファイル並びにソースパッケージのディレクトリです。ファイルとの照合はファイル名だけを基にして行い、ファイルの内容との照合は行いません!

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>Sources</literal> and <literal>Packages</literal> can be compressed in any format apt supports as long as they have the correct extension. If you need to store multiple of these files in one directory you can prefix a name of your choice with the last character being an underscore ("<literal>_</literal>"). Example: my.example_Packages.xz
ja: <literal>Sources</literal> 及び <literal>Packages</literal> は正しい拡張子を付けていれば APT がサポートする任意の形式で圧縮できます。このファイルを同じディレクトリに複数置く必要がある場合は、自分が付ける名前の部分の最後尾にアンダースコア (「<literal>_</literal>」) を付加したものを先頭に付けます。例: my.example_Packages.xz

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Note that these sources are treated as trusted (see &apt-secure;).  Configuration Item: <literal>APT::Sources::With</literal>.
ja: これによって指定したソースは信頼できるものとして扱われる (&apt-secure; 参照) ことに注意してください。設定項目: <literal>APT::Sources::With</literal>

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-cache</command> returns zero on normal operation, decimal 100 on error.
ja: <command>apt-cache</command> は正常終了時に 0 を返します。エラー時には十進の 100 を返します。

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-key</command> is used to manage the list of keys used by apt to authenticate packages.  Packages which have been authenticated using these keys will be considered trusted.
ja: <command>apt-key</command> は、apt が パッケージを認証するのに使用するキーの一覧を管理するのに使用します。このキーで認証されたパッケージは、信頼するに足ると見なせるでしょう。

note: type: Content of: <refentry><refsect1><title>
en: Supported keyring files
ja: サポートするキーリングファイル

note: type: Content of: <refentry><refsect1><para>
en: apt-key supports only the binary OpenPGP format (also known as "GPG key public ring") in files with the "<literal>gpg</literal>" extension, not the keybox database format introduced in newer &gpg; versions as default for keyring files. Binary keyring files intended to be used with any apt version should therefore always be created with <command>gpg --export</command>.
ja: apt-key では拡張子「<literal>gpg</literal>」の付けられた OpenPGP のバイナリ形式 (いわゆる「GPG キー公開用リング」) を収録するファイルだけをサポートします。&gpg; のもっと新しいバージョンで導入されてキーリングファイルのデフォルトとなっているキーボックスのデータベース形式はサポートしません。そのため、バージョンを問わず apt で利用するためのバイナリキーリングファイルの作成には常に <command>gpg --export</command> を使ってください。

note: type: Content of: <refentry><refsect1><para>
en: Alternatively, if all systems which should be using the created keyring have at least apt version >= 1.4 installed, you can use the ASCII armored format with the "<literal>asc</literal>" extension instead which can be created with <command>gpg --armor --export</command>.
ja: また、作成したキーリングを利用するシステムにインストールされている apt のバージョンが全て 1.4 以降であれば、<command>gpg --armor --export</command> で作成する、拡張子に「<literal>asc</literal>」を付けられた保護付きアスキー形式を代わりに使うこともできます。

note: type: Content of: <refentry><refsect1><title>
en: Commands
ja: コマンド

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: (deprecated)
ja: (非推奨)

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Add a new key to the list of trusted keys.  The key is read from the filename given with the parameter &synopsis-param-filename; or if the filename is <literal>-</literal> from standard input.
ja: 信頼キーのリストに新しいキーを追加します。このキーを &synopsis-param-filename; パラメータに与えたファイル名から読み込みますが、ファイル名を <literal>-</literal> とすると、標準入力から読み込みます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: It is critical that keys added manually via <command>apt-key</command> are verified to belong to the owner of the repositories they claim to be for otherwise the &apt-secure; infrastructure is completely undermined.
ja: <command>apt-key</command> を使用して手動で追加されたキーは、リポジトリの所有者に所属していることが確認されていることが重要です。そうでなければ、&apt-secure; インフラが完全に損なわれます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <emphasis>Note</emphasis>: Instead of using this command a keyring should be placed directly in the <filename>/etc/apt/trusted.gpg.d/</filename> directory with a descriptive name and either "<literal>gpg</literal>" or "<literal>asc</literal>" as file extension.
ja: <emphasis>注意</emphasis>: このコマンドを使う代わりに、キーリングに記述的な名前 (ファイル名については &apt-conf; ファイルと同一の規則が適用されます) を付けて、ファイルの拡張子を「<literal>gpg</literal>」または「<literal>asc</literal>」として <filename>/etc/apt/trusted.gpg.d/</filename> ディレクトリに直接配置する方法もあります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Remove a key from the list of trusted keys.
ja: 信頼キー一覧からキーを削除します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Output the key &synopsis-param-keyid; to standard output.
ja: キー &synopsis-param-keyid; を標準出力に出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Output all trusted keys to standard output.
ja: 信頼するキーをすべて標準出力に出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: List trusted keys with fingerprints.
ja: 信頼キーとそのフィンガープリントを一覧表示します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Update the local keyring with the archive keyring and remove from the local keyring the archive keys which are no longer valid.  The archive keyring is shipped in the <literal>archive-keyring</literal> package of your distribution, e.g. the &keyring-package; package in &keyring-distro;.
ja: ローカルキーリングをアーカイブキーリングで更新し、もう有効でなくなったアーカイブキーをローカルキーリングから削除します。アーカイブキーリングは、使用中のディストリビューションにある <literal>archive-keyring</literal> パッケージ (例えば &keyring-distro; では &keyring-package; パッケージ) で提供されています。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Note that a distribution does not need to and in fact should not use this command any longer and instead ship keyring files in the <filename>/etc/apt/trusted.gpg.d/</filename> directory directly as this avoids a dependency on <package>gnupg</package> and it is easier to manage keys by simply adding and removing files for maintainers and users alike.
ja: ディストリビューションでこのコマンドを使う必要はなく、実のところもはやこれを使うのではなくキーリングファイルを <filename>/etc/apt/trusted.gpg</filename> ディレクトリに直接配置すべきであることに注意してください。それによって <package>gnupg</package> への依存を回避でき、鍵の管理は単純にファイルを追加、削除するだけになるため、メンテナにとってもユーザにとっても同様に容易になります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Perform an update working similarly to the <command>update</command> command above, but get the archive keyring from a URI instead and validate it against a master key.  This requires an installed &wget; and an APT build configured to have a server to fetch from and a master keyring to validate.  APT in Debian does not support this command, relying on <command>update</command> instead, but Ubuntu's APT does.
ja: 上記の <command>update</command> コマンドと同様に更新しますが、アーカイブキーリングを URI から取得し、マスターキーを用いて検証します。これには &wget; のインストールと、 APT のビルドに取得するサーバと検証するマスターキーリングが設定されていることが必要です。Debian での APT はこのコマンドをサポートしていません。代わりに <command>update</command> を使用してください。Ubuntu の APT では有効です。

note: type: Content of: <refentry><refsect1><title>
en: Options
ja: オプション

note: type: Content of: <refentry><refsect1><para>
en: Note that options need to be defined before the commands described in the previous section.
ja: 前節で説明したコマンドの前に、このオプションを定義する必要があることに注意してください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: With this option it is possible to specify a particular keyring file the command should operate on. The default is that a command is executed on the <filename>trusted.gpg</filename> file as well as on all parts in the <filename>trusted.gpg.d</filename> directory, though <filename>trusted.gpg</filename> is the primary keyring which means that e.g. new keys are added to this one.
ja: このオプションでは、コマンドが操作するべき特定のキーリングファイルを指定できます。デフォルトでは、<filename>trusted.gpg</filename> と <filename>trusted.gpg.d</filename> ディレクトリにあるすべてのファイルを用いて、コマンドが動作します。とはいえ、<filename>trusted.gpg</filename> がプライマリキーリングになります。つまり新しいキーはこのファイルに追加されます。

note: type: Content of: <refentry><refnamediv><refpurpose>
en: show, set and unset various settings for a package
ja: パッケージの各種設定の表示、設定、設定解除

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-mark</command> can be used as a unified front-end to set various settings for a package, such as marking a package as being automatically/manually installed or changing <command>dpkg</command> selections such as hold, install, deinstall and purge which are respected e.g. by <command>apt-get dselect-upgrade</command> or <command>aptitude</command>.
ja: 統合フロントエンドとして使用することができます。例えば、パッケージを自動/手動インストール済みとマークしたり、<command>dpkg</command> の選択を保留、インストール、削除や完全削除に変更できます。例えば <command>apt-get dselect-upgrade</command> や <command>aptitude</command> によりリスペクトされています。

note: type: Content of: <refentry><refsect1><title>
en: Automatically and Manually Installed Packages
ja: 自動および手動インストール済みパッケージ

note: type: Content of: <refentry><refsect1><para>
en: When you request that a package is installed, and as a result other packages are installed to satisfy its dependencies, the dependencies are marked as being automatically installed, while the package you installed explicitly is marked as manually installed.  Once an automatically installed package is no longer depended on by any manually installed package it is considered no longer needed and e.g. <command>apt-get</command> or <command>aptitude</command> will at least suggest removing them.
ja: パッケージをインストールすると要求し、その結果、別のパッケージが依存関係を満たすためにインストールされた場合、依存関係に自動インストール済みとマークされます。いったん自動的にインストールされたパッケージは、手動でインストールしたパッケージに依存されなくなると、そのパッケージは、例えば <command>apt-get</command> や <command>aptitude</command> により削除が提案されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>auto</literal> is used to mark a package as being automatically installed, which will cause the package to be removed when no more manually installed packages depend on this package.
ja: <literal>auto</literal> は、パッケージを自動インストール済みとマークします。このパッケージに依存する手動でインストールされたパッケージがなくなると、このパッケージを削除します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>manual</literal> is used to mark a package as being manually installed, which will prevent the package from being automatically removed if no other packages depend on it.
ja: <literal>manual</literal> は、パッケージを手動インストール済みとマークします。このパッケージに依存するほかのパッケージがなくなっても、このパッケージを自動的に削除するのを防ぎます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>showauto</literal> is used to print a list of automatically installed packages with each package on a new line.  All automatically installed packages will be listed if no package is given.  If packages are given only those which are automatically installed will be shown.
ja: <literal>showauto</literal> は、自動的にインストールされたパッケージを、パッケージごとに改行して表示します。パッケージを与えなければ、自動的にインストールされたパッケージをすべて一覧表示します。パッケージを与えた場合は、そのパッケージが自動的にインストールされている場合にのみ、表示します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>showmanual</literal> can be used in the same way as <literal>showauto</literal> except that it will print a list of manually installed packages instead.
ja: <literal>showmanual</literal> は <literal>showauto</literal> と同様に使用できますが、手動でインストールされたパッケージの一覧を表示します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Read/Write package stats from the filename given with the parameter &synopsis-param-filename; instead of from the default location, which is <filename>extended_states</filename> in the directory defined by the Configuration Item: <literal>Dir::State</literal>.
ja: デフォルトの場所 (設定項目: <literal>Dir::State</literal> で定義したディレクトリの <filename>extended_states</filename>) ではなく、パラメータ &synopsis-param-filename; からパッケージの状態を読み書きします。

note: type: Content of: <refentry><refsect1><title>
en: Prevent Changes for a Package
ja: パッケージの変更を防ぐ

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>hold</literal> is used to mark a package as held back, which will prevent the package from being automatically installed, upgraded or removed.
ja: <literal>hold</literal> は、パッケージを保留としてマークします。パッケージを自動的なインストール、アップグレード、削除から防ぎます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>unhold</literal> is used to cancel a previously set hold on a package to allow all actions again.
ja: <literal>unhold</literal> は、以前保留したパッケージを、また操作できるようキャンセルするのに使用します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>showhold</literal> is used to print a list of packages on hold in the same way as for the other show commands.
ja: <literal>showhold</literal> は、他の show コマンドと同様に、保留されているパッケージを出力します。

note: type: Content of: <refentry><refsect1><title>
en: Schedule Packages for Install, Remove and Purge
ja: パッケージのインストール、削除、完全削除をスケジュールする

note: type: Content of: <refentry><refsect1><para>
en: Some front-ends like <command>apt-get dselect-upgrade</command> can be used to apply previously scheduled changes to the install state of packages. Such changes can be scheduled with the <option>install</option>, <option>remove</option> (also known as <option>deinstall</option>) and <option>purge</option> commands.  Packages with a specific selection can be displayed with <option>showinstall</option>, <option>showremove</option> and <option>showpurge</option> respectively.  More information about these so called dpkg selections can be found in &dpkg;.
ja: <command>apt-get dselect-upgrade</command> のようないくつかのフロントエンドは、パッケージのインストール状態の事前のスケジュール変更を適用するために使用することができます。このような変更は、<option>install</option>、<option>remove</option> (<option>deinstall</option> としても知られています) および <option>purge</option> オプションでスケジュールすることができます。特定のパッケージの選択は、それぞれ <option>showinstall</option>、<option>showremove</option> および <option>showpurge</option> で表示することができます。dpkg 選択とも呼ぶこれらの詳細については、dpkg で見つけることができます。

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-mark</command> returns zero on normal operation, non-zero on error.
ja: <command>apt-mark</command> は正常終了時に 0 を返します。エラー時には 0 以外を返します。

note: type: Content of: <refentry><refnamediv><refpurpose>
en: Archive authentication support for APT
ja: APT アーカイブ認証サポート

note: type: Content of: <refentry><refsect1><para>
en: Note: All APT-based package management front-ends like &apt-get;, &aptitude; and &synaptic; support this authentication feature, so this manpage uses <literal>APT</literal> to refer to them all for simplicity only.
ja: 注意: &apt-get;、&aptitude;、&synaptic; といった APT ベースのパッケージ管理フロントエンドは全てこの新しい証明機能をサポートしています。この man ページでは単純化するためだけに、その全てを参照するのに <literal>APT</literal> を使っています。

note: type: Content of: <refentry><refsect1><para>
en: If an archive has an unsigned Release file or no Release file at all current APT versions will refuse to download data from them by default in <command>update</command> operations and even if forced to download front-ends like &apt-get; will require explicit confirmation if an installation request includes a package from such an unauthenticated archive.
ja: アーカイブに署名されていない Release ファイルがある、または Release ファイルが全くない場合は、現在の APT バージョンは <command>update</command> 操作によるそこからのダウンロードをデフォルトで拒否し、ダウンロードを強制した場合でも、インストール要求に証明されていないアーカイブからのパッケージが含まれる場合には <command>apt-get</command> のようなフロントエンドは明示的な確認を要求します。

note: type: Content of: <refentry><refsect1><para>
en: You can force all APT clients to raise only warnings by setting the configuration option <option>Acquire::AllowInsecureRepositories</option> to <literal>true</literal>. Individual repositories can also be allowed to be insecure via the &sources-list; option <literal>allow-insecure=yes</literal>.  Note that insecure repositories are strongly discouraged and all options to force apt to continue supporting them will eventually be removed.  Users also have the <option>Trusted</option> option available to disable even the warnings, but be sure to understand the implications as detailed in &sources-list;.
ja: 設定オプション <option>Acquire::AllowInsecureRepositories</option> に <literal>true</literal> を設定するとどの APT クライアントでも警告だけを出すように強制できます。&sources-list; オプション <literal>allow-insecure=yes</literal> を使うと個々のリポジトリについて安全でないことを許可するようにもできます。安全でないリポジトリは全く勧められるものではなく、apt にそのサポート継続を強制させるオプションは全て最終的には削除されることに注意してください。ユーザ側では警告についても無効化する <option>Trusted</option> オプションを利用することもできますが、&sources-list; で述べているように、その影響を必ず理解してください。

note: type: Content of: <refentry><refsect1><para>
en: A repository which previously was authenticated but would loose this state in an <command>update</command> operation raises an error in all APT clients irrespective of the option to allow or forbid usage of insecure repositories.  The error can be overcome by additionally setting <option>Acquire::AllowDowngradeToInsecureRepositories</option> to <literal>true</literal> or for Individual repositories with the &sources-list; option <literal>allow-downgrade-to-insecure=yes</literal>.
ja: 以前は証明されていたけれども <command>update</command> 操作の結果その効力がなくなったリポジトリについては、安全でないリポジトリの利用を許可あるいは禁止するオプションに関わらず、どの APT クライアントでもエラーを出します。追加で <option>Acquire::AllowDowngradeToInsecureRepositories</option> に <literal>true</literal> をセットするか &sources-list; のオプション <literal>allow-downgrade-to-insecure=yes</literal> を個々のリポジトリに設定することでこのエラーを無視させることもできます。

note: type: Content of: <refentry><refsect1><para>
en: The chain of trust from an APT archive to the end user is made up of several steps. <command>apt-secure</command> is the last step in this chain; trusting an archive does not mean that you trust its packages not to contain malicious code, but means that you trust the archive maintainer. It's the archive maintainer's responsibility to ensure that the archive's integrity is preserved.
ja: APT アーカイブからエンドユーザまでの信頼の輪は、いくつかのステップで構成されています。<command>apt-secure</command> は、この輪の最後のステップで、「アーカイブを信頼する」ということは、パッケージに悪意のあるコードが含まれていないことを信頼するということではなく、アーカイブメンテナを信頼するということを意味します。これは、アーカイブの完全性が保たれていることを保証するのは、アーカイブメンテナの責任だということです。

note: type: Content of: <refentry><refsect1><para>
en: apt-secure does not review signatures at a package level. If you require tools to do this you should look at <command>debsig-verify</command> and <command>debsign</command> (provided in the debsig-verify and devscripts packages respectively).
ja: apt-secure はパッケージレベルの署名検証は行いません。そのようなツールが必要な場合は、<command>debsig-verify</command> や <command>debsign</command> (debsig-verify パッケージと devscripts パッケージでそれぞれ提供されています) を確認してください。

note: type: Content of: <refentry><refsect1><para>
en: The chain of trust in Debian starts (e.g.) when a maintainer uploads a new package or a new version of a package to the Debian archive. In order to become effective, this upload needs to be signed by a key contained in one of the Debian package maintainer keyrings (available in the debian-keyring package). Maintainers' keys are signed by other maintainers following pre-established procedures to ensure the identity of the key holder. Similar procedures exist in all Debian-based distributions.
ja: Debian における信頼の輪は、(例えば) 新しいパッケージやパッケージの新バージョンを、メンテナが Debian アーカイブにアップロードすることから始まります。これが有効になるには、アップロードの際に、Debian メンテナキーリング (debian-keyring パッケージに収録) にあるメンテナのキーで署名する必要があります。メンテナのキーは、キーの所有者の ID を確保するため、事前に確立した手続きの後で、他のメンテナに署名されています。同様の手順は、すべての Debian ベースのディストリビューションに存在します。

note: type: Content of: <refentry><refsect1><para>
en: Once the uploaded package is verified and included in the archive, the maintainer signature is stripped off, and checksums of the package are computed and put in the Packages file. The checksums of all of the Packages files are then computed and put into the Release file. The Release file is then signed by the archive key for this &keyring-distro; release, and distributed alongside the packages and the Packages files on &keyring-distro; mirrors. The keys are in the &keyring-distro; archive keyring available in the &keyring-package; package.
ja: アップロードされたパッケージが検証されてアーカイブに格納されると、メンテナの署名を取り外し、パッケージのチェックサムを計算して、Packages ファイルに格納します。その後、全 Packages ファイルのチェックサムを計算して、Release ファイルに格納します。Release ファイルは、その &keyring-distro; リリースのアーカイブキーで署名され、&keyring-distro; ミラーサイトでパッケージや Packages ファイルとともに配布されます。このキーは、<package>debian-archive-keyring</package> パッケージに収録されている、&keyring-distro; アーカイブキーリングに含まれます。

note: type: Content of: <refentry><refsect1><para>
en: End users can check the signature of the Release file, extract a checksum of a package from it and compare it with the checksum of the package they downloaded by hand - or rely on APT doing this automatically.
ja: エンドユーザは誰でも、Release ファイルの署名をチェックし、パッケージのチェックサムを抽出して、手でダウンロードしたパッケージのチェックサムと比較できます。また、APT が自動的に行うのに任せることもできます。

note: type: Content of: <refentry><refsect1><para>
en: Notice that this is distinct from checking signatures on a per package basis. It is designed to prevent two possible attacks:
ja: 以上は、パッケージごとの署名チェックとは違うことに注意してください。以下のように考えられる 2 種類の攻撃を防ぐよう設計されています。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <literal>Network "man in the middle" attacks</literal>. Without signature checking, malicious agents can introduce themselves into the package download process and provide malicious software either by controlling a network element (router, switch, etc.) or by redirecting traffic to a rogue server (through ARP or DNS spoofing attacks).
ja: <literal>ネットワーク中間者攻撃</literal>。署名をチェックしないと、悪意あるエージェントがパッケージダウンロードプロセスに割り込んだり、ネットワーク構成要素 (ルータ、スイッチなど) の制御や、悪漢サーバへのネットワークトラフィックのリダイレクトなど (ARP スプーフィング攻撃や DNS スプーフィング攻撃) で、悪意あるソフトウェアを掴まされたりします。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <literal>Mirror network compromise</literal>.  Without signature checking, a malicious agent can compromise a mirror host and modify the files in it to propagate malicious software to all users downloading packages from that host.
ja: <literal>ミラーネットワーク感染</literal>。署名をチェックしないと、悪意あるエージェントがミラーホストに感染し、このホストからダウンロードしたユーザすべてに、悪意あるソフトウェアが伝播するようにファイルを変更できます。

note: type: Content of: <refentry><refsect1><para>
en: However, it does not defend against a compromise of the master server itself (which signs the packages) or against a compromise of the key used to sign the Release files. In any case, this mechanism can complement a per-package signature.
ja: しかしこれは、(パッケージに署名する) マスターサーバ自体の侵害や、Release ファイルに署名するのに使用したキーの漏洩を防げません。いずれにせよ、この機構はパッケージごとの署名を補完することができます。

note: type: Content of: <refentry><refsect1><title>
en: User Configuration
ja: ユーザ設定

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-key</command> is the program that manages the list of keys used by APT to trust repositories. It can be used to add or remove keys as well as list the trusted keys. Limiting which key(s) are able to sign which archive is possible via the <option>Signed-By</option> in &sources-list;.
ja: <command>apt-key</command> は、リポジトリを信頼するために APT が使用するキーリストを管理するプログラムです。信頼されたキーのリストにキーを追加または削除するために使用することができます。キーが署名することができるアーカイブは、&sources-list; 中の <option>Signed-By</option> を介して制限可能です。

note: type: Content of: <refentry><refsect1><para>
en: Note that a default installation already contains all keys to securely acquire packages from the default repositories, so fiddling with <command>apt-key</command> is only needed if third-party repositories are added.
ja: デフォルトのインストールでは、すでにデフォルトのリポジトリからセキュアにパッケージを取得するためにすべてのキーが含まれていることに注意してください。そのため、サードパーティのリポジトリを追加している場合は <command>apt-key</command> で操作する必要があります。

note: type: Content of: <refentry><refsect1><para>
en: In order to add a new key you need to first download it (you should make sure you are using a trusted communication channel when retrieving it), add it with <command>apt-key</command> and then run <command>apt-get update</command> so that apt can download and verify the <filename>InRelease</filename> or <filename>Release.gpg</filename> files from the archives you have configured.
ja: 新しいキーを追加するためには、まずキーをダウンロードする必要があります (取得する際には、信頼できる通信チャネルを使用するよう、特に留意してください)。取得したキーを、<command>apt-key</command> で追加し、<command>apt-get update</command> を実行してください。以上により、apt は設定済みのアーカイブから、<filename>InRelease</filename> ファイルや <filename>Release.gpg</filename> ファイルをダウンロード・検証できるようになります。

note: type: Content of: <refentry><refsect1><para>
en: If you want to provide archive signatures in an archive under your maintenance you have to:
ja: あなたがメンテナンスしているアーカイブで、アーカイブ署名を提供したい場合、以下のようにしてください。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <emphasis>Create a toplevel Release file</emphasis>, if it does not exist already. You can do this by running <command>apt-ftparchive release</command> (provided in apt-utils).
ja: 既に存在しているのでなければ、<emphasis>最上位 Release ファイルを作成してください</emphasis>。<command>apt-ftparchive release</command> (apt-utils で提供) を実行すると、作成できます。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <emphasis>Sign it</emphasis>. You can do this by running <command>gpg --clearsign -o InRelease Release</command> and <command>gpg -abs -o Release.gpg Release</command>.
ja: <emphasis>署名</emphasis>します。<command>gpg --clearsign -o InRelease Release</command> や <command>gpg -abs -o Release.gpg Release</command> を実行して、署名してください。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <emphasis>Publish the key fingerprint</emphasis>, so that your users will know what key they need to import in order to authenticate the files in the archive. It is best to ship your key in its own keyring package like &keyring-distro; does with &keyring-package; to be able to distribute updates and key transitions automatically later.
ja: <emphasis>キーのフィンガープリントを公開</emphasis>します。これにより、ユーザは、アーカイブ内のファイルを認証するためにインポートする必要があるキーを知るでしょう。これは、ディストリビューションのアップデートとキーの更新を後で自動的に行うことができる &keyring-package; を実行する &keyring-distro; のような独自のキーリングパッケージで鍵を公開するのが最善です。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <emphasis>Provide instructions on how to add your archive and key</emphasis>.  If your users can't acquire your key securely the chain of trust described above is broken.  How you can help users add your key depends on your archive and target audience ranging from having your keyring package included in another archive users already have configured (like the default repositories of their distribution) to leveraging the web of trust.
ja: <emphasis>アーカイブとキーを追加する方法について説明します</emphasis>。ユーザがセキュアにキーを取得できない場合は、上述の信頼の輪が壊れています。ユーザのキー追加を助けることができる方法は、アーカイブとすでに信頼のウェブを活用するように (ディストリビューションのデフォルトのリポジトリのように) 設定している別のアーカイブユーザに含まれたあなたのキーリングパッケージを持つまでは、アーカイブと対象者に依存します。

note: type: Content of: <refentry><refsect1><para>
en: Whenever the contents of the archive change (new packages are added or removed) the archive maintainer has to follow the first two steps outlined above.
ja: アーカイブの内容に変化がある場合 (新しいパッケージの追加や削除)、アーカイブメンテナは前述の最初の 2 ステップに従わなければなりません。

note: type: Content of: <refentry><refsect1><para>
en: For more background information you might want to review the <ulink url="https://www.debian.org/doc/manuals/securing-debian-howto/ch7">Debian Security Infrastructure</ulink> chapter of the Securing Debian Manual (also available in the harden-doc package) and the <ulink url="http://www.cryptnet.net/fdp/crypto/strong_distro.html" >Strong Distribution HOWTO</ulink> by V. Alex Brennen.
ja: 詳細な背景情報を検証するのなら、Securing Debian Manual (harden-doc パッケージにも収録) の <ulink url="http://www.debian.org/doc/manuals/securing-debian-howto/ch7">Debian Security Infrastructure</ulink> 章や、V. Alex Brennen による <ulink url="http://www.cryptnet.net/fdp/crypto/strong_distro.html" >Strong Distribution HOWTO</ulink> をご覧ください。

note: type: Content of: <refentry><refsect1><title>
en: Manpage Authors
ja: マニュアルページ作者

note: type: Content of: <refentry><refsect1><para>
en: This man-page is based on the work of Javier Fernández-Sanguino Peña, Isaac Jones, Colin Walters, Florian Weimer and Michael Vogt.
ja: このマニュアルページは Javier Fernández-Sanguino Peña, Isaac Jones, Colin Walters, Florian Weimer, Michael Vogt の作業を元にしています。

note: type: Content of: <refentry><refnamediv><refpurpose>
en: APT CD-ROM management utility
ja: APT CD-ROM 管理ユーティリティ

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-cdrom</command> is used to add a new CD-ROM to APT's list of available sources. <command>apt-cdrom</command> takes care of determining the structure of the disc as well as correcting for several possible mis-burns and verifying the index files.
ja: <command>apt-cdrom</command> は利用可能な取得元として、APT のリストに新しい CD-ROM を追加するのに使用します。<command>apt-cdrom</command> は、ディスクの構造を測定します。また、焼き損じを可能な限り補正し、インデックスファイルの確認を行います。

note: type: Content of: <refentry><refsect1><para>
en: It is necessary to use <command>apt-cdrom</command> to add CDs to the APT system; it cannot be done by hand. Furthermore each disc in a multi-CD set must be inserted and scanned separately to account for possible mis-burns.
ja: APT システムに手作業で CD を追加するのは難しいため、<command>apt-cdrom</command> が必要になります。その上、複数の CD のディスクを 1 枚づつ、焼き損じを補正できるか評価しなければなりません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>add</literal> is used to add a new disc to the source list. It will unmount the CD-ROM device, prompt for a disc to be inserted and then proceed to scan it and copy the index files. If the disc does not have a proper <filename>.disk</filename> directory you will be prompted for a descriptive title.
ja: <literal>add</literal> は、新しいディスクを取得元リストに追加します。CD-ROM デバイスのアンマウントやディスク挿入のプロンプト表示の後に、ディスクのスキャンとインデックスファイルのコピーを行います。ディスクに正しい <filename>.disk</filename> ディレクトリが存在しない場合、タイトルを入力するよう促します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: APT uses a CD-ROM ID to track which disc is currently in the drive and maintains a database of these IDs in <filename>&statedir;/cdroms.list</filename>
ja: APT は、現在ドライブにあるディスクのトラックから取得した、CD-ROM ID を使用します。またその ID を、<filename>&statedir;/cdroms.list</filename> 内のデータベースで管理します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: A debugging tool to report the identity of the current disc as well as the stored file name
ja: 格納されているファイル名と現在のディスクが同一かどうかをレポートする、デバッグツールです。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Do not try to auto-detect the CD-ROM path. Usually combined with the <option>--cdrom</option> option.  Configuration Item: <literal>Acquire::cdrom::AutoDetect</literal>.
ja: CD-ROM パスの自動検出を試行しません。通常、<option>--cdrom</option> オプションと組み合わせて使います。設定項目: <literal>Acquire::cdrom::AutoDetect</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Mount point; specify the location to mount the CD-ROM. This mount point must be listed in <filename>/etc/fstab</filename> and properly configured.  Configuration Item: <literal>Acquire::cdrom::mount</literal>.
ja: マウントポイント - CD-ROM をマウントする場所を指定します。このマウントポイントは、<filename>/etc/fstab</filename> に正しく設定されている必要があります。設定項目: <literal>Acquire::cdrom::mount</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Rename a disc; change the label of a disc or override the disc's given label. This option will cause <command>apt-cdrom</command> to prompt for a new label.  Configuration Item: <literal>APT::CDROM::Rename</literal>.
ja: ディスクの名前変更 - ディスクのラベル変更や、指定したラベルでのラベルの上書きを行います。このオプションにより、<command>apt-cdrom</command> が新しいラベルを入力するよう促します。設定項目: <literal>APT::CDROM::Rename</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: No mounting; prevent <command>apt-cdrom</command> from mounting and unmounting the mount point.  Configuration Item: <literal>APT::CDROM::NoMount</literal>.
ja: マウントなし - <command>apt-cdrom</command> が、マウントポイントにマウント・アンマウントしないようにします。設定項目: <literal>APT::CDROM::NoMount</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Fast Copy; Assume the package files are valid and do not check every package. This option should be used only if <command>apt-cdrom</command> has been run on this disc before and did not detect any errors.  Configuration Item: <literal>APT::CDROM::Fast</literal>.
ja: 高速コピー - パッケージファイルが妥当であると仮定し、チェックを全く行いません。このオプションは、このディスクで以前 <command>apt-cdrom</command> を行っており、エラーを検出しなかった場合のみ使用すべきです。設定項目: <literal>APT::CDROM::Fast</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Thorough Package Scan; This option may be needed with some old Debian 1.1/1.2 discs that have Package files in strange places. It takes much longer to scan the CD but will pick them all up.
ja: 完全パッケージスキャン - 古い Debian 1.1/1.2 のディスクは、パッケージファイルが違う場所にあるため、このオプションを使う必要があるかもしれません。CD をスキャンするのに非常に時間がかかりますが、全パッケージファイルを抽出することができます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: No Changes; Do not change the &sources-list; file and do not write index files. Everything is still checked however.  Configuration Item: <literal>APT::CDROM::NoAct</literal>.
ja: 変更なし - &sources-list; ファイルの変更や、インデックスファイルの書き込みを行いません。とはいえ、すべてのチェックは行います。設定項目: <literal>APT::CDROM::NoAct</literal>

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-cdrom</command> returns zero on normal operation, decimal 100 on error.
ja: <command>apt-cdrom</command> は正常終了時に 0 を返します。エラー時には十進の 100 を返します。

note: type: Content of: <refentry><refnamediv><refpurpose>
en: APT Configuration Query program
ja: APT 設定取得プログラム

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-config</command> is an internal program used by various portions of the APT suite to provide consistent configurability. It accesses the main configuration file <filename>/etc/apt/apt.conf</filename> in a manner that is easy to use for scripted applications.
ja: <command>apt-config</command> は、APT スイートの様々な所で一貫した設定を行うために使用する、内部プログラムです。スクリプトアプリケーションで使いやすい方法で、メイン設定ファイル <filename>/etc/apt/apt.conf</filename> にアクセスします。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: shell is used to access the configuration information from a shell script. It is given pairs of arguments, the first being a shell variable and the second the configuration value to query. As output it lists shell assignment commands for each value present.  In a shell script it should be used as follows:
ja: shell は、シェルスクリプトから設定情報にアクセスするのに使用します。引数として、まずシェル変数、次に取得したい設定値をペアで与えます。出力として、現在の値ごとのシェル代入コマンドを列挙します。シェルスクリプト内では、以下のようにしてください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This will set the shell environment variable $OPTS to the value of MyApp::options with a default of <option>-f</option>.
ja: これは、MyApp::options の値をシェル環境変数 $OPTS にセットします。デフォルト値は <option>-f</option> となります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The configuration item may be postfixed with a /[fdbi]. f returns file names, d returns directories, b returns true or false and i returns an integer. Each of the returns is normalized and verified internally.
ja: 設定項目は /[fdbi] を後ろに付けられます。f はファイル名を、d はディレクトリを、b は true か false を、i は整数を返します。返り値ごとに内部で正規化と検証を行います。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Just show the contents of the configuration space.
ja: 設定箇所の内容を表示するだけです。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Include options which have an empty value. This is the default, so use --no-empty to remove them from the output.
ja: 値が空のオプションを含めます。これはデフォルトですので、出力から取り除くには --no-empty としてください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Defines the output of each config option. &percnt;t will be replaced with its individual name, &percnt;f with its full hierarchical name and &percnt;v with its value.  Use uppercase letters and special characters in the value will be encoded to ensure that it can e.g. be safely used in a quoted-string as defined by RFC822. Additionally &percnt;n will be replaced by a newline, and &percnt;N by a tab. A &percnt; can be printed by using &percnt;&percnt;.
ja: 各設定オプションの出力を定義します。&percnt;t はオプション名に、&percnt;f は完全オプション名に、&percnt;v はオプションの値に置換されます。大文字や特殊文字を使用する値は、安全を保証するために、RFC822 で定義されている quoted-string でエンコードされることになります。さらに、&percnt;n は改行に、&percnt;N はタブ文字になります。&percnt; を出力するには、&percnt;&percnt; としてください。

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-config</command> returns zero on normal operation, decimal 100 on error.
ja: <command>apt-config</command> は正常終了時に 0 を返します。エラー時には十進の 100 を返します。

note: type: Content of: <refentry><refentryinfo><author><contrib>
en: Initial documentation of Debug::*.
ja: Debug::* に関する最初のドキュメント

note: type: Content of: <refentry><refnamediv><refpurpose>
en: Configuration file for APT
ja: APT の設定ファイル

note: type: Content of: <refentry><refsect1><para>
en: <filename>/etc/apt/apt.conf</filename> is the main configuration file shared by all the tools in the APT suite of tools, though it is by no means the only place options can be set. The suite also shares a common command line parser to provide a uniform environment.
ja: <filename>/etc/apt/apt.conf</filename> は、APT スイートの全ツールで使用するメイン設定ファイルです。しかし、間違いなくオプションを設定しておくだけの場所などではありません。そのため、APT スイートは統一環境を提供するため、共通のコマンドラインパーサを共有しています。

note: type: Content of: <refentry><refsect1><orderedlist><para>
en: When an APT tool starts up it will read the configuration files in the following order:
ja: APT ツールの起動時に、設定ファイルを以下の順番で読み込みます。

note: type: Content of: <refentry><refsect1><orderedlist><listitem><para>
en: the file specified by the <envar>APT_CONFIG</envar> environment variable (if any)
ja: <envar>APT_CONFIG</envar> 環境変数で指定したファイル (存在する場合)

note: type: Content of: <refentry><refsect1><orderedlist><listitem><para>
en: all files in <literal>Dir::Etc::Parts</literal> in alphanumeric ascending order which have either no or "<literal>conf</literal>" as filename extension and which only contain alphanumeric, hyphen (-), underscore (_) and period (.) characters.  Otherwise APT will print a notice that it has ignored a file, unless that file matches a pattern in the <literal>Dir::Ignore-Files-Silently</literal> configuration list - in which case it will be silently ignored.
ja: <literal>Dir::Etc::Parts</literal> にあるすべてのファイルを英数字の昇順になります。ファイル名には拡張子がないか、"<literal>conf</literal>" となっており、英数字、ハイフン (-)、アンダースコア (_)、ピリオド (.) で構成されています。そうでなければ、<literal>Dir::Ignore-Files-Silently</literal> 設定リストのパターンに一致するもの以外に対して、ファイルを無視するという注意を APT が出力します。一致する場合は黙って無視します。

note: type: Content of: <refentry><refsect1><orderedlist><listitem><para>
en: the main configuration file specified by <literal>Dir::Etc::main</literal>
ja: <literal>Dir::Etc::Main</literal> で指定される、メイン設定ファイル

note: type: Content of: <refentry><refsect1><orderedlist><listitem><para>
en: all options set in the binary specific configuration subtree are moved into the root of the tree.
ja: バイナリ固有の設定サブツリーに設定されたすべてのオプションは、ツリーのルートに移動されます。

note: type: Content of: <refentry><refsect1><orderedlist><listitem><para>
en: the command line options are applied to override the configuration directives or to load even more configuration files.
ja: コマンドラインオプションにより、設定ディレクティブの上書きや設定ファイルの追加読み込みができます。

note: type: Content of: <refentry><refsect1><title>
en: Syntax
ja: 構文

note: type: Content of: <refentry><refsect1><para>
en: The configuration file is organized in a tree with options organized into functional groups. Option specification is given with a double colon notation; for instance <literal>APT::Get::Assume-Yes</literal> is an option within the APT tool group, for the Get tool. Options do not inherit from their parent groups.
ja: 設定ファイルは、機能グループごとに系統立てられたオプションを木構造で表します。オプションの指定は、2 つのコロンで区切ります。例えば <literal>APT::Get::Assume-Yes</literal> は、APT ツールグループの Get ツール用オプションです。オプションは、親グループからは継承しません。

note: type: Content of: <refentry><refsect1><para>
en: with newlines placed to make it more readable. Lists can be created by opening a scope and including a single string enclosed in quotes followed by a semicolon. Multiple entries can be included, separated by a semicolon.
ja: また適宜改行することで、より読みやすくなります。リストは、開いたスコープ、クォートで囲まれた 1 単語、そしてセミコロンと続けることで作成できます。セミコロンで区切って、複数のエントリを表せます。

note: type: Content of: <refentry><refsect1><para>
en: In general the sample configuration file &configureindex; is a good guide for how it should look.
ja: &configureindex; は一般的な設定ファイルのサンプルです。どのように設定するか参考になるでしょう。

note: type: Content of: <refentry><refsect1><para>
en: Case is not significant in names of configuration items, so in the previous example you could use <literal>dpkg::pre-install-pkgs</literal>.
ja: 設定項目の名前にある文字の大小は、重要ではありません。そのため、前述の例を <literal>dpkg::pre-install-pkgs</literal> とすることもできます。

note: type: Content of: <refentry><refsect1><para>
en: Names for the configuration items are optional if a list is defined as can be seen in the <literal>DPkg::Pre-Install-Pkgs</literal> example above. If you don't specify a name a new entry will simply add a new option to the list. If you specify a name you can override the option in the same way as any other option by reassigning a new value to the option.
ja: 前述した <literal>DPkg::Pre-Install-Pkgs</literal> の例で見られるように、リストを定義した場合、設定項目名はオプションになります。名前を指定しない場合、新しいエントリは、単純に新しいオプションをリストに追加します。名前を指定して同様にすると、あらゆる他の選択肢をオプションに再割り当てし、オプションを上書きできます。

note: type: Content of: <refentry><refsect1><para>
en: Two special commands are defined: <literal>#include</literal> (which is deprecated and not supported by alternative implementations) and <literal>#clear</literal>. <literal>#include</literal> will include the given file, unless the filename ends in a slash, in which case the whole directory is included.  <literal>#clear</literal> is used to erase a part of the configuration tree. The specified element and all its descendants are erased.  (Note that these lines also need to end with a semicolon.)
ja: <literal>#include</literal> (これは廃止予定でサポートしない他の実装もあります) と <literal>#clear</literal> の 2 つの特別なコマンドがあります。<literal>#include</literal> は指定したファイルを取り込みます。ファイル名がスラッシュで終わった場合には、そのディレクトリをすべて取り込みます。<literal>#clear</literal> は、設定ツリーの一部を削除するのに使用します。指定した要素と、それ以下の要素を削除します (これらの行も、セミコロンで終わる必要があることに注意してください)。

note: type: Content of: <refentry><refsect1><para>
en: The <literal>#clear</literal> command is the only way to delete a list or a complete scope. Reopening a scope (or using the syntax described below with an appended <literal>::</literal>) will <emphasis>not</emphasis> override previously written entries. Options can only be overridden by addressing a new value to them - lists and scopes can't be overridden, only cleared.
ja: <literal>#clear</literal> コマンドは、リストや完全なスコープを削除する唯一の方法です。スコープの再オープン (や後述する <literal>::</literal> スタイル)は、それまで書いたエントリを<emphasis>上書きしません</emphasis>。オプションでは新しい値を与えて上書きするしかありませんが、リストやスコープは上書きできません。クリアされるだけです。

note: type: Content of: <refentry><refsect1><para>
en: All of the APT tools take an -o option which allows an arbitrary configuration directive to be specified on the command line. The syntax is a full option name (<literal>APT::Get::Assume-Yes</literal> for instance) followed by an equals sign then the new value of the option. To append a new element to a list, add a trailing <literal>::</literal> to the name of the list.  (As you might suspect, the scope syntax can't be used on the command line.)
ja: すべての APT ツールでは、コマンドラインで任意の設定ディレクティブを指定できる -o オプションが使用できます。構文は、完全なオプション名 (例: <literal>APT::Get::Assume-Yes</literal>) に続き等号、その後オプションの新しい値となります。リスト名に続き <literal>::</literal> を加えることで、リストを追加できます (疑問に思われたように、スコープ構文はコマンドラインで使用できません)。

note: type: Content of: <refentry><refsect1><para>
en: Note that appending items to a list using <literal>::</literal> only works for one item per line, and that you should not use it in combination with the scope syntax (which adds <literal>::</literal> implicitly). Using both syntaxes together will trigger a bug which some users unfortunately depend on: an option with the unusual name "<literal>::</literal>" which acts like every other option with a name. This introduces many problems; for one thing, users who write multiple lines in this <emphasis>wrong</emphasis> syntax in the hope of appending to a list will achieve the opposite, as only the last assignment for this option "<literal>::</literal>" will be used. Future versions of APT will raise errors and stop working if they encounter this misuse, so please correct such statements now while APT doesn't explicitly complain about them.
ja: <literal>::</literal> を用いたリストへの項目追加は、1 行で 1 項目の場合にのみ使用でき、スコープ構文と組み合わせるべきではないことに注意してください (スコープ構文には暗黙で <literal>::</literal> が追加されます)。両方の構文を同時に使用すると、「他のオプションと同様に名前と共に動作する、通常ではありえない名前 "<literal>::</literal>" のオプションである」といった、(残念なことに) 複数のユーザに渡るバグの引き金になります。たくさんの問題の中には、リストに追加しようと<emphasis>誤った</emphasis>構文で複数行書いたユーザが、このオプション "<literal>::</literal>" を最後に割り当てようとして、正反対の結果を得るということも含まれます。APT の次期バージョンでは、この誤用を検出すると、動作を停止しエラーを上げるようになります。そのため、APT がこの件で明白にエラーを吐かない限りは、自分でそのような構文を修正してください。

note: type: Content of: <refentry><refsect1><title>
en: The APT Group
ja: APT グループ

note: type: Content of: <refentry><refsect1><para>
en: This group of options controls general APT behavior as well as holding the options for all of the tools.
ja: このオプショングループは、ツール全体に影響のある、一般的な APT の振る舞いを制御します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: System Architecture; sets the architecture to use when fetching files and parsing package lists. The internal default is the architecture apt was compiled for.
ja: システムアーキテクチャ - ファイルを取得したり、パッケージリストを解析するときに使用するアーキテクチャをセットします。内部でのデフォルトは、apt をコンパイルしたアーキテクチャです。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: All Architectures the system supports. For instance, CPUs implementing the <literal>amd64</literal> (also called <literal>x86-64</literal>)  instruction set are also able to execute binaries compiled for the <literal>i386</literal> (<literal>x86</literal>) instruction set. This list is used when fetching files and parsing package lists. The initial default is always the system's native architecture (<literal>APT::Architecture</literal>), and foreign architectures are added to the default list when they are registered via <command>dpkg --add-architecture</command>.
ja: システムがサポートする、すべてのアーキテクチャです。例えば、<literal>amd64</literal> (<literal>x86-64</literal> とも呼ばれます) 命令セットを実装した CPU は、<literal>i386</literal> (<literal>x86</literal>) 命令セット用にコンパイルされたバイナリも実行できます。このリストは、ファイルを取得しパッケージリストを解析する際に利用されます。初期のデフォルト値は、常にシステムのネイティブアーキテクチャ (<literal>APT::Architecture</literal>) です。<command>dpkg --add-architecture</command> を用いて、外部アーキテクチャをデフォルトリストに追加します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This scope defines which compression formats are supported, how compression and decompression can be performed if support for this format isn't built into apt directly and a cost-value indicating how costly it is to compress something in this format. As an example the following configuration stanza would allow apt to download and uncompress as well as create and store files with the low-cost <literal>.reversed</literal> file extension which it will pass to the command <command>rev</command> without additional commandline parameters for compression and uncompression:
ja: この設定項目ではどの圧縮形式をサポートするのか、その形式のサポートが apt に直接組み込まれていない場合に圧縮と展開をどのように行えばいいのか、それとこの形式で何か圧縮するのにどれくらいコストがかかるのか、という値を定義します。1つの例として、以下の内容では拡張子が <literal>.reversed</literal> のコストの低いファイルについて、ファイルの作成と保存に加えてダウンロードと展開を apt に許可し、<command>rev</command> による圧縮と展開の際に渡すコマンドラインパラメータを追加しない設定となります:

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: List of all build profiles enabled for build-dependency resolution, without the "<literal>profile.</literal>" namespace prefix.  By default this list is empty. The <envar>DEB_BUILD_PROFILES</envar> as used by &dpkg-buildpackage; overrides the list notation.
ja: 構築依存の解決にあたって有効になっているビルドプロファイルを名前空間の「<literal>profile.</literal>」接頭辞を取り除いたもの全ての一覧です。デフォルトではこの一覧は空です。&dpkg-buildpackage; で利用される <envar>DEB_BUILD_PROFILES</envar> はこの一覧よりも優先されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Default release to install packages from if more than one version is available. Contains release name, codename or release version. Examples: 'stable', 'testing', 'unstable', '&debian-stable-codename;', '&debian-testing-codename;', '4.0', '5.0*'. See also &apt-preferences;.
ja: ひとつ以上のバージョンがある場合に、パッケージをインストールを行うデフォルトリリースです。リリース名や、コード名、リリースバージョンがあります。例えば 'stable', 'testing', 'unstable', '&debian-stable-codename;', '&debian-testing-codename;', '4.0', '5.0*'  となります。&apt-preferences; も参照してください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Ignore held packages; this global option causes the problem resolver to ignore held packages in its decision making.
ja: 保留パッケージの無視 - このグローバルオプションは、問題解決器に保留と指定したパッケージを無視します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Defaults to on. When turned on the autoclean feature will remove any packages which can no longer be downloaded from the cache. If turned off then packages that are locally installed are also excluded from cleaning - but note that APT provides no direct means to reinstall them.
ja: デフォルトで有効です。on の時、autoclean 機能は、ダウンロードできなくなったパッケージを、すべてキャッシュから削除します。off の場合、ローカルにインストールされているパッケージは、削除対象から外します。しかし、 APT はキャッシュから削除したパッケージの再インストール方法を、直接提供するわけではないことに注意してください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Defaults to on, which will cause APT to install essential and important packages as soon as possible in an install/upgrade operation, in order to limit the effect of a failing &dpkg; call. If this option is disabled, APT treats an important package in the same way as an extra package: between the unpacking of the package A and its configuration there can be many other unpack or configuration calls for other unrelated packages B, C etc. If these cause the &dpkg; call to fail (e.g. because package B's maintainer scripts generate an error), this results in a system state in which package A is unpacked but unconfigured - so any package depending on A is now no longer guaranteed to work, as its dependency on A is no longer satisfied.
ja: デフォルトは on です。&dpkg; の呼び出し失敗の影響を最小限にするため、インストール・更新操作の中で、APT は不可欠パッケージや重要パッケージを、可能な限り早くインストールするようになります。このオプションを無効にすると、以下のように、重要パッケージを特別パッケージと同様に扱うようになります。パッケージ A の展開とその設定の間に、パッケージ B や C などの関係ない、たくさんの他のパッケージの展開と設定が行えます。&dpkg; の呼び出しに失敗した場合 (例: パッケージ B のメンテナスクリプトでエラー発生)、システムの状態は、パッケージ A は展開したが未設定になります。そのため、A に依存したパッケージの動作が保証されなくなり、A への依存関係は、もう満たせません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The immediate configuration marker is also applied in the potentially problematic case of circular dependencies, since a dependency with the immediate flag is equivalent to a Pre-Dependency. In theory this allows APT to recognise a situation in which it is unable to perform immediate configuration, abort, and suggest to the user that the option should be temporarily deactivated in order to allow the operation to proceed.  Note the use of the word "theory" here; in the real world this problem has rarely been encountered, in non-stable distribution versions, and was caused by wrong dependencies of the package in question or by a system in an already broken state; so you should not blindly disable this option, as the scenario mentioned above is not the only problem it can help to prevent in the first place.
ja: 即時 (immediate) フラグは事前依存関係と等価なため、即時設定マーカも潜在的に、循環依存関係の問題に対して適用されます。理論上 APT は、即時設定不能と認識し、中断し、操作を継続するためにこのオプションを一時的に無効にするよう提案できます。ここで言う「理論上」という言葉に注意してください。現実世界では、安定版ではないバージョンでも、この問題にはほとんど遭遇していませんし、問題のパッケージの依存関係が誤っているか、システムの状態がすでに破損している場合に発生していました。そのため、盲目的にこのオプションを無効にするべきではありません。前述のシナリオを解決する方法の、1つにしかすぎないのです。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Before a big operation like <literal>dist-upgrade</literal> is run with this option disabled you should try to explicitly <literal>install</literal> the package APT is unable to configure immediately; but please make sure you also report your problem to your distribution and to the APT team with the bug link below, so they can work on improving or correcting the upgrade process.
ja: このオプションを無効にして <literal>dist-upgrade</literal> のような大きな操作を実行する前に、パッケージに <literal>install</literal> を明示して、即時設定が行われないようにするべきです。ですが、動作の改善とアップグレードプロセスの修正のため、以下のバグリンクから、問題をディストリビューションと APT チームにも報告していただきたいです。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Never enable this option unless you <emphasis>really</emphasis> know what you are doing. It permits APT to temporarily remove an essential package to break a Conflicts/Conflicts or Conflicts/Pre-Depends loop between two essential packages. <emphasis>Such a loop should never exist and is a grave bug</emphasis>. This option will work if the essential packages are not <command>tar</command>, <command>gzip</command>, <command>libc</command>, <command>dpkg</command>, <command>dash</command> or anything that those packages depend on.
ja: 何をしようとしているのか<emphasis>本当に</emphasis>判っているのでなければ、絶対にこのオプションを有効にしないでください。不可欠 (essential) パッケージ同士で、競合 (Conflicts) /競合や競合/事前依存 (Pre-Depend) のループに落ち込んだときに、不可欠パッケージを一時的に削除してループを抜けられるようにします。<emphasis>そんなループはあり得ないはずで、あるとすれば重大なバグです。</emphasis>このオプションは、<command>tar</command>, <command>gzip</command>, <command>libc</command>, <command>dpkg</command>, <command>dash</command> とそれらが依存しているパッケージ以外の不可欠パッケージで動作します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: APT uses since version 0.7.26 a resizable memory mapped cache file to store the available information. <literal>Cache-Start</literal> acts as a hint of the size the cache will grow to, and is therefore the amount of memory APT will request at startup. The default value is 20971520 bytes (~20 MB). Note that this amount of space needs to be available for APT; otherwise it will likely fail ungracefully, so for memory restricted devices this value should be lowered while on systems with a lot of configured sources it should be increased.  <literal>Cache-Grow</literal> defines in bytes with the default of 1048576 (~1 MB) how much the cache size will be increased in the event the space defined by <literal>Cache-Start</literal> is not enough. This value will be applied again and again until either the cache is big enough to store all information or the size of the cache reaches the <literal>Cache-Limit</literal>.  The default of <literal>Cache-Limit</literal> is 0 which stands for no limit.  If <literal>Cache-Grow</literal> is set to 0 the automatic growth of the cache is disabled.
ja: APT は、バージョン 0.7.26 から、利用できる情報を格納するため、サイズ可変なメモリマップキャッシュファイルを使用します。<literal>Cache-Start</literal> は、キャッシュサイズが増大していくヒントとして動作し、従って APT が起動時に要求するメモリ量です。デフォルト値は、20971520 バイト (~20 MB) です。この領域の量が、APT に利用可能になっている必要があることに注意してください。そうでなければ、無様に失敗することになります。そのため、メモリに制限のあるデバイスで、たくさんのソースが設定され、それが増加していくシステムでは、この値をより低くしておくべきです。<literal>Cache-Grow</literal> は、<literal>Cache-Start</literal> が足りなくなったという領域定義イベントにより、どの程度キャッシュサイズを増加させるかを、バイト数で定義します。デフォルトは 1048576 (~1 MB) です。この値は全情報を格納できる量になるか、<literal>Cache-Limit</literal> に達するまで、繰り返し適用されます。<literal>Cache-Limit</literal> のデフォルトは 0 で、無制限です。<literal>Cache-Grow</literal> に 0 をセットすると、キャッシュの自動増加を無効にします。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Defines which packages are considered essential build dependencies.
ja: 構築依存関係で不可欠なパッケージを定義します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The Get subsection controls the &apt-get; tool; please see its documentation for more information about the options here.
ja: Get サブセクションは &apt-get; ツールを制御します。このオプションの詳細は &apt-get; の文書を参照してください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The Cache subsection controls the &apt-cache; tool; please see its documentation for more information about the options here.
ja: Cache サブセクションは &apt-cache; ツールを制御します。このオプションの詳細は &apt-cache; の文書を参照してください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The CDROM subsection controls the &apt-cdrom; tool; please see its documentation for more information about the options here.
ja: CDROM サブセクションは &apt-cdrom; ツールを制御します。このオプションの詳細は &apt-cdrom; の文書を参照してください。

note: type: Content of: <refentry><refsect1><title>
en: The Acquire Group
ja: Acquire グループ

note: type: Content of: <refentry><refsect1><para>
en: The <literal>Acquire</literal> group of options controls the download of packages as well as the various "acquire methods" responsible for the download itself (see also &sources-list;).
ja: オプションの <literal>Acquire</literal> グループは、パッケージのダウンロードやダウンロードに関して責任を持つ、様々な「取得 (acquire) 方法」 を制御します (&sources-list; も参照)。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Security related option defaulting to true, as giving a Release file's validation an expiration date prevents replay attacks over a long timescale, and can also for example help users to identify mirrors that are no longer updated - but the feature depends on the correctness of the clock on the user system. Archive maintainers are encouraged to create Release files with the <literal>Valid-Until</literal> header, but if they don't or a stricter value is desired the <literal>Max-ValidTime</literal> option below can be used.  The <option>Check-Valid-Until</option> option of &sources-list; entries should be preferred to disable the check selectively instead of using this global override.
ja: セキュリティ関連のオプションで、デフォルトは true です。Release ファイルの有効期限検証により、長期間のリプレイ攻撃を防ぎます。さらに、例えばユーザが、もう更新されないミラーサイトを識別するのを支援します。しかしこの機能は、ユーザのシステム時計が正確であることに依存しています。アーカイブメンテナは、<literal>Valid-Until</literal> ヘッダがある Release ファイルを作成するよう推奨されていますが、このヘッダを付与しない、またはより厳密な値が必要な場合、以下の <literal>Max-ValidTime</literal> オプションを使用できます。&sources-list; エントリの <option>Check-Valid-Until</option> オプションは、グローバルオーバーライドを使う代わりに選択的にチェックを無効にすることが好ましいです。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Maximum time (in seconds) after its creation (as indicated by the <literal>Date</literal> header) that the <filename>Release</filename> file should be considered valid.  If the Release file itself includes a <literal>Valid-Until</literal> header the earlier date of the two is used as the expiration date.  The default value is <literal>0</literal> which stands for "valid forever".  Archive specific settings can be made by appending the label of the archive to the option name. Preferably, the same can be achieved for specific &sources-list; entries by using the <option>Valid-Until-Max</option> option there.
ja: <filename>Release</filename> ファイルを作成してから (<literal>Date</literal> ヘッダ)、有効であるとみなせる最大時間 (秒数) です。Release ファイル自体に <literal>Valid-Until</literal> ヘッダがある場合、その 2 つのうち、より早い日付が有効期間として使用されます。デフォルト値は <literal>0</literal> で「無期限」を表します。オプション名にアーカイブのラベルを付与することで、アーカイブ固有の設定を作成できます。または、<option>Valid-Until-Max</option> オプションを使用して特定の &sources-list; エントリで同じことを達成できます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Minimum time (in seconds) after its creation (as indicated by the <literal>Date</literal> header) that the <filename>Release</filename> file should be considered valid.  Use this if you need to use a seldom updated (local) mirror of a more frequently updated archive with a <literal>Valid-Until</literal> header instead of completely disabling the expiration date checking.  Archive specific settings can and should be used by appending the label of the archive to the option name. Preferably, the same can be achieved for specific &sources-list; entries by using the <option>Valid-Until-Min</option> option there.
ja: <filename>Release</filename> ファイルを作成してから (<literal>Date</literal> ヘッダ)、有効であるとみなせる最小時間 (秒数) です。<literal>Valid-Until</literal> がある頻繁に更新されるアーカイブの、ほとんど更新されない (ローカル) ミラーを使用する場合に、完全に有効期限チェックを無効にする代わりに使用してください。オプション名にアーカイブのラベルを付与することで、アーカイブ固有の設定を作成できます。または、<option>Valid-Until-Min</option> オプションを使用して特定の &sources-list; エントリで同じことを達成できます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Try to download deltas called <literal>PDiffs</literal> for indexes (like <filename>Packages</filename> files) instead of downloading whole ones. True by default. Preferably, this can be set for specific &sources-list; entries or index files by using the <option>PDiffs</option> option there.
ja: (<filename>Packages</filename> のような) インデックス全体をダウンロードするのではなく、<literal>PDiffs</literal> と呼ばれる差分をダウンロードしようとします。デフォルトでは True です。または、<option>PDiffs</option> オプションを使用して特定の &sources-list; エントリまたはインデックスファイルでこれを設定できます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Two sub-options to limit the use of PDiffs are also available: <literal>FileLimit</literal> can be used to specify a maximum number of PDiff files should be downloaded to update a file. <literal>SizeLimit</literal> on the other hand is the maximum percentage of the size of all patches compared to the size of the targeted file. If one of these limits is exceeded the complete file is downloaded instead of the patches.
ja: PDiffs の使用を制限するふたつのサブオプションがあります。<literal>FileLimit</literal> では、ファイルを更新するのに、PDiff ファイルをダウンロードできる最大数を指定します。一方、<literal>SizeLimit</literal> は、対象ファイルのサイズに対して、全パッチサイズの最大パーセンテージを指定します。どちらの制限を超えても、パッチをダウンロードする代わりに、完全なファイルをダウンロードします。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Try to download indexes via an URI constructed from a hashsum of the expected file rather than downloaded via a well-known stable filename. True by default, but automatically disabled if the source indicates no support for it. Usage can be forced with the special value "force". Preferably, this can be set for specific &sources-list; entries or index files by using the <option>By-Hash</option> option there.
ja: (<filename>Packages</filename> のような) インデックス全体をダウンロードするのではなく、<literal>PDiffs</literal> と呼ばれる差分をダウンロードしようとします。デフォルトでは True です。または、<option>By-Hash</option> オプションを使用して特定の &sources-list; エントリまたはインデックスファイルでこれを設定できます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Queuing mode; <literal>Queue-Mode</literal> can be one of <literal>host</literal> or <literal>access</literal> which determines how APT parallelizes outgoing connections. <literal>host</literal> means that one connection per target host will be opened, <literal>access</literal> means that one connection per URI type will be opened.
ja: キューモード - <literal>Queue-Mode</literal> は、APT がどのように並列接続を行うか、<literal>host</literal> か <literal>access</literal> で指定できます。<literal>host</literal> は、ターゲットホストごとに 1 接続を開きます。<literal>access</literal> は、URI タイプごとに 1 接続を開きます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Number of retries to perform. If this is non-zero APT will retry failed files the given number of times.
ja: リトライの回数を設定します。0 でない場合、APT は失敗したファイルに対して、与えられた回数だけリトライを行います。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Use symlinks for source archives. If set to true then source archives will be symlinked when possible instead of copying. True is the default.
ja: ソースアーカイブのシンボリックリンクを使用します。true がセットされているとき、可能ならコピーの代わりにシンボリックリンクを張ります。true がデフォルトです。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>ftp::Proxy</literal> sets the default proxy to use for FTP URIs.  It is in the standard form of <literal>ftp://[[user][:pass]@]host[:port]/</literal>.  Per host proxies can also be specified by using the form <literal>ftp::Proxy::&lt;host&gt;</literal> with the special keyword <literal>DIRECT</literal> meaning to use no proxies. If no one of the above settings is specified, <envar>ftp_proxy</envar> environment variable will be used. To use an FTP proxy you will have to set the <literal>ftp::ProxyLogin</literal> script in the configuration file. This entry specifies the commands to send to tell the proxy server what to connect to. Please see &configureindex; for an example of how to do this. The substitution variables representing the corresponding URI component are <literal>$(PROXY_USER)</literal>, <literal>$(PROXY_PASS)</literal>, <literal>$(SITE_USER)</literal>, <literal>$(SITE_PASS)</literal>, <literal>$(SITE)</literal> and <literal>$(SITE_PORT)</literal>.
ja: <literal>ftp::Proxy</literal> は、FTP URI を使用する際のデフォルトプロキシを設定します。<literal>ftp://[[user][:pass]@]host[:port]/</literal> という標準形で表します。ホストごとのプロキシを、<literal>ftp::Proxy::&lt;host&gt;</literal> という形で指定できます。この時、プロキシを使用しないという意味の特殊キーワード <literal>DIRECT</literal> も使用できます。上記の設定をなにも指定しないと、環境変数 <envar>ftp_proxy</envar> を使用します。FTP プロキシを使用するには、設定ファイルに <literal>ftp::ProxyLogin</literal> スクリプトを設定する必要があります。このエントリには、接続する際にプロキシサーバに送信するコマンドを設定します。どのようにするのかは &configureindex; の例を参照してください。URI を構成するコンポーネントに対応する置換変数は、<literal>$(PROXY_USER)</literal>, <literal>$(PROXY_PASS)</literal>, <literal>$(SITE_USER)</literal>, <literal>$(SITE_PASS)</literal>, <literal>$(SITE)</literal>, <literal>$(SITE_PORT)</literal> です。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The option <literal>timeout</literal> sets the timeout timer used by the method; this value applies to the connection as well as the data timeout.
ja: <literal>timeout</literal> オプションは、この方法でのタイムアウトまでの時間を設定します。これには、接続のタイムアウトとデータのタイムアウトが含まれています。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Several settings are provided to control passive mode. Generally it is safe to leave passive mode on; it works in nearly every environment.  However, some situations require that passive mode be disabled and port mode FTP used instead. This can be done globally or for connections that go through a proxy or for a specific host (see the sample config file for examples).
ja: 設定のいくつかは、パッシブモードを制御するものです。一般的に、パッシブモードのままにしておく方が安全で、ほぼどんな環境でも動作します。しかしある状況下では、パッシブモードが無効のため、代わりにポートモード FTP を使用する必要があります。この設定は、プロキシを通る接続や特定のホストへの接続全般に有効です (設定例はサンプル設定ファイルを参照してください)。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: It is possible to proxy FTP over HTTP by setting the <envar>ftp_proxy</envar> environment variable to an HTTP URL - see the discussion of the http method above for syntax. You cannot set this in the configuration file and it is not recommended to use FTP over HTTP due to its low efficiency.
ja: 環境変数 <envar>ftp_proxy</envar> に HTTP URL を指定すると FTP over HTTP のプロキシが利用可能になります。構文は前述の http についての説明を参照してください。設定ファイルの中でこれをセットすることはできません。また、効率が悪いため FTP over HTTP を使用するのは推奨しません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The setting <literal>ForceExtended</literal> controls the use of RFC2428 <literal>EPSV</literal> and <literal>EPRT</literal> commands. The default is false, which means these commands are only used if the control connection is IPv6. Setting this to true forces their use even on IPv4 connections. Note that most FTP servers do not support RFC2428.
ja: <literal>ForceExtended</literal> の設定は RFC2428 の <literal>EPSV</literal> コマンドと <literal>EPRT</literal> コマンドの使用を制御します。デフォルトでは false で、コントロールコネクションが IPv6 の時にのみ、このコマンドを使用するということです。これを true にセットすると、IPv4 コネクションでも、強制的にこのコマンドを使用します。ほとんどの FTP サーバは RFC2428 をサポートしていないことに注意してください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: For URIs using the <literal>cdrom</literal> method, the only configurable option is the mount point, <literal>cdrom::Mount</literal>, which must be the mount point for the CD-ROM (or DVD, or whatever) drive as specified in <filename>/etc/fstab</filename>. It is possible to provide alternate mount and unmount commands if your mount point cannot be listed in the fstab.  The syntax is to put <placeholder type="literallayout" id="0"/> within the <literal>cdrom</literal> block. It is important to have the trailing slash.  Unmount commands can be specified using UMount.
ja: <literal>cdrom</literal> メソッドを利用する URI では、設定できるオプションはマウントポイントだけです。<filename>/etc/fstab</filename> で設定されているように、CD-ROM (または DVD など) ドライブのマウントポイントを <literal>cdrom::Mount</literal> に設定しなければなりません。マウントポイントが fstab に記述できない場合、かわりにマウント・アンマウントコマンドも使用できます。構文は、<literal>cdrom</literal> ブロックを <placeholder type="literallayout" id="0"/> の形で記述します。スラッシュを後につけるのが重要です。アンマウントコマンドは UMount で指定することができます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: For GPGV URIs the only configurable option is <literal>gpgv::Options</literal>, which passes additional parameters to gpgv.
ja: GPGV URI 用の唯一のオプションは、gpgv に渡す追加パラメータのオプションである、<literal>gpgv::Options</literal> です。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: List of compression types which are understood by the acquire methods.  Files like <filename>Packages</filename> can be available in various compression formats.  By default the acquire methods can decompress and recompress many common formats like <command>xz</command> and <command>gzip</command>; with this scope the supported formats can be queried, modified as well as support for more formats added (see also <option>APT::Compressor</option>). The syntax for this is: <placeholder type="synopsis" id="0"/>
ja: acquire メソッドが理解できる、圧縮法のリストです。<filename>Packages</filename> のようなファイルにはさまざまな圧縮形式が利用できます。デフォルトで acquire メソッドは、<command>xz</command> や <command>gzip</command> 等の一般的な多くの圧縮形式で展開、再圧縮できます。この設定項目ではサポートする圧縮形式を参照、変更でき、サポートする圧縮形式をさらに追加することもできます (関連項目 <option>APT::Compressor</option>)。<placeholder type="synopsis" id="0"/>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Also, the <literal>Order</literal> subgroup can be used to define in which order the acquire system will try to download the compressed files. The acquire system will try the first and proceed with the next compression type in this list on error, so to prefer one over the other type simply add the preferred type first - types not already added will be implicitly appended to the end of the list, so e.g. <placeholder type="synopsis" id="0"/> can be used to prefer <command>gzip</command> compressed files over all other compression formats.  If <command>xz</command> should be preferred over <command>gzip</command> and <command>bzip2</command> the configure setting should look like this: <placeholder type="synopsis" id="1"/> It is not needed to add <literal>bz2</literal> to the list explicitly as it will be added automatically.
ja: また、<literal>Order</literal> サブグループを使用して、取得システムが、圧縮ファイルのダウンロードを試みる順番を定義できます。取得システムは先頭のものを試行し、エラーが発生すると次の圧縮タイプのダウンロードを開始します。そのため、どれかを他のものより優先したい場合、単にそのタイプを先頭に追加してください。まだ追加していないタイプは、リストの最後に追加されます。つまり、<placeholder type="synopsis" id="0"/> とすると、<command>gzip</command> で圧縮されたファイルを他のどれよりも優先的に使用します。もし <command>xz</command> を <command>gzip</command> や <command>bzip2</command> よりも優先するべきなら、設定を以下のようにしてください。<placeholder type="synopsis" id="1"/> <literal>bz2</literal> は自動的に追加されるため、明示する必要はありません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Note that the <literal>Dir::Bin::<replaceable>Methodname</replaceable></literal> will be checked at run time. If this option has been set and support for this format isn't directly built into apt, the method will only be used if this file exists; e.g. for the <literal>bzip2</literal> method (the inbuilt) setting is: <placeholder type="literallayout" id="0"/> Note also that list entries specified on the command line will be added at the end of the list specified in the configuration files, but before the default entries. To prefer a type in this case over the ones specified in the configuration files you can set the option direct - not in list style.  This will not override the defined list; it will only prefix the list with this type.
ja: 実行時に <literal>Dir::Bin::<replaceable>Methodname</replaceable></literal> をチェックすることに注意してください。このオプションが設定されていてその形式のサポートが apt に直接組み込まれていない場合、ファイルがある場合に、この方法しか使われなくなります。例えば、bzip2 メソッド (内蔵) の設定は以下になります。<placeholder type="literallayout" id="0"/> また、コマンドラインに指定した一覧のエントリは設定ファイルに指定したものの後、デフォルトエントリの前に追加されることに注意してください。この場合、設定ファイルに指定した内容よりも前に指定するには、オプションを直接 (一覧スタイルでなく) 指定してください。これは定義されている一覧を上書きするのではなく、このタイプを先頭に付加するだけです。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The special type <literal>uncompressed</literal> can be used to give uncompressed files a preference, but note that most archives don't provide uncompressed files so this is mostly only usable for local mirrors.
ja: 特殊なタイプ <literal>uncompressed</literal> は、非圧縮ファイルを優先するために使用できますが、ほとんどのアーカイブは非圧縮ファイルを提供しないため、ほとんどローカルミラーでのみ有効になることに注意してください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: When downloading <literal>gzip</literal> compressed indexes (Packages, Sources, or Translations), keep them gzip compressed locally instead of unpacking them. This saves quite a lot of disk space at the expense of more CPU requirements when building the local package caches. False by default.
ja: <literal>gzip</literal> 圧縮インデックス (Packages, Sources, Translations) をダウンロードする際、ローカルで展開せずに、gzip で圧縮したままにします。これにより、かなりディスク領域を節約できますが、ローカルパッケージキャッシュを構築する際に、CPU の能力を余計に消費します。デフォルトでは false です。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The Languages subsection controls which <filename>Translation</filename> files are downloaded and in which order APT tries to display the description-translations. APT will try to display the first available description in the language which is listed first. Languages can be defined with their short or long language codes. Note that not all archives provide <filename>Translation</filename> files for every language - the long language codes are especially rare.
ja: Languages サブセクションは、<filename>Translation</filename> ファイルをダウンロードし、APT が説明の翻訳を表示しようとする場合の挙動を制御します。APT はリストの先頭にある言語で、まず有効な説明を表示しようとします。Languages は 短い形式や長い形式の言語コードで、定義できます。すべてのアーカイブが、全言語の <filename>Translation</filename> ファイルを、提供しているわけではないことに注意してください。長い言語コードは特に見かけません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The default list includes "environment" and "en". "<literal>environment</literal>" has a special meaning here: it will be replaced at runtime with the language codes extracted from the <literal>LC_MESSAGES</literal> environment variable.  It will also ensure that these codes are not included twice in the list. If <literal>LC_MESSAGES</literal> is set to "C" only the <filename>Translation-en</filename> file (if available) will be used.  To force APT to use no Translation file use the setting <literal>Acquire::Languages=none</literal>. "<literal>none</literal>" is another special meaning code which will stop the search for a suitable <filename>Translation</filename> file.  This tells APT to download these translations too, without actually using them unless the environment specifies the languages. So the following example configuration will result in the order "en, de" in an English locale or "de, en" in a German one. Note that "fr" is downloaded, but not used unless APT is used in a French locale (where the order would be "fr, de, en").  <placeholder type="programlisting" id="0"/>
ja: デフォルトのリストには "environment" と "en" があります。"<literal>environment</literal>" はここでは特殊な意味があります。これは実行時に、<literal>LC_MESSAGES</literal> 環境変数から取得した言語コードに置換されます。また、このリストには、同じコードが2度現れないように確認してください。<literal>LC_MESSAGES</literal> が "C" に設定されているだけの場合、<filename>Translation-en</filename> ファイルを (利用可能であれば) 使用します。強制的に APT が Translation ファイルを使用しないようにするには、<literal>Acquire::Languages=none</literal> と設定してください。"<literal>none</literal>" はもうひとつの特殊な意味を持つコードで、適切な <filename>Translation</filename> ファイルの検索を中止します。環境から実際の言語を指定されなかった場合、この値を用いて APT に翻訳をダウンロードさせます。そのため、以下の設定例では、英語ロケールの場合 "en, de" の順になり、ドイツ語ロケールの場合 "de, en" の順になります。"fr" はダウンロードされますが、フランス語ロケール ("fr, de, en" の順になる) でないと、APT が使用しないことに注意してください。<placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Note: To prevent problems resulting from APT being executed in different environments (e.g. by different users or by other programs) all Translation files which are found in <filename>/var/lib/apt/lists/</filename> will be added to the end of the list (after an implicit "<literal>none</literal>").
ja: 注意: 異なる環境 (例: 異なるユーザや他のプログラム) で APT を実行したことによる問題を防ぐため、<filename>/var/lib/apt/lists/</filename> にあるすべての Translation ファイルを、リストの最後 (暗黙の "<literal>none</literal>" の後) に追加します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: When downloading, force to use only the IPv4 protocol.
ja: ダウンロード時に IPv4 プロトコルだけを使うように強制します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: When downloading, force to use only the IPv6 protocol.
ja: ダウンロード時に IPv6 プロトコルだけを使うように強制します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The maximum file size of Release/Release.gpg/InRelease files.  The default is 10MB.
ja: Release/Release.gpg/InRelease ファイルの最大ファイルサイズです。デフォルトは 10MB です。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This option controls if apt will use the DNS SRV server record as specified in RFC 2782 to select an alternative server to connect to.  The default is "true".
ja: apt が 接続するための代替サーバを選択するために RFC 2782 で指定された DRS SRV サーバレコードを使う場合は、このオプションを制御します。デフォルトは "true" です。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Allow update operations to load data files from repositories without sufficient security information.  The default value is "<literal>false</literal>".  Concept, implications as well as alternatives are detailed in &apt-secure;.
ja: 十分なセキュリティ情報を提供していないリポジトリからのデータファイル読み込みを行う更新操作を許可します。デフォルトは「<literal>false</literal>」です。概念や影響、代替手段については &apt-secure; で説明しています。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Allow update operations to load data files from repositories which provide security information, but these are deemed no longer cryptographically strong enough.  The default value is "<literal>false</literal>".  Concept, implications as well as alternatives are detailed in &apt-secure;.
ja: セキュリティ情報を提供してはいるものの暗号的に十分に強いものとは見なされなくなっている場合に、そういったリポジトリからのデータファイル読み込みを行う更新操作を許可します。デフォルトは「<literal>false</literal>」です。概念や影響、代替手段については &apt-secure; で説明しています。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Allow that a repository that was previously gpg signed to become unsigned during an update operation. When there is no valid signature for a previously trusted repository apt will refuse the update. This option can be used to override this protection. You almost certainly never want to enable this. The default is <literal>false</literal>.  Concept, implications as well as alternatives are detailed in &apt-secure;.
ja: 以前に GPG 署名されたリポジトリが、更新操作中に署名なしにすることを許可します。以前に信頼されたリポジトリの有効な署名が存在しない場合、更新を拒否します。このオプションは、この保護を無効にするために使用することができます。ほぼ確実に、これを有効にすることはありません。デフォルトは <literal>false</literal> です。概念や影響、代替手段については &apt-secure; で説明しています。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: scope
ja: スコープ

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Acquiring changelogs can only be done if an URI is known from where to get them.  Preferable the Release file indicates this in a 'Changelogs' field. If this isn't available the Label/Origin field of the Release file is used to check if a <literal>Acquire::Changelogs::URI::Label::<replaceable>LABEL</replaceable></literal> or <literal>Acquire::Changelogs::URI::Origin::<replaceable>ORIGIN</replaceable></literal> option exists and if so this value is taken. The value in the Release file can be overridden with <literal>Acquire::Changelogs::URI::Override::Label::<replaceable>LABEL</replaceable></literal> or <literal>Acquire::Changelogs::URI::Override::Origin::<replaceable>ORIGIN</replaceable></literal>.  The value should be a normal URI to a text file, except that package specific data is replaced with the placeholder <literal>@CHANGEPATH@</literal>. The value for it is: 1. if the package is from a component (e.g. <literal>main</literal>)  this is the first part otherwise it is omitted, 2. the first letter of source package name, except if the source package name starts with '<literal>lib</literal>' in which case it will be the first four letters. 3. The complete source package name. 4. the complete name again and 5. the source version.  The first (if present), second, third and fourth part are separated by a slash ('<literal>/</literal>')  and between the fourth and fifth part is an underscore ('<literal>_</literal>').  The special value '<literal>no</literal>' is available for this option indicating that this source can't be used to acquire changelog files from. Another source will be tried if available in this case.
ja: URI は、それらを取得する場所から知られている場合は、変更履歴の取得のみ行うことができます。好ましいリリースファイルは、「変更履歴」フィールドでこのことを示します。これが利用できない場合、<literal>Acquire::Changelogs::URI::Label::<replaceable>LABEL</replaceable></literal> または <literal>Acquire::Changelogs::URI::Origin::<replaceable>ORIGIN</replaceable></literal> オプションが存在し、そしてこの値が取られてる場合は、リリースファイルの Label/Origin フィールドが確認するために使用されます。リリースファイル内の値は、<literal>Acquire::Changelogs::URI::Override::Label::<replaceable>LABEL</replaceable></literal> または <literal>Acquire::Changelogs::URI::Override::Origin::<replaceable>ORIGIN</replaceable></literal> で上書きできます。そのパッケージ固有のデータが <literal>@CHANGEPATH@</literal> プレースホルダに置き換えられている場合以外は、値はテキストファイルへの正常な URI にする必要があります。値は次の通りです: 1. パッケージがコンポーネント (例えば、<literal>main</literal>) からのものである場合、それ以外の場合は省略されている最初の部分です、2. ソースパッケージ名の最初の文字。ただし、ソースパッケージ名が '<literal>lib</literal>' で始まる場合を除きます (その場合は 最初の 4 文字になります)。3. 完全なソースパッケージ名。4. 再び完全な名前および 5. ソースのバージョン。(存在する場合は) 最初、第二、第三、第四の部分はスラッシュ ('<literal>/</literal>') で区切られ、第四と第五の部分の間はアンダースコア ('<literal>_</literal>') です。このソースから変更履歴を取得することができないことを示す特別な値 '<literal>no</literal>' がこのオプションで利用可能です。この場合、可能であれば別のソースが試行されます。

note: type: Content of: <refentry><refsect1><title>
en: Binary specific configuration
ja: バイナリユーザ設定

note: type: Content of: <refentry><refsect1><para>
en: Especially with the introduction of the <command>apt</command> binary it can be useful to set certain options only for a specific binary as even options which look like they would effect only a certain binary like <option>APT::Get::Show-Versions</option> effect <command>apt-get</command> as well as <command>apt</command>.
ja: 特に、<command>apt</command> のバイナリの導入では、<option>APT::Get::Show-Versions</option> が <command>apt</command> と同様に <command>apt-get</command> に効果を与えるように、特定のバイナリのみに影響を与えるように見えるオプションであっても、特定のバイナリのために特定のオプションを設定することは有用であり得ます。

note: type: Content of: <refentry><refsect1><para>
en: Setting an option for a specific binary only can be achieved by setting the option inside the <option>Binary::<replaceable>specific-binary</replaceable></option> scope. Setting the option <option>APT::Get::Show-Versions</option> for the <command>apt</command> only can e.g. by done by setting <option>Binary::apt::APT::Get::Show-Versions</option> instead.
ja: 特定のバイナリ用のオプション設定は、<option>Binary::<replaceable>specific-binary</replaceable></option> スコープ内でオプションを設定して達成することができます。 <command>apt</command> 用の<option>APT::Get::Show-Versions</option> オプションの設定は、例えば、<option>Binary::apt::APT::Get::Show-Versions</option> 設定の代わりに実行されることができます。

note: type: Content of: <refentry><refsect1><para>
en: Note that as seen in the DESCRIPTION section further above you can't set binary-specific options on the commandline itself nor in configuration files loaded via the commandline.
ja: さらに上記の説明の節に見られるように、コマンドライン上のオプション自体またはコマンドラインからロードされた設定ファイル中でバイナリ固有のオプションを設定することはできません。

note: type: Content of: <refentry><refsect1><title>
en: Directories
ja: ディレクトリ

note: type: Content of: <refentry><refsect1><para>
en: The <literal>Dir::State</literal> section has directories that pertain to local state information. <literal>lists</literal> is the directory to place downloaded package lists in and <literal>status</literal> is the name of the &dpkg; status file.  <literal>preferences</literal> is the name of the APT <filename>preferences</filename> file.  <literal>Dir::State</literal> contains the default directory to prefix on all sub-items if they do not start with <filename>/</filename> or <filename>./</filename>.
ja: <literal>Dir::State</literal> セクションは、ローカル状態情報に関するディレクトリを保持します。<literal>lists</literal> は、ダウンロードしたパッケージ一覧を格納するディレクトリで、<literal>status</literal> は &dpkg; の状態ファイルの名前を表します。<literal>preferences</literal> は APT の <filename>preferences</filename> ファイルの名前です。<literal>Dir::State</literal> には、<filename>/</filename> や <filename>./</filename> で始まらないサブアイテムすべてに、前に付加するデフォルトディレクトリを含んでいます。

note: type: Content of: <refentry><refsect1><para>
en: <literal>Dir::Cache</literal> contains locations pertaining to local cache information, such as the two package caches <literal>srcpkgcache</literal> and <literal>pkgcache</literal> as well as the location to place downloaded archives, <literal>Dir::Cache::archives</literal>. Generation of caches can be turned off by setting <literal>pkgcache</literal> or <literal>srcpkgcache</literal> to <literal>""</literal>.  This will slow down startup but save disk space. It is probably preferable to turn off the pkgcache rather than the srcpkgcache.  Like <literal>Dir::State</literal> the default directory is contained in <literal>Dir::Cache</literal>
ja: <literal>Dir::Cache</literal> は、ローカルキャッシュ情報に関する場所を格納しています。これは、ダウンロード済アーカイブの場所を示す <literal>Dir::Cache::archives</literal> と同様に、<literal>srcpkgcache</literal> と <literal>pkgcache</literal> のパッケージキャッシュの場所になります。<literal>pkgcache</literal> や <literal>srcpkgcache</literal> に <literal>""</literal> をセットすることで、キャッシュの生成を無効にできます。これにより起動時に遅くなりますが、ディスク容量を節約できます。おそらく、srcpkgcache よりも pkgcache を無効にすることが多いと思います。<literal>Dir::State</literal> と同様、<literal>Dir::Cache</literal> はデフォルトディレクトリを含んでいます。

note: type: Content of: <refentry><refsect1><para>
en: <literal>Dir::Etc</literal> contains the location of configuration files, <literal>sourcelist</literal> gives the location of the sourcelist and <literal>main</literal> is the default configuration file (setting has no effect, unless it is done from the config file specified by <envar>APT_CONFIG</envar>).
ja: <literal>Dir::Etc</literal> は設定ファイルの場所を格納しています。<literal>sourcelist</literal> はソースリストの場所を示し、<literal>main</literal> はデフォルトの設定ファイルです。(<envar>APT_CONFIG</envar> で設定ファイルを指定された場合のみ、この設定の効果があります)

note: type: Content of: <refentry><refsect1><para>
en: The <literal>Dir::Parts</literal> setting reads in all the config fragments in lexical order from the directory specified. After this is done then the main config file is loaded.
ja: <literal>Dir::Parts</literal> 設定は、指定されたディレクトリから、字句単位の全ての設定断片を読みこみます。これを設定した後に、メイン設定ファイルをロードします。

note: type: Content of: <refentry><refsect1><para>
en: Binary programs are pointed to by <literal>Dir::Bin</literal>. <literal>Dir::Bin::Methods</literal> specifies the location of the method handlers and <literal>gzip</literal>, <literal>bzip2</literal>, <literal>lzma</literal>, <literal>dpkg</literal>, <literal>apt-get</literal> <literal>dpkg-source</literal> <literal>dpkg-buildpackage</literal> and <literal>apt-cache</literal> specify the location of the respective programs.
ja: バイナリプログラムは <literal>Dir::Bin</literal> で指定します。<literal>Dir::Bin::Methods</literal> はメソッドハンドラの場所を指定し、<literal>gzip</literal>, <literal>bzip2</literal>, <literal>lzma</literal>, <literal>dpkg</literal>, <literal>apt-get</literal> <literal>dpkg-source</literal> <literal>dpkg-buildpackage</literal>, <literal>apt-cache</literal> はそれぞれプログラムの場所を指定します。

note: type: Content of: <refentry><refsect1><para>
en: The configuration item <literal>RootDir</literal> has a special meaning.  If set, all paths will be relative to <literal>RootDir</literal>, <emphasis>even paths that are specified absolutely</emphasis>.  So, for instance, if <literal>RootDir</literal> is set to <filename>/tmp/staging</filename> and <literal>Dir::State::status</literal> is set to <filename>/var/lib/dpkg/status</filename>, then the status file will be looked up in <filename>/tmp/staging/var/lib/dpkg/status</filename>.  If you want to prefix only relative paths, set <literal>Dir</literal> instead.
ja: 設定項目 <literal>RootDir</literal> は特別な意味を持ちます。設定されていると、すべてのパスは <emphasis>絶対パスとして指定しても</emphasis><literal>RootDir</literal> からの相対パスとなります。そのため例えば、<literal>RootDir</literal> が <filename>/tmp/staging</filename> にセットされており、<literal>Dir::State::status</literal> が <filename>/var/lib/dpkg/status</filename> にセットされている場合、status ファイルを <filename>/tmp/staging/var/lib/dpkg/status</filename> から探します。相対バスのみをプレフィックスにしたい場合は、代わりに <literal>Dir</literal> を設定します。

note: type: Content of: <refentry><refsect1><para>
en: The <literal>Ignore-Files-Silently</literal> list can be used to specify which files APT should silently ignore while parsing the files in the fragment directories. Per default a file which ends with <literal>.disabled</literal>, <literal>~</literal>, <literal>.bak</literal> or <literal>.dpkg-[a-z]+</literal> is silently ignored. As seen in the last default value these patterns can use regular expression syntax.
ja: <literal>Ignore-Files-Silently</literal> リストは、断片ディレクトリの解析中に、APT が黙って無視をするファイルを指定します。デフォルトではそれぞれ、<literal>.disabled</literal>, <literal>~</literal>, <literal>.bak</literal>, <literal>.dpkg-[a-z]+</literal> で終わるものが、黙って無視されます。最後のデフォルト値を見ればわかる通り、このパターンには正規表現を使用できます。

note: type: Content of: <refentry><refsect1><title>
en: APT in DSelect
ja: DSelect での APT

note: type: Content of: <refentry><refsect1><para>
en: When APT is used as a &dselect; method several configuration directives control the default behavior. These are in the <literal>DSelect</literal> section.
ja: &dselect; メソッドで APT を使用する際、いくつかの設定ディレクティブでデフォルトの動作を制御します。これは <literal>DSelect</literal> セクション以下にあります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Cache Clean mode; this value may be one of <literal>always</literal>, <literal>prompt</literal>, <literal>auto</literal>, <literal>pre-auto</literal> and <literal>never</literal>.  <literal>always</literal> and <literal>prompt</literal> will remove all packages from the cache after upgrading, <literal>prompt</literal> (the default) does so conditionally.  <literal>auto</literal> removes only those packages which are no longer downloadable (replaced with a new version for instance).  <literal>pre-auto</literal> performs this action before downloading new packages.
ja: キャッシュクリーンモード - この値は <literal>always</literal>, <literal>prompt</literal>, <literal>auto</literal>, <literal>pre-auto</literal>, <literal>never</literal> のうちひとつを取ります。<literal>always</literal> と <literal>prompt</literal> は更新後、全パッケージをキャッシュから削除します。<literal>prompt</literal> (デフォルト) では条件付きで削除します。<literal>auto</literal> はダウンロード不能パッケージ (例えば新バージョンで置き換えられたもの) を削除します。<literal>pre-auto</literal> はこの動作を、新パッケージをダウンロードする直前に行います。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The contents of this variable are passed to &apt-get; as command line options when it is run for the install phase.
ja: この変数の内容は、install 時のコマンドラインオプションと同様に &apt-get; に渡されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The contents of this variable are passed to &apt-get; as command line options when it is run for the update phase.
ja: この変数の内容は、update 時のコマンドラインオプションと同様に &apt-get; に渡されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: If true the [U]pdate operation in &dselect; will always prompt to continue.  The default is to prompt only on error.
ja: true の場合、&dselect; の [U]pdate 実行時に、続行のためのプロンプトを毎回表示します。デフォルトはエラーが発生した場合のみです。

note: type: Content of: <refentry><refsect1><title>
en: How APT calls &dpkg;
ja: APT が &dpkg; を呼ぶ方法

note: type: Content of: <refentry><refsect1><para>
en: Several configuration directives control how APT invokes &dpkg;. These are in the <literal>DPkg</literal> section.
ja: いくつかの設定項目で APT がどのように &dpkg; を呼び出すかを制御できます。<literal>DPkg</literal> セクションにあります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This is a list of options to pass to &dpkg;. The options must be specified using the list notation and each list item is passed as a single argument to &dpkg;.
ja: &dpkg; に渡すオプションのリストです。オプションは、リスト記法を使用して指定しなければなりません。また、各リストは単一の引数として &dpkg; に渡されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This is a list of shell commands to run before/after invoking &dpkg;.  Like <literal>options</literal> this must be specified in list notation. The commands are invoked in order using <filename>/bin/sh</filename>; should any fail APT will abort.
ja: &dpkg; を呼び出す前後で実行するシェルコマンドのリストです。<literal>options</literal> のようにリスト記法で指定しなければなりません。コマンドは <filename>/bin/sh</filename> を通して呼び出され、何か問題があれば APT が異常終了します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This is a list of shell commands to run before invoking &dpkg;. Like <literal>options</literal> this must be specified in list notation. The commands are invoked in order using <filename>/bin/sh</filename>; should any fail APT will abort. APT will pass the filenames of all .deb files it is going to install to the commands, one per line on the requested file descriptor, defaulting to standard input.
ja: &dpkg; を呼び出す前に実行するシェルコマンドのリストです。<literal>options</literal> のようにリスト記法で指定しなければなりません。コマンドは <filename>/bin/sh</filename> を通して呼び出され、何か問題があれば、APT は異常終了します。APT はインストールしようとする全 .deb ファイルのファイル名を、要求したファイルディスクリプタについて1 行ずつ、デフォルトではコマンドの標準入力に送ります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Version 2 of this protocol sends more information through the requested file descriptor: a line with the text <literal>VERSION 2</literal>, the APT configuration space, and a list of package actions with filename and version information.
ja: このプロトコルのバージョン 2 は、要求されたファイルディスクリプタを介してより多くの情報を送信します: テキスト <literal>VERSION 2</literal> の行、APT 設定空間、ファイル名とバージョン情報を持つパッケージ処理のリスト。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Each configuration directive line has the form <literal>key=value</literal>.  Special characters (equal signs, newlines, nonprintable characters, quotation marks, and percent signs in <literal>key</literal> and newlines, nonprintable characters, and percent signs in <literal>value</literal>) are %-encoded. Lists are represented by multiple <literal>key::=value</literal> lines with the same key. The configuration section ends with a blank line.
ja: 各設定ディレクティブ行は、<literal>key=value</literal> 形式です。特殊文字 (<literal>key</literal> 中のイコール記号、改行、非印字可能文字、引用符、およびパーセント記号、および <literal>value</literal> 中の改行、非印字可能文字、およびパーセント記号) は、% エンコードされます。リストは、同じキーを持つ複数の<literal>key::=value</literal> 行で表されます。設定セクションは、空白行で終わります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Package action lines consist of five fields in Version 2: package name (without architecture qualification even if foreign), old version, direction of version change (&lt; for upgrades, &gt; for downgrades, = for no change), new version, action. The version fields are "-" for no version at all (for example when installing a package for the first time; no version is treated as earlier than any real version, so that is an upgrade, indicated as <literal>- &lt; 1.23.4</literal>). The action field is "**CONFIGURE**" if the package is being configured, "**REMOVE**" if it is being removed, or the filename of a .deb file if it is being unpacked.
ja: バージョン 2 ではパッケージアクション行は 5 つのフィールドで構成されています: パッケージ名 (例え外国だとしてもアーキテクチャ資格なしで)、旧バージョン、バージョン変更の方向 (&lt; アップグレード、&gt; ダウングレード、= 変化なし)、新バージョン、処理。バージョンなしの場合は、バージョンフィールドはすべて "-" です (例えば、初めてパッケージをインストール時、バージョンなしは、任意の実際のバージョンよりも前として扱われます。そのため、<literal>- &lt; 1.23.4</literal>はアップグレードとなります)。パッケージが設定されている場合のアクションフィールドは "**CONFIGURE**" で、削除されている場合は "**REMOVE**" 、解凍されている場合は .deb ファイルのファイル名です。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: In Version 3 after each version field follows the architecture of this version, which is "-" if there is no version, and a field showing the MultiArch type "same", "foreign", "allowed" or "none". Note that "none" is an incorrect typename which is just kept to remain compatible, it should be read as "no" and users are encouraged to support both.
ja: バージョン 3 では、各バージョンフィールドの後に、このバージョンのアーキテクチャが続きます。バージョンなしの場合は "-" 、そして MultiArch 型 "same"、"foreign"、"allowed" または "none" を示すフィールド。"none" は単に互換性を維持するために残された、誤った型名であることに注意してください。それは"no" と読まれるべきで、ユーザは両方をサポートすることをお勧めします。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The version of the protocol to be used for the command <literal><replaceable>cmd</replaceable></literal> can be chosen by setting <literal>DPkg::Tools::options::<replaceable>cmd</replaceable>::Version</literal> accordingly, the default being version 1. If APT isn't supporting the requested version it will send the information in the highest version it has support for instead.
ja: コマンド <literal><replaceable>cmd</replaceable></literal> で利用するプロトコルのバージョンは <literal>DPkg::Tools::options::<replaceable>cmd</replaceable>::Version</literal> の設定により選択でき、デフォルトはバージョン 1 となっています。リクエストしたバージョンを APT がサポートしていない場合はサポートしている最大のバージョンの情報を代わりに送ります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The file descriptor to be used to send the information can be requested with <literal>DPkg::Tools::options::<replaceable>cmd</replaceable>::InfoFD</literal> which defaults to <literal>0</literal> for standard input and is available since version 0.9.11. Support for the option can be detected by looking for the environment variable <envar>APT_HOOK_INFO_FD</envar> which contains the number of the used file descriptor as a confirmation.
ja: 情報の送信に利用するファイルディスクリプタは <literal>DPkg::Tools::options::<replaceable>cmd</replaceable>::InfoFD</literal> によりリクエストでき、デフォルトは <literal>0</literal> で標準入力を指定します。バージョン 0.9.11 から利用可能となりました。環境変数 <envar>APT_HOOK_INFO_FD</envar> を見ることでこのオプションに対応していることを検出でき、それには確認として利用しているファイルディスクリプタの番号が収録されています。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: APT chdirs to this directory before invoking &dpkg;, the default is <filename>/</filename>.
ja: APT は &dpkg; を呼び出す前にこのディレクトリに移動します。デフォルトは <filename>/</filename> です。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: These options are passed to &dpkg-buildpackage; when compiling packages; the default is to disable signing and produce all binaries.
ja: これらのオプションは、パッケージのコンパイル時に &dpkg-buildpackage; に渡されます。デフォルトでは署名を無効にし、全バイナリを生成します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: If this option is set APT will call <command>dpkg --configure --pending</command> to let &dpkg; handle all required configurations and triggers. This option is activated by default, but deactivating it could be useful if you want to run APT multiple times in a row - e.g. in an installer.  In this scenario you could deactivate this option in all but the last run.
ja: このオプションがセットされると、&dpkg; にすべての必要な設定とトリガを扱わせるように、APT は <command>dpkg --configure --pending</command> を呼び出します。このオプションは、デフォルトで有効となっていますが、APT を複数回連続して実行する場合 (インストーラなど) には、無効にしたほうが便利かもしれません。このシナリオでは、最後以外のすべての実行で、無効にできます。

note: type: Content of: <refentry><refsect1><title>
en: Periodic and Archives options
ja: Periodic オプションと Archives オプション

note: type: Content of: <refentry><refsect1><para>
en: <literal>APT::Periodic</literal> and <literal>APT::Archives</literal> groups of options configure behavior of apt periodic updates, which is done by the <literal>/usr/lib/apt/apt.systemd.daily</literal> script. See the top of this script for the brief documentation of these options.
ja: オプションの <literal>APT::Periodic</literal> グループと <literal>APT::Archives</literal> グループは、<literal>/usr/lib/apt/apt.systemd.daily</literal> スクリプトを使用して、apt の定期更新の挙動を設定します。このオプションのドキュメントは、このスクリプトの先頭を参照してください。

note: type: Content of: <refentry><refsect1><title>
en: Debug options
ja: デバッグオプション

note: type: Content of: <refentry><refsect1><para>
en: Enabling options in the <literal>Debug::</literal> section will cause debugging information to be sent to the standard error stream of the program utilizing the <literal>apt</literal> libraries, or enable special program modes that are primarily useful for debugging the behavior of <literal>apt</literal>.  Most of these options are not interesting to a normal user, but a few may be:
ja: <literal>Debug::</literal> セクションのオプションを有効にすると、<literal>apt</literal> ライブラリを利用するプログラムの標準エラー出力に、デバッグ情報を送るようになったり、主に <literal>apt</literal> の挙動をデバッグするのに便利な、特殊モードを有効にしたりできます。普通のユーザには、ほとんどのオプションは興味がないでしょうが、以下のものは興味を引くかもしれません。

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <literal>Debug::pkgProblemResolver</literal> enables output about the decisions made by <literal>dist-upgrade, upgrade, install, remove, purge</literal>.
ja: <literal>Debug::pkgProblemResolver</literal> は、<literal>dist-upgrade, upgrade, install, remove, purge</literal> で行われた判断についての出力を有効にします。

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <literal>Debug::NoLocking</literal> disables all file locking.  This can be used to run some operations (for instance, <literal>apt-get -s install</literal>) as a non-root user.
ja: <literal>Debug::NoLocking</literal> はファイルロックをすべて無効にします。これは、非 root ユーザとして操作 (例えば <literal>apt-get -s install</literal>) を行う場合に使用します。

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <literal>Debug::pkgDPkgPM</literal> prints out the actual command line each time that <literal>apt</literal> invokes &dpkg;.
ja: <literal>Debug::pkgDPkgPM</literal> は <literal>apt</literal> が実際に &dpkg; を起動する際の各コマンドラインを表示します。

note: TODO: provide a motivating example, except I haven't a clue why you'd want to do this. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <literal>Debug::IdentCdrom</literal> disables the inclusion of statfs data in CD-ROM IDs.
ja: <literal>Debug::IdentCdrom</literal> は CD-ROM ID にある statfs データを含めないようにします。

note: type: Content of: <refentry><refsect1><para>
en: A full list of debugging options to apt follows.
ja: 以下は apt に対するデバッグオプションのすべてです。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Print information related to accessing <literal>cdrom://</literal> sources.
ja: <literal>cdrom://</literal> ソースへのアクセスに関する情報を出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Print information related to downloading packages using FTP.
ja: FTP を用いたパッケージのダウンロードに関する情報を出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Print information related to downloading packages using HTTP.
ja: HTTP を用いたパッケージのダウンロードに関する情報を出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Print information related to downloading packages using HTTPS.
ja: HTTPS を用いたパッケージのダウンロードに関する情報を出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Print information related to verifying cryptographic signatures using <literal>gpg</literal>.
ja: <literal>gpg</literal> を用いた暗号署名の検証に関する情報を出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Output information about the process of accessing collections of packages stored on CD-ROMs.
ja: CD-ROM にあるパッケージ集合に対して、アクセスするプロセスについての情報を出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Output each cryptographic hash that is generated by the <literal>apt</literal> libraries.
ja: <literal>apt</literal> ライブラリが生成した、暗号化ハッシュを出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Do not include information from <literal>statfs</literal>, namely the number of used and free blocks on the CD-ROM filesystem, when generating an ID for a CD-ROM.
ja: CD-ROM の ID を生成する際に <literal>statfs</literal> という、CD-ROM ファイルシステムにある使用済・未使用ブロックの数からの情報を含めないようにします。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Disable all file locking.  For instance, this will allow two instances of <quote><literal>apt-get update</literal></quote> to run at the same time.
ja: ファイルのロックをすべて無効にします。例えば、同時にふたつの <quote><literal>apt-get update</literal></quote> を実行できるようになります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Log when items are added to or removed from the global download queue.
ja: グローバルダウンロードキューに対する項目の追加・削除の際にログを出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Output status messages and errors related to verifying checksums and cryptographic signatures of downloaded files.
ja: ダウンロードしたファイルのチェックサムや暗号署名の確認に関する、状態メッセージやエラーを出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Output information about downloading and applying package index list diffs, and errors relating to package index list diffs.
ja: パッケージインデックスリスト差分のダウンロード・適用時の、情報やエラーを出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Output information related to patching apt package lists when downloading index diffs instead of full indices.
ja: インデックス全体ではなくインデックス差分のダウンロードの際に、apt パッケージリストへのパッチ適用に関する情報を出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Log all interactions with the sub-processes that actually perform downloads.
ja: 実際のダウンロードを行う際の、サブプロセスとのやりとりをログに出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Log events related to the automatically-installed status of packages and to the removal of unused packages.
ja: パッケージの自動インストールや、不要パッケージの削除に関するイベントを、ログに出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Generate debug messages describing which packages are being automatically installed to resolve dependencies.  This corresponds to the initial auto-install pass performed in, e.g., <literal>apt-get install</literal>, and not to the full <literal>apt</literal> dependency resolver; see <literal>Debug::pkgProblemResolver</literal> for that.
ja: 依存関係解決のために、どのパッケージが自動的にインストールされたかのデバッグメッセージを生成します。これは完全な <literal>apt</literal> 依存関係解決プログラム (<literal>Debug::pkgProblemResolver</literal> を参照) ではなく、例えば <literal>apt-get install</literal> で実行された、初期の自動インストール経路に対応しています。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Generate debug messages describing which packages are marked as keep/install/remove while the ProblemResolver does his work.  Each addition or deletion may trigger additional actions; they are shown indented two additional spaces under the original entry.  The format for each line is <literal>MarkKeep</literal>, <literal>MarkDelete</literal> or <literal>MarkInstall</literal> followed by <literal>package-name &lt;a.b.c -&gt; d.e.f | x.y.z&gt; (section)</literal> where <literal>a.b.c</literal> is the current version of the package, <literal>d.e.f</literal> is the version considered for installation and <literal>x.y.z</literal> is a newer version, but not considered for installation (because of a low pin score). The later two can be omitted if there is none or if it is the same as the installed version.  <literal>section</literal> is the name of the section the package appears in.
ja: ProblemResolver が動作する際に、一時保留・インストール・削除としてマークされたパッケージに関する、デバッグメッセージを生成します。各追加・削除は追加アクションのトリガとなり、これをオリジナルのエントリの下に、空白 2 個でインデントして表示します。各行は、<literal>MarkKeep</literal>, <literal>MarkDelete</literal>, <literal>MarkInstall</literal> となり、<literal>package-name &lt;a.b.c -&gt; d.e.f | x.y.z&gt; (section)</literal> が続きます。ここで、<literal>a.b.c</literal> は、そのパッケージの現在のバージョン、<literal>d.e.f</literal>は、インストール予定のバージョン、<literal>x.y.z</literal> はより新しいけれどインストール対象外のバージョン (pin のスコアが低いため) です。後のふたつは、存在しない、ないしインストール中のバージョンと同じ場合、省略されます。<literal>section</literal> はパッケージが現れるセクション名です。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: When invoking &dpkg;, output the precise command line with which it is being invoked, with arguments separated by a single space character.
ja: &dpkg; 起動時に、起動した際の正確なコマンドラインを出力します。引数は空白で区切られます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Output all the data received from &dpkg; on the status file descriptor and any errors encountered while parsing it.
ja: 状態ファイルディスクリプタに、&dpkg; から受信したすべてのデータと、そのデータを解析中に発生したエラーを出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Generate a trace of the algorithm that decides the order in which <literal>apt</literal> should pass packages to &dpkg;.
ja: <literal>apt</literal> が &dpkg; にパッケージを渡す順番を決める、アルゴリズムのトレースを生成します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Output status messages tracing the steps performed when invoking &dpkg;.
ja: &dpkg; を呼び出す際に、実行手順を追跡した状態メッセージを出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Output the priority of each package list on startup.
ja: 起動時の各パッケージの優先度を表示します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Trace the execution of the dependency resolver (this applies only to what happens when a complex dependency problem is encountered).
ja: 依存関係解決システムの実行内容を追跡します (これは複雑な依存関係の問題に遭遇した場合にのみ、適用されます)。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Display a list of all installed packages with their calculated score used by the pkgProblemResolver. The description of the package is the same as described in <literal>Debug::pkgDepCache::Marker</literal>
ja: 全インストール済みパッケージの、pkgProblemResolver が計算したスコアを一覧表示します。パッケージの説明は、<literal>Debug::pkgDepCache::Marker</literal> で説明したものと同じです。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Print information about the vendors read from <filename>/etc/apt/vendors.list</filename>.
ja: <filename>/etc/apt/vendors.list</filename> から読み込んだ、ベンダの情報を出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Display the external commands that are called by apt hooks.  This includes e.g. the config options <literal>DPkg::{Pre,Post}-Invoke</literal> or <literal>APT::Update::{Pre,Post}-Invoke</literal>.
ja: aptのフックにより呼び出される外部コマンドを表示します。これには例えば、設定オプション <literal>DPkg::{Pre,Post}-Invoke</literal> や <literal>APT::Update::{Pre,Post}-Invoke</literal> があります。

note: type: Content of: <refentry><refsect1><title>
en: Examples
ja: サンプル

note: type: Content of: <refentry><refsect1><para>
en: &configureindex; is a configuration file showing example values for all possible options.
ja: &configureindex; は、全利用可能オプション値のサンプルを参照できる、設定ファイルのサンプルです。

note: type: Content of: <refentry><refnamediv><refpurpose>
en: Preference control file for APT
ja: APT 用選択制御ファイル

note: type: Content of: <refentry><refsect1><para>
en: The APT preferences file <filename>/etc/apt/preferences</filename> and the fragment files in the <filename>/etc/apt/preferences.d/</filename> folder can be used to control which versions of packages will be selected for installation.
ja: APT プリファレンスファイル <filename>/etc/apt/preferences</filename> と <filename>/etc/apt/preferences.d/</filename> フォルダにある断片ファイルは、インストールするパッケージのバージョンを制御するのに使用します。

note: type: Content of: <refentry><refsect1><para>
en: Several versions of a package may be available for installation when the &sources-list; file contains references to more than one distribution (for example, <literal>stable</literal> and <literal>testing</literal>).  APT assigns a priority to each version that is available.  Subject to dependency constraints, <command>apt-get</command> selects the version with the highest priority for installation.  The APT preferences override the priorities that APT assigns to package versions by default, thus giving the user control over which one is selected for installation.
ja: &sources-list; ファイルに複数のディストリビューション (<literal>stable</literal> と <literal>testing</literal> など) が指定されていて、パッケージに対し複数のバージョンがインストールできることがあります。このとき APT は、利用できるバージョンごとに優先度を割り当てます。依存関係規則を条件として、<command>apt-get</command> は、最も高い優先度を持つバージョンをインストールするよう選択します。APT プリファレンスファイルは、APT がデフォルトで割り当てた、パッケージのバージョンの優先度を上書きします。その結果インストールするものの選択を、ユーザが選択できるようになります。

note: type: Content of: <refentry><refsect1><para>
en: Several instances of the same version of a package may be available when the &sources-list; file contains references to more than one source.  In this case <command>apt-get</command> downloads the instance listed earliest in the &sources-list; file.  The APT preferences do not affect the choice of instance, only the choice of version.
ja: &sources-list; ファイルに複数の参照が書かれている場合、パッケージの同じバージョンのインスタンスが複数利用できる可能性があります。この場合、<command>apt-get</command> は &sources-list; ファイルの初めの方に指定されているところからダウンロードします。APT プリファレンスファイルはバージョンの選択にのみ影響し、インスタンスの選択には影響しません。

note: type: Content of: <refentry><refsect1><para>
en: Preferences are a strong power in the hands of a system administrator but they can become also their biggest nightmare if used without care! APT will not question the preferences, so wrong settings can lead to uninstallable packages or wrong decisions while upgrading packages.  Even more problems will arise if multiple distribution releases are mixed without a good understanding of the following paragraphs.  Packages included in a specific release aren't tested in (and therefore don't always work as expected in) older or newer releases, or together with other packages from different releases.  You have been warned.
ja: プリファレンスファイルは、システム管理者の強い力ですが、注意して使わないと大きな悪夢にもなります! APT はプリファレンスについて問い合わせることはしません。そのため、設定を誤ったことにより、インストールできないパッケージに誘導されたり、パッケージのアップグレード中に誤った判断をしたりという事がありえます。以降の段落の内容をよく理解しないで、複数のディストリビューションリリースを混ぜてしまうと、より多くの問題が発生する事になります。特定のリリースに含まれるパッケージは、古い/新しいリリースや、異なるリリースから持ってきた他のパッケージとでは、テストされていません (し、予想通りに常に動作するとは限りません)。以上、警告しました。

note: type: Content of: <refentry><refsect1><para>
en: Note that the files in the <filename>/etc/apt/preferences.d</filename> directory are parsed in alphanumeric ascending order and need to obey the following naming convention: The files have either no or "<literal>pref</literal>" as filename extension and only contain alphanumeric, hyphen (-), underscore (_) and period (.) characters.  Otherwise APT will print a notice that it has ignored a file, unless that file matches a pattern in the <literal>Dir::Ignore-Files-Silently</literal> configuration list - in which case it will be silently ignored.
ja: <filename>/etc/apt/preferences.d</filename> ディレクトリにあるファイルは、英数字の昇順で解析され、以下の命名規約に従う必要があることに注意してください。ファイル名の拡張子はないか、"<literal>pref</literal>" となっており、英数字、ハイフン (-)、アンダースコア (_)、ピリオド (.) でできています。そうでなければ、<literal>Dir::Ignore-Files-Silently</literal> 設定リストのパターンに一致するもの以外に対して、ファイルを無視するという注意を APT が出力します。一致する場合は黙って無視します。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: APT's Default Priority Assignments
ja: APT のデフォルト優先度の割り当て

note: type: Content of: <refentry><refsect1><refsect2><para>
en: If there is no preferences file or if there is no entry in the file that applies to a particular version then the priority assigned to that version is the priority of the distribution to which that version belongs.  It is possible to single out a distribution, "the target release", which receives a higher priority than other distributions do by default.  The target release can be set on the <command>apt-get</command> command line or in the APT configuration file <filename>/etc/apt/apt.conf</filename>.  Note that this has precedence over any general priority you set in the <filename>/etc/apt/preferences</filename> file described later, but not over specifically pinned packages.  For example, <placeholder type="programlisting" id="0"/> <placeholder type="programlisting" id="1"/>
ja: プリファレンスファイルがなかったり、プリファレンスファイルに特定のパッケージを割り当てるエントリがない場合、そのバージョンの優先度は、そのバージョンが属しているディストリビューションの優先度となります。デフォルトで他のディストリビューションより高い優先度を持つ、特定のディストリビューションを「ターゲットリリース」としておけます。ターゲットリリースは、<command>apt-get</command> のコマンドラインや、APT 設定ファイル <filename>/etc/apt/apt.conf</filename> で設定できます。後述する <filename>/etc/apt/preferences</filename> ファイルで設定した一般優先度よりもこれは優先されますが、pin 止めしたパッケージには及ばないことに注意してください。例えば以下のようになります。<placeholder type="programlisting" id="0"/> <placeholder type="programlisting" id="1"/>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: If the target release has been specified then APT uses the following algorithm to set the priorities of the versions of a package.  Assign:
ja: ターゲットリリースが指定されると、APT は以下のアルゴリズムで、パッケージのバージョンの優先度を設定します。以下のように割り当てます。

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: priority 1
ja: 優先度 1

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: priority 100
ja: 優先度 100

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: to the version that is already installed (if any) and to the versions coming from archives which in their <filename>Release</filename> files are marked as "NotAutomatic: yes" and "ButAutomaticUpgrades: yes" like the Debian backports archive since <literal>squeeze-backports</literal>.
ja: (もしあれば) 既にインストール済みのバージョンや、<literal>squeeze-backports</literal> 以降である Debian のバックポートアーカイブのような、<filename>Release</filename> ファイルに "NotAutomatic: yes" かつ "ButAutomaticUpgrades: yes" とマークされているアーカイブ由来のバージョン。

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: priority 500
ja: 優先度 500

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: to the versions that do not belong to the target release.
ja: ターゲットリリースに属していないバージョン。

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: priority 990
ja: 優先度 990

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: to the versions that belong to the target release.
ja: ターゲットリリースに属するバージョン。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The highest of those priorities whose description matches the version is assigned to the version.
ja: 説明がバージョンとマッチし、優先順位が最も高いものがバージョンに割り当てられます。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: If the target release has not been specified then APT simply assigns priority 100 to all installed package versions and priority 500 to all uninstalled package versions, except versions coming from archives which in their <filename>Release</filename> files are marked as "NotAutomatic: yes" - these versions get the priority 1 or priority 100 if it is additionally marked as "ButAutomaticUpgrades: yes".
ja: ターゲットリリースが指定されていなければ、APT は単純にインストールしているパッケージのバージョンには優先度 100 を、インストールしていないパッケージのバージョンには優先度 500 を割り当てます。ただし、<filename>Release</filename> ファイルに "NotAutomatic: yes" とマークされたアーカイブ由来のバージョンは違います。こういったバージョンでは優先度 1 を割り当て、さらに "ButAutomaticUpgrades: yes" とマークされている場合には、優先度 100 を割り当てます。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: APT then applies the following rules, listed in order of precedence, to determine which version of a package to install.
ja: APT は、インストールするパッケージのバージョンを決定するために、以下のルールを上から順番に適用します。

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: Never downgrade unless the priority of an available version exceeds 1000.  ("Downgrading" is installing a less recent version of a package in place of a more recent version.  Note that none of APT's default priorities exceeds 1000; such high priorities can only be set in the preferences file.  Note also that downgrading a package can be risky.)
ja: 有効なバージョンの優先度が 1000 を越えない場合、決してダウングレードしません。(「ダウングレード」は、現在のパッケージのバージョンよりも、小さいバージョンのものをインストールします。APT のデフォルト優先度が 1000 を越えないことに注意してください。そのような優先度は、プリファレンスファイルでのみ設定できます。また、パッケージのダウングレードは危険であることにも注意してください)

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: Install the highest priority version.
ja: 最も高い優先度のバージョンをインストールします。

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: If two or more versions have the same priority, install the most recent one (that is, the one with the higher version number).
ja: 同じ優先度のバージョンが複数存在する場合、最も新しいもの (最もバージョン番号が高いもの) をインストールします。

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: If two or more versions have the same priority and version number but either the packages differ in some of their metadata or the <literal>--reinstall</literal> option is given, install the uninstalled one.
ja: 優先度・バージョン番号が同じものが複数存在し、そのパッケージのメタデータが異なるか <literal>--reinstall</literal> オプションが与えられている場合、インストールされていないものをインストールします。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: In a typical situation, the installed version of a package (priority 100)  is not as recent as one of the versions available from the sources listed in the &sources-list; file (priority 500 or 990).  Then the package will be upgraded when <command>apt-get install <replaceable>some-package</replaceable></command> or <command>apt-get upgrade</command> is executed.
ja: よくある状況として、あるインストールされているパッケージのバージョン (優先度 100) が、&sources-list; ファイルのリストから得られるバージョン (優先度 500 か 990) よりも新しくないということがあります。この場合、<command>apt-get install <replaceable>some-package</replaceable></command> や <command>apt-get upgrade</command> を実行するとパッケージが更新されます。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: More rarely, the installed version of a package is <emphasis>more</emphasis> recent than any of the other available versions.  The package will not be downgraded when <command>apt-get install <replaceable>some-package</replaceable></command> or <command>apt-get upgrade</command> is executed.
ja: まれに、インストールされているパッケージのバージョンが、<emphasis>他の有効なバージョンよりも</emphasis>新しい場合があります。この時 <command>apt-get install <replaceable>some-package</replaceable></command> や <command>apt-get upgrade</command> を実行しても、ダウングレードしません。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Sometimes the installed version of a package is more recent than the version belonging to the target release, but not as recent as a version belonging to some other distribution.  Such a package will indeed be upgraded when <command>apt-get install <replaceable>some-package</replaceable></command> or <command>apt-get upgrade</command> is executed, because at least <emphasis>one</emphasis> of the available versions has a higher priority than the installed version.
ja: 時々、インストールしているパッケージのバージョンが、ターゲットリリースに属するバージョンよりも新しく、他のディストリビューションよりも古い場合があります。そのようなパッケージに対して <command>apt-get install <replaceable>some-package</replaceable></command> や <command>apt-get upgrade</command> を実行すると、パッケージは更新されます。この場合、インストールされているバージョンよりも、少なくとも<emphasis>ひとつ</emphasis>は、高い優先度を持つ有効なパッケージがあるからです。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: The Effect of APT Preferences
ja: APT プリファレンスファイルの効果

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The APT preferences file allows the system administrator to control the assignment of priorities.  The file consists of one or more multi-line records separated by blank lines.  Records can have one of two forms, a specific form and a general form.
ja: APT プリファレンスファイルを使うと、システム管理者が優先度を割り当てられるようになります。ファイルは、空白行で区切られた、複数行からなるレコードで構成されています。レコードは特定形式か、汎用形式のどちらかの形式をとります。

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: The specific form assigns a priority (a "Pin-Priority") to one or more specified packages with a specified version or version range.  For example, the following record assigns a high priority to all versions of the <filename>perl</filename> package whose version number begins with "<literal>&good-perl;</literal>".  Multiple packages can be separated by spaces.
ja: 特定形式は、優先度 ("Pin-Priority") を、指定したバージョンやバージョン範囲の、指定したパッケージについて割り当てます。例えば以下のレコードは、バージョン番号が "<literal>&good-perl;</literal>" で始まる <filename>perl</filename> パッケージを、高い優先度に設定します。空白で区切り、複数のパッケージを指定できます。

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: The general form assigns a priority to all of the package versions in a given distribution (that is, to all the versions of packages that are listed in a certain <filename>Release</filename> file) or to all of the package versions coming from a particular Internet site, as identified by the site's fully qualified domain name.
ja: 汎用形式は、与えられたディストリビューションにある、すべてのパッケージ (<filename>Release</filename> ファイルに列挙したパッケージ) の優先度や、FQDNで指定した、特定のインターネットサイトから取得するパッケージの優先度を割り当てます。

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: This general-form entry in the APT preferences file applies only to groups of packages.  For example, the following record assigns a high priority to all package versions available from the local site.
ja: APT プリファレンスファイルに書かれている汎用形式のエントリは、パッケージのグループについてのみ適用されます。例えば以下のレコードは、ローカルサイトにある全パッケージについて、高い優先度を割り当てます。

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: A note of caution: the keyword used here is "<literal>origin</literal>" which can be used to match a hostname. The following record will assign a high priority to all versions available from the server identified by the hostname "ftp.de.debian.org"
ja: 注意: ここで使われるキーワードは、ホスト名にマッチするのに使われる "<literal>origin</literal>" です。以下のレコードは、ホスト名が "ftp.de.debian.org" で識別されるサーバ由来のすべてのバージョンに、高い優先度を割り当てます。

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: This should <emphasis>not</emphasis> be confused with the Origin of a distribution as specified in a <filename>Release</filename> file.  What follows the "Origin:" tag in a <filename>Release</filename> file is not an Internet address but an author or vendor name, such as "Debian" or "Ximian".
ja: <filename>Release</filename> ファイルに指定されたような、ディストリビューションの Origin と <emphasis>混同しない</emphasis>ようにしてください。<filename>Release</filename> ファイルにある "Origin:" タグは、インターネットアドレスではなく、"Debian" や "Ximian" といった作者やベンダ名です。

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: The following record assigns a low priority to all package versions belonging to any distribution whose Archive name is "<literal>unstable</literal>".
ja: 以下のレコードは、アーカイブ名が "<literal>unstable</literal>" となっているディストリビューションに属するパッケージを、すべて低い優先度に割り当てます。

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: The following record assigns a high priority to all package versions belonging to any distribution whose Codename is "<literal>&debian-testing-codename;</literal>".
ja: 以下のレコードは、コード名が "<literal>&debian-testing-codename;</literal>" となっているディストリビューションに属するパッケージのバージョンを、高い優先度に割り当てます。

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: The following record assigns a high priority to all package versions belonging to any release whose Archive name is "<literal>stable</literal>" and whose release Version number is "<literal>&debian-stable-version;</literal>".
ja: 以下のレコードは、アーカイブ名が "<literal>stable</literal>" で、リリースバージョン番号が "<literal>&debian-stable-version;</literal>" となっているリリースに属するパッケージを、すべて高い優先度に割り当てます。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The effect of the comma operator is similar to an "and" in logic: All conditions must be satisfied for the pin to match. There is one exception: For any type of condition (such as two "a" conditions), only the last such condition is checked.
ja: コンマ演算子の効果は "and" 論理に似ています: ピンが一致するようにすべての条件がピンが一致しなければなりません。一つの例外があります: 条件のいずれかの型では (例えば、二つの "a" 条件)、ただ最後の条件のみがチェックされます。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The rule for those expressions is that they can occur anywhere where a string can occur. Thus, the following pin assigns the priority 990 to all packages from a release starting with &ubuntu-codename;.
ja: この表現の規則は、文字が現れうる場所なら、どこでも発生しうるという事です。したがって、以下の pin は、&ubuntu-codename; で始まるリリース由来の、すべてのパッケージに、優先度 990 を割り当てます。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: If a regular expression occurs in a <literal>Package</literal> field, the behavior is the same as if this regular expression were replaced with a list of all package names it matches. It is undecided whether this will change in the future; thus you should always list wild-card pins first, so later specific pins override it.  The pattern "<literal>*</literal>" in a Package field is not considered a &glob; expression in itself.
ja: <literal>Package</literal> フィールドも正規表現が現れる場合、正規表現を、マッチするすべてのパッケージ名のリストに置き換えたものとして、動作します。これは将来変更されるかどうか、まだ決定していません。そのため、まずはじめにワイルドカード pin を、常に記述するようにしてください。その後に続く pin で上書きされます。Package フィールドの "<literal>*</literal>" パターンは、&glob; 表現自体とは見なされません。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: How APT Interprets Priorities
ja: APT が優先度に割り込む方法

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Priorities (P) assigned in the APT preferences file must be positive or negative integers.  They are interpreted as follows (roughly speaking):
ja: APT プリファレンスファイルで割り当てた優先度 (P) は、正負の整数でなくてはなりません。これは (おおざっぱにいうと) 以下のように解釈されます。

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: causes a version to be installed even if this constitutes a downgrade of the package
ja: パッケージがダウングレードしても、このバージョンのパッケージをインストール

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: causes a version to be installed even if it does not come from the target release, unless the installed version is more recent
ja: インストールされているバージョンの方が新しいのでなければ、ターゲットリリースに含まれなくても、このバージョンのパッケージをインストール

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: causes a version to be installed unless there is a version available belonging to the target release or the installed version is more recent
ja: ターゲットリリースに属するバージョンがあったり、インストールされているバージョンの方が新しいのでなければ、このバージョンのパッケージをインストール

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: causes a version to be installed unless there is a version available belonging to some other distribution or the installed version is more recent
ja: 他のディストリビューションに属するバージョンがあったり、インストールされているバージョンの方が新しいのでなければ、このバージョンのパッケージをインストール

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: causes a version to be installed only if there is no installed version of the package
ja: このパッケージがインストールされていない場合、このバージョンのパッケージをインストール

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: prevents the version from being installed
ja: このバージョンのインストール禁止

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: has undefined behaviour, do not use it.
ja: は動作が未定義です、使用しないでください。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The first specific-form record matching an available package version determines the priority of the package version.  Failing that, the priority of the package is defined as the maximum of all priorities defined by generic-form records matching the version.  Records defined using patterns in the Pin field other than "*" are treated like specific-form records.
ja: 利用可能なパッケージバージョンに一致する最初の特定形式のレコードが、パッケージバージョンの優先度を決定します。それに失敗すると、パッケージバージョンの優先度は、バージョンに一致する汎用形式のレコードで定義されたすべての優先度の最大値として定義されます。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: For example, suppose the APT preferences file contains the three records presented earlier:
ja: 例えば、APT プリファレンスファイルの上の方に、以下のレコードが書かれていると仮定してください。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Then:
ja: すると、以下のように動作します。

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: The most recent available version of the <literal>perl</literal> package will be installed, so long as that version's version number begins with "<literal>&good-perl;</literal>".  If <emphasis>any</emphasis> &good-perl;* version of <literal>perl</literal> is available and the installed version is &bad-perl;*, then <literal>perl</literal> will be downgraded.
ja: バージョン番号が "<literal>&good-perl;</literal>" で始まっていれば、<literal>perl</literal> の最新の利用可能パッケージがインストールされます。バージョン &good-perl;* が利用可能で、バージョン &bad-perl;* がインストールされている場合、<literal>perl</literal> はダウングレードされます。

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: A version of any package other than <literal>perl</literal> that is available from the local system has priority over other versions, even versions belonging to the target release.
ja: ローカルシステムで有効な、<literal>perl</literal> 以外のどんなパッケージでも、他のバージョンより (たとえターゲットリリースに属していても) 優先度が高くなります。

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: A version of a package whose origin is not the local system but some other site listed in &sources-list; and which belongs to an <literal>unstable</literal> distribution is only installed if it is selected for installation and no version of the package is already installed.
ja: ローカルシステムにはなくても &sources-list; に列挙されたサイトにあるバージョンで、<literal>unstable</literal> ディストリビューションに属しているパッケージは、インストールするよう選択され、既にインストールされているバージョンがない場合にのみインストールされます。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Determination of Package Version and Distribution Properties
ja: パッケージのバージョンとディストリビューションプロパティの決定

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The locations listed in the &sources-list; file should provide <filename>Packages</filename> and <filename>Release</filename> files to describe the packages available at that location.
ja: &sources-list; ファイルに列挙した場所では、その場所で利用できるパッケージを記述した、<filename>Packages</filename> ファイルや <filename>Release</filename> ファイルを提供します。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The <filename>Packages</filename> file is normally found in the directory <filename>.../dists/<replaceable>dist-name</replaceable>/<replaceable>component</replaceable>/<replaceable>arch</replaceable></filename>: for example, <filename>.../dists/stable/main/binary-i386/Packages</filename>.  It consists of a series of multi-line records, one for each package available in that directory.  Only two lines in each record are relevant for setting APT priorities:
ja: <filename>Packages</filename> ファイルは通常 <filename>.../dists/<replaceable>dist-name</replaceable>/<replaceable>component</replaceable>/<replaceable>arch</replaceable></filename> ディレクトリにあります。例えば、<filename>.../dists/stable/main/binary-i386/Packages</filename> です。これは、ディレクトリにある利用可能パッケージごとに、複数行のレコードからできています。APT 優先度の設定は、レコードごとに以下の 2 行だけです。

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: the <literal>Package:</literal> line
ja: <literal>Package:</literal> 行

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: gives the package name
ja: パッケージ名

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: the <literal>Version:</literal> line
ja: <literal>Version:</literal> 行

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: gives the version number for the named package
ja: その名前のパッケージのバージョン番号

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The <filename>Release</filename> file is normally found in the directory <filename>.../dists/<replaceable>dist-name</replaceable></filename>: for example, <filename>.../dists/stable/Release</filename>, or <filename>.../dists/&debian-stable-codename;/Release</filename>.  It consists of a single multi-line record which applies to <emphasis>all</emphasis> of the packages in the directory tree below its parent.  Unlike the <filename>Packages</filename> file, nearly all of the lines in a <filename>Release</filename> file are relevant for setting APT priorities:
ja: <filename>Release</filename> ファイルは、通常 <filename>.../dists/<replaceable>dist-name</replaceable></filename> ディレクトリにあります。例えば、<filename>.../dists/stable/Release</filename> や <filename>.../dists/&debian-stable-codename;/Release</filename> です。これは、このディレクトリ以下にある<emphasis>全</emphasis>パッケージに適用する、複数行のレコード 1 つから成っています。<filename>Packages</filename> ファイルと違い <filename>Release</filename> ファイルは、以下のようにほとんどの行が APT 優先度の設定に関連します。

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: the <literal>Archive:</literal> or <literal>Suite:</literal> line
ja: <literal>Archive:</literal> 行や <literal>Suite:</literal> 行

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: names the archive to which all the packages in the directory tree belong.  For example, the line "Archive: stable" or "Suite: stable" specifies that all of the packages in the directory tree below the parent of the <filename>Release</filename> file are in a <literal>stable</literal> archive.  Specifying this value in the APT preferences file would require the line:
ja: このディレクトリツリーに属する全パッケージのアーカイブ名です。例えば、"Archive: stable" や "Suite: stable" という行は、<filename>Release</filename> ファイルの親ディレクトリツリー以下にある全パッケージが、<literal>stable</literal> アーカイブだと指定します。APT プリファレンスファイルでこの値を指定するには、以下の行が必要になります。

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: the <literal>Codename:</literal> line
ja: <literal>Codename:</literal> 行

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: names the codename to which all the packages in the directory tree belong.  For example, the line "Codename: &debian-testing-codename;" specifies that all of the packages in the directory tree below the parent of the <filename>Release</filename> file belong to a version named <literal>&debian-testing-codename;</literal>.  Specifying this value in the APT preferences file would require the line:
ja: このディレクトリツリーに属する全パッケージのコード名です。たとえば、"Codename: &debian-testing-codename;" という行は、<filename>Release</filename> ファイルの親ディレクトリツリー以下にある全パッケージが、<literal>&debian-testing-codename;</literal> と名前のついたバージョンであると指定します。APT プリファレンスファイルでこの値を指定するには、以下の行が必要になります。

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: names the release version.  For example, the packages in the tree might belong to Debian release version &debian-stable-version;.  Note that there is normally no version number for the <literal>testing</literal> and <literal>unstable</literal> distributions because they have not been released yet.  Specifying this in the APT preferences file would require one of the following lines.
ja: リリースバージョン名です。例えば、このツリーのパッケージが、Debian リリースバージョン &debian-stable-version; に属するとします。通常 <literal>testing</literal> ディストリビューションや <literal>unstable</literal> ディストリビューションには、まだリリースされていないので、バージョン番号が付きません。APT プリファレンスファイルでこれを指定するには、以下の行のいずれかが必要になります。

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: the <literal>Component:</literal> line
ja: <literal>Component:</literal> 行

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: names the licensing component associated with the packages in the directory tree of the <filename>Release</filename> file.  For example, the line "Component: main" specifies that all the packages in the directory tree are from the <literal>main</literal> component, which entails that they are licensed under terms listed in the Debian Free Software Guidelines.  Specifying this component in the APT preferences file would require the line:
ja: <filename>Release</filename> ファイルの、ディレクトリツリーにあるパッケージのライセンスコンポーネント名です。例えば、"Component: main" という行は、このディレクトリ以下の全ファイルが、<literal>main</literal> コンポーネント (Debian フリーソフトウェアガイドラインの元でライセンスされている) であることを表します。APT プリファレンスファイルでこのコンポーネントを指定するには、以下の行が必要になります。

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: the <literal>Origin:</literal> line
ja: <literal>Origin:</literal> 行

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: names the originator of the packages in the directory tree of the <filename>Release</filename> file.  Most commonly, this is <literal>Debian</literal>.  Specifying this origin in the APT preferences file would require the line:
ja: <filename>Release</filename> ファイルのディレクトリツリーにあるパッケージの提供者名です。ほとんど共通で <literal>Debian</literal> です。APT プリファレンスファイルでこの提供者を指定するには、以下の行が必要になります。

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: the <literal>Label:</literal> line
ja: <literal>Label:</literal> 行

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: names the label of the packages in the directory tree of the <filename>Release</filename> file.  Most commonly, this is <literal>Debian</literal>.  Specifying this label in the APT preferences file would require the line:
ja: <filename>Release</filename> ファイルのディレクトリツリーにあるパッケージのラベル名です。ほとんど共通で <literal>Debian</literal> です。APT プリファレンスファイルでこのラベルを指定するには、以下の行が必要になります。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: All of the <filename>Packages</filename> and <filename>Release</filename> files retrieved from locations listed in the &sources-list; file are stored in the directory <filename>/var/lib/apt/lists</filename>, or in the file named by the variable <literal>Dir::State::Lists</literal> in the <filename>apt.conf</filename> file.  For example, the file <filename>debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release</filename> contains the <filename>Release</filename> file retrieved from the site <literal>debian.lcs.mit.edu</literal> for <literal>binary-i386</literal> architecture files from the <literal>contrib</literal> component of the <literal>unstable</literal> distribution.
ja: &sources-list; ファイルに列挙された場所から取得した <filename>Packages</filename> ファイルや <filename>Release</filename> ファイルはすべて、<filename>/var/lib/apt/lists</filename> ディレクトリや、<filename>apt.conf</filename> ファイルの <literal>Dir::State::Lists</literal> 変数で指定した場所に取得されます。例えば、<filename>debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release</filename> ファイルは、<literal>debian.lcs.mit.edu</literal> から取得した、<literal>unstable</literal> ディストリビューションで、<literal>contrib</literal> コンポーネントな、<literal>binary-i386</literal> アーキテクチャ用の <filename>Release</filename> ファイルを含んでいます。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Optional Lines in an APT Preferences Record
ja: APT プリファレンスレコードのオプション行

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Each record in the APT preferences file can optionally begin with one or more lines beginning with the word <literal>Explanation:</literal>.  This provides a place for comments.
ja: APT プリファレンスファイルのレコードごとに、任意で <literal>Explanation:</literal> で始まる行を持てます。これは、コメント用の場所を確保します。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Tracking Stable
ja: 安定版の追跡

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The following APT preferences file will cause APT to assign a priority higher than the default (500) to all package versions belonging to a <literal>stable</literal> distribution and a prohibitively low priority to package versions belonging to other <literal>Debian</literal> distributions.  <placeholder type="programlisting" id="0"/>
ja: 以下の APT プリファレンスファイルは、<literal>stable</literal> ディストリビューションに属する全てのパッケージのバージョンに、デフォルト (500) より高い優先度を割り当て、他の <literal>Debian</literal> ディストリビューションのパッケージのバージョンには、低くてインストールできないような優先度を割り当てます。<placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: With a suitable &sources-list; file and the above preferences file, any of the following commands will cause APT to upgrade to the latest <literal>stable</literal> version(s).  <placeholder type="programlisting" id="0"/>
ja: 適切な &sources-list; ファイルと上記のプリファレンスファイルにより、以下のコマンドのいずれかで最新の <literal>stable</literal> バージョンにアップグレードできます。<placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The following command will cause APT to upgrade the specified package to the latest version from the <literal>testing</literal> distribution; the package will not be upgraded again unless this command is given again.  <placeholder type="programlisting" id="0"/>
ja: 以下のコマンドで、指定したパッケージを <literal>testing</literal> ディストリビューションの最新バージョンにアップグレードします。このパッケージは、再度このコマンドを発行しないとアップグレードされません。<placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Tracking Testing or Unstable
ja: テスト版や不安定版の追跡

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The following APT preferences file will cause APT to assign a high priority to package versions from the <literal>testing</literal> distribution, a lower priority to package versions from the <literal>unstable</literal> distribution, and a prohibitively low priority to package versions from other <literal>Debian</literal> distributions.  <placeholder type="programlisting" id="0"/>
ja: 以下の APT プリファレンスファイルは、<literal>testing</literal> ディストリビューションのパッケージのバージョンに高い優先度を割り当て、<literal>unstable</literal> ディストリビューションのパッケージのバージョンには低い優先度を割り当てます。また他の <literal>Debian</literal> ディストリビューションのパッケージのバージョンには、低くてインストールできないような優先度を割り当てます。<placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: With a suitable &sources-list; file and the above preferences file, any of the following commands will cause APT to upgrade to the latest <literal>testing</literal> version(s).  <placeholder type="programlisting" id="0"/>
ja: 適切な &sources-list; ファイルと上記のプリファレンスファイルにより、以下のコマンドのいずれかで最新の <literal>testing</literal> バージョンにアップグレードできます。<placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The following command will cause APT to upgrade the specified package to the latest version from the <literal>unstable</literal> distribution.  Thereafter, <command>apt-get upgrade</command> will upgrade the package to the most recent <literal>testing</literal> version if that is more recent than the installed version, otherwise, to the most recent <literal>unstable</literal> version if that is more recent than the installed version.  <placeholder type="programlisting" id="0"/>
ja: 以下のコマンドで、指定したパッケージを <literal>unstable</literal> ディストリビューションの最新バージョンにアップグレードします。それ以降、<command>apt-get upgrade</command> は <literal>testing</literal> バージョンのパッケージが更新されていれば <literal>testing</literal> の最新版に、<literal>unstable</literal> バージョンのパッケージが更新されていれば <literal>unstable</literal> の最新版にアップグレードします。<placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Tracking the evolution of a codename release
ja: コード名リリースの進化の追跡

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The following APT preferences file will cause APT to assign a priority higher than the default (500) to all package versions belonging to a specified codename of a distribution and a prohibitively low priority to package versions belonging to other <literal>Debian</literal> distributions, codenames and archives.  Note that with this APT preference APT will follow the migration of a release from the archive <literal>testing</literal> to <literal>stable</literal> and later <literal>oldstable</literal>. If you want to follow for example the progress in <literal>testing</literal> notwithstanding the codename changes you should use the example configurations above.  <placeholder type="programlisting" id="0"/>
ja: 以下の APT プリファレンスファイルは、指定したコード名のディストリビューションに属する全てのパッケージのバージョンに、デフォルト (500) より高い優先度を割り当て、他の <literal>Debian</literal> ディストリビューション、コード名、アーカイブのパッケージのバージョンには、低くてインストールできないような優先度を割り当てます。この APT プリファレンスファイルにより、APT は <literal>testing</literal> アーカイブから、<literal>stable</literal> や最新の <literal>oldstable</literal> へ移行できます。コード名の変更に関係なく <literal>testing</literal> を追跡したい場合は、上記の設定例を使用するべきです。<placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: With a suitable &sources-list; file and the above preferences file, any of the following commands will cause APT to upgrade to the latest version(s) in the release codenamed with <literal>&debian-testing-codename;</literal>.  <placeholder type="programlisting" id="0"/>
ja: 適切な &sources-list; ファイルと上記のプリファレンスファイルにより、以下のコマンドのいずれかで、リリースコード名が <literal>&debian-testing-codename;</literal> である最新バージョンにアップグレードできます。<placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The following command will cause APT to upgrade the specified package to the latest version from the <literal>sid</literal> distribution.  Thereafter, <command>apt-get upgrade</command> will upgrade the package to the most recent <literal>&debian-testing-codename;</literal> version if that is more recent than the installed version, otherwise, to the most recent <literal>sid</literal> version if that is more recent than the installed version.  <placeholder type="programlisting" id="0"/>
ja: 以下のコマンドで、指定したパッケージを <literal>sid</literal> ディストリビューションの最新バージョンにアップグレードします。それ以降、<command>apt-get upgrade</command> は <literal>&debian-testing-codename;</literal> バージョンのパッケージが更新されていれば <literal>&debian-testing-codename;</literal> の最新版に、<literal>sid</literal> バージョンのパッケージが更新されていれば <literal>sid</literal>の最新版にアップグレードします。<placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refnamediv><refpurpose>
en: List of configured APT data sources
ja: APT のデータ取得元の設定リスト

note: type: Content of: <refentry><refsect1><para>
en: The source list <filename>/etc/apt/sources.list</filename> and the files contained in <filename>/etc/apt/sources.list.d/</filename> are designed to support any number of active sources and a variety of source media. The files list one source per line (one-line style) or contain multiline stanzas defining one or more sources per stanza (deb822 style), with the most preferred source listed first (in case a single version is available from more than one source). The information available from the configured sources is acquired by <command>apt-get update</command> (or by an equivalent command from another APT front-end).
ja: 取得元リスト <filename>/etc/apt/sources.list</filename> と <filename>/etc/apt/sources.list.d/</filename> に含まれるファイルは、複数の取得元や様々なメディアをサポートするよう設計されています。ファイルは、1 行に一つの取得元をリストする (1 行スタイル) かまたはスタンザごとに複数の取得元を定義し、(シングルバージョンが複数の取得元から入手可能である場合には) 最も好ましい取得元を先頭に置く複数行のスタンザ (deb822 スタイル) を含みます。設定した取得元から利用可能な情報は、<command>apt-get update</command> (や、ほかの APT フロントエンドの同等のコマンド) で取得します。

note: type: Content of: <refentry><refsect1><para>
en: The <filename>/etc/apt/sources.list.d</filename> directory provides a way to add sources.list entries in separate files.  Two different file formats are allowed as described in the next two sections.  Filenames need to have either the extension <filename>.list</filename> or <filename>.sources</filename> depending on the contained format.  The filenames may only contain letters (a-z and A-Z), digits (0-9), underscore (_), hyphen (-) and period (.) characters.  Otherwise APT will print a notice that it has ignored a file, unless that file matches a pattern in the <literal>Dir::Ignore-Files-Silently</literal> configuration list - in which case it will be silently ignored.
ja: <filename>/etc/apt/sources.list.d</filename> ディレクトリは、別々のファイルで source.list のエントリを追加する方法を提供します。次の二つの節で説明するように、二つの異なるファイル形式が許可されています。ファイル名は、含まれている形式に応じて <filename>.list</filename> または <filename>.sources</filename> のいずれかの拡張子を持っている必要があります。ファイル名は、文字 (a-z と A-Z)、数字 (0-9)、アンダースコア (_)、ハイフン (-)、ピリオド (.) のみを含むことができます。そうでなければ、<literal>Dir::Ignore-Files-Silently</literal> 設定リストのパターンに一致するもの以外に対して、ファイルを無視するという注意を APT が出力します。一致する場合は黙って無視します。

note: type: Content of: <refentry><refsect1><title>
en: One-Line-Style Format
ja: 1 行スタイル形式

note: type: Content of: <refentry><refsect1><para>
en: Files in this format have the extension <filename>.list</filename>.  Each line specifying a source starts with a type (e.g. <literal>deb-src</literal>)  followed by options and arguments for this type.  Individual entries cannot be continued onto a following line. Empty lines are ignored, and a <literal>#</literal> character anywhere on a line marks the remainder of that line as a comment. Consequently an entry can be disabled by commenting out the entire line.  If options should be provided they are separated by spaces and all of them together are enclosed by square brackets (<literal>[]</literal>)  included in the line after the type separated from it with a space.  If an option allows multiple values these are separated from each other with a comma (<literal>,</literal>). An option name is separated from its value(s) by an equals sign (<literal>=</literal>). Multivalue options also have <literal>-=</literal> and <literal>+=</literal> as separators, which instead of replacing the default with the given value(s) modify the default value(s) to remove or include the given values.
ja: この形式のファイルは、<filename>.list</filename> 拡張子を持っています。取得元を指定する各行は、この型のオプションと引数が続く型 <literal>deb-src</literal> から始まります。個々のエントリは、次の行に継続することはできません。空行は無視され、行の任意の位置の <literal>#</literal> 文字はコメントとして行の残りの部分をマークします。したがって行全体をコメントアウトすることによって、エントリを無効にすることができます。オプションが提供されている場合、スペースで区切られ、すべて角カッコ (<literal>[]</literal>) で囲まれていて、行の中でスペースで区切られた型の後ろに含まれます。複数の値が許されるオプションの場合、カンマ (<literal>,</literal>) で分離されています。オプション名は、イコール記号 (<literal>=</literal>) で分離されます。複数値のオプションも <literal>-=</literal> および <literal>+=</literal> をセパレータとして持ち、デフォルト値から与えられた値を削除するか、またはデフォルト値に与えられた値を含めます。

note: type: Content of: <refentry><refsect1><para>
en: This is the traditional format and supported by all apt versions.  Note that not all options as described below are supported by all apt versions.  Note also that some older applications parsing this format on their own might not expect to encounter options as they were uncommon before the introduction of multi-architecture support.
ja: 伝統的な形式とすべての apt のバージョンでサポートされています。下記のようにすべてのオプションがすべての apt のバージョンでサポートされているわけでないことに注意してください。いくつかの古いアプリケーションは、自分でこの形式をパースするので、マルチアーキテクチャのサポートの導入前には珍しいオプションに遭遇することを期待しないかもしれないことに注意してください。

note: type: Content of: <refentry><refsect1><title>
en: deb822-Style Format
ja: deb822 スタイル形式

note: type: Content of: <refentry><refsect1><para>
en: This is a new format supported by apt itself since version 1.1. Previous versions ignore such files with a notice message as described earlier.  It is intended to make this format gradually the default format, deprecating the previously described one-line-style format, as it is easier to create, extend and modify for humans and machines alike especially if a lot of sources and/or options are involved.  Developers who are working with and/or parsing apt sources are highly encouraged to add support for this format and to contact the APT team to coordinate and share this work. Users can freely adopt this format already, but may encounter problems with software not supporting the format yet.
ja: バージョン 1.1 以降の apt 自身によりサポートされる新しい形式です。前述のように以前のバージョンでは、通知メッセージでそのようなファイルを無視します。多くのソースおよび/またはオプションが関与している場合は特に、人間と機械を問わず、作成、拡張、変更を簡単にするために、先に述べた 1 行スタイル形式を非推奨にし、徐々にこの形式をデフォルト形式にすることが意図されています。apt ソースを作業および/またはパースしている開発者は、このフォーマットのサポートを追加することと、調整するために APT チームに連絡すること、この作業を共有することをお勧めします。ユーザはすでに自由にこの形式を採用することができますが、この形式をまだサポートしていないソフトウェアで問題が発生する場合があります。

note: type: Content of: <refentry><refsect1><title>
en: The deb and deb-src Types: General Format
ja: deb および deb-src タイプ: 一般形式

note: type: Content of: <refentry><refsect1><para>
en: The <literal>deb</literal> type references a typical two-level Debian archive, <filename>distribution/component</filename>. The <literal>distribution</literal> is generally a suite name like <literal>stable</literal> or <literal>testing</literal> or a codename like <literal>&debian-stable-codename;</literal> or <literal>&debian-testing-codename;</literal> while component is one of <literal>main</literal>, <literal>contrib</literal>, <literal>non-free</literal> or <literal>non-free-firmware</literal>. The <literal>deb-src</literal> type references a Debian distribution's source code in the same form as the <literal>deb</literal> type.  A <literal>deb-src</literal> line is required to fetch source indexes.
ja: <literal>deb</literal> タイプでは典型的な 2 段階の Debian アーカイブ <filename>distribution/component</filename> を参照します。<literal>distribution</literal> は通常 <literal>stable</literal> や <literal>testing</literal> または <literal>&debian-stable-codename;</literal> や <literal>&debian-testing-codename;</literal> のようなコード名になります。component は、<literal>main</literal>, <literal>contrib</literal>, <literal>non-free</literal>, <literal>non-free-firmware</literal> のどれかです。<literal>deb-src</literal> タイプでは、debian ディストリビューションのソースコードを、<literal>deb</literal> タイプと同じ形式で参照します。<literal>deb-src</literal> 行は、ソースインデックスを取得するのに必要です。

note: type: Content of: <refentry><refsect1><para>
en: The format for two one-line-style entries using the <literal>deb</literal> and <literal>deb-src</literal> types is:
ja: <literal>deb</literal> および <literal>deb-src</literal> タイプで使用する 2 つの 1 行スタイルのエントリの形式は、以下のようになります:

note: type: Content of: <refentry><refsect1><para>
en: Alternatively the equivalent entry in deb822 style looks like this: <placeholder type="literallayout" id="0"/>
ja: 他に deb822 スタイルで同等のエントリもサポートしています: <placeholder type="literallayout" id="0"/>

note: type: Content of: <refentry><refsect1><para>
en: The URI for the <literal>deb</literal> type must specify the base of the Debian distribution, from which APT will find the information it needs.  <literal>suite</literal> can specify an exact path, in which case the components must be omitted and <literal>suite</literal> must end with a slash (<literal>/</literal>). This is useful for the case when only a particular sub-directory of the archive denoted by the URI is of interest.  If <literal>suite</literal> does not specify an exact path, at least one <literal>component</literal> must be present.
ja: <literal>deb</literal> タイプの URI は、APT が必要な情報を見つけられるように、Debian ディストリビューションの基底を指定しなければなりません。<literal>スイート</literal>には正確なパスを指定できます。その場合コンポーネントを省略し、<literal>スイート</literal>はスラッシュ (<literal>/</literal>) で終わらなくてはなりません。これは URL で指定されたアーカイブの、特定のサブディレクトリのみに関心があるときに役に立ちます。<literal>スイート</literal>に正確なパスを指定しないのなら、少なくとも一つは <literal>コンポーネント</literal> を指定しなければなりません。

note: type: Content of: <refentry><refsect1><para>
en: <literal>suite</literal> may also contain a variable, <literal>$(ARCH)</literal> which expands to the Debian architecture (such as <literal>amd64</literal> or <literal>armel</literal>) used on the system. This permits architecture-independent <filename>sources.list</filename> files to be used. In general this is only of interest when specifying an exact path; <literal>APT</literal> will automatically generate a URI with the current architecture otherwise.
ja: <literal>スイート</literal> は、<literal>$(ARCH)</literal> 変数を含む場合があります。<literal>$(ARCH)</literal> 変数は、システムで使用している Debian アーキテクチャ (<literal>amd64</literal> や <literal>armel</literal> など) に展開されます。これにより、アーキテクチャに依存しない <filename>sources.list</filename> ファイルを使用できます。一般的に、これは正しいパスを指定するときに気にするだけです。そうでない場合は、<literal>APT</literal> は現在のアーキテクチャで URI を自動的に生成します。

note: type: Content of: <refentry><refsect1><para>
en: Especially in the one-line-style format since only one distribution can be specified per line it may be necessary to have multiple lines for the same URI, if a subset of all available distributions or components at that location is desired.  APT will sort the URI list after it has generated a complete set internally, and will collapse multiple references to the same Internet host, for instance, into a single connection, so that it does not inefficiently establish a connection, close it, do something else, and then re-establish a connection to that same host. APT also parallelizes connections to different hosts to more effectively deal with sites with low bandwidth.
ja: 特に 1 行スタイル形式では 1 行につき 1 つのディストリビューションしか指定できないため、同じ URI の行を複数記述することになるでしょう。APT は内部で URI リストを生成してから、並べ替えます。そして、同じインターネットホストに対しては複数の参照をまとめます。例えば FTP 接続後、切断してからまた同じホストに再接続するといった効率の悪いことをせずに、1 接続にまとめます。APT は、帯域の狭いサイトを効率よく扱うため異なるホストへは接続を並行して行うようにもしています。

note: type: Content of: <refentry><refsect1><para>
en: It is important to list sources in order of preference, with the most preferred source listed first. Typically this will result in sorting by speed from fastest to slowest (CD-ROM followed by hosts on a local network, followed by distant Internet hosts, for example).
ja: 最優先する取得元を最初に記述するというように、優先順に取得元を記述するのは重要です。一般的には、スピードの速い順に並べることになる (例えば、CD-ROM に続いてローカルネットワークのホスト、さらに続いて彼方のインターネットホスト) でしょう。

note: type: Content of: <refentry><refsect1><para>
en: As an example, the sources for your distribution could look like this in one-line-style format: <placeholder type="literallayout" id="0"/> or like this in deb822 style format: <placeholder type="literallayout" id="1"/>
ja: 例として、あなたのディストリビューション用のソースは、1 行スタイル形式で次のようになります: <placeholder type="literallayout" id="0"/> または deb822 スタイル形式でこのようになります: <placeholder type="literallayout" id="1"/>

note: type: Content of: <refentry><refsect1><title>
en: The deb and deb-src types: Options
ja: deb および deb-src タイプ: オプション

note: type: Content of: <refentry><refsect1><para>
en: Each source entry can have options specified to modify which source is accessed and how data is acquired from it. Format, syntax and names of the options vary between the one-line-style and deb822-style formats as described, but they both have the same options available. For simplicity we list the deb822 field name and provide the one-line name in brackets.  Remember that besides setting multivalue options explicitly, there is also the option to modify them based on the default, but we aren't listing those names explicitly here. Unsupported options are silently ignored by all APT versions.
ja: 各取得元エントリは、アクセスされる取得元や取得されるデータを変更するために指定するオプションを持つことができます。オプションの形式、構文と名前は、記載されているように 1 行スタイルと deb822 スタイルの間で異なりますが、どちらも同じオプションが用意されています。簡単にするために、deb822 フィールド名を一覧表示し、カッコ内に 1 行の名前を提供します。明示的に複数の値を持つオプションを設定する以外に、デフォルトをベースに変更するためのオプションもあることを忘れないでください。ここでは明示的にそれらの名前はリストしていません。サポートされていないオプションは、すべての APT バージョンで黙って無視されます。

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>Architectures</option> (<option>arch</option>) is a multivalue option defining for which architectures information should be downloaded. If this option isn't set the default is all architectures as defined by the <option>APT::Architectures</option> config option.
ja: <option>Architectures</option> (<option>arch</option>) は複数の値を持つオプションで、どのアーキテクチャ情報をダウンロードするか指定します。このオプションを指定しないと、<option>APT::Architectures</option> 設定オプションに定義してあるすべてのアーキテクチャをダウンロードします。

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>Languages</option> (<option>lang</option>) is a multivalue option defining for which languages information such as translated package descriptions should be downloaded.  If this option isn't set the default is all languages as defined by the <option>Acquire::Languages</option> config option.
ja: <literal>arch=<replaceable>arch1</replaceable>,<replaceable>arch2</replaceable>,…</literal> により、どのアーキテクチャ情報をダウンロードするか指定します。このオプションを指定しないと、<literal>APT::Architectures</literal> オプションに定義してある全アーキテクチャをダウンロードします。

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>Targets</option> (<option>target</option>) is a multivalue option defining which download targets apt will try to acquire from this source. If not specified, the default set is defined by the <option>Acquire::IndexTargets</option> configuration scope (targets are specified by their name in the <literal>Created-By</literal> field).  Additionally, targets can be enabled or disabled by using the <literal>Identifier</literal> field as an option with a boolean value instead of using this multivalue option.
ja: <option>Targets</option> (<option>target</option>) は値を複数取るオプションで、apt がその取得元から取得するダウンロード対象を定義します。指定しない場合のデフォルトセットは設定項目 <option>Acquire::IndexTargets</option> で定義されます (対象は <literal>Created-By</literal> の名前により指定されます)。また、複数の値を取るこのオプションに代えて、真偽値を指定した <literal>Identifier</literal> をオプションとして使うことで有効化、無効化できます。

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>PDiffs</option> (<option>pdiffs</option>)  is a yes/no value which controls if APT should try to use PDiffs to update old indexes instead of downloading the new indexes entirely. The value of this option is ignored if the repository doesn't announce the availability of PDiffs.  Defaults to the value of the option with the same name for a specific index file defined in the <option>Acquire::IndexTargets</option> scope, which itself defaults to the value of configuration option <option>Acquire::PDiffs</option> which defaults to <literal>yes</literal>.
ja: <option>PDiffs</option> (<option>pdiffs</option>) は、新しいインデックスを完全にダウンロードする代わりに、古いインデックスを更新するため PDiffs を使用するかどうかを制御する yes/no 値です。レポジトリが PDiffs の提供を公開していない場合は、このオプションの値は無視されます。<option>Acquire::IndexTargets</option> スコープ中に定義された特定のインデックスファイル用の同じ名前のオプション値がデフォルトになり、設定オプション <option>Acquire::PDiffs</option> のデフォルト値は <literal>yes</literal> です。

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>By-Hash</option> (<option>by-hash</option>)  can have the value <literal>yes</literal>, <literal>no</literal> or <literal>force</literal> and controls if APT should try to acquire indexes via a URI constructed from a hashsum of the expected file instead of using the well-known stable filename of the index. Using this can avoid hashsum mismatches, but requires a supporting mirror. A <literal>yes</literal> or <literal>no</literal> value activates/disables the use of this feature if this source indicates support for it, while <literal>force</literal> will enable the feature regardless of what the source indicates. Defaults to the value of the option of the same name for a specific index file defined in the <option>Acquire::IndexTargets</option> scope, which itself defaults to the value of configuration option <option>Acquire::By-Hash</option> which defaults to <literal>yes</literal>.
ja: <option>By-Hash</option> (<option>by-hash</option>) は、<literal>yes</literal>、<literal>no</literal> または <literal>force</literal> の値を持つことができます。そして、APT がインデックスのよく知られた安定版の名前を使用する代わりに、期待されるファイルのハッシュ値から構築された URI を経由してインデックスを取得するかどうかを制御します。これを使用すると、ハッシュ値の不一致を避けることができますが、ミラーのサポートを必要とします。この取得元がそのサポートを示す場合、<literal>yes</literal> または <literal>no</literal> の値は、この機能の使用を有効化/無効化します。<literal>force</literal> は取得元が示すものに関係なく、機能を有効にします。<option>Acquire::IndexTargets</option> スコープ中に定義された特定のインデックスファイル用の同じ名前のオプション値がデフォルトになり、設定オプション <option>Acquire::By-Hash</option> のデフォルト値は <literal>yes</literal> です。

note: type: Content of: <refentry><refsect1><para>
en: Furthermore, there are options which if set affect <emphasis>all</emphasis> sources with the same URI and Suite, so they have to be set on all such entries and can not be varied between different components. APT will try to detect and error out on such anomalies.
ja: さらに、設定が同じ URI とスイートの<emphasis>すべて</emphasis>の取得元に影響する場合のオプションがあり、このようなすべてのエントリに設定する必要があり、異なる要素間で変化することができません。APT はこのような異常を検出してエラー出力しようとします。

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>Allow-Insecure</option> (<option>allow-insecure</option>), <option>Allow-Weak</option> (<option>allow-weak</option>) and <option>Allow-Downgrade-To-Insecure</option> (<option>allow-downgrade-to-insecure</option>)  are boolean values which all default to <literal>no</literal>.  If set to <literal>yes</literal> they circumvent parts of &apt-secure; and should therefore not be used lightly!
ja: <option>Allow-Insecure</option> (<option>allow-insecure</option>), <option>Allow-Weak</option> (<option>allow-weak</option>), <option>Allow-Downgrade-To-Insecure</option> (<option>allow-downgrade-to-insecure</option>) は真偽値でデフォルトはどれも <literal>no</literal> となっています。<literal>yes</literal> をセットすると &apt-secure; の部分を迂回するため安易に有効化すべきではありません!

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>Trusted</option> (<option>trusted</option>)  is a tri-state value which defaults to APT deciding if a source is considered trusted or if warnings should be raised before e.g.  packages are installed from this source. This option can be used to override that decision. The value <literal>yes</literal> tells APT always to consider this source as trusted, even if it doesn't pass authentication checks. It disables parts of &apt-secure;, and should therefore only be used in a local and trusted context (if at all) as otherwise security is breached. The value <literal>no</literal> does the opposite, causing the source to be handled as untrusted even if the authentication checks passed successfully. The default value can't be set explicitly.
ja: <option>Trusted</option> (<option>trusted</option>) は、APT の判断のデフォルトのトライステート値で、取得元が信頼できる、以前警告が発生した (例えば、パッケージをこの取得元からインストールしたときに)、信頼できないの 3 値です。このオプションは、APT の決定を上書きするために使用することができます。値 <literal>yes</literal> は、それが認証チェックに合格しない場合であっても、この取得元が信頼できると考えられることを常に APT に伝えます。&apt-secure; の一部を無効にするので、(すべてであれば) ローカルおよび信頼されたコンテキストでのみ使用するべきです。そうしなければ、セキュリティが破られます。値 <literal>no</literal> は反対のことを行います。認証チェックに合格した場合でも取得元を信頼できないとして扱います。デフォルト値は明示的に設定することはできません。

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>Check-Valid-Until</option> (<option>check-valid-until</option>)  is a yes/no value which controls if APT should try to detect replay attacks. A repository creator can declare a time until which the data provided in the repository should be considered valid, and if this time is reached, but no new data is provided, the data is considered expired and an error is raised.  Besides increasing security, as a malicious attacker can't send old data forever to prevent a user from upgrading to a new version, this also helps users identify mirrors which are no longer updated. However, some repositories such as historic archives are not updated any more by design, so this check can be disabled by setting this option to <literal>no</literal>.  Defaults to the value of configuration option <option>Acquire::Check-Valid-Until</option> which itself defaults to <literal>yes</literal>.
ja: <option>Check-Valid-Until</option> (<option>check-valid-until</option>) は、APT がリプレイ攻撃を検出するかどうかを制御する yes/no 値です。リポジトリの作成者は、リポジトリに提供されたデータが有効とみなされる時間を宣言することができます。そして、この時間に達しているが、新しいデータが提供されていない場合、データが期限切れになったとみなされ、エラーが発生します。セキュリティを高めることに加えて、新しいバージョンにアップグレードするユーザを守るために、悪意のある攻撃者が古いデータを永遠に送れないようにすることで、長期間更新されていないミラーをユーザが特定するのに役立ちます。しかしながら、歴史的アーカイブなど、いくつかのリポジトリは、設計によりこれ以上更新されないので、このオプションを <literal>no</literal> に設定することで、このチェックを無効にすることができます。設定オプション <option>Acquire::Check-Valid-Until</option> の値がデフォルトになり、そのデフォルトは <literal>yes</literal> です。

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>Valid-Until-Min</option> (<option>valid-until-min</option>) and <option>Valid-Until-Max</option> (<option>valid-until-max</option>) can be used to raise or lower the time period in seconds in which the data from this repository is considered valid. -Max can be especially useful if the repository provides no Valid-Until field on its Release file to set your own value, while -Min can be used to increase the valid time on seldom updated (local) mirrors of a more frequently updated but less accessible archive (which is in the sources.list as well) instead of disabling the check entirely.  Default to the value of the configuration options <option>Acquire::Min-ValidTime</option> and <option>Acquire::Max-ValidTime</option> which are both unset by default.
ja: <option>Valid-Until-Min</option> (<option>valid-until-min</option>) および <option>Valid-Until-Max</option> (<option>valid-until-max</option>) は、このリポジトリからのデータの有効期間 (秒単位) を上げたり下げたりするために使用することができます。リポジトリが独自の値を設定するリリースファイルに Valid-Until フィールドがないものを提供する場合、-Max は特に有用です。-Min は完全にチェックを無効にする代わりに (sources.list 同様にある) より頻繁に更新があるミラーの、あまりアクセスされないアーカイブの有効期間を増やすことができます。設定オプション <option>Acquire::Min-ValidTime</option> および <option>Acquire::Max-ValidTime</option> の値がデフォルトになり、その両方のデフォルト値は unset です。

note: type: Content of: <refentry><refsect1><title>
en: URI Specification
ja: URI の仕様

note: type: Content of: <refentry><refsect1><para>
en: The currently recognized URI types are:
ja: 現在認識できる URI タイプは以下のとおりです:

note: type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
en: The file scheme allows an arbitrary directory in the file system to be considered an archive. This is useful for NFS mounts and local mirrors or archives.
ja: file スキームは、システム内の任意のディレクトリを、アーカイブとして扱えるようにします。これは NFS マウントやローカルミラーで便利です。

note: type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
en: The copy scheme is identical to the file scheme except that packages are copied into the cache directory instead of used directly at their location.  This is useful for people using removable media to copy files around with APT.
ja: copy スキームは、file スキームと同様ですが、パッケージをその場で使用せず、キャッシュディレクトリにコピーするところが違います。リムーバブルメディアを使用していて、APT でコピーを行う場合に便利です。

note: type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
en: The rsh/ssh method invokes RSH/SSH to connect to a remote host and access the files as a given user. Prior configuration of rhosts or RSA keys is recommended. The standard <command>find</command> and <command>dd</command> commands are used to perform the file transfers from the remote host.
ja: rsh/ssh メソッドは、与えられたユーザでリモートホストに接続し、ファイルにアクセスするのに rsh/ssh を使用します。あらかじめ rhosts や RSA キーの設定をしておくことをお勧めします。リモートホストからのファイル転送に、標準の <command>find</command> コマンドと <command>dd</command> コマンドを使用します。

note: type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
en: adding more recognizable URI types
ja: さらに認識できる URI タイプの追加

note: type: Content of: <refentry><refsect1><para>
en: Uses the archive stored locally (or NFS mounted) at /home/apt/debian for stable/main, stable/contrib, stable/non-free and stable/non-free-firmware.
ja: /home/apt/debian に格納されている stable/main, stable/contrib, stable/non-free, stable/non-free-firmware 用のローカル (または NFS) アーカイブを使用します。

note: type: Content of: <refentry><refsect1><para>
en: As above, except this uses the unstable (development) distribution.
ja: 上記と同様ですが、不安定版 (開発版) を使用します。

note: type: Content of: <refentry><refsect1><para>
en: Sources specification for the above.
ja: 上記のソースの指定は以下のようになります。

note: type: Content of: <refentry><refsect1><para>
en: The first line gets package information for the architectures in <literal>APT::Architectures</literal> while the second always retrieves <literal>amd64</literal> and <literal>armel</literal>.
ja: 1 行目は <literal>APT::Architectures</literal> にあるアーキテクチャのパッケージ情報を取得し、2 行目は常に <literal>amd64</literal> アーキテクチャと <literal>armel</literal> アーキテクチャのパッケージ情報を取得します。

note: type: Content of: <refentry><refsect1><para>
en: Uses HTTP to access the archive at archive.debian.org, and uses only the hamm/main area.
ja: archive.debian.org のアーカイブに HTTP アクセスし、hamm/main のみを使用します。

note: type: Content of: <refentry><refsect1><para>
en: Uses FTP to access the archive at ftp.debian.org, under the debian directory, and uses only the &debian-stable-codename;/contrib area.
ja: ftp.debian.org のアーカイブに FTP アクセスし、debian ディレクトリ以下の &debian-stable-codename;/contrib のみを使用します。

note: type: Content of: <refentry><refsect1><para>
en: Uses FTP to access the archive at ftp.debian.org, under the debian directory, and uses only the unstable/contrib area. If this line appears as well as the one in the previous example in <filename>sources.list</filename> a single FTP session will be used for both resource lines.
ja: ftp.debian.org のアーカイブに FTP アクセスし、debian ディレクトリ以下の unstable/contrib のみを使用します。<filename>sources.list</filename> に上記サンプルと一緒に指定された場合、両方のリソース行に対応する FTP セッションはひとつだけになります。

note: type: Content of: <refentry><refsect1><para>
en: Uses HTTP to access the archive at ftp.tlh.debian.org, under the universe directory, and uses only files found under <filename>unstable/binary-i386</filename> on i386 machines, <filename>unstable/binary-amd64</filename> on amd64, and so forth for other supported architectures. [Note this example only illustrates how to use the substitution variable; official debian archives are not structured like this] <placeholder type="literallayout" id="0"/> <placeholder type="literallayout" id="1"/>
ja: ftp.tlh.debian.org のアーカイブに HTTP アクセスし、universe ディレクトリ以下を使用します。また、i386 マシンでは <filename>unstable/binary-i386</filename> 以下にあるファイル、amd64 マシンでは <filename>unstable/binary-amd64</filename> 以下にあるファイル、その他サポートするアーキテクチャごとのファイルのみ使用します。[このサンプルは変数展開の使用法の説明でしかないことに注意してください。公式 debian アーカイブはこのような構造になっていません] <placeholder type="literallayout" id="0"/> <placeholder type="literallayout" id="1"/>

note: type: Content of: <refentry><refsect1><para>
en: Uses HTTP to get binary packages as well as sources from the stable, testing and unstable suites and the components main and contrib.
ja: 安定版、テスト版、不安定版スイートからバイナリパッケージやソース、およびmain と contrib コンポーネントを入手するため HTTP を使用しています。

note: type: Content of: <refentry><refnamediv><refpurpose>
en: Utility to extract <command>debconf</command> config and templates from Debian packages
ja: Debian パッケージから <command>debconf</command> の設定とテンプレートを抽出するユーティリティ

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-extracttemplates</command> will take one or more Debian package files as input and write out (to a temporary directory) all associated config scripts and template files. For each passed in package that contains config scripts and templates, one line of output will be generated in the format:
ja: <command>apt-extracttemplates</command> は、入力に複数の Debian パッケージをとり、関連する設定スクリプトとテンプレートファイルを (一時ディレクトリに) 出力します。設定スクリプト・テンプレートファイルを持つ、渡されたパッケージそれぞれに対し、以下の形式で 1 行ずつ出力します。

note: type: Content of: <refentry><refsect1><para>
en: template-file and config-script are written to the temporary directory specified by the <option>-t</option> or <option>--tempdir</option> (<literal>APT::ExtractTemplates::TempDir</literal>) directory, with filenames of the form <filename>package.template.XXXXXX</filename> and <filename>package.config.XXXXXX</filename>
ja: テンプレートファイルや、設定スクリプトは、<option>-t</option> や <option>--tempdir</option> で指定した一時ディレクトリ (<literal>APT::ExtractTemplates::TempDir</literal>) に書き出され、ファイル名は、<filename>package.template.XXXXXX</filename> や <filename>package.config.XXXXXX</filename> といった形になります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Temporary directory in which to write extracted <command>debconf</command> template files and config scripts.  Configuration Item: <literal>APT::ExtractTemplates::TempDir</literal>
ja: 抽出した <command>debconf</command> テンプレートファイルや設定スクリプトを書き出す一時ディレクトリ。設定項目: <literal>APT::ExtractTemplates::TempDir</literal>

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-extracttemplates</command> returns zero on normal operation, decimal 100 on error.
ja: <command>apt-extracttemplates</command> は正常終了時に 0 を返します。エラー時には十進の 100 を返します。

note: type: Content of: <refentry><refnamediv><refpurpose>
en: Utility to sort package index files
ja: パッケージインデックスファイルのソートユーティリティ

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-sortpkgs</command> will take an index file (source index or package index) and sort the records so that they are ordered by the package name.  It will also sort the internal fields of each record according to the internal sorting rules.
ja: <command>apt-sortpkgs</command> は、インデックスファイル (ソースインデックスやパッケージインデックス) からレコードをソートし、パッケージ名順に整えます。また、内部のソート規則に従って、内部フィールドについてもソートを行います。

note: type: Content of: <refentry><refsect1><para>
en: All output is sent to standard output; the input must be a seekable file.
ja: 出力はすべて標準出力に送られ、入力は検索できるファイルでなければなりません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Use source index field ordering.  Configuration Item: <literal>APT::SortPkgs::Source</literal>.
ja: ソースインデックスフィールド順に並べ替えに使用します。設定項目: <literal>APT::SortPkgs::Source</literal>

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-sortpkgs</command> returns zero on normal operation, decimal 100 on error.
ja: <command>apt-sortpkgs</command> は正常終了時に 0 を返します。エラー時には十進の 100 を返します。

note: type: Content of: <refentry><refnamediv><refpurpose>
en: Utility to generate index files
ja: インデックスファイル生成ユーティリティ

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-ftparchive</command> is the command line tool that generates the index files that APT uses to access a distribution source. The index files should be generated on the origin site based on the content of that site.
ja: <command>apt-ftparchive</command> は、APT が取得元にアクセスするのに必要な、インデックスファイルを生成するコマンドラインツールです。インデックスファイルは、元のサイトの内容に基づき生成されるべきです。

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-ftparchive</command> is a superset of the &dpkg-scanpackages; program, incorporating its entire functionality via the <literal>packages</literal> command.  It also contains a contents file generator, <literal>contents</literal>, and an elaborate means to 'script' the generation process for a complete archive.
ja: <command>apt-ftparchive</command> は、&dpkg-scanpackages; プログラムのスーパーセットで、<literal>packages</literal> コマンド経由で機能全体を取り込んでいます。また、contents ファイルジェネレータ <literal>contents</literal> と完全なアーカイブの生成プロセス「スクリプト」である綿密な手段を含んでいます。

note: type: Content of: <refentry><refsect1><para>
en: Internally <command>apt-ftparchive</command> can make use of binary databases to cache the contents of a .deb file and it does not rely on any external programs aside from &gzip;. When doing a full generate it automatically performs file-change checks and builds the desired compressed output files.
ja: 本質的に <command>apt-ftparchive</command> は、.deb ファイルの内容をキャッシュするのにバイナリデータベースを使用できます。また、&gzip; 以外のいかなる外部プログラムにも依存しません。すべて生成する際には、ファイル変更点の検出と希望した圧縮出力ファイルの作成を自動的に実行します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The packages command generates a package file from a directory tree. It takes the given directory and recursively searches it for .deb files, emitting a package record to stdout for each. This command is approximately equivalent to &dpkg-scanpackages;.
ja: packages コマンドは、ディレクトリツリーからパッケージファイルを生成します。与えられたディレクトリから再帰検索し、.deb ファイルを取得します。またパッケージレコードを標準出力にそれぞれ出力します。このコマンドは、&dpkg-scanpackages; とほぼ同じです。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The option <option>--db</option> can be used to specify a binary caching DB.
ja: <option>--db</option> オプションで、キャッシュ DB を指定できます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The <literal>sources</literal> command generates a source index file from a directory tree.  It takes the given directory and recursively searches it for .dsc files, emitting a source record to stdout for each. This command is approximately equivalent to &dpkg-scansources;.
ja: <literal>sources</literal> コマンドは、ディレクトリツリーからソースインデックスファイルを生成します。与えられたディレクトリから再帰検索し、.dsc ファイルを取得します。またソースレコードを標準出力にそれぞれ出力します。このコマンドは、&dpkg-scansources; とほぼ同じです。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: If an override file is specified then a source override file will be looked for with an extension of .src. The --source-override option can be used to change the source override file that will be used.
ja: override ファイルを指定した場合、src 拡張子がついたソースオーバーライドファイルを探します。使用するソースオーバーライドファイルを変更するのには、--source-override オプションを使用します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The <literal>contents</literal> command generates a contents file from a directory tree. It takes the given directory and recursively searches it for .deb files, and reads the file list from each file. It then sorts and writes to stdout the list of files matched to packages. Directories are not written to the output. If multiple packages own the same file then each package is separated by a comma in the output.
ja: <literal>contents</literal> コマンドは、ディレクトリツリーからコンテンツファイルを生成します。与えられたディレクトリから再帰検索し、.deb ファイルを取得します。またファイルごとにファイル一覧を読み取ります。その後、パッケージに対応するファイル一覧を標準出力にソートして出力します。ディレクトリは出力に含まれません。複数のパッケージが同じファイルを持つ場合、パッケージ名をカンマ区切りで出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The <literal>release</literal> command generates a Release file from a directory tree. It recursively searches the given directory for uncompressed and compressed <filename>Packages</filename>, <filename>Sources</filename>, <filename>Contents</filename>, <filename>Components</filename> and <filename>icons</filename> files as well as <filename>Release</filename>, <filename>Index</filename> and <filename>md5sum.txt</filename> files by default (<literal>APT::FTPArchive::Release::Default-Patterns</literal>).  Additional filename patterns can be added by listing them in <literal>APT::FTPArchive::Release::Patterns</literal>.  It then writes to stdout a <filename>Release</filename> file containing (by default) an MD5, SHA1, SHA256 and SHA512 digest for each file.
ja: <literal>release</literal> コマンドは、ディレクトリツリーから Release ファイルを生成します。与えたディレクトリを再帰的に検索し、未圧縮の <filename>Packages</filename>, <filename>Sources</filename>, <filename>Contents</filename>, <filename>Components</filename>, <filename>icons</filename> 各ファイル、それに <filename>Release</filename>, <filename>Index</filename>, <filename>md5sum.txt</filename> ファイルをデフォルト (<literal>APT::FTPArchive::Release::Default-Patterns</literal>) で探します。また <literal>APT::FTPArchive::Release::Patterns</literal> に列挙して、さらにファイル名のパターンを追加できます。その後、(デフォルトで) MD5, SHA1, SHA256 と SHA512 の各ダイジェストをファイルごとに格納した <filename>Release</filename> ファイルを標準出力に書き出します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Values for the additional metadata fields in the Release file are taken from the corresponding variables under <literal>APT::FTPArchive::Release</literal>, e.g. <literal>APT::FTPArchive::Release::Origin</literal>. The supported fields are <literal>Origin</literal>, <literal>Label</literal>, <literal>Suite</literal>, <literal>Version</literal>, <literal>Codename</literal>, <literal>Date</literal>, <literal>NotAutomatic</literal>, <literal>ButAutomaticUpgrades</literal>, <literal>Acquire-By-Hash</literal>, <literal>Valid-Until</literal>, <literal>Signed-By</literal>, <literal>Architectures</literal>, <literal>Components</literal> and <literal>Description</literal>.
ja: Release ファイルの追加メタデータフィールドの値は、<literal>APT::FTPArchive::Release</literal> 以下の相当する値 (例: <literal>APT::FTPArchive::Release::Origin</literal>) をとります。サポートするフィールドは、<literal>Origin</literal>, <literal>Label</literal>, <literal>Suite</literal>, <literal>Version</literal>, <literal>Codename</literal>, <literal>Date</literal>, <literal>NotAutomatic</literal>, <literal>ButAutomaticUpgrades</literal>, <literal>Acquire-By-Hash</literal>, <literal>Valid-Until</literal>, <literal>Signed-By</literal>, <literal>Architectures</literal>, <literal>Components</literal>, <literal>Description</literal> です。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The <literal>generate</literal> command is designed to be runnable from a cron script and builds indexes according to the given config file. The config language provides a flexible means of specifying which index files are built from which directories, as well as providing a simple means of maintaining the required settings.
ja: <literal>generate</literal> コマンドは、cron スクリプトから実行できるよう設計されており、与えられた設定ファイルに従ってインデックスを生成します。設定言語は、必要な設定を維持する簡単な方法を提供すると共に、インデックスファイルをどのディレクトリから作成するかを指定する、柔軟な方法を提供します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The <literal>clean</literal> command tidies the databases used by the given configuration file by removing any records that are no longer necessary.
ja: <literal>clean</literal> コマンドは、設定ファイルで与えられたデータベースを、もう必要ないレコードを削除して整理します。

note: type: Content of: <refentry><refsect1><title>
en: The Generate Configuration
ja: Generate 設定

note: type: Content of: <refentry><refsect1><para>
en: The <literal>generate</literal> command uses a configuration file to describe the archives that are going to be generated. It follows the typical ISC configuration format as seen in ISC tools like bind 8 and dhcpd.  &apt-conf; contains a description of the syntax. Note that the generate configuration is parsed in sectional manner, but &apt-conf; is parsed in a tree manner. This only effects how the scope tag is handled.
ja: <literal>generate</literal> コマンドは、生成するアーカイブに関する記述をした設定ファイルを使用します。設定ファイルは、bind 8 や dhcpd といった ISC ツールに見られるような、ISC 設定フォーマットに従います。&apt-conf; に、構文の説明があります。Generate 設定はセクション法で解析しますが、&apt-conf; はツリー法で解析するのに注意してください。これはスコープタグの扱い方に違いがあるだけです。

note: type: Content of: <refentry><refsect1><para>
en: The generate configuration has four separate sections, each described below.
ja: generate 設定には 4 個の独立したセクションがあります。以下それぞれ説明します。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: <literal>Dir</literal> Section
ja: <literal>Dir</literal> セクション

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The <literal>Dir</literal> section defines the standard directories needed to locate the files required during the generation process. These directories are prepended certain relative paths defined in later sections to produce a complete an absolute path.
ja: <literal>Dir</literal> セクションは、生成プロセスで必要なファイルを配置するために必要な、標準ディレクトリを定義します。このディレクトリは、完全な絶対パスを生成するため、後のセクションで定義される相対パスの前に結合されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies the root of the FTP archive, in a standard Debian configuration this is the directory that contains the <filename>ls-LR</filename> and dist nodes.
ja: FTP アーカイブのルートを指定します。標準的な Debian 設定では、このディレクトリには <filename>ls-LR</filename> と dist ノードがあります。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies the location of the override files.
ja: オーバーライドファイルの場所を指定します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies the location of the cache files.
ja: キャッシュファイルの場所を指定します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies the location of the file list files, if the <literal>FileList</literal> setting is used below.
ja: <literal>FileList</literal> 設定が以下で使用されている場合、ファイルリストファイルの場所を指定します。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: <literal>Default</literal> Section
ja: <literal>Default</literal> セクション

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The <literal>Default</literal> section specifies default values, and settings that control the operation of the generator. Other sections may override these defaults with a per-section setting.
ja: <literal>Default</literal> セクションではデフォルト値を指定します。また、生成器の動作を制御する設定も行います。他のセクションでは、ここにあるデフォルト値を、セクションごとの設定で上書きします。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the default compression schemes to use for the package index files. It is a string that contains a space separated list of at least one of the compressors configured via the <option>APT::Compressor</option> configuration scope.  The default for all compression schemes is '. gzip'.
ja: パッケージインデックスファイルのデフォルト圧縮方法を設定します。設定項目 <option>APT::Compressor</option> によって設定した圧縮形式の最低1つが入る、空白区切りの文字列です。圧縮方法のデフォルトはすべて '. gzip' です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the default list of file extensions that are package files.  This defaults to '.deb'.
ja: パッケージファイル拡張子のデフォルト値を列挙します。このデフォルト値は '.deb' です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: This is similar to <literal>Packages::Compress</literal> except that it controls the compression for the Sources files.
ja: <literal>Packages::Compress</literal> と同様に、Sources ファイルの圧縮方法を指定します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the default list of file extensions that are source files.  This defaults to '.dsc'.
ja: ソースファイル拡張子のデフォルト値を列挙します。このデフォルト値は '.dsc' です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: This is similar to <literal>Packages::Compress</literal> except that it controls the compression for the Contents files.
ja: <literal>Packages::Compress</literal> と同様に、Contents ファイルの圧縮方法を指定します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: This is similar to <literal>Packages::Compress</literal> except that it controls the compression for the Translation-en master file.
ja: <literal>Packages::Compress</literal> と同様に、Translation-en マスターファイルの圧縮を制御します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies the number of kilobytes to delink (and replace with hard links) per run. This is used in conjunction with the per-section <literal>External-Links</literal> setting.
ja: 実行するごとに delink (及びハードリンクの置き換え) する量を、キロバイト単位で指定します。セクションごとの <literal>External-Links</literal> 設定と合わせて使います。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies the mode of all created index files. It defaults to 0644. All index files are set to this mode with no regard to the umask.
ja: 作成したインデックスファイルのモードを指定します。デフォルトは 0644 です。全インデックスファイルは、umask を無視してこのモードを使用します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies whether long descriptions should be included in the <filename>Packages</filename> file or split out into a master <filename>Translation-en</filename> file.
ja: 長い説明文を <filename>Packages</filename> ファイルに含めるか、マスター <filename>Translation-en</filename> ファイルに分割するかを指定します。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: <literal>TreeDefault</literal> Section
ja: <literal>TreeDefault</literal> セクション

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Sets defaults specific to <literal>Tree</literal> sections. All of these variables are substitution variables and have the strings $(DIST), $(SECTION) and $(ARCH) replaced with their respective values.
ja: 特定の <literal>Tree</literal> セクションのデフォルトを設定します。これらの変数はすべて置換変数であり、文字列 $(DIST), $(SECTION), $(ARCH) をそれぞれの値に展開します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the number of kilobytes of contents files that are generated each day. The contents files are round-robined so that over several days they will all be rebuilt.
ja: 日毎に生成する contents ファイルをキロバイト単位で設定します。contents ファイルをラウンドロビンし、数日経つとすべて再生成します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Controls the number of days a contents file is allowed to be checked without changing. If this limit is passed the mtime of the contents file is updated. This case can occur if the package file is changed in such a way that does not result in a new contents file [override edit for instance]. A hold off is allowed in hopes that new .debs will be installed, requiring a new file anyhow. The default is 10, the units are in days.
ja: 変更がない contents ファイルをチェックする日数を指定します。この制限を越えた contents ファイルの mtime を、更新します。パッケージファイルが変更されても、[例えば上書き編集で] contents ファイルが更新されないような場合、こういったことが発生します。新しい .deb ファイルをインストールしたい場合、保留を解除でき、少なくとも新しいファイルが必要です。デフォルトは 10 で、単位は日です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the top of the .deb directory tree. Defaults to <filename>$(DIST)/$(SECTION)/binary-$(ARCH)/</filename>
ja: .deb ディレクトリツリーの先頭を設定します。デフォルトは <filename>$(DIST)/$(SECTION)/binary-$(ARCH)/</filename> です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the top of the source package directory tree. Defaults to <filename>$(DIST)/$(SECTION)/source/</filename>
ja: ソースパッケージディレクトリツリーの先頭を設定します。デフォルトは <filename>$(DIST)/$(SECTION)/source/</filename> です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the output Packages file. Defaults to <filename>$(DIST)/$(SECTION)/binary-$(ARCH)/Packages</filename>
ja: Packages ファイルの出力先を設定します。デフォルトは <filename>$(DIST)/$(SECTION)/binary-$(ARCH)/Packages</filename> です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the output Sources file. Defaults to <filename>$(DIST)/$(SECTION)/source/Sources</filename>
ja: Sources ファイルの出力先を設定します。デフォルトは <filename>$(DIST)/$(SECTION)/source/Sources</filename> です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the output Translation-en master file with the long descriptions if they should be not included in the Packages file. Defaults to <filename>$(DIST)/$(SECTION)/i18n/Translation-en</filename>
ja: 万一 Packages ファイルに含まれていない場合、長い説明文がある Translation-en マスターファイルの出力先を設定します。デフォルトは、<filename>$(DIST)/$(SECTION)/i18n/Translation-en</filename> です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the path prefix that causes a symlink to be considered an internal link instead of an external link. Defaults to <filename>$(DIST)/$(SECTION)/</filename>
ja: 外部リンクではなく、内部リンクと見なす判断材料となる、パスのプレフィックスを設定します。デフォルトは、<filename>$(DIST)/$(SECTION)/</filename> です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the output Contents file. Defaults to <filename>$(DIST)/$(SECTION)/Contents-$(ARCH)</filename>. If this setting causes multiple Packages files to map onto a single Contents file (as is the default)  then <command>apt-ftparchive</command> will integrate those package files together automatically.
ja: Contents ファイルの出力先を設定します。デフォルトは、<filename>$(DIST)/$(SECTION)/Contents-$(ARCH)</filename> です。複数の Packages ファイルをひとつの Contents ファイルにまとめられる設定 (デフォルト) の場合、<command>apt-ftparchive</command> は自動でパッケージファイルをまとめます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets header file to prepend to the contents output.
ja: contents の出力に付けるヘッダファイルを設定します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the binary cache database to use for this section. Multiple sections can share the same database.
ja: このセクションで使用するバイナリキャッシュデータベースを設定します。複数のセクションで同じデータベースを共有できます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies that instead of walking the directory tree, <command>apt-ftparchive</command> should read the list of files from the given file. Relative files names are prefixed with the archive directory.
ja: ディレクトリツリーを走査する代わりに、<command>apt-ftparchive</command> が読み込むファイル一覧ファイルを指定します。相対ファイル名は、アーカイブディレクトリが先頭につきます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies that instead of walking the directory tree, <command>apt-ftparchive</command> should read the list of files from the given file. Relative files names are prefixed with the archive directory.  This is used when processing source indexes.
ja: ディレクトリツリーを走査する代わりに、<command>apt-ftparchive</command> が読み込むファイル一覧ファイルを指定します。相対ファイル名は、アーカイブディレクトリが先頭につきます。ソースインデックスを処理する際に使用します。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: <literal>Tree</literal> Section
ja: <literal>Tree</literal> セクション

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The <literal>Tree</literal> section defines a standard Debian file tree which consists of a base directory, then multiple sections in that base directory and finally multiple Architectures in each section. The exact pathing used is defined by the <literal>Directory</literal> substitution variable.
ja: <literal>Tree</literal> セクションでは、ベースディレクトリからの標準 Debian ファイルツリー、ベースディレクトリの複数のセクション、最終的にはセクションごとの複数のアーキテクチャを定義します。使用する正確なパスは、<literal>Directory</literal> 変数で定義されます。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The <literal>Tree</literal> section takes a scope tag which sets the <literal>$(DIST)</literal> variable and defines the root of the tree (the path is prefixed by <literal>ArchiveDir</literal>).  Typically this is a setting such as <filename>dists/&debian-stable-codename;</filename>.
ja: <literal>Tree</literal> セクションは、<literal>$(DIST)</literal> 変数で設定されているスコープタグをとり、ツリーのルート (<literal>ArchiveDir</literal>が先頭につくパス) を定義します。通常、この設定は <filename>dists/&debian-stable-codename;</filename> のようになります。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: All of the settings defined in the <literal>TreeDefault</literal> section can be used in a <literal>Tree</literal> section as well as three new variables.
ja: <literal>TreeDefault</literal> セクションで定義される設定はすべて、3 個の新しい変数と同様に、<literal>Tree</literal> セクションで使用できます。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: When processing a <literal>Tree</literal> section <command>apt-ftparchive</command> performs an operation similar to: <placeholder type="programlisting" id="0"/>
ja: <literal>Tree</literal> セクションを処理する際、<command>apt-ftparchive</command> は以下のような操作を行います。<placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: This is a space separated list of sections which appear under the distribution; typically this is something like <literal>main contrib non-free non-free-firmware</literal>
ja: distribution 以下に現れるセクションを、空白区切りで指定したリストです。通常、<literal>main contrib non-free non-free-firmware</literal> のようになります。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: This is a space separated list of all the architectures that appear under search section. The special architecture 'source' is used to indicate that this tree has a source archive.  The architecture 'all' signals that architecture specific files like <filename>Packages</filename> should not include information about architecture <literal>all</literal> packages in all files as they will be available in a dedicated file.
ja: 検索部の下に表示されるすべてのアーキテクチャの空白区切りリストです。特別なアーキテクチャ「source」は、このツリーがソースアーカイブを持っていることを示すために使用されます。アーキテクチャ「all」は、<filename>Packages</filename> のようなアーキテクチャ固有のファイルがすべてのファイル中のアーキテクチャ <literal>all</literal> パッケージに関する情報を含まず、専用のファイルで利用できることを示します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the binary override file. The override file contains section, priority and maintainer address information.
ja: バイナリオーバーライドファイルを設定します。このオーバーライドファイルには、セクション、優先度、メンテナのアドレスといった情報が含まれています。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the source override file. The override file contains section information.
ja: ソースオーバーライドファイルを設定します。このオーバーライドファイルには、セクションの情報が含まれています。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the binary extra override file.
ja: バイナリ特別オーバーライドファイルを設定します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the source extra override file.
ja: ソース特別オーバーライドファイルを設定します。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: <literal>BinDirectory</literal> Section
ja: <literal>BinDirectory</literal> セクション

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The <literal>bindirectory</literal> section defines a binary directory tree with no special structure. The scope tag specifies the location of the binary directory and the settings are similar to the <literal>Tree</literal> section with no substitution variables or <literal>Section</literal><literal>Architecture</literal> settings.
ja: <literal>bindirectory</literal> セクションでは、特殊な構造を持たないバイナリディレクトリツリーを定義します。スコープタグはバイナリディレクトリの場所を指定し、設定は変数展開のない <literal>Tree</literal> セクションや <literal>Section</literal><literal>Architecture</literal> 設定に似ています。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the Packages file output.
ja: Packages ファイルの出力先を設定します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the Sources file output. At least one of <literal>Packages</literal> or <literal>Sources</literal> is required.
ja: Sources ファイルの出力先を設定します。少なくとも <literal>Packages</literal> か <literal>Sources</literal> のうち、ひとつは必要です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the Contents file output (optional).
ja: Contents ファイルの出力先を設定します (オプション)。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the binary override file.
ja: バイナリオーバーライドファイルを設定します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the source override file.
ja: ソースオーバーライドファイルを設定します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the cache DB.
ja: キャッシュ DB を設定します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Appends a path to all the output paths.
ja: 全出力パスに付加するパス。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies the file list file.
ja: ファイル一覧ファイルを指定します。

note: type: Content of: <refentry><refsect1><title>
en: The Binary Override File
ja: バイナリオーバーライドファイル

note: type: Content of: <refentry><refsect1><para>
en: The binary override file is fully compatible with &dpkg-scanpackages;. It contains four fields separated by spaces. The first field is the package name, the second is the priority to force that package to, the third is the section to force that package to and the final field is the maintainer permutation field.
ja: バイナリオーバーライドファイルは、&dpkg-scanpackages; と完全に互換性があります。ここには、空白区切りでフィールドが 4 個あります。先頭のフィールドはパッケージ名、2 番目のフィールドはパッケージに強制する優先度、3 番目のフィールドはパッケージに強制するセクション、最後のフィールドはメンテナ順列フィールドです。

note: type: Content of: <refentry><refsect1><para>
en: The general form of the maintainer field is: <placeholder type="literallayout" id="0"/> or simply, <placeholder type="literallayout" id="1"/> The first form allows a double-slash separated list of old email addresses to be specified. If any of those are found then new is substituted for the maintainer field. The second form unconditionally substitutes the maintainer field.
ja: メンテナフィールドの一般的な形は以下のようになります。<placeholder type="literallayout" id="0"/> また単純に以下のようにもなります。<placeholder type="literallayout" id="1"/>最初の形式は、// で区切られた古い email アドレスのリストを許可します。この形式がある場合は、メンテナフィールドになるよう new に置換してください。2 番目の形式は無条件にメンテナフィールドに置換します。

note: type: Content of: <refentry><refsect1><title>
en: The Source Override File
ja: ソースオーバーライドファイル

note: type: Content of: <refentry><refsect1><para>
en: The source override file is fully compatible with &dpkg-scansources;. It contains two fields separated by spaces. The first field is the source package name, the second is the section to assign it.
ja: ソースオーバーライドファイルは、&dpkg-scansources; と完全に互換性があります。ここには、空白区切りでフィールドが 2 個あります。先頭のフィールドはソースパッケージ名、2 番目のフィールドは割り当てるセクションです。

note: type: Content of: <refentry><refsect1><title>
en: The Extra Override File
ja: 特別オーバーライドファイル

note: type: Content of: <refentry><refsect1><para>
en: The extra override file allows any arbitrary tag to be added or replaced in the output. It has three columns, the first is the package, the second is the tag and the remainder of the line is the new value.
ja: 特別オーバーライドファイルは、出力中に任意のタグを追加・置換できるようにします。3 列からなり、先頭はパッケージ、2番目はタグ、残りは新しい値です。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Generate the given checksum. These options default to on, when turned off the generated index files will not have the checksum fields where possible.  Configuration Items: <literal>APT::FTPArchive::<replaceable>Checksum</replaceable></literal> and <literal>APT::FTPArchive::<replaceable>Index</replaceable>::<replaceable>Checksum</replaceable></literal> where <literal><replaceable>Index</replaceable></literal> can be <literal>Packages</literal>, <literal>Sources</literal> or <literal>Release</literal> and <literal><replaceable>Checksum</replaceable></literal> can be <literal>MD5</literal>, <literal>SHA1</literal>, <literal>SHA256</literal> or <literal>SHA512</literal>.
ja: 与えたチェックサムを生成します。このオプションはデフォルトで on です。off にすると生成したインデックスファイルには checksum フィールドが含まれません。設定項目: <literal>APT::FTPArchive::<replaceable>Checksum</replaceable></literal> と <literal>APT::FTPArchive::<replaceable>Index</replaceable>::<replaceable>Checksum</replaceable></literal>。ここで <literal><replaceable>Index</replaceable></literal> は <literal>Packages</literal>, <literal>Sources</literal>, <literal>Release</literal> になります。<literal><replaceable>Checksum</replaceable></literal> は <literal>MD5</literal>, <literal>SHA1</literal>, <literal>SHA256</literal> または <literal>SHA512</literal> になります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Use a binary caching DB. This has no effect on the generate command.  Configuration Item: <literal>APT::FTPArchive::DB</literal>.
ja: バイナリキャッシュ DB を使用します。generate コマンドには影響しません。設定項目: <literal>APT::FTPArchive::DB</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Quiet; produces output suitable for logging, omitting progress indicators.  More q's will produce more quiet up to a maximum of 2. You can also use <option>-q=#</option> to set the quiet level, overriding the configuration file.  Configuration Item: <literal>quiet</literal>.
ja: 静粛 - 進捗表示を省略し、ログをとるのに便利な出力を行います。最大 2 つまで q を重ねることでより静粛にできます。また、<option>-q=#</option> のように静粛レベルを指定して、設定ファイルを上書きすることもできます。設定項目: <literal>quiet</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Perform Delinking. If the <literal>External-Links</literal> setting is used then this option actually enables delinking of the files. It defaults to on and can be turned off with <option>--no-delink</option>.  Configuration Item: <literal>APT::FTPArchive::DeLinkAct</literal>.
ja: Delink を実行します。<literal>External-Links</literal> 設定を使用している場合、このオプションはファイルの delink を有効にします。デフォルトは on で、off にするには <option>--no-delink</option> としてください。設定項目: <literal>APT::FTPArchive::DeLinkAct</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Perform contents generation. When this option is set and package indexes are being generated with a cache DB then the file listing will also be extracted and stored in the DB for later use. When using the generate command this option also allows the creation of any Contents files. The default is on.  Configuration Item: <literal>APT::FTPArchive::Contents</literal>.
ja: contents の生成を行います。このオプションを指定し、パッケージインデックスをキャッシュ DB と共に生成する際、ファイルリストを後で使用するように、抽出し DB に格納します。generate コマンドを使用する際、このオプションでいずれの Contents ファイルも作成できます。デフォルトは on です。設定項目: <literal>APT::FTPArchive::Contents</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Select the source override file to use with the <literal>sources</literal> command.  Configuration Item: <literal>APT::FTPArchive::SourceOverride</literal>.
ja: <literal>sources</literal> コマンドで使用する、ソースオーバーライドファイルを選択します。設定項目: <literal>APT::FTPArchive::SourceOverride</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Make the caching databases read only.  Configuration Item: <literal>APT::FTPArchive::ReadOnlyDB</literal>.
ja: キャッシュデータベースを読み取り専用にします。設定項目: <literal>APT::FTPArchive::ReadOnlyDB</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Accept in the <literal>packages</literal> and <literal>contents</literal> commands only package files matching <literal>*_arch.deb</literal> or <literal>*_all.deb</literal> instead of all package files in the given path.  Configuration Item: <literal>APT::FTPArchive::Architecture</literal>.
ja: <literal>packages</literal> コマンドや <literal>contents</literal> コマンドで、与えたパスにあるすべてのパッケージファイルではなく、<literal>*_arch.deb</literal> や <literal>*_all.deb</literal> に一致したパッケージファイルのみを受け付けます。設定項目: <literal>APT::FTPArchive::Architecture</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: &apt-ftparchive; caches as much as possible of metadata in a cachedb. If packages are recompiled and/or republished with the same version again, this will lead to problems as the now outdated cached metadata like size and checksums will be used. With this option enabled this will no longer happen as it will be checked if the file was changed.  Note that this option is set to "<literal>false</literal>" by default as it is not recommend to upload multiple versions/builds of a package with the same version number, so in theory nobody will have these problems and therefore all these extra checks are useless.
ja: &apt-ftparchive; は cachedb のメタデータに可能な限りキャッシュします。パッケージを再コンパイルし、また同じバージョンで再発行されると、古くなってしまったキャッシュのメタデータ (サイズやチェックサム) が使われ、これが問題になることがあります。このオプションを有効にすると、ファイルを更新するとチェックが行われるため、問題が起こらなくなります。デフォルトでは、このオプションは "<literal>false</literal>" にセットされていることに注意してください。バージョンや、同じバージョン番号のパッケージのビルドを、増やしてアップロードするのは推奨しないからです。そのため理論上、誰もその問題に行き会わず、すべての追加チェックには、意味がありません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This configuration option defaults to "<literal>true</literal>" and should only be set to <literal>"false"</literal> if the Archive generated with &apt-ftparchive; also provides <filename>Translation</filename> files. Note that the <filename>Translation-en</filename> master file can only be created in the generate command.
ja: この設定オプションはデフォルトで "<literal>true</literal>" で、&apt-ftparchive; が生成したアーカイブが <filename>Translation</filename> ファイルも提供する場合にのみ <literal>"false"</literal> に設定してください。<filename>Translation-en</filename> マスターファイルは generate コマンドでのみ生成できることに注意してください。

note: type: Content of: <refentry><refsect1><para>
en: To create a compressed Packages file for a directory containing binary packages (.deb): <placeholder type="programlisting" id="0"/>
ja: バイナリパッケージ (.deb) があるディレクトリの Packages ファイルを生成するには、以下のようにします。<placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-ftparchive</command> returns zero on normal operation, decimal 100 on error.
ja: <command>apt-ftparchive</command> は正常終了時に 0 を返します。エラー時には十進の 100 を返します。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: <literal>Acquire::http::AllowRedirect</literal> controls whether APT will follow redirects, which is enabled by default.
ja: <literal>Acquire::http::AllowRedirect</literal> は APT がリダイレクトをたどるかどうかを制御します。デフォルトでは有効です。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: <literal>Acquire::http::User-Agent</literal> can be used to set a different User-Agent for the http download method as some proxies allow access for clients only if the client uses a known identifier.
ja: クライアントが既知の識別子を使用する場合にのみ、プロキシがアクセスを許可する場合、<literal>Acquire::http::User-Agent</literal> を使用して、http でダウンロードするための、異なる User-Agent を設定できます。

note: type: Attribute 'lang' of: <book>
en: en
ja: ja

note: type: Content of: <book><title>
en: APT User's Guide
ja: APT ユーザガイド

note: type: Content of: <book><bookinfo><releaseinfo>
en: Version &apt-product-version;
ja: バージョン &apt-product-version;

note: type: Content of: <book><bookinfo><legalnotice><title>
en: License Notice
ja: ライセンスについて

note: type: Content of: <book><chapter><title>
en: General
ja: 全般

note: type: Content of: <book><chapter><para>
en: The APT package currently contains two sections, the APT <command>dselect</command> method and the <command>apt-get</command> command line user interface. Both provide a way to install and remove packages as well as download new packages from the Internet.
ja: APT パッケージは現在、APT <command>dselect</command> メソッドと <command>apt-get</command> コマンドラインユーザインターフェイスの2つを収録しています。両方ともインターネットから新しいパッケージをダウンロードするのと同様、パッケージをインストール、削除する方法を提供しています。

note: type: Content of: <book><chapter><section><title>
en: Anatomy of the Package System
ja: パッケージシステムの構造

note: type: Content of: <book><chapter><section><para>
en: The Debian packaging system has a large amount of information associated with each package to help assure that it integrates cleanly and easily into the system. The most prominent of its features is the dependency system.
ja: Debian パッケージシステムには各パッケージに関連する膨大な情報があり、システムに手際良く簡単に統合することを支援します。その最も重要な機能は依存システムです。

note: type: Content of: <book><chapter><section><para>
en: The dependency system allows individual programs to make use of shared elements in the system such as libraries. It simplifies placing infrequently used portions of a program in separate packages to reduce the number of things the average user is required to install. Also, it allows for choices in mail transport agents, X servers and so on.
ja: 依存システムにより、システムにあるライブラリ等の共有要素を個々のプログラムを使えるようになります。簡単に言うと、プログラムのうちまれに利用される部分を別個のパッケージに配置して、平均的ユーザがインストールを必要とするものの数を減らします。また、メール転送エージェントや X サーバ等の選択ができるようにもなります。

note: type: Content of: <book><chapter><section><para>
en: The first step to understanding the dependency system is to grasp the concept of a simple dependency. The meaning of a simple dependency is that a package requires another package to be installed at the same time to work properly.
ja: 依存システムの理解はまず単純な依存の概念を把握することから始まります。単純な依存というのは、あるパッケージが適切に機能するためには別のパッケージが同時にインストールされている必要があるということです。

note: type: Content of: <book><chapter><section><para>
en: For instance, mailcrypt is an emacs extension that aids in encrypting email with GPG. Without GPGP installed mailcrypt is useless, so mailcrypt has a simple dependency on GPG. Also, because it is an emacs extension it has a simple dependency on emacs, without emacs it is completely useless.
ja: 例えば mailcrypt は emacs を拡張するプログラムで、GPG によるメールの暗号化を支援します。GPGP がインストールされていなければ mailcrypt は役に立たないので mailcrypt には GPG に単純に依存しています。また、これは emacs の拡張なので emacs に単純に依存し、emacs がないと何の役にも立ちません。

note: type: Content of: <book><chapter><section><para>
en: The other important dependency to understand is a conflicting dependency. It means that a package, when installed with another package, will not work and may possibly be extremely harmful to the system. As an example consider a mail transport agent such as sendmail, exim or qmail. It is not possible to have two mail transport agents installed because both need to listen to the network to receive mail. Attempting to install two will seriously damage the system so all mail transport agents have a conflicting dependency with all other mail transport agents.
ja: 理解しておかないといけないもう一つの重要な依存に競合する依存があります。これはあるパッケージが別のパッケージと同時にインストールされていると機能せず、システムにとってひどく有害なこともあります。例として sendmail や exim、qmail 等のメール転送エージェントで考えてみましょう。メール転送エージェントはどれもメールを受け取るのにネットワークを待ち受ける必要があるため、2つインストールすることは不可能です。複数インストールするとシステムに重大な被害を与える可能性があるため、メール転送エージェントはどれも他のあらゆるメール転送エージェントと競合依存となっています。

note: type: Content of: <book><chapter><section><para>
en: As an added complication there is the possibility for a package to pretend to be another package. Consider that exim and sendmail for many intents are identical, they both deliver mail and understand a common interface. Hence, the package system has a way for them to declare that they are both mail-transport-agents. So, exim and sendmail both declare that they provide a mail-transport-agent and other packages that need a mail transport agent depend on mail-transport-agent. This can add a great deal of confusion when trying to manually fix packages.
ja: 複雑な例としては、別のパッケージのように装うパッケージがあります。exim と sendmail について見てみると、その多くの目的は同一で、両方ともメールを配送し、一般的インターフェイスを解釈します。そこで、パッケージシステムにはどちらも mail-transport-agents だと宣言する方法があります。そうして exim と sendmail は両方とも mail-transport-agent を提供すると宣言し、他のメール転送エージェントを必要とするパッケージは mail-transport-agent に依存します。手作業によりパッケージを修正しようとしたときに多大な混乱が生まれる可能性があります。

note: type: Content of: <book><chapter><section><para>
en: At any given time a single dependency may be met by packages that are already installed or it may not be. APT attempts to help resolve dependency issues by providing a number of automatic algorithms that help in selecting packages for installation.
ja: 既にインストールされている、あるいはされていないパッケージについて、1つの依存が生まれる可能性は常にあります。APT はインストールするパッケージの選択を支援する自動化でのアルゴリズムをいくつか提供することで依存問題の解決支援に努めます。

note: type: Content of: <book><chapter><para>
en: <command>apt-get</command> provides a simple way to install packages from the command line. Unlike <command>dpkg</command>, <command>apt-get</command> does not understand .deb files, it works with the package's proper name and can only install .deb archives from a <emphasis>Source</emphasis>.
ja: <command>apt-get</command> はコマンドラインからパッケージをインストールする簡単な方法を提供します。<command>dpkg</command> とは異なり、<command>apt-get</command> は .deb ファイルを解釈せず、連携するのはパッケージ特有の名前で、インストールできるのは<emphasis>ソース</emphasis>にある .deb アーカイブだけです。

note: type: Content of: <book><chapter><para><footnote><para>
en: If you are using an http proxy server you must set the http_proxy environment variable first, see sources.list(5)
ja: http プロキシサーバを使っている場合はまず http_proxy 環境変数をセットする必要があります。sources.list(5) を見てください

note: type: Content of: <book><chapter><para>
en: The first <placeholder type="footnote" id="0"/> thing that should be done before using <command>apt-get</command> is to fetch the package lists from the <emphasis>Sources</emphasis> so that it knows what packages are available. This is done with <literal>apt-get update</literal>. For instance,
ja: <command>apt-get</command> を使う前にまずやるべきことは<placeholder type="footnote" id="0"/>パッケージ一覧を<emphasis>ソース</emphasis>から取得することで、それにより利用できるパッケージがわかるようになります。これには <literal>apt-get update</literal> を実行します。例えば

note: type: Content of: <book><chapter><screen>
en: # apt-get update
    Get http://ftp.de.debian.org/debian-non-US/ stable/binary-i386/ Packages
    Get http://llug.sep.bnl.gov/debian/ testing/contrib Packages
    Reading Package Lists... Done
    Building Dependency Tree... Done
ja: # apt-get update
    取得 http://ftp.de.debian.org/debian-non-US/ stable/binary-i386/ Packages
    取得 http://llug.sep.bnl.gov/debian/ testing/contrib Packages
    パッケージリストを読み込んでいます... 完了

note: type: Content of: <book><chapter><para>
en: Once updated there are several commands that can be used:
ja: 更新後は複数のコマンドを使えます:

note: type: Content of: <book><chapter><variablelist><varlistentry><listitem><para>
en: Upgrade will attempt to gently upgrade the whole system. Upgrade will never install a new package or remove an existing package, nor will it ever upgrade a package that might cause some other package to break. This can be used daily to relatively safely upgrade the system. Upgrade will list all of the packages that it could not upgrade, this usually means that they depend on new packages or conflict with some other package. <command>dselect</command> or <literal>apt-get install</literal> can be used to force these packages to install.
ja: upgrade を行うとシステム全体を穏やかにアップグレードします。アップグレードでは新しいパッケージのインストールや既存のパッケージの削除、アップグレードすると他のパッケージを破壊する可能性のある場合のそのパッケージのアップグレードは行いません。これは毎日実行してシステムを比較的安全にアップグレードできます。upgrade を行うとアップグレードできないパッケージがある場合にその一覧を表示します。これは通常新しいパッケージに依存しているか他のパッケージと競合しているということになります。<command>dselect</command> や <literal>apt-get install</literal> を使うとそういったパッケージを強制的にインストールできます。

note: type: Content of: <book><chapter><variablelist><varlistentry><listitem><para>
en: Install is used to install packages by name. The package is automatically fetched and installed. This can be useful if you already know the name of the package to install and do not want to go into a GUI to select it. Any number of packages may be passed to install, they will all be fetched. Install automatically attempts to resolve dependency problems with the listed packages and will print a summary and ask for confirmation if anything other than its arguments are changed.
ja: install を使ってパッケージを名前によりインストールします。パッケージは自動的に取得、インストールされます。これはインストールするパッケージの名前が既にわかっていて GUI を使って選択したくない場合に有用です。インストールするパッケージはいくらでも指定でき、全て取得されます。install では対象パッケージ一覧から自動的に依存問題の解決に努めてまとめを提示し、指示以外の変更がある場合は確認を促します。

note: type: Content of: <book><chapter><variablelist><varlistentry><listitem><para>
en: Dist-upgrade is a complete upgrader designed to simplify upgrading between releases of Debian. It uses a sophisticated algorithm to determine the best set of packages to install, upgrade and remove to get as much of the system to the newest release. In some situations it may be desired to use dist-upgrade rather than spend the time manually resolving dependencies in <command>dselect</command>. Once dist-upgrade has completed then <command>dselect</command> can be used to install any packages that may have been left out.
ja: dist-upgrade は完全なアップグレードを行うように設計されていて、Debian のリリース間のアップグレードを単純化します。洗練されたアルゴリズムを使って、システムをできるだけ最新のリリースにするためにインストール、アップグレード、削除する最善のパッケージ群を決定します。状況によっては <command>dselect</command> で手作業により時間を掛けて依存を解決するよりも dist-upgrade を使う方が希望には合うかもしれません。dist-upgrade 完了後は <command>dselect</command> を使って、残っているパッケージがあればインストールできます。

note: type: Content of: <book><chapter><variablelist><varlistentry><listitem><para>
en: It is important to closely look at what dist-upgrade is going to do, its decisions may sometimes be quite surprising.
ja: dist-upgrade が実行する内容をよく観察するのは重要です。かなり驚くような判断がなされることもあります。

note: type: Content of: <book><chapter><para>
en: <command>apt-get</command> has several command line options that are detailed in its man page, <citerefentry><refentrytitle>apt-get</refentrytitle><manvolnum>8</manvolnum></citerefentry>. The most useful option is <literal>-d</literal> which does not install the fetched files. If the system has to download a large number of package it would be undesired to start installing them in case something goes wrong. When <literal>-d</literal> is used the downloaded archives can be installed by simply running the command that caused them to be downloaded again without <literal>-d</literal>.
ja: <command>apt-get</command> にはコマンドラインオプションが複数あり、man ページの <citerefentry><refentrytitle>apt-get</refentrytitle><manvolnum>8</manvolnum></citerefentry> で詳細に説明されています。最も有用なオプションは取得したファイルをインストールしない <literal>-d</literal> です。システムが大量のパッケージをダウンロードする必要がある場合、何かうまくいかなかったときにインストールを開始するのは望ましくはないでしょう。<literal>-d</literal> を指定すると、ダウンロードしたときのコマンドを単純に再び、<literal>-d</literal> を付けずに実行することでダウンロードしたアーカイブをインストールできます。

note: type: Content of: <book><chapter><para>
en: The APT <command>dselect</command> method provides the complete APT system with the <command>dselect</command> package selection GUI. <command>dselect</command> is used to select the packages to be installed or removed and APT actually installs them.
ja: APT の <command>dselect</command> メソッドは <command>dselect</command> パッケージ選択 GUI を使った完全な APT システムを提供します。インストールや削除するパッケージの選択には <command>dselect</command> を使い、実際のインストールは APT が行います。

note: type: Content of: <book><chapter><para>
en: To enable the APT method you need to select [A]ccess in <command>dselect</command> and then choose the APT method. You will be prompted for a set of <emphasis>Sources</emphasis> which are places to fetch archives from. These can be remote Internet sites, local Debian mirrors or CD-ROMs. Each source can provide a fragment of the total Debian archive, APT will automatically combine them to form a complete set of packages. If you have a CD-ROM then it is a good idea to specify it first and then specify a mirror so that you have access to the latest bug fixes. APT will automatically use packages on your CD-ROM before downloading from the Internet.
ja: APT メソッドを有効にするには、<command>dselect</command> でアクセス(a) を選択し、それから APT メソッドを選択する必要があります。そうするとアーカイブの取得先の場所となる<emphasis>ソース</emphasis>群を聞かれます。これにはリモートのインターネットサイトやローカルの Debian ミラー、CD-ROM を指定できます。各ソースで Debian アーカイブ全体のうちの一部を提供でき、APT は自動的に組み合わせてパッケージ群一式を構成します。CD-ROM がある場合はまずそれを指定し、それからミラーを指定するのが良い方法で、そうすることで最新のバグ修正にアクセスできるようになります。APT はインターネットからダウンロードする前に CD-ROM にあるパッケージを自動的に利用します。

note: type: Content of: <book><chapter><screen>
en:    Set up a list of distribution source locations
    
     Please give the base URL of the debian distribution.
     The access schemes I know about are: http file
    
     For example:
          file:/mnt/debian,
          ftp://ftp.debian.org/debian,
          http://ftp.de.debian.org/debian,
    
    
     URL [http://llug.sep.bnl.gov/debian]:
ja:    ディストリビューションソース位置一覧の準備
    
     Debian ディストリビューションの基底 URL を指定してください。
     認識できるアクセス方法: http file
    
     例:
          file:/mnt/debian,
          ftp://ftp.debian.org/debian,
          http://ftp.de.debian.org/debian,
    
    
     URL [http://llug.sep.bnl.gov/debian]:

note: type: Content of: <book><chapter><para>
en: The <emphasis>Sources</emphasis> setup starts by asking for the base of the Debian archive, defaulting to an HTTP mirror. Next it asks for the distribution to get.
ja: <emphasis>ソース</emphasis>の準備は基礎となる Debian アーカイブの質問から始まり、デフォルトは HTTP ミラーとなっています。その次は取得するディストリビューションを質問します。

note: type: Content of: <book><chapter><screen>
en:  Please give the distribution tag to get or a path to the
     package file ending in a /. The distribution
     tags are typically something like: stable unstable testing non-US
    
     Distribution [stable]:
ja:  取得するディストリビューションのタグやパッケージファイルへのパスを
     / で終える形式で指定してください。ディストリビューションのタグには
     以下のようなものがあります: stable unstable testing non-US
    
     ディストリビューション [stable]:

note: type: Content of: <book><chapter><para>
en: The distribution refers to the Debian version in the archive, <emphasis>stable</emphasis> refers to the latest released version and <emphasis>unstable</emphasis> refers to the developmental version. <emphasis>non-US</emphasis> is only available on some mirrors and refers to packages that contain encryption technology or other things that cannot be exported from the United States. Importing these packages into the US is legal however.
ja: ディストリビューションはアーカイブ中の Debian バージョンを参照し、<emphasis>stable</emphasis> は最新のリリース版を、<emphasis>unstable</emphasis> は開発版を参照します。<emphasis>non-US</emphasis> は一部のミラーでのみ利用可能で、合衆国からの輸出ができない暗号化技術その他のものを収録するパッケージを参照します。ただしこういったパッケージの合衆国への輸入は合法です。

note: type: Content of: <book><chapter><screen>
en:  Please give the components to get
     The components are typically something like: main contrib non-free non-free-firmware
    
     Components [main contrib non-free non-free-firmware]:
ja:  取得するコンポーネントを指定してください
     コンポーネントには以下のようなものがあります: main contrib non-free non-free-firmware
    
     コンポーネント [main contrib non-free non-free-firmware]:

note: type: Content of: <book><chapter><para>
en: The components list refers to the list of sub distributions to fetch. The distribution is split up based on software licenses, main being DFSG free packages while contrib and non-free contain things that have various restrictions placed on their use and distribution.
ja: コンポーネント一覧は取得するサブディストリビューションの一覧を参照します。このディストリビューションはソフトウェアのライセンスを基にして分けられています。main にあるのは DFSG フリーのパッケージですが contrib や non-free には利用目的や配布形態に様々な制限を課せられているものが収録されています。

note: type: Content of: <book><chapter><para>
en: Any number of sources can be added, the setup script will continue to prompt until you have specified all that you want.
ja: ソースはいくらでも追加できます。準備スクリプトは必要なソースを全て指定するまで聞き続けます。

note: type: Content of: <book><chapter><para>
en: Before starting to use <command>dselect</command> it is necessary to update the available list by selecting [U]pdate from the menu. This is a superset of <literal>apt-get update</literal> that makes the fetched information available to <command>dselect</command>. [U]pdate must be performed even if <literal>apt-get update</literal> has been run before.
ja: <command>dselect</command> を使う前にメニューから更新(u)を選択して利用可能なパッケージ一覧を更新する必要があります。これは <literal>apt-get update</literal> の上位集合で、取得した情報を <command>dselect</command> から利用できるようにします。以前に <literal>apt-get update</literal> を実行していても更新(u)を実行する必要があります。

note: type: Content of: <book><chapter><para>
en: You can then go on and make your selections using [S]elect and then perform the installation using [I]nstall. When using the APT method the [C]onfig and [R]emove commands have no meaning, the [I]nstall command performs both of them together.
ja: その後は選択(s)を使って選択し、導入(i)を使ってインストールします。APT メソッドを使っている場合は設定(c)や削除(r)コマンドに意味はなく、導入(i)コマンドがその両方を実行します。

note: type: Content of: <book><chapter><para>
en: By default APT will automatically remove the package (.deb) files once they have been successfully installed. To change this behavior place <literal>Dselect::clean "prompt";</literal> in /etc/apt/apt.conf.
ja: デフォルトで APT はインストールに成功したパッケージ (.deb) ファイルを自動的に削除します。この挙動を変更するには /etc/apt/apt.conf 中に <literal>Dselect::clean "prompt";</literal> と記述します。

note: type: Content of: <book><chapter><title>
en: The Interface
ja: インターフェース

note: type: Content of: <book><chapter><para><footnote><para>
en: The <command>dselect</command> method actually is a set of wrapper scripts to <command>apt-get</command>. The method actually provides more functionality than is present in <command>apt-get</command> alone.
ja: <command>dselect</command> メソッドは実際に <command>apt-get</command> に対するラッパースクリプト群です。このメソッドでは <command>apt-get</command> 単体に存在している以上の機能を実際に提供しています。

note: type: Content of: <book><chapter><para>
en: Both that APT <command>dselect</command> method and <command>apt-get</command> share the same interface. It is a simple system that generally tells you what it will do and then goes and does it. <placeholder type="footnote" id="0"/> After printing out a summary of what will happen APT then will print out some informative status messages so that you can estimate how far along it is and how much is left to do.
ja: APT の <command>dselect</command> メソッドと <command>apt-get</command> は共に同一のインターフェイスを共有しています。通常は行う内容を告知して実行する簡単なシステムです。<placeholder type="footnote" id="0"/> 実行内容のまとめを告知した後 APT が参考になる状態メッセージをいくらか表示するため、どれくらい進んでいるのか、あるいは残り作業がどれくらいあるのか見積もることができるようになっています。

note: type: Content of: <book><chapter><section><title>
en: Startup
ja: スタートアップ

note: type: Content of: <book><chapter><section><para>
en: Before all operations except update, APT performs a number of actions to prepare its internal state. It also does some checks of the system's state. At any time these operations can be performed by running <literal>apt-get check</literal>.
ja: update 以外のあらゆる操作で、APT はいくつか処理を行い内部状態を準備します。また、システムの状態についてもいくらか確認します。この処理は <literal>apt-get check</literal> によりいつでも実行できます。

note: type: Content of: <book><chapter><section><screen>
en: # apt-get check
    Reading Package Lists... Done
    Building Dependency Tree... Done
ja: # apt-get check
    パッケージリストを読み込んでいます... 完了
    依存関係ツリーを作成しています
    状態情報を読み取っています... 完了

note: type: Content of: <book><chapter><section><para>
en: The first thing it does is read all the package files into memory. APT uses a caching scheme so this operation will be faster the second time it is run. If some of the package files are not found then they will be ignored and a warning will be printed when apt-get exits.
ja: これが最初に行うのはパッケージファイルを全てメモリに読み込むことです。APT はキャッシュを使うようになっているので、この処理は次に実行するときには早く終わります。見つけられないパッケージファイルがある場合は無視され、apt-get 終了時に注意を表示します。

note: type: Content of: <book><chapter><section><para>
en: The final operation performs a detailed analysis of the system's dependencies. It checks every dependency of every installed or unpacked package and considers if it is OK. Should this find a problem then a report will be printed out and <command>apt-get</command> will refuse to run.
ja: 最後の処理はシステムの依存関係の詳細な分析です。インストール、あるいは展開されたパッケージの依存関係を全て確認し、問題ないか判断します。問題が見つかった場合は報告し、<command>apt-get</command> の実行を拒否します。

note: type: Content of: <book><chapter><section><screen>
en: # apt-get check
    Reading Package Lists... Done
    Building Dependency Tree... Done
    You might want to run 'apt --fix-broken install' to correct these.
    Sorry, but the following packages have unmet dependencies:
      9fonts: Depends: xlib6g but it is not installed
      uucp: Depends: mailx but it is not installed
      blast: Depends: xlib6g (&gt;= 3.3-5) but it is not installed
      adduser: Depends: perl-base but it is not installed
      aumix: Depends: libgpmg1 but it is not installed
      debiandoc-sgml: Depends: sgml-base but it is not installed
      bash-builtins: Depends: bash (&gt;= 2.01) but 2.0-3 is installed
      cthugha: Depends: svgalibg1 but it is not installed
               Depends: xlib6g (&gt;= 3.3-5) but it is not installed
      libreadlineg2: Conflicts:libreadline2 (&lt;&lt; 2.1-2.1)
ja: # apt-get check
    パッケージリストを読み込んでいます... 完了
    依存関係ツリーを作成しています
    状態情報を読み取っています... 完了
    これらを直すためには 'apt --fix-broken install' を実行する必要があるかもしれません。
    下のパッケージには満たせない依存関係があります:
      9fonts: 依存: xlib6g しかし、インストールされていません
      uucp: 依存: mailx しかし、インストールされていません
      blast: 依存: xlib6g (&gt;= 3.3-5) しかし、インストールされていません
      adduser: 依存: perl-base しかし、インストールされていません
      aumix: 依存: libgpmg1 しかし、インストールされていません
      debiandoc-sgml: 依存: sgml-base しかし、インストールされていません
      bash-builtins: 依存: bash (&gt;= 2.01) しかし、2.0-3 はインストールされています
      cthugha: 依存: svgalibg1 しかし、インストールされていません
               依存: xlib6g (&gt;= 3.3-5) しかし、インストールされていません
      libreadlineg2: 競合:libreadline2 (&lt;&lt; 2.1-2.1)

note: type: Content of: <book><chapter><section><para>
en: In this example the system has many problems, including a serious problem with libreadlineg2. For each package that has unmet dependencies a line is printed out indicating the package with the problem and the dependencies that are unmet. A short explanation of why the package has a dependency problem is also included.
ja: この例ではシステムに libreadlineg2 に関する重大な問題を含めて多数の問題があります。未解決の依存関係があれば各パッケージごとにそのパッケージに問題があることを示し、併せて未解決の依存関係を1行で出力します。そのパッケージの依存問題の理由について簡潔な説明も添えられます。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: APT however considers all known dependencies and attempts to prevent broken packages
ja: APT はそれでも既知の依存関係を全て検討し、パッケージが壊れた状態となることを回避しようとします。

note: type: Content of: <book><chapter><section><para>
en: There are two ways a system can get into a broken state like this. The first is caused by <command>dpkg</command> missing some subtle relationships between packages when performing upgrades. <placeholder type="footnote" id="0"/>. The second is if a package installation fails during an operation. In this situation a package may have been unpacked without its dependents being installed.
ja: システムがこのように壊れた状態となる原因は2つあります。1つ目はアップグレード実行時にパッケージ間の難解な依存関係を <command>dpkg</command> がいくらか欠いていることによります。<placeholder type="footnote" id="0"/>2つ目はパッケージのインストール処理中に何か失敗した場合です。この状況では依存するパッケージがインストールされないままパッケージが展開されている可能性があります。

note: type: Content of: <book><chapter><section><para>
en: The second situation is much less serious than the first because APT places certain constraints on the order that packages are installed. In both cases supplying the <literal>-f</literal> option to <command>apt-get</command> will cause APT to deduce a possible solution to the problem and then continue on. The APT <command>dselect</command> method always supplies the <literal>-f</literal> option to allow for easy continuation of failed maintainer scripts.
ja: APT がパッケージのインストール順序に特定の制約を設けていることにより2つ目の状況は1つ目の状況と比べて重大ですらなくなります。どちらの場合でも <command>apt-get</command> に <literal>-f</literal> オプションを指定することで APT は解決方法を推測し、処理を続けます。APT <command>dselect</command> メソッドでは常に <literal>-f</literal> オプションを有効にして、メンテナスクリプトでの問題が起きた場合でも簡単に処理を継続できるようにしています。

note: type: Content of: <book><chapter><section><para>
en: However, if the <literal>-f</literal> option is used to correct a seriously broken system caused by the first case then it is possible that it will either fail immediately or the installation sequence will fail. In either case it is necessary to manually use dpkg (possibly with forcing options) to correct the situation enough to allow APT to proceed.
ja: しかし、1つ目の状況により重大な壊れ方になっているシステムの修正に <literal>-f</literal> オプションを使った場合はインストールにすぐに失敗、あるいはインストール順序がおかしくなる可能性があります。どちらの場合も、APT が処理を十分に進められるところまで手作業により dpkg を使って (恐らく強制するオプションを指定して) 状況を修正する必要があります。

note: type: Content of: <book><chapter><section><title>
en: The Status Report
ja: 状態レポート

note: type: Content of: <book><chapter><section><para>
en: Before proceeding <command>apt-get</command> will present a report on what will happen. Generally the report reflects the type of operation being performed but there are several common elements. In all cases the lists reflect the final state of things, taking into account the <literal>-f</literal> option and any other relevant activities to the command being executed.
ja: 処理を続ける前に <command>apt-get</command> は実行しようとする処理について報告します。通常この報告は実行される操作の種類を反映したものになりますが、一般的要素がいくつかあります。どの場合でもこの処理一覧は最終的な状態を示し、<literal>-f</literal> オプションその他の実行されるコマンドに関連する動作を考慮したものとなります。

note: type: Content of: <book><chapter><section><section><title>
en: The Extra Package list
ja: 追加パッケージリスト

note: type: Content of: <book><chapter><section><section><screen>
en: The following extra packages will be installed:
      libdbd-mysql-perl xlib6 zlib1 xzx libreadline2 libdbd-msql-perl
      mailpgp xdpkg fileutils pinepgp zlib1g xlib6g perl-base
      bin86 libgdbm1 libgdbmg1 quake-lib gmp2 bcc xbuffy
      squake pgp-i python-base debmake ldso perl libreadlineg2
      ssh
ja: 以下の特別パッケージがインストールされます:
      libdbd-mysql-perl xlib6 zlib1 xzx libreadline2 libdbd-msql-perl
      mailpgp xdpkg fileutils pinepgp zlib1g xlib6g perl-base
      bin86 libgdbm1 libgdbmg1 quake-lib gmp2 bcc xbuffy
      squake pgp-i python-base debmake ldso perl libreadlineg2
      ssh

note: type: Content of: <book><chapter><section><section><para>
en: The Extra Package list shows all of the packages that will be installed or upgraded in excess of the ones mentioned on the command line. It is only generated for an <literal>install</literal> command. The listed packages are often the result of an Auto Install.
ja: 追加パッケージリストはコマンドラインで指示した以外にインストールやアップグレードされるパッケージを全て表示します。これは <literal>install</literal> コマンドの場合にのみ生成されます。一覧に挙げられるパッケージは自動インストールの結果による場合が多くなります。

note: type: Content of: <book><chapter><section><section><title>
en: The Packages to Remove
ja: 削除するパッケージ

note: type: Content of: <book><chapter><section><section><screen>
en: The following packages will be REMOVED:
      xlib6-dev xpat2 tk40-dev xkeycaps xbattle xonix
      xdaliclock tk40 tk41 xforms0.86 ghostview xloadimage xcolorsel
      xadmin xboard perl-debug tkined xtetris libreadline2-dev perl-suid
      nas xpilot xfig
ja: 以下のパッケージは「削除」されます:
    The following packages will be REMOVED:
      xlib6-dev xpat2 tk40-dev xkeycaps xbattle xonix
      xdaliclock tk40 tk41 xforms0.86 ghostview xloadimage xcolorsel
      xadmin xboard perl-debug tkined xtetris libreadline2-dev perl-suid
      nas xpilot xfig

note: type: Content of: <book><chapter><section><section><para>
en: The Packages to Remove list shows all of the packages that will be removed from the system. It can be shown for any of the operations and should be given a careful inspection to ensure nothing important is to be taken off. The <literal>-f</literal> option is especially good at generating packages to remove so extreme care should be used in that case. The list may contain packages that are going to be removed because they are only partially installed, possibly due to an aborted installation.
ja: 削除するパッケージリストはシステムから削除されるパッケージを全て表示します。これはどの操作でも起きるもので、重要なものが失われることのないように注意深く確認すべきです。<literal>-f</literal> オプションを使った場合はパッケージの削除を伴うことが特に多く、そのためこのオプションを指定した場合は特に注意を払うようにしてください。この一覧にはインストールの中止等により一部だけがインストールされているために削除されるパッケージが含まれることがあります。

note: type: Content of: <book><chapter><section><section><title>
en: The New Packages list
ja: 新規パッケージリスト

note: type: Content of: <book><chapter><section><section><screen>
en: The following NEW packages will installed:
      zlib1g xlib6g perl-base libgdbmg1 quake-lib gmp2 pgp-i python-base
ja: 以下のパッケージが新たにインストールされます:
      zlib1g xlib6g perl-base libgdbmg1 quake-lib gmp2 pgp-i python-base

note: type: Content of: <book><chapter><section><section><para>
en: The New Packages list is simply a reminder of what will happen. The packages listed are not presently installed in the system but will be when APT is done.
ja: 新規パッケージリストでは単純にこれから起きることを再通知します。このパッケージ一覧は現在システムにインストールされておらず、APT 処理後には存在することになります。

note: type: Content of: <book><chapter><section><section><title>
en: The Kept Back list
ja: 一時固定リスト

note: type: Content of: <book><chapter><section><section><screen>
en: The following packages have been kept back
      compface man-db tetex-base msql libpaper svgalib1
      gs snmp arena lynx xpat2 groff xscreensaver
ja: 以下のパッケージは保留されます
      compface man-db tetex-base msql libpaper svgalib1
      gs snmp arena lynx xpat2 groff xscreensaver

note: type: Content of: <book><chapter><section><section><para>
en: Whenever the whole system is being upgraded there is the possibility that new versions of packages cannot be installed because they require new things or conflict with already installed things. In this case the package will appear in the Kept Back list. The best way to convince packages listed there to install is with <literal>apt-get install</literal> or by using <command>dselect</command> to resolve their problems.
ja: システム全体をアップグレードする場合、新しいパッケージが必要であったり既にインストールされているパッケージと競合するためにパッケージの新しいバージョンがインストールできないということがあります。この場合、そのパッケージは一時固定リストに表示されます。この一覧に挙げられたパッケージをインストールする最善の方法は <literal>apt-get install</literal> または <command>dselect</command> を使ってその問題を解決することです。

note: type: Content of: <book><chapter><section><section><title>
en: Held Packages warning
ja: 保留パッケージの警告

note: type: Content of: <book><chapter><section><section><screen>
en: The following held packages will be changed:
      cvs
ja: 以下の変更禁止パッケージは変更されます:
      cvs

note: type: Content of: <book><chapter><section><section><para>
en: Sometimes you can ask APT to install a package that is on hold, in such a case it prints out a warning that the held package is going to be changed. This should only happen during dist-upgrade or install.
ja: 保留となっているパッケージをインストールするように APT に指示することもできます。その際、保留となっているパッケージを変更することを警告します。これは dist-upgrade または install を指示したときにしか起きないはずです。

note: type: Content of: <book><chapter><section><section><title>
en: Final summary
ja: 最後のまとめ

note: type: Content of: <book><chapter><section><section><para>
en: Finally, APT will print out a summary of all the changes that will occur.
ja: 最後に、APT は発生する全変更のまとめを表示します。

note: type: Content of: <book><chapter><section><section><screen>
en: 206 packages upgraded, 8 newly installed, 23 to remove and 51 not upgraded.
    12 packages not fully installed or removed.
    Need to get 65.7M/66.7M of archives. After unpacking 26.5M will be used.
ja: アップグレード: 206 個、新規インストール: 8 個、削除: 23 個、保留: 51 個。
    12 個のパッケージが完全にインストールまたは削除されていません。
    66.7MB 中 65.7MB のアーカイブを取得する必要があります。
    この操作後に追加で 26.5MB のディスク容量が消費されます。

note: type: Content of: <book><chapter><section><section><para>
en: The first line of the summary simply is a reduced version of all of the lists and includes the number of upgrades - that is packages already installed that have new versions available. The second line indicates the number of poorly configured packages, possibly the result of an aborted installation. The final line shows the space requirements that the installation needs. The first pair of numbers refer to the size of the archive files. The first number indicates the number of bytes that must be fetched from remote locations and the second indicates the total size of all the archives required. The next number indicates the size difference between the presently installed packages and the newly installed packages. It is roughly equivalent to the space required in /usr after everything is done. If a large number of packages are being removed then the value may indicate the amount of space that will be freed.
ja: まとめの1行目は単純に一覧を全て短くまとめたもので、アップグレードされる (既にインストールされていて新しいバージョンが利用可能な) パッケージの数についても示します。2行目は設定が完了していないパッケージの数を示し、インストールを中止した場合にこれに集計されることがあります。最終行はそのインストールで必要となる容量の要件を示します。最初の数値の組はアーカイブファイルのサイズを示します。この1つ目の数値はリモートから取得してくる必要のあるバイト数、2つ目は必要となる全アーカイブの合計サイズを示します。次の数値は現在インストールされているパッケージと新しくインストールしたパッケージのサイズの違いを示します。これは処理が全て終わった後に /usr で消費される容量にほぼ相当します。パッケージを大量に削除する場合は解放される容量を示すこともあります。

note: type: Content of: <book><chapter><section><section><para>
en: Some other reports can be generated by using the -u option to show packages to upgrade, they are similar to the previous examples.
ja: 他の報告として、-u オプションを使うとアップグレードされるパッケージを表示します。これは前に示した例と似たものです。

note: type: Content of: <book><chapter><section><title>
en: The Status Display
ja: 状態表示

note: type: Content of: <book><chapter><section><para>
en: During the download of archives and package files APT prints out a series of status messages.
ja: アーカイブやパッケージファイルのダウンロード中、APT は状態を示す一連のメッセージを表示します。

note: type: Content of: <book><chapter><section><screen>
en: # apt-get update
    Get:1 http://ftp.de.debian.org/debian-non-US/ stable/non-US/ Packages
    Get:2 http://llug.sep.bnl.gov/debian/ testing/contrib Packages
    Hit http://llug.sep.bnl.gov/debian/ testing/main Packages
    Get:4 http://ftp.de.debian.org/debian-non-US/ unstable/binary-i386/ Packages
    Get:5 http://llug.sep.bnl.gov/debian/ testing/non-free Packages
    11% [5 testing/non-free `Waiting for file' 0/32.1k 0%] 2203b/s 1m52s
ja: # apt-get update
    取得:1 http://ftp.de.debian.org/debian-non-US/ stable/non-US/ Packages
    取得:2 http://llug.sep.bnl.gov/debian/ testing/contrib Packages
    ヒット http://llug.sep.bnl.gov/debian/ testing/main Packages
    取得:4 http://ftp.de.debian.org/debian-non-US/ unstable/binary-i386/ Packages
    取得:5 http://llug.sep.bnl.gov/debian/ testing/non-free Packages
    11% [5 testing/non-free `Waiting for file' 0/32.1k 0%] 2203b/s 1m52s

note: type: Content of: <book><chapter><section><para>
en: The lines starting with <emphasis>Get</emphasis> are printed out when APT begins to fetch a file while the last line indicates the progress of the download. The first percent value on the progress line indicates the total percent done of all files. Unfortunately since the size of the Package files is unknown <literal>apt-get update</literal> estimates the percent done which causes some inaccuracies.
ja: APT がファイルの取得を開始すると、最終行でダウンロードの進捗状況を示しつつ<emphasis>取得</emphasis>で始まる行が表示されます。進捗の最初のパーセント値は全ファイルに対する取得済みの全体での割合を示します。残念ながらパッケージファイルのサイズは不明なので <literal>apt-get update</literal> は不正確な予測を行う可能性があります。

note: type: Content of: <book><chapter><section><para>
en: The next section of the status line is repeated once for each download thread and indicates the operation being performed and some useful information about what is happening. Sometimes this section will simply read <emphasis>Forking</emphasis> which means the OS is loading the download module. The first word after the [ is the fetch number as shown on the history lines. The next word is the short form name of the object being downloaded. For archives it will contain the name of the package that is being fetched.
ja: 状態を示す行の次の節は各ダウンロードスレッドごとに1度ずつ繰り返され、進行中の操作や処理についての有用な情報をいくらか示します。この節は単純に <emphasis>Forking</emphasis> となっていることもあり、その場合は OS がダウンロード用のモジュールを読み込んでいることを示します。[ の後の最初の語は履歴に表示されている取得番号です。その次の語はダウンロード対象の名前の短縮形です。アーカイブの場合は取得中のパッケージの名前が入ります。

note: type: Content of: <book><chapter><section><para>
en: Inside of the single quote is an informative string indicating the progress of the negotiation phase of the download. Typically it progresses from <emphasis>Connecting</emphasis> to <emphasis>Waiting for file</emphasis> to <emphasis>Downloading</emphasis> or <emphasis>Resuming</emphasis>. The final value is the number of bytes downloaded from the remote site. Once the download begins this is represented as <literal>102/10.2k</literal> indicating that 102 bytes have been fetched and 10.2 kilobytes is expected. The total size is always shown in 4 figure notation to preserve space. After the size display is a percent meter for the file itself. The second last element is the instantaneous average speed. This values is updated every 5 seconds and reflects the rate of data transfer for that period. Finally is shown the estimated transfer time. This is updated regularly and reflects the time to complete everything at the shown transfer rate.
ja: 単一引用符内はダウンロードのやりとりの進捗を示す有益な文字列です。標準的には<emphasis>...へ接続しています</emphasis>から<emphasis>ファイルを待っています</emphasis>へ、それから<emphasis>...をダウンロードしています</emphasis>または<emphasis>...を再開しています</emphasis>へと進みます。最後の値はリモートサイトからダウンロードしたバイト数です。ダウンロードが始まるとこれは <literal>102/10.2k</literal> のように表示され、この場合10.2キロバイトのうち102バイトが取得済みであることを示します。合計サイズは常に4ケタで表示され、表示空間を保つようになっています。サイズ表示の後はそのファイル自体の進捗状況を百分率で示したものです。その2つ後は瞬間的な平均速度です。この値は5秒ごとに更新され、その間のデータ転送速度を反映します。最後は推定転送時間を表示しています。これは定期的に更新され、表示している転送速度で全て完了する時間を表示します。

note: type: Content of: <book><chapter><section><para>
en: The status display updates every half second to provide a constant feedback on the download progress while the Get lines scroll back whenever a new file is started. Since the status display is constantly updated it is unsuitable for logging to a file, use the <literal>-q</literal> option to remove the status display.
ja: 状態表示は0.5秒ごとに更新してダウンロードの進捗状況を絶えず通知し、取得行は新しいファイルの処理が始まるたびに流れていきます。状態表示は絶えず更新されるためファイルへの記録には適しません。<literal>-q</literal> オプションを使うと状態を表示しないようにできます。

note: type: Content of: <book><chapter><section><para>
en: APT uses <command>dpkg</command> for installing the archives and will switch over to the <command>dpkg</command> interface once downloading is completed. <command>dpkg</command> will also ask a number of questions as it processes the packages and the packages themselves may also ask several questions. Before each question there is usually a description of what it is asking and the questions are too varied to discuss completely here.
ja: APT はアーカイブのインストールに <command>dpkg</command> を使い、ダウンロードの完了後は <command>dpkg</command> インターフェイスに切り替わります。<command>dpkg</command> もパッケージの処理中にいくつか質問し、パッケージ自体も複数質問するかもしれません。通常それぞれの質問の前にそれが何を聞いているのか説明します。その質問の内容は多岐にわたるものであり、ここで説明できるものでは全くありません。

note: type: Content of: <book><title>
en: Using APT Offline
ja: オフラインでの APT の使用法

note: type: Content of: <book><bookinfo><abstract><para>
en: This document describes how to use APT in a non-networked environment, specifically a 'sneaker-net' approach for performing upgrades.
ja: このドキュメントはネットワークがない環境での APT の使用方法を説明しています。具体的には、アップグレード時の「スニーカーネット」アプローチです。

note: type: Content of: <book><chapter><title>
en: Introduction
ja: はじめに

note: type: Content of: <book><chapter><section><title>
en: Overview
ja: 概要

note: type: Content of: <book><chapter><section><para>
en: Normally APT requires direct access to a Debian archive, either from a local media or through a network. Another common complaint is that a Debian machine is on a slow link, such as a modem and another machine has a very fast connection but they are physically distant.
ja: 通常 APT は Debian アーカイブに、ローカルメディアから、あるいはネットワーク経由で直接アクセスできる必要があります。他によくある苦情としてはある Debian マシンの接続がモデム等のために低速で、別のマシンには非常に高速な接続があるけれども物理的に遠い、といったことがあります。

note: type: Content of: <book><chapter><section><para>
en: The solution to this is to use large removable media such as a Zip disc or a SuperDisk disc. These discs are not large enough to store the entire Debian archive but can easily fit a subset large enough for most users. The idea is to use APT to generate a list of packages that are required and then fetch them onto the disc using another machine with good connectivity. It is even possible to use another Debian machine with APT or to use a completely different OS and a download tool like wget. Let <emphasis>remote host</emphasis> mean the machine downloading the packages, and <emphasis>target host</emphasis> the one with bad or no connection.
ja: これに対する解法としては Zip や SuperDisk ディスクといった大容量脱着可能メディアを使います。こういったディスクは Debian アーカイブ全体を格納するには十分とは言えない容量ですがほとんどのユーザにとって必要なその一部を収めるには十分余裕があります。その考え方は APT を使って必要なパッケージの一覧を生成し、接続状態の良好な別のマシンを使ってそのディスク上に取得します。APT を使える別の Debian マシンや、完全に異なる OS で wget のようなダウンロードツールを使うことも可能です。<emphasis>リモートホスト</emphasis>はパッケージをダウンロードするマシン、<emphasis>対象ホスト</emphasis>は接続がないあるいは良くないマシンだと考えてください。

note: type: Content of: <book><chapter><section><para>
en: This is achieved by creatively manipulating the APT configuration file. The essential premise to tell APT to look on a disc for it's archive files. Note that the disc should be formatted with a filesystem that can handle long file names such as ext2, fat32 or vfat.
ja: これは APT 設定ファイルを独創的に操作することで実現できます。あるディスクを APT が検索するようにするために必須となる前提条件はアーカイブファイルです。そのディスクは長いファイル名を扱えるファイルシステム、例えば ext2 や fat32、vfat でフォーマットする必要があることに注意してください。

note: type: Content of: <book><chapter><title>
en: Using APT on both machines
ja: 両方のマシンでの APT の使用法

note: type: Content of: <book><chapter><section><para>
en: APT being available on both machines gives the simplest configuration. The basic idea is to place a copy of the status file on the disc and use the remote machine to fetch the latest package files and decide which packages to download. The disk directory structure should look like:
ja: APT を両方のマシンで利用できるようにする最も単純な設定を考えます。基本的な考え方は status ファイルのコピーをそのディスクに置いて最新のパッケージファイルの取得やダウンロードするパッケージの決定にはリモートマシンを使います。そのディスクのディレクトリ構造は次のようになります:

note: type: Content of: <book><chapter><section><title>
en: The configuration file
ja: 設定ファイル

note: type: Content of: <book><chapter><section><para>
en: The configuration file should tell APT to store its files on the disc and to use the configuration files on the disc as well. The sources.list should contain the proper sites that you wish to use from the remote machine, and the status file should be a copy of <emphasis>/var/lib/dpkg/status</emphasis> from the <emphasis>target host</emphasis>. Please note, if you are using a local archive you must use copy URIs, the syntax is identical to file URIs.
ja: 設定ファイルでは APT が管理ファイルをそのディスクに保存し、そのディスク上の設定ファイルを同様に利用するように指示する必要があります。sources.list ではリモートマシンから利用する適切なサイトを指定し、status ファイルは<emphasis>対象ホスト</emphasis>の <emphasis>/var/lib/dpkg/status</emphasis> をコピーしたものを利用します。ローカルアーカイブを使っている場合はその URI を利用しないといけないことに注意してください。書式はファイルの URI と同一です。

note: type: Content of: <book><chapter><section><para>
en: <emphasis>apt.conf</emphasis> must contain the necessary information to make APT use the disc:
ja: <emphasis>apt.conf</emphasis> には APT がそのディスクを使うようにするのに必要な情報を記述しないといけません:

note: type: Content of: <book><chapter><section><para>
en: More details can be seen by examining the apt.conf man page and the sample configuration file in <emphasis>/usr/share/doc/apt/examples/apt.conf</emphasis>.
ja: apt.conf の man ページや <emphasis>/usr/share/doc/apt/examples/apt.conf</emphasis> にある見本の設定ファイルを調べるとさらなる詳細があります。

note: type: Content of: <book><chapter><section><para>
en: On the target machine the first thing to do is mount the disc and copy <emphasis>/var/lib/dpkg/status</emphasis> to it. You will also need to create the directories outlined in the Overview, <emphasis>archives/partial/</emphasis> and <emphasis>lists/partial/</emphasis>. Then take the disc to the remote machine and configure the sources.list. On the remote machine execute the following:
ja: 対象のマシンでまず行うことはディスクをマウントしてそのディスクに <emphasis>/var/lib/dpkg/status</emphasis> をコピーすることです。概要にまとめられているように、ディレクトリ <emphasis>archives/partial/</emphasis> 及び <emphasis>lists/partial/</emphasis> を作成する必要もあるでしょう。それからディスクをリモートマシンに移動して sources.list を設定します。リモートマシンでは以下の手順を実行します:

note: type: Content of: <book><chapter><section><screen>
en:  # export APT_CONFIG="/disc/apt.conf"
     # apt-get update
     [ APT fetches the package files ]
     # apt-get dist-upgrade
     [ APT fetches all the packages needed to upgrade the target machine ]
ja:  # export APT_CONFIG="/disc/apt.conf"
     # apt-get update
     [ package ファイルを APT が取得します ]
     # apt-get dist-upgrade
     [ 対象マシンをアップグレードするのに必要なパッケージを、APT が取得します ]

note: type: Content of: <book><chapter><section><para>
en: The dist-upgrade command can be replaced with any other standard APT commands, particularly dselect-upgrade. You can even use an APT front end such as <emphasis>dselect</emphasis>. However this presents a problem in communicating your selections back to the local computer.
ja: dist-upgrade コマンドは他の任意の標準的な APT コマンド、特に dselect-upgrade に置き換えることができます。<emphasis>dselect</emphasis> 等の APT フロントエンドを使うこともできます。しかし、それには選択したときにローカルコンピュータとやりとりしてしまうという問題があります。

note: type: Content of: <book><chapter><section><para>
en: Now the disc contains all of the index files and archives needed to upgrade the target machine. Take the disc back and run:
ja: これで、対象のマシンをアップグレードするのに必要な索引ファイルとアーカイブが全てこのディスクに収録されたということになります。ディスクを戻して実行します:

note: type: Content of: <book><chapter><section><screen>
en:   # export APT_CONFIG="/disc/apt.conf"
      # apt-get check
      [ APT generates a local copy of the cache files ]
      # apt-get --no-d -o dir::state::status=/var/lib/dpkg/status dist-upgrade
      [ Or any other APT command ]
ja:   # export APT_CONFIG="/disc/apt.conf"
      # apt-get check
      [ キャッシュファイルのローカルコピーを生成します ]
      # apt-get --no-d -o dir::state::status=/var/lib/dpkg/status dist-upgrade
      [ もしくはその他の APT コマンド ]

note: type: Content of: <book><chapter><section><para>
en: It is necessary for proper function to re-specify the status file to be the local one. This is very important!
ja: 適切に機能するためにはローカルのファイルを status ファイルに再指定する必要があります。これは非常に重要です!

note: type: Content of: <book><chapter><section><para>
en: If you are using dselect you can do the very risky operation of copying disc/status to /var/lib/dpkg/status so that any selections you made on the remote machine are updated. I highly recommend that people only make selections on the local machine - but this may not always be possible. DO NOT copy the status file if dpkg or APT have been run in the mean time!!
ja: dselect を使っている場合、disc/status はリモートマシンで何か選択すると更新されるため /var/lib/dpkg/status にコピーするのは非常に危険です。選択はローカルマシンでのみ行うことを強く勧めます - しかしこれは常に可能だとは限りません。dpkg や APT を実行している間は status ファイルをコピー *しないでください* !!

note: type: Content of: <book><chapter><title>
en: Using APT and wget
ja: APT と wget の使用

note: type: Content of: <book><chapter><section><para>
en: <emphasis>wget</emphasis> is a popular and portable download tool that can run on nearly any machine. Unlike the method above this requires that the Debian machine already has a list of available packages.
ja: <emphasis>wget</emphasis> は人気のある移植性の高いダウンロードツールで、ほぼあらゆるマシンで実行できます。上記の方法とは異なり、これには利用可能なパッケージの一覧を Debian マシンで用意しておく必要があります。

note: type: Content of: <book><chapter><section><para>
en: The basic idea is to create a disc that has only the archive files downloaded from the remote site. This is done by using the --print-uris option to apt-get and then preparing a wget script to actually fetch the packages.
ja: 基本的な考え方は、リモートサイトからダウンロードしたアーカイブファイルだけを収録したディスクを作成するということです。これは apt-get に --print-uris オプションを使って行い、それから wget スクリプトを準備して実際にパッケージを取得します。

note: type: Content of: <book><chapter><section><title>
en: Operation
ja: 操作

note: type: Content of: <book><chapter><section><para>
en: Unlike the previous technique no special configuration files are required. We merely use the standard APT commands to generate the file list.
ja: 前の技とは異なり、特別な設定ファイルを必要としません。標準的な APT コマンドを単純に使ってファイル一覧を生成します。

note: type: Content of: <book><chapter><section><screen>
en:  # apt-get dist-upgrade
     [ Press no when prompted, make sure you are happy with the actions ]
     # apt-get -qq --print-uris dist-upgrade &gt; uris
     # awk '{print "wget -O " $2 " " $1}' &lt; uris &gt; /disc/wget-script
ja:  # apt-get dist-upgrade
     [ 問い合わせには no を回答し、意図しない動作を起こすことのないように ]
     # apt-get -qq --print-uris dist-upgrade &gt; uris
     # awk '{print "wget -O " $2 " " $1}' &lt; uris &gt; /disc/wget-script

note: type: Content of: <book><chapter><section><para>
en: Any command other than dist-upgrade could be used here, including dselect-upgrade.
ja: dselect-upgrade を含め、ここでは dist-upgrade 以外の任意のコマンドを使えます。

note: type: Content of: <book><chapter><section><para>
en: The /disc/wget-script file will now contain a list of wget commands to execute in order to fetch the necessary archives. This script should be run with the current directory as the disc's mount point so as to save the output on the disc.
ja: /disc/wget-script ファイルには、必要なアーカイブを取得するために実行する wget コマンドの一覧を収録するようになっています。ディスク上の出力を減らすため、このスクリプトは現在のディレクトリをそのディスクのマウントポイントとして実行するようにしてください。

note: type: Content of: <book><chapter><section><para>
en: The remote machine would do something like
ja: リモートマシンでは以下のようにします。

note: type: Content of: <book><chapter><section><screen>
en:   # cd /disc
      # sh -x ./wget-script
      [ wait.. ]
ja:   # cd /disc
      # sh -x ./wget-script
      [ お待ちください... ]

note: type: Content of: <book><chapter><section><para>
en: Once the archives are downloaded and the disc returned to the Debian machine installation can proceed using,
ja: アーカイブのダウンロードが終わってディスクが Debian マシンに返ってくるとインストールを続けられるようになります。

note: type: Content of: <book><chapter><section><para>
en: Which will use the already fetched archives on the disc.
ja: これで、ディスクにある取得済みのアーカイブを使用するようになります。
