Man page - apt_preferences(5)

Packages contains this manual

Package:  apt
apt-get install apt

Manuals in package:
• apt-cache(8)
• apt_auth.conf(5)
• apt-transport-mirror(1)
• sources.list(5)
• apt-get(8)
• apt-transport-http(1)
• apt.conf(5)
• apt-config(8)
• apt_preferences(5)
• apt-secure(8)
• apt(8)
• apt-cdrom(8)
• apt-patterns(7)
• apt-transport-https(1)
• apt-mark(8)
Documentations in package:
• apt

Available languages:

en fr es it pl pt nl ja de

Manual

APT_PREFERENCES

名 前
説 明
APT の デ フ ォ ル ト 優 先 度 の 割 り 当 て
Phased Updates
APT プ リ フ ァ レ ン ス フ ァ イ ル の 効 果
Matching packages in the Package field
APT が 優 先 度 に 割 り 込 む 方 法
パ ッ ケ ー ジ の バ ー ジ ョ ン と デ ィ ス ト リ ビ ュ ー シ ョ ン プ ロ パ テ ィ の 決 定
APT プ リ フ ァ レ ン ス レ コ ー ド の オ プ シ ョ ン 行
サ ン プ ル
安 定 版 の 追 跡
テ ス ト 版 や 不 安 定 版 の 追 跡
コ ー ド 名 リ リ ー ス の 進 化 の 追 跡
フ ァ イ ル
関 連 項 目
バ グ
翻 訳
著 者
注 記

---

名 前

apt_preferences - APT 用 選 択 制 御 フ ァ イ ル

説 明

APT プ リ フ ァ レ ン ス フ ァ イ ル /etc/apt/preferences と /etc/apt/preferences.d/ フ ォ ル ダ に あ る 断 片 フ ァ イ ル は 、 イ ン ス ト ー ル す る パ ッ ケ ー ジ の バ ー ジ ョ ン を 制 御 す る の に 使 用 し ま す 。

sources.list (5) フ ァ イ ル に 複 数 の デ ィ ス ト リ ビ ュ ー シ ョ ン (stable と testing な ど ) が 指 定 さ れ て い て 、 パ ッ ケ ー ジ に 対 し 複 数 の バ ー ジ ョ ン が イ ン ス ト ー ル で き る こ と が あ り ま す 。 こ の と き APT は 、 利 用 で き る バ ー ジ ョ ン ご と に 優 先 度 を 割 り 当 て ま す 。 依 存 関 係 規 則 を 条 件 と し て 、 apt-get は 、 最 も 高 い 優 先 度 を 持 つ バ ー ジ ョ ン を イ ン ス ト ー ル す る よ う 選 択 し ま す 。 APT プ リ フ ァ レ ン ス フ ァ イ ル は 、 APT が デ フ ォ ル ト で 割 り 当 て た 、 パ ッ ケ ー ジ の バ ー ジ ョ ン の 優 先 度 を 上 書 き し ま す 。 そ の 結 果 イ ン ス ト ー ル す る も の の 選 択 を 、 ユ ー ザ が 選 択 で き る よ う に な り ま す 。

sources.list (5) フ ァ イ ル に 複 数 の 参 照 が 書 か れ て い る 場 合 、 パ ッ ケ ー ジ の 同 じ バ ー ジ ョ ン の イ ン ス タ ン ス が 複 数 利 用 で き る 可 能 性 が あ り ま す 。 こ の 場 合 、 apt-get は sources.list (5) フ ァ イ ル の 初 め の 方 に 指 定 さ れ て い る と こ ろ か ら ダ ウ ン ロ ー ド し ま す 。 APT プ リ フ ァ レ ン ス フ ァ イ ル は バ ー ジ ョ ン の 選 択 に の み 影 響 し 、 イ ン ス タ ン ス の 選 択 に は 影 響 し ま せ ん 。

プ リ フ ァ レ ン ス フ ァ イ ル は 、 シ ス テ ム 管 理 者 の 強 い 力 で す が 、 注 意 し て 使 わ な い と 大 き な 悪 夢 に も な り ま す ! APT は プ リ フ ァ レ ン ス に つ い て 問 い 合 わ せ る こ と は し ま せ ん 。 そ の た め 、 設 定 を 誤 っ た こ と に よ り 、 イ ン ス ト ー ル で き な い パ ッ ケ ー ジ に 誘 導 さ れ た り 、 パ ッ ケ ー ジ の ア ッ プ グ レ ー ド 中 に 誤 っ た 判 断 を し た り と い う 事 が あ り え ま す 。 以 降 の 段 落 の 内 容 を よ く 理 解 し な い で 、 複 数 の デ ィ ス ト リ ビ ュ ー シ ョ ン リ リ ー ス を 混 ぜ て し ま う と 、 よ り 多 く の 問 題 が 発 生 す る 事 に な り ま す 。 特 定 の リ リ ー ス に 含 ま れ る パ ッ ケ ー ジ は 、 古 い /新 し い リ リ ー ス や 、 異 な る リ リ ー ス か ら 持 っ て き た 他 の パ ッ ケ ー ジ と で は 、 テ ス ト さ れ て い ま せ ん (し 、 予 想 通 り に 常 に 動 作 す る と は 限 り ま せ ん )。 以 上 、 警 告 し ま し た 。

