<!--DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook V4.2//EN"-->
<!-- Time-stamp: <07/09/29 22:57:25 ruby11> -->

<chapter id="update-alternatives">
  <title>update-alternatives による標準コマンドの切り替え</title>
  
  <!--chapterinfo>
      <author>
	<firstname>Takuya</firstname>
	<surname>Kobayashi</surname>
      </author>
      
      <abstract>
	<para>
	  ここでは alternatives について記述します。
	  update-alternatives コマンドの display, list, config, set, all などの基本的な操作だけでなく、
 	  alternatives の仕組みと install, remove, remove-all の利用例についても扱うこととします。
	</para>
      </abstract>
      
      <pubdate>2007/9/29</pubdate>
  </chapterinfo-->
  
  
  <sect1 id="update-alternatives-1">
    <title>機能の重複するプログラム</title>
    <para>いくつかのプログラムには、同様の機能をもったプログラムが複数用意されている場合があります。</para>
    <para>これらの中には、複数のものを同時にインストールしておけるものがあります。</para>
    
    <para>バージョンの異なるものを同時に複数インストールしておけるものでは、gcc のようなプログラムがあり、gcc,gcc4,gcc295 といったrpmパッケージがあります。</para>
    
    <para>また、ある程度同等な機能をもつものとしては <ulink url="vine-cups.html">cups</ulink> と <ulink url="vine-lprng.html">LPRng</ulink> のようなものがあります。</para>
    
    <para>ほかにも様々なものがあります。そうしたrpmパッケージの一覧は <xref linkend="alternatives-packages" /> を見てください。</para>
    
    <para>複数のプログラムをインストールしてある時に、どれをシステムの標準とするか、決定、選択、切り替えを行うために alternatives という仕組みがあります。</para>
    
    <para>この章では、alternatives の仕組みと、パッケージ alternatives に含まれている update-alternatives コマンドの利用方法を扱います。</para>
    
    <para>alternatives というパッケージは、cups など、切り替え可能なrpmパッケージが一つでもインストールされていればすでにインストールされているはずですが、インストールされていない場合には、スーパーユーザ(root)でインストールしてください。参照 <ulink url="inst_apps.html">パート III. アプリケーションの追加や削除</ulink>
      <screen># apt-get install alternatives</screen></para>
    
    <para>update-alternatives コマンドのマニュアルに日本語での詳細な説明があるので読んでください。
      <screen>$ jman update-alternatives</screen></para>
    
  </sect1>
  
  
  <sect1 id="update-alternatives-2">
    <title>alternatives の仕組み</title>
    <para>alternatives は、既存のファイルに新しい名前をつけて利用できるようにするシステムです。</para>
    <para>いくつかのファイルを同じ名前の元に登録すれば、切り替えられるようにすることができます。</para>
    
    <itemizedlist>
      <listitem><para>節目次</para>
	<itemizedlist>
	  <listitem><xref linkend="word-and-directionay" /></listitem>
	  <listitem><xref linkend="word_and_directory_explanation2_with_figure" /></listitem>
	  <listitem><xref linkend="example_of_gcc" /></listitem>
	  <listitem><xref linkend="master_link_and_slave_link" /></listitem>
	  <listitem><xref linkend="state_information" /></listitem>
	  <listitem><xref linkend="state_information_of_gcc" /></listitem>
	</itemizedlist>
      </listitem>
    </itemizedlist>
    
    <sect2 id="word-and-directionay">
      <title>用語とディレクトリ</title>
      <para>alternative には仕組みを理解する上で必要となる 5つの用語と 2つのディレクトリ があります。</para>
      
      <itemizedlist>
	<listitem><para>用語</para>
	  <itemizedlist>
	    <listitem><para>総称名 generic name</para></listitem>
	    <listitem><para>リンク名 link name</para></listitem>
	    <listitem><para>選択候補 alternative</para></listitem>
	    <listitem><para>優先度 priotity</para></listitem>
	    <listitem><para>モード mode</para></listitem>
	  </itemizedlist>
	</listitem>
	<listitem><para>ディレクトリ</para>
	  <itemizedlist>
	    <listitem><para><emphasis>alternatives directory</emphasis></para></listitem>
	    <listitem><para><emphasis>administrative directory</emphasis></para></listitem>
	  </itemizedlist>
	</listitem>
      </itemizedlist>
      
      <sect3 id="word_and_directory_explanation1">
	
	<para><emphasis>総称名 generic name</emphasis> は、リンク名、選択候補、優先度、モードなどを一つのグループとして管理するための <emphasis>グループの名前</emphasis> です。</para>
	
	<para><emphasis>リンク名 link name</emphasis> は、alternatives によって作られる、新しい名前 です。この名前で、シンボリックリンクファイル<footnote><para>symbolic link file:他のファイル、ディレクトリを参照する形式のファイル</para></footnote>が作られ、一般的なコマンド、ファイルと同じように利用されることになります。</para>
	
	<para><emphasis>選択候補 alternative</emphasis> は、既存のファイル、実際のファイルです。「本体」といった感じのものになります。リンク名 で作られるファイルは最終的にこのファイルを参照することになります。</para>
	
	<para>選択候補ごとに、<emphasis>優先度 priority</emphasis> があります。数字で設定され、選択候補が複数ある場合には、数字の大きなものほど優先されます。</para>
	
	<para>優先度に従うかどうかを決める <emphasis>モード mode</emphasis> があります。モードには、パッケージの追加や削除などで、選択候補が追加されたり削除された時に、優先度が高いものに自動的に切り替わる <emphasis>auto</emphasis>(matic mode) と、すでに設定したもので固定しておく <emphasis>manual</emphasis>( mode) というものがあります。</para>
	<para>標準では、自動的に切り替える auto になっています。</para>
	
	<para><emphasis>alternatives directory</emphasis> は、どの候補を選択するかといった切り替えに利用するディレクトリです。Vine Linux では /etc/alternatives が利用されます。</para>
	
	<para><emphasis>administrative directory</emphasis> には、総称名ごとに、モード、リンク名、選択候補、優先度の情報が保存されます。Vine Linux では /var/lib/rpm/alternatives が利用されます。</para>
	<para>ここにあるファイルの中身については<xref linkend="state_information" />で説明します。</para>
	
	
	<para><ulink url="update-alternatives-3.html">update-alternatives コマンド</ulink>で切り替える時には 総称名 と 選択候補 を利用します。</para>
	
	<para>リンク名以外は alternatives という仕組みの中で利用されるものです。</para>
	
	<note><title>ノート</title>
	  <para>一般的にシステムごとの設定ファイルなどは /etc/ というディレクトリ以下におかれて管理されるので、alternatives は /usr/bin/ にあるコマンドを直接変更するのではなく、/etc/alternatives 以下を経由して変更を行うようになっています。</para>
	  
	  <para>また、優先度などの情報は、パッケージのインストールやアンインストールなどで、選択候補が増えたり減ったり動的に変化するために、/var/lib/rpm/alternatives 以下におかれます。</para>
	  <para>/etc や /var などのディレクトリの配置や意味などについては、FHS(Filesystem Hierarchy Standard)という規格があります。</para>
	</note>
	
      </sect3>
      
    </sect2>
    <sect2 id="word_and_directory_explanation2_with_figure">
      <title>ファイルのつながり</title>
      <figure id="alternatives-master-only">
	<graphic fileref="images/alternatives-master-only.png" />
	<title>alternatives の概念図</title>
      </figure>
      
      <para>リンク名 があります。このファイルは、<emphasis>alternatives directory</emphasis> の中にある、<emphasis>総称名と同じ名前のファイル</emphasis> を参照しています。</para>
      
      <para>総称名 のもとに、2つの<emphasis>選択候補</emphasis> ファイルA と ファイルB が登録されています。</para>
      
      <para>優先度は、A が 20、 B が 10 となっています。</para>
      
      <para><emphasis>総称名と同じ名前のファイル</emphasis> は、優先度の高い ファイルA を参照します。</para>
      
      <para><emphasis>リンク名</emphasis> は <emphasis>総称名と同じ名前のファイル</emphasis> を経由して <emphasis>選択候補</emphasis>ファイルA を参照しています。</para>
      
      <sect3 id="example_of_gcc">
	<title>gcc の場合</title>
	<para>GCC(GNU Compiler Collection) の、/usr/bin/gcc というコマンドを見てみましょう。</para>
	
	<para>Vine Linux 4.1 では、<xref linkend="gcc-packages" />のように 3つrpmパッケージが用意されています。<footnote><para>C++ をサポートするための gcc-c++ など関連したパッケージも GCC のバージョンごとに用意されています。</para></footnote></para>
	
	<table id="gcc-packages">
	  <title>GCC のパッケージ</title>
	  <tgroup cols="4">
	    <thead>
	      <row><entry>パッケージ名</entry><entry>GCCのバージョン</entry><entry>gccコマンド</entry><entry>優先度(priority)</entry></row>
	    </thead>
	    <tbody>
	      <row><entry>gcc</entry><entry>3.3.6</entry><entry>/usr/bin/gcc-3.3.6</entry><entry>30</entry></row>
	      <row><entry>gcc4</entry><entry>4.0.2</entry><entry>/usr/bin/gcc-4.0.2</entry><entry>20</entry></row>
	      <row><entry>gcc295</entry><entry>2.95.3</entry><entry>/usr/bin/gcc-2.95.3</entry><entry>15</entry></row>
	    </tbody>
	  </tgroup>
	</table>
	
	<para>gcc というコマンドは一般的には /usr/bin/gcc ですが、それぞれのrpmパッケージでは /usr/bin/gcc-3.3.6 , /usr/bin/gcc-4.0.2 , /usr/bin/gcc-2.95.3 というコマンド(ファイル名)になっています。</para>
	<para>そして、alternatives を使って、この中のどれかを /usr/bin/gcc として使えるようにしています。</para>
	
	<figure id="alternatives-master-only-gcc">
	  <graphic fileref="images/alternatives-master-only-gcc.png" />
	  <title>gcc の場合</title>
	</figure>
	
	<para>/usr/bin/gcc があります。このファイルは、<emphasis>/etc/alternatives</emphasis> の中にある、<emphasis>総称名と同じ名前の gcc というファイル</emphasis> を参照しています。
	  <screen>$ file /usr/bin/gcc</screen>
	  <screen>/usr/bin/gcc: symbolic link to `/etc/alternatives/gcc'</screen></para>
	
	<para>総称名 gcc のもとに、3つの<emphasis>選択候補</emphasis>  /usr/bin/gcc-3.3.6 と /usr/bin/gcc-4.0.2 と /usr/bin/gcc-2.95.3 が登録されています。</para>
	
	<para>優先度は、/usr/bin/gcc-3.3.6 が 30 , /usr/bin/gcc-4.0.2 が 20 , /usr/bin/gcc-2.95.3 が 15 となっています。</para>
	
	<para><emphasis>/etc/alternatives/gcc </emphasis> は、優先度の最も高い /usr/bin/gcc-3.3.6 を参照します。
	  <screen>$ file /etc/alternatives/gcc</screen>
	  <screen>/etc/alternatives/gcc: symbolic link to `/usr/bin/gcc-3.3.6'</screen></para>
	
	<para><emphasis>/usr/bin/gcc</emphasis> は <emphasis>/etc/alternatives/gcc</emphasis> を経由して <emphasis>選択候補</emphasis>/usr/bin/gcc-3.3.6 を参照しています。</para>
      </sect3>
    </sect2>
    
    <sect2 id="master_link_and_slave_link">
      <title>リンクグループ(マスターリンクとスレーブリンク)</title>
      <para>alternatives には、プログラムが変更されたら同時にマニュアルページファイルも切り替える、といったように、複数のものを同時に切り替える仕組みがあります。</para>
      
      <para>総称名1 を切り替えたら、総称名2 のほうも同時に切り替えるというように、複数の総称名をグループ化することで、選択候補を同時に切り替えられるようにすることができます。</para>
      
      <para>基準となる総称名1 をマスターリンク(master link)と呼び、それと同時に変更される総称名2 をスレーブリンク(slave link)と呼びます。</para>
      
      <para>マスターリンクとスレーブリンクを合わせて、リンクグループ(link group)と呼びます。</para>
      
      <para>スレーブリンクは、マスターリンクに合わせて切り替わるものなので、モードと優先度を持ちません。総称名とリンク名と選択候補を持ちます。</para>
      
      <para>スレーブリンクは、<emphasis>無くてもいいもの</emphasis>なので、マスターリンクの選択候補1 にはスレーブリンクがあるけれど、選択候補2 にはスレーブリンクはない、といったようにもできます。全て対応させる必要はありません。</para>
      
      <para>また、スレーブリンクを複数持つこともできます。</para>
      
      <para>マスターリンクとスレーブリンクは、<xref linkend="alternatives-master-slave" />のような関係になります。</para>
      
      <figure id="alternatives-master-slave">
	<graphic fileref="images/alternatives-master-slave.png" />
	<title>alternatives の概念図(マスターリンクとスレーブリンク)</title>
      </figure>
      
      <para>総称名1 の選択候補 ファイルA と、総称名2 の選択候補 ファイルa が対応します。</para>
      <para>また、総称名1 の選択候補 ファイルB と、総称名2 の選択候補 ファイルb が対応します。</para>
      
      <para>リンク名1 に ファイルA を選択した時には、リンク名2 が ファイルa になります。</para>
    </sect2>
    
    
    <sect2 id="state_information">
      <title>administrative directory におかれるファイル</title>

      <para><emphasis>administrative directory</emphasis> ( /var/lib/rpm/alternatives/ ) に 総称名と同じ名前のファイルがあり、総称名ごとに、モード、リンク名、選択候補、優先度の情報が保存されます。</para>
      
      <para>書式は次のようになります。</para>
      
      <screen>モード (auto か manual)
