apt-get

Autres langues

Langue: ja

Autres versions - même langue

Version: 29 February 2004 (debian - 07/07/09)

Section: 8 (Commandes administrateur)

NAME

apt-get - APT package handling utility -- コマンドラインインターフェース

SYNOPSIS

apt-get [-hvs] [-o=config string] [-c=file] {[update] | [upgrade] | [dselect-upgrade] | [install pkg...] | [remove pkg...] | [source pkg...] | [build-dep pkg...] | [check] | [clean] | [autoclean]}

説明

apt-get は、 パッケージを操作するコマンドラインツールで、 APT ライブラリを用いる他のツールのユーザ側「バックエンド」といえるものです。 「フロントエンド」インターフェースには、dselect(8), aptitude, synaptic, gnome-apt, wajig などがあります。

-h オプションや --help オプションを除き、 以下に挙げるコマンドが必要です。

update
updateは、 取得元からパッケージインデックスファイルの再同期を行うのに使用します。 利用可能なパッケージのインデックスは、 /etc/apt/sources.list に記述した場所から取得します。 例えば Debian アーカイブを利用する際、 このコマンドが Packages.gz ファイルを検索することで、 新規または更新されたパッケージの情報が利用可能となります。 update は、upgrade や dist-upgrade を行う前に常に実行してください。 前もってパッケージファイルのサイズを知ることができないため、 全体の進捗メータは正しく表示されません。

upgrade

upgrade は、 現在システムにインストールされている全パッケージの最新バージョンを、 /etc/apt/sources.list に列挙した取得元からインストールするのに使用します。 現在インストール中のパッケージに新しいバージョンがあれば更新しますが、 いかなる時も現在インストール中のパッケージの削除は行いません。 対象のパッケージが、 他のパッケージのインストール状態を変更せずに更新できない場合は、 現在のバージョンのままとなります。 最初に update を実行しておき、 apt-get にパッケージの新しいバージョンがあることを 知らせる必要があります。

dselect-upgrade

dselect-upgrade は、 伝統的な Debian GNU/Linux パッケージ管理フロントエンドの dselect(8) と共に使用されます。 dselect-upgrade は、 dselect(8) で作られた利用可能パッケージの Status フィールドの変更を追跡し、 その状態を反映させるのに必要なアクションを実行します。 (例えば、古いパッケージの削除や新しいパッケージのインストールなど)

dist-upgrade

dist-upgrade は、 upgrade の機能に加え、 新バージョンのパッケージに対する依存関係の変更を知的に操作します。 apt-get は「洗練された」競合解決システムを持ち、 必要とあらば比較的重要でないパッケージを犠牲にして、 最重要パッケージの更新を試みます。 /etc/apt/sources.list ファイルには、 必要なパッケージファイルを検索する場所のリストが含まれています。 特定のパッケージ向けに、一般的な設定を上書きする機構については、 apt_preferences(5) をご覧ください。

install

install の後には、 インストールするパッケージを 1 つ以上指定します。 指定するパッケージは、完全なファイル名ではなくパッケージ名です。 (例えば Debian GNU/Linux システムでは、 libc6_1.9.6-2.deb ではなく libc6 を引数として与えます) インストールするよう指定したすべてのパッケージに対し、 検索・インストールを行います。 /etc/apt/sources.list ファイルを、 要求するパッケージの場所を特定するのに使用します。 パッケージ名の後ろに (空白を含まず) ハイフンが追加されている場合、 そのパッケージがインストールされていれば削除します。 同様に、インストールするパッケージを明示するのにプラス記号も使用できます。 この記号は apt-get の競合解決システムの判断に利用されるかもしれません。
パッケージにイコール記号とバージョンを続けることで、 選択したバージョンのパッケージをインストールすることができます。 つまり、指定のバージョンのパッケージをインストールするように選択する、 ということです。 別の方法としては、ディストリビューションを特定するのに、 パッケージ名に続けて、 スラッシュとディストリビューションのバージョンやアーカイブ名 (stable, testing, unstable) を記述できます。
バージョン選択機構はダウングレード時にも使用できるため、 注意して使用しなければなりません。
最後に、apt_preferences(5) 機構により、 特定のパッケージに対するインストールポリシーを作成できます。
構文に '.', '?', '*' を含み、パッケージ名がマッチしなかった場合、 POSIX 正規表現であると見なし、 データベース内の全パッケージ名に対して適用します。 マッチしたパッケージすべてがインストール(もしくは削除)されます。 'lo.*' のような文字列は、 'how-lo' や 'lowest' にマッチすることに注意してください。 そうしたくなければ、'^' や '$' を付けるか、 もっと詳しい正規表現を指定してください。