/etc/apt/preferences.d デ ィ レ ク ト リ に あ る フ ァ イ ル は 、 英 数 字 の 昇 順 で 解 析 さ れ 、 以 下 の 命 名 規 約 に 従 う 必 要 が あ る こ と に 注 意 し て く だ さ い 。 フ ァ イ ル 名 の 拡 張 子 は な い か 、 "pref" と な っ て お り 、 英 数 字 、 ハ イ フ ン (-)、 ア ン ダ ー ス コ ア (_)、 ピ リ オ ド (.) で で き て い ま す 。 そ う で な け れ ば 、 Dir::Ignore-Files-Silently 設 定 リ ス ト の パ タ ー ン に 一 致 す る も の 以 外 に 対 し て 、 フ ァ イ ル を 無 視 す る と い う 注 意 を APT が 出 力 し ま す 。 一 致 す る 場 合 は 黙 っ て 無 視 し ま す 。

APT の デ フ ォ ル ト 優 先 度 の 割 り 当 て

プ リ フ ァ レ ン ス フ ァ イ ル が な か っ た り 、 プ リ フ ァ レ ン ス フ ァ イ ル に 特 定 の パ ッ ケ ー ジ を 割 り 当 て る エ ン ト リ が な い 場 合 、 そ の バ ー ジ ョ ン の 優 先 度 は 、 そ の バ ー ジ ョ ン が 属 し て い る デ ィ ス ト リ ビ ュ ー シ ョ ン の 優 先 度 と な り ま す 。 デ フ ォ ル ト で 他 の デ ィ ス ト リ ビ ュ ー シ ョ ン よ り 高 い 優 先 度 を 持 つ 、 特 定 の デ ィ ス ト リ ビ ュ ー シ ョ ン を 「 タ ー ゲ ッ ト リ リ ー ス 」 と し て お け ま す 。 タ ー ゲ ッ ト リ リ ー ス は 、 apt-get の コ マ ン ド ラ イ ン や 、 APT 設 定 フ ァ イ ル /etc/apt/apt.conf で 設 定 で き ま す 。 後 述 す る /etc/apt/preferences フ ァ イ ル で 設 定 し た 一 般 優 先 度 よ り も こ れ は 優 先 さ れ ま す が 、 pin 止 め し た パ ッ ケ ー ジ に は 及 ば な い こ と に 注 意 し て く だ さ い 。 例 え ば 以 下 の よ う に な り ま す 。

apt-get install -t testing some-package

APT::Default-Release "stable";

タ ー ゲ ッ ト リ リ ー ス が 指 定 さ れ る と 、 APT は 以 下 の ア ル ゴ リ ズ ム で 、 パ ッ ケ ー ジ の バ ー ジ ョ ン の 優 先 度 を 設 定 し ま す 。 以 下 の よ う に 割 り 当 て ま す 。

優 先 度 1

to the versions coming from archives which in their Release files are marked as "NotAutomatic: yes" but not as "ButAutomaticUpgrades: yes" like the Debian experimental archive, as well as versions that are not phased on this systems.

優 先 度 100

(も し あ れ ば ) 既 に イ ン ス ト ー ル 済 み の バ ー ジ ョ ン や 、 squeeze-backports 以 降 で あ る Debian の バ ッ ク ポ ー ト ア ー カ イ ブ の よ う な 、 Release フ ァ イ ル に "NotAutomatic: yes" か つ "ButAutomaticUpgrades: yes" と マ ー ク さ れ て い る ア ー カ イ ブ 由 来 の バ ー ジ ョ ン 。

優 先 度 500

タ ー ゲ ッ ト リ リ ー ス に 属 し て い な い バ ー ジ ョ ン 。

優 先 度 990

タ ー ゲ ッ ト リ リ ー ス に 属 す る バ ー ジ ョ ン 。

説 明 が バ ー ジ ョ ン と マ ッ チ し 、 優 先 順 位 が 最 も 高 い も の が バ ー ジ ョ ン に 割 り 当 て ら れ ま す 。

タ ー ゲ ッ ト リ リ ー ス が 指 定 さ れ て い な け れ ば 、 APT は 単 純 に イ ン ス ト ー ル し て い る パ ッ ケ ー ジ の バ ー ジ ョ ン に は 優 先 度 100 を 、 イ ン ス ト ー ル し て い な い パ ッ ケ ー ジ の バ ー ジ ョ ン に は 優 先 度 500 を 割 り 当 て ま す 。 た だ し 、 Release フ ァ イ ル に "NotAutomatic: yes" と マ ー ク さ れ た ア ー カ イ ブ 由 来 の バ ー ジ ョ ン は 違 い ま す 。 こ う い っ た バ ー ジ ョ ン で は 優 先 度 1 を 割 り 当 て 、 さ ら に "ButAutomaticUpgrades: yes" と マ ー ク さ れ て い る 場 合 に は 、 優 先 度 100 を 割 り 当 て ま す 。

APT は 、 イ ン ス ト ー ル す る パ ッ ケ ー ジ の バ ー ジ ョ ン を 決 定 す る た め に 、 以 下 の ル ー ル を 上 か ら 順 番 に 適 用 し ま す 。