リンク名 (/usr/bin/hoge など)
区切りとなる空行
選択候補1
選択候補1の優先度
選択候補2
選択候補2の優先度</screen>

      <para>スレーブリンクもある場合には次のような書式になります。</para>

      <screen>モード
master link のリンク名
slave link1 の総称名
slave link1 のリンク名
slave link2 の総称名
slave link2 のリンク名
区切りとなる空行
master link の選択候補1
master link の選択候補1の優先度
master link の選択候補1のslave link1の選択候補
master link の選択候補1のslave link2の選択候補
master link の選択候補2
master link の選択候補2の優先度
master link の選択候補2のslave link1の選択候補
master link の選択候補2のslave link2の選択候補
区切りとなる空行</screen>
      
      <para>スレーブリンクのリンク名など、関連したファイルがどこにあるのかはこのファイルをみるとわかります。</para>
      
      <sect3 id="state_information_of_gcc">
	<title>/var/lib/rpm/alternatives/gcc の場合</title>
	
	<para>/var/lib/rpm/alternatives/gcc は次のように書かれています。</para>
	<screen>auto                                  モード
/usr/bin/gcc                          master link のリンク名
c99                                   slave link1 の総称名
/usr/bin/c99                          slave link1 のリンク名
cc                                    slave link2 の総称名
/usr/bin/cc                           slave link2 のリンク名
i386-vine-linux-gcc                   slave link3 の総称名
/usr/bin/i386-vine-linux-gcc          slave link3 のリンク名
c89                                   slave link4 の総称名
/usr/bin/c89                          slave link4 のリンク名
                                      (区切りとなる空行)
