source: projects/apt-rpm-manpages-ja/trunk/doc/ja/apt.ja.1.sgml @ 6625

<!-- -*- mode: sgml; mode: fold -*- -->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [

<!ENTITY % aptent SYSTEM "apt.ent.ja">
%aptent;

]>

<refentry>
        &apt-docinfo;
        
        <refmeta>
                <refentrytitle>apt</refentrytitle>
                <manvolnum>1</manvolnum>
        </refmeta>
        
        <!-- Man page title -->
        <refnamediv>
                <refname>apt</refname>
                <refpurpose>APT パッケージ操作ユーティリティ -- コマンドラインインターフェイス</refpurpose>
        </refnamediv>
        
        <!-- Arguments -->
        <refsynopsisdiv>
                <cmdsynopsis>
                        <command>apt</command>
                        <arg><option>options</option></arg>
                        <arg><option>apt-rpm options</option></arg>
                        <arg><option>action</option></arg>
                        <arg><option>packages</option></arg>
                </cmdsynopsis>
        </refsynopsisdiv>
        
        <RefSect1><Title>説明</Title>
        <Para>
                <command>apt</command> は、&apt-get; , &apt-cache; , &apt-config; , &apt-cdrom; といったコマンドと &rpm; コマンドでの query を用いた操作を行うための、単一のコマンドラインでのインターフェイスを提供します。
                単一のインターフェイス以外に、&rpm; コマンドと組み合わされた特定のオプションを提供します。
                </Para><Para>
                <option>-h</option> オプションや <option>--help</option> オプションを除き、次に説明する action が必要です。
                </Para><Para>
                apt のそれぞれのコマンドとオプションの詳細な情報は、コマンドごとのマニュアルページを参照してください。
        </Para>
        </RefSect1>
        
        <RefSect1><Title>Action(動作)</Title>
        <Para>apt がサポートする action は add, autoclean, build-dep, check, clean, depends, dist-upgrade, dotty, dump, dumpavail, gencaches, groupinstall, groupremove, ident, install, list-extras, list-nodeps, moo, pkgnames, policy, query, querytags, rdepends, reinstall, remove, script, search, show, showgroup, showgroups, showpkg, showsrc, source, stats, unmet, update, upgrade, whatdepends, xvcg です。
        </Para>
        
        <VariableList>
                <VarListEntry><Term>list-nodeps</Term>
                <ListItem><Para>   
                        インストールされている全てのパッケージの中の、他のインストール済みパッケージから依存(Requires)されていないパッケージのリストを表示します。
                </Para></ListItem>
                </VarListEntry>
                
                <VarListEntry><Term>list-extras</Term>
                <ListItem><Para>   
                        どのリポジトリからも発見できないパッケージを表示します。
                        これらのパッケージは、どこか別な場所からダウンロードされたか、ローカルでビルド、インストールされたパッケージです。
                        このリストは、それらのパッケージが現在も必要なものであるかを判断するのに役立ちます。
                        
                        また、特に、システムが他のシステムに配布するパッケージをビルド(作成)するという用途で用いられている場合、標準のリポジトリで提供されていないパッケージが、依存関係を満たすためにインストールされていないかどうかをチェックするのはとても重要なことです。
                </Para></ListItem>
                </VarListEntry>
                
                <VarListEntry><Term>reinstall</Term>
                <ListItem><Para>   
                        パッケージがすでにインストールされていても、再びインストールします。
                </Para></ListItem>
                </VarListEntry>
                
                <VarListEntry><Term>その他の action</Term>
                <ListItem><Para>
                        残りの action は、他の aptツール によって提供されるものです。
                        コマンドとそのコマンドによって提供される action は次のようになります。動作についてはそれぞれのコマンドのマニュアルを参照してください。
                </Para></ListItem>
                </VarListEntry>
                
                <VarListEntry><Term>apt-get</Term>
                <ListItem><Para>   
                        autoclean, build-dep, check, clean, dist-upgrade, install, moo, remove, reinstall, script, source, update, upgrade
                </Para></ListItem>
                </VarListEntry>
                
                <VarListEntry><Term>apt-cache</Term>
                <ListItem><Para>   
                        add, depends, dotty, dump, dumpavail, gencaches, pkgnames, policy, rdepends. search, show, showpkg, showsrc, stats, unmet, whatdepends, xvcg
                </Para></ListItem>
                </VarListEntry>
                
                <VarListEntry><Term>apt-config</Term>
                <ListItem><Para>   
                        shell, dump
                </Para></ListItem>
                </VarListEntry>
                
                <VarListEntry><Term>apt-cdrom</Term>
                <ListItem><Para>   
                        add, ident
                </Para></ListItem>
                </VarListEntry>
        </VariableList>
        </RefSect1>
        
        <RefSect1><Title>オプション</Title>
        &apt-cmdblurb;
        
        <VariableList>
                <VarListEntry><term><option>--checksig</option></term>
                <ListItem><Para>
                        インストールされるパッケージの完全性(ファイルの破損の有無)と起源(署名)をチェックします。
                        一つでも、複数でも、チェックに失敗すると、候補と成っているすべてのパッケージがインストールされません。
                        署名のチェックに失敗した場合、<option>--hold</option> オプションで、インストールを抑制できます。
                        また、<option>--no-checksig</option> オプションでは、パッケージのチェックを省略できます。
                        パッケージのチェックについての更なる情報は、&rpm; のマニュアルに記述されています。
                        設定項目 <literal>RPM::GPG-Check</literal>
                </Para></ListItem>
                </VarListEntry>
                
                <VarListEntry><term><option>--hold</option></term>
                <ListItem><Para>
                        パッケージを hold するように設定します。
                        hold するように設定されたパッケージは、install で指定されない限り、アップグレードされません。
                        アップグレードしないようにしたいパッケージが複数ある場合、パッケージごとにこのオプションを繰り返してください。
                        このオプションは hold するパッケージの名称に、正規表現を利用できます。例 "at" というパッケージを hold するには、<literal>--hold ^at$</literal> のようにします。このようにしないと、<literal>attr</literal> のようなパッケージも、同じように hold されてしまうことでしょう。
                        いかなる場合でも、パッケージを hold するには、&apt-conf; の設定項目 <literal>RPM::HOLD</literal> を利用したほうがいいです。
                </Para></ListItem>
                </VarListEntry>
                
                <VarListEntry><term><option>--no-checksig</option></term>
                <ListItem><Para>
                        インストールされるパッケージの完全性(ファイルの破損の有無)のチェックを行いません。
                        一つ、あるいは複数のパッケージの完全性のチェックには失敗したけれど、入手したのは信頼できる場所であるといった場合に利用できます。
                        設定項目 <literal>RPM::GPG-Check</literal>
                </Para></ListItem>
                </VarListEntry>
                
                <VarListEntry><term><option>--no-postscipt</option></term>
                <ListItem><Para>
                        パッケージのアップグレード、ダウングレード、アンインストール、インストールの際に、postscript を実行しません。
                        設定項目 <literal>Scripts::Options::RunPostScript</literal>
                </Para></ListItem>
                </VarListEntry>
                
                <VarListEntry><term><option>--postscript</option></term>
                <ListItem><Para>
                        パッケージのアップグレード、ダウングレード、アンインストール、インストールの際に、postscript を実行します。
                        どのスクリプトを実行するかは、設定項目 <literal>Scripts::PM::Post</literal> で設定します。
                        このオプションで、ldconfig や ディストリビューション固有の設定スクリプトなどを実行できます。
                        設定項目 <literal>Scripts::Options::RunPostScript</literal>
                </Para></ListItem>
                </VarListEntry>
                
                <VarListEntry><term><option>--show-rpm-command</option></term>
                <ListItem><Para>
                        install, upgrade, dist-upgrade 時に、実行される rpm コマンドを表示します。
                        コマンドが表示されるだけで、install, upgrade, dist-upgrade といったアクションは実行されません。
                </Para></ListItem>
                </VarListEntry>
                
                <VarListEntry><term><option>--sourceslist</option></term>
                <ListItem><Para>
                        sourceslist ファイル(標準は <filename>/etc/apt/sources.list</filename>) を指定します。
                </Para></ListItem>
                </VarListEntry>
                
                &apt-commonoptions;
        </VariableList>
        </RefSect1>
        
        <RefSect1><Title>RPM オプション</Title>
        <Para>
                次に挙げるものは、&rpm; コマンドに由来するオプションです。それぞれの機能は rpm コマンドのマニュアルページを読んでください。
        </Para>
        <VariableList>
                <VarListEntry><term><option>--test</option></term>
                <ListItem><Para>
                        Rpm コマンドのオプション <option>--test</option> です。
                </Para></ListItem>
                </VarListEntry>
                
                <VarListEntry><term><option>--force-rpm</option></term>
                <ListItem><Para>
                        Rpm コマンドのオプション <option>--force</option> です。
                </Para></ListItem>
                </VarListEntry>
        </VariableList>
        </RefSect1>
        
        <RefSect1><Title>ファイル</Title>
        <VariableList>
                <VarListEntry><term><filename>/usr/share/apt/scripts</filename></term>
                <ListItem><Para>
                        APT の lua script をおくディレクトリ。
                        設定項目 <literal>Dir::Bin::scripts</literal>
                </Para></ListItem>
                </VarListEntry>
        </VariableList>
        </RefSect1>
        
        <RefSect1><Title>環境変数</Title>
        <VariableList>
                <VarListEntry><term><envar>APT_VERBOSE</envar></term>
                <ListItem><Para>
                        <envar>APT_VERBOSE</envar> が設定されていると、apt はどのコマンドが実行されるかを表示します。
                </Para></ListItem>
                </VarListEntry>
        </VariableList>
        </RefSect1>
        
        <RefSect1><Title>注意事項</Title>
        <Para>
                複数のコマンドで用いられる、<literal>add</literal> と <literal>dump</literal> という action があります。
                <literal>add</literal> という action は <command>apt-cdrom</command> と <command>apt-cache</command> というコマンドにありますが、apt では <command>apt-cdrom</command> コマンドの add が用いられます。
                <literal>dump</literal> という action は、<command>apt-config</command> と <command>apt-cache</command> にありますが、apt では <command>apt-config</command> コマンドの dump が用いられます。
        </Para>
        </RefSect1>
        
        <RefSect1><Title>関連項目</Title>
        <Para>
                &apt-get;, &apt-cache;, &apt-config;, &apt-cdrom;, &apt-conf;, &rpm;
        </Para>
        </RefSect1>
        
        <RefSect1><Title>診断メッセージ</Title>
        <Para>
                <command>apt</command> は正常終了時に 0 を返します。エラー時には十進の 100 を返します。
        </Para>
        </RefSect1>
        
        &manbugs;
        &manauthor-vine;
        
</refentry>

<!--
                Local Variables:
                mode: nxml
                End:
-->