• 有 効 な バ ー ジ ョ ン の 優 先 度 が 1000 を 越 え な い 場 合 、 決 し て ダ ウ ン グ レ ー ド し ま せ ん 。 (「 ダ ウ ン グ レ ー ド 」 は 、 現 在 の パ ッ ケ ー ジ の バ ー ジ ョ ン よ り も 、 小 さ い バ ー ジ ョ ン の も の を イ ン ス ト ー ル し ま す 。 APT の デ フ ォ ル ト 優 先 度 が 1000 を 越 え な い こ と に 注 意 し て く だ さ い 。 そ の よ う な 優 先 度 は 、 プ リ フ ァ レ ン ス フ ァ イ ル で の み 設 定 で き ま す 。 ま た 、 パ ッ ケ ー ジ の ダ ウ ン グ レ ー ド は 危 険 で あ る こ と に も 注 意 し て く だ さ い )

• 最 も 高 い 優 先 度 の バ ー ジ ョ ン を イ ン ス ト ー ル し ま す 。

• 同 じ 優 先 度 の バ ー ジ ョ ン が 複 数 存 在 す る 場 合 、 最 も 新 し い も の (最 も バ ー ジ ョ ン 番 号 が 高 い も の ) を イ ン ス ト ー ル し ま す 。

• 優 先 度 ・ バ ー ジ ョ ン 番 号 が 同 じ も の が 複 数 存 在 し 、 そ の パ ッ ケ ー ジ の メ タ デ ー タ が 異 な る か --reinstall オ プ シ ョ ン が 与 え ら れ て い る 場 合 、 イ ン ス ト ー ル さ れ て い な い も の を イ ン ス ト ー ル し ま す 。

よ く あ る 状 況 と し て 、 あ る イ ン ス ト ー ル さ れ て い る パ ッ ケ ー ジ の バ ー ジ ョ ン (優 先 度 100) が 、 sources.list (5) フ ァ イ ル の リ ス ト か ら 得 ら れ る バ ー ジ ョ ン (優 先 度 500 か 990) よ り も 新 し く な い と い う こ と が あ り ま す 。 こ の 場 合 、 apt-get install some-package や apt-get upgrade を 実 行 す る と パ ッ ケ ー ジ が 更 新 さ れ ま す 。

ま れ に 、 イ ン ス ト ー ル さ れ て い る パ ッ ケ ー ジ の バ ー ジ ョ ン が 、 他 の 有 効 な バ ー ジ ョ ン よ り も 新 し い 場 合 が あ り ま す 。 こ の 時 apt-get install some-package や apt-get upgrade を 実 行 し て も 、 ダ ウ ン グ レ ー ド し ま せ ん 。

時 々 、 イ ン ス ト ー ル し て い る パ ッ ケ ー ジ の バ ー ジ ョ ン が 、 タ ー ゲ ッ ト リ リ ー ス に 属 す る バ ー ジ ョ ン よ り も 新 し く 、 他 の デ ィ ス ト リ ビ ュ ー シ ョ ン よ り も 古 い 場 合 が あ り ま す 。 そ の よ う な パ ッ ケ ー ジ に 対 し て apt-get install some-package や apt-get upgrade を 実 行 す る と 、 パ ッ ケ ー ジ は 更 新 さ れ ま す 。 こ の 場 合 、 イ ン ス ト ー ル さ れ て い る バ ー ジ ョ ン よ り も 、 少 な く と も ひ と つ は 、 高 い 優 先 度 を 持 つ 有 効 な パ ッ ケ ー ジ が あ る か ら で す 。

Phased Updates

APT understands a field called Phased-Update-Percentage which can be used to control the rollout of a new version. It is an integer between 0 and 100.

A system's eligibility to a phased update is determined by seeding random number generator with the package source name, the version number, and /etc/machine-id, and then calculating an integer in the range [0, 100]. If this integer is larger than the Phased-Update-Percentage, the version is pinned to 1, and thus held back. Otherwise, normal policy rules apply.

In case you have multiple systems that you want to receive the same set of updates, you can set APT::Machine-ID to a UUID such that they all phase the same, or set APT::Get::Never-Include-Phased-Updates or APT::Get::Always-Include-Phased-Updates to true such that APT will never/always consider phased updates.

APT プ リ フ ァ レ ン ス フ ァ イ ル の 効 果

APT プ リ フ ァ レ ン ス フ ァ イ ル を 使 う と 、 シ ス テ ム 管 理 者 が 優 先 度 を 割 り 当 て ら れ る よ う に な り ま す 。 フ ァ イ ル は 、 空 白 行 で 区 切 ら れ た 、 複 数 行 か ら な る レ コ ー ド で 構 成 さ れ て い ま す 。 レ コ ー ド は 特 定 形 式 か 、 汎 用 形 式 の ど ち ら か の 形 式 を と り ま す 。

• 特 定 形 式 は 、 優 先 度 ("Pin-Priority") を 、 指 定 し た バ ー ジ ョ ン や バ ー ジ ョ ン 範 囲 の 、 指 定 し た パ ッ ケ ー ジ に つ い て 割 り 当 て ま す 。 例 え ば 以 下 の レ コ ー ド は 、 バ ー ジ ョ ン 番 号 が "5.32" で 始 ま る perl パ ッ ケ ー ジ を 、 高 い 優 先 度 に 設 定 し ま す 。 空 白 で 区 切 り 、 複 数 の パ ッ ケ ー ジ を 指 定 で き ま す 。

Package: perl
Pin: version 5.32*
Pin-Priority: 1001