/usr/bin/gcc-3.3.6                    選択候補 1
30                                    選択候補 1の優先度
/usr/bin/c99-3.3.6                    選択候補 1のスレーブリンク 1の選択候補
/usr/bin/gcc-3.3.6                    選択候補 1のスレーブリンク 2の選択候補
/usr/bin/i386-vine-linux-gcc-3.3.6    選択候補 1のスレーブリンク 3の選択候補
/usr/bin/c89-3.3.6                    選択候補 1のスレーブリンク 4の選択候補
/usr/bin/gcc-2.95.3                   選択候補 2
15                                    選択候補 2の優先度
                                      選択候補 2のスレーブリンク 1の選択候補 (該当無し)
/usr/bin/gcc-2.95.3                   選択候補 2のスレーブリンク 2の選択候補
                                      選択候補 2のスレーブリンク 3の選択候補 (該当無し)
                                      選択候補 2のスレーブリンク 4の選択候補 (該当無し)
/usr/bin/gcc-4.0.2                    選択候補 3
20                                    選択候補 3の優先度
/usr/bin/c99-4.0.2                    選択候補 3のスレーブリンク 1の選択候補
/usr/bin/gcc-4.0.2                    選択候補 3のスレーブリンク 2の選択候補
/usr/bin/i386-vine-linux-gcc-4.0.2    選択候補 3のスレーブリンク 3の選択候補
/usr/bin/c89-4.0.2                    選択候補 3のスレーブリンク 4の選択候補
                                      (区切りとなる空行)</screen>
      </sect3>
    </sect2>
    
  </sect1>

  <sect1 id="update-alternatives-3">
    <title>update-alternatives コマンドの使い方</title>

    <para>update-alternatives コマンドの利用方法を扱います。</para>
    <para>現在の設定を確認する方法、切り替える方法を扱います。</para>
    <para>登録と削除に関しては実際には次節で扱います。</para>
    
    <itemizedlist>
      <listitem><para>節目次</para>
	<itemizedlist>
	  <listitem><xref linkend="common_options" /></listitem>
	  <listitem><xref linkend="option_--list" /></listitem>
	  <listitem><xref linkend="option_--display" /></listitem>
	  <listitem><xref linkend="option_--config_--all_--set_--auto" />
	    <itemizedlist>
	      <listitem><xref linkend="option_--config" /></listitem>
	      <listitem><xref linkend="option_--all" /></listitem>
	      <listitem><xref linkend="option_--set" /></listitem>
	      <listitem><xref linkend="option_--auto" /></listitem>
	    </itemizedlist>
	  </listitem>
	  <listitem><xref linkend="update-alternatives-4" />
	    <itemizedlist>
	      <listitem><xref linkend="option_--install" /></listitem>
	      <listitem><xref linkend="option_--slave" /></listitem>
	      <listitem><xref linkend="option_--remove" /></listitem>
	      <listitem><xref linkend="option_--remove-all" /></listitem>
	    </itemizedlist>
	  </listitem>
	</itemizedlist>
      </listitem>
    </itemizedlist>
    
    <sect2 id="common_options">
      <title>オプション</title>
      <para>--help や --version というオプションを使うとバージョン情報とヘルプメッセージを表示します。</para>
      
      <screen>$ /sbin/update-alternatives <emphasis>--help</emphasis></screen>      
      
      <para>--verbose というオプションを使うと、メッセージが詳細に表示される場合があります。</para>
      <para>--verbose は、他のオプションと合わせて利用します。</para>
      
    </sect2>

    <sect2 id="option_--list">
      <title>選択候補を確認する</title>
      <para>選択候補を表示するには --list というオプションを用います。</para>
      
      <screen>$ /sbin/update-alternatives <emphasis>--list</emphasis> 総称名</screen>
      
      <para>これは変更するのではなく表示するだけなので一般ユーザーで実行できます。</para>
      
      <screen>$ /sbin/update-alternatives <emphasis>--list</emphasis> gcc</screen>
      <screen>/usr/bin/gcc-3.3.6