remove

remove は、 パッケージが削除されることを除き、install と同様です。 プラス記号がパッケージ名に (間に空白を含まずに) 付加されると、 識別されたパッケージを、削除ではなくインストールします。

source

source は、 ソースパッケージを取得するのに apt-get します。 APT はどのソースパッケージを取得するか決定するよう、 利用可能なパッケージを検討します。 その後、最新の利用可能なソースパッケージを見つけ、 カレントディレクトリへダウンロードします。 バイナリパッケージとは別に sources.list(5) ファイルの deb-src 行から、ソースパッケージを追跡します。 これは、インストールした (またはインストールできる) パッケージと、 取得元を変えることができることを示しています。 --compile オプションが指定された場合、dpkg-buildpackage を用いて バイナリ .deb ファイルへコンパイルを行います。 --download-only の場合はソースパッケージを展開しません。
パッケージと同様に、 ソース名の後ろにイコールと取得したいバージョンを置くと、 指定したバージョンのソースを取得できます。 APT::Get::Only-Source オプションが暗黙のうちに有効になっているため、 ソースパッケージ名とバージョンに厳密に一致させています。
tar ball はカレントディレクトリにのみダウンロードされ、 カレントディレクトリに展開されることに注意してください。

build-dep

build-dep は、 ソースパッケージの構築依存関係を満たすように、 パッケージのインストール・削除を行います。

check

check は、 パッケージキャッシュの更新や壊れた依存関係をチェックする診断ツールです。

clean

clean は、 取得したパッケージのローカルリポジトリを掃除します。 /var/cache/apt/archives//var/cache/apt/archives/partial/ からロックファイル以外すべて削除します。 APT が dselect(8) から呼ばれるときには、 自動的に clean が実行されます。 dselectを使用しない場合は、ディスクスペースを解放するため、時々 apt-get clean を実行したくなるでしょう。

autoclean

clean と同様に、 autoclean は取得したパッケージのローカルリポジトリを掃除します。 違いは、もうダウンロードされることがないパッケージファイルや、 ほとんど不要なパッケージファイルのみを削除することです。 このため、長い期間、キャッシュが管理できずに肥大化することなく、 維持することができます。 設定オプション APT::Clean-Installed に off をセットしていれば、 インストール済のパッケージファイルが削除されるのを防げます。

オプション

この説明で示したオプションは、 すべて設定ファイルを使用して設定できます。 設定ファイルに書いた真偽値をとるオプションは -f-,--no-f, -f=no などのようにして上書きできます。

-d, --download-only

ダウンロードのみ - パッケージファイルの取得のみを行い、 展開・インストールを行いません。 設定項目 - APT::Get::Download-Only

-f, --fix-broken