Since 2.9.9, you can also pin by a source version:

Package: perl
Pin: source-version 5.32*
Pin-Priority: 1001

• 汎 用 形 式 は 、 与 え ら れ た デ ィ ス ト リ ビ ュ ー シ ョ ン に あ る 、 す べ て の パ ッ ケ ー ジ (Release フ ァ イ ル に 列 挙 し た パ ッ ケ ー ジ ) の 優 先 度 や 、 FQDNで 指 定 し た 、 特 定 の イ ン タ ー ネ ッ ト サ イ ト か ら 取 得 す る パ ッ ケ ー ジ の 優 先 度 を 割 り 当 て ま す 。

APT プ リ フ ァ レ ン ス フ ァ イ ル に 書 か れ て い る 汎 用 形 式 の エ ン ト リ は 、 パ ッ ケ ー ジ の グ ル ー プ に つ い て の み 適 用 さ れ ま す 。 例 え ば 以 下 の レ コ ー ド は 、 ロ ー カ ル サ イ ト に あ る 全 パ ッ ケ ー ジ に つ い て 、 高 い 優 先 度 を 割 り 当 て ま す 。

Package: *
Pin: origin ""
Pin-Priority: 999

注 意 : こ こ で 使 わ れ る キ ー ワ ー ド は 、 ホ ス ト 名 に マ ッ チ す る の に 使 わ れ る "origin" で す 。 以 下 の レ コ ー ド は 、 ホ ス ト 名 が "ftp.de.debian.org" で 識 別 さ れ る サ ー バ 由 来 の す べ て の バ ー ジ ョ ン に 、 高 い 優 先 度 を 割 り 当 て ま す 。

Package: *
Pin: origin "ftp.de.debian.org"
Pin-Priority: 999

Release フ ァ イ ル に 指 定 さ れ た よ う な 、 デ ィ ス ト リ ビ ュ ー シ ョ ン の Origin と 混 同 し な い よ う に し て く だ さ い 。 Release フ ァ イ ル に あ る "Origin:" タ グ は 、 イ ン タ ー ネ ッ ト ア ド レ ス で は な く 、 "Debian" や "Ximian" と い っ た 作 者 や ベ ン ダ 名 で す 。

以 下 の レ コ ー ド は 、 ア ー カ イ ブ 名 が "unstable" と な っ て い る デ ィ ス ト リ ビ ュ ー シ ョ ン に 属 す る パ ッ ケ ー ジ を 、 す べ て 低 い 優 先 度 に 割 り 当 て ま す 。

Package: *
Pin: release a=unstable
Pin-Priority: 50

以 下 の レ コ ー ド は 、 コ ー ド 名 が "forky" と な っ て い る デ ィ ス ト リ ビ ュ ー シ ョ ン に 属 す る パ ッ ケ ー ジ の バ ー ジ ョ ン を 、 高 い 優 先 度 に 割 り 当 て ま す 。

Package: *
Pin: release n=forky
Pin-Priority: 900

以 下 の レ コ ー ド は 、 ア ー カ イ ブ 名 が "stable" で 、 リ リ ー ス バ ー ジ ョ ン 番 号 が "13" と な っ て い る リ リ ー ス に 属 す る パ ッ ケ ー ジ を 、 す べ て 高 い 優 先 度 に 割 り 当 て ま す 。

Package: *
Pin: release a=stable, v=13
Pin-Priority: 500

コ ン マ 演 算 子 の 効 果 は "and" 論 理 に 似 て い ま す : ピ ン が 一 致 す る よ う に す べ て の 条 件 が ピ ン が 一 致 し な け れ ば な り ま せ ん 。 一 つ の 例 外 が あ り ま す : 条 件 の い ず れ か の 型 で は (例 え ば 、 二 つ の "a" 条 件 )、 た だ 最 後 の 条 件 の み が チ ェ ッ ク さ れ ま す 。

Matching packages in the Package field

The Package field specifies the package that a pinning priority is applied to. The field can either contain a binary package name, a source package name (prefixed with "src:"), a glob (7) expression or a regular expression (surrounded by slashes). Multiple package names, glob (7) expressions and regular expressions can be listed separated by whitespace in which case the record will match any of the matched packages.

By default, only packages of the native architecture are matched. To match binary packages of any architecture, add the :any suffix to the package name. You can also limit matching to a specific architecture by appending the architecture name to the package name, separated by a colon character.

For example, the following example uses a glob expression and a regular expression to assign the priority 500 to all packages from experimental where the name starts with gnome (as a glob (7)-like expression) or contains the word kde (as a POSIX extended regular expression surrounded by slashes).

Package: gnome* /kde/
Pin: release a=experimental
Pin-Priority: 500

こ の 表 現 の 規 則 は 、 文 字 が 現 れ う る 場 所 な ら 、 ど こ で も 発 生 し う る と い う 事 で す 。 し た が っ て 、 以 下 の pin は 、 plucky で 始 ま る リ リ ー ス 由 来 の 、 す べ て の パ ッ ケ ー ジ に 、 優 先 度 990 を 割 り 当 て ま す 。

Package: *
Pin: release n=plucky*
Pin-Priority: 990

