apt-get
は、パッケージを操作するコマンドラインツールで、APT
ライブラリを用いる他のツールのユーザ側「バックエンド」といえるものです。「フロントエンド」インターフェースには、aptitude(8),
synaptic(8), wajig(1)
などがあります。
-h オプションや
--help
オプションを除き、以下に挙げるコマンドが必要です。
update
updateは、取得元からパッケージインデックスファイルの再同期を行うのに使用します。利用可能なパッケージのインデックスは、/etc/apt/sources.list
に記述した場所から取得します。例えば
Debian
アーカイブを利用する際、このコマンドが
Packages.gz
ファイルを検索することで、新規または更新されたパッケージの情報が利用可能となります。update
は、upgrade や dist-upgrade
を行う前に常に実行してください。前もってパッケージファイルのサイズを知ることができないため、全体の進捗メータは正しく表示されません。
upgrade
upgrade
は、現在システムにインストールされている全パッケージの最新バージョンを、/etc/apt/sources.list
に列挙した取得元からインストールするのに使用します。現在インストール中のパッケージに新しいバージョンがあれば更新しますが、いかなる時も現在インストール中のパッケージの削除は行いませんし、インストールしていないパッケー所の取得・インストールは行いません。対象のパッケージが、他のパッケージのインストール状態を変更せずに更新できない場合は、現在のバージョンのままとなります。最初に
update
を実行しておき、apt-get
にパッケージの新しいバージョンがあることを知らせる必要があります。
dist-upgrade
dist-upgrade は、upgrade
の機能に加え、新バージョンのパッケージに対する依存関係の変更を知的に操作します。
apt-get
は「洗練された」競合解決システムを持ち、必要とあらば比較的重要でないパッケージを犠牲にして、最重要パッケージの更新を試みます。そのため
dist-upgrade
は、いくつかのパッケージを削除する可能性があります。/etc/apt/sources.list
ファイルには、必要なパッケージファイルを検索する場所のリストが含まれています。特定のパッケージ向けに、一般的な設定を上書きする機構については、
apt_preferences(5)
をご覧ください。
dselect-upgrade
dselect-upgrade
は、伝統的な Debian GNU/Linux
パッケージ管理フロントエンドの
dselect(1)
と共に使用されます。dselect-upgrade
は、
dselect(1)
で作られた利用可能パッケージのStatus
フィールドの変更を追跡し、その状態を反映させるのに必要なアクションを実行します。(例えば、古いパッケージの削除や新しいパッケージのインストールなど)
install
install
の後には、インストールや更新したいパッケージを
1
つ以上指定します。指定するパッケージは、完全なファイル名ではなくパッケージ名です
(例えば Debian
システムでは、apt-utils_2.6.1_amd64.deb
ではなく apt-utils
を引数として与えます)。インストールするよう指定したすべてのパッケージに対し、依存パッケージも含めて取得・インストールを行います。/etc/apt/sources.list
ファイルを、要求するパッケージの場所を特定するのに使用します。パッケージ名の後ろに
(空白を含まず)
ハイフンが追加されている場合、そのパッケージがインストールされていれば削除します。同様に、インストールするパッケージを明示するのにプラス記号も使用できます。この記号は
apt-get
の競合解決システムの判断を上書きするのに利用される可能性があります。
パッケージにイコール記号とバージョンを続けることで、選択したバージョンのパッケージをインストールすることができます。つまり、指定のバージョンのパッケージをインストールするように選択する、ということです。別の方法としては、ディストリビューションを特定するのに、パッケージ名に続けて、スラッシュとディストリビューションのバージョンやアーカイブ名
(stable, testing, unstable)
を記述できます。
バージョン選択機構はダウングレードにも使用できるため、注意して使用しなければなりません。
システムにインストール済みのパッケージを、すべてアップグレードするのではなく、いくつかのパッケージをアップグレードする場合にも、このターゲットを使用できます。現在インストールされているパッケージすべての最新版をインストールする
"upgrade"
ターゲットと異なり、"install"
は指定したパッケージの最新版のみをインストールします。単純にアップグレードしたいパッケージ名を指定してください。より新しいバージョンが利用できる場合、そのパッケージ
(と前述の依存関係にあるパッケージ)
をダウンロード・インストールします。
最後に、apt_preferences(5)
機構により、特定のパッケージに対するインストールポリシーを作成できます。
構文に '.', '?', '*'
を含み、パッケージ名がマッチしなかった場合、POSIX
正規表現であると見なし、データベース内の全パッケージ名に対して適用します。マッチしたパッケージすべてがインストール(もしくは削除)されます。'lo.*'
のような文字列は、'how-lo'
や 'lowest'
にマッチすることに注意してください。そうしたくなければ、'^'
や '$'
を付けるか、もっと詳しい正規表現を指定してください。
Fallback to regular expressions is deprecated in APT 2.0, has been
removed in apt(8), except for anchored expressions, and will be
removed from apt-get(8) in a future version. Use
apt-patterns(5) instead.
reinstall
reinstall is an alias for install --reinstall.
remove
remove
は、パッケージが削除されることを除き、install
と同様です。削除されたパッケージの設定ファイルは、システムに残ったままになることに注意してください。プラス記号がパッケージ名に
(間に空白を含まずに)
付加されると、識別されたパッケージを、削除ではなくインストールします。
purge
パッケージが削除かつ完全削除
(すべての設定ファイルも削除)
されるのを除き、purge は
remove と同じです。
source
source は、
apt-get
にソースパッケージを取得させます。APT
はどのソースパッケージを取得するか決めるため、利用可能なパッケージを検査します。その後、デフォルトリリースから最新の利用可能なソースパッケージを見つけ、カレントディレクトリへダウンロードします。デフォルトリリースは、可能であれば、APT::Default-Release
オプション、
-t
オプション、パッケージごとの
pkg/release
構文で指定します。
The arguments are interpreted as binary and source package names.
See the --only-source option if you want to change that.
ソースパッケージは、sources.list(5)
ファイルの deb-src
行により、バイナリパッケージと分けて管理されます。つまり、ソースを取得したいリポジトリを、それぞれ追加する必要があるということです。こうしないと、誤った
(古すぎ・新しすぎな)
ソースバージョンを取得したり、何も取得できなくなります。
--compile
オプションを指定すると、dpkg-buildpackage
を用いて、--host-architecture
オプションで定義したアーキテクチャのバイナリ
.deb
パッケージをコンパイルします。--download-only
を指定すると、ソースパッケージを展開しません。
パッケージと同様に、ソース名の後ろにイコールと取得したいバージョンを置くと、指定したバージョンのソースを取得できます。APT::Get::Only-Source
オプションが暗黙のうちに有効になっているため、ソースパッケージ名とバージョンに厳密に一致させています。
ソースパッケージはインストールされず、バイナリパッケージのように
dpkg
データベースで管理されないことに注意してください。ソースの
tarball
のように、単にカレントディレクトリにダウンロードします。
build-dep
build-dep
は、ソースパッケージの構築依存関係を満たすように、パッケージのインストール・削除を行います。デフォルトでは、パッケージをネイティブに構築する依存関係を満たします。お望みなら、
--host-architecture
オプションにより、別のホストアーキテクチャを指定できます。
The arguments are interpreted as binary or source package names.
See the --only-source option if you want to change that.
satisfy
satisfy causes apt-get to satisfy the given dependency
strings. The dependency strings may have build profiles and architecture
restriction list as in build dependencies. They may optionally be prefixed
with "Conflicts: " to unsatisfy the dependency string. Multiple
strings of the same type can be specified.
Example: apt-get satisfy "foo" "Conflicts:
bar" "baz (>> 1.0) | bar (= 2.0), moo"
The legacy operator '</>' is not supported, use
'<=/>=' instead.
check
check
は、パッケージキャッシュの更新や壊れた依存関係をチェックする診断ツールです。
download
download will download the given binary package into the
current directory. The authenticity of the package data is ensured as
usual.
clean
clean
は、取得したパッケージのローカルリポジトリを掃除します。/var/cache/apt/archives/
と /var/cache/apt/archives/partial/
からロックファイル以外すべて削除します。
autoclean (および auto-clean 1.1
以降の別名)
clean のように、autoclean
は取得したパッケージのローカルリポジトリを掃除します。違いは、もうダウンロードされることがないパッケージファイルや、ほとんど不要なパッケージファイルのみを削除することです。このため、キャッシュは、制御不能になるほど成長することなく、長期にわたって維持することができます。設定オプション
APT::Clean-Installed に off
をセットしていれば、インストール済みのパッケージファイルが削除されるのを防ぐことができます。
autoremove (および auto-remove 1.1
以降の別名)
autoremove
は、他のパッケージの依存関係を満たすために自動的にインストールされ、もう必要なくなったパッケージを削除するのに使用します。
autopurge
Like autoremove, but autopurge also removes configuration
files. This is a shortcut for autoremove --purge.
changelog
changelog
は、パッケージの changelog
をダウンロードし、sensible-pager
で表示します。デフォルトでは、インストールされているバージョンの
changelog
を表示します。しかし、install
コマンドと同じオプションを指定することができます。
indextargets
デフォルトでは
apt-get update
でダウンロードすることができるすべてのデータファイル
(別名インデックスターゲット)
に関する情報の deb822
形式のリストを表示します。出力形式を変更する、またレコードをフィルタするデフォルト出力の行を受け付けるための
--format
オプションをサポートします。コマンドは主に、ダウンロードしたファイルの情報やファイル名を取得するために、APT
を扱う外部ツール用のインターフェースとして使用されます。そして、外部ツールが自身で再度ダウンロードする代わりに使用することができます。詳細なドキュメントはここでは省略しますが、代わりに
apt-doc
パッケージに収録されている
doc/acquire-additional-files.txt
で見つけることができます。
オプション¶
ここで設定オプションとして説明したコマンドラインオプションは、
すべて設定ファイルを使用して設定できます。
設定ファイルに書いた真偽値をとるオプションは
-f-,--no-f, -f=no
などのようにして上書きできます。
--no-install-recommends
「推奨」パッケージをインストールする依存関係と見なしません。設定項目:
APT::Install-Recommends
--install-suggests
「提案」パッケージをインストールする依存関係と見なします。設定項目:
APT::Install-Suggests
-d, --download-only
ダウンロードのみ
-
パッケージファイルの取得のみを行い、展開・インストールを行いません。設定項目:
APT::Get::Download-Only
-f, --fix-broken
修復 -
依存関係が壊れたシステムの修正を試みます。このオプションを
install や remove
と一緒に使うときは、APT
が解決法を推測するので、パッケージを指定しなくてもかまいません。どのパッケージを指定しても、完全に問題を解決します。APT
自体は、システムに存在する破損したパッケージ依存関係を許すことができないので、初めて
APT
を実行する場合、このオプションが必要になることがあります。システムの依存関係構造にかなり問題がある場合は、手動で修正するよう要求することもあります。(通常は、問題のあるパッケージを取り除くのに
dpkg --remove を使用します)
このオプションを -m
オプションと同時に使用すると、エラーになる状況があるかもしれません。設定項目:
APT::Get::Fix-Broken
-m, --ignore-missing, --fix-missing
欠落パッケージの無視
-
パッケージが取得できなかったり、(パッケージの破損で)
取得した後の整合性チェックに失敗した場合、そのパッケージの処理を保留し最後まで処理を続けます。このオプションを
-f
オプションと同時に使用すると、エラーになる状況があるかもしれません。パッケージをインストールするよう選択している
(特にコマンドラインでの操作する)
場合や、ダウンロードできなかった場合に、なにも表示せず保留することになります。設定項目:
APT::Get::Fix-Missing
--no-download
パッケージのダウンロードを無効にします。これはすでにダウンロードした
.deb に対してのみ APT
を行う場合に、--ignore-missing
と併せて使うのがよいでしょう。設定項目:
APT::Get::Download
-q, --quiet
静粛 -
進捗表示を省略し、ログをとるのに便利な出力を行います。最大
2 つまで q
を重ねることでより静粛にできます。また、-q=#
のように静粛レベルを指定して、設定ファイルを上書きすることもできます。静粛レベル
2 は -y
を含んでいることに注意してください。APT
が意図しない決定を行うかもしれないので
-d, --print-uris, -s
のような操作を行わないオプションをつけずに
-qq
を使用するべきではありません。設定項目:
quiet
-s, --simulate, --just-print,
--dry-run, --recon, --no-act
何もしない -
現在のシステム状態に基づいて起こるイベントのシミュレーションを行い、実際にはシステムを変更しません。ロックは無効になる
(
Debug::NoLocking) ので、
apt-get
実行中にシステムの状態が変化する可能性があります。シミュレーションは
root
以外のユーザが実行できますが、シミュレーションを歪めるすべての
apt
設定への読み取りアクセス権を持っていない可能性があります。この警告を表す通知は、root
以外のユーザではデフォルトで表示されます
(
APT::Get::Show-User-Simulation-Note)。設定項目:
APT::Get::Simulate
シミュレートの結果、dpkg
の動作を表す一連の行のそれぞれに、設定
(Conf)、削除 (Remv)、展開 (Inst)
を表示します。角カッコは壊れたパッケージを表し、(まれに)
空の角カッコは大した問題ではないことを表します。
-y, --yes, --assume-yes
プロンプトへの自動承諾
-
すべてのプロンプトに自動的に
"yes"
と答え、非対話的に実行します。保留したパッケージの状態を変更したり、必須パッケージを削除するような不適切な状況の場合、apt-get
は処理を中断します。設定項目:
APT::Get::Assume-Yes
--assume-no
全ての質問に、自動的に
"no"
と答えます。設定項目:
APT::Get::Assume-No
--no-show-upgraded
更新される全パッケージの表示を行いません。設定項目:
APT::Get::Show-Upgraded
-V, --verbose-versions
更新・インストールするパッケージのバージョンをすべて表示します。設定項目:
APT::Get::Show-Versions
-a, --host-architecture
このオプションは、apt-get
source --compile
で構築するパッケージのアーキテクチャや、どのようにクロス依存関係を解決するかを制御します。デフォルトでは未定義で、これはホストアーキテクチャは、(APT::Architecture
で定義した)
ビルドアーキテクチャと同じという意味になります。設定項目:
APT::Get::Host-Architecture。
-P, --build-profiles
このオプションは、apt-get
source --compile
でパッケージをビルドする際に有効化するビルドプロファイルや、どのようにクロス依存関係を解決するかを制御します。デフォルトでは有効化するビルドプロファイルはありません。コンマで連結することで複数のビルドプロファイルを有効化できます。設定項目:
APT::Get::Host-Architecture
-b, --compile, --build
ソースパッケージをダウンロード後、コンパイルします。設定項目:
APT::Get::Compile
--ignore-hold
保留パッケージの無視
-
パッケージの保留指示を無視して
apt-get を行います。dist-upgrade
と共に使用し、パッケージを大量に、保留解除するのに便利です。設定項目:
APT::Ignore-Hold
--with-new-pkgs
upgrade
と併せて使った場合に新しいパッケージのインストールを許可します。これは新しい依存をインストールするために既にインストールされているパッケージを更新する必要がある場合に有用です。パッケージを保留する代わりに
upgrade
がパッケージをアップグレードして新しい依存をインストールします。このオプションと併せて使った場合、upgrade
がパッケージを削除することはなく、新規追加を許可するだけであることに注意してください。設定項目:
APT::Get::Upgrade-Allow-New
--no-upgrade
パッケージ更新なし
- install
と同時に使用すると、no-upgrade
は、コマンドラインで指定したパッケージが、すでにインストールしてある場合に更新を行いません。設定項目:
APT::Get::Upgrade
--only-upgrade
新規パッケージインストールなし
- install
と同時に使用すると、only-upgrade
は、すでにインストールされているパッケージのみをアップグレードし、新しいパッケージのインストール要求を無視します。設定項目:
APT::Get::Only-Upgrade
--allow-downgrades
ダウングレードを行う場合でも、確認なしで実行してしまう危険なオプションです。よほどの状況でなければ、使うべきではありません。このオプションを使うと、システムを破壊しかねません!
設定項目: APT::Get::allow-downgrades。APT 1.1
で導入されました。
--allow-remove-essential
強制承諾 -
必要不可欠なものを削除する場合でも、確認なしで実行してしまう危険なオプションです。よほどの状況でなければ、使うべきではありません。force-yes
を使うと、システムを破壊しかねません!
設定項目: APT::Get::allow-remove-essential。APT
1.1
で導入されました。
--allow-change-held-packages
強制承諾 -
保持されたパッケージを変更する場合でも、確認なしで実行してしまう危険なオプションです。よほどの状況でなければ、使うべきではありません。このオプションを使うと、システムを破壊しかねません!
設定項目:
APT::Get::allow-change-held-packages。APT 1.1
で導入されました。
--force-yes
Force yes; this is a dangerous option that will cause apt
to continue without prompting if it is doing something potentially harmful. It
should not be used except in very special situations. Using force-yes can
potentially destroy your system! Configuration Item: APT::Get::force-yes. This
is deprecated and replaced by --allow-unauthenticated ,
--allow-downgrades , --allow-remove-essential ,
--allow-change-held-packages in 1.1.
--print-uris
インストールするファイルを取得する代わりに、その
URI を表示します。URI
には、パス、対象ファイル名、ファイルサイズ、予測される
MD5
ハッシュが含まれています。出力したファイル名が、常にリモートサイトのファイル名と一致するわけではない、ということに注意してください!
これは source コマンド、update
コマンドでも動作します。update
で使用したときには、MD5
やファイルサイズを含みません。このとき、圧縮ファイルの展開はユーザの責任において行ってください。設定項目:
APT::Get::Print-URIs
--purge
削除する際、「削除」ではなく「完全削除」を行います。「完全削除」を行うと指示したパッケージ名の後には、アスタリスク
("*") が付きます。remove
--purge は purge
コマンドと等価です。
設定項目: APT::Get::Purge
--reinstall
すでに最新版がインストールされていても、パッケージを再インストールします。設定項目:
APT::Get::ReInstall
--list-cleanup
この機能はデフォルトで
ON になっています。OFF
にするには --no-list-cleanup
としてください。ON
の場合、apt-get
は古くなったファイルを確実に消去するため、自動的に
/var/lib/apt/lists
の中身を管理します。これを
OFF
にするのは、取得元リストを頻繁に変更する時ぐらいでしょう。設定項目:
APT::Get::List-Cleanup
-t, --target-release, --default-release
このオプションは、ポリシーエンジンへのデフォルト入力を制御します。また、指定されたリリース文字列を使用し、デフォルト
pin を優先度 990
で作成します。これは、/etc/apt/preferences
にある一般設定を上書きします。pin
で留めるのを明示されたパッケージには、このオプションの値は影響を与えません。つまりこのオプションで、どの配布パッケージを取得するかを簡単に管理します。一般的な例としては、
-t
'2.1*',
-t unstable,
-t sid
のようになります。設定項目:
APT::Default-Release。
apt_preferences(5)
のマニュアルページも参照してください。
--trivial-only
「重要でない」操作のみを行います。これは論理的に
--assume-yes
の仲間と見なせます。--assume-yes
は質問にすべて yes
と答えますが、--trivial-only
はすべて no
と答えます。設定項目:
APT::Get::Trivial-Only
--mark-auto
After successful installation, mark all freshly installed
packages as automatically installed, which will cause each of the packages to
be removed when no more manually installed packages depend on this package.
This is equally to running apt-mark auto for all installed packages.
Configuration Item: APT::Get::Mark-Auto.
--no-remove
パッケージが削除される状況になったとき、プロンプトを表示せず中断します。設定項目:
APT::Get::Remove
--auto-remove, --autoremove
コマンドが install か
remove
である場合、このオプションは使用していない依存しているパッケージを削除し、autoremove
コマンドのように動作します。設定項目:
APT::Get::AutomaticRemove
--only-source
source コマンドと build-dep
コマンドでのみ意味があります。指定されたソース名がバイナリテーブルにマップされないようにします。これは、このオプションを指定すると、バイナリパッケージ名を受け付けて対応するソースパッケージを探すのではなく、引数にソースパッケージ名しか受け付けなくなる、ということです。設定項目:
APT::Get::Only-Source
--diff-only, --dsc-only, --tar-only
ソースアーカイブの
diff ファイルや dsc
ファイル、tar
ファイルのダウンロードのみを行います。設定項目:
APT::Get::Diff-Only, APT::Get::Dsc-Only, APT::Get::Tar-Only
--arch-only
構築依存関係の解決を、アーキテクチャに依存したもののみ行います。設定項目:
APT::Get::Arch-Only
--indep-only
構築依存関係の解決を、アーキテクチャに依存しないもののみ行います。設定項目:
APT::Get::Arch-Only
--allow-unauthenticated
パッケージが認証できない場合は無視してください。プロンプトは表示されません。ローカルリポジトリでの作業中には有用ですが、ユーザ自身が別の方法でデータの信憑性を確保していない場合は、セキュリティ上の重大なリスクになります。
sources.list(5)
エントリ用の
Trusted
オプションの使用は、通常グローバルオーバーライドよりも優先されるはずです。設定項目:
APT::Get::AllowUnauthenticated
--allow-insecure-repositories
Allow the update command to acquire unverifiable data
from configured sources. APT will otherwise fail at the update command for
repositories without valid cryptographically signatures. See also
apt-secure(8) for details on the concept and the implications.
Configuration Item: Acquire::AllowInsecureRepositories.
--allow-releaseinfo-change
Allow the update command to continue downloading data
from a repository which changed its information of the release contained in
the repository indicating e.g a new major release. APT will fail at the update
command for such repositories until the change is confirmed to ensure the user
is prepared for the change. See also
apt-secure(8) for details on the
concept and configuration.
Specialist options (--allow-releaseinfo-change-field) exist
to allow changes only for certain fields like origin, label, codename,
suite, version and defaultpin. See also apt_preferences(5).
Configuration Item: Acquire::AllowReleaseInfoChange.
--show-progress
パッケージのインストール、アップグレード、削除時にユーザにとってわかりやすい形で進捗情報をターミナルウィンドウ内に表示します。このデータの機械的に解析できるバージョンについては
apt の doc
ディレクトリにある
README.progress-reporting
を見てください。設定項目:
Dpkg::Progress、 Dpkg::Progress-Fancy
--with-source
ファイル名
メタ情報のソースとして指定したファイルを追加します。指定を繰り返すと複数のファイルを追加できます。さらなる詳細については
apt-cache(8) の
--with-source
の説明を見てください。
-eany,
--error-on=any
Fail the update command if any error occured, even a
transient one.
-h, --help
使い方の短い要約を表示します。
-v, --version
プログラムのバージョンを表示します。
-c, --config-file
設定ファイル。
使用する設定ファイルを指定します。
このプログラムは、デフォルト設定ファイルを読んでから、この設定ファイルを読みます。
この設定をデフォルト設定ファイルよりも前に読む必要がある場合、
APT_CONFIG
環境変数に指定してください。構文については
apt.conf(5)
をご覧ください。
-o, --option
設定オプションのセット。任意の設定オプションをセットします。
構文 -o Foo::Bar=bar
となります。
異なるオプションを設定するため、-o
と --option は、
複数回使用できます。
