Scroll to navigation

APT-GET(8) APT APT-GET(8)

名前

apt-get - APT パッケージ操作ユーティリティ -- コマンドラインインターフェース

概要

apt-get [ -asqdyfmubV] [-o=config_string] [-c= config_file] [-t=target_release] [ -a=architecture] {update | upgrade | dselect-upgrade | dist-upgrade | install  pkg [{=pkg_version_number | / target_release}]... | remove  pkg... | purge pkg... | source  pkg [{=pkg_version_number | / target_release}]... | build-dep  pkg [{=pkg_version_number | / target_release}]... | download  pkg [{=pkg_version_number | / target_release}]... | check | clean | autoclean | autoremove | {-v | --version} | {-h | --help}}

説明

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_1.4.7_amd64.deb ではなく apt-utils を引数として与えます)。インストールするよう指定したすべてのパッケージに対し、依存パッケージも含めて取得・インストールを行います。/etc/apt/sources.list ファイルを、要求するパッケージの場所を特定するのに使用します。パッケージ名の後ろに (空白を含まず) ハイフンが追加されている場合、そのパッケージがインストールされていれば削除します。同様に、インストールするパッケージを明示するのにプラス記号も使用できます。この記号は apt-get の競合解決システムの判断を上書きするのに利用される可能性があります。
 
パッケージにイコール記号とバージョンを続けることで、選択したバージョンのパッケージをインストールすることができます。つまり、指定のバージョンのパッケージをインストールするように選択する、ということです。別の方法としては、ディストリビューションを特定するのに、パッケージ名に続けて、スラッシュとディストリビューションのバージョンやアーカイブ名 (stable, testing, unstable) を記述できます。
 
バージョン選択機構はダウングレードにも使用できるため、注意して使用しなければなりません。
 
システムにインストール済みのパッケージを、すべてアップグレードするのではなく、いくつかのパッケージをアップグレードする場合にも、このターゲットを使用できます。現在インストールされているパッケージすべての最新版をインストールする "upgrade" ターゲットと異なり、"install" は指定したパッケージの最新版のみをインストールします。単純にアップグレードしたいパッケージ名を指定してください。より新しいバージョンが利用できる場合、そのパッケージ (と前述の依存関係にあるパッケージ) をダウンロード・インストールします。
 
最後に、 apt_preferences(5) 機構により、特定のパッケージに対するインストールポリシーを作成できます。
 
構文に '.', '?', '*' を含み、パッケージ名がマッチしなかった場合、POSIX 正規表現であると見なし、データベース内の全パッケージ名に対して適用します。マッチしたパッケージすべてがインストール(もしくは削除)されます。'lo.*' のような文字列は、'how-lo' や 'lowest' にマッチすることに注意してください。そうしたくなければ、'^' や '$' を付けるか、もっと詳しい正規表現を指定してください。
remove
remove は、パッケージが削除されることを除き、install と同様です。削除されたパッケージの設定ファイルは、システムに残ったままになることに注意してください。プラス記号がパッケージ名に (間に空白を含まずに) 付加されると、識別されたパッケージを、削除ではなくインストールします。
purge
パッケージが削除かつ完全削除 (すべての設定ファイルも削除) されるのを除き、purge は remove と同じです。
source
source は、 apt-get にソースパッケージを取得させます。APT はどのソースパッケージを取得するか決めるため、利用可能なパッケージを検査します。その後、デフォルトリリースから最新の利用可能なソースパッケージを見つけ、カレントディレクトリへダウンロードします。デフォルトリリースは、可能であれば、APT::Default-Release オプション、 -t オプション、パッケージごとの pkg/release 構文で指定します。
 
ソースパッケージは、 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 オプションにより、別のホストアーキテクチャを指定できます。
check
check は、パッケージキャッシュの更新や壊れた依存関係をチェックする診断ツールです。
download
download は、与えたバイナリパッケージを、カレントディレクトリにダウンロードします。
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 は、他のパッケージの依存関係を満たすために自動的にインストールされ、もう必要なくなったパッケージを削除するのに使用します。
changelog
changelog は、パッケージの changelog をダウンロードし、 sensible-pager で表示します。デフォルトでは、インストールされているバージョンの changelog を表示します。しかし、 install コマンドと同じオプションを指定することができます。
indextargets
デフォルトでは apt-get update でダウンロードすることができるすべてのデータファイル (別名インデックスターゲット) に関する情報の deb822 形式のリストを表示します。出力形式を変更する、またレコードをフィルタするデフォルト出力の行を受け付けるための --format オプションをサポートします。コマンドは主に、ダウンロードしたファイルの情報やファイル名を取得するために、APT を扱う外部ツール用のインターフェースとして使用されます。そして、外部ツールが自身で再度ダウンロードする代わりに使用することができます。詳細なドキュメントはここでは省略しますが、代わりに apt-doc パッケージに収録されている doc/acquire-additional-files.txt で見つけることができます。