Package フ ィ ー ル ド も 正 規 表 現 が 現 れ る 場 合 、 正 規 表 現 を 、 マ ッ チ す る す べ て の パ ッ ケ ー ジ 名 の リ ス ト に 置 き 換 え た も の と し て 、 動 作 し ま す 。 こ れ は 将 来 変 更 さ れ る か ど う か 、 ま だ 決 定 し て い ま せ ん 。 そ の た め 、 ま ず は じ め に ワ イ ル ド カ ー ド pin を 、 常 に 記 述 す る よ う に し て く だ さ い 。 そ の 後 に 続 く pin で 上 書 き さ れ ま す 。 Package フ ィ ー ル ド の "*" パ タ ー ン は 、 glob (7) 表 現 自 体 と は 見 な さ れ ま せ ん 。

To pin all binaries produced by the apt source package of this APT's version to 990, you can do:

Package: src:apt
Pin: version 3.0.3
Pin-Priority: 990

Source package pinning can be combined with regular expressions and glob patterns, and can also take a binary architecture.

For example, let's pin all binaries for all architectures produced by any source package containing apt in its name to 990:

Package: src:*apt*:any
Pin: version *
Pin-Priority: 990

The :any suffix makes sure to select binary packages from any architecture. Without that suffix, apt implicitly assumes the :native suffix which would only select packages from the native architecture.

APT が 優 先 度 に 割 り 込 む 方 法

APT プ リ フ ァ レ ン ス フ ァ イ ル で 割 り 当 て た 優 先 度 (P) は 、 正 負 の 整 数 で な く て は な り ま せ ん 。 こ れ は (お お ざ っ ぱ に い う と ) 以 下 の よ う に 解 釈 さ れ ま す 。

P >= 1000

パ ッ ケ ー ジ が ダ ウ ン グ レ ー ド し て も 、 こ の バ ー ジ ョ ン の パ ッ ケ ー ジ を イ ン ス ト ー ル

990 <= P < 1000

イ ン ス ト ー ル さ れ て い る バ ー ジ ョ ン の 方 が 新 し い の で な け れ ば 、 タ ー ゲ ッ ト リ リ ー ス に 含 ま れ な く て も 、 こ の バ ー ジ ョ ン の パ ッ ケ ー ジ を イ ン ス ト ー ル

500 <= P < 990

タ ー ゲ ッ ト リ リ ー ス に 属 す る バ ー ジ ョ ン が あ っ た り 、 イ ン ス ト ー ル さ れ て い る バ ー ジ ョ ン の 方 が 新 し い の で な け れ ば 、 こ の バ ー ジ ョ ン の パ ッ ケ ー ジ を イ ン ス ト ー ル

100 <= P < 500

他 の デ ィ ス ト リ ビ ュ ー シ ョ ン に 属 す る バ ー ジ ョ ン が あ っ た り 、 イ ン ス ト ー ル さ れ て い る バ ー ジ ョ ン の 方 が 新 し い の で な け れ ば 、 こ の バ ー ジ ョ ン の パ ッ ケ ー ジ を イ ン ス ト ー ル

0 < P < 100

こ の パ ッ ケ ー ジ が イ ン ス ト ー ル さ れ て い な い 場 合 、 こ の バ ー ジ ョ ン の パ ッ ケ ー ジ を イ ン ス ト ー ル

P < 0

こ の バ ー ジ ョ ン の イ ン ス ト ー ル 禁 止

P = 0

は 動 作 が 未 定 義 で す 、 使 用 し な い で く だ さ い 。

利 用 可 能 な パ ッ ケ ー ジ バ ー ジ ョ ン に 一 致 す る 最 初 の 特 定 形 式 の レ コ ー ド が 、 パ ッ ケ ー ジ バ ー ジ ョ ン の 優 先 度 を 決 定 し ま す 。 そ れ に 失 敗 す る と 、 パ ッ ケ ー ジ バ ー ジ ョ ン の 優 先 度 は 、 バ ー ジ ョ ン に 一 致 す る 汎 用 形 式 の レ コ ー ド で 定 義 さ れ た す べ て の 優 先 度 の 最 大 値 と し て 定 義 さ れ ま す 。

例 え ば 、 APT プ リ フ ァ レ ン ス フ ァ イ ル の 上 の 方 に 、 以 下 の レ コ ー ド が 書 か れ て い る と 仮 定 し て く だ さ い 。

Package: perl
Pin: version 5.32*
Pin-Priority: 1001

Package: *
Pin: origin ""
Pin-Priority: 999

Package: *
Pin: release unstable
Pin-Priority: 50

す る と 、 以 下 の よ う に 動 作 し ま す 。

• バ ー ジ ョ ン 番 号 が "5.32" で 始 ま っ て い れ ば 、 perl の 最 新 の 利 用 可 能 パ ッ ケ ー ジ が イ ン ス ト ー ル さ れ ま す 。 バ ー ジ ョ ン 5.32* が 利 用 可 能 で 、 バ ー ジ ョ ン 5.36* が イ ン ス ト ー ル さ れ て い る 場 合 、 perl は ダ ウ ン グ レ ー ド さ れ ま す 。

• ロ ー カ ル シ ス テ ム で 有 効 な 、 perl 以 外 の ど ん な パ ッ ケ ー ジ で も 、 他 の バ ー ジ ョ ン よ り (た と え タ ー ゲ ッ ト リ リ ー ス に 属 し て い て も ) 優 先 度 が 高 く な り ま す 。