/usr/bin/gcc-2.95.3
/usr/bin/gcc-4.0.2</screen>

      <para>総称名 gcc に対して選択候補が 3つあることがわかります。</para>
    </sect2>

    <sect2 id="option_--display">
      <title>現在の設定を確認する</title>
      <para>現在の設定を確認するには --display というオプションを用います。</para>
      
      <screen>$ /sbin/update-alternatives <emphasis>--display</emphasis> 総称名</screen>
      
      <para>これも一般ユーザーで実行できます。</para>
      
      <screen>$ /sbin/update-alternatives <emphasis>--display</emphasis> gcc</screen>
      <screen>1  <emphasis>gcc</emphasis> - <emphasis>status is auto</emphasis>.
2   link currently points to <emphasis>/usr/bin/gcc-3.3.6</emphasis>
3  <emphasis>/usr/bin/gcc-3.3.6</emphasis> - <emphasis>priority 30</emphasis>
4   slave c99: /usr/bin/c99-3.3.6
5   slave cc: /usr/bin/gcc-3.3.6
6   slave i386-vine-linux-gcc: /usr/bin/i386-vine-linux-gcc-3.3.6
7   slave c89: /usr/bin/c89-3.3.6
8  <emphasis>/usr/bin/gcc-2.95.3</emphasis> - <emphasis>priority 15</emphasis>
9   slave cc: /usr/bin/gcc-2.95.3
10 <emphasis>/usr/bin/gcc-4.0.2</emphasis> - <emphasis>priority 20</emphasis>
11  <emphasis>slave c99</emphasis>: /usr/bin/c99-4.0.2
12  <emphasis>slave cc</emphasis>: /usr/bin/gcc-4.0.2
13  <emphasis>slave i386-vine-linux-gcc</emphasis>: /usr/bin/i386-vine-linux-gcc-4.0.2
14  <emphasis>slave c89</emphasis>: /usr/bin/c89-4.0.2
15 <emphasis>Current `best' version is /usr/bin/gcc-3.3.6.</emphasis></screen>

      <para>説明のために左端に行番号をつけています。</para>
      <para>1行目に総称名 gcc があり、mode の表示があります。status is <emphasis>auto</emphasis>. となっているので、優先度の一番高いものを自動的に選択するという状態です。</para>
      
      <para>2行目に link currently points to <emphasis>/usr/bin/gcc-3.3.6</emphasis> とあり、gcc-3.3.6 が選択されていることがわかります。</para>
      
      <para>manual モードで、選択候補が無いという場合には、 link currently <emphasis>absent</emphasis> となります。</para>
      <para>3,8,10行に<emphasis>優先度(priority)</emphasis>があり、gcc-3.3.6 が 30 , gcc-2.95.3 が 15 , gcc-4.0.2 が 20 となっていることがわかります。</para>
      <para>また、一番下の15行目に Current `best' version is /usr/bin/gcc-3.3.6. とあり、ここでも、優先度が一番高いのは gcc-3.3.6 であるということがわかります。</para>

      <para>4〜7,9,11〜14行の slave で指定されているものは、スレーブリンクです。(参照 <xref linkend="master_link_and_slave_link" />)</para>
      
      <para>その上の 3,8,10行にある /usr/bin/gcc-3.3.6 , /usr/bin/gcc-2.95.3 , /usr/bin/gcc-4.0.2 が マスターリンク です。</para>
      
      <para>マスターリンクである /usr/bin/gcc-4.0.2 を選択すると、スレーブリンクである c99,cc,i386-vine-linux-gcc,c89 も選択されたことになり、まとめて切り替えることができます。</para>
    </sect2>
    
    <sect2 id="option_--config_--all_--set_--auto">
      <title>設定を切り替える</title>
      <para>ここから先の操作は スーパーユーザ(root) で行う必要があります。</para>
      
      <para>優先度が高いものを自動的に利用する、というのではなく選択するには、--config や --all や --set というオプションを用います。</para>

      <para>優先度に従い自動的に切り替えるように戻すには、--auto というオプションを用います。</para>

      <note>
	<para>rpmパッケージのインストール時に設定された alternatives は、パッケージのアンインストール時に manual( mode) から auto(matic mode) に切り替える処理が行われる場合がありますが、自分で alternatives として登録した場合などは、ファイルが削除されたりしてもモードの切り替えは行われないので、必要に応じて auto に戻したり、どれかを選択したりしてください。</para>
      </note>
      
      <sect3 id="option_--config">
	<title>対話的に切り替える</title>
	<para>対話的に設定するには、--config というオプションを用います。
	  <screen># /sbin/update-alternatives --config 総称名</screen></para>
	
	<para>/usr/bin/gcc-3.3.6 ではなく /usr/bin/gcc-4.0.2 を利用するようにしてみます。</para>
	<screen># /sbin/update-alternatives --config gcc</screen>
	<screen>
