クロック設定用外部プログラムの使用と開発に関する情報 <author> The XFree86 Project, Inc. <date> 16 December 1994 <trans> The X Japanese Documentation Project <tdate> 13 January 1999 <toc>  <sect> クロック設定用外部プログラムの使用  XFree86 には、グラフィックスカードのクロック周波数の設定を外部プログラムから行うための機能があります。これにより、標準ドライバがサポートしていない方法でクロック選択を行うカードを扱えるようになります。  この機能を有効にするには、<tt>XF86Config</tt> ファイルの <tt>Device</tt> セクションに <tt>ClockProg</tt> という行を追加します。この行のフォーマットは以下のようになっています: <tscreen> <tt>ClockProg "</tt><it>commandpath</it><tt>"</tt> </tscreen>  ここで <it>commandpath</it> はクロック設定プログラムのフルパス名です。 <it>commandpath</it> に引き数を付けることはできません。  このオプションが使われ、かつ <tt>Clocks</tt> 行を指定されていない時には、カードのクロックは完全にプログラマブルである(例: SS24)ものと想定されます。しかし、カードで選べるクロックが予め決まっている場合には、 <tt>XF86Config</tt> ファイルの Device セクションに <tt>Clocks</tt> 行が必要であり、これを使って利用可能なクロック周波数をサーバに教えてやらなければなりません。<tt>Clocks</tt> 行におけるクロックの順序は、カードやプログラムが想定している順序と一致していなければなりません。クロック値は 128 個まで指定することができます。  サーバが外部プログラムを呼び出すのは、クロック周波数を変更する必要があるときです。変更する必要が生じるのは、サーバの起動時とホットキーシーケンスによってモードが切替えられたときです。外部コマンドには2つのコマンドライン引き数が渡されます。最初の引き数はクロック周波数です(MHz を単位とする浮動小数で、現在はほぼ 0.1MHz 単位で指定できます)。2番目の引き数は Clocks リストにおけるクロック値のインデックス番号です(最初のクロック値のインデックス番号は 0 になります)。選べるクロック値の組合せが決まっているカードではインデックス番号を使うことになるでしょうし、クロックが完全にプログラマブルなカードでは周波数を引き数にすることになるでしょう。  <sect>クロック設定用外部プログラムの開発  このような外部プログラムを使っている間には、サーバはクロック選択に関係するレジスタは一切変更しません。また、外部プログラムではクロック選択フィールド以外は変更しないよう注意しなければなりません。外部プログラムは、標準入力と標準出力を xf86Info.consoleFd にセットして実行されます。 xf86Info.consoleFd はファイルデスクリプタであり、表示関係の ioctl() 操作のために必要に応じて使われます。標準エラー出力はサーバの標準エラー出力と同じになります。つまり、エラーメッセージや警告メッセージはこちらに送られます。外部プログラムは実際に使うユーザの ID で実行されるので、特権を必要とするシステムコールを使う場合には、外部プログラムは root に SUID しておかなければなりません。外部プログラムは I/O アクセスの特権をサーバから受け継がないので、必要なアクセス権限は自分で使えるようにしなければならないでしょう。  外部プログラムは、正常終了すると終了ステータス 0 を返し、異常終了すると 1-254 の範囲のステータスを返すことが期待されます。サーバの初期化時に外部プログラムが異常終了すると、サーバも終了します。モード切替えのときに外部プログラムが異常終了すると、モード切替えが失敗し(サーバはクロック周波数が変更されなかったとみなします)、サーバは実行を続けます。将来的には、必要に応じて終了ステータスを変更できるようになるでしょう。これにより、外部プログラムがモード切替えに失敗してもサーバが終了できるようになります。  クロック切替えプログラムの例としては、ET4000 カード(8組の決まったクロック値を使用します)で使うプログラムがあります。このプログラムは例題として用意されたものであり、汎用的に使うことは考えられていません(ET4000 カードはサーバの内部コードで扱います)。このプログラムはソースツリーの <tt>xc/programs/Xserver/hw/xfree86/etc/et4000clock.c</tt> とバイナリツリーの <tt>/usr/X11R6/lib/X11/etc/et4000clock.c</tt> にあります。  クロック設定に外部プログラムを使うというアイディアは、 Frank Klemm さん <<it>pfk@@rz.uni-jena.de</it>> が提案したものです。 <verb> $XFree86: xc/programs/Xserver/hw/xfree86/doc/Japanese/sgml/clkprog.sgml,v 1.1.2.1 1999/05/25 06:39:30 hohndel Exp $ $XConsortium: clkprog.sgml /main/3 1996/02/21 17:46:48 kaleb $ </verb> <sect>日本語訳について 日本語訳は X Japanese Documentation Project が行いました (翻訳: 藤原輝嘉 <url url="mailto:fujiwara@@linux.or.jp" name="<fujiwara@@linux.or.jp>">, 校正: 金田浩司 <url url="mailto:vanitas@@ma3.seikyou.ne.jp" name="<vanitas@@ma3.seikyou.ne.jp>">)。問題点の指摘やご意見は藤原まで御連絡ください。原文の著作権は XFree86 プロジェクト社にあり、日本語訳の著作権は X Japanese Documentation Project にあります。 </article> @ 1.1 log @Initial revision @ text @@ 1.1.1.1 log @XFree86 3.3.4 sources @ text @@ 1.1.1.2 log @XFree86 3.3.6 @ text @d152 1 a152 1 $XFree86: xc/programs/Xserver/hw/xfree86/doc/Japanese/sgml/clkprog.sgml,v 1.1.2.2 1999/11/26 15:23:57 hohndel Exp $ @