• ロ ー カ ル シ ス テ ム に は な く て も sources.list (5) に 列 挙 さ れ た サ イ ト に あ る バ ー ジ ョ ン で 、 unstable デ ィ ス ト リ ビ ュ ー シ ョ ン に 属 し て い る パ ッ ケ ー ジ は 、 イ ン ス ト ー ル す る よ う 選 択 さ れ 、 既 に イ ン ス ト ー ル さ れ て い る バ ー ジ ョ ン が な い 場 合 に の み イ ン ス ト ー ル さ れ ま す 。

パ ッ ケ ー ジ の バ ー ジ ョ ン と デ ィ ス ト リ ビ ュ ー シ ョ ン プ ロ パ テ ィ の 決 定

sources.list (5) フ ァ イ ル に 列 挙 し た 場 所 で は 、 そ の 場 所 で 利 用 で き る パ ッ ケ ー ジ を 記 述 し た 、 Packages フ ァ イ ル や Release フ ァ イ ル を 提 供 し ま す 。

Packages フ ァ イ ル は 通 常 .../dists/ dist-name / component / arch デ ィ レ ク ト リ に あ り ま す 。 例 え ば 、 .../dists/stable/main/binary-i386/Packages で す 。 こ れ は 、 デ ィ レ ク ト リ に あ る 利 用 可 能 パ ッ ケ ー ジ ご と に 、 複 数 行 の レ コ ー ド か ら で き て い ま す 。 APT 優 先 度 の 設 定 は 、 レ コ ー ド ご と に 以 下 の 2 行 だ け で す 。

Package: 行

パ ッ ケ ー ジ 名

Version: 行

そ の 名 前 の パ ッ ケ ー ジ の バ ー ジ ョ ン 番 号

Release フ ァ イ ル は 、 通 常 .../dists/ dist-name デ ィ レ ク ト リ に あ り ま す 。 例 え ば 、 .../dists/stable/Release や .../dists/trixie/Release で す 。 こ れ は 、 こ の デ ィ レ ク ト リ 以 下 に あ る 全 パ ッ ケ ー ジ に 適 用 す る 、 複 数 行 の レ コ ー ド 1 つ か ら 成 っ て い ま す 。 Packages フ ァ イ ル と 違 い Release フ ァ イ ル は 、 以 下 の よ う に ほ と ん ど の 行 が APT 優 先 度 の 設 定 に 関 連 し ま す 。

Archive: 行 や Suite: 行

こ の デ ィ レ ク ト リ ツ リ ー に 属 す る 全 パ ッ ケ ー ジ の ア ー カ イ ブ 名 で す 。 例 え ば 、 "Archive: stable" や "Suite: stable" と い う 行 は 、 Release フ ァ イ ル の 親 デ ィ レ ク ト リ ツ リ ー 以 下 に あ る 全 パ ッ ケ ー ジ が 、 stable ア ー カ イ ブ だ と 指 定 し ま す 。 APT プ リ フ ァ レ ン ス フ ァ イ ル で こ の 値 を 指 定 す る に は 、 以 下 の 行 が 必 要 に な り ま す 。

Pin: release a=stable

Codename: 行

こ の デ ィ レ ク ト リ ツ リ ー に 属 す る 全 パ ッ ケ ー ジ の コ ー ド 名 で す 。 た と え ば 、 "Codename: forky" と い う 行 は 、 Release フ ァ イ ル の 親 デ ィ レ ク ト リ ツ リ ー 以 下 に あ る 全 パ ッ ケ ー ジ が 、 forky と 名 前 の つ い た バ ー ジ ョ ン で あ る と 指 定 し ま す 。 APT プ リ フ ァ レ ン ス フ ァ イ ル で こ の 値 を 指 定 す る に は 、 以 下 の 行 が 必 要 に な り ま す 。

Pin: release n=forky

Version: 行

リ リ ー ス バ ー ジ ョ ン 名 で す 。 例 え ば 、 こ の ツ リ ー の パ ッ ケ ー ジ が 、 Debian リ リ ー ス バ ー ジ ョ ン 13 に 属 す る と し ま す 。 通 常 testing デ ィ ス ト リ ビ ュ ー シ ョ ン や unstable デ ィ ス ト リ ビ ュ ー シ ョ ン に は 、 ま だ リ リ ー ス さ れ て い な い の で 、 バ ー ジ ョ ン 番 号 が 付 き ま せ ん 。 APT プ リ フ ァ レ ン ス フ ァ イ ル で こ れ を 指 定 す る に は 、 以 下 の 行 の い ず れ か が 必 要 に な り ま す 。

Pin: release v=13
Pin: release a=stable, v=13
Pin: release 13

Component: 行

Release フ ァ イ ル の 、 デ ィ レ ク ト リ ツ リ ー に あ る パ ッ ケ ー ジ の ラ イ セ ン ス コ ン ポ ー ネ ン ト 名 で す 。 例 え ば 、 "Component: main" と い う 行 は 、 こ の デ ィ レ ク ト リ 以 下 の 全 フ ァ イ ル が 、 main コ ン ポ ー ネ ン ト (Debian フ リ ー ソ フ ト ウ ェ ア ガ イ ド ラ イ ン の 元 で ラ イ セ ン ス さ れ て い る ) で あ る こ と を 表 し ま す 。 APT プ リ フ ァ レ ン ス フ ァ イ ル で こ の コ ン ポ ー ネ ン ト を 指 定 す る に は 、 以 下 の 行 が 必 要 に な り ま す 。

