dpkg man pages - en to ja translation catalogue (1358 entries)

note: type: SH
en: NAME
ja: 名前

note: type: Plain text
en: deb - Debian binary package format
ja: deb - Debian バイナリパッケージ形式

note: type: SH
en: SYNOPSIS
ja: 書式

note: type: SH
en: DESCRIPTION
ja: 説明

note: type: Plain text
en: The B<.deb> format is the Debian binary package file format. It is understood by dpkg 0.93.76 and later, and is generated by default by all versions of dpkg since 1.2.0 and all i386/ELF versions since 1.1.1elf.
ja: B<.deb> フォーマットは Debian バイナリパッケージのファイル形式であり、dpkg 0.93.76 以降で扱うことができる。dpkg 1.2.0 以降のすべてのバージョンと i386/ELF 1.1.1elf 以降のすべてのバージョンでは、デフォルトでこの形式が作成される。

note: type: Plain text
en: The format described here is used since Debian 0.93; details of the old format are described in B<deb-old>(5).
ja: このマニュアルで説明する形式は Debian 0.93 から使用されている。古い形式の詳細については B<deb-old>(5) を参照のこと。

note: type: SH
en: FORMAT
ja: フォーマット

note: type: Plain text
en: The file is an B<ar> archive with a magic value of B<!E<lt>archE<gt>>.  Only the common B<ar> archive format is supported, with no long file name extensions, but with file names containing an optional trailing slash, which limits their length to 15 characters (from the 16 allowed).  File sizes are limited to 10 ASCII decimal digits, allowing for up to approximately 9536.74 MiB member files.
ja: このファイルは B<!E<lt>archE<gt>> というマジックナンバーを持つ B<ar> アーカイブである。一般的な B<ar> アーカイブ形式のみがサポートされているため長いファイル名はサポートされていないが、ファイル名が (本来許可されている 16 文字のうち) 15 文字以内の場合、末尾にスラッシュを付けることができる。ファイルサイズは、ASCII の 10 進数で 10 桁以内となっており、約 9536.74 MiB のメンバファイルを扱うことができる。

note: type: Plain text
en: The B<tar> archives currently allowed are, the old-style (v7) format, the pre-POSIX ustar format, a subset of the GNU format (only the new style long pathnames and long linknames, supported since dpkg 1.4.1.17), and the POSIX ustar format (long names supported since dpkg 1.15.0).  Unrecognized tar typeflags are considered an error.
ja: 現在使用できる B<tar> アーカイブの形式は、old-style (v7) 形式、POSIX 以前の ustar 形式、GNU 形式のサブセット (新しい形式の長いパス名とリンク名のみ。dpkg 1.4.1.17 以降でサポート)、POSIX ustar 形式 (長いパス名については dpkg 1.15.0 以降でサポート) である。認識されないtar の typeflag はエラーとなる。

note: type: Plain text
en: The first member is named B<debian-binary> and contains a series of lines, separated by newlines. Currently only one line is present, the format version number, B<2.0> at the time this manual page was written.  Programs which read new-format archives should be prepared for the minor number to be increased and new lines to be present, and should ignore these if this is the case.
ja: アーカイブの 1 番目のファイルは B<debian-binary> である。このファイルは、改行で区切られた何行かからなるが、本マニュアルページが書かれた時点では、形式のバージョン番号である B<2.0> が書かれた 1 行のみが存在している。新しい形式のアーカイブを読み込むプログラムは、マイナーバージョン番号の増加や、新しい行の追加に対応すべきである。その際には、これらを無視すること。

note: type: Plain text
en: If the major number has changed, an incompatible change has been made and the program should stop. If it has not, then the program should be able to safely continue, unless it encounters an unexpected member in the archive (except at the end), as described below.
ja: メジャーバージョン番号が変更されている場合は、互換性のない変更がされているとみなし、プログラムは停止すべきである。メジャーバージョンが変更されていない場合は、以下で説明するように、アーカイブに予期しないファイルが含まれていない限り (アーカイブ末尾に含まれる場合を除く)、プログラムは安全に実行を継続できる必要がある。

note: type: Plain text
en: The second required member is named B<control.tar.gz>.  It is a gzipped tar archive containing the package control information, as a series of plain files, of which the file B<control> is mandatory and contains the core control information. The control tarball may optionally contain an entry for `B<.>', the current directory.
ja: 2 番目の必須ファイルは B<control.tar.gz> である。このファイルは、パッケージ制御情報が格納されたテキストファイルからなる gzip で圧縮された tar アーカイブである。B<control> ファイル (制御情報ファイル) は必須であり、中心となる制御情報が含まれる。アーカイブには、カレントディレクトリを意味する `B<.>' のエントリがあってもよい。

note: type: Plain text
en: The third, last required member is named B<data.tar>.  It contains the filesystem as a tar archive, either not compressed (supported since dpkg 1.10.24), or compressed with gzip (with B<.gz> extension), xz (with B<.xz> extension, supported since dpkg 1.15.6), bzip2 (with B<.bz2> extension, supported since dpkg 1.10.24) or lzma (with B<.lzma> extension, supported since dpkg 1.13.25).
ja: 3 番目となる最後の必須ファイルは B<data.tar> である。このファイルは、ファイルシステムツリーが格納された tar アーカイブである。ファイルは、gzip (拡張子 B<.gz>)、xz (拡張子 B<.xz> 、dpkg 1.15.6以降でサポート)、bzip2 (拡張子 B<.bz2>、dpkg 1.10.24以降でサポート)、lzma (拡張子 B<.lzma>、dpkg 1.13.25 以降でサポート) により圧縮される場合もあるが、非圧縮のまま (dpkg 1.10.24 以降でサポート) の場合もある。

note: type: Plain text
en: These members must occur in this exact order. Current implementations should ignore any additional members after B<data.tar>.  Further members may be defined in the future, and (if possible) will be placed after these three. Any additional members that may need to be inserted before B<data.tar> and which should be safely ignored by older programs, will have names starting with an underscore, `B<_>'.
ja: これらのファイルはこの通りの順序でアーカイブされていなければならない。現在の実装では、B<data.tar> より後に追加されているファイルを無視すべきである。将来的に追加のファイルが定義された場合は、(やむを得ない場合を除き) これら 3 つのファイルより後にアーカイブされることになるだろう。B<data.tar> の前に何らかのファイルを追加する必要が発生した際に、それらを古いプログラムから安全に無視させるには、アンダースコア `_' から始まる名前を付ければよい。

note: type: Plain text
en: Those new members which won't be able to be safely ignored will be inserted before B<data.tar> with names starting with something other than underscores, or will (more likely) cause the major version number to be increased.
ja: 安全に無視させることのできない、アンダースコア以外の文字で始まる名前のファイルが B<data.tar> の前に追加されるかも知れないが、その場合は、(おそらく) メジャーバージョンアップとなるだろう。

note: type: SH
en: SEE ALSO
ja: 関連項目

note: type: Plain text
en: deb-control - Debian packages' master control file format
ja: deb-control - Debian パッケージのマスタ制御ファイルの形式

note: type: Plain text
en: Each Debian package contains the master `control' file, which contains a number of fields, or comments when the line starts with B<'#'>. Each field begins with a tag, such as B<Package> or B<Version> (case insensitive), followed by a colon, and the body of the field.  Fields are delimited only by field tags. In other words, field text may be multiple lines in length, but the installation tools will generally join lines when processing the body of the field (except in the case of the B<Description> field, see below).
ja: 各 Debian パッケージには、マスタとなる `control' ファイルがある。ファイルはフィールド行や B<'#'> で始まるコメント行からなる。各フィールド行は B<Package> や B<Version> (大文字小文字の区別なし) といったフィールドタグで始まり、コロンの後にフィールド本体 (値) が続く。フィールドがフィールドタグ以外で区切られることはない。言い換えると、フィールド本体のテキストは複数行にまたがっても構わない。ただし、インストールを行うツールは通常フィールド本体を処理する際にそれらを 1 行にまとめてしまう (以下で説明する B<Description> フィールドを除く)。

note: type: SH
en: REQUIRED FIELDS
ja: 必須フィールド

note: type: TP
en: B<Package:>I< package-name>
ja: B<Package:>I< パッケージ名>

note: type: Plain text
en: The value of this field determines the package name, and is used to generate file names by most installation tools.
ja: このフィールドの値によってパッケージ名が決まる。またインストールを行うツールの大半によって、ファイル名を生成するために使用される。

note: type: TP
en: B<Version:>I< version-string>
ja: B<Version:>I<バージョン文字列>

note: type: Plain text
en: Typically, this is the original package's version number in whatever form the program's author uses. It may also include a Debian revision number (for non-native packages). The exact format and sorting algorithm are described in B<deb-version>(5).
ja: 通常、このフィールドの値はプログラムの作者が使用する形式で付けられた、パッケージ本来のバージョン番号であるが、(Debian 固有のパッケージでない場合は) Debian リビジョン番号が付加されることもある。この形式とソートアルゴリズムの詳細は、B<deb-version>(5) で説明されている。

note: type: Plain text
en: Should be in the format `Joe Bloggs E<lt>jbloggs@foo.comE<gt>', and is typically the person who created the package, as opposed to the author of the software that was packaged.
ja: `Joe Bloggs E<lt>jbloggs@foo.comE<gt>' 形式で設定すること。パッケージ化されたソフトウェアの開発者ではなく、パッケージ作成者の情報を設定する。

note: type: TP
en: B<Description:>I< short-description>
ja: B<Description:>I< 短い説明>

note: type: Plain text
en: B< >I<long-description>
ja: B< >I<長い説明>

note: type: Plain text
en: The format for the package description is a short brief summary on the first line (after the "Description" field). The following lines should be used as a longer, more detailed description. Each line of the long description must be preceded by a space, and blank lines in the long description must contain a single '.' following the preceding space.
ja: パッケージ説明の形式は、先頭行 ("Description" フィールドの後) に短い説明、それ以降の行に詳細な長い説明というものである。長い説明の各行は、スペースから始まる必要がある。空行は、行頭のスペースに続けて '.' を 1 つだけ記述する必要がある。

note: type: SH
en: OPTIONAL FIELDS
ja: オプションフィールド

note: type: TP
en: B<Section:>I< section>
ja: B<Section:>I< セクション>

note: type: Plain text
en: This is a general field that gives the package a category based on the software that it installs. Some common sections are `utils', `net', `mail', `text', `x11' etc.
ja: パッケージによりインストールされるソフトウェアがどのセクションの分類に属するかを示すフィールドである。一般的なセクションには `utils', `net', `mail', `text', `x11' などがある。

note: type: Plain text
en: Sets the importance of this package in relation to the system as a whole.  Common priorities are `required', `standard', `optional', `extra' etc.
ja: システム全体からみたこのパッケージの重要度を示す。一般的に使われる priority には `required'、`standard'、`optional'、`extra' などがある。

note: type: Plain text
en: In Debian, the B<Section> and B<Priority> fields have a defined set of accepted values based on the Policy Manual.  A list of these values can be obtained from the latest version of the B<debian-policy> package.
ja: Debian では、B<Section> と B<Priority> フィールドで使える値がポリシーマニュアルで定められている。最新の B<debian-policy> パッケージから一覧を取得できる。

note: type: Plain text
en: This field is usually only needed when the answer is B<yes>. It denotes a package that is required for proper operation of the system. Dpkg or any other installation tool will not allow an B<Essential> package to be removed (at least not without using one of the force options).
ja: このフィールドは通常 B<yes> に設定する場合だけ必要とされ、パッケージがシステムを適切に稼働させる上で必須であることを示す。dpkg を含むインストールを行うツールは、(少なくとも強制オプションのいずれかを用いない限り) B<Essential> パッケージの削除を許可しない。

note: type: TP
en: B<Architecture:> I<arch>|B<all>
ja: B<Architecture:> I<アーキテクチャ>|B<all>

note: type: Plain text
en: The architecture specifies which type of hardware this package was compiled for. Common architectures are `i386', `m68k', `sparc', `alpha', `powerpc' etc. Note that the B<all> option is meant for packages that are architecture independent. Some examples of this are shell and Perl scripts, and documentation.
ja: アーキテクチャは、パッケージがコンパイルされた際の対象ハードウェアを示す。一般的なアーキテクチャには `i386', `m68k', `sparc', `alpha', `powerpc' などがある。B<all> オプションは、パッケージが architecture 非依存であることを意味する。これには、シェルスクリプト、Perl スクリプト、ドキュメントなどが該当する。

note: type: TP
en: B<Origin:>I< name>
ja: B<Origin:>I< ディストリビューション名>

note: type: Plain text
en: The name of the distribution this package is originating from.
ja: パッケージの起源となったディストリビューション名。

note: type: Plain text
en: The I<url> of the bug tracking system for this package. The current used format is I<bts-type>B<://>I<bts-address>, like B<debbugs://bugs.debian.org>.
ja: パッケージのバグトラッキングシステムの I<url>。現在使われている形式は、B<debbugs://bugs.debian.org> のような I<bts-type>B<://>I<bts_address> 形式である。

note: type: Plain text
en: The upstream project home page I<url>.
ja: アップストリームのプロジェクトのホームページ I<url>。

note: type: TP
en: B<Tag:>I< tag-list>
ja: B<Tag:>I< タグのリスト>

note: type: Plain text
en: List of tags describing the qualities of the package. The description and list of supported tags can be found in the B<debtags> package.
ja: パッケージの品質を示すタグのリスト。サポートされているタグの一覧と説明は、B<debtags> パッケージを参照のこと。

note: type: Plain text
en: This field is used to indicate how this package should behave on a multi-arch installations. The value B<same> means that the package is co-installable with itself, but it must not be used to satisfy the dependency of any package of a different architecture from itself. The value B<foreign> means that the package is not co-installable with itself, but should be allowed to satisfy the dependency of a package of a different arch from itself. The value B<allowed> allows reverse-dependencies to indicate in their Depends field that they accept a package from a foreign architecture, but has no effect otherwise.
ja: このフィールドは、multiarch インストールの際のパッケージの動作を定義するために使用される。B<same> は、パッケージが多重インストール (co-install) 可能である (訳注: あるパッケージに対して、別アーキテクチャの同一パッケージをインストールできる) 一方、別アーキテクチャのいかなるパッケージとの依存関係を満たすためにも使用してはいけないことを意味する。B<foreign> は、パッケージを多重インストールできないが、別アーキテクチャのパッケージの依存関係を満たすことが可能であることを意味する。 B<allowed> は、別アーキテクチャのパッケージを許容するような逆の依存関係を Depends フィールドに指定可能であることを示すだけで、それ以上の意味はない。

note: type: TP
en: B<Source:>I< source-name>
ja: B<Source:>I< ソースパッケージ名>

note: type: Plain text
en: The name of the source package that this binary package came from, if different than the name of the package itself.
ja: このバイナリパッケージを作るために使われたソースパッケージ名である。バイナリパッケージの名前とソースパッケージの名前が違う時に使われる。

note: type: Plain text
en: These fields are used by the debian-installer and are usually not needed.  See /usr/share/doc/debian-installer/devel/modules.txt from the B<debian-installer> package for more details about them.
ja: これらのフィールドは、debian-installer によって用いられるもので、通常は不要である。詳細については、B<debian-installer> パッケージに含まれている/usr/share/doc/debian-installer/devel/modules.txt を参照のこと

note: type: TP
en: B<Depends:>I< package-list>
ja: B<Depends:>I< パッケージのリスト>

note: type: Plain text
en: List of packages that are required for this package to provide a non-trivial amount of functionality. The package maintenance software will not allow a package to be installed if the packages listed in its B<Depends> field aren't installed (at least not without using the force options).  In an installation, the postinst scripts of packages listed in Depends: fields are run before those of the packages which depend on them. On the opposite, in a removal, the prerm script of a package is run before those of the packages listed in its Depends: field.
ja: このパッケージが提供する大半の機能にとって必要となるパッケージのリスト。パッケージ管理ソフトウェアは、インストールするパッケージの B<Depends> フィールドに列挙されているパッケージがインストールされていない場合、(少なくとも強制オプションを指定しない限りは)、そのパッケージのインストールを許可しない。インストールの際は、Depends: フィールドに列挙されているパッケージの postinst スクリプトが、依存しているパッケージのスクリプトより先に実行される。反対に削除の際には、削除しようとしているパッケージの prerm スクリプトが Depends: フィールドに列挙されているパッケージのスクリプトより先に実行される。

note: type: TP
en: B<Pre-Depends:>I< package-list>
ja: B<Pre-Depends:>I< パッケージのリスト>

note: type: Plain text
en: List of packages that must be installed B<and> configured before this one can be installed. This is usually used in the case where this package requires another package for running its preinst script.
ja: パッケージのインストール前にインストールされ、B<かつ>設定済でなければならないパッケージのリスト。このフィールドは、通常あるパッケージが他のパッケージをpreinst スクリプトで必要とする際に用いられる。

note: type: TP
en: B<Recommends:>I< package-list>
ja: B<Recommends:>I< パッケージのリスト>

note: type: Plain text
en: Lists packages that would be found together with this one in all but unusual installations. The package maintenance software will warn the user if they install a package without those listed in its B<Recommends> field.
ja: 例外的な場合を除き、このパッケージと共にインストールした方がよいパッケージのリスト。B<Recommends> フィールドに列挙されているパッケージ抜きでパッケージをインストールしようとすると、パッケージ管理ソフトウェアは警告を発する。

note: type: TP
en: B<Suggests:>I< package-list>
ja: B<Suggests:>I< パッケージのリスト>

note: type: Plain text
en: Lists packages that are related to this one and can perhaps enhance its usefulness, but without which installing this package is perfectly reasonable.
ja: このパッケージと関係があり、利便性を向上させることができるが、インストールしなくても構わないパッケージのリスト。

note: type: Plain text
en: The syntax of B<Depends>, B<Pre-Depends>, B<Recommends> and B<Suggests> fields is a list of groups of alternative packages. Each group is a list of packages separated by vertical bar (or `pipe') symbols, `|'. The groups are separated by commas. Commas are to be read as `AND', and pipes as `OR', with pipes binding more tightly. Each package name is optionally followed by a version number specification in parentheses.
ja: B<Depends>, B<Pre-Depends>, B<Recommends>, B<Suggests> フィールドは、代替パッケージグループのリストである。各代替パッケージグループは、パッケージを縦棒(`パイプ')記号 `|' で区切ったリストで表現する。代替パッケージグループ間はコンマで区切る。コンマは `AND'、パイプは `OR' で、パイプの優先度が高いという理解でよい。各パッケージ名の後に、括弧で囲んでバージョン番号の指定を行うこともできる。

note: type: Plain text
en: A version number may start with a `E<gt>E<gt>', in which case any later version will match, and may specify or omit the Debian packaging revision (separated by a hyphen). Accepted version relationships are "E<gt>E<gt>" for greater than, "E<lt>E<lt>" for less than, "E<gt>=" for greater than or equal to, "E<lt>=" for less than or equal to, and "=" for equal to.
ja: バージョン番号が `E<gt>E<gt>' で始まる場合は、それより新しいバージョンすべてにマッチする。バージョン番号には、(ハイフンに続けて) Debian パッケージリビジョンを指定することもできるが、省略しても構わない。「より新しい」を意味する "E<gt>E<gt>"、「より古い」を意味する "E<lt>E<lt>"、「同じか新しい」を意味する "E<gt>="、「同じか古い」を意味する "E<lt>="、「同じ」を意味する "=" を使用できる。

note: type: TP
en: B<Breaks:>I< package-list>
ja: B<Breaks:>I< パッケージのリスト>

note: type: Plain text
en: Lists packages that this one breaks, for example by exposing bugs when the named packages rely on this one. The package maintenance software will not allow broken packages to be configured; generally the resolution is to upgrade the packages named in a B<Breaks> field.
ja: パッケージが依存している機能のバグを顕在化させてしまうなどで、パッケージを機能不全に陥れてしまうパッケージのリスト。パッケージ管理ソフトウェアは、こうしたパッケージを設定できないようにしている。一般的には、B<Breaks> フィールドに設定されているパッケージのアップグレードが解決策となる。

note: type: TP
en: B<Conflicts:>I< package-list>
ja: B<Conflicts:>I< パッケージのリスト>

note: type: Plain text
en: Lists packages that conflict with this one, for example by containing files with the same names. The package maintenance software will not allow conflicting packages to be installed at the same time. Two conflicting packages should each include a B<Conflicts> line mentioning the other.
ja: 同じ名前のファイルが存在しているなどで、このパッケージと競合するパッケージのリスト。パッケージ管理ソフトウェアは、競合しているパッケージを同時にインストールできないようにしている。競合しているパッケージ同士は、互いに相手を B<Conflicts> 行に設定しておくべきである。

note: type: TP
en: B<Replaces:>I< package-list>
ja: B<Replaces:>I< パッケージのリスト>

note: type: Plain text
en: List of packages files from which this one replaces. This is used for allowing this package to overwrite the files of another package and is usually used with the B<Conflicts> field to force removal of the other package, if this one also has the same files as the conflicted package.
ja: このパッケージによって置き換えられるファイルを含むパッケージのリスト。このパッケージと競合するパッケージに同じ名前のファイルが含まれている際に、他のパッケージのファイルを上書きできるようにするために用いられる。通常、他のパッケージを強制的に削除するため B<Conflicts> フィールドも併せて設定される。

note: type: TP
en: B<Provides:>I< package-list>
ja: B<Provides:>I< パッケージのリスト>

note: type: Plain text
en: This is a list of virtual packages that this one provides. Usually this is used in the case of several packages all providing the same service.  For example, sendmail and exim can serve as a mail server, so they provide a common package (`mail-transport-agent') on which other packages can depend. This will allow sendmail or exim to serve as a valid option to satisfy the dependency. This prevents the packages that depend on a mail server from having to know the package names for all of them, and using `|' to separate the list.
ja: このパッケージが提供する仮想パッケージのリスト。通常、仮想パッケージは複数パッケージが同一のサービスを提供している場合に用いられる。例えば、sendmail と exim は共にメールサーバの機能を提供しているので、共通のパッケージ (`mail-transport-agent') を提供した上で、他のパッケージがこれに依存するように設定する。これにより、sendmail でも exim でも依存関係を満たすような設定が可能となり、メールサーバに依存するパッケージが、メールサーバとして機能するパッケージをすべて把握した上で、`|' を用いて列挙するといった必要がなくなる。

note: type: Plain text
en: The syntax of B<Breaks>, B<Conflicts>, B<Replaces> and B<Provides> is a list of package names, separated by commas (and optional whitespace).  In the B<Breaks> and B<Conflicts> fields, the comma should be read as `OR'. An optional version can also be given with the same syntax as above for the B<Breaks>, B<Conflicts> and B<Replaces> fields.
ja: B<Breaks>, B<Conflicts>, B<Replaces>, B<Provides> は、コンマで区切られた (空白文字があってもよい) パッケージ名のリストである。 B<Breaks> および B<Conflicts> フィールドにおけるコンマは `OR' と解釈できる。B<Breaks>, B<Conflicts>, B<Replaces> フィールドでは、前述した記法で、バージョンを指定することもできる。

note: type: TP
en: B<Built-Using:>I< package-list>
ja: B<Built-Using:>I< パッケージのリスト>

note: type: Plain text
en: This field lists extra source packages that were used during the build of this binary package.  This is an indication to the archive maintenance software that these extra source packages must be kept whilst this binary package is maintained.  This field must be a list of source package names with strict (=)  version relationships.  Note that the archive maintenance software is likely to refuse to accept an upload which declares a B<Built-Using> relationship which cannot be satisfied within the archive.
ja: このフィールドには、このバイナリパッケージのビルドに用いられる別のソースパッケージを列挙する。これは、このバイナリパッケージをメンテナンスし続ける限り、別のソースパッケージも維持しなければならないことをアーカイブメンテナンスソフトウェアに通知するために用いられる。このフィールドには、(= を用いて) バージョン番号を明示したソースパッケージ名を列挙しなければならない。アーカイブメンテナンスソフトウェアは、アーカイブ内で解決できないような依存関係が B<Built-Using> で指定された場合に、アップロードを拒否する可能性があるという点に留意すること。

note: type: SH
en: EXAMPLE
ja: 例

note: type: Plain text
en: deb-src-control - Debian source packages' master control file format
ja: deb-src-control - Debian ソースパッケージのマスター制御ファイルのフォーマット

note: type: Plain text
en: Each Debian source package contains the master "control" file, which contains at least 2 paragraphs, separated by a blank line. The first paragraph lists all information about the source package in general, while each following paragraph describes exactly one binary package. Each paragraph consists of at least one field. A field starts with a fieldname, such as B<Package> or B<Section> (case insensitive), followed by a colon, the body of the field and a newline.  Multi-line fields are also allowed, but each supplementary line, without a fieldname, should start with at least one space. The content of the multi-line fields is generally joined to a single line by the tools (except in the case of the B<Description> field, see below). To insert empty lines into a multi-line field, insert a dot after the space. Lines starting with a B<'#'> are treated as comments.
ja: Debian の各ソースパッケージには、マスタとなる "control" ファイルがある。ファイルには、空白行で区切られた最低 2 つの段落が含まれる。最初の段落には、通常ソースパッケージに関するすべての情報が列挙されている。以降の段落は、各々が 1 つのバイナリパッケージに関する設定となる。各段落は、最低 1 つのフィールドからなる。フィールドは Package やSection (大文字小文字の区別なし) といったフィールド名から始まり、コロンの後にフィールドの本体 (値) が続き、改行で終わる。フィールドは複数行にまたがっても構わないが、フィールド名を含まない追加の行は、最低 1 つのスペースから始まる必要がある。通常、複数行にまたがるフィールドの本体は、ツールによって 1行にまとめられる (ただし、以下で説明する B<Description> フィールドは例外である)。空行を追加したい場合は、スペースに続けてドットを 1 つだけ記述する。B<'#'> で始まる行はコメントとして扱われる。

note: type: SH
en: SOURCE FIELDS
ja: SOURCE フィールド

note: type: TP
en: B<Source:> I<source-package-name> (required)
ja: B<Source:> I<ソースパッケージ名> (必須)

note: type: Plain text
en: The value of this field is the name of the source package, and should match the name of the source package in the debian/changelog file. A package name must consist only of lower case letters (a-z), digits (0-9), plus (+) and minus (-) signs, and periods (.). Package names must be at least two characters long and must start with an alphanumeric character.
ja: このフィールドの値がソースパッケージ名となる。これは debian/changelog ファイル内のソースパッケージ名と合致させるべきである。パッケージ名には、小文字(a-z)、数字 (0-9)、プラス (+)、マイナス (-) 記号とピリオド (.) のみを含めることができる。パッケージ名は最低 2 文字以上の長さとし、英数字で始めなければならない。

note: type: TP
en: B<Maintainer:> I<fullname-email> (required)
ja: B<Maintainer:> I<fullname-email> (必須)

note: type: Plain text
en: Should be in the format "Joe Bloggs E<lt>jbloggs@foo.comE<gt>", and references the person who currently maintains the package, as opposed to the author of the software or the original packager.
ja: `Joe Bloggs E<lt>jbloggs@foo.comE<gt>' 形式で設定すること。パッケージ化されたソフトウェアの開発者や元々のパッケージ作成者ではなく、*このパッケージ* の現在のメンテナの情報を記載する。

note: type: Plain text
en: Lists all the names and email addresses of co-maintainers of the package, in the same format as the Maintainer field. Multiple co-maintainers should be separated by a comma.
ja: パッケージの共同メンテナの名前と電子メールアドレスを Maintainer フィールドと同じ形式で列挙する。共同メンテナが複数人いる場合はコンマで区切ること。

note: type: TP
en: B<Standards-Version:>I< version-string>
ja: B<Standards-Version:>I< バージョン文字列>

note: type: Plain text
en: This documents the most recent version of the standards (which consists of the Debian Policy Manual and referenced texts from the B<debian-policy> package) this package complies to.
ja: このパッケージが準拠した標準 (B<debian-policy> パッケージに含まれる Debian Policy Manual と関連ドキュメントから構成される) の最新バージョンを示す。

note: type: Plain text
en: The upstream project home page URL.
ja: アップストリームのプロジェクトのホームページ URL。

note: type: Plain text
en: The I<url> of the bug tracking system for this package. The current used format is I<bts-type>B<://>I<bts-address>, like B<debbugs://bugs.debian.org>. This field is usually not needed.
ja: パッケージのバグトラッキングシステムの I<url>。現在使われている形式は、B<debbugs://bugs.debian.org> のような I<bts-type>B<://>I<bts_address> 形式である。このフィールドは一般的に必要とされない。

note: type: Plain text
en: The I<url> of the Version Control System repository used to maintain this package. Currently supported are B<Arch>, B<Bzr> (Bazaar), B<Cvs>, B<Darcs>, B<Git>, B<Hg> (Mercurial), B<Mtn> (Monotone) and B<Svn> (Subversion). Usually this field points to the latest version of the package, such as the main branch or the trunk.
ja: このパッケージの管理に用いられているバージョン管理システムのリポジトリ I<url>。現在サポートされているのは、B<Arch>, B<Bzr> (Bazaar), B<Cvs>, B<Darcs>, B<Git>, B<Hg>(Mercurial), B<Mtn> (Monotone), B<Svn> (Subversion) である。通常、このフィールドは、main ブランチや trunk といった最新版のパッケージを示している。

note: type: Plain text
en: The I<url> of a webinterface to browse the Version Control System repository.
ja: バージョン管理システムのリポジトリを閲覧するための Web インタフェースの I<url>。

note: type: Plain text
en: The name of the distribution this package is originating from. This field is usually not needed.
ja: パッケージの起源となったディストリビューション名。このフィールドは、通常不要である。

note: type: Plain text
en: This is a general field that gives the package a category based on the software that it installs. Some common sections are "utils", "net", "mail", "text", "x11", etc.
ja: パッケージによりインストールされるソフトウェアがどのセクションの分類に属するかを示すフィールドである。一般的なセクションには "utils" や "net"、"mail"、"text"、"x11" などがある。

note: type: Plain text
en: Sets the importance of this package in relation to the system as a whole.  Common priorities are "required", "standard", "optional", "extra", etc.
ja: システム全体からみたこのパッケージの重要度を示す。一般的に使われる priority には "required"、"standard"、"optional"、"extra" などがある。

note: type: TP
en: B<Build-Depends:>I< package-list>
ja: B<Build-Depends:>I< パッケージのリスト>

note: type: Plain text
en: A list of packages that need to be installed and configured to be able to build the source package. Including a dependency in this list has the same effect as including it in both B<Build-Depends-Arch> and B<Build-Depends-Indep>, with the additional effect of being used for source-only builds.
ja: ソースパッケージをビルドするためにインストールと設定が必要なパッケージのリスト。このリストで定義した依存関係は、B<Build-Depends-Arch> と B<Build-Depends-Indep> の両方で行った定義と同じ効力を持つだけでなく、ソースのみのビルドにおいても効力を持つ。

note: type: TP
en: B<Build-Depends-Arch:>I< package list>
ja: B<Build-Depends-Arch:>I< パッケージのリスト>

note: type: Plain text
en: Same as B<Build-Depends>, but they are only needed when building the architecture dependent packages. The B<Build-Depends> are also installed in this case. This field was introduced in dpkg version 1.16.4; in order to build with older dpkg versions, B<Build-Depends> should be used instead.
ja: B<Build-Depends> と同様だが、アーキテクチャ非依存なパッケージをビルドする場合にのみ必要とされるもの。B<Build-Depends> もインストールされる。このフィールドは dpkg バージョン 1.16.4 で導入された。古いバージョンの dpkg によるビルドを可能とするためには、B<Build-Depends> を代わりに用いるべきである。

note: type: TP
en: B<Build-Depends-Indep:>I< package-list>
ja: B<Build-Depends-Indep:>I< パッケージのリスト>

note: type: Plain text
en: Same as B<Build-Depends>, but they are only needed when building the architecture independent packages. The B<Build-Depends> are also installed in this case.
ja: B<Build-Depends> と同様だが、アーキテクチャ非依存なパッケージをビルドする場合にのみ必要とされるもの。B<Build-Depends> もインストールされる。

note: type: TP
en: B<Build-Conflicts:>I< package list>
ja: B<Build-Conflicts:>I< パッケージのリスト>

note: type: Plain text
en: A list of packages that should not be installed when the package is built, for example because they interfere with the build system used.  Including a dependency in this list has the same effect as including it in both B<Build-Conflicts-Arch> and B<Build-Conflicts-Indep>, with the additional effect of being used for source-only builds.
ja: ビルドシステムの動作に影響するなど、パッケージがビルドされる時にインストールされていることが好ましくないパッケージのリスト。このリストで定義した依存関係は、B<Build-Conflicts-Arch> と B<Build-Conflicts-Indep> の両方で行った定義と同じ効力を持つだけでなく、ソースのみのビルドにおいても効力を持つ。

note: type: TP
en: B<Build-Conflicts-Arch:>I< package list>
ja: B<Build-Conflicts-Arch:>I< パッケージのリスト>

note: type: Plain text
en: Same as B<Build-Conflicts>, but only when building the architecture dependent packages. This field was introduced in dpkg version 1.16.4; in order to build with older dpkg versions, B<Build-Conflicts> should be used instead.
ja: B<Build-Conflicts> と同様だが、アーキテクチャ依存のパッケージをビルドする場合にのみ必要とされるもの。このフィールドは dpkg バージョン 1.16.4 で導入された。古いバージョンの dpkg によるビルドを可能とするためには、B<Build-Conflicts> を代わりに用いるべきである。

note: type: TP
en: B<Build-Conflicts-Indep:>I< package-list>
ja: B<Build-Conflicts-Indep:>I< パッケージのリスト>

note: type: Plain text
en: Same as B<Build-Conflicts>, but only when building the architecture independent packages.
ja: Build-Conflicts と同様だが、アーキテクチャ非依存なパッケージをビルドする場合にのみ影響するもの。

note: type: Plain text
en: The syntax of the B<Build-Depends>, B<Build-Depends-Arch> and B<Build-Depends-Indep> fields is a list of groups of alternative packages. Each group is a list of packages separated by vertical bar (or "pipe") symbols, "|". The groups are separated by commas. Commas are to be read as "AND", and pipes as "OR", with pipes binding more tightly. Each package name is optionally followed by a version number specification in parentheses and an architecture specification in square brackets.
ja: B<Build-Depends>, B<Build-Depends-Arch>, B<Build-Depends-Indep> フィールドには、代替パッケージグループのリストを指定する。各グループでは、互換性のあるパッケージを縦棒(`パイプ')記号 "|" で区切ったリストで表現する。代替パッケージグループ間はコンマで区切る。コンマは "AND"、パイプは "OR" で、パイプの優先度が高いという理解でよい。各パッケージ名の後に、括弧で囲んでバージョン番号の指定を行ったり、角括弧で囲んでアーキテクチャの指定を行ったりすることもできる。

note: type: Plain text
en: The syntax of the B<Build-Conflicts>, B<Build-Conflicts-Arch> and B<Build-Conflicts-Indep> fields is a list of comma-separated package names, where the comma is read as an "AND". Specifying alternative packages using a "pipe" is not supported.  Each package name is optionally followed by a version number specification in parentheses and an architecture specification in square brackets.
ja: B<Build-Conflicts>, B<Build-Conflicts-Arch>, B<Build-Conflicts-Indep> フィールドには、パッケージ名をコンマで区切って列挙する。 コンマは "AND" という理解でよい。"パイプ" を用いて複数の代替パッケージを指定する記法はサポートされない。各パッケージ名の後に、括弧で囲んでバージョン番号の指定を行ったり、角括弧で囲んでアーキテクチャの指定を行ったりすることもできる。

note: type: Plain text
en: A version number may start with a "E<gt>E<gt>", in which case any later version will match, and may specify or omit the Debian packaging revision (separated by a hyphen). Accepted version relationships are "E<gt>E<gt>" for greater than, "E<lt>E<lt>" for less than, "E<gt>=" for greater than or equal to, "E<lt>=" for less than or equal to, and "=" for equal to.
ja: バージョン番号が "E<gt>E<gt>" で始まる場合は、それより新しいバージョンすべてにマッチする。バージョン番号には、(ハイフンに続けて) Debian パッケージリビジョンを指定することもできるが、省略しても構わない。「より新しい」を意味する "E<gt>E<gt>"、「より古い」を意味する "E<lt>E<lt>"、「同じか新しい」を意味する "E<gt>="、「同じか古い」を意味する "E<lt>="、「同じ」を意味する "=" を使用できる。

note: type: Plain text
en: A architecture specification consists of one or more architecture names, separated by whitespace. Exclamation marks may be prepended to each of the names, meaning "NOT".
ja: 空白文字で区切った 1 つ以上のアーキテクチャ名により、アーキテクチャを指定する。感嘆符がアーキテクチャ名の前にある場合は "NOT" を意味する。

note: type: Plain text
en: Note that dependencies on packages in the B<build-essential> set can be omitted and that declaring build conflicts against them is impossible. A list of these packages is in the build-essential package.
ja: B<build-essential> に含まれるパッケージとの依存関係は省略できること、これらのパッケージと競合するようなビルド設定は禁止されている点に留意すること。該当するパッケージの一覧は、build-essential パッケージに含まれている。

note: type: SH
en: BINARY FIELDS
ja: BINARY フィールド

note: type: Plain text
en: Note that the B<Priority>, B<Section> and B<Homepage> fields can also be in a binary paragraph to override the global value from the source package.
ja: B<Priority>, B<Section>, B<Homepage> フィールドは、BINARY 段落に設定することで、ソースパッケージで定義されたグローバルな値を上書きすることも可能である点に留意すること。

note: type: TP
en: B<Package:> I<binary-package-name> (required)
ja: B<Package:> I<バイナリパッケージ名> (必須)

note: type: Plain text
en: This field is used to name the binary package name. The same restrictions as to a source package name apply.
ja: このフィールドはバイナリパッケージ名の指定に用いられる。ソースパッケージ名と同様の制約が適用される。

note: type: TP
en: B<Architecture:> I<arch>|B<all>|B<any> (required)
ja: B<Architecture:> I<arch>|B<all>|B<any> (必須)

note: type: Plain text
en: The architecture specifies on which type of hardware this package runs. For packages that run on all architectures, use the B<any> value. For packages that are architecture independent, such as shell and Perl scripts or documentation, use the B<all> value. To restrict the packages to a certain set of architectures, specify the architecture names, separated by a space. It's also possible to put architecture wildcards in that list (see B<dpkg-architecture>(1)  for more information about them).
ja: アーキテクチャ (Architecture) は、このパッケージが動作するハードウェア種別を指定する。すべてのアーキテクチャで動作するパッケージは、値 B<any> を使用する。シェルスクリプトや Perl スクリプト、ドキュメントといったアーキテクチャ非依存のパッケージは、値 B<all> を使用する。パッケージのアーキテクチャを制約したい場合は、アーキテクチャ名をスペースで区切って指定する。アーキテクチャのワイルドカードを使用することも可能である (詳細は B<dpkg-architecture>(1) を参照のこと)。

note: type: Plain text
en: This field defines the type of the package. "udeb" is for size-constrained packages used by the debian installer. "deb" is the default value, it's assumed if the field is absent. More types might be added in the future.
ja: このフィールドは、パッケージのタイプを指定する。"udeb" は debian installer が使用するサイズの制約があるパッケージである。"deb" はデフォルトの値であり、フィールドが存在しなかった場合に仮定される値である。将来的にはこれ以外のタイプが追加されるかもしれない。

note: type: TP
en: B<Description:> I<short-description> (required)
ja: B<Description:> I<短い説明> (必須)

note: type: Plain text
en: These fields are described in the B<deb-control>(5)  manual page, as they are copied literally to the control file of the binary package.
ja: これらのフィールドは、バイナリパッケージの control ファイルにそのままコピーされるため、B<deb-control>(5) のマニュアルページで解説されている。

note: type: TP
en: B<Enhances:>I< package-list>
ja: B<Enhances:>I< パッケージのリスト>

note: type: Plain text
en: These fields declare relationships between packages. They are discussed in the B<deb-control>(5)  manpage and in the B<debian-policy> package.
ja: これらのフィールドは、パッケージ間の関連性を指定するものであり、B<deb-control>(5) マニュアルページと B<debian-policy> パッケージで説明されている。

note: type: SH
en: USER-DEFINED FIELDS
ja: ユーザ定義フィールド

note: type: Plain text
en: It is allowed to add additional user-defined fields to the control file. The tools will ignore these fields. If you want the fields to be copied over to the output files, such as the binary packages, you need to use a custom naming scheme: the fields should start with a X, followed by one or more of the letters BCS and a hypen. If the letter B is used, the field will appear in the control file in the binary package, see B<deb-control>(5), for the letter S in the source package control file as constructed by B<dpkg-source>(1)  and for the letter C in the upload control (.changes) file. Note that the X[BCS]- prefixes are stripped when the fields are copied over to the output files. A field B<XC-Approved-By> will appear as B<Approved-By> in the changes file and will not appear in the binary or source package control files.
ja: control ファイルに、ユーザが定義する追加のフィールドを含めることもできる。ツール類は、これらのフィールドを無視する。フィールドをバイナリパッケージなどの出力ファイルにもコピーしたい場合は、X に続き、文字 BCS から 1 文字以上とハイフンとをつなげた custom naming scheme を使用する必要がある。文字 B を使用する場合、フィールドはバイナリパッケージの control ファイルに複製される。B<deb-control>(5) も参照のこと。文字 S の場合は B<dpkg-source>(1) によって作成されるソースパッケージ内の control ファイルに、文字 C の場合はアップロードの制御ファイル (.changes ファイル) に、各々複製される。フィールドが出力ファイルにコピーされる時に、X[BCS]- というプレフィックスは削除されることに注意。例えば B<XC-Approved-By> というフィールドは changes ファイルでは B<Approved-By>となり、バイナリやソースパッケージ内 の control ファイルには複製されない点に留意すること。

note: type: Plain text
en: Take into account that these user-defined fields will be using the global namespace, which might at some point in the future collide with officially recognized fields. To avoid such potential situation you can prefix those fields with B<Private->, such as B<XB-Private-New-Field>, which as a side effect will make B<dpkg-deb> not warn on them as unknown fields.
ja: こうしたユーザ定義のフィールドはグローバルな名前空間を使用するため、将来的に公式に定義されたフィールドと衝突する可能性がある点に注意。このような潜在的な可能性を避けるために、これらのフィールドを B<XB-Private-New-Field> のように B<Private-> から開始するとよい。これには、B<dpkg-deb> がこれらを不明なフィールドとして警告しなくなるという副次的効果もある。

note: type: Plain text
en: deb-split - Debian multi-part binary package format
ja: deb-split - Debian マルチパートのバイナリパッケージ形式

note: type: Plain text
en: The multi-part B<.deb> format is used to split big packages into smaller pieces to ease transport in small media.
ja: マルチパート B<.deb> 形式は、巨大なパッケージを小さく分割することで、小容量メディアでの転送を容易にするために用いられる。

note: type: Plain text
en: The file is an B<ar> archive with a magic value of B<!E<lt>archE<gt>>.  The file names might contain a trailing slash (since dpkg 1.15.6).
ja: このファイルはマジックナンバー B<!E<lt>archE<gt>> を持つ B<ar> アーカイブである。ファイル名はスラッシュで終わる場合がある (dpkg 1.15.6 以降)。

note: type: Plain text
en: The first member is named B<debian-split> and contains a series of lines, separated by newlines. Currently eight lines are present:
ja: アーカイブ先頭のファイルは B<debian-split> である。このファイルは、改行で区切られた数行からなる。現在のところ 8 行が存在する:

note: type: Plain text
en: The format version number, B<2.1> at the time this manual page was written.
ja: 本マニュアルページが書かれた時点での形式のバージョン番号は、B<2.1> である。

note: type: Plain text
en: The package name.
ja: パッケージ名

note: type: Plain text
en: The package version.
ja: パッケージのバージョン

note: type: Plain text
en: The md5sum of the package.
ja: パッケージの md5sum

note: type: Plain text
en: The total size of the package.
ja: パッケージ全体のサイズ

note: type: Plain text
en: The maximum part size.
ja: 単一パートの最大サイズ

note: type: Plain text
en: The current part number, followed by a slash and the total amount of parts (as in \(oq1/10\(cq).
ja: 現在のパート番号。スラッシュに続いてパートの総数を記載する形態 (\(oq1/10\(cq) で表記される。

note: type: Plain text
en: The package architecture (since dpkg 1.16.1).
ja: パッケージのアーキテクチャ (dpkg 1.16.1 以降)

note: type: Plain text
en: Programs which read multi-part archives should be prepared for the minor format version number to be increased and additional lines to be present, and should ignore these if this is the case.
ja: マルチパート形式のアーカイブを読み込むプログラムは、マイナーバージョン番号の増加や、新しい行の追加に対応すべきである。その際には、これらを無視すること。

note: type: Plain text
en: If the major format version number has changed, an incompatible change has been made and the program should stop. If it has not, then the program should be able to safely continue, unless it encounters an unexpected member in the archive (except at the end), as described below.
ja: メジャーバージョン番号が変更されている場合は、互換性のない変更がされているとみなし、プログラムは停止すべきである。メジャーバージョンが変更されていない場合は、以下で説明するように、アーカイブに予期しないファイルが含まれていない限り(アーカイブ末尾に含まれる場合を除く)、プログラムは安全に実行を継続できる必要がある。

note: type: Plain text
en: The second, last required member is named B<data.>I<N>, where I<N> denotes the part number. It contains the raw part data.
ja: 2 番目となる最後の必須ファイルは B<data.>I<N> である。I<N> はパート番号を示す。これにはパートのデータそのものが格納されている。

note: type: Plain text
en: These members must occur in this exact order. Current implementations should ignore any additional members after B<data.>I<N>.  Further members may be defined in the future, and (if possible) will be placed after these two.
ja: これらのファイルはこの通りの順序でアーカイブされていなければならない。現在の実装では B<data.>I<N> より後に追加されているファイルを無視すべきである。将来的に追加のファイルが定義された場合は、(やむを得ない場合を除き) これら 2 つのファイルの後にアーカイブされることになるだろう。

note: type: Plain text
en: deb-version - Debian package version number format
ja: deb-version - Debian パッケージのバージョン番号の形式

note: type: Plain text
en: Version numbers as used for Debian binary and source packages consist of three components. These are:
ja: Debian バイナリおよびソースパッケージで用いられているバージョン番号は、以下の 3 つの要素からなっている:

note: type: Plain text
en: This is a single (generally small) unsigned integer.  It may be omitted, in which case zero is assumed.  If it is omitted then the I<upstream-version> may not contain any colons.
ja: これは一桁の (通常小さい) 符号なし整数であり、0 の場合は省略してよい。省略した時には、I<upstream-version> にコロンを含めてはならない。

note: type: Plain text
en: It is provided to allow mistakes in the version numbers of older versions of a package, and also a package's previous version numbering schemes, to be left behind.
ja: I<epoch> は、パッケージの古いバージョンにおけるバージョン番号の誤りを許容すると共に、パッケージの以前のバージョンにおける番号体系をそのまま残しておくために提供されている。

note: type: Plain text
en: This is the main part of the version number.  It is usually the version number of the original ("upstream")  package from which the I<.deb> file has been made, if this is applicable.  Usually this will be in the same format as that specified by the upstream author(s); however, it may need to be reformatted to fit into the package management system's format and comparison scheme.
ja: これはバージョン番号の中核部分であり、通常 I<.deb> ファイルの生成元であるオリジナル ("アップストリーム") のパッケージのバージョン番号が可能であれば用いられる。一般的に、このバージョン番号は、アップストリームの作者によって指定された形式と同じ形式になるが、場合によってはパッケージ管理システムの形式や比較ができる形式に合わせるために、形式の変更が必要となる場合もある。

note: type: Plain text
en: The comparison behavior of the package management system with respect to the I<upstream-version> is described below. The I<upstream-version> portion of the version number is mandatory.
ja: パッケージ管理システムが I<upstream-version> 間で比較を行う際の挙動については後述する。バージョン番号には、必ず I<upstream-version> 部分がなければならない。

note: type: Plain text
en: The I<upstream-version> may contain only alphanumerics ("A-Za-z0-9") and the characters B<.> B<+> B<-> B<:> B<~> (full stop, plus, hyphen, colon, tilde) and should start with a digit.  If there is no I<debian-revision> then hyphens are not allowed; if there is no I<epoch> then colons are not allowed.
ja: I<upstream-version> には英数字 ("A-Za-z0-9") と、文字 B<.> B<+> B<-> B<:> B<~> (ピリオド、プラス、ハイフン、コロン、チルダ) の各記号のみが許容され、先頭は数字である必要がある。I<debian-revision> が存在しない場合は、ハイフンを使うことはできない。I<epoch> が存在しない場合は、コロンを使うこともできない。

note: type: Plain text
en: This part of the version number specifies the version of the Debian package based on the upstream version.  It may contain only alphanumerics and the characters B<+> B<.> B<~> (plus, full stop, tilde) and is compared in the same way as the I<upstream-version> is.
ja: バージョン番号のこの部分では、upstream-version に基づく Debian パッケージとしてのバージョン (リビジョン) を指定する。これには英数字と文字 B<+> B<.> B<~> (プラス、ピリオド、チルダ) のみが許容される。比較については、I<upstream-version> と同様に行われる。

note: type: Plain text
en: It is optional; if it isn't present then the I<upstream-version> may not contain a hyphen.  This format represents the case where a piece of software was written specifically to be turned into a Debian package, and so there is only one "debianisation" of it and therefore no revision indication is required.
ja: この部分は任意であるが、存在しない場合は I<upstream-version> にハイフンを含めることはできない。ソフトウェアが Debian パッケージ化を前提に開発された場合、あるバージョンに対する "debian 化" されたバージョンが 1 つしか存在しないため、リビジョン番号は不要となる。

note: type: Plain text
en: It is conventional to restart the I<debian-revision> at '1' each time time the I<upstream-version> is increased.
ja: I<upstream-version> がバージョンアップしたら、I<debian-revision> は '1' から再度始めるのが慣習になっている。

note: type: Plain text
en: Dpkg will break the version number apart at the last hyphen in the string (if there is one) to determine the I<upstream-version> and I<debian-revision>. The absence of a I<debian-revision> compares earlier than the presence of one (but note that the I<debian-revision> is the least significant part of the version number).
ja: dpkg はバージョン番号文字列を、最後のハイフンの前後で I<upstream-version> とI<debian-revision> とに分割する (ハイフンがある場合)。I<debian-revision> が存在しない場合は、存在する場合よりも小さいとみなされる (ただし、debian-revisionは、バージョン番号を構成する要素のうち、もっとも右の部分であることに留意)。

note: type: SS
en: Sorting Algorithm
ja: ソートアルゴリズム

note: type: Plain text
en: The I<upstream-version> and I<debian-revision> parts are compared by the package management system using the same algorithm:
ja: パッケージ管理システムは、同じアルゴリズムを用いて I<upstream-version> や I<debian-revision> 同士を比較する。

note: type: Plain text
en: The strings are compared from left to right.
ja: 文字列は左から右に順に比較される。

note: type: Plain text
en: First the initial part of each string consisting entirely of non-digit characters is determined.  These two parts (one of which may be empty) are compared lexically.  If a difference is found it is returned.  The lexical comparison is a comparison of ASCII values modified so that all the letters sort earlier than all the non-letters and so that a tilde sorts before anything, even the end of a part.  For example, the following parts are in sorted order: '~~', '~~a', '~', the empty part, 'a'.
ja: 最初に、双方の文字列の先頭から、数字以外の文字からなる部分が切り出され、これら (片方が空文字列の場合もある) が辞書的に比較される。相違点が検出された場合、そこで比較は完了となる。辞書的な比較とは、ASCII 文字の比較に手を加えたもので、すべての文字は記号よりも先となるが、チルダだけは例外で、空文字を含むあらゆる文字よりも先となる。例えば、以下の文字列は、このソート順に並べられている: '~~', '~~a', '~', 空文字, 'a'。

note: type: Plain text
en: Then the initial part of the remainder of each string which consists entirely of digit characters is determined.  The numerical values of these two parts are compared, and any difference found is returned as the result of the comparison.  For these purposes an empty string (which can only occur at the end of one or both version strings being compared) counts as zero.
ja: 次に、双方の文字列の残りの部分の先頭から数字の部分が切り出され、数値として比較される。相違点が検出された場合は、それが比較結果として返却される。空文字列 (比較されるバージョン文字列の末尾以外に存在することはない) は、比較時には 0 として扱われる。

note: type: Plain text
en: These two steps (comparing and removing initial non-digit strings and initial digit strings) are repeated until a difference is found or both strings are exhausted.
ja: このステップ (先頭の数字以外の文字列と数字を順に切り出して比較していく) を、相違点が確認されるか、双方の文字列の終端に達するまで繰り返す。

note: type: Plain text
en: Note that the purpose of epochs is to allow us to leave behind mistakes in version numbering, and to cope with situations where the version numbering scheme changes.  It is B<not> intended to cope with version numbers containing strings of letters which the package management system cannot interpret (such as 'ALPHA' or 'pre-'), or with silly orderings.
ja: epoch は、バージョン番号の設定ミスや、バージョン番号の付与体系の変更にうまく対応できるようにする目的で存在する。パッケージ管理システムが解釈できない文字列 (例えば 'ALPHA' や 'pre-'など) が含まれているバージョン番号や、明らかにおかしい番号づけに対応することを意図したものではB<ない>。

note: type: SH
en: CAVEATS
ja: 警告

note: type: Plain text
en: The tilde character and its special sorting properties were introduced in dpkg, version 1.10 and some parts of dpkg-dev only gained support for it later in the 1.10.x series.
ja: チルダ文字及びその特殊な意味づけは、dpkg 1.10 から導入されたが、dpkg-dev の一部機能では、1.10.x 系列の後期になって、ようやくサポートされた。

note: type: Plain text
en: deb-old - old style Debian binary package format
ja: deb-old - 旧 Debian バイナリパッケージ形式

note: type: Plain text
en: The B<.deb> format is the Debian binary package file format. This manual page describes the B<old> format, used before Debian 0.93. Please see B<deb>(5)  for details of the new format.
ja: B<.deb> 形式は Debian バイナリパッケージのファイル形式である。このマニュアルでは、Debian 0.93 以前に使用されていた B<旧>形式について説明する。新しい形式の詳細については B<deb>(5) を参照のこと。

note: type: Plain text
en: The file is two lines of format information as ASCII text, followed by two concatenated gzipped ustar files.
ja: ファイルには 2 行の ASCII テキストによる形式情報があり、それに 2 つの gzip 圧縮された ustar ファイルが続く。

note: type: Plain text
en: The first line is the format version number padded to 8 digits, and is B<0.939000> for all old-format archives.
ja: 1 行目は 8 桁にそろえた形式のバージョン番号であり、旧形式のアーカイブはすべて B<0.939000> である。

note: type: Plain text
en: The second line is a decimal string (without leading zeroes) giving the length of the first gzipped tarfile.
ja: 2 行目はひとつ目の gzip 圧縮 tar ファイルの大きさを意味する (0 から始まらない) 十進数の数値文字列である。

note: type: Plain text
en: Each of these lines is terminated with a single newline character.
ja: それぞれの行の終わりには改行文字がひとつ置かれる。

note: type: Plain text
en: The first tarfile contains the control information, as a series of ordinary files. The file B<control> must be present, as it contains the core control information.
ja: 1 番目の tar ファイルは、制御情報を含む幾つかの平文ファイルからなる。中核となる制御情報を含む B<control> ファイルは必須である。

note: type: Plain text
en: In some very old archives, the files in the control tarfile may optionally be in a B<DEBIAN> subdirectory. In that case, the B<DEBIAN> subdirectory will be in the control tarfile too, and the control tarfile will have only files in that directory. Optionally the control tarfile may contain an entry for `B<.>', that is, the current directory.
ja: 非常に古いアーカイブでは、制御情報を格納した tar ファイル内のファイルが B<DEBIAN> サブディレクトリに存在することもある。この場合、該当の tar ファイルにも B<DEBIAN> サブディレクトリが存在し、そのディレクトリ内にのみファイルが存在する。制御情報を格納した tar ファイルは、カレントディレクトリを意味する `B<.>' を含むこともある。

note: type: Plain text
en: The second gzipped tarfile is the filesystem archive, containing pathnames relative to the root directory of the system to be installed on. The pathnames do not have leading slashes.
ja: 2 番目の gzip 圧縮 tar ファイルはインストールされるファイルのアーカイブであり、インストールされるシステムのルートディレクトリからの相対パス名が格納されている。パス名の先頭にスラッシュ(/)はない。

note: type: Plain text
en: deb-origin - Vendor-specific information files
ja: deb-origin - ベンダ固有情報ファイル

note: type: Plain text
en: The files in B</etc/dpkg/origins> can provide information about various vendors who are providing Debian packages. They contain a number of fields, or comments when the line starts with B<'#'>.  Each field begins with a tag, such as B<Vendor> or B<Parent>, followed by a colon and the body of the field. Fields are delimited only by field tags. In other words, field text may be multiple lines in length, but the tools will join lines when processing the body of the field.
ja: B</etc/dpkg/origins> にあるファイルは、Debian パッケージを提供する様々なベンダの情報を提供する。ファイルはフィールド行や B<'#'> で始まるコメント行からなる。各フィールド行は B<Vendor> や B<Parent> といったフィールドタグで始まり、コロンの後にフィールド本体 (値) が続く。フィールドがフィールドタグ以外で区切られることはない。言い換えると、フィールド本体のテキストは複数行にまたがっても構わない。ただし、インストールを行うツールは通常フィールド本体を処理する際にそれらを 1 行にまとめてしまう。

note: type: Plain text
en: The value of this field determines the vendor name.
ja: このフィールドの値によってベンダ名が決まる。

note: type: Plain text
en: The value of this field determines the vendor URL.
ja: このフィールドの値によってベンダの URL が決まる。

note: type: Plain text
en: The value of this field determines the type and address of the bug tracking system used by this vendor. It can be a mailto URL or a debbugs URL (e.g., debbugs://bugs.debian.org/).
ja: このフィールドの値によって、このベンダが使用しているバグトラッキングシステムの種類やアドレスが決まる。これは、mailto URL や debbugs URL (例えば debbugs://bugs.debian.org/ など) といった値をとる。

note: type: Plain text
en: The value of this field determines the vendor name of the vendor that this vendor derives from.
ja: このフィールドの値によって、このベンダの由来となるベンダ名が決まる。

note: type: TH
en: dpkg utilities
ja: dpkg ユーティリティ

note: type: Plain text
en: deb-override - Debian archive override file
ja: deb-override - Debian アーカイブ override ファイル

note: type: Plain text
en: While most information about a package can be found in the control file, some is managed centrally by the distribution czars rather than by the maintainer in order to offer some global consistency.  This information is found in the override file.
ja: パッケージに関する大半の情報は control ファイルにあるが、システム全体の整合性を保つために、メンテナではなく、ディストリビューション側の管理者によって一元管理されている情報もある。そうした情報が override ファイルに存在する。

note: type: Plain text
en: The override file has a simple whitespace-delimited format. Comments are allowed (denoted with a B<#>).
ja: override ファイルは、空白文字を区切り文字とした簡単な形式になっている。コメントも可能である (B<#> 以降がコメント)。

note: type: Plain text
en: I<package> is the name of the package. Entries in the override file for packages not found in the tree of binary packages are ignored.
ja: I<package> はパッケージ名である。override ファイルにあるがバイナリパッケージのツリーにはないパッケージ名のエントリは無視される。

note: type: Plain text
en: I<priority> and I<section> correspond to the respective control fields available in the .deb. The allowed values are listed in the Debian policy.
ja: I<priority> と I<section> は、.deb ファイルの対応する制御フィールドに各々対応づけられる。指定可能な値については Debian policy を参照のこと。

note: type: Plain text
en: I<maintainerinfo>, if present, can be either the name of a maintainer for an unconditional override, or else I<oldmaintainer> B<=E<gt>> I<newmaintainer> to perform a substitution.
ja: I<maintainerinfo> があれば、メンテナの名前が無条件に上書きされる。次のようにI<oldmaintainer> B<=E<gt>> I<newmaintainer> 形式の場合は置換が行われる。

note: type: Plain text
en: The override files used to make the official Packages lists may be found in the I<indices> directory on any Debian mirror.
ja: 公式の Packages 一覧を作成するために使われている override ファイルが、 Debian ミラーの I<indices> ディレクトリに存在する。

note: type: Plain text
en: deb-extra-override - Debian archive extra override file
ja: deb-extra-override - Debian アーカイブ拡張 override ファイル

note: type: Plain text
en: While most information about a binary/source package can be found in the control/.dsc file, all of it can be overridden when it's exported to Packages/Sources files. The extra override file contains those overrides.
ja: binary/source パッケージの大半の情報は control/.dsc ファイルにあるが、これらは Packages/Sources ファイルを作成する段階ですべて上書きすることができる。そうした情報が拡張 override ファイルに格納される。

note: type: Plain text
en: The extra override file has a simple whitespace-delimited format. Comments are allowed (denoted with a B<#>).
ja: 拡張 override ファイルは、空白文字をディリミタとした簡単な形式になっている。コメントも可能である (B<#> 以降がコメント)。

note: type: Plain text
en: I<package> is the name of the binary/source package.
ja: I<package> は binary/source パッケージ名である。

note: type: Plain text
en: I<field-name> is the name of the field that is overridden.  I<value> is the value to put in the field. It can contain spaces as the line is split in no more than 3 columns when it's parsed.
ja: I<field-name> は、上書きされるフィールド名である。I<value> はフィールドに設定される値を意味する。各行は解析される際に 3 つのカラムに分割される。各カラムはスペースで区切られる。

note: type: Plain text
en: The extra override files used to make the official Packages lists may be found in the I<indices> directory on any Debian mirror.
ja: 公式の Packages 一覧を作成するために使われている拡張 override ファイルは、 Debian ミラーの I<indices> ディレクトリにある。

note: type: Plain text
en: deb-shlibs - Debian shared library information file
ja: deb-shlibs - Debian 共有ライブラリ情報ファイル

note: type: Plain text
en: B<shlibs> files map shared library names and versions (I<sonames>)  to dependencies suitable for a package control file.  There is one entry per line. Blank lines are B<not> allowed.  Lines beginning with an B<#> character are considered commentary, and are ignored.  All other lines must have the format
ja: B<shlibs> ファイルは、共有ライブラリのファイル名とバージョン (I<soname>) をパッケージ制御ファイルに準拠した依存関係情報に対応付けるためのものである。1 行に 1 つのエントリを記述する。空白行があってはB<ならない>。B<#> 文字から始まる行はコメント行と見なされ無視されるが、それ以外の行は形式に則ったものでなければならない。

note: type: Plain text
en: The I<library> and I<version> fields are whitespace-delimited, but the I<dependencies> field extends to the end of the line.  The I<type> field is optional and normally not needed.
ja: I<library> と I<version> フィールドは空白文字で区切られるが、I<dependencies> フィールドは行末までの範囲がすべて含まれる。I<type> フィールドはオプションで、通常不要である。

note: type: Plain text
en: The I<dependencies> field has the same syntax as the B<Depends> field in a binary control file, see B<deb-control>(5).  See also the Debian Policy Manual for further details.
ja: I<dependencies> フィールドは、バイナリ制御ファイルにおける B<Depends> フィールドと同じ文法である。B<deb-control>(5) を参照のこと。詳細は Debian Policy Manual も参照のこと。

note: type: SH
en: EXAMPLES
ja: 例

note: type: Plain text
en: The B<shlibs> file for a typical library package, named I<libcrunch1>, that provides one library whose soname is I<libcrunch.so.1>, might read
ja: 一般的な例として、例えば、I<libcrunch.so.1> という soname のライブラリファイルを提供する I<libcrunch1> というパッケージの B<shlibs> ファイルは、次のようになる:

note: type: Plain text
en: The I<dependencies> must mention the most recent version of the package that added new symbols to the library: in the above example, new symbols were added to version 1.2 of I<libcrunch>.  This is not the only reason the dependencies might need to be tightened; again, see the Debian Policy Manual for details.
ja: I<dependencies> では、直近でシンボルが追加されたバージョンの指定が必須である。上記の例は、直近でシンボルが追加されたのは、I<libcrunch> バージョン 1.2 であることを意味する。dependencies (依存関係) を厳密に規定する必要がある理由はこれだけではない。詳細は Debian Policy Manual を参照のこと。

note: type: Plain text
en: deb-substvars - Debian source substitution variables
ja: deb-substvars - Debian ソースにおける変数

note: type: Plain text
en: Before B<dpkg-source>, B<dpkg-gencontrol> and B<dpkg-genchanges> write their control information (to the source control file B<.dsc> for B<dpkg-source> and to standard output for B<dpkg-gencontrol> and B<dpkg-genchanges>)  they perform some variable substitutions on the output file.
ja: B<dpkg-source>, B<dpkg-gencontrol>, B<dpkg-genchanges> が制御情報を (B<dpkg-source> 用のソース制御ファイル B<.dsc> 、B<dpkg-gencontrol> や B<dpkg-genchanges> の標準出力に) 書き出す際に、変数の置換が行われる。

note: type: Plain text
en: A variable substitution has the form B<${>I<variable-name>B<}>.  Variable names consist of alphanumerics, hyphens and colons and start with an alphanumeric. Variable substitutions are performed repeatedly until none are left; the full text of the field after the substitution is rescanned to look for more substitutions.
ja: 変数が置換される箇所は B<${>I<変数名>B<}> という形式になっている。変数名には英数字、ハイフン、コロンを使用できるが、先頭文字は英数字である必要がある。変数の置換は、置換が不要になるまで再帰的に何度でも行われる。これは、置換後のフィールドの全文に対して、再度置換対象がないかの確認が行われることを意味する。

note: type: Plain text
en: After all the substitutions have been done each occurrence of the string B<${}> (which is not a legal substitution) is replaced with a B<$> sign.
ja: 置換がすべて完了した後で、文字列 B<${}> (これは置換対象ではない) が B<$> 記号に置き換えられる。

note: type: Plain text
en: While variable substitution is done on all control fields, some of those fields are used and needed during the build when the substitution did not yet occur. That's why you can't use variables in the B<Package>, B<Source> and B<Architecture> fields.
ja: 変数の置換は、すべての制御フィールドに対して行われるが、フィールドによっては変数が置換される前のビルド段階で用いられるものがある。そのため、B<Package>, B<Source>, B<Architecture> フィールドで変数を用いてはならない。

note: type: Plain text
en: Variable substitution happens on the content of the fields after they have been parsed, thus if you want a variable to expand over multiple lines you do not have to include a space after the newline. This is done implicitly when the field is output. For example, if the variable B<${Description}> is set to "foo is bar.${Newline}foo is great." and if you have the following field:
ja: 変数の置換は、各フィールドが解析され、切り出された後の内容に対して行われる。そのため、置換した結果が複数行にわたる場合も、改行の後にスペースを含めておく必要はない。これは、置換された変数の内容がフィールドに展開される際に暗黙的に行われる。例えば "foo is bar.${Newline}foo is great." という内容が B<${Description}> という変数に格納されており、フィールドの内容が以下のようになっていた場合、

note: type: Plain text
en: It will result in:
ja: 置換後の結果は次のようになる:

note: type: Plain text
en: Variables can be set using the B<-V> common option. They can be also specified in the file B<debian/substvars> (or whatever other file is specified using the B<-T> option). This file consists of lines of the form I<name>B<=>I<value>.  Trailing whitespace on each line, blank lines, and lines starting with a B<#> symbol (comments) are ignored.
ja: 共通オプション B<-V> により変数を設定することが可能である。debian/substvars ファイル (もしくは B<-T> オプションで指定したファイル中) で設定してもよい。このファイルには I<name>B<=>I<value> 形式の行から構成する。行末の空白文字、空白行、B<#> 記号から始まる行 (コメント行) は無視される。

note: type: Plain text
en: Additionally, the following standard variables are available:
ja: その他に、以下の標準変数を使用することができる:

note: type: Plain text
en: The current build architecture (from B<dpkg --print-architecture>).
ja: 現在ビルドしているアーキテクチャ (B<dpkg --print-architecture> オプションより)。

note: type: Plain text
en: The source package version.
ja: ソースパッケージのバージョン

note: type: Plain text
en: The upstream source package version, including the Debian version epoch if any.
ja: アップストリームのソースパッケージのバージョン、Debian の epoch が存在している場合、それも含まれる。

note: type: Plain text
en: The binary package version (which may differ from source:Version in a binNMU for example).
ja: バイナリパッケージのバージョン (binNMU などの場合、source:Version と異なることもある)

note: type: Plain text
en: The source package version (from the changelog file). This variable is now B<deprecated> as its meaning is different from its function, please use the B<source:Version> or B<binary:Version> as appropriate.
ja: ソースパッケージのバージョン (changelog ファイルより)。この変数は、名が体を表さなくなってしまっているため、B<廃止予定>である。用途に応じて B<source:Version>もしくは B<binary:Version> を使用すること。

note: type: Plain text
en: The total size of the package's installed files. This value is copied into the corresponding control file field; setting it will modify the value of that field. If this variable isn't set B<dpkg-gencontrol> will use B<du -k debian/tmp> to find the default value.
ja: パッケージによりインストールされるファイルの合計サイズ。この変数の値はcontrol ファイルの適切なフィールドにも適用され、該当フィールドの値を上書きする。この変数が設定されていなかった場合、B<dpkg-gencontrol> はデフォルト値として B<du -k debian/tmp> の値を設定する。

note: type: Plain text
en: Additional disk space used when the package is installed. If this variable is set its value is added to that of the B<Installed-Size> variable (whether set explicitly or using the default value) before it is copied into the B<Installed-Size> control file field.
ja: パッケージのインストール時に追加で用いられるディスク領域。この変数が設定されていると、B<Installed-Size> 変数の値 (明示的に設定されたものか、デフォルト値かは問わない) に本変数の値を足した値が control ファイルの B<Installed-Size>フィールドに適用される。

note: type: Plain text
en: The value of the output field I<fieldname> (which must be given in the canonical capitalisation). Setting these variables has no effect other than on places where they are expanded explicitly.
ja: I<fieldname> というフィールド (大文字で指定する必要がある) の値。この変数は、展開する箇所を明示的に指定するという以上の意味を持たない。

note: type: Plain text
en: The B<.changes> file format version generated by this version of the source packaging scripts. If you set this variable the contents of the B<Format> field in the B<.changes> file will change too.
ja: ソースパッケージングスクリプトによって生成される B<.changes> ファイルのフォーマットのバージョン。この変数を設定すると、B<.changes> ファイルの B<Format> フィールドの内容も変更される。

note: type: Plain text
en: These variables each hold the corresponding character.
ja: これらの変数は、各々対応する文字を示す。

note: type: Plain text
en: Variable settings with names of this form are generated by B<dpkg-shlibdeps>.
ja: この形式の名前のついた変数は、B<dpkg-shlibdeps> により生成される。

note: type: Plain text
en: The upstream version of dpkg.
ja: dpkg のアップストリームのバージョン

note: type: Plain text
en: The full version of dpkg.
ja: dpkg の完全なバージョン表記

note: type: Plain text
en: If a variable is referred to but not defined it generates a warning and an empty value is assumed.
ja: 変数が定義されていないにもかかわらず参照されている場合は、値として空文字列が想定されるとともに、警告が生成される。

note: type: SH
en: FILES
ja: ファイル

note: type: Plain text
en: List of substitution variables and values.
ja: 変数およびその値のリスト。

note: type: SH
en: BUGS
ja: バグ

note: type: Plain text
en: The point at which field overriding occurs compared to certain standard output field settings is rather confused.
ja: 標準の出力フィールドの設定と比較すると、フィールドの上書きが発生する箇所は混乱を引き起こす。

note: type: Plain text
en: deb-symbols - Debian's extended shared library information file
ja: deb-symbols - Debian の拡張された共有ライブラリ情報ファイル

note: type: Plain text
en: The format for an extended shared library dependency information entry in these files is:
ja: これらのファイルに設定可能な拡張された共有ライブラリの依存関係情報のフォーマットは以下のとおりである:

note: type: Plain text
en: The I<library-soname> is exactly the value of the SONAME field as exported by B<objdump>(1). A I<dependency-template> is a dependency where I<#MINVER#> is dynamically replaced either by a version check like "(E<gt>= I<minimal-version>)" or by nothing (if an unversioned dependency is deemed sufficient).
ja: I<library-soname> は B<objdump>(1) によってエクスポートされた SONAME フィールドの値と完全に合致している。I<dependency-template> は依存関係を示す。なおI<#MINVER#> は "(E<gt>= I<minimal-version>)" のようなバージョンチェックにより動的に置き換えられるか、(バージョンを明示した依存関係が不要だと判断された場合は) 空文字となる。

note: type: Plain text
en: Each exported I<symbol> (listed as I<name>@I<version>, with I<version> being "Base" if the library is not versioned) is associated to a I<minimal-version> of its dependency template (the main dependency template is used if I<id-of-dependency-template> is not present). The first alternative dependency template is numbered 1, the second one 2, etc.
ja: エクスポートされた各シンボル (I<name>@I<version> 形式で列挙。ライブラリにバージョンが存在しない場合、I<version> は "Base" となる) は dependency template のI<minimal-version> に関連付けられる (I<id-of-dependency-template> が存在しない場合は、I<main-dependency-template> が用いられる。代替の dependency-template の最初のものは 1 となり、次は 2 となっていく。

note: type: Plain text
en: Each entry for a library can also have some fields of meta-information.  Those fields are stored on lines starting with an asterisk. Currently, the only valid field is I<Build-Depends-Package>, it indicates the name of the "-dev" package associated to the library and is used by B<dpkg-shlibdeps> to make sure that the dependency generated is at least as strict as the corresponding build dependency.
ja: ライブラリの各エントリには、メタ情報を示すフィールドもいくつか存在する。これらのフィールドはアスタリスクから始まる行に保存される。現在のところ有効なフィールドは、I<Build-Depends-Package> のみである。これは、ライブラリに関連する "-dev" パッケージ名を示し、B<dpkg-shlibdeps> によって、生成される依存関係が、対応するビルド時の依存関係を最低限満たすことを保証するために用いられる。

note: type: SS
en: Simple symbols file
ja: 簡単な symbol ファイル

note: type: SS
en: Advanced symbols file
ja: 複雑な symbol ファイル

note: type: Plain text
en: deb-triggers - package triggers
ja: deb-triggers - パッケージトリガ

note: type: Plain text
en: A package declares its relationship to some trigger(s) by including a I<triggers> file in its control archive (i.e. I<DEBIAN/triggers> during package creation).
ja: パッケージは、 control アーカイブ内に I<triggers> ファイル (つまりはパッケージ生成の際の I<DEBIAN/triggers> など) を含めることで、トリガに対する関連付けを定義する。

note: type: Plain text
en: This file contains directives, one per line. Leading and trailing whitespace and everything after the first B<#> on any line will be trimmed, and empty lines will be ignored.
ja: このファイルには、各行ごとに 1 つのディレクティブが含まれる。行頭及び行末の空白文字と、B<#> 以降の記載および空行は無視される。

note: type: Plain text
en: The trigger control directives currently supported are:
ja: 現在サポートされているトリガ制御ディレクティブを以下に示す:

note: type: Plain text
en: Specifies that the package is interested in the named trigger. All triggers in which a package is interested must be listed using this directive in the triggers control file. The "noawait" variant does not put the triggering packages in triggers-awaited state. This should be used when the functionality provided by the trigger is not crucial.
ja: パッケージが、指定されたトリガをウォッチすることを示す。パッケージがウォッチするすべてのトリガは、トリガ制御ファイル内で本ディレクティブを用いて列挙しておく必要がある。"noawait" をつけることで、ステータスが trigger-awaitedであっても、パッケージがトリガされなくなる。これは、トリガによって提供される機能が重要でない場合に使用すべきである。

note: type: Plain text
en: Arranges that changes to this package's state will activate the specified trigger. The trigger will be activated at the start of the following operations: unpack, configure, remove (including for the benefit of a conflicting package), purge and deconfigure.  The "noawait" variant does not put the triggering packages in triggers-awaited state. This should be used when the functionality provided by the trigger is not crucial.
ja: 本パッケージの状態が変化した際に、指定したトリガを有効化するように設定する。トリガは次の操作の開始により有効化される: unpack, configure, remove(競合状態にあるパッケージによるものも含まれる), purge, deconfigure 。"noawait" をつけることで、ステータスが trigger-awaited であっても、パッケージがトリガされなくなる。これは、トリガによって提供される機能が重要でない場合に使用すべきである。

note: type: Plain text
en: If this package disappears during the unpacking of another package the trigger will be activated when the disappearance is noted towards the end of the unpack. Trigger processing, and transition from triggers-awaited to installed, does not cause activations.  In the case of unpack, triggers mentioned in both the old and new versions of the package will be activated.
ja: 他のパッケージを unpack している最中に本パッケージが削除された場合、unpack終了時に削除が確認された際に、トリガが有効化される。トリガ処理自体やtriggers-awaited から installed への状態変化により、トリガが有効化されることはない。unpack の場合、パッケージの旧バージョンと新バージョンの両方で定義されているトリガが有効化される。

note: type: Plain text
en: Unknown directives are an error which will prevent installation of the package.
ja: 不明なディレクティブがあるとエラーが発生し、パッケージのインストールが失敗する。

note: type: Plain text
en: The "-noawait" variants are only supported by dpkg 1.16.1 or newer, and will lead to errors if used with an older dpkg. It is thus recommended to add a "Pre-Depends: dpkg (E<gt>= 1.16.1)" to any package that wish to use those directives.
ja: "-noawait" は、dpk 1.16.1 以降でのみサポートされ、それ以前の dpkg で使用するとエラーとなる。そのため、これらのディレクティブを使用するパッケージは、"Pre-Depends: dpkg (E<gt>= 1.16.1)" を付加することが推奨される。

note: type: Plain text
en: dpkg - package manager for Debian
ja: dpkg - Debian パッケージマネージャ

note: type: SH
en: WARNING
ja: 警告

note: type: Plain text
en: This manual is intended for users wishing to understand B<dpkg>'s command line options and package states in more detail than that provided by B<dpkg --help>.
ja: このマニュアルは、B<dpkg> のコマンドラインオプションやパッケージ状態について、B<dpkg --help> よりも、さらに詳細に理解したいユーザを対象としている。

note: type: Plain text
en: It should I<not> be used by package maintainers wishing to understand how B<dpkg> will install their packages. The descriptions of what B<dpkg> does when installing and removing packages are particularly inadequate.
ja: B<dpkg> がパッケージをどのようにインストールするかを理解したいというパッケージのメンテナを対象としたものではない。特に、パッケージのインストールや削除の際の B<dpkg> の挙動に関する説明が不足している。

note: type: Plain text
en: B<dpkg> is a tool to install, build, remove and manage Debian packages. The primary and more user-friendly front-end for B<dpkg> is B<aptitude>(1). B<dpkg> itself is controlled entirely via command line parameters, which consist of exactly one action and zero or more options. The action-parameter tells B<dpkg> what to do and options control the behavior of the action in some way.
ja: B<dpkg> は、Debian パッケージのインストール、ビルド、削除、管理を行うためのツールである。B<dpkg> の代表的なフロントエンドであり、利便性の高いツールがB<aptitude>(1) である。dpkg 自体は、1 つのアクションと 0 個以上のオプションからなるコマンドラインパラメータによって制御される。アクションにより B<dpkg> の動作が指定され、オプションにより、そのアクションに関する挙動が制御される。

note: type: Plain text
en: B<dpkg> can also be used as a front-end to B<dpkg-deb>(1) and B<dpkg-query>(1). The list of supported actions can be found later on in the B<ACTIONS> section. If any such action is encountered B<dpkg> just runs B<dpkg-deb> or B<dpkg-query> with the parameters given to it, but no specific options are currently passed to them, to use any such option the back-ends need to be called directly.
ja: B<dpkg> は B<dpkg-deb>(1) および B<dpkg-query>(1) のフロントエンドとして用いることもできる。サポートされているアクションの一覧は、アクションセクションで後ほど説明する。これらのアクションが指示された場合、B<dpkg> は、アクションに対して指定されたパラメータを用いて B<dpkg-deb> もしくは B<dpkg-query> を呼び出すが、現在のところオプションについては引き渡されない。バックエンドに対してこうしたオプションを指定したい場合は、直接呼び出す必要がある。

note: type: SH
en: INFORMATION ABOUT PACKAGES
ja: パッケージに関する情報

note: type: Plain text
en: B<dpkg> maintains some usable information about available packages. The information is divided in three classes: B<states>, B<selection states> and B<flags>. These values are intended to be changed mainly with B<dselect>.
ja: B<dpkg> は利用可能なパッケージに関して、いくばくかの有用な情報を管理している。情報は、B<ステータス>、B<パッケージ選択状態>、B<フラグ>の 3 つに分類でき、主にB<dselect> によって変更されることが想定されている。

note: type: SS
en: PACKAGE STATES
ja: パッケージのステータス

note: type: Plain text
en: The package is not installed on your system.
ja: パッケージはシステムにインストールされていない。

note: type: Plain text
en: Only the configuration files of the package exist on the system.
ja: パッケージの設定ファイルだけがシステムに存在している。

note: type: Plain text
en: The installation of the package has been started, but not completed for some reason.
ja: パッケージのインストールは開始しているが、何らかの理由で完了していない。

note: type: Plain text
en: The package is unpacked, but not configured.
ja: パッケージは展開されたが、まだ設定されていない。

note: type: Plain text
en: The package is unpacked and configuration has been started, but not yet completed for some reason.
ja: パッケージは展開されて設定も開始しているが、何らかの理由によって完了していない。

note: type: Plain text
en: The package awaits trigger processing by another package.
ja: パッケージは別のパッケージによるトリガ処理を待機している。

note: type: Plain text
en: The package has been triggered.
ja: パッケージはトリガされている。

note: type: Plain text
en: The package is unpacked and configured OK.
ja: パッケージの展開と設定が完了している。

note: type: SS
en: PACKAGE SELECTION STATES
ja: パッケージ選択状態

note: type: Plain text
en: The package is selected for installation.
ja: パッケージはインストールするように選択されている。

note: type: Plain text
en: A package marked to be on B<hold> is not handled by B<dpkg>, unless forced to do that with option B<--force-hold>.
ja: B<hold> 状態にあるパッケージは、B<--force-hold> オプションで強制しない限り、B<dpkg>による処理の対象とならない。

note: type: Plain text
en: The package is selected for deinstallation (i.e. we want to remove all files, except configuration files).
ja: パッケージは deinstallation (設定ファイルを除くすべてのファイルを削除) するように選択されている

note: type: Plain text
en: The package is selected to be purged (i.e. we want to remove everything from system directories, even configuration files).
ja: パッケージは完全削除 (設定ファイルも含めたすべてのファイルを削除) するように選択されている。

note: type: SS
en: PACKAGE FLAGS
ja: パッケージのフラグ

note: type: Plain text
en: A package marked B<reinst-required> is broken and requires reinstallation. These packages cannot be removed, unless forced with option B<--force-remove-reinstreq>.
ja: B<reinst-required> 状態にあるパッケージは、不正な状態にあり、再インストールが必要となっている。こうしたパッケージは、B<--force-remove-reinstreq> オプションで強制しない限り、削除することができない。

note: type: SH
en: ACTIONS
ja: アクション

note: type: Plain text
en: Install the package. If B<--recursive> or B<-R> option is specified, I<package-file> must refer to a directory instead.
ja: パッケージをインストールする。B<--recursive> または B<-R> オプションが指定されていた場合、I<package-file> としてファイルではなくディレクトリを指定すること。

note: type: Plain text
en: Installation consists of the following steps:
ja: インストールは、以下のステップで構成されている。

note: type: Plain text
en: B<1.> Extract the control files of the new package.
ja: B<1.> インストールする新しいパッケージの制御ファイルを展開する。

note: type: Plain text
en: B<2.> If another version of the same package was installed before the new installation, execute I<prerm> script of the old package.
ja: B<2.> 同一パッケージの別バージョンがインストール済の場合、新しいパッケージのインストール前に、インストール済パッケージの I<prerm> スクリプトを実行する。

note: type: Plain text
en: B<3.> Run I<preinst> script, if provided by the package.
ja: B<3.> 新しいパッケージが I<preinst> スクリプトを提供している場合、実行する。

note: type: Plain text
en: B<4.> Unpack the new files, and at the same time back up the old files, so that if something goes wrong, they can be restored.
ja: B<4.> 新しいファイルを展開する。同時に、失敗したときに元に戻せるように、古いファイルを保存する。

note: type: Plain text
en: B<5.> If another version of the same package was installed before the new installation, execute the I<postrm> script of the old package. Note that this script is executed after the I<preinst> script of the new package, because new files are written at the same time old files are removed.
ja: B<5.> 同一パッケージの別バージョンがインストール済の場合、古いパッケージのI<postrm> スクリプトを実行する。このスクリプトは、新しいパッケージの I<preinst>スクリプトの後に実行されることに注意すること。これは、新しいファイルが書き込まれるのと同時に古いファイルが削除されるためである。

note: type: Plain text
en: B<6.> Configure the package. See B<--configure> for detailed information about how this is done.
ja: B<6.> パッケージの設定を行う。処理の詳細については、B<--configure> を参照のこと。

note: type: Plain text
en: Unpack the package, but don't configure it. If B<--recursive> or B<-R> option is specified, I<package-file> must refer to a directory instead.
ja: パッケージを展開するが、設定はしない。B<--recursive> または B<-R> オプションが指定されていた場合、I<package-file> としてファイルではなくディレクトリを指定すること。

note: type: Plain text
en: Configure a package which has been unpacked but not yet configured.  If B<-a> or B<--pending> is given instead of I<package>, all unpacked but unconfigured packages are configured.
ja: 展開済だが未設定のパッケージを設定する。package の代わりに B<-a> もしくはB<--pending> を指定した場合は、展開済だが未設定のパッケージすべてを設定する。

note: type: Plain text
en: To reconfigure a package which has already been configured, try the B<dpkg-reconfigure>(8)  command instead.
ja: 既に設定済のパッケージを再設定する場合は、B<dpkg-reconfigure>(8) コマンドを代わりに使用すること。

note: type: Plain text
en: Configuring consists of the following steps:
ja: 設定は、以下のステップで構成されている。

note: type: Plain text
en: B<1.> Unpack the conffiles, and at the same time back up the old conffiles, so that they can be restored if something goes wrong.
ja: B<1.> 設定ファイルを展開する。同時になにか問題が発生した時に元に戻せるよう、古い設定ファイルをバックアップする。

note: type: Plain text
en: B<2.> Run I<postinst> script, if provided by the package.
ja: B<2.> パッケージが提供している場合、I<postinst> スクリプトを実行する。

note: type: Plain text
en: Processes only triggers. All pending triggers will be processed. If package names are supplied only those packages' triggers will be processed, exactly once each where necessary. Use of this option may leave packages in the improper B<triggers-awaited> and B<triggers-pending> states. This can be fixed later by running: B<dpkg --configure --pending>.
ja: トリガ処理のみを行う。待機しているトリガが処理される。パッケージ名が指定されている場合、該当パッケージのトリガのみが、必要な場合に一度だけ処理される。このオプションを使用すると、パッケージが不適切な B<triggers-awaited> もしくはB<triggers-pending> 状態のままになってしまうかもしれない。これらの状態は B<dpkg --configure --pending> を後から実行することで対処できる。

note: type: Plain text
en: Remove an installed package. B<-r> or B<--remove> remove everything except conffiles. This may avoid having to reconfigure the package if it is reinstalled later. (Conffiles are configuration files that are listed in the I<DEBIAN/conffiles> control file). B<-P> or B<--purge> removes everything, including conffiles. If B<-a> or B<--pending> is given instead of a package name, then all packages unpacked, but marked to be removed or purged in file I</var/lib/dpkg/status>, are removed or purged, respectively. Note: some configuration files might be unknown to B<dpkg> because they are created and handled separately through the configuration scripts. In that case, B<dpkg> won't remove them by itself, but the package's I<postrm> script (which is called by B<dpkg>), has to take care of their removal during purge. Of course, this only applies to files in system directories, not configuration files written to individual users' home directories.
ja: インストール済のパッケージを削除する。B<-r> もしくは B<--remove> は、設定ファイル (conffile) を除いたすべてを削除する。これにより、後ほど再インストールした時にパッケージの再設定を不要とすることができる (ここでいう設定ファイルとは、制御ファイルの I<DEBIAN/conffiles> に列挙されたファイルである) 。B<-P> もしくは B<--purge> は、設定ファイルを含むすべてを強制削除する。パッケージ名の代わりに B<-a> もしくはB<--pending> が指定された場合は、I</var/lib/dpkg/status> で remove もしくは purgeが指定されている展開済パッケージすべてが remove もしくは完全削除される。設定ファイルによっては、設定スクリプトが生成、処理しているため、B<dpkg> の管理下にない場合がある。この場合 B<dpkg> はこれらのファイルを削除しないため、(B<dpkg> から呼び出される) パッケージの I<postrm> スクリプトが完全削除処理の際に、これらのファイルを削除する必要がある。当然であるが、削除対象となるのは、システムのディレクトリに存在しているファイルのみであり、個々のユーザのホームディレクトリにある設定ファイルは対象外である。

note: type: Plain text
en: Removing of a package consists of the following steps:
ja: パッケージの削除は以下のステップで構成されている:

note: type: Plain text
en: B<1.> Run I<prerm> script
ja: B<1.> I<prerm> スクリプトを実行する。

note: type: Plain text
en: B<2.> Remove the installed files
ja: B<2.> インストールしたファイルを削除する。

note: type: Plain text
en: B<3.> Run I<postrm> script
ja: B<3.> I<postrm> スクリプトを実行する。

note: type: Plain text
en: Update B<dpkg>'s and B<dselect>'s idea of which packages are available. With action B<--merge-avail>, old information is combined with information from I<Packages-file>. With action B<--update-avail>, old information is replaced with the information in the I<Packages-file>. The I<Packages-file> distributed with Debian is simply named I<Packages>. B<dpkg> keeps its record of available packages in I</var/lib/dpkg/available>.
ja: B<dpkg> や B<dselect> が管理する利用可能なパッケージの情報を更新する。B<--merge-avail>アクションを指定すると、古い情報と I<Packages-file> の情報とが統合される。B<--update-avail> アクションを指定すると、古い情報は I<Packages-file> の情報で置き換えられる。Debian と一緒に配布されている I<Packages-file> は、シンプルにI<Packages> という名前になっている。B<dpkg> は、利用可能なパッケージの情報をI</var/lib/dpkg/available> に記録する。

note: type: Plain text
en: A simpler one-shot command to retrieve and update the I<available> file is B<dselect update>. Note that this file is mostly useless if you don't use B<dselect> but an APT-based frontend: APT has its own system to keep track of available packages.
ja: I<available> ファイルを取得し更新する簡便なコマンドが B<dselect update> である。このファイルは B<dselect> の代わりに APT ベースのフロントエンドを使用する場合はほとんど無意味である。APT は利用可能なパッケージを管理するシステムを独自に保持しているためである。

note: type: Plain text
en: Update B<dpkg> and B<dselect>'s idea of which packages are available with information from the package I<package-file>. If B<--recursive> or B<-R> option is specified, I<package-file> must refer to a directory instead.
ja: B<dpkg> や B<dselect> が管理する利用可能なパッケージの情報を、I<package-file> で指定したパッケージの情報で更新する。B<--recursive> または B<-R> オプションが指定されていた場合、I<package-file> としてファイルではなくディレクトリを指定すること。

note: type: Plain text
en: Now B<obsolete> and a no-op as B<dpkg> will automatically forget uninstalled unavailable packages.
ja: 現在はB<廃止され>ており、何も行われない。B<dpkg> は、インストールされず利用できないパッケージの情報を自動的に消去する。

note: type: Plain text
en: Erase the existing information about what packages are available.
ja: 利用可能なパッケージについての情報を消去する。

note: type: Plain text
en: Searches for packages that have been installed only partially on your system. B<dpkg> will suggest what to do with them to get them working.
ja: インストールが中断されているパッケージを検索する。dpkg はインストールを完了させるために行うべきことを提示する。

note: type: Plain text
en: Get list of package selections, and write it to stdout. Without a pattern, non-installed packages (i.e. those which have been previously purged)  will not be shown.
ja: 選択したパッケージのリストを標準出力に出力する。パターンを指定しなかった場合は、(既に完全削除されているなどで) インストールされていないパッケージは表示されない。

note: type: Plain text
en: Set package selections using file read from stdin. This file should be in the format 'I<package> I<state>', where state is one of B<install>, B<hold>, B<deinstall> or B<purge>. Blank lines and comment lines beginning with '#' are also permitted.
ja: 標準入力から読み込んだファイルを用いて選択したパッケージのステータスを更新する。読み込むファイルは 'I<package> I<state>' というフォーマットになっている必要がある。state は B<install>, B<hold>, B<deinstall>, B<purge> のいずれかの値をとる。空行や '#' から始まるコメント行を使用してもよい。

note: type: Plain text
en: Set the requested state of every non-essential package to deinstall.  This is intended to be used immediately before --set-selections, to deinstall any packages not in list given to --set-selections.
ja: essential 以外のすべてのパッケージのステータスを deinstall にする。このオプションは、--set-selection の直前で用いて --set-selections で指定していないパッケージをすべて deinstall するために使用されることを想定している。

note: type: Plain text
en: Searches for packages selected for installation, but which for some reason still haven't been installed.
ja: インストールするために選択されたが、何らかの理由でまだインストールされていないパッケージを検索する。

note: type: Plain text
en: Add I<architecture> to the list of architectures for which packages can be installed without using B<--force-architecture>. The architecture B<dpkg> is built for (i.e. the output of B<--print-architecture>)  is always part of that list.
ja: I<architecture> を、B<--force-architecture> を使用せずにパッケージをインストールすることが可能となるアーキテクチャのリストに追加する。B<dpkg> がビルドされたアーキテクチャ (すなわち B<--print-architecture> の出力) は、常にリストに含まれる。

note: type: Plain text
en: Remove I<architecture> from the list of architectures for which packages can be installed without using B<--force-architecture>. If the architecture is currently in use in the database then the operation will be refused, except if B<--force-architecture> is specified. The architecture B<dpkg> is built for (i.e. the output of B<--print-architecture>) can never be removed from that list.
ja: I<architecture> を、B<--force-architecture> を使用せずにパッケージをインストールすることが可能となるアーキテクチャのリストから削除する。アーキテクチャが現在データベースで使用中だった場合、B<--force-architecture> が指定されていない限り、操作は拒否される。B<dpkg> がビルドされたアーキテクチャ (すなわち B<--print-architecture> の出力) を、リストから削除することは決してできない。

note: type: Plain text
en: Print architecture of packages B<dpkg> installs (for example, "i386").
ja: B<dpkg> がインストールするパッケージのアーキテクチャ (例えば "i386") を表示する。

note: type: Plain text
en: Print a newline-separated list of the extra architectures B<dpkg> is configured to allow packages to be installed for.
ja: B<dpkg> によるインストールを可能とする設定をされた、追加のアーキテクチャを改行で区切ったリストで表示する。

note: .TP .B \-\-command\-fd \fIn\fP Accept a series of commands on input file descriptor \fIn\fP. Note: additional options set on the command line, and through this file descriptor, are not reset for subsequent commands executed during the same run. type: Plain text
en: Compare version numbers, where I<op> is a binary operator. B<dpkg> returns success (zero result) if the specified condition is satisfied, and failure (nonzero result) otherwise. There are two groups of operators, which differ in how they treat an empty I<ver1> or I<ver2>. These treat an empty version as earlier than any version: B<lt le eq ne ge gt>. These treat an empty version as later than any version: B<lt-nl le-nl ge-nl gt-nl>. These are provided only for compatibility with control file syntax: B<E<lt> E<lt>E<lt> E<lt>= = E<gt>= E<gt>E<gt> E<gt>>.
ja: 二項演算子 I<op> を用いてバージョン番号を比較する。B<dpkg> は、指定した条件を満たす場合は成功 (0) を、それ以外は失敗 (0 以外) を返却する。演算子は I<ver1> やI<ver2> が空文字列の時の扱いによって、 2 種類に大別できる。B<lt le eq ne ge gt>は、空文字列をもっとも小さいバージョンと見なす。B<lt-nl le-nl ge-nl gt-nl> は、もっとも大きいバージョンとみなす。B<E<lt> E<lt>E<lt> E<lt>= = E<gt>= E<gt>E<gt> E<gt>> は、control ファイルの文法との互換性を維持するためにのみ提供される。

note: type: Plain text
en: Display a brief help message.
ja: オプションに関する簡単なヘルプを表示する。

note: type: Plain text
en: Give help about the B<--force->I<thing> options.
ja: B<--force->I<thing> オプションに関するヘルプを表示する。

note: type: Plain text
en: Give help about debugging options.
ja: デバッグ用オプションに関するヘルプを表示する。

note: type: Plain text
en: Display B<dpkg> version information.
ja: B<dpkg> のバージョン情報を表示する。

note: type: Plain text
en: See B<dpkg-deb>(1) for more information about the following actions.
ja: 以下のアクションの詳細については B<dpkg-deb>(1) を参照のこと。

note: type: Plain text
en: B<-b>, B<--build> I<directory> [I<archive>|I<directory>]
        Build a deb package.
    B<-c>, B<--contents> I<archive>
        List contents of a deb package.
    B<-e>, B<--control> I<filename> [I<directory>]
        Extract control-information from a package.
    B<-x>, B<--extract> I<archive directory>
        Extract the files contained by package.
    B<-X>, B<--vextract> I<archive directory>
        Extract and display the filenames contained by a
        package.
    B<-f>, B<--field>  I<archive> [I<control-field>...]
        Display control field(s) of a package.
    B<--fsys-tarfile> I<archive>
        Display the filesystem tar-file contained by a
        Debian package.
    B<-I>, B<--info> I<archive> [I<control-file>...]
        Show information about a package.
ja: B<-b>, B<--build> I<directory> [I<archive>|I<directory>]
        deb パッケージをビルドする。
    B<-c>, B<--contents> I<archive>
        deb パッケージに含まれるファイル一覧を表示する。
    B<-e>, B<--control> I<filename> [I<directory>]
        パッケージから制御情報ファイルを展開する。
    B<-x>, B<--extract> I<archive directory>
        パッケージによってインストールされるファイルをすべて展開する。
    B<-X>, B<--vextract> I<archive directory>
        パッケージによってインストールされるファイルをすべて展開して表示する。
    B<-f>, B<--field>  I<archive> [I<control-field>...]
        パッケージの制御ファイルの各フィールドを表示する。
    B<--fsys-tarfile> I<archive>
        Debian パッケージに含まれるインストールされるファイルが格納された
        tar ファイルの内容を表示する。
    B<-I>, B<--info> I<archive> [I<control-file>...]
        パッケージに関する各種情報を表示する。

note: type: Plain text
en: See B<dpkg-query>(1) for more information about the following actions.
ja: 以下のアクションの詳細は、B<dpkg-query>(1) を参照のこと。

note: type: Plain text
en: B<-l>, B<--list> I<package-name-pattern>...
        List packages matching given pattern.
    B<-s>, B<--status> I<package-name>...
        Report status of specified package.
    B<-L>, B<--listfiles> I<package-name>...
        List files installed to your system from I<package-name>.
    B<-S>, B<--search> I<filename-search-pattern>...
        Search for a filename from installed packages.
    B<-p>, B<--print-avail> I<package-name>...
        Display details about I<package-name>, as found in
        I</var/lib/dpkg/available>. Users of APT-based frontends
        should use B<apt-cache show> I<package-name> instead.
ja: B<-l> | B<--list> I<package-name-pattern> ...
        指定したパターンにマッチする名前のパッケージの一覧を表示する。
    B<-s> | B<--status> I<package-name> ...
        指定したパッケージの状態を報告する。
    B<-L> | B<--listfiles> I<package-name> ...
        B<package-name> によってシステムにインストールされたファイルの一覧を表示する。
    B<-S> | B<--search> I<filename-search-pattern> ...
        指定したファイルがどのパッケージからインストールされたか検索する。
    B<-p> | B<--print-avail> I<package-name>
        I</var/lib/dpkg/available> にある I<package-name> の詳細情報を表示する。
        APT ベースのフロントエンドを使っている場合は、B<apt-cache show> I<package-name>
        コマンドを代わりに使用すること。

note: type: SH
en: OPTIONS
ja: オプション

note: type: Plain text
en: All options can be specified both on the command line and in the B<dpkg> configuration file I</etc/dpkg/dpkg.cfg> or fragment files (with names matching this shell pattern \(aq[0-9a-zA-Z_-]*\(aq) on the configuration directory I</etc/dpkg/dpkg.cfg.d/>. Each line in the configuration file is either an option (exactly the same as the command line option but without leading dashes) or a comment (if it starts with a B<#>).
ja: すべてのオプションは、コマンドラインと B<dpkg> の設定ファイルI</etc/dpkg/dpkg.cfg> もしくは設定ディレクトリ I</etc/dpkg/dpkg.cfg.d/> 内にあり、次のシェルパターン \(aq[0-9a-zA-Z_-]*\(aq) にマッチする名前の) フラグメントファイルのいずれで指定してもよい。設定ファイルの各行は、(先頭のダッシュを削除することを除き、コマンドラインオプションとまったく同一の) オプションもしくは (行頭が B<#> からはじまる) コメントのいずれかを記述する。

note: type: Plain text
en: Change after how many errors B<dpkg> will abort. The default is 50.
ja: B<dpkg> の処理を中断させるエラー数を変更する。デフォルトは 50 である。

note: type: Plain text
en: When a package is removed, there is a possibility that another installed package depended on the removed package. Specifying this option will cause automatic deconfiguration of the package which depended on the removed package.
ja: パッケージを削除するとき、削除するパッケージに依存した別のパッケージがインストールされている場合がある。このオプションを指定すると、削除するパッケージに依存しているパッケージの設定を自動的に取り消す。

note: type: Plain text
en: Switch debugging on. I<octal> is formed by bitwise-orring desired values together from the list below (note that these values may change in future releases). B<-Dh> or B<--debug=help> display these debugging values.
ja: デバッグモードにする。 I<octal> は、以下の一覧 (将来のリリースでは変更される可能性があることに注意) から、任意の値をビットごとの論理和で組み合わせた数値である。B<-Dh> または B<--debug=help> により指定可能な値が表示される。

note: type: Plain text
en:     Number   Description
             1   Generally helpful progress information
             2   Invocation and status of maintainer scripts
            10   Output for each file processed
           100   Lots of output for each file processed
            20   Output for each configuration file
           200   Lots of output for each configuration file
            40   Dependencies and conflicts
           400   Lots of dependencies/conflicts output
         10000   Trigger activation and processing
         20000   Lots of output regarding triggers
         40000   Silly amounts of output regarding triggers
          1000   Lots of drivel about e.g. the dpkg/info dir
          2000   Insane amounts of drivel
ja:       数値   説明
             1   一般的に有用な、処理の進行状況
             2   管理スクリプトの呼び出しと処理状況
            10   各ファイル処理の情報
           100   各ファイル処理の詳細情報
            20   各設定ファイルの情報
           200   各設定ファイルの詳細情報
            40   依存関係、競合関係
           400   依存関係、競合関係の詳細情報
         10000   トリガの有効化と処理状況
         20000   トリガ関連の詳細情報
         40000   トリガ関連の過剰ともいえる詳細情報
          1000   dpkg/info ディレクトリ関連など、あまり意味のない詳細情報
          2000   信じられないほど大量のあまり意味のない情報

note: type: Plain text
en: Force or refuse (B<no-force> and B<refuse> mean the same thing)  to do some things. I<things> is a comma separated list of things specified below. B<--force-help> displays a message describing them.  Things marked with (*) are forced by default.
ja: 指定した I<things> を強制実行 (force) もしくは拒否 (refuse) する (B<no-force>と B<refuse> は同じ意味) 。I<things> には、以下の項目をコンマで区切って列挙する。これらの項目は B<--force-help> オプションで表示される。(*) マークのあるものは、デフォルトで強制実行される。

note: type: Plain text
en: I<Warning: These options are mostly intended to be used by experts only. Using them without fully understanding their effects may break your whole system.>
ja: I<警告: 以下のオプションは、熟練ユーザ以外による使用を基本的に想定していない。影響を完全に理解しないままに使用した場合、システム全体が機能不全に陥る可能性がある。>

note: type: Plain text
en: B<all>: Turns on (or off) all force options.
ja: B<all>: 全ての強制オプションを指定する(または指定しない)。

note: type: Plain text
en: B<downgrade>(*): Install a package, even if newer version of it is already installed.
ja: B<downgrade>(*): より新しいバージョンがすでにインストールされていたとしても、指定したパッケージをインストールする。

note: type: Plain text
en: I<Warning: At present dpkg does not do any dependency checking on downgrades and therefore will not warn you if the downgrade breaks the dependency of some other package. This can have serious side effects, downgrading essential system components can even make your whole system unusable. Use with care.>
ja: I<警告: 現在のところ dpkg はダウングレードの際に依存関係のチェックをまったく行わない。そのため、ダウングレードが別のパッケージの依存関係に問題を発生させる可能性についても警告されない。これは深刻な副作用を引き起こす可能性があり、必須のシステムコンポーネントをダウングレードした場合、システム全体が機能不全に陥ってしまうこともありうる。充分注意して使用すること。>

note: type: Plain text
en: B<configure-any>: Configure also any unpacked but unconfigured packages on which the current package depends.
ja: B<configure-any>: 指定したパッケージが依存しており、すでに展開されているが、まだ設定されていないパッケージも一緒に設定をする。

note: type: Plain text
en: B<hold>: Process packages even when marked "hold".
ja: B<hold>: たとえ "hold" とマークされていても、そのパッケージの処理をする。

note: type: Plain text
en: B<remove-reinstreq>: Remove a package, even if it's broken and marked to require reinstallation. This may, for example, cause parts of the package to remain on the system, which will then be forgotten by B<dpkg>.
ja: B<remove-reinstreq>: 問題が発生しており、再インストールが必要だとマークされていた場合でも、パッケージを削除する。これは、パッケージの一部が B<dpkg> から認識されない状態でシステムに残置されてしまう状況を引き起こす場合がある。

note: type: Plain text
en: B<remove-essential>: Remove, even if the package is considered essential. Essential packages contain mostly very basic Unix commands. Removing them might cause the whole system to stop working, so use with caution.
ja: B<remove-essential>: essential と見なされるパッケージであっても削除する。essential パッケージには、もっとも基本となる UNIX コマンドが含まれる。これらを削除すると、システム全体が動作しなくなるため、本オプションは注意して使用すること。

note: type: Plain text
en: B<depends>: Turn all dependency problems into warnings.
ja: B<depends>: すべての依存関係の問題を警告として扱う。

note: type: Plain text
en: B<depends-version>: Don't care about versions when checking dependencies.
ja: B<depends-version>: 依存関係の確認の際に、バージョンを無視する。

note: type: Plain text
en: B<breaks>: Install, even if this would break another package.
ja: B<breaks>: 別のパッケージの機能不全を引き起こす場合でもインストールする。

note: type: Plain text
en: B<conflicts>: Install, even if it conflicts with another package. This is dangerous, for it will usually cause overwriting of some files.
ja: B<conflicts>: 他のパッケージと競合してもインストールする。たいていはいくつかファイルを上書きすることになるため、危険である。

note: type: Plain text
en: B<confmiss>: If a conffile is missing and the version in the package did change, always install the missing conffile without prompting. This is dangerous, since it means not preserving a change (removing) made to the file.
ja: B<confmiss>: 設定ファイルが存在せず、パッケージ中のバージョンが変更された際に、存在しない設定ファイルを常にインストールする。これは、ファイルに対する変更 (ファイル削除) を保持しないことを意味するため、危険である。

note: type: Plain text
en: B<confnew>: If a conffile has been modified and the version in the package did change, always install the new version without prompting, unless the B<--force-confdef> is also specified, in which case the default action is preferred.
ja: B<confnew>: 設定ファイルが変更されており、パッケージ中のバージョンも変更されていた場合、確認なしに新しいバージョンをインストールする。ただし、B<--force-confdef> が同時に指定されていた場合は、デフォルトの動作が優先される。

note: type: Plain text
en: B<confold>: If a conffile has been modified and the version in the package did change, always keep the old version without prompting, unless the B<--force-confdef> is also specified, in which case the default action is preferred.
ja: B<confold>: 設定ファイルが変更されており、パッケージ中のバージョンも変更されていた場合、確認なしに古いバージョンを保持する。ただし、B<--force-confdef> が同時に指定されていた場合は、デフォルトの動作が優先される。

note: type: Plain text
en: B<confdef>: If a conffile has been modified and the version in the package did change, always choose the default action without prompting. If there is no default action it will stop to ask the user unless B<--force-confnew> or B<--force-confold> is also been given, in which case it will use that to decide the final action.
ja: B<confdef>: conffile が変更されており、パッケージ中のバージョンも変更されていた場合、デフォルトの動作を実行する。デフォルトの動作が未定義で、B<--force-confnew> と B<--force-confold> のいずれも設定されていなかった場合は、ユーザに確認を求めるため、処理を中断する。いずれかが設定されている場合は、それによって最終的な動作が決定される。

note: type: Plain text
en: B<confask>: If a conffile has been modified always offer to replace it with the version in the package, even if the version in the package did not change. If any of B<--force-confmiss>, B<--force-confnew>, B<--force-confold>, or B<--force-confdef> is also given, it will be used to decide the final action.
ja: B<confask>: 設定ファイルが変更されていた場合、パッケージバージョンが変更されていない場合でも、パッケージ収録のものと置き換えるかどうかを確認する。B<--force-confmiss>, B<--force-confnew>, B<--force-confold>, または B<--force-confdef>のいずれかが設定されている場合は、それによって最終的な動作が決定される。

note: type: Plain text
en: B<overwrite>: Overwrite one package's file with another's file.
ja: B<overwrite>: あるパッケージで提供されているファイルを、インストールするパッケージのファイルで上書きする。

note: type: Plain text
en: B<overwrite-dir> Overwrite one package's directory with another's file.
ja: B<overwrite-dir>: あるパッケージで提供されているディレクトリを、インストールするパッケージのファイルで上書きする。

note: type: Plain text
en: B<overwrite-diverted>: Overwrite a diverted file with an undiverted version.
ja: B<overwrite-diverted>: 退避 (divert) した古いファイルを現在のファイルで上書きする。

note: type: Plain text
en: B<unsafe-io>: Do not perform safe I/O operations when unpacking. Currently this implies not performing file system syncs before file renames, which is known to cause substantial performance degradation on some file systems, unfortunately the ones that require the safe I/O on the first place due to their unreliable behaviour causing zero-length files on abrupt system crashes.
ja: B<unsafe-io>: 展開の際に安全な I/O 処理を行わない。現在のところ、これはファイル名の変更前にファイルシステムの同期を行わないことを意味する。同期を行った場合、ファイルシステムによっては顕著な性能低下が発生することが知られている。不幸なことに、まず第一に安全な I/O を必要としているのは、信頼性の低い I/O 処理を行っており、突然のシステム停止の際に 0 バイト長のファイルを作成してしまう、このような性能低下が発生するファイルシステム自身である。

note: type: Plain text
en: I<Note>: For ext4, the main offender, consider using instead the mount option B<nodelalloc>, which will fix both the performance degradation and the data safety issues, the latter by making the file system not produce zero-length files on abrupt system crashes with any software not doing syncs before atomic renames.
ja: I<注記>: この事象の主たる発生元である ext4 では、本オプションの代わりにマウントオプション B<nodelalloc> の使用を検討してほしい。これはパフォーマンスの低下を抑えつつ、データを安全に扱うことができる。後者は、ファイルシステム上において、アトミックな rename 処理の前に同期を行わないソフトウェアが、突然のシステム停止の際に 0 バイト長のファイルを作成できないようにすることで実現している。

note: type: Plain text
en: I<Warning: Using this option might improve performance at the cost of losing data, use with care.>
ja: I<警告: このオプションはパフォーマンスを向上させるかもしれないが、同時にデータ喪失のリスクを高める。使用に際してはこの点の充分注意すること。>

note: type: Plain text
en: B<architecture>: Process even packages with wrong or no architecture.
ja: B<architecture>: パッケージのアーキテクチャが誤っている、もしくはアーキテクチャが存在しない場合であっても、処理を行う。

note: type: Plain text
en: B<bad-version>: Process even packages with wrong versions.
ja: B<bad-version>: パッケージのバージョンが誤っていても処理を続行する。

note: type: Plain text
en: B<bad-path>: B<PATH> is missing important programs, so problems are likely.
ja: B<bad-path>: 重要なプログラムが B<PATH> に含まれていなくても実行する。問題が起きる可能性が高い。

note: type: Plain text
en: B<not-root>: Try to (de)install things even when not root.
ja: B<not-root>: root 以外でも、インストール (または削除) を試行する。

note: type: Plain text
en: B<bad-verify>: Install a package even if it fails authenticity check.
ja: B<bad-verify>: 正当性認証チェックに失敗してもパッケージをインストールする。

note: type: Plain text
en: Ignore dependency-checking for specified packages (actually, checking is performed, but only warnings about conflicts are given, nothing else).
ja: 指定したパッケージに関する依存関係の確認を行わない (実際は、依存関係の確認は行われるが、競合が発生しても警告メッセージのみで処理を続行する)。

note: type: Plain text
en: Do everything which is supposed to be done, but don't write any changes. This is used to see what would happen with the specified action, without actually modifying anything.
ja: 実行されるべき処理をすべて行うが、いかなる変更も書き込まない。これは、一切変更を行わずに、指定したアクションによって何が起こるかを確認する際に用いられる。

note: type: Plain text
en: Be sure to give B<--no-act> before the action-parameter, or you might end up with undesirable results. (e.g. B<dpkg --purge foo --no-act> will first purge package foo and then try to purge package --no-act, even though you probably expected it to actually do nothing)
ja: オプション B<--no-act> は、必ずアクションパラメータより前で指定すること。さもなくば、望ましくない結果が発生することになる (例えば、B<dpkg --purge foo --no-act> というコマンドを実行させた場合、変更は一切させないつもりかも知れないが、実際には、パッケージ foo を完全削除してしまってから、--no-act という名前のパッケージの完全削除処理が行われる)。

note: type: Plain text
en: Recursively handle all regular files matching pattern B<*.deb> found at specified directories and all of its subdirectories. This can be used with B<-i>, B<-A>, B<--install>, B<--unpack> and B<--avail> actions.
ja: 指定したディレクトリを再帰的に検索し、B<*.deb> というパターンにマッチする通常ファイルすべてに処理を行う。これは、B<-i>, B<-A>, B<--install>, B<--unpack>, B<--avail> アクションに使うことができる。

note: type: Plain text
en: Don't install a package if a newer version of the same package is already installed. This is an alias of B<--refuse-downgrade>.
ja: インストール済のパッケージのバージョンの方が新しければ、パッケージをインストールしない。これは B<--refuse-downgrade> の別名である。

note: type: Plain text
en: Change default administrative directory, which contains many files that give information about status of installed or uninstalled packages, etc.  (Defaults to I</var/lib/dpkg>)
ja: デフォルトの管理ディレクトリを変更する (デフォルトは I</var/lib/dpkg>)。管理ディレクトリには、パッケージのインストール状況に関する情報が格納された多種多様なファイルが存在する。

note: type: Plain text
en: Change default installation directory which refers to the directory where packages are to be installed. B<instdir> is also the directory passed to B<chroot>(2) before running package's installation scripts, which means that the scripts see B<instdir> as a root directory.  (Defaults to I</>)
ja: デフォルトのインストールディレクトリを変更する。インストールディレクトリは、パッケージのインストール先となるディレクトリである。B<instdir> は、パッケージのインストールスクリプトが実行される前に B<chroot>(2) にわたされるディレクトリでもある。つまり、スクリプトは B<instdir> をルートディレクトリとみなす (デフォルトは I</> である)。

note: type: Plain text
en: Changing B<root> changes B<instdir> to I<dir> and B<admindir> to I<dir>B</var/lib/dpkg>.
ja: B<root> を変更すると、B<instdir> が I<dir> に変更され、B<admindir> が I<dir>B</var/lib/dpkg> に変更される。

note: type: Plain text
en: Only process the packages that are selected for installation. The actual marking is done with B<dselect> or by B<dpkg>, when it handles packages. For example, when a package is removed, it will be marked selected for deinstallation.
ja: インストール対象として選択されたパッケージのみを処理する。選択のマーク付けそのものは、B<dselect> や B<dpkg> を使って行なう。例えば、パッケージ削除の際には、パッケージは削除対象としてマーク付けがされる。

note: type: Plain text
en: Don't install the package if the same version of the package is already installed.
ja: すでに同じバージョンのパッケージがインストールされている場合、パッケージをインストールしない。

note: type: Plain text
en: Set an invoke hook I<command> to be run via ``sh -c'' before or after the dpkg run for the I<unpack>, I<configure>, I<install>, I<triggers-only>, I<remove> and I<purge> dpkg actions. This option can be specified multiple times. The order the options are specified is preserved, with the ones from the configuration files taking precedence.  The environment variable B<DPKG_HOOK_ACTION> is set for the hooks to the current dpkg action. Note: front-ends might call dpkg several times per invocation, which might run the hooks more times than expected.
ja: dpkg が I<unpack>, I<configure>, I<install>, I<triggers-only>, I<remove>, I<purge> の各アクションを実行する前後に ``sh -c'' によって起動されるフックコマンドを指定する。このオプションは複数回指定することができ、その際オプションの指定順は保持される。設定ファイルにおける指定の方が優先度が高い。現在のアクションに対するフックは、環境変数 B<DPKG_HOOK_ACTION> に設定される。フロントエンドは、ある一回の操作中に dpkg を複数回呼び出す場合がある。そのため、フックについても想定していた回数以上に呼び出される場合がある点に留意すること。

note: type: Plain text
en: Set I<glob-pattern> as a path filter, either by excluding or re-including previously excluded paths matching the specified patterns during install.
ja: I<glob-pattern> によりパスのフィルタ条件を指定する。これは、インストールの際に指定したパターンにマッチしたパスのファイルをインストールの対象から除外したり、除外したパスの一部を再度インストール対象としたりするために用いられる。

note: type: Plain text
en: I<Warning: take into account that depending on the excluded paths you might completely break your system, use with caution.>
ja: I<警告: 除外したパスによっては、システム全体が動作しなくなる可能性がある。危険性を充分理解した上で、注意して使用すること。>

note: type: Plain text
en: The glob patterns use the same wildcards used in the shell, were '*' matches any sequence of characters, including the empty string and also '/'. For example, I<'/usr/*/READ*'> matches I<'/usr/share/doc/package/README'>.  As usual, '?' matches any single character (again, including '/'). And '[' starts a character class, which can contain a list of characters, ranges and complementations. See B<glob>(7) for detailed information about globbing. Note: the current implementation might re-include more directories and symlinks than needed, to be on the safe side and avoid possible unpack failures, future work might fix this.
ja: glob-pattern には、シェルと同様のワイルドカードを使用することができる。'*' は、空文字列と '/' を含むすべての文字列にマッチする。例えば、I<'/usr/*/READ*'> は I<'/usr/share/doc/package/README'> にマッチする。例によって '?' は任意の 1 文字 (こちらも '/' を含む) にマッチする。'[' は、文字のリスト、範囲、補集合を含む文字クラスの開始を意味する。パターンマッチングの詳細は B<glob>(7) を参照のこと。注記: 現在の実装では、安全サイドに倒してファイル展開の際のエラーを抑止しているため、ディレクトリやシンボリックリンクが過度にマッチしてしまう。この挙動は将来的に修正されるかもしれない。

note: type: Plain text
en: This can be used to remove all paths except some particular ones; a typical case is:
ja: これは、特定のパス以外のパスをすべて除外するために使用することができる。典型的な例を以下に示す:

note: type: Plain text
en: to remove all documentation files except the copyright files.
ja: これは、copyright ファイル以外のすべてのドキュメントファイルを削除する。

note: type: Plain text
en: These two options can be specified multiple times, and interleaved with each other. Both are processed in the given order, with the last rule that matches a file name making the decision.
ja: この 2 つのオプションは複数回指定することができ、交互に指定していくことも可能である。その場合は指定された順番どおりに処理が行われ、ファイル名に対して最後にマッチしたルールによって、処理が決定する。

note: type: Plain text
en: Send machine-readable package status and progress information to file descriptor I<n>. This option can be specified multiple times. The information is generally one record per line, in one of the following forms:
ja: コンピュータが解釈可能な形式のパッケージの状態と処理の進行状況に関する情報とをファイルディスクリプタ I<n> に引き渡す。このオプションは複数回指定することができる。情報は通常 1 行に 1 レコードずつ、以下のいずれかの形式で記載される:

note: type: Plain text
en: Package status changed; I<status> is as in the status file.
ja: パッケージのステータスが変更された。I<status> が新しいステータスである。

note: type: Plain text
en: An error occurred. Any possible newlines in I<extended-error-message> will be converted to spaces before output.
ja: エラーが発生した。I<extended-error-message> 中の改行は、出力の前に空白文字に置き換えられる。

note: type: Plain text
en: User is being asked a conffile question.
ja: ユーザは設定ファイルの処理に関する確認をされている。

note: type: Plain text
en: Sent just before a processing stage starts. I<stage> is one of B<upgrade>, B<install> (both sent before unpacking), B<configure>, B<trigproc>, B<disappear>, B<remove>, B<purge>.
ja: stage に関する処理が開始される前に送信される。I<stage> は、B<upgrade>, B<install> (いずれも展開が開始される前に送信される), B<configure>, B<trigproc>, B<disappear>, B<remove>, B<purge> のいずれかになる。

note: type: Plain text
en: Send machine-readable package status and progress information to the shell I<command>'s standard input. This option can be specified multiple times. The output format used is the same as in B<--status-fd.>
ja: コンピュータが解釈可能な形式のパッケージの状態と処理の進行状況に関する情報とをシェル I<command> の標準入力に引き渡す。このオプションは複数回指定することができる。出力形式は B<--status-fd> と同一である。

note: type: Plain text
en: Log status change updates and actions to I<filename>, instead of the default I</var/log/dpkg.log>. If this option is given multiple times, the last filename is used. Log messages are of the form `YYYY-MM-DD HH:MM:SS status I<state> I<pkg> I<installed-version>' for status change updates; `YYYY-MM-DD HH:MM:SS I<action> I<pkg> I<installed-version> I<available-version>' for actions where I<action> is one of B<install>, B<upgrade>, B<remove>, B<purge>; and `YYYY-MM-DD HH:MM:SS conffile I<filename> I<decision>' for conffile changes where I<decision> is either B<install> or B<keep>.
ja: 状態の変更やアクションの記録先を、デフォルトの I</var/log/dpkg.log> から I<filename> に変更する。このオプションを複数回指定した場合は、最後に指定したファイル名が使われる。ログメッセージの形式は次のとおり。状態の変更は、`YYYY-MM-DD HH:MM:SS I<status> I<pkg> I<installed-version>。アクションは、`YYYY-MM-DD HH:MM:SS I<action> I<pkg> I<installed-version> I<available-version> で、I<action> は、B<install>, B<upgrade>, B<remove>, B<purge> のいずれかである。設定ファイルの変更は、`YYYY-MM-DD HH:MM:SS conffile I<filename> I<decision>' で、I<decision> は B<install> か B<keep>のいずれかである。

note: type: Plain text
en: Do not try to verify package signatures.
ja: パッケージの署名を確認しない。

note: type: Plain text
en: Do not run any triggers in this run (activations will still be recorded).  If used with B<--configure> I<package> or B<--triggers-only> I<package> then the named package postinst will still be run even if only a triggers run is needed. Use of this option may leave packages in the improper B<triggers-awaited> and B<triggers-pending> states. This can be fixed later by running: B<dpkg --configure --pending>.
ja: 今回の実行に際しては、いかなるトリガも実行させない (トリガの有効化自体は記録される)。B<--configure> I<package> や B<--triggers-only> I<package> と同時に指定した場合、対象パッケージの postinst はトリガの実行が必要であっても、実行されることになる。このオプションを使用すると、パッケージがB<triggers-awaited> や B<triggers-pending> のまま不適切な状態で残ってしまうことがある。これは後ほど B<dpkg --configure --pending> を実行することで解消される。

note: type: Plain text
en: Cancels a previous B<--no-triggers>.
ja: 先に指定した B<--no-triggers> を無効にする。

note: type: Plain text
en: Configuration fragment files.
ja: フラグメントファイルの設定

note: type: Plain text
en: Configuration file with default options.
ja: オプションのデフォルト値を記述する設定ファイル。

note: type: Plain text
en: Default log file (see I</etc/dpkg/dpkg.cfg>(5) and option B<--log>).
ja: デフォルトのログファイル (I</etc/dpkg/dpkg.cfg>(5) と B<--log> オプションも参照のこと)。

note: type: Plain text
en: The other files listed below are in their default directories, see option B<--admindir> to see how to change locations of these files.
ja: 以下のファイルのパスは、デフォルトのディレクトリ配下に存在している場合である。ファイルの位置を変更する方法については、B<--admindir> オプションを参照すること。

note: type: Plain text
en: List of available packages.
ja: 使用できるパッケージの一覧。

note: type: Plain text
en: Statuses of available packages. This file contains information about whether a package is marked for removing or not, whether it is installed or not, etc. See section B<INFORMATION ABOUT PACKAGES> for more info.
ja: 使用できるパッケージのステータス情報。このファイルには、パッケージが削除対象としてマークされているか、インストール済みかどうかといった情報が含まれている。詳細は、B<パッケージに関する情報> セクションを参照すること。

note: type: Plain text
en: The status file is backed up daily in I</var/backups>. It can be useful if it's lost or corrupted due to filesystems troubles.
ja: ステータスファイルは、日時で I</var/backups> にバックアップされる。これはファイルシステムまわりのトラブルで、ファイルが消失したり破損したりした際に有用である。

note: type: Plain text
en: The following files are components of a binary package. See B<deb>(5)  for more information about them:
ja: 以下のファイルはバイナリパッケージを構成するファイルである。これらのファイルに関する詳細情報は、B<deb>(5) を参照のこと。

note: type: SH
en: ENVIRONMENT
ja: 環境変数

note: type: Plain text
en: If set, B<dpkg> will use it as the directory from which to read the user specific configuration file.
ja: 設定されていた場合、B<dpkg> は、変数の値をユーザ固有の設定ファイルの参照先のディレクトリとして使用する。

note: type: Plain text
en: If set, B<dpkg> will use it as the directory in which to create temporary files and directories.
ja: 設定されていた場合、B<dpkg> は、変数の値を一時ファイルおよびディレクトリを作成するディレクトリとして使用する。

note: type: Plain text
en: The program B<dpkg> will execute when displaying the conffiles.
ja: B<dpkg> が設定ファイルの内容を表示するときに、実際に起動するプログラム。

note: type: Plain text
en: The program B<dpkg> will execute when starting a new shell.
ja: B<dpkg> が新しいシェルを起動するときに、実際に起動するプログラム。

note: type: Plain text
en: Sets the number of columns B<dpkg> should use when displaying formatted text. Currently only used by -l.
ja: B<dpkg> が整形済テキストを表示する時に使用するコラム数。現在は -l オプションでのみ参照されている。

note: type: Plain text
en: Defined by B<dpkg> on the shell spawned on the conffile prompt to examine the situation. Current valid value: B<conffile-prompt>.
ja: 状況を確認するために設定ファイルのプロンプトから起動されたシェルに対して、B<dpkg> により設定される。現在のところ有効な値は B<conffile-prompt> のみである。

note: type: Plain text
en: Defined by B<dpkg> on the shell spawned on the conffile prompt to examine the situation. Contains the path to the old conffile.
ja: 状況を確認するために設定ファイルのプロンプトから起動されたシェルに対して、B<dpkg> により設定される。古い設定ファイルのパスが含まれる。

note: type: Plain text
en: Defined by B<dpkg> on the shell spawned on the conffile prompt to examine the situation. Contains the path to the new conffile.
ja: 状況を確認するために設定ファイルのプロンプトから起動されたシェルに対して、B<dpkg> により設定される。新しい設定ファイルのパスが含まれる。

note: type: Plain text
en: Defined by B<dpkg> on the maintainer script environment to the version of the currently running B<dpkg> instance.
ja: メンテナスクリプトの環境に対して、B<dpkg> により現在実行中の B<dpkg>のバージョンが設定される。

note: type: Plain text
en: Defined by B<dpkg> on the maintainer script environment to the package name being handled.
ja: メンテナスクリプトの環境に対して、B<dpkg> により処理対象のパッケージ名が設定される。

note: type: Plain text
en: Defined by B<dpkg> on the maintainer script environment to the architecture the package got built for.
ja: メンテナスクリプトの環境に対して、B<dpkg> によりパッケージのビルド対象となったアーキテクチャの情報が設定される。

note: type: Plain text
en: Defined by B<dpkg> on the maintainer script environment to the name of the script running (preinst, postinst, prerm, postrm).
ja: メンテナスクリプトの環境に対して、B<dpkg> により実行中のスクリプト名 (preinst, postinst, prerm, postrm) が設定される。

note: type: Plain text
en: To list installed packages related to the editor B<vi>(1) (note that B<dpkg-query> does not load the available file anymore by default, and the B<dpkg-query> B<--load-avail> option should be used instead for that):
ja: B<vi>(1) エディタに関連するインストール済パッケージの一覧を表示する。(B<dpkg-query> は、デフォルトでは利用可能なファイルについて一切表示しないことに注意。これを行うには、代わりに B<dpkg-query> B<--load-avail> オプションを使用すること):

note: type: Plain text
en: To see the entries in I</var/lib/dpkg/available> of two packages:
ja: 2 つのパッケージに関して、I</var/lib/dpkg/available> にある項目を表示する。

note: type: Plain text
en: To search the listing of packages yourself:
ja: パッケージの一覧を自分で検索する。

note: type: Plain text
en: To remove an installed elvis package:
ja: インストールされた elvis パッケージを削除する。

note: type: Plain text
en: To install a package, you first need to find it in an archive or CDROM. The "available" file shows that the vim package is in section "editors":
ja: パッケージをインストールするには、まずパッケージをアーカイブや CDROM から探し出す必要がある。"available" ファイルによれば、vim パッケージは "editors" セクションに属している。

note: type: Plain text
en: To make a local copy of the package selection states:
ja: パッケージ選択状況のコピーを作成する。

note: type: Plain text
en: You might transfer this file to another computer, and install it there with:
ja: このファイルをほかのコンピュータに転送して、次のようにしてインストールする。

note: type: Plain text
en: Note that this will not actually install or remove anything, but just set the selection state on the requested packages. You will need some other application to actually download and install the requested packages. For example, run B<apt-get dselect-upgrade>.
ja: これは実際にはインストールも削除もせずに、単に要求しているパッケージの選択状態を設定するだけであることに注意。要求しているパッケージを実際にダウンロード、インストールするには別のアプリケーションが必要である。例えば、B<apt-get dselect-upgrade> を実行する。

note: type: Plain text
en: Ordinarily, you will find that B<dselect>(1) provides a more convenient way to modify the package selection states.
ja: 通常、パッケージの選択状態を変更するには B<dselect>(1) を使用するほうが便利である。

note: type: SH
en: ADDITIONAL FUNCTIONALITY
ja: 追加機能

note: type: Plain text
en: Additional functionality can be gained by installing any of the following packages: B<apt>, B<aptitude> and B<debsums>.
ja: B<apt>、B<aptitude>、B<debsums> パッケージをインストールすると、これ以外の機能が追加される。

note: type: Plain text
en: B<aptitude>(1), B<apt>(1), B<dselect>(1), B<dpkg-deb>(1), B<dpkg-query>(1), B<deb>(5), B<deb-control>(5), B<dpkg.cfg>(5), and B<dpkg-reconfigure>(8).
ja: B<aptitude>(1), B<apt>(1), B<dselect>(1), B<dpkg-deb>(1), B<dpkg-query>(1), B<deb>(5), B<deb-control>(5), B<dpkg.cfg>(5), B<dpkg-reconfigure>(8).

note: type: Plain text
en: B<--no-act> usually gives less information than might be helpful.
ja: B<--no-act> の提供する情報はたいていの場合、不充分である。

note: type: SH
en: AUTHORS
ja: 著者

note: type: Plain text
en: See I</usr/share/doc/dpkg/THANKS> for the list of people who have contributed to B<dpkg>.
ja: B<dpkg> に貢献した人の一覧については、I</usr/share/doc/dpkg/THANKS> を参照のこと。

note: type: Plain text
en: dpkg-architecture - set and determine the architecture for package building
ja: dpkg-architecture - パッケージのビルドに用いられたアーキテクチャの設定と判別

note: type: Plain text
en: dpkg-architecture does provide a facility to determine and set the build and host architecture for package building.
ja: dpkg-architecture は、パッケージのビルドに用いられたビルドおよびホストのアーキテクチャを判別する機能を提供する。

note: type: Plain text
en: The build architecture is always determined by an external call to B<dpkg>(1), and can not be set at the command line.
ja: ビルドアーキテクチャは、常に B<dpkg>(1) を呼び出すことで判別される。コマンドラインから設定することはできない。

note: type: Plain text
en: You can specify the host architecture by providing one or both of the options B<-a> and B<-t>. The default is determined by an external call to B<gcc>(1), or the same as the build architecture if \s-1CC\s0 or gcc are both not available. One out of B<-a> and B<-t> is sufficient, the value of the other will be set to a usable default. Indeed, it is often better to only specify one, because B<dpkg-architecture> will warn you if your choice does not match the default.
ja: ホストのアーキテクチャは B<-a> もしくは B<-t> オプションにより指定することができる。デフォルトは、外部プログラムの B<gcc>(1) を呼び出して判別するが、\s-1CC\s0 や gcc が利用できない場合は、ビルドのアーキテクチャと同じ値が設定される。B<-a> と B<-t> オプションは、いずれかを指定すればよく、他方はその値に応じたデフォルト値に設定される。B<dpkg-architecture> は、他方に対してデフォルト値に合致しない値が設定されると警告を発するため、実用上も、いずれか片方のみを指定することが好ましい。

note: type: SH
en: COMMANDS
ja: コマンド

note: type: Plain text
en: Print the environment variables, one each line, in the format I<VARIABLE=value>. This is the default action.
ja: 環境変数の値を 1 行に 1 つずつ、I<VARIABLE=value> 形式で表示する。これは、デフォルトの動作である。

note: type: Plain text
en: Check for equality of architecture. By default I<debian-architecture> is compared against the current Debian architecture, being the host.  This action will not expand the architecture wildcards. Command finishes with an exit status of 0 if matched, 1 if not matched.
ja: アーキテクチャとの合致性を比較する。デフォルトでは、I<debian-architecture> が現在のホストの Debian アーキテクチャと比較される。このオプションでは、アーキテクチャワイルドカードは展開されない。コマンドは、アーキテクチャが合致すると 0 を、合致しないと 1 を戻り値として返却する。

note: type: Plain text
en: Check for identity of architecture by expanding I<architecture-wildcard> as an architecture wildcard and comparing against the current Debian architecture. Command finishes with an exit status of 0 if matched, 1 if not matched.
ja: アーキテクチャワイルドカードとして I<architecture-wildcard> を展開し、現在の Debian アーキテクチャと比較することにより、アーキテクチャの同一性を確認する。コマンドは、アーキテクチャが合致すると 0 を、合致しないと 1 を戻り値として返却する。

note: type: Plain text
en: Print the value of a single variable.
ja: 指定した単一の変数の値を表示する。

note: type: Plain text
en: Print an export command. This can be used to set the environment variables using eval.
ja: 変数をエクスポートするコマンドを出力する。これは、eval を用いて環境変数を設定する際に使用することができる。

note: type: Plain text
en: Print a similar command to B<-s> but to unset all variables.
ja: B<-s> と同様は逆に、すべての変数を未設定にするコマンドを表示する。

note: type: Plain text
en: Execute a I<command> in an environment which has all variables set to the determined value.
ja: すべての変数が指定された値に設定された環境で、I<command> を実行する。

note: type: Plain text
en: Print a list of valid architecture names.
ja: 有効なアーキテクチャ名の一覧を表示する。

note: type: Plain text
en: Show the usage message and exit.
ja: 利用方法を表示して終了する。

note: type: Plain text
en: Show the version and exit.
ja: バージョン情報を表示して終了する。

note: type: Plain text
en: Set the Debian architecture.
ja: Debian アーキテクチャを設定する。

note: type: Plain text
en: Set the GNU system type.
ja: GNU システムタイプを設定する。

note: type: Plain text
en: Values set by existing environment variables with the same name as used by the scripts are honored (i.e. used by B<dpkg-architecture>), except if this force flag is present. This allows the user to override a value even when the call to B<dpkg-architecture> is buried in some other script (for example B<dpkg-buildpackage>(1)).
ja: スクリプトが使用する (例えば B<dpkg-architecture> が使用する) 環境変数と同じ名前の環境変数が既に存在していた場合、この強制フラグを設定していない限り、既存の値がそのまま残される。このオプションにより、B<dpkg-architecture> の呼び出し後に、別のスクリプト (例えば B<dpkg-buildpackage>(1)) が実行される際に、変数の値を上書きすることが可能となる。

note: type: SH
en: TERMS
ja: 用語

note: type: IP
en: build machine
ja: ビルド (build) マシン

note: type: Plain text
en: The machine the package is built on.
ja: パッケージのビルドが実行されるマシン

note: type: IP
en: host machine
ja: ホスト (host) マシン

note: type: Plain text
en: The machine the package is built for.
ja: パッケージのビルドの対象となるマシン

note: type: IP
en: Debian architecture
ja: Debian アーキテクチャ

note: type: Plain text
en: The Debian architecture string, which specifies the binary tree in the \s-1FTP\s0 archive. Examples: i386, sparc, hurd-i386.
ja: Debian のアーキテクチャを示す文字列で、\s-1FTP\s0 アーカイブ内のバイナリツリーを指定する。例: i386, sparc, hurd-i386 。

note: type: IP
en: architecture wildcard
ja: アーキテクチャワイルドカード

note: type: Plain text
en: An architecture wildcard is a special architecture string that will match any real architecture being part of it. The general form is E<lt>kernelE<gt>-E<lt>cpuE<gt>.  Examples: linux-any, any-i386, hurd-any.
ja: アーキテクチャワイルドカードは、アーキテクチャ文字列のある部分に関して実際に存在している任意のアーキテクチャ文字列にマッチする特別なアーキテクチャ文字列である。一般的には、 E<lt>kernelE<gt>-E<lt>cpuE<gt> という形式をとる。例: linux-any, any-i386, hurd-any 。

note: type: IP
en: \s-1GNU\s0 system type
ja: \s-1GNU\s0 システムタイプ

note: type: Plain text
en: An architecture specification string consisting of two parts separated by a dash: cpu and system. Examples: i386-linux-gnu, sparc-linux-gnu, i386-gnu, x86_64-netbsd.
ja: ダッシュで区切られた 2 つの部分、CPU とシステム名からなるアーキテクチャを識別する文字列。例: i386-linux-gnu, sparc-linux-gnu, i386-gnu, x86_64-netbsd 。

note: type: SH
en: VARIABLES
ja: 変数

note: type: Plain text
en: The following variables are set by B<dpkg-architecture>:
ja: B<dpkg-architecture> により設定される変数を以下に示す。

note: type: Plain text
en: The Debian architecture of the build machine.
ja: ビルドマシンの Debian アーキテクチャ

note: type: Plain text
en: The Debian system name of the build machine.
ja: ビルドマシンの Debian システム名

note: type: Plain text
en: The Debian cpu name of the build machine.
ja: ビルドマシンの Debian CPU 名

note: type: Plain text
en: The pointer size of the build machine (in bits).
ja: ビルドマシンのポインタサイズ (ビット単位)

note: type: Plain text
en: The endianness of the build machine (little / big).
ja: ビルドマシンのエンディアン (little / big)

note: type: Plain text
en: The \s-1CPU\s0 part of \s-1DEB_BUILD_GNU_TYPE\s0.
ja: \s-1DEB_BUILD_GNU_TYPE\s0 の \s-1CPU\s0 の部分

note: type: Plain text
en: The System part of \s-1DEB_BUILD_GNU_TYPE\s0.
ja: \s-1DEB_BUILD_GNU_TYPE\s0 のシステムの部分

note: type: Plain text
en: The \s-1GNU\s0 system type of the build machine.
ja: ビルドマシンの \s-1GNU\s0 システムタイプ

note: type: Plain text
en: The clarified \s-1GNU\s0 system type of the build machine, used for filesystem paths.
ja: ビルドマシンの \s-1GNU\s0 システムタイプ、ファイルシステムのパスに使用するよう整形済。

note: type: Plain text
en: The Debian architecture of the host machine.
ja: ホストマシンの Debian アーキテクチャ

note: type: Plain text
en: The Debian system name of the host machine.
ja: ホストマシンの Debian システム名

note: type: Plain text
en: The Debian cpu name of the host machine.
ja: ホストマシンの Debian CPU 名

note: type: Plain text
en: The pointer size of the host machine (in bits).
ja: ホストマシンのポインタサイズ (ビット単位)

note: type: Plain text
en: The endianness of the host machine (little / big).
ja: ホストマシンのエンディアン (little / big)

note: type: Plain text
en: The \s-1CPU\s0 part of \s-1DEB_HOST_GNU_TYPE\s0.
ja: \s-1DEB_HOST_GNU_TYPE\s0 の \s-1CPU\s0 部分

note: type: Plain text
en: The System part of \s-1DEB_HOST_GNU_TYPE\s0.
ja: \s-1DEB_HOST_GNU_TYPE\s0 のシステム部分

note: type: Plain text
en: The \s-1GNU\s0 system type of the host machine.
ja: ホストマシンの \s-1GNU\s0 システムタイプ

note: type: Plain text
en: The clarified \s-1GNU\s0 system type of the host machine, used for filesystem paths.
ja: ホストマシンの \s-1GNU\s0 システムタイプ、ファイルシステムのパスに使用するよう整形済。

note: type: Plain text
en: The environment variables set by B<dpkg-architecture> are passed to I<debian/rules> as make variables (see make documentation). However, you should not rely on them, as this breaks manual invocation of the script. Instead, you should always initialize them using B<dpkg-architecture> with the -q option. Here are some examples, which also show how you can improve the cross compilation support in your package:
ja: B<dpkg-architecture> によって設定された環境変数は、make 変数 (make のドキュメントを参照のこと) としてI<debian/rules> に渡される。しかし、スクリプトが手動で実行される場合を考慮すると、上記の点に依存すべきではない。B<dpkg-architecture> の -q オプションを用いて、常に初期化を行うようにすべきである。パッケージのクロスコンパイルのサポートの改善方法を示す例を幾つか提示する:

note: type: Plain text
en: Retrieving the GNU system type and forwarding it to ./configure:
ja: GNU システムタイプを取得し、それを ./configure に引き渡す:

note: type: Plain text
en: Doing something only for a specific architecture:
ja: 特定のアーキテクチャに特化した処理を行う:

note: type: Plain text
en: or if you only need to check the CPU or OS type, use the DEB_HOST_ARCH_CPU or DEB_HOST_ARCH_OS variables.
ja: ただし、CPU か OS タイプのみをチェックしたい場合は、DEB_HOST_ARCH_CPU や DEB_HOST_ARCH_OS 変数を使用する。

note: type: Plain text
en: Note that you can also rely on an external Makefile snippet to properly set all the variables that B<dpkg-architecture> can provide:
ja: B<dpkg-architecture> が提供可能なすべての変数を適切に設定する目的で、外部の Makefile スニペットに依存することも可能である:

note: type: Plain text
en: In any case, you should never use B<dpkg --print-architecture> to get architecture information during a package build.
ja: いかなる場合も、パッケージのビルド中にアーキテクチャ情報を取得する目的で、B<dpkg --print-architecture> を使用すべきではない。

note: type: SH
en: BACKWARD COMPATIBILITY
ja: 後方互換性

note: type: Plain text
en: The /usr/share/dpkg/architecture.mk Makefile snippet is provided by dpkg-dev since version 1.16.1.
ja: /usr/share/dpkg/architecture.mk Makefile スニペットは、dpkg-dev 1.16.1 以降で提供されている。

note: type: Plain text
en: The DEB_*_ARCH_BITS and DEB_*_ARCH_ENDIAN variables were introduced in dpkg-dev 1.15.4. Using them in I<debian/rules> thus requires a build-dependency on dpkg-dev (E<gt>= 1.15.4).
ja: DEB_*_ARCH_BITS と DEB_*_ARCH_ENDIAN 変数は、dpkg-dev 1.15.4 から導入された。そのため、これらを I<debian/rules> で使用する時は、build-dependency として、dpkg-dev (E<gt>= 1.15.4) が必要となる。

note: type: Plain text
en: The DEB_HOST_ARCH_CPU and DEB_HOST_ARCH_OS variables were introduced in dpkg-dev 1.13.2.
ja: DEB_HOST_ARCH_CPU と DEB_HOST_ARCH_OS 変数は、dpkg-dev 1.13.2 から導入された。

note: type: Plain text
en: The B<-e> and B<-i> options were only introduced in relatively recent versions of B<dpkg-architecture> (since dpkg 1.13.13).
ja: B<-e> および B<-i> オプションは、比較的新しいバージョンの B<dpkg-architecture> (dpkg 1.13.13 以降) にのみ存在する。

note: type: Plain text
en: B<dpkg-buildpackage> accepts the B<-a> option and passes it to B<dpkg-architecture>. Other examples:
ja: B<dpkg-buildpackage> は B<-a> オプションを認識して、これをB<dpkg-architecture> に引き渡す。以下に実行例を幾つか示す:

note: type: Plain text
en: Check if an architecture is equal to the current architecture or a given one:
ja: あるアーキテクチャが現在のアーキテクチャと同一かどうかのチェック:

note: type: Plain text
en: Check if the current architecture or an architecture provided with -a are Linux systems:
ja: 現在のアーキテクチャ、もしくは -a で提供されたアーキテクチャが Linux かどうかのチェック:

note: type: Plain text
en: All these files have to be present for B<dpkg-architecture> to work. Their location can be overridden at runtime with the environment variable B<DPKG_DATADIR>.
ja: B<dpkg-architecture> が動作するためには、以下のファイルが存在している必要がある。ファイルの位置は、環境変数 B<DPKG_DATADIR> を設定することで、実行時に変更することができる。

note: type: Plain text
en: Table of known CPU names and mapping to their GNU name.
ja: 認識される CPU 名と、GNU 名へのマッピングテーブル

note: type: Plain text
en: Table of known operating system names and mapping to their GNU name.
ja: 認識される OS 名と、GNU 名へのマッピングテーブル

note: type: Plain text
en: Mapping between Debian architecture triplets and Debian architecture names.
ja: Debian アーキテクチャの文字列 (triplets) と Debian アーキテクチャ名とのマッピング

note: type: Plain text
en: B<dpkg-buildpackage>(1), B<dpkg-cross>(1).
ja: B<dpkg-buildpackage>(1), B<dpkg-cross>(1)

note: type: Plain text
en: dpkg.cfg - dpkg configuration file
ja: dpkg.conf - dpkg の設定ファイル

note: type: Plain text
en: This file contains default options for dpkg. Each line contains a single option which is exactly the same as a normal command line option for dpkg except for the leading dashes which are not used here. Quotes surrounding option values are stripped. Comments are allowed by starting a line with a hash sign ("B<#>").
ja: 本ファイルには、dpkg オプションのデフォルトが設定される。各行には、行頭のダッシュを削除することを覗き、dpkg のコマンドラインオプションとまったく同一のオプションが記述する。オプションの値を囲むように付けられたクオート記号は無視される。ハッシュ記号 "B<#>" からはじまる行は、コメント行である。

note: type: SH
en: AUTHOR
ja: 作者

note: type: Plain text
en: dpkg-buildflags - returns build flags to use during package build
ja: パッケージのビルドの際に用いられるビルドフラグを返却する

note: type: Plain text
en: B<dpkg-buildflags> is a tool to retrieve compilation flags to use during build of Debian packages.
ja: B<dpkg-buildflags> は、Debian パッケージのビルドの際に用いられるコンパイルオプションを示すツールである。

note: type: Plain text
en: The default flags are defined by the vendor but they can be extended/overriden in several ways:
ja: デフォルトのフラグはベンダによって定義されるが、いくつかの方法によって上書きすることができる。

note: type: Plain text
en: system-wide with B</etc/dpkg/buildflags.conf>;
ja: システムワイドな B</etc/dpkg/buildflags.conf>

note: type: Plain text
en: for the current user with B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> where B<$XDG_CONFIG_HOME> defaults to B<$HOME/.config>;
ja: 現在のユーザの B<$XDG_CONFIG_HOME/dpkg/buildflags.conf>。B<$XDG_CONFIG_HOME>のデフォルトは B<$HOME/.config> である。

note: type: Plain text
en: temporarily by the user with environment variables (see section B<ENVIRONMENT>);
ja: ユーザ毎に一時的に設定される環境変数の値 (B<環境変数> セクションを参照のこと)。

note: type: Plain text
en: dynamically by the package maintainer with environment variables set via B<debian/rules> (see section B<ENVIRONMENT>).
ja: パッケージのメンテナによって B<debian/rules>で設定された環境変数の値 (B<環境変数> セクションを参照のこと)。

note: type: Plain text
en: The configuration files can contain two types of directives:
ja: 設定ファイルには、二種類のディレクティブが含まれる。

note: type: Plain text
en: Override the flag named I<flag> to have the value I<value>.
ja: I<flag> という名前のフラグの値を I<value> で上書きする。

note: type: Plain text
en: Strip from the flag named I<flag> all the build flags listed in I<value>.
ja: I<flag> という名前のフラグから、I<value> で指定されたビルドフラグを取り除く。

note: type: Plain text
en: Extend the flag named I<flag> by appending the options given in I<value>.  A space is prepended to the appended value if the flag's current value is non-empty.
ja: I<flag> という名前のフラグに対して、I<value> で指定されたオプションを追加する。対象のフラグに値が設定されている場合は、追加する値の前にスペースを付加すること。

note: type: Plain text
en: Extend the flag named I<flag> by prepending the options given in I<value>.  A space is appended to the prepended value if the flag's current value is non-empty.
ja: I<flag> という名前のフラグに対して I<value> で指定されたオプションを値の先頭部分に付加する。対象のフラグに値が設定されている場合は、追加する値の後ろにスペースを付加すること。

note: type: Plain text
en: The configuration files can contain comments on lines starting with a hash (#). Empty lines are also ignored.
ja: 設定ファイルには、ハッシュ (#) から始まるコメント行を含めてもよい。空行は無視される。

note: type: Plain text
en: Print to standard output all compilation flags and their values. It prints one flag per line separated from its value by an equal sign ("I<flag>=I<value>"). This is the default action.
ja: 標準出力に、すべてのコンパイルフラグとその値を出力する。1 行に 1 つのフラグが、等号記号でフラグ名と値とを区切った ("I<flag>=I<value>") 形式で出力される。これはデフォルトの動作である。

note: type: Plain text
en: Print the list of flags supported by the current vendor (one per line). See the B<SUPPORTED FLAGS> section for more information about them.
ja: 現在のベンダによってサポートされるフラグの一覧を (1 行に 1 つずつ) 出力する。詳細については、B<サポートされるフラグ> セクションを参照のこと。

note: type: Plain text
en: Display any information that can be useful to explain the behaviour of B<dpkg-buildflags>: relevant environment variables, current vendor, state of all feature flags. Also print the resulting compiler flags with their origin.
ja: B<dpkg-buildflags> の動作を示すのに便利な情報を表示する。これには関連する環境変数、現在のベンダ、すべての機能フラグの状態が含まれる。加えて、最終的なコンパイラのフラグが、元々のフラグの状態とともに表示される。

note: type: Plain text
en: This is intended to be run from B<debian/rules>, so that the build log keeps a clear trace of the build flags used. This can be useful to diagnose problems related to them.
ja: これは B<debian/rules> から実行されることを想定されており、結果として、ビルドのログを用いた、使用されているビルドフラグの明確なトレースが実現する。ビルドフラグに関連した問題を調査するのに有用である。

note: type: Plain text
en: Print to standard output shell (if I<format> is B<sh>) or make (if I<format> is B<make>) commands that can be used to export all the compilation flags in the environment. If I<format> is B<configure> then the output can be used on a B<./configure> command-line. If the I<format> value is not given, B<sh> is assumed. Only compilation flags starting with an upper case character are included, others are assumed to not be suitable for the environment.
ja: 標準出力に、シェル形式 (I<format> が B<sh> の場合) もしくは make 形式 (I<format> が make の場合) で、定義済のすべてのコンパイルフラグをエクスポートする。I<format> が B<configure> の場合、出力形式は、B<./configure> コマンドで使用可能な形式となる。I<format> の値が指定されない場合は B<sh> が仮定される。大文字から始まるコンパイルフラグのみが対象となる。それ以外のものは、現在の環境に適合していないものと見なされる。

note: type: Plain text
en: Print the value of the flag on standard output. Exits with 0 if the flag is known otherwise exits with 1.
ja: 指定されたフラグの値を標準出力に出力する。フラグが存在している場合は 0、それ以外の場合は 1 が返却される。

note: type: Plain text
en: Print the origin of the value that is returned by B<--get>. Exits with 0 if the flag is known otherwise exits with 1. The origin can be one of the following values:
ja: B<--get> によって返却された値の提供元を表示する。フラグが存在している場合は 0、それ以外の場合は 1 が返却される。origin は、以下の値のいずれかとなる:

note: type: Plain text
en: the original flag set by the vendor is returned;
ja: ベンダによって設定された本来のフラグ

note: type: Plain text
en: the flag is set/modified by a system-wide configuration;
ja: システムワイドな設定ファイルにより設定、変更されたフラグ

note: type: Plain text
en: the flag is set/modified by a user-specific configuration;
ja: ユーザ毎の設定により設定、変更されたフラグ

note: type: Plain text
en: the flag is set/modified by an environment-specific configuration.
ja: 環境固有の設定により設定、変更されたフラグ

note: type: Plain text
en: Print the features enabled for a given area. The only currently recognized area is B<hardening>. Exits with 0 if the area is known otherwise exits with 1.
ja: 指定された領域 (area) で有効化された機能 (Feature) を出力する。現在認識される領域は B<hardening> のみである。領域が認識されている場合は 0 を、それ以外の場合は 1 を返却し終了する。

note: type: Plain text
en: The output is in RFC822 format, with one section per feature.  For example:
ja: 出力は、機能ごとに、1つのセクションが存在する RFC822 形式となる。以下に例を示す:

note: type: SH
en: SUPPORTED FLAGS
ja: サポートされるフラグ

note: type: Plain text
en: Options for the C compiler. The default value set by the vendor includes I<-g> and the default optimization level (I<-O2> usually, or I<-O0> if the B<DEB_BUILD_OPTIONS> environment variable defines I<noopt>).
ja: C コンパイラのオプション。デフォルトの値はベンダによって設定されるが、I<-g> およびデフォルトの最適化レベル (通常 I<-O2> だが B<DEB_BUILD_OPTIONS>環境変数に I<noopt> が設定されている場合は I<-O0>) も含まれている。

note: type: Plain text
en: Options for the C preprocessor. Default value: empty.
ja: C プリプロセッサのオプション。デフォルト値: 未定義

note: type: Plain text
en: Options for the C++ compiler. Same as B<CFLAGS>.
ja: C++ コンパイラのオプション。B<CFLAGS> と同等

note: type: Plain text
en: Options for the Fortran compiler. Same as B<CFLAGS>.
ja: Fortran コンパイラのオプション。B<CFLAGS> と同等

note: type: Plain text
en: Options passed to the compiler when linking executables or shared objects (if the linker is called directly, then B<-Wl> and B<,> have to be stripped from these options). Default value: empty.
ja: 実行ファイルもしくは共有オブジェクトのリンクの際にコンパイラに渡されるオプション (リンカが直接呼び出される場合は、B<-Wl> および B<,> がオプションから削除される)。デフォルト値: 未定義

note: type: Plain text
en: System wide configuration file.
ja: システムワイドな設定ファイル

note: type: TP
en: B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> or B<$HOME/.config/dpkg/buildflags.conf>
ja: B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> もしくは B<$HOME/.config/dpkg/buildflags.conf>

note: type: Plain text
en: User configuration file.
ja: ユーザ毎の設定ファイル

note: type: Plain text
en: There are 2 sets of environment variables doing the same operations, the first one (DEB_I<flag>_I<op>) should never be used within B<debian/rules>. It's meant for any user that wants to rebuild the source package with different build flags. The second set (DEB_I<flag>_MAINT_I<op>) should only be used in B<debian/rules> by package maintainers to change the resulting build flags.
ja: 同じ動作を行う環境変数が 2 組存在する。1 つ目の (DEB_I<flag>_I<op>) を B<debian/rules> 内で用いてはならない。これは、デフォルトのフラグとは異なる設定でソースパッケージをリビルドしたいユーザ向けの設定である。2 つ目の方法 (DEB_I<flag>_MAINT_I<op>) は B<debian/rules> 内でのみ使用すべきである。これは、パッケージのメンテナがビルドフラグを変更する際に使用すること。

note: type: Plain text
en: This variable can be used to force the value returned for the given I<flag>.
ja: この変数は、I<flag> の値を強制的に設定したい場合に使用すること

note: type: Plain text
en: This variable can be used to provide a space separated list of options that will be stripped from the set of flags returned for the given I<flag>.
ja: この変数は、I<flag> の値から削除したいオプションがある場合に使用すること。削除したいオプションは、スペースで区切ったリスト形式で指定する。

note: type: Plain text
en: This variable can be used to append supplementary options to the value returned for the given I<flag>.
ja: この変数は、I<flag> の値に追加したいオプションがある場合に使用すること。

note: type: Plain text
en: This variable can be used to prepend supplementary options to the value returned for the given I<flag>.
ja: この変数は、I<flag> の値の先頭部分に追加したいオプションがある場合に使用すること。

note: type: Plain text
en: This variable can be used to disable/enable various hardening build flags through the B<hardening> option. See the B<HARDENING> section for details.
ja: この変数は、B<hardening> オプションによるビルドフラグの様々な要塞化の有効化、無効化を行うために使用される。詳細は B<要塞化> セクションを参照のこと。

note: type: SH
en: HARDENING
ja: 要塞化

note: type: Plain text
en: Several compile-time options (detailed below) can be used to help harden a resulting binary against memory corruption attacks, or provide additional warning messages during compilation. Except as noted below, these are enabled by default for architectures that support them.
ja: 幾つかのコンパイルタイムオプションを (以下で説明する) 使用することで、生成されるバイナリをメモリ破壊攻撃から保護したり、コンパイル時に追加の警告メッセージを表示させたりすることができる。以下で注記されていない限り、これらのオプションは、サポートされているアーキテクチャにおいて、デフォルトで有効化される。

note: type: Plain text
en: Each hardening feature can be enabled and disabled in the B<DEB_BUILD_MAINT_OPTIONS> environment variable's B<hardening> value with the "+" and "-" modifier. For example, to enable the "pie" feature and disable the "fortify" feature you can do this in B<debian/rules>:
ja: 各要塞化機能は、B<DEB_BUILD_MAINT_OPTIONS> 環境変数の B<hardening> 値において "+" や "-" をつけることで有効化/無効化できる。例えば、"pie" 機能を有効化して "fortify" 機能を無効化する場合、B<debian/rules> で次のように設定する:

note: type: Plain text
en: The special feature B<all> can be used to enable or disable all hardening features at the same time. Thus disabling everything and enabling only "format" and "fortify" can be achieved with:
ja: 特別な機能 B<all> により、すべての要塞化機能を一度に有効化、無効化することができる。次のようにして、すべての機能を無効化した上で "format" と "fortify" のみを有効化することができる:

note: type: Plain text
en: This setting (enabled by default) adds B<-Wformat -Werror=format-security> to B<CFLAGS> and B<CXXFLAGS>. This will warn about improper format string uses, and will fail when format functions are used in a way that represent possible security problems. At present, this warns about calls to B<printf> and B<scanf> functions where the format string is not a string literal and there are no format arguments, as in B<printf(foo);> instead of B<printf("%s", foo);> This may be a security hole if the format string came from untrusted input and contains "%n".
ja: この設定 (デフォルト有効) により、B<CFLAGS> および B<CXXFLAGS> に B<-Wformat -Werror=format-security> が追加される。これにより、不適切なフォーマット文字列の使用に関する警告が行われ、フォーマット関数が潜在的にセキュリティ問題を引き起こすような使用をされている場合に処理を失敗させる。現在、これは、B<printf> と B<scanf> 関数の呼び出しで、フォーマット文字列が文字列リテラル以外かつフォーマットに関する引数がないもの、例えば B<printf("%s", foo);> ではなく B<printf(foo);> のようなものについて警告する。信頼できない入力からもたらされたフォーマット文字列が "%n" を含んでいる場合、呼び出しはセキュリティホールとなりうる。

note: type: Plain text
en: This setting (enabled by default) adds B<-D_FORTIFY_SOURCE=2> to B<CPPFLAGS>. During code generation the compiler knows a great deal of information about buffer sizes (where possible), and attempts to replace insecure unlimited length buffer function calls with length-limited ones. This is especially useful for old, crufty code.  Additionally, format strings in writable memory that contain '%n' are blocked. If an application depends on such a format string, it will need to be worked around.
ja: この設定 (デフォルト有効) により、B<CPPFLAGS> に B<-D_FORTIFY_SOURCE=2> が追加される。コード生成の際に、コンパイラはバッファサイズに関して (可能な場所では) 多くの情報を収集し、安全でないバッファ長の制限のない関数の呼び出しを、制限のある関数の呼び出しに置換する。これは、古い汚いコードには特に有用である。これに加え、書き込み可能なメモリ上にあるフォーマット文字列で '%n' を含むものが抑止される。アプリケーションがこうしたフォーマット文字列に依存している場合は、個別に対処する必要がある。

note: type: Plain text
en: Note that for this option to have any effect, the source must also be compiled with B<-O1> or higher.
ja: このオプションが効果を発揮するためには、ソースコードは B<-O1> 以上でコンパイルされている必要がある。

note: type: Plain text
en: This setting (enabled by default) adds B<-fstack-protector --param=ssp-buffer-size=4> to B<CFLAGS> and B<CXXFLAGS>. This adds safety checks against stack overwrites. This renders many potential code injection attacks into aborting situations. In the best case this turns code injection vulnerabilities into denial of service or into non-issues (depending on the application).
ja: この設定 (デフォルト有効) により、B<CFLAGS> および B<CXXFLAGS> に B<-fstack-protector --param=ssp-buffer-size=4> が追加される。これにより、スタックの上書きに対する安全性チェックが追加され、多くの潜在的なコードインジェクション攻撃が抑止される。(アプリケーションにもよるが) 最良のケースでは、コードインジェクションの脆弱性を単なるサービス拒否に留めたり、無力化したりすることができる。

note: type: Plain text
en: This feature requires linking against glibc (or another provider of B<__stack_chk_fail>), so needs to be disabled when building with B<-nostdlib> or B<-ffreestanding> or similar.
ja: この機能は、glibc (もしくは B<__stack_chk_fail> を提供する他の実装) へのリンクが必要であるため、B<-nostdlib> や B<-ffreestanding> といったオプションでビルドする際には、無効にする必要がある。

note: type: Plain text
en: This setting (enabled by default) adds B<-Wl,-z,relro> to B<LDFLAGS>.  During program load, several ELF memory sections need to be written to by the linker. This flags the loader to turn these sections read-only before turning over control to the program. Most notably this prevents GOT overwrite attacks. If this option is disabled, B<bindnow> will become disabled as well.
ja: この設定 (デフォルト有効) は、B<LDFLAGS> に B<-Wl,-z,relro> を追加する。プログラムがロードされる際、ELF メモリセクションの幾つかは、リンカから書き込まれる必要がある。この設定により、ローダはプログラムに制御を引き渡す前に、こうしたセクションを読み取り専用にする。これにより、GOT を上書きする攻撃の大半が抑止される。このオプションが無効な場合、B<bindnow> も同様に無効となる。

note: type: Plain text
en: This setting (disabled by default) adds B<-Wl,-z,now> to B<LDFLAGS>. During program load, all dynamic symbols are resolved, allowing for the entire PLT to be marked read-only (due to B<relro> above). The option cannot become enabled if B<relro> is not enabled.
ja: この設定 (デフォルト無効) は B<LDFLAGS> に B<-Wl,-z,now> を追加する。これにより、プログラムがロードされる時点ですべての動的なシンボルが解決されるため、PLT 全体を読み取り専用とすることが可能となる (上の B<relro> を参照のこと)。B<relro> が有効でない場合、このオプションは有効化できない。

note: type: Plain text
en: This setting (disabled by default) adds B<-fPIE> to B<CFLAGS> and B<CXXFLAGS>, and B<-fPIE -pie> to B<LDFLAGS>. Position Independent Executable are needed to take advantage of Address Space Layout Randomization, supported by some kernel versions. While ASLR can already be enforced for data areas in the stack and heap (brk and mmap), the code areas must be compiled as position-independent. Shared libraries already do this (-fPIC), so they gain ASLR automatically, but binary .text regions need to be build PIE to gain ASLR. When this happens, ROP (Return Oriented Programming) attacks are much harder since there are no static locations to bounce off of during a memory corruption attack.
ja: この設定 (デフォルト無効) は B<CFLAGS> および B<CXXFLAGS> に B<-fPIE> を追加し、B<LDFLAGS> に B<-fPIE -pie> を追加する。PIE (位置独立実行形式) は、幾つかのカーネルバージョンでサポートされるアドレス空間配置のランダム化 (ASLR) を行う上で必要となる。スタックとヒープ (brk とmmap) 内のデータ領域では、ASLR が既に必須となっているが、コード領域も位置独立でコンパイルされる必要がある。共有ライブラリでは、(-fPIC) によりこれが既に行われているので、自動的に ASLR が行われるが、バイナリの .text 領域は ASLR を行うために、PIE でビルドされる必要がある。これが実現すると、メモリ破壊攻撃を行う際にリターンさせる先のアドレスが静的ではなくなるため、ROP (Return Oriented Programming) 攻撃が、より困難となる。

note: type: Plain text
en: This is not compatible with B<-fPIC> so care must be taken when building shared objects.
ja: これは B<-fPIC> と互換性がないため、共有ライブラリをビルドする際は、設定を行わないよう注意すること

note: type: Plain text
en: Additionally, since PIE is implemented via a general register, some architectures (most notably i386) can see performance losses of up to 15% in very text-segment-heavy application workloads; most workloads see less than 1%. Architectures with more general registers (e.g. amd64)  do not see as high a worst-case penalty.
ja: 加えて、PIE は汎用レジスタにより実装されているため、幾つかのアーキテクチャ (特に注意すべきは i386) では、text セグメントの負荷が高いアプリケーションにおいて最大 15% 程度のパフォーマンス低下が見込まれる。もっとも、大半の場合、パフォーマンス低下は 1% 未満である。多くの汎用レジスタを有するアーキテクチャ (amd64 など) では、前述した最悪の場合であっても問題は発生しない。

note: type: Plain text
en: dpkg-buildpackage - build binary or source packages from sources
ja: dpkg-buildpackage - バイナリパッケージおよびソースパッケージのビルド

note: type: Plain text
en: B<dpkg-buildpackage> is a program that automates the process of building a Debian package. It consists of the following steps:
ja: B<dpkg-buildpackage> は、Debian パッケージのビルドを自動化するプログラムである。これには以下のステップが含まれる:

note: type: Plain text
en: It prepares the build environment by setting various environment variables (see B<ENVIRONMENT>) and calls B<dpkg-source --before-build> (unless B<-T> or B<--target> has been used).
ja: 様々な環境変数 (B<環境変数> を参照のこと) を定義することで、ビルド環境を設定し、B<dpkg-source --before-build> を呼び出す (B<-T> もしくは B<--target>が指定されていない限り)。

note: type: Plain text
en: It checks that the build-dependencies and build-conflicts are satisfied (unless B<-d> is specified).
ja: ビルドにおける依存関係が満たされているか、競合が発生していないかをチェックする (B<-d> が指定されていない限り)。

note: type: Plain text
en: If a specific target has been selected with the B<-T> or B<--target> option, it calls that target and stops here. Otherwise it calls B<fakeroot debian/rules clean> to clean the build-tree (unless B<-nc> is specified).
ja: B<-T> もしくは B<--target> オプションにより、ビルドのターゲットが指定されている場合は、ターゲットを呼び出して、そこで実行を停止する。それ以外の場合は B<fakeroot debian/rules clean> を呼び出し、ビルドツリーをクリアする (B<-nc> が指定されていない限り)。

note: type: Plain text
en: It calls B<dpkg-source -b> to generate the source package (unless a binary-only build has been requested with B<-b>, B<-B> or B<-A>).
ja: B<dpkg-source -b> を呼び出し、ソースパッケージを生成する (B<-b>, B<-B>, B<-A> によってバイナリパッケージのみのビルドが指定されていない限り)。

note: type: Plain text
en: It calls B<debian/rules> I<build-target> followed by B<fakeroot debian/rules> I<binary-target> (unless a source-only build has been requested with B<-S>). Note that I<build-target> and I<binary-target> are either B<build> and B<binary> (default case, or if B<-b> is specified), or B<build-arch> and B<binary-arch> (if B<-B> is specified), or B<build-indep> and B<binary-indep> (if B<-A> is specified).
ja: B<fakeroot debian/rules> I<binary-target> に続き、B<debian/rules> B<build-target> を呼び出す (B<-S> によってソースパッケージのみのビルドが指定されていない限り)。I<build-target> および I<binary-target> は B<build> および B<binary> (デフォルト、もしくは B<-b> が指定されていた場合)、B<build-arch> および B<binary-arch> (B<-B> が指定されていた場合)、B<build-indep> および B<binary-indep> (B<-A> が指定されていた場合) のいずれかの値をとる。

note: type: Plain text
en: It calls B<gpg> to sign the B<.dsc> file (if any, unless B<-us> is specified).
ja: B<gpg> を呼び出し、B<.dsc> ファイルに署名を行う (B<-us> が指定されていない限り)。

note: type: Plain text
en: It calls B<dpkg-genchanges> to generate a B<.changes> file.  Many B<dpkg-buildpackage> options are forwarded to B<dpkg-genchanges>.
ja: B<dpkg-genchanges> を呼び出して、B<.changes> ファイルを生成する。B<dpkg-buildpackage> のオプションの多くが B<dpkg-genchanges> に引き継がれる。

note: type: Plain text
en: It calls B<gpg> to sign the B<.changes> file (unless B<-uc> is specified).
ja: B<gpg> を呼び出し、B<.changes> ファイルに署名を行う (B<-uc> が指定されていない限り)。

note: type: Plain text
en: If B<-tc> is specified, it will call B<fakeroot debian/rules clean> again. Finally it calls B<dpkg-source --after-build>.
ja: B<-tc> が指定されていた場合、B<fakeroot debian/rules clean> が再度呼び出される。最後に B<dpkg-source --after-build> が呼び出される。

note: type: Plain text
en: Specifies a binary-only build, no source files are to be built and/or distributed. Passed to B<dpkg-genchanges>.
ja: バイナリパッケージのみのビルドを指定する。ソースファイルはビルドされず、配布もされない。オプションは B<dpkg-genchanges> に渡される。

note: type: Plain text
en: Specifies a binary-only build, limited to architecture dependent packages.  Passed to B<dpkg-genchanges>.
ja: アーキテクチャ依存のパッケージについて、バイナリパッケージのみのビルドを指定する。オプションは B<dpkg-genchanges> に渡される。

note: type: Plain text
en: Specifies a binary-only build, limited to architecture independent packages. Passed to B<dpkg-genchanges>.
ja: アーキテクチャ非依存のパッケージについて、バイナリパッケージのみのビルドを指定する。オプションは B<dpkg-genchanges> に渡される。

note: type: Plain text
en: Specifies a source-only build, no binary packages need to be made.  Passed to B<dpkg-genchanges>.
ja: ソースパッケージのみのビルドを指定する。バイナリパッケージは作成されない。オプションは B<dpkg-genchanges> に渡される。

note: type: Plain text
en: Specifies a normal full build, binary and source packages will be built.  This is the same as the default case when no build option is specified.
ja: バイナリパッケージとソースパッケージの両方をビルドする、通常のフルビルドを指定する。これはビルドオプションを指定しなかった際のデフォルトの挙動である。

note: type: Plain text
en: Calls B<debian/rules> I<target> after having setup the build environment and stops the package build process here. If B<--as-root> is also given, then the command is executed as root (see B<-r>). Note that official targets that are required to be run as root by the Debian policy do not need this option.
ja: ビルド環境の設定後に、B<debian/rules> I<target> を呼び出し、そこでパッケージのビルド処理を中止する。B<--as-root> も設定されていた場合、コマンドは root として実行される (B<-r> も参照のこと)。Debian policy によって、公式に root での実行が必須とされているターゲットについては、本オプションは不要である。

note: type: Plain text
en: Only meaningful together with B<--target>. Requires that the target be run with root rights.
ja: B<--target> と併せて指定された場合のみ有効であり、target の実行に root 権限が必要であることを指定する。

note: type: Plain text
en: Passed unchanged to B<dpkg-genchanges>. See its manual page.
ja: B<dpkg-genchanges> にそのまま引き渡される。そちらのマニュアルページを参照のこと。

note: type: Plain text
en: Specify the Debian architecture we build for. The architecture of the machine we build on is determined automatically, and is also the default for the host machine.
ja: ビルド対象となる Debian アーキテクチャを指定する。ビルドを実行するマシンのアーキテクチャは自動的に判別され、ホストマシンのデフォルト値となる。

note: type: Plain text
en: Specify the GNU system type we build for. It can be used in place of -a or as a complement to override the default GNU system type of the target Debian architecture.
ja: ビルド対象となる GNU システムタイプを指定する。これは -a オプションの代わりとしてターゲットの Debian アーキテクチャに対応するデフォルトの GNU システムタイプを上書きするために用いられる。

note: type: Plain text
en: Number of jobs allowed to be run simultaneously, equivalent to the B<make>(1)  option of the same name. Will add itself to the MAKEFLAGS environment variable, which should cause all subsequent make invocations to inherit the option. Also adds B<parallel=>I<jobs> to the DEB_BUILD_OPTIONS environment variable which allows debian/rules files to use this information for their own purposes.  The B<parallel=>I<jobs> in DEB_BUILD_OPTIONS environment variable will override the B<-j> value if this option is given.
ja: 同時に実行させることが可能なジョブの数であり、B<make>(1) の同名のオプションと同じ意味を持つ。MAKEFLAGS 環境変数に追加され、後に続くすべての make の呼び出しに、このオプションが引き継がれる。このオプションは、debian/rules ファイルがこの情報を使用できるように DEB_BUILD_OPTIONS 環境変数に対しても B<parallel=>I<jobs> を追加する。DEB_BUILD_OPTIONS 環境変数に B<parallel=>I<jobs> が設定されていた場合、B<-j> オプションの値は上書きされる。

note: type: Plain text
en: Check build dependencies and conflicts; abort if unsatisfied. This is the default behavior.
ja: ビルドの依存関係と競合をチェックし、問題がある場合は処理を中断させる。これはデフォルトの挙動である。

note: type: Plain text
en: Do not check build dependencies and conflicts.
ja: ビルドの依存関係と競合をチェックしない。

note: type: Plain text
en: Do not clean the source tree (implies B<-b> if nothing else has been selected among B<-B>, B<-A> or B<-S>).
ja: ソースツリーを消去しない (B<-B>, B<-A>, B<-S> いずれもが指定されない場合は、B<-b> が指定されたと見なされる)。

note: type: Plain text
en: Clean the source tree (using I<gain-root-command> B<debian/rules clean>)  after the package has been built.
ja: パッケージのビルド後にソースツリーを消去する (I<gain-root-command> B<debian/rules clean> が用いられる)。

note: type: Plain text
en: When B<dpkg-buildpackage> needs to execute part of the build process as root, it prefixes the command it executes with I<gain-root-command> if one has been specified. Otherwise, if none has been specified, B<fakeroot> will be used by default, if the command is present.  I<gain-root-command> should start with the name of a program on the B<PATH> and will get as arguments the name of the real command to run and the arguments it should take.  I<gain-root-command> can include parameters (they must be space-separated) but no shell metacharacters.  I<gain-root-command> might typically be B<fakeroot>, B<sudo>, B<super> or B<really>.  B<su> is not suitable, since it can only invoke the user's shell with B<-c> instead of passing arguments individually to the command to be run.
ja: B<dpkg-buildpackage> がビルド処理の一部を root 権限で実行する必要がある場合、このオプションが指定されていれば、実行するコマンドの前に I<gain-root-command> が付けられる。このオプションが指定されていなかった場合は、B<fakeroot> が存在していれば、それがデフォルトで用いられる。I<gain-root-command> はB<PATH> 上のプログラム名である必要があり、実際に実行したいコマンドに続き、そのコマンドの引数を引数として指定する。I<gain-root-command> には (スペースで区切られた) パラメータを含めてもよいが、シェルのメタキャラクタを含めることはできない。I<gain-root-command> は通常 B<fakeroot>, B<sudo>, B<super>, B<really> などである。B<su> は、実行したいコマンドに引数を個々に引き渡すのではなく、B<-c> を用いてユーザのシェルを起動するだけであるため適切ではない。

note: type: Plain text
en: Building a Debian package usually involves invoking B<debian/rules> as a command with several standard parameters. With this option it's possible to use another program invocation to build the package (it can include space separated parameters).  Alternatively it can be used to execute the standard rules file with another make program (for example by using B</usr/local/bin/make -f debian/rules> as I<rules-file>).
ja: Debian パッケージのビルドの際は、通常 B<debian/rules> コマンドが幾つかの標準的な引数を付けて実行される。このオプションにより、パッケージのビルドの際に別のプログラムを使用することが可能となる (スペースで区切られた引数を含めることも可能である)。標準のルールファイルを別の make プログラムで実行する (例えば I<rules-file> の代わりに B</usr/local/bin/make -f debian/rules> を使用する) ために使用することもできる。

note: type: Plain text
en: When B<dpkg-buildpackage> needs to execute GPG to sign a source control (B<.dsc>) file or a B<.changes> file it will run I<sign-command> (searching the B<PATH> if necessary) instead of B<gpg>. I<sign-command> will get all the arguments that B<gpg> would have gotten. I<sign-command> should not contain spaces or any other shell metacharacters.
ja: B<dpkg-buildpackage> がソースコントロール (B<.dsc>) ファイルや B<.changes> ファイルに署名するために GPG を実行する必要がある場合、B<gpg> の代わりにI<sign-command> を実行する (必要に応じて B<PATH> を検索する) 。I<sign-command> には B<gpg> に引き渡されるすべての引数が引き渡される。I<sign-command> にはスペースやシェルのメタキャラクタを含めてはならない。

note: type: Plain text
en: Specify a key-ID to use when signing packages.
ja: パッケージに署名する際に使用する鍵のIDを指定する。

note: type: Plain text
en: Do not sign the source package.
ja: ソースパッケージに署名しない。

note: type: Plain text
en: Do not sign the B<.changes> file.
ja: B<.changes> ファイルに署名しない。

note: type: Plain text
en: Passed unchanged to B<dpkg-source>. See its manual page.
ja: B<dpkg-source> にそのまま引き渡される。そちらのマニュアルページを参照のこと。

note: type: Plain text
en: Pass option I<opt> to B<dpkg-source>.
ja: B<dpkg-source> に I<opt> オプションを引き渡す。

note: type: Plain text
en: Pass option I<opt> to B<dpkg-genchanges>.
ja: B<dpkg-genchanges> に I<opt> オプションを引き渡す。

note: type: Plain text
en: Change the location of the B<dpkg> database. The default location is I</var/lib/dpkg>.
ja: B<dpkg> データベースの位置を変更する。デフォルトの位置は I</var/lib/dpkg> である。

note: type: Plain text
en: Even if B<dpkg-buildpackage> exports some variables, B<debian/rules> should not rely on their presence and should instead use the respective interface to retrieve the needed values.
ja: B<dpkg-buildpackage> が幾つかの変数をエクスポートしていたとしても、B<debian/rules> はその存在に依存してはならない。代わりに必要な値を取得するためのインタフェースを使用すること。

note: type: SS
en: Variables set by dpkg-architecture
ja: dpkg-architecture によって設定される変数

note: type: Plain text
en: B<dpkg-architecture> is called with the B<-a> and B<-t> parameters forwarded. Any variable that is output by its B<-s> option is integrated in the build environment.
ja: B<dpkg-architecture> は B<-a> および B<-t> を引数として呼び出される。このコマンドの B<-s> オプションによって設定された変数はビルド環境にマージされる。

note: type: SS
en: Compiler flags are no longer exported
ja: コンパイラフラグのエクスポート停止

note: type: Plain text
en: Between versions 1.14.17 and 1.16.1, B<dpkg-buildpackage> exported compiler flags (B<CFLAGS>, B<CXXFLAGS>, B<FFLAGS>, B<CPPFLAGS> and B<LDFLAGS>) with values as returned by B<dpkg-buildflags>. This is no longer the case.
ja: 1.14.17 から 1.16.1 の間では、B<dpkg-buildpackage> が B<dpkg-buildflags> によって返却される値としてコンパイラフラグ (B<CFLAGS>, B<CXXFLAGS>, B<FFLAGS>, B<CPPFLAGS>, B<LDFLAGS>) をエクスポートしていた。現在のバージョンでは、行われていない。

note: type: Plain text
en: B<dpkg-buildpackage> is using the B<build-arch> and B<build-indep> targets since version 1.16.2. Those targets are thus mandatory. But to avoid breakages of existing packages, and ease the transition, it will fallback to using the B<build> target if B<make -f debian/rules -qn> I<build-target> returns 2 as exit code.
ja: バージョン 1.16.2 以降の B<dpkg-buildpackage> は、B<build-arch> および B<build-indep> ターゲットを使用している。これらのターゲットは必須である。しかし、既存パッケージで問題が発生するのを回避し、円滑な移行を行うために、B<make -f debian/rules -qn> I<build-target> が戻り値として 2 を返却した場合は、B<build> ターゲットにフォールバックする。

note: type: Plain text
en: It should be possible to specify spaces and shell metacharacters in and initial arguments for I<gain-root-command> and I<sign-command>.
ja: I<gain-root-command> および I<sign-command> の先頭の引数として、スペースやシェルのメタキャラクタを指定できるようにすべきである。

note: type: Plain text
en: dpkg-checkbuilddeps - check build dependencies and conflicts
ja: dpkg-checkbuilddeps - ビルド時の依存と競合のチェック

note: type: Plain text
en: This program checks the installed packages in the system against the build dependencies and build conflicts listed in the control file. If any are not met, it displays them and exits with a nonzero return code.
ja: このプログラムは、制御ファイルに列挙されているビルド時の依存関係と競合に関して、システムにインストールされているパッケージをチェックする。問題があった場合はそれらを表示し、0 以外の返り値で終了する。

note: type: Plain text
en: By default, B<debian/control> is read, but an alternate control filename may be specified on the command line.
ja: デフォルトでは、I<debian/control> が読みこまれるが、別のコントロールファイル名をコマンドラインで指定することもできる。

note: type: Plain text
en: Ignore I<Build-Depends-Arch> and I<Build-Conflicts-Arch> lines. Use when only arch-indep packages will be built, or combine with B<-B> when only a source package is to be built.
ja: I<Build-Depends-Arch> および  I<Build-Conflicts-Arch> 行を無視する。アーキテクチャ依存のパッケージをビルドする時のみ利用すること。ソースパッケージのみビルドする時には、B<-B> を併せて指定すること。

note: type: Plain text
en: Ignore I<Build-Depends-Indep> and I<Build-Conflicts-Indep> lines. Use when only arch-dep packages will be built, or combine with B<-A> when only a source package is to be built.
ja: I<Build-Depends-Indep> および I<Build-Conflicts-Indep> 行を無視する。アーキテクチャ依存のパッケージをビルドする時のみ利用すること。ソースパッケージのみビルドする時には、B<-A> を併せて指定すること。

note: type: Plain text
en: Use the given build dependencies/conflicts instead of those contained in the I<debian/control> file.
ja: I<debian/control> ファイルに含まれている情報の代わりに、指定されたビルド時の依存関係と競合の情報を使用する。

note: type: Plain text
en: Check build dependencies/conflicts assuming that the package described in the control file is to be built for the given host architecture instead of the architecture of the current system.
ja: 制御ファイルで指定されたパッケージが、現在のシステムのアーキテクチャではなく、指定されたホストのアーキテクチャでビルドされたものとして、ビルド時の依存関係と競合のチェックを行う。

note: type: Plain text
en: dpkg-distaddfile - add entries to debian/files
ja: dpkg-distaddfile - debian/files にエントリを追加する

note: type: Plain text
en: B<dpkg-distaddfile> adds an entry for a named file to B<debian/files>.
ja: B<dpkg-distaddfile> は B<debian/files> にファイル名のエントリを追加する。

note: type: Plain text
en: It takes three non-option arguments, the filename and the section and priority for the B<.changes> file.
ja: このコマンドは、B<.changes> ファイル用に、オプション以外の引数として filename, section, priority という 3 つの引数をとる。

note: type: Plain text
en: The filename should be specified relative to the directory where B<dpkg-genchanges> will expect to find the files, usually B<..>, rather than being a pathname relative to the current directory when B<dpkg-distaddfile> is run.
ja: filename は B<dpkg-genchanges> が想定するディレクトリ、通常 B<..> からの相対パスで指定する。B<dpkg-distaddfile> 実行時のカレントディレクトリからの相対パスではない。

note: type: Plain text
en: Read or write the list of files to be uploaded here, rather than using B<debian/files>.
ja: B<debian/files> の代わりにこのファイルに記載されたファイルのリストを読み書きする。

note: type: Plain text
en: The list of generated files which are part of the upload being prepared.  B<dpkg-distaddfile> can be used to add additional files.
ja: アップロードの準備の一部をなす、生成されたファイルのリスト。B<dpkg-distaddfile> により、ファイルを追加することができる。

note: type: Plain text
en: dpkg-deb - Debian package archive (.deb) manipulation tool
ja: dpkg-deb - Debian パッケージアーカイブ (.deb) 操作ツール

note: type: Plain text
en: B<dpkg-deb> packs, unpacks and provides information about Debian archives.
ja: B<dpkg-deb> は、Debian アーカイブの作成、展開、情報の表示を行う。

note: type: Plain text
en: Use B<dpkg> to install and remove packages from your system.
ja: パッケージをシステムにインストールしたり削除したりするには B<dpkg> を使うこと。

note: type: Plain text
en: You can also invoke B<dpkg-deb> by calling B<dpkg> with whatever options you want to pass to B<dpkg-deb>. B<dpkg> will spot that you wanted B<dpkg-deb> and run it for you.
ja: また、B<dpkg-deb> に引き渡したいオプションを指定して B<dpkg> を実行することで、B<dpkg-deb> を実行することもできる。B<dpkg> は、B<dpkg-deb> 用のオプションであると判断すると、 B<dpkg-deb> を起動する。

note: type: Plain text
en: Creates a debian archive from the filesystem tree stored in I<directory>. I<directory> must have a B<DEBIAN> subdirectory, which contains the control information files such as the control file itself. This directory will I<not> appear in the binary package's filesystem archive, but instead the files in it will be put in the binary package's control information area.
ja: I<directory> 以下のファイルシステムツリーから debian アーカイブを作成する。 I<directory> には、control ファイルなどの制御情報ファイルのある B<DEBIAN> サブディレクトリが必ず存在しなければならない。 DEBIAN ディレクトリはバイナリパッケージのファイルシステム・アーカイブにはI<含まれない>。代わりに DEBIAN ディレクトリ以下にあったファイルはバイナリパッケージの制御情報エリアに置かれる。

note: type: Plain text
en: Unless you specify B<--nocheck>, B<dpkg-deb> will read B<DEBIAN/control> and parse it. It will check it for syntax errors and other problems, and display the name of the binary package being built.  B<dpkg-deb> will also check the permissions of the maintainer scripts and other files found in the B<DEBIAN> control information directory.
ja: B<--nocheck> を指定しないかぎり、 B<dpkg-deb> は B<DEBIAN/control> を読み込んで解析する。 B<dpkg-deb> は、文法エラーなどの問題のチェックを行い、ビルド中のバイナリパッケージ名を表示する。 B<dpkg-deb> は、 B<DEBIAN> 制御情報ディレクトリにある、メンテナスクリプトなどのファイルのパーミッションもチェックする。

note: type: Plain text
en: If no I<archive> is specified then B<dpkg-deb> will write the package into the file I<directory>B<.deb>.
ja: I<archive> が指定されない場合、 B<dpkg-deb> はパッケージを I<directory>B<.deb> という名前で作成する。

note: type: Plain text
en: If the archive to be created already exists it will be overwritten.
ja: 作成するアーカイブが既に存在している場合は、上書きする。

note: type: Plain text
en: If the second argument is a directory then B<dpkg-deb> will write to the file I<package>B<_>I<version>B<_>I<arch>B<.deb>, or I<package>B<_>I<version>B<.deb> if no B<Architecture> field is present in the package control file. When a target directory is specified, rather than a file, the B<--nocheck> option may not be used (since B<dpkg-deb> needs to read and parse the package control file to determine which filename to use).
ja: 2 番目の引数がディレクトリの場合、 B<dpkg-deb> は I<package>B<_>I<version>B<_>I<arch>B<.deb> または I<package>B<_>I<version>B<.deb> (パッケージ制御ファイルに B<Architecture> フィールドがない場合) というファイルを作成する。ファイル名の代わりにディレクトリを指定するときには、B<--nocheck> オプションを使用してはいけない (B<dpkg-deb> は、使用するファイル名を確認するために、パッケージ制御ファイルを読み込んで解析する必要があるため)。

note: type: Plain text
en: Provides information about a binary package archive.
ja: バイナリパッケージアーカイブの情報を表示する。

note: type: Plain text
en: If no I<control-file-name>s are specified then it will print a summary of the contents of the package as well as its control file.
ja: I<control-file-name> が指定されていない場合は、制御ファイルの一覧と、パッケージの概要を表示する。

note: type: Plain text
en: If any I<control-file-name>s are specified then B<dpkg-deb> will print them in the order they were specified; if any of the components weren't present it will print an error message to stderr about each one and exit with status 2.
ja: I<control-file-name> が指定された場合、 B<dpkg-deb> は指定された順でファイルの内容を表示する。指定したファイルの一部が存在しない場合、存在しないファイル各々について、標準エラー出力にエラーメッセージを表示し、そして終了ステータス 2 で終了する。

note: type: Plain text
en: Provides information about a binary package archive in the format specified by the B<--showformat> argument. The default format displays the package's name and version on one line, separated by a tabulator.
ja: バイナリパッケージアーカイブの情報を B<--showformat> 引数で指定した形式で表示する。デフォルトの形式では、パッケージ名とバージョンがタブで区切られて 1 行に表示される。

note: type: Plain text
en: Extracts control file information from a binary package archive.
ja: バイナリパッケージアーカイブから制御ファイル情報を取り出す。

note: type: Plain text
en: If no B<control-file-field>s are specified then it will print the whole control file.
ja: B<control-file-field> が指定されていない場合、control ファイルのすべての内容が表示される。

note: type: Plain text
en: If any are specified then B<dpkg-deb> will print their contents, in the order in which they appear in the control file. If more than one B<control-file-field> is specified then B<dpkg-deb> will precede each with its field name (and a colon and space).
ja: B<control-file-field> が指定されている場合、B<dpkg-deb> は指定されたフィールドの内容を制御ファイルに記載されている順に表示する。B<control-file-field> が複数指定された場合、 B<dpkg-deb> は、各々の前にフィールド名 (およびコロンとスペース) を表示する。

note: type: Plain text
en: No errors are reported for fields requested but not found.
ja: 指定したフィールドがみつからない場合でもエラーにはならない。

note: type: Plain text
en: Lists the contents of the filesystem tree archive portion of the package archive. It is currently produced in the format generated by B<tar>'s verbose listing.
ja: パッケージアーカイブに含まれるファイルシステムツリーの内容を表示する。現在は、B<tar> の冗長表示 (-v オプション) の形式で表示する。

note: type: Plain text
en: Extracts the filesystem tree from a package archive into the specified directory.
ja: パッケージアーカイブから、ファイルシステムツリーを指定したディレクトリに展開する。

note: type: Plain text
en: Note that extracting a package to the root directory will I<not> result in a correct installation! Use B<dpkg> to install packages.
ja: ルートディレクトリにパッケージを展開しても、正しいインストールにはI<ならない>ことに注意 ! パッケージのインストールには B<dpkg> を使うこと。

note: type: Plain text
en: I<directory> (but not its parents) will be created if necessary, and its permissions modified to match the contents of the package.
ja: I<directory> (親ディレクトリは含まない) は必要に応じて作成される。

note: type: Plain text
en: Is like B<--extract> (B<-x>)  with B<--verbose> (B<-v>)  which prints a listing of the files extracted as it goes.
ja: B<--extract> (B<-x>) に B<--verbose> (B<-v>) を付加したオプションと同様だが、実際にファイルを展開して一覧を表示する。

note: type: Plain text
en: Extracts the filesystem tree from a package archive into a specified directory, and the control information files into a DEBIAN subdirectory of the specified directory.
ja: パッケージアーカイブから、ファイルシステムツリーを指定したディレクトリに展開し、制御情報ファイルを、DEBIAN サブディレクトリに展開する。

note: type: Plain text
en: The target directory (but not its parents) will be created if necessary.
ja: 指定したディレクトリ (親ディレクトリは含まない) は必要に応じて作成される。

note: type: Plain text
en: Extracts the filesystem tree data from a binary package and sends it to standard output in B<tar> format. Together with B<tar>(1)  this can be used to extract a particular file from a package archive.  The input archive will always be processed sequentially.
ja: バイナリパッケージからファイルシステムツリーを展開し、標準出力に B<tar> 形式で出力する。 B<tar>(1) と組み合わせて使用することで、特定のファイルをパッケージアーカイブから取り出すことができる。入力のアーカイブは、常に 1 つずつ処理される。

note: type: Plain text
en: Extracts the control information files from a package archive into the specified directory.
ja: パッケージアーカイブから制御情報ファイルを指定したディレクトリに展開する。

note: type: Plain text
en: If no directory is specified then a subdirectory B<DEBIAN> in the current directory is used.
ja: ディレクトリが指定されない場合、カレントディレクトリの B<DEBIAN> サブディレクトリに展開する。

note: type: Plain text
en: This option is used to specify the format of the output B<--show> will produce. The format is a string that will be output for each package listed.
ja: このオプションは、B<--show> の出力の書式を指定するものである。書式は、一覧表示される各パッケージの出力を制御する文字列である。

note: type: Plain text
en: The string may reference any status field using the "${I<field-name>}" form, a list of the valid fields can be easily produced using B<-I> on the same package. A complete explanation of the formatting options (including escape sequences and field tabbing) can be found in the explanation of the B<--showformat> option in B<dpkg-query>(1).
ja: 文字列は "${I<field-name>}" 形式であらゆる status フィールドを参照することができる。有効なフィールドの一覧は、対象のパッケージに B<-I> を使用することで簡単に確認できる。書式オプションの網羅的な解説 (エスケープシーケンスやフィールドでのタブの使い方を含む) は、B<dpkg-query>(1)の B<--showformat> オプションの解説を参照のこと。

note: type: Plain text
en: The default for this field is "${Package}\et${Version}\en".
ja: このフィールドのデフォルトの書式は "${Package}\et${Version}\en" である。

note: type: Plain text
en: Specify which compression level to use on the compressor backend, when building a package (default is 9 for gzip and bzip2, 6 for xz and lzma).  The accepted values are 0-9 with: 0 being mapped to compressor none for gzip and 0 mapped to 1 for bzip2. Before dpkg 1.16.2 level 0 was equivalent to compressor none for all compressors.
ja: パッケージのビルドの際に、圧縮を行うバックエンドのプログラムに引き渡す圧縮レベルを指定する (デフォルトは、gzip および bzip2 の場合 9、xz および lzma の場合 6)。指定可能な値は 0-9 であり、gzip の場合 0 は非圧縮に対応するが、bzip2 の場合 0 は 1 とみなされる。dpkg 1.16.2 より前では、すべての圧縮プログラムにおいて、レベル 0 は非圧縮と等価となる。

note: type: Plain text
en: Specify which compression strategy to use on the compressor backend, when building a package (since dpkg 1.16.2). Allowed values are I<none> (since dpkg 1.16.4) and I<extreme> for xz.
ja: パッケージのビルドの際に、圧縮を行うバックエンドのプログラムに引き渡す圧縮ストラテジーを指定する (dpkg 1.16.2 以降)。指定可能な値は、I<none> (dpkg 1.16.4 以降) と、xz 用の I<extreme> である。

note: type: Plain text
en: Specify which compression type to use when building a package. Allowed values are I<gzip>, I<xz>, I<bzip2>, I<lzma>, and I<none> (default is I<gzip>).
ja: パッケージのビルドの際に使用する圧縮タイプを指定する。指定可能な値は I<gzip>, I<xz>, I<bzip2>, I<lzma>, I<none> (デフォルトは I<gzip>) である。

note: type: Plain text
en: Ensures that B<dpkg-deb> builds a `new' format archive. This is the default.
ja: B<dpkg-deb> に `新しい' 形式のアーカイブを構築させる。これはデフォルトの動作である。

note: type: Plain text
en: Forces B<dpkg-deb> to build an `old' format archive. This old archive format is less easily parsed by non-Debian tools and is now obsolete; its only use is when building packages to be parsed by versions of dpkg older than 0.93.76 (September 1995), which was released as i386 a.out only.
ja: B<dpkg-deb> に `古い' 形式のアーカイブを構築させる。この古いアーカイブ形式は、新しい形式よりも Debian 以外のツールで処理することが難しく、現在は廃止されている。このオプションは、i386 の a.out 形式のみを対象としてリリースされた、バージョン 0.93.76 (1995 年 9 月) 以前の dpkg で処理するためのパッケージをビルドする時のみ使用すること。

note: type: Plain text
en: Inhibits B<dpkg-deb --build>'s usual checks on the proposed contents of an archive. You can build any archive you want, no matter how broken, this way.
ja: B<dpkg-deb --build> の際に通常実施される、アーカイブの内容のチェックを実施しない。これにより、アーカイブの内容に問題があっても、アーカイブをビルドすることができる。

note: type: Plain text
en: Enables verbose output. This currently only affects B<--extract> making it behave like B<--vextract>.
ja: 詳細な出力を有効にする。現在のところ、これは B<--extract> に B<--vextract> と同様の挙動をさせる場合のみ有効である。

note: type: Plain text
en: Enables debugging output. This is not very interesting.
ja: デバッグ出力を有効にする。これはあまり面白いものではない。

note: type: Plain text
en: If set, B<dpkg-deb> will use it as the directory in which to create temporary files and directories.
ja: B<TMPDIR> が設定されている場合、B<dpkg-deb> は、一時的なファイルやディレクトリを作成するディレクトリとして使用する。

note: type: Plain text
en: B<dpkg-deb -I> I<package1>B<.deb> I<package2>B<.deb> does the wrong thing.
ja: B<dpkg-deb -I> I<package1>B<.deb> I<package2>B<.deb> は適切に動作しない。

note: type: Plain text
en: There is no authentication on B<.deb> files; in fact, there isn't even a straightforward checksum.  (Higher level tools like APT support authenticating B<.deb> packages retrieved from a given repository, and most packages nowadays provide an md5sum control file generated by debian/rules. Though this is not directly supported by the lower level tools.)
ja: B<.deb> ファイルには認証という概念がなく、単純なチェックサムすらもない (APT のような高レイヤのツールは、指定されたリポジトリから情報を収集することで B<.deb> パッケージの認証をサポートしている。また大半のパッケージは近年debian/rules によって生成される md5sum 制御ファイルを提供している。しかし、これらは低レイヤのツールが直接的にサポートしているものではない。

note: type: Plain text
en: Do not attempt to use just B<dpkg-deb> to install software! You must use B<dpkg> proper to ensure that all the files are correctly placed and the package's scripts run and its status and contents recorded.
ja: B<dpkg-deb> でソフトウェアをインストールしようとしてはいけない!すべてのファイルの適切なパスへインストール、パッケージのスクリプトの実行、ステータスや内容の記録を確実に実行するために、必ず B<dpkg> を使うこと。

note: type: Plain text
en: dpkg-divert - override a package's version of a file
ja: dpkg-divert - パッケージの提供するファイルの上書き

note: type: Plain text
en: B<dpkg-divert> is the utility used to set up and update the list of diversions.
ja: B<dpkg-divert> は、退避ファイルの一覧を設定、更新するためのユーティリティである。

note: type: Plain text
en: File I<diversions> are a way of forcing B<dpkg>(1)  not to install a file into its location, but to a I<diverted> location. Diversions can be used through the Debian package scripts to move a file away when it causes a conflict. System administrators can also use it to override some package's configuration file, or whenever some files (which aren't marked as 'conffiles') need to be preserved by dpkg, when installing a newer version of a package which contains those files.
ja: I<diversions> ファイルにより、B<dpkg>(1) はファイルを本来の場所ではなく、I<退避 (diverted) 用> の場所にインストールするようになる。diversions ファイルは、Debian パッケージスクリプトが競合を発生させるファイルを移動させるために使うことができる。システム管理者は、パッケージの提供する設定ファイルを上書きする場合や、幾つかのファイル ('conffiles' としてマークされていないもの) について、それらのファイルを含む新しいバージョンのパッケージをインストールする時に、dpkg による上書きから保護する必要がある場合にこれを使うこともできる。

note: type: Plain text
en: Add a diversion for I<file>.
ja: I<file> を退避ファイルに追加する。

note: type: Plain text
en: Remove a diversion for I<file>.
ja: I<file> を退避ファイルから削除する。

note: type: Plain text
en: List diversions matching I<glob-pattern>.
ja: I<glob-pattern> にマッチする退避ファイルの一覧を表示する。

note: type: Plain text
en: Print the name of the package that diverts I<file>.  Prints LOCAL if I<file> is locally diverted and nothing if I<file> is not diverted.
ja: I<file> を退避させているパッケージ名を表示する。I<file> がローカルに退避されている場合は LOCAL と表示される。ファイルが退避されていない場合はなにも表示されない。

note: type: Plain text
en: Print the real name for a diverted file.
ja: 退避されたファイルの実際のファイル名を表示する。

note: type: Plain text
en: Set the dpkg data directory to I<directory> (default: I</var/lib/dpkg>).
ja: dpkg データディレクトリを I<directory> (デフォルトは I</var/lib/dpkg>) に設定する。

note: type: Plain text
en: I<divert-to> is the location where the versions of I<file>, as provided by other packages, will be diverted.
ja: I<divert-to> は、他のパッケージによって提供された I<file> の退避場所である。

note: type: Plain text
en: Specifies that all packages' versions of this file are diverted.  This means, that there are no exceptions, and whatever package is installed, the file is diverted. This can be used by an admin to install a locally modified version.
ja: パッケージが提供する該当ファイルについてはすべて退避の対象とする。これは、いかなるパッケージがインストールされても、該当のファイルは退避されることを意味する。これにより、管理者が修正したファイルをローカルにインストールすることが可能となる。

note: type: Plain text
en: I<package> is the name of a package whose copy of I<file> will not be diverted. i.e. I<file> will be diverted for all packages except I<package>.
ja: I<package> は、I<file> の退避が発生しないパッケージ名である。つまり、I<package> 以外のすべてのパッケージの提供する I<file> は、退避される。

note: type: Plain text
en: Quiet mode, i.e. no verbose output.
ja: 非表示モード。冗長な出力をしない。

note: type: Plain text
en: Actually move the file aside (or back). B<dpkg-divert> will abort operation in case the destination file already exists.
ja: 実際にファイルを退避 (もしくは復帰) させる。B<dpkg-divert> は、退避 (復帰) 先のファイルが既に存在していると動作を中断する。

note: type: Plain text
en: Test mode, i.e. don't actually perform any changes, just demonstrate.
ja: テストモード。実際にはなにも実行せず、なにを実行するかを表示するだけである。

note: type: SH
en: NOTES
ja: 参考

note: type: Plain text
en: When adding, default is B<--local> and B<--divert> I<original>B<.distrib>. When removing, B<--package> or B<--local> and B<--divert> must match if specified.
ja: ファイルを追加する時のデフォルトは、B<--local> および B<--divert> I<original>B<.distrib> である。削除する時に、B<--package> もしくは B<--local> と B<--divert> が指定されていた場合は、これらの整合性がとれている必要がある。

note: type: Plain text
en: Directories can't be diverted with B<dpkg-divert>.
ja: B<dpkg-divert> でディレクトリを退避させることはできない。

note: type: Plain text
en: Care should be taken when diverting shared libraries, B<ldconfig>(8)  creates a symbolic link based on the DT_SONAME field embedded in the library.  Because ldconfig doesn't honour diverts (only dpkg does), the symlink may end up pointing at the diverted library, if a diverted library has the same SONAME as the undiverted one.
ja: 共有ライブラリを退避する場合は注意が必要である。B<ldconfig>(8) は、ライブラリに埋め込まれている DT_SONAME フィールドに基づいて、シンボリックリンクを作成する。ldconfig では退避を扱うことができない (dpkg だけができる) ため、退避したライブラリと退避していないライブラリが同じ SONAME であれば、シンボリックリンクは退避した方のライブラリを指すことになる。

note: type: Plain text
en: To divert all copies of a I</usr/bin/example> to I</usr/bin/example.foo>, i.e. directs all packages providing I</usr/bin/example> to install it as I</usr/bin/example.foo>, performing the rename if required:
ja: I</usr/bin/example> となるファイルすべてを I</usr/bin/example.foo> に退避させる、つまり、I</usr/bin/example> を提供するすべてのパッケージが、該当ファイルを I</usr/bin/example.foo> にリネームしてインストールするようにさせる:

note: type: Plain text
en: To remove that diversion:
ja: 該当の退避ファイルを削除する。

note: type: Plain text
en: To divert any package trying to install I</usr/bin/example> to I</usr/bin/example.foo>, except your own I<wibble> package:
ja: I</usr/bin/example> をインストールしようとするすべてのパッケージを I</usr/bin/example.foo> に退避させる。ただし、自作の I<wibble> パッケージを除く:

note: type: Plain text
en: If set and the B<--admindir> option has not been specified, it will be used as the dpkg data directory.
ja: B<--admindir> オプションが設定されておらず、この変数が設定されている場合、この変数の値が dpkg データディレクトリとして用いられる。

note: type: Plain text
en: If set and the B<--local> and B<--package> options have not been specified, B<dpkg-divert> will use it as the package name.
ja: B<--local> および B<--package> オプションが設定されておらず、この変数が設定されている場合、B<dpkg-divert> は、この変数の値をパッケージ名として使用する。

note: type: Plain text
en: File which contains the current list of diversions of the system. It is located in the dpkg administration directory, along with other files important to dpkg, such as I<status> or I<available>.
ja: システムの現在の退避ファイルの一覧を含むファイル。これは dpkg にとって重要なファイルである I<status> や I<available> とともに、dpkg の管理ディレクトリに存在する。

note: type: Plain text
en: Note: B<dpkg-divert> preserves the old copy of this file, with extension I<-old>, before replacing it with the new one.
ja: 注記: B<dpkg-divert> は、このファイルを更新する時に古いバージョンを I<-old> という拡張子をつけたファイルにコピーして保存する。

note: type: Plain text
en: dpkg-genchanges - generate Debian .changes files
ja: dpkg-genchanges - Debian .changes ファイルの生成

note: type: Plain text
en: B<dpkg-genchanges> reads information from an unpacked and built Debian source tree and from the files it has generated and generates a Debian upload control file (B<.changes> file).
ja: B<dpkg-genchanges> は展開されてビルドされた Debian ソースツリーおよび生成されたファイルから情報を読み取り、Debian アップロード制御ファイル (B<.changes> ファイル) を生成する。

note: type: Plain text
en: Specifies that a binary-only build is taking place (no source files are to be included). There's no distinction between B<-b>, B<-B> and B<-A>, the produced B<.changes> file will include whatever files were created by the B<binary-*> target(s) of the package being built.
ja: バイナリのみのビルドが実行された (ソースファイルが含まれていない) ことを指定する。B<-b>, B<-B>, B<-A> に差異はなく、生成された B<.changes> ファイルには、ビルドされたパッケージの B<binary-*> ターゲットによって生成されたすべてのファイルが含まれる。

note: type: Plain text
en: Specifies that only the source should be uploaded (no binary packages will be included).
ja: ソースのみがアップロードされる (バイナリパッケージは含まれていないこと) を指定する。

note: type: Plain text
en: The B<-s>I<x> options control whether the original source archive is included in the upload if any source is being generated (i.e.  B<-b> or B<-B> haven't been used).
ja: B<-s>I<x> オプションは、(B<-b>, B<-B> が使われておらず) 何らかのソースが生成された場合に、オリジナルのソースアーカイブがアップロードに含まれるかどうかを決定する。

note: type: Plain text
en: By default, or if specified, the original source will be included only if the upstream version number (the version without epoch and without Debian revision) differs from the upstream version number of the previous changelog entry.
ja: デフォルト、もしくは明示的にこのオプションが指定された場合は、アップストリームのバージョン番号 (epoch および Debian リビジョンを含まない) が以前の changelog エントリに記録されたアップストリームのバージョン番号と異なる場合にのみ、オリジナルのソースが含まれる。

note: type: Plain text
en: Forces the inclusion of the original source.
ja: 強制的にオリジナルのソースを含める。

note: type: Plain text
en: Forces the exclusion of the original source and includes only the diff.
ja: 強制的にオリジナルのソースを除外し、差分情報のみを含める。

note: type: Plain text
en: Causes changelog information from all versions strictly later than I<version> to be used.
ja: I<version> 以降のバージョンすべてから changelog 情報を生成する。

note: type: Plain text
en: Read the description of the changes from the file I<changes-description> rather than using the information from the source tree's changelog file.
ja: ソースツリーの changelog ファイルからの情報ではなく、I<changes-description> ファイルにある変更点の情報を使用する。

note: type: Plain text
en: Use I<maintainer-address> as the name and email address of the maintainer for this package, rather than using the information from the source tree's control file.
ja: ソースツリーの control ファイルからの情報ではなく、I<maintainer-address> で指定した情報を、このパッケージのメンテナの名前とメールアドレスとして使用する。

note: type: Plain text
en: Use I<maintainer-address> as the name and email address of the maintainer for this upload, rather than using the information from the source tree's changelog.
ja: ソースツリーの changelog ファイルからの情報ではなく、I<maintainer-address> で指定した情報を、今回のアップロードのメンテナの名前とメールアドレスとして使用する。

note: type: Plain text
en: Set an output substitution variable.  See B<deb-substvars>(5) for a discussion of output substitution.
ja: 変数を設定する。出力時の置換に関する詳細は、B<deb-substvars>(5) を参照のこと。

note: type: Plain text
en: Read substitution variables in I<substvars-file>; the default is B<debian/substvars>.  No variable substitution is done on any of the fields that are output, however the special variable I<Format> will override the field of the same name. This option can be used multiple times to read substitution variables from multiple files.
ja: 変数の設定を I<substvars-file> から読み取る。デフォルトは B<debian/substvars> である。出力フィールドについては、変数置換は行われない。ただし、特別な変数である I<Format> については、同じ名称のフィールドを上書きする。このオプションを複数回設定することで、複数のファイルから変数置換の設定を読み取ることができる。

note: type: Plain text
en: Override or add an output control file field.
ja: 出力制御ファイルのフィールドを上書きもしくは追加する。

note: type: Plain text
en: Remove an output control file field.
ja: 出力制御ファイルのフィールドを削除する。

note: type: Plain text
en: Specifies the main source control file to read information from. The default is B<debian/control>.
ja: 情報の読み取り元となる主なソース制御ファイルを指定する。デフォルトは B<debian/control>。

note: type: Plain text
en: Specifies the changelog file to read information from. The default is B<debian/changelog>.
ja: 情報の読み取り元となる changelog ファイルを指定する。デフォルトは B<debian/changelog>。

note: type: Plain text
en: Read the list of files to be uploaded here, rather than using B<debian/files>.
ja: B<debian/files> の代わりに、アップロードされるファイルの一覧を読み取るファイルを指定する。

note: type: Plain text
en: Specifies the format of the changelog. See B<dpkg-parsechangelog>(1)  for information about alternative formats.
ja: changelog ファイルのフォーマットを指定する。指定可能なフォーマットについての情報は、B<dpkg-parsechangelog>(1) を参照のこと。

note: type: Plain text
en: Look for the files to be uploaded in I<upload-files-dir> rather than B<..> (B<dpkg-genchanges> needs to find these files so that it can include their sizes and checksums in the B<.changes> file).
ja: アップロード対象となるファイルを、B<..> ではなく I<upload-files-dir> から探し出す (B<dpkg-genchanges> は B<.changes> ファイルにファイルサイズとチェックサムを含めるため、対象となるファイルを確認する必要がある)。

note: type: Plain text
en: Usually B<dpkg-genchanges> will produce informative messages on standard error, for example about how many of the package's source files are being uploaded.  B<-q> suppresses these messages.
ja: 通常、B<dpkg-genchanges> は標準エラー出力に対して、アップロードされたパッケージに含まれるソースファイルの数といった有用なメッセージを出力する。B<-q> により、こうしたメッセージの出力が抑止される。

note: type: Plain text
en: The list of generated files which are part of the upload being prepared.  B<dpkg-genchanges> reads the data here when producing a B<.changes> file.
ja: アップロードの準備の一部をなす、生成されたファイルのリスト。B<dpkg-genchanges> は B<.changes> ファイルを生成する際の情報をここから読み取る。

note: type: Plain text
en: dpkg-gencontrol - generate Debian control files
ja: dpkg-gencontrol - Debian 制御ファイルの生成

note: type: Plain text
en: B<dpkg-gencontrol> reads information from an unpacked Debian source tree and generates a binary package control file (which defaults to debian/tmp/DEBIAN/control); during this process it will simplify the relation fields.
ja: B<dpkg-gencontrol> は展開された Debian ソースツリーから情報を読み取り、バイナリパッケージの control ファイル (デフォルトでは debian/tmp/DEBIAN/control) を生成する。生成の過程で、関連するフィールドの単純化も行う。

note: type: Plain text
en: Thus I<Pre-Depends>, I<Depends>, I<Recommends> and I<Suggests> are simplified in this order by removing dependencies which are known to be true according to the stronger dependencies already parsed. It will also remove any self-dependency (in fact it will remove any dependency which evaluates to true given the current version of the package as installed). Logically it keeps the intersection of multiple dependencies on the same package. The order of dependencies is preserved as best as possible: if any dependency must be discarded due to another dependency appearing further in the field, the superseding dependency will take the place of the discarded one.
ja: I<Pre-Depends>, I<Depends>, I<Recommends>, I<Suggests> については、より包括的な依存関係が既に確認されているため認識済の依存関係を削除することで、順に単純化が行われる。自己依存についても同様に削除される (実際には、パッケージの現在のバージョンがインストールされていれば満たされる依存関係が削除される)。論理的に、同じパッケージが複数の依存関係に共通に含まれている場合は、論理的に維持される。依存関係の順序は可能な限り維持される。あるフィールドにおいて、ある依存関係が後続の別の依存関係により破棄される場合、代替となる後続の依存関係は、破棄された依存関係の位置に挿入される。

note: type: Plain text
en: The other relation fields (I<Enhances>, I<Conflicts>, I<Breaks>, I<Replaces> and I<Provides>)  are also simplified individually by computing the union of the various dependencies when a package is listed multiple times in the field.
ja: その他の依存関係のフィールド (I<Enhances>, I<Conflicts>, I<Breaks>, I<Replaces>, I<Provides>) についても、フィールド内に同一のパッケージが複数回記載されている場合は、依存関係の統合可否を計算することで、各々に単純化される。

note: type: Plain text
en: B<dpkg-gencontrol> also adds an entry for the binary package to B<debian/files>.
ja: B<dpkg-gencontrol> は B<debian/files> へのバイナリパッケージのエントリ追加も行う。

note: type: Plain text
en: Sets the version number of the binary package which will be generated.
ja: 生成されるバイナリパッケージのバージョン番号を設定する。

note: type: Plain text
en: Set an output substitution variable. See B<deb-substvars>(5) for discussion of output substitution.
ja: 変数を設定する。出力時の置換に関する詳細は、B<deb-substvars>(5) を参照のこと。

note: type: Plain text
en: Read substitution variables in I<substvars-file>; the default is B<debian/substvars>.  This option can be used multiple times to read substitution variables from multiple files.
ja: 変数の設定を I<substvars-file> から読み取る。デフォルトは B<debian/substvars> である。このオプションを複数回設定することで、複数のファイルから変数置換の設定を読み取ることができる。

note: type: Plain text
en: Generate information for the binary package I<package>.  If the source control file lists only one binary package then this option may be omitted; otherwise it is essential to select which binary package's information to generate.
ja: バイナリパッケージ I<package> の情報を生成する。ソース制御ファイルに単一のバイナリパッケージだけが記載されていた場合、このオプションは省略してもよい。それ以外の場合は、どのバイナリパッケージの情報を生成するかを選択する上で、このオプションが不可欠である。

note: type: Plain text
en: Assume the filename of the package will be I<filename> instead of the normal package_version_arch.deb filename.
ja: 通常の package_version_arch.deb というファイル名ではなく、パッケージのファイル名を I<filename> とする。

note: type: Plain text
en: These options are ignored for compatibility with older versions of dpkg-dev but are now deprecated. Previously they were used to tell dpkg-gencontrol to include the Section and Priority fields in the control file. This is now the default behaviour. If you want to get the old behaviour you can use the B<-U> option to delete the fields from the control file.
ja: これらのオプションは dpkg-dev の古いバージョンとの互換性のために残されているが、現在は廃止予定となっており無視される。これらは、以前のバージョンにおいて dpkg-gencontrol が control ファイルの Section と Priority フィールドを含めるよう設定するために用いられた。現在、この動作はデフォルトとなっている。以前の挙動をさせたい場合は、B<-U> オプションを用いて、これらのフィールドをcontrol ファイルから削除すること。

note: type: Plain text
en: Tells B<dpkg-source> that the package is being built in I<package-build-dir> instead of B<debian/tmp>.  This value is used to find the default value of the B<Installed-Size> substitution variable and control file field (using B<du>), and for the default location of the output file.
ja: B<dpkg-source> に対して、パッケージを B<debian/tmp> ではなく I<package-build-dir> 内でビルドするように設定する。この値は B<Installed-Size> 変数や制御ファイルフィールドの値のデフォルト値を (B<du> を用いて) 算出する際に用いられる他、出力ファイルのデフォルトの場所としても用いられる。

note: type: Plain text
en: Print the control file to standard output, rather than to B<debian/tmp/DEBIAN/control> (or I<package-build-dir>B</DEBIAN/control> if B<-P> was used).
ja: control ファイルの内容を B<debian/tmp/DEBIAN/control> (B<-P> が指定されている場合は、I<package-build-dir>B</DEBIAN/control>) ではなく標準出力に出力する。

note: type: Plain text
en: The main source control information file, giving version-independent information about the source package and the binary packages it can produce.
ja: 主たるソース制御情報ファイルであり、生成可能なソースパッケージおよびバイナリパッケージに関するバージョン非依存の情報を提供する。

note: type: Plain text
en: The list of generated files which are part of the upload being prepared.  B<dpkg-gencontrol> adds the presumed filenames of binary packages whose control files it generates here.
ja: アップロードの準備の一部をなす、生成されたファイルのリスト。B<dpkg-gencontrol> は、制御ファイルを生成したバイナリパッケージのファイル名を追加する。

note: type: Plain text
en: dpkg-gensymbols - generate symbols files (shared library dependency information)
ja: dpkg-gensymbols - シンボルファイル (共有ライブラリの依存情報) の生成

note: type: Plain text
en: B<dpkg-gensymbols> scans a temporary build tree (debian/tmp by default) looking for libraries and generates a I<symbols> file describing them. This file, if non-empty, is then installed in the DEBIAN subdirectory of the build tree so that it ends up included in the control information of the package.
ja: B<dpkg-gensymbols> は一時的なビルドツリー (デフォルトでは debian/tmp) 以下にあるライブラリを探しだし、それらの情報を記載した I<symbols> ファイルを生成する。このファイルが空でない場合、ファイルはビルドツリーの DEBIAN サブディレクトリにインストールされ、最終的にパッケージの制御情報ファイルに含まれる。

note: type: Plain text
en: When generating those files, it uses as input some symbols files provided by the maintainer. It looks for the following files (and uses the first that is found):
ja: これらのファイルの生成の際には、入力情報として、メンテナによって提供されるシンボルファイルが用いられる。シンボルファイルとして、以下のファイルが確認される (最初に見つかったファイルが用いられる):

note: type: Plain text
en: The main interest of those files is to provide the minimal version associated to each symbol provided by the libraries. Usually it corresponds to the first version of that package that provided the symbol, but it can be manually incremented by the maintainer if the ABI of the symbol is extended without breaking backwards compatibility. It's the responsibility of the maintainer to keep those files up-to-date and accurate, but B<dpkg-gensymbols> helps him.
ja: これらのファイルの主要な目的は、ライブラリが提供する各シンボルに対応づけられた最小バージョンの情報を提供することである。通常、これはシンボルを提供するパッケージの最初のバージョンに一致するが、シンボルの ABI が後方互換性を損なわずに拡張可能であれば、メンテナによって手動で増加させることも可能である。これらのファイルを更新して維持するのはメンテナの責任であるが、B<dpkg-gensymbols> も役に立つ。

note: type: Plain text
en: When the generated symbols files differ from the maintainer supplied one, B<dpkg-gensymbols> will print a diff between the two versions.  Furthermore if the difference is too significant, it will even fail (you can customize how much difference you can tolerate, see the B<-c> option).
ja: 生成されたシンボルファイルがメンテナが提供するものと異なっていた場合、B<dpkg-gensymbols> は双方の差分を表示する。相違点が大量の場合は、処理を失敗させる (どの程度の量を大量と見なすかについては調整可能である。B<-c> オプションを参照のこと)。

note: type: SH
en: MAINTAINING SYMBOLS FILES
ja: シンボルファイルのメンテナンス

note: type: Plain text
en: The symbols files are really useful only if they reflect the evolution of the package through several releases. Thus the maintainer has to update them every time that a new symbol is added so that its associated minimal version matches reality. To do this properly he can use the diffs contained in the build logs. In most cases, the diff applies directly to his debian/I<package>.symbols file. That said, further tweaks are usually needed: it's recommended for example to drop the Debian revision from the minimal version so that backports with a lower version number but the same upstream version still satisfy the generated dependencies.  If the Debian revision can't be dropped because the symbol really got added by the Debian specific change, then one should suffix the version with "~".
ja: シンボルファイルは、リリースを重ねることによるパッケージの進化に追従してこそ、はじめて有益なものとなる。つまり、メンテナは新しいシンボルが追加される度にファイルを更新し、これにより関連付けられた最小のバージョンを実態に即したものとする必要がある。この作業を適切に行うために、ビルドのログに含まれる差分情報を使用することができる。大半の場合、差分情報は直接 debian/I<package>.symbols ファイルに適用することができる。しかしながら、通常は更に細かい調整が必要となる。例えば最小バージョンから Debian リビジョンを削除することにより、アップストリームのバージョンが同一だが、バックポートにはより小さいバージョン番号が付与されているケースでも、生成された依存関係を満たすことができる。シンボルが Debian 固有の変更により追加されたものであり、Debian リビジョンを削除することができない場合は、バージョンに続く "~" の後に記載する。

note: type: Plain text
en: Before applying any patch to the symbols file, the maintainer should double-check that it's sane. Public symbols are not supposed to disappear, so the patch should ideally only add new lines.
ja: シンボルファイルに何らかのパッチを適用する前に、メンテナは本当にそれが必要かどうかを再度確認すること。公開シンボルが削除されることは想定されていないため、パッチは新しい行を追加するだけに留めるのが理想である。

note: type: Plain text
en: Note that you can put comments in symbols files: any line with '#' as the first character is a comment except if it starts with '#include' (see section B<Using includes>). Lines starting with '#MISSING:' are special comments documenting symbols that have disappeared.
ja: シンボルファイルにコメントを記載することもできる。'#' から始まる行は'#include' (B<Using includes> セクションを参照) から始まる場合をのぞき、コメントと見なされる。'#MISSING:' から始まる行は、なくなったシンボルについて記載された特別なコメントを意味する。

note: type: SS
en: Using #PACKAGE# substitution
ja: #PACKAGE# 置換の使用

note: type: Plain text
en: In some rare cases, the name of the library varies between architectures.  To avoid hardcoding the name of the package in the symbols file, you can use the marker I<#PACKAGE#>. It will be replaced by the real package name during installation of the symbols files. Contrary to the I<#MINVER#> marker, I<#PACKAGE#> will never appear in a symbols file inside a binary package.
ja: 稀ではあるが、アーキテクチャによってライブラリ名が異なる場合がある。シンボルファイルにパッケージ名をハードコードすることを避けるため、I<#PACKAGE#> マークを使用することができる。これはシンボルファイルのインストール時に実際のパッケージ名に置換される。I<#MINVER#> マークと異なり、I<#PACKAGE#> がバイナリパッケージ内のシンボルファイルに現れることは決してない。

note: type: SS
en: Using symbol tags
ja: シンボルタグの使用

note: type: Plain text
en: Symbol tagging is useful for marking symbols that are special in some way.  Any symbol can have an arbitrary number of tags associated with it. While all tags are parsed and stored, only a some of them are understood by B<dpkg-gensymbols> and trigger special handling of the symbols. See subsection B<Standard symbol tags> for reference of these tags.
ja: シンボルタグは何らかの意味で特別なシンボルを識別する際に有用である。シンボルには任意の数のタグを関連付けることができる。すべてのタグが解析されて保存されるが、B<dpkg-gensymbols> が認識し、シンボルに対して特殊な扱いを行うものは、その一部のみである。これらのタグについての詳細は、B<標準シンボルタグ> サブセクションを参照のこと。

note: type: Plain text
en: Tag specification comes right before the symbol name (no whitespace is allowed in between). It always starts with an opening bracket B<(>, ends with a closing bracket B<)> and must contain at least one tag. Multiple tags are separated by the B<|> character. Each tag can optionally have a value which is separated form the tag name by the B<=> character. Tag names and values can be arbitrary strings except they cannot contain any of the special B<)> B<|> B<=> characters. Symbol names following a tag specification can optionally be quoted with either B<'> or B<"> characters to allow whitespaces in them. However, if there are no tags specified for the symbol, quotes are treated as part of the symbol name which continues up until the first space.
ja: タグはシンボル名の前に設置され (空白文字を間にいれることはできない)、B<(> から始まりB<)> で終わり、間に最低 1 つのタグを記載する必要がある。複数のタグは B<|> 文字で区切る。各タグには、タグ名との間を B<=> 文字で区切った形式で値を設定することもできる。タグ名と値には、特別な文字 B<)> B<|> B<=> を除き、任意の文字を含めることができる。タグに続くシンボル名には、B<'> もしくは B<"> 文字でクオートすることで、空白文字を含めることができる。ただし、シンボルにタグが設定されていなかった場合、クオートはシンボル名の一部と見なされ、最初のスペースまでがシンボル名と認識される。

note: type: Plain text
en: The first symbol in the example is named I<tagged quoted symbol> and has two tags: I<tag1> with value I<i am marked> and I<tag name with space> that has no value. The second symbol named I<tagged_unquoted_symbol> is only tagged with the tag named I<optional>. The last symbol is an example of the normal untagged symbol.
ja: 設定例の 1 番目のシンボルは I<tagged quoted symbol> という名前であり、I<i am marked> という値を持つ I<tag1> というタグと I<tag name with space> という値を持たないタグの 2 つが設定されている。2 番目のシンボルは I<tagged_unquoted_symbol> という名前で I<optional> という名前のタグが設定されている。最後のシンボルは一般的なタグのないシンボルの例である。

note: type: Plain text
en: Since symbol tags are an extension of the I<deb-symbols(5)> format, they can only be part of the symbols files used in source packages (those files should then be seen as templates used to build the symbols files that are embedded in binary packages). When B<dpkg-gensymbols> is called without the I<-t> option, it will output symbols files compatible to the I<deb-symbols(5)> format: it fully processes symbols according to the requirements of their standard tags and strips all tags from the output. On the contrary, in template mode (I<-t>) all symbols and their tags (both standard and unknown ones)  are kept in the output and are written in their original form as they were loaded.
ja: シンボルタグは I<deb-symbols(5)> 形式の拡張であるため、これらは、ソースパッケージで用いられるシンボルファイルの一部分として扱う必要がある (これらのファイルはバイナリパッケージに埋め込まれるシンボルファイルをビルドするために使われるテンプレートとして扱われる)。B<dpkg-gensymbols> が I<-t> オプションなしで呼び出された場合は、I<deb-symbols(5)> 形式と互換性のあるシンボルファイルを出力する。標準タグの制約に則ってシンボルの処理を完全に行い、出力からすべてのタグを削除する。一方、テンプレートモード (I<-t>) の場合、シンボルのすべてとタグ (標準のものもそれ以外のものも) が出力でも保持され、読み取られた時の元々の形式で書き込まれる。

note: type: SS
en: Standard symbol tags
ja: 標準シンボルタグ

note: type: Plain text
en: A symbol marked as optional can disappear from the library at any time and that will never cause B<dpkg-gensymbols> to fail. However, disappeared optional symbols will continuously appear as MISSING in the diff in each new package revision.  This behaviour serves as a reminder for the maintainer that such a symbol needs to be removed from the symbol file or readded to the library. When the optional symbol, which was previously declared as MISSING, suddenly reappears in the next revision, it will be upgraded back to the "existing" status with its minimum version unchanged.
ja: optional とマークされたシンボルはいつでもライブラリから削除することができる。削除によって B<dpkg-gensymbols> に失敗することは決してない。ただし、削除された optional のシンボルは、新しいパッケージのリビジョン各々において、差分情報内に MISSING として残り続ける。この挙動は、メンテナに対して、このシンボルをシンボルファイルから削除するか、再度ライブラリに追加する必要があることを通知するために行われる。以前に MISSING として宣言していた optional シンボルが突然次のリビジョンで復活した場合は、最小バージョンを変更せずに "existing" ステータスに戻される。

note: type: Plain text
en: This tag is useful for symbols which are private where their disappearance do not cause ABI breakage. For example, most of C++ template instantiations fall into this category. Like any other tag, this one may also have an arbitrary value: it could be used to indicate why the symbol is considered optional.
ja: このタグはシンボルの削除が ABI の互換性を損なわないようなプライベートなシンボルに有用である。例えば、C++ テンプレートのインスタンス化の多くがこれに分類される。その他のタグと同様、このタグには任意の値を設定することができる。これはシンボルが optional と見なされる理由を示すために使用することができる。

note: type: Plain text
en: This tag allows one to restrict the set of architectures where the symbol is supposed to exist. When the symbols list is updated with the symbols discovered in the library, all arch-specific symbols which do not concern the current host architecture are treated as if they did not exist. If an arch-specific symbol matching the current host architecture does not exist in the library, normal procedures for missing symbols apply and it may cause B<dpkg-gensymbols> to fail. On the other hand, if the arch-specific symbol is found when it was not supposed to exist (because the current host architecture is not listed in the tag), it is made arch neutral (i.e. the arch tag is dropped and the symbol will appear in the diff due to this change), but it is not considered as new.
ja: このタグにより、シンボルが存在しているはずのアーキテクチャを限定することが可能になる。ライブラリで発見されたシンボルにより、シンボルのリストが更新された際にも、現在のホストのアーキテクチャに関連しないアーキテクチャに固有のシンボルは、存在していないものとして扱われる。現在のホストのアーキテクチャに関連するアーキテクチャに固有のシンボルがライブラリに存在していない場合は、シンボルが存在しない場合の通常の処理が行われ、おそらくは、B<dpkg-gensymbols> の停止を引き起こすことになるだろう。一方、アーキテクチャ依存のシンボルが存在している場合に、存在しているはずだとされていない場合 (現在のホストのアーキテクチャがタグに記載されていない場合) は、アーキテクチャ非依存として扱われる (アーキテクチャのタグの削除という変更が行われるため、シンボルは差分情報として現れる) が、新しいシンボルとしては扱われない。

note: type: Plain text
en: When operating in the default non-template mode, among arch-specific symbols only those that match the current host architecture are written to the symbols file. On the contrary, all arch-specific symbols (including those from foreign arches) are always written to the symbol file when operating in template mode.
ja: デフォルトの非テンプレートモードで動作する際には、アーキテクチャ固有のシンボルの中で、現在のホストのアーキテクチャに合致するもののみがシンボルファイルに書き込まれる。一方、テンプレートモードで動作している場合は、アーキテクチャ固有のシンボルのすべて (異なるアーキテクチャのものも含む) がシンボルファイルに書き込まれる。

note: type: Plain text
en: The format of I<architecture list> is the same as the one used in the I<Build-Depends> field of I<debian/control> (except the enclosing square brackets []). For example, the first symbol from the list below will be considered only on alpha, any-amd64 and ia64 architectures, the second only on linux architectures, while the third one anywhere except on armel.
ja: I<architecture list> の形式は、(ブラケット [] を除き) I<debian/control> における I<Build-Depends> フィールドと同じ書式である。下の例における、最初のシンボルは、alpha, any-amd64, ia64 アーキテクチャのいずれかであることを示し、2 番目は Linux アーキテクチャを、3 番目は armel 以外のすべてを示す。

note: type: Plain text
en: dpkg-gensymbols has an internal blacklist of symbols that should not appear in symbols files as they are usually only side-effects of implementation details of the toolchain. If for some reason, you really want one of those symbols to be included in the symbols file, you should tag the symbol with B<ignore-blacklist>. It can be necessary for some low level toolchain libraries like libgcc.
ja: dpkg-gensymbols は、ツールチェインの詳細な実装の副作用以外では通常存在しないため、シンボルファイル中に存在すべきではないシンボルからなる内部的なブラックリストを持っている。なんらかの理由により、シンボルファイルにこうしたシンボルの一つを本気で加えたい場合は、B<ignore-blacklist> タグをシンボルに付ける必要がある。これは、 libgcc のような低レベルなツールチェインのライブラリの一部で必要な場合がある。

note: type: Plain text
en: Denotes I<c++> symbol pattern. See B<Using symbol patterns> subsection below.
ja: I<c++> シンボルパターンを示す。以下の B<シンボルパターンの使用> サブセクションも参照のこと。

note: type: Plain text
en: Denotes I<symver> (symbol version) symbol pattern. See B<Using symbol patterns> subsection below.
ja: I<symver> (シンボルバージョン) シンボルパターンを示す。以下の B<シンボルパターンの使用> サブセクションも参照のこと。

note: type: Plain text
en: Denotes I<regex> symbol pattern. See B<Using symbol patterns> subsection below.
ja: I<regex> シンボルパターンを示す。以下の B<シンボルパターンの使用> サブセクションも参照のこと。

note: type: SS
en: Using symbol patterns
ja: シンボルパターンの使用

note: type: Plain text
en: Unlike a standard symbol specification, a pattern may cover multiple real symbols from the library. B<dpkg-gensymbols> will attempt to match each pattern against each real symbol that does I<not> have a specific symbol counterpart defined in the symbol file. Whenever the first matching pattern is found, all its tags and properties will be used as a basis specification of the symbol. If none of the patterns matches, the symbol will be considered as new.
ja: 標準シンボルと異なり、パターンにはライブラリがエクスポートする複数の実シンボルが含まれうる。B<dpkg-gensymbols> は、シンボルファイルによって特定のシンボルと関連付けられてI<いない>各実シンボルについて、パターンとのマッチングを行う。最初にパターンにマッチした時点で、シンボルの基本的な機能として、パターンのタグおよび属性が用いられる。パターンにマッチしなかった場合、そのシンボルは新しいシンボルと見なされる。

note: type: Plain text
en: A pattern is considered lost if it does not match any symbol in the library. By default this will trigger a B<dpkg-gensymbols> failure under I<-c1> or higher level. However, if the failure is undesired, the pattern may be marked with the I<optional> tag. Then if the pattern does not match anything, it will only appear in the diff as MISSING. Moreover, like any symbol, the pattern may be limited to the specific architectures with the I<arch> tag. Please refer to B<Standard symbol tags> subsection above for more information.
ja: ライブラリ内のシンボルと一切マッチしなかったパターンは、消失したと見なされる。これは、I<-c1> 以上のレベルを指定していた場合、デフォルトで B<dpkg-gensymbols> の停止を引き起こす。停止させたくない場合は、パターンにI<optional> タグを付加することもできる。その場合、パターンが一切マッチしなかった場合でも、差分情報で MISSING 扱いとなるだけになる。また、他のシンボルと同様、パターンに対しても I<arch> タグにより対象のアーキテクチャを限定することが可能である。これに関する詳細な情報は、前述の B<標準シンボルタグ> サブセクションを参照のこと。

note: type: Plain text
en: Patterns are an extension of the I<deb-symbols(5)> format hence they are only valid in symbol file templates. Pattern specification syntax is not any different from the one of a specific symbol. However, symbol name part of the specification serves as an expression to be matched against I<name@version> of the real symbol. In order to distinguish among different pattern types, a pattern will typically be tagged with a special tag.
ja: パターンは I<deb-symbols(5)> を拡張した形式であるため、シンボルファイルのテンプレートでのみ有効である。パターン定義の文法はシンボル定義のものとまったく変わらない。ただし、シンボル名の部分は、実シンボルのI<name@version> 部分にマッチするような表現になっている。パターンのタイプを判別するために、通常パターンには特別なタグが付けられている。

note: type: Plain text
en: At the moment, B<dpkg-gensymbols> supports three basic pattern types:
ja: 現在のところ、B<dpkg-gensymbols> は 3 つの基本的なパターンタイプをサポートしている:

note: type: Plain text
en: This pattern is denoted by the I<c++> tag. It matches only C++ symbols by their demangled symbol name (as emitted by B<c++filt>(1) utility). This pattern is very handy for matching symbols which mangled names might vary across different architectures while their demangled names remain the same. One group of such symbols is I<non-virtual thunks> which have architecture specific offsets embedded in their mangled names. A common instance of this case is a virtual destructor which under diamond inheritance needs a non-virtual thunk symbol. For example, even if _ZThn8_N3NSB6ClassDD1Ev@Base on 32bit architectures will probably be _ZThn16_N3NSB6ClassDD1Ev@Base on 64bit ones, it can be matched with a single I<c++> pattern:
ja: このパターンは I<c++> タグを示す。これは (B<c++filt>(1) ユーティリティによって出力された) デコードされた (demangled) シンボル名による C++ シンボルにのみマッチする。このパターンは、デコードされた名前は同一であるが、エンコードされたシンボル名がアーキテクチャによってばらばらであるようなシンボルにマッチさせたい場合に非常に有用である。こうしたシンボルの一つのグループが、I<non-virtual thunks> と呼ばれるもので、エンコードされた名前にアーキテクチャ依存のオフセットが埋め込まれるシンボルである。このパターンの実例として、ダイアモンド継承において、仮想継承でないサンクシンボルを必要とする仮想デストラクタが挙げられる。32 ビットアーキテクチャ上で _ZThn8_N3NSB6ClassDD1Ev@Base となるシンボルが 64 ビットでは _ZThn16_N3NSB6ClassDD1Ev@Base となってしまう場合であっても、これらを単一の I<c++> パターンでマッチさせることができる。

note: type: Plain text
en: The demangled name above can be obtained by executing the following command:
ja: 上記のデコードされた名前は、以下のコマンドを実行することで取得できる:

note: type: Plain text
en: Please note that while mangled name is unique in the library by definition, this is not necessarily true for demangled names. A couple of distinct real symbols may have the same demangled name. For example, that's the case with non-virtual thunk symbols in complex inheritance configurations or with most constructors and destructors (since g++ typically generates two real symbols for them). However, as these collisions happen on the ABI level, they should not degrade quality of the symbol file.
ja: エンコードされた名前がライブラリ内で一意に定義されていた場合であっても、デコードされた名前が一位である必要はない。幾つかの実シンボルのデコードされた名前が同じである場合もある。これは、例えば仮想継承でないサンクシンボルに複雑な継承の設定が行われている場合や、大半のコンストラクタとデストラクタについて言える (ただし、g++ は、これらに対して通常 2 つの実シンボルを生成する)。ただし、こうした衝突は ABI レベルで発生しているものであり、シンボルファイルの品質を低下させるものではない。

note: type: Plain text
en: This pattern is denoted by the I<symver> tag. Well maintained libraries have versioned symbols where each version corresponds to the upstream version where the symbol got added. If that's the case, you can use a I<symver> pattern to match any symbol associated to the specific version. For example:
ja: このパターンは、I<symver> タグを示す。きちんとメンテナンスされているライブラリでは、シンボルがバージョン管理されており、各バージョンがシンボルの追加されたアップストリームのバージョンに対応付けられている。この場合、I<symver> パターンを使用することで、特定のバージョンに対応付けられた任意のシンボルにマッチさせることが可能である。以下に例を示す:

note: type: Plain text
en: All symbols associated with versions GLIBC_2.0 and GLIBC_2.7 will lead to minimal version of 2.0 and 2.7 respectively with the exception of the symbol access@GLIBC_2.0. The latter will lead to a minimal dependency on libc6 version 2.2 despite being in the scope of the "(symver)GLIBC_2.0" pattern because specific symbols take precedence over patterns.
ja: GLIBC_2.0 および GLIBC_2.7 のバージョンに対応付けられたすべてのシンボルは、access@GLIBC_2.0 シンボルを除き、最低バージョンが各々 2.0 および 2.7 となる。後者は、"(symver)GLIBC_2.0" パターンにマッチするが、libc6 バージョン 2.2 が最低限の依存関係となる。これは、シンボルの指定がパターンによるマッチより優先されるためである。

note: type: Plain text
en: Please note that while old style wildcard patterns (denoted by "*@version" in the symbol name field) are still supported, they have been deprecated by new style syntax "(symver|optional)version". For example, "*@GLIBC_2.0 2.0" should be written as "(symver|optional)GLIBC_2.0 2.0" if the same behaviour is needed.
ja: 古い形式のワイルドカードのパターン (シンボル名フィールドで "*@version" を指定) は、"(symver|optional)version" は、まだサポートされているが、廃止予定となっている点に留意すること。例えば、"*@GLIBC_2.0 2.0" という表記は、同じ動作をさせたいのであれば、"(symver|optional)GLIBC_2.0 2.0" に修正すべきである。

note: type: Plain text
en: Regular expression patterns are denoted by the I<regex> tag. They match by the perl regular expression specified in the symbol name field. A regular expression is matched as it is, therefore do not forget to start it with the I<^> character or it may match any part of the real symbol I<name@version> string. For example:
ja: 正規表現パターンは I<regex> タグで指定される。これは、シンボル名フィールドで指定された perl 形式の正規表現にマッチする。正規表現であるため、I<^> 文字から始めることを忘れないこと、さもなくば、実シンボル I<name@version> の任意の部分にマッチする可能性がある。以下に例を示す:

note: type: Plain text
en: Symbols like "mystack_new@Base", "mystack_push@Base", "mystack_pop@Base" etc.  will be matched by the first pattern while e.g. "ng_mystack_new@Base" won't.  The second pattern will match all symbols having the string "private" in their names and matches will inherit I<optional> tag from the pattern.
ja: 1 番目のパターンには、"mystack_new@Base", "mystack_push@Base", "mystack_pop@Base" のようなシンボルがマッチするが、"ng_mystack_new@Base" はマッチしない。2 番目のパターンには、"private" という文字列を含む名前のすべてのシンボルにマッチし、マッチしたシンボル名が I<optional> タグに引き継がれる。

note: type: Plain text
en: Basic patterns listed above can be combined where it makes sense. In that case, they are processed in the order in which the tags are specified. For example, both
ja: 前述した基本的なパターンは、整合性がとれる限り複合して用いてもよい。その場合、パターンはタグで指定された順に処理される。以下の例において、

note: type: Plain text
en: will match symbols "_ZN3NSA6ClassA7Private11privmethod1Ei@Base" and "_ZN3NSA6ClassA7Private11privmethod2Ei@Base". When matching the first pattern, the raw symbol is first demangled as C++ symbol, then the demangled name is matched against the regular expression. On the other hand, when matching the second pattern, regular expression is matched against the raw symbol name, then the symbol is tested if it is C++ one by attempting to demangle it. A failure of any basic pattern will result in the failure of the whole pattern.  Therefore, for example, "__N3NSA6ClassA7Private11privmethod\edEi@Base" will not match either of the patterns because it is not a valid C++ symbol.
ja: 両方のパターンとも、"_ZN3NSA6ClassA7Private11privmethod1Ei@Base" シンボルと "_ZN3NSA6ClassA7Private11privmethod2Ei@Base" シンボルにマッチする。1 番目のパターンでは、本来のシンボル名が 1 番目に C++ シンボルにデコードされ、デコードされたシンボル名を用いて正規表現によりマッチが行われる。一方、2 番目のパターンにマッチした場合、正規表現が本来のシンボル名にマッチし、その後そのシンボル名がデコードされた上で、C++ シンボル名として評価される。いずれかの基本パターンのマッチングに失敗すると、全体が失敗と見なされる。そのため、例えば "__N3NSA6ClassA7Private11privmethod\edEi@Base" は、正しい C++ シンボルでないため、どちらのパターンにもマッチしないと見なされる。

note: type: Plain text
en: In general, all patterns are divided into two groups: aliases (basic I<c++> and I<symver>) and generic patterns (I<regex>, all combinations of multiple basic patterns). Matching of basic alias-based patterns is fast (O(1))  while generic patterns are O(N) (N - generic pattern count) for each symbol.  Therefore, it is recommended not to overuse generic patterns.
ja: 一般的に、すべてのパターンはエイリアス (基本的な I<c++> と I<symver>) と汎用パターン (I<regex> および任意の基本パターンの組み合わせ) という 2 つのグループに大別される。基本的なエイリアスベースのパターンに対するマッチングは (O(1)) であるため高速であるが、汎用パターンは各シンボルに対して O(N) (N - 汎用的なパターンの数) となる。そのため、汎用パターンを多用しすぎないことを推奨する。

note: type: Plain text
en: When multiple patterns match the same real symbol, aliases (first I<c++>, then I<symver>) are preferred over generic patterns. Generic patterns are matched in the order they are found in the symbol file template until the first success.  Please note, however, that manual reordering of template file entries is not recommended because B<dpkg-gensymbols> generates diffs based on the alphanumerical order of their names.
ja: 組み合わせのパターンが同じ実シンボルにマッチした場合、エイリアス (I<c++>、I<symver> の順) が汎用パターンよりも優先される。汎用パターンは、マッチングに成功するまで、シンボルファイルのテンプレートに記載された順にマッチングを試みる。ただし、テンプレートファイルのエントリに記載された順序を手作業で修正することは推奨されない。これは、B<dpkg-gensymbols> が差分を生成する際に、名前が英数字順になっていることを前提としているためである。

note: type: SS
en: Using includes
ja: include の使用

note: type: Plain text
en: When the set of exported symbols differ between architectures, it may become inefficient to use a single symbol file. In those cases, an include directive may prove to be useful in a couple of ways:
ja: エクスポートされた一連のシンボルがアーキテクチャにより異なっている場合、単一のシンボルファイルでは不便な場合がある。その場合、include ディレクティブにより、以下のような方法で、利便性を向上させることができる場合もある:

note: type: Plain text
en: You can factorize the common part in some external file and include that file in your I<package>.symbols.I<arch> file by using an include directive like this:
ja: 外出ししたファイルの共通部分を取り出した上で、include ディレクティブを次にように用いて、該当ファイルを I<package>.symbols.I<arch> ファイルに挿入する:

note: type: Plain text
en: The include directive may also be tagged like any symbol:
ja: include ディレクティブには、他のシンボル同様タグを付加してもよい:

note: type: Plain text
en: (tag|...|tagN)#include "file-to-include"
ja: (tag|..|tagN)#include "file-to-include"

note: type: Plain text
en: As a result, all symbols included from I<file-to-include> will be considered to be tagged with I<tag> ... I<tagN> by default. You can use this feature to create a common I<package>.symbols file which includes architecture specific symbol files:
ja: 結果として、I<file-to-include> から挿入されるすべてのシンボルが I<tag> ... I<tagN> にデフォルトでタグづけされたと見なされる。この機能を用いて、以下のように共通の I<package>.symbols ファイルを作成した上で、それをアーキテクチャ固有のシンボルファイルに挿入することもできる:

note: type: Plain text
en: The symbols files are read line by line, and include directives are processed as soon as they are encountered. This means that the content of the included file can override any content that appeared before the include directive and that any content after the directive can override anything contained in the included file. Any symbol (or even another #include directive) in the included file can specify additional tags or override values of the inherited tags in its tag specification. However, there is no way for the symbol to remove any of the inherited tags.
ja: シンボルファイルは 1 行ずつ読み取られ、include ディレクティブがあれば、都度処理される。つまり、挿入されるファイルの設定で include ディレクティブの前に存在していた設定が上書きされる可能性もあり、include ディレクティブの後に存在している設定により、挿入されたファイルの設定が上書きされることもある。挿入されるファイルに存在する任意のシンボル (別の #include ディレクティブを含む) では、新しいタグを追加することも、継承されたタグの値を上書きすることもできるが、シンボルから継承されたタグを削除することはできない。

note: type: Plain text
en: An included file can repeat the header line containing the SONAME of the library. In that case, it overrides any header line previously read.  However, in general it's best to avoid duplicating header lines. One way to do it is the following:
ja: 挿入されたファイルで、ライブラリの SONAME を含むヘッダ行を繰り返すことも可能である。その場合、そこまで読み込んだヘッダ行はすべて上書きされる。ただし、一般的に、ヘッダ行の重複は避けるべきである。これを避ける方法の一つを以下に示す:

note: type: SS
en: Good library management
ja: 推奨されるライブラリ管理

note: type: Plain text
en: A well-maintained library has the following features:
ja: 適切に維持されているライブラリの特徴を以下に示す:

note: type: Plain text
en: its API is stable (public symbols are never dropped, only new public symbols are added) and changes in incompatible ways only when the SONAME changes;
ja: API の変更がなく (公開シンボルの消失は一切なく、新しい公開シンボルが追加されるのみである)、SONAME の変更以外に互換性を損なう API の変更が行われない。

note: type: Plain text
en: ideally, it uses symbol versioning to achieve ABI stability despite internal changes and API extension;
ja: 理想的には、ABI の安定性を維持するため、内部的な変更と API の拡張を除いてシンボルのバージョン管理が行われている。

note: type: Plain text
en: it doesn't export private symbols (such symbols can be tagged optional as workaround).
ja: 非公開シンボルをエクスポートしない (そうしたシンボルは暫定で optional のタグづけをしておくこともできる)。

note: type: Plain text
en: While maintaining the symbols file, it's easy to notice appearance and disappearance of symbols. But it's more difficult to catch incompatible API and ABI change. Thus the maintainer should read thoroughly the upstream changelog looking for cases where the rules of good library management have been broken. If potential problems are discovered, the upstream author should be notified as an upstream fix is always better than a Debian specific work-around.
ja: シンボルファイルをメンテナンスする上で、追加されたり削除されたりしたシンボルを把握することは難しくないが、互換性のない API や ABI の変更を把握するのは難しい。メンテナにはアップストリームの changelog を読み込んで、推奨されるライブラリ管理のルールが守られていない点を探しだすことが求められる。潜在的な問題が発見されたら、アップストリームの開発者に通知すること。Debian 独自の暫定対処よりも、アップストリーム側での修正が常に望ましい。

note: type: Plain text
en: Scan I<package-build-dir> instead of debian/tmp.
ja: debian/tmp の代わりに I<package-build-dir> 内を確認する。

note: type: Plain text
en: Define the package name. Required if more than one binary package is listed in debian/control (or if there's no debian/control file).
ja: パッケージ名を定義する。debian/control ファイルに複数のバイナリパッケージが記載されている (もしくは debian/control ファイルが存在しない) 場合は必須である。

note: type: Plain text
en: Define the package version. Defaults to the version extracted from debian/changelog. Required if called outside of a source package tree.
ja: パッケージのバージョンを定義する。デフォルトは debian/changelog から取得されたバージョンが用いられる。ソースパッケージツリー以外で呼び出された際は必須である。

note: type: Plain text
en: Only analyze libraries explicitly listed instead of finding all public libraries. You can use shell patterns used for pathname expansions (see the File::Glob manual page for details) in I<library-file> to match multiple libraries with a single argument (otherwise you need multiple B<-e>).
ja: すべての公開されているライブラリを探索する代わりに、明示的に指定されたライブラリのみを探索する。I<library-file> に、パス名の展開に使用されるシェルのパターンマッチングを指定することで (詳細は File::Glob マニュアルページを参照のこと) 、単一の設定で複数のライブラリをマッチさせることもできる (さもなくば B<-e> を複数回指定する必要がある)。

note: type: Plain text
en: Use I<filename> as reference file to generate the symbols file that is integrated in the package itself.
ja: I<filename> を、パッケージに同梱するシンボルファイルを生成する際のリファレンスファイルとして使用する。

note: type: Plain text
en: Print the generated symbols file to standard output, rather than being stored in the package build tree.
ja: 生成されたシンボルファイルをパッケージビルドツリーに保存する代わりに標準出力に出力する。

note: type: Plain text
en: Store the generated symbols file as I<filename>. If I<filename> is pre-existing, its content is used as basis for the generated symbols file.  You can use this feature to update a symbols file so that it matches a newer upstream version of your library.
ja: 生成されたシンボルファイルを I<filename> として保存する。I<filename> があらかじめ存在している場合、その内容は生成されるシンボルファイルの元として使われる。この機能を用いてシンボルファイルを更新することで、ライブラリを新しいアップストリームのバージョンに対応させることができる。

note: type: Plain text
en: Write the symbol file in template mode rather than the format compatible with I<deb-symbols(5)>. The main difference is that in the template mode symbol names and tags are written in their original form contrary to the post-processed symbol names with tags stripped in the compatibility mode.  Moreover, some symbols might be omitted when writing a standard I<deb-symbols(5)> file (according to the tag processing rules) while all symbols are always written to the symbol file template.
ja: シンボルファイルを I<deb-symbols(5)> と互換性のある形式ではなく、テンプレートモードで保存する。両者の主な違いは、テンプレートモードではシンボル名とタグの両方がオリジナルの形式のまま書き出されるのに対し、互換モードでは、処理済みのシンボル名のみが書き出され、タグは削除される点である。さらに、テンプレートモードでは、すべてのシンボルが常にシンボルファイルのテンプレートに書き込まれるのに対し、互換モードでは、シンボルの一部が標準の I<deb-symbols(5)> ファイルに書き出される際に削除される場合がある (タグの処理ルールによる)。

note: type: Plain text
en: Define the checks to do when comparing the generated symbols file with the template file used as starting point. By default the level is 1. Increasing levels do more checks and include all checks of lower levels. Level 0 never fails. Level 1 fails if some symbols have disappeared. Level 2 fails if some new symbols have been introduced. Level 3 fails if some libraries have disappeared. Level 4 fails if some libraries have been introduced.
ja: 生成されたシンボルファイルをベースとして用いたテンプレートファイルと比較する際のチェック項目を定義する。デフォルトのレベルは 1 である。レベルを上げるとより低いレベルのチェック項目すべてに加えて、より多くのチェックが行われる。レベル 0 を指定した場合、常に失敗しない。レベル 1 は、幾つかのシンボルが消失した場合に失敗となる。レベル 2 は新しいシンボルが出現しても失敗となる。レベル 3 はライブラリが消失すると失敗となる。レベル 4 はライブラリが出現した場合にも失敗となる。

note: type: Plain text
en: This value can be overridden by the environment variable DPKG_GENSYMBOLS_CHECK_LEVEL.
ja: この値は、環境変数 DPKG_GENSYMBOLS_CHECK_LEVEL により上書きすることができる。

note: type: Plain text
en: Keep quiet and never generate a diff between generated symbols file and the template file used as starting point or show any warnings about new/lost libraries or new/lost symbols. This option only disables informational output but not the checks themselves (see I<-c> option).
ja: 出力を抑止し、生成されたシンボルファイルとベースとなったテンプレートファイルとの差分を生成せず、新規の、もしくは消失したライブラリや、新規の、もしくは消失したシンボルに関する警告も表示しない。このオプションは情報の出力を抑止するのみであり、チェック自体は行われる (I<-c> オプションも参照のこと)。

note: type: Plain text
en: Assume I<arch> as host architecture when processing symbol files. Use this option to generate a symbol file or diff for any architecture provided its binaries are already available.
ja: シンボルファイルの処理の際に、I<arch> をホストのアーキテクチャと見なす。このオプションは、バイナリファイルが既に利用可能な場合に、シンボルファイルや差分情報を生成する際に使用する。

note: type: Plain text
en: Enable debug mode. Numerous messages are displayed to explain what B<dpkg-gensymbols> does.
ja: デバッグモードを有効化する。B<dpkg-gensymbols> の動作を示す大量のメッセージが表示される。

note: type: Plain text
en: Enable verbose mode. The generated symbols file contains deprecated symbols as comments. Furthermore in template mode, pattern symbols are followed by comments listing real symbols that have matched the pattern.
ja: 冗長モードを有効化する。生成されたシンボルファイルには、廃止されたシンボルがコメントとして残される。さらにテンプレートモードの場合、パターンシンボルについて、パターンとマッチした実シンボルの一覧もコメントとして残される。

note: type: Plain text
en: dpkg-maintscript-helper - works around known dpkg limitations in maintainer scripts
ja: dpkg-maintscript-helper - メンテナスクリプトにおける既知の dpkg の制約に対する暫定対応

note: type: SH
en: COMMANDS AND PARAMETERS
ja: コマンドおよびパラメータ

note: type: Plain text
en: This program is designed to be run within maintainer scripts to achieve some tasks that dpkg can't (yet) handle natively either because of design decisions or due to current limitations.
ja: このプログラムは、メンテナスクリプトとして実行されることで、dpkg が設計上の判断や制約事項によって (未だに) 自身で対応できていない幾つかの作業を実現するために開発された。

note: type: Plain text
en: Many of those tasks require coordinated actions from several maintainer scripts (B<preinst>, B<postinst>, B<prerm>, B<postrm>). To avoid mistakes the same call simply needs to be put in all scripts and the program will automatically adapt its behaviour based on the environment variable B<DPKG_MAINTSCRIPT_NAME> and on the maintainer scripts arguments that you have to forward after a double dash.
ja: こうした作業の多くは、メンテナスクリプト (B<preinst>, B<postinst>, B<prerm>, B<postrm>) 間の連携した動作が求められる。ミスを避けるために、すべてのスクリプトに対して単に同じ形式のスクリプト呼び出しを設定し、プログラム側で環境変数 B<DPKG_MAINTSCRIPT_NAME> と二重ダッシュの後に設定して渡されるメンテナスクリプト固有の引数とに基づいた挙動の調整を自動的に行うようにしている。

note: type: SH
en: CONFFILE RELATED TASKS
ja: conffile 関連の作業

note: type: Plain text
en: When upgrading a package, dpkg will not automatically remove a conffile (a configuration file for which dpkg should preserve user changes) if it is not present in the newer version. There are two principal reasons for this; the first is that the conffile could've been dropped by accident and the next version could restore it, users wouldn't want their changes thrown away. The second is to allow packages to transition files from a dpkg-maintained conffile to a file maintained by the package's maintainer scripts, usually with a tool like debconf or ucf.
ja: パッケージをアップグレードする時に、dpkg は、新しいバージョンに存在しない conffile (dpkg がユーザの行った修正を保持する必要がある設定ファイル) を自動的には削除しない。これには 2 つの大きな理由がある。1 つは (パッケージ作成時に) conffile の指定を誤って削除してしまった場合でも、ユーザとしては行った変更を破棄されたくないであろうことを勘案し、設定を削除されないようにしておき、次のバージョンでそれを復活させることができるようにするためである。もう 1 つは、dpkg がメンテナンスする conffile を、パッケージのメンテナスクリプト、通常は debconf や ucf といったツールによって、メンテナンスするファイルに移行することを可能とするためである。

note: type: Plain text
en: This means that if a package is intended to rename or remove a conffile, it must explicitly do so and B<dpkg-maintscript-helper> can be used to implement graceful deletion and moving of conffiles within maintainer scripts.
ja: これは、パッケージが conffile のリネームや削除を意図していた場合は、明示的に行う必要があり、B<dpkg-maintscript-helper> が既定を遵守した削除の実装と、conffile をメンテナスクリプトにより移動するために用いられることを意味する。

note: type: SS
en: REMOVING A CONFFILE
ja: conffile の削除

note: type: Plain text
en: If a conffile is completely removed, it should be removed from disk, unless the user has modified it. If there are local modifications, they should be preserved. If the package upgrades aborts, the newly obsolete conffile should not disappear.
ja: conffile が完全に削除される場合は、ユーザが変更していない限り、ディスクから削除されるべきである。ローカルに変更が行われていた場合は、その変更は保持されるべきである。パッケージのアップグレードが中止された場合は、不要となるはずだった conffile が消去されることがないようにすべきである。

note: type: Plain text
en: All of this is implemented by putting the following shell snippet in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:
ja: これらのすべてがメンテナスクリプト B<preinst>, B<postinst>, B<postrm> 内で以下のようなシェルスクリプトによって行われる。

note: type: Plain text
en: I<conffile> is the filename of the conffile to remove.
ja: I<conffile> は削除する conffile のファイル名である。

note: type: Plain text
en: I<prior-version> defines the latest version of the package whose upgrade should trigger the removal. It is important to calculate I<prior-version> correctly so that conffiles are correctly removed even if the user rebuilt the package with a local version. For example, for a conffile removed in version B<2.0-1> of a package, I<prior-version> should be set to B<2.0-1~>. This will cause the conffile to be removed even if the user rebuilt the previous version B<1.0-1> as B<1.0-1local1>.
ja: I<prior-version> は、アップグレードが削除の契機となる最新のパッケージのバージョンを定義する。ユーザがローカルなバージョンを用いてパッケージをリビルドした際でも conffile を適切に削除するためには、適切な I<prior-version> を定義することが肝要である。例えば、あるパッケージのバージョン B<2.0-1> で削除される conffile は、I<prior-version> を B<2.0-1~> に設定する必要がある。これにより、ユーザが以前のバージョンである B<1.0-1> を B<1.0-1local1> としてリビルドした場合であっても、conffile が削除されることになる。

note: type: Plain text
en: If the conffile has not been shipped for several versions, and you are now modifying the maintainer scripts to clean up the obsolete file, I<prior-version> should be based on the version of the package that you are now preparing, not the first version of the package that lacked the conffile.
ja: ある conffile が提供されていないまま、既に複数回のバージョンアップが行われてしまっている場合に、メンテナスクリプトを修正して不要となったファイルを削除したいという場合、I<prior-version> は conffile が不要となった最初のパッケージのバージョンではなく、現在のバージョンを指定する必要がある。

note: type: Plain text
en: I<package> is the package name. If empty or omitted, the DPKG_MAINTSCRIPT_PACKAGE environment variable (as set by dpkg) will be used.
ja: I<package> はパッケージ名を示す。空白もしくは省略された場合、環境変数 DPKG_MAINTSCRIPT_PACKAGE の値 (dpkg により設定される) が用いられる。

note: type: Plain text
en: All the parameters of the maintainer scripts have to be forwarded to the program after "--".
ja: メンテナスクリプトのパラメータはすべて、"--" 以降の部分をプログラムに引き渡す必要がある。

note: type: Plain text
en: Current implementation: in the B<preinst>, it checks if the conffile was modified and renames it either to I<conffile>B<.dpkg-remove> (if not modified) or to I<conffile>B<.dpkg-backup> (if modified). In the B<postinst>, the latter file is renamed to I<conffile>B<.dpkg-bak> and kept for reference as it contains user modifications but the former will be removed. If the package upgrade aborts, the B<postrm> reinstalls the original conffile. During purge, the B<postrm> will also delete the B<.dpkg-bak> file kept up to now.
ja: 現在の実装では、B<preinst> は conffile が変更されたかをチェックし、I<conffile>B<.dpkg-remove> (変更されていない場合) もしくは I<conffile>.B<dpkg-backup> (変更されている場合) にリネームする。B<postinst> は後者のファイルを I<conffile>B<.dpkg-bak> にリネームし、ユーザが変更内容を参照できるように保持するが、前者は削除する。パッケージのアップグレードが中止となった場合、B<postrm> は以前の conffile を再インストールする。完全削除の際に、B<postrm> はここまで保持されていた B<.dpkg-bak> ファイルも削除する。

note: type: SS
en: RENAMING A CONFFILE
ja: conffile のリネーム

note: type: Plain text
en: If a conffile is moved from one location to another, you need to make sure you move across any changes the user has made. This may seem a simple change to the B<preinst> script at first, however that will result in the user being prompted by dpkg to approve the conffile edits even though they are not responsible of them.
ja: conffile のパスが変更された場合は、ユーザによる変更点もすべて移行する必要がある。これは、B<preinst> スクリプトに簡単な変更を行うことで実現できそうに見えるが、その場合、ユーザが主体的に変更を行っていないにも関わらず、dpkg からユーザに対して、conffile の変更を受け入れるかどうかの確認が発生してしまう。

note: type: Plain text
en: Graceful renaming can be implemented by putting the following shell snippet in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:
ja: 以下に示すシェルスクリプトを B<preinst>, B<postinst>, B<postrm> のメンテナスクリプトに入れることで、適切なリネーム処理が実行される:

note: type: Plain text
en: I<old-conffile> and I<new-conffile> are the old and new name of the conffile to rename.
ja: I<old-conffile> と I<new-conffile> は、リネームする conffile の変更前、変更後の名前である。

note: type: Plain text
en: I<prior-version> defines the latest version of the package whose upgrade should trigger the rename of the conffile (see the notes for B<rm_conffile> above concerning the correct value). If I<prior-version> is empty or omitted, then the operation is tried on every upgrade (note: it's safer to give the version and have the operation tried only once).
ja: I<prior-version> は、バージョンアップにより conffile のリネームを行うパッケージの最新のバージョンを指定する (指定すべき適切な値については、B<rm_conffile> での注記を参照のこと) 。I<prior-version> が空白もしくは省略された場合、バージョンアップの度にリネームが試行される (バージョンを指定することで、リネームの試行を一度に留めておく方が安全である)。

note: type: Plain text
en: Current implementation: the B<preinst> checks if the conffile has been modified, if yes it's left on place otherwise it's renamed to I<old-conffile>B<.dpkg-remove>. On configuration, the B<postinst> removes I<old-conffile>B<.dpkg-remove> and renames I<old-conffile> to I<new-conffile> if I<old-conffile> is still available. On abort-upgrade/abort-install, the B<postrm> renames I<old-conffile>B<.dpkg-remove> back to I<old-conffile> if required.
ja: 現在の実装では、B<preinst> は conffile が変更されたかをチェックし、変更されている場合はそのままに、変更されていない場合は I<old-conffile>B<.dpkg-remove> にリネームする。設定の際に、B<postinst> は I<old-conffile>B<.dpkg-remove> を削除し、I<old-conffile> が存在している場合は、それを I<new-conffile> にリネームする。abort-upgrade や abort-install が行われた場合、B<postrm> は、必要に応じて I<old-conffile>B<.dpkg-remove> をリネームして I<old-conffile> に戻す。

note: type: SH
en: INTEGRATION IN PACKAGES
ja: パッケージとの連携

note: type: Plain text
en: Given that B<dpkg-maintscript-helper> is used in the B<preinst>, using it unconditionally requires a pre-dependency to ensure that the required version of dpkg has been unpacked before. The required version depends on the command used, for B<rm_conffile> and B<mv_conffile> it is 1.15.7.2:
ja: B<dpkg-maintscript-helper> の使用が B<preinst> にて指定された場合は、必要なバージョンの dpkg が事前に展開されていることを担保する事前依存関係が必須となる。必要なバージョンは、使用するコマンドによって異なる。例えば、B<rm_conffile> や B<mv_conffile> の場合は 1.15.7.2 以上となる:

note: type: Plain text
en: But in many cases the operation done by the program is not critical for the package, and instead of using a pre-dependency we can call the program only if we know that the required command is supported by the currently installed dpkg:
ja: しかし多くの場合、プログラムによって行われる操作はパッケージにとって不可欠なものではない。そのため、事前依存関係を使用する代わりに、必要なコマンドが現在インストールされている dpkg によってサポートされていることが確認できている場合に限ってプログラムを呼び出してもよい:

note: type: Plain text
en: dpkg-mergechangelogs - 3-way merge of debian/changelog files
ja: dpkg-mergechangelogs - debian/changelogs ファイルの 3-way マージ

note: type: Plain text
en: This program will use the 3 provided versions of the Debian changelog to generate a merged changelog file. The resulting changelog is stored in the file I<out> or output to the standard output if that parameter is not given.
ja: このプログラムは、3 つの Debian changelog のバージョンから、マージされたchangelog ファイルを生成する。生成された changelog は I<out> ファイルに保存されるが、パラメータが指定されなかった場合は 標準出力に出力される。

note: type: Plain text
en: Each entry is identified by its version number and they are assumed to be not conflicting, they are simply merged in the right order (by decreasing version number). When B<--merge-prereleases> is used, the part of the version number after the last tilde is dropped so that 1.0-1~exp1 and 1.0-1~exp5 are considered to be the same entry. When the same version is available in both I<new-a> and I<new-b>, a standard line-based 3-way merge is attempted (provided that the module Algorithm::Merge is available \[em] it's part of the package libalgorithm-merge-perl \[em] otherwise you get a global conflict on the content of the entry).
ja: 各エントリはバージョン番号によって区別され、競合が発生していないことが前提となる。これらは右から順番に (バージョン番号を減らすことで) 単純にマージされる。B<--merge-prereleases> が指定された場合、バージョン番号の最後のチルダより後の部分が除外されるため、1.0-1~exp1 と 1.0-1~exp5 は同じエントリだと見なされる。I<new-a> と I<new-b> とに同じバージョンがある場合、標準的な行ベースの 3-way マージが試行される (Algorithm::Merge モジュールが利用可能な場合。\[em] これは、libalgorithm-merge-perl パッケージの一部である。 \[em] 利用できない場合は、該当のエントリにおいて競合が発生する)。

note: type: Plain text
en: Drop the part after the last tilde in the version number when doing version comparison to identify if two entries are supposed to be the same or not.
ja: 2 つのエントリが同一と見なされるかどうかを確認するバージョン比較の際に、バージョン番号の最後のチルダより後の部分を除外する。

note: type: Plain text
en: This is useful when you keep using the same changelog entry but you increase its version number regularly. For instance, you might have 2.3-1~exp1, 2.3-1~exp2, ... until the official release 2.3-1 and they are all the same changelog entry that has evolved over time.
ja: これは、バージョン番号を常に増加させているものの、同一の changelog エントリの使用を継続したい場合に有用である。一例として、2.3-1~exp1, 2.3-1~exp2 というバージョンが公式なリリースである 2.3-1 まで続くような場合に、これらを時系列順に並べて同一の changelog エントリにしたい場合などが挙げられる。

note: type: SH
en: LIMITATIONS
ja: 制限事項

note: type: Plain text
en: Anything that is not parsed by Dpkg::Changelog is lost during the merge.  This might include stuff like vim modelines, comments which were not supposed to be there, etc.
ja: Dpkg::Changelog で解析できない内容は、マージの際に消失する。これには vim のモードライン、存在しているとは見なされないコメントなどが挙げられる。

note: type: SH
en: INTEGRATION WITH GIT
ja: GIT との連携

note: type: Plain text
en: If you want to use this program to merge Debian changelog files in a git repository, you have first to register a new merge driver in B<.git/config> or B<~/.gitconfig>:
ja: このプログラムを git リポジトリにある Debian changelog ファイルのマージに用いる場合は、最初に B<.git/config> もしくは B<~/.gitconfig> に新しいマージドライバを登録しておく必要がある:

note: type: Plain text
en: Then you have to setup the merge attribute for the debian/changelog file either in B<.gitattributes> in the repository itself, or in B<.git/info/attributes>:
ja: ついで、debian/changelog ファイルの merge 属性をリポジトリ内の B<.gitattributes> もしくは B<.git/info/attributes> 中に設定する必要がある:

note: type: Plain text
en: dpkg-name - rename Debian packages to full package names
ja: dpkg-name - Debian パッケージを完全パッケージ名にリネーム

note: type: Plain text
en: This manual page documents the B<dpkg-name> program which provides an easy way to rename B<Debian> packages into their full package names. A full package name consists of I<package>B<_>I<version>B<_>I<architecture>B<.>I<package-type> as specified in the control file of the package. The I<version> part of the filename consists of the upstream version information optionally followed by a hyphen and the revision information. The I<package-type> part comes from that field if present or fallbacks to B<deb>.
ja: このマニュアルページでは、B<dpkg-name> シェルスクリプトについて説明する。これは、B<Debian> パッケージを完全パッケージ名に、簡単に変更する方法を提供する。完全パッケージ名とは、パッケージの control ファイルで指定された I<package>B<_>I<version>B<_>I<architecture>B<.>I<package-type> という形式である。ファイル名の I<version> 部分は、アップストリームのバージョン情報に続き、オプションでハイフンおよびリビジョン情報が続いたものである。I<package-type> 部分は、Package-Type フィールドが設定されていればその内容が用いられる。デフォルトは B<deb> である。

note: type: Plain text
en: The destination filename will not have the architecture information.
ja: リネーム後のファイル名にアーキテクチャ情報を含めない。

note: type: Plain text
en: Create a symlink, instead of moving.
ja: ファイル名のリネーム処理として、ファイルを移動する代わりにシンボリックリンクを作成する。

note: type: Plain text
en: Existing files will be overwritten if they have the same name as the destination filename.
ja: リネーム後のファイル名と同名のファイルがあれば、上書きする。

note: type: Plain text
en: Files will be moved into a subdirectory. If the directory given as argument exists the files will be moved into that directory otherwise the name of the target directory is extracted from the section field in the control part of the package. The target directory will be `unstable/binary-I<architecture>/I<section>'. If the section is not found in the control, then `no-section' is assumed, and in this case, as well as for sections `non-free' and `contrib' the target directory is `I<section>/binary-I<architecture>'. The section field isn't required so a lot of packages will find their way to the `no-section' area. Use this option with care, it's messy.
ja: リネームしたファイルをサブディレクトリに移動する。引数で指定されたディレクトリが存在する場合、パッケージの制御情報のセクションフィールドから得られたターゲットディレクトリの代わりにそのディレクトリにファイルを移動する。通常、ターゲットディレクトリは `unstable/binary-I<architecture>/I<section>' である。制御情報にこのセクションがない場合は `no-section' とみなされる。この場合、`non-free' や `contrib' セクションの時と同様にターゲットディレクトリは `I<section>/binary-I<architecture>' となる。セクションフィールドは必須ではないため、多くのパッケージが `no-section' になってしまうだろう。このオプションは注意して使用すること。この機能は完成度が低いので、使う時は注意すること。

note: type: Plain text
en: This option can used together with the -s option. If a target directory isn't found it will be created automatically.  B<Use this option with care.>
ja: このオプションは -s オプションとともに使うことができる。ターゲットディレクトリがなければ、自動的に作成される。B<このオプションは注意して使用すること。>

note: type: Plain text
en: The file `bar-foo.deb' will be renamed to bar-foo_1.0-2_i386.deb or something similar (depending on whatever information is in the control part of `bar-foo.deb').
ja: ファイル `bar-foo.deb' が bar-foo_1.0-2_i386.deb のような名前にリネームされる (実際にどうなるかは `bar-foo.deb' の制御情報に依存する)。

note: type: Plain text
en: All files with the extension `deb' in the directory /root/debian and its subdirectory's will be renamed by dpkg-name if required into names with no architecture information.
ja: ディレクトリ /root/debian 以下に存在する拡張子が `deb' のファイルすべてを、dpkg-name によりアーキテクチャ情報のない名前にリネームする。

note: type: Plain text
en: B<Don't do this.> Your archive will be messed up completely because a lot of packages don't come with section information.  B<Don't do this.>
ja: B<やってはいけない!> 多くのパッケージはセクション情報をもっていないので、アーカイブがぐちゃぐちゃになってしまうだろう。B<やってはいけない!>

note: type: Plain text
en: This can be used when building new packages.
ja: これは新しいパッケージを作る時に使うことができる。

note: type: Plain text
en: Some packages don't follow the name structure I<package>B<_>I<version>B<_>I<architecture>B<.deb>.  Packages renamed by dpkg-name will follow this structure. Generally this will have no impact on how packages are installed by B<dselect>(1)/B<dpkg>(1), but other installation tools might depend on this naming structure.
ja: dpkg-name によってリネームされたパッケージは、 I<package>B<_>I<version>B<_>I<architecture>B<.deb> という構造の名前になっているが、これに則っていないパッケージもある。B<dselect>(1)/B<dpkg>(1) がパッケージをインストールする際に、この構造が影響を及ぼすことは通常ないが、インストールを行うツールによっては、これに起因する影響があるかもしれない。

note: type: Plain text
en: dpkg-parsechangelog - parse Debian changelog files
ja: dpkg-parsechangelog - Debian changelog ファイルの解析

note: type: Plain text
en: B<dpkg-parsechangelog> reads and parses the changelog of an unpacked Debian source tree and outputs the information in it to standard output in a machine-readable form.
ja: B<dpkg-parsechangelog> は、展開された Debian ソースツリーにある changelog ファイルを読み取って解析し、その情報をコンピュータに適した形式で標準出力に出力する。

note: type: Plain text
en: Specifies the format of the changelog. By default the format is read from a special line near the bottom of the changelog or failing that defaults to the I<debian> standard format. See also B<CHANGELOG FORMATS>.
ja: changelog ファイルの形式を指定する。デフォルトでは、changelog の末尾の近辺にある特別な行から読み取られるか、もしくは I<debian> 標準形式が用いられる。B<changelog のフォーマット> も参照のこと。

note: type: Plain text
en: Specify an additional directory to search for parser scripts.  This directory is searched before the default directories which are currently B</usr/local/lib/dpkg/parsechangelog> and B</usr/lib/dpkg/parsechangelog>.
ja: パーサスクリプトを検索するディレクトリを追加で指定する。このディレクトリはデフォルトのディレクトリの検索前に検索される。デフォルトのディレクトリは、現在 B</usr/local/lib/dpkg/parsechangelog> および B</usr/lib/dpkg/parsechangelog> である。

note: type: SS
en: Parser Options
ja: パーサ用オプション

note: type: Plain text
en: The following options can be used to influence the output of the changelog parser, e.g. the range of entries or the format of the output. They need to be supported by the parser script in question. See also B<CAVEATS>.
ja: 以下のオプションは、解析対象の範囲や出力形式といった、changelog パーサの出力を制御するために使われる。これらは、解析スクリプトによってサポートされる必要がある。B<警告> も参照のこと。

note: type: Plain text
en: Set the output format. Currently supported values are I<dpkg> and I<rfc822>.  I<dpkg> is the classic output format (from before this option existed) and the default. It consists of one paragraph in Debian control format (see B<deb-control>(5)). If more than one entry is requested, then most fields are taken from the most recent entry, except otherwise stated:
ja: 出力形式を指定する。現在サポートされている値は I<dpkg> および I<rfc822> である。I<dpkg> は従来からの (このオプションが存在する前からの) 出力形式であり、デフォルトである。これには Debian 制御情報形式 (B<deb-control>(5) を参照) に則った段落 1 つからなる。複数のエントリが指定された場合、他に指示がない限り、ほとんどのフィールドは最新のエントリに従って取得される:

note: type: Plain text
en: The highest urgency of all included entries is used, followed by the concatenated (space-separated) comments from all the versions requested.
ja: 含まれているエントリの中で、最も高い urgency の値が用いられ、要求されたバージョンすべてのコメントを (スペースで区切って) 結合した文字列が続く。

note: type: Plain text
en: The Closes fields of all included entries are merged.
ja: Closes フィールドに含まれるすべてのエントリはマージされる。

note: type: Plain text
en: The text of all changelog entries is concatenated. To make this field a valid Debian control format multiline field empty lines are replaced with a single full stop and all lines is intended by one space character. The exact content depends on the changelog format.
ja: changelog のエントリにあるすべてのテキストは結合される。このフィールドを Debian 制御情報形式に従った形式とするために、複数行のフィールドにおける空行は、ピリオドに置き換えられ、すべての行の先頭に空白文字が 1 つ挿入される。内容は changelog の形式に依存する。

note: type: Plain text
en: The B<Version>, B<Distribution>, B<Urgency>, B<Maintainer> and B<Changes> fields are mandatory.
ja: B<Version>, B<Distribution>, B<Urgency>, B<Maintainer>, B<Changes> フィールドは必須である。

note: type: Plain text
en: There might be additional user-defined fields present.
ja: この他、ユーザ定義のフィールドが存在してもよい。

note: type: Plain text
en: The B<rfc822> format uses the same fields but outputs a separate paragraph for each changelog entry so that all metadata for each entry is preserved.
ja: B<rfc822> 形式でも同じフィールドが用いられるが、出力については、changelog のエントリ毎に別の段落に分割され、各エントリのメタデータが保持される。

note: type: Plain text
en: include all changes later than I<version>.
ja: I<version> より後のすべての変更を含む。

note: type: Plain text
en: include all changes earlier than I<version>.
ja: I<version> より前のすべての変更を含む。

note: type: Plain text
en: include all changes equal or later than I<version>.
ja: I<version> 以降のすべての変更を含む。

note: type: Plain text
en: include all changes up to or equal than I<version>.
ja: I<version> 以前のすべての変更を含む。

note: type: Plain text
en: include I<number> entries from the top (or the tail if I<number> is lower than 0).
ja: 先頭から I<number> 分のエントリを含める (I<number> が 0 未満の場合は、最後から I<number> エントリの意味となる。

note: type: Plain text
en: change the starting point for --count, counted from the top (or the tail if I<number> is lower than 0).
ja: --count の開始地点を先頭から I<number> エントリに変更する (I<number> が0 未満の場合は、最後から I<number> エントリの意味となる)。

note: type: Plain text
en: include all changes. Note: other options have no effect when this is in use.
ja: すべての変更を含める。このオプションが設定された場合、他のオプションは無効となる。

note: type: SH
en: CHANGELOG FORMATS
ja: changelog のフォーマット

note: type: Plain text
en: It is possible to use a different format to the standard one, by providing a parser for that alternative format.
ja: 標準的なフォーマットとは異なるフォーマットに対応したパーサがあれば、非標準のフォーマットを用いることもできる。

note: type: Plain text
en: In order to have B<dpkg-parsechangelog> run the new parser, a line must be included within the last 40 lines of the changelog file, matching the Perl regular expression: \(lqB<\eschangelog-format:\es+([0-9a-z]+)\eW>\(rq.  The part in parentheses should be the name of the format. For example:
ja: B<dpkg-parsechangelog> に新しいパーサを使用させるには、changelog ファイルの末尾 40 行以内に、次のような Perl の正規表現: \(lqB<\eschangelog-format:\es+([0-9a-z]+)\eW>\(rq にマッチする行が含まれている必要がある。括弧内にフォーマットの名称を記載すること。以下に一例を示す:

note: type: Plain text
en: Changelog format names are non-empty strings of alphanumerics.
ja: changelog のフォーマット名は、英数字の文字列である必要がある。

note: type: Plain text
en: If such a line exists then B<dpkg-parsechangelog> will look for the parser as B</usr/lib/dpkg/parsechangelog/>I<otherformat> or B</usr/local/lib/dpkg/parsechangelog/>I<otherformat>; it is an error for it not being present or not being an executable program.  The default changelog format is B<debian>, and a parser for it is provided by default.
ja: こうした行があった場合、B<dpkg-parsechangelog> は、B</usr/lib/dpkg/parsechangelog/>I<otherformat> もしくは B</usr/local/lib/dpkg/parsechangelog/>I<otherformat> という名称のパーサを検索する。これらが存在していなかったり、実行可能でなかったりする場合はエラーとなる。デフォルトの changelog のフォーマットは B<debian> であり、対応するパーサはデフォルトで提供されている。

note: type: Plain text
en: The parser will be invoked with the changelog open on standard input at the start of the file. It should read the file (it may seek if it wishes)  to determine the information required and return the parsed information to standard output in the format specified by the B<--format> option.  It should accept all B<Parser Options>.
ja: パーサは changelog ファイルの先頭を標準入力に設定された状態で起動され、ファイルを読み取って (必要に応じて検索して) 必要な情報を確定し、解析した情報を標準出力経由で、B<--format> オプションで指定されたフォーマットで返却する必要がある。パーサは、すべての B<パーサ用オプション> を受け付けること。

note: type: Plain text
en: If the changelog format which is being parsed always or almost always leaves a blank line between individual change notes, these blank lines should be stripped out, so as to make the resulting output compact.
ja: 解析されている changelog フォーマットにおいて、個々の変更点の記述の間の大半、もしくはすべてが空行となる場合、それらの空行は省略されるため、結果として出力がコンパクトになる。

note: type: Plain text
en: If the changelog format does not contain date or package name information this information should be omitted from the output. The parser should not attempt to synthesize it or find it from other sources.
ja: changelog フォーマットに日付やパッケージ名の情報が含まれていない場合、これらの情報は出力から省かれる。パーサは、これらを生成したり、別の情報源から探してきたりしてはならない。

note: type: Plain text
en: If the changelog does not have the expected format the parser should exit with a nonzero exit status, rather than trying to muddle through and possibly generating incorrect output.
ja: changelog がパーサの期待するフォーマットになっていなかった場合、パーサは、実行を継続しておそらくは不正となるであろう出力を生成するよりは、0 以外の終了コードで終了すべきである。

note: type: Plain text
en: A changelog parser may not interact with the user at all.
ja: changelog パーサは、ユーザと対話を行わなくともよい。

note: type: Plain text
en: All B<Parser Options> except for -v are only supported in B<dpkg>, version 1.14.16 and later. Third party parsers for changelog formats other than I<debian> might not support all options.
ja: -v 以外の B<パーサ用オプション> は B<dpkg> 1.14.16 以降のバージョンでのみサポートされる。I<debian> 以外の changelog 形式を解析するサードパーティのパーサは、すべてのオプションをサポートしないかもしれない。

note: type: Plain text
en: The changelog file, used to obtain version-dependent information about the source package, such as the urgency and distribution of an upload, the changes made since a particular release, and the source version number itself.
ja: changelog ファイル、urgency やアップロードの distribution、あるリリース以降に行われた変更点、ソースのバージョン番号自体といった、ソースパッケージに関するバージョン固有の情報を取得するために用いられる。

note: type: Plain text
en: dpkg-query - a tool to query the dpkg database
ja: dpkg-query - dpkg データベースクエリツール

note: type: Plain text
en: B<dpkg-query> is a tool to show information about packages listed in the B<dpkg> database.
ja: B<dpkg-query> は、B<dpkg> データベースに格納されたパッケージの情報を表示するツールである。

note: type: Plain text
en: List packages matching given pattern. If no I<package-name-pattern> is given, list all packages in I</var/lib/dpkg/status>, excluding the ones marked as not-installed (i.e. those which have been previously purged). Normal shell wildchars are allowed in I<package-name-pattern>. Please note you will probably have to quote I<package-name-pattern> to prevent the shell from performing filename expansion. For example this will list all package names starting with ``libc6'':
ja: 指定したパターンにマッチする名前のパッケージを表示する。 I<package-name-pattern> が指定されなかった場合は、not-installed とマークされているもの (完全削除されているパッケージなど) を除き、I</var/lib/dpkg/status> にある、すべてのパッケージを表示する。I<package-name-pattern> には、標準的なシェルのワイルドカード文字を使用することができる。ただし、シェルにファイル名の展開をさせないように、I<package-name-pattern> をクオートする必要があることに注意。例えば次のコマンドは、``libc6'' で始まる名前のすべてのパッケージを表示する:

note: type: Plain text
en: The first three columns of the output show the desired action, the package status, and errors, in that order.
ja: 出力の先頭から 3 つのカラムは、順に期待される動作 (desired action)、パッケージの状況、エラー状態を示す。

note: type: Plain text
en: Desired action:
ja: 期待される動作

note: type: Plain text
en: Package status:
ja: パッケージの状況:

note: type: Plain text
en: Error flags:
ja: エラーフラグ:

note: type: Plain text
en:   E<lt>emptyE<gt> = (none)
      R = Reinst-required
ja:   E<lt>emptyE<gt> = (none)
      R = 要再インストール

note: type: Plain text
en: An uppercase status or error letter indicates the package is likely to cause severe problems. Please refer to B<dpkg>(1) for information about the above states and flags.
ja: 大文字はエラーを示すものであり、パッケージに致命的な問題が発生していることを示す。上記の状態についての詳細は B<dpkg>(1) を参照のこと。

note: type: Plain text
en: The output format of this option is not configurable, but varies automatically to fit the terminal width. It is intended for human readers, and is not easily machine-readable. See B<-W> (B<--show>)  and B<--showformat> for a way to configure the output format.
ja: この出力形式は変更できないが、端末の横幅に合わせて自動的に調整される。これは人間が目視することを想定したものであり、コンピュータに適した形式ではない。出力形式の設定方法については、B<-W> (B<--show>) および B<--showformat> を参照のこと。

note: type: Plain text
en: Just like the B<--list> option this will list all packages matching the given pattern. However the output can be customized using the B<--showformat> option.  The default output format gives one line per matching package, each line having the name (extended with the architecture qualifier for I<Multi-Arch> B<same> packages) and installed version of the package, separated by a tab.
ja: B<--list> オプションと同様に、指定したパターンにマッチするすべてのパッケージを表示する。このオプションの出力は、 B<--showformat> オプションによってカスタマイズすることができる。デフォルトの出力形式は、マッチしたパッケージごとに、(I<Multi-Arch> が B<same> のパッケージ用のアーキテクチャ修飾子によって拡張された) パッケージ名とバージョンがタブで区切られた 1 行で表示される。

note: type: Plain text
en: Report status of specified package. This just displays the entry in the installed package status database. When multiple I<package-name> are listed, the requested status entries are separated by an empty line, with the same order as specified on the argument list.
ja: 指定したパッケージの状況を表示する。実際は、インストールされたパッケージの状況データベースの内容が表示される。I<package-name> が複数指定された場合、各パッケージは引数のリストで指定された順に、パッケージ間を空行で区切って表示される。

note: type: Plain text
en: List files installed to your system from I<package-name>. When multiple I<package-name> are listed, the requested lists of files are separated by an empty line, with the same order as specified on the argument list.  However, note that files created by package-specific installation-scripts are not listed.
ja: I<package-name> がインストールしたファイルを一覧する。I<package-name> が複数指定された場合、各パッケージは引数のリストで指定された順に、パッケージ間を空行で区切って表示される。パッケージ付属のインストールスクリプトによって作成されたファイルは含まれないことに注意。

note: type: Plain text
en: List control files installed to your system from I<package-name>.  These can be used as input arguments to B<--control-show>.
ja: I<package-name> がシステムにインストールした制御ファイルを一覧する。これは、B<--control-show> の引数として用いることができる。

note: type: Plain text
en: Print the I<control-file> installed to your system from I<package-name> to the standard output.
ja: I<package-name> がシステムにインストールした I<control-file> を標準出力に出力する。

note: type: Plain text
en: List paths for control files installed to your system from I<package-name>.  If I<control-file> is specified then only list the path for that control file if it is present. B<Warning>: this command is deprecated, please switch to use B<--control-list> and B<--control-show> instead.
ja: I<package-name> がシステムにインストールした制御ファイルのパスを表示する。I<control-file> が指定された場合は、該当の制御ファイルが存在している場合に限り、その制御ファイルのパスだけを表示する。B<警告>: このコマンドは廃止予定である。B<--control-list> や B<--control-show> の使用に切り替えてほしい。

note: type: Plain text
en: Search for packages that own files corresponding to the given pattern.  Standard shell wildchars can be used in the pattern.  This command will not list extra files created by maintainer scripts, nor will it list alternatives.
ja: 指定したパターンにマッチするファイルをインストールしたパッケージを検索する。パターンには、標準的なシェルのすべてのワイルドカード文字を使用することができる。このコマンドでは、メンテナスクリプトで作成された追加ファイルや、 alternative は検索することができない。

note: type: Plain text
en: Display details about I<package-name>, as found in I</var/lib/dpkg/available>. When multiple I<package-name> are listed, the requested I<available> entries are separated by an empty line, with the same order as specified on the argument list.
ja: I</var/lib/dpkg/available> にある I<package-name> の詳細を表示する。I<package-name> が複数指定された場合、各 I<available> のエントリは、引数のリストで指定された順に、エントリ間を空行で区切って表示される。

note: type: Plain text
en: Users of APT-based frontends should use B<apt-cache show> I<package-name> instead as the I<available> file is only kept up-to-date when using B<dselect>.
ja: I<available> ファイルには、B<dselect> を用いた際の更新情報しか保持されていないため、APT ベースのフロントエンドを使っているユーザは、B<apt-cache show> I<package-name> を代わりに使用すべきである。

note: type: Plain text
en: Also load the available file when using the B<--show> and B<--list> commands, which now default to only querying the status file.
ja: B<--show> および B<--list> コマンドを用いた際に利用可能なファイルもロードする。これらのコマンドはデフォルトではステータスファイルのみを検索対象とする。

note: type: Plain text
en: In the format string, \(lqB<\e>\(rq introduces escapes:
ja: フォーマット文字列中の \(lqB<\e>\(rq はエスケープ文字である:

note: type: Plain text
en:     B<\en>  newline
        B<\er>  carriage return
        B<\et>  tab
ja:     B<\en>  改行
        B<\er>  復帰 (キャリッジリターン)
        B<\et>  タブ

note: type: Plain text
en: \(lqB<\e>\(rq before any other character suppresses any special meaning of the following character, which is useful for \(lqB<\e>\(rq and \(lqB<$>\(rq.
ja: 任意の文字の前に \(lqB<\e>\(rq を配置することで、これに続く文字の特殊な意味を抑制できる。これは \(lqB<\e>\(rq や \(lqB<$>\(rq に有用である。

note: type: Plain text
en: Package information can be included by inserting variable references to package fields using the syntax \(lqB<${>I<field>[B<;>I<width>]B<}>\(rq. Fields are printed right-aligned unless the width is negative in which case left alignment will be used. The following I<field>s are recognized but they are not necessarily available in the status file (only internal fields or fields stored in the binary package end up in it):
ja: パッケージ情報には、\(lqB<${>I<field>[B<;>I<width>]B<}>\(rq という構文で、パッケージフィールドを参照する変数を含めることができる。各フィールドは右寄せで表示されるが、width に負の値を指定すると左寄せになる。以下の I<field> が認識されるが、これらはステータスファイルに存在している必要はない (内部フィールドやバイナリパッケージに格納されたフィールドの形で最終的に存在していればよい)。

note: type: Plain text
en:     B<Architecture>
        B<Bugs>
        B<Conffiles> (internal)
        B<Config-Version> (internal)
        B<Conflicts>
        B<Breaks>
        B<Depends>
        B<Description>
        B<Enhances>
        B<Essential>
        B<Filename> (internal, front-end related)
        B<Homepage>
        B<Installed-Size>
        B<MD5sum> (internal, front-end related)
        B<MSDOS-Filename> (internal, front-end related)
        B<Maintainer>
        B<Origin>
        B<Package>
        B<Pre-Depends>
        B<Priority>
        B<Provides>
        B<Recommends>
        B<Replaces>
        B<Revision> (obsolete)
        B<Section>
        B<Size> (internal, front-end related)
        B<Source>
        B<Status> (internal)
        B<Suggests>
        B<Tag> (usually not in .deb but in repository Packages files)
        B<Triggers-Awaited> (internal)
        B<Triggers-Pending> (internal)
        B<Version>
ja:     B<Architecture>
        B<Bugs>
        B<Conffiles> (内部フィールド)
        B<Config-Version> (内部フィールド)
        B<Conflicts>
        B<Breaks>
        B<Depends>
        B<Description>
        B<Enhances>
        B<Essential>
        B<Filename> (内部フィールド, フロントエンド関連)
        B<Homepage>
        B<Installed-Size>
        B<MD5sum> (内部フィールド, フロントエンド関連)
        B<MSDOS-Filename> (内部フィールド, フロントエンド関連)
        B<Maintainer>
        B<Origin>
        B<Package>
        B<Pre-Depends>
        B<Priority>
        B<Provides>
        B<Recommends>
        B<Replaces>
        B<Revision> (obsolete)
        B<Section>
        B<Size> (内部フィールド, フロントエンド関連)
        B<Source>
        B<Status> (内部フィールド)
        B<Suggests>
        B<Tag> (通常 .deb パッケージではなく、リポジトリの Packages ファイルに存在する)
        B<Triggers-Awaited> (内部フィールド)
        B<Triggers-Pending> (内部フィールド)
        B<Version>

note: type: Plain text
en: The following are virtual fields, generated by B<dpkg-query> from values from other fields (note that these do not use valid names for fields in control files):
ja: 以下は B<dpkg-query> が別のフィールドの値から生成した仮想的なフィールドである (これらのフィールド名は、制御ファイルにおける適切な命名規則に従っていない点に留意)。

note: type: Plain text
en: The default format string is \(lqB<${binary:Package}\et${Version}\en>\(rq.  Actually, all other fields found in the status file (i.e. user defined fields) can be requested, too. They will be printed as-is, though, no conversion nor error checking is done on them. B<binary:Package> is a special field that will print the package name with an architecture qualifier (like "libc6:amd64") if the package has a I<Multi-Arch> field with a value of B<same>, and as such its name could be ambiguous.  To get the name of the dpkg maintainer and the installed version, you could run:
ja: デフォルトのフォーマット文字列は  \(lqB<${binary:Package}\et${Version}\en>\(rq である。実際には、ステータスファイルに含まれる他のすべてのフィールド (ユーザ定義フィールド) も指定することができ、これらはそのまま表示される。変換やエラーチェックは行われない。B<binary:Package> は、パッケージの I<Multi-Arch> フィールドが B<same> となっているため、名前だけでは曖昧になってしまうパッケージについて、パッケージ名をアーキテクチャ修飾子 ("libc6:amd64" のような) 付きで表示する特殊なフィールドである。dpkg のメンテナとインストールされているバージョンを取得するには、以下を実行する:

note: type: SH
en: EXIT STATUS
ja: 終了ステータス

note: type: Plain text
en: The requested query was successfully performed.
ja: リクエストされたクエリが正しく実行された。

note: type: Plain text
en: Problems were encountered while parsing the command line or performing the query, including no file or package being found (except for --control-path).
ja: コマンドラインの解析中もしくはクエリの実行中に問題が発生した。これには(--control-path を除き) ファイルやパッケージが存在しなかった場合も含まれる。

note: type: Plain text
en: This setting influences the output of the B<--list> option by changing the width of its output.
ja: この設定により、B<--list> オプションによる出力の横幅が設定される。

note: type: Plain text
en: dpkg-scanpackages - create Packages index files
ja: dpkg-scanpackages - Packages インデックスファイルの作成

note: type: Plain text
en: B<dpkg-scanpackages> sorts through a tree of Debian binary packages and creates a Packages file, used by B<apt>(8), B<dselect>(1), etc, to tell the user what packages are available for installation. These Packages files are the same as those found on Debian archive sites and CD-ROMs. You might use B<dpkg-scanpackages> yourself if making a directory of local packages to install on a cluster of machines.
ja: B<dpkg-scanpackages> は、Debian バイナリパッケージのツリーから、Packages ファイルを生成する。Packages ファイルは、インストール可能なパッケージをユーザに提示するために、B<apt>(8) や B<dselect>(1) などによって用いられる。こうしたPackages ファイルは Debian アーカイブサイトや CD-ROM などで使われているものと同じものである。多数のマシンにインストールを行うローカルなパッケージのディレクトリを作成した上で、自分で B<dpkg-scanpackages> を使うこともできる。

note: type: Plain text
en: B<Note:> If you want to access the generated Packages file with B<apt> you will probably need to compress the file with B<bzip2>(1)  (generating a Packages.bz2 file) or B<gzip>(1)  (generating a Packages.gz file). apt ignores uncompressed Packages files except on local access (i.e.  B<file://> sources).
ja: B<注記:> B<apt> を用いて生成された Packages ファイルにアクセスする場合は、恐らくファイルを B<bzip2>(1) で圧縮する (Packages.bz2 を生成する) か、B<gzip>(1) で圧縮する (Packages.gz を生成する) 必要があるだろう。apt はローカルアクセス (B<file://> ソース) 以外、非圧縮の Packages ファイルを無視する。

note: type: Plain text
en: I<binary-dir> is the name of the tree of the binary packages to process (for example, B<contrib/binary-i386>).  It is best to make this relative to the root of the Debian archive, because every Filename field in the new Packages file will start with this string.
ja: I<binary-dir> は処理するバイナリパッケージツリーの名前である (例えば B<contrib/binary-i386> など)。Debian アーカイブのルートに対する相対パスにしておくことが推奨される。これは、新規 Packages ファイルに含まれている各 Filename フィールドはこの文字列で始まるからである。

note: type: Plain text
en: I<override-file> is the name of a file to read which contains information about how the package fits into the distribution (it can be a compressed file); see B<deb-override>(5).
ja: I<override-file> は、パッケージをディストリビューションに適合させるようにするための情報を含むファイルの名前である (圧縮ファイルの場合もある)。B<deb-override>(5) を参照のこと。

note: type: Plain text
en: I<path-prefix> is an optional string to be prepended to the Filename fields.
ja: I<path-prefix> は Filename フィールドにおいて、パスの前に追加できるオプションの文字列である。

note: type: Plain text
en: If more than one version of a package is found only the newest one is included in the output. If they have the same version and only differ in architecture only the first one found is used.
ja: パッケージに複数のバージョンがある場合、最新のものだけが出力される。同一のバージョンでアーキテクチャだけが異なる場合は、最初のものだけが使用される。

note: type: Plain text
en: Scan for *.I<type> packages, instead of *.deb.
ja: *.deb の代わりに *.I<type> パッケージを検索の対象とする。

note: type: Plain text
en: Scan I<file> to find supplementary overrides (the file can be compressed). See B<deb-extra-override>(5)  for more information on its format.
ja: 追加の override を確認するために、I<file> を調査する (ファイルは圧縮されていてもよい)。ファイルの形式に関する詳細は、B<deb-extra-override>(5) を参照のこと。

note: type: Plain text
en: Use a pattern consisting of I<*_all.deb> and I<*_arch.deb> instead of scanning for all debs.
ja: すべての deb ファイルを検索する代わりに、I<*_all.deb> および I<*_arch.deb> といったパターンを検索する。

note: type: Plain text
en: Include all found packages in the output.
ja: みつかったパッケージすべてを出力する。

note: type: Plain text
en: Add an X-Medium field containing the value I<id-string>. This field is required if you want to generate B<Packages.cd> files for use by the multicd access method of dselect.
ja: I<id-string> の値を含む X-Medium フィールドを追加する。このフィールドはdselect の multicd access method を使用するために B<Packages.cd> ファイルを生成する場合に必要となる。

note: type: SH
en: DIAGNOSTICS
ja: 診断メッセージ

note: type: Plain text
en: B<dpkg-scanpackages> outputs the usual self-explanatory errors. It also warns about packages that are in the wrong subdirectory, are duplicated, have a Filename field in their control file, are missing from the override file, or have maintainer substitutions which do not take effect.
ja: B<dpkg-scanpackages> のエラーメッセージは通常自明である。また、不適切なディレクトリにある、重複している、control ファイルに Filename フィールドがある、override ファイルに存在しない、無効なメンテナの置換があるといったパッケージに対する警告も行う。

note: type: Plain text
en: dpkg-scansources - create Sources index files
ja: dpkg-scansources - ソースインデックスファイルの作成

note: type: Plain text
en: B<dpkg-scansources> scans the given I<binary-dir> for I<.dsc> files.  These are used to create a Debian source index, which is output to stdout.
ja: B<dpkg-scansources> は、I<.dsc> ファイルのために、指定された I<binary-dir> を検索する。これは Debian ソースインデックスを生成し、標準出力に出力するために用いられる。

note: type: Plain text
en: The I<override-file>, if given, is used to set priorities in the resulting index records and to override the maintainer field given in the I<.dsc> files. The file can be compressed. See B<deb-override>(5)  for the format of this file. \s-1NB:\s0 Since the override file is indexed by binary, not source, packages, there's a bit of a problem here. The current implementation uses the highest priority of all the binary packages produced by a I<.dsc> file for the priority of the source package, and the override entry for the first binary package listed in the I<.dsc> file to modify maintainer information. This might change.
ja: I<override-file> が指定された場合、結果として生成されるインデックスレコードのpriority を設定するために用いられると共に、I<.dsc> ファイルのメンテナフィールドを上書きする。ファイルは圧縮されていてもよい。このファイルの形式については、B<deb-override>(5) を参照のこと。\s-1注意:\s0 override ファイルはソースパッケージではなく、バイナリパッケージによってインデックス化されるため、若干の問題が発生する。現在の実装では、ソースパッケージの priority を指定するために、I<.dsc> ファイルによって生成されたすべてのバイナリパッケージの中でもっとも高い priority が用いられ、メンテナ情報を変更する際に、I<.dsc> ファイルに最初に現れるバイナリパッケージの override エントリが用いられる。この実装は変更されるかもしれない。

note: type: Plain text
en: The I<path-prefix>, if given, is prepended to the directory field in the generated source index. You generally use this to make the directory fields contain the path from the top of the Debian archive hierarchy.
ja: I<path-prefix> が指定された場合、生成されたソースインデックスにおける directory フィールドの先頭に挿入される。これは通常 directory フィールドにDebian アーカイブ階層トップからのパスを含めたい場合に使用する。

note: type: Plain text
en: B<Note:> If you want to access the generated Sources file with B<apt>(8)  you will probably need to compress the file with B<gzip>(1)  (generating a Sources.gz file). apt ignores uncompressed Sources files except on local access (i.e.  B<file://> sources).
ja: B<注記:> B<apt>(8) を用いて生成された Sources ファイルにアクセスする場合は、恐らくファイルを B<gzip>(1) で圧縮する (Sources.gz を生成する) 必要があるだろう。apt はローカルアクセス (B<file://> ソース) 以外、非圧縮の Sources ファイルを無視する。

note: type: Plain text
en: Don't sort the index records. Normally they are sorted by source package name.
ja: インデックスレコードをソートしない。通常これはソースパッケージ名によってソートされる。

note: type: Plain text
en: Use I<file> as the source override file (the file can be compressed).  The default is the name of the override file you specified with I<.src> appended.
ja: I<file> をソース override ファイルとして使用する (ファイルは圧縮されていてもよい)。デフォルトは override ファイルの名前に I<.src> を付加した名前が用いられる。

note: type: Plain text
en: The source override file is in a different format from the binary override file. It contains only two whitespace separated fields, the first is the source package name and the second is the section. Blank lines and comment lines are ignored in the normal manner. If a package appears in both files the source override takes precedence for setting the section.
ja: ソース override ファイルの形式はバイナリ override ファイルとは異なり、空白文字で区切られた 2 つのフィールドのみからなる。1 番目のフィールドはソースパッケージ名であり、2 番目はセクション名である。慣習に従い、空白行とコメント行は無視される。あるパッケージが両方のファイルに現れた場合、セクションの設定においては、ソース override ファイルが優先される。

note: type: Plain text
en: Turn debugging on.
ja: デバッグを有効にする

note: type: Plain text
en: dpkg-shlibdeps - generate shared library substvar dependencies
ja: dpkg-shlibdeps - 共有ライブラリの substvar 依存関係を生成する

note: type: Plain text
en: B<dpkg-shlibdeps> calculates shared library dependencies for executables named in its arguments. The dependencies are added to the substitution variables file B<debian/substvars> as variable names B<shlibs:>I<dependency-field> where I<dependency-field> is a dependency field name. Any other variables starting with B<shlibs:> are removed from the file.
ja: B<dpkg-shlibdeps> は、引数として与えられた実行バイナリと共有ライブラリとの依存関係を算出する。依存関係は変数ファイル B<debian/substvars> に B<shlibs:>I<dependency-field> という名前の変数として追加される。I<dependency-field> は依存関係にあるフィールド名であり、それ以外のB<shlibs:> からはじまる変数はファイルから削除される。

note: type: Plain text
en: B<dpkg-shlibdeps> has two possible sources of information to generate dependency information. Either I<symbols> files or I<shlibs> files. For each binary that B<dpkg-shlibdeps> analyzes, it finds out the list of libraries that it's linked with.  Then, for each library, it looks up either the I<symbols> file, or the I<shlibs> file (if the former doesn't exist or if debian/shlibs.local contains the relevant dependency). Both files are supposed to be provided by the library package and should thus be available as /var/lib/dpkg/info/I<package>.I<symbols> or /var/lib/dpkg/info/I<package>.I<shlibs>. The package name is identified in two steps: find the library file on the system (looking in the same directories that B<ld.so> would use), then use B<dpkg -S >I<library-file> to lookup the package providing the library.
ja: B<dpkg-shlibdeps> には依存関係情報を生成する情報源として I<symbols> ファイルおよび I<shlibs> ファイルの 2 つを使用する。B<dpkg-shlibdeps> は、解析する各バイナリについてリンクするライブラリの一覧を確認した上で、各ライブラリを、I<symbols> ファイルもしくは I<shlibs> ファイル (前者が存在しないか、debian/shlibs.local に適切な依存関係が含まれている場合) から検索する。両ファイルともに、ライブラリのパッケージによって提供され、各々 /var/lib/dpkg/info/I<package>.I<symbols> および /var/lib/dpkg/info/I<package>.I<shlibs> に存在する。パッケージ名は 2 段階で識別される。最初にシステムにあるライブラリが検索され (B<ld.so> が使用するのと同じディレクトリが検索される)、ついで B<dpkg -S >I<library-file> を用いてライブラリを提供するパッケージが検索される。

note: type: SS
en: Symbols files
ja: シンボルファイル

note: type: Plain text
en: Symbols files contain finer-grained dependency information by providing the minimum dependency for each symbol that the library exports. The script tries to find a symbols file associated to a library package in the following places (first match is used):
ja: シンボルファイルにはライブラリがエクスポートしている各シンボルに関する最小の依存関係を提供するための詳細な依存関係情報が含まれる。スクリプトは、ライブラリパッケージに関連付けられたシンボルファイルを検索する際に、ファイルを確認する (最初にマッチしたものが使われる):

note: type: Plain text
en: Shared library information generated by the current build process that also invoked B<dpkg-shlibdeps>.  They are generated by B<dpkg-gensymbols>(1).  They are only used if the library is found in a package's build tree. The symbols file in that build tree takes precedence over symbols files from other binary packages.
ja: B<dpkg-gensymbols>(1) を実行した現在のビルド処理によって生成される共有ライブラリの情報。これらはライブラリがパッケージのビルドツリー内で見つかった場合のみ使われる。ビルドツリー内のシンボルファイルは、その他のバイナリパッケージのシンボルファイルに優先する。

note: type: Plain text
en: Per-system overriding shared library dependency information.  I<arch> is the architecture of the current system (obtained by B<dpkg-architecture -qDEB_HOST_ARCH>).
ja: システム全体に上書き適用される共有ライブラリの依存関係情報。I<arch> は現在のシステムのアーキテクチャを示す (B<dpkg-architecture -qDEB_HOST_ARCH> により取得される)。

note: type: IP
en: Output from \(lqB<dpkg-query --control-path> I<package> symbols\(rq
ja: \(lqB<dpkg-query --control-path> I<package> symbols\(rq の出力

note: type: Plain text
en: Package-provided shared library dependency information.  Unless overridden by --admindir, those files are located in /var/lib/dpkg.
ja: パッケージの提供する共有ライブラリの依存関係情報。--admindir により上書きされない限り、これらのファイルは /var/lib/dpkg に存在する。

note: type: Plain text
en: While scanning the symbols used by all binaries, B<dpkg-shlibdeps> remembers the (biggest) minimal version needed for each library. At the end of the process, it is able to write out the minimal dependency for every library used (provided that the information of the I<symbols> files are accurate).
ja: バイナリが使用するシンボルをスキャンしている際、B<dpkg-shlibdeps> は、各ライブラリが必要としている (最大の) 最小バージョンを記憶する。これにより、処理が完了した際に、使用する各ライブラリ毎に最小の依存関係を書き出すことが可能となる (I<symbols> ファイルの情報が適切である場合)。

note: type: Plain text
en: As a safe-guard measure, a symbols file can provide a I<Build-Depends-Package> meta-information field and B<dpkg-shlibdeps> will extract the minimal version required by the corresponding package in the Build-Depends field and use this version if it's higher than the minimal version computed by scanning symbols.
ja: 安全を確保するための手段として、シンボルファイルは I<Build-Depends-Package> というメタ情報フィールドを提供することができる。B<dpkg-shlibdeps> は、ここから Build-Depends フィールドにあるパッケージが必要とする最小バージョンを取得する。この最小バージョンがシンボルを検索して算出された最小バージョンより大きい場合、シンボルファイルで指定したバージョンが使用される。

note: type: SS
en: Shlibs files
ja: shlibs ファイル

note: type: Plain text
en: Shlibs files associate directly a library to a dependency (without looking at the symbols). It's thus often stronger than really needed but very safe and easy to handle.
ja: shlibs ファイルは、ライブラリに直接 (シンボルを参照することなしに) 依存関係を設定する。これは時として必要以上に強力な場合もあるが、非常に安全かつ簡単に扱うことができる。

note: type: Plain text
en: The dependencies for a library are looked up in several places. The first file providing information for the library of interest is used:
ja: ライブラリの依存関係は、幾つかのパスから検索される。対象のライブラリに対して最初に情報を提供したファイルの情報が用いられる。

note: type: Plain text
en: Package-local overriding shared library dependency information.
ja: パッケージのみに上書き適用される共有ライブラリの依存関係情報

note: type: Plain text
en: Per-system overriding shared library dependency information.
ja: システム全体に上書き適用される共有ライブラリの依存関係情報

note: type: Plain text
en: Shared library information generated by the current build process that also invoked B<dpkg-shlibdeps>.  They are only used if the library is found in a package's build tree. The shlibs file in that build tree takes precedence over shlibs files from other binary packages.
ja: B<dpkg-shlibdeps> を起動した現在のビルド処理によって生成された共有ライブラリの情報。これらはライブラリがパッケージのビルドツリー内で見つかった場合のみ使われる。ビルドツリー内の shlibs ファイルはその他のバイナリパッケージの shlibs ファイルに優先する。

note: type: IP
en: Output from \(lqB<dpkg-query --control-path> I<package> shlibs\(rq
ja: \(lqB<dpkg-query --control-path> I<package> shlibs\(rq の出力

note: type: Plain text
en: Per-system default shared library dependency information.
ja: システム全体に影響するデフォルトの共有ライブラリの依存関係情報

note: type: Plain text
en: The extracted dependencies are then directly used (except if they are filtered out because they have been identified as duplicate, or as weaker than another dependency).
ja: 展開された依存関係は直接適用される (重複が確認されたり、別のより強い依存関係が確認されたりしたためフィルタされる場合を除く)。

note: type: Plain text
en: B<dpkg-shlibdeps> interprets non-option arguments as executable names, just as if they'd been supplied as B<-e>I<executable>.
ja: B<dpkg-shlibdeps> は、オプションでない引数を、B<-e>I<executable> で指定された場合と同じく実行ファイル名として解釈する。

note: type: Plain text
en: Include dependencies appropriate for the shared libraries required by I<executable>.
ja: I<executable> が必要とする共有ライブラリのための依存関係を含める。

note: type: Plain text
en: Add dependencies to be added to the control file dependency field I<dependency-field>.  (The dependencies for this field are placed in the variable B<shlibs:>I<dependency-field>.)
ja: 制御ファイルの依存関係のためのフィールド I<dependency-field> に依存関係を追加する (このフィールドに記載した依存関係は B<shlibs:>I<dependency-field> 変数に設定される。

note: type: Plain text
en: The B<-d>I<dependency-field> option takes effect for all executables after the option, until the next B<-d>I<dependency-field>.  The default I<dependency-field> is B<Depends>.
ja: B<-d>I<dependency-field> オプションは、次の B<-d>I<dependency-field> が現れるまで、このオプションに続くすべての実行ファイルに適用される。I<dependency-field> のデフォルトは B<Depends> である。

note: type: Plain text
en: If the same dependency entry (or set of alternatives) appears in more than one of the recognized dependency field names B<Pre-Depends>, B<Depends>, B<Recommends>, B<Enhances> or B<Suggests> then B<dpkg-shlibdeps> will automatically remove the dependency from all fields except the one representing the most important dependencies.
ja: B<Pre-Depends>, B<Depends>, B<Recommends>, B<Enhances>, B<Suggests> といった依存関係に関連するフィールドに、同一の (代替パッケージを含む) 依存関係のエントリが現れた場合、B<dpkg-shlibdeps> は自動的にもっとも重要な依存関係を示すもの以外、すべてのフィールドから該当する依存関係を自動的に削除する。

note: type: Plain text
en: Start substitution variables with I<varname-prefix>B<:> instead of B<shlibs:>.  Likewise, any existing substitution variables starting with I<varname-prefix>B<:> (rather than B<shlibs:>)  are removed from the the substitution variables file.
ja: 変数名を B<shlibs:> から始まる代わりに I<varname-prefix>B<:> から始める。同様に、(B<shlibs:>ではなく) I<varname-prefix>B<:> から始まる既存の変数が変数ファイルから削除される。

note: type: Plain text
en: Print substitution variable settings to standard output, rather than being added to the substitution variables file (B<debian/substvars> by default).
ja: 変数の設定を、変数ファイル (デフォルトは B<debian/substvars>) に追加する代わりに標準出力に出力する。

note: type: Plain text
en: Prefer shared library dependency information tagged for the given package type. If no tagged information is available, falls back to untagged information. The default package type is "deb". Shared library dependency information is tagged for a given type by prefixing it with the name of the type, a colon, and whitespace.
ja: 指定されたパッケージ形式にタグ付けされた共有ライブラリの依存情報を優先的に用いる。タグ付けされた情報が利用できなかった場合はタグ付けされていない情報が用いられる。デフォルトのパッケージ形式は "deb" である。共有ライブラリの依存関係情報は、パッケージ形式の名称、コロン、空白文字を名前の先頭につけることで、パッケージ形式にタグ付けされる。

note: type: Plain text
en: Read overriding shared library dependency information from I<local-shlibs-file> instead of B<debian/shlibs.local>.
ja: B<debian/shlibs.local> の代わりに I<local-shlibs-file> から上書きする共有ライブラリの依存関係情報を読み取る。

note: type: Plain text
en: Write substitution variables in I<substvars-file>; the default is B<debian/substvars>.
ja: 変数を I<substvars-file> に書き込む。デフォルトは B<debian/substvars> である。

note: type: Plain text
en: Enable verbose mode. Numerous messages are displayed to explain what B<dpkg-shlibdeps> does.
ja: 冗長モードを有効にする。B<dpkg-shlibdeps> の動作を示すためのメッセージが数多く表示される。

note: type: Plain text
en: Exclude the package from the generated dependencies. This is useful to avoid self-dependencies for packages which provide ELF binaries (executables or library plugins) using a library contained in the same package. This option can be used multiple times to exclude several packages.
ja: I<package> で指定したパッケージを生成された依存関係から除外する。これは ELF バイナリ (実行ファイルやライブラリのプラグイン) を提供するパッケージが同じパッケージに含まれるライブラリを使用することによる自己依存関係を避ける際に有用である。このオプションを複数回設定することで、複数のパッケージを除外することができる。

note: type: Plain text
en: Look into I<package-build-dir> first when trying to find a library. This is useful when the source package builds multiple flavors of the same library and you want to ensure that you get the dependency from a given binary package. You can use this option multiple times: directories will be tried in the same order before directories of other binary packages.
ja: ライブラリを探索する際に、最初に I<package-build-dir> 内を探索する。これは、ソースパッケージが flavor を交えながら同じライブラリを何度もビルドする際に、指定されたバイナリパッケージからの依存関係を取得したいといった場合に有用である。このオプションは複数回設定することができる。その場合、ここで指定した以外のバイナリパッケージの格納されたディレクトリを探索する前に、指定された順にディレクトリが探索される。

note: type: Plain text
en: Do not fail if dependency information can't be found for a shared library.  Usage of this option is discouraged, all libraries should provide dependency information (either with shlibs files, or with symbols files)  even if they are not yet used by other packages.
ja: 共有ライブラリが依存関係情報を提供しなかった際に失敗と見なさない。このオプションの使用は推奨しない。すべてのライブラリは、たとえ他のパッケージによって使用されていない場合であっても、依存関係情報を(shlibs ファイルまたはシンボルファイルによって) 提供すべきであるためである。

note: type: Plain text
en: I<value> is a bit field defining the set of warnings that can be emitted by B<dpkg-shlibdeps>.  Bit 0 (value=1) enables the warning "symbol I<sym> used by I<binary> found in none of the libraries", bit 1 (value=2) enables the warning "package could avoid a useless dependency" and bit 2 (value=4)  enables the warning "I<binary> should not be linked against I<library>".  The default I<value> is 3: the first two warnings are active by default, the last one is not. Set I<value> to 7 if you want all warnings to be active.
ja: I<value> は B<dpkg-shlibdeps> によって出力される一連の警告をビットフィールドとして定義したものである。ビット 0 (value=1) は "symbol I<sym> used by I<binary> found in none of the libraries" という警告を、ビット 1 (value=2) は "package could avoid a useless dependency" という警告を、ビット 2 (value=4) は "I<binary> should not be linked with I<library>" という警告を有効にする。デフォルトの I<value> は 3 であり、最初の 2 つの警告がデフォルトで有効になり、最後の 1 つは無効となる。I<value> を 7 にすることで、すべての警告を有効にできる。

note: type: SH
en: WARNINGS
ja: 警告

note: type: Plain text
en: Since B<dpkg-shlibdeps> analyzes the set of symbols used by each binary of the generated package, it is able to emit warnings in several cases. They inform you of things that can be improved in the package. In most cases, those improvements concern the upstream sources directly. By order of decreasing importance, here are the various warnings that you can encounter:
ja: B<dpkg-shlibdeps> が生成されたパッケージの各バイナリが使用する一連のシンボルを解析する際に、様々なケースで警告が発生する。これにより、パッケージの改良につながるヒントを得ることができる。多くの場合、こうした改良はアップストリームのソースに直接影響する。重要度の高いものから順に、発生しうる様々な警告を以下に示す:

note: type: Plain text
en: The indicated symbol has not been found in the libraries linked with the binary. The I<binary> is most likely a library and it needs to be linked with an additional library during the build process (option B<-l>I<library> of the linker).
ja: これは、シンボルがバイナリにリンクされたライブラリ内で見つからなかったことを示す。I<binary> はほとんどの場合ライブラリであり、ビルド処理の中で別のライブラリにリンクされる必要がある (リンカの B<-l>I<library> オプション)。

note: type: Plain text
en: The indicated symbol has not been found in the libraries linked with the binary. The I<binary> is most likely a plugin and the symbol is probably provided by the program that loads this plugin. In theory a plugin doesn't have any SONAME but this binary does have one and as such it could not be clearly identified as such. However the fact that the binary is stored in a non-public directory is a strong indication that's it's not a normal shared library. If the binary is really a plugin, then disregard this warning. But there's always the possibility that it's a real library and that programs linking to it are using an RPATH so that the dynamic loader finds it. In that case, the library is broken and needs to be fixed.
ja: これは、シンボルがバイナリにリンクされたライブラリ内で見つからなかったことを示す。I<binary> はほとんどの場合プラグインであり、シンボルは恐らくプラグインをロードするプログラムによって提供される。プラグインには SONAME を持たせないのがセオリーだが、このバイナリはそれを持っているため、プラグインかどうかを明確に判別することができていない。ただし、このバイナリは一般的なディレクトリに配置されていないため、通常の共有ライブラリではないことがほぼ断定できている。バイナリが実際にプラグインであった場合は、この警告は無視すればよい。ただし、バイナリが実際にはライブラリである可能性もある。その場合、リンクするプログラムは RPATH を用いて、動的ローダにライブラリを発見させる。後者の場合、このライブラリは機能不全であり、修正が必要である。

note: type: Plain text
en: None of the I<binaries> that are linked with I<library> use any of the symbols provided by the library. By fixing all the binaries, you would avoid the dependency associated to this library (unless the same dependency is also generated by another library that is really used).
ja: I<library> にリンクされた I<binaries> は、ライブラリによって提供されているシンボルをまったく使用していない。I<binaries> に列挙されたすべてのバイナリを修正することで、このライブラリへの依存関係を外すことができる可能性がある (実際に使用される別のライブラリによって、同じ依存関係が生成されている場合を除く)。

note: type: Plain text
en: Exactly the same as the above warning, but for multiple binaries.
ja: 前述の警告と同一であるが、複数のバイナリが対象となっている。

note: type: Plain text
en: The I<binary> is linked to a library that it doesn't need. It's not a problem but some small performance improvements in binary load time can be obtained by not linking this library to this binary. This warning checks the same information than the previous one but does it for each binary instead of doing the check globally on all binaries analyzed.
ja: I<binary> は不要なライブラリにリンクされている。これは問題ではないが、このライブラリをバイナリにリンクしないことで、若干のパフォーマンス向上が見込まれる。この警告は前述したものと同じ情報を提示しているが、解析したバイナリ全体に対するチェックではなく、個別のライブラリに対するチェックとなっている。

note: type: SH
en: ERRORS
ja: エラー

note: type: Plain text
en: B<dpkg-shlibdeps> will fail if it can't find a public library used by a binary or if this library has no associated dependency information (either shlibs file or symbols file). A public library has a SONAME and is versioned (libsomething.so.I<X>). A private library (like a plugin) should not have a SONAME and doesn't need to be versioned.
ja: B<dpkg-shlibdeps> は、バイナリによって使用される公開ライブラリを発見できない場合や、ライブラリに依存関係の情報 (shlibs ファイルやシンボルファイル) が存在しない場合エラーとなる。公開ライブラリは SONAME があり、(libsomething.so.I<X> という形態で) バージョン管理されている。(プラグインのような) 非公開ライブラリは SONAME を持つべきではなく、バージョン管理も不要である。

note: type: Plain text
en: The I<binary> uses a library called I<library-soname> but B<dpkg-shlibdeps> has been unable to find the library.  B<dpkg-shlibdeps> creates a list of directories to check as following: directories listed in the RPATH of the binary, directories listed in /etc/ld.so.conf, directories listed in the LD_LIBRARY_PATH environment variable, and standard public directories (/lib, /usr/lib, /lib32, /usr/lib32, /lib64, /usr/lib64). Then it checks those directories in the package's build tree of the binary being analyzed, in the packages' build trees indicated with the -S command-line option, in other packages' build trees that contains a DEBIAN/shlibs or DEBIAN/symbols file and finally in the root directory.  If the library is not found in any of those directories, then you get this error.
ja: I<binary> が I<library-soname> で呼び出されるライブラリを使用しているが、B<dpkg-shlibdeps> はライブラリを発見できない。B<dpkg-shlibdeps> は以下の順でライブラリを確認するディレクトリの一覧を作成する: バイナリの RPATH に設定されたディレクトリ、/etc/ld.so.conf に設定されたディレクトリ、LD_LIBRARY_PATH 環境変数に設定されたディレクトリ、標準のディレクトリ (/lib, /usr/lib, /lib32, /usr/lib32, /lib64, /usr/lib64)。作成後、解析されているバイナリに関するパッケージのビルドツリー、-S コマンドラインオプションで指定されたパッケージビルドツリー、同じく DEBIAN/shlibs もしくは DEBIAN/symbols ファイルに含まれるもの、最後にルートディレクトリ内にある、先ほどのディレクトリの一覧をチェックする。これらのディレクトリでライブラリが発見できない場合、エラーとなる。

note: type: Plain text
en: If the library not found is in a private directory of the same package, then you want to add the directory to LD_LIBRARY_PATH. If it's in another binary package being built, you want to make sure that the shlibs/symbols file of this package is already created and that LD_LIBRARY_PATH contains the appropriate directory if it also is in a private directory.
ja: 発見できないライブラリが同じパッケージの非公開ディレクトリにある場合、ディレクトリを LD_LIBRARY_PATH に追加するとよい。ライブラリがビルドされる別のバイナリパッケージに存在している場合、このパッケージの shlibs/symbols ファイルをあらかじめ作成した上で、それが非公開ディレクトリに配置される場合は、LD_LIBRARY_PATH に適切なディレクトリを含めておけばよい。

note: type: Plain text
en: The library needed by I<binary> has been found by B<dpkg-shlibdeps> in I<library-file> but B<dpkg-shlibdeps> has been unable to find any dependency information for that library. To find out the dependency, it has tried to map the library to a Debian package with the help of B<dpkg -S >I<library-file>.  Then it checked the corresponding shlibs and symbols files in /var/lib/dpkg/info/, and in the various package's build trees (debian/*/DEBIAN/).
ja: I<binary> が必要とするライブラリは、B<dpkg-shlibdeps> によって I<library-file> 内で発見されているが、B<dpkg-shlibdeps> は該当ライブラリについての依存関係情報を発見できていない。依存関係を発見するために、 B<dpkg-shlibdeps> は B<dpkg -S >I<library-file> によって Debian パッケージをライブラリに対応付け、さらに /var/lib/dpkg/info や様々なパッケージのビルドツリー (debian/*/DEBIAN/) にある shlibs や symbols ファイルのチェックを実施している。

note: type: Plain text
en: This failure can be caused by a bad or missing shlibs or symbols file in the package of the library. It might also happen if the library is built within the same source package and if the shlibs files has not yet been created (in which case you must fix debian/rules to create the shlibs before calling B<dpkg-shlibdeps>). Bad RPATH can also lead to the library being found under a non-canonical name (example: /usr/lib/openoffice.org/../lib/libssl.so.0.9.8 instead of /usr/lib/libssl.so.0.9.8) that's not associated to any package, B<dpkg-shlibdeps> tries to work around this by trying to fallback on a canonical name (using B<realpath>(3))  but it might not always work. It's always best to clean up the RPATH of the binary to avoid problems.
ja: このエラーはライブラリパッケージの shlibs や symbols ファイルに問題があるか、ファイル自体が存在しない場合に発生する。これは、ライブラリが同じソースパッケージからビルドされているが、shlibs ファイルが未生成 (この場合 debian/rules ファイルを修正して、B<dpkg-shlibdeps> 実行前に shlibs ファイルを生成するようにする必要がある) の場合にも発生する。RPATH に問題があり、ライブラリが正規化されていないパス名で発見され (例えば、/usr/lib/libssl.so.0.9.8 ではなく、/usr/lib/openoffice.org/../lib/libssl.so.0.9.8 のような形で)、そのライブラリがどのパッケージにも対応付けられない場合にも発生する。この場合、B<dpkg-shlibdeps> は (B<realpath>(3) を用いて) 正規名を確認するが、常に成功するとは限らない。問題を発生させないために、バイナリの RPATH を常に整理しておくことが推奨される。

note: type: Plain text
en: Calling B<dpkg-shlibdeps> in verbose mode (-v) will provide much more information about where it tried to find the dependency information. This might be useful if you don't understand why it's giving you this error.
ja: B<dpkg-shlibdeps> を冗長モード (-v) で実行することで、依存関係情報を検索する際の試行に関して、より多くのメッセージを提供することができる。これは、エラーの原因が何か分からない場合に有用となるだろう。

note: type: Plain text
en: B<deb-shlibs>(5), B<deb-symbols>(5), B<dpkg-gensymbols>(1).
ja: B<deb-shlibs>(5), B<deb-symbols>(5), B<dpkg-gensymbols>(1)

note: type: Plain text
en: dpkg-source - Debian source package (.dsc) manipulation tool
ja: dpkg-source - Debian ソースパッケージ (.dsc) 操作ツール

note: type: Plain text
en: B<dpkg-source> packs and unpacks Debian source archives.
ja: B<dpkg-source> は、Debian ソースアーカイブの作成、展開を行う。

note: type: Plain text
en: None of these commands allow multiple options to be combined into one, and they do not allow the value for an option to be specified in a separate argument.
ja: これらの I<command> では複数のオプションを 1 つに結合することはできず、オプションの値をオプション名から分離した引数として指定することもできない。

note: type: Plain text
en: Extract a source package. One non-option argument must be supplied, the name of the Debian source control file (B<.dsc>).  An optional second non-option argument may be supplied to specify the directory to extract the source package to, this must not exist. If no output directory is specified, the source package is extracted into a directory named I<source>-I<version> under the current working directory.
ja: ソースパッケージを展開する。Debian ソースコントロールファイル (B<.dsc>) 名として、オプション形式ではない引数を 1 つ指定する必要がある。それに続きオプション形式ではない引数を指定することで、ソースパッケージの展開先となるディレクトリを指定することができる。このディレクトリは既存であってはならない。ディレクトリが指定されなかった場合、ソースパッケージは、現在のワーキングディレクトリ以下の I<source>-I<version> というディレクトリに展開される。

note: type: Plain text
en: B<dpkg-source> will read the names of the other file(s) making up the source package from the control file; they are assumed to be in the same directory as the B<.dsc>.
ja: B<dpkg-source> は制御ファイルからソースパッケージの設定を行うためのファイル名を取得する。これらは B<.dsc> ファイルと同じディレクトリに配置されているものとみなされる。

note: type: Plain text
en: The files in the extracted package will have their permissions and ownerships set to those which would have been expected if the files and directories had simply been created - directories and executable files will be 0777 and plain files will be 0666, both modified by the extractors' umask; if the parent directory is setgid then the extracted directories will be too, and all the files and directories will inherit its group ownership.
ja: 展開されたパッケージのファイルには、ファイルやディレクトリを単に作成したときに設定されるであろうものと同様のパーミッションや所有者が設定される。ディレクトリ及び実行ファイルのパーミッションは 0777 に、普通のファイルは 0666 に設定されるが、展開したユーザの umask の影響を受ける。親ディレクトリが setgid されていた場合、展開されたディレクトリもそれに従い、ファイルやディレクトリには、グループの所有者情報が引き継がれる。

note: type: Plain text
en: If the source package uses a non-standard format (currently this means all formats except "1.0"), its name will be stored in B<debian/source/format> so that the following builds of the source package use the same format by default.
ja: ソースパッケージが標準以外の形式 (現在のところ "1.0" 以外のすべての形式を意味する) を使用している場合、形式の名称は B<debian/source/format> に格納され、以降のソースパッケージのビルドでは、デフォルトで同じ形式が使用される。

note: type: Plain text
en: Build a source package. The first non-option argument is taken as the name of the directory containing the debianized source tree (i.e. with a debian sub-directory and maybe changes to the original files).  Depending on the source package format used to build the package, additional parameters might be accepted.
ja: ソースパッケージをビルドする。先頭のオプション形式ではない引数は Debian 化されたソースツリー (debian サブディレクトリとオリジナルのファイルに対する変更物) の格納されたディレクトリ名になる。パッケージのビルドに使用されるソースパッケージ形式によって、この他の引数が存在する場合もあるだろう。

note: type: Plain text
en: B<dpkg-source> will build the source package with the first format found in this ordered list: the format indicated with the I<--format> command line option, the format indicated in B<debian/source/format>, "1.0". The fallback to "1.0" is deprecated and will be removed at some point in the future, you should always document the desired source format in B<debian/source/format>. See section B<SOURCE PACKAGE FORMATS> for an extensive description of the various source package formats.
ja: B<dpkg-source> は、コマンドライン引数の I<--format> で指定した形式、B<debian/source/format> で指定した形式、"1.0" の順で形式を確認し、最初に確認できた形式にに基づいてソースパッケージをビルドする。"1.0" は廃止予定であり、将来的には削除されるため、常に B<debian/source/format> でソースパッケージ形式を指定するようにすべきである。ソースパッケージ形式についての詳細な解説は、B<ソースパッケージ形式>セクションを参照のこと。

note: type: Plain text
en: Print the source format that would be used to build the source package if B<dpkg-source -b >I<directory> was called (in the same conditions and with the same parameters).
ja: B<dpkg-source -b >I<directory> が 呼び出された際に、ソースパッケージのビルドに用いられるソース形式を表示する。

note: type: Plain text
en: Run the corresponding hook of the source package format. This hook is called before any build of the package (B<dpkg-buildpackage> calls it very early even before B<debian/rules clean>). This command is idempotent and can be called multiple times. Not all source formats implement something in this hook, and those that do usually prepare the source tree for the build for example by ensuring that the Debian patches are applied.
ja: ソースパッケージ形式に合致するフックを実行する。このフックはパッケージのビルド開始前に呼び出される (B<dpkg-buildpackage> は、B<debian/rules clean> 実行前の非常に早い段階でこれを呼び出す)。このコマンドは冪等であり、複数回呼び出されてもよい。すべてのソース形式がこのフックを実装しているわけではない。実装される場合は、通常、Debian のパッチが適用されていることを確認するといったビルド前のソースツリーの準備に用いられる。

note: type: Plain text
en: Run the corresponding hook of the source package format. This hook is called after any build of the package (B<dpkg-buildpackage> calls it last). This command is idempotent and can be called multiple times. Not all source formats implement something in this hook, and those that do usually use it to undo what B<--before-build> has done.
ja: ソースパッケージ形式に合致するフックを実行する。このフックはパッケージのビルド完了後に呼び出される (B<dpkg-buildpackage> は、これを最後に呼び出す) このコマンドは冪等であり、複数回呼び出されてもよい。すべてのソース形式がこのフックを実装しているわけではない。実装される場合は、通常、B<--before-build> が行った変更を元に戻すために用いられる。

note: type: Plain text
en: Record changes in the source tree unpacked in I<directory>. This command can take supplementary parameters depending on the source format.  It will error out for formats where this operation doesn't mean anything.
ja: I<directory> に展開されたソースツリーの変更を記録する。このコマンドはソース形式に応じて追加の引数を取ることができる。この操作が意味を持たない形式については、エラーとなる。

note: type: SH
en: GENERIC BUILD OPTIONS
ja: 一般的なビルドオプション

note: type: Plain text
en: Specifies the main source control file to read information from. The default is B<debian/control>.  If given with relative pathname this is interpreted starting at the source tree's top level directory.
ja: 情報の読み取り元となるメインのソース制御ファイルを指定する。デフォルトは B<debian/control> である。相対パス名で指定された場合は、ソースツリーのトップのディレクトリを起点として解釈される。

note: type: Plain text
en: Specifies the changelog file to read information from. The default is B<debian/changelog>.  If given with relative pathname this is interpreted starting at the source tree's top level directory.
ja: 情報の読み取り元となる changelog ファイルを指定する。デフォルトは B<debian/changelog> である。相対パス名で指定された場合は、ソースツリーのトップのディレクトリを起点として解釈される。

note: type: Plain text
en: Use the given format for building the source package. It does override any format given in B<debian/source/format>.
ja: ソースパッケージのビルドに指定した形式を使用する。これは B<debian/source/format> で指定された形式に優先する。

note: type: Plain text
en: Read substitution variables in I<substvars-file>; the default is to not read any file. This option can be used multiple times to read substitution variables from multiple files.
ja: I<substvars-file> にある変数を読み込む。デフォルトではいかなるファイルも読み込まれない。このオプションは複数のファイルから変数を読み取るために複数回指定することができる。

note: type: Plain text
en: Specify the compression to use for created files (tarballs and diffs).  Note that this option will not cause existing tarballs to be recompressed, it only affects new files. Supported values are: I<gzip>, I<bzip2>, I<lzma> and I<xz>.  I<gzip> is the default. I<xz> is only supported since dpkg-dev 1.15.5.
ja: ファイル作成 (tar アーカイブや diff) の際に使用する圧縮形式を指定する。このオプションは、新規の圧縮時にのみ適用される。既存の tar アーカイブが再圧縮されることはない。指定可能な値は次のとおり: I<gzip>, I<bzip2>, I<lzma>, I<xz>。デフォルトは I<gzip> である。I<xz> は dpkg-dev 1.15.5 以降でのみ指定できる。

note: type: Plain text
en: Compression level to use. As with B<-Z> it only affects newly created files. Supported values are: I<1> to I<9>, I<best>, and I<fast>.  The default is I<9> for gzip and bzip2, I<6> for xz and lzma.
ja: 使用する圧縮レベル。B<-Z> と併せて指定する。これは新規の圧縮時にのみ適用される。指定可能な値は次のとおり: I<1> から I<9>, I<best>, I<fast>。デフォルトは gzip および bzip2 の場合 I<9>、xz および lzma の場合 I<6> である。

note: type: Plain text
en: You may specify a perl regular expression to match files you want filtered out of the list of files for the diff. (This list is generated by a find command.) (If the source package is being built as a version 3 source package using a VCS, this can be used to ignore uncommited changes on specific files. Using -i.* will ignore all of them.)  B<-i> by itself enables the option, with a default regexp that will filter out control files and directories of the most common revision control systems, backup and swap files and Libtool build output directories. There can only be one active regexp, of multiple B<-i> options only the last one will take effect.
ja: perl 形式の正規表現を用いて diff に含まれるファイルから指定したファイルを除外することができる (除外リストは find コマンドで生成される)。 (ソースパッケージが VCS のバージョン 3 形式のソースパッケージとしてビルドされている場合、これを指定したファイルに対するコミットされていない変更を無視するために使用することができる。-i.* を使用することで、それらすべてを無視することもできる)。B<-i> を指定することでオプションが有効となり、デフォルトの正規表現により、制御ファイルと一般的なバージョン管理システムのディレクトリ、バックアップファイル、スワップファイル、libtool の出力ディレクトリが除外される。正規表現は 1 つしか有効にならない。B<-i> オプションを複数回指定した場合、最後に指定したものしか有効にならない。

note: type: Plain text
en: This is very helpful in cutting out extraneous files that get included in the diff, e.g. if you maintain your source in a revision control system and want to use a checkout to build a source package without including the additional files and directories that it will usually contain (e.g. CVS/, .cvsignore, .svn/). The default regexp is already very exhaustive, but if you need to replace it, please note that by default it can match any part of a path, so if you want to match the begin of a filename or only full filenames, you will need to provide the necessary anchors (e.g. '(^|/)', '($|/)') yourself.
ja: これは diff に含まれている無関係なファイルを除外する際に非常に有用である。例えばバージョン管理システムでソース管理しており、ソースパッケージのビルドにチェックアウトしたファイルを使用したい場合に、無関係なファイルやディレクトリ (例えば CVS/, .cvsignore, .svn/ など) を除外したい場合などが該当する。これらはデフォルトの正規表現でほぼ網羅されているが、デフォルトを変更したい場合は、正規表現はパスの任意の箇所にマッチするため、ファイル名の先頭やフルパスにマッチさせたい場合は、必要なアンカー ('(^|/)' や '($|/)') を自分で指定する必要がある点に留意して行うこと。

note: type: Plain text
en: The perl regular expression specified will extend the default value of B<--diff-ignore> and its current value (if set). It does this by concatenating "B<|>I<regexp>" to the existing value.  This option is convenient to use in B<debian/source/options> to exclude some auto-generated files from the automatic patch generation.
ja: 指定された perl 形式の正規表現により B<--diff-ignore> のデフォルト値および (設定されている場合) 現在の値が拡張される。これは、現在の値に "B<|>I<regexp>" を結合することで行われる。このオプションは、B<debian/source/options> にて、自動パッチ生成によって自動的に生成されるファイルを除外したい場合に有用である。

note: type: Plain text
en: If this option is specified, the pattern will be passed to B<tar>(1)'s --exclude option when it is called to generate a .orig.tar or .tar file. For example, -ICVS will make tar skip over CVS directories when generating a .tar.gz file. The option may be repeated multiple times to list multiple patterns to exclude.
ja: このオプションが指定された場合、B<tar>(1) が .orig.tar や .tar ファイルを生成する際に呼び出される際の --exclude オプションに、I<file-pattern> が引き渡される。例えば -ICVS を指定すると、tar は .tar.gz ファイルを生成する際に、CVS ディレクトリをスキップする。複数の除外パターンを指定するために、このオプションを複数回指定してもよい。

note: type: Plain text
en: B<-I> by itself adds default --exclude options that will filter out control files and directories of the most common revision control systems, backup and swap files and Libtool build output directories.
ja: B<-I> を指定することで、デフォルトの --exclude オプションが設定され、制御ファイルと一般的なバージョン管理システムのディレクトリ、バックアップファイル、スワップファイル、libtool の出力ディレクトリが除外される。

note: type: Plain text
en: B<Note:> While they have similar purposes, B<-i> and B<-I> have very different syntax and semantics. B<-i> can only be specified once and takes a perl compatible regular expression which is matched against the full relative path of each file. B<-I> can specified multiple times and takes a filename pattern with shell wildcards.  The pattern is applied to the full relative path but also to each part of the path individually. The exact semantic of tar's --exclude option is somewhat complicated, see http://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.
ja: B<注記:> B<-i> と B<-I> は類似の目的で用いられるが、文法と意味はまったく異なっている。B<-i> は複数回指定することができず、各ファイルの相対パス全体をマッチ対象として perl 形式の正規表現により指定する。B<-I> は複数回指定することができ、シェルのワイルドカードによるファイル名パターンにより指定する。パターンは相対パス全体に適用されるが、パスの個々の部分毎にチェックが行われる。tar の --exclude オプションの指定は、若干面倒である。網羅的な記述についてはhttp://www.gnu.org/software/tar/manual/tar.html#wildcards を参照のこと。

note: type: Plain text
en: The default regexp and patterns for both options can be seen in the output of the B<--help> command.
ja: 両オプションのデフォルトの正規表現やパターンについては、B<--help> コマンドの出力で確認できる。

note: type: SH
en: GENERIC EXTRACT OPTIONS
ja: 一般的な展開オプション

note: type: Plain text
en: Do not copy original tarballs near the extracted source package.
ja: 展開されたソースパッケージ以外に、オリジナルの tar アーカイブをコピーしない。

note: type: Plain text
en: Do not check signatures and checksums before unpacking.
ja: 展開前に、署名やチェックサムの検証を行わない。

note: type: Plain text
en: Refuse to unpack the source package if it doesn't contain an OpenPGP signature that can be verified either with the user's I<trustedkeys.gpg> keyring, one of the vendor-specific keyrings, or one of the official Debian keyrings (I</usr/share/keyrings/debian-keyring.gpg> and I</usr/share/keyrings/debian-maintainers.gpg>).
ja: 展開するユーザの I<trustedkeys.gpg> keyring、ベンダ固有の keyring のいずれか、official Debian keyring (I</usr/share/keyrings/debian-keyring.gpg> もしくはI</usr/share/keyrings/debian-maintainers.gpg>) のいずれかによって検証可能な OpenPGP の署名が含まれない場合に、ソースパッケージの展開を拒否する。

note: type: SH
en: SOURCE PACKAGE FORMATS
ja: ソースパッケージ形式

note: type: Plain text
en: If you don't know what source format to use, you should probably pick either "3.0 (quilt)" or "3.0 (native)". See http://wiki.debian.org/Projects/DebSrc3.0 for information on the deployment of those formats within Debian.
ja: 使用しているソース形式が分からない場合は、"3.0 (quilt)" もしくは "3.0 (native)" のいずれかであろう。Debian においてこれらの形式を使用するための情報については、http://wiki.debian.org/Projects/DebSrc3.0 を参照のこと。

note: type: SS
en: Format: 1.0
ja: 1.0 形式

note: type: Plain text
en: A source package in this format consists either of a B<.orig.tar.gz> associated to a B<.diff.gz> or a single B<.tar.gz> (in that case the package is said to be I<native>).
ja: この形式のソースパッケージには、B<.diff.gz> と対応する B<.orig.tar.gz>、もしくはB<.tar.gz> のみ (この形態を I<ネイティブ> と称する) が含まれる。

note: type: Plain text
en: B<Extracting>
ja: B<展開>

note: type: Plain text
en: Extracting a native package is a simple extraction of the single tarball in the target directory. Extracting a non-native package is done by first unpacking the B<.orig.tar.gz> and then applying the patch contained in the B<.diff.gz> file. The timestamp of all patched files is reset to the extraction time of the source package (this avoids timestamp skews leading to problems when autogenerated files are patched). The diff can create new files (the whole debian directory is created that way) but can't remove files (empty files will be left over).
ja: ネイティブパッケージの展開は、単一の tar アーカイブをターゲットディレクトリに単に展開するだけである。非ネイティブなパッケージの展開は、先に B<.orig.tar.gz> を展開した上で、B<.diff.gz> ファイルに含まれるパッチを適用する。パッチされたファイルのタイムスタンプは、ソースパッケージを展開した時刻に再設定される (これにより、自動生成されたファイルにパッチする際に、タイムスタンプが逆転してしまうことによる問題の発生を回避する)。diff により新しいファイルを作成することもできる (debian ディレクトリ自体も、これにより作成される) が、ファイルを削除することはできない (空ファイルはそのまま残される)。

note: type: Plain text
en: B<Building>
ja: B<ビルド>

note: type: Plain text
en: Building a native package is just creating a single tarball with the source directory. Building a non-native package involves extracting the original tarball in a separate ".orig" directory and regenerating the B<.diff.gz> by comparing the source package I<directory> with the .orig directory.
ja: ネイティブパッケージのビルドは、ソースディレクトリに単一の tar アーカイブを作成するだけである。非ネイティブパッケージのビルドは、オリジナルの tar アーカイブを ".orig" ディレクトリに展開し、 I<directory> にあるソースパッケージと .orig ディレクトリを比較して B<.diff.gz> ファイルを再生成することにより行われる。

note: type: TP
en: B<Build options (with -b):>
ja: B<ビルドオプション (-b と併用):>

note: type: Plain text
en: If a second non-option argument is supplied it should be the name of the original source directory or tarfile or the empty string if the package is a Debian-specific one and so has no Debianisation diffs. If no second argument is supplied then B<dpkg-source> will look for the original source tarfile I<package>B<_>I<upstream-version>B<.orig.tar.gz> or the original source directory I<directory>B<.orig> depending on the B<-sX> arguments.
ja: 2 番目のオプションでない引数が存在する場合は、オリジナルのソースディレクトリか tar ファイル名を意味する。ただし、パッケージが Debian 固有のものであり、Debian 化するための diff が存在しない場合は空文字列となる。2 番目の引数が存在する場合、B<dpkg-source> は B<-sX> 引数に応じて、オリジナルのソース tar ファイル I<package>B<_>I<upstream-version>B<.orig.tar.gz> もしくはオリジナルのソースディレクトリ I<directory>B<.orig> を検索する。

note: type: Plain text
en: B<-sa>, B<-sp>, B<-sk>, B<-su> and B<-sr> will not overwrite existing tarfiles or directories. If this is desired then B<-sA>, B<-sP>, B<-sK>, B<-sU> and B<-sR> should be used instead.
ja: B<-sa>, B<-sp>, B<-sk>, B<-su>, B<-sr> は、既存の tar ファイルやディレクトリを上書きしない。上書きさせたい場合は、代わりに B<-sA>, B<-sP>, B<-sK>, B<-sU>, B<-sR> を使用すること。

note: type: Plain text
en: Specifies to expect the original source as a tarfile, by default I<package>B<_>I<upstream-version>B<.orig.tar.>I<extension>.  It will leave this original source in place as a tarfile, or copy it to the current directory if it isn't already there. The tarball will be unpacked into I<directory>B<.orig> for the generation of the diff.
ja: オリジナルのソースが、デフォルトでは I<package>B<_>I<upstream-version>B<.orig.tar.>I<extension> という名前の tar ファイルであることを指示する。このオリジナルのソースは適切な場所にtar ファイルのまま残され、カレントディレクトリに存在していない場合はそこにコピーされる。tar ファイルは diff を生成するために、I<directory>B<.orig> に展開される。

note: type: Plain text
en: Like B<-sk> but will remove the directory again afterwards.
ja: B<-sk> と同様だが、最後にディレクトリを削除する。

note: type: Plain text
en: Specifies that the original source is expected as a directory, by default I<package>B<->I<upstream-version>B<.orig> and B<dpkg-source> will create a new original source archive from it.
ja: オリジナルのソースが、デフォルトでは I<package>B<->I<upstream-version>B<.orig> という名前のディレクトリにあることを指示する。B<dpkg-source> は、ここから新しいソースアーカイブを作成する。

note: type: Plain text
en: Like B<-su> but will remove that directory after it has been used.
ja: B<-su> と同様だが、使用後にディレクトリを削除する。

note: type: Plain text
en: Specifies that the original source is available both as a directory and as a tarfile. dpkg-source will use the directory to create the diff, but the tarfile to create the B<.dsc>.  This option must be used with care - if the directory and tarfile do not match a bad source archive will be generated.
ja: オリジナルのソースが、ディレクトリと tar ファイルの両方に存在することを指示する。dpkg-source はディレクトリにあるファイルを用いて diff を作成するが、B<.dsc> ファイル作成の際は tar ファイルを使用する。このオプションは注意して用いること。ディレクトリと tar ファイルの整合性が取れていない場合、不正なソースアーカイブが生成されてしまう。

note: type: Plain text
en: Specifies to not look for any original source, and to not generate a diff.  The second argument, if supplied, must be the empty string. This is used for Debian-specific packages which do not have a separate upstream source and therefore have no debianisation diffs.
ja: オリジナルのソースを参照せず、diff も生成しないことを指示する。2 番目の引数が存在する場合、それは空文字列である必要がある。これは、アップストリームのソースが存在せず、Debian 化するための差分が存在しない Debian 固有のパッケージに用いられる。

note: type: TP
en: B<-sa> or B<-sA>
ja: B<-sa> もしくは B<-sA>

note: type: Plain text
en: Specifies to look for the original source archive as a tarfile or as a directory - the second argument, if any, may be either, or the empty string (this is equivalent to using B<-sn>).  If a tarfile is found it will unpack it to create the diff and remove it afterwards (this is equivalent to B<-sp>); if a directory is found it will pack it to create the original source and remove it afterwards (this is equivalent to B<-sr>); if neither is found it will assume that the package has no debianisation diffs, only a straightforward source archive (this is equivalent to B<-sn>).  If both are found then B<dpkg-source> will ignore the directory, overwriting it, if B<-sA> was specified (this is equivalent to B<-sP>)  or raise an error if B<-sa> was specified.  B<-sA> is the default.
ja: オリジナルのソースアーカイブが tar ファイルもしくはディレクトリであることを指示する。2 番目の引数が指定されている場合、それは上記のいずれであってもよいし、空文字列でもよい (その場合は、B<-sn> (訳注: B<-sp> の誤りと思われる) と同等である)。tar ファイルが存在した場合は、diff 生成のために展開され、最後に削除される (これは B<-sp> と同等である)。ディレクトリが存在した場合は、オリジナルのソースを作成するためにアーカイブ化され最後に削除される (これは、B<-sr> と同等である)。いずれも存在しなかった場合、パッケージは Debian 化の diff を持たず、ソースアーカイブのみが存在すると見なされる (これは、 B<-sn> と同等である)。いずれも存在した場合、B<dpkg-source> はディレクトリの存在を無視して、B<-sA> が指定されていた場合はこれを上書きし (これは B<-sP> と同等である)、B<-sa> が指定されていた場合はエラーを発生させる。デフォルトは B<-sA> である。

note: type: Plain text
en: The process fails if the generated diff contains changes to files outside of the debian sub-directory. This option is not allowed in B<debian/source/options> but can be used in B<debian/source/local-options>.
ja: 生成された diff に Debian サブディレクトリ外にあるファイルへの変更が含まれていた場合、処理を失敗させる。このオプションは B<debian/source/options> で指定できない。B<debian/source/local-options> で指定することは可能である。

note: type: TP
en: B<Extract options (with -x):>
ja: B<展開オプション (-x と併用):>

note: type: Plain text
en: In all cases any existing original source tree will be removed.
ja: いずれの場合も、既存のオリジナルのソースツリーはすべて削除される。

note: type: Plain text
en: Used when extracting then the original source (if any) will be left as a tarfile. If it is not already located in the current directory or if an existing but different file is there it will be copied there.  (B<This is the default>).
ja: オリジナルのソースを tar ファイルとして残す (存在する場合)。カレントディレクトリに配置されていない場合や、存在しているが異なるファイルである場合は、オリジナルのソースがコピーされる (B<これはデフォルトの挙動である>)。

note: type: Plain text
en: Unpacks the original source tree.
ja: オリジナルのソースツリーを展開する。

note: type: Plain text
en: Ensures that the original source is neither copied to the current directory nor unpacked. Any original source tree that was in the current directory is still removed.
ja: オリジナルのソースをカレントディレクトリにコピーさせず、展開もさせない。カレントディレクトリに存在するオリジナルのソースツリーは削除される。

note: type: Plain text
en: All the B<-s>I<X> options are mutually exclusive. If you specify more than one only the last one will be used.
ja: B<-s>I<X> オプションは相互排他である。複数回指定された場合、最後に指定されたものが使用される。

note: type: Plain text
en: Skips application of the debian diff on top of the upstream sources.
ja: アップストリームのソースのトップに存在する Debian 化の diff を適用しない。

note: type: SS
en: Format: 2.0
ja: 2.0 形式

note: type: Plain text
en: Also known as wig&pen. This format is not recommended for wide-spread usage, the format "3.0 (quilt)" replaces it. Wig&pen was the first specification of a new-generation source package format.
ja: wig&pen という名称でも知られている。この形式は広範な使用を推奨されておらず、"3.0 (quilt)" が代替している。wig&pen は新世代のソースパッケージ形式の最初の仕様である。

note: type: Plain text
en: The behaviour of this format is the same as the "3.0 (quilt)" format except that it doesn't use an explicit list of patches. All files in B<debian/patches/> matching the perl regular expression B<[\ew-]+> must be valid patches: they are applied at extraction time.
ja: この形式の挙動は、明示的なパッチ一覧を使用しない点を除き、"3.0 (quilt)" 形式と同等である。perl 形式の正規表現 B<[\ew-]+> にマッチする B<debian/patches/> に存在するすべてのファイルは、適切なパッチである必要がある。これらは展開時に適用される。

note: type: Plain text
en: When building a new source package, any change to the upstream source is stored in a patch named B<zz_debian-diff-auto>.
ja: 新しいソースパッケージをビルドする際にアップストリームのソースに対する変更が発生した場合、B<zz_debian-diff-auto> という名前のパッチとして保存する。

note: type: SS
en: Format: 3.0 (native)
ja: 3.0 (native) 形式

note: type: Plain text
en: This format is an extension of the native package format as defined in the 1.0 format. It supports all compression methods and will ignore by default any VCS specific files and directories as well as many temporary files (see default value associated to B<-I> option in the B<--help> output).
ja: この形式は 1.0 形式で定義されたネイティブパッケージ形式の拡張版である。これはすべての圧縮方式をサポートし、デフォルトでは、多くの一時ファイル (デフォルト値は B<--help> 出力の B<-I> オプションを参照のこと) やバージョン管理システム固有のファイルやディレクトリを無視する。

note: type: SS
en: Format: 3.0 (quilt)
ja: 3.0 (quilt) 形式

note: type: Plain text
en: A source package in this format contains at least an original tarball (B<.orig.tar.>I<ext> where I<ext> can be B<gz>, B<bz2>, B<lzma> and B<xz>) and a debian tarball (B<.debian.tar.>I<ext>). It can also contain additional original tarballs (B<.orig->I<component>B<.tar.>I<ext>).  I<component> can only contain alphanumeric characters and dashes ("-").
ja: この形式のソースパッケージには、オリジナルの tar アーカイブ (B<.orig.tar.>I<ext>。I<ext> は B<gz>, B<bz2>, B<lzma>, B<xz> のいずれか)  および debian tar アーカイブ (B<.debian.tar.>I<ext>) が最低でも含まれる。追加のオリジナルの tar アーカイブ (B<.orig->I<component>B<.tar.>I<ext>) を含んでもよい。I<component> には、英数文字とダッシュ ("-") のみを含めることができる。

note: type: Plain text
en: The main original tarball is extracted first, then all additional original tarballs are extracted in subdirectories named after the I<component> part of their filename (any pre-existing directory is replaced). The debian tarball is extracted on top of the source directory after prior removal of any pre-existing B<debian> directory. Note that the debian tarball must contain a B<debian> sub-directory but it can also contain binary files outside of that directory (see B<--include-binaries> option).
ja: 主たるオリジナルの tar アーカイブが最初に展開され、ついで追加のオリジナル tar アーカイブが、ファイル名の I<component> からとった名前のサブディレクトリに展開される (既存のディレクトリがあった場合、上書きされる)。debian tar アーカイブは、既存の B<debian> ディレクトリの削除後、ソースディレクトリのトップに展開される。debian tar アーカイブには、B<debian> サブディレクトリが必要だが、ディレクトリ外にバイナリファイルを含めることもできる (B<--include-binaries)> オプションを参照のこと)。

note: type: Plain text
en: All patches listed in B<debian/patches/debian.series> or B<debian/patches/series> are then applied.  If the former file is used and the latter one doesn't exist (or is a symlink), then the latter is replaced with a symlink to the former. This is meant to simplify usage of quilt to manage the set of patches. Note however that while B<dpkg-source> parses correctly series files with explicit options used for patch application (stored on each line after the patch filename and one or more spaces), it does ignore those options and always expect patches that can be applied with the B<-p1> option of B<patch>. It will thus emit a warning when it encounters such options, and the build is likely to fail.
ja: 引き続き、B<debian/patches/debian.series> もしくは B<debian/patches/series> にあるパッチがすべて適用される。前者のファイルが使用され、後者が存在しない場合 (もしくはシンボリックリンクの場合)、後者は前者に対するシンボリックリンクに置き換えられる。これは、一連のパッチを管理する上での quilt の使用を単純化する意図である。B<dpkg-source> は、パッチ適用の際に使用されるオプションが (各行毎にパッチファイル名と 1 つ以上のスペースの後に格納する形で) 明示的に指定されたseries ファイルであっても解析するが、指定されたオプションを無視し、常に B<patch> コマンドの B<-p1> オプションを指定して適用すべきものとみなす点に留意すること。このようなオプションが指定されていた場合は、警告が出力され、ビルドは恐らく失敗するだろう。

note: type: Plain text
en: Contrary to quilt's default behaviour, patches are expected to apply without any fuzz. When that is not the case, you should refresh such patches with quilt, or dpkg-source will error out while trying to apply them.
ja: quilt のデフォルトの動作とは相反するが、パッチは fuzz なしで適用されることが期待される。さもなくば、これらのパッチを quilt で更新しない限り、dpkg-source によるパッチ適用時にエラーとなる。

note: type: Plain text
en: Similarly to quilt's default behaviour, the patches can remove files too.
ja: quilt のデフォルトの挙動と同様、パッチによってファイルを削除することもできる。

note: type: Plain text
en: The file B<.pc/applied-patches> is created if some patches have been applied during the extraction.
ja: 展開の際にパッチが適用された場合、B<.pc/applied-patches> ファイルが作成される。

note: type: Plain text
en: All original tarballs found in the current directory are extracted in a temporary directory by following the same logic as for the unpack, the debian directory is copied over in the temporary directory, and all patches except the automatic patch (B<debian-changes->I<version> or B<debian-changes>, depending on B<--single-debian-patch>) are applied. The temporary directory is compared to the source package directory. When the diff is non-empty, the build fails unless B<--single-debian-patch> or B<--auto-commit> has been used, in which case the diff is stored in the automatic patch.  If the automatic patch is created/deleted, it's added/removed from the series file and from the quilt metadata.
ja: カレントディレクトリにあるオリジナルの tar アーカイブが、展開の際と同じロジックで一時ディレクトリに展開され、debian ディレクトリが一時ディレクトリからコピーされる。さらに、自動パッチ (B<--single-debian-patch> の指定により、B<debian-changes->I<version> もしくは B<debian-changes>) を除くすべてのパッチが適用される。一時ディレクトリはソースパッケージのディレクトリと比較される。diff が空でない場合、B<--single-debian-patch> もしくは B<--auto-commit> が指定され、diff が自動パッチの中に保存されていない限り、ビルドは失敗する。自動パッチが作成/削除される場合は、series ファイルと quilt のメタデータからも追加/削除される。

note: type: Plain text
en: Any change on a binary file is not representable in a diff and will thus lead to a failure unless the maintainer deliberately decided to include that modified binary file in the debian tarball (by listing it in B<debian/source/include-binaries>). The build will also fail if it finds binary files in the debian sub-directory unless they have been whitelisted through B<debian/source/include-binaries>.
ja: バイナリファイルに対する変更は diff では表現できないため、メンテナが修正されたバイナリファイルを debian tar アーカイブに (B<debian/source/include-binaries> に格納することで) 含めておくことを熟考の上決定しない限り、処理の失敗を引き起こす。debian サブディレクトリ内にバイナリファイルがあった場合も、B<debian/source/include-binaries> によりホワイトリスト設定されていない限り、ビルドの失敗を引き起こす。

note: type: Plain text
en: The updated debian directory and the list of modified binaries is then used to generate the debian tarball.
ja: 設定を行うことで、debian tar アーカイブを生成する際に、更新された debian ディレクトリと修正されたバイナリのリストが使用される。

note: type: Plain text
en: The automatically generated diff doesn't include changes on VCS specific files as well as many temporary files (see default value associated to B<-i> option in the B<--help> output). In particular, the B<.pc> directory used by quilt is ignored during generation of the automatic patch.
ja: 自動的に生成された diff には、多くの一時ファイル (デフォルト値は B<--help> 出力の B<-i> オプションを参照のこと) やバージョン管理システム固有のファイルやディレクトリは含まれない。特に quilt が使用する B<.pc> ディレクトリは、自動パッチの生成時には無視される。

note: type: Plain text
en: Note: B<dpkg-source> B<--before-build> (and B<-b>) will ensure that all patches listed in the series file are applied so that a package build always has all patches applied. It does this by finding unapplied patches (they are listed in the B<series> file but not in B<.pc/applied-patches>), and if the first patch in that set can be applied without errors, it will apply them all. The option B<--no-preparation> can be used to disable this behavior.
ja: B<dpkg-source> B<--before-build> (および B<-b>) は、series ファイルにリストされているすべてのパッチが適用され、パッケージのビルドが常にすべてのパッチが適用された状態で行われることを担保する。これは、適用されなかったパッチ (B<series> ファイルにリストされているが、B<.pc/applied-patches> にリストされていないもの) を確認することで行われる。これらのうち、最初のパッチがエラーなく適用可能であれば、残りのすべても適用する。この挙動を抑止する場合は、B<--no-preparation> オプションを使用すること。

note: type: Plain text
en: B<Recording changes>
ja: B<変更の記録>

note: type: Plain text
en: Generates a patch corresponding to the local changes that are not managed by the quilt patch system and integrates it in the patch system under the name I<patch-name>. If the name is missing, it will be asked interactively. If I<patch-file> is given, it is used as the patch corresponding to the local changes to integrate. Once integrated, an editor is launched so that you can edit the meta-information in the patch header.
ja: quilt パッチシステムによって管理されていないローカルな変更に対応するパッチを生成し、I<patch-name> というファイル名でパッチシステムに統合する。I<patch-name> を指定しなかった場合は、対話的に確認される。I<patch-file> が指定された場合は、統合されるローカルな変更に関連するパッチファイル名として用いられる。パッチ統合の際にはエディタが起動され、パッチのヘッダにおけるメタ情報を編集することができる。

note: type: Plain text
en: Passing I<patch-file> is mainly useful after a build failure that pre-generated this file, and on this ground the given file is removed after integration. Note also that the changes contained in the patch file must already be applied on the tree and that the files modified by the patch must not have supplementary unrecorded changes.
ja: I<patch-file> の指定は、予め生成されたパッチファイルを用いたビルドに失敗した際に有用であり、そのため、指定されたファイルは統合後に削除される。パッチファイルに含まれている変更点は、ツリーに予め適用されている必要があり、パッチによって修正されるファイルは、その他の記録されていない変更が行われていてはならない点にも留意すること。

note: type: Plain text
en: If the patch generation detects modified binary files, they will be automatically added to B<debian/source/include-binaries> so that they end up in the debian tarball (exactly like B<dpkg-source --include-binaries -b> would do).
ja: パッチの生成により、バイナリファイルの変更が必要と認識された場合、それらは自動的に B<debian/source/include-binaries> に追加されるため、最終的に debian tar アーカイブに追加される (B<dpkg-source --include-binaries -b> と似た動作となる)。

note: type: Plain text
en: B<Build options>
ja: B<ビルドオプション>

note: type: Plain text
en: Allow B<dpkg-source> to build the source package if the version of the quilt metadata is the one specified, even if B<dpkg-source> doesn't know about it. Effectively this says that the given version of the quilt metadata is compatible with the version 2 that B<dpkg-source> currently supports. The version of the quilt metadata is stored in B<.pc/.version>.
ja: B<dpkg-source> が、quilt メタデータのバージョンが指定したものであった場合に、B<dpkg-source> がそれを確認できない場合でも、ソースパッケージをビルドすることを可能とする。指定された quilt メタデータのバージョンは、 B<dpkg-source> が現在サポートしているバージョン 2 と互換であることが事実上必要である。quilt メタデータのバージョンは B<.pc/.version> に保存されている。

note: type: Plain text
en: Do not ignore removed files and include them in the automatically generated patch.
ja: 削除されたファイルを無視せず、それらを自動生成されたパッチに含める。

note: type: Plain text
en: Include timestamp in the automatically generated patch.
ja: タイムスタンプを自動生成されたパッチに含める。

note: type: Plain text
en: Add all modified binaries in the debian tarball. Also add them to B<debian/source/include-binaries>: they will be added by default in subsequent builds and this option is thus no more needed.
ja: debian tar アーカイブに修正されたバイナリをすべて追加し、併せて B<debian/source/include-binaries> にも追加する。これらはその後のビルドの際にデフォルトで追加されるため、このオプションは不要である。

note: type: Plain text
en: Do not try to prepare the build tree by applying patches which are apparently unapplied.
ja: 明らかに適用されていないパッチを適用することによるビルドツリーの準備を行わない。

note: type: Plain text
en: Use B<debian/patches/debian-changes> instead of B<debian/patches/debian-changes->I<version> for the name of the automatic patch generated during build. This option is particularly useful when the package is maintained in a VCS and a patch set can't reliably be generated. Instead the current diff with upstream should be stored in a single patch. The option would be put in B<debian/source/local-options> and would be accompanied by a B<debian/source/local-patch-header> file explaining how the Debian changes can be best reviewed, for example in the VCS that is used.
ja: ビルドの際に生成される自動パッチの名前として、B<debian/patches/debian-changes->I<version> の代わりに B<debian/patches/debian-changes> を使用する。このオプションは、パッケージがバージョン管理システムで維持されているために、パッチセットが安定して生成できない場合特に有用であり、アップストリームと現状との差分を単一のパッチに格納する。このオプションをB<debian/source/local-options> に設定した上で、例えば使用しているバージョン管理システムなどで Debian における変更点を確認するのに最適な方法を説明する B<debian/source/local-patch-header> ファイルを添付しておく。

note: type: Plain text
en: Automatically create the main original tarball as empty if it's missing and if there are supplementary original tarballs. This option is meant to be used when the source package is just a bundle of multiple upstream software and where there's no "main" software.
ja: 主たるオリジナルの tar アーカイブについて、作成できない場合や補助のものが存在する場合であっても、空のファイルを自動的に生成する。このオプションは、ソースパッケージに複数のアップストリームのソフトウェアを単に集めたものであり、"主たる" ソフトウェアが存在しない場合に用いられることを想定している。

note: type: Plain text
en: By default, dpkg-source will automatically unapply the patches in the B<--after-build> hook if it did apply them during B<--before-build>. Those options allow you to forcefully disable or enable the patch unapplication process. Those options are only allowed in B<debian/source/local-options> so that all generated source packages have the same behavior by default.
ja: dpkg-source のデフォルトでは、B<--before-build> フックでパッチが適用された場合、B<--after-build> フックにおいてパッチを自動適用はしない。これらのオプションにより、パッチ適用の処理を強制的に有効化、無効化することができる。これらのオプションは B<debian/source/local-options> においてのみ有効であるため、生成されたすべてのソースパッケージがデフォルトでは同じ挙動を示す。

note: type: Plain text
en: The process fails if an automatic patch has been generated. This option can be used to ensure that all changes were properly recorded in separate quilt patches prior to the source package build. This option is not allowed in B<debian/source/options> but can be used in B<debian/source/local-options>.
ja: 自動パッチが生成された場合に処理を失敗させる。このオプションは、ソースパッケージのビルド以前に、すべての変更点が個別の quilt パッチに適切に保存されることを担保したい場合に使用することができる。このオプションは B<debian/source/options> で指定できない。B<debian/source/local-options> で指定することは可能である。

note: type: Plain text
en: The process doesn't fail if an automatic patch has been generated, instead it's immediately recorded in the quilt series.
ja: 自動パッチが生成された場合に処理を失敗させず、即座に quilt の series ファイルに保存する。

note: type: Plain text
en: B<Extract options>
ja: B<展開オプション>

note: type: Plain text
en: Skips extraction of the debian tarball on top of the upstream sources.
ja: アップストリームのソース上に、debian tar アーカイブの上書き展開を行わない。

note: type: Plain text
en: Do not apply patches at the end of the extraction.
ja: 展開の最後に、パッチの適用を行わない。

note: type: SS
en: Format: 3.0 (custom)
ja: 3.0 (custom) 形式

note: type: Plain text
en: This format is special. It doesn't represent a real source package format but can be used to create source packages with arbitrary files.
ja: これは特別な形式である。特定のソースパッケージ形式を示すものではなく、任意のファイルを用いてソースパッケージを作成する際に使用する形式である。

note: type: Plain text
en: All non-option arguments are taken as files to integrate in the generated source package. They must exist and are preferably in the current directory. At least one file must be given.
ja: すべてのオプション形式ではない引数は、生成されたソースパッケージに統合するファイルとみなされる。ファイルはあらかじめ存在している必要があり、カレントディレクトリに存在していることが望ましい。最低 1 つのファイルを指定すること。

note: type: Plain text
en: B<Required>. Defines the real format of the generated source package.  The generated .dsc file will contain this value in its I<Format> field and not "3.0 (custom)".
ja: B<必須>。ソースパッケージの生成に使用する実際の形式を指定する。生成された .dsc ファイルの I<Format> フィールドには、" 3.0 (custom)" ではなく、ここで指定した値が設定される。

note: type: SS
en: Format: 3.0 (git)
ja: 3.0 (git) 形式

note: type: Plain text
en: This format is experimental.
ja: この形式は実験段階のものである。

note: type: Plain text
en: A source package in this format consists of a single bundle of a git repository B<.git> to hold the source of a package.  There may also be a B<.gitshallow> file listing revisions for a shallow git clone.
ja: この形式のソースパッケージは、パッケージのソースを保持する単一の git bundle である、git リポジトリ B<.git> から構成される。shallow git clone がリビジョン保持に使用する B<.gitshallow> ファイルも含まれる場合がある。

note: type: Plain text
en: The bundle is cloned as a git repository to the target directory.  If there is a gitshallow file, it is installed as `.git/shallow` inside the cloned git repository.
ja: この git bundle は git リポジトリとしてターゲットディレクトリに複製される。gitshallow ファイルがある場合は、複製された git リポジトリ内に `.git/shallow` としてインストールされる。

note: type: Plain text
en: Note that by default the new repository will have the same branch checked out that was checked out in the original source. (Typically "master", but it could be anything.) Any other branches will be available under `remotes/origin/`.
ja: デフォルトで、新しいリポジトリはオリジナルのソースがチェックアウトされたものと同じブランチとなっている。(通常は "master" だが、それに限らない。) それ以外のブランチは `remotes/origin` から利用することができる。

note: type: Plain text
en: Before going any further, some checks are done to ensure that we don't have any non-ignored uncommitted changes.
ja: 先に進む前に、無視すべきもの以外でコミットされていない変更がないことを担保するためのチェックが行われる。

note: type: Plain text
en: B<git-bundle>(1) is used to generate a bundle of the git repository.  By default, all branches and tags in the repository are included in the bundle.
ja: git リポジトリの bundle を生成する際には B<git-bundle>(1) が使用される。デフォルトで、リポジトリ内のすべてのブランチとタグが bundle に含められる。

note: type: Plain text
en: Allows specifying a git ref to include in the git bundle. Use disables the default behavior of including all branches and tags. May be specified multiple times. The I<ref> can be the name of a branch or tag to include. It may also be any parameter that can be passed to B<git-rev-list>(1). For example, to include only the master branch, use --git-ref=master. To include all tags and branches, except for the private branch, use --git-ref=--all --git-ref=^private
ja: git bundle に含める git ref を指定する。このオプションにより、すべてのブランチとタグを含めるというデフォルトの挙動が無効となる。これは複数回指定してもよい。I<ref> は、git bundle に含めるブランチ名もしくはタグ名となるが、B<git-rev-list>(1) に渡すことが可能な任意の引数を指定してもよい。一例として、master ブランチのみを含めたい場合は --git-ref=master と指定する。private ブランチ以外すべてのタグとブランチを含めたい場合は、 --git-ref=--all --git-ref=^private と指定する。

note: type: Plain text
en: Creates a shallow clone with a history truncated to the specified number of revisions.
ja: shallow clone を作成する。作成の際、ヒストリを指定したリビジョン数に切り詰める。

note: type: SS
en: Format: 3.0 (bzr)
ja: 3.0 (bzr) 形式

note: type: Plain text
en: This format is experimental. It generates a single tarball containing the bzr repository.
ja: この形式は実験段階である。これは bzr リポジトリを含む単一の tar アーカイブを生成する。

note: type: Plain text
en: The tarball is unpacked and then bzr is used to checkout the current branch.
ja: tar アーカイブを展開した上で、現在のブランチをチェックアウトするために bzr が使用される。

note: type: Plain text
en: Then the VCS specific part of the source directory is copied over to a temporary directory. Before this temporary directory is packed in a tarball, various cleanup are done to save space.
ja: その後、ソースディレクトリ内のバージョン管理システム固有のファイルが一時ディレクトリにコピーされる。一時ディレクトリが tar アーカイブにされる前に、領域を節約するために、様々なクリーンアップ処理が行われる。

note: type: SH
en: WARNINGS AND ERRORS
ja: 警告とエラー

note: type: Plain text
en: The file B<debian/source/format> should always exist and indicate the desired source format. For backwards compatibility, format "1.0" is assumed when the file doesn't exist but you should not rely on this: at some point in the future dpkg-source will be modified to fail when that file doesn't exist.
ja: B<debian/source/format> ファイルは、ソース形式を指定するために、常に存在しているべきである。後方互換性のため、ファイルが存在していない場合は、"1.0" 形式であると見なされるが、これに依存すべきではない。将来的には、dpkg-source が修正されて、ファイルが存在していないと処理が失敗するようになるかもしれない。

note: type: Plain text
en: The rationale is that format "1.0" is no longer the recommended format, you should usually pick one of the newer formats ("3.0 (quilt)", "3.0 (native)") but B<dpkg-source> will not do this automatically for you.  If you want to continue using the old format, you should be explicit about it and put "1.0" in B<debian/source/format>.
ja: "1.0" 形式は既に推奨される形式から外れており、新しい形式 ("3.0 (quilt)", "3.0 (native)") のいずれかを使用すべきであるが、B<dpkg-source> は、これを自動的には行わない。古い形式の使用を継続する場合、B<debian/source/format> 中で "1.0" を明示すべきである。

note: type: Plain text
en: When using source format "1.0" it is usually a bad idea to modify upstream files directly as the changes end up hidden and mostly undocumented in the .diff.gz file. Instead you should store your changes as patches in the debian directory and apply them at build-time. To avoid this complexity you can also use the format "3.0 (quilt)" that offers this natively.
ja: ソース形式として "1.0" を使用する場合、アップストリームのファイルを直接修正することは通常勧められない。これは変更点が隠蔽され、diff.gz ファイル内でドキュメント化されないままとなってしまうためである。変更点については、 debian ディレクトリ内にパッチとして保存し、ビルド時にこれを適用することが勧められる。複雑化を避ける意味では、この処理が組み込まれている "3.0 (quilt)" 形式を使用してもよい。

note: type: Plain text
en: Changes to upstream sources are usually stored with patch files, but not all changes can be represented with patches: they can only alter the content of plain text files. If you try replacing a file with something of a different type (for example replacing a plain file with a symlink or a directory), you will get this error message.
ja: アップストリームのソースに対する変更は、通常パッチファイルに保存されるが、パッチでは、すべての変更を保持できるわけではない。パッチは平文テキストファイルの内容しか変更できない。これ以外の形式のファイルの内容を変更しようとすると (例えば普通のファイルをシンボリックリンクやディレクトリに変更するなど) 、このエラーメッセージが表示される。

note: type: Plain text
en: Empty files can't be created with patch files. Thus this change is not recorded in the source package and you are warned about it.
ja: パッチファイルでは空ファイルを作成することができないため、この変更はソースパッケージに保持されない。そのため警告が表示される。

note: type: Plain text
en: Patch files do not record permissions of files and thus modified permissions are not stored in the source package. This warning reminds you of that fact.
ja: パッチファイルにファイルのパーミッション情報は保存されないため、パーミッションの変更はソースパッケージに保持されない。そのため警告が表示される。

note: type: SH
en: FILE FORMATS
ja: ファイルフォーマット

note: type: Plain text
en: This file contains on a single line the format that should be used to build the source package (possible formats are described above). No leading or trailing spaces are allowed.
ja: このファイルはソースパッケージのビルドの際に使用される形式を記載した 1 行からなる (指定可能な形式は前述のとおり)。前後に空白を入れてはならない。

note: type: Plain text
en: This file contains a list of binary files (one per line) that should be included in the debian tarball. Leading and trailing spaces are stripped.  Lines starting with "#" are comments and are skipped. Empty lines are ignored.
ja: このファイルには、debian tar アーカイブに含まれるバイナリファイルが (1 行に 1 ファイルずつ) リストされる。前後の空白は削除される。"#" で始まる行はコメント行と見なされスキップされる。空行も無視される。

note: type: Plain text
en: This file contains a list of long options that should be automatically prepended to the set of command line options of a B<dpkg-source -b> or B<dpkg-source --print-format> call. Options like B<--compression> and B<--compression-level> are well suited for this file.
ja: このファイルには、B<dpkg-source -b> や B<dpkg-source --print-format> が実行される際に自動的に付加されるコマンドラインオプションを長いオプション形式でリストしたものが含まれる。このファイルは、B<--compression> や B<--compression-level> といったオプションを指定するのに適している。

note: type: Plain text
en: Each option should be put on a separate line. Empty lines and lines starting with "#" are ignored. The leading "--" should be stripped and short options are not allowed. Optional spaces are allowed around the "=" symbol and optional quotes are allowed around the value.  Here's an example of such a file:
ja: 各オプションは別々の行に記載する。空行や "#" から始まる行は無視される。記載の際に、先頭の "--" は省略する必要がある。また短いオプションは指定できない。"=" の前後に空白を入れることは可能である。また値を囲むためにクオートを行うこともできる。以下にファイルへの設定例を示す:

note: type: Plain text
en: Note: B<format> options are not accepted in this file, you should use B<debian/source/format> instead.
ja: 注記: B<format> オプションをこのファイルで設定することはできない。代わりに B<debian/source/format> を使用すること。

note: type: Plain text
en: Exactly like B<debian/source/options> except that the file is not included in the generated source package. It can be useful to store a preference tied to the maintainer or to the VCS repository where the source package is maintained.
ja: ファイルが生成されたソースパッケージに含まれない点を除き、B<debian/source/options> とまったく同等である。これはメンテナ固有の設定や、ソースパッケージを管理しているバージョン管理システム固有の設定を保持する際に有用である。

note: type: Plain text
en: Free form text that is put on top of the automatic patch generated in formats "2.0" or "3.0 (quilt)". B<local-patch-header> is not included in the generated source package while B<patch-header> is.
ja: "2.0" もしくは "3.0 (quilt)" 形式で生成される自動パッチのトップに配置する、フリーフォーマットのテキスト。B<local-patch-header> は生成されたソースパッケージに含まれないが、B<patch-header> は含まれる。

note: type: Plain text
en: This file lists all patches that have to be applied (in the given order)  on top of the upstream source package. Leading and trailing spaces are stripped. Lines starting with "#" are comments and are skipped. Empty lines are ignored. Remaining lines start with a patch filename (relative to the B<debian/patches/> directory) up to the first space character or the end of line. Optional quilt options can follow up to the end of line or the first "#" preceded by one or more spaces (which marks the start of a comment up to the end of line).
ja: このファイルには、アップストリームのソースパッケージに対して適用すべきすべてのパッチが (適用順序に従って) 並べられる。パッチ名前後の空白は削除される。"#" で始まる行はコメント行と見なされスキップされる。空行も無視される。その他の行は、(B<debian/patches/> ディレクトリからの相対パスによる) パッチのファイル名から始まり、これは最初の空白文字もしくは行末まで続く。それに続き quilt のオプションを任意で設定することができる。これは最初に空白文字に続いて (それ以降が行末までコメントであることを示す) "#" が現れた位置もしくは行末まで続く。

note: type: Plain text
en: dpkg-split - Debian package archive split/join tool
ja: dpkg-split - Debian パッケージアーカイブの分割/統合ツール

note: type: Plain text
en: B<dpkg-split> splits Debian binary package files into smaller parts and reassembles them again, to support the storage of large package files on small media such as floppy disks.
ja: B<dpkg-split> は Debian バイナリパッケージのファイルを小さいパートに分割したり、それらを再度統合したりするツールであり、フロッピーディスクのような容量の小さい媒体上に、サイズの大きいパッケージファイルを保管できるようにする。

note: type: Plain text
en: It can be operated manually using the B<--split>, B<--join> and B<--info> options.
ja: これは、B<--split>, B<--join>, B<--info> オプションを手動で指定することにより行われる。

note: type: Plain text
en: It also has an automatic mode, invoked using the B<--auto> option, where it maintains a queue of parts seen but not yet reassembled and reassembles a package file when it has seen all of its parts. The B<--listq> and B<--discard> options allow the management of the queue.
ja: B<dpkg-split> には B<--auto> オプションにより実行される自動モードも備わっている。自動モードでは、存在しているがまだ統合されていないパートのキューを管理することで、すべてのパートが確認できた時点でそれらを統合する。キューの管理は、B<--listq> および B<--discard> オプションで行うことができる。

note: type: Plain text
en: All splitting, joining and queueing operations produce informative messages on standard output; these may safely be ignored.
ja: 分割、統合、キューイング処理のいずれも、標準出力に有用なメッセージを出力する。これらは無視しても問題ない。

note: type: Plain text
en: Splits a single Debian binary package into several parts.
ja: 単一の Debian バイナリパッケージを幾つかのパートに分割する。

note: type: Plain text
en: The parts are named I<prefix>B<.>I<N>B<of>I<M>B<.deb> where I<N> is the part number, starting at 1, and I<M> is the total number of parts (both in decimal).
ja: 各パートは、I<prefix>B<.>I<N>B<of>I<M>B<.deb> のように名づけられる。ここで、I<N> は 1 から始まるパート番号であり、I<M> はパートの総数である (いずれも 10 進数である)。

note: type: Plain text
en: If no I<prefix> is supplied then the I<complete-archive> filename is taken, including directory, with any trailing B<.deb> removed.
ja: I<prefix> が指定されていない場合は、I<complete-archive> ファイル名が、ディレクトリ部分も含めて用いられるが、末尾の B<.deb> 部分は削除される。

note: type: Plain text
en: Joins the parts of a package file together, reassembling the original file as it was before it was split.
ja: パッケージファイルのパート群を集約して、分割前のオリジナルファイルに統合する。

note: type: Plain text
en: The part files given as arguments must be all the parts of exactly the same original binary file. Each part must occur exactly once in the argument list, though the parts to not need to be listed in order.
ja: 引数として指定された各パートのファイルは、オリジナルのバイナリファイルのすべてのパートを含んでいること。パートを順番に並べて指定する必要はないが、同じパートのファイルを複数回指定することはできない。

note: type: Plain text
en: The parts must of course all have been generated with the same part size specified at split time, which means that they must usually have been generated by the same invocation of B<dpkg-split --split>.
ja: 各パートは分割時に指定されたサイズが同一である必要がある。これは、通常各パートが単一の B<dpkg-split --split> の実行から生成されることを意味する。

note: type: Plain text
en: The parts' filenames are not significant for the reassembly process.
ja: パートのファイル名は、統合処理において重要ではない。

note: type: Plain text
en: By default the output file is called I<package>B<_>I<version>B<_>I<arch>B<.deb>.
ja: 生成されたファイルは、デフォルトで I<package>B<_>I<version>B<_>I<arch>B<.deb> というファイル名になる。

note: type: Plain text
en: Prints information, in a human-readable format, about the part file(s)  specified. Arguments which are not binary package parts produce a message saying so instead (but still on standard output).
ja: パートのファイルに関する情報を人が読みやすい形式で表示する。バイナリパッケージのパート以外のファイルが引数で指定された場合は、それを指摘するメッセージを (標準出力に) 代わりに表示する。

note: type: Plain text
en: Automatically queue parts and reassemble a package if possible.
ja: 自動的にパートをキューイングして、可能であればパッケージを再統合する。

note: type: Plain text
en: The I<part> specified is examined, and compared with other parts of the same package (if any) in the queue of packages file parts.
ja: I<part> で指定されたパートが検査され、同じパッケージファイルのパートのキューにあるパッケージの別のパート (もしあれば) と比較される。

note: type: Plain text
en: If all parts of the package file of which I<part> is a part are available then the package is reassembled and written to I<complete-output> (which should not usually already exist, though this is not an error).
ja: I<part> が属するパッケージファイルのすべてのパートが利用可能な場合、パッケージは統合され、I<complete-output> に書き出される (ファイルが既存の場合もエラーとはならないが、通常は推奨されない)。

note: type: Plain text
en: If not then the I<part> is copied into the queue and I<complete-output> is not created.
ja: それ以外の場合、I<part> がキューにコピーされ、I<complete-output> は作成されない。

note: type: Plain text
en: If I<part> is not a split binary package part then B<dpkg-split> will exit with status B<1>; if some other trouble occurs then it will exit with status B<2>.
ja: I<part> が分割されたバイナリパッケージのパート以外の場合、B<dpkg-split> は戻り値 B<1> で終了する。何らかのトラブルが発生した場合、戻り値 B<2> で終了する。

note: type: Plain text
en: The B<--output> or B<-o> option must be supplied when using B<--auto>.  (If this were not mandatory the calling program would not know what output file to expect.)
ja: B<--auto> を使用する場合、B<--output> もしくは B<-o> オプションも指定すること (これを必須にしないと、呼び出したプログラムが出力ファイル名を知る術がなくなってしまう)。

note: type: Plain text
en: Lists the contents of the queue of packages to be reassembled.
ja: 統合されるパッケージのキューの内容を一覧表示する。

note: type: Plain text
en: For each package file of which parts are in the queue the output gives the name of the package, the parts in the queue, and the total number of bytes stored in the queue.
ja: キューにパートが存在している各パッケージファイルについて、パッケージ名とキューにあるパート、キューに格納されているバイト数が出力される。

note: type: Plain text
en: This discards parts from the queue of those waiting for the remaining parts of their packages.
ja: パッケージの残りのパートが揃うまでキューに格納されているパートをキューから削除する。

note: type: Plain text
en: If no I<package> is specified then the queue is cleared completely; if any are specified then only parts of the relevant package(s) are deleted.
ja: I<package> が指定されなかった場合、キューは完全に消去される。何らかのパッケージが指定された場合、そのパッケージのパートのみが削除される。

note: type: Plain text
en: Specifies an alternative directory for the queue of parts awaiting automatic reassembly. The default is B</var/lib/dpkg>.
ja: 自動的な統合を待っているパートのキューが置かれているディレクトリを指定する。デフォルトは B</var/lib/dpkg> である。

note: type: Plain text
en: Specifies the maximum part size when splitting, in kibibytes (1024 bytes). The default is 450 KiB.
ja: ファイル分割の際のパートの最大サイズを kibibyte (1024 byte) 単位で指定する。デフォルトは 450 KiB である。

note: type: Plain text
en: Specifies the output file name for a reassembly.
ja: 統合の際の出力ファイル名を指定する。

note: type: Plain text
en: This overrides the default for a manual reassembly (B<--join>)  and is mandatory for an automatic queue-or-reassemble (B<--auto>).
ja: これは、(B<--join> による) 手動統合の際のデフォルトのファイル名に優先する。また、(B<--auto> による) 自動でのキューイングおよび統合の際には必須である。

note: type: Plain text
en: When doing automatic queue-or-reassembly B<dpkg-split> usually prints a message if it is given a I<part> that is not a binary package part. This option suppresses this message, to allow programs such as B<dpkg> to cope with both split and unsplit packages without producing spurious messages.
ja: 自動でのキューイングおよび統合が行われる際、B<dpkg-split> は通常バイナリパッケージのパートでない I<part> が指定されるとメッセージを出力するが、このオプションによりメッセージが抑止され、B<dpkg> のようなプログラムがパッケージの分割や統合を扱う際に、余計なメッセージを出力することが避けられる。

note: type: Plain text
en: Forces the output filenames generated by B<--split> to be msdos-compatible.
ja: B<--split> で生成される出力ファイル名として MS-DOS 互換のファイル名を強制する。

note: type: Plain text
en: This mangles the prefix - either the default derived from the input filename or the one supplied as an argument: alphanumerics are lowercased, plus signs are replaced by B<x>'s and all other characters are discarded.
ja: これにより、入力ファイル名から生成されたデフォルト値の prefix、引数として指定された prefix いずれもが切り詰められる。英数字は小文字にされ、プラス記号は B<x> に置き換えられ、その他の文字は破棄される。

note: type: Plain text
en: The result is then truncated as much as is necessary, and filenames of the form I<prefixN>B<of>I<M>B<.deb> are generated.
ja: 必要な切り詰めが行われた結果として、I<prefixN>B<of>I<M>B<.deb> 形式のファイル名が生成される。

note: type: Plain text
en: The requested split, merge, or other command succeeded.  B<--info> commands count as successful even if the files are not binary package parts.
ja: 要求された分割、統合、その他のコマンドは成功した。B<--info> コマンドはファイルがバイナリパッケージのパートでなかった場合も含め、成功としてカウントする。

note: type: Plain text
en: Only occurs with B<--auto> and indicates that the I<part> file was not a binary package part.
ja: B<--auto> の場合のみ発生し、I<part> ファイルがバイナリパッケージのパートではなかったことを示す。

note: type: Plain text
en: Some kind of trouble happened, such as a system call failure, a file that looked like a package part file but was corrupted, a usage error or some other problem.
ja: 何らかのトラブルが発生した。これにはシステムコールの失敗、ファイルはパッケージのパートのようだが壊れていた場合、文法エラーなどが含まれる。

note: type: Plain text
en: Full details of the packages in the queue are impossible to get without digging into the queue directory yourself.
ja: キューにあるパッケージの詳細は、キューディレクトリを自分で調べない限り確認することができない。

note: type: Plain text
en: There is no easy way to test whether a file that may be a binary package part is one.
ja: ファイルがバイナリパッケージのパートかどうかを簡単に確認する手段が存在しない。

note: type: Plain text
en: The default queue directory for part files awaiting automatic reassembly.
ja: パートを構成するファイルが自動統合を待機するデフォルトのキューディレクトリ。

note: type: Plain text
en: The filenames used in this directory are in a format internal to B<dpkg-split> and are unlikely to be useful to other programs, and in any case the filename format should not be relied upon.
ja: このディレクトリ内のファイル名は B<dpkg-split> の内部形式となっており、その他のプログラムから参照されることを想定していない。いかなる場合もファイル名の形式に依存すべきではない。

note: type: TH
en: Debian project
ja: Debian プロジェクト

note: type: Plain text
en: dpkg-statoverride - override ownership and mode of files
ja: dpkg-statoverride - ファイルの所有権やモードを変更する

note: type: Plain text
en: `B<stat overrides>' are a way to tell B<dpkg>(1)  to use a different owner or mode for a file when a package is installed. (note: I use the word `file' here, but in reality this can be any filesystem object that dpkg handles, including directories, devices, etc.). This can be used to force programs that are normally setuid to be install without a setuid flag, or only executable by a certain group.
ja: `B<stat override>' とは、パッケージがインストールされるときに、ファイルの所有者やモードを変更するよう B<dpkg>(1) に指示する方式である (補足: ここでは「ファイル」という言葉を使ったが、実際には dpkg が扱えるファイルシステムオブジェクトならなんでもよい。つまりディレクトリやデバイスなどでも OK)。これを用いると、通常 setuid されるプログラムを setuid フラグ無しでインストールしたり、特定のグループのみに実行許可を与えるようにしたりできる。

note: type: Plain text
en: B<dpkg-statoverride> is a utility to manage the list of stat overrides. It has three basic functions: adding, removing and listing overrides.
ja: B<dpkg-statoverride> は stat override のリストを管理するユーティリティである。これには override を追加、削除、表示するという 3 つの基本機能がある。

note: type: Plain text
en: Add an override for I<file>. I<file> does not need to exist when this command is used; the override will be stored and used later.  Users and groups can be specified by their name (for example B<root> or B<nobody>), or by their number by prepending the number with a `B<#>' (for example B<#0> or B<#65534>). The I<mode> needs to be specified in octal.
ja: I<file> に対する override を追加する。 I<file> はコマンドの実行時に存在していなくてもよい。override は保存され、後で用いられる。ユーザとグループは (例えば B<root> や B<nobody> といった) 名前でも指定できるし、 (例えば B<#0> や B<#65534> といった) 前に `B<#>' 文字をつけた数字でも指定できる。

note: type: Plain text
en: If --update is specified and I<file> exists, it is immediately set to the new owner and mode.
ja: --update が指定された際に I<file> が存在していた場合、即座に所有者とモードが新しい値に変更される。

note: type: Plain text
en: Remove an override for I<file>, the status of I<file> is left unchanged by this command.
ja: I<file> に対する override を削除する。このコマンドで I<file> の状態が変化することはない。

note: type: Plain text
en: List all overrides. If a glob pattern is specified restrict the output to overrides which match the glob. If there are no overrides or none match the glob B<dpkg-statoverride> will exit with an exitcode of 1.
ja: override をすべてリストする。glob パターンが指定された場合は、マッチした override のみを出力する。override が全くない場合や、glob にマッチするものがひとつもなかった場合は、B<dpkg-statoverride> は終了コード 1 で終了する。

note: type: Plain text
en: Change the I<directory> of the dpkg database where the statoverride file is also stored. Defaults to I</var/lib/dpkg>.
ja: dpkg データベースのディレクトリを変更する。statoverride ファイルもここに保存される。デフォルトは I</var/lib/dpkg> である。

note: type: Plain text
en: Force an action, even if a sanity check would otherwise prohibit it.  This is necessary to override an existing override.
ja: sanity チェック (正気度チェック) が禁止するような場合でも、強制的に処理を行う。既存の override を変更する場合には、これを指定する必要がある。

note: type: Plain text
en: Immediately try to change the file to the new owner and mode if it exists.
ja: ファイルが存在する場合は、直ちにその所有者とモードを新しい値に変更しようとする。

note: type: Plain text
en: Be less verbose about what we do.
ja: 動作に関して多くの出力を行わない。

note: type: Plain text
en: File which contains the current list of stat overrides of the system. It is located in the dpkg administration directory, along with other files important to dpkg, such as `status' or `available'.
ja: システムの現在の stat override のリストが書かれたファイル。dpkg の管理ディレクトリに、dpkg にとって重要な他のファイル (`status' や `available' など) と一緒に置かれる。

note: type: Plain text
en: Note: B<dpkg-statoverride> preserves the old copy of this file, with extension "-old", before replacing it with the new one.
ja: 注記: B<dpkg-statoverride> は、このファイルを新しいもので置き換える前に、古いファイルのコピーを "-old" を付加した名前で保存する。

note: type: Plain text
en: dpkg-trigger - a package trigger utility
ja: dpkg-trigger - パッケージトリガユーティリティ

note: type: Plain text
en: B<dpkg-trigger> is a tool to explicitly activate triggers and check for its support on the running B<dpkg>.
ja: B<dpkg-trigger> は、トリガを明示的に有効化したり、B<dpkg> の実行時に、トリガのサポートをチェックしたりするツールである。

note: type: Plain text
en: This can be used by maintainer scripts in complex and conditional situations where the file triggers, or the declarative B<activate> triggers control file directive, are insufficiently rich. It can also be used for testing and by system administrators (but note that the triggers won't actually be run by B<dpkg-trigger>).
ja: これは、ファイルトリガや宣言された B<有効化した>トリガ制御ファイルのディレクティブが不十分であるような、複雑で条件付きの判定を行うような場合に、メンテナスクリプトによって使用される。また、これはテスト時やシステム管理者からも使用できる (ただし、B<dpkg-trigger> はトリガ自体を実行するものではないことに注意)。

note: type: Plain text
en: Unrecognized trigger name syntaxes are an error for B<dpkg-trigger>.
ja: トリガ名の文法が認識されなかった場合、B<dpkg-trigger> はエラーとなる。

note: type: Plain text
en: Check if the running B<dpkg> supports triggers (usually called from a postinst). Will exit B<0> if a triggers-capable B<dpkg> has run, or B<1> with an error message to stderr if not. Normally, however, it is better just to activate the desired trigger with B<dpkg-trigger>.
ja: 実行中の B<dpkg> がトリガをサポートしているかをチェックする (通常これはpostinst から呼び出される)。トリガを実行可能な B<dpkg> が実行中の場合は、 B<0> が返却され、それ以外の場合は B<1> が返却されるとともに、標準エラー出力にエラーメッセージが出力される。ただし、普通の使い方としては、単にB<dpkg-trigger> を用いて使用したいトリガを有効化することが望ましい。

note: type: Plain text
en: Override trigger awaiter (normally set by B<dpkg> through the B<DPKG_MAINTSCRIPT_PACKAGE> environment variable of the maintainer scripts, naming the package to which the script belongs, and this will be used by default).
ja: トリガを待機するパッケージ名 (通常メンテナスクリプトの B<DPKG_MAINTSCRIPT_PACKAGE> 環境変数を通じて B<dpkg> によってスクリプトが含まれるパッケージ名に設定され、デフォルトでこの名前が用いられる) を上書きする。

note: type: Plain text
en: This option arranges that the calling package T (if any) need not await the processing of this trigger; the interested package(s) I, will not be added to T's trigger processing awaited list and T's status is unchanged.  T may be considered installed even though I may not yet have processed the trigger.
ja: このオプションは、呼び出し側のパッケージ T (もしあれば) が、このトリガの処理を待機する必要がないように設定する。これは、関連パッケージ I が T のトリガ処理待ちリストに追加されず、T のステータスも変更されないことを意味する。I のトリガ処理が完了していない場合であっても、T はインストールされたと見なされる。

note: type: Plain text
en: Just test, do not actually change anything.
ja: テスト用、実際にはいかなる変更も行わない。

note: type: Plain text
en: B<dpkg>(1), B<deb-triggers>(5), B</usr/share/doc/dpkg-dev/triggers.txt.gz>.
ja: B<dpkg>(1), B<deb-triggers>(5), B</usr/share/doc/dpkg-dev/triggers.txt.gz>

note: type: Plain text
en: dpkg-vendor - queries information about distribution vendors
ja: dpkg-vendor - 配布ベンダに関する情報をクエリする

note: type: Plain text
en: B<dpkg-vendor> is a tool to query information about vendors listed in B</etc/dpkg/origins>. B</etc/dpkg/origins/default> contains information about the current vendor.
ja: B<dpkg-vendor> は、B</etc/dpkg/origins> にリストされたベンダに関する情報をクエリするツールである。現在のベンダの情報は、B</etc/dpkg/origins/default> に格納されている。

note: type: Plain text
en: Exits with B<0> if the current vendor is I<vendor>. Otherwise exits with non-zero.
ja: 現在のベンダが I<vendor> の場合、戻り値 B<0> で終了する。それ以外の場合 0 以外の戻り値で終了する。

note: type: Plain text
en: Exits with B<0> if the current vendor distribution is a derivative of I<vendor>, otherwise exits with non-zero. It uses the "Parent" field to browse all ancestors of the current vendor.
ja: 現在のベンダディストリビューションが I<vendor> の派生であった場合、戻り値 B<0> で終了する。それ以外の場合 0 以外の戻り値で終了する。現在のベンダの祖先をたどるために、"Parent" フィールドが使用される。

note: type: Plain text
en: Print on standard output the value of the vendor-specific I<field> for the current vendor.
ja: 標準出力に、現在のベンダのベンダ固有の I<field> の値を出力する。

note: type: Plain text
en: Assumes the current vendor is I<vendor> instead of discovering it with the B<DEB_VENDOR> environment variable or B</etc/dpkg/origins/default>.
ja: 現在のベンダが、B<DEB_VENDOR> 環境変数や B</etc/dpkg/origins/default> から確認された値ではなく、I<vendor> であると見なす。

note: type: Plain text
en: This setting defines the current vendor. If not set, it will discover the current vendor by reading B</etc/dpkg/origins/default>.
ja: 現在のベンダを定義する設定。設定されていなかった場合、現在のベンダは B</etc/dpkg/origins/default> から設定される。

note: type: Plain text
en: dselect - Debian package management frontend
ja: dselect - Debian パッケージ管理フロントエンド

note: type: Plain text
en: B<dselect>
    is one of the primary user interfaces for managing packages on a Debian
    system. At the B<dselect> main menu, the system administrator can:
     - Update the list of available package versions,
     - View the status of installed and available packages,
     - Alter package selections and manage dependencies,
     - Install new packages or upgrade to newer versions.
ja: B<dselect> は、Debian システムにおけるパッケージ管理用ユーザインタフェースとして主要なものの一つである。システム管理者は、B<dselect> のメインメニューから以下の操作を行える。
     - 取得可能パッケージのバージョンリストの更新
     - インストール済、利用可能パッケージ状況の参照
     - パッケージ選択の変更や依存関係の管理
     - 新規パッケージのインストールや新バージョンへのアップグレード

note: type: Plain text
en: B<dselect> operates as a front-end to B<dpkg>(1), the low-level debian package handling tool. It features a full-screen package selections manager with package depends and conflicts resolver. When run with administrator privileges, packages can be installed, upgraded and removed. Various access methods can be configured to retrieve available package version information and installable packages from package repositories.  Depending on the used access method, these repositories can be public archive servers on the internet, local archive servers or cdroms.  The recommended access method is I<apt>, which is provided by the package B<apt>.
ja: B<dselect> は、下位に位置する Debian パッケージ管理ツールである B<dpkg>(1) のフロントエンドとして動作する。これは、フルスクリーンのパッケージ選択管理ツールであり、パッケージの依存関係や競合の解決を行なうことができる点が特徴である。管理者権限で起動することで、パッケージのインストール、更新、削除を行うことができるとともに、様々な方式により、パッケージリポジトリから利用可能パッケージのバージョン情報や、インストール可能パッケージの情報を取得するための設定を行うことができる。使用するアクセス方式に応じて、リポジトリをインターネット上の公開サーバ、ローカルサーバ、CD-ROM に設定することができる。推奨するアクセス方式は、B<apt> パッケージで提供される I<apt> である。

note: type: Plain text
en: Normally B<dselect> is invoked without parameters. An interactive menu is presented, offering the user a list of actions. If an action is given as argument, then that action is started immediately. Several command line parameters are still available to modify the running behaviour of B<dselect> or show additional information about the program.
ja: 通常 B<dselect> は引数なしで起動される。これにより、対話的メニューが表示され、ユーザ対してアクションのリストが提供される。一方、引数でアクションを与えられた場合は、そのアクションが直ちに実行される。コマンドライン引数により、B<dselect> の動作を変更したり、プログラムに関する補足情報を表示させたりすることができる。

note: type: Plain text
en: All options can be specified both on the command line and in the B<dselect> configuration file I</etc/dpkg/dselect.cfg> or the files on the configuration directory I</etc/dpkg/dselect.cfg.d/>. Each line in the configuration file is either an option (exactly the same as the command line option but without leading dashes) or a comment (if it starts with a B<#>).
ja: オプションはすべて、コマンドラインと B<dselect> の設定ファイル I</etc/dpkg/dselect.cfg> もしくは設定ディレクトリ I</etc/dpkg/dselect.cfg.d/> の両方で指定できる。設定ファイル中の各行には、オプション (正確にはコマンドラインオプションから先頭のダッシュを除いたもの) か、コメント (行が B<#> で始まる場合) を記述する。

note: type: Plain text
en: Changes the directory where the dpkg `I<status>', `I<available>' and similar files are located. This defaults to I</var/lib/dpkg> and normally there shouldn't be any need to change it.
ja: dpkg が使用する `I<status>' ファイルや `I<available>' ファイルなどを置くディレクトリを変更する。デフォルトは I</var/lib/dpkg> で、通常変更する必要はない。

note: type: Plain text
en: Turn on debugging. Debugging information is sent to I<file>.
ja: デバッグを有効にする。デバッグ情報は I<file> に送られる。

note: type: Plain text
en: Turns on expert mode, i.e. doesn't display possibly annoying help messages.
ja: エキスパートモードを有効にする。つまり、煩雑なヘルプを表示しない。

note: type: Plain text
en: Configures screen colors. This works only if your display supports colors.  This option may be used multiple times (and is best used in I<dselect.cfg>). Each use changes the color (and optionally, other attributes) of one part of the screen.  The parts of the screen (from top to bottom) are:
ja: 表示色を設定する。ディスプレイがカラー表示をサポートしている場合に有効である。このオプションは、複数回指定できる ( I<dselect.cfg> での使用が推奨されている)。各設定ごとに、画面のある部位の色 (や他の属性) が変更される。画面の部位の名称は (上から順に) 次のとおり:

note: type: Plain text
en: The screen title.
ja: 画面タイトル

note: type: Plain text
en: The header line above the list of packages.
ja: パッケージリストの上部にあるヘッダライン

note: type: Plain text
en: The scrolling list of packages (and also some help text).
ja: パッケージリストのスクロール領域 (ヘルプも表示される)

note: type: Plain text
en: The selected item in the list.
ja: リスト内の選択行

note: type: Plain text
en: In the list of packages, the text indicating the current state of each package.
ja: パッケージリスト内で、各パッケージの状況を示すテキスト

note: type: Plain text
en: In the list of packages, the text indicating the current state of the currently selected package.
ja: パッケージリスト内で、選択したパッケージの状況を示すテキスト

note: type: Plain text
en: The header line that displays the state of the currently selected package.
ja: 現在選択しているパッケージの状況を表示するヘッダ行

note: type: Plain text
en: The package's short description.
ja: パッケージの短い説明文

note: type: Plain text
en: Used to display package info such as the package's description.
ja: パッケージの説明などパッケージの情報を表示するために用いられる

note: type: Plain text
en: The last line of the screen when selecting packages.
ja: パッケージ選択時の画面最下行

note: type: Plain text
en: Used to display query lines
ja: クエリ行を表示するために用いられる

note: type: Plain text
en: Color of help screens.
ja: ヘルプ画面の色

note: type: Plain text
en: After the part of the screen comes a colon and the color specification. You can specify either the foreground color, the background color, or both, overriding the compiled-in colors. Use standard curses color names.
ja: 画面の部位を示すキーワードの後に、コロンに続き色設定を記述する。前景色、背景色、あるいは両方を指定でき、コンパイル時に指定した色設定に優先する。標準の curses 色名称を使用すること。

note: type: Plain text
en: Optionally, after the color specification is another colon, and an attribute specification. This is a list of one or more attributes, separated by plus ("+") characters. Available attributes include (not all of these will work on all terminals): normal, standout, underline, reverse, blink, bright, dim, bold
ja: 色設定の後に、コロンに続き、オプションで属性を設定してもよい。これはプラス("+")文字によって区切られた、1 つ以上の属性のリストである。利用可能な属性を以下に示す(すべての属性がすべての端末で有効とは限らない): normal, standout, underline, reverse, blink, bright, dim, bold

note: type: Plain text
en: Print a brief help text and exit successfully.
ja: 簡単なヘルプを表示し、正常終了する。

note: type: Plain text
en: Print version information and exit successfully.
ja: バージョン情報を表示し、正常終了する。

note: type: Plain text
en: When B<dselect> is started it can perform the following actions, either directly if it was specified on the command line or by prompting the user with a menu of available actions if running interactively:
ja: B<dselect> を起動すると、次のようなアクションを実行することができる。これは、コマンドラインで直接指定してもよいし、対話的に実行されている場合は、利用可能なアクションの一覧メニューから、ユーザに選択させる形式でもよい。

note: type: SS
en: access
ja: アクセス (access)

note: type: Plain text
en: Choose and configure an access method to access package repositories.
ja: パッケージリポジトリにアクセスするアクセス方式を選択、設定する。

note: type: Plain text
en: By default, B<dselect> provides several methods such as I<cdrom>, I<multi_cd>, I<nfs>, I<multi_nfs>, I<harddisk>, I<mounted>, I<multi_mount>, I<floppy> or I<ftp>, but other packages may provide additional methods, eg. the I<apt> access method provided by the B<apt> package.
ja: デフォルトで、 B<dselect> は I<cdrom>, I<multi_cd>, I<nfs>, I<multi_nfs>, I<harddisk>, I<mounted>, I<multi_mount>, I<floppy>, I<ftp> といった、いくつかの方式を提供する。しかし、他のパッケージが追加アクセス方式を提供することもある。例えば、I<apt> アクセス方式は B<apt> パッケージで提供される。

note: type: Plain text
en: The use of the I<apt> access method is strongly recommended.
ja: I<apt> アクセス方式の使用を、強く推奨する。

note: type: SS
en: update
ja: 更新 (update)

note: type: Plain text
en: Refresh the available packages database.
ja: 取得可能パッケージのデータベースを更新する。

note: type: Plain text
en: Retrieves a list of available package versions from the package repository, configured for the current access method, and update the dpkg database. The package lists are commonly provided by the repository as files named I<Packages> or I<Packages.gz>.  These files can be generated by repository maintainers, using the program B<dpkg-scanpackages>(1).
ja: 取得可能パッケージのバージョンリストを、現在設定しているアクセス方式でパッケージリポジトリから取得し、dpkg データベースを更新する。パッケージ一覧は、一般的には I<Packages> や I<Packages.gz> という名前で、リポジトリから提供されている。リポジトリ管理者は、B<dpkg-scanpackages>(1) というプログラムを使用して、このファイルを生成することができる。

note: type: Plain text
en: Details of the update action depend on the access method's implementation.  Normally the process is straightforward and requires no user interaction.
ja: 更新アクションの詳細は、アクセス方式の実装に依存する。通常、この処理は単純で、ユーザの入力を必要としない。

note: type: SS
en: select
ja: 選択 (select)

note: type: Plain text
en: View or manage package selections and dependencies.
ja: パッケージの選択や依存関係の表示、管理を行う。

note: type: Plain text
en: This is the main function of B<dselect>. In the select screen, the user can review a list of all available and installed packages. When run with administrator privileges, it is also possible to interactively change packages selection state. B<dselect> tracks the implications of these changes to other depending or conflicting packages.
ja: これは B<dselect> の主たる機能である。この画面で取得可能なパッケージやインストール済パッケージリストを確認できる。管理者権限で実行すると、対話的にパッケージの選択状況を変更することもできる。 B<dselect> は、変更に伴って発生する依存、競合パッケージについても検出する。

note: type: Plain text
en: When a conflict or failed depends is detected, a dependency resolution subscreen is prompted to the user. In this screen, a list of conflicting or depending packages is shown, and for each package listed, the reason for its listing is shown. The user may apply the suggestions proposed by B<dselect>, override them, or back out all the changes, including the ones that created the unresolved depends or conflicts.
ja: 競合や解決できない依存関係を検出すると、依存関係解決サブ画面をユーザに提示する。この画面では、競合パッケージや依存パッケージのリストが、その理由とともに表示される。ユーザは、B<dselect> が提案した変更案を適用してもよいし、その案を修正してもよい。また、解決できない依存関係や競合を発生させた変更を含む、すべての変更を元に戻すこともできる。

note: type: Plain text
en: The use of the interactive package selections management screen is explained in more detail below.
ja: 対話的なパッケージ選択管理画面の詳細な使い方については後述する。

note: type: SS
en: install
ja: 導入 (install)

note: type: Plain text
en: Installs selected packages.
ja: 選択したパッケージをインストールする。

note: type: Plain text
en: The configured access method will fetch installable or upgradable packages from the relevant repositories and install these using B<dpkg>.  Depending on the implementation of the access method, all packages can be prefetched before installation, or fetched when needed.  Some access methods may also remove packages that were marked for removal.
ja: 新規インストール、更新が可能なパッケージを、設定したアクセス方式で適切なリポジトリより取得し、 B<dpkg> を用いてインストールを行う。インストール前にパッケージをすべて取得するか、必要な時に取得するかは、アクセス方式の実装によって異なる。アクセス方式によって、削除マークをつけたパッケージの削除を行う場合もある。

note: type: Plain text
en: If an error occurred during install, it is usually advisable to run install again. In most cases, the problems will disappear or be solved.  If problems persist or the installation performed was incorrect, please investigate into the causes and circumstances, and file a bug in the Debian bug tracking system. Instructions on how to do this can be found at http://bugs.debian.org/ or by reading the documentation for B<bug>(1) or B<reportbug>(1), if these are installed.
ja: インストール中にエラーが発生した場合は、通常インストールを再度行うことを推奨する。大半の場合、問題は再発しないか解決されるが、問題が解決しなかったりインストールが適切に行われていなかったりする場合は、原因や環境を調べて、Debian バグ追跡システムへバグ報告をしていただきたい。バグ報告の方法は、http://bugs.debian.org/ や、B<bug>(1) や B<reportbug>(1) がインストールされていれば、それらの文書を参照のこと。

note: type: Plain text
en: Details of the install action depend on the access method's implementation.  The user's attention and input may be required during installation, configuration or removal of packages. This depends on the maintainer scripts in the package. Some packages make use of the B<debconf>(1)  library, allowing for more flexible or even automated installation setups.
ja: 導入アクションの詳細はアクセス方式の実装に依存する。パッケージのインストール、設定、削除中に、ユーザに対する確認が発生したり、入力が要求されたりする場合もある。これはパッケージのメンテナスクリプトに依存する。パッケージによっては、B<debconf>(1) ライブラリを用いており、より柔軟で自動化されたインストールセットアップが可能である。

note: type: SS
en: config
ja: 設定 (config)

note: type: Plain text
en: Configures any previously installed, but not fully configured packages.
ja: すでにインストール済みだが、設定が完了していないパッケージの設定を行う。

note: type: SS
en: remove
ja: 削除 (remove)

note: type: Plain text
en: Removes or purges installed packages, that are marked for removal.
ja: 削除マークをつけたインストール済パッケージの削除や完全削除を行う。

note: type: SS
en: quit
ja: 終了 (quit)

note: type: Plain text
en: Quit B<dselect>
ja: B<dselect> を終了する。

note: type: Plain text
en: Exits the program with zero (successful) errorcode.
ja: エラーコード 0 (成功) でプログラムを終了する。

note: type: SH
en: Package selections management
ja: パッケージ選択管理

note: type: SS
en: Introduction
ja: 概要

note: type: Plain text
en: B<dselect> directly exposes the administrator to some of the complexities involved with managing large sets of packages with many interdependencies. For a user who is unfamiliar with the concepts and the ways of the debian package management system, it can be quite overwhelming. Although B<dselect> is aimed at easing package management and administration, it is only instrumental in doing so and can not be assumed to be a sufficient substitute for administrator skill and understanding. The user is required to be familiar with the concepts underlying the Debian packaging system.  In case of doubt, consult the B<dpkg>(1) manpage and the Debian Policy manual, contained in the B<debian-policy> package.
ja: B<dselect> により、管理者は大量の相互依存関係を持つパッケージ群を管理する複雑さの一端に直面することになる。Debian パッケージ管理システムの概念や、その方法に慣れていないユーザにとって、これは圧倒的ですらある。 B<dselect> は、パッケージ管理と管理作業の負担緩和を目指しているが、あくまで負担緩和に役立つだけで、管理者としての技術や知識の代用にはならない。管理者には、Debian パッケージングシステムについての基礎概念に精通することが要求される。不明点があれば、B<dpkg>(1) のマニュアルや、B<debian-policy> パッケージに含まれている Debian ポリシーマニュアルを参照してほしい。

note: type: Plain text
en: Unless B<dselect> is run in expert or immediate mode, a help screen is first displayed when choosing this action from the menu. The user is I<strongly> advised to study all of the information presented in the online help screens, when one pops up.  The online help screens can at any time be invoked with the B<'?'> key.
ja: B<dselect> がエキスパートモードや直接モードで起動されない場合、メニューからアクションを選ぶ際には、まずヘルプ画面が表示される。オンラインヘルプ画面がポップアップした際には、示された内容にすべて目を通すように I<強く>推奨する。オンラインヘルプ画面は、いつでも B<'？'> キーで表示できる。

note: type: SS
en: Screen layout
ja: 画面レイアウト

note: type: Plain text
en: The select screen is by default split in a top and a bottom half.  The top half shows a list of packages. A cursor bar can select an individual package, or a group of packages, if applicable, by selecting the group header. The bottom half of the screen shows some details about the package currently selected in the top half of the screen.  The type of detail that is displayed can be varied.
ja: 選択画面は、デフォルトで上下 2 分割されている。上半分はパッケージのリストを表示している。カーソルバーで個々のパッケージを選択したり、グループヘッダ (存在していれば) を選択して、パッケージグループを選択したりできる。画面の下半分は、画面の上半分で現在選択しているパッケージの詳細が表示される。表示される詳細の形式は変更できる。

note: type: Plain text
en: Pressing the B<'I'> key toggles a full-screen display of the packages list, an enlarged view of the package details, or the equally split screen.
ja:  B<'I'> キーを押すごとに、パッケージリストの全画面表示、パッケージ詳細の拡大、画面の均等分割が切り替えられる。

note: type: SS
en: Package details view
ja: パッケージ詳細表示

note: type: Plain text
en: The package details view by default shows the extended package description
    for the package that is currently selected in the packages status list.
    The type of detail can be toggled by pressing the B<'i'> key. This
    alternates between:
     - the extended description
     - the control information for the installed version
     - the control information for the available version
ja: デフォルトのパッケージ詳細表示部は、パッケージ状況リスト内で現在選択されているパッケージの詳細なパッケージ説明文を表示する。詳細の形式は B<'i'> キーを押すごとに以下が切り替わる。
     - 詳細な説明文
     - インストール済バージョンの制御情報
     - 取得可能バージョンの制御情報

note: type: Plain text
en: In a dependency resolution screen, there is also the possibility of viewing the specific unresolved depends or conflicts related to the package and causing it to be listed.
ja: 依存関係解決画面で、特定のパッケージに関連する未解決な依存関係、競合関係が、その原因とともに表示される場合もある。

note: type: SS
en: Packages status list
ja: パッケージ状況リスト

note: type: Plain text
en: The main select screen displays a list of all packages known to the debian package management system. This includes packages installed on the system and packages known from the available packages database.
ja: 主たる選択画面には、Debian パッケージ管理システムが認識しているすべてのパッケージがリストされる。これには、システムにインストール済のパッケージと、取得可能パッケージのデータベースが認識しているパッケージが含まれる。

note: type: Plain text
en: For every package, the list shows the package's status, priority, section, installed and available versions, the package name and its short description, all in one line. By pressing the B<'V'> key, the display of the installed and available version can be toggled between on an off. By pressing the B<'v'> key, the package status display is toggled between verbose and shorthand.  Shorthand display is the default.
ja: リストにはパッケージごとに、パッケージの状況、優先度、セクション、インストール済、取得可能バージョン、パッケージ名、短い説明文が 1 行で表示される。 B<'V'> キーを押すと、インストール済バージョンと取得可能バージョンの表示、非表示を切り替える。 B<'v'> キーを押すと、パッケージ状況の詳細表示と簡略表示を切り替える。簡略表示がデフォルトである。

note: type: Plain text
en: The shorthand status indication consists of four parts: an error flag, which should normally be clear, the current status, the last selection state and the current selection state.  The first two relate to the actual state of the package, the second pair are about the selections set by the user.
ja: 簡略表示における状況は、エラーフラグ (通常クリアされている)、現在の状況、現在の選択状況、新規の選択状況の 4 パートからなる。始めの 2 つはパッケージの現在の状況を表し、後の 2 つはユーザが設定した選択状況を示している。

note: type: Plain text
en: These are the meanings of the shorthand package status indicator codes:
     Error flag:
      I<empty>   no error
      B<R>       serious error, needs reinstallation;
     Installed state:
      I<empty>   not installed;
      B<*>       fully installed and configured;
      B<->       not installed but some config files may remain;
      B<U>       unpacked but not yet configured;
      B<C>       half-configured (an error happened);
      B<I>       half-installed (an error happened).
     Current and requested selections:
      B<*>       marked for installation or upgrade;
      B<->       marked for removal, configuration files remain;
      B<=>       on hold: package will not be processed at all;
      B<_>       marked for purge, also remove configuration;
      B<n>       package is new and has yet to be marked.
ja: 簡略表示におけるパッケージ状況の略号には以下の意味がある。
     エラーフラグ:
      I<空>      エラーなし
      B<R>       深刻なエラー (要再インストール)
     インストール状況:
      I<空>      未インストール
      B<*>       インストール済で設定済
      B<->       未インストールだが設定ファイルが残っている
      B<U>       展開済だが未設定
      B<C>       半設定状況 (エラー発生)
      B<I>       半インストール状況 (エラー発生)
     現在の選択状況、新規の選択状況:
      B<*>       インストールもしくは更新マーク
      B<->       削除マーク (設定ファイルは残す)
      B<=>       保留 (パッケージに対する処理は行われない)
      B<_>       完全削除マーク (設定ファイルも削除する)
      B<n>       新規パッケージでまだマークが付けられていない

note: type: SS
en: Cursor and screen movement
ja: カーソルおよび画面移動

note: type: Plain text
en: The package selection list and the dependency conflict resolution screens can be navigated using motion commands mapped to the following keys:
ja: パッケージ選択リストや依存、競合関係解決画面では、以下のキーに割当てられた移動コマンドで操作することができる。

note: type: Plain text
en:   B<p, Up, k>           move cursor bar up
      B<n, Down, j>         move cursor bar down
      B<P, Pgup, Backspace> scroll list 1 page up
      B<N, Pgdn, Space>     scroll list 1 page down
      B<^p>                 scroll list 1 line up
      B<^n>                 scroll list 1 line down
      B<t, Home>            jump to top of list
      B<e, End>             jump to end of list
      B<u>                  scroll info 1 page up
      B<d>                  scroll info 1 page down
      B<^u>                 scroll info 1 line up
      B<^d>                 scroll info 1 line down
      B<B, Left-arrow>      pan display 1/3 screen left
      B<F, Right-arrow>     pan display 1/3 screen right
      B<^b>                 pan display 1 character left
      B<^f>                 pan display 1 character right
ja:   B<p, Up, k>           カーソルバーを上に移動
      B<n, Down, j>         カーソルバーを下に移動
      B<P, Pgup, Backspace> リストを 1 ページ上にスクロール
      B<N, Pgdn, Space>     リストを 1 ページ下にスクロール
      B<^p>                 リストを 1 行上にスクロール
      B<^n>                 リストを 1 行下にスクロール
      B<t, Home>            リストの先頭にジャンプ
      B<e, End>             リストの最後にジャンプ
      B<u>                  情報を 1 ページ上にスクロール
      B<d>                  情報を 1 ページ下にスクロール
      B<^u>                 情報を 1 行上にスクロール
      B<^d>                 情報を 1 行下にスクロール
      B<B, Left-arrow>      表示を 1/3 画面左にスクロール
      B<F, Right-arrow>     表示を 1/3 画面右にスクロール
      B<^b>                 表示を 1 文字左にスクロール
      B<^f>                 表示を 1 文字右にスクロール

note: type: SS
en: Searching and sorting
ja: 検索とソート

note: type: Plain text
en: The list of packages can be searched by package name. This is done by pressing B<'/'>, and typing a simple search string. The string is interpreted as a B<regex>(7)  regular expression.  If you add B<'/d'> to the search expression, dselect will also search in descriptions. If you add B<'/i'> the search will be case insensitive.  You may combine these two suffixes like this: B<'/id'>.  Repeated searching is accomplished by repeatedly pressing the B<'n'> or B<'\e'> keys, until the wanted package is found.  If the search reaches the bottom of the list, it wraps to the top and continues searching from there.
ja: パッケージリストはパッケージ名で検索することができる。これは、パッケージリストで  B<'/'> を押してから、単純な検索文字列を入力することで行える。この文字列は、正規表現 B<regex>(7) で解析される。検索文字列に続けて B<'/d'> を加えると、説明文からも検索する。 B<'/i'> を加えた場合は、大文字小文字の区別をしない。この 2 つの添字を B<'/id'> のように合わせることもできる。検索結果に対して B<'n'> ないし B<'\e'> キーを何度か押すと、目的のパッケージが得られるまで検索を繰り返せる。検索がリストの最後まで達すると、先頭に戻る。

note: type: Plain text
en: The list sort order can be varied by pressing
    the B<'o'> and B<'O'> keys repeatedly.
    The following nine sort orderings can be selected:
     alphabet          available           status
     priority+section  available+priority  status+priority
     section+priority  available+section   status+section
ja: リストのソート順は、B<'o'> と B<'O'> キーを何度か押して変更する。
    以下の 9 通りのソート順を選べる。
     アルファベット     取得可能             状況
     優先度+セクション  取得可能+優先度      状況+優先度
     セクション+優先度  取得可能+セクション  状況+セクション

note: type: Plain text
en: Where not listed above explicitly, alphabetic order is used as the final subordering sort key.
ja: 上記リストには明記されていないが、最終的にアルファベット順でのソートが行われる。

note: type: SS
en: Altering selections
ja: 選択の変更

note: type: Plain text
en: The requested selection state of individual packages may be
    altered with the following commands:
      B<+, Insert>    install or upgrade
      B<=, H>         hold in present state and version
      B<:, G>         unhold: upgrade or leave uninstalled
      B<-, Delete>    remove, but leave configuration
      B<_>            remove & purge configuration
ja: 各パッケージの新規選択状況は、以下のコマンドで変更できる。
      B<+, Insert>    インストール、更新する
      B<=, H>         現在の状況、バージョンで保留する
      B<:, G>         保留解除 (更新ないし未インストールのままとする)
      B<-, Delete>    削除、設定は残す
      B<_>            完全削除、設定も消す

note: type: Plain text
en: When the change request results in one or more unsatisfied depends or conflicts, B<dselect> prompts the user with a dependency resolution screen. This will be further explained below.
ja: 変更の結果、依存関係を充足できなかったり競合したりした場合、 B<dselect> は依存関係解決画面を表示する。これは後ほど説明する。

note: type: Plain text
en: It is also possible to apply these commands to groups of package selections, by pointing the cursor bar onto a group header. The exact grouping of packages is dependent on the current list ordering settings.
ja: グループヘッダ上にカーソルバーを移動して、パッケージ選択のグループにコマンドを適用することもできる。現在のリストのソート順設定によっては、パッケージのグループ化が適切に行われない場合がある。

note: type: Plain text
en: Proper care should be taken when altering large groups of selections, because this can instantaneously create large numbers of unresolved depends or conflicts, all of which will be listed in one dependency resolution screen, making them very hard to handle. In practice, only hold and unhold operations are useful when applied to groups.
ja: 大規模なグループの選択状況を変更する場合は、大量の未解決な依存、競合関係が一度に発生するため、十分注意すべきである。 これらは 1 つの依存関係解決画面にリストされることとなるため、これを操作するのは非常に難しい。グループに対する変更が実用的なのは、保留や保留解除の時ぐらいである。

note: type: SS
en: Resolving depends and conflicts
ja: 依存・競合関係の解決

note: type: Plain text
en: When the change request results in one or more unsatisfied depends or conflicts, B<dselect> prompts the user with a dependency resolution screen. First however, an informative help screen is displayed.
ja: 選択状況の変更により未解決の依存・競合関係が発生した場合、 B<dselect> は依存関係解決画面を表示する。なお、表示の前にヘルプ画面が表示される。

note: type: Plain text
en: The top half of this screen lists all the packages that will have unresolved depends or conflicts, as a result of the requested change, and all the packages whose installation can resolve any of these depends or whose removal can resolve any of the conflicts.  The bottom half defaults to show the depends or conflicts that cause the currently selected package to be listed.
ja: この画面の上半分には、選択された変更の結果として発生した未解決の依存、競合関係があるパッケージに加え、インストールすることで依存関係を解決するパッケージ、削除することで競合を解決するパッケージがすべて表示される。下半分には、現在選択されているパッケージが原因となっている依存や競合関係がデフォルトで表示される。

note: type: Plain text
en: When the sublist of packages is displayed initially, B<dselect> may have already set the requested selection status of some of the listed packages, in order to resolve the depends or conflicts that caused the dependency resolution screen to be displayed. Usually, it is best to follow up the suggestions made by B<dselect>.
ja: パッケージのサブリストの初期表示の時点で、B<dselect> は、依存関係解決画面の表示を引き起こしている依存や競合関係を解決するよう、リストしたパッケージの選択状況の一部をあらかじめ変更している場合がある。通常、B<dselect> による提案を採用するのが最良である。

note: type: Plain text
en: The listed packages' selection state may be reverted to the original settings, as they were before the unresolved depends or conflicts were created, by pressing the B<'R'> key. By pressing the B<'D'> key, the automatic suggestions are reset, but the change that caused the dependency resolution screen to be prompted is kept as requested.  Finally, by pressing B<'U'>, the selections are again set to the automatic suggestion values.
ja: B<'R'> キーを押すことで、パッケージリストの選択状況を未解決の依存、競合関係が生成される前の状態に戻すことができる。B<'D'> キーを押すことで、自動的に生成された推奨の設定は解除されるが、依存関係解決画面が表示される原因となった変更は、その状態のまま保持される。B<'U'> を押すことで、自動的に生成された推奨の設定が再設定される。

note: type: SS
en: Establishing the requested selections
ja: 選択された変更の確定

note: type: Plain text
en: By pressing B<enter>, the currently displayed set of selections is accepted. If B<dselect> detects no unresolved depends as a result of the requested selections, the new selections will be set.  However, if there are any unresolved depends, B<dselect> will again prompt the user with a dependency resolution screen.
ja: B<enter> を押すことで、現在表示されている選択を確定する。選択された変更に起因する未解決の依存関係が検出されない限り、B<dselect> は新しい選択を設定する。未解決の依存関係が存在する場合、 B<dselect> は依存関係解決画面を改めて表示する。

note: type: Plain text
en: To alter a set of selections that creates unresolved depends or conflicts and forcing B<dselect> to accept it, press the B<'Q'> key. This sets the selections as specified by the user, unconditionally. Generally, don't do this unless you've read the fine print.
ja: 未解決の依存関係、競合が生成された状態の選択で、B<dselect> に確定を強制させるには、B<'Q'> キーを押す。これはユーザが指定した選択を無条件に設定する。一般的に、何が行われるかの詳細を把握していない限り、これを行わないこと。

note: type: Plain text
en: The opposite effect, to back out any selections change requests and go back to the previous list of selections, is attained by pressing the B<'X'> or B<escape> keys. By repeatedly pressing these keys, any possibly detrimental changes to the requested package selections can be backed out completely to the last established settings.
ja: 反対に、選択を取り消して選択リストを元に戻す場合は、 B<'X'> キーや B<escape> キーを押すこと。キーを何回か押すことで、問題の発生する可能性のある、パッケージ選択の変更を取り消し、最後に確定した選択に戻すことができる。

note: type: Plain text
en: If you mistakenly establish some settings and wish to revert all the selections to what is currently installed on the system, press the B<'C'> key.  This is somewhat similar to using the unhold command on all packages, but provides a more obvious panic button in cases where the user pressed B<enter> by accident.
ja: 誤って選択を確定させてしまったが、現在システムにインストールされている選択に完全に戻したいという場合は、B<'C'> キーを押すこと。これはすべてのパッケージに対して保留解除を行ってしまった場合と同様であるが、ユーザが事故で B<enter> を押してしまった場合についての明確なパニックボタンを提供するものである。

note: type: Plain text
en: If set, B<dselect> will use it as the directory from which to read the user specific configuration file.
ja: 設定されていると、B<dselect> はその値をユーザ固有の設定ファイルを読み込むディレクトリとして使用する。

note: type: Plain text
en: The B<dselect> package selection interface is confusing to some new users.  Reportedly, it even makes seasoned kernel developers cry.
ja: 始めて B<dselect> を使うユーザの中には、このパッケージ選択インタフェースに混乱する者もいる。聞くところによると、経験を積んだカーネル開発者ですら、これに悩まされている。

note: type: Plain text
en: The documentation is lacking.
ja: ドキュメントが不足している。

note: type: Plain text
en: There is no help option in the main menu.
ja: メインメニューにヘルプオプションがない。

note: type: Plain text
en: The visible list of available packages cannot be reduced.
ja: 取得可能パッケージのリスト表示を減らせない。

note: type: Plain text
en: The built in access methods can no longer stand up to current quality standards. Use the access method provided by apt, it is not only not broken, it is also much more flexible than the built in access methods.
ja: 内部実装されているアクセス方式では、もはや現在の品質基準を満たせない。apt が提供するアクセス方式を利用すれば、問題を発生させないだけでなく、内部実装されているアクセス方式より遙かに柔軟である。

note: type: Plain text
en: dselect.cfg - dselect configuration file
ja: dselect.cfg - dselect の設定ファイル

note: type: Plain text
en: This file contains default options for dselect. Each line contains a single option which is exactly the same as a normal command line option for dselect except for the leading dashes which are not used here. Quotes surrounding option values are stripped. Comments are allowed by starting a line with a hash sign ("B<#>").
ja: このファイルには、dselect のデフォルトのオプションが格納される。各行には、先頭のダッシュが不要なことを除き、dselect の通常のコマンドラインオプションとまったく同一のオプションを 1 つ記述する。オプションの値を囲むクオートも削除される。ハッシュ記号 ("B<#>") からはじまる行はコメント行と見なされる。

note: type: Plain text
en: See I</usr/share/doc/dpkg/THANKS> for the list of people who have contributed to B<dselect>.
ja: B<dselect> に貢献した人のリストは B</usr/share/doc/dpkg/THANKS> を参照のこと。

note: type: Plain text
en: B<dselect>(1).
ja: B<dselect>(1)

note: type: Plain text
en: start-stop-daemon - start and stop system daemon programs
ja: start-stop-daemon - システムデーモンプログラムの起動、停止

note: type: Plain text
en: B<start-stop-daemon> is used to control the creation and termination of system-level processes.  Using one of the matching options, B<start-stop-daemon> can be configured to find existing instances of a running process.
ja: B<start-stop-daemon> はシステムレベルのプロセスの生成や停止を制御するために使用される。また、 適切なオプションを指定することで、実行中のプロセスを確認することができる。

note: type: Plain text
en: Note: unless B<--pidfile> is specified, B<start-stop-daemon> behaves similar to B<killall>(1).  B<start-stop-daemon> will scan the process table looking for any processes which match the process name, uid, and/or gid (if specified). Any matching process will prevent B<--start> from starting the daemon. All matching processes will be sent the TERM signal (or the one specified via B<--signal> or B<--retry>) if B<--stop> is specified. For daemons which have long-lived children which need to live through a B<--stop>, you must specify a pidfile.
ja: 注記: B<--pidfile> を指定しない場合、B<start-stop-daemon> は B<killall>(1) と類似の動作を行う。B<start-stop-daemon> は、(指定されていれば) プロセス名、uid、および gid にマッチするプロセスをプロセステーブルから検索する。B<--start> が指定されている場合にマッチするプロセスがあれば、デーモンは起動されない。B<--stop> が指定されていれば、マッチするプロセスすべてに TERM シグナル (もしくは B<--signal> や B<--retry> により指定されたシグナル) が送られる。そのため、B<--stop> を指定されても動作しつづける必要があるような、長寿命の子プロセスを持つデーモンには、 pidfile を指定しなければならない。

note: type: Plain text
en: Check for the existence of a specified process.  If such a process exists, B<start-stop-daemon> does nothing, and exits with error status 1 (0 if B<--oknodo> is specified).  If such a process does not exist, it starts an instance, using either the executable specified by B<--exec> or, if specified, by B<--startas>.  Any arguments given after B<--> on the command line are passed unmodified to the program being started.
ja: 指定されたプロセスの存在を確認する。該当するプロセスが存在する場合、 B<start-stop-daemon> は何もせず、エラーステータス 1 を返して終了する (B<--oknodo> が指定された場合は、0 を返す)。該当するプロセスが存在しない場合、 B<--exec> により、もしくは B<--startas> が指定された場合はこれにより指定される実行ファイルを起動する。コマンドライン上で B<--> 以降に与えられた任意の引数は起動されるプログラムにそのまま引き渡される。

note: type: Plain text
en: Checks for the existence of a specified process.  If such a process exists, B<start-stop-daemon> sends it the signal specified by B<--signal>, and exits with error status 0.  If such a process does not exist, B<start-stop-daemon> exits with error status 1 (0 if B<--oknodo> is specified). If B<--retry> is specified, then B<start-stop-daemon> will check that the process(es) have terminated.
ja: 指定されたプロセスの存在を確認する。該当するプロセスが存在する場合、 B<start-stop-daemon> は B<--signal> により指定されたシグナルをそのプロセスに送り、エラーステータス 0 を返して終了する。該当するプロセスが存在しない場合、 B<start-stop-daemon> はエラーステータス 1 を返して終了する( B<--oknodo> が指定された場合は 0 を返す)。B<--retry> を指定した場合、B<start-stop-daemon> はそのプロセスが終了したことを確認する。

note: type: Plain text
en: Check for the existence of a specified process, and returns an exit status code, according to the LSB Init Script Actions.
ja: 指定されたプロセスの存在を確認し、LSB の Init Script Action に基づいた終了ステータスを返却する。

note: type: Plain text
en: Show usage information and exit.
ja: 使用方法に関する情報を表示し、終了する。

note: type: Plain text
en: Show the program version and exit.
ja: バージョンと著作権に関する情報を表示し、終了する。

note: type: SH
en: MATCHING OPTIONS
ja: マッチ用オプション

note: type: Plain text
en: Check whether a process has created the file I<pid-file>. Note: using this matching option alone might cause unintended processes to be acted on, if the old process terminated without being able to remove the I<pid-file>.
ja: プロセスが I<pid-file> を作成したかどうかをチェックする。このオプションを単体で使用した場合、以前のプロセスが I<pid-file> を削除できないまま終了してしまった際に、意図しないプロセスが動作中であると判断される場合があるため留意すること。

note: type: Plain text
en: Check for processes that are instances of this I<executable>. The I<executable> argument should be an absolute pathname. Note: this might not work as intended with interpreted scripts, as the executable will point to the interpreter. Take into account processes running from inside a chroot will also be matched, so other match restrictions might be needed.
ja: プロセスが指定した I<executable> のインスタンスであるかどうかをチェックする。I<executable> 引数は絶対パス名であること。インタプリタ型のスクリプトに対して指定した場合、executable はインタプリタ自体を指してしまうため、期待する動作とならない点に留意すること。chroot 内で動作しているプロセスもマッチしてしまうため、これ以外の制約との組み合わせが必要となる点に注意すること。

note: type: Plain text
en: Check for processes with the name I<process-name>. The I<process-name> is usually the process filename, but it could have been changed by the process itself. Note: on most systems this information is retrieved from the process comm name from the kernel, which tends to have a relatively short length limit (assuming more than 15 characters is non-portable).
ja: プロセスが I<process-name> であるかどうかをチェックする。I<process-name> は通常プロセスのファイル名であるが、プロセス自身によって変更することも可能である。大半のシステムにおいて、この情報はカーネル内の process comm name から取得されるため、比較的短い名称である必要がある (15 文字を超える名称は移植性がないと判断される)点に留意すること。

note: type: Plain text
en: Check for processes owned by the user specified by I<username> or I<uid>. Note: using this matching option alone will cause all processes matching the user to be acted on.
ja: プロセスが I<username> もしくは I<uid> で指定されたユーザの所有となっているかをチェックする。このオプションを単体で用いた場合、指定されたユーザの所有するすべてのプロセスが合致するかをチェックする点に留意すること。

note: type: Plain text
en: Change to I<group> or I<gid> when starting the process.
ja: プロセスを開始する時点で、I<group> や I<gid> を変更する。

note: type: Plain text
en: With B<--stop>, specifies the signal to send to processes being stopped (default TERM).
ja: B<--stop> と同時に指定することで、プロセスを停止するために送信するシグナルを指定する (デフォルトは TERM)。

note: type: Plain text
en: With B<--stop>, specifies that B<start-stop-daemon> is to check whether the process(es)  do finish. It will check repeatedly whether any matching processes are running, until none are. If the processes do not exit it will then take further action as determined by the schedule.
ja: B<--stop> と同時に指定することで、B<start-stop-daemon> にプロセスの終了を確認させる。これにより、マッチした実行中のプロセスが全て終了するまで繰り返し確認が行われる。プロセスが終了しなければ、スケジュールにより指定されたアクションが実行される。

note: type: Plain text
en: If I<timeout> is specified instead of I<schedule>, then the schedule I<signal>B</>I<timeout>B</KILL/>I<timeout> is used, where I<signal> is the signal specified with B<--signal>.
ja: I<schedule> のかわりに I<timeout> が指定されている場合、 I<signal>B</>I<timeout>B</KILL/>I<timeout> スケジュールが使われる。ここで I<signal> は B<--signal> で指定されるシグナルである。

note: type: Plain text
en: I<schedule> is a list of at least two items separated by slashes (B</>); each item may be B<->I<signal-number> or [B<->]I<signal-name>, which means to send that signal, or I<timeout>, which means to wait that many seconds for processes to exit, or B<forever>, which means to repeat the rest of the schedule forever if necessary.
ja: スケジュール I<schedule> は、スラッシュ (B</>) で区切られた少なくとも 2 つの要素からなるリストである。それぞれの要素は、B<->I<signal-number> もしくは [B<->]I<signal-name> の場合は送るべきシグナル、 I<timeout> の場合はプロセスが終了するのを待つ秒数、 B<forever> の場合は必要な限り、残りの I<schedule> を繰り返し適用することを意味する。

note: type: Plain text
en: If the end of the schedule is reached and B<forever> is not specified, then B<start-stop-daemon> exits with error status 2.  If a schedule is specified, then any signal specified with B<--signal> is ignored.
ja: I<schedule> が終了し、B<forever> が指定されていない場合、 B<start-stop-daemon> はエラー状態 2 で終了する。schedule が指定されている場合、B<--signal> で指定したシグナルは無視される。

note: type: Plain text
en: With B<--start>, start the process specified by I<pathname>.  If not specified, defaults to the argument given to B<--exec>.
ja: B<--start> と同時に指定することで、I<pathname> により指定されるプロセスを起動する。このオプションが指定されない場合、 B<--exec> に与えられる引数がデフォルトになる。

note: type: Plain text
en: Print actions that would be taken and set appropriate return value, but take no action.
ja: 実行しようとする処理内容を出力し，それに伴い適切な返り値が設定されるが、実際の処理は行わない。

note: type: Plain text
en: Return exit status 0 instead of 1 if no actions are (would be) taken.
ja: 処理が何も行われない (又は、行なわれないと想定される) 場合、終了ステータス 1 のかわりに 0 を返す。

note: type: Plain text
en: Do not print informational messages; only display error messages.
ja: 情報メッセージを出力しない。エラーメッセージのみ出力する。

note: type: Plain text
en: Change to this username/uid before starting the process. You can also specify a group by appending a B<:>, then the group or gid in the same way as you would for the `chown' command (I<user>B<:>I<group>).  If a user is specified without a group, the primary GID for that user is used.  When using this option you must realize that the primary and supplemental groups are set as well, even if the B<--group> option is not specified. The B<--group> option is only for groups that the user isn't normally a member of (like adding per process group membership for generic users like B<nobody>).
ja: プロセスを起動する前に指定されたユーザ名やユーザ ID に変更する。 B<:> に続いてグループ名またはグループ ID を与えることによりグループも指定できる。これは `chown' コマンドと同じ書式 (I<user>B<:>I<group>) である。ユーザ名のみを指定した場合、そのユーザのプライマリグループの GID が用いられる。このオプション ( B<:> 書式) を使用した時には、 B<--group> オプションが指定されていない場合であっても、指定された場合と同様にプライマリグループと補助グループが設定されることを認識しておく必要がある。B<--group> オプションは、(あるプロセスについて B<nobody> のような汎用のユーザをグループに追加するといった) ユーザが通常メンバとなっていないグループを指定する場合にのみ使用する。

note: type: Plain text
en: Chdir and chroot to I<root> before starting the process. Please note that the pidfile is also written after the chroot.
ja: プロセスを起動する前に、I<root> に対して chdir と chroot を実行する。pidfile は chroot 後に、書き出されることに注意すること。

note: type: Plain text
en: Chdir to I<path> before starting the process. This is done after the chroot if the B<-r>|B<--chroot> option is set. When not specified, start-stop-daemon will chdir to the root directory before starting the process.
ja: プロセスを起動する前に、I<path> に chdir する。B<-r>|B<--chroot> オプションを同時に指定した場合は、chroot の後に chdir する。そうでない場合、start-stop-daemon は、プロセスを起動する前に root ディレクトリに chdir する。

note: type: Plain text
en: Typically used with programs that don't detach on their own. This option will force B<start-stop-daemon> to fork before starting the process, and force it into the background.  B<WARNING: start-stop-daemon> cannot check the exit status if the process fails to execute for B<any> reason. This is a last resort, and is only meant for programs that either make no sense forking on their own, or where it's not feasible to add the code for them to do this themselves.
ja: 通常、自身をデタッチできないプログラムで使用される。このオプションを指定した場合、 B<start-stop-daemon> は自身を対象プロセスの起動前に fork し、以後バックグラウンドで実行させる。 B<警告: start-stop-daemon> は B<いかなる>理由によってプロセスの起動に失敗した場合であっても、その終了ステータスをチェックできなくなる。このオプションは最終手段であり、自身の fork に意味のないプログラムや、fork を自身で行うためのコード追加が現実的でないプログラム以外での使用を意図していない。

note: type: Plain text
en: Do not close any file descriptor when forcing the daemon into the background.  Used for debugging purposes to see the process output, or to redirect file descriptors to log the process output.  Only relevant when using B<--background>.
ja: デーモンにバックグラウンドでの動作を強制する際に、ファイルディスクリプタのクローズを一切行わない。プロセスの出力を参照する、ファイルディスクリプタの出力をプロセスの出力をロギングするためにリダイレクトするといったデバッグ目的で使用される。B<--background> を指定した際にのみ有効である。

note: type: Plain text
en: This alters the priority of the process before starting it.
ja: プロセスを起動する前にプロセスのプライオリティを変更する。

note: type: Plain text
en: This alters the process scheduler policy and priority of the process before starting it. The priority can be optionally specified by appending a B<:> followed by the value. The default I<priority> is 0. The currently supported policy values are B<other>, B<fifo> and B<rr>.
ja: プロセスを起動する前に、スケジューラのポリシーと優先順位を変更する。優先順位の指定は任意であり、B<:> に続いて値を設定することで指定する。デフォルトの I<priority> は 0 である。現在サポートされているポリシーの値は B<other>, B<fifo>, B<rr> である。

note: type: Plain text
en: This alters the IO scheduler class and priority of the process before starting it. The priority can be optionally specified by appending a B<:> followed by the value. The default I<priority> is 4, unless I<class> is B<idle>, then I<priority> will always be 7. The currently supported values for I<class> are B<idle>, B<best-effort> and B<real-time>.
ja: プロセスを起動する前に、IO スケジューラのクラスと優先順位を変更する。優先順位の指定は任意であり、B<:> に続いて値を設定することで指定する。デフォルトの I<priority> は 4 であるが、I<class> が B<idle> の場合の I<priority> は常に 7 となる。現在サポートされている I<class> の値は B<idle>, B<best-effort>, B<real-time> である。

note: type: Plain text
en: This sets the umask of the process before starting it.
ja: プロセスを起動する前にプロセスの umask を設定する。

note: type: Plain text
en: Used when starting a program that does not create its own pid file. This option will make B<start-stop-daemon> create the file referenced with B<--pidfile> and place the pid into it just before executing the process. Note, the file will not be removed when stopping the program.  B<NOTE:> This feature may not work in all cases. Most notably when the program being executed forks from its main process. Because of this, it is usually only useful when combined with the B<--background> option.
ja: 自分自身で PID ファイルを作成しないプログラムを起動する際に使用する。このオプションにより、プロセスの起動直前に B<start-stop-daemon> は B<--pidfile> で参照されるファイルを作成し、pid の値を格納する。このファイルはプログラムの停止時に削除されないことに注意。B<注記:> このオプションは動作しない場合がある。特に、プログラムの実行時にそのメインのプロセスから fork するようなプログラムでは正しく動作しない。このため、通常は B<--background> オプションと併用する場合にのみ有用である。

note: type: Plain text
en: Print verbose informational messages.
ja: 詳細な情報を出力する。

note: type: Plain text
en: The requested action was performed. If B<--oknodo> was specified, it's also possible that nothing had to be done.  This can happen when B<--start> was specified and a matching process was already running, or when B<--stop> was specified and there were no matching processes.
ja: 指定されたアクションが実行された。B<--oknodo> が指定された場合、何も行われなかった場合も意味する。これは、B<--start> が指定されたがマッチするプロセスが実行されていた場合、B<--stop> が指定されたがマッチするプロセスが存在しなかった場合に発生しうる。

note: type: Plain text
en: If B<--oknodo> was not specified and nothing was done.
ja: B<--oknodo> が指定されなかった場合に、何も行われなかった。

note: type: Plain text
en: If B<--stop> and B<--retry> were specified, but the end of the schedule was reached and the processes were still running.
ja: B<--stop> および B<--retry> が指定されたが、規定時間の最後まで到達したにも関わらず、プロセスがまだ実行されている。

note: type: Plain text
en: Any other error.
ja: その他のエラー。

note: type: Plain text
en: When using the B<--status> command, the following status codes are returned:
ja: B<--status> コマンドを実行した際には、以下の戻り値が返される:

note: type: Plain text
en: Program is running.
ja: プログラムは実行中である。

note: type: Plain text
en: Program is not running and the pid file exists.
ja: プログラムは実行中でないが、pid ファイルが存在している。

note: type: Plain text
en: Program is not running.
ja: プログラムは実行中でない。

note: type: Plain text
en: Unable to determine program status.
ja: プログラムの状況を確認できない。

note: type: Plain text
en: Start the B<food> daemon, unless one is already running (a process named food, running as user food, with pid in food.pid):
ja: 既に実行中でない場合に、B<food> デーモンを (プロセス名 food、実行ユーザ food 、PID 情報を food.pid に格納で) 起動する。

note: type: Plain text
en: Send B<SIGTERM> to B<food> and wait up to 5 seconds for it to stop:
ja: B<food> に B<SIGTERM> を送信し、停止するまで 5 秒間待機する:

note: type: Plain text
en: Demonstration of a custom schedule for stopping B<food>:
ja: B<food> 停止のためのカスタムスケジュールのデモ:

note: type: Plain text
en: update-alternatives - maintain symbolic links determining default commands
ja: update-alternatives - シンボリックリンクを管理してデフォルトのコマンドを決定する

note: type: Plain text
en: B<update-alternatives> creates, removes, maintains and displays information about the symbolic links comprising the Debian alternatives system.
ja: B<update-alternatives> は Debian の alternatives システムを構成するシンボリックリンクを生成・削除・管理したり、リンクの情報を表示したりするツールである。

note: type: Plain text
en: It is possible for several programs fulfilling the same or similar functions to be installed on a single system at the same time.  For example, many systems have several text editors installed at once.  This gives choice to the users of a system, allowing each to use a different editor, if desired, but makes it difficult for a program to make a good choice for an editor to invoke if the user has not specified a particular preference.
ja: 同一の、あるいは類似の機能を持つ複数のプログラムを一つのシステムに同時にインストールし、共存させることができる。例えば多くのシステムでは、複数のテキストエディタを共存させている。これにより、システムのユーザは好みに応じて別々のエディタを使うことができるようになる。しかしプログラムからすると、特に指定がなかったときにどのエディタを起動すれば良いのかという、なかなか難しい問題を抱えることになる。

note: type: Plain text
en: Debian's alternatives system aims to solve this problem.  A generic name in the filesystem is shared by all files providing interchangeable functionality.  The alternatives system and the system administrator together determine which actual file is referenced by this generic name.  For example, if the text editors B<ed>(1)  and B<nvi>(1)  are both installed on the system, the alternatives system will cause the generic name I</usr/bin/editor> to refer to I</usr/bin/nvi> by default. The system administrator can override this and cause it to refer to I</usr/bin/ed> instead, and the alternatives system will not alter this setting until explicitly requested to do so.
ja: Debian の alternatives システムは、この問題を解決するためのものである。互いに置き換え可能な機能を提供する全てのファイルは、ファイルシステム中の「一般名 (generic name)」を共有する。その一般名が実際にどのファイルを参照するかは、 alternatives システムとシステム管理者とが決定する。例えば、テキストエディタである B<ed>(1) と B<nvi>(1) の両方がシステムにインストールされていたとすると、一般名である I</usr/bin/editor> は、デフォルトでは I</usr/bin/nvi> を参照する。システム管理者はこれを上書きし、 I</usr/bin/ed> を参照させるようにすることもできる。こうすると、その後明示的な設定がなければ、 alternatives システムはその設定を変更しない。

note: type: Plain text
en: The generic name is not a direct symbolic link to the selected alternative.  Instead, it is a symbolic link to a name in the I<alternatives> I<directory>, which in turn is a symbolic link to the actual file referenced.  This is done so that the system administrator's changes can be confined within the I</etc> directory: the FHS (q.v.) gives reasons why this is a Good Thing.
ja: 一般名は、選ばれた「選択肢 (alternative)」への直接のシンボリックリンクではなく、 I<alternatives> I<ディレクトリ> にある名前へのシンボリックリンクになっており、その名前が実際に参照されるファイルへのシンボリックリンクになっている。こうなっている理由は、システム管理者による変更を I</etc> ディレクトリ以下で完結させるためである。なぜこうするのが良いかについては FHS に説明がある。

note: type: Plain text
en: When each package providing a file with a particular functionality is installed, changed or removed, B<update-alternatives> is called to update information about that file in the alternatives system.  B<update-alternatives> is usually called from the B<postinst> (configure) or B<prerm> (install) scripts in Debian packages.
ja: ある機能を持ったファイルを提供するパッケージがインストール・変更・削除されると、 B<update-alternatives> が呼ばれ、そのファイルに対する alternatives システムの情報を更新する。 B<update-alternatives> は、通常 Debian パッケージの B<postinst> (configure) または B<prerm> (install) スクリプトから呼び出される。

note: type: Plain text
en: It is often useful for a number of alternatives to be synchronized, so that they are changed as a group; for example, when several versions of the B<vi>(1)  editor are installed, the man page referenced by I</usr/share/man/man1/vi.1> should correspond to the executable referenced by I</usr/bin/vi>.  B<update-alternatives> handles this by means of I<master> and I<slave> links; when the master is changed, any associated slaves are changed too.  A master link and its associated slaves make up a I<link> I<group>.
ja: 複数の選択肢を同期させ、グループとして変更すると便利なことが多い。例えば B<vi>(1) エディタのいろいろな派生システムが同時にインストールされていたとすると、 I</usr/share/man/man1/vi.1> が参照する man ページは、 I</usr/bin/vi> が参照する実行ファイルに対応しているべきであろう。 B<update-alternatives> は、 I<master> リンクと I<slave> リンクによってこれを取り扱う。 master が変更されると、それに関連づけされた各 slave も同時に変更される。 master リンクとそれに関連づけされた slave とは、 I<リンクグループ> を形成する。

note: type: Plain text
en: Each link group is, at any given time, in one of two modes: automatic or manual.  When a group is in automatic mode, the alternatives system will automatically decide, as packages are installed and removed, whether and how to update the links.  In manual mode, the alternatives system will retain the choice of the administrator and avoid changing the links (except when something is broken).
ja: 各リンクグループは、いかなる時点においても、 automatic または manual の 2 つのモードのいずれかにある。グループが automatic モードにある場合は、パッケージのインストール・削除の際にリンクを更新するか、どのように更新するかは、 alternatives システムが自動的に決定する。 manual モードでは、 alternatives システムは (何らかの問題が発生した場合を除き) リンクを変更せず、システム管理者の行った設定が保持される。

note: type: Plain text
en: Link groups are in automatic mode when they are first introduced to the system.  If the system administrator makes changes to the system's automatic settings, this will be noticed the next time B<update-alternatives> is run on the changed link's group, and the group will automatically be switched to manual mode.
ja: リンクグループがシステムに導入されると、まず automatic モードとして機能する。システム管理者がその設定を変更すると、次に B<update-alternatives> がリンクグループに対して実行されたときに変更が認識され、そのリンクグループは自動的に manual モードに切り換わる。

note: type: Plain text
en: Each alternative has a I<priority> associated with it.  When a link group is in automatic mode, the alternatives pointed to by members of the group will be those which have the highest priority.
ja: 各選択肢は I<priority> 属性を持っている。リンクグループが automatic モードにあるときは、 I<priority> のもっとも高いものが、そのグループのメンバーが参照する選択肢になる。

note: type: Plain text
en: When using the B<--config> option, B<update-alternatives> will list all of the choices for the link group of which given I<name> is the master alternative name. The current choice is marked with a '*'.  You will then be prompted for your choice regarding this link group.  Depending on the choice made, the link group might no longer be in I<auto> mode. You will need to use the B<--auto> option in order to return to the automatic mode (or you can rerun B<--config> and select the entry marked as automatic).
ja: I<--config> オプションを使用すると、 B<update-alternatives> は I<name> で指定された master リンクのリンクグループに対応する選択肢をすべてリストし、現在選択されているものに '*' マークを付与した上で、そのリンクグループの選択肢を確認するプロンプトを表示する。ここで変更を行うと、その一般名は I<automatic> モードではなくなる。 automatic モードに戻すには、 I<--auto> オプションを使用する (もしくは B<--config> オプションで再実行した上で、 automatic モードの選択肢を選択する) 必要がある。

note: type: Plain text
en: If you want to configure non-interactively you can use the B<--set> option instead (see below).
ja: 非対話的に設定をしたい場合は B<--set> オプションを代わりに使用する (以下を参照)。

note: type: Plain text
en: Different packages providing the same file need to do so B<cooperatively>.  In other words, the usage of B<update-alternatives> is B<mandatory> for all involved packages in such case. It is not possible to override some file in a package that does not employ the B<update-alternatives> mechanism.
ja: 同一のファイルを提供する異なるパッケージは、これを B<協調して> 行う必要がある。言い換えると、こうした場合、関連するパッケージのすべてで B<update-alternatives> の使用が必須となる。B<update-alternatives> 機構を使用していないパッケージのファイルを上書きすることはできない。

note: type: SH
en: TERMINOLOGY
ja: 用語

note: type: Plain text
en: Since the activities of B<update-alternatives> are quite involved, some specific terms will help to explain its operation.
ja: B<update-alternatives> の動作は極めて複雑なので、ここでいくつかの固有の用語を説明し、動作の理解の助けとしたい。

note: type: TP
en: generic name (or alternative link)
ja: 一般名 (generic name / alternative link)

note: type: Plain text
en: A name, like I</usr/bin/editor>, which refers, via the alternatives system, to one of a number of files of similar function.
ja: I</usr/bin/editor> のような名前。 alternatives システムによって、類似の機能を持つ複数のファイルのいずれかを参照する。

note: type: TP
en: alternative name
ja: 選択肢名 (alternative name)

note: type: Plain text
en: The name of a symbolic link in the alternatives directory.
ja: alternatives ディレクトリに存在するシンボリックリンク名

note: type: TP
en: alternative (or alternative path)
ja: 選択肢 (alternative / alternative path)

note: type: Plain text
en: The name of a specific file in the filesystem, which may be made accessible via a generic name using the alternatives system.
ja: ファイルシステム中の特定ファイルの名称、alternatives システムによって、一般名からのアクセスが可能となる。

note: type: TP
en: alternatives directory
ja: alternatives ディレクトリ

note: type: Plain text
en: A directory, by default I</etc/alternatives>, containing the symlinks.
ja: シンボリックリンクを保持するディレクトリ。デフォルトは I</etc/alternatives>。

note: type: TP
en: administrative directory
ja: administrative ディレクトリ

note: type: Plain text
en: A directory, by default I</var/lib/dpkg/alternatives>, containing B<update-alternatives>' state information.
ja: B<update-alternatives> の状態情報を保持するディレクトリ。デフォルトは I</var/lib/dpkg/alternatives>。

note: type: TP
en: link group
ja: リンクグループ

note: type: Plain text
en: A set of related symlinks, intended to be updated as a group.
ja: 関連するシンボリックリンクのセットで、グループ単位での更新を行うためのもの。

note: type: TP
en: master link
ja: master リンク

note: type: Plain text
en: The alternative link in a link group which determines how the other links in the group are configured.
ja: リンクグループに属する選択肢のリンクで、グループ内の他のリンクの設定を決定するもの。

note: type: TP
en: slave link
ja: slave リンク

note: type: Plain text
en: An alternative link in a link group which is controlled by the setting of the master link.
ja: リンクグループに属する選択肢のリンクで、 master リンクの設定によって設定されるもの。

note: type: TP
en: automatic mode
ja: automatic モード

note: type: Plain text
en: When a link group is in automatic mode, the alternatives system ensures that the links in the group point to the highest priority alternative appropriate for the group.
ja: リンクグループが automatic モードにある場合、alternatives システムは、グループ内の各リンクが priority のもっとも高い選択肢を参照することを担保する。

note: type: TP
en: manual mode
ja: manual モード

note: type: Plain text
en: When a link group is in manual mode, the alternatives system will not make any changes to the system administrator's settings.
ja: リンクグループが manual モードにある場合、alternatives システムはシステム管理者の行った設定を一切変更しない。

note: type: Plain text
en: Add a group of alternatives to the system.  I<link> is the generic name for the master link, I<name> is the name of its symlink in the alternatives directory, and I<path> is the alternative being introduced for the master link.  The arguments after B<--slave> are the generic name, symlink name in the alternatives directory and the alternative path for a slave link.  Zero or more B<--slave> options, each followed by three arguments, may be specified. Note that the master alternative must exist or the call will fail. However if a slave alternative doesn't exist, the corresponding slave alternative link will simply not be installed (a warning will still be displayed). If some real file is installed where an alternative link has to be installed, it is kept unless B<--force> is used.
ja: 選択肢のグループをシステムに追加する。I<link> は master リンクの一般名、I<name> は alternatives ディレクトリにおけるシンボリックリンクの名前、 I<path> は master リンクとなる選択肢の名前となる。B<--slave> オプションに続く引数は、alternatives ディレクトリでの一般名およびシンボリックリンクの名前と slave リンクとなる選択肢のパスの順となる。B<--slave> オプションと、それにに続く 3 つの引数のセットは、いくつ設定してもよく、まったく設定しないこともできる。master となる選択肢は必ず存在している必要があり、存在していない場合は失敗となるが、slave の選択肢がインストールされていない場合は、(依然として警告が表示されるものの) 対応する slave の選択肢のリンクが単にインストールされないだけである。選択肢のリンクがインストールされるパスに、何らかの実ファイルがインストールされている場合、B<--force> が指定されない限り、それらのファイルは保持される。

note: type: Plain text
en: If the alternative name specified exists already in the alternatives system's records, the information supplied will be added as a new set of alternatives for the group.  Otherwise, a new group, set to automatic mode, will be added with this information.  If the group is in automatic mode, and the newly added alternatives' priority is higher than any other installed alternatives for this group, the symlinks will be updated to point to the newly added alternatives.
ja: 指定された選択肢の名前が既に alternatives システム内に存在している場合、与えられた情報は、グループに対する新たな選択肢として追加される。それ以外の場合は、与えられた情報を用いて、新しいグループが automatic モードで追加される。グループが automatic モードにあり、新たに追加された選択肢の priority がそのグループに対してインストールされている他の選択肢のものより高い場合、シンボリックリンクは新たに追加された選択肢を参照するように更新される。

note: type: Plain text
en: Set the program I<path> as alternative for I<name.> This is equivalent to B<--config> but is non-interactive and thus scriptable.
ja: プログラム I<path> を I<name> の選択肢として設定する。 I<--config> と同等だが、こちらは非対話的であるため、スクリプト向けである。

note: type: Plain text
en: Remove an alternative and all of its associated slave links.  I<name> is a name in the alternatives directory, and I<path> is an absolute filename to which I<name> could be linked. If I<name> is indeed linked to I<path>, I<name> will be updated to point to another appropriate alternative (and the group is put back in automatic mode), or removed if there is no such alternative left.  Associated slave links will be updated or removed, correspondingly.  If the link is not currently pointing to I<path>, no links are changed; only the information about the alternative is removed.
ja: (master の) 選択肢とそれに関連する全ての slave リンクを削除する。 I<name> は alternatives ディレクトリ内の名前であり、 I<path> は I<name> のリンク先に指定されうるファイル名の絶対パスである。 I<name> が実際に I<path> にリンクされている場合には、 I<name> は他の適切な選択肢を参照するよう更新される (グループは automatic モードに戻される) が、そのような選択肢が残っていなければ削除される。関連する slave リンクも対応して更新 (削除) される。 I<name> が現在その I<path> を参照していなければ、リンクの変更は行われない。その選択肢の情報が削除されるだけである。

note: type: Plain text
en: Remove all alternatives and all of their associated slave links.  I<name> is a name in the alternatives directory.
ja: すべての選択肢と、それに関連するすべての slave リンクを削除する。 I<name> は、alternatives ディレクトリ内の名前である。

note: type: Plain text
en: Call B<--config> on all alternatives. It can be usefully combined with B<--skip-auto> to review and configure all alternatives which are not configured in automatic mode. Broken alternatives are also displayed.  Thus a simple way to fix all broken alternatives is to call B<yes \[aq]\[aq] | update-alternatives --force --all>.
ja: すべての選択肢に対して B<--config> を呼び出す。これは B<--skip-auto> と組み合わせることで、automatic モードで設定されていないすべての選択肢を確認、設定する際に有用である。問題のある選択肢も表示される。問題のある選択肢をすべて修正するためには B<yes \[aq]\[aq] | update-alternatives --force --all> を実行すればよい。

note: type: Plain text
en: Switch the link group behind the alternative for I<name> to automatic mode.  In the process, the master symlink and its slaves are updated to point to the highest priority installed alternatives.
ja: I<name> で指定される選択肢のリンクグループを、automatic モードに変更する。この処理を行う際に、master のシンボリックリンクと対応する各 slave は、現在インストールされている選択肢のうち、もっとも priority の高いものを参照するように更新される。

note: type: Plain text
en: Display information about the link group.  Information displayed includes the group's mode (auto or manual), which alternative the master link currently points to, what other alternatives are available (and their corresponding slave alternatives), and the highest priority alternative currently installed.
ja: リンクグループの情報を表示する。表示される情報は、グループのモード (auto か manual か)、master リンクの現在の参照先となる選択肢、他に利用可能な選択肢 (とそれに対応した slave の選択肢)、現在インストールされている選択肢のうち、もっとも priority の高いものである。

note: type: Plain text
en: List all master alternative names (those controlling a link group)  and their status. Each line contains up to 3 fields (separated by one or more spaces). The first field is the alternative name, the second one is the status (either "auto" or "manual"), and the last one contains the current choice in the alternative (beware: it's a filename and thus might contain spaces).
ja: すべての master の選択肢名 (これらはリンクグループを制御する) と、その状況を列挙する。各行には、(1 つ以上の空白で区切られた) 3 つのフィールドからなる。1 番目のフィールドは選択肢の名前、2 番目は状況 ("auto" か "manual" か)、3 番目は現在の選択肢の選択状況 (これはファイル名であるため、空白を含む可能性のあることに留意) である。

note: type: Plain text
en: Read configuration of alternatives on standard input in the format generated by B<update-alternatives --get-selections> and reconfigure them accordingly.
ja: 選択肢の設定を、B<update-alternatives --get-selections> の生成する形式で標準入力から読み取り、その内容に従って再設定を行う。

note: type: Plain text
en: Display information about the link group like --display does, but in a machine parseable way (see section B<QUERY FORMAT> below).
ja: --display と同様に、リンクグループについての情報を表示するが、コンピュータが解析するのに適した形式で行う (以下の B<QUERY FORMAT> セクションも参照のこと)。

note: type: Plain text
en: Display all targets of the link group.
ja: リンクグループのすべての対象を表示する。

note: type: Plain text
en: Show available alternatives for a link group and allow the user to interactively select which one to use. The link group is updated.
ja: リンクグループで利用可能なすべての選択肢を表示し、対話的に選択肢の 1 つを選択できるようにする。これにより、リンクグループが更新される。

note: type: TP
en: B<--altdir>I< directory>
ja: B<--altdir> I<directory>

note: type: Plain text
en: Specifies the alternatives directory, when this is to be different from the default.
ja: alternatives ディレクトリをデフォルトから変えたいときに指定する。

note: type: Plain text
en: Specifies the administrative directory, when this is to be different from the default.
ja: administrative ディレクトリをデフォルトから変えたいときに指定する。

note: type: Plain text
en: Specifies the log file, when this is to be different from the default (/var/log/alternatives.log).
ja: alternatives ディレクトリをデフォルト (/var/log/alternatives.log) から変えたいときに指定する。

note: type: Plain text
en: Let B<update-alternatives> replace or drop any real file that is installed where an alternative link has to be installed or removed.
ja: 選択肢のリンクがインストールもしくは削除されるパスに実ファイルがインストールされていた場合に、B<update-alternatives> にそれらを置き換え、削除させる。

note: type: Plain text
en: Skip configuration prompt for alternatives which are properly configured in automatic mode. This option is only relevant with B<--config> or B<--all>.
ja: automatic モードで適切に設定されている選択肢について、設定の確認を行わない。このオプションは B<--config> および B<--all> とともに指定した場合のみ有効である。

note: type: Plain text
en: Generate more comments about what B<update-alternatives> is doing.
ja: B<update-alternatives> の実行内容に付いて、より詳細なコメントを生成する。

note: type: Plain text
en: Don't generate any comments unless errors occur.
ja: エラー以外のコメントを出力しない。

note: type: Plain text
en: If set and the B<--admindir> option has not been specified, it will be used as the base administrative directory.
ja: B<--admindir> オプションが指定されていない場合に、この変数が設定されていると、この値が administrative ディレクトリの起点として使用される。

note: type: Plain text
en: The default alternatives directory.  Can be overridden by the B<--altdir> option.
ja: デフォルトの alternatives ディレクトリ。 B<--altdir> オプションによって変更できる。

note: type: Plain text
en: The default administration directory.  Can be overridden by the B<--admindir> option.
ja: デフォルトの administration ディレクトリ。 B<--admindir> オプションによって変更できる。

note: type: Plain text
en: The requested action was successfully performed.
ja: 指定したアクションが正しく実行された。

note: type: Plain text
en: Problems were encountered whilst parsing the command line or performing the action.
ja: コマンドラインの解釈か、アクションの実行時に問題が発生した。

note: type: Plain text
en: The B<update-alternatives --query> format is using an RFC822-like flat format. It's made of I<n> + 1 blocks where I<n> is the number of alternatives available in the queried link group. The first block contains the following fields:
ja: B<update-alternatives --query> の形式としては、RFC822 に似たフラットなものが使用されている。これは I<n> + 1 ブロックからなっており、ここで I<n> はクエリ対象のリンクグループで利用可能な選択肢の数を意味する。最初のブロックには、以下のフィールドが含まれる:

note: type: Plain text
en: The alternative name in the alternative directory.
ja: alternative ディレクトリに存在する選択肢の名前

note: type: Plain text
en: The generic name of the alternative.
ja: 選択肢の一般名

note: type: Plain text
en: When this field is present, the B<next> lines hold all slave links associated to the master link of the alternative. There is one slave per line. Each line contains one space, the generic name of the slave alternative, another space, and the path to the slave link.
ja: このヘッダが存在している場合、B<以降の> 行には、この選択肢の master リンクに対応するすべての slave リンクが記述される。これは、slave 毎に 1 行ずつ記述され、各行は、1 文字のスペースに続き、slave の選択肢の一般名、スペース、slave リンクのパスが記述される。

note: type: Plain text
en: The status of the alternative (B<auto> or B<manual>).
ja: 選択肢の状況 (B<auto> もしくは B<manual>)

note: type: Plain text
en: The path of the best alternative for this link group. Not present if there is no alternatives available.
ja: このリンクグループで最適な選択肢のパス。利用可能な選択肢が存在しない場合、存在しない。

note: type: Plain text
en: The path of the currently selected alternative. It can also take the magic value B<none>. It is used if the link doesn't exist.
ja: 現在選択されている選択肢のパス。リンクが存在しない場合、B<none> という特別な値が設定される場合がある。

note: type: TP
en: The other blocks describe the available alternatives in the queried link group:
ja: これ以外のブロックは、クエリ対象のリンクグループにおいて利用可能な選択肢を表示する。

note: type: Plain text
en: Path to this block's alternative.
ja: このブロックの選択肢のパス。

note: type: Plain text
en: Value of the priority of this alternative.
ja: この選択肢の priority の値。

note: type: Plain text
en: When this field is present, the B<next> lines hold all slave alternatives associated to the master link of the alternative. There is one slave per line. Each line contains one space, the generic name of the slave alternative, another space, and the path to the slave alternative.
ja: このヘッダが存在している場合、B<以降の> 行には、この選択肢の master リンクに対応するすべての slave の選択肢が記述される。これは、slave 毎に 1 行ずつ記述され、各行は、1 文字のスペースに続き、slave の選択肢の一般名、スペース、slave の選択肢のパスが記述される。

note: type: TP
en: B<Example>
ja: B<実行例>

note: type: Plain text
en: With B<--verbose> B<update-alternatives> chatters incessantly about its activities on its standard output channel.  If problems occur, B<update-alternatives> outputs error messages on its standard error channel and returns an exit status of 2.  These diagnostics should be self-explanatory; if you do not find them so, please report this as a bug.
ja: B<--verbose> を指定した場合、B<update-alternatives> は、実行中の処理内容を逐一標準出力に出力する。問題が起きると、 B<update-alternatives> はエラーメッセージを標準エラー出力に出力し、終了ステータス 2 を返す。これらの診断メッセージは、読めばわかるはずである。もしわからなければ、バグとして報告して欲しい。

note: type: Plain text
en: There are several packages which provide a text editor compatible with B<vi>, for example B<nvi> and B<vim>. Which one is used is controlled by the link group B<vi>, which includes links for the program itself and the associated manpage.
ja: 例えば B<nvi> や B<vim> のように、テキストエディタ B<vi> と互換性のあるプログラムを提供するパッケージが複数ある。どのパッケージが使われるかは、リンクグループ B<vi> によって制御される。リンクグループ B<vi> にはプログラム自身のリンクと、関連する man ページのリンクが含まれる。

note: type: Plain text
en: To display the available packages which provide B<vi> and the current setting for it, use the B<--display> action:
ja: B<vi> を提供するパッケージとその現在の設定を表示するには、B<--display> アクションを使用する:

note: type: Plain text
en: To choose a particular B<vi> implementation, use this command as root and then select a number from the list:
ja: 特定の B<vi> の実装を選ぶには、root としてこのコマンドを実行し、一覧から数字を選ぶ:

note: type: Plain text
en: To go back to having the B<vi> implementation chosen automatically, do this as root:
ja: B<vi> 実装の選択を自動的に行なうように戻すには、root としてこのコマンドを実行する:

note: type: Plain text
en: If you find a bug, please report it using the Debian bug-tracking system.
ja: バグを見つけた場合、 Debian バグ追跡システムを使って報告してほしい。

note: type: Plain text
en: If you find any discrepancy between the operation of B<update-alternatives> and this manual page, it is a bug, either in the implementation or the documentation; please report it.
ja: B<update-alternatives> の動作とこのマニュアルページの記述に矛盾があれば、実装かドキュメントどちらかのバグである。報告をお願いしたい。
