APT-GET(8)

November 2008

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

SYNOPSIS

apt-get [-sqdyfmubV] [-o= config_string ] [-c= config_file ] [-t= target_release] [-a= default_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... | check | clean | autoclean | autoremove | {-v | --version} | {-h | --help}}

説明

apt-get は、パッケージを操作するコマンドラインツールで、APT ライブラリを用いる他のツールのユーザ側「バックエンド」といえるものです。「フロントエンド」インターフェースには、dselect(1), 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 にパッケージの新しいバージョンがあることを知らせる必要があります。

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

dist-upgrade
    dist-upgrade は、upgrade の機能に加え、新バージョンのパッケージに対する依存関係の変更を知的に操作します。apt-get は「洗練された」競合解決システムを持ち、必要とあらば比較的重要でないパッケージを犠牲にして、最重要パッケージの更新を試みます。そのため dist-upgrade は、いくつかのパッケージを削除する可能性があります。/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) を記述できます。

    バージョン選択機構はダウングレードにも使用できるため、注意して使用しなければなりません。

    システムにインストール済みのパッケージを、すべてアップグレードするのではなく、いくつかのパッケージをアップグレードする場合にも、このターゲットを使用できます。現在インストールされているパッケージすべての最新版をインストールする "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 タイプにより、バイナリパッケート分けて管理されます。つまり、ソースを取得したいリポジトリを、それぞれ追加する必要があるということです。こうしないと、インストール済み・インストール可能なものとは違う (新しい、または古い、存在しない) もっと適切なものを取得します。

    If the --compile option is specified then the package will be compiled to a binary .deb using dpkg-buildpackage for the architecture as defined by the --host-architecture option. If --download-only is specified then the source package will not be unpacked.

    パッケージと同様に、ソース名の後ろにイコールと取得したいバージョンを置くと、指定したバージョンのソースを取得できます。APT::Get::Only-Source オプションが暗黙のうちに有効になっているため、ソースパッケージ名とバージョンに厳密に一致させています。

    tar ball はカレントディレクトリにのみダウンロードされ、カレントディレクトリに展開されることに注意してください。

build-dep
    build-dep causes apt-get to install/remove packages in an attempt to satisfy the build dependencies for a source package. By default the dependencies are satisfied to build the package natively. If desired a host-architecture can be specified with the --host-architecture option instead.

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

download
    download will download the given binary package into the current directory.

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

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

autoremove
    autoremove is used to remove packages that were automatically installed to satisfy dependencies for other packages and are now no longer needed.

changelog
    changelog downloads a package changelog and displays it through sensible-pager. The server name and base directory is defined in the APT::Changelogs::Server variable (e. g. http://packages.debian.org/changelogs for Debian or http://changelogs.ubuntu.com/changelogs for Ubuntu). By default it displays the changelog for the version that is installed. However, you can specify the same options as for the install command.

オプション

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

--no-install-recommends
    「推奨」パッケージをインストールする依存関係と見なしません。設定項目 - APT::Install-Recommends

--install-suggests
    Consider suggested packages as a dependency for installing. Configuration Item: APT::Install-Suggests.

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

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

    シミュレーションは、自動ではロックを行わず (Debug::NoLocking) ユーザ権限で実行します。また、APT::Get::Show-User-Simulation-Note オプション (デフォルト: true) をセットすると、これがシミュレーションであるという注意を表示したりもします。root 権限で実行すると、NoLocking も 注意も行われません (root は apt-get による警告などなくても、何をしているのか知っているべきです)。

    シミュレートの結果、dpkg の動作を表す一連の行のそれぞれに、設定 (Conf)、削除 (Remv)、展開 (Inst) を表示します。角カッコは壊れたパッケージを表し、(まれに) 空の角カッコは大した問題ではないことを表します。

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

--assume-no
    Automatic "no" to all prompts. Configuration Item: APT::Get::Assume-No.

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

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

-a, --host-architecture
    This option controls the architecture packages are built for by apt-get source --compile and how cross-builddependencies are satisfied. By default is it not set which means that the host architecture is the same as the build architecture (which is defined by APT::Architecture). Configuration Item: APT::Get::Host-Architecture

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

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

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

--only-upgrade
    Do not install new packages; When used in conjunction with install, only-upgrade will prevent packages on the command line from being upgraded if they are not already installed. Configuration Item: APT::Get::Only-Upgrade.

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

--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

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

--auto-remove
    コマンドが install か remove である場合、このオプションは使用していないパッケージを削除し、autoremove のように動作します。設定項目 - APT::Get::AutomaticRemove

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

--diff-only, --dsc-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_CONFIG 環境変数に指定してください。構文については apt.conf(5) をご覧ください。

-o, --option
    設定オプションのセット。任意の設定オプションをセットします。 構文 -o Foo::Bar=bar となります。 異なるオプションを設定するため、-o と --option は、 複数回使用できます。

ファイル

/etc/apt/sources.list
    パッケージ取得元の場所。 設定項目 - Dir::Etc::SourceList

/etc/apt/sources.list.d/
    パッケージ取得元の場所のファイル断片 設定項目 - Dir::Etc::SourceParts

/etc/apt/apt.conf
    APT 設定ファイル。 設定項目 - Dir::Etc::Main

/etc/apt/apt.conf.d/
    APT 設定ファイル断片。 設定項目 - Dir::Etc::Parts

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

/etc/apt/preferences.d/
    バージョン選択ファイル断片。 設定項目 - Dir::Etc::PreferencesParts

/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(1), dselect(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 を返します。

原著者

Jason Gunthorpe

現著者

APT チーム

QA ページ[3]

バグ

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

翻訳

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

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

AUTHORS

Jason Gunthorpe

APT チーム

NOTES

1.  http://packages.debian.org/changelogs

2.  http://changelogs.ubuntu.com/changelogs

3.  QA ページ
    http://packages.qa.debian.org/a/apt.html

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