Pin: release c=main

Origin: 行

Release フ ァ イ ル の デ ィ レ ク ト リ ツ リ ー に あ る パ ッ ケ ー ジ の 提 供 者 名 で す 。 ほ と ん ど 共 通 で Debian で す 。 APT プ リ フ ァ レ ン ス フ ァ イ ル で こ の 提 供 者 を 指 定 す る に は 、 以 下 の 行 が 必 要 に な り ま す 。

Pin: release o=Debian

Label: 行

Release フ ァ イ ル の デ ィ レ ク ト リ ツ リ ー に あ る パ ッ ケ ー ジ の ラ ベ ル 名 で す 。 ほ と ん ど 共 通 で Debian で す 。 APT プ リ フ ァ レ ン ス フ ァ イ ル で こ の ラ ベ ル を 指 定 す る に は 、 以 下 の 行 が 必 要 に な り ま す 。

Pin: release l=Debian

sources.list (5) フ ァ イ ル に 列 挙 さ れ た 場 所 か ら 取 得 し た Packages フ ァ イ ル や Release フ ァ イ ル は す べ て 、 /var/lib/apt/lists デ ィ レ ク ト リ や 、 apt.conf フ ァ イ ル の Dir::State::Lists 変 数 で 指 定 し た 場 所 に 取 得 さ れ ま す 。 例 え ば 、 debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release フ ァ イ ル は 、 debian.lcs.mit.edu か ら 取 得 し た 、 unstable デ ィ ス ト リ ビ ュ ー シ ョ ン で 、 contrib コ ン ポ ー ネ ン ト な 、 binary-i386 ア ー キ テ ク チ ャ 用 の Release フ ァ イ ル を 含 ん で い ま す 。

APT プ リ フ ァ レ ン ス レ コ ー ド の オ プ シ ョ ン 行

APT プ リ フ ァ レ ン ス フ ァ イ ル の レ コ ー ド ご と に 、 任 意 で Explanation: で 始 ま る 行 を 持 て ま す 。 こ れ は 、 コ メ ン ト 用 の 場 所 を 確 保 し ま す 。

サ ン プ ル

安 定 版 の 追 跡

以 下 の APT プ リ フ ァ レ ン ス フ ァ イ ル は 、 stable デ ィ ス ト リ ビ ュ ー シ ョ ン に 属 す る 全 て の パ ッ ケ ー ジ の バ ー ジ ョ ン に 、 デ フ ォ ル ト (500) よ り 高 い 優 先 度 を 割 り 当 て 、 他 の Debian デ ィ ス ト リ ビ ュ ー シ ョ ン の パ ッ ケ ー ジ の バ ー ジ ョ ン に は 、 低 く て イ ン ス ト ー ル で き な い よ う な 優 先 度 を 割 り 当 て ま す 。

Explanation: Uninstall or do not install any Debian-originated
Explanation: package versions other than those in the stable distro
Package: *
Pin: release a=stable
Pin-Priority: 900

Package: *
Pin: release o=Debian
Pin-Priority: -10

適 切 な sources.list (5) フ ァ イ ル と 上 記 の プ リ フ ァ レ ン ス フ ァ イ ル に よ り 、 以 下 の コ マ ン ド の い ず れ か で 最 新 の stable バ ー ジ ョ ン に ア ッ プ グ レ ー ド で き ま す 。

apt-get install package-name
apt-get upgrade
apt-get dist-upgrade

以 下 の コ マ ン ド で 、 指 定 し た パ ッ ケ ー ジ を testing デ ィ ス ト リ ビ ュ ー シ ョ ン の 最 新 バ ー ジ ョ ン に ア ッ プ グ レ ー ド し ま す 。 こ の パ ッ ケ ー ジ は 、 再 度 こ の コ マ ン ド を 発 行 し な い と ア ッ プ グ レ ー ド さ れ ま せ ん 。

apt-get install package /testing

テ ス ト 版 や 不 安 定 版 の 追 跡

以 下 の APT プ リ フ ァ レ ン ス フ ァ イ ル は 、 testing デ ィ ス ト リ ビ ュ ー シ ョ ン の パ ッ ケ ー ジ の バ ー ジ ョ ン に 高 い 優 先 度 を 割 り 当 て 、 unstable デ ィ ス ト リ ビ ュ ー シ ョ ン の パ ッ ケ ー ジ の バ ー ジ ョ ン に は 低 い 優 先 度 を 割 り 当 て ま す 。 ま た 他 の Debian デ ィ ス ト リ ビ ュ ー シ ョ ン の パ ッ ケ ー ジ の バ ー ジ ョ ン に は 、 低 く て イ ン ス ト ー ル で き な い よ う な 優 先 度 を 割 り 当 て ま す 。

Package: *
Pin: release a=testing
Pin-Priority: 900

Package: *
Pin: release a=unstable
Pin-Priority: 800

Package: *
Pin: release o=Debian
Pin-Priority: -10

適 切 な sources.list (5) フ ァ イ ル と 上 記 の プ リ フ ァ レ ン ス フ ァ イ ル に よ り 、 以 下 の コ マ ン ド の い ず れ か で 最 新 の testing バ ー ジ ョ ン に ア ッ プ グ レ ー ド で き ま す 。

