APT-GET(8)

November 2008

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

SYNOPSIS

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

説明

apt-get は、パッケージを操作するコマンドラインツールで、APT ライブラリを用いる他のツールのユーザ側「バックエンド」といえるものです。「フロントエンド」インターフェースには、dselect(1), aptitude(8), synaptic(8), gnome-apt(1), 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) を記述できます。

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

    This is also the target to use if you want to upgrade one or more already-installed packages without upgrading every package you have on your system. Unlike the "upgrade" target, which installs the newest version of all currently installed packages, "install" will install the newest version of only the package(s) specified. Simply provide the name of the package(s) you wish to upgrade, and if a newer version is available, it (and its dependencies, as described above) will be downloaded and installed.

    最後に、apt_preferences(5) 機構により、特定のパッケージに対するインストールポリシーを作成できます。

    構文に '.', '?', '*' を含み、パッケージ名がマッチしなかった場合、POSIX 正規表現であると見なし、データベース内の全パッケージ名に対して適用します。マッチしたパッケージすべてがインストール(もしくは削除)されます。'lo.*' のような文字列は、'how-lo' や 'lowest' にマッチすることに注意してください。そうしたくなければ、'^' や '$' を付けるか、もっと詳しい正規表現を指定してください。

remove
    remove は、パッケージが削除されることを除き、install と同様です。削除されたパッケージの設定ファイルは、システムに残ったままになることに注意してください。プラス記号がパッケージ名に (間に空白を含まずに) 付加されると、識別されたパッケージを、削除ではなくインストールします。

purge
    パッケージが削除かつ完全削除 (すべての設定ファイルも削除) されるのを除き、purge は remove と同じです。

source
    source causes apt-get to fetch source packages. APT will examine the available packages to decide which source package to fetch. It will then find and download into the current directory the newest available version of that source package while respect the default release, set with the option APT::Default-Release, the -t option or per package with the pkg/release syntax, if possible.

    Source packages are tracked separately from binary packages via deb-src type lines in the sources.list(5) file. This means that you will need to add such a line for each repository you want to get sources from. If you don't do this you will properly get another (newer, older or none) source version than the one you have installed or could install.

    If the --compile option is specified then the package will be compiled to a binary .deb using dpkg-buildpackage, if --download-only is specified then the source package will not be unpacked.

    パッケージと同様に、ソース名の後ろにイコールと取得したいバージョンを置くと、指定したバージョンのソースを取得できます。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(1) から呼ばれるときには、自動的に clean が実行されます。dselectを使用しない場合は、ディスクスペースを解放するため、時々 apt-get clean を実行したくなるでしょう。

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

autoremove
    autoremove は、依存関係を満たすために自動的にインストールされ、もう必要なくなったパッケージを削除するのに使用します。

オプション

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

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

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

-f, --fix-broken
    Fix; attempt to correct a system with broken dependencies in place. This option, when used with install/remove, can omit any packages to permit APT to deduce a likely solution. If packages are specified, these have to completely correct the problem. The option is sometimes necessary when running APT for the first time; APT itself does not allow broken package dependencies to exist on a system. It is possible that a system's dependency structure can be so corrupt as to require manual intervention (which usually means using dselect(1) or dpkg --remove to eliminate some of the offending packages). Use of this option together with -m may produce an error in some situations. Configuration Item: 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

    Simulation run as user will deactivate locking (Debug::NoLocking) automatic. Also a notice will be displayed indicating that this is only a simulation, if the option APT::Get::Show-User-Simulation-Note is set (Default: true). Neither NoLocking nor the notice will be triggered if run as root (root should know what he is doing without further warnings by apt-get).

    Simulate prints out a series of lines each one representing a dpkg operation, Configure (Conf), Remove (Remv), Unpack (Inst). Square brackets indicate broken packages and empty set of square brackets meaning breaks that are of no consequence (rare).

-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

--install-recommends
    「推奨」パッケージもインストールします。

--no-install-recommends
    「推奨」パッケージをインストールしません。

--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
    Use purge instead of remove for anything that would be removed. An asterisk ("*") will be displayed next to packages which are scheduled to be purged. remove --purge is equivalent to the purge command. Configuration Item: 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
    Ignore if packages can't be authenticated and don't prompt about it. This is useful for tools like pbuilder. Configuration Item: APT::Get::AllowUnauthenticated.

-h, --help
    使い方の短い要約を表示します。

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

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

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

ファイル

/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 (implicit partial).

/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 (implicit partial).

関連項目

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

診断メッセージ

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

原著者

Jason Gunthorpe

現著者

APT team

QA Page[1]

バグ

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

訳者

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

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.

AUTHORS

Jason Gunthorpe

APT team

NOTES

1.  QA Page
    http://packages.qa.debian.org/a/apt.html

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