APT-GET(8)

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

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 ライブラリを用いる他のツールのユーザ側バックエンドともいえるものです。

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

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

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

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

dist-upgrade
    dist-upgrade は upgrade の機能に加え、新バージョンの パッケージに対する依存関係の変更を知的に操作します。 apt-get は「洗練された」競合解決システムを持ち、必要なら 比較的重要でないパッケージを犠牲にして、最重要パッケージの更新を 試みます。 /etc/apt/sources.list ファイルに必要なパッケージファイルを 検索する場所のリストが含まれています。

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

-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 コマンドでも動作します。 MD5 やファイルサイズを含まず update で使用したときに、 圧縮ファイルを展開することはユーザの責任において行ってください。 設定項目 - 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

--trivial-only
    「重要でない」操作のみを行います。これは論理的に --assume-yes の 仲間と見なすことができます。--assume-yes は質問にすべて yes と 答えますが、--trivial-only はすべて no と答えます。 設定項目 - APT::Get::Trivial-Only

--no-remove
    パッケージが削除される状況になったとき、プロンプトを表示せず中断します。 設定項目 - APT::Get::Remove

--only-source
    source コマンドでのみ意味があります。 指定されたソース名がバイナリテーブルにマップされないことを示します。 設定項目 - APT::Get::Only-Source

--diff-only

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

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

-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
    バージョン優先ファイル。 設定項目 - 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), /usr/share/doc/apt/の APT ユーザーズガイド, apt_preferences(5)

診断メッセージ

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

バグ

APT バグページ <URL:http://bugs.debian.org/apt>を 参照してください。 APT のバグを報告する場合は、 /usr/share/doc/debian/bug-reporting.txt や reportbug(1) コマンドを参照してください。

著者

APT は the APT team <apt@packages.debian.org> によって書かれました。

翻訳者

倉澤 望 <nabetaro@mx1.avis.ne.jp> (2003-2004)

Debian JP Documentation ML <debian-doc@debian.or.jp>