apt-get install package-name
apt-get upgrade
apt-get dist-upgrade

以 下 の コ マ ン ド で 、 指 定 し た パ ッ ケ ー ジ を unstable デ ィ ス ト リ ビ ュ ー シ ョ ン の 最 新 バ ー ジ ョ ン に ア ッ プ グ レ ー ド し ま す 。 そ れ 以 降 、 apt-get upgrade は testing バ ー ジ ョ ン の パ ッ ケ ー ジ が 更 新 さ れ て い れ ば testing の 最 新 版 に 、 unstable バ ー ジ ョ ン の パ ッ ケ ー ジ が 更 新 さ れ て い れ ば unstable の 最 新 版 に ア ッ プ グ レ ー ド し ま す 。

apt-get install package /unstable

コ ー ド 名 リ リ ー ス の 進 化 の 追 跡

以 下 の APT プ リ フ ァ レ ン ス フ ァ イ ル は 、 指 定 し た コ ー ド 名 の デ ィ ス ト リ ビ ュ ー シ ョ ン に 属 す る 全 て の パ ッ ケ ー ジ の バ ー ジ ョ ン に 、 デ フ ォ ル ト (500) よ り 高 い 優 先 度 を 割 り 当 て 、 他 の Debian デ ィ ス ト リ ビ ュ ー シ ョ ン 、 コ ー ド 名 、 ア ー カ イ ブ の パ ッ ケ ー ジ の バ ー ジ ョ ン に は 、 低 く て イ ン ス ト ー ル で き な い よ う な 優 先 度 を 割 り 当 て ま す 。 こ の APT プ リ フ ァ レ ン ス フ ァ イ ル に よ り 、 APT は testing ア ー カ イ ブ か ら 、 stable や 最 新 の oldstable へ 移 行 で き ま す 。 コ ー ド 名 の 変 更 に 関 係 な く testing を 追 跡 し た い 場 合 は 、 上 記 の 設 定 例 を 使 用 す る べ き で す 。

Explanation: Uninstall or do not install any Debian-originated package versions
Explanation: other than those in the distribution codenamed with forky or sid
Package: *
Pin: release n=forky
Pin-Priority: 900

Explanation: Debian unstable is always codenamed with sid
Package: *
Pin: release n=sid
Pin-Priority: 800

Package: *
Pin: release o=Debian
Pin-Priority: -10

適 切 な sources.list (5) フ ァ イ ル と 上 記 の プ リ フ ァ レ ン ス フ ァ イ ル に よ り 、 以 下 の コ マ ン ド の い ず れ か で 、 リ リ ー ス コ ー ド 名 が forky で あ る 最 新 バ ー ジ ョ ン に ア ッ プ グ レ ー ド で き ま す 。

apt-get install package-name
apt-get upgrade
apt-get dist-upgrade

以 下 の コ マ ン ド で 、 指 定 し た パ ッ ケ ー ジ を sid デ ィ ス ト リ ビ ュ ー シ ョ ン の 最 新 バ ー ジ ョ ン に ア ッ プ グ レ ー ド し ま す 。 そ れ 以 降 、 apt-get upgrade は forky バ ー ジ ョ ン の パ ッ ケ ー ジ が 更 新 さ れ て い れ ば forky の 最 新 版 に 、 sid バ ー ジ ョ ン の パ ッ ケ ー ジ が 更 新 さ れ て い れ ば sidの 最 新 版 に ア ッ プ グ レ ー ド し ま す 。

apt-get install package /sid

フ ァ イ ル

/etc/apt/preferences

バ ー ジ ョ ン プ リ フ ァ レ ン ス フ ァ イ ル 。 こ こ に "pin"の 設 定 を 行 い ま す 。 つ ま り 、 別 々 の 取 得 元 や 異 な る デ ィ ス ト リ ビ ュ ー シ ョ ン の バ ー ジ ョ ン の 、 ど こ か ら パ ッ ケ ー ジ を 取 得 す る か を 設 定 し ま す 。 設 定 項 目 : Dir::Etc::Preferences

/etc/apt/preferences.d/

バ ー ジ ョ ン プ リ フ ァ レ ン ス フ ァ イ ル 断 片 。 設 定 項 目 : Dir::Etc::PreferencesParts

関 連 項 目

apt-get (8) apt-cache (8) apt.conf (5) sources.list (5)

バ グ

APT バ グ ペ ー ジ [1] を ご 覧 く だ さ い 。 APT の バ グ を 報 告 す る 場 合 は 、 /usr/share/doc/debian/bug-reporting.txt や reportbug (1) コ マ ン ド を ご 覧 く だ さ い 。

翻 訳

倉 澤 望 <nabetaro@debian.or.jp> (2003-2006,2009-2012), Takuma Yamada <tyamada@takumayamada.com> (2016), Debian JP Documentation ML <debian-doc@debian.or.jp>

こ の 翻 訳 文 書 に は 未 訳 部 分 が 含 ま れ て い る 可 能 性 が あ る こ と に 注 意 し て く だ さ い 。 翻 訳 が オ リ ジ ナ ル に 追 従 で き て い な い 場 合 、 内 容 を 失 わ な い よ う に こ の よ う に し て い ま す 。

著 者

[FAMILY Given]

注 記

1.

APT バ グ ペ ー ジ

https://bugs.debian.org/src:apt

---