オプション

All command line options may be set using the configuration file, the descriptions indicate the configuration option to set. For boolean options you can override the config file by using something like -f-,--no-f, -f=no or several other variations.
--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 を使うと、システムを破壊しかねません! 設定項目: APT::Get::force-yes。これは非推奨で、1.1 で --allow-downgrades, --allow-remove-essential, --allow-change-held-packages に置き換えられました。
--print-uris
インストールするファイルを取得する代わりに、その URI を表示します。URI には、パス、対象ファイル名、ファイルサイズ、予測される MD5 ハッシュが含まれています。出力したファイル名が、常にリモートサイトのファイル名と一致するわけではない、ということに注意してください! これは source コマンド、update コマンドでも動作します。update で使用したときには、MD5 やファイルサイズを含みません。このとき、圧縮ファイルの展開はユーザの責任において行ってください。設定項目: APT::Get::Print-URIs
--purge
削除する際、「削除」ではなく「完全削除」を行います。「完全削除」を行うと指示したパッケージ名の後には、アスタリスク ("*") が付きます。 remove --purgepurge コマンドと等価です。 設定項目: 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
--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
--no-allow-insecure-repositories
設定された取得元から検証できないデータを取得する update コマンドを禁止します。APT は、有効な暗号による署名のないリポジトリ用の update コマンドで失敗します。概念と影響の詳細については apt-secure(8) も参照してください。設定項目: Acquire::AllowInsecureRepositories
--show-progress
パッケージのインストール、アップグレード、削除時にユーザにとってわかりやすい形で進捗情報をターミナルウィンドウ内に表示します。このデータの機械的に解析できるバージョンについては apt の doc ディレクトリにある README.progress-reporting を見てください。設定項目: Dpkg::Progress、 Dpkg::Progress-Fancy
--with-source filename
メタ情報のソースとして指定したファイルを追加します。指定を繰り返すと複数のファイルを追加できます。さらなる詳細については apt-cache(8)--with-source の説明を見てください。
-h, --help
Show a short usage summary.
-v, --version
Show the program version.
-c, --config-file
Configuration File; Specify a configuration file to use. The program will read the default configuration file and then this configuration file. If configuration settings need to be set before the default configuration files are parsed specify a file with the APT_CONFIG environment variable. See apt.conf(5) for syntax information.
-o, --option
Set a Configuration Option; This will set an arbitrary configuration option. The syntax is -o Foo::Bar=bar. -o and --option can be used multiple times to set different options.

ファイル

/etc/apt/sources.list
Locations to fetch packages from. Configuration Item: Dir::Etc::SourceList.
/etc/apt/sources.list.d/
File fragments for locations to fetch packages from. Configuration Item: Dir::Etc::SourceParts.
/etc/apt/apt.conf
APT configuration file. Configuration Item: Dir::Etc::Main.
/etc/apt/apt.conf.d/
APT configuration file fragments. Configuration Item: Dir::Etc::Parts.
/etc/apt/preferences
Version preferences file. This is where you would specify "pinning", i.e. a preference to get certain packages from a separate source or from a different version of a distribution. Configuration Item: Dir::Etc::Preferences.
/etc/apt/preferences.d/
File fragments for the version preferences. Configuration Item: Dir::Etc::PreferencesParts.
/var/cache/apt/archives/
Storage area for retrieved package files. Configuration Item: Dir::Cache::Archives.
/var/cache/apt/archives/partial/
Storage area for package files in transit. Configuration Item: Dir::Cache::Archives (partial will be implicitly appended)
/var/lib/apt/lists/
Storage area for state information for each package resource specified in sources.list(5) Configuration Item: Dir::State::Lists.
/var/lib/apt/lists/partial/
Storage area for state information in transit. Configuration Item: Dir::State::Lists (partial will be implicitly appended)

関連項目

apt-cache(8), apt-cdrom(8), dpkg(1), sources.list(5), apt.conf(5), apt-config(8), apt-secure(8), /usr/share/doc/apt-doc/ にある APT ユーザガイド, apt_preferences(5), APT Howto

診断メッセージ

apt-get は正常終了時に 0 を返します。エラー時には十進の 100 を返します。

BUGS

APT bug page[1]. If you wish to report a bug in APT, please see /usr/share/doc/debian/bug-reporting.txt or the reportbug(1) command.

TRANSLATION

The english translation was done by John Doe <john@doe.org> in 2009, 2010 and Daniela Acme <daniela@acme.us> in 2010 together with the Debian Dummy l10n Team <debian-l10n-dummy@lists.debian.org>.
Note that this translated document may contain untranslated parts. This is done on purpose, to avoid losing content when the translation is lagging behind the original content.

著者

Gunthorpe Jason[FAMILY Given]
[FAMILY Given]

注記

1.
APT bug page
http://bugs.debian.org/src:apt
22 2 月 2017 APT 1.4.7