There are 3 alternatives which provide `gcc'.

  Selection    Alternative
-----------------------------------------------
*+    1        /usr/bin/gcc-3.3.6
      2        /usr/bin/gcc-2.95.3
      3        /usr/bin/gcc-4.0.2

Press enter to keep the default[*], or type selection number: </screen>

	<para>と表示されます。</para>
	<para>* と書かれているものが現在選択されているものです。そのまま利用するのであれば <keycap>Enter</keycap> と入力します。この場合には モード は変更されません。</para>
	
	<para>3        /usr/bin/gcc-4.0.2 とあるので、<keycap>3</keycap> <keycap>Enter</keycap> と入力します。</para>
	<screen>Using `/usr/bin/gcc-4.0.2' to provide `gcc'.</screen>
	<para>と表示されて設定変更が完了しました。</para>
	
	<screen>$ /sbin/update-alternatives --display gcc</screen>
	<screen>gcc - status is manual.
 link currently points to /usr/bin/gcc-4.0.2
/usr/bin/gcc-3.3.6 - priority 30
 slave c99: /usr/bin/c99-3.3.6
 slave cc: /usr/bin/gcc-3.3.6
 slave i386-vine-linux-gcc: /usr/bin/i386-vine-linux-gcc-3.3.6
 slave c89: /usr/bin/c89-3.3.6
/usr/bin/gcc-2.95.3 - priority 15
 slave cc: /usr/bin/gcc-2.95.3
/usr/bin/gcc-4.0.2 - priority 20
 slave c99: /usr/bin/c99-4.0.2
 slave cc: /usr/bin/gcc-4.0.2
 slave i386-vine-linux-gcc: /usr/bin/i386-vine-linux-gcc-4.0.2
 slave c89: /usr/bin/c89-4.0.2
Current `best' version is /usr/bin/gcc-3.3.6.</screen>

	<para>自分で選択したので一行目が status is <emphasis>manual</emphasis> となりました。</para>
	<para>二行目で link currently points to /usr/bin/gcc-4.0.2 となっていることが確認できます。</para>
      </sect3>

      <sect3 id="option_--all">
	<title>全ての総称名について対話的に切り替える</title>
	<para>--all とすると、すべての 総称名 について順に --config で設定できます。
	  <screen># /sbin/update-alternatives --all</screen></para>

	<para><keycap>Enter</keycap> だけ入力していけば、何も変更せずに終了できるので、どんな 総称名 と選択候補 があるのか確認することもできます。</para>
      </sect3>
      
      <sect3 id="option_--set">
	<title>直接指定して切り替える</title>
	<para>対話的に決定するのではなく、直接指定するには --set というオプションを用います。</para>
	<screen># /sbin/update-alternatives --set 総称名 選択候補</screen>
	
	<screen># /sbin/update-alternatives --set gcc /usr/bin/gcc-4.0.2</screen>
	
	<screen>Using `/usr/bin/gcc-4.0.2' to provide `gcc'.</screen>
	<para>と表示され /usr/bin/gcc-4.0.2 が選択されたことがわかります。</para>
      </sect3>

      <sect3 id="option_--auto">
	<title>automatic modeに戻す</title>
	<para>manual( mode) から auto(matic mode) に戻すには --auto というオプションを用います。</para>
	
	<screen># /sbin/update-alternatives --auto 総称名</screen>
	
	<screen># /sbin/update-alternatives --auto gcc</screen>
	
	<para>特に何も表示されません。</para>

	<para><ulink url="update-alternatives-3.html#common_options">--verbose オプション</ulink>を使うと次のように表示されます。</para>
	<screen># /sbin/update-alternatives --verbose --auto gcc</screen>
	<screen>Setting up automatic selection of gcc.