修復 - 依存関係が壊れたシステムの修正を試みます。 このオプションを install や remove と一緒に使うときは、 パッケージを指定しなくてもかまいません。 どのパッケージを指定しても、完全に問題を解決します。APT 自体は、 システムに存在する壊れたパッケージ依存関係を許すことができないので、 初めて APT を実行する場合、このオプションが必要になることがあります。 システムの依存関係構造にかなり問題がある場合は、 手動で修正するよう要求することもあります。 (通常は、問題のあるパッケージを取り除くのに dselect(8) や 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

動作なし - なにが起こるのかのシミュレーションを行い、 実際にはシステムの変更を行いません。 設定項目 - APT::Get::Simulate
シミュレートの結果、dpkg の動作を表す一連の行のそれぞれに、 設定 (Conf)、削除 (Remv)、展開 (Inst) を表示します。 角カッコは壊れたパッケージを表し、(まれに) 空の角カッコは大した問題ではないことを表します。

-y, --yes, --assume-yes

プロンプトへの自動承諾 - すべてのプロンプトに自動的に "yes" と答え、非対話的に実行します。 保留したパッケージの状態を変更したり、 必須パッケージを削除するような不適切な状況の場合、 apt-get は処理を中断します。 設定項目 - APT::Get::Assume-Yes

-u, --show-upgraded

更新パッケージ表示 - 更新される全パッケージを一覧表示します。 設定項目 - APT::Get::Show-Upgraded

-V, --verbose-versions

更新・インストールするパッケージのヴァージョンを、 すべて表示します。 設定項目 - APT::Get::Show-Versions

-b, --compile, --build

ソースパッケージをダウンロード後、コンパイルします。 設定項目 - APT::Get::Compile

--ignore-hold

保留パッケージの無視 - パッケージの保留指示を無視して apt-get を行います。 dist-upgrade と共に、 大量のパッケージを保留の解除をするのに使用すると便利です。 設定項目 - APT::Ignore-Hold

--no-upgrade

パッケージ更新なし - install と同時に使用すると、no-upgrade は、 指定したパッケージがすでにインストールしてある場合に更新を行いません。 設定項目 - APT::Get::Upgrade

--force-yes

強制承諾 - APT が何か損傷を与えかねない動作をしようとした場合でも、 確認の入力なしで実行してしまう危険なオプションです。 よほどの状況でなければ、使用しない方がいいでしょう。 force-yes は、あなたのシステムを破壊しかねません! 設定項目 - APT::Get::force-yes

--print-uris

インストールするファイルを取得する代わりに、 その URI を表示します。 URI には、パス、対象ファイル名、ファイルサイズ、 予測される md5 ハッシュが含まれています。 出力したファイル名が、 常にリモートサイトのファイル名と一致するわけではない、 ということに注意してください! これは source コマンド、 update コマンドでも動作します。 update で使用したときには、 MD5 やファイルサイズを含みません。 このとき、圧縮ファイルの展開はユーザの責任において行ってください。 設定項目 - APT::Get::Print-URIs

--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 で作成することです。 優先ファイルはこの設定を上書きします。 要するにこのオプションで、 どの配布パッケージを取得するかを簡単に管理します。 一般的な例としては、 -t '2.1*'-t unstable でしょう。 設定項目 - 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

--only-source

source コマンドと build-dep コマンドでのみ意味があります。 指定されたソース名がバイナリテーブルにマップされないようにします。 これは、このオプションを指定すると、 バイナリパッケージ名を受け付けて対応するソースパッケージを探すのではなく、 引数にソースパッケージ名しか受け付けなくなる、ということです。 設定項目 - APT::Get::Only-Source

--diff-only, --tar-only

ソースアーカイブの diff ファイルや tar ファイルのダウンロードのみを行います。 設定項目 - APT::Get::Diff-Only, APT::Get::Tar-Only

--arch-only

構築依存関係の解決を、 アーキテクチャに依存したもののみ行います。 設定項目 - APT::Get::Arch-Only

--allow-unauthenticated

パッケージを確認できない場合に無視し、 それについて質問しません。 pbuilder のようなツールで便利です。 設定項目 - APT::Get::AllowUnauthenticated

-h, --help

使い方の短い要約を表示します。

-v, --version

プログラムのバージョンを表示します。

-c, --config-file

設定ファイル。 使用する設定ファイルを指定します。 この設定ファイルが読めない場合はデフォルトの設定ファイルを読み込みます。 文法については apt.conf(5) を参照してください。

-o, --option

設定オプションのセット。任意の設定オプションをセットします。 文法は -o Foo::Bar=bar となります。

ファイル

/etc/apt/sources.list

パッケージの取得元。 設定項目 - Dir::Etc::SourceList

/etc/apt/apt.conf

APT 設定ファイル。 設定項目 - Dir::Etc::Main

/etc/apt/apt.conf.d/

APT 設定ファイルの断片。 設定項目 - Dir::Etc::Parts

/etc/apt/preferences

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

/var/cache/apt/archives/

取得済みパッケージファイル格納エリア。 設定項目 - Dir::Cache::Archives

/var/cache/apt/archives/partial/

取得中パッケージファイル格納エリア。 設定項目 - Dir::Cache::Archives (必然的に不完全)

/var/lib/apt/lists/

sources.list(5) のパッケージリソース特有の状態情報格納エリア。 設定項目 - Dir::State::Lists

/var/lib/apt/lists/partial/

取得中の状態情報格納エリア。 設定項目 - Dir::State::Lists (必然的に不完全)

関連項目

apt-cache(8), apt-cdrom(8), dpkg(8), dselect(8), sources.list(5), apt.conf(5), apt-config(8), /usr/share/doc/apt/ の APT ユーザーズガイド, apt_preferences(5), APT Howto

診断メッセージ

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

バグ

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

訳者

倉澤 望 <nabetaro@debian.or.jp> (2003-2006), Debian JP Documentation ML <debian-doc@debian.or.jp>

AUTHORS

Jason Gunthorpe

Author.

APT team

Author.

NOTES

1.
APT バグページ
http://bugs.debian.org/src:apt