Checking available versions of gcc, updating links in /etc/alternatives ...
(You may modify the symlinks there yourself if desired - see `man ln'.)
Updating gcc (/usr/bin/gcc) to point to /usr/bin/gcc-3.3.6.
Updating c99 (/usr/bin/c99) to point to /usr/bin/c99-3.3.6.
Updating cc (/usr/bin/cc) to point to /usr/bin/gcc-3.3.6.
Updating i386-vine-linux-gcc (/usr/bin/i386-vine-linux-gcc) to point to /usr/bin/i386-vine-linux-gcc-3.3.6.
Updating c89 (/usr/bin/c89) to point to /usr/bin/c89-3.3.6.
</screen>
	
      </sect3>
    </sect2>
  </sect1>
  
  <sect1 id="update-alternatives-4">
    <title>登録と削除</title>
    <para>rpmパッケージであらかじめ設定されているものではなく、自分で 総称名 や 選択候補 を作成することもできます。</para>

    <para>登録には --install というオプションを、削除には --remove や --remove-all というオプションを用います。</para>

    <para>Editor という 総称名 で jed や vi や emacs を登録してみます。</para>

    <itemizedlist>
      <listitem><para>節目次</para>
	<itemizedlist>
	  <listitem><xref linkend="option_--install" />
	    <itemizedlist>
	      <listitem><xref linkend="--install-editor" />
		<itemizedlist>
		  <listitem><xref linkend="preparation" /></listitem>
		  <listitem><xref linkend="--install" /></listitem>
		</itemizedlist>
	      </listitem>
	      <listitem><xref linkend="option_--slave" />
		<itemizedlist>
		  <listitem><xref linkend="preparation-for-slave-link" /></listitem>
		  <listitem><xref linkend="--install-with--slave-option" /></listitem>
		</itemizedlist>
	      </listitem>
	    </itemizedlist>
	  </listitem>
	  <listitem><xref linkend="option_--remove" />
	    <itemizedlist>
	      <listitem><xref linkend="--remove_alternatives" /></listitem>
	    </itemizedlist>
	  </listitem>
	  <listitem><xref linkend="option_--remove-all" />
	    <itemizedlist>
	      <listitem><xref linkend="--remove_generic_name" /></listitem>
	    </itemizedlist>
	  </listitem>
	</itemizedlist>
      </listitem>
    </itemizedlist>
    
    <sect2 id="option_--install">
      <title>登録する</title>
      
      <para>登録には --install というオプションを用います。</para>
      <screen># /sbin/update-alternatives --install リンク名 総称名 選択候補 優先度</screen>
      
      <para>すでに同じ総称名で選択候補が登録されていた場合、選択候補が追加されることになります。</para>
      <para>優先度か候補を選択することによって、どの候補が用いられるかが決まるので、登録する順番は影響を与えません。</para>
      
      <sect3 id="--install-editor">
	<title>/usr/bin/editor を作成する</title>
	
	<para>Editor という 総称名 で jed や vi や emacs を登録してみます。</para>
	
	<sect4 id="preparation">
	  <title>登録前の準備</title>
	  <para>jed や vi や emacs は jed , vim , emacs というrpmパッケージに含まれています。必要であればインストールしてください。
	    <screen># apt-get install jed vim emacs</screen></para>
	  
	  <para>総称名を Editor<footnote><para>説明の中で総称名とリンク名を区別しやすくするためにここでは Editor としておきますが、総称名とリンク名を同じものにするほうが一般的かもしれません。</para></footnote>、リンク名は /usr/bin/editor にします。</para>
	  
	  <para>選択候補を調べます。コマンドがどこにあるかは、which や whereis や type といったコマンドで確認できます。</para>
	  
	  <note><para>それぞれの使い方は jman which や jman whereis や jman bash 確認してください。type は単独のコマンドファイルではなく bash に組み込まれているものなので jman type ではなく、jman bash になります。</para></note>
	  
	  <para>この場合はman page(マニュアルページファイル) の場所もわかる whereis が適しています。</para>
	  <screen>$ whereis jed vi emacs</screen>
	  <screen>jed: <emphasis>/usr/bin/jed</emphasis> /usr/lib/jed <emphasis>/usr/share/man/man1/jed.1.gz</emphasis>
vi: <emphasis>/bin/vi</emphasis> <emphasis>/usr/share/man/man1p/vi.1p.gz</emphasis>
emacs: <emphasis>/usr/bin/emacs</emphasis> /usr/lib/emacs /usr/share/emacs</screen>
	  
	  <para>選択候補は /usr/bin/jed , /bin/vi , /usr/bin/emacs になります。</para>
	  <para>また、emacs は man page がありませんが、jed と vi は /usr/share/man/man1/jed.1.gz , /usr/share/man/man1p/vi.1p.gz に man page があることがわかりました。</para>
	  
	  <para>jed と vi の man page は
	    <screen>$ rpm -qf /usr/share/man/man1/jed.1.gz /usr/share/man/man1p/vi.1p.gz</screen>
	    <screen>jed-common-0.99.14-0vl6
man-pages-2.21-1vl2</screen>
	    jed-common と man-pages のrpmパッケージに含まれています。</para>
	  
	  <para>優先度は /usr/bin/jed を 30、/bin/vi を 20、/usr/bin/emacs を 10 とします。</para>
	  
	  <para>整理すると<xref linkend="information_of_alternatives_for_editor" />のようになります。</para>
	  
	  <table id="information_of_alternatives_for_editor">
	    <title>editor の候補</title>
	    <tgroup cols="3">
	      <thead>
		<row><entry>選択候補</entry><entry>優先度</entry><entry>man page</entry></row>
	      </thead>
	      <tbody>
		<row><entry>/usr/bin/jed</entry><entry>30</entry><entry>/usr/share/man/man1/jed.1.gz</entry></row>
		<row><entry>/bin/vi</entry><entry>20</entry><entry>/usr/share/man/man1p/vi.1p.gz</entry></row>
		<row><entry>/usr/bin/emacs</entry><entry>10</entry><entry>無し</entry></row>
	      </tbody>
	    </tgroup>
	  </table>
	</sect4>
	
	<sect4 id="--install">
	  <title>実際に登録する</title>
	  <para>ここでは、コマンドだけを登録してみます。</para>
	  
	  <example id="add_generic-name_Editor">
	    <title>総称名 Editor で jed vi emacs を登録する。</title>
	    <para>jed を登録します。
	      <screen># /sbin/update-alternatives --install /usr/bin/editor Editor /usr/bin/jed 30</screen></para>
	    <para>vi を登録します。
	      <screen># /sbin/update-alternatives --install /usr/bin/editor Editor /bin/vi 20</screen></para>
	    <para>emacs を登録します。
	      <screen># /sbin/update-alternatives --install /usr/bin/editor Editor /usr/bin/emacs 10</screen></para>
	    
	    <para>これで、Editor として jed vi emacs を登録できました。</para>
	    
	    <ulink url="update-alternatives-3.html#option_--display">--display オプション</ulink>で確認してみます。
	    <screen>$ /sbin/update-alternatives --display Editor</screen>
	    <screen>Editor - status is auto.
 link currently points to /usr/bin/jed
/usr/bin/emacs - priority 30
/bin/vi - priority 20
/usr/bin/jed - priority 40
Current `best' version is /usr/bin/jed.</screen>
	  </example>
	</sect4>
      </sect3>

      <sect3 id="option_--slave">
	<title>スレーブリンクも登録する</title>
	<para>一つだけではなく、他のものも登録するには --install と一緒に --slave というオプションを用います。</para>
	<para>--slave にも --install の時と同じように リンク名 と 総称名 と 選択候補 が必要になります。</para>
	
	<screen># /sbin/update-alternatives --install リンク名1 総称名1 選択候補1 優先度1 \<footnote><para>コマンド入力で一行の文字数が多く途中で改行したい時には <keycap>\</keycap><keycap>Enter</keycap> を使います。通常<keycap>Enter</keycap>を押すと、コマンドの入力が終わったものとして解釈されますが、<keycap>\</keycap><keycap>Enter</keycap> とするとただの改行として扱われ、次の行に続きを入力できます。\ のような記号は、エスケープシーケンス(escape sequence)と呼ばれ、特殊な意味を持つ記号などを単なる文字として扱う場合に利用されます。</para></footnote>
--slave リンク名2 総称名2 選択候補2</screen>

	<para>--slave オプションは複数回利用できます。</para>
	<screen># /sbin/update-alternatives --install リンク名1 総称名1 選択候補1 優先度1 \
--slave リンク名2 総称名2 選択候補2 \
--slave リンク名3 総称名3 選択候補3</screen>

	<sect4 id="preparation-for-slave-link">
	  <title>登録前の準備 (スレーブリンク)</title>
	  <para>man pageも登録してみます。</para>
	  <para>総称名は editor_man とします。</para>
	  
	  <para>man page の場所は、<xref linkend="information_of_alternatives_for_editor" /> のように jed が /usr/share/man/man1/jed.1.gz 、vi が /usr/share/man/man1p/vi.1p.gz となっています。</para>
	  
	  <para>man page がおかれる /usr/share/man/ 以下は、セクションという分類があるので、リンク名2 もそれぞれ同じディレクトリに作ることにします。</para>
	  
	  <table id="man_page_of_editor">
	    <title>editor の man page</title>
	    <tgroup cols="2">
	      <thead>
		<row><entry>リンク名</entry><entry>選択候補</entry></row>
	      </thead>
	      <tbody>
		<row><entry>/usr/share/man/man1/editor.1.gz</entry><entry>/usr/share/man/man1/jed.1.gz</entry></row>
		<row><entry>/usr/share/man/man1p/editor.1.gz</entry><entry>/usr/share/man/man1p/vi.1p.gz</entry></row>
	      </tbody>
	    </tgroup>
	  </table>
	  
	  <para>/usr/share/man/man1/editor.1.gz と /usr/share/man/man1p/editor.1.gz というファイルが無いということを確認しておきます。
	    <screen>$ stat /usr/share/man/man1/editor.1.gz /usr/share/man/man1p/editor.1.gz</screen>
	    <screen>stat: `/usr/share/man/man1/editor.1.gz' の情報を取得できません: そのようなファイルやディレクトリはありません
stat: `/usr/share/man/man1p/editor.1.gz' の情報を取得できません: そのようなファイルやディレクトリはありません</screen></para>
	</sect4>
	
	<sect4 id="--install-with--slave-option">
	  <title>--slave オプションも利用して登録する</title>
	  <para>実際に登録してみます。</para>

	  <example id="add_generic-name_Editor-with--slave-option">
	    <title>総称名 Editor で jed vi emacs を登録する。(--slave オプションも利用)</title>
	    <para>jed を登録します。
	      <screen># /sbin/update-alternatives --install /usr/bin/editor Editor /usr/bin/jed 30 \
--slave /usr/share/man/man1/editor.1.gz editor-man /usr/share/man/man1/jed.1.gz</screen></para>
	    <para>vi を登録します。
	      <screen># /sbin/update-alternatives --install /usr/bin/editor Editor /bin/vi 20 \
--slave /usr/share/man/man1p/editor.1.gz editor-man /usr/share/man/man1p/vi.1p.gz</screen></para>
	    <para>emacs を登録します。
	      <screen># /sbin/update-alternatives --install /usr/bin/editor Editor /usr/bin/emacs 10</screen></para>
	  </example>

	</sect4>
      </sect3>
    </sect2>

    <sect2 id="option_--remove">
      <title>選択候補を削除する</title>
      
      <para>選択候補を削除するには、--remove というオプションを用います。</para>
      
      <para>総称名と選択候補を指定して、選択候補を一つ削除します。</para>
      <para>全ての選択候補が無くなる時には総称名も削除されます。</para>
      <para>manual( mode)の時に、選択されていた選択候補が削除されると auto(matic mode)に変更されます。</para>
      
      <para><screen># /sbin/update-alternatives --remove 総称名 選択候補</screen></para>
      
      <para>選択候補の確認は<ulink url="update-alternatives-3.html#option_--list">--list オプション</ulink>や<ulink url="update-alternatives-3.html#option_--display">--display オプション</ulink>が便利です。</para>
      
      <sect3 id="--remove_alternatives">
	<title>選択候補 /usr/bin/emacs を削除する</title>
	
	<para><ulink url="update-alternatives-3.html#option_--list">--list オプション</ulink>で選択候補を確認しておきます。
	  <screen>$ /sbin/update-alternatives --list Editor</screen>
	  <screen>/usr/bin/jed
/bin/vi
/usr/bin/emacs</screen></para>
	
	<para>総称名 Editor から 選択候補 /usr/bin/emacs を削除します。</para>
	<para><screen># /sbin/update-alternatives --remove Editor /usr/bin/emacs</screen></para>
	<para>通常、何も表示されません。</para>
	
	<para>manual( mode)で、選択されていた選択候補が削除された場合には、次のようにメッセーが出力され auto(matic mode)に変更されたことがわかります。</para>
	<para><screen># /sbin/update-alternatives --remove Editor /usr/bin/emacs</screen>
	  <screen>Removing manually selected alternative - switching to auto mode</screen></para>
	
	<para><ulink url="update-alternatives-3.html#common_options">--verbose オプション</ulink>を使うと次のように表示されます。
	  <screen># /sbin/update-alternatives --verbose --remove Editor /usr/bin/emacs</screen>
	  <screen>Checking available versions of Editor, updating links in /etc/alternatives ...
(You may modify the symlinks there yourself if desired - see `man ln'.)
Leaving Editor (/usr/bin/editor) pointing to /usr/bin/jed.
Leaving editor-man (/usr/share/man/man1p/editor.1.gz) pointing to /usr/share/man/man1/jed.1.gz.</screen></para>
	
	<para>下の 2行に、現在選択されている選択候補 /usr/bin/jed , /usr/share/man/man1/jed.1.gz が表示されています。</para>
      </sect3>

    </sect2>
    
    <sect2 id="option_--remove-all">
      <title>総称名を削除する</title>
      <para>総称名を指定して削除します。</para>
      <para>全ての選択候補が削除されます。</para>
      
      <para>総称名ごと削除するには --remove-all というオプションを用います。
	<screen># /sbin/update-alternatives --remove-all 総称名</screen></para>
      
      <sect3 id="--remove_generic_name">
	<title>総称名 Editor を削除する</title>
	
	<para>総称名 Editor を削除します。</para>
	<para><screen># /sbin/update-alternatives --remove-all Editor</screen></para>
	<para>通常、何も表示されません。</para>
	
	<para><ulink url="update-alternatives-3.html#common_options">--verbose オプション</ulink>を使うと次のように表示されます。
	  <screen># /sbin/update-alternatives --verbose --remove-all Editor</screen></para>
	<screen>Checking available versions of Editor, updating links in /etc/alternatives ...
(You may modify the symlinks there yourself if desired - see `man ln'.)
Discarding obsolete slave link editor-man (/usr/share/man/man1p/editor.1.gz).
Last package providing Editor (/usr/bin/editor) removed, deleting it.</screen>
	
	<para>スレーブリンクである editor-man が削除されることなどがわかります。</para>
      </sect3>
    </sect2>
    
  </sect1>
  
  <sect1 id="alternatives-packages">
    <title>alternatives で切り替えられるものが含まれているrpmパッケージ</title>
    
    <para>alternatives で切り替えできるものの 総称名(generic name) と rpmパッケージ名 を挙げておきます。<footnote><para>すべてのパッケージを挙げているわけではありません。また、選択候補が一つしかないものは挙げていません。</para></footnote></para>
    
    <table id="alternatives-packages-table">
      <title>alternatives で切り替えられるものが含まれているrpmパッケージ</title>
      <tgroup cols="2">
	<thead>
	  <row><entry>総称名</entry><entry>rpmパッケージ名</entry></row>
	</thead>
	<tbody>
	  <row><entry>apache2</entry><entry>apache2</entry></row>
	  <row><entry>emacs</entry><entry>emacs,emacs22,xemacs</entry></row>
	  <row><entry>cpp</entry><entry>gcc-cpp,gcc4-cpp,gcc295-cpp</entry></row>
	  <row><entry>g77</entry><entry>gcc-g77,gcc295-g77</entry></row>
	  <row><entry>gfortran</entry><entry>gcc4-gfortran</entry></row>
	  <row><entry>gcc</entry><entry>gcc,gcc4,gcc295</entry></row>
	  <row><entry>g++</entry><entry>gcc-c++,gcc4-c++,gcc295-c++</entry></row>
	  <row><entry>gcj</entry><entry>gcc-java,gcc4-java,gcc295-java</entry></row>
	  <row><entry>gij</entry><entry>libgcj,libgcj34</entry></row>
<!--	  <row><entry>pager</entry><entry>less,lv,more,w3m</entry></row> -->
          <row><entry>pear</entry><entry>php-pear,php5-pear</entry></row>
	  <row><entry>php</entry><entry>php,php5</entry></row>
	  <row><entry>print</entry><entry>cups,LPRng</entry></row>
	  <row><entry>vi</entry><entry>vim,vim-tiny,vim-huge,vim-X11,jvim</entry></row>
	  <row><entry>totem</entry><entry>totem-gstreamer,totem-xine</entry></row>
	</tbody>
      </tgroup>
    </table>
    
  </sect1>
</chapter>

<!-- EOF -->
