diff options
author | Jun Kuriyama <kuriyama@FreeBSD.org> | 1999-04-08 15:46:01 +0000 |
---|---|---|
committer | Jun Kuriyama <kuriyama@FreeBSD.org> | 1999-04-08 15:46:01 +0000 |
commit | 9c0d1e11498d9fa3a542d21e109aa65624ec6a6e (patch) | |
tree | 094af15946e3157801dc2777c0023e1253af0a4f /ja_JP.eucJP | |
parent | 1f57381cf8ef4732e076469b9caf3acd67bc49df (diff) | |
download | doc-9c0d1e11498d9fa3a542d21e109aa65624ec6a6e.tar.gz doc-9c0d1e11498d9fa3a542d21e109aa65624ec6a6e.zip |
Migration to DocBook was completed.
Notes
Notes:
svn path=/head/; revision=4639
Diffstat (limited to 'ja_JP.eucJP')
43 files changed, 62608 insertions, 225 deletions
diff --git a/ja_JP.eucJP/articles/contributing/article.sgml b/ja_JP.eucJP/articles/contributing/article.sgml new file mode 100644 index 0000000000..0a08cafdd0 --- /dev/null +++ b/ja_JP.eucJP/articles/contributing/article.sgml @@ -0,0 +1,10027 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.12 + $Id: article.sgml,v 1.1.1.1 1999-04-08 15:45:59 kuriyama Exp $ +--> + +<chapter id="contrib"> + <title>FreeBSD への貢献</title> + + <para><emphasis>原作: &a.jkh;.</emphasis></para> + + <para><emphasis>訳: &a.jp.iwasaki;.<!-- <br> --> + 27 April 1997.</emphasis></para> + + <para>あなたも何か FreeBSD のために貢献したくなりましたか? + 素晴らしい! 私たちは常に支援を受ける用意がありますし, FreeBSD + は生き残るためにユー + ザベースの貢献に<emphasis>頼る</emphasis>ようなシステムの一つです. + あなたの貢献は 感謝されるだけではなく, FreeBSD + が成長し続けるために極めて重要なものな のです!</para> + + <para>一部の人達が言っているのとは逆に, + 貢献を受け付けてもらうために腕利 きのプログラマーになるとか + FreeBSD コアチームの人と親友になる必要はあ りません. FreeBSD + プロジェクトの開発は, 多くのそして益々増加する世界中 + の貢献者達によってなされており, 彼らの年齢, + 専門技術分野は多岐に渡りま す. + そして手の空いている人よりも + 成されるべき仕事の方が常に多いのです.</para> + + <para>FreeBSD + プロジェクトがカーネルや散在しているユーティリティよりも, + オペレーティングシステム環境 (と, そのインストール) + に対して責任を持つ ようになったため, + 私たちの<filename>TODO</filename>リストはドキュメンテーション, + ベータテ スト, + 高度に専門化されたタイプのカーネル開発の好例を紹介するなど非常に + 広い範囲のタスクに渡ります. あなたの技能レベルに関わらず, + プロジェクト を支援できることが必ず何かあります!</para> + + <para>FreeBSD + 関連の事業に従事している商業団体が私たちにコンタクトすること + も歓迎します. あなたの製品を (FreeBSD 上で) 動作させるには, + 特別な拡張 が必要ではありませんか? + あまりにも風変わりな要求でなければ, それを受け + 入れる用意が私たちにあるとわかるはずです. + 付加価値のある製品ですか? 私たちに知らせてください! 多分私たちは, + ある 面において共同して作業をすることができるでしょう. + フリーソフトウェア界 は, + ソフトウェアがそのライフサイクルを通してどのように開発され, + 売られ, 保守されていくかについて, 既存の仮説に挑戦しています. + 少なくとももう一 + 度考慮してみることを私たちは強くお奨めします.</para> + + <sect1> + <title>何が必要?</title> + + <para>次のタスクとサブプロジェクトのリストは, コアチームの色々な + <filename>TODO</filename> リ + ストと最近2ヶ月で集めたユーザリクエストを合わせたものです. + 可能なとこ ろでは, 緊急度によってタスクがランクづけされています. + もしここにあるタ スクの実行に興味があるのでしたら, + コーディネータの名前をクリックしてメー ルを送ってください. + もしコーディネータが決まっていなければ, あなたがボ + ランティアしてみませんか?</para> + + <sect2> + <title>優先度の高いタスク</title> + + <para>次のタスクは通常, ひどく壊れているとか, + とても必要とされている何かを 表しているため, + 急務と考えられています:</para> + + <orderedlist> + <listitem> + <para>第3ステージ・ブート問題. 全体コーディネーション: + &a.hackers;</para> + + <itemizedlist> + <listitem> + <para>第3ステージがディスクの BIOS + ジオメトリの正確なマッピングを提供 できるように WinNT + コンパチブルなドライブの追跡をおこなう.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>ファイルシステム問題. 全体コーディネーション: + &a.fs;</para> + + <itemizedlist> + <listitem> + <para>nullfs ファイルシステムコードのクリーンアップと + ドキュメンテーション. コーディネータ: &a.gibbs;</para> + </listitem> + + <listitem> + <para>union ファイルシステムの修正. コーディネータ: + &a.dg;</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>カーネル vm86 及びユーザ vm86 サポート実装. + コーディネータ: &a.jlemon;</para> + </listitem> + + <listitem> + <para>Int13 vm86 ディスクドライバの実装. コーディネータ: + &a.hackers;</para> + </listitem> + + <listitem> + <para>カーネル問題. 全体コーディネーション: + &a.hackers;</para> + + <itemizedlist> + <listitem> + <para>すべての現存ドライバの eisaconf 変換の達成.</para> + </listitem> + + <listitem> + <para>すべての割り込みルーチンを + ユニット番号を使う代わりに (void *) を + 取るように変更.</para> + </listitem> + + <listitem> + <para>EISA/PCI/ISAの割り込み登録コードの統合.</para> + </listitem> + + <listitem> + <para>PCI/EISA/ISA デバイス検出を bt742a.c(WIP) + のようなドライバから分割.</para> + </listitem> + + <listitem> + <para>syscons の ALT-Fn/vt 切替えによるハングの修正. + コーディネータ: &a.sos;</para> + </listitem> + + <listitem> + <para>3c509と3c590 ドライバの統合 (本質的には PCI + デバイス検出の ep.c への提供).</para> + </listitem> + </itemizedlist> + </listitem> + </orderedlist> + </sect2> + + <sect2> + <title>優先度がさほど高くないタスク</title> + + <para>次のタスクはやっておくべきではありますが, + 特にさし迫っているわけで はありません:</para> + + <orderedlist> + <listitem> + <para>MCA サポート? + これは続けるにしても止めてしまうにしても結論を出 + すべき.</para> + </listitem> + + <listitem> + <para>完全な KLD ベースのドライバのサポート / + コンフィグレーションマネー ジャ.</para> + + <itemizedlist> + <listitem> + <para>ld なしですべての LKM + の登録をおこなう方法を考案する. これは + カーネル中にある種のシンボルテーブルを + 持たせることを意味します.</para> + </listitem> + + <listitem> + <para>穏やかな方法でハードウェアを検知する + コンフィグレーションマネージャ の作成 + (第3ステージ・ブートの中に?). ハードウェアが必要とする + KLD だけを 残す等.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>PCMCIA/PCCARD. コーディネータ: &a.msmith; と &a.phk;</para> + + <itemizedlist> + <listitem> + <para>ドキュメンテーション!</para> + </listitem> + + <listitem> + <para>pcic ドライバの信頼性のある操作 (テスト要).</para> + </listitem> + + <listitem> + <para><filename>sio.c</filename> + のリコグナイザとハンドラ (ほぼ完了).</para> + </listitem> + + <listitem> + <para><filename>ed.c</filename> のリコグナイザとハンドラ + (ほぼ完了).</para> + </listitem> + + <listitem> + <para><filename>ep.c</filename> のリコグナイザとハンドラ + (ほぼ完了).</para> + </listitem> + + <listitem> + <para>User-mode のリコグナイザとハンドラ + (部分的に完了).</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>先進的なパワーマネージメント. コーディネータ: &a.nate; + と &a.phk;</para> + + <itemizedlist> + <listitem> + <para>APM サブドライバ (ほぼ完了).</para> + </listitem> + + <listitem> + <para>IDE/ATA ディスクサブドライバ (部分的に完了).</para> + </listitem> + + <listitem> + <para>syscons/pcvt サブドライバ.</para> + </listitem> + + <listitem> + <para>PCMCIA/PCCARD ドライバ群との統合 (サスペンド / + レジューム).</para> + </listitem> + </itemizedlist> + </listitem> + </orderedlist> + </sect2> + + <sect2> + <title>優先度の低いタスク</title> + + <para>次のタスクは全くのあら隠し, + または誰もすぐにおこないそうもない投資 + のような仕事を表します:</para> + + <para>最初の20項目は Terry Lambert + <email>terry@lambert.org</email> からのもので す.</para> + + <orderedlist> + <listitem> + <para>プロセッサ上で V86 モードを使用して, + プロテクトモードからの BIOS コールができるようにし, + マップされた割り込み IPC 機構を経由してプロテ + クトモードの呼出し元に結果を返すようにする.</para> + </listitem> + + <listitem> + <para>DOS と同じように, + 実際の下位ハードウェアから独立になるよう, BIOS + コール機構を使用したカーネルの中に組み込まれたドライバ. + これは DOS ベー スのローダプログラムで BSD + がロードされる前に DOS にロードされていたネッ + トワークドライバや ASPI ドライバも含みます. + このことは潜在的なポーリン グ, + つまりプロテクトモードカーネルによる V86 マシンのための + DOS-not-busy 割り込みの生成を意味します.</para> + </listitem> + + <listitem> + <para>ハードウェア固有のプロテクトモードの + ドライバがロードされて活性化 された後で, + デフォルトのカーネル実行形式の中の, そのようなドライバデー + タとテキストエリアを追跡して, + カーネルアドレス空間のその部分が回復され + るようにするためのイメージ形式. これは個々の BIOS + ベースのドライバを互いに分離することを含みます. なぜ + なら全く実行しないよりも, すべてのケースにおいて BIOS + ベースのドライバ と共に実行した方が良いためです.</para> + </listitem> + + <listitem> + <para>バスインタフェース機構の抽象化. 現在のところ, PCMCIA, + EISA そし て PCI バスはブリッジで ISA + バスに接続されていると仮定しています. こう + いった仮定はおこなうべきではありません.</para> + </listitem> + + <listitem> + <para>パワーマネージメントイベント, カードの挿入, 取り出し, + そしてバス (PNPISA と PCMCIA とのブリッジチップ) + 対カードのレベルのイベント管理を 含む PNP + イベントを解釈するコンフィグレーションマネージャ.</para> + </listitem> + + <listitem> + <para>固定デバイスによる他の再割当可・不可の + デバイス空間リソースの使用 と衝突しない, + 再割当可能なアドレスの割り当てのためのトポロジカルソート + 機構.</para> + </listitem> + + <listitem> + <para>ハードウェアサービス登録のための登録ベースの機構. + 特にタイマ, サウンドおよび他の + システムクリティカルなサービス供給源のためのデバイス + 中心の登録機構. + 単一の独立していないサービス供給源の一つの例として + Timer2, Timer0 + そしてスピーカサービスを考慮する必要があります.</para> + </listitem> + + <listitem> + <para>ネットワークカードと一緒に提供される ODI + カードドライバを使用で きるようにする, NetWare サーバ + (プロテクトモードの ODI ドライバ) ロー ダとサブサービス. + NDIS ドライバと NetWare の SCSI ドライバについても同 + 様.</para> + </listitem> + + <listitem> + <para>前のリビジョンの FreeBSD マシンではなく, Linux + マシンで動作する 「アップグレード + システム」オプション.</para> + </listitem> + + <listitem> + <para>移植を簡単にするためと, X, ThinkPad, PS/2マウス, LED, + コンソール スイッチング, しつこい NumLock + などの問題を全部一度に片付けるためのコ + ンソールドライバの抽象レイヤへの分割.</para> + </listitem> + + <listitem> + <para>機会が許したら, + 他の外部ドライバのための他のカーネルのエミュレー + ション環境. SCO と Solaris は UnixWare + などに続く良い候補です.</para> + </listitem> + + <listitem> + <para>異なるアーキテクチャのバイナリの実行のための + プロセッサエミュレーション環境. + これはシステムコールインタフェースがあまり変わらなければ, + 思ったより簡単です.</para> + </listitem> + + <listitem> + <para>商用のストリームドライバを使用可能にするための + ストリーム機構.</para> + </listitem> + + <listitem> + <para>カーネルのマルチスレッド化 + (カーネルのプリエンプションが必要).</para> + </listitem> + + <listitem> + <para>カーネルのプリエンプション付き対称マルチプロセッシング + (カーネル のプリエンプションが必要).</para> + </listitem> + + <listitem> + <para>ポータブルコンピュータのサポートにおける協調の試み. + これは PCMCIA + ブリッジング規則と電源管理イベント処理の変更により, いく + らかは処理できます. しかし, + 内蔵ディスプレイと外部ディスプレイの検出, この 2 + 種類のディスプレイがあるという事実に基づく + 異なる解像度の選択, マシンがドックにある場合には + ディスクのモータ停止を防止すること, マシンの + ブート能力に影響を与えずにドックベースのカードの消滅を + 可能にすること (PCMCIA と同じ問題) + などの問題があります.</para> + </listitem> + + <listitem> + <para>マルチプラットフォームへの移植のための + ソースツリーの再組織化.</para> + </listitem> + + <listitem> + <para><command>make + world</command>できちんと「世界を創造する」 + ができるようにする. (もし<command>make + regress</command>(訳注: 後退する)と呼び方が適当であれば, + そのように 名前を変える)</para> + </listitem> + + <listitem> + <para>最小必要メモリ 4MB 化 (もっと小さければなお良し!).</para> + </listitem> + </orderedlist> + </sect2> + + <sect2> + <title>もっと簡単なタスク</title> + + <para>上のセクションで挙げたタスクは膨大な時間の投資または + FreeBSD のカーネルに関する深い知識を必要とします + (もしくはそのどちらも). しかしながら, + "週末ハッカー"やプログラミングのスキルを持 + たない人々に適した立派なタスクも数多くあります.</para> + + <orderedlist> + <listitem> + <para>FreeBSD-current を運用しており, + 状態の良いインターネット接続があ るならば, <hostid + role="fqdn">current.freebsd.org</hostid> + という一日に一回フルリリースを行っている マシンがあります + — 時おり最新のリリースをそこからインストールし, その + 過程で何か問題があるなら報告して下さい.</para> + </listitem> + + <listitem> + <para><email>freebsd</email>-bugs + メーリングリストを読んでください. そこではあなたが建 + 設的なコメントを付けたりテストできるパッチが + 提供されているような問題がある かもしれません. + もしくはそれらの問題の一つをあなた自身で修正することさえ + できるかもしれません.</para> + </listitem> + + <listitem> + <para>定期的に FAQ とハンドブックを通して読んでみてください. + もしまずい説明や古い事柄や完全に間違っていることなどが + あれば我々に しらせて下さい. + さらに良いのは我々に修正案を送ることです (SGML + は学ぶのにそれほど難しくありませんが, + プレインテキストでも問題は ありません).</para> + </listitem> + + <listitem> + <para>(もしまだないならば) FreeBSD + のドキュメントを自分の母国語に翻訳 + するのを手伝ってください — + 作業している人がいるかどうか &a.doc; にメールを + 送って聞くだけです. とはいっても, + そうすることによってあなたが全ての FreeBSD + ドキュメントの翻訳に携わるように + なるというわけではないですから ね — 実際, + もっとも翻訳が必要とされているドキュメントはインストール方 + 法です.</para> + </listitem> + + <listitem> + <para>たまに(もしくは定期的に) freebsd-questions + メーリングリストや + <literal>comp.unix.bsd.freebsd.misc</literal> + を読んでください. これは, あなたの持ってい + る専門知識を共有したり誰かが抱えている問題を + 解決するのに非常に有効な ものになり得ることです. + 時にはあなた自身で新しいことを学ぶことさえ + できるかもしれません. + これらのフォーラムはやるべきことのアイディア + の源にもなり得るのです.</para> + </listitem> + + <listitem> + <para>-current に正しく当てられるがしばらく経っても(通常は + 2, 3 週間) -stable + に取り込まれてないようなバグフィックスがあるならば + コミッターに 丁寧に思い出させてください.</para> + </listitem> + + <listitem> + <para>寄贈ソフトウェアをソースツリーの + <filename>src/contrib</filename> + に移動させてください.</para> + </listitem> + + <listitem> + <para><filename>src/contrib</filename> + 以下のコードが最新のものであるか確認してください.</para> + </listitem> + + <listitem> + <para>2000 年問題に関するバグを探してください(そして, + 見つけたら修正してください!).</para> + </listitem> + + <listitem> + <para>ソースツリー全体(もしくはその一部)を, + 警告を詳細に報告するようにして構築してみてください. + そして警告が出ないようにしてください.</para> + </listitem> + + <listitem> + <para>ports で, gets() を使っているとか malloc.h + をインクルードしている + などといった警告が出ないようにしてください.</para> + </listitem> + + <listitem> + <para>もしなんらかの ports に関わっているなら, + あなたのパッチを作者に フィードバックしてください + (次のバージョンが出た時にあなたが楽になります).</para> + </listitem> + + <listitem> + <para>このリストに追加するタスクを提案して下さい!</para> + </listitem> + </orderedlist> + </sect2> + </sect1> + + <sect1> + <title>貢献の仕方</title> + + <para>一般的に, システムへの貢献は次の 6 + つのカテゴリの1つ以上に分類されます:</para> + + <sect2 id="contrib-general"> + <title>バグ報告と一般的な論評</title> + + <para>報告するべきバグがあったり, 提案したいことがあれば:</para> + + <para><emphasis>一般的な</emphasis> + 技術的関心事に関するアイデアや提案は &a.hackers; + へメールしてください. 同様に, このような事柄に興味のある + (そして<emphasis>膨大な</emphasis>メール! に耐えられる) 人は, + &a.majordomo; へメールを送って hackers + メーリングリストに参加すると良いでしょう. 情報については + <link linkend="eresources-mail">メーリングリスト</link> + を参照してください.</para> + + <para>バグを発見したり変更を送付しようとしている場合は + &man.send-pr.1; プログラムか <ulink + URL="http://www.freebsd.org/send-pr.html">WEB ベースの + send-pr</ulink> を使用して報告してください. + バグレポートの各項目を埋めるようにしてください. 65KB + を超えるのでなければ, レポート中に直接 + パッチを入れてくださって結構です. 20KB を超える場合は, + それらを compress して &man.uuencode.1; + することも検討してください. とても大きくなる場合は <ulink + url="ftp://ftp.FreeBSD.ORG/pub/FreeBSD/incoming/"> + ftp.freebsd.org:/pub/FreeBSD/incoming/</ulink> + を利用してください. + </para> + + <para>レポートがファイリングされれば, バグ報告の確認と + トラッキング番号をメールで受け取るはずです. + このトラッキング番号を覚えておき, 問題に関する詳細情報を + <email>bug-followup@FreeBSD.ORG</email> に + メールで送って更新できるようにしてください. 例えば + <literal>"Re: kern/3377"</literal> のように, + この番号をサブジェクト行に使用してください. + すべてのバグレポートの追加情報は, + この方法で送付されなければいけません.</para> + + <para>もしタイムリに (あなたの電子メール接続形態にもよりますが, + 3日から 1週間) 確認を受けとれないとか, 何らかの理由で + &man.send-pr.1; コマンドが 使用できない場合には, &a.bugs; + へメールを送り, 誰か代りにバグ報告を + 送付してもらうようたずねてください.</para> + </sect2> + + <sect2> + <title>文書の変更</title> + + <para>文書の変更は &a.doc; が監督しています. <link + linkend="contrib-general">バグ報告と一般的な論評</link> + に記述されているように <command>send-pr</command> + コマンドを使用して, 提案や変更 + (どんな些細なものでも歓迎します!) を送ってください.</para> + </sect2> + + <sect2> + <title>現存のソースコードの変更</title> + + <para>現存のソースコードへの追加または変更は, + いくらかトリッキーな仕事で あり, core の FreeBSD + 開発の現状にあなたがどれだけ通じているかに大 きく依存します. + “FreeBSD-current”として知られる FreeBSD の特別な + 継続的リリースがあります. FreeBSD-current + は開発者の積極的な活動の 便宜のために, + 色々な方法で利用可能になっています. FreeBSD-current + の入手と使用方法についての詳しい情報については <link + linkend="current">最新の FreeBSD を追いかける</link> + を参照してください.</para> + + <para>不幸にして古いソースをもとに仕事をすることは, + 時々あなたの変更が時 代遅れ, または FreeBSD + への簡単な再統合に合わなくなっていることを意 味します. + システムの現状に関する議論がおこなわれている &a.announce; と + &a.current; へ参加することで, + この可能性を最小限にすることができます.</para> + + <para>完全な最新のソースを変更のベースにできることが + 確実になったと仮定し て, 次のステップは FreeBSD + の保守担当者へ送る差分ファイルの生成です. これは &man.diff.1; + コマンドを使用しておこないますが, “context + diff”形式が好まれるようです. 例えば:</para> + + <screen>&prompt.user; <userinput>diff -c oldfile newfile</userinput></screen> + + <para>または</para> + + <screen>&prompt.user; <userinput>diff -c -r olddir newdir</userinput></screen> + + <para>これで指定されたソースファイルまたはディレクトリ階層に + 対するコンテ キスト形式の差分が生成されます. 詳しい説明は + &man.diff.1; のマ ニュアルページを参照してください.</para> + + <para>差分ファイル (&man.patch.1; コマンドでテストできます) + を作ったら, それらを FreeBSD + に含めてもらうようメールで送ってください. <link + linkend="contrib-general">バグ報告と一般的な論評</link> + に記述されているように &man.send-pr.1; + コマンドを使用してください. 差分ファイルだけを &a.hackers; + へ送ってはいけません. 途方にくれてしまいます! + 私たちは多忙なので, あなたの提案に大変感謝します + (これはボランティアのプロジェクトです!). + すぐに取りかかることはできませんが, 処理されるまでは ちゃんと + pr データベースに残っています.</para> + + <para>あなたがそうした方がいいと思う場合 (例えば, + ファイルの追加, 削除または名称変更など), 変更を + <command>tar</command> ファイルにまとめ, &man.uuencode.1; + プログラムにかけてください. Shar + アーカイブも歓迎します.</para> + + <para>例えばあなたがそれ自身のさらなる配布を管理する + コピーライト問題を良 く分かっていないとか, + 単に厳しいレビューをおこなっておらず, リリース + する準備ができていないなど, + あなたの変更が潜在的に不安定な性質をも つものである場合, + &man.send-pr.1; で送付するよりむしろ &a.core; + へ直接送ってください. コアチームメーリングリスト宛のメールは, + 日々の仕 事のほとんどを FreeBSD でおこなっている人たちの, + より小さなグルー プに届きます. + このグループもまた<emphasis>とても忙しい</emphasis> + ことに注意し て, 本当に必要な場合にコアチームの彼らにメールを + 送るだけにしてください.</para> + + <para>コーディングスタイルに関する情報は <command>man 9 + intro</command> および <command>man 9 style</command> + を参照してください. コードを提出する前には, + 少なくともこの情報を意識しておいてくださるようお願いします. + </para> + </sect2> + + <sect2> + <title>新たなコードやメジャーな付加価値の高いパッケージ</title> + + <para>重要な大きい仕事の寄贈や, 重要な新しいフィーチャーを + FreeBSD に追加 する稀な場合には, 変更点を tar/uuencode + したファイルにして送るか, それらを私たちの ftp サイト <ulink + URL="ftp://ftp.FreeBSD.ORG/pub/FreeBSD/incoming"> + ftp://ftp.FreeBSD.ORG/pub/FreeBSD/incoming</ulink> + へアップロードす ることのどちらかが通常必要になります.</para> + + <para>大量のコードを伴った仕事の場合, + コピーライトの神経過敏な問題が常に 出てきます. FreeBSD + に含めるコードのコピーライトとして受け入れるこ とができるのは, + 以下の二つです:</para> + + <orderedlist> + <listitem> + <para>BSD コピーライト. + このコピーライトは“権利に縛られない”性格 + と商用企業にとって一般的な魅力をもつために最も好まれま す. + FreeBSD プロジェクトは商用利用を阻んだりせず, 何かを + FreeBSD + へ投資する気になった商業関係者による参加を積極的に奨励 + します.</para> + </listitem> + + <listitem> + <para>GNU一般公有使用許諾, または“GPL”. + このライセンスはコード + を商用目的に使用する場合に余分な努力が求められるため, + 私たち にあまり評判が良いというわけではありません. しかし, + 私たちは 既に GPL 下の高品質なコード (コンパイラ, + アセンブラ, テキスト フォーマッタ等) の提供を受けており, + 私たちは現在それを必要と しています. そのため, + このライセンスによる新たな貢献を拒絶す + るというのは愚かなことでしょう. GPL + 下のコードはソースツリー の別の部分, 現在のところ + <filename>/sys/gnu</filename> か + <filename>/usr/src/gnu</filename> に入っています. + そのため, GPL が問題と なるような人は, + 誰でも簡単にそれとわかるようになっています.</para> + </listitem> + </orderedlist> + + <para>これ以外のタイプのコピーライトによる寄贈は, FreeBSD + へ含めることを 考慮する前に, + 注意深いレビューを受けなければなりません. 作者が独自 + のチャネルを通して配布しており, + そのような変更をおこなうことを常に 奨励している場合でも, + 特に限定的な商用のコピーライトが適用される寄 + 贈は一般に拒否されます.</para> + + <para>あなたの作品に “BSD-スタイル” + のコピーライトを付けるには, 保護した + いソースコードファイルすべての一番最初に + 以下のテキストを入れて, <literal>%%</literal> + の間を適切な情報に置き換えください.</para> + + <programlisting> +Copyright (c) %%適切な年%% + %%あなたの名前%%, %%あなたの州%% %%郵便番号%%. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer as + the first lines of this file unmodified. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY %%あなたの名前%% ``AS IS'' AND ANY EXPRESS OR +IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +IN NO EVENT SHALL %%あなたの名前%% BE LIABLE FOR ANY DIRECT, INDIRECT, +INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + $Id$</programlisting> + + <para>便宜をはかるため, + このテキストのコピーは次の場所に置いてあります. + <filename>/usr/share/examples/etc/bsd-style-copyright</filename>. + </para> + + <para>(訳注: 以下は神田敏広氏より寄贈された bsd-style-copyright + の日本語訳です. + ソースファイルに含めるものは原文の方であることに注意して + ご利用ください. また, 原文との間に趣旨の差異が生じた場合, + 原文の内容が FreeBSD プロジェクトの + 意思であるものとします.)</para> + + <programlisting> +Copyright (C) [年] + [あなたの名前] All rights reserved. + +ソースとバイナリ形式の再配布および使用は, 変更の有無にかかわらず以下の +条件を満たす場合に限り許可される: +1. ソースコードの再配布は, 上記の著作権表示・この条件のリスト・下記の + 否認声明文を保持しなければならない. + +2. バイナリ形式の再配布は, 上記の著作権表示・この条件のリスト・下記の + 否認声明文を, 配布物と共に提供される文書および/または他の資料の中に + 含めなければならない. + +(訳注:ここから「否認声明文」です) + +このソフトウェアは[あなたの名前]および貢献者によって ``あるがままの状態'' +で提供され, 商品性と特定の目的に対する適合性についての暗黙の保証に留ま +らず, いかなる明示および暗黙の保証を認めない. [あなたの名前]および貢献 +者は, あらゆる直接的・間接的・偶発的・特殊的・典型的・必然的な損害 (代 +替製品または代替サービスの獲得費; 効用・データ・利益の喪失; または業務 +中断を含み, またそれだけに留まらない損害) に対して, たとえどのようにし +て生じたとしても, そしてこのソフトウェアの使用によってどのようにであれ +生じる, 契約上であろうと, 厳密な責任内であろうと, あるいは不正行為 (過 +失やそうでない場合を含む) における場合であろうとも, いかなる責任論上も, +たとえそのような損害の可能性が予見されていたとしても, 一切の責任を持た +ない. + +翻訳: 神田敏広 +御協力 (五十音順・敬称略): + 池田研二, 内川 喜章, 藤村 英治, むらたしゅういちろう + 杢野 雅一, 横田@宇都宮 + </programlisting> + </sect2> + + <sect2 id="porting"> + <title>自分で port を作る</title> + + <para><emphasis>原作: &a.jkh;, &a.gpalmer;, &a.asami;, + &a.obrien; and &a.hoek;. 28 August 1996.</emphasis></para> + + <para><emphasis>訳: &a.jp.simokawa;, &a.asami;.<!-- <br> --> + 10 November 1996.</emphasis></para> + + <para>自分で port を作ることに興味がありますか, すばらしい!</para> + + <para>これから, FreeBSD 用のportを作る際の, + いくつかのガイドラインを 説明します. + 実際にportをコンパイルするときのほとんどの仕事は + <filename>/usr/share/mk/bsd.port.mk</filename> + というファイルでおこないます. + Portsコレクションについてのさらに細かい内部の働きについては, + そちらの ファイルを参照してください. + これにはコメントが細かく書いてありますので, Makefile + を読むのにあまり慣れていない人でも, 得るものはとても大きいで + しょう.</para> + + <note> + <para>ここでは, 変更可能な変数の一部についてのみ記述しています. + ほとんどの変数は<filename>bsd.port.mk</filename> + の始めに記述があります. + また, このファイルは非標準のタブの設定になっています. + <application>Emacs</application> や <application>Vim</application> + はファイルのロード時にこれを認識しますが, + <command>vi</command>や<command>ex</command>では, + ファイルをロードしたら <command>:set tabstop=4</command> + のようにして正しい値を設定する + ことができます.</para> + </note> + + <sect3> + <title>3分porting</title> + + <para>この節では, 簡単なportの方法について説明します. + 多くの場合これ では不十分ですが, + まあうまくいくかどうか試してみて損はないでしょ う.</para> + + <para>まず, 元のtarファイルを<makevar>DISTDIR</makevar>に置きます. + デフォルトは<filename>/usr/ports/distfiles</filename>です.</para> + + <note> + <para>以下では, + ソフトウェアはそのままコンパイルされるとします. つまり, + FreeBSDのマシンで動かすために, 変更がまったく必要ない + とします. + もしなにか変更が必要な場合には次の節も参照する必要 + があります.</para> + </note> + + <sect4> + <title><filename>Makefile</filename> の作成</title> + + <para>最小限の<filename>Makefile</filename> + は次のようなものです:</para> + + <programlisting> +# New ports collection makefile for: oneko +# Version required: 1.1b +# Date created: 5 December 1994 +# Whom: asami +# +# $Id$ +# + +DISTNAME= oneko-1.1b +CATEGORIES= games +MASTER_SITES= ftp://ftp.cs.columbia.edu/archives/X11R5/contrib/ + +MAINTAINER= asami@FreeBSD.ORG + +MAN1= oneko.1 +MANCOMPRESSED= yes +USE_IMAKE= yes + +.include <bsd.port.mk></programlisting> + + <para>おわかりになりますでしょうか. + <literal>$Id$</literal>があ る行の内容については, + 気にしないでください. これはこのファイル + がportsツリーに書き込まれるときにCVSによって自動的に書 + き込まれます. もっと詳しい例が見たければ, <link + linkend="porting-samplem">Makefileのお手本</link> + の節をご覧ください.</para> + </sect4> + + <sect4> + <title>Package記述ファイルの作成</title> + + <para>どのようなportでも, packageにするしないに関わらず, 3つ + の記述ファイルが必要です. + <filename>pkg</filename>サブディレクトリにある, + <filename>COMMENT</filename>, <filename>DESCR</filename>, + それに <filename>PLIST</filename>です.</para> + + <sect5> + <title><filename>COMMENT</filename></title> + + <para>これには, そのportについての説明を1行で書きます. + Package の名前, バージョン番号等は + <emphasis>含めない</emphasis>でください. たとえば, + こんな具合です:</para> + + <programlisting> +A cat chasing a mouse all over the screen.</programlisting> + </sect5> + + <sect5> + <title><filename>DESCR</filename></title> + + <para>これは, そのソフトウェアについての, + すこし長い説明を記述します. その port + が何をするのかについての数段落程度の + 簡潔な解説があれば十分です. + このファイルはマニュアルでもなければ, + 使用方法やコンパイル方法についての細かい + 説明書でもありません. 特に, + <emphasis><filename>README</filename>ファイル manpage + をコピーしようとしてしている場合には + 注意してください</emphasis>. これらは多くの場合, + そのポートの簡潔な説明に なっていなかったり, + 扱いにくい形式(manpage の場合, + 行を揃えるために空白が調整されます)になっていたりします. + もしこのソフトウエアに公式の WWW のホームページがあれば, + ここに書いて下さい.</para> + + <para>このファイルの最後にあなたの名前を書くことが + 推奨されています. たとえば, こんな具合です.</para> + + <programlisting> +This is a port of oneko, in which a cat chases a poor mouse all over +the screen. + : +(うんぬん.) + +http://www.oneko.org/ + +- Satoshi +asami@cs.berkeley.edu</programlisting> + </sect5> + + <sect5> + <title><filename>PLIST</filename></title> + + <para>このファイルには, + このportによってインストールされるファ + イルが列挙されます. このファイルはpackageを作る際のリス + トとして使われるため, `packing list' とも呼ばれます. + ここ に書かれているファイル名は, + インストール時のプレフィックス (普通は + <filename>/usr/local</filename> か + <filename>/usr/X11R6</filename>) からの 相対パスです. + <makevar>MAN<replaceable>n</replaceable></makevar> + 変数を使用する場合(使用することが推奨されています)には, + マニュアルはここに入れないでください.</para> + + <para>簡単な例を載せておきましょう:</para> + + <programlisting> +bin/oneko +lib/X11/app-defaults/Oneko +lib/X11/oneko/cat1.xpm +lib/X11/oneko/cat2.xpm +lib/X11/oneko/mouse.xpm +@dirrm lib/X11/oneko</programlisting> + + <para>'Packing list'の詳細については, &man.pkg.create.1; + の マニュアルを参照してください. + すべてファイルを列挙しなければなりませんが, + ディレクトリ名は必要ありません. また, ports + がインストール時にディレクトリを作成する場合には, + <literal>@dirrm</literal> の行を加えて, その port + が削除されるとき, + そのディレクトリも削除されるようにしてください. </para> + + <para>このファイルには, + ファイル名をアルファベット順に並べるようにしてください. + port のアップグレートのとき, + 楽に確認ができるようになります.</para> + </sect5> + </sect4> + + <sect4> + <title>チェックサムファイルの作成</title> + + <para>ただ, <command>make makesum</command> + と入力するだけです. <filename>bsd.port.mk</filename> + にルールがあるので, + 自動的に<filename>files/md5</filename>が生成されます.</para> + </sect4> + + <sect4 id="porting-testing"> + <title>Portのテスト</title> + + <para>そのportが正しく動くことを, + package化を含めて確認してください. + 以下の重要なポイントを確認してください.</para> + + <itemizedlist> + <listitem> + <para><filename>PLIST</filename> にその port + がインストールしないものが含まれていないこと.</para> + </listitem> + + <listitem> + <para><filename>PLIST</filename> にその port + がインストールする全てのものが含まれていること.</para> + </listitem> + + <listitem> + <para><maketarget>reinstall</maketarget> + ターゲットを使うことによって, + 何度でもインストールが可能こと.</para> + </listitem> + + <listitem> + <para>deintall の際に <link + linkend="porting-cleaning">後片付け</link> + をすること.</para> + </listitem> + </itemizedlist> + + <procedure> + <title>推奨されるテストの手順</title> + + <step> + <para><command>make install</command></para> + </step> + + <step> + <para><command>make package</command></para> + </step> + + <step> + <para><command>make deinstall</command></para> + </step> + + <step> + <para><command>pkg_add `make package-name`</command></para> + </step> + + <step> + <para><command>make deinstall</command></para> + </step> + + <step> + <para><command>make reinstall</command></para> + </step> + + <step> + <para><command>make package</command></para> + </step> + </procedure> + + <para><maketarget>package</maketarget> および + <maketarget>deinstall</maketarget> の段階で, + どんな警告(warning)も出力されないことを確認してください. + ステップ3の後, + 新しいディレクトリが全て正しく消去されているかを + 確認してください. また, + ステップ4の後にそのソフトウェアを使用してみて, package + からインストールされた場合に正しく動作するかを + 確認してください.</para> + </sect4> + + <sect4 id="porting-portlint"> + <title><command>portlint</command> でチェック</title> + + <para><command>portlint</command>を使って, あなたの port + が我々のガイドラインそっているかを確認してください. + <command>portlint</command> プログラムは ports + コレクションに含まれています. 特に, <link + linkend="porting-samplem">Makefile</link> + が正しい形式になっているか, <link + linkend="porting-pkgname">package</link> + の名前が正しいか, をチェックするのに良いでしょう.</para> + </sect4> + + <sect4 id="porting-submitting"> + <title>Portの送付</title> + + <para>まず, <link + linkend="porting-dads">やってよいことといけないこと</link> + についての節を読んでください.</para> + + <para>さあ, あなたのportに満足したら, + あとはそれをFreeBSDのメイ ンのportsツリーに置いて, + 皆に使ってもらうだけです. いまある + <filename>work</filename> ディレクトリや + <filename>pkgname.tgz</filename> + パッケージは必要ありませんから, まず消去してください. + あとは, バグレポートの中に <command>shar `find + port_dir`</command> の出力を, &man.send-pr.1; + プログラムを使用して送ってください. &man.send-pr.1; + についての詳細は, <link + linkend="contrib-general">バグ報告と一般的な論評</link> + を参照してください.) もし, 圧縮していない状態で, + 20KB以上あるようなポートであれば, 圧縮して tar + ファイルにして, バグレポートに入れる前に &man.uuencode.1; + を使用してください. (20KB以下のものでも, tar + ファイルにして送ってもよいですが, あまり歓迎されません). + バクレポートの category は <literal>ports</literal>, class + は + <literal>change-request</literal>を必ず使用してください. + (レポートを <literal>confidential</literal> (内密) + にしないようにしてください!)</para> + + <para>もう一度, <emphasis>オリジナルのソースファイル, + <filename>work</filename> ディレクトリ, <command>make + package</command> + で作成したパッケージが含まれていないこと + </emphasis>を確認してください.</para> + + <note> + <para>以前, 新しい port をわれわれの ftp サイト (<hostid + role="fqdn">ftp.freebsd.org</hostid>) + にアップロードするようにお願いしたことがありますが, + 現在このサイトの <filename>incoming</filename> + ディレクトリは読み出し不可になっており, + いまでは推奨されていません. + 沢山の海賊版ソフトウェアがそこに置かれたためです.</para> + </note> + + <para>私たちは, 何か不明な点があったらあなたに確認したのち, + それをツリーへ置きます. あなたの名前は, FreeBSD + ハンドブックやその他のファイルの “Additional FreeBSD + contributors” のリストにも載るでしょう. う〜ん, + 素晴らし い. <!-- smiley -->:)</para> +<!-- kuriyama - should use link tag? --> + </sect4> + </sect3> + + <sect3> + <title>本格的なport</title> + + <para>残念ながら, 移植がそう簡単ではなく, + 動かすために多少の変更が 必要な場合も多いでしょう. + この節では, portsコレクション の方法論にのっとって, + そのような場合にどのように変更を施し, 動 + くようにしたらよいかを順を追って説明します.</para> + + <sect4> + <title>port構築の詳細</title> + + <para>まず, あなたがportのディレクトリで + <command>make</command> とタイ + プしてから起こる一連の出来事について,順を追って説明しま + す. ここを読むときには, 他のウィンドウで同時に + <filename>bsd.port.mk</filename> + も開いておくとよいかもしれません.</para> + + <para>しかし, + <filename>bsd.port.mk</filename>が何をしているのか, + 完全に理解 できなくても心配する必要はありません. + そう多くの人が理解して いるわけではないですから... <!-- + smiley --><emphasis>f(^_^;)</emphasis></para> + + <procedure> + <step> + <para>まず, <maketarget>fetch</maketarget> + というターゲットが実行されます. + この<maketarget>fetch</maketarget>ターゲットは + ローカルディスクの<makevar>DISTDIR</makevar>に配布ファ + イルがあるようにするのが役目です. もし, + <maketarget>fetch</maketarget>が必要なファ + イルを<makevar>DISTDIR</makevar>に見つけることが + できなけ れば, Makefileに指定されているURL + <makevar>MASTER_SITES</makevar>, + そして私たちのFTPサイトで ある <ulink + URL="ftp://ftp.freebsd.org/pub/FreeBSD/ports/distfiles/"> + ftp://ftp.freebsd.org/pub/FreeBSD/ports/distfiles/</ulink> + (ここ には, 私たちが取ってきたファイルを + バックアップとして置いてあ ります) に探しにいきます. + そして, ユーザのサイトがインター ネットに + 直接接続されている場合には, <makevar>FETCH</makevar> + を使って, その名前のファイルを取っ てきて, + <makevar>DISTDIR</makevar>に保存します.</para> + </step> + + <step> + <para>次に実行されるのは + <maketarget>extract</maketarget> ターゲットです. + これは, <makevar>DISTDIR</makevar>にある, 配布ファイル + (普通は gzipされたtarファイル) を読み, + ソースを一時的な作業ディレ + クトリ<makevar>WRKDIR</makevar> (デフォルトは + <filename>work</filename>) に展開します.</para> + </step> + + <step> + <para>次に, <maketarget>patch</maketarget> + というターゲットが実行されます. まず, + <makevar>PATCHFILES</makevar>に定義されている, + すべてのパッ チをあてます. + 次にもし<makevar>PATCHDIR</makevar> (デフォ ルトは + <filename>patches</filename> サブディレクトリ) + にパッチが存在す れば, + これらをアルファベット順にあてます.</para> + </step> + + <step> + <para>次に実行されるターゲットは + <maketarget>configure</maketarget>です. これには, い + ろいろな場合があります.</para> + + <orderedlist> + <listitem> + <para>もし存在すれば, + <filename>scripts/configure</filename> + が実行されます.</para> + </listitem> + + <listitem> + <para>もし, <makevar>HAS_CONFIGURE</makevar> + あるいは <makevar>GNU_CONFIGURE</makevar> + がセットされていれば, + <filename><makevar>WRKSRC</makevar>/configure</filename> + が実行されます.</para> + </listitem> + + <listitem> + <para>もし, <makevar>USE_IMAKE</makevar> + がセットされていれば, <makevar>XMKMF</makevar> + (デフォルト: <command>xmkmf -a</command>) + が実行されます.</para> + </listitem> + </orderedlist> + </step> + + <step> + <para>最後に, <maketarget>build</maketarget> + というターゲットが実行されます. これは, その port + の専用の作業ディレクトリ (<makevar>WRKSRC</makevar>) + にい き, コンパイルするのが役目です. もし + <makevar>USE_GMAKE</makevar> がセットされていれば, GNU + <command>make</command> が使用されます. + さもなければFreeBSDの <command>make</command> + が使用されます.</para> + </step> + </procedure> + + <para>上記はデフォルトのルールです. さらに, + <maketarget>pre-<replaceable>何とか + </replaceable></maketarget>や + <maketarget>post-<replaceable>何とか</replaceable></maketarget> + というターゲット が定義してあったり, + そのような名前のスクリプトが + <filename>scripts</filename> サブディレクトリに + 置いてある場合には, それ らはデフォルトの動作の + 前後に実行されます.</para> + + <para>たとえば, <maketarget>post-extract</maketarget> + というターゲットがMakefile で定義されていて, + <filename>pre-build</filename> というファイルが, + <filename>scripts</filename> + サブディレクトリにあるとすると, + <maketarget>post-extract</maketarget>ターゲットは, + 通常の展開動作のあとに呼 び出され, + <filename>pre-build</filename> + スクリプトはデフォルトのコンパイ + ルのルールが実行される前に実行されます. + もし動作が簡単であれ ば, <filename>Makefile</filename> + のターゲットを使用することが推奨されています. な ぜならば, + そのportが何らかのデフォルトではない動作を必要とす + るのかどうかが一箇所にまとめて書いてあった方が他の人に + 理解しやす いからです.</para> + + <para>デフォルトの動作は <filename>bsd.port.mk</filename> の + <maketarget>do-<replaceable> 何とか + </replaceable></maketarget> + というターゲットでおこなわれます. たとえば, + portを展開するコマンドは, + <maketarget>do-extract</maketarget> + というターゲットにあります. もし, + デフォルトのターゲットに 不満があれば, + <maketarget>do-<replaceable> something + </replaceable></maketarget> というターゲッ + トを再定義することによって, + どのようにでも直すことができます.</para> + + <note> + <para>“メイン”のターゲット (例えば, + <maketarget>extract</maketarget>, + <maketarget>configure</maketarget>等) は, + すべての前段階が実行されていること を確認して, + 実際のターゲットやスクリプトを呼び出す以外のこと + はしません. + bsd.port.mkはこれらが変更されることは仮定してい + ませんので, もし, 例えば, 展開の仕方を直したいときには, + <maketarget>do-extract</maketarget> を直し, + 絶対に<maketarget>extract</maketarget>には手を + 触れないでください.</para> + </note> + + <para>これで, ユーザが <command>make</command> + と入力したときに何が起こ るのかが理解できたと思います. + では, 完璧なportを手順を追っ て作ってみましょう.</para> + </sect4> + + <sect4> + <title>オリジナルのソースの入手</title> + + <para>オリジナルのソースを, (普通は) + 圧縮されたtarファイルの形 (<filename> + <replaceable>foo</replaceable>.tar.gz</filename> + あるいは + <filename><replaceable>foo</replaceable>.tar.Z</filename>) + で入手して, それを <makevar>DISTDIR</makevar> + にコピーします. 可能なかぎり, 広 + く使われている<emphasis>主流の</emphasis> + ソースを使用するようにしてください.</para> + + <para>もし, ネットワークへの接続のよい FTP/HTTP + サイトを見つけるこ とができなかったり, + 頭にくるような非標準的な形式しか持ってい + ないサイトしか見つけられないときには, 自分で管理する確実な + ftp か http サーバ (たとえば, + あなたのホームページ)に置くこと ができます. + <makevar>MASTER_SITES</makevar> + に正しく反映されていることを確認してください.</para> + + <para>もしも, そのような都合の良く, + 安心な置き場所が見つけられない 場合(あなたが FreeBSD の + committer であれば, 自分の + <filename>public_html</filename> ディレクトリに置けます), + 私たちが, <!-- kuriyama - lack of tanslation --> + <filename> + ftp://ftp.FreeBSD.ORG/pub/FreeBSD/ports/distfiles/LOCAL_PORTS/ + </filename> に置き場所を提供できます. + この場所は, 変数 <makevar>MASTER_SITE_LOCAL</makevar> + を使って参照してください. + これについての問い合わせのメールは &a.ports へお願いします. + </para> + + <para>その port の配布ファイルが特に理由もなく, + しょっちゅう変る場合には, + 配布ファイルをあなたのホームページに置いて + <makevar>MASTER_SITES</makevar>の最初に入れてください. + こうすることによって, ユーザ利用する場合に + <errorname>checksum mismatch</errorname> + エラーが起るのを防ぎ, 我々の ftp + サイトの保守の負担を減らすことができます. もし, master + site がたった一つしかない場合には, + あなたのサイトにバックアップを置いて + <makevar>MASTER_SITES</makevar> + の2番目に加えてください.</para> + + <para>もし, + あなたのportに必要ないくつかの追加パッチがインター + ネット上で手に入るのならば, それらも取ってきて, + <makevar>DISTDIR</makevar> に置きます. もし, + それらがメイン + のソースのtarファイルとは別のサイトにあっても, + 心配する必要 はありません. + そのような状況にはちゃんと対応できるようになっ ています. + (以下の<link linkend="porting-patchfiles">PATCHFILESの記述 + </link>をご覧ください).</para> + </sect4> + + <sect4> + <title>Portの修正</title> + + <para>適当なディレクトリにtarファイルを展開して, + FreeBSDの最新の バージョン上で, + 正しくコンパイルできるために必要なあらゆる変 更を施します. + 最終的に処理は自動化するわけですから, 何をおこなっ + たかを<emphasis>注意深く記録しておきましょう</emphasis>. + あなたのport が完成した暁には, ファイルの削除, 追加, + 修正を含むすべての処 理が, + 自動化されたスクリプトやパッチファイルで + おこなえるようになっ ていないといけません.</para> + + <para>もし, あなたの port + のコンパイルやインストールのために必要 + な手作業があまりに多いようならば, Larry Wall の模範的な + <application>Configure</application> + スクリプトでも参考にしたほうがいいかもしれませ ん. + 新しいportsコレクションは, 最小のディスクスペースで, + 個々のportがエンドユーザにできるだけ“プラグ & + プレ + イ”の状態でmakeできることをめざしています.</para> + + <note> + <para>あなたが作成し FreeBSD の ports + に寄付されたパッチファイル, + スクリプトおよびその他のファイルは, + 明示的に記述されている場合 を除いては, + BSDの標準的な著作権条件によりカバーされていると見な + されます.</para> + </note> + </sect4> + + <sect4> + <title>パッチをあてる</title> + + <para>port + の過程で追加されたり変更されたファイルは再帰的diffで変 + 更点を取り出すことができます. パッチは適当にまとめて, + <filename>patch-<replaceable>xx</replaceable></filename> + という名前のファイルに入れてくだ さい. + <filename><replaceable>xx</replaceable></filename> + はパッチが適用される順番を示します — これらは, + <emphasis>アルファベット順</emphasis>, つまり + <literal>aa</literal> が 最初, つぎに + <literal>ab</literal> などとなります. これらのファイル + を<makevar>PATCHDIR</makevar>に置いておくと, + 自動的に適用さ れるようになっています. すべてのパッチは + <makevar>WRKSRC</makevar> (通常は, portのtarファイルが展 + 開されるところで, makeが実行されるところと同じです) + からの相 対パスになります. + 修正やアップグレードを容易にするため, 2つ + 以上のパッチが同じファイルを修正するのは避けてください. + (例, + patch-aaとpatch-abが共に<makevar>WRKSRC</makevar>/foobar.c + を修正する, など.)</para> + </sect4> + + <sect4> + <title>コンフィグレーション</title> + + <para>カスタマイズのために追加したいコマンドがあれば, + <filename>configure</filename> + という名前のスクリプトに入れて + <filename>scripts</filename> サブディレクトリに置きます. + 上で述べたよ うに, <filename>pre-configure</filename> + あるいは <filename>post-configure</filename> という + <filename>Makefile</filename> + のターゲットおよび/あるいはスクリプトで処理す + ることもできます.</para> + </sect4> + + <sect4> + <title>ユーザからの入力の扱い</title> + + <para>もし, そのportがビルド, コンフィグレーション, + インストー ルの際にユーザからの入力を必要とするならば, + Makefileで + <makevar>IS_INTERACTIVE</makevar>をセットしてください. + これによって, 深夜, + 自動的にたくさんのportをコンパイルすることが可能にな + ります. 環境変数<envar>BATCH</envar>がセットされていると + <symbol>IS_INTERACTIVE</symbol> + の定義されているportはスキップされ ます (そして, + ユーザが<envar>INTERACTIVE</envar>という変数をセッ + トすると入力を必要とする port + <emphasis>のみ</emphasis>コンパイルされま す).</para> + + <para>もし, 適切なデフォルト設定があるのであれば, + <makevar>PACKAGE_BUILDING</makevar> 変数をチェックして, + それが設定されて いる場合には, + ユーザ入力のスクリプトを起動しないように してください. + こうすることによって, CD-ROM や ftp に 置く package + を我々が作成することができます. + </para> + </sect4> + </sect3> + + <sect3> + <title>Makefileの作成</title> + + <para>Makefileの作成は非常に単純です. 繰り返しになりますが, + 始める まえに, すでにある例を見てみることをお奨めします. + またこのハ ンドブックには<link + linkend="porting-samplem">Makefileのお手本</link> + があります. それを見て, + Makefile内の変数の順番や空行を入れると + ころなどの参考にしてください. + そうすると他の人々にも読みやすい ものとなります.</para> + + <para>では, + Makefileをデザインするときに問題となるところを順に追っ + て見てみましょう.</para> + + <sect4> + <title>オリジナルのソース</title> + + <para>ソースは<makevar>DISTDIR</makevar>に, + 標準的なgzipされた tarファイルとして置かれていますか? + そうであれば, 次のステッ プに進めます. そうでなければ, + 変数 <makevar>EXTRACT_CMD</makevar>, + <makevar>EXTRACT_BEFORE_ARGS</makevar>, + <makevar>EXTRACT_AFTER_ARGS</makevar>, + <makevar>EXTRACT_SUFX</makevar>, + <makevar>DISTFILES</makevar> + を適当に書き換えないといけません. + どれだけ変更しないといけないかは, あなたのportの + 配布ファイルがどの程度標準からかけはなれているかによりま + す. (最もよくある場合は, + gzipではなく普通のcompressコマンド + でtarファイルが圧縮されている場合で, + <literal>EXTRACT_SUFX=.tar.Z</literal> + とするだけです.)</para> + + <para>最悪の場合には, 自分で + <maketarget>do-extract</maketarget> ターゲットを作 成して, + デフォルトを上書きすることもできます. しかし, そこま + でする必要があることはめったにないでしょう.</para> + </sect4> + + <sect4> + <title><makevar>DISTNAME</makevar></title> + + <para><makevar>DISTNAME</makevar> には port + の名前の基幹部分を入れ ます. デフォルトのルールでは, + 配布ファイルのリスト (<makevar>DISTFILES</makevar>) は + <makevar>DISTNAME</makevar> + <makevar>EXTRACT_SUFX</makevar> という名前 になっています. + 例えば, <literal>foozolix-1.0.tar.gz</literal>の場 合, + 通常のtarファイルだと, <literal> + DISTNAME=foozolix-1.0</literal> のようになります.</para> + + <para>さらにデフォルトのルールでは, tarファイルは + <filename>work/<makevar>DISTNAME</makevar></filename> + というサブディレクトリ に展開されることを仮定しています, + 例えば <filename>work/foozolix-1.0/</filename> + といった具合いです.</para> + + <para>これらの動作はもちろんすべて変更可能です. + デフォルトのルー + ルは最も標準的な場合を仮定しているだけです. まず, port + が複 数の配布ファイルを必要とするときには, 単に明示的に + <makevar>DISTFILES</makevar>を設定してください. もし, + <makevar>DISTFILES</makevar> + の一部だけが実際に展開される場合 には, + それらを<makevar>EXTRACT_ONLY</makevar> に設定してくだ + さい. この変数が定義されている場合には, 展開時に + <makevar>DISTFILES</makevar>に優先して利用されます. + 残りのファ + イルも<makevar>DISTDIR</makevar>に取ってきますが, 展開時に + はなにもせずに後で使うためにそのまま置いておかれます. + </para> + </sect4> + + <sect4> + <title><makevar>PKGNAME</makevar></title> + + <para>もし, <makevar>DISTNAME</makevar> が我々の <link + linkend="porting-pkgname"> package + の名前についてのガイドライン</link> + に沿ったものでない場合には, <makevar>PKGNAME</makevar> + にもっと良い名前を設定してください. + 詳細は上記のガイドラインを参照してください. + </para> + </sect4> + + <sect4> + <title><makevar>CATEGORIES</makevar> (分類)</title> + + <para>完成した package の実体は + <filename>/usr/ports/packages/All</filename> に置かれます. + また, 1つかそれ以上の + <filename>/usr/ports/packages</filename> + のサブディレクトリからのシンボリッ クリンクが作られます. + それらのサブディレクトリの名前が + <makevar>CATEGORIES</makevar> + という変数によって指定されます. これは, + ユーザがFTPサイトやCD-ROMのpackageの山を渡り歩 + くことを容易にするためです. 現在存在する <link + linkend="porting-categories">カテゴリ</link>を見て, そ + のportに適したもを選んでください.</para> + + <para>このリストは, この port が port tree のどこに import + されるかも決定します. 2つ以上のカテゴリを指定した場合には + 最初のカテゴリで指定されるサブディレクトリに置かれること + になります. 適切なカテゴリを選ぶ方法については, <link + linkend="porting-categories">カテゴリ</link> + の節を参照してください.</para> + + <para>もしその port + が本当に現在存在するすべてのものとは異なって いる場合には, + 新しいカテゴリ名を作ることもできます. その際には, &a.ports + 宛てに新しいカテゴリ名を提案する + メールを送ってください.</para> + + <para>カテゴリ名については, + なんのエラーチェックも行なわれません.ミスタイプがあっても + <command>make package</command> はなにも考えずに + 新しいディレクトリを作ってしまいますので, + 注意してください.</para> + </sect4> + + <sect4> + <title><makevar>MASTER_SITES</makevar></title> + + <para>オリジナルの配布ファイルを指し示す FTP または HTTP の + URL のディ レクトリ部分までを + <makevar>MASTER_SITES</makevar> に記録しま す. スラッシュ + (<filename>/</filename>) を最後につけることをお忘れなく. + 配布ファイルがシステム上に存在しないときに, + <command>make</command>マクロは <makevar>FETCH</makevar> + でこの変数に指定されたサイトから取っ てきます.</para> + + <para>複数の, + できれば異なる大陸のサイトをこのリストに入れておく + ことが推奨されています. これによって, + 広域ネットワークにトラ + ブルがあった場合でも成功する可能性が高くなります. + 私たちはさら に, 自動的に最も近いマスタサイトを検出して, + そこから取って + くるメカニズムの導入を計画しています.</para> + + <para>オリジナルのtar ファイルが, X-contrib, GNU, Perl CPAN, + TeX CTAN または Linux Sunsite + などの有名なアーカイブにある場合には, + <makevar>MASTER_SITE_XCONTRIB</makevar>, + <makevar>MASTER_SITE_GNU</makevar>, + <makevar>MASTER_SITE_PERL_CPAN</makevar>, + <makevar>MASTER_SITE_TEX_CTAN</makevar> および + <makevar>MASTER_SITE_SUNSITE</makevar> を利用することで, + 簡単にこれらのサイトを 指定することができます. あとは + <makevar>MASTER_SITE_SUBDIR</makevar> にアーカイ + ブ内でのパスを指定するだけです. 以下に例を示します.</para> + + <programlisting> +MASTER_SITES= ${MASTER_SITE_XCONTRIB} +MASTER_SITE_SUBDIR= applications</programlisting> + + <para>ユーザは<filename>/etc/make.conf</filename>中で + <makevar>MASTER_SITE_*</makevar> 変数を設定 + することによって, デフォルトの FTP サイトではなく, + これらの 有名なアーカイブの + ミラーの中で好みのものを使用することが可能 です.</para> + </sect4> + + <sect4 id="porting-patchfiles"> + <title><makevar>PATCHFILES</makevar></title> + + <para>もし, + オリジナルの配布ファイル以外にもFTPかHTTPで手に入る + パッチが必要な場合には, + <makevar>PATCHFILES</makevar>にファ イル名を, + <makevar>PATCH_SITES</makevar>にサイトとディレクト + リの名前を <makevar>MASTER_SITES</makevar> + と同様に設定してく ださい.</para> + + <para>そのパッチ内のファイル名ががソースツリーの + 一番上のディレク トリ (<makevar>WKRSRC</makevar>) + からの相対パスになっていな い場合には, + <makevar>PATCH_DIST_STRIP</makevar>を指定してく ださい. + 例えば, パッチ内のファイル名にすべて余計な + <literal>foozolix-1.0/</literal> がついている場合には, + <literal>PATCH_DIST_STRIP=-p1</literal>としてください.</para> + + <para>これらのパッチは圧縮されていても大丈夫です. + ファイル名が <filename>.gz</filename> か + <filename>.Z</filename> で終わる場合には自動的に復元 + されるようになっています.</para> + + <para>もしパッチが, 文書などその他のファイルと一緒に gzip + された tarファイルで配布されている場合には,単純に + <makevar>PATCHFILES</makevar> を使うことはできません. + このような場合には, このパッチの tar + ファイルの名前と場所を <makevar>DISTFILES</makevar> と + <makevar>MASTER_SITES</makevar> に加えます. それから, + <maketarget>pre-patch</maketarget> ターゲットで, + パッチコマンドを走らせるか, パッチファイルを + <makevar>PATCHDIR</makevar> ディレクトリに + <filename>patch-<replaceable>xx</replaceable></filename> + という名前でコピーするかして, + パッチを適用するようにします.</para> + + <note> + <para>普通の gzip か compress された tar ファイルであれば, + 通常のソースファイルと一緒にその時までに + 展開されていますので, 明示的に展開する必要はありません. + もし, 後者の方法を使用する場合には, + すでにそのディレクトリにある なにかを上書きしないように, + 注意する必要があります. さらに, + <maketarget>pre-clean</maketarget> + ターゲットにコピーしたパッチファイル + を削除するコマンドを追加するのを忘れないでください.</para> + </note> + </sect4> + + <sect4> + <title><makevar>MAINTAINER</makevar></title> + + <para>あなたのメールアドレスをここに入れてください. + お願いします. + <!-- smiley --><emphasis remap=tt>:)</emphasis></para> + + <para>保守担当者(maintainer)の責任についての詳細は, <link + linkend="policies-maintainer">Makefile 中の + MAINTAINER</link> の節をご覧ください.</para> + </sect4> + + <sect4> + <title>依存関係</title> + + <para>このプログラムが他のportに依存する場合には, + 必要なものが 自動的に作られるようにすることができます. + そのために, 以下の 5つの変数が用意されています. + よくあるケースのためにあらかじめ設定された依存変数や, + いくつかの依存関係の制御のための変数があります.</para> + + <sect5> + <title><makevar>LIB_DEPENDS</makevar></title> + + <para>Port が必要とする非標準の共有ライブラリを + この変数で指定 します. これは + <replaceable>lib</replaceable>: + <replaceable>dir</replaceable><optional><replaceable>: + target</replaceable></optional> という組のリストで, + うち <replaceable>lib</replaceable> + が共有ライブラリの名前, そして + <replaceable>dir</replaceable> + がそのライブラリが見つからない場合にインストールする + port のあるディレクトリで, + <replaceable>target</replaceable> + はそのディレクトリで呼ばれるターゲットです. 例えば, <!-- + kuriyama - should use programlisting? --> + <programlisting> LIB_DEPENDS= + jpeg.9:${PORTSDIR}/graphics/jpeg:install + </programlisting> と指定してあれば, + まずメジャーバージョンが9のjpegライブ + ラリがあるかどうか確認し, ない場合にはportsツリーの中の + <filename>graphics/jpeg</filename> + というサブディレクトリに移動し, そこ + でコンパイルとインストールを行ないます. + <replaceable>target</replaceable> の 部分は, + <makevar>DEPENDS_TARGET</makevar> (デフォルトは + <literal>install</literal>) + と等しいときには省略できます.</para> + + <note> + <para>前半の <replaceable>lib</replaceable> + 部分は <command>ldconfig -r | grep -wF</command> + への引数になります. + この変数には正規表現を入れられません. + </para> + </note> + + <para> + この依存関係は2度チェックされます. まず + <maketarget>extract</maketarget> ターゲットで, 次に + <maketarget>install</maketarget> でチェックされます. + (これは, その port を作成するマシンとインストールする + マシンが違う場合でも, きちんとそのライブラリが利用できる + ことを確認するためです.) また, 依存するもの名前は + package の中にも含まれますので, + ユーザのシステムに存在しなければ, + <command>pkg_add</command> が自動的にインストールします. + </para> + </sect5> + + <sect5> + <title><makevar>RUN_DEPENDS</makevar></title> + + <para>Port + を使用する際に必要となるファイルまたはプログラムがある + ときにはこの変数で指定します. これは + <replaceable>path</replaceable>: + <replaceable>dir</replaceable><optional><replaceable> + :target</replaceable></optional> とい + う組のリストで, <replaceable>path</replaceable> + がファイルまたはプログラムの 名前, そして + <replaceable>dir</replaceable> + がそれが見つからない場合に作成する + ためのディレクトリ名で <replaceable>target</replaceable> + はそのディレクトリで呼ばれるターゲットです. + <replaceable>path</replaceable> の最初の文字がスラッ + シュ (<literal>/</literal>) + の場合にはファイルかディレクトリ とみなし, その存在を + <command>test -e</command> でチェックします; + そうでない場合には 実行可能であると仮定し, + <command>which -s</command> を使って + そのプログラムがユーザのサーチパス上に + あるかどうか確認します.</para> + + <para>例えばMakefileに以下のように書いてあるとします.</para> + + <programlisting> +RUN_DEPENDS= ${PREFIX}/etc/innd:${PORTSDIR}/news/inn \ + wish8.0:${PORTSDIR}/x11-toolkits/tk80</programlisting> + + <para>まず, <filename>/usr/local/etc/innd</filename> + というファイルかディレクトリが存在 するか確認し, + ない場合にはportsツリーの中の + <filename>news/inn</filename> + というサブディレクトリから作られます. ま た, + <command>wish8.0</command> + というプログラムがユーザのサーチパス中 + にあるかどうか探し, ない場合には同じくportsツリーの + <filename>x11-toolkits/tk80</filename> + というサブディレクトリから作られます.</para> + + <note> + <para>この例で, <command>innd</command> + は実際にはプログラムです; この ように, + プログラムであっても標準のサーチパス以外のところに + あるようなものの場合には, + 絶対パスで指定してください.</para> + </note> + + <para>この依存関係は<maketarget>install</maketarget> + ステージのはじめでチェック されます. また, + packageを作る際に必要となるportのpackage名 が記録され, + <command>pkg_add</command>を使用すると + ユーザのシステムに存在しない場合には自動的にそちら + のpackageもインストールされるようになります. + <replaceable>target</replaceable> の部分は, + <makevar>DEPENdS_TARGET</makevar> + と同じ場合には省略可能です. + </para> + </sect5> + + <sect5> + <title><makevar>BUILD_DEPENDS</makevar></title> + + <para>Port + のコンパイルに必要なファイルまたはプログラムがある + ときは, この変数で指定してください. + <makevar>RUN_DEPENDS</makevar>と同 様に, これは + <replaceable>path</replaceable>: + <replaceable>dir</replaceable><optional><replaceable> + :target</replaceable></optional> + という組のリストです. 例 えば, <programlisting> + BUILD_DEPENDS= + unzip:${PORTSDIR}/archivers/unzip</programlisting> は + <command>unzip</command> という名前のプログラムを探し, + 見つから + ない場合には<filename>archivers/unzip</filename> + サブディレクトリで作 れという意味になります.</para> + + <note> + <para>ここでは “コンパイル” + と一口にいいましたが, この変数は実際 + にはファイルの展開から実際のコンパイル・リンクまで + 全部をま とめて面倒を見てくれます. + この依存関係は <maketarget>extract</maketarget> + ステージからチェックされます. + <replaceable>target</replaceable> の部分は + <makevar>DEPENDS_TARGET</makevar> + と同じ場合には省略可能です.</para> + </note> + </sect5> + + <sect5> + <title><makevar>FETCH_DEPENDS</makevar></title> + + <para>この変数は, + portを取ってくるのに必要なファイルまたはプロ + グラムを指定するのに使います. 上の二つと同様に, これは + <replaceable>path</replaceable>: + <replaceable>dir</replaceable><optional><replaceable> + :target</replaceable></optional> + <!-- kuriyama - should use programlisting? --> + という組のリストです. 例えば, <programlisting> + FETCH_DEPENDS= + ncftp2:${PORTSDIR}/net/ncftp2</programlisting> + としておけば, <command>ncftp2</command> + という名前のプログラムを探 し, + 見つからない場合には<filename>net/ncftp2</filename> + サブディレク トリにいってインストールします.</para> + + <para>この依存関係は <maketarget>fetch</maketarget> + ステージからチェックされます. + <replaceable>target</replaceable> の部分は + <makevar>DEPENDS_TARGET</makevar> + と同じ場合には省略可能です.</para> + </sect5> + + <sect5> + <title><makevar>DEPENDS</makevar></title> + + <para>上記の四つのいずれにもあてはまらないような + 依存関係がある場 合, または他の port + がインストールされれているだけではなく, + ソースが展開されている必要がある場合にはこの変数 + を使います. これは + <replaceable>dir</replaceable><optional><replaceable> + :target</replaceable></optional> という形式のリスト + になります. 上記の四つと違って特に + “確認”するものがありませんので.</para> + </sect5> + + <sect5> + <title>よくある依存関係を表す変数</title> + + <para>もし ports が X Window System + を必要とするのであれば, <literal>USE_XLIB=yes</literal> + を定義してください. (これは + <makevar>USE_IMAKE</makevar>も意味します) BSD + <command>make</command> の代りに GNU + <command>make</command> を必要とする場合には, + <literal>USE_GMAKE=yes</literal> を定義. 動作するのに + GNU autoconf を必要とする場合には, + <literal>USE_AUTOCONF=yes</literal> を定義. 最新の qt + toolkit を使用 する場合には + <literal>USE_QT=yes</literal> を定義. perl + 言語のバージョン5 を必要とする場合には, + <literal>USE_PERL5=yes</literal> を定義してください. + (特に最後のは重要で, FreeBSD のいくつかの + バージョンでは基本システムに perl5 を含みますが, + 他のものは含んでいません.)</para> + </sect5> + + <sect5> + <title>依存関係に関する注意</title> + + <para>上で述べたように, 依存する ports + が必要になったときに呼ばれるデフォルトのターゲットは + <maketarget>DEPENDS_TARGET</maketarget> で, + そのデフォルトは <literal>install</literal> です. + これは, ユーザの使用する変数で, port の + <filename>Makefile</filename> + で定義されるものではありません. もし, + あなたのportが特別な方法で, 依存関係を扱う必要が + ある場合には, <makevar>DEPENDS_TARGET</makevar> + を再定義するのではなく, <makevar>*_DEPENDS</makevar> + 変数の <literal>:target</literal> + の部分を利用してください. </para> + + <para><command>make clean</command> とタイプしたときには, + 依存する port も自動的に clean されます. + もしそうしたくない場合には, + <makevar>NOCLEANDEPENDS</makevar> + を環境変数として設定してください.</para> + + <para>無条件に他の port に依存させるには, 特別に + <literal>nonexistent</literal> という文字列を + <makevar>BUILD_DEPENDS</makevar> あるいは + <makevar>RUN_DEPENDS</makevar> + の最初のフィールドに使用してください. これは, 他の port + のソースが必要なときのみ使用してください. target + も指定することによって, + コンパイルの時間を節約することができます. 例えば, <!-- + kuriyama - should use programlisting? --> + <programlisting> BUILD_DEPENDS= + /nonexistent:${PORTSDIR}/graphics/jpeg:extract + </programlisting> これは, 常に JPEG port の directory + に行きソースの展開を行ないます.</para> + + <para>あなたがやりたいことが他の方法ではできない場合以外は, + <makevar>DEPENDS</makevar> を使わないでください. これは常に + 他の port の作成を行い(さらにデフォルトでインストール + を行い), package も作成します. もし本当にこれがあなたの + やりたいことでしたら, 代りにこれを + <literal>BUILD_DEPENDS</literal> と + <literal>RUN_DEPENDS</literal> で書くことをお勧めします + — 少なくとも意図が明確になります.</para> + </sect5> + </sect4> + + <sect4> + <title>コンパイル時の特別な指定</title> + + <para>GNUの<command>make</command>を使う場合には, + <literal>USE_GMAKE=yes</literal> と指定してください. Port + に GNU の <command>configure</command> が含まれ + ている場合には, <literal>GNU_CONFIGURE=yes</literal> + を使います(これは, <literal>HAS_CONFIGURE</literal> + も意味します). <command>configure</command> に追加の引数 + (デフォルトでは, GNU の <command>configure</command> では + <literal>--prefix=${PREFIX}</literal>, GNUでない + <command>configure</command> では空) + を渡したい場合には追加部分を + <makevar>CONFIGURE_ARGS</makevar> で指定してください. + そのパッケージが <command>autoconf</command> + を使用する場合には, <literal>USE_AUTOCONF=yes</literal> + を使います. これは, <makevar>GNU_CONFIGURE</makevar> + も意味し, <command>configure</command> の前に + <command>autoconf</command> を実行します. + </para> + + <para>X Window Systemのアプリケーションなど, + <command>imake</command>を 使って + <filename>Imakefile</filename> から + <filename>Makefile</filename> を作成するportの場合には + <literal>USE_IMAKE=yes</literal> を指定してください. + コンフィグレー ションステージで自動的に<command>xmkmf + -a</command> が実行されます. も し <option>-a</option> + フラグが問題をもたらすなら, さらに + <literal>XMKMF=xmkmf</literal>としてください.</para> + + <para>もし, port が <command>imake</command> + を使用するけれども, <maketarget>install.man</maketarget> + ターゲットがない場合には, + <literal>NO_INSTALL_MANPAGES=yes</literal> + を指定してください. ついでに, その port + のオリジナルの作者を探し出して八つ裂きにすると + いいでしょう.<!-- smiley + --><emphasis>:></emphasis></para> + + <para>Portの <filename>Makefile</filename> が + <maketarget>all</maketarget> 以外のものをメインのター + ゲットとしている場合には, <makevar>ALL_TARGET</makevar> + でそ れを指定してください. + <maketarget>install</maketarget> と + <makevar>INSTALL_TARGET</makevar> も同様です.</para> + + <para>もし, port の元の Makefile が + <maketarget>all</maketarget> + 以外のターゲットをメインのターゲットとしている場合には, + <makevar>ALL_TARGET</makevar> + をそれに合わせて設定してください. + <maketarget>install</maketarget> と + <makevar>INSTALL_TARGET</makevar> + についても同様です.</para> + <!-- kuriyama - duplicated? --> + </sect4> + + <!-- kuriyama - needs review order --> + <sect4> + <title><makevar>NO_INSTALL_MANPAGES</makevar></title> + + <para>あなたの port が<command>imake</command>は使うものの + <filename>install.man</filename> + ターゲットを持っていない場合, + <literal>NO_INSTALL_MANPAGES=yes</literal> + を指定してください. つい でに, + 作者を探し出して八つ裂きにするといいでしょ う. <!-- smiley + --><emphasis>(-_-#)</emphasis></para> + </sect4> + </sect3> + + <sect3> + <title>特別な配慮</title> + + <para>Portを作成する場合, + 考慮しなくてはいけないことがさらにいくつかあります. + この節では, + それらのうちもっともありがちなものについて説明します.</para> + + <sect4> + <title>ldconfig</title> + + <para>共有ライブラリをインストールするときには, + 共有ライブラリのキャッシュを更新するために port の + <filename>Makefile</filename> の + <maketarget>post-install</maketarget>target + から<literal>${LDCONFIG} -m</literal> + を走らせてください. + このコマンドの引数は共有ライブラリのインストールしてある + ディレクトリ (通常 + <filename><makevar>PREFIX</makevar>/lib</filename>) + です.</para> + + <para>また, <filename>pkg/PLIST</filename> に <literal>@exec + /sbin/ldconfig -m</literal> と <literal>@unexec + /sbin/ldconfig -R</literal> の組を入れて, package + をインストールした場合にも共有ライブラリがすぐ使え, + 削除の際にも, システムがまだライブラリが存在すると + 誤認しないようにしてください. + この行は共有ライブラリを指定する行のすぐ後に + 書くのがよいでしょう:</para> + + <programlisting> +lib/libtvl80.so.1 +@exec /sbin/ldconfig -m %D/lib +@unexec /sbin/ldconfig -R</programlisting> + + <para><emphasis>絶対に</emphasis>引数なしでただ + <literal>ldconfig</literal> とだけ書いてある行を + <filename>Makefile</filename> や + <filename>pkg/PLIST</filename> + ファイルに入れないでください. このコマンドを実行すると, + 共有ライブラリのキャッシュが <filename>/usr/lib</filename> + の内容のみとなり, + ユーザのマシンにさまざまな問題をもたらします (「ぎゃぁ! + このportをインストールしたら xinit + が使えなくなっちゃった!」). この掟を破った者は, + 永久に地獄の底で苦しみ続けるように, + 閻魔様に頼んでおきます.</para> + </sect4> + </sect3> + + <sect3> + <title>ELF 対応</title> + + <para>FreeBSD は 3.0-RELEASE で ELF に移行しましたので, + シェアードライブラリを作成するたくさんの port を ELF 対応 + にする必要があります. 3.0 システムは ELF としても a.out + としてmも 動作しますし, 我々は非公式ではありますが, + できるだけ長い間 2.2 + システムのサポートをしたいと思っていますので, + 複雑な状況です. 以下は a.out のみに対応している port + をどのように a.out と ELF 両方に対応させるかのガイドライ + ンです.</para> + + <para>このリストの一部は, + 移行時にしかあてはまらないものもありますが, 古い port + をアップグレードしたい場合に参考になるように, + しばらくのあいだは残しておきます.</para> + + <sect4> + <title>a.out ライブラリの退避</title> + + <para>a.out ライブラリは, + <filename>/usr/local/lib</filename> から, + <filename>aout</filename> サブディレクトリ + に移動しなくはなりません. (もし移動しないと, ELF ports + がそれらをあっさり上書きして しまいます.) 3.0-CURRENT の + <filename>src/Makefile</filename> にある + <maketarget>move-aout-libs</maketarget> ターゲット + (<maketarget>aout-to-elf</maketarget> から呼ばれます) + がその移動をしてくれます. a.out + ライブラリを移動するだけなので, ELF と a.out + の両方のライブラリが標準的な + ディレクトリにあるシステムでは, + このターゲットを実行しても安全です.</para> + </sect4> + + <sect4> + <title>フォーマット</title> + + <para>port ツリーは package + をそのマシンのフォーマットで作成します. つまり, 2.2 では + a.out, また 3.0 では <command>`objformat`</command> + の結果によって, a.out か ELF になります. また, いったん + a.out ライブラリをサブディレクトリに移動すると a.out + ライブラリの作成はサポートされません. (つまり, + あなたがにをすれば良いのかを理解しているのならば, + うまく作成できるかもしれませんが, + 自力でやらなければならないということです)</para> + + <note> + <para>もし port が aout でしか動作しないのなら, + <makevar>BROKEN_ELF</makevar> + に原因を説明する文字列を設定してください. + この変数が設定された port は, ELF + システム上でのビルドの際スキップされます.</para> + </note> + </sect4> + + <sect4> + <title>PORTOBJFORMAT</title> + + <para><filename>bsd.port.mk</filename> において + <makevar>PORTOBJFORMAT</makevar> は + <literal>aout</literal> か <literal>elf</literal> + に設定され, 環境変数 <envar>CONFIGURE_ENV</envar>, + <envar>SCRIPTS_ENV</envar>, <envar>MAKE_ENV</envar> の中で + export されます. (2.2-STABLE では常に + <literal>aout</literal> になります). また, + <literal>PORTOBJFORMAT=${PORTOBJFORMAT}</literal> として + <maketarget>PLIST_SUB</maketarget> に渡されます. + (以下にある <literal>ldconfig</literal> + に関するコメントを参照して下さい.)</para> + + <para>この変数は, 以下のようにして + <filename>bsd.port.mk</filename> 中で設定されます.</para> + + <programlisting> +PORTOBJFORMAT!= test -x /usr/bin/objformat && /usr/bin/objformat || echo aout</programlisting> + + <para>この変数を使って, port の make + の過程で何をすべきかを決定すべきですが, もし port の + <filename>configure</filename> スクリプトが元々, ELF + システムを自動的に検出するのであれば, + <makevar>PORTOBJFORMAT</makevar> + を参照する必要はありません.</para> + </sect4> + + <sect4> + <title>共有ライブラリの作成</title> + + <para>以下は, a.out と ELF + での共有ライブラリの扱いの違いです.</para> + + <itemizedlist> + <listitem> + <para>共有ライブラリのバージョン</para> + + <para>ELF の共有ライブラリは, <filename> + libfoo.so.<replaceable>M</replaceable> </filename> + という名前になっていなければなりません. ここで + <replaceable>M</replaceable> は単一の + バージョン番号を表します. 一方 a.out のライブラリは + <filename> libfoo.so.<replaceable>M</replaceable>. + <replaceable>N</replaceable></filename> + という名前で, <replaceable>M</replaceable> + はメジャーバージョン番号, <replaceable>N</replaceable> + はマイナーバージョン番号になっている必要があります. + これらを混同しないでください. <filename> + libfoo.so.<replaceable>N</replaceable>. + <replaceable>M</replaceable></filename> + という名のELF 共有ライブラリや <filename> + libfoo.so.<replaceable>N</replaceable></filename> + という名の a.out 共有ライブラリ + (あるいはシンボリックリンク) は + <emphasis>絶対にinstallしないでください</emphasis>.</para> + </listitem> + + <listitem> + <para>リンカコマンドライン</para> + + <para>直接 <command>ld</command> を使用せずに, + <command>cc -shared</command> を使用してください. + たった一つの違いは, ELF には, <option> + -Wl,-<replaceable>soname,libfoo.so.M</replaceable> + </option> + コマンドラインにを加える必要があることです.</para> + <!-- kuriyama - strange Japanese representation --> + </listitem> + </itemizedlist> + + <para>ELF のリンカを満足させるためには, + <filename>libfoo.so</filename> から <filename> + libfoo.so.<replaceable>N</replaceable></filename> + へのシンボリックリンクを作る必要があります. これは, + <filename>PLIST</filename> にも加えなくては いけませんし, + a.out の場合でも害にはならないので (一部の port + ではダイナミックリンクローディングのために + 必要でもあります), <makevar>PORTOBJFORMAT</makevar> + の設定を気にせずに, + ただ単純にリンクを作成してください.</para> + </sect4> + + <sect4> + <title><makevar>LIB_DEPENDS</makevar></title> + + <para>すべての port の Makefile を編集して, + <makevar>LIB_DEPENDS</makevar> + からマイナー番号を除去する必要があり, + 正規表現のサポートも除去する必要があります. (例えば, + <literal>foo\\.1\\.\\(33|40\\)</literal> から + <literal>foo.2</literal>) マッチングは <command>grep + -wF</command> を使って行われます.</para> + </sect4> + + <sect4> + <title><filename>PLIST</filename></title> + + <para><filename>PLIST</filename> は, a.out + のマイナー番号が0であれば, 短い (ELFの) + 共有ライブラリの名前を含み, さもなくば長い (a.outの) + 名前を含んでいる必要があります. + <filename>bsd.port.mk</filename> は 自動的に, + <makevar>PORTOBJFORMAT</makevar> が + <literal>aout</literal> であれば, <literal>.0</literal> を + 短い共有ライブラリの名前の行に付け加え, + <makevar>PORTOBJFORMAT</makevar> が <literal>elf</literal> + であれば, マイナー番号を + 長い共有ライブラリの名前から削除します.</para> + + <para>ELF システムで 2 + つのバージョン番号を持つ共有ライブラリを + インストールしたり, aout システムで 1 + つのバージョン番号しか持たない共有ライブラリを + インストールするのが避けられない場合 + (例えば他のオペレーティングシステム用の + 互換ライブラリをインストールする port など), + <makevar>NO_FILTER_SHLIBS</makevar> 変数を定義すれば, + 前節で説明されている <filename>PLIST</filename> + 編集の機能が停止されます.</para> + </sect4> + + <sect4> + <title><literal>ldconfig</literal></title> + + <!-- kuriyama - Eng. why literal? --> + <para>Makefile 中の <literal>ldconfig</literal> + の行は以下のようになります.</para> + + <programlisting> +${SETENV} OBJFORMAT=${PORTOBJFORMAT} ${LDCONFIG} -m ....</programlisting> + + <para>また <filename>PLIST</filename> 中では:</para> + + <programlisting> +@exec /usr/bin/env OBJFORMAT=%%PORTOBJFORMAT%% /sbin/ldconfig -m ... +@unexec /usr/bin/env OBJFORMAT=%%PORTOBJFORMAT%% /sbin/ldconfig -R</programlisting> + + <para>となります. これは, + システムのデフォルトフォーマットではなく + パッケージのフォーマットに応じて, 正しい + <command>ldconfig</command> + が呼ばれることを保証するためのものです.</para> + </sect4> + </sect3> + + <sect3 id="porting-masterdir"> + <title><makevar>MASTERDIR</makevar></title> + + <para>もし, あなたの port が 変数(例えば + 解像度とか紙のサイズなど)を変えたりした, + ちょっと違うバージョンを作成する必要があるときには, + ユーザが分りやすいように, package + ごとに別々のサブディレクトリを作成し, ただし, できるだけ + port 間でファイルを共有するようにしてください. + 典型的な例では, うまく変数を使えば, + とても短い<filename>Makefile</filename>だけ, + 1つ以外のすべてのディレクトリに置くだけで済みます. その短い + <filename>Makefile</filename> には + <makevar>MASTERDIR</makevar> を使って, + 残りのファイルがあるディレクトリを指定できます. また <link + linkend="porting-pkgname"><makevar>PKGNAME</makevar> + </link> の一部に変数に使って, package + が別々の名前を持つようにしてください.</para> + + <para>以下が, とても良い例になるでしょう. これは + <filename>japanese/xdvi300/Makefile</filename> + の一部です:</para> + + <programlisting> +PKGNAME= ja-xdvi${RESOLUTION}-17 + : +# default +RESOLUTION?= 300 +.if ${RESOLUTION} != 118 && ${RESOLUTION} != 240 && \ + ${RESOLUTION} != 300 && ${RESOLUTION} != 400 + @${ECHO} "Error: invalid value for RESOLUTION: \"${RESOLUTION}\"" + @${ECHO} "Possible values are: 118, 240, 300 (default) and 400." + @${FALSE} +.endif</programlisting> + + <para><filename>japanese/xdvi300</filename> は通常のパッチ, + package ファイルももっています. そこで, + <command>make</command> と入力すると, + デフォルトの解像度(300)を使って, 普通に port + の作成を行います.</para> + + <para>他の解像度に関してですが, これが, + <filename>xdvi118/Makefile</filename> の(コメントを除いた) + <emphasis>すべて</emphasis>です.</para> + + <programlisting> +RESOLUTION= 118 +MASTERDIR= ${.CURDIR}/../xdvi300 + +.include ${MASTERDIR}/Makefile</programlisting> + + <para>(<filename>xdvi240/Makefile</filename> と + <filename>xdvi400/Makefile</filename> も同様です). + <makevar>MASTERDIR</makevar> が + <filename>bsd.port.mk</filename> に + <makevar>PATCHDIR</makevar> や <makevar>PKGDIR</makevar> + などの通常のサブディレクトリが <filename>xdvi300</filename> + にあることを教えます. <literal>RESOLUTION=118</literal> + の行が, <filename>xdvi300/Makefile</filename> の + <literal>RESOLUTION=300</literal> の行を無効にし, port + は解像度を118として作成されます.</para> + </sect3> + + <sect3> + <title>共有ライブラリのバージョン</title> + + <para>まず, <link linkend="policies-shlib"> + 共有ライブラリのバージョンについての指針</link> を読んで, + 共有ライブラリのバージョンを + 一般的にどうすれば良いかを理解してください. 盲目的に, + ソフトウエアの作者がちゃんと理解していると + 信じててはいけません, 多くの場合違います. + 細い点まで考慮することは大変重要なことです, + なぜなら我々は互換性がないかもしれない大量の + ソフトウェアを共存させようとする, 特殊な状況にあるからです. + 不注意な port の導入が共有ライブラリに関して, + 多大な問題を引き起したことが過去にあります (今まで, + <filename>jpeg-6b</filename> がなぜ 9.0 + といバージョン番号を持っているか不思議に + 思ったことはありませんか?). もし, 疑問があれば, &a.ports; + にメールを送ってください. ほとんどの時間は, + 正しいシェアードライブラリのバージョンを決めることと, + それを実現するためのパッチを作成することに終始します.</para> + + <para>しかしながら, が同じソフトウェアの違ったバージョンの + ソフトウェアが既にツリーにあるばあいには, + 状況は非常に複雑です. <!-- kuriyama - strange translation? + --> つまり, FreeBSD では, + ユーザがリンカにどのバージョンの共有ライブラリを + 使用するかを指定できないからです + (リンカは常にもっとも高いバージョンを選びます). これは, + もし, <filename>libfoo.so.3.2</filename> と + <filename>libfoo.so.4.0</filename> + がシステムに存在するときには, + リンカに特別なアプリケーションだけ + <filename>libfoo.so.3.2</filename> + をリンクするように指示する方法がないことを意味します. + これは, + コンパイル時のリンクという意味では完全に見劣りします. + この場合の唯一の解決方法は, 共有ファイルの名前の + <emphasis>ベース</emphasis> 部分を変えることです. 例えば, + <filename>libfoo.so.4.0</filename> を + <filename>libfoo4.so.1.0</filename> へ変えることによって, + バージョン 3.2 とバージョン 4.0 共に他の port + からリンクされることができるようになります.</para> + </sect3> + + <sect3 id="porting-manpages"> + <title>マニュアル</title> + + <para><makevar>MAN[1-9LN]</makevar> 変数を使用すると, + 自動的にすべてのマニュアルを <filename>pkg/PLIST</filename> + に加えます (つまり, マニュアルを <filename>PLIST</filename> + に加えては <emphasis>いけません</emphasis> — <link + linkend="porting-plist">PLIST の生成</link> + を参照してください). またマニュアルを + <filename>/etc/make.conf</filename> 中の + <makevar>NOMANCOMPRESS</makevar> の設定に応じて, + install時に自動的に圧縮したり伸長したりします.</para> + + <para>マニュアルをインストール時に圧縮するかどうかを + 指定するには, <makevar>MANCOMPRESSED</makevar> + 変数を使用します. この変数は, 3つの値をとることができます, + <literal>yes</literal>, <literal>no</literal> そして + <literal>maybe</literal> です. <literal>yes</literal> + はマニュアルが既に圧縮されて インストールされている, + <literal>no</literal> はされていない, + <literal>maybe</literal> はそのソフトウェアがすでに, + <makevar>NOMANCOMPRESS</makevar> に合わせており + <filename>bsd.port.mk</filename> + が特別なにもする必要がないことを意味します.</para> + + <para><makevar>USE_IMAKE</makevar> がセットされていて, + <makevar>NO_INSTALL_MANPAGES</makevar> + がセットされていなければ, <makevar>MANCOMPRESSED</makevar> + は自動的に <literal>yes</literal> に設定され, + それ以外の場合には, <literal>no</literal> になります. + デフォルトがあなたの port + に合わない場合以外は明示的に設定する必要がありません.</para> + + <para><makevar>PREFIX</makevar> 以外のディレクトリの下に + マニュアルを置くような port では + <makevar>MANPREFIX</makevar> を指定することができます. + さらに, 特定のセクションのマニュアルだけ, + 標準ではない場所にインストールする場合, 例えばいくつかの + Perl のモジュールの ports など, には個々のマニュアルのパスを + <makevar>MAN<replaceable>sect</replaceable>PREFIX</makevar> + (<replaceable>sect</replaceable> は, <literal>1-9</literal>, + または, <literal>L</literal> か <literal>N</literal> + を表わします) によって指定できます. ができます.</para> + <!-- kuriyama - strange representation --> + + <para>マニュアルが, 言語特有のサブディレクトリに + 置かれる場合には, 言語名を <makevar>MANLANG</makevar> + に設定してください. この変数のデフォルト値は, + <literal>""</literal> になっています (つまり, 英語のみ). + </para> + + <para>これは, 全部をまとめた例です.</para> + + <programlisting> +MAN1= foo.1 +MAN3= bar.3 +MAN4= baz.4 +MANLANG= "" ja +MAN3PREFIX= ${PREFIX}/share/foobar +MANCOMPRESSED= yes</programlisting> + + <para>以下の6個のファイルがこの port でインストールされます. + </para> + + <programlisting> +${PREFIX}/man/man1/foo.1.gz +${PREFIX}/man/ja/man1/foo.1.gz +${PREFIX}/share/foobar/man/man3/bar.3.gz +${PREFIX}/share/foobar/man/ja/man3/bar.3.gz +${PREFIX}/man/man4/baz.4.gz +${PREFIX}/man/ja/man4/baz.4.gz</programlisting> + </sect3> + + <sect3> + <title>Motifを必要とするport</title> + + <para>最近はコンパイルに Motif + を必要とするアプリケーションが増えて きました. + (Motif自体は有料のものがいくつかの会社から手に入りま すし, + 多くのアプリケーションがコンパイル可能な無料の互換ライブラリ + が <filename>x11-toolkits/lesstif</filename>にあります) + Motifはかなり広く使われていますし, 製品のライ + センスではライブラリを静的にリンクした + 実行形式は再配布が認めら れている場合が多いので, + Motifを必要とするソフトウェアを簡単に 動的(port + からコンパイルする人々のために)/静的(package を配布 + する人々のために)にリンクできるような + しくみが用意されています.</para> + + <sect4> + <title><makevar>REQUIRES_MOTIF</makevar></title> + + <para>Motif + がないとコンパイルできないportのMakefileではこの変 + 数を指定してください. これによって, + Motifを持っていない人が + このportをコンパイルしようとするのを未然に防ぎます.</para> + </sect4> + + <sect4> + <title><makevar>MOTIFLIB</makevar></title> + + <para>この変数は <filename>bsd.port.mk</filename> によって + Motif ライブラリの指 定に置き換えられます. + ソース内のMakefileやImakefileで Motif + ライブラリを指定しているところをこの変数に置き換えるよ + うにパッチをあててください.</para> + + <para>代表的な例としては以下の二つがあげられます:</para> + + <orderedlist> + <listitem> + <para>MakefileかImakefileの中でMotifライブラリが + <option>-lXm</option> として使われている場合には, + かわりに <makevar>MOTIFLIB</makevar> + と書いてください.</para> + </listitem> + + <listitem> + <para>Imakefileの中で <literal>XmClientLibs</literal> + が使われている 場合には, それを + <literal>${MOTIFLIB} ${XTOOLLIB} + ${XLIB}</literal> と書きかえてください.</para> + </listitem> + </orderedlist> + + <note> + <para><makevar>MOTIFLIB</makevar> は通常 + <literal>-L/usr/X11R6/lib -lXm</literal> か + <literal>/usr/X11R6/lib/libXm.a</literal> に置き換えら + れます. したがって前に <option>-L</option> や + <option>-l</option> をつけ る必要はありません.</para> + </note> + </sect4> + </sect3> + + <sect3> + <title>X11 のフォント</title> + + <para>もし, あなたの port が X window system + のフォントをインストールするのであれば, それらを <filename> + <makevar>X11BASE</makevar>/lib/X11/fonts/local</filename> + に置くようにしてください. このディレクトリは XFree86 release + 3.3.3 で新設されたものです. もし, + それが存在しなければ作成し, ユーザに XFree86 を 3.3.3 + かそれより新しいものに更新か, すくなくとも, + このディレクトリを <filename>/etc/XF86Config</filename> の + font path + に加えるように促すメッセージを出力するようにしてください. + </para> + </sect3> + + <sect3> + <title>Info ファイル</title> + + <para>新しい版の texinfo(2.2.2-RELEASE + およびそれ以降に入っています) には, + <command>install-info</command> + というコマンドが含まれており, <filename>dir</filename> + ファイルに項目を追加したり, 削除したりすることがで きます. + もし, あなたの port が info ドキュメントをインストー + ルするのであれば, 以下の指示に従って, その port および + package が正しく, ユーザの + <filename>${PREFIX}/info/dir</filename> ファイル + を更新するようにしてください. (この節は, + とても長くてすいません, しかし info + ファイルを作りあげるためには, これらは不可欠 です. + 正しく行なえば, <emphasis>美しい</emphasis> + リストができますので, 辛抱してください! <!-- smiley + --><emphasis>:)</emphasis></para> + + <para>まず, これを知っておかなければなりません:</para> + + <screen>&prompt.user; <userinput>install-info --help</userinput> +install-info [OPTION]... [INFO-FILE [DIR-FILE]] + Install INFO-FILE in the Info directory file DIR-FILE. + (訳注: Info ディレクトリの INO-FILE を DIR-FILE にインストールする) +Options: +--delete Delete existing entries in INFO-FILE; + don't insert any new entries. + (訳注: INFO-FILE の中の項目を削除, + 新しい項目は一切追加しない.) + : +--entry=TEXT Insert TEXT as an Info directory entry. + (訳注: TEXT を Info ディレクトリの項目として追加する.) + : +--section=SEC Put this file's entries in section SEC of the directory. + (訳注: このファイルの項目を Info ディレクトリの SEC + という節に置く.) + :</screen> + + <note> + <para>このプログラムは, 実際には info + ファイルを<emphasis>インストール</emphasis> しません, 単に + <filename>dir</filename> + ファイルにエントリーを挿入したり削除し + たりするだけです.</para> + </note> + + <para>これから, <command>install-info</command> + を使用するように, ports を変換す る7段階の工程を示します. + 例として <filename>editors/emacs</filename>を + 使用します.</para> + + <procedure> + <step> + <para>まず, texinfo のソースを見て, + <literal>@dircategory</literal> と + <literal>@direntry</literal> 文がないファイルについて, + それらを追加するパッチを作成します. 以下は, + ここでの例での patchの一部です:</para> + + <programlisting> +--- ./man/vip.texi.org Fri Jun 16 15:31:11 1995 ++++ ./man/vip.texi Tue May 20 01:28:33 1997 +@@ -2,6 +2,10 @@ + + @setfilename ../info/vip + @settitle VIP ++@dircategory The Emacs editor and associated tools ++@direntry ++* VIP: (vip). A VI-emulation for Emacs. ++@end direntry + + @iftex + @finalout + :</programlisting> + + <para>フォーマットについては見ればわかると思います. + <filename>dir</filename> + というファイルに必要な項目を書いておいてくれる作者 + も多いので, まず自分で書く前にさがしてみてください. + また, 関係 する ports も調べて, 節(section)の名前や, + インデントなどが + きちんと合っているかどうかを確認してください + (項目のテキスト は, すべて4つめのタブ・ストップ(tab + stop)から始めることを推 奨します).</para> + + <note> + <para>1つのファイルに対して1つの info + の項目しか書けないことに注 意してください, これは, + <command>install-info --delete</command> <!-- kuriyama + - not email --> が, そのバグにより, + <email>@direntry</email> セクションに複数の項目を書 + いても, + 初めの1つの項目しか削除してくれないからです.</para> + </note> + + <para>texinfo のソースにパッチをあてるかわりに, + <literal>dir</literal> の項目 を + <command>install-info</command> の + 引数((<option>--section</option>, + <option>--entry</option>) として与えることもできます. + これはあまり良い方法とは 思えません, なぜなら, + 同じ情報を3ヶ所(<filename>Makefile</filename>, + <filename>PLIST</filename> の + <literal>@exec</literal>/<literal>@unexec</literal>: + 以下参照) に重複して, 書く必要があるからです. + しかしながら, もし日本語(あるいは, + 他のマルチバイト文字)の info ファイルがあるのならば, + <command>install-info</command> + の特別な引数を使用する必要があるでしょう, なぜならば, + <command>makeinfo</command> がこのような texinfo + ソースファイル を扱えないからです. + (このようなものをどう扱うかの例としては, + <filename>japanese/skk</filename> の + <filename>Makefile</filename> と + <filename>PLIST</filename> を見て ください.)</para> + </step> + + <step> + <para>portのディレクトリに戻って, <command>make clean; + make</command> をして, info ファイルが texinfo + ソースファイルから再び生成さ れることを確認してください. + texinfo ソースファイルのほうが info + ファイルよりも新しいので, <command>make</command> + とタイプすれば, info ファイルは再構築されるはずですが, + 多くの <filename>Makefile</filename> には info + ファイルの正しい依存関係が書かれていません. + <command>emacs</command> の場合, info + ファイルの再構築ため, <filename>man</filename> + サブディレクトリ に降りていくようにするために, メインの + <filename>Makefile.in</filename> にパッ + チをあてる必要がありました.</para> + + <programlisting> +--- ./Makefile.in.org Mon Aug 19 21:12:19 1996 ++++ ./Makefile.in Tue Apr 15 00:15:28 1997 +@@ -184,7 +184,7 @@ + # Subdirectories to make recursively. `lisp' is not included + # because the compiled lisp files are part of the distribution + # and you cannot remake them without installing Emacs first. +-SUBDIR = lib-src src ++SUBDIR = lib-src src man + + # The makefiles of the directories in $SUBDIR. + SUBDIR_MAKEFILES = lib-src/Makefile man/Makefile src/Makefile oldXMenu/Makefile lwlib/Makefile +--- ./man/Makefile.in.org Thu Jun 27 15:27:19 1996 ++++ ./man/Makefile.in Tue Apr 15 00:29:52 1997 +@@ -66,6 +66,7 @@ + ${srcdir}/gnu1.texi \ + ${srcdir}/glossary.texi + ++all: info + info: $(INFO_TARGETS) + + dvi: $(DVI_TARGETS)</programlisting> + + <para><filename>man</filename> + サブディレクトリでのデフォルトターゲットは, + <maketarget>info</maketarget> で呼ばれるのに対して, + メインの <filename>Makefile</filename> では, + <maketarget>all</maketarget> で呼びたいので, + 2つめのpatchが必要でした. また, + <filename>info</filename> info + ファイルのインストールも削除しました, なぜなら, + 同じものが同じ名前で既に + <filename>/usr/share/info</filename> にあるからです. + (このパッチはここにはありません.)</para> + </step> + + <step> + <para>もし, <filename>Makefile</filename> に + <filename>dir</filename> ファイルをインストールす + る個所があれば, 削除します. あなたの port がインストー + ルしてはいけません. また, <filename>dir</filename> + ファイルを壊してしまうよう + なコマンドの類も削除します.</para> + + <programlisting> +--- ./Makefile.in.org Mon Aug 19 21:12:19 1996 ++++ ./Makefile.in Mon Apr 14 23:38:07 1997 +@@ -368,14 +368,8 @@ + if [ `(cd ${srcdir}/info && /bin/pwd)` != `(cd ${infodir} && /bin/pwd)` ]; \ + then \ + (cd ${infodir}; \ +- if [ -f dir ]; then \ +- if [ ! -f dir.old ]; then mv -f dir dir.old; \ +- else mv -f dir dir.bak; fi; \ +- fi; \ + cd ${srcdir}/info ; \ +- (cd $${thisdir}; ${INSTALL_DATA} ${srcdir}/info/dir ${infodir}/dir); \ +- (cd $${thisdir}; chmod a+r ${infodir}/dir); \ + for f in ccmode* cl* dired-x* ediff* emacs* forms* gnus* info* message* mh-e* sc* vip*; do \ + (cd $${thisdir}; \ + ${INSTALL_DATA} ${srcdir}/info/$$f ${infodir}/$$f; \ + chmod a+r ${infodir}/$$f); \</programlisting> + </step> + + <step> + <para>(これは, 既存のportを修正するときのみ必要です.) + <filename>pkg/PLIST</filename> を見て, + <filename>info/dir</filename> にパッチをあて + ようとするものすべてを削除します. これらは, + <filename>pkg/INSTALL</filename> + やその他のファイルにもあるかもしれない ので, + いろいろさがしてみてください.</para> + + <programlisting> +Index: pkg/PLIST +=================================================================== +RCS file: /usr/cvs/ports/editors/emacs/pkg/PLIST,v +retrieving revision 1.15 +diff -u -r1.15 PLIST +--- PLIST 1997/03/04 08:04:00 1.15 ++++ PLIST 1997/04/15 06:32:12 +@@ -15,9 +15,6 @@ + man/man1/emacs.1.gz + man/man1/etags.1.gz + man/man1/ctags.1.gz +-@unexec cp %D/info/dir %D/info/dir.bak +-info/dir +-@unexec cp %D/info/dir.bak %D/info/dir + info/cl + info/cl-1 + info/cl-2</programlisting> + </step> + + <step> + <para><maketarget>post-install</maketarget> ターゲットを + <filename>Makefile</filename> に加えて, + <filename>dir</filename> + ファイルが存在しなければ作成するようにします. また, + インストールされた info ファイルについては, + <maketarget>install-info</maketarget> + を実行するようします.</para> + + <programlisting> +Index: Makefile +=================================================================== +RCS file: /usr/cvs/ports/editors/emacs/Makefile,v +retrieving revision 1.26 +diff -u -r1.26 Makefile +--- Makefile 1996/11/19 13:14:40 1.26 ++++ Makefile 1997/05/20 10:25:09 1.28 +@@ -20,5 +20,11 @@ + post-install: + .for file in emacs-19.34 emacsclient etags ctags b2m + strip ${PREFIX}/bin/${file} + .endfor ++ if [ ! -f ${PREFIX}/info/dir ]; then \ ++ ${SED} -ne '1,/Menu:/p' /usr/share/info/dir > ${PREFIX}/info/dir; \ ++ fi ++.for info in emacs vip viper forms gnus mh-e cl sc dired-x ediff ccmode ++ install-info ${PREFIX}/info/${info} ${PREFIX}/info/dir ++.endfor + + .include <bsd.port.mk></programlisting> + + <para>新しい info ファイルを作成するのに, + <filename>/usr/share/info/dir</filename> と上のコマンド, + 以外は使用しな いでください. 実際のところ, もし port + する人がこれに関して <filename>PLIST</filename> + に自らまったく手を加える必要がないのであれば, 上 + のパッチのはじめの3行を <filename>bsd.port.mk</filename> + に加えたでしょう.</para> + </step> + + <step> + <para><filename>PLIST</filename> を編集して, + 同じ働きをする <literal>@exec</literal> 文, そ + れに<command>pkg_delete</command> のために + <literal>@unexec</literal> 文を加えてくださ い. + <literal>@unexec</literal> を使用して + <filename>info/dir</filename> を削除する必 + 要はありません.</para> + + <programlisting> +Index: pkg/PLIST +=================================================================== +RCS file: /usr/cvs/ports/editors/emacs/pkg/PLIST,v +retrieving revision 1.15 +diff -u -r1.15 PLIST +--- PLIST 1997/03/04 08:04:00 1.15 ++++ PLIST 1997/05/20 10:25:12 1.17 +@@ -16,7 +14,15 @@ + man/man1/etags.1.gz + man/man1/ctags.1.gz ++@unexec install-info --delete %D/info/emacs %D/info/dir + : ++@unexec install-info --delete %D/info/ccmode %D/info/dir + info/cl + info/cl-1 +@@ -87,6 +94,18 @@ + info/viper-3 + info/viper-4 ++@exec [ -f %D/info/dir ] || sed -ne '1,/Menu:/p' /usr/share/info/dir > %D/info/dir ++@exec install-info %D/info/emacs %D/info/dir + : ++@exec install-info %D/info/ccmode %D/info/dir + libexec/emacs/19.34/i386--freebsd/cvtmail + libexec/emacs/19.34/i386--freebsd/digest-doc</programlisting> + + <note> + <para><literal>@unexec install-info --delete</literal> + コマンドは, info ファイル自身より先に置き, + コマンドがファイルを読めるようにし + ておかなければならないことに注意してください. また, + <literal>@exec install-info</literal> コマンドは info + ファイルおよび <filename>dir</filename> ファイルを作る + <literal>@exec</literal> コマンドより後に + おかなければなりません.</para> + </note> + </step> + + <step> + <para><link linkend="porting-testing">テスト</link> + をして出来栄えに感服しましょう <!-- smiley + --><emphasis>:)</emphasis> 各段階の前後に, + <filename>dir</filename> + ファイルをチェックしましょう.</para> + </step> + </procedure> + </sect3> + + <sect3> + <title><filename>pkg/</filename> サブディレクトリ</title> + + <para>まだ触れていない, いくつかのこつが + <filename>pkg/</filename> サブディレクトリにはあり, + 時として便利でしょう.</para> + + <sect4 id="porting-message"> + <title><filename>MESSAGE</filename></title> + + <para>もし, インストールする人にメッセージを表示する + 必要がある場合には, そのメッセージを + <filename>pkg/MESSAGE</filename> に置けます. この機能は, + <command>pkg_add</command> + の後の追加のインストール手続きを表示するときなどに, + 重宝します.</para> + + <note> + <para> + <filename>pkg/MESSAGE</filename> ファイルは + <filename>pkg/PLIST</filename> に加える必要はありません. + また, もしユーザが package ではなく port を使用して + いる場合には自動的には表示されませんので, 明示的に + <maketarget>post-install</maketarget> + で表示するようにするべきでしょう.</para> + </note> + </sect4> + + <sect4> + <title><filename>INSTALL</filename></title> + + <para>バイナリパッケージが <command>pkg_add</command> + でインストールされるときに, 実行される必要がある + コマンドがあれば, <filename>pkg/INSTALL</filename> + スクリプトを使って実行することができます. + このスクリプトは自動的に package に加えられ, + <command>pkg_add</command> によって2度実行されます. + はじめは <literal>INSTALL ${PKGNAME} + PRE-INSTALL</literal> と実行され, 2度目には, + <literal>INSTALL ${PKGNAME} POST-INSTALL</literal> + と実行されます. どちらのモードで実行されているかは, + <literal>$2</literal> + を調べることによってわかります. 環境変数 + <envar>PKG_PREFIX</envar> には package + がインストールされるディレクトリが設定されます. 詳細は + &man.pkg.add.1; を見てください.</para> + + <note> + <para> + port を <command>make install</command> で + インストールするときには, + このスクリプトは自動的に実行されません. もし, + 実行される必要があるならば, port の Makefile + から明示的に呼ぶ必要があります. + </para> + </note> + </sect4> + + <sect4> + <title><filename>REQ</filename></title> + + <para>port が(インストールされるシステムの状態によって) + インストールされるべきか, されないべきか区別する必要が + あるときには, “要件(requirements)” スクリプト + <filename>pkg/REQ</filename> を作ることができます. これは, + インストール及びデインストール (package + の削除)の時に自動的に実行され, + それらが処理されるべきかを決定します.</para> + </sect4> + + <sect4 id="porting-plist"> + <title>make の変数にあわせた <filename>PLIST</filename> + の変更</title> + + <para>いくつかの port, 特に p5- portsなど, は configure + のオプション (あるいは, p5- ports の場合は perl + のバージョン)によって, <filename>PLIST</filename> + を変える必要があります. これを容易に実現するために, + <filename>PLIST</filename> 中の + <literal>%%OSREL%%</literal>, + <literal>%%PERL_VER%%</literal>, + <literal>%%PERL_VERSION%%</literal> は, + 適切に置き換えられるようになっています. + <literal>%%OSREL%%</literal> の値は, + オペレーティングシステムの数字で表されたリビジョンです + (例えば, <literal>2.2.7</literal>). + <literal>%%PERL_VERSION%%</literal> は perl + のバージョン番号全体(例えば, <literal>5.00502</literal> + )で, <literal>%%PERL_VER%%</literal> はバージョン番号から, + パッチレベルを引いてものです(例えば, + <literal>5.005</literal>).</para> + + <para>他の置き換えが必要であれば, + <makevar>PLIST_SUB</makevar> 変数に <literal> + <replaceable> VAR</replaceable>=<replaceable>VALUE + </replaceable></literal> + という形式のペアのリストを設定することによって, + <filename>PLIST</filename> 中の + <literal>%%<replaceable>VAR</replaceable>%%</literal> は + <replaceable>VALUE</replaceable> に置き換えられます. + 例えば, バージョンに固有の沢山のファイルを + インストールする場合には, <filename>Makefile</filename> + に</para> + <!-- kuriyama - Eng ver has unneeded quote above --> + + <programlisting> +OCTAVE_VERSION= 2.0.13 +PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION}</programlisting> + + <para>と書いて, <filename>PLIST</filename> + 中のバージョン番号が表われるすべてのところに, + <literal>%%OCTAVE_VERSION%%</literal> と書きます. + このようにしておけば, port をアップグレードするときに, + 何十行(ときとして, 何百行)も <filename>PLIST</filename> + を書き替えないですみます.</para> + + <para>この書き換えは (<link linkend="porting-manpages"> + マニュアル</link> の追加も) + <maketarget>do-install</maketarget> と + <maketarget>post-install</maketarget> ターゲット + のあいだに, <makevar>PLIST</makevar> を読み + <makevar>TMPPLIST</makevar> (デフォルトは, <filename> + <makevar>WRKDIR</makevar>/.PLIST.mktmp</filename> ) + に書き込むことによって行なわれます. もし, あなたの port が + <makevar>PLIST</makevar> を実行時に生成するのであれば, + <maketarget>do-install</maketarget> のあいだか, + その前に行うようにしてください. また, + 書きかえられたあとのファイルを編集する必要がある場合には, + <maketarget>post-install</maketarget> で, + <makevar>TMPPLIST</makevar> を書きかえてください.</para> + </sect4> + + <sect4> + <title id="porting-pkgsubdir"><filename>pkg</filename> + サブディレクトリにあるファイル名の変更</title> + + <para><filename>pkg</filename> + サブディレクトリにあるファイルは全て, 変数を + 使用して定義されていますので, 必要であれば + <filename>Makefile</filename> 中で 変更可能です. + いくつかの ports で 一つの <filename>pkg</filename> + サブディレクトリを共有する場合や, 上記のファイルに書き込む + 必要があるときなど, 特に便利です. + (<filename>pkg</filename> + サブディレクトリに直接書き込むのが良くない理由に ついては + <link linkend="porting-wrkdir">WRKDIR + 以外への書きこみ</link> を参照してください.)</para> + + <para>以下が変数名とそのデフォルト値の表です.</para> + + <informaltable frame="none"> + <tgroup cols="2"> + <thead> + <row> + <entry>Variable</entry> + <entry>Default value</entry> + </row> + </thead> + + <tbody> + <row> + <entry><makevar>COMMENT</makevar></entry> + <entry><literal>${PKGDIR}/DESCR</literal></entry> + </row> + + <row> + <entry><makevar>DESCR</makevar></entry> + <entry><literal>${PKGDIR}/DESCR</literal></entry> + </row> + + <row> + <entry><makevar>PLIST</makevar></entry> + <entry><literal>${PKGDIR}/PLIST</literal></entry> + </row> + + <row> + <entry><makevar>PKGINSTALL</makevar></entry> + <entry><literal>${PKGDIR}/PKGINSTALL</literal></entry> + </row> + + <row> + <entry><makevar>PKGDEINSTALL</makevar></entry> + <entry><literal>${PKGDIR}/PKGDEINSTALL</literal></entry> + </row> + + <row> + <entry><makevar>PKGREQ</makevar></entry> + <entry><literal>${PKGDIR}/REQ</literal></entry> + </row> + + <row> + <entry><makevar>PKGMESSAGE</makevar></entry> + <entry><literal>${PKGDIR}/MESSAGE</literal></entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para><makevar>PKG_ARGS</makevar>を上書きせずに, + これらの変数を変更 するようにしてください. + <makevar>PKG_ARGS</makevar>を変更すると これらのファイルは + port から正しく <filename>/var/db/pkg</filename> + にインストールされなくなります.</para> + </sect4> + </sect3> + + <sect3> + <title>ライセンス上の問題</title> + + <para>ソフトウェアによっては制限の厳しい + ライセンスがついてきたり, 法律的に問題があるかもしれません. + (PKPの公開鍵暗号化, ITAR (暗 号化ソフトウェアの輸出) + などが例としてあげられます). それらを + どう扱えばいいかはライセンスの文面によって + さまざまな場合があり ます.</para> + + <note> + <para>ソフトウェア移植者として, + あなたにはライセンスをよく読み, FreeBSD プロジェクトが FTP + または CD-ROM で配布してはいけないソフ + トウェアを配布してしまうことのないよう, + 注意する義務があります. なにか疑問がある場合には, + &a.ports;に聞いてみてください.</para> + </note> + + <para>よく見られるケースに対処するために, + 二つの変数が用意されてい ます:</para> + + <orderedlist> + <listitem> + <para>ソフトウェアに “有償再配布を禁ずる” + という趣旨のライセン スがついてきた場合には + <makevar>NO_CDROM</makevar> + という変数にその理由を記述して ください. + 私たちはこれがついているportはCD-ROMリリースに入 + れないようにしますが, + オリジナルのソースファイルとpackage + はFTPでは取れるようにしておきます.</para> + </listitem> + + <listitem> + <para>もしも, 生成される package + が個々のサイトで独自に構築さ れる必要があったり, + ライセンスによって生成されるバイナリが + 配布できない場合には, <makevar>NO_PACKAGE</makevar> + 変数にその理由を記述してくだ さい. そのような package が + FTP サイトに置かれたり, リリース 時の CD-ROM + へ入らないようにします. ただし, いずれの場合も distfile + は(FTP や CD-ROM に)含まれるようになります.</para> + </listitem> + + <listitem> + <para>Portが, 使用者によっては法律上の問題が生じる時 + (暗号化ソフ トウェアなど), + または“商用利用を禁ずる”とライセンスに書い + てある場合には + <makevar>RESTRICTED</makevar>という変数にその理由を入れ + てください. この場合には, + ソースファイルやpackageは私たちの + FTPサイトにも置かれません.</para> + </listitem> + </orderedlist> + + <note> + <para>GNU一般公有使用許諾書 (GPL) はバージョン1, 2とも + port作成上は何ら問題にはなりません.</para> + </note> + + <note> + <para>もしあなたが,ソースツリー管理者 (committer) + であれば, ソースツリーにこのようなportを入れる際に, + <filename>ports/LEGAL</filename> + ファイルを書き換えるのを忘れないようにし + てください.</para> + </note> + </sect3> + + <sect3> + <title>アップグレード</title> + + <para>Port + のバージョンが原作者からのものに比べて古いことに気がつ + いたら, まずはあなたの持っているportが私たちの最新のもの + (ミラー サイトの <filename>ports/ports-current</filename> + というディレクトリにあります) + であることを確認してください.</para> + + <para>次に, portの <filename>Makefile</filename> + に<makevar>MAINTAINER</makevar> (保守担当者) の + アドレスが書いてある場合には, + その人にメールを出してみましょう. + 保守担当者の人がすでにアップグレードの準備を + しているかもしれま せんし, + (新しいバージョンの安定度に問題があるなど) あえてアッ + プグレードをしない理由があるのかもしれません.</para> + + <para>保守担当者にアップグレードをしてくれと頼まれた場合, + あるいは + そもそもportのMakefileに保守担当者が書いてない場合などは, あ + なたがアップグレードをしてくださると助かります. + その場合にはアッ プグレードをしたのち, + 変更前と変更後のディレクトリの再帰的diff (unified diff と + context diff のどちらでもいいのですが, port のコミッター達は + unified diff のほうを好むようです) をとって送ってください. + (例えば, 変更前のディレクトリが + <filename>superedit.bak</filename> という名前でとってあり, + 変更後のもの が <filename>superedit</filename> + に入っているなら, <command>diff -ruN superedit.bak + superedit</command> の結果を送ってください. ) diff + の出力を見て, すべての変更が正しくなされているか確認して + ください. 変更箇所については, &man.send-pr.1; (カテゴリーは, + <literal>ports</literal>)に diff の出力結果を添えて, + 私たちに送ってもらうのが一 番よいです. commit する際に CVS + に明確に記述しなければならない ので, + 付け加えたり削除したりしたファイルがあったら, それについ + て書いておいてください. もし diff の大きさが 20 KB 程度を + 超えるようであれば, 圧縮したものを uuencode して下さい. + そうでなければそのまま PR に入れるだけでいいです.</para> + + <para>繰り返しになりますが, ports の変更を送るときには, + &man.shar.1; ではなく &man.diff.1; + を使用してください.</para> + </sect3> + + <sect3 id="porting-dads"><!-- kuriyama - why Eng ver has anchor tag? --> + <title>やっていいことといけないこと</title> + + <para>この節では, + ソフトウェアをportする上でよくある落し穴などにつ + いて説明します. このリストを使って, あなた自身が作成した + port のチェックはもとより, PR データベースにある, + 他の人が作成した port のチェックもできます. + あなたがチェックした port について のコメントを <link + linkend="contrib-general">バグ報告と一般的な論評</link> + にしたがって, 送ってください. PR データベースにある port を + チェックすることによって, 私達がそれらを commit + するのを早くし, + あなたが何をしているか理解していることも示します.</para> + + <sect4> + <title>バイナリのstrip</title> + + <para>バイナリは strip してください. + オリジナルのソースがバイナリを strip + してくれる場合は良いですが, そうでない場合には + <literal>post-install</literal> ターゲットを指定して strip + するようにするとよいでしょう. 例えば, + こんな風になります:</para> + + <programlisting> +post-install: + strip ${PREFIX}/bin/xdl</programlisting> + + <para>インストールされた実行形式がすでに strip + されているかどうかは <command>file</command> + コマンドで確認できます. これが`not + stripped'と言わなければ, + stripされているということです.</para> + </sect4> + + <sect4> + <title><makevar>INSTALL_*</makevar> マクロ</title> + + <para>あなた自身の *-install + ターゲットでファイルの正しいモードと + オーナを保証するために, + 必ず<filename>bsd.port.mk</filename>で提供されて + いるマクロを使用してください. + マクロは以下のようなものがあります.</para> + + <itemizedlist> + <listitem> + <para><makevar>${INSTALL_PROGRAM}</makevar> + は実行可能なバイナリを + インストールするコマンドです.</para> + </listitem> + + <listitem> + <para><makevar>${INSTALL_SCRIPT}</makevar> + は実行可能なスクリプトを + インストールするコマンドです.</para> + </listitem> + + <listitem> + <para><makevar>${INSTALL_DATA}</makevar> + は共有可能なデータを + インストールするコマンドです.</para> + </listitem> + + <listitem> + <para><makevar>${INSTALL_MAN}</makevar> + はマニュアルとその他のドキュメ + ントをインストールするコマンドです. + (圧縮はしません)</para> + </listitem> + </itemizedlist> + + <para>これらは基本的に <command>install</command> + コマンドに適当なフラグを与え たものです. + どのようにこれらを使用するかは以下の例を見てください. + </para> + </sect4> + + <sect4 id="porting-wrkdir"> + <title><makevar>WRKDIR</makevar></title> + + <para><makevar>WKRDIR</makevar> + の外のファイルにはなにも書き込まないように <!-- kuriyama - + to files? --> してください. <makevar>WRKDIR</makevar> は + ports のビルド中に書き込こめる + ことが保証されている唯一の場所です(<link + linkend="ports-cd"> CDROM から ports + をコンパイル</link>を参照). <makevar>PKGDIR</makevar> + にあるファイルを修正する必要がある ときには, <link + linkend="porting-pkgsubdir">変数の再定義</link> + によって行ない, 上書きはしないでください.</para> + </sect4> + + <sect4> + <title><makevar>WRKDIRPREFIX</makevar></title> + + <para><makevar>WRKDIRPREFIX</makevar> + を尊重していることを確認してください. 特に, 別の port の + <makevar>WRKDIR</makevar> を参照している + ときには気を付けてください. 正しい場所は, + <filename><makevar> WRKDIRPREFIX</makevar> + <makevar>PORTSDIR</makevar> + /<replaceable>subdir</replaceable>/ + <replaceable>name</replaceable>/work</filename>, です, + <filename><makevar> + PORTSDIR</makevar>/<replaceable>subdir</replaceable>/ + <replaceable>name</replaceable>/work</filename> とか + <filename><makevar> + .CURDIR</makevar>/../../<replaceable>subdir + </replaceable>/<replaceable>name</replaceable>/work + </filename> とかではありません.</para> + + <para>また, 自分で <makevar>WRKDIR</makevar> + 定義するときには, 頭に + <literal>${WRKDIRPREFIX}${.CURDIR}</literal> + が付いている 事を確認してください.</para> + </sect4> + + <sect4 id="porting-versions"> + <title>OS や OS のバージョンの区別</title> + + <para>Port の過程で, 修正や, どのバージョンの UNIX + で動くかによる条件つきコンパイルなどが + 必要なコードに出会うかもしれません. + そのような条件つきコンパイルなどのための + 変更をおこなうときには, FreeBSD 1.x システムへの移植や, + CSRGの4.4BSD, BSD/386, 386BSD, NetBSD, OpenBSD + などの他のBSDシステムへの移植が可能なように, + できるだけ普遍的な変更をおこなうことを + 心がけてください.</para> + + <para>4.3BSD/Reno (1990) およびそれより新しい BSD + 版を古いバージョンと区別するには <literal>BSD</literal> + マクロを利用するのがよいでしょう. これは + <filename><sys/param.h></filename> + で定義されています. + このファイルがすでにインクルードされていればよいのですが, + もしそうでない場合には以下のコードを, その + <filename>.c</filename> + ファイルの適当な場所に加えてください.</para> + + <programlisting> +#if (defined(__unix__) || defined(unix)) && !defined(USG) +#include <sys/param.h> +#endif</programlisting> + + <para>これらの 2 + つのシンボルが定義されているすべてのシステムには + <filename>sys/param.h</filename> があるはずです. もし, + そうでないシステムを発見したら我々にも教えてください. + &a.ports; までメールを送ってください.</para> + + <para>あるいは, GNU の Autoconf + のスタイルを使用することもできます,</para> + + <programlisting> +#ifdef HAVE_SYS_PARAM_H +#include <sys/param.h> +#endif</programlisting> + + <para>この方法を使用するときには, + <filename>Makefile</filename> 中の + <makevar>CFLAGS</makevar>に + <literal>-DHAVE_SYS_PARAM_H</literal> + を加えることを忘れないようにしてください.</para> + + <para>いったん <filename>sys/param.h</filename> + がインクルードされると,</para> + + <programlisting> +#if (defined(BSD) && (BSD >= 199103))</programlisting> + + <para>このようにしてそのコードが 4.3 Net2 コードベース, + またはそれより新しいもの (例: FreeBSD 1.x, 4.3/Reno, + NetBSD 0.9, 386BSD, BSD/386 1.1とそれ以前) + の上でコンパイルされているかを検出できます.</para> + + <programlisting> +#if (defined(BSD) && (BSD >= 199306))</programlisting> + + <para>これは, 4.4コードベース, またはそれより新しいもの (例: + FreeBSD 2.x, 4.4, NetBSD 1.0, BSD/386 2.0とそれ以後) + の上でコンパイルされているかどうかを + 検出するために使用します.</para> + + <para>4.4BSD-Lite2 コードベースでは, <literal>BSD</literal> + マクロの値は <literal>199506</literal> になっています. + これは参考程度の意味合いしかありません. 4.4-Lite ベースの + FreeBSD と 4.4-Lite2 での変更がマージされたバージョンとを + 区別するのに使用するべきものではありません. + この目的のためには, <literal>__FreeBSD__</literal> + マクロをかわりに使用してください.</para> + + <para>以下は控え目に使ってください.</para> + + <itemizedlist> + <listitem> + <para><literal>__FreeBSD__</literal> + はFreeBSDのすべての版で定義されています. 変更が + FreeBSD + だけに適用されるとき以外は使用しないでください. + Portでよくある, <function>strerror()</function> + ではなく <literal>sys_errlist[]</literal> + を使うなどは, FreeBSDでの変更ではなく, BSD + の流儀です.</para> + </listitem> + + <listitem> + <para>FreeBSD 2.xでは <literal>__FreeBSD__</literal> が + <literal>2</literal> と定義されています. + それ以前の版では <literal>1</literal> になっています. + その後の版では, + そのメジャー番号に合うように上がっていきます.</para> + </listitem> + + <listitem> + <para>もし, FreeBSD 1.x システムと FreeBSD 2.x あるいは + FreeBSD 3.x システムを区別する必要があれば, 上で述べた + <literal>BSD</literal>マクロを使用するのが, + 大抵の場合において正しい答です. もし, + FreeBSD特有の変更であれば (<command>ld</command> + を使うときのシェアードライブラリ用のなオプションなど), + <!-- kuriyama - strange translation --> + <literal>__FreeBSD__</literal>を使い <literal>#if + __FreeBSD__ > 1</literal> のようにFreeBSD 2.x + および, それ以降のシステムを検出するのはかまいません. + もし, + 2.0-RELEASE以降のFreeBSDシステムを細かく検出したけれ + ば, 以下を使用することができます.</para> + + <programlisting> +#if __FreeBSD__ >= 2 +#include <osreldate.h> +# if __FreeBSD_version >= 199504 + /* 2.0.5+ release specific code here */ +# endif +#endif</programlisting> + + <informaltable frame="none"> + <tgroup cols="2"> + <thead> + <row> + <entry>Release</entry> + <entry><literal>_FreeBSD_version</literal></entry> + </row> + </thead> + + <tbody> + <row> + <entry>2.0-RELEASE</entry> + <entry>119411</entry> + </row> + + <row> + <entry>2.1-CURRENT's</entry> + <entry>199501, 199503</entry> + </row> + + <row> + <entry>2.0.5-RELEASE</entry> + <entry>199504</entry> + </row> + + <row> + <entry>2.1 以前の 2.2-CURRENT</entry> + <entry>199508</entry> + </row> + + <row> + <entry>2.1.0-RELEASE</entry> + <entry>199511</entry> + </row> + + <row> + <entry>2.1.5 以前の 2.2-CURRENT</entry> + <entry>199512</entry> + </row> + + <row> + <entry>2.1.5-RELEASE</entry> + <entry>199607</entry> + </row> + + <row> + <entry>2.1.6 以前の 2.2-CURRENT</entry> + <entry>199608</entry> + </row> + + <row> + <entry>2.1.6-RELEASE</entry> + <entry>199612</entry> + </row> + + <row> + <entry>2.1.7-RELEASE</entry> + <entry>199612</entry> + </row> + + <row> + <entry>2.2-RELEASE</entry> + <entry>220000</entry> + </row> + + <row> + <entry>2.2.1-RELEASE</entry> + <entry>220000 (2.2-RELEASE と同じです)</entry> + </row> + + <row> + <entry>2.2.1-RELEASE 以後の 2.2-STABLE</entry> + <entry>220000 (これも同じです)</entry> + </row> + + <row> + <entry>texinfo-3.9 以後の 2.2-STABLE</entry> + <entry>221001</entry> + </row> + + <row> + <entry>top 導入以後の 2.2-STABLE</entry> + <entry>221002</entry> + </row> + + <row> + <entry>2.2.2-RELEASE</entry> + <entry>222000</entry> + </row> + + <row> + <entry>2.2.2-RELEASE 以後の 2.2-STABLE</entry> + <entry>222001</entry> + </row> + + <row> + <entry>2.2.5-RELEASE</entry> + <entry>225000</entry> + </row> + + <row> + <entry>2.2.5-RELEASE 以後の 2.2-STABLE</entry> + <entry>225001</entry> + </row> + + <row> + <entry>ldconfig -R 以後の 2.2-STABLE</entry> + <entry>225002</entry> + </row> + + <row> + <entry>2.2.6-RELEASE</entry> + <entry>226000</entry> + </row> + + <row> + <entry>2.2.7-RELEASE</entry> + <entry>227000</entry> + </row> + + <row> + <entry>2.2.7-RELEASE 以後の 2.2-STABLE</entry> + <entry>227001</entry> + </row> + + <row> + <entry>semctl(2) 変更後の 2.2-STABLE</entry> + <entry>227002</entry> + </row> + + <row> + <entry>2.2.8-RELEASE</entry> + <entry>228000</entry> + </row> + + <row> + <entry>2.2.8-RELEASE 以後の 2.2-STABLE</entry> + <entry>228001</entry> + </row> + + <row> + <entry>mount(2) 変更以前の 3.0-CURRENT</entry> + <entry>300000</entry> + </row> + + <row> + <entry>mount(2) 変更以後の 3.0-CURRENT</entry> + <entry>300001</entry> + </row> + + <row> + <entry>semctl(2) 変更以後の 3.0-CURRENT</entry> + <entry>300002</entry> + </row> + + <row> + <entry>ioctl 引数変更後の 3.0-CURRENT</entry> + <entry>300003</entry> + </row> + + <row> + <entry>ELF 移行後の 3.0-CURRENT</entry> + <entry>300004</entry> + </row> + + <row> + <entry>3.0-RELEASE</entry> + <entry>300005</entry> + </row> + + <row> + <entry>3.0-RELEASE 以後の 3.0-CURRENT</entry> + <entry>300006</entry> + </row> + + <row> + <entry>3/4 の分岐後の 3.0-STABLE</entry> + <entry>300007</entry> + </row> + + <row> + <entry>3.1-RELEASE</entry> + <entry>310000</entry> + </row> + + <row> + <entry>3.1-RELEASE 以後の 3.1-STABLE</entry> + <entry>310001</entry> + </row> + + <row> + <entry>3/4 の分岐後の 4.0-CURRENT</entry> + <entry>400000</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </listitem> + </itemizedlist> + + <note> + <para>(2.2-STABLE は, 2.2.5-RELESE 以後, + “2.2.5-STABLE” と呼ばれることがあります.) + 見ての通り, + これは年・月というフォーマットになっていましたが, + バージョン 2.2 から, + より直接的にメジャー/マイナー番号を使う + ように変更になりました. + 並行していくつかのブランチ(枝分かれし + たバージョン)を開発する場合には, + リリースされた日付でそれらの + リリースを分類することが不可能だからです. (あなたが今 + port を作成するときに, 古い -CURRENT 達について心配 + する必要はありません. + これは参考のために挙げられているにすぎま せん.)</para> + </note> + + <para>これまで, 何百ものportが作られてきましたが, + <literal>__FreeBSD__</literal> が正しく使われたのは, + 1つか2つの場合だけでしょう. + 以前のportが誤った場所でそのマクロを使っているからと + いって, それをまねする理由はありません.</para> + </sect4> + + <sect4> + <title><filename>bsd.port.mk</filename> の後に書くこと</title> + + <para><literal>.include <bsd.port.mk></literal> + の行の後には なにも書かないようにしてください. + 大抵の場合は <filename>Makefile</filename> の + 中程のどこかで, <filename>bsd.port.pre.mk</filename> を + include して, 最後に <filename>bsd.port.pre.mk</filename> + を include することによって避けることができます.</para> + + <note> + <para><filename> + pre.mk</filename>/<filename>post.mk</filename> + のペアか <filename>bsd.port.mk</filename> + だけのどちらかだけを include してください. + 2つを混ぜないでください.</para> + </note> + + <para>前者は, いくつかの変数の定義だけ をして, + <filename>Makefile</filename> でのテストに使用し, + 後者は残りを定義します.</para> + + <para> + 以下は <filename>bsd.port.pre.mk</filename> + で定義される重要な変数です. (これは, すべてではありません. + 完全なリストは <filename>bsd.port.mk</filename> + を参照してください.) + </para> + + <informaltable frame="none"> + <tgroup cols="2"> + <thead> + <row> + <entry>変数名</entry> + <entry>解説</entry> + </row> + </thead> + + <tbody> + <row> + <entry><makevar>ARCH</makevar></entry> + <entry><command>uname -m</command> で返される + アーキテクチャ. (例, <literal>i386</literal>). + </entry> + </row> + + <row> + <entry><makevar>OPSYS</makevar></entry> + <entry><command>uname -s</command> で返される + オペレーティングシステム (例, + <literal>FreeBSD</literal>).</entry> + </row> + + <row> + <entry><makevar>OSREL</makevar></entry> + <entry>オペレーティングシステムの + リリースバージョン + (例., <literal>2.1.5</literal>, + <literal>2.2.7</literal>).</entry> + </row> + + <row> + <entry><makevar>OSVERSION</makevar></entry> + <entry>数字形式のオペレーティングシステム + のバージョン, + 上記の <link linkend="porting-versions"><literal> + __FreeBSD_version</literal></link> + と同じです.</entry> + </row> + + <row> + <entry><makevar>PORTOBJFORMAT</makevar></entry> + <entry>システムのオブジェクト + フォーマット (<literal>aout</literal> あるいは + <literal>elf</literal>).</entry> + </row> + + <row> + <entry><makevar>LOCALBASE</makevar></entry> + <entry>“local” ツリーのベース. + (例, <literal>/usr/local/</literal>). + </entry> + </row> + + <row> + <entry><makevar>X11BASE</makevar></entry> + <entry>“X11” ツリーのベース. + (例, <literal>/usr/X11R6/</literal>). + </entry> + </row> + + <row> + <entry><makevar>PREFIX</makevar></entry> + <entry> portsのインストール先 + (<link linkend="porting-prefix"> + <makevar>PREFIX</makevar>について</link>を参照). + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <note> + <para><makevar>USE_IMAKE</makevar>, + <makevar>USE_X_PREFIX</makevar> あるいは + <makevar>MASTERDIR</makevar> + などの変数を定義する必要がある場合には, + <filename>bsd.port.pre.mk</filename> + を include する前に定義してください. + 他のものは, <filename>bsd.port.pre.mk</filename> + の前でも後でもかまいません.</para> + </note> + + <para>以下は <filename>bsd.port.pre.mk</filename> + の後に書けるものの例です:</para> + + <programlisting> +# no need to compile lang/perl5 if perl5 is already in system +.if ${OSVERSION} > 300003 +BROKEN= perl is in system +.endif + +# only one shlib version number for ELF +.if ${PORTOBJFORMAT} == "elf" +TCL_LIB_FILE= ${TCL_LIB}.${SHLIB_MAJOR} +.else +TCL_LIB_FILE= ${TCL_LIB}.${SHLIB_MAJOR}.${SHLIB_MINOR} +.endif + +# software already makes link for ELF, but not for a.out +post-install: +.if ${PORTOBJFORMAT} == "aout" + ${LN} -sf liblinpack.so.1.0 ${PREFIX}/lib/liblinpack.so +.endif</programlisting> + </sect4> + + <sect4> + <title>付加的ドキュメント</title> + + <para>普通のマニュアルや info + ファイルのほかにユーザにとって有用だ + と思えるようなドキュメントがある場合には, + <filename><makevar> PREFIX</makevar>/share/doc</filename> + の下にインストールしてく ださい. これは前記と同様, + <maketarget>post-install</maketarget>ターゲットの + 中からするのがいいでしょう.</para> + + <para>まず, あなたのportのために新しいディレクトリを作りま + す. どのportのドキュメントか簡単にわかるような名前にする必 + 要がありますので, 普通は <makevar>PKGNAME</makevar> + からバージョ ン番号を除いた部分を使うといいでしょう. + もちろん, ユーザが異 + なるバージョンのものを同時に使うことが予想される port + の場合 には, <makevar>PKGNAME</makevar> + をそのまま使ってかまいません.</para> + + <para>ユーザが <filename>/etc/make.conf</filename> + でこの部分を禁止するために <makevar>NOPORTDOCS</makevar> + という変数をセットしている場合には, + これらのドキュメントが + インストールされないようにしてください. こんな具合です. + </para> + + <programlisting> +post-install: +.if !defined(NOPORTDOCS) + ${MKDIR}${PREFIX}/share/doc/xv + ${INSTALL_MAN} ${WRKSRC}/docs/xvdocs.ps ${PREFIX}/share/doc/xv +.endif</programlisting> + + <para>これらのファイルを <filename>pkg/PLIST</filename> + に入れるのを忘れないよ うにしてください. + (packageが<filename>/etc/make.conf</filename>内の + 変数を読む方法は今のところ存在しませんので, + <makevar>NOPORTDOCS</makevar> + については気にしないでください.)</para> + + <para>インストール時に <filename>pkg/MESSAGE</filename> + ファイルを利用して, メッセージを表示することができます. + 詳細は <link linkend="porting-message">pkg/MESSAGE を使う + </link> の節を参照してください.</para> + + <!-- kuriyama - note below is not exist in Jap ver, but Eng ver has it. why? --> + <note> + <para><filename>MESSAGE</filename> ファイルは + <filename>pkg/PLIST</filename> に加える必要はありま + せん.</para> + </note> + </sect4> + + <sect4> + <title><makevar>DIST_SUBDIR</makevar></title> + + <para><filename>/usr/ports/distfiles</filename> + ディレクトリ内をあまり散らかさ ないようにしてください. + たくさんのファイルを取ってくるport や, + 数は少なくてもほかのportのファイルと混同されるおそれが + あるファイル (<filename>Makefile</filename> など) + がある場合には, <makevar>DIST_SUBDIR</makevar> に port + の名前 (<makevar>PKGNAME</makevar> + からバージョン番号を取った部分を 使うといいでしょう) + を入れてください. すると, + <makevar>DISTDIR</makevar>がデフォルトの + <filename>/usr/ports/distfiles</filename> から <filename> + /usr/ports/distfiles/<makevar>DIST_SUBDIR</makevar> + </filename>に変更され, + 取ってきたファイルはすべてそのサブディレクトリの中に置か + れるようになります.</para> + + <para>また, + ファイルを取ってくるときにバックアップサイトとして使わ + れる <filename>ftp.freebsd.org</filename> + のディレクトリ名にもこの変数の 値が使われます. + (<makevar>DISTDIR</makevar>を明示的に指定し た場合には, + ローカルのファイルを置くところは変わりますが, こ + のサイトのディレクトリ名は変わりませんので, 必ず + <makevar>DIST_SUBDIR</makevar>を使うようにしてください.)</para> + + <note> + <para>この変数はMakefile中で明示的に指定された + <makevar>MASTER_SITES</makevar> + には影響しないことに注意して ください.</para> + </note> + </sect4> + + <sect4> + <title>RCS文字列</title> + + <para>RCS + が特別な意味を与えている文字列をパッチ内に入れないように + してください. + ファイルを私たちのソースツリーに入れる時にこれら + の文字列はCVSによって書き換えられてしまい, + あとでまたパッチ + を使おうとした時にうまくいかないことがあります. + RCS文字列は ドル記号 (<literal>$</literal>) + で囲まれており, <literal>$Id</literal> や + <literal>$RCS</literal> などで始まり ます.</para> + </sect4> + + <sect4> + <title>パッチ作成上の注意</title> + + <para><command>diff</command>の再帰 (<option>-r</option>) + フラグを使って再帰的なパッ チを作るのは大変結構なのですが, + でき上がったパッチは必ず目で + チェックして余計なゴミが入っていないことを確認してくださ + い. よくあるのはバックアップファイル同士の変更点, あるいは + <command>Imake</command> や GNU + <command>configure</command> を使うソフトウェアの + <filename>Makefile</filename> + の変更点が入っている場合などです. また, + <filename>configure.in</filename> を編集して, + <command>autoconf</command> を使って + <command>configure</command> を作り直す ときには, + <command>configure</command> の diff は含めずに (それらは, + 数千行になることもしばしばです), + <literal>USE_AUTOCONF=yes</literal> を定義して, + <filename>configure.in</filename> の diff + をとってください.</para> + + <para>ファイルをまるごと消す場合にはパッチを使わずに + <maketarget>post-extract</maketarget> + ターゲットで消す方が簡単です. できあがった + 差分に満足したら, それらをソースのファイルごとに別々の + パッチファイルに分割してください.</para> + </sect4> + + <sect4 id="porting-prefix"> + <title><makevar>PREFIX</makevar></title> + + <para>なるべく port は <makevar>PREFIX</makevar> + に対する相対パス + にインストールすることができるように心がけてください. + (この変数の値は <makevar>USE_X_PREFIX</makevar>か + <makevar>USE_IMAKE</makevar>が指定してある時には + <makevar>X11BASE</makevar> + (デフォルト<filename>/usr/X11R6</filename>), + そうでない場合には<makevar>LOCALBASE</makevar> + (デフォルト<filename>/usr/local</filename>) + にセットされます.)</para> + + <para>サイトによってフリーソフトウェアが + インストールされる場所が 違いますので, ソース内で + <filename>/usr/local</filename> や + <filename>/usr/X11R6</filename> + を明示的に書かないようにしてください. X のプログラムで + <command>imake</command> を使うものについては, + これは問題に はなりません. それ以外の場合には, + ソース中のMakefileやスク <!-- kuriyama - imake is command + --> リプトで <filename>/usr/local</filename> + (imakeを使わないXのプログラ ムは + <filename>/usr/X11R6</filename>) と書いてあるところを + <makevar>PREFIX</makevar> に書き換えてください. この値は + portのコンパイル, + およびインストール時に自動的に環境変数として + 下位makeに渡されます.</para> + + <para><makevar>USE_X_PREFIX</makevar>は本当に必要な時 + (つまり, X のライブラリなどとリンクしたり, + <makevar>X11BASE</makevar> 以下にある + ファイルを参照したりする必要がある時) + 以外には設定しないでください.</para> + + <para>変数 <makevar>PREFIX</makevar> の値は port の + Makefile やユーザの環境で変更することもできます. しかし, + 個々の port が Makefile + でこの変数の値を明示的に設定することはなるべくしない + でください.</para> + + <para>また, 他の port + からインストールされるプログラムやファイル + を指定するときには, 上で述べた変数を使用してください. + 例えば, <command>less</command> のフルパスを + <literal>PAGER</literal> というマクロに入れた い場合は, + コンパイラに + <literal>-DPAGER=\"/usr/local/bin/less\"</literal> + と渡すかわりに <programlisting> + -DPAGER=\"${PREFIX}/bin/less\"</programlisting> + (Xを使うportの時は <programlisting> + -DPAGER=\"${LOCALBASE}/bin/less\"</programlisting> ) + を渡し てください. こうしておけば, `/usr/local' + がまるごとどこか他 の場所に移してあるサイトでも, + あなたのportがそのまま使える 可能性が高くなります.</para> + </sect4> + + <sect4> + <title>ディレクトリ構成</title> + + <para>インストール時には <makevar>PREFIX</makevar> + の正しいサブディ + レクトリにファイルを置くように心がけてください. + ソフトウェア によっては新しいディレクトリを + 一つ作ってファイルを全部それに + 入れてしまうものがありますが, それはよくありません. また, + バ イナリ, ヘッダファイルとマニュアル以外のすべてを + <filename>lib</filename> + というディレクトリに入れてしまうportもあります が, + これもBSD的なファイルシステム構成からいうと正しくありま + せん. これは以下のように分散すべきです. + <filename>etc</filename> にセッ + トアップ/コンフィグレーションファイル, + <filename>libexec</filename> に 内部で使用されるプログラム + (コマンドラインから呼ばれることの ないコマンド), + <filename>sbin</filename> に管理者用のコマンド, + <filename>info</filename> に GNU Info 用のドキュメント, + そして <filename>share</filename> + にアーキテクチャに依存しないファイルが入り ます. + 詳細については man &man.hier.7; を見てくださ い. + <filename>/usr</filename>の構成方針はほとんどそのまま + <filename>/usr/local</filename>にもあてはまります. USENET + “ニュース”を 扱う ports は例外です. これらは, + ファイルのインストール先として + <filename><makevar>PREFIX</makevar>/news</filename> + を使用します.</para> + </sect4> + + <sect4 id="porting-cleaning"> + <title>空のディレクトリの除去</title> + + <para>ports は デインストール(削除) の際には, + 自分自身を消去したあとに, (ディレクトリの) + 除去をするようにしてください. これは, 大抵の場合 + <literal>@dirrm</literal> の行を ports + が作成するすべてのディレクトリについて + 加えることによって実現できます. 親ディレクトリは, + 子ディレクトリを先に消さないと + 消せないことに気をつけて下さい.</para> + + <programlisting> + : +lib/X11/oneko/pixmaps/cat.xpm +lib/X11/oneko/sounds/cat.au + : +@dirrm lib/X11/oneko/pixmals +@dirrm lib/X11/oneko/sounds +@dirrm lib/X11/oneko</programlisting> + + <para>といった感じです.</para> + + <para>しかし, ときとして, 他の port + をディレクトリを共有しているために + <literal>@dirrm</literal> がエラーを返すことがあります. + <command>rmdir</command> を <literal>@unexec</literal> + から呼びだすことによって, 警告(warning)なしで + 空のディレクトリのみを削除することができます: + </para> + + <programlisting> +@unexec rmdir %D/share/doc/gimp 2>/dev/null || true</programlisting> + + <para> + これを使えば, たとえ, 他の port がファイルを + インストールしていて, <filename><makevar> + PREFIX</makevar>/share/doc/gimp</filename> + が空でない場合でも エラーメッセージは表示されませんし, + <command>pkg_delete</command> + が異常終了することもありません.</para> + </sect4> + + <sect4> + <title>UID</title> + + <para>もしあなたの + portがインストールされるシステム上に特定のユー + ザを必要とする場合は, <filename>pkg/INSTALL</filename> + スクリプトから <command>pw</command> + コマンドを実行して自動的にそのユーザを追加するよ + うにしてください. <filename>net/cvsup-mirror</filename> + の portが参考になるでしょう.</para> + + <para>もしあなたの port が, バイナリのパッケージとしてとして + インストールされるときにも, + コンパイルされたときと同じユーザー/グループ ID + を使わなければならないのなら, 50 から 99 の間で空いている + UID を選んで登録してください. + <filename>japanese/Wnn</filename> の port + が参考になるでしょう.</para> + + <para>既にシステムや他の portで利用されている + UIDを使わないように 十分注意してください. 現在の 50から + 99までの間の UIDは以下の とおりです.</para> + + <programlisting> +majordom:*:54:54:Majordomo Pseudo User:/usr/local/majordomo:/nonexistent +cyrus:*:60:60:the cyrus mail server:/nonexistent:/nonexistent +gnats:*:61:1:GNATS database owner:/usr/local/share/gnats/gnats-db:/bin/sh +uucp:*:66:66:UUCP pseudo-user:/var/spool/uucppublic:/usr/libexec/uucp/uucico +xten:*:67:67:X-10 daemon:/usr/local/xten:/nonexistent +pop:*:68:6:Post Office Owner (popper):/nonexistent:/nonexistent +wnn:*:69:7:Wnn:/nonexistent:/nonexistent +ifmail:*:70:66:Ifmail user:/nonexistent:/nonexistent +pgsql:*:70:70:PostgreSQL pseudo-user:/usr/local/pgsql:/bin/sh +ircd:*:72:72:IRCd hybrid:/nonexistent:/nonexistent +alias:*:81:81:QMail user:/var/qmail/alias:/nonexistent +qmaill:*:83:81:QMail user:/var/qmail:/nonexistent +qmaild:*:82:81:QMail user:/var/qmail:/nonexistent +qmailq:*:85:82:QMail user:/var/qmail:/nonexistent +qmails:*:87:82:QMail user:/var/qmail:/nonexistent +qmailp:*:84:81:QMail user:/var/qmail:/nonexistent +qmailr:*:86:82:QMail user:/var/qmail:/nonexistent +msql:*:87:87:mSQL-2 pseudo-user:/var/db/msqldb:/bin/sh</programlisting> + + <para>このリストを最新の状態に保つためにも, + この範囲の UID や GID を予約するような port を作ったり, + 既存の port にそのような改変を行って我々に送るときには, + UID の予約に関する注意書きをつけてください.</para> + </sect4> + + <sect4> + <title>合理的な port</title> + + <para><filename>Makefile</filename> + は単純かつ適切であるべきです. もし, + <filename>Makefile</filename> を数行短かくできたり, + もっと読みやすくできるのであれば, そうしてください. + 例えば, shell の <literal>if</literal> 構文を使う代りに, + make の <literal>.if</literal> 構文を使う, + <makevar>EXTRACT*</makevar> + の再定義で代用できるのであれば, + <maketarget>do-extract</maketarget> を再定義しない, + <literal>CONFIGURE_ARGS += + --prefix=${PREFIX}</literal> とするかわりに, + <makevar>GNU_CONFIGURE</makevar> とする, などです.</para> + </sect4> + + <sect4> + <title><makevar>CFLAGS</makevar> の尊重</title> + + <para><makevar>CFLAGS</makevar> 変数は尊重すべきです. その + port がこれを無視するのであれば, + <literal>NO_PACKAGE=ignores cflags</literal> を + <filename>Makefile</filename> に加えてください.</para> + </sect4> + + <sect4> + <title>コンフィグレーション(設定)ファイル</title> + + <para>もしあなたの port が設定ファイルを + <filename><makevar>PREFIX</makevar>/etc</filename> + に置く必要がある場合には, それを単純にインストールしたり, + <filename>pkg/PLIST</filename> + に加えては<emphasis>いけません</emphasis>. + こうしてしまうと, <command>pkg_delete</command> が + ユーザが苦労して作ったファイルを消してしまったり, 新しく + インストールすると上書きされてしまったりします.</para> + + <para>代りに, 見本となるファイルを suffix ( + <filename><replaceable> + filename</replaceable>.sample</filename> + が良いでしょう) を付けて インストールして, <link + linkend="porting-message"> message</link> を表示して, + ソフトウエアを動かす前に, ユーザがそのファイル + をコピーして編集をしなければならないことを知らせましょう. + </para> + </sect4> + + <sect4> + <title>Portlint</title> + + <para>送付や commit をする前に <link + linkend="porting-portlint"><command>portlint</command></link> + を使ってチェックしましょう.</para> + </sect4> + + <sect4> + <title>フィードバック</title> + + <para>Portを作るためにソフトウェアに変更を加えたら, + なるべく原作者にその旨を伝えてパッチ等を送ってください. + これらが次のリリースに取り入れられれば, + アップグレードが楽になります.</para> + </sect4> + + <sect4> + <title>その他諸々</title> + + <para><filename>pkg/DESCR</filename>, + <filename>pkg/COMMENT</filename>, + <filename>pkg/PLIST</filename> などのファイルは, + それぞれ2重にチェックしてください. + 再検討してもっと良い記述があれば, + それに置きかえてください.</para> + + <para>GNU General Public License + (GNU一般公有使用許諾)のコピーは + (すでにあるので)コピーしないでください, + おねがいします.</para> + + <para>法律に関することには, 十分注意をはらってください. + 私達に法律に反するような形でソフトフェアの配布をさせない + でください!</para> + </sect4> + + <sect4> + <title>困ったら....</title> + + <para>私たちに質問を送る前に, + 既存のportの例と<filename>bsd.port.mk</filename>を + ちゃんと読んでください! <!-- smiley + --><emphasis>;)</emphasis></para> + + <para>それでもわからないことがあったら, + 一人で悩まないでどんどん 質問してください! <!-- smiley + --><emphasis>:)</emphasis></para> + </sect4> + </sect3> + + <sect3 id="porting-samplem"> + <title><filename>Makefile</filename> のお手本</title> + + <para>これはportの <filename>Makefile</filename> + を作る際のお手本です. かぎかっこ + ([])内のコメントは忘れずに取ってください.</para> + + <para>変数の順番, 段落の間の空行など, + <filename>Makefile</filename> を作るときはなるべくこ + の形式にしたがってください. + この形式は重要な情報が簡単に見つけられるように + 設計されています. <link + linkend="porting-portlint">portlint</link> を使って + <filename>Makefile</filename> をチェックすることが + 推奨されています.</para> + + <programlisting> +[ヘッダ -- どのようなportのMakefileかすぐにわかるようになっています] +# New ports collection makefile for: xdvi +# Version required: pl18 ["1.5alpha" みたいなのでも結構です] +[この Makefile の最初の版が作成された日付です. この port をアップグ + レードするときには変えないでください.] +# Date created: 26 May 1995 +[このソフトウェアを最初に FreeBSD に port した人の名前, つまり, + この Makefile の最初の版を書いた人です. この port をアップグレー + ドするとき, この行も変えないでください.] +# Whom: Satoshi Asami <asami@FreeBSD.ORG> +# +# $Id$ +[ ^^^^ この部分は, CVS ツリーに入れる時に自動的に RCS の ID 文字列に + 置き換えられます.] +# + +[Port自体, およびオリジナルのソースを取ってくるところを記述する部分. + 最初は必ずDISTNAME, そして必要ならPKGNAME, CATEGORIES, 続いて + MASTER_SITESがおかれ, さらに MASTER_SITE_SUBDIR がおかれることもあり + ます. そのあと, EXTRACT_SUFX か DISTFILES を指定することも可能です] +DISTNAME= xdvi +PKGNAME= xdvi-pl18 +CATEGORIES= print +[MASTER_SITE_* マクロを使用しない場合は, +最後のスラッシュを忘れないように ("/")!] +MASTER_SITES= ${MASTER_SITE_XCONTRIB} +MASTER_SITE_SUBDIR= applications +[ソースファイルが標準の ".tar.gz" 形式でない時にこれを使いましょう] +EXTRACT_SUFX= .tar.Z + +[配布パッチのセクション -- ない場合もあります] +PATCH_SITES= ftp://ftp.sra.co.jp/pub/X11/japanese/ +PATCHFILES= xdvi-18.patch1.gz xdvi-18.patch2.gz + +[保守責任者 -- これは *必ず* 必要です. 担当者 (あなた) 自身, あるいは + 担当者に素早く連絡をとれる人のアドレスを書いてください. どうしてもこ + こに自分のアドレスを書くのがいやな人は "ports@FreeBSD.ORG" と書いて + もいいです] +MAINTAINER= asami@FreeBSD.ORG + +[依存するport -- ない場合もあります] +RUN_DEPENDS= gs:${PORTSDIR}/print/ghostscript +LIB_DEPENDS= Xpm.5:${PORTSDIR}/graphics/xpm + +[ここには標準のbsd.port.mkの変数で, 上のどれにもあてはまらないものを + 書きます] +[コンフィグレーション, コンパイル, インストールなどの時に質問をする + なら...] +IS_INTERACTIVE=yes +[${DISTNAME}以外のディレクトリにソースが展開されるなら...] +WRKSRC= ${WRKDIR}/xdvi-new +[配布されているパッチが ${WRKSRC} に対する相対パスで作られてい + い場合にこの変数の指定が必要かも...] +PATCH_DIST_STRIP= -p1 +[GNU autoconfによって生成された "configure" スクリプトを走らせたいなら...] +GNU_CONFIGURE= yes +[/usr/bin/makeでなく, GNU makeを使わないといけないなら...] +USE_GMAKE= yes +[これがXのアプリケーションで "xmkmf -a" を走らせたいなら...] +USE_IMAKE= yes +[などなど] + +[下の方のルールで使う非標準の変数] +MY_FAVORITE_RESPONSE= "yeah, right" + +[そして, 特別なターゲット, 使用順に] +pre-fetch: + i go fetch something, yeah + +post-patch: + i need to do something after patch, great + +pre-install: + and then some more stuff before installing, wow + +[最後には必ず] +.include <bsd.port.mk></programlisting> + </sect3> + + <sect3 id="porting-pkgname"> + <title>Packageの名前</title> + + <para>Package の名前は以下のルールにしたがってつけてください. + こ れは package のディレクトリを見やすくするためで, + 無秩序な名前 + がたくさん並んでいるとユーザが使いづらくなるのでは + という心配か らです. + (FTPサイトなどにはたくさんpackageがありますからね.)</para> + + <para>Packageの名前は以下のようにしてください. + <filename><replaceable> + 言語-</replaceable>名前<replaceable>-オプション + </replaceable><replaceable>バージョン.番号 + </replaceable></filename></para> + + <para><makevar>DISTNAME</makevar> + が上記の形式になっていない場合に は, + <makevar>PKGNAME</makevar> をそのようにしてください.</para> + + <orderedlist> + <listitem> + <para>FreeBSD + はユーザの慣れ親しんだ言語のサポートに力を入れて います. + 特定の言語のためのportのpackage名には + <replaceable>言語-</replaceable> に ISO-639 + で定義されている言語名の略称を入れ てください. 例えば, + 日本語なら <literal>ja</literal>, ロシア語なら + <literal>ru</literal>, ベト ナム語なら + <literal>vi</literal>, 中国語なら <literal>zh</literal>, + 韓国語ならば <literal>ko</literal>, ドイツ 語なら + <literal>de</literal>, といった具合です.</para> + </listitem> + + <listitem> + <para><filename>名前</filename> + の部分は原則的にはすべて英小文字 を使います. + 例外はたくさんのプログラムが入っている巨大なport + の場合で, XFree86 (ほんとにあるんですよ) やImageMagickな + どがこれにあたります. そうでない場合には, + 名前の大文字を小文 字に (少なくとも最初の一字だけは) + 変えてください. もし, + 大文字であることが重要な場合(例えば, 1文字の名前, + <literal>R</literal> とか <literal>V</literal>)には, + あなたの裁量で大文字を使うのも良いでしょう. Perl 5 + のモジュールでは, 頭に <literal>p5-</literal> を付け, + 2重コロン (<literal>::</literal>) + のセパレータをハイフン( <literal>-</literal> ) + に置きかえるしきたりになっています. 例えば, + <literal>Data::Dumper</literal> は + <literal>p5-Data-Dumper</literal> になります. また, その + ソフトウェアの名前として通常使われるものに番号, + ハイフン, あ るいは下線が入っている場合には, + それらを使うことも構いません + (<literal>kinput2</literal> など).</para> + </listitem> + + <listitem> + <para>コンパイル時に環境変数や <command>make</command> + の引数などで <link linkend="porting-masterdir"> + ハードコードされたデフォルト </link> + を変えてコンパイルできる場合, + <replaceable>-compiled.specifics</replaceable> + にそのコンパイル時のデフォルトを入れてください + (ハイフンはあってもなくてもかまいません). 用紙のサイズ, + あるいはフォントの解像度などがこれにあたります.</para> + </listitem> + + <listitem> + <para>バージョン番号は数字とアルファベットからなり, + ピリオド (.) で区切ります. + アルファベットは二文字以上続けてはいけませ ん. + ただ一つの例外は「パッチレベル」を意味する + <literal>pl</literal> で, それ 以外にバージョン番号が + まったくついていない場合にのみ使うことがで + きます.</para> + </listitem> + </orderedlist> + + <para>では, <makevar>DISTNAME</makevar>を正しい + <makevar>PKGNAME</makevar>に直す例を見てみましょう:</para> + + <informaltable frame="none"> + <tgroup cols="3"> + <thead> + <row> + <entry>DISTNAME</entry> + <entry>PKGNAME</entry> + <entry>理由</entry> + </row> + </thead> + + <tbody> + <row> + <entry>mule-2.2.2.</entry> + <entry>mule-2.2.2</entry> + <entry>まったく問題なし</entry> + </row> + + <row> + <entry>XFree86-3.1.2</entry> + <entry>XFree86-3.1.2</entry> + <entry>同上</entry> + </row> + + <row> + <entry>EmiClock-1.0.2</entry> + <entry>emiclock-1.0.2</entry> + <entry>プログラム一つだけの時は小文字のみ</entry> + </row> + + <row> + <entry>gmod1.4</entry> + <entry>gmod-1.4</entry> + <!-- kuriyama - need to be fixed --> + <entry>`<名前>' のあとにハイフンが必要</entry> + </row> + + <row> + <entry>xmris.4.0.2</entry> + <entry>xmris-4.0.2</entry> + <entry>同上</entry> + </row> + + <row> + <entry>rdist-1.3alpha</entry> + <entry>rdist-1.3a</entry> + <entry><literal>alpha</literal>のような文字列は使えない + </entry> + </row> + + <row> + <entry>es-0.9-beta1</entry> + <entry>es-0.9b1</entry> + <entry>同上</entry> + </row> + + <row> + <entry>v3.3beta021.src</entry> + <entry>tiff-3.3</entry> + <entry>なんなんでしょう ;)</entry> + </row> + + <row> + <entry>tvtwm</entry> + <entry>tvtwm-pl11</entry> + <entry>バージョン番号は必ず必要</entry> + </row> + + <row> + <entry>piewm</entry> + <entry>piewm-1.0</entry> + <entry>同上</entry> + </row> + + <row> + <entry>xvgr-2.10pl1</entry> + <entry>xvgr-2.10.1</entry> + <entry><literal>pl</literal> + が使えるのは他にバージョン番号がない場合のみ</entry> + </row> + + <row> + <entry>gawk-2.15.6</entry> + <entry>ja-gawk-2.15.6</entry> + <entry>日本語バージョン</entry> + </row> + + <row> + <entry>psutils-1.13</entry> + <entry>psutils-letter-1.13</entry> + <entry>コンパイル時に用紙のサイズを指定</entry> + </row> + + <row> + <entry>pkfonts</entry> + <entry>pkfonts300-1.0</entry> + <entry>300dpiフォント用のpackage</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>オリジナルのソースにまったくバージョン情報が見当たらず, + また原作 + 者が新しいバージョンをリリースする可能性が低いときには, + バージョ ン番号として <literal>1.0</literal> + を使えばいいでしょう (上記のpiewmの例がこ れにあたります). + そうでない場合には, 原作者に聞くか, 日付 + (<literal><replaceable> + 年</replaceable>.<replaceable>月</replaceable> + .<replaceable>日</replaceable></literal>) + を使うなどしてください.</para> + </sect3> + + <sect3 id="porting-categories"> + <title>カテゴリ</title> + + <para>すでに御存知のように, ports はいくつかのカテゴリに + 分類されています. これを有効に利用するためには, port を + 行う人々とユーザが, そろぞれのカテゴリが何であるか, + どのようにしてカテゴリに分類するかを理解する必要が + あります.</para> + + <sect4> + <title>現在のカテゴリのリスト</title> + + <para>まず, これが現在の port のカテゴリーのリストです. + アスタリスク(<literal>*</literal>) が付いているものは, + バーチャル(<emphasis>virtual</emphasis>) カテゴリです -- + これらには対応するサブディレクトリが port + ツリーにはありません.</para> + <!-- kuriyama - don't use " - - " as literal --> + + <note> + <para>バーチャルカテゴリでないものは, + そのサブディレクトリ内の <filename>pkg/COMMENT</filename> + に1行の記述があります + (例, <filename>archivers/pkg/COMMENT</filename>).</para> + </note> + + <informaltable frame="none"> + <tgroup cols="2"> + <thead> + <row> + <entry>Category</entry> + <entry>Description</entry> + </row> + </thead> + + <tbody> + <row> + <entry><filename>afterstep*</filename></entry> + <entry>Ports to support AfterStep window manager</entry> + </row> + + <row> + <entry><filename>archivers</filename></entry> + <entry>Archiving tools.</entry> + </row> + + <row> + <entry><filename>astro</filename></entry> + <entry>Astronomical ports.</entry> + </row> + + <row> + <entry><filename>audio</filename></entry> + <entry>Sound support.</entry> + </row> + + <row> + <entry><filename>benchmarks</filename></entry> + <entry>Benchmarking utilities.</entry> + </row> + + <row> + <entry><filename>biology</filename></entry> + <entry>Biology-related software.</entry> + </row> + + <row> + <entry><filename>cad</filename></entry> + <entry>Computer aided design tools.</entry> + </row> + + <row> + <entry><filename>chinese</filename></entry> + <entry>Chinese language support.</entry> + </row> + + <row> + <entry><filename>comms</filename></entry> + <entry>Communication software. Mostly software to talk to + your serial port.</entry> + </row> + + <row> + <entry><filename>converters</filename></entry> + <entry>Character code converters.</entry> + </row> + + <row> + <entry><filename>databases</filename></entry> + <entry>Databases.</entry> + </row> + + <row> + <entry><filename>deskutils</filename></entry> + <entry>Things that used to be on the desktop before + computers were invented.</entry> + </row> + + <row> + <entry><filename>devel</filename></entry> + <entry>Development utilities. Do not put libraries here just + because they are libraries—unless they truly don't + belong to anywhere else, they shouldn't be in this + category.</entry> + </row> + + <row> + <entry><filename>editors</filename></entry> + <entry>General editors. Specialized editors go in the + section for those tools (e.g., a mathematical-formula + editor will go in <filename>math</filename>).</entry> + </row> + + <row> + <entry><filename>elisp</filename></entry> + <entry>Emacs-lisp ports.</entry> + </row> + + <row> + <entry><filename>emulators</filename></entry> + <entry>Emulators for other operating systems. Terminal + emulators do <emphasis>not</emphasis> belong + here—X-based ones should go to + <filename>x11</filename> and text-based ones to either + <filename>comms</filename> or <filename>misc</filename>, + depending on the exact functionality.</entry> + </row> + + <row> + <entry><filename>games</filename></entry> + <entry>Games.</entry> + </row> + + <row> + <entry><filename>german</filename></entry> + <entry>German language support.</entry> + </row> + + <row> + <entry><filename>graphics</filename></entry> + <entry>Graphics utilities.</entry> + </row> + + <row> + <entry><filename>japanese</filename></entry> + <entry>Japanese language support.</entry> + </row> + + <row> + <entry><filename>kde*</filename></entry> + <entry>Ports that form the K Desktop Environment + (kde).</entry> + </row> + + <row> + <entry><filename>korean</filename></entry> + <entry>Korean language support.</entry> + </row> + + <row> + <entry><filename>lang</filename></entry> + <entry>Programming languages.</entry> + </row> + + <row> + <entry><filename>mail</filename></entry> + <entry>Mail software.</entry> + </row> + + <row> + <entry><filename>math</filename></entry> + <entry>Numerical computation software and other utilities + for mathematics.</entry> + </row> + + <row> + <entry><filename>mbone</filename></entry> + <entry>MBone applications.</entry> + </row> + + <row> + <entry><filename>misc</filename></entry> + <entry>Miscellaneous utilities—basically things that + doesn't belong to anywhere else. This is the only category + that should not appear with any other non-virtual + category. If you have <literal>misc</literal> with + something else in your <makevar>CATEGORIES</makevar> line, + that means you can safely delete <literal>misc</literal> + and just put the port in that other subdirectory!</entry> + </row> + + <row> + <entry><filename>net</filename></entry> + <entry>Miscellaneous networking software.</entry> + </row> + + <row> + <entry><filename>news</filename></entry> + <entry>USENET news software.</entry> + </row> + + <row> + <entry><filename>offix*</filename></entry> + <entry>Ports from the OffiX suite.</entry> + </row> + + <row> + <entry><filename>palm</filename></entry> + <entry>Software support for the 3Com Palm(tm) series.</entry> + </row> + + <row> + <entry><filename>perl5*</filename></entry> + <entry>Ports that require perl version 5 to run.</entry> + </row> + + <row> + <entry><filename>plan9*</filename></entry> + <entry>Various programs from Plan9.</entry> + </row> + + <row> + <entry><filename>print</filename></entry> + <entry>Printing software. Desktop publishing tools + (previewers, etc.) belong here too.</entry> + </row> + + <row> + <entry><filename>python*</filename></entry> + <entry>Software written in python.</entry> + </row> + + <row> + <entry><filename>russian</filename></entry> + <entry>Russian language support.</entry> + </row> + + <row> + <entry><filename>security</filename></entry> + <entry>Security utilities.</entry> + </row> + + <row> + <entry><filename>shells</filename></entry> + <entry>Command line shells.</entry> + </row> + + <row> + <entry><filename>sysutils</filename></entry> + <entry>System utilities.</entry> + </row> + + <row> + <entry><filename>tcl75*</filename></entry> + <entry>Ports that use tcl version 7.5 to run.</entry> + </row> + + <row> + <entry><filename>tcl76*</filename></entry> + <entry>Ports that use tcl version 7.6 to run.</entry> + </row> + + <row> + <entry><filename>tcl80*</filename></entry> + <entry>Ports that use tcl version 8.0 to run.</entry> + </row> + + <row> + <entry><filename>tcl81*</filename></entry> + <entry>Ports that use tcl version 8.1 to run.</entry> + </row> + + <row> + <entry><filename>textproc</filename></entry> + <entry>Text processing utilities. It does not include + desktop publishing tools, which go to print/.</entry> + </row> + + <row> + <entry><filename>tk41*</filename></entry> + <entry>Ports that use tk version 4.1 to run.</entry> + </row> + + <row> + <entry><filename>tk42*</filename></entry> + <entry>Ports that use tk version 4.2 to run.</entry> + </row> + + <row> + <entry><filename>tk80*</filename></entry> + <entry>Ports that use tk version 8.0 to run.</entry> + </row> + + <row> + <entry><filename>tk81*</filename></entry> + <entry>Ports that use tk version 8.1 to run.</entry> + </row> + + <row> + <entry><filename>vietnamese</filename></entry> + <entry>Vietnamese language support.</entry> + </row> + + <row> + <entry><filename>windowmaker*</filename></entry> + <entry>Ports to support the WindowMaker window + manager</entry> + </row> + + <row> + <entry><filename>www</filename></entry> + <entry>Software related to the World Wide Web. HTML language + support belong here too.</entry> + </row> + + <row> + <entry>x11</entry> + <entry>The X window system and friends. This category is + only for software that directly support the window system. + Do not put regular X applications here. If your port is + an X application, define <makevar>USE_XLIB</makevar> + (implied by <makevar>USE_IMAKE</makevar>) and put it in + appropriate categories. Also, many of them go into other + <filename>x11-*</filename> categories (see below).</entry> + </row> + + <row> + <entry><filename>x11-clocks</filename></entry> + <entry>X11 clocks.</entry> + </row> + + <row> + <entry><filename>x11-fm</filename></entry> + <entry>X11 file managers.</entry> + </row> + + <row> + <entry><filename>x11-fonts</filename></entry> + <entry>X11 fonts and font utilities.</entry> + </row> + + <row> + <entry><filename>x11-toolkits</filename></entry> + <entry>X11 toolkits.</entry> + </row> + + <row> + <entry><filename>x11-wm</filename></entry> + <entry>X11 window managers.</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </sect4> + + <sect4> + <title>適切なカテゴリの選択</title> + + <para>多くのカテゴリに重なるので, どれを '第一' + カテゴリにするかを決めなければならないことが + たびたびあるでしょう. これを + うまく決めるルールがいくつかあります. + 以下はその優先順のリストで, 優先度の高いものから + 低いものの順に書いてあります.</para> + + <itemizedlist> + <listitem> + <para>言語特有のカテゴリがまず最初です. + 例えば日本語の X11 のフォントをインストールする + port の場合, <makevar>CATEGORIES</makevar> 行は + <literal>japanese x11-fonts</literal> となるでしょう.</para> + <!-- kuriyama - Eng. ver has x11 category. why? --> + </listitem> + + <listitem> + <para>より特徴的なカテゴリが, 一般的なカテゴリより + 優先されます. 例えば, HTML エディタの場合は + <literal>www editors</literal> となり, + 逆順にはしないでください. また, port が + <literal>mail</literal>, <literal>mbone</literal>, + <literal>news</literal>, <literal>security</literal>, + <literal>www</literal> のいづれかに属するとには, + <literal>net</literal> は必要ありません.</para> + </listitem> + + <listitem> + <para><literal>x11</literal> を第2カテゴリにするのは, + 第1カテゴリが自然言語の場合のみにしてください. 特に X + のアプリケーションには <literal>x11</literal> + を指定<emphasis>しない</emphasis>でください.</para> + </listitem> + + <listitem> + <para>もし, あなたの port が他のどのカテゴリにも + 属しないばあいには, <literal>misc</literal> + にしてください.</para> + </listitem> + </itemizedlist> + + <para>もし, あなたがカテゴリについて自信が持てない場合には, + そのことを <command>send-pr</command> するときに + 書き加えてください. そうすれば import するまえに + それについて議論できます. (もしあなたが commiter であれば, + そのことを &a.ports に送って, 先に議論 + するようにしてください — 新しい port + が間違ったカテゴリに import されて, + すぐ移動されることが多いので.)</para> + </sect4> + </sect3> + + <sect3> + <title>このドキュメントと ports システムの変更</title> + + <para>もしあなたが, たくさんの ports の保守を + しているのであれば, &a.ports メーリングリストの内容を + フォロウすることを考えてください. Ports + のしくみについての重要な変更点はここに アナウンスされます. + 最新の変更点については, いつでも, <ulink + url="http://www.FreeBSD.ORG/cgi/cvsweb.cgi/src/share/mk/bsd.port.mk"> + the bsd.port.mk CVS log</ulink> + で詳細な情報を得ることができます.</para> + <!-- kuriyama - the はまずいだろ --> + </sect3> + + <sect3> + <title>やっとおしまい!</title> + + <para>いやはや, 長い文章ですみません. + ここまで読んでくださった方に は感謝, 感謝でございます. <!-- + smiley --><emphasis>(_ _)</emphasis></para> + + <para>さあ, portの作り方がわかったところで, + 世界中のソフトウェア をport化しましょう. + FreeBSDプロジェクトに貢献するには, それ + がもっとも簡単な方法です! <emphasis + remap=tt>:)</emphasis></para> + </sect3> + </sect2> + + <sect2> + <title>金銭, ハードウェアまたはインターネットアクセス</title> + + <para>FreeBSD プロジェクトの目的を進めるための寄付や, + 私たちと同じような ボランティアの細く長い ! 努力を, + 私たちは常に喜んで受け入れています. + また一般的に私たちは自分達で + 周辺機器を買う資金が不足しているため, + 周辺機器のサポートを充実させるのに + ハードウェアの寄付はとても重要です.</para> + + <sect3 id="donations"> + <title>資金の寄付</title> + + <para>FreeBSD プロジェクトは501(C3) (非営利) 企業ではないため, + いかなる寄 + 付に対しても特別な税金の優遇措置を提供することができません. + このような 寄付はプロジェクトを代表して FreeBSD, Inc + により感謝をもって受け入れら れるでしょう.</para> + + <para>FreeBSD, Inc.は FreeBSD + プロジェクトの推進とプロジェクトに企業とし + ての最小限の体裁を持たせることを目的として, 1995年の初めに + &a.jkh; と &a.dg; により設立されました. + 寄付されたすべての資金は (最終的に FreeBSD, + Inc.によりもたらされるであろうすべての利益も同様に) + プロジェク + トの目標を推進するためだけに使われるでしょう.</para> + + <para>支払い先を FreeBSD, Inc. とした小切手を, + 次の住所気付けで送ってください:</para> + + <address> + <otheraddr>FreeBSD, Inc.</otheraddr> + <otheraddr>c/o Jordan Hubbard</otheraddr> + <street>4041 Pike Lane, Suite F</street> + <city>Concord</city> + <state>CA</state>, <postcode>94520</postcode> + </address> + + <para>[現在 私書箱が開設されるまで一時的に Walnut Creek CDROM + の住所を使用]</para> + + <para>電信振替は次の所まで直接送れるでしょう:</para> + + <address> + <otheraddr>Bank Of America</otheraddr> + <otheraddr>Concord Main Office</otheraddr> + <pob>P.O. Box 37176</pob> + <city>San Francisco</city> + <state>CA</state>, <postcode>94137-5176</postcode> + + <otheraddr>Routing #: 121-000-358</otheraddr> + <otheraddr>Account #: 01411-07441 (FreeBSD, Inc.)</otheraddr> + </address> + + <para>寄付に関することは全て電子メールもしくは上記 FreeBSD, + Inc. の住所宛の郵政省メールにて Jordan Hubbard + <email>jkh@FreeBSD.org</email> + までお送りくださるようお願いします.</para> + + <para>もし <link linkend="donors">寄贈者ギャラリー</link> + の節で匿名を希望される 方は, 寄付の際にその旨お伝えください. + Thanks!</para> + </sect3> + + <sect3> + <title>ハードウェアの寄贈</title> + + <para>FreeBSD プロジェクトは, + 次の3つのカテゴリのどんなハードウェアの寄贈 も, + 喜んで受け付けます:</para> + + <itemizedlist> + <listitem> + <para>ディスクドライブ, + メモリまたは完全なシステムといった一般用途のハー + ドウェアは, <emphasis>資金の寄付</emphasis>の節にある + FreeBSD, Inc. の住所まで送っ てください.</para> + </listitem> + + <listitem> + <para>進行中の受け入れテストのための + ハードウェアが必要とされていま す. + 新たなリリース毎に適切な逆行テストができるように, + 私たちは現在, FreeBSD + がサポートするすべてのコンポーネントの + テストラボを設置しよう としています. 私たちにはまだ, + たくさんの重要な部品 (ネットワークカード, + マザーボードなど) が不足していますので, + このような寄贈をしたいと思って いるならば, &a.dg; + へコンタクトしてどの部品がまだ必要とされているか + の情報を得てください.</para> + </listitem> + + <listitem> + <para>現在 FreeBSD にサポートされていないハードウェアで, + サポートに追 加して欲しいもの. + 私たちが新しいハードウェアを受けとる前にそのタスクを + 引き受けてくれる開発者を探す必要があるため, + その部品を送る前に &a.core; + にコンタクトを取ってください.</para> + </listitem> + </itemizedlist> + </sect3> + + <sect3> + <title>インターネットアクセスの寄付</title> + + <para>私たちは常に FTP, WWW や <command>cvsup</command> + の新しいミラーサイトを募集しています. + ミラーサイトになりたい場合には the FreeBSD project + administrators <email>admin@FreeBSD.ORG</email> + にコンタクトを取って, 詳し + い情報を手に入れてください.</para> + </sect3> + </sect2> + </sect1> + + <sect1 id="donors"> + <title>寄贈者ギャラリー</title> + + <para>FreeBSD プロジェクトは次の寄贈者に恩義を受けており, + ここに公表して 感謝の意を表したいと思います.</para> + + <itemizedlist> + <listitem> + <para><emphasis> + セントラルサーバプロジェクトへの寄贈者:</emphasis></para> + + <para>次に挙げる個人および企業からは, + セントラルサーバマシンのための 部品の寄贈を頂いており, + それによって <hostid + role="fqdn">freefall.freebsd.org</hostid> + をリプレースして新たに FreeBSD + プロジェクトのセントラルサーバマシンを + 構築することができました:</para> + + <itemizedlist> + <listitem> + <para>Ade Barkah <email>mbarkah@freebsd.org</email> + と彼の所属する <ulink + URL="http://www.hemi.com">Hemisphere Online</ulink> + は, <emphasis>Pentium Pro (P6) 200Mhz CPU</emphasis> + を寄贈してくださいました.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.asacomputers.com">ASA + Computers</ulink> は, <emphasis>Tyan 1662 + マザーボード</emphasis> + を寄贈してくださいました.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.via.net">ViaNet + Communications</ulink> の Joe McGuckin + <email>joe@via.net</email> は, <emphasis>Kingston + イーサネットコントローラ</emphasis> + を寄贈してくださいました.</para> + </listitem> + + <listitem> + <para>Jack O'Neill + <email>jack@diamond.xtalwind.net</email> は, + <emphasis>NCR 53C875 SCSI コントローラカード</emphasis> + を寄贈してくださいました.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.Alameda.net">Alameda + Networks</ulink> の Ulf Zimmermann + <email>ulf@Alameda.net</email> は, <emphasis>128MB + のメモリ</emphasis>, そして <emphasis>4 GB + のディスクドライブと匡体</emphasis> + を寄贈してくださいました.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para><emphasis>直接的な資金提供:</emphasis></para> + + <para>次に挙げる個人および企業からは FreeBSD + プロジェクトに対する直接的な + 資金提供を頂いております:</para> + + <itemizedlist> + <listitem> + <para>Annelise Anderson + <email>ANDRSN@HOOVER.STANFORD.EDU</email></para> + </listitem> + + <listitem> + <para>Matt Dillon <email>dillon@best.net</email></para> + </listitem> + + <listitem> + <para><ulink URL="http://www.epilogue.com/"> + Epilogue Technology Corporation</ulink></para> + </listitem> + + <listitem> + <para>Sean Eric Fagan</para> + </listitem> + + <listitem> + <para>Don Scott Wilde</para> + </listitem> + + <listitem> + <para>Gianmarco Giovannelli + <email>gmarco@masternet.it</email></para> + </listitem> + + <listitem> + <para>Josef C. Grosch <email>joeg@truenorth.org</email></para> + </listitem> + + <listitem> + <para>Robert T. Morris</para> + </listitem> + + <listitem> + <para>Chuck Robey <email>chuckr@freebsd.org</email></para> + </listitem> + + <listitem> + <para><ulink URL="http://www.imagescape.com"> + Imaginary Landscape, LLC.</ulink> + の Kenneth P. Stox + <email>ken@stox.sa.enteract.com</email></para> + </listitem> + + <listitem> + <para>Dmitry S. Kohmanyuk <email>dk@dog.farm.org</email></para> + </listitem> + + <listitem> + <para>日本の + <ulink URL="http://www.cdrom.co.jp/">Laser5</ulink> + はいくつかの FreeBSD CD の販売利益の一部を + 寄付してくれました.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.mmjp.or.jp/fuki/"> + 蕗出版</ulink> は, <emphasis>はじめての FreeBSD + </emphasis> の売り上げの一部を FreeBSD プロジェクト及び + XFree86 プロジェクトへ寄付してくれました.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.ascii.co.jp/">アスキー</ulink> + は FreeBSD 関連の書籍の売り上げの一部を FreeBSD + プロジェクト及び FreeBSD 友の会へ寄付してくれました. + </para> + </listitem> + + <listitem> + <para><ulink URL="http://www.yokogawa.co.jp/"> + 横河電機株式会社</ulink> からは FreeBSD + プロジェクトへ多大な寄付をいただきました.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.buffnet.net/">BuffNET</ulink></para> + </listitem> + + <listitem> + <para><ulink url="http://www.pacificsolutions.com/">Pacific + Solutions</ulink></para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para><emphasis>ハードウェアの寄贈者:</emphasis></para> + + <para>次に挙げる個人および企業からは, + テストやデバイスドライバの開発 / サポート + のためのハードウェアの寄贈を頂いております:</para> + + <itemizedlist> + <listitem> + <para>Walnut Creek CDROM は, + ネットワークへのアクセスおよび + 他のハードウェアリソースの寄贈はいうまでもなく, + 開発に使うための Pentium P5-90 と 486/DX2-66 EISA/VL + のシステム数台を 提供してくださいました.</para> + </listitem> + + <listitem> + <para>TRW Financial Sysytems社は, PC 130台, 68 GB + のファイルサーバ 3台, 12のイーサネット, + ディスクレスコードのデバッグをおこなうための ルータ + 2台及び ATM スイッチを提供してくださいました. また, + 彼らは 2, 3人の FreeBSD ハッカーを雇って, FreeBSD + に専念させて くださっております. + ありがとうございます!</para> + </listitem> + + <listitem> + <para>Dermot McDonnell は, 東芝 XM3401B CD-ROM ドライブを + 寄贈してくださいました. その CD-ROM ドライブは現在 + freefall で使用されています.</para> + </listitem> + + <listitem> + <para>&a.chuck; は, 実験用のフロッピーテープストリーマを + 寄付してくださいました.</para> + </listitem> + + <listitem> + <para>Larry Altneu <email>larry@ALR.COM</email> と + &a.wilko;は, <devicename>wt</devicename> + ドライバを改良するために Wangtek と Archive の QIC-02 + テープドライブを提供してくださいました.</para> + </listitem> + + <listitem> + <para>Ernst Winter <email>ewinter@lobo.muc.de</email> は, + このプロジェクトへ 2.88 MB + のフロッピードライブを提供してくださいました. + うまくいけば, + これでフロッピーディスクドライバを書き直すための + プレッシャーが増えるでしょう. <!-- smiley -->;-)</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.tekram.com">Tekram + Technologies</ulink> は NCR ドライバや AMD + ドライバと自社のカードの逆行テストのため FAST/ULTRA + SCSI ホストアダプタ DC-390, DC-390U, DC-390F を + 各1枚提供してくださいました. また, フリーな OS + のためのドライバの ソースを自社の FTP サーバ <ulink + URL="ftp://ftp.tekram.com/scsi/FreeBSD"> + ftp://ftp.tekram.com/scsi/FreeBSD</ulink> + で公開されていることも 称賛に値するでしょう.</para> + </listitem> + + <listitem> + <para>Larry M. Augustin <email>lma@varesearch.com</email> + は Symbios Sym8751S SCSI + カードを寄贈してくださっただけでなく, Ultra-2 や LVD + をサポートする次期チップ Sym53c895 のものを含む + データブックのセットと, 最新の Symbios SCSI + チップが持つ先進的機能を 安全に使う方法について書かれた + 最新のプログラミングマニュアルも 寄贈してくださいました. + 本当にありがとうございます !</para> + </listitem> + + <listitem> + <para>Christoph Kukulies <email>kuku@freebsd.org</email> + は, IDE CD-ROM ドライバ開発用の FX120 12 倍速 Mitsumi + CD-ROM ドライブ を提供してくださいました.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para><emphasis>特筆すべき寄贈者:</emphasis></para> + + <itemizedlist> + <listitem> + <para><ulink URL="http://www.cdrom.com">Walnut Creek + CDROM</ulink> は, + 言い表せないほど多くの寄付をしてくださいました (詳細は + <link linkend="history">FreeBSD 小史</link>を参照). + 特に, 私たちのもともとのプライマリ開発マシンである + <hostid role="fqdn">freefall.FreeBSD.ORG</hostid>, + テストおよびビルドマシンである <hostid + role="fqdn">thud.FreeBSD.ORG</hostid> + で使用しているハードウェアに対し 感謝したいと思います. + また彼らには, 数年にわたる色々な貢献者への資金提供や, + インターネット への T1 + コネクションの無制限使用を提供して + 頂いた恩義があります.</para> + </listitem> + + <listitem> + <para><ulink + URL="http://www.interface-business.de">interface + business GmbH, Dresden</ulink> は, &a.joerg; + を根気よく サポートしてくださいました. 彼は本職より + FreeBSD の仕事を好みがちであり, 彼個人の接続があまりに + 遅くなったり途切れたりして仕事にならない時は必ず + interface business の (非常に高価な) EUnet + インターネット接続に頼ったものです...</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.bsdi.com">Berkeley Software + Design, Inc.</ulink> は, 同社の DOS + エミュレータのコードを BSD コミュ + ニティ全体に対して提供してくれました. このコードは, + <emphasis>dosemu</emphasis> + コマンドに利用されています.</para> + </listitem> + </itemizedlist> + </listitem> + </itemizedlist> + </sect1> + + <sect1> + <title>コアチームの卒業生</title> + + <para>次に挙げる人々は()で記した期間, FreeBSD + コアチームのメンバーでした. FreeBSD + プロジェクトにおける彼らの努力に感謝の意を表します. + </para> + + <para><emphasis>だいたいの年代順:</emphasis></para> + + <itemizedlist> + <listitem> + <para>Guido van Rooij (1995 - 1999)</para> + </listitem> + + <listitem> + <para>John Dyson (1993 - 1998)</para> + </listitem> + + <listitem> + <para>Nate Williams (1992 - 1996)</para> + </listitem> + + <listitem> + <para>Rod Grimes (1992 - 1995)</para> + </listitem> + + <listitem> + <para>Andreas Schulz (1992 - 1995)</para> + </listitem> + + <listitem> + <para>Geoff Rehmet (1993 - 1995)</para> + </listitem> + + <listitem> + <para>Paul Richards (1992 - 1995)</para> + </listitem> + + <listitem> + <para>Scott Mace (1993 - 1994)</para> + </listitem> + + <listitem> + <para>Andrew Moore (1993 - 1994)</para> + </listitem> + + <listitem> + <para>Christoph Robitschko (1993 - 1994)</para> + </listitem> + + <listitem> + <para>J. T. Conklin (1992 - 1993)</para> + </listitem> + </itemizedlist> + </sect1> + + <sect1> + <title>BSD派生ソフトウェアへのコントリビュータ</title> + + <para>このソフトウェアは最初は William F. Jolitz の 386BSD release + 0.1 から派生しましたが, オリジナルの 386BSD + に固有のコードはほとんど 残っていません. + このソフトウェアは基本的にはカリフォルニア大学 バークレイ校の + Computer Science Research Group (CSRG) とその共同研究者 + たちによる 4.4BSD-Lite リリースから再実装されました.</para> + + <para>また, NetBSD や OpenBSD の一部も FreeBSD + に取り込まれています. したがって私たちは NetBSD と OpenBSD + へ貢献した人々すべてに感謝します.</para> + </sect1> + + <sect1 id="contrib-additional"> + <title>その他の FreeBSD へのコントリビュータ</title> + + <para>(名前でアルファベット順に):</para> + + <!-- kuriyama - eng ver still have simokawa entity? --> +<!-- kuriyama - Eng. ver doesn't have this entity? ++ <item>MANTANI Nobutaka <tt><htmlurl url='mailto:nobutaka@nobutaka.com' ++ name='<nobutaka@nobutaka.com>'></tt> + --> +<!-- kuriyama - Eng. ver doesn't have this entity? ++ <item>Satsuki FUJISHIMA <tt><htmlurl url='mailto:k5@respo.or.jp' ++ name='<k5@respo.or.jp>'></tt> + --> +<!-- kuriyama - Eng. ver doesn't have this entity? ++ <item>SUGIMURA Takashi <tt><htmlurl url='mailto:sugimura@jp.FreeBSD.ORG' ++ name='<sugimura@jp.FreeBSD.ORG>'></tt> + --> + <itemizedlist> + <listitem> + <para>ABURAYA Ryushirou <email>rewsirow@ff.iij4u.or.jp</email></para> + </listitem> + + <listitem> + <para>AMAGAI Yoshiji <email>amagai@nue.org</email></para> + </listitem> + + <listitem> + <para>Aaron Bornstein <email>aaronb@j51.com</email></para> + </listitem> + + <listitem> + <para>Aaron Smith <email>aaron@tau.veritas.com</email></para> + </listitem> + + <listitem> + <para>Achim Patzner <email>ap@noses.com</email></para> + </listitem> + + <listitem> + <para>Ada T Lim <email>ada@bsd.org</email></para> + </listitem> + + <listitem> + <para>Adam Baran <email>badam@mw.mil.pl</email></para> + </listitem> + + <listitem> + <para>Adam Glass <email>glass@postgres.berkeley.edu</email></para> + </listitem> + + <listitem> + <para>Adam McDougall <email>mcdouga9@egr.msu.edu</email></para> + </listitem> + + <listitem> + <para>Adrian Colley <email>aecolley@ois.ie</email></para> + </listitem> + + <listitem> + <para>Adrian Hall <email>adrian@ibmpcug.co.uk</email></para> + </listitem> + + <listitem> + <para>Adrian Mariano <email>adrian@cam.cornell.edu</email></para> + </listitem> + + <listitem> + <para>Adrian Steinmann <email>ast@marabu.ch</email></para> + </listitem> + + <listitem> + <para>Adrian T. Filipi-Martin + <email>atf3r@agate.cs.virginia.edu</email></para> + </listitem> + + <listitem> + <para>Ajit Thyagarajan <email>unknown</email></para> + </listitem> + + <listitem> + <para>Akio Morita + <email>amorita@meadow.scphys.kyoto-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Akira SAWADA <email>unknown</email></para> + </listitem> + + <listitem> + <para>Akira Watanabe + <email>akira@myaw.ei.meisei-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Akito Fujita <email>fujita@zoo.ncl.omron.co.jp</email></para> + </listitem> + + <listitem> + <para>Alain Kalker + <email>A.C.P.M.Kalker@student.utwente.nl</email></para> + </listitem> + + <listitem> + <para>Alan Bawden <email>alan@curry.epilogue.com</email></para> + </listitem> + + <listitem> + <para>Alan Cox <email>alc@cs.rice.edu</email></para> + </listitem> + + <listitem> + <para>Alec Wolman <email>wolman@cs.washington.edu</email></para> + </listitem> + + <listitem> + <para>Aled Morris <email>aledm@routers.co.uk</email></para> + </listitem> + + <listitem> + <para>Alex <email>garbanzo@hooked.net</email></para> + </listitem> + + <listitem> + <para>Alex D. Chen + <email>dhchen@Canvas.dorm7.nccu.edu.tw</email></para> + </listitem> + + <listitem> + <para>Alex G. Bulushev <email>bag@demos.su</email></para> + </listitem> + + <listitem> + <para>Alex Le Heux <email>alexlh@funk.org</email></para> + </listitem> + + <listitem> + <para>Alexander B. Povolotsky <email>tarkhil@mgt.msk.ru</email></para> + </listitem> + + <listitem> + <para>Alexander Leidinger + <email>netchild@wurzelausix.CS.Uni-SB.DE</email></para> + </listitem> + + <listitem> + <para>Alexandre Snarskii <email>snar@paranoia.ru</email></para> + </listitem> + + <listitem> + <para>Alistair G. Crooks <email>agc@uts.amdahl.com</email></para> + </listitem> + + <listitem> + <para>Allan Saddi <email>asaddi@philosophysw.com</email></para> + </listitem> + + <listitem> + <para>Allen Campbell <email>allenc@verinet.com</email></para> + </listitem> + + <listitem> + <para>Amakawa Shuhei <email>amakawa@hoh.t.u-tokyo.ac.jp</email></para> + </listitem> + + <listitem> + <para>Amancio Hasty <email>hasty@star-gate.com</email></para> + </listitem> + + <listitem> + <para>Amir Farah <email>amir@comtrol.com</email></para> + </listitem> + + <listitem> + <para>Amy Baron <email>amee@beer.org</email></para> + </listitem> + + <listitem> + <para>Anatoly A. Orehovsky <email>tolik@mpeks.tomsk.su</email></para> + </listitem> + + <listitem> + <para>Anatoly Vorobey <email>mellon@pobox.com</email></para> + </listitem> + + <listitem> + <para>Anders Nordby <email>nickerne@nome.no</email></para> + </listitem> + + <listitem> + <para>Anders Thulin <email>Anders.X.Thulin@telia.se</email></para> + </listitem> + + <listitem> + <para>Andras Olah <email>olah@cs.utwente.nl</email></para> + </listitem> + + <listitem> + <para>Andre Albsmeier + <email>Andre.Albsmeier@mchp.siemens.de</email></para> + </listitem> + + <listitem> + <para>Andre Oppermann <email>andre@pipeline.ch</email></para> + </listitem> + + <listitem> + <para>Andreas Haakh <email>ah@alman.robin.de</email></para> + </listitem> + + <listitem> + <para>Andreas Kohout <email>shanee@rabbit.augusta.de</email></para> + </listitem> + + <listitem> + <para>Andreas Lohr <email>andreas@marvin.RoBIN.de</email></para> + </listitem> + + <listitem> + <para>Andreas Schulz <email>unknown</email></para> + </listitem> + + <listitem> + <para>Andreas Wetzel <email>mickey@deadline.snafu.de</email></para> + </listitem> + + <listitem> + <para>Andreas Wrede <email>andreas@planix.com</email></para> + </listitem> + + <listitem> + <para>Andres Vega Garcia <email>unknown</email></para> + </listitem> + + <listitem> + <para>Andrew Atrens <email>atreand@statcan.ca</email></para> + </listitem> + + <listitem> + <para>Andrew Gillham <email>gillham@andrews.edu</email></para> + </listitem> + + <listitem> + <para>Andrew Gordon <email>andrew.gordon@net-tel.co.uk</email></para> + </listitem> + + <listitem> + <para>Andrew Herbert <email>andrew@werple.apana.org.au</email></para> + </listitem> + + <listitem> + <para>Andrew J. Korty <email>ajk@purdue.edu</email></para> + </listitem> + + <listitem> + <para>Andrew L. Moore <email>alm@mclink.com</email></para> + </listitem> + + <listitem> + <para>Andrew McRae <email>amcrae@cisco.com</email></para> + </listitem> + + <listitem> + <para>Andrew Stevenson <email>andrew@ugh.net.au</email></para> + </listitem> + + <listitem> + <para>Andrew Timonin <email>tim@pool1.convey.ru</email></para> + </listitem> + + <listitem> + <para>Andrew V. Stesin <email>stesin@elvisti.kiev.ua</email></para> + </listitem> + + <listitem> + <para>Andrew Webster <email>awebster@dataradio.com</email></para> + </listitem> + + <listitem> + <para>Andrey Zakhvatov <email>andy@icc.surw.chel.su</email></para> + </listitem> + + <listitem> + <para>Andy Farkas <email>andyf@speednet.com.au</email></para> + </listitem> + + <listitem> + <para>Andy Valencia <email>ajv@csd.mot.com</email></para> + </listitem> + + <listitem> + <para>Andy Whitcroft <email>andy@sarc.city.ac.uk</email></para> + </listitem> + + <listitem> + <para>Angelo Turetta <email>ATuretta@stylo.it</email></para> + </listitem> + + <listitem> + <para>Anthony C. Chavez <email>magus@xmission.com</email></para> + </listitem> + + <listitem> + <para>Anthony Yee-Hang Chan <email>yeehang@netcom.com</email></para> + </listitem> + + <listitem> + <para>Anton Berezin <email>tobez@plab.ku.dk</email></para> + </listitem> + + <listitem> + <para>Antti Kaipila <email>anttik@iki.fi</email></para> + </listitem> + + <listitem> + <para>Are Bryne <email>are.bryne@communique.no</email></para> + </listitem> + + <listitem> + <para>Ari Suutari <email>ari@suutari.iki.fi</email></para> + </listitem> + + <listitem> + <para>Arjan de Vet <email>devet@IAEhv.nl</email></para> + </listitem> + + <listitem> + <para>Arne Henrik Juul <email>arnej@Lise.Unit.NO</email></para> + </listitem> + + <listitem> + <para>Assar Westerlund <email>assar@sics.se</email></para> + </listitem> + + <listitem> + <para>Atsushi Furuta <email>furuta@sra.co.jp</email></para> + </listitem> + + <listitem> + <para>Atsushi Murai <email>amurai@spec.co.jp</email></para> + </listitem> + + <listitem> + <para>Bakul Shah <email>bvs@bitblocks.com</email></para> + </listitem> + + <listitem> + <para>Barry Bierbauch <email>pivrnec@vszbr.cz</email></para> + </listitem> + + <listitem> + <para>Barry Lustig <email>barry@ictv.com</email></para> + </listitem> + + <listitem> + <para>Ben Hutchinson <email>benhutch@xfiles.org.uk</email></para> + </listitem> + + <listitem> + <para>Ben Jackson <email>unknown</email></para> + </listitem> + + <listitem> + <para>Ben Smithurst <email>ben@scientia.demon.co.uk</email></para> + </listitem> + + <listitem> + <para>Ben Walter <email>bwalter@itachi.swcp.com</email></para> + </listitem> + + <listitem> + <para>Benjamin Lewis <email>bhlewis@gte.net</email></para> + </listitem> + + <listitem> + <para>Bernd Rosauer <email>br@schiele-ct.de</email></para> + </listitem> + + <listitem> + <para>Bill Kish <email>kish@osf.org</email></para> + </listitem> + + <listitem> + <para>Bill Trost <email>trost@cloud.rain.com</email></para> + </listitem> + + <listitem> + <para>Blaz Zupan <email>blaz@amis.net</email></para> + </listitem> + + <listitem> + <para>Bob Van Valzah <email>Bob@whitebarn.com</email></para> + </listitem> + + <listitem> + <para>Bob Willcox <email>bob@luke.pmr.com</email></para> + </listitem> + + <listitem> + <para>Boris Staeblow <email>balu@dva.in-berlin.de</email></para> + </listitem> + + <listitem> + <para>Boyd R. Faulkner <email>faulkner@asgard.bga.com</email></para> + </listitem> + + <listitem> + <para>Brad Karp <email>karp@eecs.harvard.edu</email></para> + </listitem> + + <listitem> + <para>Bradley Dunn <email>bradley@dunn.org</email></para> + </listitem> + + <listitem> + <para>Brandon Gillespie <email>brandon@roguetrader.com</email></para> + </listitem> + + <listitem> + <para>&a.wlloyd</para> + </listitem> + + <listitem> + <para>Bob Wilcox <email>bob@obiwan.uucp</email></para> + </listitem> + + <listitem> + <para>Boyd Faulkner <email>faulkner@mpd.tandem.com</email></para> + </listitem> + + <listitem> + <para>Brent J. Nordquist <email>bjn@visi.com</email></para> + </listitem> + + <listitem> + <para>Brett Lymn <email>blymn@mulga.awadi.com.AU</email></para> + </listitem> + + <listitem> + <para>Brett Taylor + <email>brett@peloton.physics.montana.edu</email></para> + </listitem> + + <listitem> + <para>Brian Campbell <email>brianc@pobox.com</email></para> + </listitem> + + <listitem> + <para>Brian Clapper <email>bmc@willscreek.com</email></para> + </listitem> + + <listitem> + <para>Brian Cully <email>shmit@kublai.com</email></para> + </listitem> + + <listitem> + <para>Brian F. Feldman <email>green@unixhelp.org</email></para> + </listitem> + + <listitem> + <para>Brian Handy + <email>handy@lambic.space.lockheed.com</email></para> + </listitem> + + <listitem> + <para>Brian Litzinger <email>brian@MediaCity.com</email></para> + </listitem> + + <listitem> + <para>Brian McGovern <email>bmcgover@cisco.com</email></para> + </listitem> + + <listitem> + <para>Brian Moore <email>ziff@houdini.eecs.umich.edu</email></para> + </listitem> + + <listitem> + <para>Brian R. Haug <email>haug@conterra.com</email></para> + </listitem> + + <listitem> + <para>Brian Tao <email>taob@risc.org</email></para> + </listitem> + + <listitem> + <para>Brion Moss <email>brion@queeg.com</email></para> + </listitem> + + <listitem> + <para>Bruce A. Mah <email>bmah@ca.sandia.gov</email></para> + </listitem> + + <listitem> + <para>Bruce Albrecht <email>bruce@zuhause.mn.org</email></para> + </listitem> + + <listitem> + <para>Bruce Gingery <email>bgingery@gtcs.com</email></para> + </listitem> + + <listitem> + <para>Bruce J. Keeler <email>loodvrij@gridpoint.com</email></para> + </listitem> + + <listitem> + <para>Bruce Murphy <email>packrat@iinet.net.au</email></para> + </listitem> + + <listitem> + <para>Bruce Walter <email>walter@fortean.com</email></para> + </listitem> + + <listitem> + <para>Carey Jones <email>mcj@acquiesce.org</email></para> + </listitem> + + <listitem> + <para>Carl Fongheiser <email>cmf@netins.net</email></para> + </listitem> + + <listitem> + <para>Carl Mascott <email>cmascott@world.std.com</email></para> + </listitem> + + <listitem> + <para>Casper <email>casper@acc.am</email></para> + </listitem> + + <listitem> + <para>Castor Fu <email>castor@geocast.com</email></para> + </listitem> + + <listitem> + <para>Cejka Rudolf <email>cejkar@dcse.fee.vutbr.cz</email></para> + </listitem> + + <listitem> + <para>Chain Lee <email>chain@110.net</email></para> + </listitem> + + <listitem> + <para>Charles Hannum <email>mycroft@ai.mit.edu</email></para> + </listitem> + + <listitem> + <para>Charles Henrich <email>henrich@msu.edu</email></para> + </listitem> + + <listitem> + <para>Charles Mott <email>cmott@srv.net</email></para> + </listitem> + + <listitem> + <para>Charles Owens <email>owensc@enc.edu</email></para> + </listitem> + + <listitem> + <para>Chet Ramey <email>chet@odin.INS.CWRU.Edu</email></para> + </listitem> + + <listitem> + <para>Chia-liang Kao <email>clkao@CirX.ORG</email></para> + </listitem> + + <listitem> + <para>Chiharu Shibata <email>chi@bd.mbn.or.jp</email></para> + </listitem> + + <listitem> + <para>Chip Norkus <email>unknown</email></para> + </listitem> + + <listitem> + <para>Choi Jun Ho <email>junker@jazz.snu.ac.kr</email></para> + </listitem> + + <listitem> + <para>Chris Csanady <email>cc@tarsier.ca.sandia.gov</email></para> + </listitem> + + <listitem> + <para>Chris Dabrowski <email>chris@vader.org</email></para> + </listitem> + + <listitem> + <para>Chris Dillon <email>cdillon@wolves.k12.mo.us</email></para> + </listitem> + + <listitem> + <para>Chris Piazza <email>cpiazza@home.net</email></para> + </listitem> + + <listitem> + <para>Chris Shenton + <email>cshenton@angst.it.hq.nasa.gov</email></para> + </listitem> + + <listitem> + <para>Chris Stenton <email>jacs@gnome.co.uk</email></para> + </listitem> + + <listitem> + <para>Chris Timmons <email>skynyrd@opus.cts.cwu.edu</email></para> + </listitem> + + <listitem> + <para>Chris Torek <email>torek@ee.lbl.gov</email></para> + </listitem> + + <listitem> + <para>Christian Gusenbauer + <email>cg@fimp01.fim.uni-linz.ac.at</email></para> + </listitem> + + <listitem> + <para>Christian Haury <email>Christian.Haury@sagem.fr</email></para> + </listitem> + + <listitem> + <para>Christian Weisgerber + <email>naddy@bigeye.rhein-neckar.de</email></para> + </listitem> + + <listitem> + <para>Christoph P. Kukulies <email>kuku@FreeBSD.org</email></para> + </listitem> + + <listitem> + <para>Christoph Robitschko + <email>chmr@edvz.tu-graz.ac.at</email></para> + </listitem> + + <listitem> + <para>Christoph Weber-Fahr + <email>wefa@callcenter.systemhaus.net</email></para> + </listitem> + + <listitem> + <para>Christopher G. Demetriou + <email>cgd@postgres.berkeley.edu</email></para> + </listitem> + + <listitem> + <para>Christopher T. Johnson + <email>cjohnson@neunacht.netgsi.com</email></para> + </listitem> + + <listitem> + <para>Chrisy Luke <email>chrisy@flix.net</email></para> + </listitem> + + <listitem> + <para>Chuck Hein <email>chein@cisco.com</email></para> + </listitem> + + <listitem> + <para>Clive Lin <email>clive@CiRX.ORG</email></para> + </listitem> + + <listitem> + <para>Colman Reilly <email>careilly@tcd.ie</email></para> + </listitem> + + <listitem> + <para>Conrad Sabatier <email>conrads@neosoft.com</email></para> + </listitem> + + <listitem> + <para>Coranth Gryphon <email>gryphon@healer.com</email></para> + </listitem> + + <listitem> + <para>Cornelis van der Laan + <email>nils@guru.ims.uni-stuttgart.de</email></para> + </listitem> + + <listitem> + <para>Cove Schneider <email>cove@brazil.nbn.com</email></para> + </listitem> + + <listitem> + <para>Craig Leres <email>leres@ee.lbl.gov</email></para> + </listitem> + + <listitem> + <para>Craig Loomis <email>unknown</email></para> + </listitem> + + <listitem> + <para>Craig Metz <email>cmetz@inner.net</email></para> + </listitem> + + <listitem> + <para>Craig Spannring <email>cts@internetcds.com</email></para> + </listitem> + + <listitem> + <para>Craig Struble <email>cstruble@vt.edu</email></para> + </listitem> + + <listitem> + <para>Cristian Ferretti <email>cfs@riemann.mat.puc.cl</email></para> + </listitem> + + <listitem> + <para>Curt Mayer <email>curt@toad.com</email></para> + </listitem> + + <listitem> + <para>Cy Schubert <email>cschuber@uumail.gov.bc.ca</email></para> + </listitem> + + <listitem> + <para>DI. Christian Gusenbauer + <email>cg@scotty.edvz.uni-linz.ac.at</email></para> + </listitem> + + <listitem> + <para>Dai Ishijima <email>ishijima@tri.pref.osaka.jp</email></para> + </listitem> + + <listitem> + <para>Damian Hamill <email>damian@cablenet.net</email></para> + </listitem> + + <listitem> + <para>Dan Cross <email>tenser@spitfire.ecsel.psu.edu</email></para> + </listitem> + + <listitem> + <para>Dan Lukes <email>dan@obluda.cz</email></para> + </listitem> + + <listitem> + <para>Dan Nelson <email>dnelson@emsphone.com</email></para> + </listitem> + + <listitem> + <para>Dan Walters <email>hannibal@cyberstation.net</email></para> + </listitem> + + <listitem> + <para>Daniel Baker <email>dbaker@crash.ops.neosoft.com</email></para> + </listitem> + + <listitem> + <para>Daniel M. Eischen + <email>deischen@iworks.InterWorks.org</email></para> + </listitem> + + <listitem> + <para>Daniel O'Connor <email>doconnor@gsoft.com.au</email></para> + </listitem> + + <listitem> + <para>Daniel Poirot <email>poirot@aio.jsc.nasa.gov</email></para> + </listitem> + + <listitem> + <para>Daniel Rock <email>rock@cs.uni-sb.de</email></para> + </listitem> + + <listitem> + <para>Danny Egen <email>unknown</email></para> + </listitem> + + <listitem> + <para>Danny J. Zerkel <email>dzerkel@phofarm.com</email></para> + </listitem> + + <listitem> + <para>Darren Reed <email>avalon@coombs.anu.edu.au</email></para> + </listitem> + + <listitem> + <para>Dave Adkins <email>adkin003@tc.umn.edu</email></para> + </listitem> + + <listitem> + <para>Dave Andersen <email>angio@aros.net</email></para> + </listitem> + + <listitem> + <para>Dave Blizzard <email>dblizzar@sprynet.com</email></para> + </listitem> + + <listitem> + <para>Dave Bodenstab <email>imdave@synet.net</email></para> + </listitem> + + <listitem> + <para>Dave Burgess <email>burgess@hrd769.brooks.af.mil</email></para> + </listitem> + + <listitem> + <para>Dave Chapeskie <email>dchapes@ddm.on.ca</email></para> + </listitem> + + <listitem> + <para>Dave Cornejo <email>dave@dogwood.com</email></para> + </listitem> + + <listitem> + <para>Dave Edmondson <email>davided@sco.com</email></para> + </listitem> + + <listitem> + <para>Dave Glowacki <email>dglo@ssec.wisc.edu</email></para> + </listitem> + + <listitem> + <para>Dave Marquardt <email>marquard@austin.ibm.com</email></para> + </listitem> + + <listitem> + <para>Dave Tweten <email>tweten@FreeBSD.org</email></para> + </listitem> + + <listitem> + <para>David A. Adkins <email>adkin003@tc.umn.edu</email></para> + </listitem> + + <listitem> + <para>David A. Bader <email>dbader@umiacs.umd.edu</email></para> + </listitem> + + <listitem> + <para>David Borman <email>dab@bsdi.com</email></para> + </listitem> + + <listitem> + <para>David Dawes <email>dawes@XFree86.org</email></para> + </listitem> + + <listitem> + <para>David Filo <email>filo@yahoo.com</email></para> + </listitem> + + <listitem> + <para>David Holland <email>dholland@eecs.harvard.edu</email></para> + </listitem> + + <listitem> + <para>David Holloway <email>daveh@gwythaint.tamis.com</email></para> + </listitem> + + <listitem> + <para>David Horwitt <email>dhorwitt@ucsd.edu</email></para> + </listitem> + + <listitem> + <para>David Hovemeyer <email>daveho@infocom.com</email></para> + </listitem> + + <listitem> + <para>David Jones <email>dej@qpoint.torfree.net</email></para> + </listitem> + + <listitem> + <para>David Kelly <email>dkelly@tomcat1.tbe.com</email></para> + </listitem> + + <listitem> + <para>David Kulp <email>dkulp@neomorphic.com</email></para> + </listitem> + + <listitem> + <para>David L. Nugent <email>davidn@blaze.net.au</email></para> + </listitem> + + <listitem> + <para>David Leonard <email>d@scry.dstc.edu.au</email></para> + </listitem> + + <listitem> + <para>David Malone <email>dwmalone@maths.tcd.ie</email></para> + </listitem> + + <listitem> + <para>David Muir Sharnoff <email>muir@idiom.com</email></para> + </listitem> + + <listitem> + <para>David S. Miller <email>davem@jenolan.rutgers.edu</email></para> + </listitem> + + <listitem> + <para>David Wolfskill <email>dhw@whistle.com</email></para> + </listitem> + + <listitem> + <para>Dean Gaudet <email>dgaudet@arctic.org</email></para> + </listitem> + + <listitem> + <para>Dean Huxley <email>dean@fsa.ca</email></para> + </listitem> + + <listitem> + <para>Denis Fortin <email>unknown</email></para> + </listitem> + + <listitem> + <para>Dennis Glatting + <email>dennis.glatting@software-munitions.com</email></para> + </listitem> + + <listitem> + <para>Denton Gentry <email>denny1@home.com</email></para> + </listitem> + + <listitem> + <para>Derek Inksetter <email>derek@saidev.com</email></para> + </listitem> + + <listitem> + <para>Dima Sivachenko <email>dima@Chg.RU</email></para> + </listitem> + + <listitem> + <para>Dirk Keunecke <email>dk@panda.rhein-main.de</email></para> + </listitem> + + <listitem> + <para>Dirk Nehrling <email>nerle@pdv.de</email></para> + </listitem> + + <listitem> + <para>Dmitry Khrustalev <email>dima@xyzzy.machaon.ru</email></para> + </listitem> + + <listitem> + <para>Dmitry Kohmanyuk <email>dk@farm.org</email></para> + </listitem> + + <listitem> + <para>Dom Mitchell <email>dom@myrddin.demon.co.uk</email></para> + </listitem> + + <listitem> + <para>Don Croyle <email>croyle@gelemna.ft-wayne.in.us</email></para> + </listitem> + + <listitem> + <para>&a.whiteside;</para> + </listitem> + + <listitem> + <para>Don Morrison <email>dmorrisn@u.washington.edu</email></para> + </listitem> + + <listitem> + <para>Don Yuniskis <email>dgy@rtd.com</email></para> + </listitem> + + <listitem> + <para>Donald Maddox <email>dmaddox@conterra.com</email></para> + </listitem> + + <listitem> + <para>Doug Barton <email>studded@dal.net</email></para> + </listitem> + + <listitem> + <para>Douglas Ambrisko <email>ambrisko@whistle.com</email></para> + </listitem> + + <listitem> + <para>Douglas Carmichael <email>dcarmich@mcs.com</email></para> + </listitem> + + <listitem> + <para>Douglas Crosher <email>dtc@scrooge.ee.swin.oz.au</email></para> + </listitem> + + <listitem> + <para>Drew Derbyshire <email>ahd@kew.com</email></para> + </listitem> + + <listitem> + <para>Duncan Barclay <email>dmlb@ragnet.demon.co.uk</email></para> + </listitem> + + <listitem> + <para>Dustin Sallings <email>dustin@spy.net</email></para> + </listitem> + + <listitem> + <para>Eckart "Isegrim" Hofmann + <email>Isegrim@Wunder-Nett.org</email></para> + </listitem> + + <listitem> + <para>Ed Gold + <email>vegold01@starbase.spd.louisville.edu</email></para> + </listitem> + + <listitem> + <para>Ed Hudson <email>elh@p5.spnet.com</email></para> + </listitem> + + <listitem> + <para>Edward Wang <email>edward@edcom.com</email></para> + </listitem> + + <listitem> + <para>Edwin Groothus <email>edwin@nwm.wan.philips.com</email></para> + </listitem> + + <listitem> + <para>Eiji-usagi-MATSUmoto <email>usagi@clave.gr.jp</email></para> + </listitem> + + <listitem> + <para>ELISA Font Project</para> + </listitem> + + <listitem> + <para>Elmar Bartel + <email>bartel@informatik.tu-muenchen.de</email></para> + </listitem> + + <listitem> + <para>Eric A. Griff <email>eagriff@global2000.net</email></para> + </listitem> + + <listitem> + <para>Eric Blood <email>eblood@cs.unr.edu</email></para> + </listitem> + + <listitem> + <para>Eric J. Haug <email>ejh@slustl.slu.edu</email></para> + </listitem> + + <listitem> + <para>Eric J. Schwertfeger <email>eric@cybernut.com</email></para> + </listitem> + + <listitem> + <para>Eric L. Hernes <email>erich@lodgenet.com</email></para> + </listitem> + + <listitem> + <para>Eric P. Scott <email>eps@sirius.com</email></para> + </listitem> + + <listitem> + <para>Eric Sprinkle <email>eric@ennovatenetworks.com</email></para> + </listitem> + + <listitem> + <para>Erich Stefan Boleyn <email>erich@uruk.org</email></para> + </listitem> + + <listitem> + <para>Erik E. Rantapaa <email>rantapaa@math.umn.edu</email></para> + </listitem> + + <listitem> + <para>Erik H. Moe <email>ehm@cris.com</email></para> + </listitem> + + <listitem> + <para>Ernst Winter <email>ewinter@lobo.muc.de</email></para> + </listitem> + + <listitem> + <para>Eugene M. Kim <email>astralblue@usa.net</email></para> + </listitem> + + <listitem> + <para>Eugene Radchenko <email>genie@qsar.chem.msu.su</email></para> + </listitem> + + <listitem> + <para>Evan Champion <email>evanc@synapse.net</email></para> + </listitem> + + <listitem> + <para>Faried Nawaz <email>fn@Hungry.COM</email></para> + </listitem> + + <listitem> + <para>Flemming Jacobsen <email>fj@tfs.com</email></para> + </listitem> + + <listitem> + <para>Fong-Ching Liaw <email>fong@juniper.net</email></para> + </listitem> + + <listitem> + <para>Francis M J Hsieh <email>mjshieh@life.nthu.edu.tw</email></para> + </listitem> + + <listitem> + <para>Frank Bartels <email>knarf@camelot.de</email></para> + </listitem> + + <listitem> + <para>Frank Chen Hsiung Chan + <email>frankch@waru.life.nthu.edu.tw</email></para> + </listitem> + + <listitem> + <para>Frank Durda IV <email>uhclem@nemesis.lonestar.org</email></para> + </listitem> + + <listitem> + <para>Frank MacLachlan <email>fpm@n2.net</email></para> + </listitem> + + <listitem> + <para>Frank Nobis <email>fn@Radio-do.de</email></para> + </listitem> + + <listitem> + <para>Frank Volf <email>volf@oasis.IAEhv.nl</email></para> + </listitem> + + <listitem> + <para>Frank ten Wolde <email>franky@pinewood.nl</email></para> + </listitem> + + <listitem> + <para>Frank van der Linden <email>frank@fwi.uva.nl</email></para> + </listitem> + + <listitem> + <para>Fred Cawthorne <email>fcawth@jjarray.umn.edu</email></para> + </listitem> + + <listitem> + <para>Fred Gilham <email>gilham@csl.sri.com</email></para> + </listitem> + + <listitem> + <para>Fred Templin <email>templin@erg.sri.com</email></para> + </listitem> + + <listitem> + <para>Frederick Earl Gray <email>fgray@rice.edu</email></para> + </listitem> + + <listitem> + <para>FUJIMOTO Kensaku + <email>fujimoto@oscar.elec.waseda.ac.jp</email></para> + </listitem> + + <listitem> + <para>FUJISHIMA Satsuki <email>k5@respo.or.jp</email></para> + </listitem> + + <listitem> + <para>FURUSAWA Kazuhisa + <email>furusawa@com.cs.osakafu-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Gabor Kincses <email>gabor@acm.org</email></para> + </listitem> + + <listitem> + <para>Gabor Zahemszky <email>zgabor@CoDe.hu</email></para> + </listitem> + + <listitem> + <para>Garance A Drosehn <email>gad@eclipse.its.rpi.edu</email></para> + </listitem> + + <listitem> + <para>Gareth McCaughan <email>gjm11@dpmms.cam.ac.uk</email></para> + </listitem> + + <listitem> + <para>Gary A. Browning <email>gab10@griffcd.amdahl.com</email></para> + </listitem> + + <listitem> + <para>Gary Howland <email>gary@hotlava.com</email></para> + </listitem> + + <listitem> + <para>Gary J. <email>garyj@rks32.pcs.dec.com</email></para> + </listitem> + + <listitem> + <para>Gary Kline <email>kline@thought.org</email></para> + </listitem> + + <listitem> + <para>Gaspar Chilingarov <email>nightmar@lemming.acc.am</email></para> + </listitem> + + <listitem> + <para>Gea-Suan Lin <email>gsl@tpts4.seed.net.tw</email></para> + </listitem> + + <listitem> + <para>Geoff Rehmet <email>csgr@alpha.ru.ac.za</email></para> + </listitem> + + <listitem> + <para>Georg Wagner <email>georg.wagner@ubs.com</email></para> + </listitem> + + <listitem> + <para>Gerard Roudier <email>groudier@club-internet.fr</email></para> + </listitem> + + <listitem> + <para>Gianmarco Giovannelli + <email>gmarco@giovannelli.it</email></para> + </listitem> + + <listitem> + <para>Gil Kloepfer Jr. <email>gil@limbic.ssdl.com</email></para> + </listitem> + + <listitem> + <para>Gilad Rom <email>rom_glsa@ein-hashofet.co.il</email></para> + </listitem> + + <listitem> + <para>Ginga Kawaguti + <email>ginga@amalthea.phys.s.u-tokyo.ac.jp</email></para> + </listitem> + + <listitem> + <para>Giles Lean <email>giles@nemeton.com.au</email></para> + </listitem> + + <listitem> + <para>Glen Foster <email>gfoster@gfoster.com</email></para> + </listitem> + + <listitem> + <para>Glenn Johnson <email>gljohns@bellsouth.net</email></para> + </listitem> + + <listitem> + <para>Godmar Back <email>gback@facility.cs.utah.edu</email></para> + </listitem> + + <listitem> + <para>Goran Hammarback <email>goran@astro.uu.se</email></para> + </listitem> + + <listitem> + <para>Gord Matzigkeit <email>gord@enci.ucalgary.ca</email></para> + </listitem> + + <listitem> + <para>Graham Wheeler <email>gram@cdsec.com</email></para> + </listitem> + + <listitem> + <para>Greg A. Woods <email>woods@zeus.leitch.com</email></para> + </listitem> + + <listitem> + <para>Greg Ansley <email>gja@ansley.com</email></para> + </listitem> + + <listitem> + <para>Greg Troxel <email>gdt@ir.bbn.com</email></para> + </listitem> + + <listitem> + <para>Greg Ungerer <email>gerg@stallion.oz.au</email></para> + </listitem> + + <listitem> + <para>Gregory Bond <email>gnb@itga.com.au</email></para> + </listitem> + + <listitem> + <para>Gregory D. Moncreaff + <email>moncrg@bt340707.res.ray.com</email></para> + </listitem> + + <listitem> + <para>Guy Harris <email>guy@netapp.com</email></para> + </listitem> + + <listitem> + <para>Guy Helmer <email>ghelmer@cs.iastate.edu</email></para> + </listitem> + + <listitem> + <para>HAMADA Naoki <email>hamada@astec.co.jp</email></para> + </listitem> + + <listitem> + <para>HONDA Yasuhiro + <email>honda@kashio.info.mie-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>HOSOBUCHI Noriyuki <email>hoso@buchi.tama.or.jp</email></para> + </listitem> + + <listitem> + <para>Hannu Savolainen <email>hannu@voxware.pp.fi</email></para> + </listitem> + + <listitem> + <para>Hans Huebner <email>hans@artcom.de</email></para> + </listitem> + + <listitem> + <para>Hans Petter Bieker <email>zerium@webindex.no</email></para> + </listitem> + + <listitem> + <para>Hans Zuidam <email>hans@brandinnovators.com</email></para> + </listitem> + + <listitem> + <para>Harlan Stenn <email>Harlan.Stenn@pfcs.com</email></para> + </listitem> + + <listitem> + <para>Harold Barker <email>hbarker@dsms.com</email></para> + </listitem> + + <listitem> + <para>Havard Eidnes + <email>Havard.Eidnes@runit.sintef.no</email></para> + </listitem> + + <listitem> + <para>Heikki Suonsivu <email>hsu@cs.hut.fi</email></para> + </listitem> + + <listitem> + <para>Heiko W. Rupp <email>unknown</email></para> + </listitem> + + <listitem> + <para>Helmut F. Wirth <email>hfwirth@ping.at</email></para> + </listitem> + + <listitem> + <para>Henrik Vestergaard Draboel + <email>hvd@terry.ping.dk</email></para> + </listitem> + + <listitem> + <para>Herb Peyerl <email>hpeyerl@NetBSD.org</email></para> + </listitem> + + <listitem> + <para>Hideaki Ohmon <email>ohmon@tom.sfc.keio.ac.jp</email></para> + </listitem> + + <listitem> + <para>Hidekazu Kuroki <email>hidekazu@cs.titech.ac.jp</email></para> + </listitem> + + <listitem> + <para>Hideki Yamamoto <email>hyama@acm.org</email></para> + </listitem> + + <listitem> + <para>Hidetoshi Shimokawa + <email>simokawa@sat.t.u-tokyo.ac.jp</email></para> + </listitem> + + <listitem> + <para>Hideyuki Suzuki + <email>hideyuki@sat.t.u-tokyo.ac.jp</email></para> + </listitem> + + <listitem> + <para>Hirayama Issei <email>iss@mail.wbs.ne.jp</email></para> + </listitem> + + <listitem> + <para>Hiroaki Sakai <email>sakai@miya.ee.kagu.sut.ac.jp</email></para> + </listitem> + + <listitem> + <para>Hiroharu Tamaru <email>tamaru@ap.t.u-tokyo.ac.jp</email></para> + </listitem> + + <listitem> + <para>Hironori Ikura <email>hikura@kaisei.org</email></para> + </listitem> + + <listitem> + <para>Hiroshi Nishikawa <email>nis@pluto.dti.ne.jp</email></para> + </listitem> + + <listitem> + <para>Hiroya Tsubakimoto <email>unknown</email></para> + </listitem> + + <listitem> + <para>Hiroyuki NAKAJI + <email>nakaji@zeisei3.dpri.kyoto-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Holger Veit <email>Holger.Veit@gmd.de</email></para> + </listitem> + + <listitem> + <para>Holm Tiffe <email>holm@geophysik.tu-freiberg.de</email></para> + </listitem> + + <listitem> + <para>Horance Chou + <email>horance@freedom.ie.cycu.edu.tw</email></para> + </listitem> + + <listitem> + <para>Horihiro Kumagaio <email>kuma@jp.freebsd.org</email></para> + </listitem> + + <listitem> + <para>Horikawa Kazuo <email>k-horik@mail.yk.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>Hr.Ladavac <email>lada@ws2301.gud.siemens.co.at</email></para> + </listitem> + + <listitem> + <para>Hubert Feyrer <email>hubertf@NetBSD.ORG</email></para> + </listitem> + + <listitem> + <para>Hugh F. Mahon <email>hugh@nsmdserv.cnd.hp.com</email></para> + </listitem> + + <listitem> + <para>Hugh Mahon <email>h_mahon@fc.hp.com</email></para> + </listitem> + + <listitem> + <para>Hung-Chi Chu <email>hcchu@r350.ee.ntu.edu.tw</email></para> + </listitem> + + <listitem> + <para>IMAI Takeshi <email>take-i@ceres.dti.ne.jp</email></para> + </listitem> + + <listitem> + <para>IMAMURA Tomoaki + <email>tomoak-i@is.aist-nara.ac.jp</email></para> + </listitem> + + <listitem> + <para>Ian Dowse <email>iedowse@maths.tcd.ie</email></para> + </listitem> + + <listitem> + <para>Ian Holland <email>ianh@tortuga.com.au</email></para> + </listitem> + + <listitem> + <para>Ian Struble <email>ian@broken.net</email></para> + </listitem> + + <listitem> + <para>Ian Vaudrey <email>i.vaudrey@bigfoot.com</email></para> + </listitem> + + <listitem> + <para>Igor Khasilev <email>igor@jabber.paco.odessa.ua</email></para> + </listitem> + + <listitem> + <para>Igor Roshchin <email>str@giganda.komkon.org</email></para> + </listitem> + + <listitem> + <para>Igor Sviridov <email>siac@ua.net</email></para> + </listitem> + + <listitem> + <para>Igor Vinokurov <email>igor@zynaps.ru</email></para> + </listitem> + + <listitem> + <para>Ikuo Nakagawa <email>ikuo@isl.intec.co.jp</email></para> + </listitem> + + <listitem> + <para>Ilya V. Komarov <email>mur@lynx.ru</email></para> + </listitem> + + <listitem> + <para>Issei Suzuki <email>issei@jp.FreeBSD.org</email></para> + </listitem> + + <listitem> + <para>Itsuro Saito <email>saito@miv.t.u-tokyo.ac.jp</email></para> + </listitem> + + <listitem> + <para>J. Bryant <email>jbryant@argus.flash.net</email></para> + </listitem> + + <listitem> + <para>J. David Lowe <email>lowe@saturn5.com</email></para> + </listitem> + + <listitem> + <para>J. Han <email>hjh@best.com</email></para> + </listitem> + + <listitem> + <para>J. Hawk <email>jhawk@MIT.EDU</email></para> + </listitem> + + <listitem> + <para>J.T. Conklin <email>jtc@cygnus.com</email></para> + </listitem> + + <listitem> + <para>J.T. Jang <email>keith@email.gcn.net.tw</email></para> + </listitem> + + <listitem> + <para>Jack <email>jack@zeus.xtalwind.net</email></para> + </listitem> + + <listitem> + <para>Jacob Bohn Lorensen <email>jacob@jblhome.ping.mk</email></para> + </listitem> + + <listitem> + <para>Jagane D Sundar <email>jagane@netcom.com</email></para> + </listitem> + + <listitem> + <para>Jake Hamby <email>jehamby@lightside.com</email></para> + </listitem> + + <listitem> + <para>James Clark <email>jjc@jclark.com</email></para> + </listitem> + + <listitem> + <para>James D. Stewart <email>jds@c4systm.com</email></para> + </listitem> + + <listitem> + <para>James Jegers <email>jimj@miller.cs.uwm.edu</email></para> + </listitem> + + <listitem> + <para>James Raynard + <email>fhackers@jraynard.demon.co.uk</email></para> + </listitem> + + <listitem> + <para>James T. Liu <email>jtliu@phlebas.rockefeller.edu</email></para> + </listitem> + + <listitem> + <para>James da Silva <email>jds@cs.umd.edu</email></para> + </listitem> + + <listitem> + <para>Jan Conard + <email>charly@fachschaften.tu-muenchen.de</email></para> + </listitem> + + <listitem> + <para>Jan Koum <email>jkb@FreeBSD.org</email></para> + </listitem> + + <listitem> + <para>Janick Taillandier + <email>Janick.Taillandier@ratp.fr</email></para> + </listitem> + + <listitem> + <para>Janusz Kokot <email>janek@gaja.ipan.lublin.pl</email></para> + </listitem> + + <listitem> + <para>Jarle Greipsland <email>jarle@idt.unit.no</email></para> + </listitem> + + <listitem> + <para>Jason Garman <email>init@risen.org</email></para> + </listitem> + + <listitem> + <para>Jason Thorpe <email>thorpej@NetBSD.org</email></para> + </listitem> + + <listitem> + <para>Jason Wright <email>jason@OpenBSD.org</email></para> + </listitem> + + <listitem> + <para>Jason Young + <email>doogie@forbidden-donut.anet-stl.com</email></para> + </listitem> + + <listitem> + <para>Javier Martin Rueda <email>jmrueda@diatel.upm.es</email></para> + </listitem> + + <listitem> + <para>Jay Fenlason <email>hack@datacube.com</email></para> + </listitem> + + <listitem> + <para>Jaye Mathisen <email>mrcpu@cdsnet.net</email></para> + </listitem> + + <listitem> + <para>Jeff Bartig <email>jeffb@doit.wisc.edu</email></para> + </listitem> + + <listitem> + <para>Jeff Forys <email>jeff@forys.cranbury.nj.us</email></para> + </listitem> + + <listitem> + <para>Jeff Kletsky <email>Jeff@Wagsky.com</email></para> + </listitem> + + <listitem> + <para>Jeffrey Evans <email>evans@scnc.k12.mi.us</email></para> + </listitem> + + <listitem> + <para>Jeffrey Wheat <email>jeff@cetlink.net</email></para> + </listitem> + + <listitem> + <para>Jens Schweikhardt + <email>schweikh@ito.uni-stuttgart.de</email></para> + </listitem> + + <listitem> + <para>Jeremy Allison <email>jallison@whistle.com</email></para> + </listitem> + + <listitem> + <para>Jeremy Chatfield <email>jdc@xinside.com</email></para> + </listitem> + + <listitem> + <para>Jeremy Lea <email>reg@shale.csir.co.za</email></para> + </listitem> + + <listitem> + <para>Jeremy Prior <email>unknown</email></para> + </listitem> + + <listitem> + <para>Jeroen Ruigrok/Asmodai <email>asmodai@wxs.nl</email></para> + </listitem> + + <listitem> + <para>Jesse Rosenstock <email>jmr@ugcs.caltech.edu</email></para> + </listitem> + + <listitem> + <para>Jian-Da Li <email>jdli@csie.nctu.edu.tw</email></para> + </listitem> + + <listitem> + <para>Jim Babb <email>babb@FreeBSD.org</email></para> + </listitem> + + <listitem> + <para>Jim Binkley <email>jrb@cs.pdx.edu</email></para> + </listitem> + + <listitem> + <para>Jim Carroll <email>jim@carroll.com</email></para> + </listitem> + + <listitem> + <para>Jim Flowers <email>jflowers@ezo.net</email></para> + </listitem> + + <listitem> + <para>Jim Leppek <email>jleppek@harris.com</email></para> + </listitem> + + <listitem> + <para>Jim Lowe <email>james@cs.uwm.edu</email></para> + </listitem> + + <listitem> + <para>Jim Mattson <email>jmattson@sonic.net</email></para> + </listitem> + + <listitem> + <para>Jim Mercer <email>jim@komodo.reptiles.org</email></para> + </listitem> + + <listitem> + <para>Jim Mock <email>jim@phrantic.phear.net</email></para> + </listitem> + + <listitem> + <para>Jim Wilson <email>wilson@moria.cygnus.com</email></para> + </listitem> + + <listitem> + <para>Jimbo Bahooli + <email>griffin@blackhole.iceworld.org</email></para> + </listitem> + + <listitem> + <para>Jin Guojun <email>jin@george.lbl.gov</email></para> + </listitem> + + <listitem> + <para>Joachim Kuebart <email>unknown</email></para> + </listitem> + + <listitem> + <para>Joao Carlos Mendes Luis <email>jonny@jonny.eng.br</email></para> + </listitem> + + <listitem> + <para>Jochen Pohl <email>jpo.drs@sni.de</email></para> + </listitem> + + <listitem> + <para>Joe "Marcus" Clarke <email>marcus@miami.edu</email></para> + </listitem> + + <listitem> + <para>Joe Abley <email>jabley@clear.co.nz</email></para> + </listitem> + + <listitem> + <para>Joe Jih-Shian Lu <email>jslu@dns.ntu.edu.tw</email></para> + </listitem> + + <listitem> + <para>Joe Orthoefer <email>j_orthoefer@tia.net</email></para> + </listitem> + + <listitem> + <para>Joe Traister <email>traister@mojozone.org</email></para> + </listitem> + + <listitem> + <para>Joel Faedi <email>Joel.Faedi@esial.u-nancy.fr</email></para> + </listitem> + + <listitem> + <para>Joel Ray Holveck <email>joelh@gnu.org</email></para> + </listitem> + + <listitem> + <para>Joel Sutton <email>sutton@aardvark.apana.org.au</email></para> + </listitem> + + <listitem> + <para>Johan Granlund <email>johan@granlund.nu</email></para> + </listitem> + + <listitem> + <para>Johan Karlsson <email>k@numeri.campus.luth.se</email></para> + </listitem> + + <listitem> + <para>Johan Larsson <email>johan@moon.campus.luth.se</email></para> + </listitem> + + <listitem> + <para>Johann Tonsing <email>jtonsing@mikom.csir.co.za</email></para> + </listitem> + + <listitem> + <para>Johannes Helander <email>unknown</email></para> + </listitem> + + <listitem> + <para>Johannes Stille <email>unknown</email></para> + </listitem> + + <listitem> + <para>John Baldwin <email>jobaldwi@vt.edu</email></para> + </listitem> + + <listitem> + <para>John Beckett <email>jbeckett@southern.edu</email></para> + </listitem> + + <listitem> + <para>John Beukema <email>jbeukema@hk.super.net</email></para> + </listitem> + + <listitem> + <para>John Brezak <email>unknown</email></para> + </listitem> + + <listitem> + <para>John Capo <email>jc@irbs.com</email></para> + </listitem> + + <listitem> + <para>John F. Woods <email>jfw@jfwhome.funhouse.com</email></para> + </listitem> + + <listitem> + <para>John Goerzen + <email>jgoerzen@alexanderwohl.complete.org</email></para> + </listitem> + + <listitem> + <para>John Hay <email>jhay@mikom.csir.co.za</email></para> + </listitem> + + <listitem> + <para>John Heidemann <email>johnh@isi.edu</email></para> + </listitem> + + <listitem> + <para>John Hood <email>cgull@owl.org</email></para> + </listitem> + + <listitem> + <para>John Kohl <email>unknown</email></para> + </listitem> + + <listitem> + <para>John Lind <email>john@starfire.mn.org</email></para> + </listitem> + + <listitem> + <para>John Mackin <email>john@physiol.su.oz.au</email></para> + </listitem> + + <listitem> + <para>John P <email>johnp@lodgenet.com</email></para> + </listitem> + + <listitem> + <para>John Perry <email>perry@vishnu.alias.net</email></para> + </listitem> + + <listitem> + <para>John Preisler <email>john@vapornet.com</email></para> + </listitem> + + <listitem> + <para>John Rochester <email>jr@cs.mun.ca</email></para> + </listitem> + + <listitem> + <para>John Sadler <email>john_sadler@alum.mit.edu</email></para> + </listitem> + + <listitem> + <para>John Saunders <email>john@pacer.nlc.net.au</email></para> + </listitem> + + <listitem> + <para>John W. DeBoskey <email>jwd@unx.sas.com</email></para> + </listitem> + + <listitem> + <para>John Wehle <email>john@feith.com</email></para> + </listitem> + + <listitem> + <para>John Woods <email>jfw@eddie.mit.edu</email></para> + </listitem> + + <listitem> + <para>Jon Morgan <email>morgan@terminus.trailblazer.com</email></para> + </listitem> + + <listitem> + <para>Jonathan H N Chin <email>jc254@newton.cam.ac.uk</email></para> + </listitem> + + <listitem> + <para>Jonathan Hanna + <email>jh@pc-21490.bc.rogers.wave.ca</email></para> + </listitem> + + <listitem> + <para>Jorge Goncalves <email>j@bug.fe.up.pt</email></para> + </listitem> + + <listitem> + <para>Jorge M. Goncalves <email>ee96199@tom.fe.up.pt</email></para> + </listitem> + + <listitem> + <para>Jos Backus <email>jbackus@plex.nl</email></para> + </listitem> + + <listitem> + <para>Jose M. Alcaide <email>jose@we.lc.ehu.es</email></para> + </listitem> + + <listitem> + <para>Josef Grosch + <email>jgrosch@superior.mooseriver.com</email></para> + </listitem> + + <listitem> + <para>Josef Karthauser <email>joe@uk.freebsd.org</email></para> + </listitem> + + <listitem> + <para>Joseph Stein <email>joes@seaport.net</email></para> + </listitem> + + <listitem> + <para>Josh Gilliam <email>josh@quick.net</email></para> + </listitem> + + <listitem> + <para>Josh Tiefenbach <email>josh@ican.net</email></para> + </listitem> + + <listitem> + <para>Juergen Lock <email>nox@jelal.hb.north.de</email></para> + </listitem> + + <listitem> + <para>Juha Inkari <email>inkari@cc.hut.fi</email></para> + </listitem> + + <listitem> + <para>Jukka A. Ukkonen <email>jua@iki.fi</email></para> + </listitem> + + <listitem> + <para>Julian Assange <email>proff@suburbia.net</email></para> + </listitem> + + <listitem> + <para>Julian Coleman <email>j.d.coleman@ncl.ac.uk</email></para> + </listitem> + + <listitem> + <para>Julian H. Stacey <email>jhs@freebsd.org</email></para> + </listitem> + + <listitem> + <para>Julian Jenkins <email>kaveman@magna.com.au</email></para> + </listitem> + + <listitem> + <para>Junichi Satoh <email>junichi@jp.freebsd.org</email></para> + </listitem> + + <listitem> + <para>Junji SAKAI <email>sakai@jp.freebsd.org</email></para> + </listitem> + + <listitem> + <para>Junya WATANABE <email>junya-w@remus.dti.ne.jp</email></para> + </listitem> + + <listitem> + <para>K.Higashino <email>a00303@cc.hc.keio.ac.jp</email></para> + </listitem> + + <listitem> + <para>KUNISHIMA Takeo <email>kunishi@c.oka-pu.ac.jp</email></para> + </listitem> + + <listitem> + <para>Kai Vorma <email>vode@snakemail.hut.fi</email></para> + </listitem> + + <listitem> + <para>Kaleb S. Keithley <email>kaleb@ics.com</email></para> + </listitem> + + <listitem> + <para>Kaneda Hiloshi <email>vanitas@ma3.seikyou.ne.jp</email></para> + </listitem> + + <listitem> + <para>Kapil Chowksey <email>kchowksey@hss.hns.com</email></para> + </listitem> + + <listitem> + <para>Karl Denninger <email>karl@mcs.com</email></para> + </listitem> + + <listitem> + <para>Karl Dietz <email>Karl.Dietz@triplan.com</email></para> + </listitem> + + <listitem> + <para>Karl Lehenbauer <email>karl@NeoSoft.com</email></para> + </listitem> + + <listitem> + <para>Kato Takenori + <email>kato@eclogite.eps.nagoya-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Kauzo Horikawa <email>h-horik@yk.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>Kawanobe Koh <email>kawanobe@st.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>Kazuhiko Kiriyama <email>kiri@kiri.toba-cmt.ac.jp</email></para> + </listitem> + + <listitem> + <para>Kazuo Horikawa <email>horikawa@jp.FreeBSD.org</email></para> + </listitem> + + <listitem> + <para>Kees Jan Koster <email>kjk1@ukc.ac.uk</email></para> + </listitem> + + <listitem> + <para>Keith Bostic <email>bostic@bostic.com</email></para> + </listitem> + + <listitem> + <para>Keith E. Walker <email>unknown</email></para> + </listitem> + + <listitem> + <para>Keith Moore <email>unknown</email></para> + </listitem> + + <listitem> + <para>Keith Sklower <email>unknown</email></para> + </listitem> + + <listitem> + <para>Ken Hornstein <email>unknown</email></para> + </listitem> + + <listitem> + <para>Ken Key <email>key@cs.utk.edu</email></para> + </listitem> + + <listitem> + <para>Ken Mayer <email>kmayer@freegate.com</email></para> + </listitem> + + <listitem> + <para>Kenji Saito <email>marukun@mx2.nisiq.net</email></para> + </listitem> + + <listitem> + <para>Kenji Tomita <email>tommyk@da2.so-net.or.jp</email></para> + </listitem> + + <listitem> + <para>Kenneth Furge <email>kenneth.furge@us.endress.com</email></para> + </listitem> + + <listitem> + <para>Kenneth Monville <email>desmo@bandwidth.org</email></para> + </listitem> + + <listitem> + <para>Kenneth R. Westerback <email>krw@tcn.net</email></para> + </listitem> + + <listitem> + <para>Kenneth Stailey <email>kstailey@gnu.ai.mit.edu</email></para> + </listitem> + + <listitem> + <para>Kent Talarico <email>kent@shipwreck.tsoft.net</email></para> + </listitem> + + <listitem> + <para>Kent Vander Velden <email>graphix@iastate.edu</email></para> + </listitem> + + <listitem> + <para>Kentaro Inagaki <email>JBD01226@niftyserve.ne.jp</email></para> + </listitem> + + <listitem> + <para>Kevin Bracey <email>kbracey@art.acorn.co.uk</email></para> + </listitem> + + <listitem> + <para>Kevin Day <email>toasty@dragondata.com</email></para> + </listitem> + + <listitem> + <para>Kevin Lahey <email>kml@nas.nasa.gov</email></para> + </listitem> + + <listitem> + <para>Kevin Street <email>street@iname.com</email></para> + </listitem> + + <listitem> + <para>Kevin Van Maren <email>vanmaren@fast.cs.utah.edu</email></para> + </listitem> + + <listitem> + <para>Kiroh HARADA <email>kiroh@kh.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>Klaus Klein <email>kleink@layla.inka.de</email></para> + </listitem> + + <listitem> + <para>Klaus-J. Wolf <email>Yanestra@t-online.de</email></para> + </listitem> + + <listitem> + <para>Koichi Sato <email>copan@ppp.fastnet.or.jp</email></para> + </listitem> + + <listitem> + <para>Kostya Lukin <email>lukin@okbmei.msk.su</email></para> + </listitem> + + <listitem> + <para>Kouichi Hirabayashi <email>kh@mogami-wire.co.jp</email></para> + </listitem> + + <listitem> + <para>Kurt D. Zeilenga <email>Kurt@Boolean.NET</email></para> + </listitem> + + <listitem> + <para>Kurt Olsen <email>kurto@tiny.mcs.usu.edu</email></para> + </listitem> + + <listitem> + <para>L. Jonas Olsson + <email>ljo@ljo-slip.DIALIN.CWRU.Edu</email></para> + </listitem> + + <listitem> + <para>Lars Köller + <email>Lars.Koeller@Uni-Bielefeld.DE</email></para> + </listitem> + + <listitem> + <para>Larry Altneu <email>larry@ALR.COM</email></para> + </listitem> + + <listitem> + <para>Laurence Lopez <email>lopez@mv.mv.com</email></para> + </listitem> + + <listitem> + <para>Lee Cremeans <email>lcremean@tidalwave.net</email></para> + </listitem> + + <listitem> + <para>Liang Tai-hwa + <email>avatar@www.mmlab.cse.yzu.edu.tw</email></para> + </listitem> + + <listitem> + <para>Lon Willett <email>lon%softt.uucp@math.utah.edu</email></para> + </listitem> + + <listitem> + <para>Louis A. Mamakos <email>louie@TransSys.COM</email></para> + </listitem> + + <listitem> + <para>Louis Mamakos <email>loiue@TransSys.com</email></para> + </listitem> + + <listitem> + <para>Lucas James <email>Lucas.James@ldjpc.apana.org.au</email></para> + </listitem> + + <listitem> + <para>Lyndon Nerenberg <email>lyndon@orthanc.com</email></para> + </listitem> + + <listitem> + <para>M.C. Wong <email>unknown</email></para> + </listitem> + + <listitem> + <para>MANTANI Nobutaka <email>nobutaka@nobutaka.com</email></para> + </listitem> + + <listitem> + <para>MIHIRA Sanpei Yoshiro <email>sanpei@sanpei.org</email></para> + </listitem> + + <listitem> + <para>MITA Yoshio <email>mita@jp.FreeBSD.ORG</email></para> + </listitem> + + <listitem> + <para>MITSUNAGA Noriaki + <email>mitchy@er.ams.eng.osaka-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>MOROHOSHI Akihiko <email>moro@race.u-tokyo.ac.jp</email></para> + </listitem> + + <listitem> + <para>Magnus Enbom <email>dot@tinto.campus.luth.se</email></para> + </listitem> + + <listitem> + <para>Mahesh Neelakanta <email>mahesh@gcomm.com</email></para> + </listitem> + + <listitem> + <para>Makoto MATSUSHITA <email>matusita@jp.freebsd.org</email></para> + </listitem> + + <listitem> + <para>Makoto WATANABE + <email>watanabe@zlab.phys.nagoya-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Malte Lance <email>malte.lance@gmx.net</email></para> + </listitem> + + <listitem> + <para>Manu Iyengar + <email>iyengar@grunthos.pscwa.psca.com</email></para> + </listitem> + + <listitem> + <para>Marc Frajola <email>marc@dev.com</email></para> + </listitem> + + <listitem> + <para>Marc Ramirez <email>mrami@mramirez.sy.yale.edu</email></para> + </listitem> + + <listitem> + <para>Marc Slemko <email>marcs@znep.com</email></para> + </listitem> + + <listitem> + <para>Marc van Kempen <email>wmbfmk@urc.tue.nl</email></para> + </listitem> + + <listitem> + <para>Marcel Moolenaar <email>marcel@scc.nl</email></para> + </listitem> + + <listitem> + <para>Mario Sergio Fujikawa Ferreira + <email>lioux@gns.com.br</email></para> + </listitem> + + <listitem> + <para>Mark Andrews <email>unknown</email></para> + </listitem> + + <listitem> + <para>Mark Cammidge <email>mark@gmtunx.ee.uct.ac.za</email></para> + </listitem> + + <listitem> + <para>Mark Diekhans <email>markd@grizzly.com</email></para> + </listitem> + + <listitem> + <para>Mark Huizer <email>xaa@stack.nl</email></para> + </listitem> + + <listitem> + <para>Mark J. Taylor <email>mtaylor@cybernet.com</email></para> + </listitem> + + <listitem> + <para>Mark Krentel <email>krentel@rice.edu</email></para> + </listitem> + + <listitem> + <para>Mark Mayo <email>markm@vmunix.com</email></para> + </listitem> + + <listitem> + <para>Mark Thompson <email>thompson@tgsoft.com</email></para> + </listitem> + + <listitem> + <para>Mark Tinguely <email>tinguely@plains.nodak.edu</email></para> + </listitem> + + <listitem> + <para>Mark Treacy <email>unknown</email></para> + </listitem> + + <listitem> + <para>Mark Valentine <email>mark@linus.demon.co.uk</email></para> + </listitem> + + <listitem> + <para>Martin Birgmeier</para> + </listitem> + + <listitem> + <para>Martin Ibert <email>mib@ppe.bb-data.de</email></para> + </listitem> + + <listitem> + <para>Martin Kammerhofer <email>dada@sbox.tu-graz.ac.at</email></para> + </listitem> + + <listitem> + <para>Martin Renters <email>martin@tdc.on.ca</email></para> + </listitem> + + <listitem> + <para>Martti Kuparinen + <email>erakupa@kk.etx.ericsson.se</email></para> + </listitem> + + <listitem> + <para>Masachika ISHIZUKA + <email>ishizuka@isis.min.ntt.jp</email></para> + </listitem> + + <listitem> + <para>Mas.TAKEMURA <email>unknown</email></para> + </listitem> + + <listitem> + <para>Masafumi NAKANE <email>max@wide.ad.jp</email></para> + </listitem> + + <listitem> + <para>Masahiro Sekiguchi + <email>seki@sysrap.cs.fujitsu.co.jp</email></para> + </listitem> + + <listitem> + <para>Masanobu Saitoh <email>msaitoh@spa.is.uec.ac.jp</email></para> + </listitem> + + <listitem> + <para>Masanori Kanaoka <email>kana@saijo.mke.mei.co.jp</email></para> + </listitem> + + <listitem> + <para>Masanori Kiriake <email>seiken@ncs.co.jp</email></para> + </listitem> + + <listitem> + <para>Masatoshi TAMURA + <email>tamrin@shinzan.kuee.kyoto-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Mats Lofkvist <email>mal@algonet.se</email></para> + </listitem> + + <listitem> + <para>Matt Bartley <email>mbartley@lear35.cytex.com</email></para> + </listitem> + + <listitem> + <para>Matt Thomas <email>matt@3am-software.com</email></para> + </listitem> + + <listitem> + <para>Matt White <email>mwhite+@CMU.EDU</email></para> + </listitem> + + <listitem> + <para>Matthew C. Mead <email>mmead@Glock.COM</email></para> + </listitem> + + <listitem> + <para>Matthew Cashdollar <email>mattc@rfcnet.com</email></para> + </listitem> + + <listitem> + <para>Matthew Flatt <email>mflatt@cs.rice.edu</email></para> + </listitem> + + <listitem> + <para>Matthew Fuller <email>fullermd@futuresouth.com</email></para> + </listitem> + + <listitem> + <para>Matthew N. Dodd <email>winter@jurai.net</email></para> + </listitem> + + <listitem> + <para>Matthew Stein <email>matt@bdd.net</email></para> + </listitem> + + <listitem> + <para>Matthias Pfaller <email>leo@dachau.marco.de</email></para> + </listitem> + + <listitem> + <para>Matthias Scheler <email>tron@netbsd.org</email></para> + </listitem> + + <listitem> + <para>Mattias Gronlund + <email>Mattias.Gronlund@sa.erisoft.se</email></para> + </listitem> + + <listitem> + <para>Mattias Pantzare <email>pantzer@ludd.luth.se</email></para> + </listitem> + + <listitem> + <para>Maurice Castro + <email>maurice@planet.serc.rmit.edu.au</email></para> + </listitem> + + <listitem> + <para>Max Euston <email>meuston@jmrodgers.com</email></para> + </listitem> + + <listitem> + <para>Max Khon <email>fjoe@husky.iclub.nsu.ru</email></para> + </listitem> + + <listitem> + <para>Maxim Bolotin <email>max@rsu.ru</email></para> + </listitem> + + <listitem> + <para>Micha Class + <email>michael_class@hpbbse.bbn.hp.com</email></para> + </listitem> + + <listitem> + <para>Michael Butler <email>imb@scgt.oz.au</email></para> + </listitem> + + <listitem> + <para>Michael Butschky <email>butsch@computi.erols.com</email></para> + </listitem> + + <listitem> + <para>Michael Clay <email>mclay@weareb.org</email></para> + </listitem> + + <listitem> + <para>Michael Elbel <email>me@FreeBSD.ORG</email></para> + </listitem> + + <listitem> + <para>Michael Galassi <email>nerd@percival.rain.com</email></para> + </listitem> + + <listitem> + <para>Michael Hancock <email>michaelh@cet.co.jp</email></para> + </listitem> + + <listitem> + <para>Michael Hohmuth <email>hohmuth@inf.tu-dresden.de</email></para> + </listitem> + + <listitem> + <para>Michael Perlman <email>canuck@caam.rice.edu</email></para> + </listitem> + + <listitem> + <para>Michael Petry <email>petry@netwolf.NetMasters.com</email></para> + </listitem> + + <listitem> + <para>Michael Reifenberger <email>root@totum.plaut.de</email></para> + </listitem> + + <listitem> + <para>Michael Searle <email>searle@longacre.demon.co.uk</email></para> + </listitem> + + <listitem> + <para>Michal Listos <email>mcl@Amnesiac.123.org</email></para> + </listitem> + + <listitem> + <para>Michio Karl Jinbo + <email>karl@marcer.nagaokaut.ac.jp</email></para> + </listitem> + + <listitem> + <para>Miguel Angel Sagreras + <email>msagre@cactus.fi.uba.ar</email></para> + </listitem> + + <listitem> + <para>Mihoko Tanaka <email>m_tonaka@pa.yokogawa.co.jp</email></para> + </listitem> + + <listitem> + <para>Mika Nystrom <email>mika@cs.caltech.edu</email></para> + </listitem> + + <listitem> + <para>Mikael Hybsch <email>micke@dynas.se</email></para> + </listitem> + + <listitem> + <para>Mikael Karpberg + <email>karpen@ocean.campus.luth.se</email></para> + </listitem> + + <listitem> + <para>Mike Del <email>repenting@hotmail.com</email></para> + </listitem> + + <listitem> + <para>Mike Durian <email>durian@plutotech.com</email></para> + </listitem> + + <listitem> + <para>Mike Durkin <email>mdurkin@tsoft.sf-bay.org</email></para> + </listitem> + + <listitem> + <para>Mike E. Matsnev <email>mike@azog.cs.msu.su</email></para> + </listitem> + + <listitem> + <para>Mike Evans <email>mevans@candle.com</email></para> + </listitem> + + <listitem> + <para>Mike Grupenhoff <email>kashmir@umiacs.umd.edu</email></para> + </listitem> + + <listitem> + <para>Mike Hibler <email>mike@marker.cs.utah.edu</email></para> + </listitem> + + <listitem> + <para>Mike Karels <email>unknown</email></para> + </listitem> + + <listitem> + <para>Mike McGaughey <email>mmcg@cs.monash.edu.au</email></para> + </listitem> + + <listitem> + <para>Mike Meyer <email>mwm@shiva.the-park.com</email></para> + </listitem> + + <listitem> + <para>Mike Mitchell <email>mitchell@ref.tfs.com</email></para> + </listitem> + + <listitem> + <para>Mike Murphy <email>mrm@alpharel.com</email></para> + </listitem> + + <listitem> + <para>Mike Peck <email>mike@binghamton.edu</email></para> + </listitem> + + <listitem> + <para>Mike Spengler <email>mks@msc.edu</email></para> + </listitem> + + <listitem> + <para>Mikhail A. Sokolov <email>mishania@demos.su</email></para> + </listitem> + + <listitem> + <para>Mikhail Teterin <email>mi@aldan.ziplink.net</email></para> + </listitem> + + <listitem> + <para>Ming-I Hseh <email>PA@FreeBSD.ee.Ntu.edu.TW</email></para> + </listitem> + + <listitem> + <para>Mitsuru IWASAKI <email>iwasaki@pc.jaring.my</email></para> + </listitem> + + <listitem> + <para>Monte Mitzelfelt <email>monte@gonefishing.org</email></para> + </listitem> + + <listitem> + <para>Morgan Davis <email>root@io.cts.com</email></para> + </listitem> + + <listitem> + <para>Mostyn Lewis <email>mostyn@mrl.com</email></para> + </listitem> + + <listitem> + <para>Motoyuki Kasahara <email>m-kasahr@sra.co.jp</email></para> + </listitem> + + <listitem> + <para>Motoyuki Konno <email>motoyuki@snipe.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>Munechika Sumikawa <email>sumikawa@kame.net</email></para> + </listitem> + + <listitem> + <para>Murray Stokely <email>murray@cdrom.com</email></para> + </listitem> + + <listitem> + <para>N.G.Smith <email>ngs@sesame.hensa.ac.uk</email></para> + </listitem> + + <listitem> + <para>NAGAO Tadaaki <email>nagao@cs.titech.ac.jp</email></para> + </listitem> + + <listitem> + <para>NAKAJI Hiroyuki + <email>nakaji@zeisei.dpri.kyoto-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>NAKAMURA Kazushi <email>nkazushi@highway.or.jp</email></para> + </listitem> + + <listitem> + <para>NAKAMURA Motonori + <email>motonori@econ.kyoto-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>NIIMI Satoshi <email>sa2c@and.or.jp</email></para> + </listitem> + + <listitem> + <para>NOKUBI Hirotaka <email>h-nokubi@yyy.or.jp</email></para> + </listitem> + + <listitem> + <para>Nadav Eiron <email>nadav@barcode.co.il</email></para> + </listitem> + + <listitem> + <para>Nanbor Wang <email>nw1@cs.wustl.edu</email></para> + </listitem> + + <listitem> + <para>Naofumi Honda + <email>honda@Kururu.math.sci.hokudai.ac.jp</email></para> + </listitem> + + <listitem> + <para>Naoki Hamada <email>nao@tom-yam.or.jp</email></para> + </listitem> + + <listitem> + <para>Narvi <email>narvi@haldjas.folklore.ee</email></para> + </listitem> + + <listitem> + <para>Nathan Dorfman <email>nathan@rtfm.net</email></para> + </listitem> + + <listitem> + <para>Neal Fachan <email>kneel@ishiboo.com</email></para> + </listitem> + + <listitem> + <para>Neil Blakey-Milner <email>nbm@rucus.ru.ac.za</email></para> + </listitem> + + <listitem> + <para>Niall Smart <email>rotel@indigo.ie</email></para> + </listitem> + + <listitem> + <para>Nick Barnes <email>Nick.Barnes@pobox.com</email></para> + </listitem> + + <listitem> + <para>Nick Handel <email>nhandel@NeoSoft.com</email></para> + </listitem> + + <listitem> + <para>Nick Hilliard <email>nick@foobar.org</email></para> + </listitem> + + <listitem> + <para>Nick Sayer <email>nsayer@quack.kfu.com</email></para> + </listitem> + + <listitem> + <para>Nick Williams <email>njw@cs.city.ac.uk</email></para> + </listitem> + + <listitem> + <para>Nickolay N. Dudorov <email>nnd@itfs.nsk.su</email></para> + </listitem> + + <listitem> + <para>Niklas Hallqvist <email>niklas@filippa.appli.se</email></para> + </listitem> + + <listitem> + <para>Nisha Talagala <email>nisha@cs.berkeley.edu</email></para> + </listitem> + + <listitem> + <para>No Name <email>ZW6T-KND@j.asahi-net.or.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>adrian@virginia.edu</email></para> + </listitem> + + <listitem> + <para>No Name <email>alex@elvisti.kiev.ua</email></para> + </listitem> + + <listitem> + <para>No Name <email>anto@netscape.net</email></para> + </listitem> + + <listitem> + <para>No Name <email>bobson@egg.ics.nitch.ac.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>bovynf@awe.be</email></para> + </listitem> + + <listitem> + <para>No Name <email>burg@is.ge.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>chris@gnome.co.uk</email></para> + </listitem> + + <listitem> + <para>No Name <email>colsen@usa.net</email></para> + </listitem> + + <listitem> + <para>No Name <email>coredump@nervosa.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>dannyman@arh0300.urh.uiuc.edu</email></para> + </listitem> + + <listitem> + <para>No Name <email>davids@SECNET.COM</email></para> + </listitem> + + <listitem> + <para>No Name <email>derek@free.org</email></para> + </listitem> + + <listitem> + <para>No Name <email>devet@adv.IAEhv.nl</email></para> + </listitem> + + <listitem> + <para>No Name <email>djv@bedford.net</email></para> + </listitem> + + <listitem> + <para>No Name <email>dvv@sprint.net</email></para> + </listitem> + + <listitem> + <para>No Name <email>enami@ba2.so-net.or.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>flash@eru.tubank.msk.su</email></para> + </listitem> + + <listitem> + <para>No Name <email>flash@hway.ru</email></para> + </listitem> + + <listitem> + <para>No Name <email>fn@pain.csrv.uidaho.edu</email></para> + </listitem> + + <listitem> + <para>No Name <email>gclarkii@netport.neosoft.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>gordon@sheaky.lonestar.org</email></para> + </listitem> + + <listitem> + <para>No Name <email>graaf@iae.nl</email></para> + </listitem> + + <listitem> + <para>No Name <email>greg@greg.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>grossman@cygnus.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>gusw@fub46.zedat.fu-berlin.de</email></para> + </listitem> + + <listitem> + <para>No Name <email>hfir@math.rochester.edu</email></para> + </listitem> + + <listitem> + <para>No Name <email>hnokubi@yyy.or.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>iaint@css.tuu.utas.edu.au</email></para> + </listitem> + + <listitem> + <para>No Name <email>invis@visi.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>ishisone@sra.co.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>iverson@lionheart.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>jpt@magic.net</email></para> + </listitem> + + <listitem> + <para>No Name <email>junker@jazz.snu.ac.kr</email></para> + </listitem> + + <listitem> + <para>No Name <email>k-sugyou@ccs.mt.nec.co.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>kenji@reseau.toyonaka.osaka.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>kfurge@worldnet.att.net</email></para> + </listitem> + + <listitem> + <para>No Name <email>lh@aus.org</email></para> + </listitem> + + <listitem> + <para>No Name <email>lhecking@nmrc.ucc.ie</email></para> + </listitem> + + <listitem> + <para>No Name <email>mrgreen@mame.mu.oz.au</email></para> + </listitem> + + <listitem> + <para>No Name <email>nakagawa@jp.freebsd.org</email></para> + </listitem> + + <listitem> + <para>No Name <email>ohki@gssm.otsuka.tsukuba.ac.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>owaki@st.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>pechter@shell.monmouth.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>pete@pelican.pelican.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>pritc003@maroon.tc.umn.edu</email></para> + </listitem> + + <listitem> + <para>No Name <email>risner@stdio.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>roman@rpd.univ.kiev.ua</email></para> + </listitem> + + <listitem> + <para>No Name <email>root@ns2.redline.ru</email></para> + </listitem> + + <listitem> + <para>No Name <email>root@uglabgw.ug.cs.sunysb.edu</email></para> + </listitem> + + <listitem> + <para>No Name <email>stephen.ma@jtec.com.au</email></para> + </listitem> + + <listitem> + <para>No Name <email>sumii@is.s.u-tokyo.ac.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>takas-su@is.aist-nara.ac.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>tamone@eig.unige.ch</email></para> + </listitem> + + <listitem> + <para>No Name <email>tjevans@raleigh.ibm.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>tony-o@iij.ad.jp amurai@spec.co.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>torii@tcd.hitachi.co.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>uenami@imasy.or.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>uhlar@netlab.sk</email></para> + </listitem> + + <listitem> + <para>No Name <email>vode@hut.fi</email></para> + </listitem> + + <listitem> + <para>No Name <email>wlloyd@mpd.ca</email></para> + </listitem> + + <listitem> + <para>No Name <email>wlr@furball.wellsfargo.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>wmbfmk@urc.tue.nl</email></para> + </listitem> + + <listitem> + <para>No Name <email>yamagata@nwgpc.kek.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>ziggy@ryan.org</email></para> + </listitem> + + <listitem> + <para>Nobuhiro Yasutomi <email>nobu@psrc.isac.co.jp</email></para> + </listitem> + + <listitem> + <para>Nobuyuki Koganemaru + <email>kogane@koganemaru.co.jp</email></para> + </listitem> + + <listitem> + <para>Norio Suzuki <email>nosuzuki@e-mail.ne.jp</email></para> + </listitem> + + <listitem> + <para>Noritaka Ishizumi <email>graphite@jp.FreeBSD.ORG</email></para> + </listitem> + + <listitem> + <para>Noriyuki Soda <email>soda@sra.co.jp</email></para> + </listitem> + + <listitem> + <para>Olaf Wagner <email>wagner@luthien.in-berlin.de</email></para> + </listitem> + + <listitem> + <para>Oleg Sharoiko <email>os@rsu.ru</email></para> + </listitem> + + <listitem> + <para>Oliver Breuninger <email>ob@seicom.NET</email></para> + </listitem> + + <listitem> + <para>Oliver Friedrichs <email>oliver@secnet.com</email></para> + </listitem> + + <listitem> + <para>Oliver Fromme + <email>oliver.fromme@heim3.tu-clausthal.de</email></para> + </listitem> + + <listitem> + <para>Oliver Laumann + <email>net@informatik.uni-bremen.de</email></para> + </listitem> + + <listitem> + <para>Oliver Oberdorf <email>oly@world.std.com</email></para> + </listitem> + + <listitem> + <para>Olof Johansson <email>offe@ludd.luth.se</email></para> + </listitem> + + <listitem> + <para>Osokin Sergey aka oZZ <email>ozz@freebsd.org.ru</email></para> + </listitem> + + <listitem> + <para>Pace Willisson <email>pace@blitz.com</email></para> + </listitem> + + <listitem> + <para>Paco Rosich <email>rosich@modico.eleinf.uv.es</email></para> + </listitem> + + <listitem> + <para>Palle Girgensohn <email>girgen@partitur.se</email></para> + </listitem> + + <listitem> + <para>Parag Patel <email>parag@cgt.com</email></para> + </listitem> + + <listitem> + <para>Pascal Pederiva <email>pascal@zuo.dec.com</email></para> + </listitem> + + <listitem> + <para>Pasvorn Boonmark <email>boonmark@juniper.net</email></para> + </listitem> + + <listitem> + <para>Patrick Gardella <email>patrick@cre8tivegroup.com</email></para> + </listitem> + + <listitem> + <para>Patrick Hausen <email>unknown</email></para> + </listitem> + + <listitem> + <para>Paul Antonov <email>apg@demos.su</email></para> + </listitem> + + <listitem> + <para>Paul F. Werkowski <email>unknown</email></para> + </listitem> + + <listitem> + <para>Paul Fox <email>pgf@foxharp.boston.ma.us</email></para> + </listitem> + + <listitem> + <para>Paul Koch <email>koch@thehub.com.au</email></para> + </listitem> + + <listitem> + <para>Paul Kranenburg <email>pk@NetBSD.org</email></para> + </listitem> + + <listitem> + <para>Paul Mackerras <email>paulus@cs.anu.edu.au</email></para> + </listitem> + + <listitem> + <para>Paul Popelka <email>paulp@uts.amdahl.com</email></para> + </listitem> + + <listitem> + <para>Paul S. LaFollette, Jr. <email>unknown</email></para> + </listitem> + + <listitem> + <para>Paul Saab <email>paul@mu.org</email></para> + </listitem> + + <listitem> + <para>Paul Sandys <email>myj@nyct.net</email></para> + </listitem> + + <listitem> + <para>Paul T. Root <email>proot@horton.iaces.com</email></para> + </listitem> + + <listitem> + <para>Paul Vixie <email>paul@vix.com</email></para> + </listitem> + + <listitem> + <para>Paulo Menezes <email>paulo@isr.uc.pt</email></para> + </listitem> + + <listitem> + <para>Paulo Menezes <email>pm@dee.uc.pt</email></para> + </listitem> + + <listitem> + <para>Pedro A M Vazquez <email>vazquez@IQM.Unicamp.BR</email></para> + </listitem> + + <listitem> + <para>Pedro Giffuni <email>giffunip@asme.org</email></para> + </listitem> + + <listitem> + <para>Pete Bentley <email>pete@demon.net</email></para> + </listitem> + + <listitem> + <para>Peter Childs <email>pjchilds@imforei.apana.org.au</email></para> + </listitem> + + <listitem> + <para>Peter Cornelius <email>pc@inr.fzk.de</email></para> + </listitem> + + <listitem> + <para>Peter Haight <email>peterh@prognet.com</email></para> + </listitem> + + <listitem> + <para>Peter Jeremy <email>perer.jeremy@alcatel.com.au</email></para> + </listitem> + + <listitem> + <para>Peter M. Chen <email>pmchen@eecs.umich.edu</email></para> + </listitem> + + <listitem> + <para>Peter Much <email>peter@citylink.dinoex.sub.org</email></para> + </listitem> + + <listitem> + <para>Peter Olsson <email>unknown</email></para> + </listitem> + + <listitem> + <para>Peter Philipp <email>pjp@bsd-daemon.net</email></para> + </listitem> + + <listitem> + <para>Peter Stubbs <email>PETERS@staidan.qld.edu.au</email></para> + </listitem> + + <listitem> + <para>Phil Maker <email>pjm@cs.ntu.edu.au</email></para> + </listitem> + + <listitem> + <para>Phil Sutherland + <email>philsuth@mycroft.dialix.oz.au</email></para> + </listitem> + + <listitem> + <para>Phil Taylor <email>phil@zipmail.co.uk</email></para> + </listitem> + + <listitem> + <para>Philip Musumeci <email>philip@rmit.edu.au</email></para> + </listitem> + + <listitem> + <para>Pierre Y. Dampure <email>pierre.dampure@k2c.co.uk</email></para> + </listitem> + + <listitem> + <para>Pius Fischer <email>pius@ienet.com</email></para> + </listitem> + + <listitem> + <para>Pomegranate <email>daver@flag.blackened.net</email></para> + </listitem> + + <listitem> + <para>Powerdog Industries + <email>kevin.ruddy@powerdog.com</email></para> + </listitem> + + <listitem> + <para>R. Kym Horsell</para> + </listitem> + + <listitem> + <para>Rajesh Vaidheeswarran <email>rv@fore.com</email></para> + </listitem> + + <listitem> + <para>Ralf Friedl <email>friedl@informatik.uni-kl.de</email></para> + </listitem> + + <listitem> + <para>Randal S. Masutani <email>randal@comtest.com</email></para> + </listitem> + + <listitem> + <para>Randall Hopper <email>rhh@ct.picker.com</email></para> + </listitem> + + <listitem> + <para>Randall W. Dean <email>rwd@osf.org</email></para> + </listitem> + + <listitem> + <para>Randy Bush <email>rbush@bainbridge.verio.net</email></para> + </listitem> + + <listitem> + <para>Reinier Bezuidenhout + <email>rbezuide@mikom.csir.co.za</email></para> + </listitem> + + <listitem> + <para>Remy Card <email>Remy.Card@masi.ibp.fr</email></para> + </listitem> + + <listitem> + <para>Ricardas Cepas <email>rch@richard.eu.org</email></para> + </listitem> + + <listitem> + <para>Richard Henderson <email>richard@atheist.tamu.edu</email></para> + </listitem> + + <listitem> + <para>Richard Hwang <email>rhwang@bigpanda.com</email></para> + </listitem> + + <listitem> + <para>Richard J Kuhns <email>rjk@watson.grauel.com</email></para> + </listitem> + + <listitem> + <para>Richard M. Neswold + <email>rneswold@drmemory.fnal.gov</email></para> + </listitem> + + <listitem> + <para>Richard Seaman, Jr. <email>dick@tar.com</email></para> + </listitem> + + <listitem> + <para>Richard Stallman <email>rms@gnu.ai.mit.edu</email></para> + </listitem> + + <listitem> + <para>Richard Straka <email>straka@user1.inficad.com</email></para> + </listitem> + + <listitem> + <para>Richard Tobin <email>richard@cogsci.ed.ac.uk</email></para> + </listitem> + + <listitem> + <para>Richard Wackerbarth <email>rkw@Dataplex.NET</email></para> + </listitem> + + <listitem> + <para>Richard Winkel <email>rich@math.missouri.edu</email></para> + </listitem> + + <listitem> + <para>Richard Wiwatowski <email>rjwiwat@adelaide.on.net</email></para> + </listitem> + + <listitem> + <para>Rick Macklem <email>rick@snowhite.cis.uoguelph.ca</email></para> + </listitem> + + <listitem> + <para>Rick Macklin <email>unknown</email></para> + </listitem> + + <listitem> + <para>Rob Austein <email>sra@epilogue.com</email></para> + </listitem> + + <listitem> + <para>Rob Mallory <email>rmallory@qualcomm.com</email></para> + </listitem> + + <listitem> + <para>Rob Snow <email>rsnow@txdirect.net</email></para> + </listitem> + + <listitem> + <para>Robert Crowe <email>bob@speakez.com</email></para> + </listitem> + + <listitem> + <para>Robert D. Thrush <email>rd@phoenix.aii.com</email></para> + </listitem> + + <listitem> + <para>Robert Eckardt + <email>roberte@MEP.Ruhr-Uni-Bochum.de</email></para> + </listitem> + + <listitem> + <para>Robert Sanders <email>rsanders@mindspring.com</email></para> + </listitem> + + <listitem> + <para>Robert Sexton <email>robert@kudra.com</email></para> + </listitem> + + <listitem> + <para>Robert Shady <email>rls@id.net</email></para> + </listitem> + + <listitem> + <para>Robert Swindells <email>swindellsr@genrad.co.uk</email></para> + </listitem> + + <listitem> + <para>Robert Watson <email>robert@cyrus.watson.org</email></para> + </listitem> + + <listitem> + <para>Robert Withrow <email>witr@rwwa.com</email></para> + </listitem> + + <listitem> + <para>Robert Yoder <email>unknown</email></para> + </listitem> + + <listitem> + <para>Robin Carey + <email>robin@mailgate.dtc.rankxerox.co.uk</email></para> + </listitem> + + <listitem> + <para>Roger Hardiman <email>roger@cs.strath.ac.uk</email></para> + </listitem> + + <listitem> + <para>Roland Jesse <email>jesse@cs.uni-magdeburg.de</email></para> + </listitem> + + <listitem> + <para>Ron Bickers <email>rbickers@intercenter.net</email></para> + </listitem> + + <listitem> + <para>Ron Lenk <email>rlenk@widget.xmission.com</email></para> + </listitem> + + <listitem> + <para>Ronald Kuehn <email>kuehn@rz.tu-clausthal.de</email></para> + </listitem> + + <listitem> + <para>Rudolf Cejka <email>unknown</email></para> + </listitem> + + <listitem> + <para>Ruslan Belkin <email>rus@home2.UA.net</email></para> + </listitem> + + <listitem> + <para>Ruslan Ermilov <email>ru@ucb.crimea.ua</email></para> + </listitem> + + <listitem> + <para>Ruslan Shevchenko <email>rssh@cam.grad.kiev.ua</email></para> + </listitem> + + <listitem> + <para>Russell L. Carter <email>rcarter@pinyon.org</email></para> + </listitem> + + <listitem> + <para>Russell Vincent <email>rv@groa.uct.ac.za</email></para> + </listitem> + + <listitem> + <para>Ryan Younce <email>ryany@pobox.com</email></para> + </listitem> + + <listitem> + <para>SANETO Takanori <email>sanewo@strg.sony.co.jp</email></para> + </listitem> + + <listitem> + <para>SAWADA Mizuki <email>miz@qb3.so-net.ne.jp</email></para> + </listitem> + + <listitem> + <para>SUGIMURA Takashi <email>sugimura@jp.FreeBSD.ORG</email></para> + </listitem> + + <listitem> + <para>SURANYI Peter + <email>suranyip@jks.is.tsukuba.ac.jp</email></para> + </listitem> + + <listitem> + <para>Sakari Jalovaara <email>sja@tekla.fi</email></para> + </listitem> + + <listitem> + <para>Sam Hartman <email>hartmans@mit.edu</email></para> + </listitem> + + <listitem> + <para>Samuel Lam <email>skl@ScalableNetwork.com</email></para> + </listitem> + + <listitem> + <para>Sander Vesik <email>sander@haldjas.folklore.ee</email></para> + </listitem> + + <listitem> + <para>Sandro Sigala <email>ssigala@globalnet.it</email></para> + </listitem> + + <listitem> + <para>Sascha Blank <email>blank@fox.uni-trier.de</email></para> + </listitem> + + <listitem> + <para>Sascha Wildner <email>swildner@channelz.GUN.de</email></para> + </listitem> + + <listitem> + <para>Satoh Junichi <email>junichi@astec.co.jp</email></para> + </listitem> + + <listitem> + <para>Satoshi Taoka + <email>taoka@infonets.hiroshima-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Scot Elliott <email>scot@poptart.org</email></para> + </listitem> + + <listitem> + <para>Scot W. Hetzel <email>hetzels@westbend.net</email></para> + </listitem> + + <listitem> + <para>Scott A. Kenney <email>saken@rmta.ml.org</email></para> + </listitem> + + <listitem> + <para>Scott Blachowicz + <email>scott.blachowicz@seaslug.org</email></para> + </listitem> + + <listitem> + <para>Scott Burris <email>scott@pita.cns.ucla.edu</email></para> + </listitem> + + <listitem> + <para>Scott Hazen Mueller <email>scott@zorch.sf-bay.org</email></para> + </listitem> + + <listitem> + <para>Scott Michel <email>scottm@cs.ucla.edu</email></para> + </listitem> + + <listitem> + <para>Scott Reynolds <email>scott@clmqt.marquette.mi.us</email></para> + </listitem> + + <listitem> + <para>Sebastian Strollo <email>seb@erix.ericsson.se</email></para> + </listitem> + + <listitem> + <para>Seigou TANIMURA + <email>tanimura@naklab.dnj.ynu.ac.jp</email></para> + </listitem> + + <listitem> + <para>Serge A. Babkin <email>babkin@hq.icb.chel.su</email></para> + </listitem> + + <listitem> + <para>Serge V. Vakulenko <email>vak@zebub.msk.su</email></para> + </listitem> + + <listitem> + <para>Sergei Chechetkin + <email>csl@whale.sunbay.crimea.ua</email></para> + </listitem> + + <listitem> + <para>Sergei S. Laskavy <email>laskavy@pc759.cs.msu.su</email></para> + </listitem> + + <listitem> + <para>Sergey Gershtein <email>sg@mplik.ru</email></para> + </listitem> + + <listitem> + <para>Sergey Potapov <email>sp@alkor.ru</email></para> + </listitem> + + <listitem> + <para>Sergey Shkonda <email>serg@bcs.zp.ua</email></para> + </listitem> + + <listitem> + <para>Sergey V.Dorokhov <email>svd@kbtelecom.nalnet.ru</email></para> + </listitem> + + <listitem> + <para>Sergio Lenzi <email>lenzi@bsi.com.br</email></para> + </listitem> + + <listitem> + <para>Shaun Courtney <email>shaun@emma.eng.uct.ac.za</email></para> + </listitem> + + <listitem> + <para>Shawn M. Carey <email>smcarey@mailbox.syr.edu</email></para> + </listitem> + + <listitem> + <para>Sheldon Hearn <email>axl@iafrica.com</email></para> + </listitem> + + <listitem> + <para>Shigio Yamaguchi <email>shigio@wafu.netgate.net</email></para> + </listitem> + + <listitem> + <para>Shunsuke Akiyama <email>akiyama@jp.freebsd.org</email></para> + </listitem> + + <listitem> + <para>Simon <email>simon@masi.ibp.fr</email></para> + </listitem> + + <listitem> + <para>Simon Burge <email>simonb@telstra.com.au</email></para> + </listitem> + + <listitem> + <para>Simon J Gerraty <email>sjg@melb.bull.oz.au</email></para> + </listitem> + + <listitem> + <para>Simon Marlow <email>simonm@dcs.gla.ac.uk</email></para> + </listitem> + + <listitem> + <para>Simon Shapiro <email>shimon@simon-shapiro.org</email></para> + </listitem> + + <listitem> + <para>Sin'ichiro MIYATANI <email>siu@phaseone.co.jp</email></para> + </listitem> + + <listitem> + <para>Slaven Rezic <email>eserte@cs.tu-berlin.de</email></para> + </listitem> + + <listitem> + <para>Soochon Radee <email>slr@mitre.org</email></para> + </listitem> + + <listitem> + <para>Soren Dayton <email>csdayton@midway.uchicago.edu</email></para> + </listitem> + + <listitem> + <para>Soren Dossing <email>sauber@netcom.com</email></para> + </listitem> + + <listitem> + <para>Soren S. Jorvang <email>soren@dt.dk</email></para> + </listitem> + + <listitem> + <para>Stefan Bethke <email>stb@hanse.de</email></para> + </listitem> + + <listitem> + <para>Stefan Eggers <email>seggers@semyam.dinoco.de</email></para> + </listitem> + + <listitem> + <para>Stefan Moeding <email>s.moeding@ndh.net</email></para> + </listitem> + + <listitem> + <para>Stefan Petri <email>unknown</email></para> + </listitem> + + <listitem> + <para>Stefan `Sec` Zehl <email>sec@42.org</email></para> + </listitem> + + <listitem> + <para>Steinar Haug <email>sthaug@nethelp.no</email></para> + </listitem> + + <listitem> + <para>Stephane E. Potvin <email>sepotvin@videotron.ca</email></para> + </listitem> + + <listitem> + <para>Stephane Legrand <email>stephane@lituus.fr</email></para> + </listitem> + + <listitem> + <para>Stephen Clawson + <email>sclawson@marker.cs.utah.edu</email></para> + </listitem> + + <listitem> + <para>Stephen F. Combs <email>combssf@salem.ge.com</email></para> + </listitem> + + <listitem> + <para>Stephen Farrell <email>stephen@farrell.org</email></para> + </listitem> + + <listitem> + <para>Stephen Hocking <email>sysseh@devetir.qld.gov.au</email></para> + </listitem> + + <listitem> + <para>Stephen J. Roznowski <email>sjr@home.net</email></para> + </listitem> + + <listitem> + <para>Stephen McKay <email>syssgm@devetir.qld.gov.au</email></para> + </listitem> + + <listitem> + <para>Stephen Melvin <email>melvin@zytek.com</email></para> + </listitem> + + <listitem> + <para>Steve Bauer <email>sbauer@rock.sdsmt.edu</email></para> + </listitem> + + <listitem> + <para>Steve Deering <email>unknown</email></para> + </listitem> + + <listitem> + <para>Steve Gerakines <email>steve2@genesis.tiac.net</email></para> + </listitem> + + <listitem> + <para>Steve Gericke <email>steveg@comtrol.com</email></para> + </listitem> + + <listitem> + <para>Steve Piette <email>steve@simon.chi.il.US</email></para> + </listitem> + + <listitem> + <para>Steve Schwarz <email>schwarz@alpharel.com</email></para> + </listitem> + + <listitem> + <para>Steven G. Kargl + <email>kargl@troutmask.apl.washington.edu</email></para> + </listitem> + + <listitem> + <para>Steven H. Samorodin <email>samorodi@NUXI.com</email></para> + </listitem> + + <listitem> + <para>Steven McCanne <email>mccanne@cs.berkeley.edu</email></para> + </listitem> + + <listitem> + <para>Steven Plite <email>splite@purdue.edu</email></para> + </listitem> + + <listitem> + <para>Steven Wallace <email>unknown</email></para> + </listitem> + + <listitem> + <para>Stuart Henderson + <email>stuart@internationalschool.co.uk</email></para> + </listitem> + + <listitem> + <para>Sue Blake <email>sue@welearn.com.au</email></para> + </listitem> + + <listitem> + <para>Sugiura Shiro <email>ssugiura@duo.co.jp</email></para> + </listitem> + + <listitem> + <para>Sujal Patel <email>smpatel@wam.umd.edu</email></para> + </listitem> + + <listitem> + <para>Sune Stjerneby <email>stjerneby@usa.net</email></para> + </listitem> + + <listitem> + <para>Suzuki Yoshiaki + <email>zensyo@ann.tama.kawasaki.jp</email></para> + </listitem> + + <listitem> + <para>Tadashi Kumano <email>kumano@strl.nhk.or.jp</email></para> + </listitem> + + <listitem> + <para>Taguchi Takeshi <email>taguchi@tohoku.iij.ad.jp</email></para> + </listitem> + + <listitem> + <para>Takahashi Yoshihiro <email>nyan@dd.catv.ne.jp</email></para> + </listitem> + + <listitem> + <para>Takahiro Yugawa <email>yugawa@orleans.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>Takanori Watanabe + <email>takawata@shidahara1.planet.sci.kobe-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Takashi Mega <email>mega@minz.org</email></para> + </listitem> + + <listitem> + <para>Takashi Uozu <email>j1594016@ed.kagu.sut.ac.jp</email></para> + </listitem> + + <listitem> + <para>Takayuki Ariga <email>a00821@cc.hc.keio.ac.jp</email></para> + </listitem> + + <listitem> + <para>Takeru NAIKI <email>naiki@bfd.es.hokudai.ac.jp</email></para> + </listitem> + + <listitem> + <para>Takeshi Amaike <email>amaike@iri.co.jp</email></para> + </listitem> + + <listitem> + <para>Takeshi MUTOH <email>mutoh@info.nara-k.ac.jp</email></para> + </listitem> + + <listitem> + <para>Takeshi Ohashi + <email>ohashi@mickey.ai.kyutech.ac.jp</email></para> + </listitem> + + <listitem> + <para>Takeshi WATANABE + <email>watanabe@crayon.earth.s.kobe-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Takuya SHIOZAKI + <email>tshiozak@makino.ise.chuo-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Tatoku Ogaito <email>tacha@tera.fukui-med.ac.jp</email></para> + </listitem> + + <listitem> + <para>Tatsumi HOSOKAWA <email>hosokawa@jp.FreeBSD.org</email></para> + </listitem> + + <listitem> + <para>Ted Buswell <email>tbuswell@mediaone.net</email></para> + </listitem> + + <listitem> + <para>Ted Faber <email>faber@isi.edu</email></para> + </listitem> + + <listitem> + <para>Ted Lemon <email>unknown</email></para> + </listitem> + + <listitem> + <para>Terry Lambert <email>terry@lambert.org</email></para> + </listitem> + + <listitem> + <para>Terry Lee <email>terry@uivlsi.csl.uiuc.edu</email></para> + </listitem> + + <listitem> + <para>Tetsuya Furukawa <email>tetsuya@secom-sis.co.jp</email></para> + </listitem> + + <listitem> + <para>Theo de Raadt <email>deraadt@OpenBSD.org</email></para> + </listitem> + + <listitem> + <para>Thomas <email>thomas@mathematik.uni-Bremen.de</email></para> + </listitem> + + <listitem> + <para>Thomas D. Dean <email>tomdean@ix.netcom.com</email></para> + </listitem> + + <listitem> + <para>Thomas David Rivers <email>rivers@dignus.com</email></para> + </listitem> + + <listitem> + <para>Thomas G. McWilliams <email>tgm@netcom.com</email></para> + </listitem> + + <listitem> + <para>Thomas Gellekum + <email>thomas@ghpc8.ihf.rwth-aachen.de</email></para> + </listitem> + + <listitem> + <para>Thomas Graichen + <email>graichen@omega.physik.fu-berlin.de</email></para> + </listitem> + + <listitem> + <para>Thomas König + <email>Thomas.Koenig@ciw.uni-karlsruhe.de</email></para> + </listitem> + + <listitem> + <para>Thomas Ptacek <email>unknown</email></para> + </listitem> + + <listitem> + <para>Thomas Stromberg <email>tstrombe@rtci.com</email></para> + </listitem> + + <listitem> + <para>Thomas Valentino Crimi + <email>tcrimi+@andrew.cmu.edu</email></para> + </listitem> + + <listitem> + <para>Thomas Wintergerst <email>thomas@lemur.nord.de</email></para> + </listitem> + + <listitem> + <para>Þórður Ívarsson + <email>totii@est.is</email></para> + </listitem> + + <listitem> + <para>Tim Kientzle <email>kientzle@netcom.com</email></para> + </listitem> + + <listitem> + <para>Tim Singletary + <email>tsingle@sunland.gsfc.nasa.gov</email></para> + </listitem> + + <listitem> + <para>Tim Wilkinson <email>tim@sarc.city.ac.uk</email></para> + </listitem> + + <listitem> + <para>Timo J. Rinne <email>tri@iki.fi</email></para> + </listitem> + + <listitem> + <para>Todd Miller <email>millert@openbsd.org</email></para> + </listitem> + + <listitem> + <para>Tom <email>root@majestix.cmr.no</email></para> + </listitem> + + <listitem> + <para>Tom <email>tom@sdf.com</email></para> + </listitem> + + <listitem> + <para>Tom Gray - DCA <email>dcasba@rain.org</email></para> + </listitem> + + <listitem> + <para>Tom Hukins <email>tom@eborcom.com</email></para> + </listitem> + + <listitem> + <para>Tom Jobbins <email>tom@tom.tj</email></para> + </listitem> + + <listitem> + <para>Tom Pusateri <email>pusateri@juniper.net</email></para> + </listitem> + + <listitem> + <para>Tom Rush <email>tarush@mindspring.com</email></para> + </listitem> + + <listitem> + <para>Tom Samplonius <email>tom@misery.sdf.com</email></para> + </listitem> + + <listitem> + <para>Tomohiko Kurahashi + <email>kura@melchior.q.t.u-tokyo.ac.jp</email></para> + </listitem> + + <listitem> + <para>Tony Kimball <email>alk@Think.COM</email></para> + </listitem> + + <listitem> + <para>Tony Li <email>tli@jnx.com</email></para> + </listitem> + + <listitem> + <para>Tony Lynn <email>wing@cc.nsysu.edu.tw</email></para> + </listitem> + + <listitem> + <para>Torbjorn Granlund <email>tege@matematik.su.se</email></para> + </listitem> + + <listitem> + <para>Toshihiko ARAI <email>toshi@tenchi.ne.jp</email></para> + </listitem> + + <listitem> + <para>Toshihiko SHIMOKAWA <email>toshi@tea.forus.or.jp</email></para> + </listitem> + + <listitem> + <para>Toshihiro Kanda <email>candy@kgc.co.jp</email></para> + </listitem> + + <listitem> + <para>Toshiomi Moriki + <email>Toshiomi.Moriki@ma1.seikyou.ne.jp</email></para> + </listitem> + + <listitem> + <para>Trefor S. <email>trefor@flevel.co.uk</email></para> + </listitem> + + <listitem> + <para>Trevor Blackwell <email>tlb@viaweb.com</email></para> + </listitem> + + <listitem> + <para>URATA Shuichiro <email>s-urata@nmit.tmg.nec.co.jp</email></para> + </listitem> + + <listitem> + <para>Ugo Paternostro <email>paterno@dsi.unifi.it</email></para> + </listitem> + + <listitem> + <para>Ulf Kieber <email>kieber@sax.de</email></para> + </listitem> + + <listitem> + <para>Ulli Linzen <email>ulli@perceval.camelot.de</email></para> + </listitem> + + <listitem> + <para>Ustimenko Semen <email>semen@iclub.nsu.ru</email></para> + </listitem> + + <listitem> + <para>Uwe Arndt <email>arndt@mailhost.uni-koblenz.de</email></para> + </listitem> + + <listitem> + <para>Vadim Chekan <email>vadim@gc.lviv.ua</email></para> + </listitem> + + <listitem> + <para>Vadim Kolontsov <email>vadim@tversu.ac.ru</email></para> + </listitem> + + <listitem> + <para>Vadim Mikhailov <email>mvp@braz.ru</email></para> + </listitem> + + <listitem> + <para>Van Jacobson <email>van@ee.lbl.gov</email></para> + </listitem> + + <listitem> + <para>Vasily V. Grechishnikov + <email>bazilio@ns1.ied-vorstu.ac.ru</email></para> + </listitem> + + <listitem> + <para>Vasim Valejev <email>vasim@uddias.diaspro.com</email></para> + </listitem> + + <listitem> + <para>Vernon J. Schryver <email>vjs@mica.denver.sgi.com</email></para> + </listitem> + + <listitem> + <para>Vic Abell <email>abe@cc.purdue.edu</email></para> + </listitem> + + <listitem> + <para>Ville Eerola <email>ve@sci.fi</email></para> + </listitem> + + <listitem> + <para>Vincent Poy <email>vince@venus.gaianet.net</email></para> + </listitem> + + <listitem> + <para>Vincenzo Capuano + <email>VCAPUANO@vmprofs.esoc.esa.de</email></para> + </listitem> + + <listitem> + <para>Virgil Champlin <email>champlin@pa.dec.com</email></para> + </listitem> + + <listitem> + <para>Vladimir A. Jakovenko + <email>vovik@ntu-kpi.kiev.ua</email></para> + </listitem> + + <listitem> + <para>Vladimir Kushnir <email>kushn@mail.kar.net</email></para> + </listitem> + + <listitem> + <para>Vsevolod Lobko <email>seva@alex-ua.com</email></para> + </listitem> + + <listitem> + <para>W. Gerald Hicks <email>wghicks@bellsouth.net</email></para> + </listitem> + + <listitem> + <para>W. Richard Stevens <email>rstevens@noao.edu</email></para> + </listitem> + + <listitem> + <para>Walt Howard <email>howard@ee.utah.edu</email></para> + </listitem> + + <listitem> + <para>Warren Toomey <email>wkt@csadfa.cs.adfa.oz.au</email></para> + </listitem> + + <listitem> + <para>Wayne Scott <email>wscott@ichips.intel.com</email></para> + </listitem> + + <listitem> + <para>Werner Griessl + <email>werner@btp1da.phy.uni-bayreuth.de</email></para> + </listitem> + + <listitem> + <para>Wes Santee <email>wsantee@wsantee.oz.net</email></para> + </listitem> + + <listitem> + <para>Wietse Venema <email>wietse@wzv.win.tue.nl</email></para> + </listitem> + + <listitem> + <para>Wilfredo Sanchez <email>wsanchez@apple.com</email></para> + </listitem> + + <listitem> + <para>Wiljo Heinen <email>wiljo@freeside.ki.open.de</email></para> + </listitem> + + <listitem> + <para>Wilko Bulte <email>wilko@yedi.iaf.nl</email></para> + </listitem> + + <listitem> + <para>Willem Jan Withagen <email>wjw@surf.IAE.nl</email></para> + </listitem> + + <listitem> + <para>William Jolitz <email>withheld</email></para> + </listitem> + + <listitem> + <para>William Liao <email>william@tale.net</email></para> + </listitem> + + <listitem> + <para>Wojtek Pilorz + <email>wpilorz@celebris.bdk.lublin.pl</email></para> + </listitem> + + <listitem> + <para>Wolfgang Helbig <email>helbig@ba-stuttgart.de</email></para> + </listitem> + + <listitem> + <para>Wolfgang Solfrank <email>ws@tools.de</email></para> + </listitem> + + <listitem> + <para>Wolfgang Stanglmeier <email>wolf@FreeBSD.org</email></para> + </listitem> + + <listitem> + <para>Wu Ching-hong <email>woju@FreeBSD.ee.Ntu.edu.TW</email></para> + </listitem> + + <listitem> + <para>Yarema <email>yds@ingress.com</email></para> + </listitem> + + <listitem> + <para>Yaroslav Terletsky <email>ts@polynet.lviv.ua</email></para> + </listitem> + + <listitem> + <para>Yen-Shuo Su <email>yssu@CCCA.NCTU.edu.tw</email></para> + </listitem> + + <listitem> + <para>Ying-Chieh Liao <email>ijliao@csie.NCTU.edu.tw</email></para> + </listitem> + + <listitem> + <para>Yixin Jin <email>yjin@rain.cs.ucla.edu</email></para> + </listitem> + + <listitem> + <para>Yoshiaki Uchikawa <email>yoshiaki@kt.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>Yoshihiko OHTA <email>yohta@bres.tsukuba.ac.jp</email></para> + </listitem> + + <listitem> + <para>Yoshihisa NAKAGAWA + <email>y-nakaga@ccs.mt.nec.co.jp</email></para> + </listitem> + + <listitem> + <para>Yoshikazu Goto <email>gotoh@ae.anritsu.co.jp</email></para> + </listitem> + + <listitem> + <para>Yoshimasa Ohnishi + <email>ohnishi@isc.kyutech.ac.jp</email></para> + </listitem> + + <listitem> + <para>Yoshishige Arai <email>ryo2@on.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>Yuichi MATSUTAKA <email>matutaka@osa.att.ne.jp</email></para> + </listitem> + + <listitem> + <para>Yujiro MIYATA + <email>miyata@bioele.nuee.nagoya-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Yukihiro Nakai <email>nacai@iname.com</email></para> + </listitem> + + <listitem> + <para>Yusuke Nawano <email>azuki@azkey.org</email></para> + </listitem> + + <listitem> + <para>Yuval Yarom <email>yval@cs.huji.ac.il</email></para> + </listitem> + + <listitem> + <para>Yves Fonk <email>yves@cpcoup5.tn.tudelft.nl</email></para> + </listitem> + + <listitem> + <para>Yves Fonk <email>yves@dutncp8.tn.tudelft.nl</email></para> + </listitem> + + <listitem> + <para>Zach Heilig <email>zach@gaffaneys.com</email></para> + </listitem> + + <listitem> + <para>Zahemszhky Gabor <email>zgabor@code.hu</email></para> + </listitem> + + <listitem> + <para>Zhong Ming-Xun <email>zmx@mail.CDPA.nsysu.edu.tw</email></para> + </listitem> + + <listitem> + <para>arci <email>vega@sophia.inria.fr</email></para> + </listitem> + + <listitem> + <para>der Mouse <email>mouse@Collatz.McRCIM.McGill.EDU</email></para> + </listitem> + + <listitem> + <para>frf <email>frf@xocolatl.com</email></para> + </listitem> + + <listitem> + <para>Ege Rekk <email>aagero@aage.priv.no</email></para> + </listitem> + </itemizedlist> + </sect1> + + <sect1> + <title>386BSD パッチキットへのパッチ提供者</title> + + <para>(名前でアルファベット順):</para> + + <itemizedlist> + <listitem> + <para>Adam Glass <email>glass@postgres.berkeley.edu</email></para> + </listitem> + + <listitem> + <para>Adrian Hall <email>adrian@ibmpcug.co.uk</email></para> + </listitem> + + <listitem> + <para>Andrey A. Chernov <email>ache@astral.msk.su</email></para> + </listitem> + + <listitem> + <para>Andrew Herbert <email>andrew@werple.apana.org.au</email></para> + </listitem> + + <listitem> + <para>Andrew Moore <email>alm@netcom.com</email></para> + </listitem> + + <listitem> + <para>Andy Valencia <email>ajv@csd.mot.com</email> + <email>jtk@netcom.com</email></para> + </listitem> + + <listitem> + <para>Arne Henrik Juul <email>arnej@Lise.Unit.NO</email></para> + </listitem> + + <listitem> + <para>Bakul Shah <email>bvs@bitblocks.com</email></para> + </listitem> + + <listitem> + <para>Barry Lustig <email>barry@ictv.com</email></para> + </listitem> + + <listitem> + <para>Bob Wilcox <email>bob@obiwan.uucp</email></para> + </listitem> + + <listitem> + <para>Branko Lankester</para> + </listitem> + + <listitem> + <para>Brett Lymn <email>blymn@mulga.awadi.com.AU</email></para> + </listitem> + + <listitem> + <para>Charles Hannum <email>mycroft@ai.mit.edu</email></para> + </listitem> + + <listitem> + <para>Chris G. Demetriou + <email>cgd@postgres.berkeley.edu</email></para> + </listitem> + + <listitem> + <para>Chris Torek <email>torek@ee.lbl.gov</email></para> + </listitem> + + <listitem> + <para>Christoph Robitschko + <email>chmr@edvz.tu-graz.ac.at</email></para> + </listitem> + + <listitem> + <para>Daniel Poirot <email>poirot@aio.jsc.nasa.gov</email></para> + </listitem> + + <listitem> + <para>Dave Burgess <email>burgess@hrd769.brooks.af.mil</email></para> + </listitem> + + <listitem> + <para>Dave Rivers <email>rivers@ponds.uucp</email></para> + </listitem> + + <listitem> + <para>David Dawes <email>dawes@physics.su.OZ.AU</email></para> + </listitem> + + <listitem> + <para>David Greenman <email>dg@Root.COM</email></para> + </listitem> + + <listitem> + <para>Eric J. Haug <email>ejh@slustl.slu.edu</email></para> + </listitem> + + <listitem> + <para>Felix Gaehtgens + <email>felix@escape.vsse.in-berlin.de</email></para> + </listitem> + + <listitem> + <para>Frank Maclachlan <email>fpm@crash.cts.com</email></para> + </listitem> + + <listitem> + <para>Gary A. Browning <email>gab10@griffcd.amdahl.com</email></para> + </listitem> + + <listitem> + <para>Gary Howland <email>gary@hotlava.com</email></para> + </listitem> + + <listitem> + <para>Geoff Rehmet <email>csgr@alpha.ru.ac.za</email></para> + </listitem> + + <listitem> + <para>Goran Hammarback <email>goran@astro.uu.se</email></para> + </listitem> + + <listitem> + <para>Guido van Rooij <email>guido@gvr.org</email></para> + </listitem> + + <listitem> + <para>Guy Harris <email>guy@auspex.com</email></para> + </listitem> + + <listitem> + <para>Havard Eidnes + <email>Havard.Eidnes@runit.sintef.no</email></para> + </listitem> + + <listitem> + <para>Herb Peyerl <email>hpeyerl@novatel.cuc.ab.ca</email></para> + </listitem> + + <listitem> + <para>Holger Veit <email>Holger.Veit@gmd.de</email></para> + </listitem> + + <listitem> + <para>Ishii Masahiro, R. Kym Horsell</para> + </listitem> + + <listitem> + <para>J.T. Conklin <email>jtc@cygnus.com</email></para> + </listitem> + + <listitem> + <para>Jagane D Sundar <email>jagane@netcom.com</email></para> + </listitem> + + <listitem> + <para>James Clark <email>jjc@jclark.com</email></para> + </listitem> + + <listitem> + <para>James Jegers <email>jimj@miller.cs.uwm.edu</email></para> + </listitem> + + <listitem> + <para>James W. Dolter</para> + </listitem> + + <listitem> + <para>James da Silva <email>jds@cs.umd.edu</email> et al</para> + </listitem> + + <listitem> + <para>Jay Fenlason <email>hack@datacube.com</email></para> + </listitem> + + <listitem> + <para>Jim Wilson <email>wilson@moria.cygnus.com</email></para> + </listitem> + + <listitem> + <para>Jörg Lohse + <email>lohse@tech7.informatik.uni-hamburg.de</email></para> + </listitem> + + <listitem> + <para>Jörg Wunsch + <email>joerg_wunsch@uriah.heep.sax.de</email></para> + </listitem> + + <listitem> + <para>John Dyson</para> + </listitem> + + <listitem> + <para>John Woods <email>jfw@eddie.mit.edu</email></para> + </listitem> + + <listitem> + <para>Jordan K. Hubbard <email>jkh@whisker.hubbard.ie</email></para> + </listitem> + + <listitem> + <para>Julian Elischer <email>julian@dialix.oz.au</email></para> + </listitem> + + <listitem> + <para>Julian Stacey <email>jhs@freebsd.org</email></para> + </listitem> + + <listitem> + <para>Karl Dietz <email>Karl.Dietz@triplan.com</email></para> + </listitem> + + <listitem> + <para>Karl Lehenbauer <email>karl@NeoSoft.com</email> + <email>karl@one.neosoft.com</email></para> + </listitem> + + <listitem> + <para>Keith Bostic <email>bostic@toe.CS.Berkeley.EDU</email></para> + </listitem> + + <listitem> + <para>Ken Hughes</para> + </listitem> + + <listitem> + <para>Kent Talarico <email>kent@shipwreck.tsoft.net</email></para> + </listitem> + + <listitem> + <para>Kevin Lahey <email>kml%rokkaku.UUCP@mathcs.emory.edu</email> + <email>kml@mosquito.cis.ufl.edu</email></para> + </listitem> + + <listitem> + <para>Marc Frajola <email>marc@dev.com</email></para> + </listitem> + + <listitem> + <para>Mark Tinguely <email>tinguely@plains.nodak.edu</email> + <email>tinguely@hookie.cs.ndsu.NoDak.edu</email></para> + </listitem> + + <listitem> + <para>Martin Renters <email>martin@tdc.on.ca</email></para> + </listitem> + + <listitem> + <para>Michael Clay <email>mclay@weareb.org</email></para> + </listitem> + + <listitem> + <para>Michael Galassi <email>nerd@percival.rain.com</email></para> + </listitem> + + <listitem> + <para>Mike Durkin <email>mdurkin@tsoft.sf-bay.org</email></para> + </listitem> + + <listitem> + <para>Naoki Hamada <email>nao@tom-yam.or.jp</email></para> + </listitem> + + <listitem> + <para>Nate Williams <email>nate@bsd.coe.montana.edu</email></para> + </listitem> + + <listitem> + <para>Nick Handel <email>nhandel@NeoSoft.com</email> + <email>nick@madhouse.neosoft.com</email></para> + </listitem> + + <listitem> + <para>Pace Willisson <email>pace@blitz.com</email></para> + </listitem> + + <listitem> + <para>Paul Kranenburg <email>pk@cs.few.eur.nl</email></para> + </listitem> + + <listitem> + <para>Paul Mackerras <email>paulus@cs.anu.edu.au</email></para> + </listitem> + + <listitem> + <para>Paul Popelka <email>paulp@uts.amdahl.com</email></para> + </listitem> + + <listitem> + <para>Peter da Silva <email>peter@NeoSoft.com</email></para> + </listitem> + + <listitem> + <para>Phil Sutherland + <email>philsuth@mycroft.dialix.oz.au</email></para> + </listitem> + + <listitem> + <para>Poul-Henning Kamp<email>phk@FreeBSD.ORG</email></para> + </listitem> + + <listitem> + <para>Ralf Friedl <email>friedl@informatik.uni-kl.de</email></para> + </listitem> + + <listitem> + <para>Rick Macklem <email>root@snowhite.cis.uoguelph.ca</email></para> + </listitem> + + <listitem> + <para>Robert D. Thrush <email>rd@phoenix.aii.com</email></para> + </listitem> + + <listitem> + <para>Rodney W. Grimes <email>rgrimes@cdrom.com</email></para> + </listitem> + + <listitem> + <para>Sascha Wildner <email>swildner@channelz.GUN.de</email></para> + </listitem> + + <listitem> + <para>Scott Burris <email>scott@pita.cns.ucla.edu</email></para> + </listitem> + + <listitem> + <para>Scott Reynolds <email>scott@clmqt.marquette.mi.us</email></para> + </listitem> + + <listitem> + <para>Sean Eric Fagan <email>sef@kithrup.com</email></para> + </listitem> + + <listitem> + <para>Simon J Gerraty <email>sjg@melb.bull.oz.au</email> + <email>sjg@zen.void.oz.au</email></para> + </listitem> + + <listitem> + <para>Stephen McKay <email>syssgm@devetir.qld.gov.au</email></para> + </listitem> + + <listitem> + <para>Terry Lambert <email>terry@icarus.weber.edu</email></para> + </listitem> + + <listitem> + <para>Terry Lee <email>terry@uivlsi.csl.uiuc.edu</email></para> + </listitem> + + <listitem> + <para>Tor Egge <email>Tor.Egge@idi.ntnu.no</email></para> + </listitem> + + <listitem> + <para>Warren Toomey <email>wkt@csadfa.cs.adfa.oz.au</email></para> + </listitem> + + <listitem> + <para>Wiljo Heinen <email>wiljo@freeside.ki.open.de</email></para> + </listitem> + + <listitem> + <para>William Jolitz <email>withheld</email></para> + </listitem> + + <listitem> + <para>Wolfgang Solfrank <email>ws@tools.de</email></para> + </listitem> + + <listitem> + <para>Wolfgang Stanglmeier <email>wolf@dentaro.GUN.de</email></para> + </listitem> + + <listitem> + <para>Yuval Yarom <email>yval@cs.huji.ac.il</email></para> + </listitem> + </itemizedlist> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/Makefile b/ja_JP.eucJP/books/handbook/Makefile index 3f0039b4dc..3f9c2fb8df 100644 --- a/ja_JP.eucJP/books/handbook/Makefile +++ b/ja_JP.eucJP/books/handbook/Makefile @@ -1,29 +1,415 @@ -# $Id: Makefile,v 1.28 1999-03-02 18:08:34 motoyuki Exp $ -# Original revision: 1.34 -# The FreeBSD Japanese Documentation Project - -.NOTPARALLEL: - -DOC= handbook -DOCDIR=${SHAREDIR}/doc/ja -FORMATS?= html roff -SGMLOPTS+=-e EUC-JP -SGMLOPTS+=-links - -SRCS= anoncvs.sgml authors.sgml backups.sgml basics.sgml bibliography.sgml boothelp.sgml -SRCS+= booting.sgml contrib.sgml crypt.sgml ctm.sgml current.sgml cvsup.sgml -SRCS+= cyclades.sgml development.sgml dialup.sgml dialout.sgml -SRCS+= disks.sgml diskless.sgml dma.sgml eresources.sgml esdi.sgml -SRCS+= firewalls.sgml german.sgml glossary.sgml goals.sgml -SRCS+= handbook.sgml history.sgml hw.sgml install.sgml isdn.sgml -SRCS+= kerberos.sgml kernelconfig.sgml kerneldebug.sgml kernelopts.sgml -SRCS+= lists.sgml mail.sgml makeworld.sgml memoryuse.sgml vm.sgml -SRCS+= mirrors.sgml nfs.sgml nutshell.sgml pgpkeys.sgml policies.sgml -SRCS+= porting.sgml ports.sgml ppp.sgml printing.sgml -SRCS+= quotas.sgml relnotes.sgml routing.sgml russian.sgml -SRCS+= serial.sgml scsi.sgml scsihd.sgml sections.sgml sio.sgml skey.sgml -SRCS+= slipc.sgml slips.sgml stable.sgml submitters.sgml synching.sgml -SRCS+= term.sgml userppp.sgml uart.sgml linuxemu.sgml -SRCS+= jcontrib.sgml jmembers.sgml - -.include <bsd.sgml.mk> +# +# Id: Makefile,v 1.17 1999/03/27 16:03:49 nik Exp +# $Id: Makefile,v 1.29 1999-04-08 15:45:06 kuriyama Exp $ +# +# Required ports (common): +# textproc/jade +# textproc/docbook +# textproc/dsssl-docbook-modular +# textproc/iso8879-1986 +# +# for HTML: +# textproc/html +# www/tidy +# +# for plain text: +# www/lynx +# +# for DVI: +# japanese/ptex-common +# japanese/ptex-euc +# japanese/platex-common +# japanese/platex-euc +# +# +# Build the FreeBSD Handbook. Will eventually split in two, a generic .mk +# file which can be used by many Makefiles, and a much smaller Makefile +# which uses the generic.mk file. +# +# Note: Doing all this in a Makefile is a little odd. This is because there +# is typically not a 1:1 mapping between the .sgml files and the .html, +# .rtf, .ps, and other formats. For most of them, all the .sgml files will +# become one file in the chosen output format. For HTML, many .html files +# will be produced, but they won't be named after the corresponding .sgml +# files. + +MAINTAINER=kuriyama@FreeBSD.ORG + +JADEOPTS= -ilang.ja + +# +# DOC is the root name of file(s) that will be generated (i.e, for +# foo.rtf, foo.ps, etc, DOC=foo. HTML generation ignores this, it +# is assumed that the stylesheet names this. If not set, DOC defaults +# to the name of the current directory. +# +DOC?= handbook + +# +# FORMATS lists the output formats that should be generated. Valid values +# are +# +# txt html html-split ps pdf rtf tar +# +# html-split is the file split into (probably) many individual HTML files, +# linked from one index.html file. +# +# This setting also affects which files will be removed with 'make clean'. +# If you 'make' with one setting, and 'make clean' with another, don't +# be surprised if it doesn't work. +FORMATS?= html-split + +# +# INSTALL_COMPRESSED lists the compressed versions to be installed by the +# install-* targets. Valid values are +# +# gz zip bz2 +# +# If left empty then no files will be installed compressed. +# +INSTALL_COMPRESSED?= gz + +# +# INSTALL_ONLY_COMPRESSED is non-empty if you only want to install the +# compressed versions of built files. +# +INSTALL_ONLY_COMPRESSED?= + +# +# SRCS lists the individual SGML files that make up the document. Changes +# to any of these files will force a rebuild +# + +# SGML content +SRCS= handbook.sgml +SRCS+= advanced-networking/chapter.sgml +SRCS+= backups/chapter.sgml +SRCS+= basics/chapter.sgml +SRCS+= bibliography/chapter.sgml +SRCS+= contrib/chapter.sgml +SRCS+= cutting-edge/chapter.sgml +SRCS+= disks/chapter.sgml +SRCS+= eresources/chapter.sgml +SRCS+= hw/chapter.sgml +SRCS+= install/chapter.sgml +SRCS+= internals/chapter.sgml +SRCS+= introduction/chapter.sgml +SRCS+= kernelconfig/chapter.sgml +SRCS+= kerneldebug/chapter.sgml +SRCS+= kernelopts/chapter.sgml +SRCS+= l10n/chapter.sgml +SRCS+= linuxemu/chapter.sgml +SRCS+= mail/chapter.sgml +SRCS+= mirrors/chapter.sgml +SRCS+= pgpkeys/chapter.sgml +SRCS+= policies/chapter.sgml +SRCS+= ppp-and-slip/chapter.sgml +SRCS+= printing/chapter.sgml +SRCS+= quotas/chapter.sgml +SRCS+= security/chapter.sgml +SRCS+= serialcomms/chapter.sgml +SRCS+= staff/chapter.sgml +SRCS+= x11/chapter.sgml +SRCS+= ports/chapter.sgml + +# Entities +SRCS+= authors.ent +SRCS+= chapters.ent +SRCS+= mailing-lists.ent + +# ------------------------------------------------------------------------ +# +# You shouldn't need to change definitions below here + +VOLUME?= ja/${.CURDIR:T} +DOC?= ${.CURDIR:T} +DISTRIBUTION?= doc/ja + +JADE= /usr/local/bin/jade +DSLHTML= ../../share/sgml/freebsd.dsl +DSLPRINT= ../../share/sgml/freebsd.dsl + +FREEBSDCATALOG= ../../share/sgml/catalog +DOCBOOKCATALOG= /usr/local/share/sgml/docbook/3.0/catalog +JADECATALOG= /usr/local/share/sgml/jade/catalog +DSSSLCATALOG?= /usr/local/share/sgml/docbook/dsssl/modular/catalog + +JADEFLAGS?= ${JADEOPTS} -c ${FREEBSDCATALOG} -c ${DSSSLCATALOG} -c ${DOCBOOKCATALOG} -c ${JADECATALOG} + +KNOWN_FORMATS= html html-split txt rtf ps pdf tex dvi tar + +# ------------------------------------------------------------------------ +# +# Look at ${FORMATS} and work out which documents need to be generated. +# It is assumed that the HTML transformation will always create a file +# called index.html, and that for every other transformation the name +# of the generated file is ${DOC}.format. +# +# ${_docs} will be set to a list of all documents that must be made +# up to date. +# +# ${CLEANFILES} is a list of files that should be removed by the "clean" +# target. ${COMPRESS_EXT:S/^/${DOC}.${_cf}.&/ takes the COMPRESS_EXT var, +# and prepends the filename to each listed extension, building a second +# list of files with the compressed extensions added. +# + +# Note: ".for _curformat in ${KNOWN_FORMATS}" is used several times in this +# file. I know they could have been rolled together in to one, much larger, +# loop. However, that would have made things more complicated for a newcomer +# to this file to unravel and understand, and a syntax error in the loop +# would have affected the entire build/compress/install process, instead +# of just one of them, making it more difficult to debug. + +# Note: It is the aim of this file that *all* the targets be available, +# not just those appropriate to the current ${FORMATS} and +# ${INSTALL_COMPRESSED} values. +# +# For example, if FORMATS=html and INSTALL_COMPRESSED=gz you could still +# type +# +# make book.rtf.bz2 +# +# and it will do the right thing. Or +# +# make install-rtf.bz2 +# +# for that matter. But don't expect "make clean" to work if the FORMATS +# and INSTALL_COMPRESSED variables are wrong. +# + +.for _curformat in ${FORMATS} +_cf=${_curformat} +.if ${_cf} == "html-split" +_docs+= index.html HTML.manifest +CLEANFILES+= `xargs < HTML.manifest` HTML.manifest +.elif ${_cf} == "html" +_docs+= ${DOC}.html +CLEANFILES+= ${DOC}.html +.elif ${_cf} == "txt" +_docs+= ${DOC}.txt +CLEANFILES+= ${DOC}.html ${DOC}.txt +.elif ${_cf} == "dvi" +_docs+= ${DOC}.dvi +CLEANFILES+= ${DOC}.aux ${DOC}.dvi ${DOC}.log ${DOC}.tex +.elif ${_cf} == "ps" +_docs+= ${DOC}.ps +CLEANFILES+= ${DOC}.aux ${DOC}.dvi ${DOC}.log ${DOC}.tex ${DOC}.ps +.elif ${_cf} == "pdf" +_docs+= ${DOC}.pdf +CLEANFILES+= ${DOC}.aux ${DOC}.dvi ${DOC}.log ${DOC}.tex ${DOC}.pdf +.elif ${_cf} == "rtf" +_docs+= ${DOC}.rtf +CLEANFILES+= ${DOC}.rtf +.elif ${_cf} == "tar" +_docs+= ${DOC}.tar +CLEANFILES+= ${DOC}.tar +.endif +.endfor + +# +# Build a list of install-${format}.${compress_format} targets to be +# by "make install". Also, add ${DOC}.${format}.${compress_format} to +# ${_docs} and ${CLEANFILES} so they get built/cleaned by "all" and +# "clean". +# +.if !empty(INSTALL_COMPRESSED) +.for _curformat in ${FORMATS} +_cf=${_curformat} +.for _curcomp in ${INSTALL_COMPRESSED} +.if ${_cf} == "html-split" +_curinst+= install-html-split.tar.${_curcomp} +_docs+= ${DOC}.html-split.tar.${_curcomp} +.else +_curinst+= install-${_curformat}.${_curcomp} +_docs+= ${DOC}.${_curformat}.${_curcomp} +CLEANFILES+= ${DOC}.${_curformat}.${_curcomp} +.endif +.endfor +.endfor +.endif + +# ------------------------------------------------------------------------ +# +# Targets +# + +# +# Build Targets +# + +# If no target is specifed then .MAIN is made +.MAIN: all + +all: ${_docs} + +index.html HTML.manifest: ${SRCS} + ${JADE} -V html-manifest -ioutput.html ${JADEFLAGS} -d ${DSLHTML} -t sgml ${DOC}.sgml + -tidy -i -m -f /dev/null -raw *.html + +${DOC}.html: ${SRCS} + ${JADE} -ioutput.html -V nochunks ${JADEFLAGS} -d ${DSLHTML} -t sgml ${DOC}.sgml > ${DOC}.html + -tidy -i -m -f /dev/null -raw ${DOC}.html + +${DOC}.html-split.tar: HTML.manifest + tar cf ${.TARGET} `xargs < HTML.manifest` + +${DOC}.txt: ${DOC}.html + lynx -nolist -dump ${DOC}.html > ${DOC}.txt + +${DOC}.rtf: ${SRCS} + ${JADE} -ioutput.print ${JADEFLAGS} -d ${DSLPRINT} -t rtf ${DOC}.sgml + +${DOC}.tex: ${SRCS} + ${JADE} -ioutput.print ${JADEFLAGS} -d ${DSLPRINT} -t tex ${DOC}.sgml + +${DOC}.dvi: ${DOC}.tex + @echo "==> TeX pass 1/3" + -tex "&jadetex" ${DOC}.tex + @echo "==> TeX pass 2/3" + -tex "&jadetex" ${DOC}.tex + @echo "==> TeX pass 3/3" + -tex "&jadetex" ${DOC}.tex + +${DOC}.pdf: ${DOC}.tex + @echo "==> PDFTeX pass 1/3" + -pdftex "&pdfjadetex" ${DOC}.tex + @echo "==> PDFTeX pass 2/3" + -pdftex "&pdfjadetex" ${DOC}.tex + @echo "==> PDFTeX pass 3/3" + pdftex "&pdfjadetex" ${DOC}.tex + +${DOC}.ps: ${DOC}.dvi + dvips -o ${DOC}.ps ${DOC}.dvi + +${DOC}.tar: + tar cf ${.TARGET} ${SRCS} + +# ------------------------------------------------------------------------ +# +# Compress targets +# + +# +# The list of compression extensions this Makefile knows about. If you +# add new compression schemes, add to this list (which is a list of +# extensions, hence bz2, *not* bzip2) and extend the _PROG_COMPRESS_* +# targets. +# +KNOWN_COMPRESS= gz bz2 zip + +# +# You can't build suffix rules to do compression, since you can't wildcard +# the source suffix. So these are defined .USE, to be tacked on as +# dependencies of the compress-* targets. +# + +_PROG_COMPRESS_gz: .USE + gzip -9 -c ${.ALLSRC} > ${.TARGET} + +_PROG_COMPRESS_bz2: .USE + bzip2 -9 -c ${.ALLSRC} > ${.TARGET} + +_PROG_COMPRESS_zip: .USE + zip -j -9 ${.TARGET} ${.ALLSRC} + +# +# Build a list of targets for each compression scheme and output format. +# Don't compress the html-split output format. +# +.for _curformat in ${KNOWN_FORMATS} +_cf=${_curformat} +.for _curcompress in ${KNOWN_COMPRESS} +.if ${_cf} == "html-split" +${DOC}.${_cf}.tar.${_curcompress}: ${DOC}.${_cf}.tar _PROG_COMPRESS_${_curcompress} +.else +${DOC}.${_cf}.${_curcompress}: ${DOC}.${_cf} _PROG_COMPRESS_${_curcompress} +.endif +.endfor +.endfor + +# +# Install targets +# +# Build install-* targets, one per allowed value in FORMATS. Need to build +# two specific targets; +# +# install-html-split - Handles multiple .html files being generated +# from one source. Uses the HTML.manifest file +# created by the stylesheets, which should list +# each .html file that's been created. +# +# install-* - Every other format. The wildcard expands to +# the other allowed formats, all of which should +# generate just one file. +# +# "beforeinstall" and "afterinstall" are hooks in to this process. +# Redefine them to do things before and after the files are installed, +# respectively. +# +install: beforeinstall realinstall afterinstall + +# +# Build a list of install-format targets to be installed. These will be +# dependencies for the "realinstall" target. +# +.if empty(INSTALL_ONLY_COMPRESSED) +_curinst+= ${FORMATS:S/^/install-/g} +.endif + +realinstall: ${_curinst} + +.for _curformat in ${KNOWN_FORMATS} +_cf=${_curformat} +.if !target(install-${_cf}) +.if ${_cf} == "html-split" +install-${_cf}: index.html + @if [ ! -f HTML.manifest ]; then \ + echo "HTML.manifest file does not exist, can't install";\ + exit 1; \ + fi + ${INSTALL} ${COPY} -o ${DOCOWN} -g ${DOCGRP} -m ${DOCMODE} \ + `xargs < HTML.manifest` ${DESTDIR}${DOCDIR}/${VOLUME}; \ + if [ -f ${.OBJDIR}/${DOC}.ln ]; then \ + (cd ${DESTDIR}${DOCDIR}/${VOLUME}; \ + sh ${.OBJDIR}/${DOC}.ln); \ + fi +.for _compressext in ${KNOWN_COMPRESS} +install-${_cf}.tar.${_compressext}: ${DOC}.${_cf}.tar.${_compressext} + ${INSTALL} ${COPY} -o ${DOCOWN} -g ${DOCGRP} -m ${DOCMODE} \ + ${.ALLSRC} ${DESTDIR}${DOCDIR}/${VOLUME} +.endfor +.else +install-${_cf}: ${DOC}.${_cf} + ${INSTALL} ${COPY} -o ${DOCOWN} -g ${DOCGRP} -m ${DOCMODE} \ + ${.ALLSRC} ${DESTDIR}${DOCDIR}/${VOLUME} + +.for _compressext in ${KNOWN_COMPRESS} +install-${_cf}.${_compressext}: ${DOC}.${_cf}.${_compressext} + ${INSTALL} ${COPY} -o ${DOCOWN} -g ${DOCGRP} -m ${DOCMODE} \ + ${.ALLSRC} ${DESTDIR}${DOCDIR}/${VOLUME} +.endfor +.endif +.endif +.endfor + +.for __target in beforeinstall afterinstall depend _SUBDIR +.if !target(${__target}) +${__target}: +.endif +.endfor + +# +# Distribution target +# +# Like "install", but places the files into the correct distribution +# +.if !target(distribute) +distribute: +.for dist in ${DISTRIBUTION} + cd ${.CURDIR}; $(MAKE) install DESTDIR=${DISTDIR}/${dist} +.endfor +.endif + +.include <bsd.dep.mk> +.include <bsd.obj.mk> diff --git a/ja_JP.eucJP/books/handbook/advanced-networking/chapter.sgml b/ja_JP.eucJP/books/handbook/advanced-networking/chapter.sgml new file mode 100644 index 0000000000..c11c0c3b2d --- /dev/null +++ b/ja_JP.eucJP/books/handbook/advanced-networking/chapter.sgml @@ -0,0 +1,1079 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.10 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:59 kuriyama Exp $ +--> + +<chapter id="advanced-networking"> + <title>高度なネットワーク</title> + + <sect1 id="routing"> + <title>ゲートウェイとルート</title> + + <para><emphasis>原作: &a.gryphon;. + <!-- <br> -->6 October 1995.</emphasis></para> + + <para><emphasis>訳: &a.jp.yuki;.<!-- <br> --> + 6 September 1996.</emphasis></para> + + <para>ある計算機が他の計算機をみつけることができるようにするには, + ある計算機から他の計算機へ, + どのようにたどり着くかを適切に記述するた めの仕組みが必要です. + この仕組みをルーティングと呼びます. “ルート(経路)”は + “destination (目的地) ”と “gateway (ゲー + トウェイ) ”の 2つのアドレスの組で定義します. あなたが + <emphasis>destination</emphasis> へアクセスしようとした場合, + <emphasis>gateway</emphasis> + を通って送られることをこのペアは示しています. destination + には個々のホスト, サブネット, “デフォルト”の 3つの + タイプがあります. + “デフォルトルート”は他への経路が適用できない + 場合に使われます. のちほどデフォルトルートについて少し述べること + するとして, ここでは, 個々のホスト, インタフェース + (“リンク”と も呼ばれます), + イーサネットハードウェアアドレスという 3つのタイ + プのゲートウェイについて説明します.</para> + + <sect2> + <title>例</title> + + <para>以下に示す <command>netstat -r</command> + の出力の例を使って, ルーティン + グがいろいろと異なっている様子を説明することにします.</para> + + <screen>Destination Gateway Flags Refs Use Netif Expire + +default outside-gw UGSc 37 418 ppp0 +localhost localhost UH 0 181 lo0 +test0 0:e0:b5:36:cf:4f UHLW 5 63288 ed0 77 +10.20.30.255 link#1 UHLW 1 2421 +foobar.com link#1 UC 0 0 +host1 0:e0:a8:37:8:1e UHLW 3 4601 lo0 +host2 0:e0:a8:37:8:1e UHLW 0 5 lo0 => +host2.foobar.com link#1 UC 0 0 +224 link#1 UC 0 0</screen> + + <para>最初の2行はデフォルトルート(次の節で詳しく説明します)と, + <hostid>localhost</hostid>への経路を示しています.</para> + + <para><literal>localhost</literal>のためのインタフェース + (<literal>Netif</literal>の欄) + は<devicename>lo0</devicename>で, + これはループバックデバイスとして知られています. + 結局のところ戻るだけなので, この + destinationへのすべてのトラフィ + ックが内部的に処理されるのであって, LAN + を経由して送られるのでは ありません.</para> + + <para>次の行では<hostid + role="mac">0:e0:...</hostid>というアドレスに注目しましょう. + これはイーサネットハードウェアアドレスです. FreeBSDは自動的に + ローカルなイーサネット上の任意のホスト + (この例では<hostid>test0</hostid>) を見つけ, + イーサネットインタフェース <devicename>ed0</devicename> + の所にそのホスト への経路を直接つけ加えます. タイムアウト時間 + (<literal>Expire</literal>の 欄) + も経路のタイプと結びついており, 指定された時間が経過しても応 + 答がないときに使用します. この場合, + 経路情報は自動的に削除されま す. これらのホストは, RIP(Routing + Information Protocol) という, + 最短パスの判定に基づいてローカルホストへの経路を + 決定する仕組みを 利用することで認識されます.</para> + + <para>更に, FreeBSDではローカルサブネット (<hostid + role="ipaddr">10.20.30.255</hostid> は <hostid + role="ipaddr">10.20.30</hostid> + というサブネットに対するブロードキャストアドレスで, <hostid + role="domainname">foobar.com</hostid> + はこのサブネットに結びつけられているドメイン名) + への経路情報も加えることができます. + <literal>link#1</literal>というの は, + この計算機の最初のイーサネットカードのことをさします. これら + については, + 何も追加インタフェースが指定されていないことに気づく + でしょう.</para> + + <para>これらの2つのグループ(ローカルネットワークホストと + ローカルサブネット) の両方とも, <command>routed</command> + と呼ばれるデーモンによって自動的に 経路が設定されます. + <emphasis remap=tt>routed</emphasis> を動かさなければ, + 静的に定義した (つまり具体的に 設定した) + 経路のみ存在することになります.</para> + + <para><literal>host1</literal> の行は私たちのホストのことで, + イーサネットアドレスで示されています. 送信側のホストの場合, + FreeBSDはイーサネットインタフェースへ 送るのではなく, + ループバックインタフェース + (<devicename>lo0</devicename>)を使います.</para> + + <para>2つある<literal>host2</literal>の行は, + ifconfigのエイリアス (このようなこと をする理由については + ethernetの章を参照してください) を使ったとき + にどのようになるかを示す例です. + <devicename>lo0</devicename>の後にある<literal>=></literal> + は, インタフェースが + (このアドレスがローカルなホストを参照しているので) + ループバックを使っているというだけでなく, + エイリアスになっていることも 示しています. + このような経路はエイリアスをサポートしている + ホストにのみ現れます. + ローカルネットワーク上の他のすべてのホストでは + 単に<literal>link#1</literal>となります.</para> + + <para>最後の行 (destinationが<literal>224</literal>のサブネット) + はマルチキャスト で扱うものですが, + これは他の章で説明します.</para> + + <para>他の欄については <literal>Flags</literal> + について説明する必要があります. + それぞれの経路は欄に示されているように違った属性を + もっています. + 以下にいくつかのフラグとこれらが何を意味しているかを示します. + </para> + + <informaltable frame="none"> + <tgroup cols="2"> + <tbody> + <row> + <entry>U</entry> + <entry>Up: この経路はアクティブです.</entry> + </row> + + <row> + <entry>H</entry> + <entry>Host: 経路の destinationが単一のホストです.</entry> + </row> + + <row> + <entry>G</entry> + <entry>Gateway: この destinationへ送られると, どこへ送れ + ばよいかを明らかにして, + そのリモートシステムへ送られます.</entry> + </row> + + <row> + <entry>S</entry> + <entry>Static: この経路はシステムによって自動的に生成 + されたのではなく, 手動で作成されました.</entry> + </row> + + <row> + <entry>C</entry> + <entry>Clone: マシンに接続したときにこの経路に基づく + 新しい経路が作られます. このタイプの経路は通常は + ローカルネットワークで使われます.</entry> + </row> + + <row> + <entry>W</entry> + <entry>WasCloned: ローカルエリアネットワーク(Clone) + の経路に基づいて + 自動的に生成された経路であることを示します.</entry> + </row> + + <row> + <entry>L</entry> + <entry>Link: イーサネットハードウェアへの参照を含む + 経路です.</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </sect2> + + <sect2> + <title>デフォルトルート</title> + + <para>ローカルシステムからリモートホストにコネクションを張る + 必要がある場合, 既知のパスが存在するかどうかを確認するためにル + ーティングテーブルをチェッ クします. + 到達するためのパスを知っているサブネットの内部にリモ + ートホストがある場合 (Cloned routes), システムはインタフェース + から接続できるかどうかをチェックします.</para> + + <para>知っているパスがすべて駄目だった場合でも, システムには + 最後の切り札の “デフォルト”ルートがあります. + このルートは ゲートウェイルート (普通はシステムに + 1つしかありません) の特別なものです. そして, + フラグフィールドは必ず <literal>c</literal> + がマークされています. このゲートウェイは, LAN 内のホストにとっ + て, 外部 (PPPのリンクを経由する場合や, + データラインに接続するハー ドウェアデバイスなど) + へ直接接続するマシンすべてのためのものです.</para> + + <para>外部に対するゲートウェイとして機能するマシンで + デフォルトルート を設定する場合, + デフォルトルートは インターネットサービスプロバイダ (ISP) + のサイトのゲートウェ イマシンになるでしょう.</para> + + <para>それではデフォルトルートの一例を見てみましょう. + 一般的な構成を示します. </para> + +<literallayout> +[Local2] <--ether--> [Local1] <--PPP--> [ISP-Serv] <--ether--> [T1-GW] + </literallayout> + + <para>ホスト <hostid>Local1</hostid> とホスト <hostid>Local2</hostid> + を PPP で ISP のターミナルサーバと接続されているあなたの + サイトだとします. + ISP はサイト内にロー カルなネットワークを持っていて, + そこにはまざまなものがあり, + あなたの接続するサーバや ISP のインターネットへの + 接続点であるハードウェアデバイス (T1-GW) などがあります.</para> + + <para>あなたのマシンのデフォルトルートは + それぞれ次のようになります.</para> + + <informaltable frame="none"> + <tgroup cols="3"> + <thead> + <row> + <entry>host</entry> + <entry>default gateway</entry> + <entry>interface</entry> + </row> + </thead> + + <tbody> + <row> + <entry>Local2</entry> + <entry>Local1</entry> + <entry>ethernet</entry> + </row> + + <row> + <entry>Local1</entry> + <entry>T1-GW</entry> + <entry>PPP</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>“なぜ (あるいは, どうやって) Local1 の + デフォルトゲートウェイをISPのサーバでなく + T1-GWにセットするのか”という質問がよくあります.</para> + + <para>コネクションのローカルの側については, + PPPのインタフェースは + ISPのローカルネットワーク上のアドレスを用いているため, + ISPのローカルネットワーク上のすべてのマシンへの経路は + 自動的に生成されています. つまり, あなたのマシンは, + どのようにT1-GW + まで届くかという経路を既に知っていることになりますから, + ISPサーバに媒介的なトラフィックをかける必要はありません.</para> + + <para>最後になりましたが, 一般的にローカルネットワークでは + <hostid role="ipaddr">...1</hostid> + というアドレスをゲートウェイアドレスとして使います. ですから + (同じ例を用います), あなたのclass-Cのアドレス空間が <hostid + role="ipaddr">10.20.30</hostid>で ISPが<hostid + role="ipaddr">10.9.9</hostid>を用いている場合, + デフォルトルートは次のようになります.</para> + + <literallayout> +Local2 (10.20.30.2) --> Local1 (10.20.30.1) +Local1 (10.20.30.1, 10.9.9.30) --> T1-GW (10.9.9.1) + </literallayout> + </sect2> + + <sect2> + <title>マルチホームホスト</title> + + <para>ここで扱うべき他のタイプの設定があります. + それは2つの異なるネットワー クにまたがるホストです. + 技術的にはゲートウェイとして機能するマシン (上 の例では + PPPコネクションを用いています) はマルチホームホストで す. + しかし実際にはこの言葉は, + 2つのローカルエリアネットワーク上のサ + イトであるマシンを指す言葉としてのみ使われます.</para> + + <para>2枚のイーサネットカードを持つマシンが, 別のサブネット + 上にそれぞれアドレスを持っている場合があります. あるいは, + イーサネットカードを1枚持っているマシンで, + ifconfigのエイリアスを使っているかもしれません. + 物理的に分かれている2つのイーサネットのネットワークが使われて + いるならば前者が用いられます. 後者は, 物理的には1つのネットワ + ークセグメントで, 論理的には分かれている 2つのサブネットとする + 場合に用いられます.</para> + + <para>どちらにしても, + このマシンがお互いのサブネットへのゲートウェイ (inbound + route) として定義されていることが分かるように, おのお + ののサブネットでルーティングテーブルを設定します. このマシンが + 2 つのサブネットの間のブリッジとして動作するという構成は, パケ + ットのフィルタリングを実装する必要がある場合や, 一方向または双 + 方向のファイアウォールを利用したセキュリティを構築する場合によ + く用いられます.</para> + </sect2> + + <sect2> + <title>ルーティングの伝播</title> + + <para>すでに外部との経路をどのように定義したらよいかは + 説明しました. + しかし外部から私たちのマシンをどのようにして + 見つけるのかについては説明していません.</para> + + <para>ある特定のアドレス空間 (この例では class-C のサブネット) + にお けるすべてのトラフィックが, + 到着したパケットを内部で転送するネ + ットワーク上の特定のホストに送られるようにルーティングテーブル + を設定することができるのは分かっています.</para> + + <para>あなたのサイトにアドレス空間を割り当てる場合, + あなたのサブネッ トへのすべてのトラフィックがすべて + PPPリンクを通じてサイトに送 + ってくるようにサービスプロバイダはルーティングテーブルを設定し + ます. しかし, 国境の向こう側のサイトはどのようにしてあなたの + ISPへ送ることを知るのでしょうか?</para> + + <para>割り当てられているすべてのアドレス空間の経路を維持する + (分散し ている DNS 情報とよく似た) システムがあり, + そのインターネット バックボーンへの接続点を定義しています. + “バックボーン” とは国を越え, + 世界中のインターネットのトラフィックを運ぶ主要 + な信用できる幹線のことです. どのバックボーンマシンも, + あるネット + ワークから特定のバックボーンのマシンへ向かうトラフィックと, + そのバックボーンのマシンからあなたのネットワークに届くサービス + プロバイダまでのチェーンのマスタテーブルのコピーを持っていま + す.</para> + + <para>あなたのサイトが接続(プロバイダからみて内側にある + ことになります) したということを, プロバイダからバックボー + ンサイトへ通知することはプロバイダの仕事です. これが経 + 路の伝搬です.</para> + </sect2> + + <sect2> + <title>トラブルシューティング</title> + + <para>ルーティングの伝搬に問題が生じて, いくつかのサイトが + 接続をおこなうことができなくなることがあります. + ルーティングがどこでおかしくなっているかを明らかにするのに + 最も有効なコマンドはおそらく &man.traceroute.8; コマンドでしょ + う. このコマンドは, + あなたがリモートマシンに対して接続をおこなう + ことができない(例えば &man.ping.8; に失敗するような場合) + 場合も, 同じように有効です.</para> + + <para> &man.traceroute.8; コマンドは, + 接続を試みているリモートホスト を引数にして実行します. + 試みているパスの経由する ゲートウェイホストを表示し, + 最終的には目的のホストに たどり着くか, + コネクションの欠如によって終ってしまうかのどちら + かになります.</para> + + <para>より詳しい情報は, &man.traceroute.8; + のマニュアルページをみてください.</para> + </sect2> + </sect1> + + <sect1 id="nfs"> + <title>NFS</title> + + <para><emphasis>原作: &a.jlind;.</emphasis></para> + + <para><emphasis>訳: &a.jp.tomo;.<!-- <br> --> + 6 September 1996.</emphasis></para> + + <para>ISA用のイーサネットアダプタの中には性能が悪いため, + ネットワーク, 特に NFS で深刻な問題がおきるものがあります. + これは FreeBSD に限ったことでは ありませんが, FreeBSD + でも起こり得ます.</para> + + <para>この問題は, + (FreeBSDを使用した) PC がシリコン・グラフィックス社や + サン・マイクロ システムズ社などの高性能な WS + にネットワーク接続されている場合に頻繁に起こります. + NFS マウントはうまく行きます. また, + いくつかの操作もうまく働きますが, 他のシステム (WS) + に対する要求や応答は続いていても, 突然サーバ が + クライアントの要求に対して反応しなくなります. + これは, クライアントが FreeBSD か上記の WS であるとき, + にクライアント側に起きる 現象です. + 多くのシステムでは, いったんこの問題が起きたら解決できないので, + 行儀よくシャットダウンするしかありません. + 唯一の解決策は, この状況に陥る前にクライアントを + リセットすることです. なぜなら, 一旦この状況に陥ると + NFS を解除することさえできないからです.</para> + <!-- kuriyama - should re-write translation --> + + <para>“正しい”解決法は, + より高性能のイーサネットアダプタをFreeBSDシステムに + インストールすることですが, + 満足な操作ができるような簡単な方法があります. もし, + FreeBSDシステムが<emphasis>サーバ</emphasis>になるのなら, + クライアントからのマウント時に + <option>-w=1024</option>オプションをつけて下さい. + もしFreeBSDシステムが<emphasis>クライアント</emphasis>になる + のなら, NFSファイルシステムを <option>-r=1024</option> + オプションつきでマウントして下さい. + これらのオプションは自動的にマウントをおこなう場合には + クライアントの <filename>fstab</filename> + エントリの4番目のフィールドに指定してもよいですし, + 手動マウントの場合は mount コマンドの <option>-o</option> + パラメータで指定してもよいでしょう.</para> + + <para>NFSサーバとクライアントが別々のネットワーク上にあるような + 場合, これと間違えやすい他の問題が起きることに注意して下さい. + そのような場合は, ルータが必要な UDP 情報をきちんと + ルーティングしているかを確かめて下さい. + そうでなければ, たとえあなたが何をしようと解決できないでしょう. + </para> + + <para>次の例では, <hostid>fastws</hostid>は高性能のWSのホスト + (インタフェース)名で, + <hostid>freebox</hostid>は低性能のイーサネットアダプタを備えた + FreeBSDシステムのホスト(インタフェース)名です.</para> + + <para>また, <filename>/sharedfs</filename> はエクスポートされる + NFS ファイルシステムであり (<command>man exports</command> + を見て下さい), <filename>/project</filename> + はエクスポートされたファイルシステムの + クライアント上のマウントポイントとなります. + 全ての場合において, <option>hard</option> や <option>soft</option>, + <option>bg</option> といった追加オプションが + アプリケーションにより要求されるかもしれないことに + 注意して下さい.</para> + + <para>クライアント側 FreeBSD システム (<hostid>freebox</hostid>) + の例は: + <!-- kuriyama - Eng. ver should be hostid for freebox --> + <hostid>freebox</hostid> の <filename>/etc/fstab</filename> + に次のように書いて下さい:</para> + + <programlisting> +fastws:/sharedfs /project nfs rw,-r=1024 0 0</programlisting> + + <para><hostid>freebox</hostid> 上で手動で mount + コマンドを実行する場合は次のようにして下さい:</para> + + <screen>&prompt.root; <userinput>mount -t nfs -o -r=1024 fastws:/sharedfs /project</userinput></screen> + + <para>サーバ側FreeBSDシステムの例は: <hostid>fastws</hostid> の + <filename>/etc/fstab</filename> に次のように書いて下さい:</para> + + <programlisting> +freebox:/sharedfs /project nfs rw,-w=1024 0 0</programlisting> + + <para><hostid>fastws</hostid> 上で手動で mount + コマンドで実行する場合は次のようにして下さい:</para> + + <screen>&prompt.root; <userinput>mount -t nfs -o -w=1024 freebox:/sharedfs /project</userinput></screen> + + <para>近いうちにどのような 16 ビットのイーサネットアダプタでも + 上記の読み出し, + 書き込みサイズの制限なしの操作ができるようになるでしょう.</para> + + <para>失敗が発生したとき何が起きているか関心のある人に, + なぜ回復不可能なのか も含めて説明します. NFSは通常 + (より小さいサイズへ分割されるかもしれませんが) + 8Kの“ブロック” サイズで働きます. + イーサネットのパケットサイズは最大1500バイト程度なので, + 上位階層のコードにとっては1つのユニットのままなのですが, + NFS“ブロック”は + 複数のイーサネットパケットに分割されます. そして受信され, + 組み立て直されてから 肯定応答されなければなりません. + 高性能のWSは次々に NFSユニットを構成するパケットを, + 基準の範囲内で間隔を詰めて 次々に送り出すことができます. 小さく, + 容量の低いカードでは, 同じユニットの + 前のパケットがホストに転送される前に, 後のパケットがそれを + 「踏みつぶし」てしまいます. + このため全体としてのユニットは再構成もされないし, + 肯定応答もされません. その結果, + WSはタイムアウトして再送を試みますが, + 8Kのユニット全体を再送しようとするので, このプロセスは + 際限無く繰り返されてしまいます.</para> + + <para>ユニットサイズを イーサネットのパケットサイズの + 制限以下に抑えることにより, 受信された完全な + イーサネットパケットは個々に肯定応答を受けられることが + 保証されるので, + デッドロック状態を避けることができるようになります.</para> + + <para>高性能のカードを使っている場合でも, 高性能な WS + が力任せに次々と PC システムにデータを送ったときには + 「踏みつぶし」 が起きるかもしれません. + そのような「踏みつぶし」は NFS “ユニット” + では保証されていません. 「踏みつぶし」が起こったとき, + 影響を受けたユニットは再送されます. そして受信され, + 組み立てられ, + 肯定応答される公平な機会が与えられるでしょう.</para> + </sect1> + + <sect1 id="diskless"> + <title>Diskless operation</title> + + <para><emphasis>原作: &a.martin;</emphasis></para> + + <para><emphasis>訳: &a.jp.yasu;</emphasis></para> + + <para><filename>netboot.com</filename>/<filename>netboot.rom</filename> + によって, ディスクのないクライアントで ネットワーク経由で + FreeBSD マシンのブートを行い FreeBSD を走らせることができます. + 2.0 ではローカルなスワップを持つことができます. + NFS 経由のスワッピングもサポートされています. </para> + + <para>サポートされているイーサネットカード: + Western Digital/SMC 8003, 8013, 8216 とその互換ボード, + NE1000/NE2000 とその互換カード (再コンパイルが必要)</para> + + <sect2> + <title>セットアップの手順</title> + + <procedure> + <step> + <para>サーバにするマシンを見つけます. + このマシンには, FreeBSD 2.0のバイナリとbootpを + 記憶するだけの十分なディスクスペースが必要です. + tftp と NFS も使えます. + + テストしたマシン:</para> + + <itemizedlist> + <listitem> + <para>HP9000/8xx / HP-UX 9.04以降 + (9.04以前では動きません)</para> + </listitem> + + <listitem> + <para>Sun/Solaris 2.3. (bootpが必要)</para> + </listitem> + </itemizedlist> + </step> + + <step> + <para>クライアントにIP,gateway,netmaskを提供する + bootpサーバをセットアップします.</para> + + <programlisting> +diskless:\ + :ht=ether:\ + :ha=0000c01f848a:\ + :sm=255.255.255.0:\ + :hn:\ + :ds=192.1.2.3:\ + :ip=192.1.2.4:\ + :gw=192.1.2.5:\ + :vm=rfc1048:</programlisting> + + </step> + + <step> + <para>クライアントにブート情報を提供する TFTP サーバを + (bootp サーバと同じマシンに) セットアップします. + このファイルの名前は, + <filename>cfg.<replaceable>X.X.X.X</replaceable></filename> + (もしくは <filename>/tftpboot/cfg. + <replaceable>X.X.X.X</replaceable></filename>)で, + ここで <replaceable>X.X.X.X</replaceable> はクライアントの + IP アドレスです. + このファイルの内容は netboot コマンドで有効です. + 2.0では, netboot は以下のようなコマンドを持ちます:</para> + + <informaltable frame="none"> + <tgroup cols="2"> + <tbody> + <row> + <entry>help</entry> + <entry>helpリストの表示</entry> + </row> + + <row> + <entry>ip + <option><replaceable>X.X.X.X</replaceable></option></entry> + <entry>クライアントのIPアドレスの表示/セット</entry> + </row> + + <row> + <entry>server + <option><replaceable>X.X.X.X</replaceable></option></entry> + <entry>bootp/tftp サーバのアドレスの表示/セット</entry> + </row> + + <row> + <entry>netmask + <option><replaceable>X.X.X.X</replaceable></option></entry> + <entry>netmaskの表示/セット</entry> + </row> + + <row> + <entry>hostname <replaceable>name</replaceable></entry> + <entry>hostnameの表示/セット</entry> + </row> + + <row> + <entry>kernel + <option><replaceable>name</replaceable></option></entry> + <entry>カーネル名の表示/セット</entry> + </row> + + <row> + <entry>rootfs + <option><replaceable>ip:/fs</replaceable></option></entry> + <entry>root ファイルシステムの表示/セット</entry> + </row> + + <row> + <entry>swapfs + <option><replaceable>ip:/fs</replaceable></option></entry> + <entry>swap ファイルシステムの表示/セット</entry> + </row> + + <row> + <entry>swapsize + <option><replaceable>size</replaceable></option></entry> + <entry>diskless swapsize を Kbytes単位でセット</entry> + </row> + + <row> + <entry>diskboot</entry> + <entry>ディスクからのブート</entry> + </row> + + <row> + <entry>autoboot</entry> + <entry>ブートプロセスの続行</entry> + </row> + + <row> + <entry>trans + <option>on</option>|<option>off</option></entry> + <entry>トランシーバのオン|オフ</entry> + </row> + + <row> + <entry>flags + <option>b</option><option>c</option> + <option>d</option><option>h</option> + <option>s</option><option>v</option></entry> + <entry>ブートフラグの設定</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>完全にディスクレスな場合の一般的な cfg + ファイルは以下のようになります:</para> + + <programlisting> +rootfs 192.1.2.3:/rootfs/myclient +swapfs 192.1.2.3:/swapfs +swapsize 20000 +hostname myclient.mydomain</programlisting> + + <para>ローカルに swap + を持つマシンについては以下のようになります:</para> + + <programlisting> +rootfs 192.1.2.3:/rootfs/myclient +hostname myclient.mydomain</programlisting> + + </step> + + <step> + <para>NFS サーバがクライアントにroot(必要ならswapも) + ファイルシステムをexportしているか, また, + クライアントがこれらのファイルシステムに + ルートアクセスできるか確認します. FreeBSDにおける一般的な + <filename>/etc/exports</filename> ファイルは + 以下のようになります:</para> + + <programlisting> +/rootfs/myclient -maproot=0:0 myclient.mydomain +/swapfs -maproot=0:0 myclient.mydomain</programlisting> + + <para>そして, HP-UX側では以下のようになります:</para> + + <programlisting> +/rootfs/myclient -root=myclient.mydomain +/swapfs -root=myclient.mydomain</programlisting> + </step> + + <step> + <para>NFS経由でスワッピングを行う場合 + (完全にディスクレスな場合の設定), クライアントが使用する + swap ファイルを <command>dd</command> で作成します. + もし, <command>swapfs</command> コマンドが上記の例のように + 引数 <filename>/swapfs</filename>を持ちそのサイズが 20000 + である場合, myclientに対するスワップファイルは + <filename>/swapfs/swap.<replaceable>X.X.X.X</replaceable> + </filename> で呼び出されます. ここで + <replaceable>X.X.X.X</replaceable> はクライアントの IP + アドレスです. 例:</para> + + <screen>&prompt.root; <userinput>dd if=/dev/zero of=/swapfs/swap.192.1.2.4 bs=1k count=20000</userinput></screen> + + <para>また, スワッピングが開始されるとクライアントの + スワップスペースはセンシティブな情報を含むようになるので, + 不正なアクセスを防止するため, このファイルへの + 読み書きのアクセス制限がなされていることを確認して下さい: + </para> + + <screen>&prompt.root; <userinput>chmod 0600 /swapfs/swap.192.1.2.4</userinput></screen> + </step> + + <step> + <para>クライアントがそれぞれのrootファイルシステムとして使う + ディレクトリにrootファイルシステムを展開します. + (上記の例では<filename>/rootfs/myclient</filename>).</para> + + <itemizedlist> + <listitem> + <para>HP-UX システム: サーバはHP9000/800 + シリーズのマシンで, HP-UX 9.04 以降が必要です. + これ以前のバージョンでは NFS + を経由するデバイスファイルが 作成ができません.</para> + </listitem> + + <listitem> + <para><filename>/rootfs/myclient</filename> に + <filename>/dev</filename> を + 展開する際に, いくつかのシステム (HPUX) では + FreeBSD に合った デバイスファイルが作成されないので + 注意してください. + その際には最初の起動時にシングルユーザモードに + 移行して (ブートの段階でCtrl-Cを押す), + <filename>/dev</filename> に移って + <command>sh ./MAKEDEV all</command> として, + クライアントからこれを 修正してください.</para> + </listitem> + </itemizedlist> + </step> + + <step> + <para>クライアントで <command>netboot.com</command> + を実行するか, <filename>netboot.rom</filename> + ファイルから EPROMを作成します.</para> + </step> + </procedure> + </sect2> + + <sect2> + <title><filename>/</filename> および <filename>/usr</filename> + ファイルシステムを共有して使用する</title> + + <para>今のところ, これを行う公式に認められた方法はありませんが, + 私はそれぞれのクライアントで <filename>/usr</filename> + ファイルシステムと 個々の <filename>/</filename> + ファイルシステム を共有して使っています. + どなたかこれをきちんと行うやり方の提案がありましたら, + 私に, もしくは &a.core; グループに知らせてください.</para> + </sect2> + + <sect2> + <title>特定の設定についてnetbootをコンパイルする</title> + + <para><filename>/sys/i386/boot/netboot/Makefile</filename> + の中の設定を変更して + コンパイルすることで, netbootでNE1000/2000 + カードをサポートします. + このファイルの先頭にあるコメントを見てください.</para> + </sect2> + </sect1> + + <sect1 id="isdn"> + <title>ISDN</title> + + <para><emphasis>最終更新: &a.wlloyd;</emphasis>.</para> + + <para><emphasis>訳: &a.jp.kiroh;.<!-- <br> --> + 11 December 1996.</emphasis></para> + + <para>ISDN 技術とハードウェアに関しては, <ulink + URL="http://alumni.caltech.edu/~dank/isdn/">Dan Kegel's ISDN + Page</ulink> がよい参考になるでしょう.</para> + + <para>ISDN の導入手順は, 簡単にいって以下のようになります. </para> + + <itemizedlist> + <listitem> + <para>ヨーロッパ在住の方は, ISDN + カードの節に進んでください.</para> + </listitem> + + <listitem> + <para>ISDN を使って, + インターネットプロバイダに(専用線は使用せず), ダ + イアルアップ接続しようとしている場合は, + ターミナルアダプタの使用を考え てみてください. + この方法はもっとも柔軟性があり, プロバイダを変更した場 + 合の問題も少ないでしょう.</para> + </listitem> + + <listitem> + <para>2つの LAN の間を接続しようする場合や, ISDN + 専用線を使用する場合 には, + スタンドアローンルータ/ブリッジの使用を勧めます.</para> + </listitem> + </itemizedlist> + + <para>どの方法を用いるかを決定するには, + 費用が重要な要素になってきます. 以下に, 最も安価な方法から, + 高価な方法まで順に説明していきます.</para> + + <sect2> + <title>ISDN カード</title> + + <para><emphasis>著者:&a.hm;.</emphasis></para> + + <para>このセクションの記述は, DSS1/Q.931 ISDN + 標準がサポートされている国のユーザにのみ有効です.</para> + + <para>最近増えてきている PC ISDN カードのうちいくつかは, FreeBSD + 2.2.x 以降で isdn4bsd + ドライバパッケージによりサポートされています. + 依然として開発中ではありますが, + ヨーロッパ中でうまく動作しているという報告があります.</para> + + <para>最新の isdn4bsd は, <ulink + url="ftp://isdn4bsd@ftp.consol.de/pub">ftp://isdn4bsd@ftp.consol.de/pub</ulink> から入手できます. + この ftp サイトでは, ユーザ名として <username>isdn4bsd</username> + を使い, パスワードにメールアドレスを使ってログインする + 必要があります. ログインできたら <filename>pub</filename> + ディレクトリに移動してください. ユーザー名 + <username>ftp</username> や <username>anonymous</username> + によるログインでは, 必要なファイルにたどりつけません.</para> + + <para>isdn4bsd は, IP over raw HDLC もしくは同期 PPP + を利用して他の ISDN ルータと接続できます. + 留守番電話アプリケーションも使えます.</para> + + <para>Siemens ISDN チップセット (ISAC/HSCX) + を使用したものを主に多くのカードがサポートされています. + 他のチップセット (Motorola, Cologn ChipDesigns) + のサポートは現在開発中です. + サポートされるカードの最新のリストは, <ulink + url="ftp://isdn4bsd@ftp.consol.de/pub/README">README</ulink> + を参照してください.</para> + + <para>他の ISDN プロトコルを追加したい場合や, + サポートされていない ISDN PC カード サポートしたい場合など + isdn4bsd を拡張したい場合は, <email>hm@kts.org</email> + までご連絡ください.</para> + + <para>majordomoによるメーリングリストが利用できます. + 参加するには, 本文に <programlisting> subscribe + freebsd-isdn</programlisting> と記入したメールを + &a.majordomo; 宛てに送ってください.</para> + </sect2> + + <sect2> + <title>ISDN ターミナルアダプタ</title> + + <para>ターミナルアダプタ (TA) はISDN に対して, + 通常の電話線に対するモデ ムに相当するものです.</para> + + <para>ほとんどの TA は, 標準のヘイズ AT + コマンドセットを使用しているので, + 単にモデムと置き換えて使うことができます.</para> + + <para>TA は, 基本的にはモデムと同じように動作しますが, + 接続方法は異なり, 通 + 信速度も古いモデムよりはるかに速くなります. <link + linkend="ppp">PPP</link> の設定を, + モデムの場合と同じように行ってください. とくにシリアル速度を + 使用できる最高速度に設定するのを忘れないでください.</para> + + <para>プロバイダへの接続に TA を使用する最大のメリットは, 動的 + PPP を行える ことです. 最近 IP アドレスが不足してきているため, + ほとんどのプロバイダ は, 専用の IP + アドレスを割り当てないようになっています. ほとんどのスタ + ンドアローンルータは, 動的 IP + アドレスに対応していません.</para> + + <para>訳注: 最近の ISDN ルータでは, IP + アドレスの動的割り当てに対応している ものも多いようです. + ただし制限がある場合もありますので, 詳しくはメーカ + に問い合わせてください.</para> + + <para>TA を使用した場合の機能や接続の安定性は, 使用している PPP + デーモンに完 全に依存します. そのため, FreeBSD で PPP + の設定が完了していれば, 使用 している既存のモデムを ISDN の TA + に簡単にアップグレードすることができ ます. ただし, それまでの + PPP のプログラムに問題があった場合, その問題 は TA + に置き換えてもそのまま残ります.</para> + + <para>最高の安定性を求めるのであれば, ユーザープロセス<link + linkend="userppp">iijPPP</link> ではなく, カーネル<link + linkend="ppp">PPP</link>を使用してく ださい.</para> + + <para>以下の TA は, FreeBSD で動作確認ずみです.</para> + + <itemizedlist> + <listitem> + <para>Motorola BitSurfer および Bitsurfer Pro</para> + </listitem> + + <listitem> + <para>Adtran</para> + </listitem> + </itemizedlist> + + <para>他の TA もほとんどの場合うまく動作するでしょう. TA + のメーカーでは, TA がほとんどの標準モデム AT + コマンドセットを受け付けるようにするよう, 努 + 力しているようです.</para> + + <para>外部 TA を使う際の最大の問題点は, + モデムの場合と同じく良いシリアルカー + ドが必要であるということです.</para> + + <para>シリアルデバイスの詳細, + そして非同期シリアルポートと同期シリアルポート の差については, + ハンドブックの<link linkend="uart">シリアルポート</link> の + 節を参照してください.</para> + + <para>標準の PC シリアルポート(非同期)に接続された TA は, 128Kbs + の接続を行っ ていても, 最大通信速度が 115.2Kbs + に制限されてしまいます. 128Kbs の ISDN + の性能を最大限に生かすためには, TA + を同期シリアルカードに接続しな ければなりません.</para> + + <para>内蔵 TA を購入して, + 同期/非同期問題を片付けてしまおうとは思わないでく ださい. + 内蔵 TA には, 単に標準 PC シリアルポートのチップが内蔵されてい + るだけです. 内蔵 TA の利点といえば, + シリアルケーブルを買わなくていいと いうことと, + 電源コンセントが一つ少なくて済むということくらいでしょう. + </para> + + <para>同期カードと TA の組合せは 386 の FreeBSD + マシンの場合でも, スタンドア + ローンのルータと同程度の速度は確保できます. + またこの組合せでは, ルータ より柔軟な設定が可能です.</para> + + <para>同期カード/TA を選ぶか, スタンドアローンルータを選ぶかは, + 多分に宗教的 な問題です. + メーリングリストでもいくつか議論がありました. 議論の内容に + ついては, <ulink URL="../search/search.html">archives</ulink> + を参照してください.</para> + </sect2> + + <sect2> + <title>スタンドアローン ISDN ブリッジ/ルータ</title> + + <para>ISDN ブリッジやルータは, OS 特有のものではありません. + もちろん FreeBSD 特有のものでもありません. + ルーティングやブリッジング技術に関す る詳細は, + ネットワークの参考書をご覧ください.</para> + + <para>このページでは, + ルータとブリッジにどちらでもあてはまるように記述します.</para> + + <para>ISDN ルータ/ブリッジは, + ローエンドの製品のコストが下がってきている こともあり, + より一般的に使用されるようになるでしょう. ISDN ルータは, + 外見は小さな箱で, + ローカルのイーサネットネットワーク(もしくはカード)と 直接, + 接続します. また, + 自身で他のブリッジ/ルータとの接続を制御します. PPP + や他のプロトコルを使用するためのソフトウェアは, + すべて組み込まれて います.</para> + + <para>ルータは, 完全な同期 ISDN 接続を使用するため, 通常の TA + と比較してスルー プットが大幅に向上します.</para> + + <para>ISDN ルータ/ブリッジを使用する場合の最大の問題点は, + 各メーカーの製品間 に相性の問題がまだ存在することです. + インターネットプロバイダとの接続を 考えている場合には, + プロバイダと相談することをお勧めします.</para> + + <para>事務所の LAN と家庭の LAN の間など, 二つの LAN + セグメントの間を接続 しようとしている場合は, + ブリッジ/ルータの使用がもっともメンテナンスが 簡単で, + 努力が少なくてすむ方法です. 両側の機材を購入するのであれば, + メー カー間の接続性の問題もないでしょう.</para> + + <para>たとえば家庭の LAN や出張所の LAN + を本社のネットワークに接続するために は, + 以下のような設定が使用できます.</para> + + <example> + <title>出張所 LAN または 家庭 LAN</title> + + <para>ネットワークは, 10 Base T イーサネットです. + ルータとネットワークの間は, 必要に応じて AUI/10BT + トランシーバを使って接続します.</para> + + <!-- This should be a graphic --> + <programlisting> +---Sun ワークステーション +| +---FreeBSD マシン +| +---Windows 95 (別に勧めているわけじゃありません) +| +スタンドアローンルータ + | +ISDN BRI ライン</programlisting> + + <para> + 家庭/出張所 LAN で, + 一台しかコンピュータを接続しないのであれば, クロス + のツイストペアケーブルを使用して, + スタンドアローンルータと直結も可能で す.</para> + </example> + + <example> + <title>本社 LAN や他の LAN</title> + + <para>ネットワークは, ツイストペアイーサネットです. </para> + + <!-- This should be a graphic --> + <programlisting> + -------Novell サーバ + | | + |ハ ---Sun + | | + | ---FreeBSD + | | + |ブ ---Windows 95 + | | + |___---スタンドアローンルータ + | + ISDN BRI ライン</programlisting> + + </example> + + <para>ほとんどのルータ/ブリッジでは, 別々の二つのサイトに対して, + <emphasis>同時</emphasis>にそれ + ぞれ<emphasis>独立した</emphasis>二つの PPP 接続が可能です. + これは, 通常の TA ではサポート されない機能で, + ルータ/ブリッジ接続の大きな利点です (シリアルポートを + 二つもつ特殊(そして高価な) TA では可能です). + チャンネル割り当てや MPP などと混同しないでください.</para> + + <para>これは, 大変便利な機能です. + たとえば事務所で専用線インターネット ISDN 接続を使用していて, + 別の ISDN ラインを購入したくないとします. この場合, + 事務所のルータは, 一つの専用線 B + チャンネル接続(64Kbs)を維持しつつ, 別 の B + チャンネルを他の用途に使用することができます. たとえば, + 他の場所 とのダイアルイン, ダイアルアウトに使用したり, + バンド幅を増やすために, + インターネットとの接続への動的に割り当て(MPP + など)に使用したりすること が可能です.</para> + + <para>またイーサネットブリッジは, IP パケットだけでなく IPX/SPX + などすべての + プロトコルのパケットを中継することが可能です.</para> + + </sect2> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/authors.ent b/ja_JP.eucJP/books/handbook/authors.ent new file mode 100644 index 0000000000..2668aa9bd8 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/authors.ent @@ -0,0 +1,348 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.9 + $Id: authors.ent,v 1.1.1.1 1999-04-08 15:45:57 kuriyama Exp $ + + Names and email address of contributing authors and CVS committers. + Entity names for committers should be the same as their login names on + freefall.FreeBSD.ORG. + + Use these entities when referencing people. + + Please keep this list in alphabetical order by entity names. +--> + +<!ENTITY a.abial "Andrzej Bialecki <email>abial@FreeBSD.ORG</email>"> + +<!ENTITY a.ache "Andrey A. Chernov <email>ache@FreeBSD.ORG</email>"> + +<!ENTITY a.adam "Adam David <email>adam@FreeBSD.ORG</email>"> + +<!ENTITY a.alex "Alex Nash <email>alex@freebsd.org</email>"> + +<!ENTITY a.amurai "Atsushi Murai <email>amurai@FreeBSD.ORG</email>"> + +<!ENTITY a.andreas "Andreas Klemm <email>andreas@FreeBSD.ORG</email>"> + +<!ENTITY a.archie "Archie Cobbs <email>archie@FreeBSD.ORG</email>"> + +<!ENTITY a.asami "浅見 賢 <email>asami@FreeBSD.ORG</email>"> + +<!ENTITY a.ats "Andreas Schulz <email>ats@FreeBSD.ORG</email>"> + +<!ENTITY a.awebster "Andrew Webster <email>awebster@pubnix.net</email>"> + +<!ENTITY a.bde "Bruce Evans <email>bde@FreeBSD.ORG</email>"> + +<!ENTITY a.billf "Bill Fumerola <email>billf@FreeBSD.ORG</email>"> + +<!ENTITY a.brandon "Brandon Gillespie <email>brandon@FreeBSD.ORG</email>"> + +<!ENTITY a.brian "Brian Somers <email>brian@FreeBSD.ORG</email>"> + +<!ENTITY a.cawimm "Charles A. Wimmer <email>cawimm@FreeBSD.ORG</email>"> + +<!ENTITY a.charnier "Philippe Charnier <email>charnier@FreeBSD.ORG</email>"> + +<!ENTITY a.chuck "Chuck Robey <email>chuckr@glue.umd.edu</email>"> + +<!ENTITY a.chuckr "Chuck Robey <email>chuckr@FreeBSD.ORG</email>"> + +<!ENTITY a.cracauer "Martin Cracauer <email>cracauer@FreeBSD.ORG</email>"> + +<!ENTITY a.csgr "Geoff Rehmet <email>csgr@FreeBSD.ORG</email>"> + +<!ENTITY a.cwt "Chris Timmons <email>cwt@FreeBSD.ORG</email>"> + +<!ENTITY a.danny "Daniel O'Callaghan <email>danny@FreeBSD.ORG</email>"> + +<!ENTITY a.darrenr "Darren Reed <email>darrenr@FreeBSD.ORG</email>"> + +<!ENTITY a.davidn "David Nugent <email>davidn@blaze.net.au</email>"> + +<!ENTITY a.dburr "Donald Burr <email>dburr@FreeBSD.ORG</email>"> + +<!ENTITY a.dcs "Daniel C. Sobral <email>dcs@FreeBSD.ORG</email>"> + +<!ENTITY a.des "Dag-Erling C. Smørgrav <email>des@FreeBSD.ORG</email>"> + +<!ENTITY a.dfr "Doug Rabson <email>dfr@FreeBSD.ORG</email>"> + +<!ENTITY a.dg "David Greenman <email>dg@FreeBSD.ORG</email>"> + +<!ENTITY a.dillon "Matthew Dillon <email>dillon@FreeBSD.ORG</email>"> + +<!ENTITY a.dima "Dima Ruban <email>dima@FreeBSD.ORG</email>"> + +<!ENTITY a.dirk "Dirk Frömberg <email>dirk@FreeBSD.ORG</email>"> + +<!ENTITY a.dirkvangulik "Dirk-Willem van Gulik <email>Dirk.vanGulik@jrc.it</email>"> + +<!ENTITY a.dt "Dmitrij Tejblum <email>dt@FreeBSD.ORG</email>"> + +<!ENTITY a.dufault "Peter Dufault <email>dufault@FreeBSD.ORG</email>"> + +<!ENTITY a.dwhite "Doug White <email>dwhite@FreeBSD.ORG</email>"> + +<!ENTITY a.dyson "John Dyson <email>dyson@FreeBSD.ORG</email>"> + +<!ENTITY a.eivind "Eivind Eklund <email>eivind@FreeBSD.ORG</email>"> + +<!ENTITY a.ejc "Eric J. Chet <email>ejc@FreeBSD.ORG</email>"> + +<!ENTITY a.erich "Eric L. Hernes <email>erich@FreeBSD.ORG</email>"> + +<!ENTITY a.faq "FAQ 保守担当者 <email>faq@freebsd.org</email>"> + +<!ENTITY a.fenner "Bill Fenner <email>fenner@FreeBSD.ORG</email>"> + +<!ENTITY a.flathill "平岡 征一朗 <email>flathill@FreeBSD.ORG</email>"> + +<!ENTITY a.foxfair "Howard F. Hu <email>foxfair@FreeBSD.ORG</email>"> + +<!ENTITY a.fsmp "Steve Passe <email>fsmp@FreeBSD.ORG</email>"> + +<!ENTITY a.gallatin "Andrew Gallatin <email>gallatin@FreeBSD.ORG</email>"> + +<!ENTITY a.gclarkii "Gary Clark II <email>gclarkii@FreeBSD.ORG</email>"> + +<!ENTITY a.gena "Gennady B. Sorokopud <email>gena@NetVision.net.il</email>"> + +<!ENTITY a.ghelmer "Guy Helmer <email>ghelmer@cs.iastate.edu</email>"> + +<!ENTITY a.gibbs "Justin T. Gibbs <email>gibbs@FreeBSD.ORG</email>"> + +<!ENTITY a.mjacob "Matthew Jacob <email>mjacob@FreeBSD.ORG</email>"> + +<!ENTITY a.gj "Gary Jennejohn <email>gj@FreeBSD.ORG</email>"> + +<!ENTITY a.gpalmer "Gary Palmer <email>gpalmer@FreeBSD.ORG</email>"> + +<!ENTITY a.graichen "Thomas Graichen <email>graichen@FreeBSD.ORG</email>"> + +<!ENTITY a.grog "Greg Lehey <email>grog@FreeBSD.ORG</email>"> + +<!ENTITY a.gryphon "Coranth Gryphon <email>gryphon@healer.com</email>"> + +<!ENTITY a.guido "Guido van Rooij <email>guido@FreeBSD.ORG</email>"> + +<!ENTITY a.hanai "花井浩之 <email>hanai@FreeBSD.ORG</email>"> + +<!ENTITY a.handy "Brian N. Handy <email>handy@sxt4.physics.montana.edu</email>"> + +<!ENTITY a.helbig "Wolfgang Helbig <email>helbig@FreeBSD.ORG</email>"> + +<!ENTITY a.hm "Hellmuth Michaelis <email>hm@FreeBSD.ORG</email>"> + +<!ENTITY a.hoek "Tim Vanderhoek <email>hoek@FreeBSD.ORG</email>"> + +<!ENTITY a.hosokawa "Tatsumi Hosokawa <email>hosokawa@FreeBSD.ORG</email>"> + +<!ENTITY a.hsu "Jeffrey Hsu <email>hsu@FreeBSD.ORG</email>"> + +<!ENTITY a.imp "Warner Losh <email>imp@FreeBSD.ORG</email>"> + +<!ENTITY a.itojun "Jun-ichiro Itoh <email>itojun@itojun.org</email>"> + +<!ENTITY a.jb "John Birrell <email>jb@cimlogic.com.au</email>"> + +<!ENTITY a.jdp "John Polstra <email>jdp@FreeBSD.ORG</email>"> + +<!ENTITY a.jehamby "Jake Hamby <email>jehamby@lightside.com</email>"> + +<!ENTITY a.jfieber "John Fieber <email>jfieber@FreeBSD.ORG</email>"> + +<!ENTITY a.jfitz "James FitzGibbon <email>james@nexis.net</email>"> + +<!ENTITY a.jgreco "Joe Greco <email>jgreco@FreeBSD.ORG</email>"> + +<!ENTITY a.jhay "John Hay <email>jhay@FreeBSD.ORG</email>"> + +<!ENTITY a.jkh "Jordan K. Hubbard <email>jkh@FreeBSD.ORG</email>"> + +<!ENTITY a.jkoshy "Joseph Koshy <email>jkoshy@FreeBSD.ORG</email>"> + +<!ENTITY a.jlemon "Jonathan Lemon <email>jlemon@FreeBSD.ORG</email>"> + +<!ENTITY a.jlind "John Lind <email>john@starfire.MN.ORG</email>"> + +<!ENTITY a.jlrobin "James L. Robinson <email>jlrobin@FreeBSD.ORG</email>"> + +<!ENTITY a.jmacd "Joshua Peck Macdonald <email>jmacd@FreeBSD.ORG</email>"> + +<!ENTITY a.jmb "Jonathan M. Bresler <email>jmb@FreeBSD.ORG</email>"> + +<!ENTITY a.jmg "John-Mark Gurney <email>jmg@FreeBSD.ORG</email>"> + +<!ENTITY a.jmz "Jean-Marc Zucconi <email>jmz@FreeBSD.ORG</email>"> + +<!ENTITY a.joerg "Jörg Wunsch <email>joerg@FreeBSD.ORG</email>"> + +<!ENTITY a.john "John Cavanaugh <email>john@FreeBSD.ORG</email>"> + +<!ENTITY a.jraynard "James Raynard <email>jraynard@freebsd.org</email>"> + +<!ENTITY a.jseger "Justin Seger <email>jseger@freebsd.org</email>"> + +<!ENTITY a.julian "Julian Elischer <email>julian@FreeBSD.ORG</email>"> + +<!ENTITY a.jvh "Johannes Helander <email>jvh@FreeBSD.ORG</email>"> + +<!ENTITY a.karl "Karl Strickland <email>karl@FreeBSD.ORG</email>"> + +<!ENTITY a.kato "Takenori KATO <email>kato@FreeBSD.ORG</email>"> + +<!ENTITY a.kelly "Sean Kelly <email>kelly@fsl.noaa.gov</email>"> + +<!ENTITY a.ken "Kenneth D. Merry <email>ken@FreeBSD.ORG</email>"> + +<!ENTITY a.kjc "Kenjiro Cho <email>kjc@FreeBSD.ORG</email>"> + +<!ENTITY a.kris "Kris Kennaway <email>kris@FreeBSD.ORG</email>"> + +<!ENTITY a.kuriyama "くりやま <email>kuriyama@FreeBSD.ORG</email>"> + +<!ENTITY a.lars "Lars Fredriksen <email>lars@FreeBSD.ORG</email>"> + +<!ENTITY a.ljo "L Jonas Olsson <email>ljo@FreeBSD.ORG</email>"> + +<!ENTITY a.luoqi "Luoqi Chen <email>luoqi@FreeBSD.ORG</email>"> + +<!ENTITY a.markm "Mark Murray <email>markm@FreeBSD.ORG</email>"> + +<!ENTITY a.martin "Martin Renters <email>martin@FreeBSD.ORG</email>"> + +<!ENTITY a.max "中根 雅文 <email>max@FreeBSD.ORG</email>"> + +<!ENTITY a.mayo "Mark Mayo <email>mark@vmunix.com</email>"> + +<!ENTITY a.mbarkah "Ade Barkah <email>mbarkah@FreeBSD.ORG</email>"> + +<!ENTITY a.mckay "Stephen McKay <email>mckay@FreeBSD.ORG</email>"> + +<!ENTITY a.mckusick "Kirk McKusick <email>mckusick@FreeBSD.ORG</email>"> + +<!ENTITY a.md "Mark Dapoz <email>md@bsc.no</email>"> + +<!ENTITY a.mks "Mike Spengler <email>mks@FreeBSD.ORG</email>"> + +<!ENTITY a.motoyuki "今野 元之 <email>motoyuki@FreeBSD.ORG</email>"> + +<!ENTITY a.mph "Matthew Hunt <email>mph@FreeBSD.ORG</email>"> + +<!ENTITY a.mpp "Mike Pritchard <email>mpp@FreeBSD.ORG</email>"> + +<!ENTITY a.msmith "Michael Smith <email>msmith@FreeBSD.ORG</email>"> + +<!ENTITY a.nate "Nate Williams <email>nate@FreeBSD.ORG</email>"> + +<!ENTITY a.nectar "Jacques Vidrine <email>nectar@FreeBSD.ORG</email>"> + +<!ENTITY a.newton "Mark Newton <email>newton@FreeBSD.ORG</email>"> + +<!ENTITY a.nhibma "Nick Hibma <email>n_hibma@FreeBSD.ORG</email>"> + +<!ENTITY a.nik "Nik Clayton <email>nik@FreeBSD.ORG</email>"> + +<!ENTITY a.nsj "Nate Johnson <email>nsj@FreeBSD.ORG</email>"> + +<!ENTITY a.obrien "David O'Brien <email>obrien@FreeBSD.ORG</email>"> + +<!ENTITY a.olah "Andras Olah <email>olah@FreeBSD.ORG</email>"> + +<!ENTITY a.opsys "Chris Watson <email>opsys@open-systems.net</email>"> + +<!ENTITY a.paul "Paul Richards <email>paul@FreeBSD.ORG</email>"> + +<!ENTITY a.pb "Pierre Beyssac <email>pb@fasterix.freenix.org</email>"> + +<!ENTITY a.pds "Peter da Silva <email>pds@FreeBSD.ORG</email>"> + +<!ENTITY a.peter "Peter Wemm <email>peter@FreeBSD.ORG</email>"> + +<!ENTITY a.phk "Poul-Henning Kamp <email>phk@FreeBSD.ORG</email>"> + +<!ENTITY a.pjc "Peter Childs <email>pjchilds@imforei.apana.org.au</email>"> + +<!ENTITY a.proven "Chris Provenzano <email>proven@FreeBSD.ORG</email>"> + +<!ENTITY a.pst "Paul Traina <email>pst@FreeBSD.ORG</email>"> + +<!ENTITY a.rgrimes "Rodney Grimes <email>rgrimes@FreeBSD.ORG</email>"> + +<!ENTITY a.rhuff "Robert Huff <email>rhuff@cybercom.net</email>"> + +<!ENTITY a.ricardag "Ricardo AG <email>ricardag@ag.com.br</email>"> + +<!ENTITY a.rich "Rich Murphey <email>rich@FreeBSD.ORG</email>"> + +<!ENTITY a.rnordier "Robert Nordier <email>rnordier@FreeBSD.ORG</email>"> + +<!ENTITY a.roberto "Ollivier Robert <email>roberto@FreeBSD.ORG</email>"> + +<!ENTITY a.rse "Ralf S. Engelschall <email>rse@FreeBSD.ORG</email>"> + +<!ENTITY a.sada "佐田 憲治 <email>sada@FreeBSD.ORG</email>"> + +<!ENTITY a.scrappy "Marc G. Fournier <email>scrappy@FreeBSD.ORG</email>"> + +<!ENTITY a.se "Stefan Esser <email>se@FreeBSD.ORG</email>"> + +<!ENTITY a.sef "Sean Eric Fagan <email>sef@FreeBSD.ORG</email>"> + +<!ENTITY a.shige "Shigeyuki Fukushima <email>shige@FreeBSD.ORG</email>"> + +<!ENTITY a.simokawa "Hidetoshi Shimokawa <email>simokawa@FreeBSD.ORG</email>"> + +<!ENTITY a.smace "Scott Mace <email>smace@FreeBSD.ORG</email>"> + +<!ENTITY a.smpatel "Sujal Patel <email>smpatel@FreeBSD.ORG</email>"> + +<!ENTITY a.sos "Søren Schmidt <email>sos@FreeBSD.ORG</email>"> + +<!ENTITY a.stark "Gene Stark <email>stark@FreeBSD.ORG</email>"> + +<!ENTITY a.stb "Stefan Bethke <email>stb@FreeBSD.ORG</email>"> + +<!ENTITY a.steve "Steve Price <email>steve@FreeBSD.ORG</email>"> + +<!ENTITY a.swallace "Steven Wallace <email>swallace@FreeBSD.ORG</email>"> + +<!ENTITY a.tedm "Ted Mittelstaedt <email>tedm@FreeBSD.ORG</email>"> + +<!ENTITY a.tegge "Tor Egge <email>tegge@FreeBSD.ORG</email>"> + +<!ENTITY a.tg "Thomas Gellekum <email>tg@FreeBSD.ORG</email>"> + +<!ENTITY a.thepish "Peter Hawkins <email>thepish@FreeBSD.ORG</email>"> + +<!ENTITY a.torstenb "Torsten Blum <email>torstenb@FreeBSD.ORG</email>"> + +<!ENTITY a.truckman "Don “Truck” Lewis <email>truckman@FreeBSD.ORG</email>"> + +<!ENTITY a.ugen "Ugen J.S.Antsilevich <email>ugen@FreeBSD.ORG</email>"> + +<!ENTITY a.uhclem "Frank Durda IV <email>uhclem@FreeBSD.ORG</email>"> + +<!ENTITY a.ulf "Ulf Zimmermann <email>ulf@FreeBSD.ORG</email>"> + +<!ENTITY a.vanilla "Vanilla I. Shu <email>vanilla@FreeBSD.ORG</email>"> + +<!ENTITY a.wes "Wes Peters <email>wes@FreeBSD.ORG</email>"> + +<!ENTITY a.whiteside "Don Whiteside <email>whiteside@acm.org</email>"> + +<!ENTITY a.wilko "Wilko Bulte <email>wilko@yedi.iaf.nl</email>"> + +<!ENTITY a.wlloyd "Bill Lloyd <email>wlloyd@mpd.ca</email>"> + +<!ENTITY a.wollman "Garrett Wollman <email>wollman@FreeBSD.ORG</email>"> + +<!ENTITY a.wosch "Wolfram Schneider <email>wosch@FreeBSD.ORG</email>"> + +<!ENTITY a.wpaul "Bill Paul <email>wpaul@FreeBSD.ORG</email>"> + +<!ENTITY a.yokota "Kazutaka YOKOTA <email>yokota@FreeBSD.ORG</email>"> + diff --git a/ja_JP.eucJP/books/handbook/backups/chapter.sgml b/ja_JP.eucJP/books/handbook/backups/chapter.sgml new file mode 100644 index 0000000000..1964c09290 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/backups/chapter.sgml @@ -0,0 +1,750 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.6 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:58 kuriyama Exp $ +--> + +<chapter id="backups"> + <title>バックアップ</title> + + <para>ハードウェアコンパチビリティの問題は現在のコンピュータ業界 + でもっとも多く起きる種類の問題であり, + FreeBSD もこれに無縁ではありません. + 市場にある驚くほど多様な種類の製品をサポートすることによって, + FreeBSDは 安価に普及している PC ハードウェアで + 動かすことができるという利点はこの点では不利でもあります. + FreeBSD のサポートするハードウェアを徹底的に調べて + 提供することは不可能ですが, このセクションでは FreeBSD + に含まれるデバイスドライバとそのドライバがサポートする + ハードウェアのカタログを示します. 可能で適切なものについては + 特定の製品についての注釈を含めました. + また,このハンドブックの <link linkend="kernelconfig-config"> + コンフィグレーションファイル</link> のセクションにも + サポートされているデバイスのリストがありますので + そちらもご覧ください.</para> + + <para>FreeBSD はボランティアプロジェクトでテスト部門には + 資金がありませんから, より多くの情報をこのカタログに載せるには + あなたがたユーザに頼らなければなりません. + あなた自身の経験により, あるハードウェアが FreeBSD + で動くか動かないかがわかったとしたら &a.doc; へ e-mail + して知らせてください. サポートされているハードウェアについての + 質問は, &a.questions; (詳しいことは <link linkend="eresources-mail"> + メーリングリスト</link>を参照してください) へ宛ててください. + 情報を提供したり質問をする時は FreeBSD のバージョンと使っている + ハードウェアのできるだけ詳しい情報を含めることを + 忘れないでください.</para> + + <sect1> + <title>* フロッピーへのバックアップはどうでしょう?</title> + + <para></para> + </sect1> + + <sect1 id="backups-tapebackups"> + <title>テープメディア</title> + + <para>一般的なテープメディアには 4mm, 8mm, QIC, ミニカートリッジ + DLT があります.</para> + + <sect2 id="backups-tapebackups-4mm"> + <title>4mm (DDS: Digital Data Storage)</title> + + <para>4mm テープはワークステーションのバックアップメディアとして + QIC から置き換えられつつあります. この傾向は + QICドライブの製造のリーダであった Archiveを Connerが買収し + QICドライブの製造を中止したことで加速しました. + 4mmドライブは小型で静かですが 8mm + ドライブの持っているような信頼性の評判はありません. + カートリッジは 8mmカートリッジよりも安価で小型 (3 x 2 x 0.5 + インチ; 76 x 51 x 12 mm) です. 4mmドライブ は + 8mm同様にヘリカルスキャン (訳注: + VTRと同様の回転ヘッドを使う方式) + を使用しているという理由でヘッドの寿命は短いです.</para> + + <para>これらのドライブのデータスループットは + 150kB/s程度から最大で500kB/s程度の範囲です. データ容量は + 1.3GBから 2.0GBです. ハードウェア圧縮が多くのドライブで可能で, + およそ 2倍の容量になります. + マルチドライブテープライブラリユニットは1つの筐体に + 6ドライブを持つことができ自動的にテープを交換します. + ライブラリの容量は 240GBに達します.1つの例外です) + 送りだしリールと巻き取りリールの両方が + カートリッジの中にあります.</para> + <!-- kuriyama - ) not balanced. --> + + <para>4mmドライブは 8mmドライブ同様にヘリカルスキャンを使います. + ヘリカルスキャンの利点と欠点は 4mm ドライブ と 8mm + ドライブ共通です.</para> + + <para>テープの寿命は 2000 回のパスあるいは 100 + 回のフルバックアップ です.</para> + </sect2> + + <sect2 id="backups-tapebackups-8mm"> + <title>8mm (Exabyte)</title> + + <para>8mm テープは SCSI + テープドライブとして最もよく使われているもので, + データ交換用として最良の選択です. ほとんどのサイトには Exabyte + の 2GB 8mm テープドライブがあるでしょう (訳注: Unix + ワークステーションを何台も置いているようなサイトには 1 + 台くらいはあるというような意味です). 8mm + ドライブは信頼性が高く, 使いやすく, 静かです. + カートリッジは安価で小型です (4.8 x3.3 x 0.6 インチ; 122 x 84 + x 15 mm). 欠点は, テープとヘッドの相対的な速度が高速なために + 比較的ヘッドとテープの寿命が短いことです.</para> + + <para>データスループットは 250kB/s 程度から 500kB/s + 程度の範囲です. データ容量は 300MB から 7GB です. + ハードウェア圧縮が多くのドライブで可能で,およそ 2 + 倍の容量になります. 単一のユニットのドライブから, 1 + つの筐体に 6 台のドライブと 120 + 巻のテープを持ったマルチドライブテープライブラリまで + 利用することができます. ライブラリではテープはユニットにより + 自動的に交換されます. ライブラリの容量は 840GB + 以上に達します.</para> + + <para>データはヘリカルスキャンを使ってテープに記録されます. + ヘリカルスキャン方式ではヘッドはメディアに対してある傾き + (約6度) に配置されます. テープはヘッドのある円筒の周の + 270度にわたって接触します. テープが円筒面を走行する間, + 円筒は回転しています. この結果, + 高密度のデータのつまったトラックは, + 狭い間隔でテープの上端と下端の間を斜めに横切ります. </para> + </sect2> + + <sect2 id="backups-tapebackups-qic"> + <title>QIC</title> + + <para>QIC-150 テープとドライブはたぶん最も一般的に使われている + ドライブとメディアでしょう. QIC + テープドライブは現実的なバックアップドライブとして + 少なくとも高価なものではありません. + 欠点はメディアのコストです. QIC テープは 8mm や 4mm + テープに比較して GB あたりのデータの保存で 5 倍ほど高価です. + しかしあなたの必要とする量が半ダース程のテープで十分であれば, + QICは正しい選択となるかもしれません. QIC は + <emphasis>最も</emphasis>一般的なテープドライブです. + すべてのサイトに QICドライブのどれかの容量のものがあります. + 問題は, QIC は同じようなテープ (まったく同じ場合もある) + に多様な記録密度があることです. QIC + ドライブは静かではありません. これらのドライブはデータ記録を + 開始する前に音をたててシークしますし, リード, ライト, + シークの時にはっきりと聞こえる音を出します. QIC + テープの大きさは (6 x 4 x 0.7 インチ; 152 x 102 x 17 mm). + <link + linkend="backups-tapebackups-mini">ミニカートリッジ</link> + で使われている 1/4 インチ幅のテープについては別に議論します. + テープライブラリやチェンジャはありません.</para> + + <para>データスループットは 150kB/s から 500kB/s の範囲です. + データ容量の範囲は 40MB から 15GB です. ハードウェア圧縮が + 最近の多くのドライブで使えるようになっています. QIC ドライブは + DAT ドライブに置き換えられつつあり, + あまり頻繁には利用されなくなっています.</para> + + <para>データは複数のトラックにわかれてテープに記録されます. + トラックはテープメディアの + 長さ方向の一端からもう一方の端までです. (訳注: 1トラックの + read/write が終わるとテープの 走行方向を反転させ次のトラックの + read/write を行います) トラックの数と, + それに対応するトラックの幅は テープの容量によって変わります. + すべてではありませんがほとんどの最近のドライブは + 少なくとも読み出しについては (場合によっては書き込みも) + 下位互換性があります. QIC + はデータの安全性についてはよいといわれています + (ヘリカルスキャンドライブに比べて機構は単純でより丈夫です). + </para> + + <para>テープは 5000回のバックアップで寿命となるでしょう.</para> + </sect2> + + <sect2 id="backups-tapebackups-mini"> + <title>* ミニカートリッジ</title> + + <para></para> + </sect2> + + <sect2 id="backups-tapebackups-dlt"> + <title>DLT</title> + + <para>DLTはここに示したドライブのタイプの中で + 最高速のデータ転送レートです. 1/2 インチ (12.5mm) + テープが単リールのカートリッジ (4 x 4 x 1 インチ; 100 x 100 x + 25 mm) に入っています. + カートリッジのひとつの側面全体がスイングゲートになっています. + ドライブの機構がこのゲートを開け, テープリーダを引き出します. + テープリーダには楕円形の穴があり, + ドライブがテープを引っ掛けるのに使います. + 巻き取りのためのリールはドライブの中にあります. + ここに挙げた他のカートリッジはすべて ( 9 + トラックテープはただ1つの例外です) + 送りだしリールと巻き取りリールの両方がカートリッジの中に + あります.</para> + + <para>データスループットは約1.5MB/sで, 4mm, 8mm, QIC + テープドライブの3倍です. データ容量は単一のドライブで 10GBから + 20GBの範囲です. + マルチテープチェンジャ,マルチテープドライブ,5から + 900巻のテープを1から20ドライブで扱う + マルチドライブテープライブラリがあり, 50GB から 9TB + の容量が得られます.</para> + + <para>データは ( QIC テープのように) + テープの走行方向と並行に複数あるトラックへ記録されます. 2 + つのトラックに同時書き込みを行います. Read/Write + ヘッドの寿命は比較的長いと言えます. + テープの走行が止まればヘッドと + テープの間の相対運動はありません.</para> + </sect2> + + <sect2> + <title>新品のテープを最初に使う場合</title> + + <para>新品の完全な空テープを読もうとしたり書き込もうとすると処理 + は失敗するでしょう. + 次のようなコンソールメッセージが出るでしょう.</para> + + <screen>st0(ncr1:4:0): NOT READY asc:4,1 +st0(ncr1:4:0): Logical unit is in process of becoming ready</screen> + + <para>テープに識別ブロック (Identifire Block:block number 0) + がありません.QIC-525標準の採用されている + QICテープドライブのすべてで識別ブロックをテープに書きます. + 2つの解決方法があります.</para> + + <para>(訳注: 方法1)<command>mt fsf 1</command> + によってテープドライブは識別ブロックをテープに書きます.</para> + + <para>(訳注: + 方法2)フロントパネルのボタンを押してテープをとりだします. + </para> + + <para>再びテープを入れ,データをテープに &man.dump.8; します.</para> + + <para>&man.dump.8; はそのうちに <literal>DUMP: End of tape + detected</literal> と表示し, コンソールには + <literal>HARDWARE FAILURE info:280 + asc:80,96</literal>と表示されるでしょう.</para> + + <para><command>mt + rewind</command>を使ってテープを巻戻します.</para> + + <para>この次からはテープの操作は成功するでしょう.</para> + </sect2> + </sect1> + + <sect1 id="backup-programs"> + <title>バックアッププログラム</title> + + <para>よく使われる3つのプログラムは &man.dump.8;, &man.tar.1;, + &man.cpio.1; です.</para> + + <sect2> + <title>ダンプとリストア</title> + + <para>&man.dump.8; と &man.restore.8; は伝統的な + Unixのバックアッププログラムです. + これらはドライブのファイルシステム上のファイル, リンク, + ディレクトリをディスクブロックの集まりとして処理します. + &man.dump.8; + はデバイスやファイルシステム全体をバックアップし, + 一部分のバックアップや, &man.ln.1; によるソフトリンクや + 他のファイルシステムをマウントを行った, 1 + つ以上のファイルシステムにまたがる + ディレクトリツリーのバックアップはできません. &man.dump.8; + はファイルやディレクトリを構成する + データブロックをテープに書くだけで, + ファイルやディレクトリをテープに書くことはありません. + &man.dump.8; には初期の ATT UNIX のバージョン 6 (1975 + 年ごろ) に由来する癖が残っています. デフォルトのパラメタは 9 + トラックテープ (6250 bpi) + に適したものになっていて現在の高密度メディア (最大 62,182 + ftpi) に適していません. + 現在のテープドライブの容量を有効に利用するため, + デフォルト値をコマンドラインで置き換えなければなりません. + </para> + + <para>&man.rdump.8; と &man.rrestore.8; + は他のコンピュータに接続されているテープドライブに + ネットワーク経由でバックアップをします. + どちらのプログラムもリモートテープドライブにアクセスするために + &man.rcmd.3; と &man.ruserok.3; に依存しています. + このためユーザがバックアップを実行するためには + <literal>rhosts</literal> によるリモートアクセスが必要です. + &man.rdump.8; と &man.rrestore.8; + の引数はリモートコンピュータに適切なものを用います. + &man.rrestore.8; + はリモートコンピュータから使うのに適しています. (例えば + FreeBSD コンピュータより <hostid>komodo</hostid> という名前の + Sun に接続されている Exabyte テープドライブへ + <command>/sbin/rdump 0dsbfu 54000 13000 126 komodo:/dev/nrst8 + /dev/rsd0a 2>&1</command> として + <command>rdump</command>したような場合の restoreに使います) + 警告: セキュリティは + <literal>rhosts</literal>の管理にかかっています. + あなたの状況を注意深く調べてください.</para> + </sect2> + + <sect2> + <title>Tar</title> + + <para>&man.tar.1; ATT Unix のバージョン 6 (1975ごろ) + にさかのぼる事ができます. &man.tar.1; + はファイルシステムと協調して機能し, + ファイルやディレクトリをテープに書きます. &man.tar.1; は + &man.cpio.1; + で使えるようなフルレンジのオプションは持ちませんが + &man.cpio.1; + で使うような奇妙なコマンドパイプラインは必要ありません.</para> + + <para>大部分の &man.tar.1; + にはネットワーク経由のバックアップの機能はありませんが, + FreeBSD で使用されている GNU の &man.tar.1; は, + <command>rdump</command> + とおなじ構文でリモートデバイスを扱うことができます. komodo + というホスト名の Sun に繋いである Exabyte + のテープデバイスに対して &man.tar.1; を実行するには, + 次のようにします. <!-- kuriyama - komodo? --> + <command>/usr/bin/tar cf komodo:/dev/nrst8 . + 2>&1</command> リモートデバイスをサポートしていない tar + を使用している場合は, パイプラインと &man.rsh.1; を使うことで, + リモートテープデバイスにデータを送る事ができます. + (コマンド使用例はまだです)</para> + </sect2> + + <sect2> + <title>Cpio</title> + + <para>&man.cpio.1; は本来, Unix + ファイルを磁気メディアで交換するためのプログラムです. + &man.cpio.1; はバイトスワッピング, + 多くの異なるアーカイブフォーマットの書き込みのオプション + (それ以外にも多数のオプションがあります)があり, + パイプで他のプログラムにデータを渡す事もできます. + この最後に挙げた特徴により, &man.cpio.1; + はインストールメディアについては優れた選択です. &man.cpio.1; + は <filename>STDIN</filename> からの入力でなければならず, + ディレクトリツリーの探索や + ファイルリストについての機能はありません.</para> + + <para>&man.cpio.1; + はネットワーク経由のバックアップの機能はありません. + リモートテープドライブにはパイプラインと &man.rsh.1; + を使って送る事ができます. (コマンド使用例はまだです)</para> + </sect2> + + <sect2> + <title>Pax</title> + + <para>&man.pax.1; は <command>tar</command> と + <command>cpio</command> に対する IEEE/POSIX の回答です. + 長年の間, 様々なバージョンの <command>tar</command> や + <command>cpio</command> は, + 互いにわずかながら非互換性を有していました. + 各々をしらみ潰しに標準化する代わりに, POSIX + は新しいアーカイブユーティリティを作ることにしました. + <command>pax</command> + は専用に開発された新しいフォーマットに加えて, いくつもの cpio + や tar のフォーマットの読み書きに対応しようと試みています. + コマンド群は <command>tar</command> よりも + <command>cpio</command> の方にいくぶん似ています.</para> + </sect2> + + <sect2 id="backups-programs-amanda"> + <title>Amanda</title> + + <para><ulink + url="../ports/misc.html#amanda-2.4.0">Amanda</ulink> + (Advanced Maryland Network Disk Archiver) + は単一のプログラムではなくクライアント / + サーバ型のバックアップシステムです. Amanda サーバは, Amanda + クライアントであるネットワークで + サーバに接続された複数のコンピュータから + 一つのテープドライブへバックアップをおこないます. + このような場合の一般的な問題はいくつもの大容量の + ディスクからデータディレクトリをテープにバックアップするには + 時間がかかりすぎてしまうという事です. Amanda + はこの問題を解決します. Amanda + は同時に複数のファイルシステムのバックアップを おこなう時に + 「ホールディングディスク」を使う事ができます. + Amandaの設定ファイルに書いたすべてのファイルシステムの + フルバックアップを特定の間隔でとるために「アーカイブセット」 + と呼ばれるテープグループを作ります. + これには夜間に作られるすべてのファイルシステムの増分 + (あるいは差分として) のバックアップも含みます. + 障害の起きたファイルシステムの回復には最も新しい + フルバックアップと増分のバックアップが必要です. </para> + + <para>設定ファイルでバックアップのコントロールと Amanda + によるネットワークトラフィック量を設定します. Amanda + はデータをテープに書くのにバックアッププログラムの + いずれかを使うでしょう. Amanda + はその一部分でもパッケージでも利用可能ですが, + デフォルトではインストールされません. </para> + </sect2> + + <sect2> + <title>何もしない</title> + + <para>“何もしない” + というのはコンピュータのプログラムではありませんが, + バックアップの戦略として最も広く採用されている物です. + これには初期投資が必要ありません. + したがわなければならないバックアップスケジュールもありません. + ただ何もしないだけです. もしデータに何かが起きたら, + 苦笑いして耐えてください.</para> + + <para>あなたにとって時間やデータの価値が少ないか + あるいはまったくないのであれば “何もしない” + のはあなたのコンピュータに最も適した + バックアッププログラムでしょう. しかし注意してください. Unix + は便利なツールです. 6 ヶ月も使っていれば価値のあるファイルの + 山ができ上がっているでしょう.</para> + + <para>“何もしない” は + <filename>/usr/obj</filename> やその他の, + コンピュータによってつくり出された + ディレクトリツリーについては適切な方法です. + 一つの例はこのハンドブックのファイルで, これらは + <acronym>SGML</acronym> のファイルより生成された物です. + <acronym>HTML</acronym> + ファイルのバックアップを作る必要はありません. + <acronym>SGML</acronym> + のソースファイルは定期的にバックアップします. </para> + </sect2> + + <sect2> + <title>どのバックアッププログラムが最適でしょう?</title> + + <para><emphasis>定期的に</emphasis> &man.dump.8; しましょう. + Elizabeth D. Zwicky はここで検討したプログラムすべてについて + 拷問的なテストをおこないました. すべてのデータと + Unixファイルシステムの状態すべてを保存するには明らかに + &man.dump.8; でしょう. Elizabeth + は大きく変化に富んだ異常な状態 + (いくつかはあまり異常でもない状態のものもあります) + になっているファイルシステムで, + それぞれのプログラムでファイルシステムの + バックアップとリストアを行ってテストしました. + 特色のある状態には, ホールを持つファイル, + ホールとヌルブロックを持つファイル, + 奇妙な文字をファイル名に持つファイル, 読み出し不可, + 書き込み不可のファイル, デバイスファイル, + バックアップ中にファイルのサイズを変更する, + バックアップ中にファイルの作成/削除をおこなうなどがあります. + 彼女は1991年10月の LISA Vで結果の発表をしています.<ulink + url="http://reality.sgi.com/zwicky_neu/testdump.doc.html">torture-testing Backup and Archive Programs</ulink> を参照してください.</para> + </sect2> + + <sect2> + <title>緊急時のリストア手順</title> + + <sect3> + <title>災難の起きる前に</title> + + <para>起き得るどのような災難に対しても以下の + 4ステップだけが必要な準備です.</para> + + <para>ステップ 1では, + ファイルシステムテーブル(<command>/etc/fstab</command>) + やブートメッセージで示されるすべてのディスクの + disklabelをそれぞれ2コピーづつプリント (例えば + <command>disklabel sd0 | lpr</command> を実行します) + します.</para> + <!-- kuriyama - /etc/fstab is command ? --> + + <para>ステップ 2では, <filename>boot.flp</filename> と + <filename>fixit.flp</filename> + にそのシステムのすべてのデバイスドライバが + 含まれているか確認します. 最も簡単な確認の方法は, + フロッピーをドライブに入れてリブートし, + ブートメッセージを確認することです. + あなたのシステムのデバイスがすべて含まれ, 機能していれば, + step 3へ飛んでください.</para> + + <para>そうでないなら, + そのシステムのすべてのディスクをマウントでき, + テープドライブにもアクセスできる + 2種類のカスタムブートフロッピーディスクを作る必要があります. + これらのフロッピーには &man.fdisk.8;, &man.disklabel.8;, + &man.newfs.8;, &man.mount.8;, + と利用したいバックアッププログラムが + 入っていなければなりません. + これらのプログラムはスタティックリンクされた + プログラムである必要があります. &man.dump.8; + を使うのであればフロッピーに &man.restore.8; + を入れる必要があります.</para> + + <para>ステップ 3では, 通常の方法でバックアップを作ります. + 最新のバックアップの後でおこなわれた変更は + 回復することはできません. + バックアップテープにライトプロテクトをしてください.</para> + + <para>ステップ 4では, フロッピー + (<filename>boot.flp</filename> と + <filename>fixit.flp</filename> あるいはステップ + 2で作った2枚のカスタムブートフロッピーディスクです) + とバックアップテープのテストをします. + 手順のノートを作りましょう. + このノートはブートフロッピーディスク, + バックアップテープに入れておきプリントアウトしておきます. + あなたがリストアをおこなうような時は + おそらく錯乱状態でしょうからこのノートはバックアップを + 破壊してしまうようなことを防ぐのに役立つでしょう + (どのようにして破壊するって? <command>tar xvf + /dev/rst0</command> とする替りに偶然 <command>tar cvf + /dev/rst0</command> + とタイプしてバックアップテープに上書きしてしまうかも + しれません).</para> + + <para>訳注: 上書きはライトプロテクトをしておけば防げますが, + なんらかの原因でプロテクトがはずれているかもしれません. + ちなみに訳者の経験から言えば上のようなミスタイプは + 結構起きます.</para> + + <para>安全性を増すために, + 毎回ブートフロッピーディスクを作り, 2 + 巻のバックアップテープを取ります. + 一方を離れた場所に保管します. + 離れた場所は同じ建物の地下室ではいけません. + 世界貿易センタービルにあった数多くの会社は + 苦い経験よりこの教訓を得ました. + 離れた場所とはコンピュータやディスクドライブから + かなり離れていて物理的に分離されていなければなりません.</para> + + <para>ブートフロッピーディスクを作るスクリプトの一例</para> + + <programlisting> +<![ CDATA [#!/bin/sh +# +# create a restore floppy リストアフロッピーの作成 +# +# format the floppy フロッピーのフォーマット +# +PATH=/bin:/sbin:/usr/sbin:/usr/bin + +fdformat -q fd0 +if [ $? -ne 0 ] +then + echo "Bad floppy, please use a new one" + exit 1 +fi + +# place boot blocks on the floppy フロッピーにブートブロックを書く +# +disklabel -w -B -b /usr/mdec/fdboot -s /usr/mdec/bootfd /dev/rfd0c fd1440 + +# +# newfs the one and only partition ただ1つのパーティションを newfs +# +newfs -t 2 -u 18 -l 1 -c 40 -i 5120 -m 5 -o space /dev/rfd0a + +# +# mount the new floppy 新しいフロッピーをマウント +# +mount /dev/fd0a /mnt + +# +# create required directories 必要なディレクトリの作成 +# +mkdir /mnt/dev +mkdir /mnt/bin +mkdir /mnt/sbin +mkdir /mnt/etc +mkdir /mnt/root +mkdir /mnt/mnt # for the root partition +mkdir /mnt/tmp +mkdir /mnt/var + +# +# populate the directories +# +# MINIカーネルがない場合は作ります +if [ ! -x /sys/compile/MINI/kernel ] +then + cat << EOM +The MINI kernel does not exist, please create one. +Here is an example config file: +# MINIカーネルの config fileの例 +# MINI -- A kernel to get FreeBSD on onto a disk. +# +machine "i386" +cpu "I486_CPU" +ident MINI +maxusers 5 +options INET # needed for _tcp _icmpstat _ipstat + # _udpstat _tcpstat _udb +options FFS #Berkeley Fast File System +options FAT_CURSOR #block cursor in syscons or pccons +options SCSI_DELAY=15 #Be pessimistic about Joe SCSI device +options NCONS=2 #1 virtual consoles +options USERCONFIG #Allow user configuration with -c XXX + +config kernel root on sd0 swap on sd0 and sd1 dumps on sd0 + +controller isa0 +controller pci0 + +controller fdc0 at isa? port "IO_FD1" bio irq 6 drq 2 vector fdintr +disk fd0 at fdc0 drive 0 + +controller ncr0 + +controller scbus0 + +device sc0 at isa? port "IO_KBD" tty irq 1 vector scintr +device npx0 at isa? port "IO_NPX" irq 13 vector npxintr + +device sd0 +device sd1 +device sd2 + +device st0 + +pseudo-device loop # required by INET +pseudo-device gzip # Exec gzipped a.out's +EOM + exit 1 +fi + +cp -f /sys/compile/MINI/kernel /mnt + +gzip -c -best /sbin/init > /mnt/sbin/init +gzip -c -best /sbin/fsck > /mnt/sbin/fsck +gzip -c -best /sbin/mount > /mnt/sbin/mount +gzip -c -best /sbin/halt > /mnt/sbin/halt +gzip -c -best /sbin/restore > /mnt/sbin/restore + +gzip -c -best /bin/sh > /mnt/bin/sh +gzip -c -best /bin/sync > /mnt/bin/sync + +cp /root/.profile /mnt/root + +cp -f /dev/MAKEDEV /mnt/dev +chmod 755 /mnt/dev/MAKEDEV + +chmod 500 /mnt/sbin/init +chmod 555 /mnt/sbin/fsck /mnt/sbin/mount /mnt/sbin/halt +chmod 555 /mnt/bin/sh /mnt/bin/sync +chmod 6555 /mnt/sbin/restore + +# +# create the devices nodes デバイスノードを作る +# +cd /mnt/dev +./MAKEDEV std +./MAKEDEV sd0 +./MAKEDEV sd1 +./MAKEDEV sd2 +./MAKEDEV st0 +./MAKEDEV pty0 +cd / + +# +# create minimum filesystem table 最小限のファイルシステムテーブル +# +cat > /mnt/etc/fstab <<EOM +/dev/fd0a / ufs rw 1 1 +EOM + +# +# create minimum passwd file 最小限のパスワードファイル +# +cat > /mnt/etc/passwd <<EOM +root:*:0:0:Charlie &:/root:/bin/sh +EOM + +cat > /mnt/etc/master.passwd <<EOM +root::0:0::0:0:Charlie &:/root:/bin/sh +EOM + +chmod 600 /mnt/etc/master.passwd +chmod 644 /mnt/etc/passwd +/usr/sbin/pwd_mkdb -d/mnt/etc /mnt/etc/master.passwd + +# +# umount the floppy and inform the user フロッピーを unmount +# +/sbin/umount /mnt]]></programlisting> + </sect3> + + <sect3> + <title>災難の後に</title> + + <para>重要な問題は, ハードウェアが生き残ったかどうかです. + 定期的なバックアップを取っていれば + ソフトウェアについて心配する必要はありません.</para> + + <para>ハードウェアがダメージを受けていたら, + 最初にそのダメージを受けた部品を交換してください.</para> + + <para>ハードウェアに問題がなければ, + フロッピーをチェックしてください. + カスタムブートフロッピーディスクを使っているのであれば + シングルユーザ(<prompt>boot:</prompt> プロンプトの出た時に + <literal>-s</literal> とタイプしてください) + でブートしてください. それから次の + 「ファイルシステムを1つずつ回復する」 + を読んでください.</para> + + <para><filename>boot.flp</filename> と + <filename>fixit.flp</filename> + を使っているのであればこのまま読み続けてください. + <filename>boot.flp</filename> を入れてブートしてください. + 本来のインストールメニューが表示されるはずです. (ここで) + <literal>fixit XXX</literal>オプションを選びます. 指示の通り + <filename>fixit.flp</filename> を入れてください. + <command>restore</command> とその他の必要なプログラムは + <filename>/mnt2/stand</filename>に置かれています.</para> + <!-- kuriyama - XXX ? --> + + <para>ファイルシステムを一つずつ回復する</para> + + <para>最初のディスクのrootパーティションを &man.mount.8; + (例えば <command>mount /dev/sd0a /mnt</command> のように) + マウントして見てください. + ディスクラベルが破壊されている場合は &man.disklabel.8; + を使ってあらかじめプリントしておいた通りに + パーティションを作り直しラベルをつけてセーブしてください. + &man.newfs.8; を使いファイルシステムを作り直します. + ルートパーティションを読み書き可能にマウント (<command>mount + -u -o rw /mnt</command>) しなおします. + バックアッププログラムとバックアップテープを使って + このファイルシステムのデータを回復します (例えば + <command>restore vrf /dev/st0</command>とします). + ファイルシステムをアンマウント (<command>umount + /mnt</command>など) して, + 障害を受けたファイルシステムそれぞれについて + 繰り返してください.</para> + + <para>システムが動き出したら, + 新しいテープにデータをバックアップしてください. + どのような理由で再び事故が起きたりデータが + 失われるかはわかりません. これに時間を費す事で, + 後々の災難から救われる事になります.</para> + </sect3> + + <sect3> + <title>* 災難対策をしていませんでした. + どうしたらいいでしょう?</title> + + <para></para> + </sect3> + </sect2> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/basics/chapter.sgml b/ja_JP.eucJP/books/handbook/basics/chapter.sgml new file mode 100644 index 0000000000..762e0058ed --- /dev/null +++ b/ja_JP.eucJP/books/handbook/basics/chapter.sgml @@ -0,0 +1,152 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.8 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:59 kuriyama Exp $ +--> + +<chapter id="basics"> + <title>Unix の基礎知識</title> + + <para><emphasis>訳: &a.jp.nakai;.<!-- <br> --> + 12 October 1996.</emphasis></para> + + <sect1 id="basics-man"> + <title>オンラインマニュアル</title> + + <para>FreeBSD についてのもっとも包括的なドキュメントは + <emphasis>マニュアルページ</emphasis>の形式になっているものです. + FreeBSD システム上のほとんどすべてのプログラムには基本的な + 操作方法とさまざまな引数を説明しているリファレンスマニュアル + がついています. これらのマニュアルは <command>man</command> + コマンドで見ることができます. <command>man</command> + コマンドの使い方は簡単です :</para> + + <screen>&prompt.user; <userinput>man <replaceable>コマンド名</replaceable></userinput> + </screen> + + <para><replaceable>コマンド名</replaceable> + のところには知りたいコマンドの名前を入れます. たとえば, + <command>ls</command> コマンドについて知りたい場合には + 次のように入力します:</para> + + <screen>&prompt.user; <userinput>man ls</userinput></screen> + + <para>オンラインマニュアルは 数字のついたセクションに + 分けられています :</para> + + <orderedlist> + <listitem> + <para>ユーザコマンド</para> + </listitem> + + <listitem> + <para>システムコールとエラー番号</para> + </listitem> + + <listitem> + <para>C のライブラリ関数</para> + </listitem> + + <listitem> + <para>デバイスドライバ</para> + </listitem> + + <listitem> + <para>ファイル形式</para> + </listitem> + + <listitem> + <para>ゲームとほかのお楽しみ</para> + </listitem> + + <listitem> + <para>そのほかの情報</para> + </listitem> + + <listitem> + <para>システムの管理と操作のためのコマンド</para> + </listitem> + </orderedlist> + + <para>場合によっては, 同じことがらでもオンラインマニュアルでは + 複数のセクションに記載されていることがあります. たとえば, + <command>chmod</command> ユーザコマンドと + <function>chmod()</function> + システムコールがあります. この場合, <command>man</command> + コマンドでどちらを参照したいかをセクションで指定することが + できます :</para> + + <screen>&prompt.user; <userinput>man 1 chmod</userinput></screen> + + <para>とすればユーザコマンドとしての <command>chmod</command> + のマニュアルページが表示されます. オンラインマニュアル上の特定の + セクションへの参照は通常, 書かれているドキュメントの + 括弧の中に示されています. ですから, &man.chmod.1; は + <command>chmod</command> + ユーザコマンドを, &man.chmod.2; + はシステムコールの方を示しています.</para> + + <para>コマンドの名前を知っていて, 単純にその使い方が分かる場合は + よいのですが, もしコマンドの名前を思い出せない場合には + どうしたらいいのでしょう? <command>man</command> に + <option>-k</option> スイッチをつければ, + コマンドデスクリプション中のキーワードから検索することができます + :</para> + + <screen>&prompt.user; <userinput>man -k mail</userinput></screen> + + <para>このコマンドを使うことで, + “mail”というキーワードを含むコマンドの + 一覧を参照することができます. 実を言うと + <command>apropos</command> + コマンドを使うのと機能的には同じです.</para> + + <para>それから, <filename>/usr/bin</filename> + にある優れたコマンドすべてを目にしても, + それらの大半がどういった働きをするのか + まったく見当もつかないときは どうしたらよいでしょう. 単純に, + + <screen>&prompt.user; <userinput>cd /usr/bin; man -f *</userinput></screen> + + あるいは同じ働きをする + + <screen>&prompt.user; <userinput>cd /usr/bin; whatis *</userinput></screen> + + としましょう.</para> + </sect1> + + <sect1 id="basics-info"> + <title>GNU の Info ファイル</title> + + <para>FreeBSD には Free Software Foundation (FSF) + によるアプリケーションや + ユーティリティがたくさんあります. こうしたプログラムには + manページに加えて, “info” ファイルと呼ばれる + ハイパーテキスト形式のドキュメントが付属になっていて, + <command>info</command> コマンドや, <command>emacs</command> + をインストールしているなら <command>emacs</command> の info + モードで見ることができます.</para> + + <para>&man.info.1; コマンドを使うには, 単にこう入力します.</para> + + <screen>&prompt.user; <userinput>info</userinput></screen> + + <para>おおまかなイントロダクションを + 見るには, <userinput>h</userinput> と入力します. + クイックコマンドリファレンスは <userinput>?</userinput> + とします.</para> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/bibliography/chapter.sgml b/ja_JP.eucJP/books/handbook/bibliography/chapter.sgml new file mode 100644 index 0000000000..0d6c15be74 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/bibliography/chapter.sgml @@ -0,0 +1,638 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.9 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:59 kuriyama Exp $ +--> + +<chapter id="bibliography"> + <title>参考図書</title> + + <para><emphasis>訳: &a.jp.nakai;.<!-- <br> --> + 12 October 1996.</emphasis></para> + + <para>FreeBSD オペレーティングシステムの個々の部分については + マニュアルページで定義のような説明がなされていますが, + それらにはどうやってその部分どうしをつなぎあわせて + オペレーティングシステム全体を円滑に動作させるかを + 説明していないという欠点がよく指摘されます. + それを補うためには UNIX システム管理についてのよい本や, + すぐれた利用者向けのマニュアルが欠かせません.</para> + + <sect1> + <title>FreeBSDのためだけの書籍 & 雑誌</title> + + <para><emphasis>非英語文化圏の 書籍 & 雑誌:</emphasis></para> + + <itemizedlist> + <listitem> + <para><ulink URL="http://freebsd.csie.nctu.edu.tw/~jdli/book.html"> + FreeBSD 入門與應用</ulink> (in Chinese).</para> + </listitem> + + <listitem> + <para>FreeBSD入門キット 98版第二版. 宮嵜忠臣 著. + 秀和システム. ISBN 4-87966-535-5 C3055 2900円.</para> + </listitem> + + <listitem> + <para>FreeBSD入門キット AT互換機版 第二版. 宮嵜忠臣 著. + 秀和システム. ISBN 4-87966-535-5 C3055 2900円.</para> + </listitem> + + <listitem> + <para>ここまでできる FreeBSD パワーガイド. + 霜山 滋 仲道 嘉夫 山中右次 著. 秀和システム. + ISBN 4-87966-637-8 2600円.</para> + </listitem> + + <listitem> + <para><ulink + URL="http://www.shoeisha.co.jp/pc/index/shinkan/97_05_06.htm"> + FreeBSD徹底入門</ulink>. + あさだたくや 天川修平 衛藤敏寿 浜田直樹 細川達己 三田吉郎 著. + <ulink URL="http://www.shoeisha.co.jp/">翔泳社</ulink>. + ISBN 4-88135-473-6 3600円.</para> + </listitem> + + <listitem> + <para><ulink + URL="http://www.ascii.co.jp/pb/book1/shinkan/detail/1322785.html"> + パーソナルUNIXスターターキットFreeBSD</ulink>. + 民田雅人 古場正行 増田佳泰 天池健 宮川晋 共著. + <ulink URL="http://www.ascii.co.jp/">アスキー</ulink>. + ISBN 4-7561-1733-3 3000円.</para> + </listitem> + + <listitem> + <para>FreeBSD ハンドブック (日本語版). + <ulink URL="http://www.ascii.co.jp/">アスキー</ulink>. + ISBN 4-7561-1580-2 3800円.</para> + </listitem> + + <listitem> + <para>FreeBSD mit Methode (ドイツ語版). + Computer und Literatur Verlag/Vertrieb Hanser 発行. + 1998. ISBN 3-932311-31-0</para> + </listitem> + + <listitem> + <para><ulink + url="http://www.pc.mycom.co.uk/FreeBSD/install-manual.html"> + FreeBSD インストール & 活用マニュアル</ulink>, + published by <ulink url="http://www.pc.mycom.co.jp/"> + 毎日コミュニケーションズ</ulink>.</para> + </listitem> + </itemizedlist> + + <para><emphasis>英語の書籍 & 雑誌:</emphasis></para> + + <itemizedlist> + <listitem> + <para><ulink URL="http://www.cdrom.com/titles/freebsd/bsdbook.phtml"> + The Complete FreeBSD</ulink>, + published by + <ulink URL="http://www.cdrom.com">Walnut Creek CDROM</ulink>.</para> + </listitem> + </itemizedlist> + </sect1> + + <sect1> + <title>利用者向けのガイド</title> + + <itemizedlist> + <listitem> + <para>Computer Systems Research Group, UC Berkeley. + <emphasis>4.4BSD User's Reference Manual</emphasis>. + O'Reilly & Associates, Inc., 1994. + <!-- <br> -->ISBN 1-56592-075-9</para> + </listitem> + + <listitem> + <para>Computer Systems Research Group, UC Berkeley. + <emphasis>4.4BSD User's Supplementary Documents</emphasis>. + O'Reilly & Associates, Inc., 1994. + <!-- <br> -->ISBN 1-56592-076-7</para> + </listitem> + + <listitem> + <para><emphasis>UNIX in a Nutshell</emphasis>. + O'Reilly & Associates, Inc., 1990. + <!-- <br> -->ISBN 093717520X</para> + </listitem> + + <listitem> + <para>Mui, Linda. + <emphasis>What You Need To Know When You Can't Find Your UNIX + System Administrator</emphasis>. + O'Reilly & Associates, Inc., 1995. + <!-- <br> -->ISBN 1-56592-104-6</para> + </listitem> + + <listitem> + <para><ulink URL="http://www-wks.acs.ohio-state.edu/"> + Ohio State University</ulink> has written + a <ulink + URL="http://www-wks.acs.ohio-state.edu/unix_course/unix.html"> + UNIX Introductory Course</ulink> which is available online + in HTML and postscript format.</para> + </listitem> + + <listitem> + <para><ulink url="http://www.jp.FreeBSD.ORG/"> + FreeBSD 友の会 jpman プロジェクト</ulink>. <ulink + url="http://www.pc.mycom.co.jp/FreeBSD/urm.html">FreeBSD User's + Reference Manual</ulink> (日本語訳). <ulink + url="http://www.pc.mycom.co.jp/">毎日コミュニケーションズ + </ulink>, 1998. ISBN4-8399-0088-4 P3800E.</para> + </listitem> + </itemizedlist> + </sect1> + + <sect1> + <title>管理者向けのガイド</title> + + <itemizedlist> + <listitem> + <para>Albitz, Paul and Liu, Cricket. <emphasis>DNS and + BIND</emphasis>, 2nd Ed. + O'Reilly & Associates, Inc., 1997. + <!-- <br> -->ISBN ISBN 1-56592-236-0 + <!-- <br> -->(訳注: 邦訳は以下のものが出版されています. + <!-- <br> -->高田広章 / 小島育夫 監訳 , 小舘光正 訳. + <emphasis>DNS & BIND 改訂版</emphasis>. + オライリー・ジャパン, 1998. + <!-- <br> -->ISBN 4-900900-42-7)</para> + </listitem> + + <listitem> + <para>Computer Systems Research Group, UC Berkeley. + <emphasis>4.4BSD System Manager's Manual</emphasis>. + O'Reilly & Associates, Inc., 1994. + <!-- <br> -->ISBN 1-56592-080-5</para> + </listitem> + + <listitem> + <para>Costales, Brian, et al. + <emphasis>Sendmail</emphasis>, 2nd Ed. O'Reilly & + Associates, Inc., 1997. + <!-- <br> -->ISBN 1-56592-222-0 + <!-- <br> -->(訳注: 邦訳は以下のものが出版されています. + 2分冊になっています. + 原著の3章までが「システム管理」, 4章が「リファレンス」 + に対応します.) + ただし2分冊となり,原著のリファレンスの部分に当たる Volume2 + は 1998年3月の時点では出版されていません. + <!-- <br> -->中村 素典 監訳, 鈴木 克彦 訳. + <emphasis>sendmail システム管理 (Volume1)</emphasis>. + オライリー・ジャパン, 1997. + <!-- <br> -->ISBN 4-900900-40-0) + <!-- <br> -->中村 素典 監訳, 鈴木 克彦 訳. + <emphasis>sendmail システム管理 (Volume2)</emphasis>. + オライリー・ジャパン, 1998. + <!-- <br> -->ISBN 4-900900-41-9)</para> + </listitem> + + <listitem> + <para>Frisch, Æleen. <emphasis>Essential System + Administration</emphasis>, 2nd Ed. O'Reilly & + Associates, Inc., 1995. <!-- <br> -->ISBN 1-56592-127-5 + <!-- <br> -->(訳注: 邦訳は以下のものが出版されています. + <!-- <br> -->谷川 哲司 監訳 黒岩 真吾 , 株式会社ユニテック + 訳. <emphasis>UNIX システム管理入門 改訂版</emphasis>. + オライリー・ジャパン, 1998. + <!-- <br> -->ISBN 4-900900-14-1)</para> + </listitem> + + <listitem> + <para>Hunt, Craig. <emphasis>TCP/IP Network Administration</emphasis>. + O'Reilly & Associates, Inc., 1992. + <!-- <br> -->ISBN 0-937175-82-X + <!-- <br> -->(訳注: 邦訳は以下のものが出版されています. + <!-- <br> -->村井純 監訳. + <emphasis>TCP/IP ネットワーク管理</emphasis>. + インターナショナル・トムソン・パブリッシング・ジャパン, 1994. + <!-- <br> -->ISBN 4-900718-01-7)</para> + </listitem> + + <listitem> + <para>Nemeth, Evi. <emphasis>UNIX System Administration + Handbook</emphasis>. 2nd Ed. Prentice Hall, 1995. + <!-- <br> -->ISBN 0131510517 + <!-- <br> -->(訳注: 邦訳は以下のものが出版されています. + <!-- <br> -->井上尚司監訳. + <emphasis>UNIX システム管理入門</emphasis>. + ソフトバンク, 1992. + <!-- <br> -->ISBN 4-89052-362-6 + <!-- <br> -->原本は第2版だが, 訳出は第1版のみ)</para> + </listitem> + + <listitem> + <para>Stern, Hal <emphasis>Managing NFS and NIS</emphasis> + O'Reilly & Associates, Inc., 1991. + <!-- <br> -->ISBN 0-937175-75-7</para> + </listitem> + + <listitem> + <para><ulink url="http://www.jp.FreeBSD.ORG/"> + FreeBSD 友の会 jpman プロジェクト</ulink>. <ulink + url="http://www.pc.mycom.co.jp/FreeBSD/sam.html">FreeBSD System + Administrator's Manual</ulink> (日本語訳). <ulink + url="http://www.pc.mycom.co.jp/"> + 毎日コミュニケーションズ</ulink>, + 1998. ISBN4-8399-0109-0 P3300E.</para> + </listitem> + </itemizedlist> + </sect1> + + <sect1> + <title>プログラマ向けのガイド</title> + + <itemizedlist> + <listitem> + <para>Asente, Paul. <emphasis>X Window System + Toolkit</emphasis>. Digital Press. + <!-- <br> -->ISBN 1-55558-051-3</para> + </listitem> + + <listitem> + <para>Computer Systems Research Group, UC Berkeley. + <emphasis>4.4BSD Programmer's Reference Manual</emphasis>. + O'Reilly & Associates, Inc., 1994. + <!-- <br> -->ISBN 1-56592-078-3</para> + </listitem> + + <listitem> + <para>Computer Systems Research Group, UC Berkeley. + <emphasis>4.4BSD Programmer's Supplementary Documents</emphasis>. + O'Reilly & Associates, Inc., 1994. + <!-- <br> -->ISBN 1-56592-079-1</para> + </listitem> + + <listitem> + <para>Harbison, Samuel P. and Steele, Guy + L. Jr. <emphasis>C: A Reference Manual</emphasis>. 4rd ed. Prentice + Hall, 1995. <!-- <br> -->ISBN 0-13-326224-3 + <!-- <br> -->(訳注: 邦訳は以下のものが出版されています. + <!-- <br> -->斎藤信男監訳. + <emphasis>新・詳説C言語リファレンス + [H&Sリファレンス]</emphasis>. + ソフトバンク, 1994. + <!-- <br> -->ISBN 4-89052-506-8 + <!-- <br> -->原本は第4版だが, 訳出は第3版のみ。)</para> + </listitem> + + <listitem> + <para>Kernighan, Brian and Dennis M. Ritchie. + <emphasis>The C Programming Language.</emphasis>. + PTR Prentice Hall, 1988. + <!-- <br> -->ISBN 0-13-110362-9 + <!-- <br> -->(訳注: 邦訳は以下のものが出版されています. + <!-- <br> -->石田晴久 訳. + <emphasis>プログラミング言語 C 第2版(訳書訂正版)</emphasis> + 共立出版, 1989. + <!-- <br> -->ISBN 4-320-02692-6)</para> + </listitem> + + <listitem> + <para>Lehey, Greg. + <emphasis>Porting UNIX Software</emphasis>. + O'Reilly & Associates, Inc., 1995. + <!-- <br> -->ISBN 1-56592-126-7</para> + </listitem> + + <listitem> + <para>Plauger, P. J. <emphasis>The Standard C + Library</emphasis>. Prentice Hall, 1992. + <!-- <br> -->ISBN 0-13-131509-9 + <!-- <br> -->(訳注: 邦訳は以下のものが出版されています. + <!-- <br> -->福富寛 / 門倉明彦 / 清水恵介 訳. + <emphasis>標準 C ライブラリ ANSI/ISO/JIS C規格</emphasis>. + トッパン, 1995. + <!-- <br> -->ISBN 4-8101-8541-9)</para> + </listitem> + + <listitem> + <para>Stevens, W. Richard. <emphasis>Advanced + Programming in the UNIX Environment</emphasis>. + Reading, Mass. : Addison-Wesley, 1992 + <!-- <br> -->ISBN 0-201-56317-7 + <!-- <br> -->(訳注: 邦訳は以下のものが出版されています. + <!-- <br> -->大木敦雄 訳. + <emphasis>詳解 UNIX プログラミング</emphasis>. トッパン, 1994. + <!-- <br> -->ISBN 4-89052-524-6)</para> + </listitem> + + <listitem> + <para>Stevens, W. Richard. <emphasis>UNIX Network + Programming</emphasis>. 2nd Ed. PTR Prentice Hall, 1998. + <!-- <br> -->ISBN 0-13-949876-1 + <!-- <br> -->(訳注: + 第 1 版の邦訳は以下のものが出版されています. + <!-- <br> -->篠田陽一 訳. + <emphasis>UNIX ネットワークプログラミング</emphasis>. + トッパン,1992. + <!-- <br> -->ISBN 4-8101-8509-5)</para> + </listitem> + + <listitem> + <para>Wells, Bill. “Writing Serial Drivers for UNIX”. + <emphasis>Dr. Dobb's Journal</emphasis>. 19(15), December + 1994. pp68-71, 97-99.</para> + </listitem> + </itemizedlist> + </sect1> + + <sect1> + <title>オペレーティングシステム内部</title> + + <itemizedlist> + <listitem> + <para>Andleigh, Prabhat K. <emphasis>UNIX System Architecture</emphasis>. + Prentice-Hall, Inc., 1990. + <!-- <br> -->ISBN 0-13-949843-5</para> + </listitem> + + <listitem> + <para>Jolitz, William. “Porting UNIX to the + 386”. <emphasis>Dr. Dobb's Journal</emphasis>. January + 1991-July 1992.</para> + </listitem> + + <listitem> + <para>Leffler, Samuel J., Marshall Kirk McKusick, + Michael J Karels and John Quarterman <emphasis>The Design and + Implementation of the 4.3BSD UNIX Operating + System</emphasis>. Reading, Mass. : Addison-Wesley, 1989. + <!-- <br> -->ISBN 0-201-06196-1 + <!-- <br> -->(訳注: 邦訳は以下のものが出版されています. + <!-- <br> -->中村明 / 相田仁 / 計宇生 / 小池汎平 訳. + <emphasis>UNIX 4.3BSDの設計と実装</emphasis>. 丸善, 1991. + <!-- <br> -->ISBN 4-621-03607-6)</para> + </listitem> + + <listitem> + <para>Leffler, Samuel J., Marshall Kirk McKusick, + <emphasis>The Design and Implementation of the 4.3BSD + UNIX Operating System: Answer Book</emphasis>. + Reading, Mass. : Addison-Wesley, 1991. + <!-- <br> -->ISBN 0-201-54629-9 + <!-- <br> -->(訳注: 邦訳は以下のものが出版されています. + <!-- <br> -->相田仁 / 計宇生 / 小池汎平 訳. + <emphasis>UNIX 4.3BSDの設計と実装</emphasis>. + アンサーブック, トッパン, 1991. + <!-- <br> -->ISBN 4-8101-8039-5)</para> + </listitem> + + <listitem> + <para>McKusick, Marshall Kirk, Keith Bostic, Michael J Karels, + and John Quarterman. <emphasis>The Design and + Implementation of the 4.4BSD Operating + System</emphasis>. Reading, Mass. : Addison-Wesley, 1996. + <!-- <br> -->ISBN 0-201-54979-4</para> + </listitem> + + <listitem> + <para>Stevens, W. Richard. <emphasis>TCP/IP Illustrated, + Volume 1: The Protocols</emphasis>. + Reading, Mass. : Addison-Wesley, 1996. + <!-- <br> -->ISBN 0-201-63346-9</para> + </listitem> + + <listitem> + <para>Schimmel, Curt. + <emphasis>Unix Systems for Modern Architectures</emphasis>. + Reading, Mass. : Addison-Wesley, 1994. + <!-- <br> -->ISBN 0-201-63338-8</para> + </listitem> + + <listitem> + <para>Stevens, W. Richard. <emphasis>TCP/IP Illustrated, + Volume 3: TCP for Transactions, HTTP, NNTP + and the UNIX Domain Protocols</emphasis>. + Reading, Mass. : Addison-Wesley, 1996. + <!-- <br> -->ISBN 0-201-63495-3</para> + </listitem> + + <listitem> + <para>Vahalia, Uresh. + <emphasis>UNIX Internals -- The New Frontiers</emphasis>. + Prentice Hall, 1996. + <!-- <br> -->ISBN 0-13-101908-2</para> + </listitem> + + <listitem> + <para>Wright, Gary R. and W. Richard Stevens. + <emphasis>TCP/IP Illustrated, Volume 2: + The Implementation</emphasis>. + Reading, Mass. : Addison-Wesley, 1995. + <!-- <br> -->ISBN 0-201-63354-X</para> + </listitem> + </itemizedlist> + </sect1> + + <sect1> + <title>セキュリティの参考資料</title> + + <itemizedlist> + <listitem> + <para>Cheswick, William R. and Steven M. Bellovin. + <emphasis>Firewalls and Internet Security: + Repelling the Wily Hacker</emphasis>. + Reading, Mass. : Addison-Wesley, 1995. + <!-- <br> -->ISBN 0-201-63357-4 + <!-- <br> -->(訳注: 邦訳は以下のものが出版されています. + <!-- <br> -->川副博 監訳. <emphasis>ファイアウォール</emphasis>. + ソフトバンク, 1995. + <!-- <br> -->ISBN 4-89052-672-2)</para> + </listitem> + + <listitem> + <para>Garfinkel, Simson and Gene Spafford. + <emphasis>Practical UNIX Security</emphasis>. 2nd Ed. + O'Reilly & Associates, Inc., 1996. + <!-- <br> -->ISBN 1-56592-148-8 + <!-- <br> -->(訳注: 邦訳は以下のものが出版されています. + <!-- <br> -->山口英監訳. <emphasis>UNIX セキュリティ</emphasis>. + アスキー, 1993. + <!-- <br> -->ISBN 4-7561-0274-3 + <!-- <br> -->原本は第2版だが, 訳出は第1版のみ)</para> + </listitem> + + <listitem> + <para>Garfinkel, Simson. + <emphasis>PGP Pretty Good Privacy</emphasis> + O'Reilly & Associates, Inc., 1995. + <!-- <br> -->ISBN 1-56592-098-8</para> + </listitem> + </itemizedlist> + </sect1> + + <sect1> + <title>ハードウェアの参考資料</title> + + <itemizedlist> + <listitem> + <para>Anderson, Don and Tom Shanley. + <emphasis>Pentium Processor System Architecture</emphasis>. + 2nd Ed. Reading, Mass. : Addison-Wesley, 1995. + <!-- <br> -->ISBN 0-201-40992-5</para> + </listitem> + + <listitem> + <para>Ferraro, Richard F. <emphasis>Programmer's Guide + to the EGA, VGA, and Super VGA Cards</emphasis>. + 3rd ed. Reading, Mass. : Addison-Wesley, 1995. + <!-- <br> -->ISBN 0-201-62490-7</para> + </listitem> + + <listitem> + <para>Intel Corporation は, 自社の CPU + やチップセットに関する文書を自社の <ulink + url="http://developer.intel.com/">開発者向け Web + サイト</ulink> で公開しています. 文書のフォーマットは通常 + PDF です.</para> + </listitem> + + <listitem> + <para>Shanley, Tom. <emphasis>80486 System + Architecture</emphasis>. 3rd ed. Reading, Mass. : + Addison-Wesley, 1995. <!-- <br> -->ISBN + 0-201-40994-1</para> + </listitem> + + <listitem> + <para>Shanley, Tom. <emphasis>ISA System + Architecture</emphasis>. 3rd ed. Reading, Mass. : + Addison-Wesley, 1995. + <!-- <br> -->ISBN 0-201-40996-8</para> + </listitem> + + <listitem> + <para>Shanley, Tom. <emphasis>PCI System + Architecture</emphasis>. 3rd ed. Reading, Mass. : + Addison-Wesley, 1995. <!-- <br> -->ISBN + 0-201-40993-3</para> + </listitem> + + <listitem> + <para>Van Gilluwe, Frank. <emphasis>The Undocumented PC</emphasis>. + Reading, Mass: Addison-Wesley Pub. Co., 1994. + <!-- <br> -->ISBN 0-201-62277-7</para> + </listitem> + </itemizedlist> + </sect1> + + <sect1> + <title>UNIX の歴史</title> + + <itemizedlist> + <listitem> + <para>Lion, John <emphasis>Lion's Commentary on UNIX, 6th Ed. + With Source Code</emphasis>. + ITP Media Group, 1996. + <!-- <br> -->ISBN 1573980137</para> + </listitem> + + <listitem> + <para>Raymond, Eric s. <emphasis>The New Hacker's Dictonary, + 3rd edition</emphasis>. MIT Press, 1996. + <!-- <br> -->ISBN 0-262-68092-0 + <!-- <br> -->Also known as the + <ulink URL="http://www.ccil.org/jargon/jargon.html">Jargon File</ulink></para> + </listitem> + + <listitem> + <para>Saulus, Peter H. <emphasis>A quarter century of UNIX</emphasis>. + Addison-Wesley Publishing Company, Inc., 1994. + <!-- <br> -->ISBN 0-201-54777-5</para> + </listitem> + + <listitem> + <para>Simon Garfinkel, Daniel Weise, Steven Strassmann. + <emphasis>The UNIX-HATERS Handbook</emphasis>. + IDG Books Worldwide, Inc., 1994. + <!-- <br> -->ISBN 1-56884-203-1</para> + </listitem> + + <listitem> + <para>Don Libes, Sandy Ressler <emphasis>Life with UNIX</emphasis> + — special + edition. Prentice-Hall, Inc., 1989. + <!-- <br> -->ISBN 0-13-536657-7 + <!-- <br> -->(訳注: 邦訳は以下のものが出版されています. + <!-- <br> -->坂本文 監訳. <emphasis>Life with UNIX</emphasis>. + アスキー, 1990. + <!-- <br> -->ISBN 4-7561-0783-4 + <!-- <br> -->邦訳がSpecial 版の訳出か否かは不明)</para> + </listitem> + + <listitem> + <para><emphasis>BSD 系 OS の系譜図</emphasis>. 1997年. + <!-- <br> --> + <ulink URL="ftp://ftp.freebsd.org/pub/FreeBSD/FreeBSD-current/src/share/misc/bsd-family-tree"> + ftp://ftp.freebsd.org/pub/FreeBSD/FreeBSD-current/src/share/misc/bsd-family-tree</ulink> + または, FreeBSD-current マシンの + <ulink URL="file:/usr/share/misc/bsd-family-tree"> + ローカルファイル</ulink>.</para> + </listitem> + + <listitem> + <para><emphasis>BSD リリース告知コレクション</emphasis>. 1997. + <!-- <br> --> + <ulink URL="http://www.de.FreeBSD.ORG/de/ftp/releases/"> + http://www.de.FreeBSD.ORG/de/ftp/releases/</ulink></para> + </listitem> + + <listitem> + <para><emphasis>Networked Computer Science Technical Reports Library + </emphasis>. + <!-- <br> --> + <ulink URL="http://www.ncstrl.org/">http://www.ncstrl.org/</ulink> + </para> + </listitem> + + <listitem> + <para><emphasis>Computer Systems Research group (CSRG) からの古い + BSD リリース集</emphasis> + <!-- <br> --> + <ulink url="http://www.mckusick.com/csrg/"> + http://www.mckusick.com/csrg/</ulink>: + この 4 枚 CD セットには, 1BSD から 4.4BSD までと 4.4BSD-Lite2 + が含まれます (残念ながら 2.11BSD は含まれていません). + また 4 枚目の CD には, 最終ソースおよび SCCS + ファイルが含まれています.</para> + </listitem> + </itemizedlist> + </sect1> + + <sect1> + <title>雑誌とジャーナル</title> + + <itemizedlist> + <listitem> + <para><emphasis> + The C/C++ Users Journal</emphasis>. R&D Publications + Inc. ISSN 1075-2838</para> + </listitem> + + <listitem> + <para><emphasis>Sys Admin — The Journal for UNIX System + Administrators</emphasis> + Miller Freeman, Inc., ISSN 1061-2688</para> + </listitem> + </itemizedlist> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/book.sgml b/ja_JP.eucJP/books/handbook/book.sgml index 88ecf8f4f7..9f35d9b3db 100644 --- a/ja_JP.eucJP/books/handbook/book.sgml +++ b/ja_JP.eucJP/books/handbook/book.sgml @@ -1,210 +1,151 @@ -<!-- $Id: book.sgml,v 1.41 1999-03-01 18:04:16 motoyuki Exp $ --> -<!-- The FreeBSD Japanese Documentation Project --> -<!-- Original revision: 1.101 --> - -<!DOCTYPE linuxdoc PUBLIC "-//FreeBSD//DTD linuxdoc//EN" [ - -<!-- Conditional flags for this version of the document --> -<!ENTITY % boothelp.only "IGNORE"> -<!ENTITY % handbook.only "INCLUDE"> - -<!-- Entity shorthand for authors' names and email addresses --> -<!ENTITY % authors SYSTEM "authors.sgml"> -%authors; +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project -<!-- Entity shorthand for translator's names and email addresses --> -<!ENTITY % jmembers SYSTEM "jmembers.sgml"> -%jmembers; + Original revision: 1.72 + $Id: book.sgml,v 1.42 1999-04-08 15:45:06 kuriyama Exp $ +--> -<!-- Entity shorthand for mailing list email addresses --> -<!ENTITY % lists SYSTEM "lists.sgml"> -%lists; +<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V3.0-Based Extension//EN" [ +<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN"> +%man; -<!-- Entity definitions for all the parts --> -<!ENTITY % sections SYSTEM "sections.sgml"> -%sections; +<!ENTITY % chapters SYSTEM "chapters.ent"> %chapters; +<!ENTITY % authors SYSTEM "authors.ent"> %authors; +<!ENTITY % jauthors SYSTEM "jauthors.ent"> %jauthors; +<!ENTITY % mailing-lists SYSTEM "mailing-lists.ent"> %mailing-lists; -<!-- The currently released version of FreeBSD --> <!-- This value is used to create some links on web sites and such, so do NOT change this until it's really release time! --> <!ENTITY rel.current CDATA "3.1"> - ]> -<linuxdoc> - <book> +<book> + <bookinfo> + <title>FreeBSD ハンドブック</title> - <title>FreeBSD ハンドブック</title> + <authorgroup> <author> - <name>FreeBSD ドキュメンテーションプロジェクト</name> + <surname>FreeBSD ドキュメンテーションプロジェクト</surname> </author> - <date>1999年2月</date> - -<abstract>FreeBSD へようこそ! このハンドブックは<bf>FreeBSD Release -&rel.current;</bf>のインストールおよび, 日常での使い方について記述したもので, -FreeBSD ドキュメンテーションプロジェクトによって編集されています. - -日本語版の作成は FreeBSD 日本語ドキュメンテーションプロジェクトがおこなって -います. 本書は<bf>現在進行中の作業</bf>であって, 多くの個人の手からなる -仕事です. 多くのセクションはまだ存在しませんし, いま存在するセクションの -いくつかはアップデートが必要です. この FreeBSD ドキュメンテーション -プロジェクトに協力したいと思ったら, &a.doc; まで (英語で) 電子メールを -送ってください. ハンドブックそのものに関する議論は, こちらで -おこなわれています. (もちろん英語でです.) -日本語訳および, 日本語版のみに関することは &a.doc-jp; において日本語で -議論されています. 必要に応じて日本語ドキュメンテーションプロジェクトから -本家ドキュメンテーションプロジェクトに対してフィードバックをおこないますので, -英語が得意でない方は &a.doc-jp; まで日本語でコメントをお寄せください. -このドキュメントの最新バージョンは, いつでも -<url url="http://www.jp.FreeBSD.ORG/" -name="日本国内版 FreeBSD World Wide Web サーバ">や -<url url="http://www.FreeBSD.ORG/" name="FreeBSD World Wide Web サーバ"> -で見ることができますし, + </authorgroup> + + <pubdate>1999 年 2 月</pubdate> + +<!-- kuriyama - (c) entity should not be used in EUC-JP encoding. + <copyright> + <year>1995</year> + <year>1996</year> + <year>1997</year> + <year>1998</year> + <holder>The FreeBSD Documentation Project, FreeBSD Inc.</holder> + </copyright> + --> + + <abstract><para>FreeBSD へようこそ! このハンドブックは + <emphasis>FreeBSD Release &rel.current;</emphasis> + のインストールおよび, 日常での使い方について記述したもので, + FreeBSD ドキュメンテーションプロジェクトによって + 編集されています. 日本語版の作成は FreeBSD + 日本語ドキュメンテーションプロジェクトがおこなって います. + 本書は<emphasis>現在進行中の作業</emphasis>であって, + 多くの個人の手からなる 仕事です. + 多くのセクションはまだ存在しませんし, いま存在するセクションの + いくつかはアップデートが必要です. この FreeBSD + ドキュメンテーション プロジェクトに協力したいと思ったら, + &a.doc; まで (英語で) 電子メールを 送ってください. + ハンドブックそのものに関する議論は, こちらで + おこなわれています. (もちろん英語でです.) 日本語訳および, + 日本語版のみに関することは FreeBSD + 日本語ドキュメンテーションプロジェクト <emphasis + remap=tt><email>doc-jp@jp.FreeBSD.ORG</email></emphasis> + において日本語で 議論されています. + 必要に応じて日本語ドキュメンテーションプロジェクトから + 本家ドキュメンテーションプロジェクトに対して + フィードバックをおこないますので, 英語が得意でない方は FreeBSD + 日本語ドキュメンテーションプロジェクト <!-- kuriyama - should + replace &a.ja.doc; --> <emphasis + remap=tt><email>doc-jp@jp.FreeBSD.ORG</email></emphasis> + まで日本語でコメントをお寄せください. + このドキュメントの最新バージョンは, いつでも <ulink + URL="http://www.jp.FreeBSD.ORG/">日本国内版 FreeBSD World + Wide Web サーバ</ulink>や <ulink + URL="http://www.FreeBSD.ORG/">FreeBSD World Wide Web + サーバ</ulink> で見ることができますし, <!-- <url + url="handbook.latin1" name="プレーンテキスト"> や <url + url="handbook.ps" name="postscript">, PDF, --> <ulink + URL="handbook-html.tar.gz">HTML</ulink> 形式のものを HTTP + でダウンロードすることもできます. これらを gzip + で圧縮したものが <ulink + URL="ftp://ftp.FreeBSD.ORG/pub/FreeBSD/doc/">FreeBSD FTP + サーバ</ulink> や, たくさんの<link + linkend="mirrors">ミラーサイト</link>に置かれています. また, + <ulink URL="http://www.freebsd.org/search/search.html"> + ハンドブックの検索</ulink>も可能です.</para> + </abstract> + </bookinfo> + + <part> + <title>導入</title> + + &chap.introduction; + &chap.install; + &chap.basics; + &chap.ports; + </part> + + <part> + <title>システム管理</title> + + &chap.kernelconfig; + &chap.security; + &chap.printing; + &chap.disks; + &chap.backups; + &chap.quotas; + &chap.x11; + &chap.hw; + &chap.l10n; + </part> + + <part> + <title>ネットワーク通信</title> + + &chap.serialcomms; + &chap.ppp-and-slip; + &chap.advanced-networking; + &chap.mail; + </part> + + <part> + <title>さらに進んだ話題</title> + + &chap.cutting-edge; + &chap.contrib; + &chap.policies; + &chap.kernelopts; + &chap.kerneldebug; + &chap.linuxemu; + &chap.internals; + </part> + + <part> + <title>付録</title> + + &chap.mirrors; + &chap.bibliography; + &chap.eresources; + &chap.staff; + &chap.pgpkeys; + &chap.jcontrib; + </part> +</book> + <!-- -<url url="handbook.latin1" name="プレーンテキスト"> や -<url url="handbook.ps" name="postscript">, PDF, + Local Variables: + mode: sgml + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + End: --> -<url url="handbook-html.tar.gz" name="HTML"> 形式のものを -HTTP でダウンロードすることもできます. これらを gzip で圧縮したものが -<url url="ftp://ftp.FreeBSD.ORG/pub/FreeBSD/doc/" name="FreeBSD FTP サーバ"> -や, たくさんの<ref id="mirrors-ftp" name="ミラーサイト">に置かれています. -また, <url url="http://www.freebsd.org/search/search.html" name="ハンドブックの検索">も可能です. - -</abstract> - <toc> - -<!-- ************************************************************ --> - - <part><heading>導入</heading> - - <chapt><heading>はじめに</heading> -<p>FreeBSD は, Intel アーキテクチャ (x86) ベースの PC のための -4.4BSD-Lite をベースとしたオペレーティングシステムです. -FreeBSD の概要については, -<ref id="nutshell" name="FreeBSD とは">をご覧ください. -このプロジェクトの歴史については, <ref id="history" name="FreeBSD 小史"> -をご覧ください. 最新のリリースについての記述は, -<ref id="relnotes" name="現在のリリースについて">をご覧ください. -FreeBSD プロジェクトへの何らかの貢献 (ソースコード, 機器, 資金の提供など) -について興味があれば, <ref id="contrib" name="FreeBSD への貢献"> -の章をご覧ください. - - &nutshell; - &history; - &goals; - &development; - &relnotes; - - &install; - &basics; - - &ports; - -<!-- ************************************************************ --> - - <part><heading>システム管理</heading> - - &kernelconfig; - <chapt><heading>セキュリティ</heading> - &crypt; - &skey; - &kerberos; - &firewalls; - - &printing; - -<!-- &disks; --> - - &backups; - - "as; - - <chapt><heading>X ウィンドウシステム</heading> -<p>この節の完成は保留にしてあります. - <url url="http://www.xfree86.org/" name="The XFree86 Project, Inc"> - から提供されるドキュメントを参考にしてください. - - &hw; - - <chapt><heading>ローカル化<label id="l10n"></heading> - &russian; - &german; - -<!-- ************************************************************ --> - - <part><heading>ネットワーク通信</heading> - - <chapt><heading>シリアル通信</heading> - &serial; - &term; - &dialup; - &dialout; - - <chapt><heading>PPP と SLIP</heading> - -<p>もしあなたがモデムを使ってインターネットに接続したり, -他の人々に FreeBSD によるインターネットへのダイヤルアップ接続を -提供しようとしているのでしたら, PPP または SLIP 接続を選択することができます. -PPP 接続には, 2 種類の方法が提供されています: -<em>ユーザ</em>PPP (iijppp とも呼ばれます) と<em>カーネル</em>PPP です. -両方の PPP の設定手順と, SLIP の設定方法については以下の章に書かれています. - - &userppp; - &ppp; - &slipc; - &slips; - - <chapt><heading>高度なネットワーク</heading> - &routing; - &nfs; - &diskless; - &isdn; - - &mail; - -<!-- ************************************************************ --> - - <part><heading>さらに進んだ話題</heading> - <chapt><heading>開発の最前線: FreeBSD-current と FreeBSD-stable</heading> - <p>あるリリースから次のリリースまでの期間にも, FreeBSD の開発は - 休みなく続けられています. この開発の最前線に興味を持っている人のために, - 手元のシステムを最新の開発ツリーに同期させておくための, - とても使いやすい仕掛けが何種類も用意されています. - 注意: 開発の最前線は, 誰でもが扱えるという性質のものではありません! - もしもあなたが, 開発途中のシステムを追いかけようか, それともリリース - バージョンのどれかを使い続けようかと迷っているのなら, - きっとこの章が参考になるでしょう. </p> - - ¤t; - &stable; - &synching; - &makeworld; - </chapt> - - &submitters; - &policies; - &kernelopts; - &kerneldebug; - &linuxemu; - <chapt><heading>FreeBSD の内部</heading> - &booting; - &memoryuse; - &dma; - &vm; - - -<!-- ************************************************************ --> - - <part><heading>付録</heading> - - &mirrors; - &bibliography; - &eresources; - &contrib; - &pgpkeys; - &jcontrib; - -<!-- &glossary; --> - - </book> -</linuxdoc> diff --git a/ja_JP.eucJP/books/handbook/chapter.decl b/ja_JP.eucJP/books/handbook/chapter.decl new file mode 100644 index 0000000000..2762efb110 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/chapter.decl @@ -0,0 +1,9 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: + $Id: chapter.decl,v 1.1.1.1 1999-04-08 15:45:57 kuriyama Exp $ +--> + +<!DOCTYPE chapter PUBLIC "-//FreeBSD//DTD DocBook V3.0-Based Extension//EN"> diff --git a/ja_JP.eucJP/books/handbook/chapters.ent b/ja_JP.eucJP/books/handbook/chapters.ent new file mode 100644 index 0000000000..fa8a1e0cce --- /dev/null +++ b/ja_JP.eucJP/books/handbook/chapters.ent @@ -0,0 +1,54 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.3 + $Id: chapters.ent,v 1.1.1.1 1999-04-08 15:45:57 kuriyama Exp $ + + Creates entities for each chapter in the FreeBSD Handbook. Each entity + is named chap.foo, where foo is the value of the id attribute on that + chapter, and corresponds to the name of the directory in which that + chapter's .sgml file is stored. + + Chapters should be listed in the order in which they are referenced. +--> + +<!-- Part one --> +<!ENTITY chap.introduction SYSTEM "introduction/chapter.sgml"> +<!ENTITY chap.install SYSTEM "install/chapter.sgml"> +<!ENTITY chap.basics SYSTEM "basics/chapter.sgml"> +<!ENTITY chap.ports SYSTEM "ports/chapter.sgml"> + +<!-- Part two --> +<!ENTITY chap.kernelconfig SYSTEM "kernelconfig/chapter.sgml"> +<!ENTITY chap.security SYSTEM "security/chapter.sgml"> +<!ENTITY chap.printing SYSTEM "printing/chapter.sgml"> +<!ENTITY chap.disks SYSTEM "disks/chapter.sgml"> +<!ENTITY chap.backups SYSTEM "backups/chapter.sgml"> +<!ENTITY chap.quotas SYSTEM "quotas/chapter.sgml"> +<!ENTITY chap.x11 SYSTEM "x11/chapter.sgml"> +<!ENTITY chap.hw SYSTEM "hw/chapter.sgml"> +<!ENTITY chap.l10n SYSTEM "l10n/chapter.sgml"> + +<!-- Part three --> +<!ENTITY chap.serialcomms SYSTEM "serialcomms/chapter.sgml"> +<!ENTITY chap.ppp-and-slip SYSTEM "ppp-and-slip/chapter.sgml"> +<!ENTITY chap.advanced-networking SYSTEM "advanced-networking/chapter.sgml"> +<!ENTITY chap.mail SYSTEM "mail/chapter.sgml"> + +<!-- Part four --> +<!ENTITY chap.cutting-edge SYSTEM "cutting-edge/chapter.sgml"> +<!ENTITY chap.contrib SYSTEM "contrib/chapter.sgml"> +<!ENTITY chap.policies SYSTEM "policies/chapter.sgml"> +<!ENTITY chap.kernelopts SYSTEM "kernelopts/chapter.sgml"> +<!ENTITY chap.kerneldebug SYSTEM "kerneldebug/chapter.sgml"> +<!ENTITY chap.linuxemu SYSTEM "linuxemu/chapter.sgml"> +<!ENTITY chap.internals SYSTEM "internals/chapter.sgml"> + +<!-- Part five (appendices) --> +<!ENTITY chap.mirrors SYSTEM "mirrors/chapter.sgml"> +<!ENTITY chap.bibliography SYSTEM "bibliography/chapter.sgml"> +<!ENTITY chap.eresources SYSTEM "eresources/chapter.sgml"> +<!ENTITY chap.staff SYSTEM "staff/chapter.sgml"> +<!ENTITY chap.pgpkeys SYSTEM "pgpkeys/chapter.sgml"> +<!ENTITY chap.jcontrib SYSTEM "jcontrib/chapter.sgml"> diff --git a/ja_JP.eucJP/books/handbook/contrib/chapter.sgml b/ja_JP.eucJP/books/handbook/contrib/chapter.sgml new file mode 100644 index 0000000000..9777941552 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/contrib/chapter.sgml @@ -0,0 +1,10027 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.12 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:59 kuriyama Exp $ +--> + +<chapter id="contrib"> + <title>FreeBSD への貢献</title> + + <para><emphasis>原作: &a.jkh;.</emphasis></para> + + <para><emphasis>訳: &a.jp.iwasaki;.<!-- <br> --> + 27 April 1997.</emphasis></para> + + <para>あなたも何か FreeBSD のために貢献したくなりましたか? + 素晴らしい! 私たちは常に支援を受ける用意がありますし, FreeBSD + は生き残るためにユー + ザベースの貢献に<emphasis>頼る</emphasis>ようなシステムの一つです. + あなたの貢献は 感謝されるだけではなく, FreeBSD + が成長し続けるために極めて重要なものな のです!</para> + + <para>一部の人達が言っているのとは逆に, + 貢献を受け付けてもらうために腕利 きのプログラマーになるとか + FreeBSD コアチームの人と親友になる必要はあ りません. FreeBSD + プロジェクトの開発は, 多くのそして益々増加する世界中 + の貢献者達によってなされており, 彼らの年齢, + 専門技術分野は多岐に渡りま す. + そして手の空いている人よりも + 成されるべき仕事の方が常に多いのです.</para> + + <para>FreeBSD + プロジェクトがカーネルや散在しているユーティリティよりも, + オペレーティングシステム環境 (と, そのインストール) + に対して責任を持つ ようになったため, + 私たちの<filename>TODO</filename>リストはドキュメンテーション, + ベータテ スト, + 高度に専門化されたタイプのカーネル開発の好例を紹介するなど非常に + 広い範囲のタスクに渡ります. あなたの技能レベルに関わらず, + プロジェクト を支援できることが必ず何かあります!</para> + + <para>FreeBSD + 関連の事業に従事している商業団体が私たちにコンタクトすること + も歓迎します. あなたの製品を (FreeBSD 上で) 動作させるには, + 特別な拡張 が必要ではありませんか? + あまりにも風変わりな要求でなければ, それを受け + 入れる用意が私たちにあるとわかるはずです. + 付加価値のある製品ですか? 私たちに知らせてください! 多分私たちは, + ある 面において共同して作業をすることができるでしょう. + フリーソフトウェア界 は, + ソフトウェアがそのライフサイクルを通してどのように開発され, + 売られ, 保守されていくかについて, 既存の仮説に挑戦しています. + 少なくとももう一 + 度考慮してみることを私たちは強くお奨めします.</para> + + <sect1> + <title>何が必要?</title> + + <para>次のタスクとサブプロジェクトのリストは, コアチームの色々な + <filename>TODO</filename> リ + ストと最近2ヶ月で集めたユーザリクエストを合わせたものです. + 可能なとこ ろでは, 緊急度によってタスクがランクづけされています. + もしここにあるタ スクの実行に興味があるのでしたら, + コーディネータの名前をクリックしてメー ルを送ってください. + もしコーディネータが決まっていなければ, あなたがボ + ランティアしてみませんか?</para> + + <sect2> + <title>優先度の高いタスク</title> + + <para>次のタスクは通常, ひどく壊れているとか, + とても必要とされている何かを 表しているため, + 急務と考えられています:</para> + + <orderedlist> + <listitem> + <para>第3ステージ・ブート問題. 全体コーディネーション: + &a.hackers;</para> + + <itemizedlist> + <listitem> + <para>第3ステージがディスクの BIOS + ジオメトリの正確なマッピングを提供 できるように WinNT + コンパチブルなドライブの追跡をおこなう.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>ファイルシステム問題. 全体コーディネーション: + &a.fs;</para> + + <itemizedlist> + <listitem> + <para>nullfs ファイルシステムコードのクリーンアップと + ドキュメンテーション. コーディネータ: &a.gibbs;</para> + </listitem> + + <listitem> + <para>union ファイルシステムの修正. コーディネータ: + &a.dg;</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>カーネル vm86 及びユーザ vm86 サポート実装. + コーディネータ: &a.jlemon;</para> + </listitem> + + <listitem> + <para>Int13 vm86 ディスクドライバの実装. コーディネータ: + &a.hackers;</para> + </listitem> + + <listitem> + <para>カーネル問題. 全体コーディネーション: + &a.hackers;</para> + + <itemizedlist> + <listitem> + <para>すべての現存ドライバの eisaconf 変換の達成.</para> + </listitem> + + <listitem> + <para>すべての割り込みルーチンを + ユニット番号を使う代わりに (void *) を + 取るように変更.</para> + </listitem> + + <listitem> + <para>EISA/PCI/ISAの割り込み登録コードの統合.</para> + </listitem> + + <listitem> + <para>PCI/EISA/ISA デバイス検出を bt742a.c(WIP) + のようなドライバから分割.</para> + </listitem> + + <listitem> + <para>syscons の ALT-Fn/vt 切替えによるハングの修正. + コーディネータ: &a.sos;</para> + </listitem> + + <listitem> + <para>3c509と3c590 ドライバの統合 (本質的には PCI + デバイス検出の ep.c への提供).</para> + </listitem> + </itemizedlist> + </listitem> + </orderedlist> + </sect2> + + <sect2> + <title>優先度がさほど高くないタスク</title> + + <para>次のタスクはやっておくべきではありますが, + 特にさし迫っているわけで はありません:</para> + + <orderedlist> + <listitem> + <para>MCA サポート? + これは続けるにしても止めてしまうにしても結論を出 + すべき.</para> + </listitem> + + <listitem> + <para>完全な KLD ベースのドライバのサポート / + コンフィグレーションマネー ジャ.</para> + + <itemizedlist> + <listitem> + <para>ld なしですべての LKM + の登録をおこなう方法を考案する. これは + カーネル中にある種のシンボルテーブルを + 持たせることを意味します.</para> + </listitem> + + <listitem> + <para>穏やかな方法でハードウェアを検知する + コンフィグレーションマネージャ の作成 + (第3ステージ・ブートの中に?). ハードウェアが必要とする + KLD だけを 残す等.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>PCMCIA/PCCARD. コーディネータ: &a.msmith; と &a.phk;</para> + + <itemizedlist> + <listitem> + <para>ドキュメンテーション!</para> + </listitem> + + <listitem> + <para>pcic ドライバの信頼性のある操作 (テスト要).</para> + </listitem> + + <listitem> + <para><filename>sio.c</filename> + のリコグナイザとハンドラ (ほぼ完了).</para> + </listitem> + + <listitem> + <para><filename>ed.c</filename> のリコグナイザとハンドラ + (ほぼ完了).</para> + </listitem> + + <listitem> + <para><filename>ep.c</filename> のリコグナイザとハンドラ + (ほぼ完了).</para> + </listitem> + + <listitem> + <para>User-mode のリコグナイザとハンドラ + (部分的に完了).</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>先進的なパワーマネージメント. コーディネータ: &a.nate; + と &a.phk;</para> + + <itemizedlist> + <listitem> + <para>APM サブドライバ (ほぼ完了).</para> + </listitem> + + <listitem> + <para>IDE/ATA ディスクサブドライバ (部分的に完了).</para> + </listitem> + + <listitem> + <para>syscons/pcvt サブドライバ.</para> + </listitem> + + <listitem> + <para>PCMCIA/PCCARD ドライバ群との統合 (サスペンド / + レジューム).</para> + </listitem> + </itemizedlist> + </listitem> + </orderedlist> + </sect2> + + <sect2> + <title>優先度の低いタスク</title> + + <para>次のタスクは全くのあら隠し, + または誰もすぐにおこないそうもない投資 + のような仕事を表します:</para> + + <para>最初の20項目は Terry Lambert + <email>terry@lambert.org</email> からのもので す.</para> + + <orderedlist> + <listitem> + <para>プロセッサ上で V86 モードを使用して, + プロテクトモードからの BIOS コールができるようにし, + マップされた割り込み IPC 機構を経由してプロテ + クトモードの呼出し元に結果を返すようにする.</para> + </listitem> + + <listitem> + <para>DOS と同じように, + 実際の下位ハードウェアから独立になるよう, BIOS + コール機構を使用したカーネルの中に組み込まれたドライバ. + これは DOS ベー スのローダプログラムで BSD + がロードされる前に DOS にロードされていたネッ + トワークドライバや ASPI ドライバも含みます. + このことは潜在的なポーリン グ, + つまりプロテクトモードカーネルによる V86 マシンのための + DOS-not-busy 割り込みの生成を意味します.</para> + </listitem> + + <listitem> + <para>ハードウェア固有のプロテクトモードの + ドライバがロードされて活性化 された後で, + デフォルトのカーネル実行形式の中の, そのようなドライバデー + タとテキストエリアを追跡して, + カーネルアドレス空間のその部分が回復され + るようにするためのイメージ形式. これは個々の BIOS + ベースのドライバを互いに分離することを含みます. なぜ + なら全く実行しないよりも, すべてのケースにおいて BIOS + ベースのドライバ と共に実行した方が良いためです.</para> + </listitem> + + <listitem> + <para>バスインタフェース機構の抽象化. 現在のところ, PCMCIA, + EISA そし て PCI バスはブリッジで ISA + バスに接続されていると仮定しています. こう + いった仮定はおこなうべきではありません.</para> + </listitem> + + <listitem> + <para>パワーマネージメントイベント, カードの挿入, 取り出し, + そしてバス (PNPISA と PCMCIA とのブリッジチップ) + 対カードのレベルのイベント管理を 含む PNP + イベントを解釈するコンフィグレーションマネージャ.</para> + </listitem> + + <listitem> + <para>固定デバイスによる他の再割当可・不可の + デバイス空間リソースの使用 と衝突しない, + 再割当可能なアドレスの割り当てのためのトポロジカルソート + 機構.</para> + </listitem> + + <listitem> + <para>ハードウェアサービス登録のための登録ベースの機構. + 特にタイマ, サウンドおよび他の + システムクリティカルなサービス供給源のためのデバイス + 中心の登録機構. + 単一の独立していないサービス供給源の一つの例として + Timer2, Timer0 + そしてスピーカサービスを考慮する必要があります.</para> + </listitem> + + <listitem> + <para>ネットワークカードと一緒に提供される ODI + カードドライバを使用で きるようにする, NetWare サーバ + (プロテクトモードの ODI ドライバ) ロー ダとサブサービス. + NDIS ドライバと NetWare の SCSI ドライバについても同 + 様.</para> + </listitem> + + <listitem> + <para>前のリビジョンの FreeBSD マシンではなく, Linux + マシンで動作する 「アップグレード + システム」オプション.</para> + </listitem> + + <listitem> + <para>移植を簡単にするためと, X, ThinkPad, PS/2マウス, LED, + コンソール スイッチング, しつこい NumLock + などの問題を全部一度に片付けるためのコ + ンソールドライバの抽象レイヤへの分割.</para> + </listitem> + + <listitem> + <para>機会が許したら, + 他の外部ドライバのための他のカーネルのエミュレー + ション環境. SCO と Solaris は UnixWare + などに続く良い候補です.</para> + </listitem> + + <listitem> + <para>異なるアーキテクチャのバイナリの実行のための + プロセッサエミュレーション環境. + これはシステムコールインタフェースがあまり変わらなければ, + 思ったより簡単です.</para> + </listitem> + + <listitem> + <para>商用のストリームドライバを使用可能にするための + ストリーム機構.</para> + </listitem> + + <listitem> + <para>カーネルのマルチスレッド化 + (カーネルのプリエンプションが必要).</para> + </listitem> + + <listitem> + <para>カーネルのプリエンプション付き対称マルチプロセッシング + (カーネル のプリエンプションが必要).</para> + </listitem> + + <listitem> + <para>ポータブルコンピュータのサポートにおける協調の試み. + これは PCMCIA + ブリッジング規則と電源管理イベント処理の変更により, いく + らかは処理できます. しかし, + 内蔵ディスプレイと外部ディスプレイの検出, この 2 + 種類のディスプレイがあるという事実に基づく + 異なる解像度の選択, マシンがドックにある場合には + ディスクのモータ停止を防止すること, マシンの + ブート能力に影響を与えずにドックベースのカードの消滅を + 可能にすること (PCMCIA と同じ問題) + などの問題があります.</para> + </listitem> + + <listitem> + <para>マルチプラットフォームへの移植のための + ソースツリーの再組織化.</para> + </listitem> + + <listitem> + <para><command>make + world</command>できちんと「世界を創造する」 + ができるようにする. (もし<command>make + regress</command>(訳注: 後退する)と呼び方が適当であれば, + そのように 名前を変える)</para> + </listitem> + + <listitem> + <para>最小必要メモリ 4MB 化 (もっと小さければなお良し!).</para> + </listitem> + </orderedlist> + </sect2> + + <sect2> + <title>もっと簡単なタスク</title> + + <para>上のセクションで挙げたタスクは膨大な時間の投資または + FreeBSD のカーネルに関する深い知識を必要とします + (もしくはそのどちらも). しかしながら, + "週末ハッカー"やプログラミングのスキルを持 + たない人々に適した立派なタスクも数多くあります.</para> + + <orderedlist> + <listitem> + <para>FreeBSD-current を運用しており, + 状態の良いインターネット接続があ るならば, <hostid + role="fqdn">current.freebsd.org</hostid> + という一日に一回フルリリースを行っている マシンがあります + — 時おり最新のリリースをそこからインストールし, その + 過程で何か問題があるなら報告して下さい.</para> + </listitem> + + <listitem> + <para><email>freebsd</email>-bugs + メーリングリストを読んでください. そこではあなたが建 + 設的なコメントを付けたりテストできるパッチが + 提供されているような問題がある かもしれません. + もしくはそれらの問題の一つをあなた自身で修正することさえ + できるかもしれません.</para> + </listitem> + + <listitem> + <para>定期的に FAQ とハンドブックを通して読んでみてください. + もしまずい説明や古い事柄や完全に間違っていることなどが + あれば我々に しらせて下さい. + さらに良いのは我々に修正案を送ることです (SGML + は学ぶのにそれほど難しくありませんが, + プレインテキストでも問題は ありません).</para> + </listitem> + + <listitem> + <para>(もしまだないならば) FreeBSD + のドキュメントを自分の母国語に翻訳 + するのを手伝ってください — + 作業している人がいるかどうか &a.doc; にメールを + 送って聞くだけです. とはいっても, + そうすることによってあなたが全ての FreeBSD + ドキュメントの翻訳に携わるように + なるというわけではないですから ね — 実際, + もっとも翻訳が必要とされているドキュメントはインストール方 + 法です.</para> + </listitem> + + <listitem> + <para>たまに(もしくは定期的に) freebsd-questions + メーリングリストや + <literal>comp.unix.bsd.freebsd.misc</literal> + を読んでください. これは, あなたの持ってい + る専門知識を共有したり誰かが抱えている問題を + 解決するのに非常に有効な ものになり得ることです. + 時にはあなた自身で新しいことを学ぶことさえ + できるかもしれません. + これらのフォーラムはやるべきことのアイディア + の源にもなり得るのです.</para> + </listitem> + + <listitem> + <para>-current に正しく当てられるがしばらく経っても(通常は + 2, 3 週間) -stable + に取り込まれてないようなバグフィックスがあるならば + コミッターに 丁寧に思い出させてください.</para> + </listitem> + + <listitem> + <para>寄贈ソフトウェアをソースツリーの + <filename>src/contrib</filename> + に移動させてください.</para> + </listitem> + + <listitem> + <para><filename>src/contrib</filename> + 以下のコードが最新のものであるか確認してください.</para> + </listitem> + + <listitem> + <para>2000 年問題に関するバグを探してください(そして, + 見つけたら修正してください!).</para> + </listitem> + + <listitem> + <para>ソースツリー全体(もしくはその一部)を, + 警告を詳細に報告するようにして構築してみてください. + そして警告が出ないようにしてください.</para> + </listitem> + + <listitem> + <para>ports で, gets() を使っているとか malloc.h + をインクルードしている + などといった警告が出ないようにしてください.</para> + </listitem> + + <listitem> + <para>もしなんらかの ports に関わっているなら, + あなたのパッチを作者に フィードバックしてください + (次のバージョンが出た時にあなたが楽になります).</para> + </listitem> + + <listitem> + <para>このリストに追加するタスクを提案して下さい!</para> + </listitem> + </orderedlist> + </sect2> + </sect1> + + <sect1> + <title>貢献の仕方</title> + + <para>一般的に, システムへの貢献は次の 6 + つのカテゴリの1つ以上に分類されます:</para> + + <sect2 id="contrib-general"> + <title>バグ報告と一般的な論評</title> + + <para>報告するべきバグがあったり, 提案したいことがあれば:</para> + + <para><emphasis>一般的な</emphasis> + 技術的関心事に関するアイデアや提案は &a.hackers; + へメールしてください. 同様に, このような事柄に興味のある + (そして<emphasis>膨大な</emphasis>メール! に耐えられる) 人は, + &a.majordomo; へメールを送って hackers + メーリングリストに参加すると良いでしょう. 情報については + <link linkend="eresources-mail">メーリングリスト</link> + を参照してください.</para> + + <para>バグを発見したり変更を送付しようとしている場合は + &man.send-pr.1; プログラムか <ulink + URL="http://www.freebsd.org/send-pr.html">WEB ベースの + send-pr</ulink> を使用して報告してください. + バグレポートの各項目を埋めるようにしてください. 65KB + を超えるのでなければ, レポート中に直接 + パッチを入れてくださって結構です. 20KB を超える場合は, + それらを compress して &man.uuencode.1; + することも検討してください. とても大きくなる場合は <ulink + url="ftp://ftp.FreeBSD.ORG/pub/FreeBSD/incoming/"> + ftp.freebsd.org:/pub/FreeBSD/incoming/</ulink> + を利用してください. + </para> + + <para>レポートがファイリングされれば, バグ報告の確認と + トラッキング番号をメールで受け取るはずです. + このトラッキング番号を覚えておき, 問題に関する詳細情報を + <email>bug-followup@FreeBSD.ORG</email> に + メールで送って更新できるようにしてください. 例えば + <literal>"Re: kern/3377"</literal> のように, + この番号をサブジェクト行に使用してください. + すべてのバグレポートの追加情報は, + この方法で送付されなければいけません.</para> + + <para>もしタイムリに (あなたの電子メール接続形態にもよりますが, + 3日から 1週間) 確認を受けとれないとか, 何らかの理由で + &man.send-pr.1; コマンドが 使用できない場合には, &a.bugs; + へメールを送り, 誰か代りにバグ報告を + 送付してもらうようたずねてください.</para> + </sect2> + + <sect2> + <title>文書の変更</title> + + <para>文書の変更は &a.doc; が監督しています. <link + linkend="contrib-general">バグ報告と一般的な論評</link> + に記述されているように <command>send-pr</command> + コマンドを使用して, 提案や変更 + (どんな些細なものでも歓迎します!) を送ってください.</para> + </sect2> + + <sect2> + <title>現存のソースコードの変更</title> + + <para>現存のソースコードへの追加または変更は, + いくらかトリッキーな仕事で あり, core の FreeBSD + 開発の現状にあなたがどれだけ通じているかに大 きく依存します. + “FreeBSD-current”として知られる FreeBSD の特別な + 継続的リリースがあります. FreeBSD-current + は開発者の積極的な活動の 便宜のために, + 色々な方法で利用可能になっています. FreeBSD-current + の入手と使用方法についての詳しい情報については <link + linkend="current">最新の FreeBSD を追いかける</link> + を参照してください.</para> + + <para>不幸にして古いソースをもとに仕事をすることは, + 時々あなたの変更が時 代遅れ, または FreeBSD + への簡単な再統合に合わなくなっていることを意 味します. + システムの現状に関する議論がおこなわれている &a.announce; と + &a.current; へ参加することで, + この可能性を最小限にすることができます.</para> + + <para>完全な最新のソースを変更のベースにできることが + 確実になったと仮定し て, 次のステップは FreeBSD + の保守担当者へ送る差分ファイルの生成です. これは &man.diff.1; + コマンドを使用しておこないますが, “context + diff”形式が好まれるようです. 例えば:</para> + + <screen>&prompt.user; <userinput>diff -c oldfile newfile</userinput></screen> + + <para>または</para> + + <screen>&prompt.user; <userinput>diff -c -r olddir newdir</userinput></screen> + + <para>これで指定されたソースファイルまたはディレクトリ階層に + 対するコンテ キスト形式の差分が生成されます. 詳しい説明は + &man.diff.1; のマ ニュアルページを参照してください.</para> + + <para>差分ファイル (&man.patch.1; コマンドでテストできます) + を作ったら, それらを FreeBSD + に含めてもらうようメールで送ってください. <link + linkend="contrib-general">バグ報告と一般的な論評</link> + に記述されているように &man.send-pr.1; + コマンドを使用してください. 差分ファイルだけを &a.hackers; + へ送ってはいけません. 途方にくれてしまいます! + 私たちは多忙なので, あなたの提案に大変感謝します + (これはボランティアのプロジェクトです!). + すぐに取りかかることはできませんが, 処理されるまでは ちゃんと + pr データベースに残っています.</para> + + <para>あなたがそうした方がいいと思う場合 (例えば, + ファイルの追加, 削除または名称変更など), 変更を + <command>tar</command> ファイルにまとめ, &man.uuencode.1; + プログラムにかけてください. Shar + アーカイブも歓迎します.</para> + + <para>例えばあなたがそれ自身のさらなる配布を管理する + コピーライト問題を良 く分かっていないとか, + 単に厳しいレビューをおこなっておらず, リリース + する準備ができていないなど, + あなたの変更が潜在的に不安定な性質をも つものである場合, + &man.send-pr.1; で送付するよりむしろ &a.core; + へ直接送ってください. コアチームメーリングリスト宛のメールは, + 日々の仕 事のほとんどを FreeBSD でおこなっている人たちの, + より小さなグルー プに届きます. + このグループもまた<emphasis>とても忙しい</emphasis> + ことに注意し て, 本当に必要な場合にコアチームの彼らにメールを + 送るだけにしてください.</para> + + <para>コーディングスタイルに関する情報は <command>man 9 + intro</command> および <command>man 9 style</command> + を参照してください. コードを提出する前には, + 少なくともこの情報を意識しておいてくださるようお願いします. + </para> + </sect2> + + <sect2> + <title>新たなコードやメジャーな付加価値の高いパッケージ</title> + + <para>重要な大きい仕事の寄贈や, 重要な新しいフィーチャーを + FreeBSD に追加 する稀な場合には, 変更点を tar/uuencode + したファイルにして送るか, それらを私たちの ftp サイト <ulink + URL="ftp://ftp.FreeBSD.ORG/pub/FreeBSD/incoming"> + ftp://ftp.FreeBSD.ORG/pub/FreeBSD/incoming</ulink> + へアップロードす ることのどちらかが通常必要になります.</para> + + <para>大量のコードを伴った仕事の場合, + コピーライトの神経過敏な問題が常に 出てきます. FreeBSD + に含めるコードのコピーライトとして受け入れるこ とができるのは, + 以下の二つです:</para> + + <orderedlist> + <listitem> + <para>BSD コピーライト. + このコピーライトは“権利に縛られない”性格 + と商用企業にとって一般的な魅力をもつために最も好まれま す. + FreeBSD プロジェクトは商用利用を阻んだりせず, 何かを + FreeBSD + へ投資する気になった商業関係者による参加を積極的に奨励 + します.</para> + </listitem> + + <listitem> + <para>GNU一般公有使用許諾, または“GPL”. + このライセンスはコード + を商用目的に使用する場合に余分な努力が求められるため, + 私たち にあまり評判が良いというわけではありません. しかし, + 私たちは 既に GPL 下の高品質なコード (コンパイラ, + アセンブラ, テキスト フォーマッタ等) の提供を受けており, + 私たちは現在それを必要と しています. そのため, + このライセンスによる新たな貢献を拒絶す + るというのは愚かなことでしょう. GPL + 下のコードはソースツリー の別の部分, 現在のところ + <filename>/sys/gnu</filename> か + <filename>/usr/src/gnu</filename> に入っています. + そのため, GPL が問題と なるような人は, + 誰でも簡単にそれとわかるようになっています.</para> + </listitem> + </orderedlist> + + <para>これ以外のタイプのコピーライトによる寄贈は, FreeBSD + へ含めることを 考慮する前に, + 注意深いレビューを受けなければなりません. 作者が独自 + のチャネルを通して配布しており, + そのような変更をおこなうことを常に 奨励している場合でも, + 特に限定的な商用のコピーライトが適用される寄 + 贈は一般に拒否されます.</para> + + <para>あなたの作品に “BSD-スタイル” + のコピーライトを付けるには, 保護した + いソースコードファイルすべての一番最初に + 以下のテキストを入れて, <literal>%%</literal> + の間を適切な情報に置き換えください.</para> + + <programlisting> +Copyright (c) %%適切な年%% + %%あなたの名前%%, %%あなたの州%% %%郵便番号%%. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer as + the first lines of this file unmodified. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY %%あなたの名前%% ``AS IS'' AND ANY EXPRESS OR +IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +IN NO EVENT SHALL %%あなたの名前%% BE LIABLE FOR ANY DIRECT, INDIRECT, +INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + $Id$</programlisting> + + <para>便宜をはかるため, + このテキストのコピーは次の場所に置いてあります. + <filename>/usr/share/examples/etc/bsd-style-copyright</filename>. + </para> + + <para>(訳注: 以下は神田敏広氏より寄贈された bsd-style-copyright + の日本語訳です. + ソースファイルに含めるものは原文の方であることに注意して + ご利用ください. また, 原文との間に趣旨の差異が生じた場合, + 原文の内容が FreeBSD プロジェクトの + 意思であるものとします.)</para> + + <programlisting> +Copyright (C) [年] + [あなたの名前] All rights reserved. + +ソースとバイナリ形式の再配布および使用は, 変更の有無にかかわらず以下の +条件を満たす場合に限り許可される: +1. ソースコードの再配布は, 上記の著作権表示・この条件のリスト・下記の + 否認声明文を保持しなければならない. + +2. バイナリ形式の再配布は, 上記の著作権表示・この条件のリスト・下記の + 否認声明文を, 配布物と共に提供される文書および/または他の資料の中に + 含めなければならない. + +(訳注:ここから「否認声明文」です) + +このソフトウェアは[あなたの名前]および貢献者によって ``あるがままの状態'' +で提供され, 商品性と特定の目的に対する適合性についての暗黙の保証に留ま +らず, いかなる明示および暗黙の保証を認めない. [あなたの名前]および貢献 +者は, あらゆる直接的・間接的・偶発的・特殊的・典型的・必然的な損害 (代 +替製品または代替サービスの獲得費; 効用・データ・利益の喪失; または業務 +中断を含み, またそれだけに留まらない損害) に対して, たとえどのようにし +て生じたとしても, そしてこのソフトウェアの使用によってどのようにであれ +生じる, 契約上であろうと, 厳密な責任内であろうと, あるいは不正行為 (過 +失やそうでない場合を含む) における場合であろうとも, いかなる責任論上も, +たとえそのような損害の可能性が予見されていたとしても, 一切の責任を持た +ない. + +翻訳: 神田敏広 +御協力 (五十音順・敬称略): + 池田研二, 内川 喜章, 藤村 英治, むらたしゅういちろう + 杢野 雅一, 横田@宇都宮 + </programlisting> + </sect2> + + <sect2 id="porting"> + <title>自分で port を作る</title> + + <para><emphasis>原作: &a.jkh;, &a.gpalmer;, &a.asami;, + &a.obrien; and &a.hoek;. 28 August 1996.</emphasis></para> + + <para><emphasis>訳: &a.jp.simokawa;, &a.asami;.<!-- <br> --> + 10 November 1996.</emphasis></para> + + <para>自分で port を作ることに興味がありますか, すばらしい!</para> + + <para>これから, FreeBSD 用のportを作る際の, + いくつかのガイドラインを 説明します. + 実際にportをコンパイルするときのほとんどの仕事は + <filename>/usr/share/mk/bsd.port.mk</filename> + というファイルでおこないます. + Portsコレクションについてのさらに細かい内部の働きについては, + そちらの ファイルを参照してください. + これにはコメントが細かく書いてありますので, Makefile + を読むのにあまり慣れていない人でも, 得るものはとても大きいで + しょう.</para> + + <note> + <para>ここでは, 変更可能な変数の一部についてのみ記述しています. + ほとんどの変数は<filename>bsd.port.mk</filename> + の始めに記述があります. + また, このファイルは非標準のタブの設定になっています. + <application>Emacs</application> や <application>Vim</application> + はファイルのロード時にこれを認識しますが, + <command>vi</command>や<command>ex</command>では, + ファイルをロードしたら <command>:set tabstop=4</command> + のようにして正しい値を設定する + ことができます.</para> + </note> + + <sect3> + <title>3分porting</title> + + <para>この節では, 簡単なportの方法について説明します. + 多くの場合これ では不十分ですが, + まあうまくいくかどうか試してみて損はないでしょ う.</para> + + <para>まず, 元のtarファイルを<makevar>DISTDIR</makevar>に置きます. + デフォルトは<filename>/usr/ports/distfiles</filename>です.</para> + + <note> + <para>以下では, + ソフトウェアはそのままコンパイルされるとします. つまり, + FreeBSDのマシンで動かすために, 変更がまったく必要ない + とします. + もしなにか変更が必要な場合には次の節も参照する必要 + があります.</para> + </note> + + <sect4> + <title><filename>Makefile</filename> の作成</title> + + <para>最小限の<filename>Makefile</filename> + は次のようなものです:</para> + + <programlisting> +# New ports collection makefile for: oneko +# Version required: 1.1b +# Date created: 5 December 1994 +# Whom: asami +# +# $Id$ +# + +DISTNAME= oneko-1.1b +CATEGORIES= games +MASTER_SITES= ftp://ftp.cs.columbia.edu/archives/X11R5/contrib/ + +MAINTAINER= asami@FreeBSD.ORG + +MAN1= oneko.1 +MANCOMPRESSED= yes +USE_IMAKE= yes + +.include <bsd.port.mk></programlisting> + + <para>おわかりになりますでしょうか. + <literal>$Id$</literal>があ る行の内容については, + 気にしないでください. これはこのファイル + がportsツリーに書き込まれるときにCVSによって自動的に書 + き込まれます. もっと詳しい例が見たければ, <link + linkend="porting-samplem">Makefileのお手本</link> + の節をご覧ください.</para> + </sect4> + + <sect4> + <title>Package記述ファイルの作成</title> + + <para>どのようなportでも, packageにするしないに関わらず, 3つ + の記述ファイルが必要です. + <filename>pkg</filename>サブディレクトリにある, + <filename>COMMENT</filename>, <filename>DESCR</filename>, + それに <filename>PLIST</filename>です.</para> + + <sect5> + <title><filename>COMMENT</filename></title> + + <para>これには, そのportについての説明を1行で書きます. + Package の名前, バージョン番号等は + <emphasis>含めない</emphasis>でください. たとえば, + こんな具合です:</para> + + <programlisting> +A cat chasing a mouse all over the screen.</programlisting> + </sect5> + + <sect5> + <title><filename>DESCR</filename></title> + + <para>これは, そのソフトウェアについての, + すこし長い説明を記述します. その port + が何をするのかについての数段落程度の + 簡潔な解説があれば十分です. + このファイルはマニュアルでもなければ, + 使用方法やコンパイル方法についての細かい + 説明書でもありません. 特に, + <emphasis><filename>README</filename>ファイル manpage + をコピーしようとしてしている場合には + 注意してください</emphasis>. これらは多くの場合, + そのポートの簡潔な説明に なっていなかったり, + 扱いにくい形式(manpage の場合, + 行を揃えるために空白が調整されます)になっていたりします. + もしこのソフトウエアに公式の WWW のホームページがあれば, + ここに書いて下さい.</para> + + <para>このファイルの最後にあなたの名前を書くことが + 推奨されています. たとえば, こんな具合です.</para> + + <programlisting> +This is a port of oneko, in which a cat chases a poor mouse all over +the screen. + : +(うんぬん.) + +http://www.oneko.org/ + +- Satoshi +asami@cs.berkeley.edu</programlisting> + </sect5> + + <sect5> + <title><filename>PLIST</filename></title> + + <para>このファイルには, + このportによってインストールされるファ + イルが列挙されます. このファイルはpackageを作る際のリス + トとして使われるため, `packing list' とも呼ばれます. + ここ に書かれているファイル名は, + インストール時のプレフィックス (普通は + <filename>/usr/local</filename> か + <filename>/usr/X11R6</filename>) からの 相対パスです. + <makevar>MAN<replaceable>n</replaceable></makevar> + 変数を使用する場合(使用することが推奨されています)には, + マニュアルはここに入れないでください.</para> + + <para>簡単な例を載せておきましょう:</para> + + <programlisting> +bin/oneko +lib/X11/app-defaults/Oneko +lib/X11/oneko/cat1.xpm +lib/X11/oneko/cat2.xpm +lib/X11/oneko/mouse.xpm +@dirrm lib/X11/oneko</programlisting> + + <para>'Packing list'の詳細については, &man.pkg.create.1; + の マニュアルを参照してください. + すべてファイルを列挙しなければなりませんが, + ディレクトリ名は必要ありません. また, ports + がインストール時にディレクトリを作成する場合には, + <literal>@dirrm</literal> の行を加えて, その port + が削除されるとき, + そのディレクトリも削除されるようにしてください. </para> + + <para>このファイルには, + ファイル名をアルファベット順に並べるようにしてください. + port のアップグレートのとき, + 楽に確認ができるようになります.</para> + </sect5> + </sect4> + + <sect4> + <title>チェックサムファイルの作成</title> + + <para>ただ, <command>make makesum</command> + と入力するだけです. <filename>bsd.port.mk</filename> + にルールがあるので, + 自動的に<filename>files/md5</filename>が生成されます.</para> + </sect4> + + <sect4 id="porting-testing"> + <title>Portのテスト</title> + + <para>そのportが正しく動くことを, + package化を含めて確認してください. + 以下の重要なポイントを確認してください.</para> + + <itemizedlist> + <listitem> + <para><filename>PLIST</filename> にその port + がインストールしないものが含まれていないこと.</para> + </listitem> + + <listitem> + <para><filename>PLIST</filename> にその port + がインストールする全てのものが含まれていること.</para> + </listitem> + + <listitem> + <para><maketarget>reinstall</maketarget> + ターゲットを使うことによって, + 何度でもインストールが可能こと.</para> + </listitem> + + <listitem> + <para>deintall の際に <link + linkend="porting-cleaning">後片付け</link> + をすること.</para> + </listitem> + </itemizedlist> + + <procedure> + <title>推奨されるテストの手順</title> + + <step> + <para><command>make install</command></para> + </step> + + <step> + <para><command>make package</command></para> + </step> + + <step> + <para><command>make deinstall</command></para> + </step> + + <step> + <para><command>pkg_add `make package-name`</command></para> + </step> + + <step> + <para><command>make deinstall</command></para> + </step> + + <step> + <para><command>make reinstall</command></para> + </step> + + <step> + <para><command>make package</command></para> + </step> + </procedure> + + <para><maketarget>package</maketarget> および + <maketarget>deinstall</maketarget> の段階で, + どんな警告(warning)も出力されないことを確認してください. + ステップ3の後, + 新しいディレクトリが全て正しく消去されているかを + 確認してください. また, + ステップ4の後にそのソフトウェアを使用してみて, package + からインストールされた場合に正しく動作するかを + 確認してください.</para> + </sect4> + + <sect4 id="porting-portlint"> + <title><command>portlint</command> でチェック</title> + + <para><command>portlint</command>を使って, あなたの port + が我々のガイドラインそっているかを確認してください. + <command>portlint</command> プログラムは ports + コレクションに含まれています. 特に, <link + linkend="porting-samplem">Makefile</link> + が正しい形式になっているか, <link + linkend="porting-pkgname">package</link> + の名前が正しいか, をチェックするのに良いでしょう.</para> + </sect4> + + <sect4 id="porting-submitting"> + <title>Portの送付</title> + + <para>まず, <link + linkend="porting-dads">やってよいことといけないこと</link> + についての節を読んでください.</para> + + <para>さあ, あなたのportに満足したら, + あとはそれをFreeBSDのメイ ンのportsツリーに置いて, + 皆に使ってもらうだけです. いまある + <filename>work</filename> ディレクトリや + <filename>pkgname.tgz</filename> + パッケージは必要ありませんから, まず消去してください. + あとは, バグレポートの中に <command>shar `find + port_dir`</command> の出力を, &man.send-pr.1; + プログラムを使用して送ってください. &man.send-pr.1; + についての詳細は, <link + linkend="contrib-general">バグ報告と一般的な論評</link> + を参照してください.) もし, 圧縮していない状態で, + 20KB以上あるようなポートであれば, 圧縮して tar + ファイルにして, バグレポートに入れる前に &man.uuencode.1; + を使用してください. (20KB以下のものでも, tar + ファイルにして送ってもよいですが, あまり歓迎されません). + バクレポートの category は <literal>ports</literal>, class + は + <literal>change-request</literal>を必ず使用してください. + (レポートを <literal>confidential</literal> (内密) + にしないようにしてください!)</para> + + <para>もう一度, <emphasis>オリジナルのソースファイル, + <filename>work</filename> ディレクトリ, <command>make + package</command> + で作成したパッケージが含まれていないこと + </emphasis>を確認してください.</para> + + <note> + <para>以前, 新しい port をわれわれの ftp サイト (<hostid + role="fqdn">ftp.freebsd.org</hostid>) + にアップロードするようにお願いしたことがありますが, + 現在このサイトの <filename>incoming</filename> + ディレクトリは読み出し不可になっており, + いまでは推奨されていません. + 沢山の海賊版ソフトウェアがそこに置かれたためです.</para> + </note> + + <para>私たちは, 何か不明な点があったらあなたに確認したのち, + それをツリーへ置きます. あなたの名前は, FreeBSD + ハンドブックやその他のファイルの “Additional FreeBSD + contributors” のリストにも載るでしょう. う〜ん, + 素晴らし い. <!-- smiley -->:)</para> +<!-- kuriyama - should use link tag? --> + </sect4> + </sect3> + + <sect3> + <title>本格的なport</title> + + <para>残念ながら, 移植がそう簡単ではなく, + 動かすために多少の変更が 必要な場合も多いでしょう. + この節では, portsコレクション の方法論にのっとって, + そのような場合にどのように変更を施し, 動 + くようにしたらよいかを順を追って説明します.</para> + + <sect4> + <title>port構築の詳細</title> + + <para>まず, あなたがportのディレクトリで + <command>make</command> とタイ + プしてから起こる一連の出来事について,順を追って説明しま + す. ここを読むときには, 他のウィンドウで同時に + <filename>bsd.port.mk</filename> + も開いておくとよいかもしれません.</para> + + <para>しかし, + <filename>bsd.port.mk</filename>が何をしているのか, + 完全に理解 できなくても心配する必要はありません. + そう多くの人が理解して いるわけではないですから... <!-- + smiley --><emphasis>f(^_^;)</emphasis></para> + + <procedure> + <step> + <para>まず, <maketarget>fetch</maketarget> + というターゲットが実行されます. + この<maketarget>fetch</maketarget>ターゲットは + ローカルディスクの<makevar>DISTDIR</makevar>に配布ファ + イルがあるようにするのが役目です. もし, + <maketarget>fetch</maketarget>が必要なファ + イルを<makevar>DISTDIR</makevar>に見つけることが + できなけ れば, Makefileに指定されているURL + <makevar>MASTER_SITES</makevar>, + そして私たちのFTPサイトで ある <ulink + URL="ftp://ftp.freebsd.org/pub/FreeBSD/ports/distfiles/"> + ftp://ftp.freebsd.org/pub/FreeBSD/ports/distfiles/</ulink> + (ここ には, 私たちが取ってきたファイルを + バックアップとして置いてあ ります) に探しにいきます. + そして, ユーザのサイトがインター ネットに + 直接接続されている場合には, <makevar>FETCH</makevar> + を使って, その名前のファイルを取っ てきて, + <makevar>DISTDIR</makevar>に保存します.</para> + </step> + + <step> + <para>次に実行されるのは + <maketarget>extract</maketarget> ターゲットです. + これは, <makevar>DISTDIR</makevar>にある, 配布ファイル + (普通は gzipされたtarファイル) を読み, + ソースを一時的な作業ディレ + クトリ<makevar>WRKDIR</makevar> (デフォルトは + <filename>work</filename>) に展開します.</para> + </step> + + <step> + <para>次に, <maketarget>patch</maketarget> + というターゲットが実行されます. まず, + <makevar>PATCHFILES</makevar>に定義されている, + すべてのパッ チをあてます. + 次にもし<makevar>PATCHDIR</makevar> (デフォ ルトは + <filename>patches</filename> サブディレクトリ) + にパッチが存在す れば, + これらをアルファベット順にあてます.</para> + </step> + + <step> + <para>次に実行されるターゲットは + <maketarget>configure</maketarget>です. これには, い + ろいろな場合があります.</para> + + <orderedlist> + <listitem> + <para>もし存在すれば, + <filename>scripts/configure</filename> + が実行されます.</para> + </listitem> + + <listitem> + <para>もし, <makevar>HAS_CONFIGURE</makevar> + あるいは <makevar>GNU_CONFIGURE</makevar> + がセットされていれば, + <filename><makevar>WRKSRC</makevar>/configure</filename> + が実行されます.</para> + </listitem> + + <listitem> + <para>もし, <makevar>USE_IMAKE</makevar> + がセットされていれば, <makevar>XMKMF</makevar> + (デフォルト: <command>xmkmf -a</command>) + が実行されます.</para> + </listitem> + </orderedlist> + </step> + + <step> + <para>最後に, <maketarget>build</maketarget> + というターゲットが実行されます. これは, その port + の専用の作業ディレクトリ (<makevar>WRKSRC</makevar>) + にい き, コンパイルするのが役目です. もし + <makevar>USE_GMAKE</makevar> がセットされていれば, GNU + <command>make</command> が使用されます. + さもなければFreeBSDの <command>make</command> + が使用されます.</para> + </step> + </procedure> + + <para>上記はデフォルトのルールです. さらに, + <maketarget>pre-<replaceable>何とか + </replaceable></maketarget>や + <maketarget>post-<replaceable>何とか</replaceable></maketarget> + というターゲット が定義してあったり, + そのような名前のスクリプトが + <filename>scripts</filename> サブディレクトリに + 置いてある場合には, それ らはデフォルトの動作の + 前後に実行されます.</para> + + <para>たとえば, <maketarget>post-extract</maketarget> + というターゲットがMakefile で定義されていて, + <filename>pre-build</filename> というファイルが, + <filename>scripts</filename> + サブディレクトリにあるとすると, + <maketarget>post-extract</maketarget>ターゲットは, + 通常の展開動作のあとに呼 び出され, + <filename>pre-build</filename> + スクリプトはデフォルトのコンパイ + ルのルールが実行される前に実行されます. + もし動作が簡単であれ ば, <filename>Makefile</filename> + のターゲットを使用することが推奨されています. な ぜならば, + そのportが何らかのデフォルトではない動作を必要とす + るのかどうかが一箇所にまとめて書いてあった方が他の人に + 理解しやす いからです.</para> + + <para>デフォルトの動作は <filename>bsd.port.mk</filename> の + <maketarget>do-<replaceable> 何とか + </replaceable></maketarget> + というターゲットでおこなわれます. たとえば, + portを展開するコマンドは, + <maketarget>do-extract</maketarget> + というターゲットにあります. もし, + デフォルトのターゲットに 不満があれば, + <maketarget>do-<replaceable> something + </replaceable></maketarget> というターゲッ + トを再定義することによって, + どのようにでも直すことができます.</para> + + <note> + <para>“メイン”のターゲット (例えば, + <maketarget>extract</maketarget>, + <maketarget>configure</maketarget>等) は, + すべての前段階が実行されていること を確認して, + 実際のターゲットやスクリプトを呼び出す以外のこと + はしません. + bsd.port.mkはこれらが変更されることは仮定してい + ませんので, もし, 例えば, 展開の仕方を直したいときには, + <maketarget>do-extract</maketarget> を直し, + 絶対に<maketarget>extract</maketarget>には手を + 触れないでください.</para> + </note> + + <para>これで, ユーザが <command>make</command> + と入力したときに何が起こ るのかが理解できたと思います. + では, 完璧なportを手順を追っ て作ってみましょう.</para> + </sect4> + + <sect4> + <title>オリジナルのソースの入手</title> + + <para>オリジナルのソースを, (普通は) + 圧縮されたtarファイルの形 (<filename> + <replaceable>foo</replaceable>.tar.gz</filename> + あるいは + <filename><replaceable>foo</replaceable>.tar.Z</filename>) + で入手して, それを <makevar>DISTDIR</makevar> + にコピーします. 可能なかぎり, 広 + く使われている<emphasis>主流の</emphasis> + ソースを使用するようにしてください.</para> + + <para>もし, ネットワークへの接続のよい FTP/HTTP + サイトを見つけるこ とができなかったり, + 頭にくるような非標準的な形式しか持ってい + ないサイトしか見つけられないときには, 自分で管理する確実な + ftp か http サーバ (たとえば, + あなたのホームページ)に置くこと ができます. + <makevar>MASTER_SITES</makevar> + に正しく反映されていることを確認してください.</para> + + <para>もしも, そのような都合の良く, + 安心な置き場所が見つけられない 場合(あなたが FreeBSD の + committer であれば, 自分の + <filename>public_html</filename> ディレクトリに置けます), + 私たちが, <!-- kuriyama - lack of tanslation --> + <filename> + ftp://ftp.FreeBSD.ORG/pub/FreeBSD/ports/distfiles/LOCAL_PORTS/ + </filename> に置き場所を提供できます. + この場所は, 変数 <makevar>MASTER_SITE_LOCAL</makevar> + を使って参照してください. + これについての問い合わせのメールは &a.ports へお願いします. + </para> + + <para>その port の配布ファイルが特に理由もなく, + しょっちゅう変る場合には, + 配布ファイルをあなたのホームページに置いて + <makevar>MASTER_SITES</makevar>の最初に入れてください. + こうすることによって, ユーザ利用する場合に + <errorname>checksum mismatch</errorname> + エラーが起るのを防ぎ, 我々の ftp + サイトの保守の負担を減らすことができます. もし, master + site がたった一つしかない場合には, + あなたのサイトにバックアップを置いて + <makevar>MASTER_SITES</makevar> + の2番目に加えてください.</para> + + <para>もし, + あなたのportに必要ないくつかの追加パッチがインター + ネット上で手に入るのならば, それらも取ってきて, + <makevar>DISTDIR</makevar> に置きます. もし, + それらがメイン + のソースのtarファイルとは別のサイトにあっても, + 心配する必要 はありません. + そのような状況にはちゃんと対応できるようになっ ています. + (以下の<link linkend="porting-patchfiles">PATCHFILESの記述 + </link>をご覧ください).</para> + </sect4> + + <sect4> + <title>Portの修正</title> + + <para>適当なディレクトリにtarファイルを展開して, + FreeBSDの最新の バージョン上で, + 正しくコンパイルできるために必要なあらゆる変 更を施します. + 最終的に処理は自動化するわけですから, 何をおこなっ + たかを<emphasis>注意深く記録しておきましょう</emphasis>. + あなたのport が完成した暁には, ファイルの削除, 追加, + 修正を含むすべての処 理が, + 自動化されたスクリプトやパッチファイルで + おこなえるようになっ ていないといけません.</para> + + <para>もし, あなたの port + のコンパイルやインストールのために必要 + な手作業があまりに多いようならば, Larry Wall の模範的な + <application>Configure</application> + スクリプトでも参考にしたほうがいいかもしれませ ん. + 新しいportsコレクションは, 最小のディスクスペースで, + 個々のportがエンドユーザにできるだけ“プラグ & + プレ + イ”の状態でmakeできることをめざしています.</para> + + <note> + <para>あなたが作成し FreeBSD の ports + に寄付されたパッチファイル, + スクリプトおよびその他のファイルは, + 明示的に記述されている場合 を除いては, + BSDの標準的な著作権条件によりカバーされていると見な + されます.</para> + </note> + </sect4> + + <sect4> + <title>パッチをあてる</title> + + <para>port + の過程で追加されたり変更されたファイルは再帰的diffで変 + 更点を取り出すことができます. パッチは適当にまとめて, + <filename>patch-<replaceable>xx</replaceable></filename> + という名前のファイルに入れてくだ さい. + <filename><replaceable>xx</replaceable></filename> + はパッチが適用される順番を示します — これらは, + <emphasis>アルファベット順</emphasis>, つまり + <literal>aa</literal> が 最初, つぎに + <literal>ab</literal> などとなります. これらのファイル + を<makevar>PATCHDIR</makevar>に置いておくと, + 自動的に適用さ れるようになっています. すべてのパッチは + <makevar>WRKSRC</makevar> (通常は, portのtarファイルが展 + 開されるところで, makeが実行されるところと同じです) + からの相 対パスになります. + 修正やアップグレードを容易にするため, 2つ + 以上のパッチが同じファイルを修正するのは避けてください. + (例, + patch-aaとpatch-abが共に<makevar>WRKSRC</makevar>/foobar.c + を修正する, など.)</para> + </sect4> + + <sect4> + <title>コンフィグレーション</title> + + <para>カスタマイズのために追加したいコマンドがあれば, + <filename>configure</filename> + という名前のスクリプトに入れて + <filename>scripts</filename> サブディレクトリに置きます. + 上で述べたよ うに, <filename>pre-configure</filename> + あるいは <filename>post-configure</filename> という + <filename>Makefile</filename> + のターゲットおよび/あるいはスクリプトで処理す + ることもできます.</para> + </sect4> + + <sect4> + <title>ユーザからの入力の扱い</title> + + <para>もし, そのportがビルド, コンフィグレーション, + インストー ルの際にユーザからの入力を必要とするならば, + Makefileで + <makevar>IS_INTERACTIVE</makevar>をセットしてください. + これによって, 深夜, + 自動的にたくさんのportをコンパイルすることが可能にな + ります. 環境変数<envar>BATCH</envar>がセットされていると + <symbol>IS_INTERACTIVE</symbol> + の定義されているportはスキップされ ます (そして, + ユーザが<envar>INTERACTIVE</envar>という変数をセッ + トすると入力を必要とする port + <emphasis>のみ</emphasis>コンパイルされま す).</para> + + <para>もし, 適切なデフォルト設定があるのであれば, + <makevar>PACKAGE_BUILDING</makevar> 変数をチェックして, + それが設定されて いる場合には, + ユーザ入力のスクリプトを起動しないように してください. + こうすることによって, CD-ROM や ftp に 置く package + を我々が作成することができます. + </para> + </sect4> + </sect3> + + <sect3> + <title>Makefileの作成</title> + + <para>Makefileの作成は非常に単純です. 繰り返しになりますが, + 始める まえに, すでにある例を見てみることをお奨めします. + またこのハ ンドブックには<link + linkend="porting-samplem">Makefileのお手本</link> + があります. それを見て, + Makefile内の変数の順番や空行を入れると + ころなどの参考にしてください. + そうすると他の人々にも読みやすい ものとなります.</para> + + <para>では, + Makefileをデザインするときに問題となるところを順に追っ + て見てみましょう.</para> + + <sect4> + <title>オリジナルのソース</title> + + <para>ソースは<makevar>DISTDIR</makevar>に, + 標準的なgzipされた tarファイルとして置かれていますか? + そうであれば, 次のステッ プに進めます. そうでなければ, + 変数 <makevar>EXTRACT_CMD</makevar>, + <makevar>EXTRACT_BEFORE_ARGS</makevar>, + <makevar>EXTRACT_AFTER_ARGS</makevar>, + <makevar>EXTRACT_SUFX</makevar>, + <makevar>DISTFILES</makevar> + を適当に書き換えないといけません. + どれだけ変更しないといけないかは, あなたのportの + 配布ファイルがどの程度標準からかけはなれているかによりま + す. (最もよくある場合は, + gzipではなく普通のcompressコマンド + でtarファイルが圧縮されている場合で, + <literal>EXTRACT_SUFX=.tar.Z</literal> + とするだけです.)</para> + + <para>最悪の場合には, 自分で + <maketarget>do-extract</maketarget> ターゲットを作 成して, + デフォルトを上書きすることもできます. しかし, そこま + でする必要があることはめったにないでしょう.</para> + </sect4> + + <sect4> + <title><makevar>DISTNAME</makevar></title> + + <para><makevar>DISTNAME</makevar> には port + の名前の基幹部分を入れ ます. デフォルトのルールでは, + 配布ファイルのリスト (<makevar>DISTFILES</makevar>) は + <makevar>DISTNAME</makevar> + <makevar>EXTRACT_SUFX</makevar> という名前 になっています. + 例えば, <literal>foozolix-1.0.tar.gz</literal>の場 合, + 通常のtarファイルだと, <literal> + DISTNAME=foozolix-1.0</literal> のようになります.</para> + + <para>さらにデフォルトのルールでは, tarファイルは + <filename>work/<makevar>DISTNAME</makevar></filename> + というサブディレクトリ に展開されることを仮定しています, + 例えば <filename>work/foozolix-1.0/</filename> + といった具合いです.</para> + + <para>これらの動作はもちろんすべて変更可能です. + デフォルトのルー + ルは最も標準的な場合を仮定しているだけです. まず, port + が複 数の配布ファイルを必要とするときには, 単に明示的に + <makevar>DISTFILES</makevar>を設定してください. もし, + <makevar>DISTFILES</makevar> + の一部だけが実際に展開される場合 には, + それらを<makevar>EXTRACT_ONLY</makevar> に設定してくだ + さい. この変数が定義されている場合には, 展開時に + <makevar>DISTFILES</makevar>に優先して利用されます. + 残りのファ + イルも<makevar>DISTDIR</makevar>に取ってきますが, 展開時に + はなにもせずに後で使うためにそのまま置いておかれます. + </para> + </sect4> + + <sect4> + <title><makevar>PKGNAME</makevar></title> + + <para>もし, <makevar>DISTNAME</makevar> が我々の <link + linkend="porting-pkgname"> package + の名前についてのガイドライン</link> + に沿ったものでない場合には, <makevar>PKGNAME</makevar> + にもっと良い名前を設定してください. + 詳細は上記のガイドラインを参照してください. + </para> + </sect4> + + <sect4> + <title><makevar>CATEGORIES</makevar> (分類)</title> + + <para>完成した package の実体は + <filename>/usr/ports/packages/All</filename> に置かれます. + また, 1つかそれ以上の + <filename>/usr/ports/packages</filename> + のサブディレクトリからのシンボリッ クリンクが作られます. + それらのサブディレクトリの名前が + <makevar>CATEGORIES</makevar> + という変数によって指定されます. これは, + ユーザがFTPサイトやCD-ROMのpackageの山を渡り歩 + くことを容易にするためです. 現在存在する <link + linkend="porting-categories">カテゴリ</link>を見て, そ + のportに適したもを選んでください.</para> + + <para>このリストは, この port が port tree のどこに import + されるかも決定します. 2つ以上のカテゴリを指定した場合には + 最初のカテゴリで指定されるサブディレクトリに置かれること + になります. 適切なカテゴリを選ぶ方法については, <link + linkend="porting-categories">カテゴリ</link> + の節を参照してください.</para> + + <para>もしその port + が本当に現在存在するすべてのものとは異なって いる場合には, + 新しいカテゴリ名を作ることもできます. その際には, &a.ports + 宛てに新しいカテゴリ名を提案する + メールを送ってください.</para> + + <para>カテゴリ名については, + なんのエラーチェックも行なわれません.ミスタイプがあっても + <command>make package</command> はなにも考えずに + 新しいディレクトリを作ってしまいますので, + 注意してください.</para> + </sect4> + + <sect4> + <title><makevar>MASTER_SITES</makevar></title> + + <para>オリジナルの配布ファイルを指し示す FTP または HTTP の + URL のディ レクトリ部分までを + <makevar>MASTER_SITES</makevar> に記録しま す. スラッシュ + (<filename>/</filename>) を最後につけることをお忘れなく. + 配布ファイルがシステム上に存在しないときに, + <command>make</command>マクロは <makevar>FETCH</makevar> + でこの変数に指定されたサイトから取っ てきます.</para> + + <para>複数の, + できれば異なる大陸のサイトをこのリストに入れておく + ことが推奨されています. これによって, + 広域ネットワークにトラ + ブルがあった場合でも成功する可能性が高くなります. + 私たちはさら に, 自動的に最も近いマスタサイトを検出して, + そこから取って + くるメカニズムの導入を計画しています.</para> + + <para>オリジナルのtar ファイルが, X-contrib, GNU, Perl CPAN, + TeX CTAN または Linux Sunsite + などの有名なアーカイブにある場合には, + <makevar>MASTER_SITE_XCONTRIB</makevar>, + <makevar>MASTER_SITE_GNU</makevar>, + <makevar>MASTER_SITE_PERL_CPAN</makevar>, + <makevar>MASTER_SITE_TEX_CTAN</makevar> および + <makevar>MASTER_SITE_SUNSITE</makevar> を利用することで, + 簡単にこれらのサイトを 指定することができます. あとは + <makevar>MASTER_SITE_SUBDIR</makevar> にアーカイ + ブ内でのパスを指定するだけです. 以下に例を示します.</para> + + <programlisting> +MASTER_SITES= ${MASTER_SITE_XCONTRIB} +MASTER_SITE_SUBDIR= applications</programlisting> + + <para>ユーザは<filename>/etc/make.conf</filename>中で + <makevar>MASTER_SITE_*</makevar> 変数を設定 + することによって, デフォルトの FTP サイトではなく, + これらの 有名なアーカイブの + ミラーの中で好みのものを使用することが可能 です.</para> + </sect4> + + <sect4 id="porting-patchfiles"> + <title><makevar>PATCHFILES</makevar></title> + + <para>もし, + オリジナルの配布ファイル以外にもFTPかHTTPで手に入る + パッチが必要な場合には, + <makevar>PATCHFILES</makevar>にファ イル名を, + <makevar>PATCH_SITES</makevar>にサイトとディレクト + リの名前を <makevar>MASTER_SITES</makevar> + と同様に設定してく ださい.</para> + + <para>そのパッチ内のファイル名ががソースツリーの + 一番上のディレク トリ (<makevar>WKRSRC</makevar>) + からの相対パスになっていな い場合には, + <makevar>PATCH_DIST_STRIP</makevar>を指定してく ださい. + 例えば, パッチ内のファイル名にすべて余計な + <literal>foozolix-1.0/</literal> がついている場合には, + <literal>PATCH_DIST_STRIP=-p1</literal>としてください.</para> + + <para>これらのパッチは圧縮されていても大丈夫です. + ファイル名が <filename>.gz</filename> か + <filename>.Z</filename> で終わる場合には自動的に復元 + されるようになっています.</para> + + <para>もしパッチが, 文書などその他のファイルと一緒に gzip + された tarファイルで配布されている場合には,単純に + <makevar>PATCHFILES</makevar> を使うことはできません. + このような場合には, このパッチの tar + ファイルの名前と場所を <makevar>DISTFILES</makevar> と + <makevar>MASTER_SITES</makevar> に加えます. それから, + <maketarget>pre-patch</maketarget> ターゲットで, + パッチコマンドを走らせるか, パッチファイルを + <makevar>PATCHDIR</makevar> ディレクトリに + <filename>patch-<replaceable>xx</replaceable></filename> + という名前でコピーするかして, + パッチを適用するようにします.</para> + + <note> + <para>普通の gzip か compress された tar ファイルであれば, + 通常のソースファイルと一緒にその時までに + 展開されていますので, 明示的に展開する必要はありません. + もし, 後者の方法を使用する場合には, + すでにそのディレクトリにある なにかを上書きしないように, + 注意する必要があります. さらに, + <maketarget>pre-clean</maketarget> + ターゲットにコピーしたパッチファイル + を削除するコマンドを追加するのを忘れないでください.</para> + </note> + </sect4> + + <sect4> + <title><makevar>MAINTAINER</makevar></title> + + <para>あなたのメールアドレスをここに入れてください. + お願いします. + <!-- smiley --><emphasis remap=tt>:)</emphasis></para> + + <para>保守担当者(maintainer)の責任についての詳細は, <link + linkend="policies-maintainer">Makefile 中の + MAINTAINER</link> の節をご覧ください.</para> + </sect4> + + <sect4> + <title>依存関係</title> + + <para>このプログラムが他のportに依存する場合には, + 必要なものが 自動的に作られるようにすることができます. + そのために, 以下の 5つの変数が用意されています. + よくあるケースのためにあらかじめ設定された依存変数や, + いくつかの依存関係の制御のための変数があります.</para> + + <sect5> + <title><makevar>LIB_DEPENDS</makevar></title> + + <para>Port が必要とする非標準の共有ライブラリを + この変数で指定 します. これは + <replaceable>lib</replaceable>: + <replaceable>dir</replaceable><optional><replaceable>: + target</replaceable></optional> という組のリストで, + うち <replaceable>lib</replaceable> + が共有ライブラリの名前, そして + <replaceable>dir</replaceable> + がそのライブラリが見つからない場合にインストールする + port のあるディレクトリで, + <replaceable>target</replaceable> + はそのディレクトリで呼ばれるターゲットです. 例えば, <!-- + kuriyama - should use programlisting? --> + <programlisting> LIB_DEPENDS= + jpeg.9:${PORTSDIR}/graphics/jpeg:install + </programlisting> と指定してあれば, + まずメジャーバージョンが9のjpegライブ + ラリがあるかどうか確認し, ない場合にはportsツリーの中の + <filename>graphics/jpeg</filename> + というサブディレクトリに移動し, そこ + でコンパイルとインストールを行ないます. + <replaceable>target</replaceable> の 部分は, + <makevar>DEPENDS_TARGET</makevar> (デフォルトは + <literal>install</literal>) + と等しいときには省略できます.</para> + + <note> + <para>前半の <replaceable>lib</replaceable> + 部分は <command>ldconfig -r | grep -wF</command> + への引数になります. + この変数には正規表現を入れられません. + </para> + </note> + + <para> + この依存関係は2度チェックされます. まず + <maketarget>extract</maketarget> ターゲットで, 次に + <maketarget>install</maketarget> でチェックされます. + (これは, その port を作成するマシンとインストールする + マシンが違う場合でも, きちんとそのライブラリが利用できる + ことを確認するためです.) また, 依存するもの名前は + package の中にも含まれますので, + ユーザのシステムに存在しなければ, + <command>pkg_add</command> が自動的にインストールします. + </para> + </sect5> + + <sect5> + <title><makevar>RUN_DEPENDS</makevar></title> + + <para>Port + を使用する際に必要となるファイルまたはプログラムがある + ときにはこの変数で指定します. これは + <replaceable>path</replaceable>: + <replaceable>dir</replaceable><optional><replaceable> + :target</replaceable></optional> とい + う組のリストで, <replaceable>path</replaceable> + がファイルまたはプログラムの 名前, そして + <replaceable>dir</replaceable> + がそれが見つからない場合に作成する + ためのディレクトリ名で <replaceable>target</replaceable> + はそのディレクトリで呼ばれるターゲットです. + <replaceable>path</replaceable> の最初の文字がスラッ + シュ (<literal>/</literal>) + の場合にはファイルかディレクトリ とみなし, その存在を + <command>test -e</command> でチェックします; + そうでない場合には 実行可能であると仮定し, + <command>which -s</command> を使って + そのプログラムがユーザのサーチパス上に + あるかどうか確認します.</para> + + <para>例えばMakefileに以下のように書いてあるとします.</para> + + <programlisting> +RUN_DEPENDS= ${PREFIX}/etc/innd:${PORTSDIR}/news/inn \ + wish8.0:${PORTSDIR}/x11-toolkits/tk80</programlisting> + + <para>まず, <filename>/usr/local/etc/innd</filename> + というファイルかディレクトリが存在 するか確認し, + ない場合にはportsツリーの中の + <filename>news/inn</filename> + というサブディレクトリから作られます. ま た, + <command>wish8.0</command> + というプログラムがユーザのサーチパス中 + にあるかどうか探し, ない場合には同じくportsツリーの + <filename>x11-toolkits/tk80</filename> + というサブディレクトリから作られます.</para> + + <note> + <para>この例で, <command>innd</command> + は実際にはプログラムです; この ように, + プログラムであっても標準のサーチパス以外のところに + あるようなものの場合には, + 絶対パスで指定してください.</para> + </note> + + <para>この依存関係は<maketarget>install</maketarget> + ステージのはじめでチェック されます. また, + packageを作る際に必要となるportのpackage名 が記録され, + <command>pkg_add</command>を使用すると + ユーザのシステムに存在しない場合には自動的にそちら + のpackageもインストールされるようになります. + <replaceable>target</replaceable> の部分は, + <makevar>DEPENdS_TARGET</makevar> + と同じ場合には省略可能です. + </para> + </sect5> + + <sect5> + <title><makevar>BUILD_DEPENDS</makevar></title> + + <para>Port + のコンパイルに必要なファイルまたはプログラムがある + ときは, この変数で指定してください. + <makevar>RUN_DEPENDS</makevar>と同 様に, これは + <replaceable>path</replaceable>: + <replaceable>dir</replaceable><optional><replaceable> + :target</replaceable></optional> + という組のリストです. 例 えば, <programlisting> + BUILD_DEPENDS= + unzip:${PORTSDIR}/archivers/unzip</programlisting> は + <command>unzip</command> という名前のプログラムを探し, + 見つから + ない場合には<filename>archivers/unzip</filename> + サブディレクトリで作 れという意味になります.</para> + + <note> + <para>ここでは “コンパイル” + と一口にいいましたが, この変数は実際 + にはファイルの展開から実際のコンパイル・リンクまで + 全部をま とめて面倒を見てくれます. + この依存関係は <maketarget>extract</maketarget> + ステージからチェックされます. + <replaceable>target</replaceable> の部分は + <makevar>DEPENDS_TARGET</makevar> + と同じ場合には省略可能です.</para> + </note> + </sect5> + + <sect5> + <title><makevar>FETCH_DEPENDS</makevar></title> + + <para>この変数は, + portを取ってくるのに必要なファイルまたはプロ + グラムを指定するのに使います. 上の二つと同様に, これは + <replaceable>path</replaceable>: + <replaceable>dir</replaceable><optional><replaceable> + :target</replaceable></optional> + <!-- kuriyama - should use programlisting? --> + という組のリストです. 例えば, <programlisting> + FETCH_DEPENDS= + ncftp2:${PORTSDIR}/net/ncftp2</programlisting> + としておけば, <command>ncftp2</command> + という名前のプログラムを探 し, + 見つからない場合には<filename>net/ncftp2</filename> + サブディレク トリにいってインストールします.</para> + + <para>この依存関係は <maketarget>fetch</maketarget> + ステージからチェックされます. + <replaceable>target</replaceable> の部分は + <makevar>DEPENDS_TARGET</makevar> + と同じ場合には省略可能です.</para> + </sect5> + + <sect5> + <title><makevar>DEPENDS</makevar></title> + + <para>上記の四つのいずれにもあてはまらないような + 依存関係がある場 合, または他の port + がインストールされれているだけではなく, + ソースが展開されている必要がある場合にはこの変数 + を使います. これは + <replaceable>dir</replaceable><optional><replaceable> + :target</replaceable></optional> という形式のリスト + になります. 上記の四つと違って特に + “確認”するものがありませんので.</para> + </sect5> + + <sect5> + <title>よくある依存関係を表す変数</title> + + <para>もし ports が X Window System + を必要とするのであれば, <literal>USE_XLIB=yes</literal> + を定義してください. (これは + <makevar>USE_IMAKE</makevar>も意味します) BSD + <command>make</command> の代りに GNU + <command>make</command> を必要とする場合には, + <literal>USE_GMAKE=yes</literal> を定義. 動作するのに + GNU autoconf を必要とする場合には, + <literal>USE_AUTOCONF=yes</literal> を定義. 最新の qt + toolkit を使用 する場合には + <literal>USE_QT=yes</literal> を定義. perl + 言語のバージョン5 を必要とする場合には, + <literal>USE_PERL5=yes</literal> を定義してください. + (特に最後のは重要で, FreeBSD のいくつかの + バージョンでは基本システムに perl5 を含みますが, + 他のものは含んでいません.)</para> + </sect5> + + <sect5> + <title>依存関係に関する注意</title> + + <para>上で述べたように, 依存する ports + が必要になったときに呼ばれるデフォルトのターゲットは + <maketarget>DEPENDS_TARGET</maketarget> で, + そのデフォルトは <literal>install</literal> です. + これは, ユーザの使用する変数で, port の + <filename>Makefile</filename> + で定義されるものではありません. もし, + あなたのportが特別な方法で, 依存関係を扱う必要が + ある場合には, <makevar>DEPENDS_TARGET</makevar> + を再定義するのではなく, <makevar>*_DEPENDS</makevar> + 変数の <literal>:target</literal> + の部分を利用してください. </para> + + <para><command>make clean</command> とタイプしたときには, + 依存する port も自動的に clean されます. + もしそうしたくない場合には, + <makevar>NOCLEANDEPENDS</makevar> + を環境変数として設定してください.</para> + + <para>無条件に他の port に依存させるには, 特別に + <literal>nonexistent</literal> という文字列を + <makevar>BUILD_DEPENDS</makevar> あるいは + <makevar>RUN_DEPENDS</makevar> + の最初のフィールドに使用してください. これは, 他の port + のソースが必要なときのみ使用してください. target + も指定することによって, + コンパイルの時間を節約することができます. 例えば, <!-- + kuriyama - should use programlisting? --> + <programlisting> BUILD_DEPENDS= + /nonexistent:${PORTSDIR}/graphics/jpeg:extract + </programlisting> これは, 常に JPEG port の directory + に行きソースの展開を行ないます.</para> + + <para>あなたがやりたいことが他の方法ではできない場合以外は, + <makevar>DEPENDS</makevar> を使わないでください. これは常に + 他の port の作成を行い(さらにデフォルトでインストール + を行い), package も作成します. もし本当にこれがあなたの + やりたいことでしたら, 代りにこれを + <literal>BUILD_DEPENDS</literal> と + <literal>RUN_DEPENDS</literal> で書くことをお勧めします + — 少なくとも意図が明確になります.</para> + </sect5> + </sect4> + + <sect4> + <title>コンパイル時の特別な指定</title> + + <para>GNUの<command>make</command>を使う場合には, + <literal>USE_GMAKE=yes</literal> と指定してください. Port + に GNU の <command>configure</command> が含まれ + ている場合には, <literal>GNU_CONFIGURE=yes</literal> + を使います(これは, <literal>HAS_CONFIGURE</literal> + も意味します). <command>configure</command> に追加の引数 + (デフォルトでは, GNU の <command>configure</command> では + <literal>--prefix=${PREFIX}</literal>, GNUでない + <command>configure</command> では空) + を渡したい場合には追加部分を + <makevar>CONFIGURE_ARGS</makevar> で指定してください. + そのパッケージが <command>autoconf</command> + を使用する場合には, <literal>USE_AUTOCONF=yes</literal> + を使います. これは, <makevar>GNU_CONFIGURE</makevar> + も意味し, <command>configure</command> の前に + <command>autoconf</command> を実行します. + </para> + + <para>X Window Systemのアプリケーションなど, + <command>imake</command>を 使って + <filename>Imakefile</filename> から + <filename>Makefile</filename> を作成するportの場合には + <literal>USE_IMAKE=yes</literal> を指定してください. + コンフィグレー ションステージで自動的に<command>xmkmf + -a</command> が実行されます. も し <option>-a</option> + フラグが問題をもたらすなら, さらに + <literal>XMKMF=xmkmf</literal>としてください.</para> + + <para>もし, port が <command>imake</command> + を使用するけれども, <maketarget>install.man</maketarget> + ターゲットがない場合には, + <literal>NO_INSTALL_MANPAGES=yes</literal> + を指定してください. ついでに, その port + のオリジナルの作者を探し出して八つ裂きにすると + いいでしょう.<!-- smiley + --><emphasis>:></emphasis></para> + + <para>Portの <filename>Makefile</filename> が + <maketarget>all</maketarget> 以外のものをメインのター + ゲットとしている場合には, <makevar>ALL_TARGET</makevar> + でそ れを指定してください. + <maketarget>install</maketarget> と + <makevar>INSTALL_TARGET</makevar> も同様です.</para> + + <para>もし, port の元の Makefile が + <maketarget>all</maketarget> + 以外のターゲットをメインのターゲットとしている場合には, + <makevar>ALL_TARGET</makevar> + をそれに合わせて設定してください. + <maketarget>install</maketarget> と + <makevar>INSTALL_TARGET</makevar> + についても同様です.</para> + <!-- kuriyama - duplicated? --> + </sect4> + + <!-- kuriyama - needs review order --> + <sect4> + <title><makevar>NO_INSTALL_MANPAGES</makevar></title> + + <para>あなたの port が<command>imake</command>は使うものの + <filename>install.man</filename> + ターゲットを持っていない場合, + <literal>NO_INSTALL_MANPAGES=yes</literal> + を指定してください. つい でに, + 作者を探し出して八つ裂きにするといいでしょ う. <!-- smiley + --><emphasis>(-_-#)</emphasis></para> + </sect4> + </sect3> + + <sect3> + <title>特別な配慮</title> + + <para>Portを作成する場合, + 考慮しなくてはいけないことがさらにいくつかあります. + この節では, + それらのうちもっともありがちなものについて説明します.</para> + + <sect4> + <title>ldconfig</title> + + <para>共有ライブラリをインストールするときには, + 共有ライブラリのキャッシュを更新するために port の + <filename>Makefile</filename> の + <maketarget>post-install</maketarget>target + から<literal>${LDCONFIG} -m</literal> + を走らせてください. + このコマンドの引数は共有ライブラリのインストールしてある + ディレクトリ (通常 + <filename><makevar>PREFIX</makevar>/lib</filename>) + です.</para> + + <para>また, <filename>pkg/PLIST</filename> に <literal>@exec + /sbin/ldconfig -m</literal> と <literal>@unexec + /sbin/ldconfig -R</literal> の組を入れて, package + をインストールした場合にも共有ライブラリがすぐ使え, + 削除の際にも, システムがまだライブラリが存在すると + 誤認しないようにしてください. + この行は共有ライブラリを指定する行のすぐ後に + 書くのがよいでしょう:</para> + + <programlisting> +lib/libtvl80.so.1 +@exec /sbin/ldconfig -m %D/lib +@unexec /sbin/ldconfig -R</programlisting> + + <para><emphasis>絶対に</emphasis>引数なしでただ + <literal>ldconfig</literal> とだけ書いてある行を + <filename>Makefile</filename> や + <filename>pkg/PLIST</filename> + ファイルに入れないでください. このコマンドを実行すると, + 共有ライブラリのキャッシュが <filename>/usr/lib</filename> + の内容のみとなり, + ユーザのマシンにさまざまな問題をもたらします (「ぎゃぁ! + このportをインストールしたら xinit + が使えなくなっちゃった!」). この掟を破った者は, + 永久に地獄の底で苦しみ続けるように, + 閻魔様に頼んでおきます.</para> + </sect4> + </sect3> + + <sect3> + <title>ELF 対応</title> + + <para>FreeBSD は 3.0-RELEASE で ELF に移行しましたので, + シェアードライブラリを作成するたくさんの port を ELF 対応 + にする必要があります. 3.0 システムは ELF としても a.out + としてmも 動作しますし, 我々は非公式ではありますが, + できるだけ長い間 2.2 + システムのサポートをしたいと思っていますので, + 複雑な状況です. 以下は a.out のみに対応している port + をどのように a.out と ELF 両方に対応させるかのガイドライ + ンです.</para> + + <para>このリストの一部は, + 移行時にしかあてはまらないものもありますが, 古い port + をアップグレードしたい場合に参考になるように, + しばらくのあいだは残しておきます.</para> + + <sect4> + <title>a.out ライブラリの退避</title> + + <para>a.out ライブラリは, + <filename>/usr/local/lib</filename> から, + <filename>aout</filename> サブディレクトリ + に移動しなくはなりません. (もし移動しないと, ELF ports + がそれらをあっさり上書きして しまいます.) 3.0-CURRENT の + <filename>src/Makefile</filename> にある + <maketarget>move-aout-libs</maketarget> ターゲット + (<maketarget>aout-to-elf</maketarget> から呼ばれます) + がその移動をしてくれます. a.out + ライブラリを移動するだけなので, ELF と a.out + の両方のライブラリが標準的な + ディレクトリにあるシステムでは, + このターゲットを実行しても安全です.</para> + </sect4> + + <sect4> + <title>フォーマット</title> + + <para>port ツリーは package + をそのマシンのフォーマットで作成します. つまり, 2.2 では + a.out, また 3.0 では <command>`objformat`</command> + の結果によって, a.out か ELF になります. また, いったん + a.out ライブラリをサブディレクトリに移動すると a.out + ライブラリの作成はサポートされません. (つまり, + あなたがにをすれば良いのかを理解しているのならば, + うまく作成できるかもしれませんが, + 自力でやらなければならないということです)</para> + + <note> + <para>もし port が aout でしか動作しないのなら, + <makevar>BROKEN_ELF</makevar> + に原因を説明する文字列を設定してください. + この変数が設定された port は, ELF + システム上でのビルドの際スキップされます.</para> + </note> + </sect4> + + <sect4> + <title>PORTOBJFORMAT</title> + + <para><filename>bsd.port.mk</filename> において + <makevar>PORTOBJFORMAT</makevar> は + <literal>aout</literal> か <literal>elf</literal> + に設定され, 環境変数 <envar>CONFIGURE_ENV</envar>, + <envar>SCRIPTS_ENV</envar>, <envar>MAKE_ENV</envar> の中で + export されます. (2.2-STABLE では常に + <literal>aout</literal> になります). また, + <literal>PORTOBJFORMAT=${PORTOBJFORMAT}</literal> として + <maketarget>PLIST_SUB</maketarget> に渡されます. + (以下にある <literal>ldconfig</literal> + に関するコメントを参照して下さい.)</para> + + <para>この変数は, 以下のようにして + <filename>bsd.port.mk</filename> 中で設定されます.</para> + + <programlisting> +PORTOBJFORMAT!= test -x /usr/bin/objformat && /usr/bin/objformat || echo aout</programlisting> + + <para>この変数を使って, port の make + の過程で何をすべきかを決定すべきですが, もし port の + <filename>configure</filename> スクリプトが元々, ELF + システムを自動的に検出するのであれば, + <makevar>PORTOBJFORMAT</makevar> + を参照する必要はありません.</para> + </sect4> + + <sect4> + <title>共有ライブラリの作成</title> + + <para>以下は, a.out と ELF + での共有ライブラリの扱いの違いです.</para> + + <itemizedlist> + <listitem> + <para>共有ライブラリのバージョン</para> + + <para>ELF の共有ライブラリは, <filename> + libfoo.so.<replaceable>M</replaceable> </filename> + という名前になっていなければなりません. ここで + <replaceable>M</replaceable> は単一の + バージョン番号を表します. 一方 a.out のライブラリは + <filename> libfoo.so.<replaceable>M</replaceable>. + <replaceable>N</replaceable></filename> + という名前で, <replaceable>M</replaceable> + はメジャーバージョン番号, <replaceable>N</replaceable> + はマイナーバージョン番号になっている必要があります. + これらを混同しないでください. <filename> + libfoo.so.<replaceable>N</replaceable>. + <replaceable>M</replaceable></filename> + という名のELF 共有ライブラリや <filename> + libfoo.so.<replaceable>N</replaceable></filename> + という名の a.out 共有ライブラリ + (あるいはシンボリックリンク) は + <emphasis>絶対にinstallしないでください</emphasis>.</para> + </listitem> + + <listitem> + <para>リンカコマンドライン</para> + + <para>直接 <command>ld</command> を使用せずに, + <command>cc -shared</command> を使用してください. + たった一つの違いは, ELF には, <option> + -Wl,-<replaceable>soname,libfoo.so.M</replaceable> + </option> + コマンドラインにを加える必要があることです.</para> + <!-- kuriyama - strange Japanese representation --> + </listitem> + </itemizedlist> + + <para>ELF のリンカを満足させるためには, + <filename>libfoo.so</filename> から <filename> + libfoo.so.<replaceable>N</replaceable></filename> + へのシンボリックリンクを作る必要があります. これは, + <filename>PLIST</filename> にも加えなくては いけませんし, + a.out の場合でも害にはならないので (一部の port + ではダイナミックリンクローディングのために + 必要でもあります), <makevar>PORTOBJFORMAT</makevar> + の設定を気にせずに, + ただ単純にリンクを作成してください.</para> + </sect4> + + <sect4> + <title><makevar>LIB_DEPENDS</makevar></title> + + <para>すべての port の Makefile を編集して, + <makevar>LIB_DEPENDS</makevar> + からマイナー番号を除去する必要があり, + 正規表現のサポートも除去する必要があります. (例えば, + <literal>foo\\.1\\.\\(33|40\\)</literal> から + <literal>foo.2</literal>) マッチングは <command>grep + -wF</command> を使って行われます.</para> + </sect4> + + <sect4> + <title><filename>PLIST</filename></title> + + <para><filename>PLIST</filename> は, a.out + のマイナー番号が0であれば, 短い (ELFの) + 共有ライブラリの名前を含み, さもなくば長い (a.outの) + 名前を含んでいる必要があります. + <filename>bsd.port.mk</filename> は 自動的に, + <makevar>PORTOBJFORMAT</makevar> が + <literal>aout</literal> であれば, <literal>.0</literal> を + 短い共有ライブラリの名前の行に付け加え, + <makevar>PORTOBJFORMAT</makevar> が <literal>elf</literal> + であれば, マイナー番号を + 長い共有ライブラリの名前から削除します.</para> + + <para>ELF システムで 2 + つのバージョン番号を持つ共有ライブラリを + インストールしたり, aout システムで 1 + つのバージョン番号しか持たない共有ライブラリを + インストールするのが避けられない場合 + (例えば他のオペレーティングシステム用の + 互換ライブラリをインストールする port など), + <makevar>NO_FILTER_SHLIBS</makevar> 変数を定義すれば, + 前節で説明されている <filename>PLIST</filename> + 編集の機能が停止されます.</para> + </sect4> + + <sect4> + <title><literal>ldconfig</literal></title> + + <!-- kuriyama - Eng. why literal? --> + <para>Makefile 中の <literal>ldconfig</literal> + の行は以下のようになります.</para> + + <programlisting> +${SETENV} OBJFORMAT=${PORTOBJFORMAT} ${LDCONFIG} -m ....</programlisting> + + <para>また <filename>PLIST</filename> 中では:</para> + + <programlisting> +@exec /usr/bin/env OBJFORMAT=%%PORTOBJFORMAT%% /sbin/ldconfig -m ... +@unexec /usr/bin/env OBJFORMAT=%%PORTOBJFORMAT%% /sbin/ldconfig -R</programlisting> + + <para>となります. これは, + システムのデフォルトフォーマットではなく + パッケージのフォーマットに応じて, 正しい + <command>ldconfig</command> + が呼ばれることを保証するためのものです.</para> + </sect4> + </sect3> + + <sect3 id="porting-masterdir"> + <title><makevar>MASTERDIR</makevar></title> + + <para>もし, あなたの port が 変数(例えば + 解像度とか紙のサイズなど)を変えたりした, + ちょっと違うバージョンを作成する必要があるときには, + ユーザが分りやすいように, package + ごとに別々のサブディレクトリを作成し, ただし, できるだけ + port 間でファイルを共有するようにしてください. + 典型的な例では, うまく変数を使えば, + とても短い<filename>Makefile</filename>だけ, + 1つ以外のすべてのディレクトリに置くだけで済みます. その短い + <filename>Makefile</filename> には + <makevar>MASTERDIR</makevar> を使って, + 残りのファイルがあるディレクトリを指定できます. また <link + linkend="porting-pkgname"><makevar>PKGNAME</makevar> + </link> の一部に変数に使って, package + が別々の名前を持つようにしてください.</para> + + <para>以下が, とても良い例になるでしょう. これは + <filename>japanese/xdvi300/Makefile</filename> + の一部です:</para> + + <programlisting> +PKGNAME= ja-xdvi${RESOLUTION}-17 + : +# default +RESOLUTION?= 300 +.if ${RESOLUTION} != 118 && ${RESOLUTION} != 240 && \ + ${RESOLUTION} != 300 && ${RESOLUTION} != 400 + @${ECHO} "Error: invalid value for RESOLUTION: \"${RESOLUTION}\"" + @${ECHO} "Possible values are: 118, 240, 300 (default) and 400." + @${FALSE} +.endif</programlisting> + + <para><filename>japanese/xdvi300</filename> は通常のパッチ, + package ファイルももっています. そこで, + <command>make</command> と入力すると, + デフォルトの解像度(300)を使って, 普通に port + の作成を行います.</para> + + <para>他の解像度に関してですが, これが, + <filename>xdvi118/Makefile</filename> の(コメントを除いた) + <emphasis>すべて</emphasis>です.</para> + + <programlisting> +RESOLUTION= 118 +MASTERDIR= ${.CURDIR}/../xdvi300 + +.include ${MASTERDIR}/Makefile</programlisting> + + <para>(<filename>xdvi240/Makefile</filename> と + <filename>xdvi400/Makefile</filename> も同様です). + <makevar>MASTERDIR</makevar> が + <filename>bsd.port.mk</filename> に + <makevar>PATCHDIR</makevar> や <makevar>PKGDIR</makevar> + などの通常のサブディレクトリが <filename>xdvi300</filename> + にあることを教えます. <literal>RESOLUTION=118</literal> + の行が, <filename>xdvi300/Makefile</filename> の + <literal>RESOLUTION=300</literal> の行を無効にし, port + は解像度を118として作成されます.</para> + </sect3> + + <sect3> + <title>共有ライブラリのバージョン</title> + + <para>まず, <link linkend="policies-shlib"> + 共有ライブラリのバージョンについての指針</link> を読んで, + 共有ライブラリのバージョンを + 一般的にどうすれば良いかを理解してください. 盲目的に, + ソフトウエアの作者がちゃんと理解していると + 信じててはいけません, 多くの場合違います. + 細い点まで考慮することは大変重要なことです, + なぜなら我々は互換性がないかもしれない大量の + ソフトウェアを共存させようとする, 特殊な状況にあるからです. + 不注意な port の導入が共有ライブラリに関して, + 多大な問題を引き起したことが過去にあります (今まで, + <filename>jpeg-6b</filename> がなぜ 9.0 + といバージョン番号を持っているか不思議に + 思ったことはありませんか?). もし, 疑問があれば, &a.ports; + にメールを送ってください. ほとんどの時間は, + 正しいシェアードライブラリのバージョンを決めることと, + それを実現するためのパッチを作成することに終始します.</para> + + <para>しかしながら, が同じソフトウェアの違ったバージョンの + ソフトウェアが既にツリーにあるばあいには, + 状況は非常に複雑です. <!-- kuriyama - strange translation? + --> つまり, FreeBSD では, + ユーザがリンカにどのバージョンの共有ライブラリを + 使用するかを指定できないからです + (リンカは常にもっとも高いバージョンを選びます). これは, + もし, <filename>libfoo.so.3.2</filename> と + <filename>libfoo.so.4.0</filename> + がシステムに存在するときには, + リンカに特別なアプリケーションだけ + <filename>libfoo.so.3.2</filename> + をリンクするように指示する方法がないことを意味します. + これは, + コンパイル時のリンクという意味では完全に見劣りします. + この場合の唯一の解決方法は, 共有ファイルの名前の + <emphasis>ベース</emphasis> 部分を変えることです. 例えば, + <filename>libfoo.so.4.0</filename> を + <filename>libfoo4.so.1.0</filename> へ変えることによって, + バージョン 3.2 とバージョン 4.0 共に他の port + からリンクされることができるようになります.</para> + </sect3> + + <sect3 id="porting-manpages"> + <title>マニュアル</title> + + <para><makevar>MAN[1-9LN]</makevar> 変数を使用すると, + 自動的にすべてのマニュアルを <filename>pkg/PLIST</filename> + に加えます (つまり, マニュアルを <filename>PLIST</filename> + に加えては <emphasis>いけません</emphasis> — <link + linkend="porting-plist">PLIST の生成</link> + を参照してください). またマニュアルを + <filename>/etc/make.conf</filename> 中の + <makevar>NOMANCOMPRESS</makevar> の設定に応じて, + install時に自動的に圧縮したり伸長したりします.</para> + + <para>マニュアルをインストール時に圧縮するかどうかを + 指定するには, <makevar>MANCOMPRESSED</makevar> + 変数を使用します. この変数は, 3つの値をとることができます, + <literal>yes</literal>, <literal>no</literal> そして + <literal>maybe</literal> です. <literal>yes</literal> + はマニュアルが既に圧縮されて インストールされている, + <literal>no</literal> はされていない, + <literal>maybe</literal> はそのソフトウェアがすでに, + <makevar>NOMANCOMPRESS</makevar> に合わせており + <filename>bsd.port.mk</filename> + が特別なにもする必要がないことを意味します.</para> + + <para><makevar>USE_IMAKE</makevar> がセットされていて, + <makevar>NO_INSTALL_MANPAGES</makevar> + がセットされていなければ, <makevar>MANCOMPRESSED</makevar> + は自動的に <literal>yes</literal> に設定され, + それ以外の場合には, <literal>no</literal> になります. + デフォルトがあなたの port + に合わない場合以外は明示的に設定する必要がありません.</para> + + <para><makevar>PREFIX</makevar> 以外のディレクトリの下に + マニュアルを置くような port では + <makevar>MANPREFIX</makevar> を指定することができます. + さらに, 特定のセクションのマニュアルだけ, + 標準ではない場所にインストールする場合, 例えばいくつかの + Perl のモジュールの ports など, には個々のマニュアルのパスを + <makevar>MAN<replaceable>sect</replaceable>PREFIX</makevar> + (<replaceable>sect</replaceable> は, <literal>1-9</literal>, + または, <literal>L</literal> か <literal>N</literal> + を表わします) によって指定できます. ができます.</para> + <!-- kuriyama - strange representation --> + + <para>マニュアルが, 言語特有のサブディレクトリに + 置かれる場合には, 言語名を <makevar>MANLANG</makevar> + に設定してください. この変数のデフォルト値は, + <literal>""</literal> になっています (つまり, 英語のみ). + </para> + + <para>これは, 全部をまとめた例です.</para> + + <programlisting> +MAN1= foo.1 +MAN3= bar.3 +MAN4= baz.4 +MANLANG= "" ja +MAN3PREFIX= ${PREFIX}/share/foobar +MANCOMPRESSED= yes</programlisting> + + <para>以下の6個のファイルがこの port でインストールされます. + </para> + + <programlisting> +${PREFIX}/man/man1/foo.1.gz +${PREFIX}/man/ja/man1/foo.1.gz +${PREFIX}/share/foobar/man/man3/bar.3.gz +${PREFIX}/share/foobar/man/ja/man3/bar.3.gz +${PREFIX}/man/man4/baz.4.gz +${PREFIX}/man/ja/man4/baz.4.gz</programlisting> + </sect3> + + <sect3> + <title>Motifを必要とするport</title> + + <para>最近はコンパイルに Motif + を必要とするアプリケーションが増えて きました. + (Motif自体は有料のものがいくつかの会社から手に入りま すし, + 多くのアプリケーションがコンパイル可能な無料の互換ライブラリ + が <filename>x11-toolkits/lesstif</filename>にあります) + Motifはかなり広く使われていますし, 製品のライ + センスではライブラリを静的にリンクした + 実行形式は再配布が認めら れている場合が多いので, + Motifを必要とするソフトウェアを簡単に 動的(port + からコンパイルする人々のために)/静的(package を配布 + する人々のために)にリンクできるような + しくみが用意されています.</para> + + <sect4> + <title><makevar>REQUIRES_MOTIF</makevar></title> + + <para>Motif + がないとコンパイルできないportのMakefileではこの変 + 数を指定してください. これによって, + Motifを持っていない人が + このportをコンパイルしようとするのを未然に防ぎます.</para> + </sect4> + + <sect4> + <title><makevar>MOTIFLIB</makevar></title> + + <para>この変数は <filename>bsd.port.mk</filename> によって + Motif ライブラリの指 定に置き換えられます. + ソース内のMakefileやImakefileで Motif + ライブラリを指定しているところをこの変数に置き換えるよ + うにパッチをあててください.</para> + + <para>代表的な例としては以下の二つがあげられます:</para> + + <orderedlist> + <listitem> + <para>MakefileかImakefileの中でMotifライブラリが + <option>-lXm</option> として使われている場合には, + かわりに <makevar>MOTIFLIB</makevar> + と書いてください.</para> + </listitem> + + <listitem> + <para>Imakefileの中で <literal>XmClientLibs</literal> + が使われている 場合には, それを + <literal>${MOTIFLIB} ${XTOOLLIB} + ${XLIB}</literal> と書きかえてください.</para> + </listitem> + </orderedlist> + + <note> + <para><makevar>MOTIFLIB</makevar> は通常 + <literal>-L/usr/X11R6/lib -lXm</literal> か + <literal>/usr/X11R6/lib/libXm.a</literal> に置き換えら + れます. したがって前に <option>-L</option> や + <option>-l</option> をつけ る必要はありません.</para> + </note> + </sect4> + </sect3> + + <sect3> + <title>X11 のフォント</title> + + <para>もし, あなたの port が X window system + のフォントをインストールするのであれば, それらを <filename> + <makevar>X11BASE</makevar>/lib/X11/fonts/local</filename> + に置くようにしてください. このディレクトリは XFree86 release + 3.3.3 で新設されたものです. もし, + それが存在しなければ作成し, ユーザに XFree86 を 3.3.3 + かそれより新しいものに更新か, すくなくとも, + このディレクトリを <filename>/etc/XF86Config</filename> の + font path + に加えるように促すメッセージを出力するようにしてください. + </para> + </sect3> + + <sect3> + <title>Info ファイル</title> + + <para>新しい版の texinfo(2.2.2-RELEASE + およびそれ以降に入っています) には, + <command>install-info</command> + というコマンドが含まれており, <filename>dir</filename> + ファイルに項目を追加したり, 削除したりすることがで きます. + もし, あなたの port が info ドキュメントをインストー + ルするのであれば, 以下の指示に従って, その port および + package が正しく, ユーザの + <filename>${PREFIX}/info/dir</filename> ファイル + を更新するようにしてください. (この節は, + とても長くてすいません, しかし info + ファイルを作りあげるためには, これらは不可欠 です. + 正しく行なえば, <emphasis>美しい</emphasis> + リストができますので, 辛抱してください! <!-- smiley + --><emphasis>:)</emphasis></para> + + <para>まず, これを知っておかなければなりません:</para> + + <screen>&prompt.user; <userinput>install-info --help</userinput> +install-info [OPTION]... [INFO-FILE [DIR-FILE]] + Install INFO-FILE in the Info directory file DIR-FILE. + (訳注: Info ディレクトリの INO-FILE を DIR-FILE にインストールする) +Options: +--delete Delete existing entries in INFO-FILE; + don't insert any new entries. + (訳注: INFO-FILE の中の項目を削除, + 新しい項目は一切追加しない.) + : +--entry=TEXT Insert TEXT as an Info directory entry. + (訳注: TEXT を Info ディレクトリの項目として追加する.) + : +--section=SEC Put this file's entries in section SEC of the directory. + (訳注: このファイルの項目を Info ディレクトリの SEC + という節に置く.) + :</screen> + + <note> + <para>このプログラムは, 実際には info + ファイルを<emphasis>インストール</emphasis> しません, 単に + <filename>dir</filename> + ファイルにエントリーを挿入したり削除し + たりするだけです.</para> + </note> + + <para>これから, <command>install-info</command> + を使用するように, ports を変換す る7段階の工程を示します. + 例として <filename>editors/emacs</filename>を + 使用します.</para> + + <procedure> + <step> + <para>まず, texinfo のソースを見て, + <literal>@dircategory</literal> と + <literal>@direntry</literal> 文がないファイルについて, + それらを追加するパッチを作成します. 以下は, + ここでの例での patchの一部です:</para> + + <programlisting> +--- ./man/vip.texi.org Fri Jun 16 15:31:11 1995 ++++ ./man/vip.texi Tue May 20 01:28:33 1997 +@@ -2,6 +2,10 @@ + + @setfilename ../info/vip + @settitle VIP ++@dircategory The Emacs editor and associated tools ++@direntry ++* VIP: (vip). A VI-emulation for Emacs. ++@end direntry + + @iftex + @finalout + :</programlisting> + + <para>フォーマットについては見ればわかると思います. + <filename>dir</filename> + というファイルに必要な項目を書いておいてくれる作者 + も多いので, まず自分で書く前にさがしてみてください. + また, 関係 する ports も調べて, 節(section)の名前や, + インデントなどが + きちんと合っているかどうかを確認してください + (項目のテキスト は, すべて4つめのタブ・ストップ(tab + stop)から始めることを推 奨します).</para> + + <note> + <para>1つのファイルに対して1つの info + の項目しか書けないことに注 意してください, これは, + <command>install-info --delete</command> <!-- kuriyama + - not email --> が, そのバグにより, + <email>@direntry</email> セクションに複数の項目を書 + いても, + 初めの1つの項目しか削除してくれないからです.</para> + </note> + + <para>texinfo のソースにパッチをあてるかわりに, + <literal>dir</literal> の項目 を + <command>install-info</command> の + 引数((<option>--section</option>, + <option>--entry</option>) として与えることもできます. + これはあまり良い方法とは 思えません, なぜなら, + 同じ情報を3ヶ所(<filename>Makefile</filename>, + <filename>PLIST</filename> の + <literal>@exec</literal>/<literal>@unexec</literal>: + 以下参照) に重複して, 書く必要があるからです. + しかしながら, もし日本語(あるいは, + 他のマルチバイト文字)の info ファイルがあるのならば, + <command>install-info</command> + の特別な引数を使用する必要があるでしょう, なぜならば, + <command>makeinfo</command> がこのような texinfo + ソースファイル を扱えないからです. + (このようなものをどう扱うかの例としては, + <filename>japanese/skk</filename> の + <filename>Makefile</filename> と + <filename>PLIST</filename> を見て ください.)</para> + </step> + + <step> + <para>portのディレクトリに戻って, <command>make clean; + make</command> をして, info ファイルが texinfo + ソースファイルから再び生成さ れることを確認してください. + texinfo ソースファイルのほうが info + ファイルよりも新しいので, <command>make</command> + とタイプすれば, info ファイルは再構築されるはずですが, + 多くの <filename>Makefile</filename> には info + ファイルの正しい依存関係が書かれていません. + <command>emacs</command> の場合, info + ファイルの再構築ため, <filename>man</filename> + サブディレクトリ に降りていくようにするために, メインの + <filename>Makefile.in</filename> にパッ + チをあてる必要がありました.</para> + + <programlisting> +--- ./Makefile.in.org Mon Aug 19 21:12:19 1996 ++++ ./Makefile.in Tue Apr 15 00:15:28 1997 +@@ -184,7 +184,7 @@ + # Subdirectories to make recursively. `lisp' is not included + # because the compiled lisp files are part of the distribution + # and you cannot remake them without installing Emacs first. +-SUBDIR = lib-src src ++SUBDIR = lib-src src man + + # The makefiles of the directories in $SUBDIR. + SUBDIR_MAKEFILES = lib-src/Makefile man/Makefile src/Makefile oldXMenu/Makefile lwlib/Makefile +--- ./man/Makefile.in.org Thu Jun 27 15:27:19 1996 ++++ ./man/Makefile.in Tue Apr 15 00:29:52 1997 +@@ -66,6 +66,7 @@ + ${srcdir}/gnu1.texi \ + ${srcdir}/glossary.texi + ++all: info + info: $(INFO_TARGETS) + + dvi: $(DVI_TARGETS)</programlisting> + + <para><filename>man</filename> + サブディレクトリでのデフォルトターゲットは, + <maketarget>info</maketarget> で呼ばれるのに対して, + メインの <filename>Makefile</filename> では, + <maketarget>all</maketarget> で呼びたいので, + 2つめのpatchが必要でした. また, + <filename>info</filename> info + ファイルのインストールも削除しました, なぜなら, + 同じものが同じ名前で既に + <filename>/usr/share/info</filename> にあるからです. + (このパッチはここにはありません.)</para> + </step> + + <step> + <para>もし, <filename>Makefile</filename> に + <filename>dir</filename> ファイルをインストールす + る個所があれば, 削除します. あなたの port がインストー + ルしてはいけません. また, <filename>dir</filename> + ファイルを壊してしまうよう + なコマンドの類も削除します.</para> + + <programlisting> +--- ./Makefile.in.org Mon Aug 19 21:12:19 1996 ++++ ./Makefile.in Mon Apr 14 23:38:07 1997 +@@ -368,14 +368,8 @@ + if [ `(cd ${srcdir}/info && /bin/pwd)` != `(cd ${infodir} && /bin/pwd)` ]; \ + then \ + (cd ${infodir}; \ +- if [ -f dir ]; then \ +- if [ ! -f dir.old ]; then mv -f dir dir.old; \ +- else mv -f dir dir.bak; fi; \ +- fi; \ + cd ${srcdir}/info ; \ +- (cd $${thisdir}; ${INSTALL_DATA} ${srcdir}/info/dir ${infodir}/dir); \ +- (cd $${thisdir}; chmod a+r ${infodir}/dir); \ + for f in ccmode* cl* dired-x* ediff* emacs* forms* gnus* info* message* mh-e* sc* vip*; do \ + (cd $${thisdir}; \ + ${INSTALL_DATA} ${srcdir}/info/$$f ${infodir}/$$f; \ + chmod a+r ${infodir}/$$f); \</programlisting> + </step> + + <step> + <para>(これは, 既存のportを修正するときのみ必要です.) + <filename>pkg/PLIST</filename> を見て, + <filename>info/dir</filename> にパッチをあて + ようとするものすべてを削除します. これらは, + <filename>pkg/INSTALL</filename> + やその他のファイルにもあるかもしれない ので, + いろいろさがしてみてください.</para> + + <programlisting> +Index: pkg/PLIST +=================================================================== +RCS file: /usr/cvs/ports/editors/emacs/pkg/PLIST,v +retrieving revision 1.15 +diff -u -r1.15 PLIST +--- PLIST 1997/03/04 08:04:00 1.15 ++++ PLIST 1997/04/15 06:32:12 +@@ -15,9 +15,6 @@ + man/man1/emacs.1.gz + man/man1/etags.1.gz + man/man1/ctags.1.gz +-@unexec cp %D/info/dir %D/info/dir.bak +-info/dir +-@unexec cp %D/info/dir.bak %D/info/dir + info/cl + info/cl-1 + info/cl-2</programlisting> + </step> + + <step> + <para><maketarget>post-install</maketarget> ターゲットを + <filename>Makefile</filename> に加えて, + <filename>dir</filename> + ファイルが存在しなければ作成するようにします. また, + インストールされた info ファイルについては, + <maketarget>install-info</maketarget> + を実行するようします.</para> + + <programlisting> +Index: Makefile +=================================================================== +RCS file: /usr/cvs/ports/editors/emacs/Makefile,v +retrieving revision 1.26 +diff -u -r1.26 Makefile +--- Makefile 1996/11/19 13:14:40 1.26 ++++ Makefile 1997/05/20 10:25:09 1.28 +@@ -20,5 +20,11 @@ + post-install: + .for file in emacs-19.34 emacsclient etags ctags b2m + strip ${PREFIX}/bin/${file} + .endfor ++ if [ ! -f ${PREFIX}/info/dir ]; then \ ++ ${SED} -ne '1,/Menu:/p' /usr/share/info/dir > ${PREFIX}/info/dir; \ ++ fi ++.for info in emacs vip viper forms gnus mh-e cl sc dired-x ediff ccmode ++ install-info ${PREFIX}/info/${info} ${PREFIX}/info/dir ++.endfor + + .include <bsd.port.mk></programlisting> + + <para>新しい info ファイルを作成するのに, + <filename>/usr/share/info/dir</filename> と上のコマンド, + 以外は使用しな いでください. 実際のところ, もし port + する人がこれに関して <filename>PLIST</filename> + に自らまったく手を加える必要がないのであれば, 上 + のパッチのはじめの3行を <filename>bsd.port.mk</filename> + に加えたでしょう.</para> + </step> + + <step> + <para><filename>PLIST</filename> を編集して, + 同じ働きをする <literal>@exec</literal> 文, そ + れに<command>pkg_delete</command> のために + <literal>@unexec</literal> 文を加えてくださ い. + <literal>@unexec</literal> を使用して + <filename>info/dir</filename> を削除する必 + 要はありません.</para> + + <programlisting> +Index: pkg/PLIST +=================================================================== +RCS file: /usr/cvs/ports/editors/emacs/pkg/PLIST,v +retrieving revision 1.15 +diff -u -r1.15 PLIST +--- PLIST 1997/03/04 08:04:00 1.15 ++++ PLIST 1997/05/20 10:25:12 1.17 +@@ -16,7 +14,15 @@ + man/man1/etags.1.gz + man/man1/ctags.1.gz ++@unexec install-info --delete %D/info/emacs %D/info/dir + : ++@unexec install-info --delete %D/info/ccmode %D/info/dir + info/cl + info/cl-1 +@@ -87,6 +94,18 @@ + info/viper-3 + info/viper-4 ++@exec [ -f %D/info/dir ] || sed -ne '1,/Menu:/p' /usr/share/info/dir > %D/info/dir ++@exec install-info %D/info/emacs %D/info/dir + : ++@exec install-info %D/info/ccmode %D/info/dir + libexec/emacs/19.34/i386--freebsd/cvtmail + libexec/emacs/19.34/i386--freebsd/digest-doc</programlisting> + + <note> + <para><literal>@unexec install-info --delete</literal> + コマンドは, info ファイル自身より先に置き, + コマンドがファイルを読めるようにし + ておかなければならないことに注意してください. また, + <literal>@exec install-info</literal> コマンドは info + ファイルおよび <filename>dir</filename> ファイルを作る + <literal>@exec</literal> コマンドより後に + おかなければなりません.</para> + </note> + </step> + + <step> + <para><link linkend="porting-testing">テスト</link> + をして出来栄えに感服しましょう <!-- smiley + --><emphasis>:)</emphasis> 各段階の前後に, + <filename>dir</filename> + ファイルをチェックしましょう.</para> + </step> + </procedure> + </sect3> + + <sect3> + <title><filename>pkg/</filename> サブディレクトリ</title> + + <para>まだ触れていない, いくつかのこつが + <filename>pkg/</filename> サブディレクトリにはあり, + 時として便利でしょう.</para> + + <sect4 id="porting-message"> + <title><filename>MESSAGE</filename></title> + + <para>もし, インストールする人にメッセージを表示する + 必要がある場合には, そのメッセージを + <filename>pkg/MESSAGE</filename> に置けます. この機能は, + <command>pkg_add</command> + の後の追加のインストール手続きを表示するときなどに, + 重宝します.</para> + + <note> + <para> + <filename>pkg/MESSAGE</filename> ファイルは + <filename>pkg/PLIST</filename> に加える必要はありません. + また, もしユーザが package ではなく port を使用して + いる場合には自動的には表示されませんので, 明示的に + <maketarget>post-install</maketarget> + で表示するようにするべきでしょう.</para> + </note> + </sect4> + + <sect4> + <title><filename>INSTALL</filename></title> + + <para>バイナリパッケージが <command>pkg_add</command> + でインストールされるときに, 実行される必要がある + コマンドがあれば, <filename>pkg/INSTALL</filename> + スクリプトを使って実行することができます. + このスクリプトは自動的に package に加えられ, + <command>pkg_add</command> によって2度実行されます. + はじめは <literal>INSTALL ${PKGNAME} + PRE-INSTALL</literal> と実行され, 2度目には, + <literal>INSTALL ${PKGNAME} POST-INSTALL</literal> + と実行されます. どちらのモードで実行されているかは, + <literal>$2</literal> + を調べることによってわかります. 環境変数 + <envar>PKG_PREFIX</envar> には package + がインストールされるディレクトリが設定されます. 詳細は + &man.pkg.add.1; を見てください.</para> + + <note> + <para> + port を <command>make install</command> で + インストールするときには, + このスクリプトは自動的に実行されません. もし, + 実行される必要があるならば, port の Makefile + から明示的に呼ぶ必要があります. + </para> + </note> + </sect4> + + <sect4> + <title><filename>REQ</filename></title> + + <para>port が(インストールされるシステムの状態によって) + インストールされるべきか, されないべきか区別する必要が + あるときには, “要件(requirements)” スクリプト + <filename>pkg/REQ</filename> を作ることができます. これは, + インストール及びデインストール (package + の削除)の時に自動的に実行され, + それらが処理されるべきかを決定します.</para> + </sect4> + + <sect4 id="porting-plist"> + <title>make の変数にあわせた <filename>PLIST</filename> + の変更</title> + + <para>いくつかの port, 特に p5- portsなど, は configure + のオプション (あるいは, p5- ports の場合は perl + のバージョン)によって, <filename>PLIST</filename> + を変える必要があります. これを容易に実現するために, + <filename>PLIST</filename> 中の + <literal>%%OSREL%%</literal>, + <literal>%%PERL_VER%%</literal>, + <literal>%%PERL_VERSION%%</literal> は, + 適切に置き換えられるようになっています. + <literal>%%OSREL%%</literal> の値は, + オペレーティングシステムの数字で表されたリビジョンです + (例えば, <literal>2.2.7</literal>). + <literal>%%PERL_VERSION%%</literal> は perl + のバージョン番号全体(例えば, <literal>5.00502</literal> + )で, <literal>%%PERL_VER%%</literal> はバージョン番号から, + パッチレベルを引いてものです(例えば, + <literal>5.005</literal>).</para> + + <para>他の置き換えが必要であれば, + <makevar>PLIST_SUB</makevar> 変数に <literal> + <replaceable> VAR</replaceable>=<replaceable>VALUE + </replaceable></literal> + という形式のペアのリストを設定することによって, + <filename>PLIST</filename> 中の + <literal>%%<replaceable>VAR</replaceable>%%</literal> は + <replaceable>VALUE</replaceable> に置き換えられます. + 例えば, バージョンに固有の沢山のファイルを + インストールする場合には, <filename>Makefile</filename> + に</para> + <!-- kuriyama - Eng ver has unneeded quote above --> + + <programlisting> +OCTAVE_VERSION= 2.0.13 +PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION}</programlisting> + + <para>と書いて, <filename>PLIST</filename> + 中のバージョン番号が表われるすべてのところに, + <literal>%%OCTAVE_VERSION%%</literal> と書きます. + このようにしておけば, port をアップグレードするときに, + 何十行(ときとして, 何百行)も <filename>PLIST</filename> + を書き替えないですみます.</para> + + <para>この書き換えは (<link linkend="porting-manpages"> + マニュアル</link> の追加も) + <maketarget>do-install</maketarget> と + <maketarget>post-install</maketarget> ターゲット + のあいだに, <makevar>PLIST</makevar> を読み + <makevar>TMPPLIST</makevar> (デフォルトは, <filename> + <makevar>WRKDIR</makevar>/.PLIST.mktmp</filename> ) + に書き込むことによって行なわれます. もし, あなたの port が + <makevar>PLIST</makevar> を実行時に生成するのであれば, + <maketarget>do-install</maketarget> のあいだか, + その前に行うようにしてください. また, + 書きかえられたあとのファイルを編集する必要がある場合には, + <maketarget>post-install</maketarget> で, + <makevar>TMPPLIST</makevar> を書きかえてください.</para> + </sect4> + + <sect4> + <title id="porting-pkgsubdir"><filename>pkg</filename> + サブディレクトリにあるファイル名の変更</title> + + <para><filename>pkg</filename> + サブディレクトリにあるファイルは全て, 変数を + 使用して定義されていますので, 必要であれば + <filename>Makefile</filename> 中で 変更可能です. + いくつかの ports で 一つの <filename>pkg</filename> + サブディレクトリを共有する場合や, 上記のファイルに書き込む + 必要があるときなど, 特に便利です. + (<filename>pkg</filename> + サブディレクトリに直接書き込むのが良くない理由に ついては + <link linkend="porting-wrkdir">WRKDIR + 以外への書きこみ</link> を参照してください.)</para> + + <para>以下が変数名とそのデフォルト値の表です.</para> + + <informaltable frame="none"> + <tgroup cols="2"> + <thead> + <row> + <entry>Variable</entry> + <entry>Default value</entry> + </row> + </thead> + + <tbody> + <row> + <entry><makevar>COMMENT</makevar></entry> + <entry><literal>${PKGDIR}/DESCR</literal></entry> + </row> + + <row> + <entry><makevar>DESCR</makevar></entry> + <entry><literal>${PKGDIR}/DESCR</literal></entry> + </row> + + <row> + <entry><makevar>PLIST</makevar></entry> + <entry><literal>${PKGDIR}/PLIST</literal></entry> + </row> + + <row> + <entry><makevar>PKGINSTALL</makevar></entry> + <entry><literal>${PKGDIR}/PKGINSTALL</literal></entry> + </row> + + <row> + <entry><makevar>PKGDEINSTALL</makevar></entry> + <entry><literal>${PKGDIR}/PKGDEINSTALL</literal></entry> + </row> + + <row> + <entry><makevar>PKGREQ</makevar></entry> + <entry><literal>${PKGDIR}/REQ</literal></entry> + </row> + + <row> + <entry><makevar>PKGMESSAGE</makevar></entry> + <entry><literal>${PKGDIR}/MESSAGE</literal></entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para><makevar>PKG_ARGS</makevar>を上書きせずに, + これらの変数を変更 するようにしてください. + <makevar>PKG_ARGS</makevar>を変更すると これらのファイルは + port から正しく <filename>/var/db/pkg</filename> + にインストールされなくなります.</para> + </sect4> + </sect3> + + <sect3> + <title>ライセンス上の問題</title> + + <para>ソフトウェアによっては制限の厳しい + ライセンスがついてきたり, 法律的に問題があるかもしれません. + (PKPの公開鍵暗号化, ITAR (暗 号化ソフトウェアの輸出) + などが例としてあげられます). それらを + どう扱えばいいかはライセンスの文面によって + さまざまな場合があり ます.</para> + + <note> + <para>ソフトウェア移植者として, + あなたにはライセンスをよく読み, FreeBSD プロジェクトが FTP + または CD-ROM で配布してはいけないソフ + トウェアを配布してしまうことのないよう, + 注意する義務があります. なにか疑問がある場合には, + &a.ports;に聞いてみてください.</para> + </note> + + <para>よく見られるケースに対処するために, + 二つの変数が用意されてい ます:</para> + + <orderedlist> + <listitem> + <para>ソフトウェアに “有償再配布を禁ずる” + という趣旨のライセン スがついてきた場合には + <makevar>NO_CDROM</makevar> + という変数にその理由を記述して ください. + 私たちはこれがついているportはCD-ROMリリースに入 + れないようにしますが, + オリジナルのソースファイルとpackage + はFTPでは取れるようにしておきます.</para> + </listitem> + + <listitem> + <para>もしも, 生成される package + が個々のサイトで独自に構築さ れる必要があったり, + ライセンスによって生成されるバイナリが + 配布できない場合には, <makevar>NO_PACKAGE</makevar> + 変数にその理由を記述してくだ さい. そのような package が + FTP サイトに置かれたり, リリース 時の CD-ROM + へ入らないようにします. ただし, いずれの場合も distfile + は(FTP や CD-ROM に)含まれるようになります.</para> + </listitem> + + <listitem> + <para>Portが, 使用者によっては法律上の問題が生じる時 + (暗号化ソフ トウェアなど), + または“商用利用を禁ずる”とライセンスに書い + てある場合には + <makevar>RESTRICTED</makevar>という変数にその理由を入れ + てください. この場合には, + ソースファイルやpackageは私たちの + FTPサイトにも置かれません.</para> + </listitem> + </orderedlist> + + <note> + <para>GNU一般公有使用許諾書 (GPL) はバージョン1, 2とも + port作成上は何ら問題にはなりません.</para> + </note> + + <note> + <para>もしあなたが,ソースツリー管理者 (committer) + であれば, ソースツリーにこのようなportを入れる際に, + <filename>ports/LEGAL</filename> + ファイルを書き換えるのを忘れないようにし + てください.</para> + </note> + </sect3> + + <sect3> + <title>アップグレード</title> + + <para>Port + のバージョンが原作者からのものに比べて古いことに気がつ + いたら, まずはあなたの持っているportが私たちの最新のもの + (ミラー サイトの <filename>ports/ports-current</filename> + というディレクトリにあります) + であることを確認してください.</para> + + <para>次に, portの <filename>Makefile</filename> + に<makevar>MAINTAINER</makevar> (保守担当者) の + アドレスが書いてある場合には, + その人にメールを出してみましょう. + 保守担当者の人がすでにアップグレードの準備を + しているかもしれま せんし, + (新しいバージョンの安定度に問題があるなど) あえてアッ + プグレードをしない理由があるのかもしれません.</para> + + <para>保守担当者にアップグレードをしてくれと頼まれた場合, + あるいは + そもそもportのMakefileに保守担当者が書いてない場合などは, あ + なたがアップグレードをしてくださると助かります. + その場合にはアッ プグレードをしたのち, + 変更前と変更後のディレクトリの再帰的diff (unified diff と + context diff のどちらでもいいのですが, port のコミッター達は + unified diff のほうを好むようです) をとって送ってください. + (例えば, 変更前のディレクトリが + <filename>superedit.bak</filename> という名前でとってあり, + 変更後のもの が <filename>superedit</filename> + に入っているなら, <command>diff -ruN superedit.bak + superedit</command> の結果を送ってください. ) diff + の出力を見て, すべての変更が正しくなされているか確認して + ください. 変更箇所については, &man.send-pr.1; (カテゴリーは, + <literal>ports</literal>)に diff の出力結果を添えて, + 私たちに送ってもらうのが一 番よいです. commit する際に CVS + に明確に記述しなければならない ので, + 付け加えたり削除したりしたファイルがあったら, それについ + て書いておいてください. もし diff の大きさが 20 KB 程度を + 超えるようであれば, 圧縮したものを uuencode して下さい. + そうでなければそのまま PR に入れるだけでいいです.</para> + + <para>繰り返しになりますが, ports の変更を送るときには, + &man.shar.1; ではなく &man.diff.1; + を使用してください.</para> + </sect3> + + <sect3 id="porting-dads"><!-- kuriyama - why Eng ver has anchor tag? --> + <title>やっていいことといけないこと</title> + + <para>この節では, + ソフトウェアをportする上でよくある落し穴などにつ + いて説明します. このリストを使って, あなた自身が作成した + port のチェックはもとより, PR データベースにある, + 他の人が作成した port のチェックもできます. + あなたがチェックした port について のコメントを <link + linkend="contrib-general">バグ報告と一般的な論評</link> + にしたがって, 送ってください. PR データベースにある port を + チェックすることによって, 私達がそれらを commit + するのを早くし, + あなたが何をしているか理解していることも示します.</para> + + <sect4> + <title>バイナリのstrip</title> + + <para>バイナリは strip してください. + オリジナルのソースがバイナリを strip + してくれる場合は良いですが, そうでない場合には + <literal>post-install</literal> ターゲットを指定して strip + するようにするとよいでしょう. 例えば, + こんな風になります:</para> + + <programlisting> +post-install: + strip ${PREFIX}/bin/xdl</programlisting> + + <para>インストールされた実行形式がすでに strip + されているかどうかは <command>file</command> + コマンドで確認できます. これが`not + stripped'と言わなければ, + stripされているということです.</para> + </sect4> + + <sect4> + <title><makevar>INSTALL_*</makevar> マクロ</title> + + <para>あなた自身の *-install + ターゲットでファイルの正しいモードと + オーナを保証するために, + 必ず<filename>bsd.port.mk</filename>で提供されて + いるマクロを使用してください. + マクロは以下のようなものがあります.</para> + + <itemizedlist> + <listitem> + <para><makevar>${INSTALL_PROGRAM}</makevar> + は実行可能なバイナリを + インストールするコマンドです.</para> + </listitem> + + <listitem> + <para><makevar>${INSTALL_SCRIPT}</makevar> + は実行可能なスクリプトを + インストールするコマンドです.</para> + </listitem> + + <listitem> + <para><makevar>${INSTALL_DATA}</makevar> + は共有可能なデータを + インストールするコマンドです.</para> + </listitem> + + <listitem> + <para><makevar>${INSTALL_MAN}</makevar> + はマニュアルとその他のドキュメ + ントをインストールするコマンドです. + (圧縮はしません)</para> + </listitem> + </itemizedlist> + + <para>これらは基本的に <command>install</command> + コマンドに適当なフラグを与え たものです. + どのようにこれらを使用するかは以下の例を見てください. + </para> + </sect4> + + <sect4 id="porting-wrkdir"> + <title><makevar>WRKDIR</makevar></title> + + <para><makevar>WKRDIR</makevar> + の外のファイルにはなにも書き込まないように <!-- kuriyama - + to files? --> してください. <makevar>WRKDIR</makevar> は + ports のビルド中に書き込こめる + ことが保証されている唯一の場所です(<link + linkend="ports-cd"> CDROM から ports + をコンパイル</link>を参照). <makevar>PKGDIR</makevar> + にあるファイルを修正する必要がある ときには, <link + linkend="porting-pkgsubdir">変数の再定義</link> + によって行ない, 上書きはしないでください.</para> + </sect4> + + <sect4> + <title><makevar>WRKDIRPREFIX</makevar></title> + + <para><makevar>WRKDIRPREFIX</makevar> + を尊重していることを確認してください. 特に, 別の port の + <makevar>WRKDIR</makevar> を参照している + ときには気を付けてください. 正しい場所は, + <filename><makevar> WRKDIRPREFIX</makevar> + <makevar>PORTSDIR</makevar> + /<replaceable>subdir</replaceable>/ + <replaceable>name</replaceable>/work</filename>, です, + <filename><makevar> + PORTSDIR</makevar>/<replaceable>subdir</replaceable>/ + <replaceable>name</replaceable>/work</filename> とか + <filename><makevar> + .CURDIR</makevar>/../../<replaceable>subdir + </replaceable>/<replaceable>name</replaceable>/work + </filename> とかではありません.</para> + + <para>また, 自分で <makevar>WRKDIR</makevar> + 定義するときには, 頭に + <literal>${WRKDIRPREFIX}${.CURDIR}</literal> + が付いている 事を確認してください.</para> + </sect4> + + <sect4 id="porting-versions"> + <title>OS や OS のバージョンの区別</title> + + <para>Port の過程で, 修正や, どのバージョンの UNIX + で動くかによる条件つきコンパイルなどが + 必要なコードに出会うかもしれません. + そのような条件つきコンパイルなどのための + 変更をおこなうときには, FreeBSD 1.x システムへの移植や, + CSRGの4.4BSD, BSD/386, 386BSD, NetBSD, OpenBSD + などの他のBSDシステムへの移植が可能なように, + できるだけ普遍的な変更をおこなうことを + 心がけてください.</para> + + <para>4.3BSD/Reno (1990) およびそれより新しい BSD + 版を古いバージョンと区別するには <literal>BSD</literal> + マクロを利用するのがよいでしょう. これは + <filename><sys/param.h></filename> + で定義されています. + このファイルがすでにインクルードされていればよいのですが, + もしそうでない場合には以下のコードを, その + <filename>.c</filename> + ファイルの適当な場所に加えてください.</para> + + <programlisting> +#if (defined(__unix__) || defined(unix)) && !defined(USG) +#include <sys/param.h> +#endif</programlisting> + + <para>これらの 2 + つのシンボルが定義されているすべてのシステムには + <filename>sys/param.h</filename> があるはずです. もし, + そうでないシステムを発見したら我々にも教えてください. + &a.ports; までメールを送ってください.</para> + + <para>あるいは, GNU の Autoconf + のスタイルを使用することもできます,</para> + + <programlisting> +#ifdef HAVE_SYS_PARAM_H +#include <sys/param.h> +#endif</programlisting> + + <para>この方法を使用するときには, + <filename>Makefile</filename> 中の + <makevar>CFLAGS</makevar>に + <literal>-DHAVE_SYS_PARAM_H</literal> + を加えることを忘れないようにしてください.</para> + + <para>いったん <filename>sys/param.h</filename> + がインクルードされると,</para> + + <programlisting> +#if (defined(BSD) && (BSD >= 199103))</programlisting> + + <para>このようにしてそのコードが 4.3 Net2 コードベース, + またはそれより新しいもの (例: FreeBSD 1.x, 4.3/Reno, + NetBSD 0.9, 386BSD, BSD/386 1.1とそれ以前) + の上でコンパイルされているかを検出できます.</para> + + <programlisting> +#if (defined(BSD) && (BSD >= 199306))</programlisting> + + <para>これは, 4.4コードベース, またはそれより新しいもの (例: + FreeBSD 2.x, 4.4, NetBSD 1.0, BSD/386 2.0とそれ以後) + の上でコンパイルされているかどうかを + 検出するために使用します.</para> + + <para>4.4BSD-Lite2 コードベースでは, <literal>BSD</literal> + マクロの値は <literal>199506</literal> になっています. + これは参考程度の意味合いしかありません. 4.4-Lite ベースの + FreeBSD と 4.4-Lite2 での変更がマージされたバージョンとを + 区別するのに使用するべきものではありません. + この目的のためには, <literal>__FreeBSD__</literal> + マクロをかわりに使用してください.</para> + + <para>以下は控え目に使ってください.</para> + + <itemizedlist> + <listitem> + <para><literal>__FreeBSD__</literal> + はFreeBSDのすべての版で定義されています. 変更が + FreeBSD + だけに適用されるとき以外は使用しないでください. + Portでよくある, <function>strerror()</function> + ではなく <literal>sys_errlist[]</literal> + を使うなどは, FreeBSDでの変更ではなく, BSD + の流儀です.</para> + </listitem> + + <listitem> + <para>FreeBSD 2.xでは <literal>__FreeBSD__</literal> が + <literal>2</literal> と定義されています. + それ以前の版では <literal>1</literal> になっています. + その後の版では, + そのメジャー番号に合うように上がっていきます.</para> + </listitem> + + <listitem> + <para>もし, FreeBSD 1.x システムと FreeBSD 2.x あるいは + FreeBSD 3.x システムを区別する必要があれば, 上で述べた + <literal>BSD</literal>マクロを使用するのが, + 大抵の場合において正しい答です. もし, + FreeBSD特有の変更であれば (<command>ld</command> + を使うときのシェアードライブラリ用のなオプションなど), + <!-- kuriyama - strange translation --> + <literal>__FreeBSD__</literal>を使い <literal>#if + __FreeBSD__ > 1</literal> のようにFreeBSD 2.x + および, それ以降のシステムを検出するのはかまいません. + もし, + 2.0-RELEASE以降のFreeBSDシステムを細かく検出したけれ + ば, 以下を使用することができます.</para> + + <programlisting> +#if __FreeBSD__ >= 2 +#include <osreldate.h> +# if __FreeBSD_version >= 199504 + /* 2.0.5+ release specific code here */ +# endif +#endif</programlisting> + + <informaltable frame="none"> + <tgroup cols="2"> + <thead> + <row> + <entry>Release</entry> + <entry><literal>_FreeBSD_version</literal></entry> + </row> + </thead> + + <tbody> + <row> + <entry>2.0-RELEASE</entry> + <entry>119411</entry> + </row> + + <row> + <entry>2.1-CURRENT's</entry> + <entry>199501, 199503</entry> + </row> + + <row> + <entry>2.0.5-RELEASE</entry> + <entry>199504</entry> + </row> + + <row> + <entry>2.1 以前の 2.2-CURRENT</entry> + <entry>199508</entry> + </row> + + <row> + <entry>2.1.0-RELEASE</entry> + <entry>199511</entry> + </row> + + <row> + <entry>2.1.5 以前の 2.2-CURRENT</entry> + <entry>199512</entry> + </row> + + <row> + <entry>2.1.5-RELEASE</entry> + <entry>199607</entry> + </row> + + <row> + <entry>2.1.6 以前の 2.2-CURRENT</entry> + <entry>199608</entry> + </row> + + <row> + <entry>2.1.6-RELEASE</entry> + <entry>199612</entry> + </row> + + <row> + <entry>2.1.7-RELEASE</entry> + <entry>199612</entry> + </row> + + <row> + <entry>2.2-RELEASE</entry> + <entry>220000</entry> + </row> + + <row> + <entry>2.2.1-RELEASE</entry> + <entry>220000 (2.2-RELEASE と同じです)</entry> + </row> + + <row> + <entry>2.2.1-RELEASE 以後の 2.2-STABLE</entry> + <entry>220000 (これも同じです)</entry> + </row> + + <row> + <entry>texinfo-3.9 以後の 2.2-STABLE</entry> + <entry>221001</entry> + </row> + + <row> + <entry>top 導入以後の 2.2-STABLE</entry> + <entry>221002</entry> + </row> + + <row> + <entry>2.2.2-RELEASE</entry> + <entry>222000</entry> + </row> + + <row> + <entry>2.2.2-RELEASE 以後の 2.2-STABLE</entry> + <entry>222001</entry> + </row> + + <row> + <entry>2.2.5-RELEASE</entry> + <entry>225000</entry> + </row> + + <row> + <entry>2.2.5-RELEASE 以後の 2.2-STABLE</entry> + <entry>225001</entry> + </row> + + <row> + <entry>ldconfig -R 以後の 2.2-STABLE</entry> + <entry>225002</entry> + </row> + + <row> + <entry>2.2.6-RELEASE</entry> + <entry>226000</entry> + </row> + + <row> + <entry>2.2.7-RELEASE</entry> + <entry>227000</entry> + </row> + + <row> + <entry>2.2.7-RELEASE 以後の 2.2-STABLE</entry> + <entry>227001</entry> + </row> + + <row> + <entry>semctl(2) 変更後の 2.2-STABLE</entry> + <entry>227002</entry> + </row> + + <row> + <entry>2.2.8-RELEASE</entry> + <entry>228000</entry> + </row> + + <row> + <entry>2.2.8-RELEASE 以後の 2.2-STABLE</entry> + <entry>228001</entry> + </row> + + <row> + <entry>mount(2) 変更以前の 3.0-CURRENT</entry> + <entry>300000</entry> + </row> + + <row> + <entry>mount(2) 変更以後の 3.0-CURRENT</entry> + <entry>300001</entry> + </row> + + <row> + <entry>semctl(2) 変更以後の 3.0-CURRENT</entry> + <entry>300002</entry> + </row> + + <row> + <entry>ioctl 引数変更後の 3.0-CURRENT</entry> + <entry>300003</entry> + </row> + + <row> + <entry>ELF 移行後の 3.0-CURRENT</entry> + <entry>300004</entry> + </row> + + <row> + <entry>3.0-RELEASE</entry> + <entry>300005</entry> + </row> + + <row> + <entry>3.0-RELEASE 以後の 3.0-CURRENT</entry> + <entry>300006</entry> + </row> + + <row> + <entry>3/4 の分岐後の 3.0-STABLE</entry> + <entry>300007</entry> + </row> + + <row> + <entry>3.1-RELEASE</entry> + <entry>310000</entry> + </row> + + <row> + <entry>3.1-RELEASE 以後の 3.1-STABLE</entry> + <entry>310001</entry> + </row> + + <row> + <entry>3/4 の分岐後の 4.0-CURRENT</entry> + <entry>400000</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </listitem> + </itemizedlist> + + <note> + <para>(2.2-STABLE は, 2.2.5-RELESE 以後, + “2.2.5-STABLE” と呼ばれることがあります.) + 見ての通り, + これは年・月というフォーマットになっていましたが, + バージョン 2.2 から, + より直接的にメジャー/マイナー番号を使う + ように変更になりました. + 並行していくつかのブランチ(枝分かれし + たバージョン)を開発する場合には, + リリースされた日付でそれらの + リリースを分類することが不可能だからです. (あなたが今 + port を作成するときに, 古い -CURRENT 達について心配 + する必要はありません. + これは参考のために挙げられているにすぎま せん.)</para> + </note> + + <para>これまで, 何百ものportが作られてきましたが, + <literal>__FreeBSD__</literal> が正しく使われたのは, + 1つか2つの場合だけでしょう. + 以前のportが誤った場所でそのマクロを使っているからと + いって, それをまねする理由はありません.</para> + </sect4> + + <sect4> + <title><filename>bsd.port.mk</filename> の後に書くこと</title> + + <para><literal>.include <bsd.port.mk></literal> + の行の後には なにも書かないようにしてください. + 大抵の場合は <filename>Makefile</filename> の + 中程のどこかで, <filename>bsd.port.pre.mk</filename> を + include して, 最後に <filename>bsd.port.pre.mk</filename> + を include することによって避けることができます.</para> + + <note> + <para><filename> + pre.mk</filename>/<filename>post.mk</filename> + のペアか <filename>bsd.port.mk</filename> + だけのどちらかだけを include してください. + 2つを混ぜないでください.</para> + </note> + + <para>前者は, いくつかの変数の定義だけ をして, + <filename>Makefile</filename> でのテストに使用し, + 後者は残りを定義します.</para> + + <para> + 以下は <filename>bsd.port.pre.mk</filename> + で定義される重要な変数です. (これは, すべてではありません. + 完全なリストは <filename>bsd.port.mk</filename> + を参照してください.) + </para> + + <informaltable frame="none"> + <tgroup cols="2"> + <thead> + <row> + <entry>変数名</entry> + <entry>解説</entry> + </row> + </thead> + + <tbody> + <row> + <entry><makevar>ARCH</makevar></entry> + <entry><command>uname -m</command> で返される + アーキテクチャ. (例, <literal>i386</literal>). + </entry> + </row> + + <row> + <entry><makevar>OPSYS</makevar></entry> + <entry><command>uname -s</command> で返される + オペレーティングシステム (例, + <literal>FreeBSD</literal>).</entry> + </row> + + <row> + <entry><makevar>OSREL</makevar></entry> + <entry>オペレーティングシステムの + リリースバージョン + (例., <literal>2.1.5</literal>, + <literal>2.2.7</literal>).</entry> + </row> + + <row> + <entry><makevar>OSVERSION</makevar></entry> + <entry>数字形式のオペレーティングシステム + のバージョン, + 上記の <link linkend="porting-versions"><literal> + __FreeBSD_version</literal></link> + と同じです.</entry> + </row> + + <row> + <entry><makevar>PORTOBJFORMAT</makevar></entry> + <entry>システムのオブジェクト + フォーマット (<literal>aout</literal> あるいは + <literal>elf</literal>).</entry> + </row> + + <row> + <entry><makevar>LOCALBASE</makevar></entry> + <entry>“local” ツリーのベース. + (例, <literal>/usr/local/</literal>). + </entry> + </row> + + <row> + <entry><makevar>X11BASE</makevar></entry> + <entry>“X11” ツリーのベース. + (例, <literal>/usr/X11R6/</literal>). + </entry> + </row> + + <row> + <entry><makevar>PREFIX</makevar></entry> + <entry> portsのインストール先 + (<link linkend="porting-prefix"> + <makevar>PREFIX</makevar>について</link>を参照). + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <note> + <para><makevar>USE_IMAKE</makevar>, + <makevar>USE_X_PREFIX</makevar> あるいは + <makevar>MASTERDIR</makevar> + などの変数を定義する必要がある場合には, + <filename>bsd.port.pre.mk</filename> + を include する前に定義してください. + 他のものは, <filename>bsd.port.pre.mk</filename> + の前でも後でもかまいません.</para> + </note> + + <para>以下は <filename>bsd.port.pre.mk</filename> + の後に書けるものの例です:</para> + + <programlisting> +# no need to compile lang/perl5 if perl5 is already in system +.if ${OSVERSION} > 300003 +BROKEN= perl is in system +.endif + +# only one shlib version number for ELF +.if ${PORTOBJFORMAT} == "elf" +TCL_LIB_FILE= ${TCL_LIB}.${SHLIB_MAJOR} +.else +TCL_LIB_FILE= ${TCL_LIB}.${SHLIB_MAJOR}.${SHLIB_MINOR} +.endif + +# software already makes link for ELF, but not for a.out +post-install: +.if ${PORTOBJFORMAT} == "aout" + ${LN} -sf liblinpack.so.1.0 ${PREFIX}/lib/liblinpack.so +.endif</programlisting> + </sect4> + + <sect4> + <title>付加的ドキュメント</title> + + <para>普通のマニュアルや info + ファイルのほかにユーザにとって有用だ + と思えるようなドキュメントがある場合には, + <filename><makevar> PREFIX</makevar>/share/doc</filename> + の下にインストールしてく ださい. これは前記と同様, + <maketarget>post-install</maketarget>ターゲットの + 中からするのがいいでしょう.</para> + + <para>まず, あなたのportのために新しいディレクトリを作りま + す. どのportのドキュメントか簡単にわかるような名前にする必 + 要がありますので, 普通は <makevar>PKGNAME</makevar> + からバージョ ン番号を除いた部分を使うといいでしょう. + もちろん, ユーザが異 + なるバージョンのものを同時に使うことが予想される port + の場合 には, <makevar>PKGNAME</makevar> + をそのまま使ってかまいません.</para> + + <para>ユーザが <filename>/etc/make.conf</filename> + でこの部分を禁止するために <makevar>NOPORTDOCS</makevar> + という変数をセットしている場合には, + これらのドキュメントが + インストールされないようにしてください. こんな具合です. + </para> + + <programlisting> +post-install: +.if !defined(NOPORTDOCS) + ${MKDIR}${PREFIX}/share/doc/xv + ${INSTALL_MAN} ${WRKSRC}/docs/xvdocs.ps ${PREFIX}/share/doc/xv +.endif</programlisting> + + <para>これらのファイルを <filename>pkg/PLIST</filename> + に入れるのを忘れないよ うにしてください. + (packageが<filename>/etc/make.conf</filename>内の + 変数を読む方法は今のところ存在しませんので, + <makevar>NOPORTDOCS</makevar> + については気にしないでください.)</para> + + <para>インストール時に <filename>pkg/MESSAGE</filename> + ファイルを利用して, メッセージを表示することができます. + 詳細は <link linkend="porting-message">pkg/MESSAGE を使う + </link> の節を参照してください.</para> + + <!-- kuriyama - note below is not exist in Jap ver, but Eng ver has it. why? --> + <note> + <para><filename>MESSAGE</filename> ファイルは + <filename>pkg/PLIST</filename> に加える必要はありま + せん.</para> + </note> + </sect4> + + <sect4> + <title><makevar>DIST_SUBDIR</makevar></title> + + <para><filename>/usr/ports/distfiles</filename> + ディレクトリ内をあまり散らかさ ないようにしてください. + たくさんのファイルを取ってくるport や, + 数は少なくてもほかのportのファイルと混同されるおそれが + あるファイル (<filename>Makefile</filename> など) + がある場合には, <makevar>DIST_SUBDIR</makevar> に port + の名前 (<makevar>PKGNAME</makevar> + からバージョン番号を取った部分を 使うといいでしょう) + を入れてください. すると, + <makevar>DISTDIR</makevar>がデフォルトの + <filename>/usr/ports/distfiles</filename> から <filename> + /usr/ports/distfiles/<makevar>DIST_SUBDIR</makevar> + </filename>に変更され, + 取ってきたファイルはすべてそのサブディレクトリの中に置か + れるようになります.</para> + + <para>また, + ファイルを取ってくるときにバックアップサイトとして使わ + れる <filename>ftp.freebsd.org</filename> + のディレクトリ名にもこの変数の 値が使われます. + (<makevar>DISTDIR</makevar>を明示的に指定し た場合には, + ローカルのファイルを置くところは変わりますが, こ + のサイトのディレクトリ名は変わりませんので, 必ず + <makevar>DIST_SUBDIR</makevar>を使うようにしてください.)</para> + + <note> + <para>この変数はMakefile中で明示的に指定された + <makevar>MASTER_SITES</makevar> + には影響しないことに注意して ください.</para> + </note> + </sect4> + + <sect4> + <title>RCS文字列</title> + + <para>RCS + が特別な意味を与えている文字列をパッチ内に入れないように + してください. + ファイルを私たちのソースツリーに入れる時にこれら + の文字列はCVSによって書き換えられてしまい, + あとでまたパッチ + を使おうとした時にうまくいかないことがあります. + RCS文字列は ドル記号 (<literal>$</literal>) + で囲まれており, <literal>$Id</literal> や + <literal>$RCS</literal> などで始まり ます.</para> + </sect4> + + <sect4> + <title>パッチ作成上の注意</title> + + <para><command>diff</command>の再帰 (<option>-r</option>) + フラグを使って再帰的なパッ チを作るのは大変結構なのですが, + でき上がったパッチは必ず目で + チェックして余計なゴミが入っていないことを確認してくださ + い. よくあるのはバックアップファイル同士の変更点, あるいは + <command>Imake</command> や GNU + <command>configure</command> を使うソフトウェアの + <filename>Makefile</filename> + の変更点が入っている場合などです. また, + <filename>configure.in</filename> を編集して, + <command>autoconf</command> を使って + <command>configure</command> を作り直す ときには, + <command>configure</command> の diff は含めずに (それらは, + 数千行になることもしばしばです), + <literal>USE_AUTOCONF=yes</literal> を定義して, + <filename>configure.in</filename> の diff + をとってください.</para> + + <para>ファイルをまるごと消す場合にはパッチを使わずに + <maketarget>post-extract</maketarget> + ターゲットで消す方が簡単です. できあがった + 差分に満足したら, それらをソースのファイルごとに別々の + パッチファイルに分割してください.</para> + </sect4> + + <sect4 id="porting-prefix"> + <title><makevar>PREFIX</makevar></title> + + <para>なるべく port は <makevar>PREFIX</makevar> + に対する相対パス + にインストールすることができるように心がけてください. + (この変数の値は <makevar>USE_X_PREFIX</makevar>か + <makevar>USE_IMAKE</makevar>が指定してある時には + <makevar>X11BASE</makevar> + (デフォルト<filename>/usr/X11R6</filename>), + そうでない場合には<makevar>LOCALBASE</makevar> + (デフォルト<filename>/usr/local</filename>) + にセットされます.)</para> + + <para>サイトによってフリーソフトウェアが + インストールされる場所が 違いますので, ソース内で + <filename>/usr/local</filename> や + <filename>/usr/X11R6</filename> + を明示的に書かないようにしてください. X のプログラムで + <command>imake</command> を使うものについては, + これは問題に はなりません. それ以外の場合には, + ソース中のMakefileやスク <!-- kuriyama - imake is command + --> リプトで <filename>/usr/local</filename> + (imakeを使わないXのプログラ ムは + <filename>/usr/X11R6</filename>) と書いてあるところを + <makevar>PREFIX</makevar> に書き換えてください. この値は + portのコンパイル, + およびインストール時に自動的に環境変数として + 下位makeに渡されます.</para> + + <para><makevar>USE_X_PREFIX</makevar>は本当に必要な時 + (つまり, X のライブラリなどとリンクしたり, + <makevar>X11BASE</makevar> 以下にある + ファイルを参照したりする必要がある時) + 以外には設定しないでください.</para> + + <para>変数 <makevar>PREFIX</makevar> の値は port の + Makefile やユーザの環境で変更することもできます. しかし, + 個々の port が Makefile + でこの変数の値を明示的に設定することはなるべくしない + でください.</para> + + <para>また, 他の port + からインストールされるプログラムやファイル + を指定するときには, 上で述べた変数を使用してください. + 例えば, <command>less</command> のフルパスを + <literal>PAGER</literal> というマクロに入れた い場合は, + コンパイラに + <literal>-DPAGER=\"/usr/local/bin/less\"</literal> + と渡すかわりに <programlisting> + -DPAGER=\"${PREFIX}/bin/less\"</programlisting> + (Xを使うportの時は <programlisting> + -DPAGER=\"${LOCALBASE}/bin/less\"</programlisting> ) + を渡し てください. こうしておけば, `/usr/local' + がまるごとどこか他 の場所に移してあるサイトでも, + あなたのportがそのまま使える 可能性が高くなります.</para> + </sect4> + + <sect4> + <title>ディレクトリ構成</title> + + <para>インストール時には <makevar>PREFIX</makevar> + の正しいサブディ + レクトリにファイルを置くように心がけてください. + ソフトウェア によっては新しいディレクトリを + 一つ作ってファイルを全部それに + 入れてしまうものがありますが, それはよくありません. また, + バ イナリ, ヘッダファイルとマニュアル以外のすべてを + <filename>lib</filename> + というディレクトリに入れてしまうportもあります が, + これもBSD的なファイルシステム構成からいうと正しくありま + せん. これは以下のように分散すべきです. + <filename>etc</filename> にセッ + トアップ/コンフィグレーションファイル, + <filename>libexec</filename> に 内部で使用されるプログラム + (コマンドラインから呼ばれることの ないコマンド), + <filename>sbin</filename> に管理者用のコマンド, + <filename>info</filename> に GNU Info 用のドキュメント, + そして <filename>share</filename> + にアーキテクチャに依存しないファイルが入り ます. + 詳細については man &man.hier.7; を見てくださ い. + <filename>/usr</filename>の構成方針はほとんどそのまま + <filename>/usr/local</filename>にもあてはまります. USENET + “ニュース”を 扱う ports は例外です. これらは, + ファイルのインストール先として + <filename><makevar>PREFIX</makevar>/news</filename> + を使用します.</para> + </sect4> + + <sect4 id="porting-cleaning"> + <title>空のディレクトリの除去</title> + + <para>ports は デインストール(削除) の際には, + 自分自身を消去したあとに, (ディレクトリの) + 除去をするようにしてください. これは, 大抵の場合 + <literal>@dirrm</literal> の行を ports + が作成するすべてのディレクトリについて + 加えることによって実現できます. 親ディレクトリは, + 子ディレクトリを先に消さないと + 消せないことに気をつけて下さい.</para> + + <programlisting> + : +lib/X11/oneko/pixmaps/cat.xpm +lib/X11/oneko/sounds/cat.au + : +@dirrm lib/X11/oneko/pixmals +@dirrm lib/X11/oneko/sounds +@dirrm lib/X11/oneko</programlisting> + + <para>といった感じです.</para> + + <para>しかし, ときとして, 他の port + をディレクトリを共有しているために + <literal>@dirrm</literal> がエラーを返すことがあります. + <command>rmdir</command> を <literal>@unexec</literal> + から呼びだすことによって, 警告(warning)なしで + 空のディレクトリのみを削除することができます: + </para> + + <programlisting> +@unexec rmdir %D/share/doc/gimp 2>/dev/null || true</programlisting> + + <para> + これを使えば, たとえ, 他の port がファイルを + インストールしていて, <filename><makevar> + PREFIX</makevar>/share/doc/gimp</filename> + が空でない場合でも エラーメッセージは表示されませんし, + <command>pkg_delete</command> + が異常終了することもありません.</para> + </sect4> + + <sect4> + <title>UID</title> + + <para>もしあなたの + portがインストールされるシステム上に特定のユー + ザを必要とする場合は, <filename>pkg/INSTALL</filename> + スクリプトから <command>pw</command> + コマンドを実行して自動的にそのユーザを追加するよ + うにしてください. <filename>net/cvsup-mirror</filename> + の portが参考になるでしょう.</para> + + <para>もしあなたの port が, バイナリのパッケージとしてとして + インストールされるときにも, + コンパイルされたときと同じユーザー/グループ ID + を使わなければならないのなら, 50 から 99 の間で空いている + UID を選んで登録してください. + <filename>japanese/Wnn</filename> の port + が参考になるでしょう.</para> + + <para>既にシステムや他の portで利用されている + UIDを使わないように 十分注意してください. 現在の 50から + 99までの間の UIDは以下の とおりです.</para> + + <programlisting> +majordom:*:54:54:Majordomo Pseudo User:/usr/local/majordomo:/nonexistent +cyrus:*:60:60:the cyrus mail server:/nonexistent:/nonexistent +gnats:*:61:1:GNATS database owner:/usr/local/share/gnats/gnats-db:/bin/sh +uucp:*:66:66:UUCP pseudo-user:/var/spool/uucppublic:/usr/libexec/uucp/uucico +xten:*:67:67:X-10 daemon:/usr/local/xten:/nonexistent +pop:*:68:6:Post Office Owner (popper):/nonexistent:/nonexistent +wnn:*:69:7:Wnn:/nonexistent:/nonexistent +ifmail:*:70:66:Ifmail user:/nonexistent:/nonexistent +pgsql:*:70:70:PostgreSQL pseudo-user:/usr/local/pgsql:/bin/sh +ircd:*:72:72:IRCd hybrid:/nonexistent:/nonexistent +alias:*:81:81:QMail user:/var/qmail/alias:/nonexistent +qmaill:*:83:81:QMail user:/var/qmail:/nonexistent +qmaild:*:82:81:QMail user:/var/qmail:/nonexistent +qmailq:*:85:82:QMail user:/var/qmail:/nonexistent +qmails:*:87:82:QMail user:/var/qmail:/nonexistent +qmailp:*:84:81:QMail user:/var/qmail:/nonexistent +qmailr:*:86:82:QMail user:/var/qmail:/nonexistent +msql:*:87:87:mSQL-2 pseudo-user:/var/db/msqldb:/bin/sh</programlisting> + + <para>このリストを最新の状態に保つためにも, + この範囲の UID や GID を予約するような port を作ったり, + 既存の port にそのような改変を行って我々に送るときには, + UID の予約に関する注意書きをつけてください.</para> + </sect4> + + <sect4> + <title>合理的な port</title> + + <para><filename>Makefile</filename> + は単純かつ適切であるべきです. もし, + <filename>Makefile</filename> を数行短かくできたり, + もっと読みやすくできるのであれば, そうしてください. + 例えば, shell の <literal>if</literal> 構文を使う代りに, + make の <literal>.if</literal> 構文を使う, + <makevar>EXTRACT*</makevar> + の再定義で代用できるのであれば, + <maketarget>do-extract</maketarget> を再定義しない, + <literal>CONFIGURE_ARGS += + --prefix=${PREFIX}</literal> とするかわりに, + <makevar>GNU_CONFIGURE</makevar> とする, などです.</para> + </sect4> + + <sect4> + <title><makevar>CFLAGS</makevar> の尊重</title> + + <para><makevar>CFLAGS</makevar> 変数は尊重すべきです. その + port がこれを無視するのであれば, + <literal>NO_PACKAGE=ignores cflags</literal> を + <filename>Makefile</filename> に加えてください.</para> + </sect4> + + <sect4> + <title>コンフィグレーション(設定)ファイル</title> + + <para>もしあなたの port が設定ファイルを + <filename><makevar>PREFIX</makevar>/etc</filename> + に置く必要がある場合には, それを単純にインストールしたり, + <filename>pkg/PLIST</filename> + に加えては<emphasis>いけません</emphasis>. + こうしてしまうと, <command>pkg_delete</command> が + ユーザが苦労して作ったファイルを消してしまったり, 新しく + インストールすると上書きされてしまったりします.</para> + + <para>代りに, 見本となるファイルを suffix ( + <filename><replaceable> + filename</replaceable>.sample</filename> + が良いでしょう) を付けて インストールして, <link + linkend="porting-message"> message</link> を表示して, + ソフトウエアを動かす前に, ユーザがそのファイル + をコピーして編集をしなければならないことを知らせましょう. + </para> + </sect4> + + <sect4> + <title>Portlint</title> + + <para>送付や commit をする前に <link + linkend="porting-portlint"><command>portlint</command></link> + を使ってチェックしましょう.</para> + </sect4> + + <sect4> + <title>フィードバック</title> + + <para>Portを作るためにソフトウェアに変更を加えたら, + なるべく原作者にその旨を伝えてパッチ等を送ってください. + これらが次のリリースに取り入れられれば, + アップグレードが楽になります.</para> + </sect4> + + <sect4> + <title>その他諸々</title> + + <para><filename>pkg/DESCR</filename>, + <filename>pkg/COMMENT</filename>, + <filename>pkg/PLIST</filename> などのファイルは, + それぞれ2重にチェックしてください. + 再検討してもっと良い記述があれば, + それに置きかえてください.</para> + + <para>GNU General Public License + (GNU一般公有使用許諾)のコピーは + (すでにあるので)コピーしないでください, + おねがいします.</para> + + <para>法律に関することには, 十分注意をはらってください. + 私達に法律に反するような形でソフトフェアの配布をさせない + でください!</para> + </sect4> + + <sect4> + <title>困ったら....</title> + + <para>私たちに質問を送る前に, + 既存のportの例と<filename>bsd.port.mk</filename>を + ちゃんと読んでください! <!-- smiley + --><emphasis>;)</emphasis></para> + + <para>それでもわからないことがあったら, + 一人で悩まないでどんどん 質問してください! <!-- smiley + --><emphasis>:)</emphasis></para> + </sect4> + </sect3> + + <sect3 id="porting-samplem"> + <title><filename>Makefile</filename> のお手本</title> + + <para>これはportの <filename>Makefile</filename> + を作る際のお手本です. かぎかっこ + ([])内のコメントは忘れずに取ってください.</para> + + <para>変数の順番, 段落の間の空行など, + <filename>Makefile</filename> を作るときはなるべくこ + の形式にしたがってください. + この形式は重要な情報が簡単に見つけられるように + 設計されています. <link + linkend="porting-portlint">portlint</link> を使って + <filename>Makefile</filename> をチェックすることが + 推奨されています.</para> + + <programlisting> +[ヘッダ -- どのようなportのMakefileかすぐにわかるようになっています] +# New ports collection makefile for: xdvi +# Version required: pl18 ["1.5alpha" みたいなのでも結構です] +[この Makefile の最初の版が作成された日付です. この port をアップグ + レードするときには変えないでください.] +# Date created: 26 May 1995 +[このソフトウェアを最初に FreeBSD に port した人の名前, つまり, + この Makefile の最初の版を書いた人です. この port をアップグレー + ドするとき, この行も変えないでください.] +# Whom: Satoshi Asami <asami@FreeBSD.ORG> +# +# $Id$ +[ ^^^^ この部分は, CVS ツリーに入れる時に自動的に RCS の ID 文字列に + 置き換えられます.] +# + +[Port自体, およびオリジナルのソースを取ってくるところを記述する部分. + 最初は必ずDISTNAME, そして必要ならPKGNAME, CATEGORIES, 続いて + MASTER_SITESがおかれ, さらに MASTER_SITE_SUBDIR がおかれることもあり + ます. そのあと, EXTRACT_SUFX か DISTFILES を指定することも可能です] +DISTNAME= xdvi +PKGNAME= xdvi-pl18 +CATEGORIES= print +[MASTER_SITE_* マクロを使用しない場合は, +最後のスラッシュを忘れないように ("/")!] +MASTER_SITES= ${MASTER_SITE_XCONTRIB} +MASTER_SITE_SUBDIR= applications +[ソースファイルが標準の ".tar.gz" 形式でない時にこれを使いましょう] +EXTRACT_SUFX= .tar.Z + +[配布パッチのセクション -- ない場合もあります] +PATCH_SITES= ftp://ftp.sra.co.jp/pub/X11/japanese/ +PATCHFILES= xdvi-18.patch1.gz xdvi-18.patch2.gz + +[保守責任者 -- これは *必ず* 必要です. 担当者 (あなた) 自身, あるいは + 担当者に素早く連絡をとれる人のアドレスを書いてください. どうしてもこ + こに自分のアドレスを書くのがいやな人は "ports@FreeBSD.ORG" と書いて + もいいです] +MAINTAINER= asami@FreeBSD.ORG + +[依存するport -- ない場合もあります] +RUN_DEPENDS= gs:${PORTSDIR}/print/ghostscript +LIB_DEPENDS= Xpm.5:${PORTSDIR}/graphics/xpm + +[ここには標準のbsd.port.mkの変数で, 上のどれにもあてはまらないものを + 書きます] +[コンフィグレーション, コンパイル, インストールなどの時に質問をする + なら...] +IS_INTERACTIVE=yes +[${DISTNAME}以外のディレクトリにソースが展開されるなら...] +WRKSRC= ${WRKDIR}/xdvi-new +[配布されているパッチが ${WRKSRC} に対する相対パスで作られてい + い場合にこの変数の指定が必要かも...] +PATCH_DIST_STRIP= -p1 +[GNU autoconfによって生成された "configure" スクリプトを走らせたいなら...] +GNU_CONFIGURE= yes +[/usr/bin/makeでなく, GNU makeを使わないといけないなら...] +USE_GMAKE= yes +[これがXのアプリケーションで "xmkmf -a" を走らせたいなら...] +USE_IMAKE= yes +[などなど] + +[下の方のルールで使う非標準の変数] +MY_FAVORITE_RESPONSE= "yeah, right" + +[そして, 特別なターゲット, 使用順に] +pre-fetch: + i go fetch something, yeah + +post-patch: + i need to do something after patch, great + +pre-install: + and then some more stuff before installing, wow + +[最後には必ず] +.include <bsd.port.mk></programlisting> + </sect3> + + <sect3 id="porting-pkgname"> + <title>Packageの名前</title> + + <para>Package の名前は以下のルールにしたがってつけてください. + こ れは package のディレクトリを見やすくするためで, + 無秩序な名前 + がたくさん並んでいるとユーザが使いづらくなるのでは + という心配か らです. + (FTPサイトなどにはたくさんpackageがありますからね.)</para> + + <para>Packageの名前は以下のようにしてください. + <filename><replaceable> + 言語-</replaceable>名前<replaceable>-オプション + </replaceable><replaceable>バージョン.番号 + </replaceable></filename></para> + + <para><makevar>DISTNAME</makevar> + が上記の形式になっていない場合に は, + <makevar>PKGNAME</makevar> をそのようにしてください.</para> + + <orderedlist> + <listitem> + <para>FreeBSD + はユーザの慣れ親しんだ言語のサポートに力を入れて います. + 特定の言語のためのportのpackage名には + <replaceable>言語-</replaceable> に ISO-639 + で定義されている言語名の略称を入れ てください. 例えば, + 日本語なら <literal>ja</literal>, ロシア語なら + <literal>ru</literal>, ベト ナム語なら + <literal>vi</literal>, 中国語なら <literal>zh</literal>, + 韓国語ならば <literal>ko</literal>, ドイツ 語なら + <literal>de</literal>, といった具合です.</para> + </listitem> + + <listitem> + <para><filename>名前</filename> + の部分は原則的にはすべて英小文字 を使います. + 例外はたくさんのプログラムが入っている巨大なport + の場合で, XFree86 (ほんとにあるんですよ) やImageMagickな + どがこれにあたります. そうでない場合には, + 名前の大文字を小文 字に (少なくとも最初の一字だけは) + 変えてください. もし, + 大文字であることが重要な場合(例えば, 1文字の名前, + <literal>R</literal> とか <literal>V</literal>)には, + あなたの裁量で大文字を使うのも良いでしょう. Perl 5 + のモジュールでは, 頭に <literal>p5-</literal> を付け, + 2重コロン (<literal>::</literal>) + のセパレータをハイフン( <literal>-</literal> ) + に置きかえるしきたりになっています. 例えば, + <literal>Data::Dumper</literal> は + <literal>p5-Data-Dumper</literal> になります. また, その + ソフトウェアの名前として通常使われるものに番号, + ハイフン, あ るいは下線が入っている場合には, + それらを使うことも構いません + (<literal>kinput2</literal> など).</para> + </listitem> + + <listitem> + <para>コンパイル時に環境変数や <command>make</command> + の引数などで <link linkend="porting-masterdir"> + ハードコードされたデフォルト </link> + を変えてコンパイルできる場合, + <replaceable>-compiled.specifics</replaceable> + にそのコンパイル時のデフォルトを入れてください + (ハイフンはあってもなくてもかまいません). 用紙のサイズ, + あるいはフォントの解像度などがこれにあたります.</para> + </listitem> + + <listitem> + <para>バージョン番号は数字とアルファベットからなり, + ピリオド (.) で区切ります. + アルファベットは二文字以上続けてはいけませ ん. + ただ一つの例外は「パッチレベル」を意味する + <literal>pl</literal> で, それ 以外にバージョン番号が + まったくついていない場合にのみ使うことがで + きます.</para> + </listitem> + </orderedlist> + + <para>では, <makevar>DISTNAME</makevar>を正しい + <makevar>PKGNAME</makevar>に直す例を見てみましょう:</para> + + <informaltable frame="none"> + <tgroup cols="3"> + <thead> + <row> + <entry>DISTNAME</entry> + <entry>PKGNAME</entry> + <entry>理由</entry> + </row> + </thead> + + <tbody> + <row> + <entry>mule-2.2.2.</entry> + <entry>mule-2.2.2</entry> + <entry>まったく問題なし</entry> + </row> + + <row> + <entry>XFree86-3.1.2</entry> + <entry>XFree86-3.1.2</entry> + <entry>同上</entry> + </row> + + <row> + <entry>EmiClock-1.0.2</entry> + <entry>emiclock-1.0.2</entry> + <entry>プログラム一つだけの時は小文字のみ</entry> + </row> + + <row> + <entry>gmod1.4</entry> + <entry>gmod-1.4</entry> + <!-- kuriyama - need to be fixed --> + <entry>`<名前>' のあとにハイフンが必要</entry> + </row> + + <row> + <entry>xmris.4.0.2</entry> + <entry>xmris-4.0.2</entry> + <entry>同上</entry> + </row> + + <row> + <entry>rdist-1.3alpha</entry> + <entry>rdist-1.3a</entry> + <entry><literal>alpha</literal>のような文字列は使えない + </entry> + </row> + + <row> + <entry>es-0.9-beta1</entry> + <entry>es-0.9b1</entry> + <entry>同上</entry> + </row> + + <row> + <entry>v3.3beta021.src</entry> + <entry>tiff-3.3</entry> + <entry>なんなんでしょう ;)</entry> + </row> + + <row> + <entry>tvtwm</entry> + <entry>tvtwm-pl11</entry> + <entry>バージョン番号は必ず必要</entry> + </row> + + <row> + <entry>piewm</entry> + <entry>piewm-1.0</entry> + <entry>同上</entry> + </row> + + <row> + <entry>xvgr-2.10pl1</entry> + <entry>xvgr-2.10.1</entry> + <entry><literal>pl</literal> + が使えるのは他にバージョン番号がない場合のみ</entry> + </row> + + <row> + <entry>gawk-2.15.6</entry> + <entry>ja-gawk-2.15.6</entry> + <entry>日本語バージョン</entry> + </row> + + <row> + <entry>psutils-1.13</entry> + <entry>psutils-letter-1.13</entry> + <entry>コンパイル時に用紙のサイズを指定</entry> + </row> + + <row> + <entry>pkfonts</entry> + <entry>pkfonts300-1.0</entry> + <entry>300dpiフォント用のpackage</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>オリジナルのソースにまったくバージョン情報が見当たらず, + また原作 + 者が新しいバージョンをリリースする可能性が低いときには, + バージョ ン番号として <literal>1.0</literal> + を使えばいいでしょう (上記のpiewmの例がこ れにあたります). + そうでない場合には, 原作者に聞くか, 日付 + (<literal><replaceable> + 年</replaceable>.<replaceable>月</replaceable> + .<replaceable>日</replaceable></literal>) + を使うなどしてください.</para> + </sect3> + + <sect3 id="porting-categories"> + <title>カテゴリ</title> + + <para>すでに御存知のように, ports はいくつかのカテゴリに + 分類されています. これを有効に利用するためには, port を + 行う人々とユーザが, そろぞれのカテゴリが何であるか, + どのようにしてカテゴリに分類するかを理解する必要が + あります.</para> + + <sect4> + <title>現在のカテゴリのリスト</title> + + <para>まず, これが現在の port のカテゴリーのリストです. + アスタリスク(<literal>*</literal>) が付いているものは, + バーチャル(<emphasis>virtual</emphasis>) カテゴリです -- + これらには対応するサブディレクトリが port + ツリーにはありません.</para> + <!-- kuriyama - don't use " - - " as literal --> + + <note> + <para>バーチャルカテゴリでないものは, + そのサブディレクトリ内の <filename>pkg/COMMENT</filename> + に1行の記述があります + (例, <filename>archivers/pkg/COMMENT</filename>).</para> + </note> + + <informaltable frame="none"> + <tgroup cols="2"> + <thead> + <row> + <entry>Category</entry> + <entry>Description</entry> + </row> + </thead> + + <tbody> + <row> + <entry><filename>afterstep*</filename></entry> + <entry>Ports to support AfterStep window manager</entry> + </row> + + <row> + <entry><filename>archivers</filename></entry> + <entry>Archiving tools.</entry> + </row> + + <row> + <entry><filename>astro</filename></entry> + <entry>Astronomical ports.</entry> + </row> + + <row> + <entry><filename>audio</filename></entry> + <entry>Sound support.</entry> + </row> + + <row> + <entry><filename>benchmarks</filename></entry> + <entry>Benchmarking utilities.</entry> + </row> + + <row> + <entry><filename>biology</filename></entry> + <entry>Biology-related software.</entry> + </row> + + <row> + <entry><filename>cad</filename></entry> + <entry>Computer aided design tools.</entry> + </row> + + <row> + <entry><filename>chinese</filename></entry> + <entry>Chinese language support.</entry> + </row> + + <row> + <entry><filename>comms</filename></entry> + <entry>Communication software. Mostly software to talk to + your serial port.</entry> + </row> + + <row> + <entry><filename>converters</filename></entry> + <entry>Character code converters.</entry> + </row> + + <row> + <entry><filename>databases</filename></entry> + <entry>Databases.</entry> + </row> + + <row> + <entry><filename>deskutils</filename></entry> + <entry>Things that used to be on the desktop before + computers were invented.</entry> + </row> + + <row> + <entry><filename>devel</filename></entry> + <entry>Development utilities. Do not put libraries here just + because they are libraries—unless they truly don't + belong to anywhere else, they shouldn't be in this + category.</entry> + </row> + + <row> + <entry><filename>editors</filename></entry> + <entry>General editors. Specialized editors go in the + section for those tools (e.g., a mathematical-formula + editor will go in <filename>math</filename>).</entry> + </row> + + <row> + <entry><filename>elisp</filename></entry> + <entry>Emacs-lisp ports.</entry> + </row> + + <row> + <entry><filename>emulators</filename></entry> + <entry>Emulators for other operating systems. Terminal + emulators do <emphasis>not</emphasis> belong + here—X-based ones should go to + <filename>x11</filename> and text-based ones to either + <filename>comms</filename> or <filename>misc</filename>, + depending on the exact functionality.</entry> + </row> + + <row> + <entry><filename>games</filename></entry> + <entry>Games.</entry> + </row> + + <row> + <entry><filename>german</filename></entry> + <entry>German language support.</entry> + </row> + + <row> + <entry><filename>graphics</filename></entry> + <entry>Graphics utilities.</entry> + </row> + + <row> + <entry><filename>japanese</filename></entry> + <entry>Japanese language support.</entry> + </row> + + <row> + <entry><filename>kde*</filename></entry> + <entry>Ports that form the K Desktop Environment + (kde).</entry> + </row> + + <row> + <entry><filename>korean</filename></entry> + <entry>Korean language support.</entry> + </row> + + <row> + <entry><filename>lang</filename></entry> + <entry>Programming languages.</entry> + </row> + + <row> + <entry><filename>mail</filename></entry> + <entry>Mail software.</entry> + </row> + + <row> + <entry><filename>math</filename></entry> + <entry>Numerical computation software and other utilities + for mathematics.</entry> + </row> + + <row> + <entry><filename>mbone</filename></entry> + <entry>MBone applications.</entry> + </row> + + <row> + <entry><filename>misc</filename></entry> + <entry>Miscellaneous utilities—basically things that + doesn't belong to anywhere else. This is the only category + that should not appear with any other non-virtual + category. If you have <literal>misc</literal> with + something else in your <makevar>CATEGORIES</makevar> line, + that means you can safely delete <literal>misc</literal> + and just put the port in that other subdirectory!</entry> + </row> + + <row> + <entry><filename>net</filename></entry> + <entry>Miscellaneous networking software.</entry> + </row> + + <row> + <entry><filename>news</filename></entry> + <entry>USENET news software.</entry> + </row> + + <row> + <entry><filename>offix*</filename></entry> + <entry>Ports from the OffiX suite.</entry> + </row> + + <row> + <entry><filename>palm</filename></entry> + <entry>Software support for the 3Com Palm(tm) series.</entry> + </row> + + <row> + <entry><filename>perl5*</filename></entry> + <entry>Ports that require perl version 5 to run.</entry> + </row> + + <row> + <entry><filename>plan9*</filename></entry> + <entry>Various programs from Plan9.</entry> + </row> + + <row> + <entry><filename>print</filename></entry> + <entry>Printing software. Desktop publishing tools + (previewers, etc.) belong here too.</entry> + </row> + + <row> + <entry><filename>python*</filename></entry> + <entry>Software written in python.</entry> + </row> + + <row> + <entry><filename>russian</filename></entry> + <entry>Russian language support.</entry> + </row> + + <row> + <entry><filename>security</filename></entry> + <entry>Security utilities.</entry> + </row> + + <row> + <entry><filename>shells</filename></entry> + <entry>Command line shells.</entry> + </row> + + <row> + <entry><filename>sysutils</filename></entry> + <entry>System utilities.</entry> + </row> + + <row> + <entry><filename>tcl75*</filename></entry> + <entry>Ports that use tcl version 7.5 to run.</entry> + </row> + + <row> + <entry><filename>tcl76*</filename></entry> + <entry>Ports that use tcl version 7.6 to run.</entry> + </row> + + <row> + <entry><filename>tcl80*</filename></entry> + <entry>Ports that use tcl version 8.0 to run.</entry> + </row> + + <row> + <entry><filename>tcl81*</filename></entry> + <entry>Ports that use tcl version 8.1 to run.</entry> + </row> + + <row> + <entry><filename>textproc</filename></entry> + <entry>Text processing utilities. It does not include + desktop publishing tools, which go to print/.</entry> + </row> + + <row> + <entry><filename>tk41*</filename></entry> + <entry>Ports that use tk version 4.1 to run.</entry> + </row> + + <row> + <entry><filename>tk42*</filename></entry> + <entry>Ports that use tk version 4.2 to run.</entry> + </row> + + <row> + <entry><filename>tk80*</filename></entry> + <entry>Ports that use tk version 8.0 to run.</entry> + </row> + + <row> + <entry><filename>tk81*</filename></entry> + <entry>Ports that use tk version 8.1 to run.</entry> + </row> + + <row> + <entry><filename>vietnamese</filename></entry> + <entry>Vietnamese language support.</entry> + </row> + + <row> + <entry><filename>windowmaker*</filename></entry> + <entry>Ports to support the WindowMaker window + manager</entry> + </row> + + <row> + <entry><filename>www</filename></entry> + <entry>Software related to the World Wide Web. HTML language + support belong here too.</entry> + </row> + + <row> + <entry>x11</entry> + <entry>The X window system and friends. This category is + only for software that directly support the window system. + Do not put regular X applications here. If your port is + an X application, define <makevar>USE_XLIB</makevar> + (implied by <makevar>USE_IMAKE</makevar>) and put it in + appropriate categories. Also, many of them go into other + <filename>x11-*</filename> categories (see below).</entry> + </row> + + <row> + <entry><filename>x11-clocks</filename></entry> + <entry>X11 clocks.</entry> + </row> + + <row> + <entry><filename>x11-fm</filename></entry> + <entry>X11 file managers.</entry> + </row> + + <row> + <entry><filename>x11-fonts</filename></entry> + <entry>X11 fonts and font utilities.</entry> + </row> + + <row> + <entry><filename>x11-toolkits</filename></entry> + <entry>X11 toolkits.</entry> + </row> + + <row> + <entry><filename>x11-wm</filename></entry> + <entry>X11 window managers.</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </sect4> + + <sect4> + <title>適切なカテゴリの選択</title> + + <para>多くのカテゴリに重なるので, どれを '第一' + カテゴリにするかを決めなければならないことが + たびたびあるでしょう. これを + うまく決めるルールがいくつかあります. + 以下はその優先順のリストで, 優先度の高いものから + 低いものの順に書いてあります.</para> + + <itemizedlist> + <listitem> + <para>言語特有のカテゴリがまず最初です. + 例えば日本語の X11 のフォントをインストールする + port の場合, <makevar>CATEGORIES</makevar> 行は + <literal>japanese x11-fonts</literal> となるでしょう.</para> + <!-- kuriyama - Eng. ver has x11 category. why? --> + </listitem> + + <listitem> + <para>より特徴的なカテゴリが, 一般的なカテゴリより + 優先されます. 例えば, HTML エディタの場合は + <literal>www editors</literal> となり, + 逆順にはしないでください. また, port が + <literal>mail</literal>, <literal>mbone</literal>, + <literal>news</literal>, <literal>security</literal>, + <literal>www</literal> のいづれかに属するとには, + <literal>net</literal> は必要ありません.</para> + </listitem> + + <listitem> + <para><literal>x11</literal> を第2カテゴリにするのは, + 第1カテゴリが自然言語の場合のみにしてください. 特に X + のアプリケーションには <literal>x11</literal> + を指定<emphasis>しない</emphasis>でください.</para> + </listitem> + + <listitem> + <para>もし, あなたの port が他のどのカテゴリにも + 属しないばあいには, <literal>misc</literal> + にしてください.</para> + </listitem> + </itemizedlist> + + <para>もし, あなたがカテゴリについて自信が持てない場合には, + そのことを <command>send-pr</command> するときに + 書き加えてください. そうすれば import するまえに + それについて議論できます. (もしあなたが commiter であれば, + そのことを &a.ports に送って, 先に議論 + するようにしてください — 新しい port + が間違ったカテゴリに import されて, + すぐ移動されることが多いので.)</para> + </sect4> + </sect3> + + <sect3> + <title>このドキュメントと ports システムの変更</title> + + <para>もしあなたが, たくさんの ports の保守を + しているのであれば, &a.ports メーリングリストの内容を + フォロウすることを考えてください. Ports + のしくみについての重要な変更点はここに アナウンスされます. + 最新の変更点については, いつでも, <ulink + url="http://www.FreeBSD.ORG/cgi/cvsweb.cgi/src/share/mk/bsd.port.mk"> + the bsd.port.mk CVS log</ulink> + で詳細な情報を得ることができます.</para> + <!-- kuriyama - the はまずいだろ --> + </sect3> + + <sect3> + <title>やっとおしまい!</title> + + <para>いやはや, 長い文章ですみません. + ここまで読んでくださった方に は感謝, 感謝でございます. <!-- + smiley --><emphasis>(_ _)</emphasis></para> + + <para>さあ, portの作り方がわかったところで, + 世界中のソフトウェア をport化しましょう. + FreeBSDプロジェクトに貢献するには, それ + がもっとも簡単な方法です! <emphasis + remap=tt>:)</emphasis></para> + </sect3> + </sect2> + + <sect2> + <title>金銭, ハードウェアまたはインターネットアクセス</title> + + <para>FreeBSD プロジェクトの目的を進めるための寄付や, + 私たちと同じような ボランティアの細く長い ! 努力を, + 私たちは常に喜んで受け入れています. + また一般的に私たちは自分達で + 周辺機器を買う資金が不足しているため, + 周辺機器のサポートを充実させるのに + ハードウェアの寄付はとても重要です.</para> + + <sect3 id="donations"> + <title>資金の寄付</title> + + <para>FreeBSD プロジェクトは501(C3) (非営利) 企業ではないため, + いかなる寄 + 付に対しても特別な税金の優遇措置を提供することができません. + このような 寄付はプロジェクトを代表して FreeBSD, Inc + により感謝をもって受け入れら れるでしょう.</para> + + <para>FreeBSD, Inc.は FreeBSD + プロジェクトの推進とプロジェクトに企業とし + ての最小限の体裁を持たせることを目的として, 1995年の初めに + &a.jkh; と &a.dg; により設立されました. + 寄付されたすべての資金は (最終的に FreeBSD, + Inc.によりもたらされるであろうすべての利益も同様に) + プロジェク + トの目標を推進するためだけに使われるでしょう.</para> + + <para>支払い先を FreeBSD, Inc. とした小切手を, + 次の住所気付けで送ってください:</para> + + <address> + <otheraddr>FreeBSD, Inc.</otheraddr> + <otheraddr>c/o Jordan Hubbard</otheraddr> + <street>4041 Pike Lane, Suite F</street> + <city>Concord</city> + <state>CA</state>, <postcode>94520</postcode> + </address> + + <para>[現在 私書箱が開設されるまで一時的に Walnut Creek CDROM + の住所を使用]</para> + + <para>電信振替は次の所まで直接送れるでしょう:</para> + + <address> + <otheraddr>Bank Of America</otheraddr> + <otheraddr>Concord Main Office</otheraddr> + <pob>P.O. Box 37176</pob> + <city>San Francisco</city> + <state>CA</state>, <postcode>94137-5176</postcode> + + <otheraddr>Routing #: 121-000-358</otheraddr> + <otheraddr>Account #: 01411-07441 (FreeBSD, Inc.)</otheraddr> + </address> + + <para>寄付に関することは全て電子メールもしくは上記 FreeBSD, + Inc. の住所宛の郵政省メールにて Jordan Hubbard + <email>jkh@FreeBSD.org</email> + までお送りくださるようお願いします.</para> + + <para>もし <link linkend="donors">寄贈者ギャラリー</link> + の節で匿名を希望される 方は, 寄付の際にその旨お伝えください. + Thanks!</para> + </sect3> + + <sect3> + <title>ハードウェアの寄贈</title> + + <para>FreeBSD プロジェクトは, + 次の3つのカテゴリのどんなハードウェアの寄贈 も, + 喜んで受け付けます:</para> + + <itemizedlist> + <listitem> + <para>ディスクドライブ, + メモリまたは完全なシステムといった一般用途のハー + ドウェアは, <emphasis>資金の寄付</emphasis>の節にある + FreeBSD, Inc. の住所まで送っ てください.</para> + </listitem> + + <listitem> + <para>進行中の受け入れテストのための + ハードウェアが必要とされていま す. + 新たなリリース毎に適切な逆行テストができるように, + 私たちは現在, FreeBSD + がサポートするすべてのコンポーネントの + テストラボを設置しよう としています. 私たちにはまだ, + たくさんの重要な部品 (ネットワークカード, + マザーボードなど) が不足していますので, + このような寄贈をしたいと思って いるならば, &a.dg; + へコンタクトしてどの部品がまだ必要とされているか + の情報を得てください.</para> + </listitem> + + <listitem> + <para>現在 FreeBSD にサポートされていないハードウェアで, + サポートに追 加して欲しいもの. + 私たちが新しいハードウェアを受けとる前にそのタスクを + 引き受けてくれる開発者を探す必要があるため, + その部品を送る前に &a.core; + にコンタクトを取ってください.</para> + </listitem> + </itemizedlist> + </sect3> + + <sect3> + <title>インターネットアクセスの寄付</title> + + <para>私たちは常に FTP, WWW や <command>cvsup</command> + の新しいミラーサイトを募集しています. + ミラーサイトになりたい場合には the FreeBSD project + administrators <email>admin@FreeBSD.ORG</email> + にコンタクトを取って, 詳し + い情報を手に入れてください.</para> + </sect3> + </sect2> + </sect1> + + <sect1 id="donors"> + <title>寄贈者ギャラリー</title> + + <para>FreeBSD プロジェクトは次の寄贈者に恩義を受けており, + ここに公表して 感謝の意を表したいと思います.</para> + + <itemizedlist> + <listitem> + <para><emphasis> + セントラルサーバプロジェクトへの寄贈者:</emphasis></para> + + <para>次に挙げる個人および企業からは, + セントラルサーバマシンのための 部品の寄贈を頂いており, + それによって <hostid + role="fqdn">freefall.freebsd.org</hostid> + をリプレースして新たに FreeBSD + プロジェクトのセントラルサーバマシンを + 構築することができました:</para> + + <itemizedlist> + <listitem> + <para>Ade Barkah <email>mbarkah@freebsd.org</email> + と彼の所属する <ulink + URL="http://www.hemi.com">Hemisphere Online</ulink> + は, <emphasis>Pentium Pro (P6) 200Mhz CPU</emphasis> + を寄贈してくださいました.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.asacomputers.com">ASA + Computers</ulink> は, <emphasis>Tyan 1662 + マザーボード</emphasis> + を寄贈してくださいました.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.via.net">ViaNet + Communications</ulink> の Joe McGuckin + <email>joe@via.net</email> は, <emphasis>Kingston + イーサネットコントローラ</emphasis> + を寄贈してくださいました.</para> + </listitem> + + <listitem> + <para>Jack O'Neill + <email>jack@diamond.xtalwind.net</email> は, + <emphasis>NCR 53C875 SCSI コントローラカード</emphasis> + を寄贈してくださいました.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.Alameda.net">Alameda + Networks</ulink> の Ulf Zimmermann + <email>ulf@Alameda.net</email> は, <emphasis>128MB + のメモリ</emphasis>, そして <emphasis>4 GB + のディスクドライブと匡体</emphasis> + を寄贈してくださいました.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para><emphasis>直接的な資金提供:</emphasis></para> + + <para>次に挙げる個人および企業からは FreeBSD + プロジェクトに対する直接的な + 資金提供を頂いております:</para> + + <itemizedlist> + <listitem> + <para>Annelise Anderson + <email>ANDRSN@HOOVER.STANFORD.EDU</email></para> + </listitem> + + <listitem> + <para>Matt Dillon <email>dillon@best.net</email></para> + </listitem> + + <listitem> + <para><ulink URL="http://www.epilogue.com/"> + Epilogue Technology Corporation</ulink></para> + </listitem> + + <listitem> + <para>Sean Eric Fagan</para> + </listitem> + + <listitem> + <para>Don Scott Wilde</para> + </listitem> + + <listitem> + <para>Gianmarco Giovannelli + <email>gmarco@masternet.it</email></para> + </listitem> + + <listitem> + <para>Josef C. Grosch <email>joeg@truenorth.org</email></para> + </listitem> + + <listitem> + <para>Robert T. Morris</para> + </listitem> + + <listitem> + <para>Chuck Robey <email>chuckr@freebsd.org</email></para> + </listitem> + + <listitem> + <para><ulink URL="http://www.imagescape.com"> + Imaginary Landscape, LLC.</ulink> + の Kenneth P. Stox + <email>ken@stox.sa.enteract.com</email></para> + </listitem> + + <listitem> + <para>Dmitry S. Kohmanyuk <email>dk@dog.farm.org</email></para> + </listitem> + + <listitem> + <para>日本の + <ulink URL="http://www.cdrom.co.jp/">Laser5</ulink> + はいくつかの FreeBSD CD の販売利益の一部を + 寄付してくれました.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.mmjp.or.jp/fuki/"> + 蕗出版</ulink> は, <emphasis>はじめての FreeBSD + </emphasis> の売り上げの一部を FreeBSD プロジェクト及び + XFree86 プロジェクトへ寄付してくれました.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.ascii.co.jp/">アスキー</ulink> + は FreeBSD 関連の書籍の売り上げの一部を FreeBSD + プロジェクト及び FreeBSD 友の会へ寄付してくれました. + </para> + </listitem> + + <listitem> + <para><ulink URL="http://www.yokogawa.co.jp/"> + 横河電機株式会社</ulink> からは FreeBSD + プロジェクトへ多大な寄付をいただきました.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.buffnet.net/">BuffNET</ulink></para> + </listitem> + + <listitem> + <para><ulink url="http://www.pacificsolutions.com/">Pacific + Solutions</ulink></para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para><emphasis>ハードウェアの寄贈者:</emphasis></para> + + <para>次に挙げる個人および企業からは, + テストやデバイスドライバの開発 / サポート + のためのハードウェアの寄贈を頂いております:</para> + + <itemizedlist> + <listitem> + <para>Walnut Creek CDROM は, + ネットワークへのアクセスおよび + 他のハードウェアリソースの寄贈はいうまでもなく, + 開発に使うための Pentium P5-90 と 486/DX2-66 EISA/VL + のシステム数台を 提供してくださいました.</para> + </listitem> + + <listitem> + <para>TRW Financial Sysytems社は, PC 130台, 68 GB + のファイルサーバ 3台, 12のイーサネット, + ディスクレスコードのデバッグをおこなうための ルータ + 2台及び ATM スイッチを提供してくださいました. また, + 彼らは 2, 3人の FreeBSD ハッカーを雇って, FreeBSD + に専念させて くださっております. + ありがとうございます!</para> + </listitem> + + <listitem> + <para>Dermot McDonnell は, 東芝 XM3401B CD-ROM ドライブを + 寄贈してくださいました. その CD-ROM ドライブは現在 + freefall で使用されています.</para> + </listitem> + + <listitem> + <para>&a.chuck; は, 実験用のフロッピーテープストリーマを + 寄付してくださいました.</para> + </listitem> + + <listitem> + <para>Larry Altneu <email>larry@ALR.COM</email> と + &a.wilko;は, <devicename>wt</devicename> + ドライバを改良するために Wangtek と Archive の QIC-02 + テープドライブを提供してくださいました.</para> + </listitem> + + <listitem> + <para>Ernst Winter <email>ewinter@lobo.muc.de</email> は, + このプロジェクトへ 2.88 MB + のフロッピードライブを提供してくださいました. + うまくいけば, + これでフロッピーディスクドライバを書き直すための + プレッシャーが増えるでしょう. <!-- smiley -->;-)</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.tekram.com">Tekram + Technologies</ulink> は NCR ドライバや AMD + ドライバと自社のカードの逆行テストのため FAST/ULTRA + SCSI ホストアダプタ DC-390, DC-390U, DC-390F を + 各1枚提供してくださいました. また, フリーな OS + のためのドライバの ソースを自社の FTP サーバ <ulink + URL="ftp://ftp.tekram.com/scsi/FreeBSD"> + ftp://ftp.tekram.com/scsi/FreeBSD</ulink> + で公開されていることも 称賛に値するでしょう.</para> + </listitem> + + <listitem> + <para>Larry M. Augustin <email>lma@varesearch.com</email> + は Symbios Sym8751S SCSI + カードを寄贈してくださっただけでなく, Ultra-2 や LVD + をサポートする次期チップ Sym53c895 のものを含む + データブックのセットと, 最新の Symbios SCSI + チップが持つ先進的機能を 安全に使う方法について書かれた + 最新のプログラミングマニュアルも 寄贈してくださいました. + 本当にありがとうございます !</para> + </listitem> + + <listitem> + <para>Christoph Kukulies <email>kuku@freebsd.org</email> + は, IDE CD-ROM ドライバ開発用の FX120 12 倍速 Mitsumi + CD-ROM ドライブ を提供してくださいました.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para><emphasis>特筆すべき寄贈者:</emphasis></para> + + <itemizedlist> + <listitem> + <para><ulink URL="http://www.cdrom.com">Walnut Creek + CDROM</ulink> は, + 言い表せないほど多くの寄付をしてくださいました (詳細は + <link linkend="history">FreeBSD 小史</link>を参照). + 特に, 私たちのもともとのプライマリ開発マシンである + <hostid role="fqdn">freefall.FreeBSD.ORG</hostid>, + テストおよびビルドマシンである <hostid + role="fqdn">thud.FreeBSD.ORG</hostid> + で使用しているハードウェアに対し 感謝したいと思います. + また彼らには, 数年にわたる色々な貢献者への資金提供や, + インターネット への T1 + コネクションの無制限使用を提供して + 頂いた恩義があります.</para> + </listitem> + + <listitem> + <para><ulink + URL="http://www.interface-business.de">interface + business GmbH, Dresden</ulink> は, &a.joerg; + を根気よく サポートしてくださいました. 彼は本職より + FreeBSD の仕事を好みがちであり, 彼個人の接続があまりに + 遅くなったり途切れたりして仕事にならない時は必ず + interface business の (非常に高価な) EUnet + インターネット接続に頼ったものです...</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.bsdi.com">Berkeley Software + Design, Inc.</ulink> は, 同社の DOS + エミュレータのコードを BSD コミュ + ニティ全体に対して提供してくれました. このコードは, + <emphasis>dosemu</emphasis> + コマンドに利用されています.</para> + </listitem> + </itemizedlist> + </listitem> + </itemizedlist> + </sect1> + + <sect1> + <title>コアチームの卒業生</title> + + <para>次に挙げる人々は()で記した期間, FreeBSD + コアチームのメンバーでした. FreeBSD + プロジェクトにおける彼らの努力に感謝の意を表します. + </para> + + <para><emphasis>だいたいの年代順:</emphasis></para> + + <itemizedlist> + <listitem> + <para>Guido van Rooij (1995 - 1999)</para> + </listitem> + + <listitem> + <para>John Dyson (1993 - 1998)</para> + </listitem> + + <listitem> + <para>Nate Williams (1992 - 1996)</para> + </listitem> + + <listitem> + <para>Rod Grimes (1992 - 1995)</para> + </listitem> + + <listitem> + <para>Andreas Schulz (1992 - 1995)</para> + </listitem> + + <listitem> + <para>Geoff Rehmet (1993 - 1995)</para> + </listitem> + + <listitem> + <para>Paul Richards (1992 - 1995)</para> + </listitem> + + <listitem> + <para>Scott Mace (1993 - 1994)</para> + </listitem> + + <listitem> + <para>Andrew Moore (1993 - 1994)</para> + </listitem> + + <listitem> + <para>Christoph Robitschko (1993 - 1994)</para> + </listitem> + + <listitem> + <para>J. T. Conklin (1992 - 1993)</para> + </listitem> + </itemizedlist> + </sect1> + + <sect1> + <title>BSD派生ソフトウェアへのコントリビュータ</title> + + <para>このソフトウェアは最初は William F. Jolitz の 386BSD release + 0.1 から派生しましたが, オリジナルの 386BSD + に固有のコードはほとんど 残っていません. + このソフトウェアは基本的にはカリフォルニア大学 バークレイ校の + Computer Science Research Group (CSRG) とその共同研究者 + たちによる 4.4BSD-Lite リリースから再実装されました.</para> + + <para>また, NetBSD や OpenBSD の一部も FreeBSD + に取り込まれています. したがって私たちは NetBSD と OpenBSD + へ貢献した人々すべてに感謝します.</para> + </sect1> + + <sect1 id="contrib-additional"> + <title>その他の FreeBSD へのコントリビュータ</title> + + <para>(名前でアルファベット順に):</para> + + <!-- kuriyama - eng ver still have simokawa entity? --> +<!-- kuriyama - Eng. ver doesn't have this entity? ++ <item>MANTANI Nobutaka <tt><htmlurl url='mailto:nobutaka@nobutaka.com' ++ name='<nobutaka@nobutaka.com>'></tt> + --> +<!-- kuriyama - Eng. ver doesn't have this entity? ++ <item>Satsuki FUJISHIMA <tt><htmlurl url='mailto:k5@respo.or.jp' ++ name='<k5@respo.or.jp>'></tt> + --> +<!-- kuriyama - Eng. ver doesn't have this entity? ++ <item>SUGIMURA Takashi <tt><htmlurl url='mailto:sugimura@jp.FreeBSD.ORG' ++ name='<sugimura@jp.FreeBSD.ORG>'></tt> + --> + <itemizedlist> + <listitem> + <para>ABURAYA Ryushirou <email>rewsirow@ff.iij4u.or.jp</email></para> + </listitem> + + <listitem> + <para>AMAGAI Yoshiji <email>amagai@nue.org</email></para> + </listitem> + + <listitem> + <para>Aaron Bornstein <email>aaronb@j51.com</email></para> + </listitem> + + <listitem> + <para>Aaron Smith <email>aaron@tau.veritas.com</email></para> + </listitem> + + <listitem> + <para>Achim Patzner <email>ap@noses.com</email></para> + </listitem> + + <listitem> + <para>Ada T Lim <email>ada@bsd.org</email></para> + </listitem> + + <listitem> + <para>Adam Baran <email>badam@mw.mil.pl</email></para> + </listitem> + + <listitem> + <para>Adam Glass <email>glass@postgres.berkeley.edu</email></para> + </listitem> + + <listitem> + <para>Adam McDougall <email>mcdouga9@egr.msu.edu</email></para> + </listitem> + + <listitem> + <para>Adrian Colley <email>aecolley@ois.ie</email></para> + </listitem> + + <listitem> + <para>Adrian Hall <email>adrian@ibmpcug.co.uk</email></para> + </listitem> + + <listitem> + <para>Adrian Mariano <email>adrian@cam.cornell.edu</email></para> + </listitem> + + <listitem> + <para>Adrian Steinmann <email>ast@marabu.ch</email></para> + </listitem> + + <listitem> + <para>Adrian T. Filipi-Martin + <email>atf3r@agate.cs.virginia.edu</email></para> + </listitem> + + <listitem> + <para>Ajit Thyagarajan <email>unknown</email></para> + </listitem> + + <listitem> + <para>Akio Morita + <email>amorita@meadow.scphys.kyoto-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Akira SAWADA <email>unknown</email></para> + </listitem> + + <listitem> + <para>Akira Watanabe + <email>akira@myaw.ei.meisei-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Akito Fujita <email>fujita@zoo.ncl.omron.co.jp</email></para> + </listitem> + + <listitem> + <para>Alain Kalker + <email>A.C.P.M.Kalker@student.utwente.nl</email></para> + </listitem> + + <listitem> + <para>Alan Bawden <email>alan@curry.epilogue.com</email></para> + </listitem> + + <listitem> + <para>Alan Cox <email>alc@cs.rice.edu</email></para> + </listitem> + + <listitem> + <para>Alec Wolman <email>wolman@cs.washington.edu</email></para> + </listitem> + + <listitem> + <para>Aled Morris <email>aledm@routers.co.uk</email></para> + </listitem> + + <listitem> + <para>Alex <email>garbanzo@hooked.net</email></para> + </listitem> + + <listitem> + <para>Alex D. Chen + <email>dhchen@Canvas.dorm7.nccu.edu.tw</email></para> + </listitem> + + <listitem> + <para>Alex G. Bulushev <email>bag@demos.su</email></para> + </listitem> + + <listitem> + <para>Alex Le Heux <email>alexlh@funk.org</email></para> + </listitem> + + <listitem> + <para>Alexander B. Povolotsky <email>tarkhil@mgt.msk.ru</email></para> + </listitem> + + <listitem> + <para>Alexander Leidinger + <email>netchild@wurzelausix.CS.Uni-SB.DE</email></para> + </listitem> + + <listitem> + <para>Alexandre Snarskii <email>snar@paranoia.ru</email></para> + </listitem> + + <listitem> + <para>Alistair G. Crooks <email>agc@uts.amdahl.com</email></para> + </listitem> + + <listitem> + <para>Allan Saddi <email>asaddi@philosophysw.com</email></para> + </listitem> + + <listitem> + <para>Allen Campbell <email>allenc@verinet.com</email></para> + </listitem> + + <listitem> + <para>Amakawa Shuhei <email>amakawa@hoh.t.u-tokyo.ac.jp</email></para> + </listitem> + + <listitem> + <para>Amancio Hasty <email>hasty@star-gate.com</email></para> + </listitem> + + <listitem> + <para>Amir Farah <email>amir@comtrol.com</email></para> + </listitem> + + <listitem> + <para>Amy Baron <email>amee@beer.org</email></para> + </listitem> + + <listitem> + <para>Anatoly A. Orehovsky <email>tolik@mpeks.tomsk.su</email></para> + </listitem> + + <listitem> + <para>Anatoly Vorobey <email>mellon@pobox.com</email></para> + </listitem> + + <listitem> + <para>Anders Nordby <email>nickerne@nome.no</email></para> + </listitem> + + <listitem> + <para>Anders Thulin <email>Anders.X.Thulin@telia.se</email></para> + </listitem> + + <listitem> + <para>Andras Olah <email>olah@cs.utwente.nl</email></para> + </listitem> + + <listitem> + <para>Andre Albsmeier + <email>Andre.Albsmeier@mchp.siemens.de</email></para> + </listitem> + + <listitem> + <para>Andre Oppermann <email>andre@pipeline.ch</email></para> + </listitem> + + <listitem> + <para>Andreas Haakh <email>ah@alman.robin.de</email></para> + </listitem> + + <listitem> + <para>Andreas Kohout <email>shanee@rabbit.augusta.de</email></para> + </listitem> + + <listitem> + <para>Andreas Lohr <email>andreas@marvin.RoBIN.de</email></para> + </listitem> + + <listitem> + <para>Andreas Schulz <email>unknown</email></para> + </listitem> + + <listitem> + <para>Andreas Wetzel <email>mickey@deadline.snafu.de</email></para> + </listitem> + + <listitem> + <para>Andreas Wrede <email>andreas@planix.com</email></para> + </listitem> + + <listitem> + <para>Andres Vega Garcia <email>unknown</email></para> + </listitem> + + <listitem> + <para>Andrew Atrens <email>atreand@statcan.ca</email></para> + </listitem> + + <listitem> + <para>Andrew Gillham <email>gillham@andrews.edu</email></para> + </listitem> + + <listitem> + <para>Andrew Gordon <email>andrew.gordon@net-tel.co.uk</email></para> + </listitem> + + <listitem> + <para>Andrew Herbert <email>andrew@werple.apana.org.au</email></para> + </listitem> + + <listitem> + <para>Andrew J. Korty <email>ajk@purdue.edu</email></para> + </listitem> + + <listitem> + <para>Andrew L. Moore <email>alm@mclink.com</email></para> + </listitem> + + <listitem> + <para>Andrew McRae <email>amcrae@cisco.com</email></para> + </listitem> + + <listitem> + <para>Andrew Stevenson <email>andrew@ugh.net.au</email></para> + </listitem> + + <listitem> + <para>Andrew Timonin <email>tim@pool1.convey.ru</email></para> + </listitem> + + <listitem> + <para>Andrew V. Stesin <email>stesin@elvisti.kiev.ua</email></para> + </listitem> + + <listitem> + <para>Andrew Webster <email>awebster@dataradio.com</email></para> + </listitem> + + <listitem> + <para>Andrey Zakhvatov <email>andy@icc.surw.chel.su</email></para> + </listitem> + + <listitem> + <para>Andy Farkas <email>andyf@speednet.com.au</email></para> + </listitem> + + <listitem> + <para>Andy Valencia <email>ajv@csd.mot.com</email></para> + </listitem> + + <listitem> + <para>Andy Whitcroft <email>andy@sarc.city.ac.uk</email></para> + </listitem> + + <listitem> + <para>Angelo Turetta <email>ATuretta@stylo.it</email></para> + </listitem> + + <listitem> + <para>Anthony C. Chavez <email>magus@xmission.com</email></para> + </listitem> + + <listitem> + <para>Anthony Yee-Hang Chan <email>yeehang@netcom.com</email></para> + </listitem> + + <listitem> + <para>Anton Berezin <email>tobez@plab.ku.dk</email></para> + </listitem> + + <listitem> + <para>Antti Kaipila <email>anttik@iki.fi</email></para> + </listitem> + + <listitem> + <para>Are Bryne <email>are.bryne@communique.no</email></para> + </listitem> + + <listitem> + <para>Ari Suutari <email>ari@suutari.iki.fi</email></para> + </listitem> + + <listitem> + <para>Arjan de Vet <email>devet@IAEhv.nl</email></para> + </listitem> + + <listitem> + <para>Arne Henrik Juul <email>arnej@Lise.Unit.NO</email></para> + </listitem> + + <listitem> + <para>Assar Westerlund <email>assar@sics.se</email></para> + </listitem> + + <listitem> + <para>Atsushi Furuta <email>furuta@sra.co.jp</email></para> + </listitem> + + <listitem> + <para>Atsushi Murai <email>amurai@spec.co.jp</email></para> + </listitem> + + <listitem> + <para>Bakul Shah <email>bvs@bitblocks.com</email></para> + </listitem> + + <listitem> + <para>Barry Bierbauch <email>pivrnec@vszbr.cz</email></para> + </listitem> + + <listitem> + <para>Barry Lustig <email>barry@ictv.com</email></para> + </listitem> + + <listitem> + <para>Ben Hutchinson <email>benhutch@xfiles.org.uk</email></para> + </listitem> + + <listitem> + <para>Ben Jackson <email>unknown</email></para> + </listitem> + + <listitem> + <para>Ben Smithurst <email>ben@scientia.demon.co.uk</email></para> + </listitem> + + <listitem> + <para>Ben Walter <email>bwalter@itachi.swcp.com</email></para> + </listitem> + + <listitem> + <para>Benjamin Lewis <email>bhlewis@gte.net</email></para> + </listitem> + + <listitem> + <para>Bernd Rosauer <email>br@schiele-ct.de</email></para> + </listitem> + + <listitem> + <para>Bill Kish <email>kish@osf.org</email></para> + </listitem> + + <listitem> + <para>Bill Trost <email>trost@cloud.rain.com</email></para> + </listitem> + + <listitem> + <para>Blaz Zupan <email>blaz@amis.net</email></para> + </listitem> + + <listitem> + <para>Bob Van Valzah <email>Bob@whitebarn.com</email></para> + </listitem> + + <listitem> + <para>Bob Willcox <email>bob@luke.pmr.com</email></para> + </listitem> + + <listitem> + <para>Boris Staeblow <email>balu@dva.in-berlin.de</email></para> + </listitem> + + <listitem> + <para>Boyd R. Faulkner <email>faulkner@asgard.bga.com</email></para> + </listitem> + + <listitem> + <para>Brad Karp <email>karp@eecs.harvard.edu</email></para> + </listitem> + + <listitem> + <para>Bradley Dunn <email>bradley@dunn.org</email></para> + </listitem> + + <listitem> + <para>Brandon Gillespie <email>brandon@roguetrader.com</email></para> + </listitem> + + <listitem> + <para>&a.wlloyd</para> + </listitem> + + <listitem> + <para>Bob Wilcox <email>bob@obiwan.uucp</email></para> + </listitem> + + <listitem> + <para>Boyd Faulkner <email>faulkner@mpd.tandem.com</email></para> + </listitem> + + <listitem> + <para>Brent J. Nordquist <email>bjn@visi.com</email></para> + </listitem> + + <listitem> + <para>Brett Lymn <email>blymn@mulga.awadi.com.AU</email></para> + </listitem> + + <listitem> + <para>Brett Taylor + <email>brett@peloton.physics.montana.edu</email></para> + </listitem> + + <listitem> + <para>Brian Campbell <email>brianc@pobox.com</email></para> + </listitem> + + <listitem> + <para>Brian Clapper <email>bmc@willscreek.com</email></para> + </listitem> + + <listitem> + <para>Brian Cully <email>shmit@kublai.com</email></para> + </listitem> + + <listitem> + <para>Brian F. Feldman <email>green@unixhelp.org</email></para> + </listitem> + + <listitem> + <para>Brian Handy + <email>handy@lambic.space.lockheed.com</email></para> + </listitem> + + <listitem> + <para>Brian Litzinger <email>brian@MediaCity.com</email></para> + </listitem> + + <listitem> + <para>Brian McGovern <email>bmcgover@cisco.com</email></para> + </listitem> + + <listitem> + <para>Brian Moore <email>ziff@houdini.eecs.umich.edu</email></para> + </listitem> + + <listitem> + <para>Brian R. Haug <email>haug@conterra.com</email></para> + </listitem> + + <listitem> + <para>Brian Tao <email>taob@risc.org</email></para> + </listitem> + + <listitem> + <para>Brion Moss <email>brion@queeg.com</email></para> + </listitem> + + <listitem> + <para>Bruce A. Mah <email>bmah@ca.sandia.gov</email></para> + </listitem> + + <listitem> + <para>Bruce Albrecht <email>bruce@zuhause.mn.org</email></para> + </listitem> + + <listitem> + <para>Bruce Gingery <email>bgingery@gtcs.com</email></para> + </listitem> + + <listitem> + <para>Bruce J. Keeler <email>loodvrij@gridpoint.com</email></para> + </listitem> + + <listitem> + <para>Bruce Murphy <email>packrat@iinet.net.au</email></para> + </listitem> + + <listitem> + <para>Bruce Walter <email>walter@fortean.com</email></para> + </listitem> + + <listitem> + <para>Carey Jones <email>mcj@acquiesce.org</email></para> + </listitem> + + <listitem> + <para>Carl Fongheiser <email>cmf@netins.net</email></para> + </listitem> + + <listitem> + <para>Carl Mascott <email>cmascott@world.std.com</email></para> + </listitem> + + <listitem> + <para>Casper <email>casper@acc.am</email></para> + </listitem> + + <listitem> + <para>Castor Fu <email>castor@geocast.com</email></para> + </listitem> + + <listitem> + <para>Cejka Rudolf <email>cejkar@dcse.fee.vutbr.cz</email></para> + </listitem> + + <listitem> + <para>Chain Lee <email>chain@110.net</email></para> + </listitem> + + <listitem> + <para>Charles Hannum <email>mycroft@ai.mit.edu</email></para> + </listitem> + + <listitem> + <para>Charles Henrich <email>henrich@msu.edu</email></para> + </listitem> + + <listitem> + <para>Charles Mott <email>cmott@srv.net</email></para> + </listitem> + + <listitem> + <para>Charles Owens <email>owensc@enc.edu</email></para> + </listitem> + + <listitem> + <para>Chet Ramey <email>chet@odin.INS.CWRU.Edu</email></para> + </listitem> + + <listitem> + <para>Chia-liang Kao <email>clkao@CirX.ORG</email></para> + </listitem> + + <listitem> + <para>Chiharu Shibata <email>chi@bd.mbn.or.jp</email></para> + </listitem> + + <listitem> + <para>Chip Norkus <email>unknown</email></para> + </listitem> + + <listitem> + <para>Choi Jun Ho <email>junker@jazz.snu.ac.kr</email></para> + </listitem> + + <listitem> + <para>Chris Csanady <email>cc@tarsier.ca.sandia.gov</email></para> + </listitem> + + <listitem> + <para>Chris Dabrowski <email>chris@vader.org</email></para> + </listitem> + + <listitem> + <para>Chris Dillon <email>cdillon@wolves.k12.mo.us</email></para> + </listitem> + + <listitem> + <para>Chris Piazza <email>cpiazza@home.net</email></para> + </listitem> + + <listitem> + <para>Chris Shenton + <email>cshenton@angst.it.hq.nasa.gov</email></para> + </listitem> + + <listitem> + <para>Chris Stenton <email>jacs@gnome.co.uk</email></para> + </listitem> + + <listitem> + <para>Chris Timmons <email>skynyrd@opus.cts.cwu.edu</email></para> + </listitem> + + <listitem> + <para>Chris Torek <email>torek@ee.lbl.gov</email></para> + </listitem> + + <listitem> + <para>Christian Gusenbauer + <email>cg@fimp01.fim.uni-linz.ac.at</email></para> + </listitem> + + <listitem> + <para>Christian Haury <email>Christian.Haury@sagem.fr</email></para> + </listitem> + + <listitem> + <para>Christian Weisgerber + <email>naddy@bigeye.rhein-neckar.de</email></para> + </listitem> + + <listitem> + <para>Christoph P. Kukulies <email>kuku@FreeBSD.org</email></para> + </listitem> + + <listitem> + <para>Christoph Robitschko + <email>chmr@edvz.tu-graz.ac.at</email></para> + </listitem> + + <listitem> + <para>Christoph Weber-Fahr + <email>wefa@callcenter.systemhaus.net</email></para> + </listitem> + + <listitem> + <para>Christopher G. Demetriou + <email>cgd@postgres.berkeley.edu</email></para> + </listitem> + + <listitem> + <para>Christopher T. Johnson + <email>cjohnson@neunacht.netgsi.com</email></para> + </listitem> + + <listitem> + <para>Chrisy Luke <email>chrisy@flix.net</email></para> + </listitem> + + <listitem> + <para>Chuck Hein <email>chein@cisco.com</email></para> + </listitem> + + <listitem> + <para>Clive Lin <email>clive@CiRX.ORG</email></para> + </listitem> + + <listitem> + <para>Colman Reilly <email>careilly@tcd.ie</email></para> + </listitem> + + <listitem> + <para>Conrad Sabatier <email>conrads@neosoft.com</email></para> + </listitem> + + <listitem> + <para>Coranth Gryphon <email>gryphon@healer.com</email></para> + </listitem> + + <listitem> + <para>Cornelis van der Laan + <email>nils@guru.ims.uni-stuttgart.de</email></para> + </listitem> + + <listitem> + <para>Cove Schneider <email>cove@brazil.nbn.com</email></para> + </listitem> + + <listitem> + <para>Craig Leres <email>leres@ee.lbl.gov</email></para> + </listitem> + + <listitem> + <para>Craig Loomis <email>unknown</email></para> + </listitem> + + <listitem> + <para>Craig Metz <email>cmetz@inner.net</email></para> + </listitem> + + <listitem> + <para>Craig Spannring <email>cts@internetcds.com</email></para> + </listitem> + + <listitem> + <para>Craig Struble <email>cstruble@vt.edu</email></para> + </listitem> + + <listitem> + <para>Cristian Ferretti <email>cfs@riemann.mat.puc.cl</email></para> + </listitem> + + <listitem> + <para>Curt Mayer <email>curt@toad.com</email></para> + </listitem> + + <listitem> + <para>Cy Schubert <email>cschuber@uumail.gov.bc.ca</email></para> + </listitem> + + <listitem> + <para>DI. Christian Gusenbauer + <email>cg@scotty.edvz.uni-linz.ac.at</email></para> + </listitem> + + <listitem> + <para>Dai Ishijima <email>ishijima@tri.pref.osaka.jp</email></para> + </listitem> + + <listitem> + <para>Damian Hamill <email>damian@cablenet.net</email></para> + </listitem> + + <listitem> + <para>Dan Cross <email>tenser@spitfire.ecsel.psu.edu</email></para> + </listitem> + + <listitem> + <para>Dan Lukes <email>dan@obluda.cz</email></para> + </listitem> + + <listitem> + <para>Dan Nelson <email>dnelson@emsphone.com</email></para> + </listitem> + + <listitem> + <para>Dan Walters <email>hannibal@cyberstation.net</email></para> + </listitem> + + <listitem> + <para>Daniel Baker <email>dbaker@crash.ops.neosoft.com</email></para> + </listitem> + + <listitem> + <para>Daniel M. Eischen + <email>deischen@iworks.InterWorks.org</email></para> + </listitem> + + <listitem> + <para>Daniel O'Connor <email>doconnor@gsoft.com.au</email></para> + </listitem> + + <listitem> + <para>Daniel Poirot <email>poirot@aio.jsc.nasa.gov</email></para> + </listitem> + + <listitem> + <para>Daniel Rock <email>rock@cs.uni-sb.de</email></para> + </listitem> + + <listitem> + <para>Danny Egen <email>unknown</email></para> + </listitem> + + <listitem> + <para>Danny J. Zerkel <email>dzerkel@phofarm.com</email></para> + </listitem> + + <listitem> + <para>Darren Reed <email>avalon@coombs.anu.edu.au</email></para> + </listitem> + + <listitem> + <para>Dave Adkins <email>adkin003@tc.umn.edu</email></para> + </listitem> + + <listitem> + <para>Dave Andersen <email>angio@aros.net</email></para> + </listitem> + + <listitem> + <para>Dave Blizzard <email>dblizzar@sprynet.com</email></para> + </listitem> + + <listitem> + <para>Dave Bodenstab <email>imdave@synet.net</email></para> + </listitem> + + <listitem> + <para>Dave Burgess <email>burgess@hrd769.brooks.af.mil</email></para> + </listitem> + + <listitem> + <para>Dave Chapeskie <email>dchapes@ddm.on.ca</email></para> + </listitem> + + <listitem> + <para>Dave Cornejo <email>dave@dogwood.com</email></para> + </listitem> + + <listitem> + <para>Dave Edmondson <email>davided@sco.com</email></para> + </listitem> + + <listitem> + <para>Dave Glowacki <email>dglo@ssec.wisc.edu</email></para> + </listitem> + + <listitem> + <para>Dave Marquardt <email>marquard@austin.ibm.com</email></para> + </listitem> + + <listitem> + <para>Dave Tweten <email>tweten@FreeBSD.org</email></para> + </listitem> + + <listitem> + <para>David A. Adkins <email>adkin003@tc.umn.edu</email></para> + </listitem> + + <listitem> + <para>David A. Bader <email>dbader@umiacs.umd.edu</email></para> + </listitem> + + <listitem> + <para>David Borman <email>dab@bsdi.com</email></para> + </listitem> + + <listitem> + <para>David Dawes <email>dawes@XFree86.org</email></para> + </listitem> + + <listitem> + <para>David Filo <email>filo@yahoo.com</email></para> + </listitem> + + <listitem> + <para>David Holland <email>dholland@eecs.harvard.edu</email></para> + </listitem> + + <listitem> + <para>David Holloway <email>daveh@gwythaint.tamis.com</email></para> + </listitem> + + <listitem> + <para>David Horwitt <email>dhorwitt@ucsd.edu</email></para> + </listitem> + + <listitem> + <para>David Hovemeyer <email>daveho@infocom.com</email></para> + </listitem> + + <listitem> + <para>David Jones <email>dej@qpoint.torfree.net</email></para> + </listitem> + + <listitem> + <para>David Kelly <email>dkelly@tomcat1.tbe.com</email></para> + </listitem> + + <listitem> + <para>David Kulp <email>dkulp@neomorphic.com</email></para> + </listitem> + + <listitem> + <para>David L. Nugent <email>davidn@blaze.net.au</email></para> + </listitem> + + <listitem> + <para>David Leonard <email>d@scry.dstc.edu.au</email></para> + </listitem> + + <listitem> + <para>David Malone <email>dwmalone@maths.tcd.ie</email></para> + </listitem> + + <listitem> + <para>David Muir Sharnoff <email>muir@idiom.com</email></para> + </listitem> + + <listitem> + <para>David S. Miller <email>davem@jenolan.rutgers.edu</email></para> + </listitem> + + <listitem> + <para>David Wolfskill <email>dhw@whistle.com</email></para> + </listitem> + + <listitem> + <para>Dean Gaudet <email>dgaudet@arctic.org</email></para> + </listitem> + + <listitem> + <para>Dean Huxley <email>dean@fsa.ca</email></para> + </listitem> + + <listitem> + <para>Denis Fortin <email>unknown</email></para> + </listitem> + + <listitem> + <para>Dennis Glatting + <email>dennis.glatting@software-munitions.com</email></para> + </listitem> + + <listitem> + <para>Denton Gentry <email>denny1@home.com</email></para> + </listitem> + + <listitem> + <para>Derek Inksetter <email>derek@saidev.com</email></para> + </listitem> + + <listitem> + <para>Dima Sivachenko <email>dima@Chg.RU</email></para> + </listitem> + + <listitem> + <para>Dirk Keunecke <email>dk@panda.rhein-main.de</email></para> + </listitem> + + <listitem> + <para>Dirk Nehrling <email>nerle@pdv.de</email></para> + </listitem> + + <listitem> + <para>Dmitry Khrustalev <email>dima@xyzzy.machaon.ru</email></para> + </listitem> + + <listitem> + <para>Dmitry Kohmanyuk <email>dk@farm.org</email></para> + </listitem> + + <listitem> + <para>Dom Mitchell <email>dom@myrddin.demon.co.uk</email></para> + </listitem> + + <listitem> + <para>Don Croyle <email>croyle@gelemna.ft-wayne.in.us</email></para> + </listitem> + + <listitem> + <para>&a.whiteside;</para> + </listitem> + + <listitem> + <para>Don Morrison <email>dmorrisn@u.washington.edu</email></para> + </listitem> + + <listitem> + <para>Don Yuniskis <email>dgy@rtd.com</email></para> + </listitem> + + <listitem> + <para>Donald Maddox <email>dmaddox@conterra.com</email></para> + </listitem> + + <listitem> + <para>Doug Barton <email>studded@dal.net</email></para> + </listitem> + + <listitem> + <para>Douglas Ambrisko <email>ambrisko@whistle.com</email></para> + </listitem> + + <listitem> + <para>Douglas Carmichael <email>dcarmich@mcs.com</email></para> + </listitem> + + <listitem> + <para>Douglas Crosher <email>dtc@scrooge.ee.swin.oz.au</email></para> + </listitem> + + <listitem> + <para>Drew Derbyshire <email>ahd@kew.com</email></para> + </listitem> + + <listitem> + <para>Duncan Barclay <email>dmlb@ragnet.demon.co.uk</email></para> + </listitem> + + <listitem> + <para>Dustin Sallings <email>dustin@spy.net</email></para> + </listitem> + + <listitem> + <para>Eckart "Isegrim" Hofmann + <email>Isegrim@Wunder-Nett.org</email></para> + </listitem> + + <listitem> + <para>Ed Gold + <email>vegold01@starbase.spd.louisville.edu</email></para> + </listitem> + + <listitem> + <para>Ed Hudson <email>elh@p5.spnet.com</email></para> + </listitem> + + <listitem> + <para>Edward Wang <email>edward@edcom.com</email></para> + </listitem> + + <listitem> + <para>Edwin Groothus <email>edwin@nwm.wan.philips.com</email></para> + </listitem> + + <listitem> + <para>Eiji-usagi-MATSUmoto <email>usagi@clave.gr.jp</email></para> + </listitem> + + <listitem> + <para>ELISA Font Project</para> + </listitem> + + <listitem> + <para>Elmar Bartel + <email>bartel@informatik.tu-muenchen.de</email></para> + </listitem> + + <listitem> + <para>Eric A. Griff <email>eagriff@global2000.net</email></para> + </listitem> + + <listitem> + <para>Eric Blood <email>eblood@cs.unr.edu</email></para> + </listitem> + + <listitem> + <para>Eric J. Haug <email>ejh@slustl.slu.edu</email></para> + </listitem> + + <listitem> + <para>Eric J. Schwertfeger <email>eric@cybernut.com</email></para> + </listitem> + + <listitem> + <para>Eric L. Hernes <email>erich@lodgenet.com</email></para> + </listitem> + + <listitem> + <para>Eric P. Scott <email>eps@sirius.com</email></para> + </listitem> + + <listitem> + <para>Eric Sprinkle <email>eric@ennovatenetworks.com</email></para> + </listitem> + + <listitem> + <para>Erich Stefan Boleyn <email>erich@uruk.org</email></para> + </listitem> + + <listitem> + <para>Erik E. Rantapaa <email>rantapaa@math.umn.edu</email></para> + </listitem> + + <listitem> + <para>Erik H. Moe <email>ehm@cris.com</email></para> + </listitem> + + <listitem> + <para>Ernst Winter <email>ewinter@lobo.muc.de</email></para> + </listitem> + + <listitem> + <para>Eugene M. Kim <email>astralblue@usa.net</email></para> + </listitem> + + <listitem> + <para>Eugene Radchenko <email>genie@qsar.chem.msu.su</email></para> + </listitem> + + <listitem> + <para>Evan Champion <email>evanc@synapse.net</email></para> + </listitem> + + <listitem> + <para>Faried Nawaz <email>fn@Hungry.COM</email></para> + </listitem> + + <listitem> + <para>Flemming Jacobsen <email>fj@tfs.com</email></para> + </listitem> + + <listitem> + <para>Fong-Ching Liaw <email>fong@juniper.net</email></para> + </listitem> + + <listitem> + <para>Francis M J Hsieh <email>mjshieh@life.nthu.edu.tw</email></para> + </listitem> + + <listitem> + <para>Frank Bartels <email>knarf@camelot.de</email></para> + </listitem> + + <listitem> + <para>Frank Chen Hsiung Chan + <email>frankch@waru.life.nthu.edu.tw</email></para> + </listitem> + + <listitem> + <para>Frank Durda IV <email>uhclem@nemesis.lonestar.org</email></para> + </listitem> + + <listitem> + <para>Frank MacLachlan <email>fpm@n2.net</email></para> + </listitem> + + <listitem> + <para>Frank Nobis <email>fn@Radio-do.de</email></para> + </listitem> + + <listitem> + <para>Frank Volf <email>volf@oasis.IAEhv.nl</email></para> + </listitem> + + <listitem> + <para>Frank ten Wolde <email>franky@pinewood.nl</email></para> + </listitem> + + <listitem> + <para>Frank van der Linden <email>frank@fwi.uva.nl</email></para> + </listitem> + + <listitem> + <para>Fred Cawthorne <email>fcawth@jjarray.umn.edu</email></para> + </listitem> + + <listitem> + <para>Fred Gilham <email>gilham@csl.sri.com</email></para> + </listitem> + + <listitem> + <para>Fred Templin <email>templin@erg.sri.com</email></para> + </listitem> + + <listitem> + <para>Frederick Earl Gray <email>fgray@rice.edu</email></para> + </listitem> + + <listitem> + <para>FUJIMOTO Kensaku + <email>fujimoto@oscar.elec.waseda.ac.jp</email></para> + </listitem> + + <listitem> + <para>FUJISHIMA Satsuki <email>k5@respo.or.jp</email></para> + </listitem> + + <listitem> + <para>FURUSAWA Kazuhisa + <email>furusawa@com.cs.osakafu-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Gabor Kincses <email>gabor@acm.org</email></para> + </listitem> + + <listitem> + <para>Gabor Zahemszky <email>zgabor@CoDe.hu</email></para> + </listitem> + + <listitem> + <para>Garance A Drosehn <email>gad@eclipse.its.rpi.edu</email></para> + </listitem> + + <listitem> + <para>Gareth McCaughan <email>gjm11@dpmms.cam.ac.uk</email></para> + </listitem> + + <listitem> + <para>Gary A. Browning <email>gab10@griffcd.amdahl.com</email></para> + </listitem> + + <listitem> + <para>Gary Howland <email>gary@hotlava.com</email></para> + </listitem> + + <listitem> + <para>Gary J. <email>garyj@rks32.pcs.dec.com</email></para> + </listitem> + + <listitem> + <para>Gary Kline <email>kline@thought.org</email></para> + </listitem> + + <listitem> + <para>Gaspar Chilingarov <email>nightmar@lemming.acc.am</email></para> + </listitem> + + <listitem> + <para>Gea-Suan Lin <email>gsl@tpts4.seed.net.tw</email></para> + </listitem> + + <listitem> + <para>Geoff Rehmet <email>csgr@alpha.ru.ac.za</email></para> + </listitem> + + <listitem> + <para>Georg Wagner <email>georg.wagner@ubs.com</email></para> + </listitem> + + <listitem> + <para>Gerard Roudier <email>groudier@club-internet.fr</email></para> + </listitem> + + <listitem> + <para>Gianmarco Giovannelli + <email>gmarco@giovannelli.it</email></para> + </listitem> + + <listitem> + <para>Gil Kloepfer Jr. <email>gil@limbic.ssdl.com</email></para> + </listitem> + + <listitem> + <para>Gilad Rom <email>rom_glsa@ein-hashofet.co.il</email></para> + </listitem> + + <listitem> + <para>Ginga Kawaguti + <email>ginga@amalthea.phys.s.u-tokyo.ac.jp</email></para> + </listitem> + + <listitem> + <para>Giles Lean <email>giles@nemeton.com.au</email></para> + </listitem> + + <listitem> + <para>Glen Foster <email>gfoster@gfoster.com</email></para> + </listitem> + + <listitem> + <para>Glenn Johnson <email>gljohns@bellsouth.net</email></para> + </listitem> + + <listitem> + <para>Godmar Back <email>gback@facility.cs.utah.edu</email></para> + </listitem> + + <listitem> + <para>Goran Hammarback <email>goran@astro.uu.se</email></para> + </listitem> + + <listitem> + <para>Gord Matzigkeit <email>gord@enci.ucalgary.ca</email></para> + </listitem> + + <listitem> + <para>Graham Wheeler <email>gram@cdsec.com</email></para> + </listitem> + + <listitem> + <para>Greg A. Woods <email>woods@zeus.leitch.com</email></para> + </listitem> + + <listitem> + <para>Greg Ansley <email>gja@ansley.com</email></para> + </listitem> + + <listitem> + <para>Greg Troxel <email>gdt@ir.bbn.com</email></para> + </listitem> + + <listitem> + <para>Greg Ungerer <email>gerg@stallion.oz.au</email></para> + </listitem> + + <listitem> + <para>Gregory Bond <email>gnb@itga.com.au</email></para> + </listitem> + + <listitem> + <para>Gregory D. Moncreaff + <email>moncrg@bt340707.res.ray.com</email></para> + </listitem> + + <listitem> + <para>Guy Harris <email>guy@netapp.com</email></para> + </listitem> + + <listitem> + <para>Guy Helmer <email>ghelmer@cs.iastate.edu</email></para> + </listitem> + + <listitem> + <para>HAMADA Naoki <email>hamada@astec.co.jp</email></para> + </listitem> + + <listitem> + <para>HONDA Yasuhiro + <email>honda@kashio.info.mie-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>HOSOBUCHI Noriyuki <email>hoso@buchi.tama.or.jp</email></para> + </listitem> + + <listitem> + <para>Hannu Savolainen <email>hannu@voxware.pp.fi</email></para> + </listitem> + + <listitem> + <para>Hans Huebner <email>hans@artcom.de</email></para> + </listitem> + + <listitem> + <para>Hans Petter Bieker <email>zerium@webindex.no</email></para> + </listitem> + + <listitem> + <para>Hans Zuidam <email>hans@brandinnovators.com</email></para> + </listitem> + + <listitem> + <para>Harlan Stenn <email>Harlan.Stenn@pfcs.com</email></para> + </listitem> + + <listitem> + <para>Harold Barker <email>hbarker@dsms.com</email></para> + </listitem> + + <listitem> + <para>Havard Eidnes + <email>Havard.Eidnes@runit.sintef.no</email></para> + </listitem> + + <listitem> + <para>Heikki Suonsivu <email>hsu@cs.hut.fi</email></para> + </listitem> + + <listitem> + <para>Heiko W. Rupp <email>unknown</email></para> + </listitem> + + <listitem> + <para>Helmut F. Wirth <email>hfwirth@ping.at</email></para> + </listitem> + + <listitem> + <para>Henrik Vestergaard Draboel + <email>hvd@terry.ping.dk</email></para> + </listitem> + + <listitem> + <para>Herb Peyerl <email>hpeyerl@NetBSD.org</email></para> + </listitem> + + <listitem> + <para>Hideaki Ohmon <email>ohmon@tom.sfc.keio.ac.jp</email></para> + </listitem> + + <listitem> + <para>Hidekazu Kuroki <email>hidekazu@cs.titech.ac.jp</email></para> + </listitem> + + <listitem> + <para>Hideki Yamamoto <email>hyama@acm.org</email></para> + </listitem> + + <listitem> + <para>Hidetoshi Shimokawa + <email>simokawa@sat.t.u-tokyo.ac.jp</email></para> + </listitem> + + <listitem> + <para>Hideyuki Suzuki + <email>hideyuki@sat.t.u-tokyo.ac.jp</email></para> + </listitem> + + <listitem> + <para>Hirayama Issei <email>iss@mail.wbs.ne.jp</email></para> + </listitem> + + <listitem> + <para>Hiroaki Sakai <email>sakai@miya.ee.kagu.sut.ac.jp</email></para> + </listitem> + + <listitem> + <para>Hiroharu Tamaru <email>tamaru@ap.t.u-tokyo.ac.jp</email></para> + </listitem> + + <listitem> + <para>Hironori Ikura <email>hikura@kaisei.org</email></para> + </listitem> + + <listitem> + <para>Hiroshi Nishikawa <email>nis@pluto.dti.ne.jp</email></para> + </listitem> + + <listitem> + <para>Hiroya Tsubakimoto <email>unknown</email></para> + </listitem> + + <listitem> + <para>Hiroyuki NAKAJI + <email>nakaji@zeisei3.dpri.kyoto-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Holger Veit <email>Holger.Veit@gmd.de</email></para> + </listitem> + + <listitem> + <para>Holm Tiffe <email>holm@geophysik.tu-freiberg.de</email></para> + </listitem> + + <listitem> + <para>Horance Chou + <email>horance@freedom.ie.cycu.edu.tw</email></para> + </listitem> + + <listitem> + <para>Horihiro Kumagaio <email>kuma@jp.freebsd.org</email></para> + </listitem> + + <listitem> + <para>Horikawa Kazuo <email>k-horik@mail.yk.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>Hr.Ladavac <email>lada@ws2301.gud.siemens.co.at</email></para> + </listitem> + + <listitem> + <para>Hubert Feyrer <email>hubertf@NetBSD.ORG</email></para> + </listitem> + + <listitem> + <para>Hugh F. Mahon <email>hugh@nsmdserv.cnd.hp.com</email></para> + </listitem> + + <listitem> + <para>Hugh Mahon <email>h_mahon@fc.hp.com</email></para> + </listitem> + + <listitem> + <para>Hung-Chi Chu <email>hcchu@r350.ee.ntu.edu.tw</email></para> + </listitem> + + <listitem> + <para>IMAI Takeshi <email>take-i@ceres.dti.ne.jp</email></para> + </listitem> + + <listitem> + <para>IMAMURA Tomoaki + <email>tomoak-i@is.aist-nara.ac.jp</email></para> + </listitem> + + <listitem> + <para>Ian Dowse <email>iedowse@maths.tcd.ie</email></para> + </listitem> + + <listitem> + <para>Ian Holland <email>ianh@tortuga.com.au</email></para> + </listitem> + + <listitem> + <para>Ian Struble <email>ian@broken.net</email></para> + </listitem> + + <listitem> + <para>Ian Vaudrey <email>i.vaudrey@bigfoot.com</email></para> + </listitem> + + <listitem> + <para>Igor Khasilev <email>igor@jabber.paco.odessa.ua</email></para> + </listitem> + + <listitem> + <para>Igor Roshchin <email>str@giganda.komkon.org</email></para> + </listitem> + + <listitem> + <para>Igor Sviridov <email>siac@ua.net</email></para> + </listitem> + + <listitem> + <para>Igor Vinokurov <email>igor@zynaps.ru</email></para> + </listitem> + + <listitem> + <para>Ikuo Nakagawa <email>ikuo@isl.intec.co.jp</email></para> + </listitem> + + <listitem> + <para>Ilya V. Komarov <email>mur@lynx.ru</email></para> + </listitem> + + <listitem> + <para>Issei Suzuki <email>issei@jp.FreeBSD.org</email></para> + </listitem> + + <listitem> + <para>Itsuro Saito <email>saito@miv.t.u-tokyo.ac.jp</email></para> + </listitem> + + <listitem> + <para>J. Bryant <email>jbryant@argus.flash.net</email></para> + </listitem> + + <listitem> + <para>J. David Lowe <email>lowe@saturn5.com</email></para> + </listitem> + + <listitem> + <para>J. Han <email>hjh@best.com</email></para> + </listitem> + + <listitem> + <para>J. Hawk <email>jhawk@MIT.EDU</email></para> + </listitem> + + <listitem> + <para>J.T. Conklin <email>jtc@cygnus.com</email></para> + </listitem> + + <listitem> + <para>J.T. Jang <email>keith@email.gcn.net.tw</email></para> + </listitem> + + <listitem> + <para>Jack <email>jack@zeus.xtalwind.net</email></para> + </listitem> + + <listitem> + <para>Jacob Bohn Lorensen <email>jacob@jblhome.ping.mk</email></para> + </listitem> + + <listitem> + <para>Jagane D Sundar <email>jagane@netcom.com</email></para> + </listitem> + + <listitem> + <para>Jake Hamby <email>jehamby@lightside.com</email></para> + </listitem> + + <listitem> + <para>James Clark <email>jjc@jclark.com</email></para> + </listitem> + + <listitem> + <para>James D. Stewart <email>jds@c4systm.com</email></para> + </listitem> + + <listitem> + <para>James Jegers <email>jimj@miller.cs.uwm.edu</email></para> + </listitem> + + <listitem> + <para>James Raynard + <email>fhackers@jraynard.demon.co.uk</email></para> + </listitem> + + <listitem> + <para>James T. Liu <email>jtliu@phlebas.rockefeller.edu</email></para> + </listitem> + + <listitem> + <para>James da Silva <email>jds@cs.umd.edu</email></para> + </listitem> + + <listitem> + <para>Jan Conard + <email>charly@fachschaften.tu-muenchen.de</email></para> + </listitem> + + <listitem> + <para>Jan Koum <email>jkb@FreeBSD.org</email></para> + </listitem> + + <listitem> + <para>Janick Taillandier + <email>Janick.Taillandier@ratp.fr</email></para> + </listitem> + + <listitem> + <para>Janusz Kokot <email>janek@gaja.ipan.lublin.pl</email></para> + </listitem> + + <listitem> + <para>Jarle Greipsland <email>jarle@idt.unit.no</email></para> + </listitem> + + <listitem> + <para>Jason Garman <email>init@risen.org</email></para> + </listitem> + + <listitem> + <para>Jason Thorpe <email>thorpej@NetBSD.org</email></para> + </listitem> + + <listitem> + <para>Jason Wright <email>jason@OpenBSD.org</email></para> + </listitem> + + <listitem> + <para>Jason Young + <email>doogie@forbidden-donut.anet-stl.com</email></para> + </listitem> + + <listitem> + <para>Javier Martin Rueda <email>jmrueda@diatel.upm.es</email></para> + </listitem> + + <listitem> + <para>Jay Fenlason <email>hack@datacube.com</email></para> + </listitem> + + <listitem> + <para>Jaye Mathisen <email>mrcpu@cdsnet.net</email></para> + </listitem> + + <listitem> + <para>Jeff Bartig <email>jeffb@doit.wisc.edu</email></para> + </listitem> + + <listitem> + <para>Jeff Forys <email>jeff@forys.cranbury.nj.us</email></para> + </listitem> + + <listitem> + <para>Jeff Kletsky <email>Jeff@Wagsky.com</email></para> + </listitem> + + <listitem> + <para>Jeffrey Evans <email>evans@scnc.k12.mi.us</email></para> + </listitem> + + <listitem> + <para>Jeffrey Wheat <email>jeff@cetlink.net</email></para> + </listitem> + + <listitem> + <para>Jens Schweikhardt + <email>schweikh@ito.uni-stuttgart.de</email></para> + </listitem> + + <listitem> + <para>Jeremy Allison <email>jallison@whistle.com</email></para> + </listitem> + + <listitem> + <para>Jeremy Chatfield <email>jdc@xinside.com</email></para> + </listitem> + + <listitem> + <para>Jeremy Lea <email>reg@shale.csir.co.za</email></para> + </listitem> + + <listitem> + <para>Jeremy Prior <email>unknown</email></para> + </listitem> + + <listitem> + <para>Jeroen Ruigrok/Asmodai <email>asmodai@wxs.nl</email></para> + </listitem> + + <listitem> + <para>Jesse Rosenstock <email>jmr@ugcs.caltech.edu</email></para> + </listitem> + + <listitem> + <para>Jian-Da Li <email>jdli@csie.nctu.edu.tw</email></para> + </listitem> + + <listitem> + <para>Jim Babb <email>babb@FreeBSD.org</email></para> + </listitem> + + <listitem> + <para>Jim Binkley <email>jrb@cs.pdx.edu</email></para> + </listitem> + + <listitem> + <para>Jim Carroll <email>jim@carroll.com</email></para> + </listitem> + + <listitem> + <para>Jim Flowers <email>jflowers@ezo.net</email></para> + </listitem> + + <listitem> + <para>Jim Leppek <email>jleppek@harris.com</email></para> + </listitem> + + <listitem> + <para>Jim Lowe <email>james@cs.uwm.edu</email></para> + </listitem> + + <listitem> + <para>Jim Mattson <email>jmattson@sonic.net</email></para> + </listitem> + + <listitem> + <para>Jim Mercer <email>jim@komodo.reptiles.org</email></para> + </listitem> + + <listitem> + <para>Jim Mock <email>jim@phrantic.phear.net</email></para> + </listitem> + + <listitem> + <para>Jim Wilson <email>wilson@moria.cygnus.com</email></para> + </listitem> + + <listitem> + <para>Jimbo Bahooli + <email>griffin@blackhole.iceworld.org</email></para> + </listitem> + + <listitem> + <para>Jin Guojun <email>jin@george.lbl.gov</email></para> + </listitem> + + <listitem> + <para>Joachim Kuebart <email>unknown</email></para> + </listitem> + + <listitem> + <para>Joao Carlos Mendes Luis <email>jonny@jonny.eng.br</email></para> + </listitem> + + <listitem> + <para>Jochen Pohl <email>jpo.drs@sni.de</email></para> + </listitem> + + <listitem> + <para>Joe "Marcus" Clarke <email>marcus@miami.edu</email></para> + </listitem> + + <listitem> + <para>Joe Abley <email>jabley@clear.co.nz</email></para> + </listitem> + + <listitem> + <para>Joe Jih-Shian Lu <email>jslu@dns.ntu.edu.tw</email></para> + </listitem> + + <listitem> + <para>Joe Orthoefer <email>j_orthoefer@tia.net</email></para> + </listitem> + + <listitem> + <para>Joe Traister <email>traister@mojozone.org</email></para> + </listitem> + + <listitem> + <para>Joel Faedi <email>Joel.Faedi@esial.u-nancy.fr</email></para> + </listitem> + + <listitem> + <para>Joel Ray Holveck <email>joelh@gnu.org</email></para> + </listitem> + + <listitem> + <para>Joel Sutton <email>sutton@aardvark.apana.org.au</email></para> + </listitem> + + <listitem> + <para>Johan Granlund <email>johan@granlund.nu</email></para> + </listitem> + + <listitem> + <para>Johan Karlsson <email>k@numeri.campus.luth.se</email></para> + </listitem> + + <listitem> + <para>Johan Larsson <email>johan@moon.campus.luth.se</email></para> + </listitem> + + <listitem> + <para>Johann Tonsing <email>jtonsing@mikom.csir.co.za</email></para> + </listitem> + + <listitem> + <para>Johannes Helander <email>unknown</email></para> + </listitem> + + <listitem> + <para>Johannes Stille <email>unknown</email></para> + </listitem> + + <listitem> + <para>John Baldwin <email>jobaldwi@vt.edu</email></para> + </listitem> + + <listitem> + <para>John Beckett <email>jbeckett@southern.edu</email></para> + </listitem> + + <listitem> + <para>John Beukema <email>jbeukema@hk.super.net</email></para> + </listitem> + + <listitem> + <para>John Brezak <email>unknown</email></para> + </listitem> + + <listitem> + <para>John Capo <email>jc@irbs.com</email></para> + </listitem> + + <listitem> + <para>John F. Woods <email>jfw@jfwhome.funhouse.com</email></para> + </listitem> + + <listitem> + <para>John Goerzen + <email>jgoerzen@alexanderwohl.complete.org</email></para> + </listitem> + + <listitem> + <para>John Hay <email>jhay@mikom.csir.co.za</email></para> + </listitem> + + <listitem> + <para>John Heidemann <email>johnh@isi.edu</email></para> + </listitem> + + <listitem> + <para>John Hood <email>cgull@owl.org</email></para> + </listitem> + + <listitem> + <para>John Kohl <email>unknown</email></para> + </listitem> + + <listitem> + <para>John Lind <email>john@starfire.mn.org</email></para> + </listitem> + + <listitem> + <para>John Mackin <email>john@physiol.su.oz.au</email></para> + </listitem> + + <listitem> + <para>John P <email>johnp@lodgenet.com</email></para> + </listitem> + + <listitem> + <para>John Perry <email>perry@vishnu.alias.net</email></para> + </listitem> + + <listitem> + <para>John Preisler <email>john@vapornet.com</email></para> + </listitem> + + <listitem> + <para>John Rochester <email>jr@cs.mun.ca</email></para> + </listitem> + + <listitem> + <para>John Sadler <email>john_sadler@alum.mit.edu</email></para> + </listitem> + + <listitem> + <para>John Saunders <email>john@pacer.nlc.net.au</email></para> + </listitem> + + <listitem> + <para>John W. DeBoskey <email>jwd@unx.sas.com</email></para> + </listitem> + + <listitem> + <para>John Wehle <email>john@feith.com</email></para> + </listitem> + + <listitem> + <para>John Woods <email>jfw@eddie.mit.edu</email></para> + </listitem> + + <listitem> + <para>Jon Morgan <email>morgan@terminus.trailblazer.com</email></para> + </listitem> + + <listitem> + <para>Jonathan H N Chin <email>jc254@newton.cam.ac.uk</email></para> + </listitem> + + <listitem> + <para>Jonathan Hanna + <email>jh@pc-21490.bc.rogers.wave.ca</email></para> + </listitem> + + <listitem> + <para>Jorge Goncalves <email>j@bug.fe.up.pt</email></para> + </listitem> + + <listitem> + <para>Jorge M. Goncalves <email>ee96199@tom.fe.up.pt</email></para> + </listitem> + + <listitem> + <para>Jos Backus <email>jbackus@plex.nl</email></para> + </listitem> + + <listitem> + <para>Jose M. Alcaide <email>jose@we.lc.ehu.es</email></para> + </listitem> + + <listitem> + <para>Josef Grosch + <email>jgrosch@superior.mooseriver.com</email></para> + </listitem> + + <listitem> + <para>Josef Karthauser <email>joe@uk.freebsd.org</email></para> + </listitem> + + <listitem> + <para>Joseph Stein <email>joes@seaport.net</email></para> + </listitem> + + <listitem> + <para>Josh Gilliam <email>josh@quick.net</email></para> + </listitem> + + <listitem> + <para>Josh Tiefenbach <email>josh@ican.net</email></para> + </listitem> + + <listitem> + <para>Juergen Lock <email>nox@jelal.hb.north.de</email></para> + </listitem> + + <listitem> + <para>Juha Inkari <email>inkari@cc.hut.fi</email></para> + </listitem> + + <listitem> + <para>Jukka A. Ukkonen <email>jua@iki.fi</email></para> + </listitem> + + <listitem> + <para>Julian Assange <email>proff@suburbia.net</email></para> + </listitem> + + <listitem> + <para>Julian Coleman <email>j.d.coleman@ncl.ac.uk</email></para> + </listitem> + + <listitem> + <para>Julian H. Stacey <email>jhs@freebsd.org</email></para> + </listitem> + + <listitem> + <para>Julian Jenkins <email>kaveman@magna.com.au</email></para> + </listitem> + + <listitem> + <para>Junichi Satoh <email>junichi@jp.freebsd.org</email></para> + </listitem> + + <listitem> + <para>Junji SAKAI <email>sakai@jp.freebsd.org</email></para> + </listitem> + + <listitem> + <para>Junya WATANABE <email>junya-w@remus.dti.ne.jp</email></para> + </listitem> + + <listitem> + <para>K.Higashino <email>a00303@cc.hc.keio.ac.jp</email></para> + </listitem> + + <listitem> + <para>KUNISHIMA Takeo <email>kunishi@c.oka-pu.ac.jp</email></para> + </listitem> + + <listitem> + <para>Kai Vorma <email>vode@snakemail.hut.fi</email></para> + </listitem> + + <listitem> + <para>Kaleb S. Keithley <email>kaleb@ics.com</email></para> + </listitem> + + <listitem> + <para>Kaneda Hiloshi <email>vanitas@ma3.seikyou.ne.jp</email></para> + </listitem> + + <listitem> + <para>Kapil Chowksey <email>kchowksey@hss.hns.com</email></para> + </listitem> + + <listitem> + <para>Karl Denninger <email>karl@mcs.com</email></para> + </listitem> + + <listitem> + <para>Karl Dietz <email>Karl.Dietz@triplan.com</email></para> + </listitem> + + <listitem> + <para>Karl Lehenbauer <email>karl@NeoSoft.com</email></para> + </listitem> + + <listitem> + <para>Kato Takenori + <email>kato@eclogite.eps.nagoya-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Kauzo Horikawa <email>h-horik@yk.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>Kawanobe Koh <email>kawanobe@st.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>Kazuhiko Kiriyama <email>kiri@kiri.toba-cmt.ac.jp</email></para> + </listitem> + + <listitem> + <para>Kazuo Horikawa <email>horikawa@jp.FreeBSD.org</email></para> + </listitem> + + <listitem> + <para>Kees Jan Koster <email>kjk1@ukc.ac.uk</email></para> + </listitem> + + <listitem> + <para>Keith Bostic <email>bostic@bostic.com</email></para> + </listitem> + + <listitem> + <para>Keith E. Walker <email>unknown</email></para> + </listitem> + + <listitem> + <para>Keith Moore <email>unknown</email></para> + </listitem> + + <listitem> + <para>Keith Sklower <email>unknown</email></para> + </listitem> + + <listitem> + <para>Ken Hornstein <email>unknown</email></para> + </listitem> + + <listitem> + <para>Ken Key <email>key@cs.utk.edu</email></para> + </listitem> + + <listitem> + <para>Ken Mayer <email>kmayer@freegate.com</email></para> + </listitem> + + <listitem> + <para>Kenji Saito <email>marukun@mx2.nisiq.net</email></para> + </listitem> + + <listitem> + <para>Kenji Tomita <email>tommyk@da2.so-net.or.jp</email></para> + </listitem> + + <listitem> + <para>Kenneth Furge <email>kenneth.furge@us.endress.com</email></para> + </listitem> + + <listitem> + <para>Kenneth Monville <email>desmo@bandwidth.org</email></para> + </listitem> + + <listitem> + <para>Kenneth R. Westerback <email>krw@tcn.net</email></para> + </listitem> + + <listitem> + <para>Kenneth Stailey <email>kstailey@gnu.ai.mit.edu</email></para> + </listitem> + + <listitem> + <para>Kent Talarico <email>kent@shipwreck.tsoft.net</email></para> + </listitem> + + <listitem> + <para>Kent Vander Velden <email>graphix@iastate.edu</email></para> + </listitem> + + <listitem> + <para>Kentaro Inagaki <email>JBD01226@niftyserve.ne.jp</email></para> + </listitem> + + <listitem> + <para>Kevin Bracey <email>kbracey@art.acorn.co.uk</email></para> + </listitem> + + <listitem> + <para>Kevin Day <email>toasty@dragondata.com</email></para> + </listitem> + + <listitem> + <para>Kevin Lahey <email>kml@nas.nasa.gov</email></para> + </listitem> + + <listitem> + <para>Kevin Street <email>street@iname.com</email></para> + </listitem> + + <listitem> + <para>Kevin Van Maren <email>vanmaren@fast.cs.utah.edu</email></para> + </listitem> + + <listitem> + <para>Kiroh HARADA <email>kiroh@kh.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>Klaus Klein <email>kleink@layla.inka.de</email></para> + </listitem> + + <listitem> + <para>Klaus-J. Wolf <email>Yanestra@t-online.de</email></para> + </listitem> + + <listitem> + <para>Koichi Sato <email>copan@ppp.fastnet.or.jp</email></para> + </listitem> + + <listitem> + <para>Kostya Lukin <email>lukin@okbmei.msk.su</email></para> + </listitem> + + <listitem> + <para>Kouichi Hirabayashi <email>kh@mogami-wire.co.jp</email></para> + </listitem> + + <listitem> + <para>Kurt D. Zeilenga <email>Kurt@Boolean.NET</email></para> + </listitem> + + <listitem> + <para>Kurt Olsen <email>kurto@tiny.mcs.usu.edu</email></para> + </listitem> + + <listitem> + <para>L. Jonas Olsson + <email>ljo@ljo-slip.DIALIN.CWRU.Edu</email></para> + </listitem> + + <listitem> + <para>Lars Köller + <email>Lars.Koeller@Uni-Bielefeld.DE</email></para> + </listitem> + + <listitem> + <para>Larry Altneu <email>larry@ALR.COM</email></para> + </listitem> + + <listitem> + <para>Laurence Lopez <email>lopez@mv.mv.com</email></para> + </listitem> + + <listitem> + <para>Lee Cremeans <email>lcremean@tidalwave.net</email></para> + </listitem> + + <listitem> + <para>Liang Tai-hwa + <email>avatar@www.mmlab.cse.yzu.edu.tw</email></para> + </listitem> + + <listitem> + <para>Lon Willett <email>lon%softt.uucp@math.utah.edu</email></para> + </listitem> + + <listitem> + <para>Louis A. Mamakos <email>louie@TransSys.COM</email></para> + </listitem> + + <listitem> + <para>Louis Mamakos <email>loiue@TransSys.com</email></para> + </listitem> + + <listitem> + <para>Lucas James <email>Lucas.James@ldjpc.apana.org.au</email></para> + </listitem> + + <listitem> + <para>Lyndon Nerenberg <email>lyndon@orthanc.com</email></para> + </listitem> + + <listitem> + <para>M.C. Wong <email>unknown</email></para> + </listitem> + + <listitem> + <para>MANTANI Nobutaka <email>nobutaka@nobutaka.com</email></para> + </listitem> + + <listitem> + <para>MIHIRA Sanpei Yoshiro <email>sanpei@sanpei.org</email></para> + </listitem> + + <listitem> + <para>MITA Yoshio <email>mita@jp.FreeBSD.ORG</email></para> + </listitem> + + <listitem> + <para>MITSUNAGA Noriaki + <email>mitchy@er.ams.eng.osaka-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>MOROHOSHI Akihiko <email>moro@race.u-tokyo.ac.jp</email></para> + </listitem> + + <listitem> + <para>Magnus Enbom <email>dot@tinto.campus.luth.se</email></para> + </listitem> + + <listitem> + <para>Mahesh Neelakanta <email>mahesh@gcomm.com</email></para> + </listitem> + + <listitem> + <para>Makoto MATSUSHITA <email>matusita@jp.freebsd.org</email></para> + </listitem> + + <listitem> + <para>Makoto WATANABE + <email>watanabe@zlab.phys.nagoya-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Malte Lance <email>malte.lance@gmx.net</email></para> + </listitem> + + <listitem> + <para>Manu Iyengar + <email>iyengar@grunthos.pscwa.psca.com</email></para> + </listitem> + + <listitem> + <para>Marc Frajola <email>marc@dev.com</email></para> + </listitem> + + <listitem> + <para>Marc Ramirez <email>mrami@mramirez.sy.yale.edu</email></para> + </listitem> + + <listitem> + <para>Marc Slemko <email>marcs@znep.com</email></para> + </listitem> + + <listitem> + <para>Marc van Kempen <email>wmbfmk@urc.tue.nl</email></para> + </listitem> + + <listitem> + <para>Marcel Moolenaar <email>marcel@scc.nl</email></para> + </listitem> + + <listitem> + <para>Mario Sergio Fujikawa Ferreira + <email>lioux@gns.com.br</email></para> + </listitem> + + <listitem> + <para>Mark Andrews <email>unknown</email></para> + </listitem> + + <listitem> + <para>Mark Cammidge <email>mark@gmtunx.ee.uct.ac.za</email></para> + </listitem> + + <listitem> + <para>Mark Diekhans <email>markd@grizzly.com</email></para> + </listitem> + + <listitem> + <para>Mark Huizer <email>xaa@stack.nl</email></para> + </listitem> + + <listitem> + <para>Mark J. Taylor <email>mtaylor@cybernet.com</email></para> + </listitem> + + <listitem> + <para>Mark Krentel <email>krentel@rice.edu</email></para> + </listitem> + + <listitem> + <para>Mark Mayo <email>markm@vmunix.com</email></para> + </listitem> + + <listitem> + <para>Mark Thompson <email>thompson@tgsoft.com</email></para> + </listitem> + + <listitem> + <para>Mark Tinguely <email>tinguely@plains.nodak.edu</email></para> + </listitem> + + <listitem> + <para>Mark Treacy <email>unknown</email></para> + </listitem> + + <listitem> + <para>Mark Valentine <email>mark@linus.demon.co.uk</email></para> + </listitem> + + <listitem> + <para>Martin Birgmeier</para> + </listitem> + + <listitem> + <para>Martin Ibert <email>mib@ppe.bb-data.de</email></para> + </listitem> + + <listitem> + <para>Martin Kammerhofer <email>dada@sbox.tu-graz.ac.at</email></para> + </listitem> + + <listitem> + <para>Martin Renters <email>martin@tdc.on.ca</email></para> + </listitem> + + <listitem> + <para>Martti Kuparinen + <email>erakupa@kk.etx.ericsson.se</email></para> + </listitem> + + <listitem> + <para>Masachika ISHIZUKA + <email>ishizuka@isis.min.ntt.jp</email></para> + </listitem> + + <listitem> + <para>Mas.TAKEMURA <email>unknown</email></para> + </listitem> + + <listitem> + <para>Masafumi NAKANE <email>max@wide.ad.jp</email></para> + </listitem> + + <listitem> + <para>Masahiro Sekiguchi + <email>seki@sysrap.cs.fujitsu.co.jp</email></para> + </listitem> + + <listitem> + <para>Masanobu Saitoh <email>msaitoh@spa.is.uec.ac.jp</email></para> + </listitem> + + <listitem> + <para>Masanori Kanaoka <email>kana@saijo.mke.mei.co.jp</email></para> + </listitem> + + <listitem> + <para>Masanori Kiriake <email>seiken@ncs.co.jp</email></para> + </listitem> + + <listitem> + <para>Masatoshi TAMURA + <email>tamrin@shinzan.kuee.kyoto-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Mats Lofkvist <email>mal@algonet.se</email></para> + </listitem> + + <listitem> + <para>Matt Bartley <email>mbartley@lear35.cytex.com</email></para> + </listitem> + + <listitem> + <para>Matt Thomas <email>matt@3am-software.com</email></para> + </listitem> + + <listitem> + <para>Matt White <email>mwhite+@CMU.EDU</email></para> + </listitem> + + <listitem> + <para>Matthew C. Mead <email>mmead@Glock.COM</email></para> + </listitem> + + <listitem> + <para>Matthew Cashdollar <email>mattc@rfcnet.com</email></para> + </listitem> + + <listitem> + <para>Matthew Flatt <email>mflatt@cs.rice.edu</email></para> + </listitem> + + <listitem> + <para>Matthew Fuller <email>fullermd@futuresouth.com</email></para> + </listitem> + + <listitem> + <para>Matthew N. Dodd <email>winter@jurai.net</email></para> + </listitem> + + <listitem> + <para>Matthew Stein <email>matt@bdd.net</email></para> + </listitem> + + <listitem> + <para>Matthias Pfaller <email>leo@dachau.marco.de</email></para> + </listitem> + + <listitem> + <para>Matthias Scheler <email>tron@netbsd.org</email></para> + </listitem> + + <listitem> + <para>Mattias Gronlund + <email>Mattias.Gronlund@sa.erisoft.se</email></para> + </listitem> + + <listitem> + <para>Mattias Pantzare <email>pantzer@ludd.luth.se</email></para> + </listitem> + + <listitem> + <para>Maurice Castro + <email>maurice@planet.serc.rmit.edu.au</email></para> + </listitem> + + <listitem> + <para>Max Euston <email>meuston@jmrodgers.com</email></para> + </listitem> + + <listitem> + <para>Max Khon <email>fjoe@husky.iclub.nsu.ru</email></para> + </listitem> + + <listitem> + <para>Maxim Bolotin <email>max@rsu.ru</email></para> + </listitem> + + <listitem> + <para>Micha Class + <email>michael_class@hpbbse.bbn.hp.com</email></para> + </listitem> + + <listitem> + <para>Michael Butler <email>imb@scgt.oz.au</email></para> + </listitem> + + <listitem> + <para>Michael Butschky <email>butsch@computi.erols.com</email></para> + </listitem> + + <listitem> + <para>Michael Clay <email>mclay@weareb.org</email></para> + </listitem> + + <listitem> + <para>Michael Elbel <email>me@FreeBSD.ORG</email></para> + </listitem> + + <listitem> + <para>Michael Galassi <email>nerd@percival.rain.com</email></para> + </listitem> + + <listitem> + <para>Michael Hancock <email>michaelh@cet.co.jp</email></para> + </listitem> + + <listitem> + <para>Michael Hohmuth <email>hohmuth@inf.tu-dresden.de</email></para> + </listitem> + + <listitem> + <para>Michael Perlman <email>canuck@caam.rice.edu</email></para> + </listitem> + + <listitem> + <para>Michael Petry <email>petry@netwolf.NetMasters.com</email></para> + </listitem> + + <listitem> + <para>Michael Reifenberger <email>root@totum.plaut.de</email></para> + </listitem> + + <listitem> + <para>Michael Searle <email>searle@longacre.demon.co.uk</email></para> + </listitem> + + <listitem> + <para>Michal Listos <email>mcl@Amnesiac.123.org</email></para> + </listitem> + + <listitem> + <para>Michio Karl Jinbo + <email>karl@marcer.nagaokaut.ac.jp</email></para> + </listitem> + + <listitem> + <para>Miguel Angel Sagreras + <email>msagre@cactus.fi.uba.ar</email></para> + </listitem> + + <listitem> + <para>Mihoko Tanaka <email>m_tonaka@pa.yokogawa.co.jp</email></para> + </listitem> + + <listitem> + <para>Mika Nystrom <email>mika@cs.caltech.edu</email></para> + </listitem> + + <listitem> + <para>Mikael Hybsch <email>micke@dynas.se</email></para> + </listitem> + + <listitem> + <para>Mikael Karpberg + <email>karpen@ocean.campus.luth.se</email></para> + </listitem> + + <listitem> + <para>Mike Del <email>repenting@hotmail.com</email></para> + </listitem> + + <listitem> + <para>Mike Durian <email>durian@plutotech.com</email></para> + </listitem> + + <listitem> + <para>Mike Durkin <email>mdurkin@tsoft.sf-bay.org</email></para> + </listitem> + + <listitem> + <para>Mike E. Matsnev <email>mike@azog.cs.msu.su</email></para> + </listitem> + + <listitem> + <para>Mike Evans <email>mevans@candle.com</email></para> + </listitem> + + <listitem> + <para>Mike Grupenhoff <email>kashmir@umiacs.umd.edu</email></para> + </listitem> + + <listitem> + <para>Mike Hibler <email>mike@marker.cs.utah.edu</email></para> + </listitem> + + <listitem> + <para>Mike Karels <email>unknown</email></para> + </listitem> + + <listitem> + <para>Mike McGaughey <email>mmcg@cs.monash.edu.au</email></para> + </listitem> + + <listitem> + <para>Mike Meyer <email>mwm@shiva.the-park.com</email></para> + </listitem> + + <listitem> + <para>Mike Mitchell <email>mitchell@ref.tfs.com</email></para> + </listitem> + + <listitem> + <para>Mike Murphy <email>mrm@alpharel.com</email></para> + </listitem> + + <listitem> + <para>Mike Peck <email>mike@binghamton.edu</email></para> + </listitem> + + <listitem> + <para>Mike Spengler <email>mks@msc.edu</email></para> + </listitem> + + <listitem> + <para>Mikhail A. Sokolov <email>mishania@demos.su</email></para> + </listitem> + + <listitem> + <para>Mikhail Teterin <email>mi@aldan.ziplink.net</email></para> + </listitem> + + <listitem> + <para>Ming-I Hseh <email>PA@FreeBSD.ee.Ntu.edu.TW</email></para> + </listitem> + + <listitem> + <para>Mitsuru IWASAKI <email>iwasaki@pc.jaring.my</email></para> + </listitem> + + <listitem> + <para>Monte Mitzelfelt <email>monte@gonefishing.org</email></para> + </listitem> + + <listitem> + <para>Morgan Davis <email>root@io.cts.com</email></para> + </listitem> + + <listitem> + <para>Mostyn Lewis <email>mostyn@mrl.com</email></para> + </listitem> + + <listitem> + <para>Motoyuki Kasahara <email>m-kasahr@sra.co.jp</email></para> + </listitem> + + <listitem> + <para>Motoyuki Konno <email>motoyuki@snipe.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>Munechika Sumikawa <email>sumikawa@kame.net</email></para> + </listitem> + + <listitem> + <para>Murray Stokely <email>murray@cdrom.com</email></para> + </listitem> + + <listitem> + <para>N.G.Smith <email>ngs@sesame.hensa.ac.uk</email></para> + </listitem> + + <listitem> + <para>NAGAO Tadaaki <email>nagao@cs.titech.ac.jp</email></para> + </listitem> + + <listitem> + <para>NAKAJI Hiroyuki + <email>nakaji@zeisei.dpri.kyoto-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>NAKAMURA Kazushi <email>nkazushi@highway.or.jp</email></para> + </listitem> + + <listitem> + <para>NAKAMURA Motonori + <email>motonori@econ.kyoto-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>NIIMI Satoshi <email>sa2c@and.or.jp</email></para> + </listitem> + + <listitem> + <para>NOKUBI Hirotaka <email>h-nokubi@yyy.or.jp</email></para> + </listitem> + + <listitem> + <para>Nadav Eiron <email>nadav@barcode.co.il</email></para> + </listitem> + + <listitem> + <para>Nanbor Wang <email>nw1@cs.wustl.edu</email></para> + </listitem> + + <listitem> + <para>Naofumi Honda + <email>honda@Kururu.math.sci.hokudai.ac.jp</email></para> + </listitem> + + <listitem> + <para>Naoki Hamada <email>nao@tom-yam.or.jp</email></para> + </listitem> + + <listitem> + <para>Narvi <email>narvi@haldjas.folklore.ee</email></para> + </listitem> + + <listitem> + <para>Nathan Dorfman <email>nathan@rtfm.net</email></para> + </listitem> + + <listitem> + <para>Neal Fachan <email>kneel@ishiboo.com</email></para> + </listitem> + + <listitem> + <para>Neil Blakey-Milner <email>nbm@rucus.ru.ac.za</email></para> + </listitem> + + <listitem> + <para>Niall Smart <email>rotel@indigo.ie</email></para> + </listitem> + + <listitem> + <para>Nick Barnes <email>Nick.Barnes@pobox.com</email></para> + </listitem> + + <listitem> + <para>Nick Handel <email>nhandel@NeoSoft.com</email></para> + </listitem> + + <listitem> + <para>Nick Hilliard <email>nick@foobar.org</email></para> + </listitem> + + <listitem> + <para>Nick Sayer <email>nsayer@quack.kfu.com</email></para> + </listitem> + + <listitem> + <para>Nick Williams <email>njw@cs.city.ac.uk</email></para> + </listitem> + + <listitem> + <para>Nickolay N. Dudorov <email>nnd@itfs.nsk.su</email></para> + </listitem> + + <listitem> + <para>Niklas Hallqvist <email>niklas@filippa.appli.se</email></para> + </listitem> + + <listitem> + <para>Nisha Talagala <email>nisha@cs.berkeley.edu</email></para> + </listitem> + + <listitem> + <para>No Name <email>ZW6T-KND@j.asahi-net.or.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>adrian@virginia.edu</email></para> + </listitem> + + <listitem> + <para>No Name <email>alex@elvisti.kiev.ua</email></para> + </listitem> + + <listitem> + <para>No Name <email>anto@netscape.net</email></para> + </listitem> + + <listitem> + <para>No Name <email>bobson@egg.ics.nitch.ac.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>bovynf@awe.be</email></para> + </listitem> + + <listitem> + <para>No Name <email>burg@is.ge.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>chris@gnome.co.uk</email></para> + </listitem> + + <listitem> + <para>No Name <email>colsen@usa.net</email></para> + </listitem> + + <listitem> + <para>No Name <email>coredump@nervosa.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>dannyman@arh0300.urh.uiuc.edu</email></para> + </listitem> + + <listitem> + <para>No Name <email>davids@SECNET.COM</email></para> + </listitem> + + <listitem> + <para>No Name <email>derek@free.org</email></para> + </listitem> + + <listitem> + <para>No Name <email>devet@adv.IAEhv.nl</email></para> + </listitem> + + <listitem> + <para>No Name <email>djv@bedford.net</email></para> + </listitem> + + <listitem> + <para>No Name <email>dvv@sprint.net</email></para> + </listitem> + + <listitem> + <para>No Name <email>enami@ba2.so-net.or.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>flash@eru.tubank.msk.su</email></para> + </listitem> + + <listitem> + <para>No Name <email>flash@hway.ru</email></para> + </listitem> + + <listitem> + <para>No Name <email>fn@pain.csrv.uidaho.edu</email></para> + </listitem> + + <listitem> + <para>No Name <email>gclarkii@netport.neosoft.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>gordon@sheaky.lonestar.org</email></para> + </listitem> + + <listitem> + <para>No Name <email>graaf@iae.nl</email></para> + </listitem> + + <listitem> + <para>No Name <email>greg@greg.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>grossman@cygnus.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>gusw@fub46.zedat.fu-berlin.de</email></para> + </listitem> + + <listitem> + <para>No Name <email>hfir@math.rochester.edu</email></para> + </listitem> + + <listitem> + <para>No Name <email>hnokubi@yyy.or.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>iaint@css.tuu.utas.edu.au</email></para> + </listitem> + + <listitem> + <para>No Name <email>invis@visi.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>ishisone@sra.co.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>iverson@lionheart.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>jpt@magic.net</email></para> + </listitem> + + <listitem> + <para>No Name <email>junker@jazz.snu.ac.kr</email></para> + </listitem> + + <listitem> + <para>No Name <email>k-sugyou@ccs.mt.nec.co.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>kenji@reseau.toyonaka.osaka.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>kfurge@worldnet.att.net</email></para> + </listitem> + + <listitem> + <para>No Name <email>lh@aus.org</email></para> + </listitem> + + <listitem> + <para>No Name <email>lhecking@nmrc.ucc.ie</email></para> + </listitem> + + <listitem> + <para>No Name <email>mrgreen@mame.mu.oz.au</email></para> + </listitem> + + <listitem> + <para>No Name <email>nakagawa@jp.freebsd.org</email></para> + </listitem> + + <listitem> + <para>No Name <email>ohki@gssm.otsuka.tsukuba.ac.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>owaki@st.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>pechter@shell.monmouth.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>pete@pelican.pelican.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>pritc003@maroon.tc.umn.edu</email></para> + </listitem> + + <listitem> + <para>No Name <email>risner@stdio.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>roman@rpd.univ.kiev.ua</email></para> + </listitem> + + <listitem> + <para>No Name <email>root@ns2.redline.ru</email></para> + </listitem> + + <listitem> + <para>No Name <email>root@uglabgw.ug.cs.sunysb.edu</email></para> + </listitem> + + <listitem> + <para>No Name <email>stephen.ma@jtec.com.au</email></para> + </listitem> + + <listitem> + <para>No Name <email>sumii@is.s.u-tokyo.ac.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>takas-su@is.aist-nara.ac.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>tamone@eig.unige.ch</email></para> + </listitem> + + <listitem> + <para>No Name <email>tjevans@raleigh.ibm.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>tony-o@iij.ad.jp amurai@spec.co.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>torii@tcd.hitachi.co.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>uenami@imasy.or.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>uhlar@netlab.sk</email></para> + </listitem> + + <listitem> + <para>No Name <email>vode@hut.fi</email></para> + </listitem> + + <listitem> + <para>No Name <email>wlloyd@mpd.ca</email></para> + </listitem> + + <listitem> + <para>No Name <email>wlr@furball.wellsfargo.com</email></para> + </listitem> + + <listitem> + <para>No Name <email>wmbfmk@urc.tue.nl</email></para> + </listitem> + + <listitem> + <para>No Name <email>yamagata@nwgpc.kek.jp</email></para> + </listitem> + + <listitem> + <para>No Name <email>ziggy@ryan.org</email></para> + </listitem> + + <listitem> + <para>Nobuhiro Yasutomi <email>nobu@psrc.isac.co.jp</email></para> + </listitem> + + <listitem> + <para>Nobuyuki Koganemaru + <email>kogane@koganemaru.co.jp</email></para> + </listitem> + + <listitem> + <para>Norio Suzuki <email>nosuzuki@e-mail.ne.jp</email></para> + </listitem> + + <listitem> + <para>Noritaka Ishizumi <email>graphite@jp.FreeBSD.ORG</email></para> + </listitem> + + <listitem> + <para>Noriyuki Soda <email>soda@sra.co.jp</email></para> + </listitem> + + <listitem> + <para>Olaf Wagner <email>wagner@luthien.in-berlin.de</email></para> + </listitem> + + <listitem> + <para>Oleg Sharoiko <email>os@rsu.ru</email></para> + </listitem> + + <listitem> + <para>Oliver Breuninger <email>ob@seicom.NET</email></para> + </listitem> + + <listitem> + <para>Oliver Friedrichs <email>oliver@secnet.com</email></para> + </listitem> + + <listitem> + <para>Oliver Fromme + <email>oliver.fromme@heim3.tu-clausthal.de</email></para> + </listitem> + + <listitem> + <para>Oliver Laumann + <email>net@informatik.uni-bremen.de</email></para> + </listitem> + + <listitem> + <para>Oliver Oberdorf <email>oly@world.std.com</email></para> + </listitem> + + <listitem> + <para>Olof Johansson <email>offe@ludd.luth.se</email></para> + </listitem> + + <listitem> + <para>Osokin Sergey aka oZZ <email>ozz@freebsd.org.ru</email></para> + </listitem> + + <listitem> + <para>Pace Willisson <email>pace@blitz.com</email></para> + </listitem> + + <listitem> + <para>Paco Rosich <email>rosich@modico.eleinf.uv.es</email></para> + </listitem> + + <listitem> + <para>Palle Girgensohn <email>girgen@partitur.se</email></para> + </listitem> + + <listitem> + <para>Parag Patel <email>parag@cgt.com</email></para> + </listitem> + + <listitem> + <para>Pascal Pederiva <email>pascal@zuo.dec.com</email></para> + </listitem> + + <listitem> + <para>Pasvorn Boonmark <email>boonmark@juniper.net</email></para> + </listitem> + + <listitem> + <para>Patrick Gardella <email>patrick@cre8tivegroup.com</email></para> + </listitem> + + <listitem> + <para>Patrick Hausen <email>unknown</email></para> + </listitem> + + <listitem> + <para>Paul Antonov <email>apg@demos.su</email></para> + </listitem> + + <listitem> + <para>Paul F. Werkowski <email>unknown</email></para> + </listitem> + + <listitem> + <para>Paul Fox <email>pgf@foxharp.boston.ma.us</email></para> + </listitem> + + <listitem> + <para>Paul Koch <email>koch@thehub.com.au</email></para> + </listitem> + + <listitem> + <para>Paul Kranenburg <email>pk@NetBSD.org</email></para> + </listitem> + + <listitem> + <para>Paul Mackerras <email>paulus@cs.anu.edu.au</email></para> + </listitem> + + <listitem> + <para>Paul Popelka <email>paulp@uts.amdahl.com</email></para> + </listitem> + + <listitem> + <para>Paul S. LaFollette, Jr. <email>unknown</email></para> + </listitem> + + <listitem> + <para>Paul Saab <email>paul@mu.org</email></para> + </listitem> + + <listitem> + <para>Paul Sandys <email>myj@nyct.net</email></para> + </listitem> + + <listitem> + <para>Paul T. Root <email>proot@horton.iaces.com</email></para> + </listitem> + + <listitem> + <para>Paul Vixie <email>paul@vix.com</email></para> + </listitem> + + <listitem> + <para>Paulo Menezes <email>paulo@isr.uc.pt</email></para> + </listitem> + + <listitem> + <para>Paulo Menezes <email>pm@dee.uc.pt</email></para> + </listitem> + + <listitem> + <para>Pedro A M Vazquez <email>vazquez@IQM.Unicamp.BR</email></para> + </listitem> + + <listitem> + <para>Pedro Giffuni <email>giffunip@asme.org</email></para> + </listitem> + + <listitem> + <para>Pete Bentley <email>pete@demon.net</email></para> + </listitem> + + <listitem> + <para>Peter Childs <email>pjchilds@imforei.apana.org.au</email></para> + </listitem> + + <listitem> + <para>Peter Cornelius <email>pc@inr.fzk.de</email></para> + </listitem> + + <listitem> + <para>Peter Haight <email>peterh@prognet.com</email></para> + </listitem> + + <listitem> + <para>Peter Jeremy <email>perer.jeremy@alcatel.com.au</email></para> + </listitem> + + <listitem> + <para>Peter M. Chen <email>pmchen@eecs.umich.edu</email></para> + </listitem> + + <listitem> + <para>Peter Much <email>peter@citylink.dinoex.sub.org</email></para> + </listitem> + + <listitem> + <para>Peter Olsson <email>unknown</email></para> + </listitem> + + <listitem> + <para>Peter Philipp <email>pjp@bsd-daemon.net</email></para> + </listitem> + + <listitem> + <para>Peter Stubbs <email>PETERS@staidan.qld.edu.au</email></para> + </listitem> + + <listitem> + <para>Phil Maker <email>pjm@cs.ntu.edu.au</email></para> + </listitem> + + <listitem> + <para>Phil Sutherland + <email>philsuth@mycroft.dialix.oz.au</email></para> + </listitem> + + <listitem> + <para>Phil Taylor <email>phil@zipmail.co.uk</email></para> + </listitem> + + <listitem> + <para>Philip Musumeci <email>philip@rmit.edu.au</email></para> + </listitem> + + <listitem> + <para>Pierre Y. Dampure <email>pierre.dampure@k2c.co.uk</email></para> + </listitem> + + <listitem> + <para>Pius Fischer <email>pius@ienet.com</email></para> + </listitem> + + <listitem> + <para>Pomegranate <email>daver@flag.blackened.net</email></para> + </listitem> + + <listitem> + <para>Powerdog Industries + <email>kevin.ruddy@powerdog.com</email></para> + </listitem> + + <listitem> + <para>R. Kym Horsell</para> + </listitem> + + <listitem> + <para>Rajesh Vaidheeswarran <email>rv@fore.com</email></para> + </listitem> + + <listitem> + <para>Ralf Friedl <email>friedl@informatik.uni-kl.de</email></para> + </listitem> + + <listitem> + <para>Randal S. Masutani <email>randal@comtest.com</email></para> + </listitem> + + <listitem> + <para>Randall Hopper <email>rhh@ct.picker.com</email></para> + </listitem> + + <listitem> + <para>Randall W. Dean <email>rwd@osf.org</email></para> + </listitem> + + <listitem> + <para>Randy Bush <email>rbush@bainbridge.verio.net</email></para> + </listitem> + + <listitem> + <para>Reinier Bezuidenhout + <email>rbezuide@mikom.csir.co.za</email></para> + </listitem> + + <listitem> + <para>Remy Card <email>Remy.Card@masi.ibp.fr</email></para> + </listitem> + + <listitem> + <para>Ricardas Cepas <email>rch@richard.eu.org</email></para> + </listitem> + + <listitem> + <para>Richard Henderson <email>richard@atheist.tamu.edu</email></para> + </listitem> + + <listitem> + <para>Richard Hwang <email>rhwang@bigpanda.com</email></para> + </listitem> + + <listitem> + <para>Richard J Kuhns <email>rjk@watson.grauel.com</email></para> + </listitem> + + <listitem> + <para>Richard M. Neswold + <email>rneswold@drmemory.fnal.gov</email></para> + </listitem> + + <listitem> + <para>Richard Seaman, Jr. <email>dick@tar.com</email></para> + </listitem> + + <listitem> + <para>Richard Stallman <email>rms@gnu.ai.mit.edu</email></para> + </listitem> + + <listitem> + <para>Richard Straka <email>straka@user1.inficad.com</email></para> + </listitem> + + <listitem> + <para>Richard Tobin <email>richard@cogsci.ed.ac.uk</email></para> + </listitem> + + <listitem> + <para>Richard Wackerbarth <email>rkw@Dataplex.NET</email></para> + </listitem> + + <listitem> + <para>Richard Winkel <email>rich@math.missouri.edu</email></para> + </listitem> + + <listitem> + <para>Richard Wiwatowski <email>rjwiwat@adelaide.on.net</email></para> + </listitem> + + <listitem> + <para>Rick Macklem <email>rick@snowhite.cis.uoguelph.ca</email></para> + </listitem> + + <listitem> + <para>Rick Macklin <email>unknown</email></para> + </listitem> + + <listitem> + <para>Rob Austein <email>sra@epilogue.com</email></para> + </listitem> + + <listitem> + <para>Rob Mallory <email>rmallory@qualcomm.com</email></para> + </listitem> + + <listitem> + <para>Rob Snow <email>rsnow@txdirect.net</email></para> + </listitem> + + <listitem> + <para>Robert Crowe <email>bob@speakez.com</email></para> + </listitem> + + <listitem> + <para>Robert D. Thrush <email>rd@phoenix.aii.com</email></para> + </listitem> + + <listitem> + <para>Robert Eckardt + <email>roberte@MEP.Ruhr-Uni-Bochum.de</email></para> + </listitem> + + <listitem> + <para>Robert Sanders <email>rsanders@mindspring.com</email></para> + </listitem> + + <listitem> + <para>Robert Sexton <email>robert@kudra.com</email></para> + </listitem> + + <listitem> + <para>Robert Shady <email>rls@id.net</email></para> + </listitem> + + <listitem> + <para>Robert Swindells <email>swindellsr@genrad.co.uk</email></para> + </listitem> + + <listitem> + <para>Robert Watson <email>robert@cyrus.watson.org</email></para> + </listitem> + + <listitem> + <para>Robert Withrow <email>witr@rwwa.com</email></para> + </listitem> + + <listitem> + <para>Robert Yoder <email>unknown</email></para> + </listitem> + + <listitem> + <para>Robin Carey + <email>robin@mailgate.dtc.rankxerox.co.uk</email></para> + </listitem> + + <listitem> + <para>Roger Hardiman <email>roger@cs.strath.ac.uk</email></para> + </listitem> + + <listitem> + <para>Roland Jesse <email>jesse@cs.uni-magdeburg.de</email></para> + </listitem> + + <listitem> + <para>Ron Bickers <email>rbickers@intercenter.net</email></para> + </listitem> + + <listitem> + <para>Ron Lenk <email>rlenk@widget.xmission.com</email></para> + </listitem> + + <listitem> + <para>Ronald Kuehn <email>kuehn@rz.tu-clausthal.de</email></para> + </listitem> + + <listitem> + <para>Rudolf Cejka <email>unknown</email></para> + </listitem> + + <listitem> + <para>Ruslan Belkin <email>rus@home2.UA.net</email></para> + </listitem> + + <listitem> + <para>Ruslan Ermilov <email>ru@ucb.crimea.ua</email></para> + </listitem> + + <listitem> + <para>Ruslan Shevchenko <email>rssh@cam.grad.kiev.ua</email></para> + </listitem> + + <listitem> + <para>Russell L. Carter <email>rcarter@pinyon.org</email></para> + </listitem> + + <listitem> + <para>Russell Vincent <email>rv@groa.uct.ac.za</email></para> + </listitem> + + <listitem> + <para>Ryan Younce <email>ryany@pobox.com</email></para> + </listitem> + + <listitem> + <para>SANETO Takanori <email>sanewo@strg.sony.co.jp</email></para> + </listitem> + + <listitem> + <para>SAWADA Mizuki <email>miz@qb3.so-net.ne.jp</email></para> + </listitem> + + <listitem> + <para>SUGIMURA Takashi <email>sugimura@jp.FreeBSD.ORG</email></para> + </listitem> + + <listitem> + <para>SURANYI Peter + <email>suranyip@jks.is.tsukuba.ac.jp</email></para> + </listitem> + + <listitem> + <para>Sakari Jalovaara <email>sja@tekla.fi</email></para> + </listitem> + + <listitem> + <para>Sam Hartman <email>hartmans@mit.edu</email></para> + </listitem> + + <listitem> + <para>Samuel Lam <email>skl@ScalableNetwork.com</email></para> + </listitem> + + <listitem> + <para>Sander Vesik <email>sander@haldjas.folklore.ee</email></para> + </listitem> + + <listitem> + <para>Sandro Sigala <email>ssigala@globalnet.it</email></para> + </listitem> + + <listitem> + <para>Sascha Blank <email>blank@fox.uni-trier.de</email></para> + </listitem> + + <listitem> + <para>Sascha Wildner <email>swildner@channelz.GUN.de</email></para> + </listitem> + + <listitem> + <para>Satoh Junichi <email>junichi@astec.co.jp</email></para> + </listitem> + + <listitem> + <para>Satoshi Taoka + <email>taoka@infonets.hiroshima-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Scot Elliott <email>scot@poptart.org</email></para> + </listitem> + + <listitem> + <para>Scot W. Hetzel <email>hetzels@westbend.net</email></para> + </listitem> + + <listitem> + <para>Scott A. Kenney <email>saken@rmta.ml.org</email></para> + </listitem> + + <listitem> + <para>Scott Blachowicz + <email>scott.blachowicz@seaslug.org</email></para> + </listitem> + + <listitem> + <para>Scott Burris <email>scott@pita.cns.ucla.edu</email></para> + </listitem> + + <listitem> + <para>Scott Hazen Mueller <email>scott@zorch.sf-bay.org</email></para> + </listitem> + + <listitem> + <para>Scott Michel <email>scottm@cs.ucla.edu</email></para> + </listitem> + + <listitem> + <para>Scott Reynolds <email>scott@clmqt.marquette.mi.us</email></para> + </listitem> + + <listitem> + <para>Sebastian Strollo <email>seb@erix.ericsson.se</email></para> + </listitem> + + <listitem> + <para>Seigou TANIMURA + <email>tanimura@naklab.dnj.ynu.ac.jp</email></para> + </listitem> + + <listitem> + <para>Serge A. Babkin <email>babkin@hq.icb.chel.su</email></para> + </listitem> + + <listitem> + <para>Serge V. Vakulenko <email>vak@zebub.msk.su</email></para> + </listitem> + + <listitem> + <para>Sergei Chechetkin + <email>csl@whale.sunbay.crimea.ua</email></para> + </listitem> + + <listitem> + <para>Sergei S. Laskavy <email>laskavy@pc759.cs.msu.su</email></para> + </listitem> + + <listitem> + <para>Sergey Gershtein <email>sg@mplik.ru</email></para> + </listitem> + + <listitem> + <para>Sergey Potapov <email>sp@alkor.ru</email></para> + </listitem> + + <listitem> + <para>Sergey Shkonda <email>serg@bcs.zp.ua</email></para> + </listitem> + + <listitem> + <para>Sergey V.Dorokhov <email>svd@kbtelecom.nalnet.ru</email></para> + </listitem> + + <listitem> + <para>Sergio Lenzi <email>lenzi@bsi.com.br</email></para> + </listitem> + + <listitem> + <para>Shaun Courtney <email>shaun@emma.eng.uct.ac.za</email></para> + </listitem> + + <listitem> + <para>Shawn M. Carey <email>smcarey@mailbox.syr.edu</email></para> + </listitem> + + <listitem> + <para>Sheldon Hearn <email>axl@iafrica.com</email></para> + </listitem> + + <listitem> + <para>Shigio Yamaguchi <email>shigio@wafu.netgate.net</email></para> + </listitem> + + <listitem> + <para>Shunsuke Akiyama <email>akiyama@jp.freebsd.org</email></para> + </listitem> + + <listitem> + <para>Simon <email>simon@masi.ibp.fr</email></para> + </listitem> + + <listitem> + <para>Simon Burge <email>simonb@telstra.com.au</email></para> + </listitem> + + <listitem> + <para>Simon J Gerraty <email>sjg@melb.bull.oz.au</email></para> + </listitem> + + <listitem> + <para>Simon Marlow <email>simonm@dcs.gla.ac.uk</email></para> + </listitem> + + <listitem> + <para>Simon Shapiro <email>shimon@simon-shapiro.org</email></para> + </listitem> + + <listitem> + <para>Sin'ichiro MIYATANI <email>siu@phaseone.co.jp</email></para> + </listitem> + + <listitem> + <para>Slaven Rezic <email>eserte@cs.tu-berlin.de</email></para> + </listitem> + + <listitem> + <para>Soochon Radee <email>slr@mitre.org</email></para> + </listitem> + + <listitem> + <para>Soren Dayton <email>csdayton@midway.uchicago.edu</email></para> + </listitem> + + <listitem> + <para>Soren Dossing <email>sauber@netcom.com</email></para> + </listitem> + + <listitem> + <para>Soren S. Jorvang <email>soren@dt.dk</email></para> + </listitem> + + <listitem> + <para>Stefan Bethke <email>stb@hanse.de</email></para> + </listitem> + + <listitem> + <para>Stefan Eggers <email>seggers@semyam.dinoco.de</email></para> + </listitem> + + <listitem> + <para>Stefan Moeding <email>s.moeding@ndh.net</email></para> + </listitem> + + <listitem> + <para>Stefan Petri <email>unknown</email></para> + </listitem> + + <listitem> + <para>Stefan `Sec` Zehl <email>sec@42.org</email></para> + </listitem> + + <listitem> + <para>Steinar Haug <email>sthaug@nethelp.no</email></para> + </listitem> + + <listitem> + <para>Stephane E. Potvin <email>sepotvin@videotron.ca</email></para> + </listitem> + + <listitem> + <para>Stephane Legrand <email>stephane@lituus.fr</email></para> + </listitem> + + <listitem> + <para>Stephen Clawson + <email>sclawson@marker.cs.utah.edu</email></para> + </listitem> + + <listitem> + <para>Stephen F. Combs <email>combssf@salem.ge.com</email></para> + </listitem> + + <listitem> + <para>Stephen Farrell <email>stephen@farrell.org</email></para> + </listitem> + + <listitem> + <para>Stephen Hocking <email>sysseh@devetir.qld.gov.au</email></para> + </listitem> + + <listitem> + <para>Stephen J. Roznowski <email>sjr@home.net</email></para> + </listitem> + + <listitem> + <para>Stephen McKay <email>syssgm@devetir.qld.gov.au</email></para> + </listitem> + + <listitem> + <para>Stephen Melvin <email>melvin@zytek.com</email></para> + </listitem> + + <listitem> + <para>Steve Bauer <email>sbauer@rock.sdsmt.edu</email></para> + </listitem> + + <listitem> + <para>Steve Deering <email>unknown</email></para> + </listitem> + + <listitem> + <para>Steve Gerakines <email>steve2@genesis.tiac.net</email></para> + </listitem> + + <listitem> + <para>Steve Gericke <email>steveg@comtrol.com</email></para> + </listitem> + + <listitem> + <para>Steve Piette <email>steve@simon.chi.il.US</email></para> + </listitem> + + <listitem> + <para>Steve Schwarz <email>schwarz@alpharel.com</email></para> + </listitem> + + <listitem> + <para>Steven G. Kargl + <email>kargl@troutmask.apl.washington.edu</email></para> + </listitem> + + <listitem> + <para>Steven H. Samorodin <email>samorodi@NUXI.com</email></para> + </listitem> + + <listitem> + <para>Steven McCanne <email>mccanne@cs.berkeley.edu</email></para> + </listitem> + + <listitem> + <para>Steven Plite <email>splite@purdue.edu</email></para> + </listitem> + + <listitem> + <para>Steven Wallace <email>unknown</email></para> + </listitem> + + <listitem> + <para>Stuart Henderson + <email>stuart@internationalschool.co.uk</email></para> + </listitem> + + <listitem> + <para>Sue Blake <email>sue@welearn.com.au</email></para> + </listitem> + + <listitem> + <para>Sugiura Shiro <email>ssugiura@duo.co.jp</email></para> + </listitem> + + <listitem> + <para>Sujal Patel <email>smpatel@wam.umd.edu</email></para> + </listitem> + + <listitem> + <para>Sune Stjerneby <email>stjerneby@usa.net</email></para> + </listitem> + + <listitem> + <para>Suzuki Yoshiaki + <email>zensyo@ann.tama.kawasaki.jp</email></para> + </listitem> + + <listitem> + <para>Tadashi Kumano <email>kumano@strl.nhk.or.jp</email></para> + </listitem> + + <listitem> + <para>Taguchi Takeshi <email>taguchi@tohoku.iij.ad.jp</email></para> + </listitem> + + <listitem> + <para>Takahashi Yoshihiro <email>nyan@dd.catv.ne.jp</email></para> + </listitem> + + <listitem> + <para>Takahiro Yugawa <email>yugawa@orleans.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>Takanori Watanabe + <email>takawata@shidahara1.planet.sci.kobe-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Takashi Mega <email>mega@minz.org</email></para> + </listitem> + + <listitem> + <para>Takashi Uozu <email>j1594016@ed.kagu.sut.ac.jp</email></para> + </listitem> + + <listitem> + <para>Takayuki Ariga <email>a00821@cc.hc.keio.ac.jp</email></para> + </listitem> + + <listitem> + <para>Takeru NAIKI <email>naiki@bfd.es.hokudai.ac.jp</email></para> + </listitem> + + <listitem> + <para>Takeshi Amaike <email>amaike@iri.co.jp</email></para> + </listitem> + + <listitem> + <para>Takeshi MUTOH <email>mutoh@info.nara-k.ac.jp</email></para> + </listitem> + + <listitem> + <para>Takeshi Ohashi + <email>ohashi@mickey.ai.kyutech.ac.jp</email></para> + </listitem> + + <listitem> + <para>Takeshi WATANABE + <email>watanabe@crayon.earth.s.kobe-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Takuya SHIOZAKI + <email>tshiozak@makino.ise.chuo-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Tatoku Ogaito <email>tacha@tera.fukui-med.ac.jp</email></para> + </listitem> + + <listitem> + <para>Tatsumi HOSOKAWA <email>hosokawa@jp.FreeBSD.org</email></para> + </listitem> + + <listitem> + <para>Ted Buswell <email>tbuswell@mediaone.net</email></para> + </listitem> + + <listitem> + <para>Ted Faber <email>faber@isi.edu</email></para> + </listitem> + + <listitem> + <para>Ted Lemon <email>unknown</email></para> + </listitem> + + <listitem> + <para>Terry Lambert <email>terry@lambert.org</email></para> + </listitem> + + <listitem> + <para>Terry Lee <email>terry@uivlsi.csl.uiuc.edu</email></para> + </listitem> + + <listitem> + <para>Tetsuya Furukawa <email>tetsuya@secom-sis.co.jp</email></para> + </listitem> + + <listitem> + <para>Theo de Raadt <email>deraadt@OpenBSD.org</email></para> + </listitem> + + <listitem> + <para>Thomas <email>thomas@mathematik.uni-Bremen.de</email></para> + </listitem> + + <listitem> + <para>Thomas D. Dean <email>tomdean@ix.netcom.com</email></para> + </listitem> + + <listitem> + <para>Thomas David Rivers <email>rivers@dignus.com</email></para> + </listitem> + + <listitem> + <para>Thomas G. McWilliams <email>tgm@netcom.com</email></para> + </listitem> + + <listitem> + <para>Thomas Gellekum + <email>thomas@ghpc8.ihf.rwth-aachen.de</email></para> + </listitem> + + <listitem> + <para>Thomas Graichen + <email>graichen@omega.physik.fu-berlin.de</email></para> + </listitem> + + <listitem> + <para>Thomas König + <email>Thomas.Koenig@ciw.uni-karlsruhe.de</email></para> + </listitem> + + <listitem> + <para>Thomas Ptacek <email>unknown</email></para> + </listitem> + + <listitem> + <para>Thomas Stromberg <email>tstrombe@rtci.com</email></para> + </listitem> + + <listitem> + <para>Thomas Valentino Crimi + <email>tcrimi+@andrew.cmu.edu</email></para> + </listitem> + + <listitem> + <para>Thomas Wintergerst <email>thomas@lemur.nord.de</email></para> + </listitem> + + <listitem> + <para>Þórður Ívarsson + <email>totii@est.is</email></para> + </listitem> + + <listitem> + <para>Tim Kientzle <email>kientzle@netcom.com</email></para> + </listitem> + + <listitem> + <para>Tim Singletary + <email>tsingle@sunland.gsfc.nasa.gov</email></para> + </listitem> + + <listitem> + <para>Tim Wilkinson <email>tim@sarc.city.ac.uk</email></para> + </listitem> + + <listitem> + <para>Timo J. Rinne <email>tri@iki.fi</email></para> + </listitem> + + <listitem> + <para>Todd Miller <email>millert@openbsd.org</email></para> + </listitem> + + <listitem> + <para>Tom <email>root@majestix.cmr.no</email></para> + </listitem> + + <listitem> + <para>Tom <email>tom@sdf.com</email></para> + </listitem> + + <listitem> + <para>Tom Gray - DCA <email>dcasba@rain.org</email></para> + </listitem> + + <listitem> + <para>Tom Hukins <email>tom@eborcom.com</email></para> + </listitem> + + <listitem> + <para>Tom Jobbins <email>tom@tom.tj</email></para> + </listitem> + + <listitem> + <para>Tom Pusateri <email>pusateri@juniper.net</email></para> + </listitem> + + <listitem> + <para>Tom Rush <email>tarush@mindspring.com</email></para> + </listitem> + + <listitem> + <para>Tom Samplonius <email>tom@misery.sdf.com</email></para> + </listitem> + + <listitem> + <para>Tomohiko Kurahashi + <email>kura@melchior.q.t.u-tokyo.ac.jp</email></para> + </listitem> + + <listitem> + <para>Tony Kimball <email>alk@Think.COM</email></para> + </listitem> + + <listitem> + <para>Tony Li <email>tli@jnx.com</email></para> + </listitem> + + <listitem> + <para>Tony Lynn <email>wing@cc.nsysu.edu.tw</email></para> + </listitem> + + <listitem> + <para>Torbjorn Granlund <email>tege@matematik.su.se</email></para> + </listitem> + + <listitem> + <para>Toshihiko ARAI <email>toshi@tenchi.ne.jp</email></para> + </listitem> + + <listitem> + <para>Toshihiko SHIMOKAWA <email>toshi@tea.forus.or.jp</email></para> + </listitem> + + <listitem> + <para>Toshihiro Kanda <email>candy@kgc.co.jp</email></para> + </listitem> + + <listitem> + <para>Toshiomi Moriki + <email>Toshiomi.Moriki@ma1.seikyou.ne.jp</email></para> + </listitem> + + <listitem> + <para>Trefor S. <email>trefor@flevel.co.uk</email></para> + </listitem> + + <listitem> + <para>Trevor Blackwell <email>tlb@viaweb.com</email></para> + </listitem> + + <listitem> + <para>URATA Shuichiro <email>s-urata@nmit.tmg.nec.co.jp</email></para> + </listitem> + + <listitem> + <para>Ugo Paternostro <email>paterno@dsi.unifi.it</email></para> + </listitem> + + <listitem> + <para>Ulf Kieber <email>kieber@sax.de</email></para> + </listitem> + + <listitem> + <para>Ulli Linzen <email>ulli@perceval.camelot.de</email></para> + </listitem> + + <listitem> + <para>Ustimenko Semen <email>semen@iclub.nsu.ru</email></para> + </listitem> + + <listitem> + <para>Uwe Arndt <email>arndt@mailhost.uni-koblenz.de</email></para> + </listitem> + + <listitem> + <para>Vadim Chekan <email>vadim@gc.lviv.ua</email></para> + </listitem> + + <listitem> + <para>Vadim Kolontsov <email>vadim@tversu.ac.ru</email></para> + </listitem> + + <listitem> + <para>Vadim Mikhailov <email>mvp@braz.ru</email></para> + </listitem> + + <listitem> + <para>Van Jacobson <email>van@ee.lbl.gov</email></para> + </listitem> + + <listitem> + <para>Vasily V. Grechishnikov + <email>bazilio@ns1.ied-vorstu.ac.ru</email></para> + </listitem> + + <listitem> + <para>Vasim Valejev <email>vasim@uddias.diaspro.com</email></para> + </listitem> + + <listitem> + <para>Vernon J. Schryver <email>vjs@mica.denver.sgi.com</email></para> + </listitem> + + <listitem> + <para>Vic Abell <email>abe@cc.purdue.edu</email></para> + </listitem> + + <listitem> + <para>Ville Eerola <email>ve@sci.fi</email></para> + </listitem> + + <listitem> + <para>Vincent Poy <email>vince@venus.gaianet.net</email></para> + </listitem> + + <listitem> + <para>Vincenzo Capuano + <email>VCAPUANO@vmprofs.esoc.esa.de</email></para> + </listitem> + + <listitem> + <para>Virgil Champlin <email>champlin@pa.dec.com</email></para> + </listitem> + + <listitem> + <para>Vladimir A. Jakovenko + <email>vovik@ntu-kpi.kiev.ua</email></para> + </listitem> + + <listitem> + <para>Vladimir Kushnir <email>kushn@mail.kar.net</email></para> + </listitem> + + <listitem> + <para>Vsevolod Lobko <email>seva@alex-ua.com</email></para> + </listitem> + + <listitem> + <para>W. Gerald Hicks <email>wghicks@bellsouth.net</email></para> + </listitem> + + <listitem> + <para>W. Richard Stevens <email>rstevens@noao.edu</email></para> + </listitem> + + <listitem> + <para>Walt Howard <email>howard@ee.utah.edu</email></para> + </listitem> + + <listitem> + <para>Warren Toomey <email>wkt@csadfa.cs.adfa.oz.au</email></para> + </listitem> + + <listitem> + <para>Wayne Scott <email>wscott@ichips.intel.com</email></para> + </listitem> + + <listitem> + <para>Werner Griessl + <email>werner@btp1da.phy.uni-bayreuth.de</email></para> + </listitem> + + <listitem> + <para>Wes Santee <email>wsantee@wsantee.oz.net</email></para> + </listitem> + + <listitem> + <para>Wietse Venema <email>wietse@wzv.win.tue.nl</email></para> + </listitem> + + <listitem> + <para>Wilfredo Sanchez <email>wsanchez@apple.com</email></para> + </listitem> + + <listitem> + <para>Wiljo Heinen <email>wiljo@freeside.ki.open.de</email></para> + </listitem> + + <listitem> + <para>Wilko Bulte <email>wilko@yedi.iaf.nl</email></para> + </listitem> + + <listitem> + <para>Willem Jan Withagen <email>wjw@surf.IAE.nl</email></para> + </listitem> + + <listitem> + <para>William Jolitz <email>withheld</email></para> + </listitem> + + <listitem> + <para>William Liao <email>william@tale.net</email></para> + </listitem> + + <listitem> + <para>Wojtek Pilorz + <email>wpilorz@celebris.bdk.lublin.pl</email></para> + </listitem> + + <listitem> + <para>Wolfgang Helbig <email>helbig@ba-stuttgart.de</email></para> + </listitem> + + <listitem> + <para>Wolfgang Solfrank <email>ws@tools.de</email></para> + </listitem> + + <listitem> + <para>Wolfgang Stanglmeier <email>wolf@FreeBSD.org</email></para> + </listitem> + + <listitem> + <para>Wu Ching-hong <email>woju@FreeBSD.ee.Ntu.edu.TW</email></para> + </listitem> + + <listitem> + <para>Yarema <email>yds@ingress.com</email></para> + </listitem> + + <listitem> + <para>Yaroslav Terletsky <email>ts@polynet.lviv.ua</email></para> + </listitem> + + <listitem> + <para>Yen-Shuo Su <email>yssu@CCCA.NCTU.edu.tw</email></para> + </listitem> + + <listitem> + <para>Ying-Chieh Liao <email>ijliao@csie.NCTU.edu.tw</email></para> + </listitem> + + <listitem> + <para>Yixin Jin <email>yjin@rain.cs.ucla.edu</email></para> + </listitem> + + <listitem> + <para>Yoshiaki Uchikawa <email>yoshiaki@kt.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>Yoshihiko OHTA <email>yohta@bres.tsukuba.ac.jp</email></para> + </listitem> + + <listitem> + <para>Yoshihisa NAKAGAWA + <email>y-nakaga@ccs.mt.nec.co.jp</email></para> + </listitem> + + <listitem> + <para>Yoshikazu Goto <email>gotoh@ae.anritsu.co.jp</email></para> + </listitem> + + <listitem> + <para>Yoshimasa Ohnishi + <email>ohnishi@isc.kyutech.ac.jp</email></para> + </listitem> + + <listitem> + <para>Yoshishige Arai <email>ryo2@on.rim.or.jp</email></para> + </listitem> + + <listitem> + <para>Yuichi MATSUTAKA <email>matutaka@osa.att.ne.jp</email></para> + </listitem> + + <listitem> + <para>Yujiro MIYATA + <email>miyata@bioele.nuee.nagoya-u.ac.jp</email></para> + </listitem> + + <listitem> + <para>Yukihiro Nakai <email>nacai@iname.com</email></para> + </listitem> + + <listitem> + <para>Yusuke Nawano <email>azuki@azkey.org</email></para> + </listitem> + + <listitem> + <para>Yuval Yarom <email>yval@cs.huji.ac.il</email></para> + </listitem> + + <listitem> + <para>Yves Fonk <email>yves@cpcoup5.tn.tudelft.nl</email></para> + </listitem> + + <listitem> + <para>Yves Fonk <email>yves@dutncp8.tn.tudelft.nl</email></para> + </listitem> + + <listitem> + <para>Zach Heilig <email>zach@gaffaneys.com</email></para> + </listitem> + + <listitem> + <para>Zahemszhky Gabor <email>zgabor@code.hu</email></para> + </listitem> + + <listitem> + <para>Zhong Ming-Xun <email>zmx@mail.CDPA.nsysu.edu.tw</email></para> + </listitem> + + <listitem> + <para>arci <email>vega@sophia.inria.fr</email></para> + </listitem> + + <listitem> + <para>der Mouse <email>mouse@Collatz.McRCIM.McGill.EDU</email></para> + </listitem> + + <listitem> + <para>frf <email>frf@xocolatl.com</email></para> + </listitem> + + <listitem> + <para>Ege Rekk <email>aagero@aage.priv.no</email></para> + </listitem> + </itemizedlist> + </sect1> + + <sect1> + <title>386BSD パッチキットへのパッチ提供者</title> + + <para>(名前でアルファベット順):</para> + + <itemizedlist> + <listitem> + <para>Adam Glass <email>glass@postgres.berkeley.edu</email></para> + </listitem> + + <listitem> + <para>Adrian Hall <email>adrian@ibmpcug.co.uk</email></para> + </listitem> + + <listitem> + <para>Andrey A. Chernov <email>ache@astral.msk.su</email></para> + </listitem> + + <listitem> + <para>Andrew Herbert <email>andrew@werple.apana.org.au</email></para> + </listitem> + + <listitem> + <para>Andrew Moore <email>alm@netcom.com</email></para> + </listitem> + + <listitem> + <para>Andy Valencia <email>ajv@csd.mot.com</email> + <email>jtk@netcom.com</email></para> + </listitem> + + <listitem> + <para>Arne Henrik Juul <email>arnej@Lise.Unit.NO</email></para> + </listitem> + + <listitem> + <para>Bakul Shah <email>bvs@bitblocks.com</email></para> + </listitem> + + <listitem> + <para>Barry Lustig <email>barry@ictv.com</email></para> + </listitem> + + <listitem> + <para>Bob Wilcox <email>bob@obiwan.uucp</email></para> + </listitem> + + <listitem> + <para>Branko Lankester</para> + </listitem> + + <listitem> + <para>Brett Lymn <email>blymn@mulga.awadi.com.AU</email></para> + </listitem> + + <listitem> + <para>Charles Hannum <email>mycroft@ai.mit.edu</email></para> + </listitem> + + <listitem> + <para>Chris G. Demetriou + <email>cgd@postgres.berkeley.edu</email></para> + </listitem> + + <listitem> + <para>Chris Torek <email>torek@ee.lbl.gov</email></para> + </listitem> + + <listitem> + <para>Christoph Robitschko + <email>chmr@edvz.tu-graz.ac.at</email></para> + </listitem> + + <listitem> + <para>Daniel Poirot <email>poirot@aio.jsc.nasa.gov</email></para> + </listitem> + + <listitem> + <para>Dave Burgess <email>burgess@hrd769.brooks.af.mil</email></para> + </listitem> + + <listitem> + <para>Dave Rivers <email>rivers@ponds.uucp</email></para> + </listitem> + + <listitem> + <para>David Dawes <email>dawes@physics.su.OZ.AU</email></para> + </listitem> + + <listitem> + <para>David Greenman <email>dg@Root.COM</email></para> + </listitem> + + <listitem> + <para>Eric J. Haug <email>ejh@slustl.slu.edu</email></para> + </listitem> + + <listitem> + <para>Felix Gaehtgens + <email>felix@escape.vsse.in-berlin.de</email></para> + </listitem> + + <listitem> + <para>Frank Maclachlan <email>fpm@crash.cts.com</email></para> + </listitem> + + <listitem> + <para>Gary A. Browning <email>gab10@griffcd.amdahl.com</email></para> + </listitem> + + <listitem> + <para>Gary Howland <email>gary@hotlava.com</email></para> + </listitem> + + <listitem> + <para>Geoff Rehmet <email>csgr@alpha.ru.ac.za</email></para> + </listitem> + + <listitem> + <para>Goran Hammarback <email>goran@astro.uu.se</email></para> + </listitem> + + <listitem> + <para>Guido van Rooij <email>guido@gvr.org</email></para> + </listitem> + + <listitem> + <para>Guy Harris <email>guy@auspex.com</email></para> + </listitem> + + <listitem> + <para>Havard Eidnes + <email>Havard.Eidnes@runit.sintef.no</email></para> + </listitem> + + <listitem> + <para>Herb Peyerl <email>hpeyerl@novatel.cuc.ab.ca</email></para> + </listitem> + + <listitem> + <para>Holger Veit <email>Holger.Veit@gmd.de</email></para> + </listitem> + + <listitem> + <para>Ishii Masahiro, R. Kym Horsell</para> + </listitem> + + <listitem> + <para>J.T. Conklin <email>jtc@cygnus.com</email></para> + </listitem> + + <listitem> + <para>Jagane D Sundar <email>jagane@netcom.com</email></para> + </listitem> + + <listitem> + <para>James Clark <email>jjc@jclark.com</email></para> + </listitem> + + <listitem> + <para>James Jegers <email>jimj@miller.cs.uwm.edu</email></para> + </listitem> + + <listitem> + <para>James W. Dolter</para> + </listitem> + + <listitem> + <para>James da Silva <email>jds@cs.umd.edu</email> et al</para> + </listitem> + + <listitem> + <para>Jay Fenlason <email>hack@datacube.com</email></para> + </listitem> + + <listitem> + <para>Jim Wilson <email>wilson@moria.cygnus.com</email></para> + </listitem> + + <listitem> + <para>Jörg Lohse + <email>lohse@tech7.informatik.uni-hamburg.de</email></para> + </listitem> + + <listitem> + <para>Jörg Wunsch + <email>joerg_wunsch@uriah.heep.sax.de</email></para> + </listitem> + + <listitem> + <para>John Dyson</para> + </listitem> + + <listitem> + <para>John Woods <email>jfw@eddie.mit.edu</email></para> + </listitem> + + <listitem> + <para>Jordan K. Hubbard <email>jkh@whisker.hubbard.ie</email></para> + </listitem> + + <listitem> + <para>Julian Elischer <email>julian@dialix.oz.au</email></para> + </listitem> + + <listitem> + <para>Julian Stacey <email>jhs@freebsd.org</email></para> + </listitem> + + <listitem> + <para>Karl Dietz <email>Karl.Dietz@triplan.com</email></para> + </listitem> + + <listitem> + <para>Karl Lehenbauer <email>karl@NeoSoft.com</email> + <email>karl@one.neosoft.com</email></para> + </listitem> + + <listitem> + <para>Keith Bostic <email>bostic@toe.CS.Berkeley.EDU</email></para> + </listitem> + + <listitem> + <para>Ken Hughes</para> + </listitem> + + <listitem> + <para>Kent Talarico <email>kent@shipwreck.tsoft.net</email></para> + </listitem> + + <listitem> + <para>Kevin Lahey <email>kml%rokkaku.UUCP@mathcs.emory.edu</email> + <email>kml@mosquito.cis.ufl.edu</email></para> + </listitem> + + <listitem> + <para>Marc Frajola <email>marc@dev.com</email></para> + </listitem> + + <listitem> + <para>Mark Tinguely <email>tinguely@plains.nodak.edu</email> + <email>tinguely@hookie.cs.ndsu.NoDak.edu</email></para> + </listitem> + + <listitem> + <para>Martin Renters <email>martin@tdc.on.ca</email></para> + </listitem> + + <listitem> + <para>Michael Clay <email>mclay@weareb.org</email></para> + </listitem> + + <listitem> + <para>Michael Galassi <email>nerd@percival.rain.com</email></para> + </listitem> + + <listitem> + <para>Mike Durkin <email>mdurkin@tsoft.sf-bay.org</email></para> + </listitem> + + <listitem> + <para>Naoki Hamada <email>nao@tom-yam.or.jp</email></para> + </listitem> + + <listitem> + <para>Nate Williams <email>nate@bsd.coe.montana.edu</email></para> + </listitem> + + <listitem> + <para>Nick Handel <email>nhandel@NeoSoft.com</email> + <email>nick@madhouse.neosoft.com</email></para> + </listitem> + + <listitem> + <para>Pace Willisson <email>pace@blitz.com</email></para> + </listitem> + + <listitem> + <para>Paul Kranenburg <email>pk@cs.few.eur.nl</email></para> + </listitem> + + <listitem> + <para>Paul Mackerras <email>paulus@cs.anu.edu.au</email></para> + </listitem> + + <listitem> + <para>Paul Popelka <email>paulp@uts.amdahl.com</email></para> + </listitem> + + <listitem> + <para>Peter da Silva <email>peter@NeoSoft.com</email></para> + </listitem> + + <listitem> + <para>Phil Sutherland + <email>philsuth@mycroft.dialix.oz.au</email></para> + </listitem> + + <listitem> + <para>Poul-Henning Kamp<email>phk@FreeBSD.ORG</email></para> + </listitem> + + <listitem> + <para>Ralf Friedl <email>friedl@informatik.uni-kl.de</email></para> + </listitem> + + <listitem> + <para>Rick Macklem <email>root@snowhite.cis.uoguelph.ca</email></para> + </listitem> + + <listitem> + <para>Robert D. Thrush <email>rd@phoenix.aii.com</email></para> + </listitem> + + <listitem> + <para>Rodney W. Grimes <email>rgrimes@cdrom.com</email></para> + </listitem> + + <listitem> + <para>Sascha Wildner <email>swildner@channelz.GUN.de</email></para> + </listitem> + + <listitem> + <para>Scott Burris <email>scott@pita.cns.ucla.edu</email></para> + </listitem> + + <listitem> + <para>Scott Reynolds <email>scott@clmqt.marquette.mi.us</email></para> + </listitem> + + <listitem> + <para>Sean Eric Fagan <email>sef@kithrup.com</email></para> + </listitem> + + <listitem> + <para>Simon J Gerraty <email>sjg@melb.bull.oz.au</email> + <email>sjg@zen.void.oz.au</email></para> + </listitem> + + <listitem> + <para>Stephen McKay <email>syssgm@devetir.qld.gov.au</email></para> + </listitem> + + <listitem> + <para>Terry Lambert <email>terry@icarus.weber.edu</email></para> + </listitem> + + <listitem> + <para>Terry Lee <email>terry@uivlsi.csl.uiuc.edu</email></para> + </listitem> + + <listitem> + <para>Tor Egge <email>Tor.Egge@idi.ntnu.no</email></para> + </listitem> + + <listitem> + <para>Warren Toomey <email>wkt@csadfa.cs.adfa.oz.au</email></para> + </listitem> + + <listitem> + <para>Wiljo Heinen <email>wiljo@freeside.ki.open.de</email></para> + </listitem> + + <listitem> + <para>William Jolitz <email>withheld</email></para> + </listitem> + + <listitem> + <para>Wolfgang Solfrank <email>ws@tools.de</email></para> + </listitem> + + <listitem> + <para>Wolfgang Stanglmeier <email>wolf@dentaro.GUN.de</email></para> + </listitem> + + <listitem> + <para>Yuval Yarom <email>yval@cs.huji.ac.il</email></para> + </listitem> + </itemizedlist> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/cutting-edge/chapter.sgml b/ja_JP.eucJP/books/handbook/cutting-edge/chapter.sgml new file mode 100644 index 0000000000..690d88d88b --- /dev/null +++ b/ja_JP.eucJP/books/handbook/cutting-edge/chapter.sgml @@ -0,0 +1,2528 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.13 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:46:00 kuriyama Exp $ +--> + +<chapter id="cutting-edge"> + <title>開発の最前線: FreeBSD-current と FreeBSD-stable</title> + + <para>あるリリースから次のリリースまでの期間にも, FreeBSD の開発は + 休みなく続けられています. + この開発の最前線に興味を持っている人のために, + 手元のシステムを最新の開発ツリーに同期させておくための, + とても使いやすい仕掛けが何種類も用意されています. 注意: + 開発の最前線は, 誰でもが扱えるという性質のものではありません! + もしもあなたが, 開発途中のシステムを追いかけようか, + それともリリース + バージョンのどれかを使い続けようかと迷っているのなら, + きっとこの章が参考になるでしょう.</para> + + <sect1 id="current"> + <title>最新のFreeBSDを追いかける</title> + + <para><emphasis>原作: &a.jkh;.</emphasis></para> + + <para><emphasis>訳: &a.hanai;<!-- <br> --> + 6 November 1996.</emphasis></para> + + <sect2> + <title>FreeBSD-current ってなに?</title> + + <para>FreeBSD-current とは,文字通りに,日々変更されている + FreeBSD のソース + のスナップショット以外の何ものでもありません. + 中には現在開発途上の ソフトウェア, 実験的な変更, + あるいは過渡的な機能などが含まれています. また, + この中に入っている機能がすべて次の公式リリースに + 入るとはかぎりません. FreeBSD-current + をソースからほとんど毎日コンパイルしている人はたくさん + いますが, 時期によっては FreeBSD-current + はコンパイルさえできない状態に なっていることもあります. + これらの問題は一般的には可能な限り素早く解決 されますが, + FreeBSD-current のソースが不幸をもたらすか, それとも非常に + 素晴らしい機能をもたらすかというのは文字通り, + ある与えられた24時間の間 + のどの部分であなたがソースを手に入れたか, + による場合もあります.</para> + </sect2> + + <sect2> + <title>誰が FreeBSD-current を必要としてるの?</title> + + <para>FreeBSD-current は, + 主に次の三つの重要なグループを対象としています.</para> + + <orderedlist> + <listitem> + <para>ソースツリーのある部分に関して活発に作業している + FreeBSD グループのメンバー. 彼らにとっては + “最新のもの” にしておくのが + 絶対に必要なことなのです.</para> + </listitem> + + <listitem> + <para>活発にテストをする FreeBSD グループのメンバー. 彼らは, + FreeBSD-current を “健全である” + ことを出来るだけ確認するために種々の問題と戦うのに + 時間を費やすのを厭わない人々です. 彼らはまた, + 様々な変更に関する提案や FreeBSD + の大まかな方向付けを行ないたいと思っている + 人々でもあります.</para> + </listitem> + + <listitem> + <para>単に, 様々な事に目を向け, 参考のために + (例えば,動かすためではなく <emphasis>読むため + </emphasis>に) 最新のソースを使いたいと思って いる FreeBSD + (または他の) グループのまわりにいるメンバー. + これらの人々はまた, + 時々コメントやコードを寄稿してくれます.</para> + </listitem> + </orderedlist> + </sect2> + + <sect2> + <title>FreeBSD-current + に期待しては<emphasis>いけない</emphasis>ことは?</title> + + <orderedlist> + <listitem> + <para>なにか新しくカッコイイモノがあると聞き, 自分の周囲では + 一番にそれを持ちたいがためにリリース前のコードの断片を + 追いかけること.</para> + </listitem> + + <listitem> + <para>バグを修正するための素早い方法.</para> + </listitem> + + <listitem> + <para>我々によって “公式にサポートされている” + こと. 私たちは 3 つの “公式な” FreeBSD-current + のグループの一つに実際に属する + 人々を助けるのにベストを尽くしますが, + 技術的なサポートを行なうには 単に「時間が足りない」のです. + これは我々が外の人を助けるの好まない, + ケチで意地悪い人間だと いうことではなく (もしそうなら + FreeBSD なんかやっていません), 文字通り 我々は一日に 400 + ものメッセージに答え <emphasis>かつ</emphasis> FreeBSD + の作業をする ことなど出来ない! ということなのです. もし, + たくさんの質問に答えるか, それとも FreeBSD + を良くする作業を続けるかという選択が与えられた場合, + あなた方のほとんどは後者を支持する, + と私は確信しています.</para> + </listitem> + </orderedlist> + </sect2> + + <sect2> + <title>FreeBSD-current を使う</title> + + <orderedlist> + <listitem> + <para>&a.current;と&a.cvsall;に加わって下さい. + これは単に良い考えであるというだけでなく, + <emphasis>必須の</emphasis>ことなのです. もし + <emphasis>FreeBSD-current</emphasis> + メーリングリストに入っていなければ, + 様々な人がシステムの現在の状態について + 述べているコメントを決して見ることは ありませんし, + 従って他の人が既に見つけて解決している多くの問題に 戸惑っ + てあきらめてしまうでしょう. さらに言うと, + システムを正常に保つための + 重要な情報を見逃してしまう可能性もあります.</para> + + <para><email>cvs-all</email> メーリングリストでは, + それぞれの変更についての commit + ログを見ることができますし, + それに関して起こり得る副作用の情報を得ることができ, + もう一つの加わるに値するメーリングリストです.</para> + + <para>これらのメーリングリストに入るには, &a.majordomo; + へ</para> + + <programlisting> +subscribe freebsd-current +subscribe cvs-all</programlisting> + + <para>と書いたメールを送って下さい. オプションとして本文に + <literal>help</literal> と書けば, Majordomo + はあなたへ我々がサポ ートする様々なメーリングリストに参加 + / 脱退する方法に関する詳しい ヘルプを送ります.</para> + </listitem> + + <listitem> + <para><hostid role="fqdn">ftp.FreeBSD.ORG</hostid> + からのソースの入手. 以下の3つの方法で行なうこと + が出来ます.</para> + + <orderedlist> + <listitem> + <para>下に述べられている<application><link + linkend="ctm">CTM</link></application>を用いる. + 均一なレートの, 良質の TCP/IP + 接続を持っていない人には, + これが一番いい方法でしょう.</para> + </listitem> + + <listitem> + <para><link linkend="cvsup">cvsup</link> を <ulink + URL="ftp://ftp.freebsd.org/pub/FreeBSD/FreeBSD-current/src/share/examples/cvsup/standard-supfile"> この supfile</ulink> + を用いて使用する. これは 2 番目に推薦される方法です. + なぜなら, cvsup によって一度全体 を入手し, + 後は変更されたところだけを入手することが + 出来るからです. + たくさんの人が自動的にソースを最新のもに保つために + cvsup を cron から起動しています. + これを行なうための非常に簡単な 方法は, 単に</para> + + <screen>&prompt.root; <userinput>pkg_add -f ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></screen> + + <para>とタイプすることです.</para> + </listitem> + + <listitem> + <para><command>ftp</command> を使う. FreeBSD-current + のソースツリーは常に <ulink + URL="ftp://ftp.FreeBSD.ORG/pub/FreeBSD/FreeBSD-current"> + ftp://ftp.FreeBSD.ORG/pub/FreeBSD/FreeBSD-current</ulink> + に “公開” されています. + 我々はまた全体を compress/tar して入手できる + <command>wu-ftpd</command> を使ってい ます. 例えば,</para> + + <screen>usr.bin/lex</screen> + + <para>があったとすると,</para> + + <screen><prompt>ftp></prompt> <userinput>cd usr.bin</userinput> + <prompt>ftp></prompt> <userinput>get lex.tar.Z</userinput></screen> + + <para>とすることにより, ディレクトリ全体(この場合, + usr.bin/lex以下全体) を compress された tar + ファイルとして入手することができます.</para> + </listitem> + </orderedlist> + </listitem> + + <listitem> + <para>以上のことをまとめると, + 必要に応じて迅速なアクセスをする必要があり, + 接続のバンド幅が問題ではなければ <command>cvsup</command> + か <command>ftp</command> を使いましょう. そうではなければ + <application>CTM</application> を使いましょう.</para> + </listitem> + + <listitem> + <para>もしソースを, + 眺めるだけでなく走らせるために入手しているので あれば, + 一部だけ選ぶのではなく, current + の<emphasis>全体</emphasis>を手に入れてください. なぜなら, + ソースの様々な部分が他の部分の更新に依存しており, + 一部のみを コンパイルしようとすると, + ほぼ間違いなくトラブルを起こすからです.</para> + </listitem> + + <listitem> + <para>current をコンパイルする前に + <filename>/usr/src</filename> にある Makefile + をよく読んでください. アップグレードの処理の一部として, + 少なくとも一回は最初に <link linkend="makeworld">make + world</link> を行なうべきでしょう. &a.current; を読めば, + 次のリリースへ向けて, 時々必要になる + 他のブートストラップの方法に関して + 常に最新情報を得ることが出来ます.</para> + </listitem> + + <listitem> + <para>アクティブになって下さい! もし FreeBSD-current + を走らせているなら 我々はそれに関するコメント, + 特に拡張やバグ潰しに関する提案, を欲して います. + コードを伴う提案はもっとも歓迎されるものです!</para> + </listitem> + </orderedlist> + </sect2> + </sect1> + + <sect1 id="stable"> + <title>FreeBSD の安定状態の持続</title> + + <para><emphasis>原作: &a.jkh;.</emphasis></para> + + <para><emphasis>訳: &a.jp.iwasaki;.</emphasis></para> + + <sect2> + <title>FreeBSD-stable ってなに?</title> + + <para>FreeBSD-stable は, + 次の本流のリリースを目指した新機能をあまり採り入 + れない保守的な変更のための開発の支流です. + 実験的またはテスト未完の変更 はこの支流には取り入れられません + (<link linkend="current">最新の FreeBSD を追いかける</link> + 参照).</para> + </sect2> + + <sect2> + <title>誰が FreeBSD-stable を必要としているの?</title> + + <para>もしあなたが仕事で使用しているとか, なによりも FreeBSD + システムの安 定性を最重要視するなら, + <emphasis>stable</emphasis> を追いかけることを考えるべきで + しょう. <emphasis>stable</emphasis> + の支流は前のリリースに関して効果的にバグフィッ + クスされた流れであるため, 最新のリリース (<ulink + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/&rel.current;-RELEASE"> + &rel.current;-RELEASE</ulink> 執筆時点) + をインストールしているのであれば, 特に そうです.</para> + + <warning> + <para><emphasis>stable</emphasis> + ツリーが常に完全に互換性があり安定するように努力し + ていますが, たまに間違いがあることに注意してください (結局, + 内容が吟味 + されずに素早く送られた変更を含むソースがまだあるのです). + また, <emphasis>current</emphasis> を + <emphasis>stable</emphasis> + へ移行する前に完璧なテストフィック スに最善を尽くしますが, + 私たちのテストはすべてのケースを十分に網羅して + いるとは限りません. もし何か <emphasis>stable</emphasis> + で不具合があるようでした ら, + 私たちに<emphasis>すぐに</emphasis>教えてください + (次の節参照).</para> + </warning> + </sect2> + + <sect2> + <title>FreeBSD-stable を使う</title> + + <orderedlist> + <listitem> + <para>&a.stable; へ加わってください. このメーリングリスト + では, <emphasis>stable</emphasis> の構築に関連する事柄や, + その他の注意すべき点 に関する情報が流れています. + また開発者は議論の余地がある修正や変更 を考えている場合に, + このメーリングリストで公表し, 提案された変更に + 関して問題が生じるかどうかを返答する機会を + ユーザに与えます. </para> + + <para>また, <email>cvs-all</email> メーリングリストでは, + それぞれの変更がなされると + 起こりうる副作用に関するすべての適切な情報と一緒に commit + log を 読むことができます. subscribe + しておきたいもう一つのメーリングリストです. </para> + + <para>メーリングリストに参加するには, &a.majordomo + へメッセージの本文に + 次のように書いたメールを送ってください:</para> + + <programlisting> +subscribe freebsd-stable +subscribe cvs-all</programlisting> + + <para>オプションとして本文に `help' と書けば, Majordomo + は私たちがサポー トする様々なメーリングリストに参加 / + 脱退する方法に関する詳しいヘ ルプを送付します.</para> + </listitem> + + <listitem> + <para>もし, あなたが新しいシステムを可能な限り -stable + に近いものにインストールしようとする場合には, + 最新のブランチの snapshot を <ulink + url="ftp://releng3.freebsd.org/pub/FreeBSD"> + ftp://releng3.freebsd.org/pub/FreeBSD</ulink> + から取得し, これを一般のリリースのものと同様に + インストールしてください.</para> + + <para>もし, 既に 2.2 系列の前のリリースが動いている場合で, + これをソースからアップグレードしようとするならば, <hostid + role="fqdn">ftp.FreeBSD.ORG</hostid> より簡単に + これを行う事が出来ます. これには次の 3つの方法があります. + </para> + + <orderedlist> + <listitem> + <para><application><link + linkend="ctm">CTM</link></application> + 機能を使用する. 転送レートが 安定している TCP/IP + 接続でない場合は, この方法が適して います.</para> + </listitem> + + <listitem> + <para><link linkend="cvsup">cvsup</link> を <ulink + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/src/share/examples/cvsup/stable-supfile"> + この supfile</ulink> を用いて使用する. + 一度コレクション全体を入手してしまえば, + 前回からの変更部分だけですむので, 2 + 番目に推奨される方法です. + 多くの人が cron から cvsup を実行し, + 自動的にソースコー ドを最新の状態に保っています. + これを簡単に扱うには次のようにタイプしてください.</para> + + <screen>&prompt.root; <userinput>pkg_add -f ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></screen> + </listitem> + + <listitem> + <para><command>ftp</command> を使用する. FreeBSD-stable + 用のソースツリーは + 常に次のところで“公開”されています : + <ulink + URL="ftp://ftp.FreeBSD.ORG/pub/FreeBSD/FreeBSD-stable">ftp://ftp.FreeBSD.ORG/pub/FreeBSD/FreeBSD-stable</ulink></para> + + <para>私たちはまた, tar/compress + でツリー全体を入手できる <command>wu-ftpd</command> + を使用しています. 例えば :</para> + + <screen>usr.bin/lex</screen> + + <para>に対して:</para> + + <screen><prompt>ftp></prompt> <userinput>cd usr.bin</userinput> + <prompt>ftp></prompt> <userinput>get lex.tar.Z</userinput></screen> + + <para>とすることにより, ディレクトリ全体を compress + された tar + ファイルとして入手することができます.</para> + </listitem> + <!-- kuriyama - duplicated above? --> + </orderedlist> + </listitem> + + <listitem> + <para>基本的には, + ソースに迅速でオンデマンドなアクセスが必要で, + 接続のバンド幅が問題でなければ, <command>cvsup</command> + か <command>ftp</command> を使いましょう. そうで + ない場合は <application>CTM</application> + を使いましょう.</para> + </listitem> + + <listitem> + <para>stable をコンパイルする前に, + <filename>/usr/src</filename> にある Makefile をよ + く読んでください. + 少なくとも一回はアップグレードの処理の一部として 最初に + <link linkend="makeworld">make world</link> + を実行するべきでしょう. &a.stable; を読めば, + 次のリリースに移行する + に当たって時々必要となる既存システムからの + 新システムの構築手順に + ついての最新情報が得られるでしょう.</para> + </listitem> + </orderedlist> + </sect2> + </sect1> + + <sect1 id="synching"> + <title>インターネットを通じたソースツリーの同期</title> + + <para><emphasis>原作: &a.jkh;.</emphasis></para> + + <para><emphasis>訳: &a.jp.iwasaki;.<!-- <br> --> + 13 September 1997.</emphasis></para> + + <para>インターネット接続 (または電子メール) を使用して, + あなたの興味の対 象によって FreeBSD + プロジェクトのソースのある一部分または全体の最新を + 追いかける方法は色々あります. + 私たちが提供している基本的なサービスは <link + linkend="anoncvs">Anonymous CVS</link>, <link + linkend="cvsup">CVSup</link> と <link linkend="ctm">CTM</link> + です:</para> + + <para><application>Anonymous CVS</application> と + <application>CVSup</application> は <emphasis>pull</emphasis> + 同期モデルを採用しています. + <application>CVSup</application> の場合, ユーザ + (または cron スクリプト) が <command>cvsup</command> + 起動し, どこかにある <command>cvsupd</command> + サーバとやりとりしてファイルを + 最新状態にします. + 届けられる更新情報はその時点の最新のものであり, + また必要な時にだけ取り寄せられます. + 興味のある特定のファイルやディレクトリに + 限定して更新することも簡単にできます. + クライアント側のソースツリーの状態・ + 設定ファイルの指定に従い, サーバによって更新情報が + 素早く生成されます. + <application>Anonymous CVS</application> は, + このプログラムがリモートの CVS リポジトリから直接変更点を + pull できるようにした &man.cvs.1; への拡張であるという点で, + <application>CVSup</application> よりもずっと単純です. + <application>CVSup</application> + は効率の点ではるかにまさっていますが, + <application>Anonymous CVS</application> の方が簡単に利用できます. + </para> + + <para>一方, <application>CTM</application> + はあなたが持っているソースとマスタアーカイブ上に + あるそれとの対話的な比較をおこないませんし, + あるいは向こう側から変更点を pull したりもしません. + そのかわりに, 前回の実行時からの変更を認識するスクリプトが + マスタ CTM マシン上で一日に数回実行され, + すべての変更を compress して通し番号を振り, + さらに電子メールで転送できるようにエンコードします + (印字可能な ASCII + キャラクタのみです). 受信した後は, + これらの “CTM のデルタ” は自動 + 的にデコード, 検査してユーザのソースのコピーに変更を適用する + &man.ctm.rmail.1; によって処理可能となります. + この処理は <application>CVSup</application> や + <application>Anonymous CVS</application> よりずっと効率 + 的であり, <emphasis>pull</emphasis> モデルというよりむしろ + <emphasis>push</emphasis> モデルで + あるため, 私たちのサーバ資源の負荷は軽くなります.</para> + + <para>もちろん他のトレードオフもあります. うっかりアーカイブ + の一部を消してしまっても, <application>CVSup</application> + は壊れた部分を検出して再構築してくれます. + <application>CTM</application> はこれをやってくれませんし, + <application>Anonymous CVS</application> + はおそらく他の何よりも深く混乱してしまうことが多いでしょう. + もしソースツリーの一部を消してしまったら, (最新の CVS + “ベースデルタ”から) 一からやり直し, CTM か anoncvs + を使って悪い部分を消去し, 再同期させることによって + すべてを再構築しなければなりません.</para> + + <para><application>Anonymous CVS</application>, + <application>CTM</application>, <application>CVSup</application> + についての 詳しい情報については, + 以下の節を参照してください:</para> + + <sect2 id="anoncvs"> + <title>Anonymous CVS</title> + + <para><emphasis>原作: &a.jkh;</emphasis></para> + <para><emphasis>訳: &a.jp.sugimura;</emphasis>.<!-- <br> --> + 19 July 1998.</para> + + <sect3> + <title><anchor id="anoncvs-intro">導入</title> + + <para>Anonymous CVS (もしくは, <emphasis>anoncvs</emphasis> + として知られています) は離れたところにある CVS + リポジトリと同期を取るために FreeBSD に付属している CVS + ユーティリティに含まれている機能です. 他にもありますが, + それは FreeBSD のユーザが, 特別な権限なしに FreeBSD + プロジェクトの公式な anoncvs サーバに読み取り専用で CVS + の操作をすることができるようにするためのものです. + それを使うには, 単に <envar>CVSROOT</envar> + 環境変数を設定して適切な anoncvs サーバを指定し, そして + &man.cvs.1; + コマンドを使って手元にある + リポジトリのようにアクセスするだけです.</para> + + <para><link linkend="cvsup">CVSup</link> と + <emphasis>anoncvs</emphasis> + のサービスは本質的に同じ機能ではないか + ということも言われていますが, + ユーザが同期を取る方法を選ぶときに影響を与えるような + さまざまなトレードオフが存在します. 要約して言えば, + <application>CVSup</application> + はネットワーク資源の使い方においては非常に効率がよく, + またはるかに技術的に洗練されたものですが, + 相当な手間がかかります. <application>CVSup</application> + を使うには, + 特別なクライアントをまずインストールして設定しなくては 1bit + も取ってくることができず, またそのとき + <application>CVSup</application> では + <emphasis>collections</emphasis> + と呼んでいるかなり大きなかたまりだけからしか + 取ってこれません.</para> + + <para>それに対して <application>anoncvs</application> では, + CVS モジュールの名前を指定することで特定のプログラムの + (<command>ls</command> や <command>grep</command> のような) + 個々のファイルから調べることができます. もちろん, + <application>anoncvs</application> は CVS + リポジトリの読み取り専用の操作に対してのみ適しているので, + もしあなたが FreeBSD プロジェクトのものと共有されたなにか + ローカルなリポジトリを作ってそこでの開発を + 行おうというときには, <application>CVSup</application> + だけが唯一の手段となってしまいます.</para> + </sect3> + + <sect3> + <title><anchor id="anoncvs-usage">Anonymous CVS を使う</title> + + <para>&man.cvs.1; を設定して Anonymous CVS + リポジトリを使うには単に <envar>CVSROOT</envar> + 環境変数を設定して FreeBSD プロジェクトの + <emphasis>anoncvs</emphasis> サーバを指定するだけのことです. + この文書を書いているときには, + 次のサーバが利用できるようになっています.</para> + + <itemizedlist> + <listitem> + <para><emphasis>USA</emphasis>: + anoncvs@anoncvs.freebsd.org:/cvs</para> + </listitem> + </itemizedlist> + + <para>CVS はかつて存在した (もしくは, + 時にはこれから存在するものも <!-- smiley -->:) + ほとんどどんなバージョンの FreeBSD のソースを “check + out” することができますが, あなたは &man.cvs.1; の + リビジョン (<option>-r</option>) のオプションや FreeBSD + プロジェクトのリポジトリの中で + それをどのように指定したらいいものかということを + よく知っておく必要があります.</para> + + <para>タグには 2 種類あって, + リビジョンタグとブランチタグがあります. + リビジョンタグは特定の改訂版を指しており, + それはいつも同じものを意味しています. 一方ブランチタグは, + 指定されたときの指定された開発の流れにおける + 最も新しい改訂版を示しています. + ブランチタグは特定の改訂版を指していないために, + その意味はきょうと明日では違うものになっているでしょう. + </para> + + <para>ユーザが興味を持つであろうブランチタグの一覧です.</para> + + <variablelist> + <varlistentry> + <term>HEAD</term> + <listitem> + <para>主要部をなす流れ, すなわち FreeBSD-current + のための名前です. また, + どのリビジョンも + 指定されなかったときにはこれになります.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>RELENG_3</term> + <listitem> + <para>FreeBSD-3.x の開発のための流れです. + FreeBSD-stable としても知られています. ports + コレクションには無効です.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>RELENG_2_2</term> + <listitem> + <para>FreeBSD-2.2.x の開発のための流れです. 2.2-stable + としても知られています. ports + コレクションにはふさわしくありません.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>RELENG_2_1_0</term> + <listitem> + <para>FreeBSD-2.1.x の開発のための流れです - + このブランチは大部分がすたれています. ports + コレクションにはふさわしくありません.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>ユーザが興味を持つであろうリビジョンタグの一覧です.</para> + + <variablelist> + <varlistentry> + <term>RELENG_2_2_6_RELEASE</term> + <listitem> + <para>FreeBSD-2.2.6. ports + コレクションにはふさわしくありません.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>RELENG_2_2_5_RELEASE</term> + <listitem> + <para>FreeBSD-2.2.5. ports + コレクションにはふさわしくありません.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>RELENG_2_2_2_RELEASE</term> + <listitem> + <para>FreeBSD-2.2.2. ports + コレクションにはふさわしくありません.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>RELENG_2_2_1_RELEASE</term> + <listitem> + <para>FreeBSD-2.2.1. ports + コレクションにはふさわしくありません.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>RELENG_2_2_0_RELEASE</term> + <listitem> + <para>FreeBSD-2.2.0. ports + コレクションにはふさわしくありません.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>RELENG_2_1_7_RELEASE</term> + <listitem> + <para>FreeBSD-2.1.7. ports + コレクションにはふさわしくありません.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>RELENG_2_1_6_1_RELEASE</term> + <listitem> + <para>FreeBSD-2.1.6.1. ports + コレクションにはふさわしくありません.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>RELENG_2_1_6_RELEASE</term> + <listitem> + <para>FreeBSD-2.1.6. ports + コレクションにはふさわしくありません.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>RELENG_2_1_5_RELEASE</term> + <listitem> + <para>FreeBSD-2.1.5. ports + コレクションにはふさわしくありません.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>RELENG_2_1_0_RELEASE</term> + <listitem> + <para>FreeBSD-2.1.0. ports + コレクションにはふさわしくありません.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>ブランチタグを指定したときには, + 普通はその開発の流れにおける + 最も新しいバージョンのファイルを受け取ることができます. + もし以前のバージョンのものが欲しいときには, 日付を + <option>-D date</option> + オプションを使って指定すればよいです.<!-- kuriyama - ? + cvs(1) --></para> + </sect3> + + <sect3> + <title>例</title> + + <para>本当はなにかする前には &man.cvs.1; + のマニュアルページの全体を + ちゃんと読んでからのほうがいいのですが, Anonymous CVS + の使い方の本質的なところを簡単に例を挙げて説明します.</para> + + <example> + <title>-current (ls(1)) + をちょっと確認してから消してみます.</title> + + <screen> + &prompt.user; <userinput>setenv CVSROOT + anoncvs@anoncvs.freebsd.org:/cvs</userinput> + &prompt.user; <userinput>cvs co ls</userinput> + &prompt.user; <userinput>cvs release -d + ls</userinput></screen> + </example> + + <example> + <title>ls(1) のバージョンを 2.2-stable + ブランチから調べてみます.</title> + <!-- kuriyama - ls should man.ls.1 --> + + <screen> + &prompt.user; <userinput>setenv CVSROOT + anoncvs@anoncvs.freebsd.org:/cvs</userinput> + &prompt.user; <userinput>cvs co -rRELENG_2_2 + ls</userinput> &prompt.user; <userinput>cvs release -d + ls</userinput></screen> + </example> + + <example> + <title>FreeBSD 2.2.2 と FreeBSD 2.2.6 とで ls(1) + の変更点のリストを (unidiff で) 作ってみます.</title> + + <screen> + &prompt.user; <userinput>setenv CVSROOT + anoncvs@anoncvs.freebsd.org:/cvs</userinput> + &prompt.user; <userinput>cvs rdiff -u + -rRELENG_2_2_2_RELEASE -rRELENG_2_2_6_RELEASE + ls</userinput></screen> + </example> + + <example> + <title>他のどんなモジュールの名前が + 使われているか検索してみます.</title> + + <screen> + &prompt.user; <userinput>setenv CVSROOT + anoncvs@anoncvs.freebsd.org:/cvs</userinput> + &prompt.user; <userinput>cvs co modules</userinput> + &prompt.user; <userinput>more + modules/modules</userinput> &prompt.user; <userinput>cvs + release -d modules</userinput></screen> + </example> + </sect3> + + <sect3> + <title>他の資料</title> + + <para>次の資料は CVS を学ぶのに役に立つでしょう.</para> + + <itemizedlist> + <listitem> + <para><ulink + url="http://www.csc.calpoly.edu/~dbutler/tutorials/winter96/cvs/">CVS チュートリアル</ulink>. Cal Poly によります.</para> + </listitem> + + <listitem> + <para><ulink url="http://www.cyclic.com">Cyclic + Software</ulink>, 商用として CVS を維持しています.</para> + </listitem> + + <listitem> + <para><ulink + url="http://www.freebsd.org/cgi/cvsweb.cgi">CVSWeb</ulink> + は FreeBSD Project の CVS のための web + インターフェースです.</para> + </listitem> + </itemizedlist> + </sect3> + </sect2> + + <sect2 id="ctm"> + <title><application>CTM</application></title> + + <para><emphasis>原作: &a.phk;. 更新: 19-October-1997.</emphasis></para> + + <para><emphasis>訳: &a.hanai;<!-- <br> --> + 13 September 1997.</emphasis></para> + + <para><application>CTM</application> + はリモートのディレクトリツリーを中央のツリーに同期させるための + 手段です. + これはFreeBSDのソースツリーの配布を行なうために開発されまし + たが, 時が経つにつれて別の目的にも有用であることがわかるかも + しれません. + デルタを作り出す処理に関するドキュメントは現在ほとんど + ありません. 従って, もしあなたが<application>CTM</application> + を他のことに使いたいなら + &a.phk;にさらなる情報を問い合わせてください.</para> + + <sect3> + <title>なぜ<application>CTM</application>を使うの?</title> + + <para><application>CTM</application> を使うことにより FreeBSD + ソースツリーのローカルコピー を手にいれることができます. + ソースツリーが使えることの魅力は数多くあります. 完全な cvs + ツリーを追いかけるにしても, ひとつのブランチを追いかける + にしても <application>CTM</application> + は必要な情報を与えてくれます. + もしあなたがFreeBSDのアクティブな開発者であるにもかかわらず + お粗末なTCP/IP接続しか持っていなかったり, またはTCP/IP接続が + 行なえないとしたら, あるいは単に変更が自動的に送られてきて + ほしいというのであれば <application>CTM</application> + はそんなあなたのために 作られたのです. + アクティブなブランチでは 1 + 日に最大三つまでのデルタを受け取る必 要があります. + これが自動的に e-mail で送られてくるという方法を + ぜひ検討してみてください. + デルタのサイズは常にできるだけ小さく保たれています. + 大抵の場合5KBよりも小さく, + たまに(10回に1回程度)10-50KBになり, + ときおり100KBかもっと大きくなる でしょう.</para> + + <para>開発ソースから直接に得られたものを使うことについては, + あらかじめ パッケージにされたリリースとは違い, + いろいろと注意することが あります. これは特に + “current” のソースを選んでいるときは 重要です. + <link linkend="current">最新の FreeBSD + を追いかける</link>を読むことを お勧めします.</para> + </sect3> + + <sect3> + <title><application>CTM</application>を使うには何が必要?</title> + + <para>二つのものが必要でしょう: <application>CTM</application> + プログラムとそれに与える (“current” + レベルを得るための)最初のデルタです.</para> + + <para><application>CTM</application> + プログラムはバージョン2.0のリリース以来FreeBSDの一部にな + りました. もしソースのコピーを持っているなら + <filename>/usr/src/usr.sbin/CTM</filename>にあります.</para> + + <para>もしFreeBSDの2.0以前のバージョンなら, + 最新の<application>CTM</application>のソースを直接</para> + + <para><ulink URL="ftp://ftp.FreeBSD.ORG/pub/FreeBSD/FreeBSD-current/src/usr.sbin/ctm">ftp://ftp.FreeBSD.ORG/pub/FreeBSD/FreeBSD-current/src/usr.sbin/ctm</ulink></para> + + <para>から入手できます. <application>CTM</application> + に与える “デルタ” は二つの方法, FTPまたはe-mail, + で得ること ができます. + もしインターネットにFTPアクセスできるなら, + 次のFTPサイト:</para> + + <para><ulink URL="ftp://ftp.FreeBSD.ORG/pub/FreeBSD/CTM">ftp://ftp.FreeBSD.ORG/pub/FreeBSD/CTM</ulink></para> + + <para>または, その <link + linkend="mirrors-ctm">ミラーサイト</link> が + <application>CTM</application> へのアクセスをサポートします. + 適切なディレクトリに FTP して <filename>README</filename> + ファイルを入手し, そこから スタートしてください.</para> + + <para>e-mail によってデルタを得たいという場合は:</para> + + <para><application>CTM</application> + 配布メーリングリストのいずれかに参加するために &a.majordomo; + へ subscribe のメールを送ってください. + “ctm-cvs-cur” は完全な cvs ツリー + をサポートします. “ctm-src-cur” + は開発先端ブランチをサポートします “ctm-src-2_2” + は 2.2 リリースのブランチのサポートです. + (もしmajordomoを使って参加する方法を知らない のであれば, + 最初に<literal>help</literal> + という語を含むメッセージを送ってください. — + 使い方の説明が送られてくるでしょう.)</para> + + <para>メールで <application>CTM</application> + による更新ファイルを受け取り始めると, 中身を取り出して使用 + するために <command>ctm_rmail</command> + プログラムを使うかもしれません. それを完全 + に自動で行ないたいなら, <filename>/etc/aliases</filename> + から <command>ctm_rmail</command>プロ + グラムを直接使うこともできます. + さらに詳しいことは<command>ctm_rmail</command> + manページを御覧ください.</para> + + <note> + <para><application>CTM</application> + デルタを得るためにどの方法を使うのであっても, + <email>ctm-announce@FreeBSD.ORG</email> + メーリングリストに参加するべきです. + このメーリングリストは将来的には + <application>CTM</application>システムの操作に関する + アナウンスがポストされる唯一の場になるでしょう. + メーリングリストに加わるためには<literal>subscribe + ctm-announce</literal> と書いた一行だけのメールを + &a.majordomo; へ送ってください.</para> + </note> + </sect3> + + <sect3> + <title>はじめて<application>CTM</application>を使い始める</title> + + <para><application>CTM</application> + デルタを使い始めるためには, これは以降作られる全ての + デルタの出発点を手にいれる必要があります. + 最初にあなたが何をすでに持っているかをはっきりさせましょう. + すべての人は + “空”のディレクトリから始めなければなりません. + ツリーをサポートしてるあなたの + <application>CTM</application> を稼働するためには + 指定した“空” + のデルタを使う必要があります. いくつかの分岐点 + では, あなたの都合により CD + 内に分配されている“スタータ” + デルタを使用できるようになっています. しかしながら, これは + 頻繁に行われることではありません. + </para> + + <para>適切な出発点が決まれば, その出発点を + <application>CTM</application> が + 維持するツリーへ変換するための “スタータ” + 初期デルタを使う必要が あります.</para> + + <para>移行デルタは番号の後ろに <literal>X</literal> + をつけたものがそうです + (たとえば<filename>src-cur.3210XEmpty.gz</filename>). + <filename>X</filename> + の後ろは最初の開始ポイントに対応します. + <filename>Empty</filename> は 空のディレクトリです. + ルールとして <filename>Empty</filename> からの移行デルタは + 100 デルタごとに 作られます. ところで, + これらは非常に大きいです! + <filename>XEmpty</filename>のデルタは 数十MBの + <command>gzip</command> + で圧縮されたデータというのが普通です.</para> + + <para>一度スタートするためのベースデルタを得ると, + それに続く多数の 全てのデルタも必要になるでしょう.</para> + </sect3> + + <sect3> + <title><application>CTM</application>を日常で使う</title> + + <para>デルタを適用するためには, 単に</para> + + <screen>&prompt.root; <userinput>cd /where/ever/you/want/the/stuff</userinput> +&prompt.root; <userinput>ctm -v -v /where/you/store/your/deltas/src-xxx.*</userinput></screen> + + <para>とします.</para> + + <para><application>CTM</application> + はどれが<command>gzip</command>されているか理解します. + 従って最初に gunzipしておく必要はありません. + ディスクの節約にもなります.</para> + + <para>全体の処理に関して確信するまでは + <application>CTM</application> は(ソース)ツリーに対して + 何もしません. また, デルタを確かめるためには + <option>-c</option> フラグを使うことができます. + このフラグがあると <application>CTM</application> + はツリーに対して実際には何も行ないません. + 単にデルタの完全性を確認し, + 現在のツリーに問題なく使用できるかを確認 + するだけです.</para> + + <para><application>CTM</application> + には他にもオプションがあります. 詳細に関しては + マニュアルページを参照するかソースを見てください.</para> + + <para>もし誰かが “ユーザ インターフェース” + の部分に関して助けてくれるなら 私はとても嬉しいです. + なぜならどういうオプションが何を, どのよう に, + いつ行なうようにするべきか決めかねているからです.</para> + + <para>以上でやることは本当に全部です. + 新しいデルタを入手した時には, + ソースを最新のものにするためにそれを + <application>CTM</application>に通すだけです.</para> + + <para>もしデルタを再ダウンロードするのが + 骨の折れる作業であれば, デルタを 消さないでおいてください. + なにかおかしなことが起こった場合には置いておけば良かった + と思うかもしれません. + もしフロッピーディスクしか持っていない状況 + であってもコピーを取るのに + <command>fdwrite</command>を使うことを考えてください.</para> + </sect3> + + <sect3> + <title>ローカルの変更を保存する</title> + + <para>開発者としてはソースツリー中のファイルを + 使って実験したり変更したく なるものです. + <application>CTM</application> + はローカルの変更を制限つきでサポートします: ファイル + <filename>foo</filename> の存在をチェックする前に, + <filename>foo.ctm</filename> を参照しにいきます. + このファイルが存在する場合, CTM は <filename>foo</filename> + の代りにこれを処理します.</para> + + <para>この動作はローカルの変更を保持する簡単な手段を + 提供します: 単に変更したいファイルを拡張子 + <filename>.ctm</filename> 付きのファイル名で + コピーするだけです. あとは自由にコードをハックでき, + <filename>.ctm</filename> ファイルの方は CTM + が最新状態に保ってくれます.</para> + </sect3> + + <sect3> + <title><application>CTM</application> + のその他の面白いオプション</title> + + <sect4> + <title>更新で変更されるファイルを正確に知る</title> + + <para><application>CTM</application> + のソースリポジトリに対する変更のリストを + <option>-l</option> + オプションを使って決定することができます.</para> + + <para>これは, 変更のログを保存したい, + 変更されたファイルをなんらかの方法で 前・後処理したい, + または単にこだわりたい<!-- smiley --> :-) 場合には, + 役に立つでしょう.</para> + </sect4> + + <sect4> + <title>更新前にバックアップを取る</title> + + <para><application>CTM</application> + の更新によって変更されるファイルすべてのバックアップを + 取りたくなることがあります.</para> + + <para><option>-B backup-file</option> オプションを指定すると + <application>CTM</application> は + デルタで変更されるファイルすべてを + <filename>backup-file</filename> + としてバックアップするようになります.</para> + </sect4> + + <sect4> + <title>更新で変更されるファイルを制限する</title> + + <para><application>CTM</application> + の更新の範囲を制限したり一連のデルタのから + ほんの数ファイルを 抽出したくなることがあります.</para> + + <para><option>-e</option> と <option>-x</option> + オプションを用い正規表現を 指定することで, + <application>CTM</application> + が処理するファイルのリストを制御することが + できます.</para> + + <para>例えば, <filename>lib/libc/Makefile</filename> + の最新のコピーを保存してある CTM + デルタのコレクションから抽出するには, + 以下のコマンドを実行します. </para> + + <screen>&prompt.root; <userinput>cd /where/ever/you/want/to/extract/it/</userinput> +&prompt.root; <userinput>ctm -e '^lib/libc/Makefile' ~ctm/src-xxx.*</userinput></screen> + + <para><application>CTM</application> + デルタで指定されたファイルごとに, <option>-e</option> + そして <option>-x</option> + オプションがコマンドラインで指定された順序で 適用されます. + すべての<option>-e</option> そして <option>-x</option> + オプションが適用された後に更新対象と選択された場合に限り, + <application>CTM</application> + はそのファイルを処理します.</para> + </sect4> + </sect3> + + <sect3> + <title><application>CTM</application>の将来計画</title> + + <para>重要なもの</para> + + <itemizedlist> + <listitem> + <para>なんらかの CTM システムへの認証機構を用い, 不正な + CTM の更新の 検出を可能とする.</para> + </listitem> + + <listitem> + <para><application>CTM</application> + へのオプションを整理する. さもないと混乱し, + 直観に反したもの になります.</para> + </listitem> + </itemizedlist> + + <para>残念なことに私は非常に忙しいです. + 従ってこれを行なうどんな手助け でも歓迎します. その際, + 自分が何をやりたいかを私に 言うのを忘れずに.</para> + </sect3> + + <sect3> + <title>その他</title> + + <para>“DESに染まった” (例えば, + 国外への持ち出しが規制された)ソースは まったく含まれません. + 手に入るのは“国際”バージョンだけです. + もし興味のある人が多いようであれば, + 我々は<literal>sec-cur</literal>シーケンスも + セットアップするつもりです. <literal>ports</literal> + コレクションに対するデルタのシーケンスもあります. しかし, + まだあまり興味は持たれていないようです. + もしこれに対するメーリング + リストが欲しい時も私に言ってください. + 我々はセットアップすることを 考えます.</para> + </sect3> + + <sect3> + <title>ありがとう!</title> + + <variablelist> + <varlistentry><term>&a.bde;</term> + <listitem> + <para>辛辣なペンと価値のないコメントに対して.</para> + </listitem> + </varlistentry> + + <varlistentry><term>&a.sos;</term> + <listitem> + <para>よく辛抱してくれました.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Stephen McKay</term> + <listitem> + <para><command>ctm_[rs]mail</command>を書いてくれました. + とても感謝して います.</para> + </listitem> + </varlistentry> + + <varlistentry><term>&a.jkh;</term> + <listitem> + <para>彼が頑固として譲らなかったため, 私もこの + <acronym>CTM</acronym> をもっと良いものに + しないわけにはいきませんでした. + 彼の頑固さに感謝します.</para> + </listitem> + </varlistentry> + + <varlistentry><term>ユーザの人みんな</term> + <listitem> + <para>気に入ってくれることを願っています...</para> + </listitem> + </varlistentry> + </variablelist> + </sect3> + </sect2> + + <sect2 id="cvsup"> + <title><application>CVSup</application></title> + + <para><emphasis>原作: &a.jdp;</emphasis>.</para> + + <para><emphasis>訳: &a.jp.iwasaki;.<!-- <br> --> + 27 February 1997.</emphasis></para> + + <sect3 id="cvsup-intro"> + <title><application>CVSup</application> の紹介</title> + + <para><application>CVSup</application> は, + リモートのサーバホストにあるマスタ CVS リポジトリから + ソースツリーを配布し更新するための + ソフトウェアパッケージです. FreeBSD のソースは, + カリフォルニアにある中心的な開発マシンの CVS リポジトリの + 中でメンテナンスしています. <application>CVSup</application> + を使用することで, FreeBSD ユーザは + 簡単に自分のソースツリーを最新の状態に + しておくことができます.</para> + + <para><application>CVSup</application> は + <emphasis>pull</emphasis> + モデルとよばれる更新のモデルを採用しています. pull + モデルでは, + 各クライアントが更新したい場合に更新したい時点で, + サーバに更新の問い合わせをおこないます. + サーバはクライアントからの + 更新の要求を受け身の状態で待ちます. したがって, + すべての更新は クライアント主導でおこなわれます. + サーバは頼まれもしない更新情報を 送るようなことはしません. + ユーザは <application>CVSup</application> + クライアントを手動で実行して 更新をおこなうか, + <command>cron</command> + ジョブを設定して定期的に自動実行する必要があります.</para> + + <para>用語 <application>CVSup</application> + のように大文字で表記しているものは, ソフトウェアパッケージ + 全体を指します. 主な構成物は, + 各ユーザマシンで実行するクライアントである + <command>cvsup</command>, FreeBSD + の各ミラーサイトで実行するサーバ <command>cvsupd</command> + です.</para> + + <para>FreeBSD の文書やメーリングリストを読んだ際に, + <application>sup</application> についての言及を + 見かけたかもしれません. <application>sup</application> は + <application>CVSup</application> の前に存在していたもので, + 同様の 目的で使われていました. + <application>CVSup</application> は sup + と同じように使用されており, 実際, <command>sup</command> + と互換性のあるコンフィグレーションファイルを使用します. + <application>CVSup</application> + の方がより高速で柔軟性もあるので, もはや + <application>sup</application> は FreeBSD + プロジェクトでは使用されていません.</para> + </sect3> + + <sect3 id="cvsup-install"> + <title><application>CVSup</application> のインストール</title> + + <para>FreeBSD 2.2 以降を使用している場合, + <application>CVSup</application> をインストールするもっとも + 簡単な方法は, FreeBSD <link linkend="ports">ports + コレクション</link> の <ulink + URL="ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports-current/net/cvsup.tar">port</ulink> + または対応する <ulink + URL="ftp://ftp.freebsd.org/pub/FreeBSD/packages-current/net/cvsup-16.0.tgz"> + バイナリ package</ulink> を使うことです. + どちらを使うかは, + CVSupを自分で作りたいかどうかによります.</para> + + <para>FreeBSD-2.1.6 または 2.1.7 を使用している場合は, + 残念ながら FreeBSD-2.1.{6,7} には存在しないバージョンの C + ライブラリが必要となるため バイナリ package + は使用できません. しかし, <ulink + URL="ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports-current/net/cvsup.tar"> + port</ulink> は FreeBSD 2.2 とまったく同じように + 簡単に使うことができます. + 単に tar ファイルを展開し, cvsup ディレクトリへ cd して + <command>make install</command> とタイプするだけです.</para> + + <para><application>CVSup</application> は <ulink + URL="http://www.research.digital.com/SRC/modula-3/html/home.html"> + Modula-3</ulink> で書かれているため, package と port + 両方とも Modula-3 ランタイムライブラリが + インストールされていることが必要です. + これらは port の <ulink + URL="ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports-current/lang/modula-3-lib.tar"> + lang/modula-3-lib</ulink> + および package の <ulink + URL="ftp://ftp.freebsd.org/pub/FreeBSD/packages-current/lang/modula-3-lib-3.6.tgz"> + lang/modula-3-lib-3.6</ulink> にあります. + これらのライブラリの port や package に対して + <command>cvsup</command> と同じ管理方法を取っていれば, + <application>CVSup</application> の port や package + をインストールする際に, これらのライブラリも自動的に + コンパイルそして/またはインストールされます.</para> + + <para>Modula-3 ライブラリはかなり大きく, + これらの転送やコンパイルはすぐに 終わるものではありません. + この理由から, 三つめの選択肢が提供されています. + 以下のアメリカ合衆国にある配布サイトのどちらからでも, + FreeBSD 用の <emphasis>スタティックリンクされた</emphasis> + <application>CVSup</application> + 実行形式が入手可能です:</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.freebsd.org/pub/FreeBSD/development/CVSup/cvsup-bin-16.0.tar.gz">ftp://ftp.freebsd.org/pub/FreeBSD/development/CVSup/cvsup-bin-16.0.tar.gz</ulink> + (GUI 込みのクライアント).</para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp.freebsd.org/pub/FreeBSD/development/CVSup/cvsup.nogui-bin-16.0.tar.gz">ftp://ftp.freebsd.org/pub/FreeBSD/development/CVSup/cvsup.nogui-bin-16.0.tar.gz</ulink> + (GUI なしのクライアント).</para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp.freebsd.org/pub/FreeBSD/development/CVSup/cvsupd-bin-16.0.tar.gz">ftp://ftp.freebsd.org/pub/FreeBSD/development/CVSup/cvsupd-bin-16.0.tar.gz</ulink> + (サーバ).</para> + </listitem> + </itemizedlist> + + <para>また, 世界中にあるたくさんの FreeBSD <link + linkend="mirrors-ftp">FTP ミラーサイト</link> + からも入手可能です. :</para> + + <para>ほとんどのユーザはクライアントのみが必要になるでしょう. + これらの 実行形式は完全に自己完結しており, FreeBSD-2.1.0 + から FreeBSD-current までの, + どのバージョンでも動作します.</para> + + <para>まとめると, CVSup + をインストールするための選択肢は以下の通りです:</para> + + <itemizedlist> + <listitem> + <para>FreeBSD-2.2以降: スタティックバイナリ, port, package</para> + </listitem> + + <listitem> + <para>FreeBSD-2.1.6, 2.1.7: スタティックバイナリ, port</para> + </listitem> + + <listitem> + <para>FreeBSD-2.1.5 以前: スタティックバイナリ</para> + </listitem> + </itemizedlist> + </sect3> + + <sect3 id="cvsup-config"> + <title><application>CVSup</application> + のコンフィグレーション</title> + + <para>CVSup の動作は, <filename>supfile</filename> + と呼ばれるコンフィグレーションファイルで 制御します. + FreeBSD-2.2 からは, <filename>supfile</filename> + のサンプルがディレクトリ <ulink + URL="file:/usr/share/examples/cvsup">/usr/share/examples/cvsup + </ulink> の下にあります. 2.2 以前のシステムを + 使用している場合は, これらの サンプルを + <ulink + URL="ftp://ftp.freebsd.org/pub/FreeBSD/FreeBSD-current/src/share/examples/cvsup/"> + ftp://ftp.freebsd.org/pub/FreeBSD/FreeBSD-current/src/share/examples/cvsup/ + </ulink> から入手することができます.</para> + + <para><filename>supfile</filename> には以下の cvsup + に関する質問への答えを記述します:</para> + + <itemizedlist> + <listitem> + <para><link linkend="cvsup-config-files"> + どのファイルを受け取りたいのか?</link></para> + </listitem> + + <listitem> + <para><link linkend="cvsup-config-vers"> + どのバージョンのものが欲しいのか?</link></para> + </listitem> + + <listitem> + <para><link linkend="cvsup-config-where"> + どこから入手したいのか?</link></para> + </listitem> + + <listitem> + <para><link linkend="cvsup-config-dest"> + 自分のマシンのどこに置きたいのか?</link></para> + </listitem> + + <listitem> + <para><link linkend="cvsup-config-status"> + どこに status ファイルを置きたいのか?</link></para> + </listitem> + </itemizedlist> + + <para>次のセクションで, これらの質問に順番に答えながら典型的な + <filename>supfile</filename> を組み立てていきます. 最初に + <filename>supfile</filename> の全体構造を説明します.</para> + + <para><filename>supfile</filename> はテキストファイルです. + コメントは <literal>#</literal> から行末までです. + 空行とコメントだけの行は無視します.</para> + + <para>残りの各行には, + ユーザが受け取りたいファイル群について記述します. + 行の始めは, + サーバ側で定義した論理的なファイルのグループである + “コレクション”の名称です. + コレクションの名称を指定して, 欲しいファイル群を + サーバに伝えます. コレクション名の後には, + ホワイトスペースで区切られた 0個以上のフィールドが続きます. + これらのフィールドが上記の質問に対する 答えになります. + フィールドには 2種類あります: flag フィールドと value + フィールドです. flag フィールドは <literal>delete</literal> + や <literal>compress</literal> のような + 単独のキーワードから成ります. また, value + フィールドもキーワードで 始まりますが, + キーワードの後にはホワイトスペースは入らず, + <literal>=</literal> と 二つめの単語が続きます. 例えば, + <literal>release=cvs</literal> は value + フィールドです.</para> + + <para>通常, <filename>supfile</filename> + には受け取りたいコレクションを一つ以上指定します. + <filename>supfile</filename> を組み立てる一つの方法として, + コレクション毎にすべての関係の + あるフィールドを明示的に指定する方法があります. しかし, + これでは <filename>supfile</filename> + のすべてのコレクションに対して + ほとんどのフィールドが同じになるため, + 行が非常に長くなってしまい不便になります. + これらの問題を避けるため, <application>CVSup</application> + ではデフォルトを指定することのできる + メカニズムが提供されています. 特殊な擬似コレクション名 + <literal>*default</literal> で始まる行は, + <filename>supfile</filename> 中の後続の + コレクションに対して使用する flag フィールドと value + フィールドの デフォルトを設定するために利用できます. + 個々のコレクションで固有の値を 指定すると, + デフォルト値を無効にできます. また <option>*default</option> + 行を追加すると, <filename>supfile</filename> + の途中からデフォルト値の変更や追加が可能になります.</para> + + <para>これまでの予備知識を基に, <link + linkend="current">FreeBSD-current</link> + のメインのソースツリーを受け取って更新するための + <filename>supfile</filename> を 組み立ててみましょう.</para> + + <itemizedlist> + <listitem> + <para>どのファイルを受け取りたいのか?<anchor + id="cvsup-config-files"></para> + + <para><application>CVSup</application> + を通して入手できるファイルは “コレクション” + と呼ばれる名前の付けられたグループにまとめられています. + 利用可能なコレクションについては <link + linkend="cvsup-collec">ここ</link> で説明しています. + ここでは, FreeBSD システムのメインのソースツリー全体 + を受け取るための設定例を紹介します. + 輸出規制されている暗号化サポートの + コード以外のすべてを含む <literal>src-all</literal> + という 単一の大きなコレクションがあります. + この例では私たちがアメリカ合衆国か + カナダにいるものと仮定します. その場合, + <literal>cvs-crypto</literal> という一つの付化的な + コレクションで暗号化コードを入手することができます. + <filename>supfile</filename> + を組み立てる最初のステップとして, + これらのコレクションを一行に一つづつ 記述します:</para> + + <programlisting> +src-all +cvs-crypto</programlisting> + </listitem> + + <listitem> + <para>どのバージョンのものが欲しいのか?<anchor + id="cvsup-config-vers"></para> + + <para><application>CVSup</application> を使用すると, + かつて存在していたことのある, 事実上どのバージョンの + ソースでも受け取ることができます. これは cvsupd + サーバがすべてのバージョンを含む CVS + リポジトリに基づいて動作することにより, + 実現されています. <!-- kuriyama - date should be + literal --> <literal>tag=</literal> および + <option>date=</option> の value フィールドを使用して, + 欲しいバージョンの 一つを指定します.</para> + + <warning> + <para><literal>tag=</literal> + のフィールドの指定は正確に行うように十分注意 + してください. いくつかのタグは特定のコレクションに + 対してのみ有効です. + タグの綴りが違っていたり不適切なタグを指定すると, + CVSupはユーザが消し + たくないファイルまで削除してしまいます. 特に + <literal>ports-*</literal> のコレクション に対しては + <literal>tag=.</literal> <emphasis>だけ</emphasis> + を指定するようにしてください.</para> + </warning> + + <para><literal>tag=</literal> + フィールドはリポジトリ中のシンボリックタグを指定します. + tag には revision tag と branch tag の二種類があります. + revision tag は特定のリビジョンを指します. これは, + 毎日同じ状態に保つことになります. 一方 branch tag は, + ある時点での開発分流の最新のリビジョンを指します. + branch tag + は特定のリビジョンを指定している訳ではないので, + 今日と明日では + 異なるリビジョンを参照することになるかもしれません.</para> + + <para>以下はユーザが興味を持っていると思われる branch tag + です:</para> + + <variablelist> + <varlistentry><term>tag=.</term> + <listitem> + <para>メインの開発分流であり, FreeBSD-current + として知られています.</para> + <note> + <para> + 注意: <literal>.</literal> + は句読点ではありません. tag の名称です. + このタグの指定は総ての + コレクションに対して有効です.</para> + </note> + </listitem> + </varlistentry> + + <varlistentry><term>tag=RELENG_3</term> + <listitem> + <para>FreeBSD-3.x 用の開発分流であり, FreeBSD-stable + として知られています. このタグの指定は ports-* + のコレクションに対しては無効です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>tag=RELENG_2_2</term> + <listitem> + <para>FreeBSD-2.2.x 用の開発分流であり, 2.2-stable + として知られています. このタグの指定は ports-* + のコレクションに対しては無効です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>tag=RELENG_2_1_0</term> + <listitem> + <para>FreeBSD-2.1.x 用の開発分流です. + この分流はほとんど利用されていません. + このタグの指定は ports-* + のコレクションに対しては無効です.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>以下はユーザが興味を持っていると思われる revision + tag です:</para> + + <variablelist> + <varlistentry><term>tag=RELENG_3_0_0_RELEASE</term> + <listitem> + <para>FreeBSD-3.0. このタグの指定は ports-* + のコレクションに対しては無効です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>tag=RELENG_2_2_8_RELEASE</term> + <listitem> + <para>FreeBSD-2.2.8. このタグの指定は ports-* + のコレクションに対しては無効です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>tag=RELENG_2_2_7_RELEASE</term> + <listitem> + <para>FreeBSD-2.2.7. このタグの指定は ports-* + のコレクションに対しては無効です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>tag=RELENG_2_2_6_RELEASE</term> + <listitem> + <para>FreeBSD-2.2.6. このタグの指定は ports-* + のコレクションに対しては無効です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>tag=RELENG_2_2_5_RELEASE</term> + <listitem> + <para>FreeBSD-2.2.5. このタグの指定は ports-* + のコレクションに対しては無効です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>tag=RELENG_2_2_2_RELEASE</term> + <listitem> + <para>FreeBSD-2.2.2. このタグの指定は ports-* + のコレクションに対しては無効です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>tag=RELENG_2_2_1_RELEASE</term> + <listitem> + <para>FreeBSD-2.2.1. このタグの指定は ports-* + のコレクションに対しては無効です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>tag=RELENG_2_2_0_RELEASE</term> + <listitem> + <para>FreeBSD-2.2.0. このタグの指定は ports-* + のコレクションに対しては無効です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>tag=RELENG_2_1_7_RELEASE</term> + <listitem> + <para>FreeBSD-2.1.7. このタグの指定は ports-* + のコレクションに対しては無効です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>tag=RELENG_2_1_6_1_RELEASE</term> + <listitem> + <para>FreeBSD-2.1.6.1. このタグの指定は ports-* + のコレクションに対しては無効です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>tag=RELENG_2_1_6_RELEASE</term> + <listitem> + <para>FreeBSD-2.1.6. このタグの指定は ports-* + のコレクションに対しては無効です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>tag=RELENG_2_1_5_RELEASE</term> + <listitem> + <para>FreeBSD-2.1.5. このタグの指定は ports-* + のコレクションに対しては無効です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>tag=RELENG_2_1_0_RELEASE</term> + <listitem> + <para>FreeBSD-2.1.0. このタグの指定は ports-* + のコレクションに対しては無効です.</para> + </listitem> + </varlistentry> + </variablelist> + + <warning> + <para> tag + 名を示した通りにタイプされているか十分注意してく + ださい. <application>CVSup</application> は tag + 名が正しいかどうかを見分けることはできません. tag + が間違っていた場合, + たまたまファイルがまったく存在しない正しい tag が + 指定されたものとして<application>CVSup</application> + は動作します. その場合は, 現在あるソースが削 + 除されるでしょう.</para> + </warning> + + <para>branch tag を指定した際には, + 通常はその開発分流の最新バージョンの + ファイルを受け取ります. + いくらか前のバージョンを受け取りたい場合は, + <option>date=</option> の value + フィールドを使って日付を指定することで, + これを実現することが できます. &man.cvsup.1; + のマニュアルページで, + その方法を説明しています.</para> + + <para>例として, FreeBSD-current を受け取りたいとします. + 次の行を <filename>supfile</filename> + の始めに追加します:</para> + + <programlisting> +*default tag=.</programlisting> + + <para><literal>tag=</literal> フィールドも + <literal>date=</literal> + フィールドも指定しなかった場合に + 動き出す重要な特殊なケースがあります. そのケースでは, + 特定のバージョンの ファイルを受け取るのではなく, + サーバの CVS リポジトリから実際の RCS + ファイルを直接受け取ります. + 一般的に開発者はこの処理のモードが 好きなようです. + 彼らのシステム上にリポジトリそのものの + コピーを維持することで, + リビジョン履歴を閲覧し過去のバージョンの + ファイルを検査できるようになります. しかし, + これには大きなディスクスペースが必要になります.</para> + </listitem> + + <listitem> + <para>どこから入手したいのか?<anchor + id="cvsup-config-where"></para> + + <para>更新情報をどこから入手するかを + <command>cvsup</command> に伝えるために + <literal>host=</literal> フィールドを使用します.<link + linkend="mirrors-cvsup">CVSup ミラーサイト</link> + のどこからでも入手できますが, + ネット上での最寄りのサイトを選ぶべきでしょう. + この例では, 仮想上の FreeBSD 配布サイト <hostid + role="fqdn">cvsup666.FreeBSD.org</hostid> + を使用します:</para> + + <programlisting> +*default host=cvsup666.FreeBSD.org</programlisting> + + <para>CVSup を実行する前にホスト名を + 実在のものに変更する必要があります. どのように + <command>cvsup</command> を実行しても, この設定は + <option>-h <replaceable> hostname</replaceable></option> + を + 使用してコマンドラインで変更することができます.</para> + </listitem> + + <listitem> + <para>自分のマシンのどこに置きたいのか?<anchor + id="cvsup-config-dest"></para> + + <para><literal>prefix=</literal> フィールドは, + <command>cvsup</command> + に受け取ったファイルをどこに置くかを 伝えます. + この例では, ソースファイルを直接メインのソースツリー + <filename>/usr/src</filename> に置きます. + <filename>src</filename> + ディレクトリはすでにファイルを受け取るために + 選択したコレクションで暗黙に指定しているので, + これは正しい仕様となります:</para> + + <programlisting> +*default prefix=/usr</programlisting> + </listitem> + + <listitem> + <para>どこに status ファイルを置きたいのか?<anchor + id="cvsup-config-status"></para> + + <para>cvsup クライアントは “base” + ディレクトリと呼ばれる場所に, ある status + ファイルを維持しています. + すでに受け取った更新情報を追従し続け ることで, + これらのファイルは <application>CVSup</application> + がより効果的に動作することを支援し ます. 標準の base + ディレクトリ <filename>/usr/local/etc/cvsup</filename> + を使用します:</para> + + <programlisting> +*default base=/usr/local/etc/cvsup</programlisting> + + <para><filename>supfile</filename> に指定がない場合は, + この設定をデフォルトで使用しますので, + 実際には上の行は必要ありません.</para> + + <para>base + ディレクトリが存在しない場合は作成しておきましょう. base + ディレクトリが存在しない場合, <command>cvsup</command> + クライアントは実行を拒否します.</para> + </listitem> + + <listitem> + <para>その他もろもろの <filename>supfile</filename> + の設定:</para> + + <para>通常 <filename>supfile</filename> + に入れておくべき行がもう一つあります:</para> + + <programlisting> +*default release=cvs delete use-rel-suffix compress</programlisting> + + <para><literal>release=cvs</literal> は, サーバがメインの + FreeBSD CVS リポジトリから + その情報を取得するように指示します. + ほとんどの場合はこのようにしておきますが, + ここでの説明の範疇をこえるような + 状況では他の指定をすることも可能です.</para> + + <para><literal>delete</literal> は + <application>CVSup</application> + にファイルを削除することを許可します. + <application>CVSup</application> が + ソースツリーを完全に最新の状態に + 保てるようにするためには, これは常に + 指定しておくべきでしょう. + <application>CVSup</application> は, + これらの責任範囲のファイルだけを 慎重に削除します. + たまたま存在する他の余分なファイルについては, + まったく手をつけずに残しておきます.</para> + + <para><literal>use-rel-suffix</literal> は ... + 神秘的なものです. これについて本当に 知りたい人は, + &man.cvsup.1; のマニュアルページをご覧ください. + でなければ, 何も考えずに指定してみてください.</para> + + <para><literal>compress</literal> は通信チャネルで gzip + 形式の圧縮の使用を有効にします. + ご使用のネットワーク接続が T1 speed 以上である場合, + この圧縮を 使用しない方がよいかもしれません. + そうでない場合は十分に役に立ちます.</para> + </listitem> + + <listitem> + <para><filename>supfile</filename> の例のまとめ:</para> + + <para>以下は <filename>supfile</filename> の例の全体です:</para> + + <programlisting> +*default tag=. +*default host=cvsup666.FreeBSD.org +*default prefix=/usr +*default base=/usr/local/etc/cvsup +*default release=cvs delete use-rel-suffix compress + +src-all +cvs-crypto</programlisting> + </listitem> + </itemizedlist> + </sect3> + + <sect3> + <title><application>CVSup</application> の実行</title> + + <para>さて, 更新の準備ができました. + これを実行するコマンドラインは 実に簡単です:</para> + + <screen>&prompt.root; <userinput>cvsup <replaceable>supfile</replaceable></userinput></screen> + + <para>もちろん, ここでの + <filename><replaceable>supfile</replaceable></filename> + は作成したばかりの supfile のファイル名です. X11 + 環境で実行するものと仮定して, <command>cvsup</command> は + 通常の操作に必要なボタンを持つ GUI ウィンドウを表示します. + “go” ボタンを押して, + 実行を監視してください.</para> + + <para>この例では実際の <filename>/usr/src</filename> + ツリーを更新しているので, <command>cvsup </command> + にファイルを更新するのに必要なパーミッションを与えるために, + ユーザ <username>root</username> で実行する必要があります. + コンフィグレーションファイルを作ったばかりで, + しかも以前にこのプログラムを実行したことがないので, + 神経質になるのは 無理もない話だと思います. + 大切なファイルに触らずに試しに実行する簡単な 方法があります. + どこか適当な場所に空のディレクトリを作成して, + コマンドラインの引数で指定するだけです:</para> + + <screen>&prompt.root; <userinput>mkdir /var/tmp/dest</userinput> +&prompt.root; <userinput>cvsup supfile /var/tmp/dest</userinput></screen> + + <para>指定したディレクトリは, すべての更新されるファイルの + 更新先ディレクトリとして使用します. + <application>CVSup</application> は + <filename>/usr/src</filename> の下の ファイルを検査しますが, + 変更や削除はまったくおこないません. かわりに + <filename>/var/tmp/dest/usr/src</filename> + に更新されたすべてのファイルが 置かれるようになります. + この方法で実行した場合は, <application>CVSup</application> + は base ディレクトリの status + ファイルを更新せずにそのままにします. + これらのファイルの新しいバージョンは指定されたディレクトリ + に書き込まれます. <filename>/usr/src</filename> + の読み取り許可がある限り, このような 試し実行のためにユーザ + root になる必要はありません.</para> + + <para>X11 を利用していないとか単に GUI が気に入らない場合は, + cvsup 起動時にコマンドラインに + 二つほどオプションを追加する必要があります:</para> + + <screen>&prompt.root; <userinput>cvsup -g -L 2 supfile</userinput></screen> + + <para><option>-g</option> オプションは cvsup に GUI + を使用しないように伝えます. X11 + を利用していない場合には自動的に指定されますが, + そうでない場合は 明示的に指定します.</para> + + <para><option>-L 2</option> オプションは cvsup + にファイル更新中の詳細情報をプリントアウト + するように伝えます. 冗長性には <option>-L 0</option> から + <option>-L 2</option> までの三つのレベル があります. + デフォルトは 0 であり, エラーメッセージ以外はまったく出力 + しません.</para> + + <para>たくさんの他のオプション変数があります. + それらの簡単な一覧は <command>cvsup -H</command> + で表示されます. + より詳しい説明はマニュアルページをご覧ください.</para> + + <para>動作している更新の方法に満足したら, &man.cron.8; + を使って cvsup を定期的に + 実行させる準備をすることができます. cron から起動する際には, + 明示的に cvsup が GUI + を使わないようにする必要があります.</para> + </sect3> + + <sect3 id="cvsup-collec"> + <title><application>CVSup</application> ファイルコレクション</title> + + <para><application>CVSup</application> + 経由で入手できるファイルコレクションは + 階層的に組織化されています. + いくつか大きなコレクションがあり, + それらは小さなサブコレクションに 分割されています. + 大きなコレクションは, そのサブコレクション毎に + 受信することと同じことになります. + 下の一覧ではコレクション間の階層関係を + 字下げして表現します.</para> + + <para>最も一般的に使用するコレクションは + <literal>src-all</literal>, <literal>cvs-crypto</literal>, + そして <literal>ports-all</literal> です. + 他のコレクションは特別な目的を持つ人達だけが 使用しており, + ミラーサイトはそれらのすべてを + 持っていないかもしれません.</para> + + <variablelist> + <varlistentry><term><literal>cvs-all release=cvs</literal></term> + <listitem> + <para>メインの FreeBSD CVS リポジトリであり, + 輸出規制された暗号化コードは含まれていません.</para> + + <variablelist> + <varlistentry> + <term><literal>distrib release=cvs</literal></term> + <listitem> + <para>FreeBSD + の配布とミラーに関連するファイルです.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>doc-all release=cvs</literal></term> + <listitem> + <para>FreeBSD + ハンドブックおよびその他のドキュメントの + ソースです.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-all release=cvs</literal></term> + <listitem> + <para>FreeBSD の ports コレクションです.</para> + + <variablelist> + <varlistentry> + <term><literal>ports-archivers release=cvs + </literal></term> + <listitem> + <para>アーカイビングのツール.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-astro release=cvs</literal></term> + <listitem> + <para>天文学関連の ports.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-audio release=cvs</literal></term> + <listitem> + <para>サウンドサポート.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-base release=cvs</literal></term> + <listitem> + <para><filename>/usr/ports</filename> + のトップにあるその他のファイル.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-benchmarks release=cvs + </literal></term> + <listitem> + <para>ベンチマークプログラム.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-biology release=cvs + </literal></term> + <listitem> + <para>植物学関連のプログラム.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-cad release=cvs</literal></term> + <listitem> + <para>CAD ツール.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-chinese release=cvs + </literal></term> + <listitem> + <para>中国語サポート.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-comms release=cvs</literal></term> + <listitem> + <para>通信ソフトウェア.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-converters release=cvs + </literal></term> + <listitem> + <para>文字コードコンバータ.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-databases release=cvs + </literal></term> + <listitem> + <para>データベース.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-deskutils release=cvs + </literal></term> + <listitem> + <para>コンピュータが発明される前に + 卓上で使われていたものたち.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-devel release=cvs</literal></term> + <listitem> + <para>開発ユーティリティ.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-editors release=cvs + </literal></term> + <listitem> + <para>エディタ.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-emulators release=cvs + </literal></term> + <listitem> + <para>他の OS のエミュレータ.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-games release=cvs</literal></term> + <listitem> + <para>ゲーム.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-german release=cvs + </literal></term> + <listitem> + <para>ドイツ語サポート.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-graphics release=cvs + </literal></term> + <listitem> + <para>グラフィックユーティリティ.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-japanese release=cvs + </literal></term> + <listitem> + <para>日本語サポート.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-korean release=cvs + </literal></term> + <listitem> + <para>韓国語サポート.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-lang release=cvs</literal></term> + <listitem> + <para>プログラミング言語.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-mail release=cvs</literal></term> + <listitem> + <para>メールソフトウェア.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-math release=cvs</literal></term> + <listitem> + <para>数値計算ソフトウェア.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-mbone release=cvs</literal></term> + <listitem> + <para>MBone アプリケーション.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-misc release=cvs</literal></term> + <listitem> + <para>色々なユーティリティ.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-net release=cvs</literal></term> + <listitem> + <para>ネットワーキングソフトウェア.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-news release=cvs</literal></term> + <listitem> + <para>USENET ニュースのソフトウェア.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-plan9 release=cvs</literal></term> + <listitem> + <para>Plan9 からの色々なプログラム.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-print release=cvs</literal></term> + <listitem> + <para>印刷ソフトウェア.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-russian release=cvs + </literal></term> + <listitem> + <para>ロシア語サポート.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-security release=cvs + </literal></term> + <listitem> + <para>セキュリティユーティリティ.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-shells release=cvs + </literal></term> + <listitem> + <para>コマンドラインシェル.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-sysutils release=cvs + </literal></term> + <listitem> + <para>システムユーティリティ.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-textproc release=cvs + </literal></term> + <listitem> + <para>文書処理ユーティリティ + (デスクトップパブリッシングは含まない).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-vietnamese release=cvs + </literal></term> + <listitem> + <para>ベトナム語サポート.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-www release=cvs</literal></term> + <listitem> + <para>World Wide Web 関連のソフトウェア.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-x11 release=cvs</literal></term> + <listitem> + <para>X window システムをサポートする ports.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-x11-clocks release=cvs + </literal></term> + <listitem> + <para>X11 上で動作する時計の数々.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-x11-fm release=cvs + </literal></term> + <listitem> + <para>X11 上で動作するファイラ.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-x11-fonts release=cvs + </literal></term> + <listitem> + <para>X11 のフォントとフォントユーティリティ.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-x11-toolkits release=cvs + </literal></term> + <listitem> + <para>X11 のツールキット.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>ports-x11-wm release=cvs + </literal></term> + <listitem> + <para>X11 のウィンドウマネージャ.</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-all release=cvs</literal></term> + <listitem> + <para>メインの FreeBSD ソース群であり, + 輸出規制された暗号化コードは + 含まれていません.</para> + + <variablelist> + <varlistentry> + <term><literal>src-base release=cvs</literal></term> + <listitem> + <para><filename>/usr/src</filename> + のトップにあるその他のファイル.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-bin release=cvs</literal></term> + <listitem> + <para>シングルユーザモードで必要な + ユーザユーティリティ + (<filename>/usr/src/bin</filename>).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-contrib release=cvs</literal></term> + <listitem> + <para>FreeBSD プロジェクト外部からの + ユーティリティおよびライブラリ, + 比較的無修正 + (<filename>/usr/src/contrib</filename>).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-etc release=cvs</literal></term> + <listitem> + <para>システムコンフィグレーションファイル + (<filename>/usr/src/etc</filename>).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-games release=cvs</literal></term> + <listitem> + <para>ゲーム + (<filename>/usr/src/games</filename>).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-gnu release=cvs</literal></term> + <listitem> + <para>GNU Public License + 下にあるユーティリティ + (<filename>/usr/src/gnu</filename>).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-include release=cvs</literal></term> + <listitem> + <para>ヘッダファイル + (<filename>/usr/src/include</filename>).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-kerberosIV release=cvs + </literal></term> + <listitem> + <para>KerberosIV セキュリティパッケージ + (<filename>/usr/src/kerberosIV</filename>).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-lib release=cvs</literal></term> + <listitem> + <para>ライブラリ + (<filename>/usr/src/lib</filename>).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-libexec release=cvs</literal></term> + <listitem> + <para>システムプログラムであり, + 通常は他のプログラムから実行される + (<filename>/usr/src/libexec</filename>).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-release release=cvs</literal></term> + <listitem> + <para>FreeBSD の release + を構築するために必要なファイル + (<filename>/usr/src/release</filename>).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-sbin release=cvs</literal></term> + <listitem> + <para>シングルユーザモード用の + システムユーティリティ + (<filename>/usr/src/sbin</filename>).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-share release=cvs</literal></term> + <listitem> + <para>多様なシステム間で共有可能なファイル + (<filename>/usr/src/share</filename>).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-sys release=cvs</literal></term> + <listitem> + <para>カーネル + (<filename>/usr/src/sys</filename>).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-tools release=cvs</literal></term> + <listitem> + <para>FreeBSD の保守用の色々なツール + (<filename>/usr/src/tools</filename>).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-usrbin release=cvs</literal></term> + <listitem> + <para>ユーザユーティリティ + (<filename>/usr/src/usr.bin</filename>).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-usrsbin release=cvs</literal></term> + <listitem> + <para>システムユーティリティ + (<filename>/usr/src/usr.sbin</filename>).</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>www release=cvs</literal></term> + <listitem> + <para>World Wide Web のデータ用のソースです.</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + + <varlistentry><term><literal>cvs-crypto release=cvs</literal></term> + <listitem> + <para>輸出規制された暗号化コードです.</para> + + <variablelist> + <varlistentry> + <term><literal>src-crypto release=cvs</literal></term> + <listitem> + <para>輸出規制された FreeBSD + プロジェクト外部からのユーティリティおよび + ライブラリ, 比較的無修正 + (<filename>/usr/src/crypto</filename>).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-eBones release=cvs</literal></term> + <listitem> + <para>Kerberos および DES + (<filename>/usr/src/eBones</filename>).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>src-secure release=cvs</literal></term> + <listitem> + <para>DES (<filename>/usr/src/secure</filename>).</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + + <varlistentry><term><literal>distrib release=self</literal></term> + <listitem> + <para>CVSup + サーバ自身のコンフィグレーションファイルです. CVSup + ミラーサイトが使用します.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>gnats release=current</literal></term> + <listitem> + <para>GNATS バグトラッキングデータベースです.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>mail-archive release=current</literal></term> + <listitem> + <para>FreeBSD 関連メーリングリストのアーカイブ.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>www release=current</literal></term> + <listitem> + <para>インストールされた World Wide Web のデータです. + WWW ミラーサイトが使用します.</para> + </listitem> + </varlistentry> + </variablelist> + </sect3> + + <sect3> + <title>詳細について</title> + + <para>CVSup の FAQ や CVSup に関するその他の情報については + <ulink url="http://www.polstra.com/projects/freeware/CVSup/"> + The CVSup Home Page</ulink> をご覧ください.</para> + + <para><application>CVSup</application> のほとんどの FreeBSD + 関連の議論は &a.hackers; で おこなわれています. + ソフトウェアの新しいバージョンは &a.announce; で + アナウンスされます.</para> + + <para>質問とバグ報告はプログラムの作者, + <email>cvsup-bugs@polstra.com</email> へ + 送ってください.</para> + </sect3> + </sect2> + </sect1> + + <sect1 id="makeworld"> + <title><command>make world</command> でシステムを再構築する</title> + + <para><emphasis>Contributed by &a.nik;.</emphasis></para> + + <para><emphasis>訳: &a.jp.y-koga;.<!-- <br> --> + 16 March 1998.</emphasis></para> + + <para>FreeBSD のどれか特定のバージョン (<literal>stable</literal>, + <literal>current</literal> など) + について, ローカルのソースツリーを同期させたら, + そのソースツリーを使ってシステムを + 再構築しなければなりません.</para> + + <para>その方法については, <ulink + URL="http://www.nothing-going-on.demon.co.uk/FreeBSD/make-world/make-world.html">http://www.nothing-going-on.demon.co.uk/FreeBSD/make-world/make-world.html</ulink> が今のところ一番よいチュートリアル資料です.</para> + + <para>このチュートリアルの次のバージョンは, ハンドブックに統合される予定です.</para> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/disks/chapter.sgml b/ja_JP.eucJP/books/handbook/disks/chapter.sgml new file mode 100644 index 0000000000..81329e0185 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/disks/chapter.sgml @@ -0,0 +1,211 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.5 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:58 kuriyama Exp $ +--> + +<chapter id="disks"> + <title>ディスク</title> + + <para><emphasis>原作 &a.obrien; 26 April 1998</emphasis></para> + <para><emphasis>訳: &a.jp.yoshiaki;. 19 July 1998.</emphasis></para> + + <para>1台だけディスクのあるマシンに新しい SCSI ディスクを追加する + 場合について述べましょう. まず, コンピュータの電源を切り, + コンピュータにコントローラとドライブを接続します. これには + 様々な手順がありえるため詳細についてはこのドキュメントの範囲外 + です.</para> + + <para><username>root</username>ユーザとして login します. + ドライブを接続した + あとで <filename>/var/run/dmesg.boot</filename> を調べて, + 新しいドライブが + 認識されたことを確認します. 以下の例では, あたらしく加える + ドライブは <filename>sd1</filename> で + <filename>/1</filename> へマウントしたいとします. + (IDE ドライブを加える場合は<filename>sd</filename> の代りに + <filename>wd</filename>を使います)</para> + + <para>FreeBSD は IBM-PC 互換コンピュータで動作しますので, + (訳注: 通常の場合では) + ディスクは PC BIOS パーティションに属しなければなりません. + これは伝統的な BSD パーティションとは異なります. PC のディスク + は最大4までのエントリを持ちます. もしディスク全体を FreeBSD に + わりあてるのであれば, + <emphasis>ディスク全体を使用</emphasis>を選ぶことが + できます. そうでないなら PC BIOS パーティションの一つに + FreeBSD を入れることになります. FreeBSD では PC BIOS + パーティションのことを <emphasis>slices</emphasis> と呼びます. + 伝統的な + BSD パーティションと混同するのを防ぐためです. FreeBSD のために + つくったスライスをつかうこともできますし, ほかの OS を + インストールしてあるスライスをつかうこともできます. + これは他のオペレーティングシステムの <command>fdisk</command> + ユーティリティの混乱を引き起こしません.</para> + + <para>スライスをつかう場合, ドライブは + <filename>/dev/sd1s1e</filename> のよう + な形で加えられます. これは, SCSI ディスクの, ユニット番号1 + (2台目の SCSI ディスク), スライス1 (PC BIOS パーティション1), + <filename>e</filename> BSD パーティションという意味です. + 全体を割り当てる場合は, ドライブは <filename>/dev/sd1e</filename> + という単純な形になります.</para> + + <sect1> + <title>sysinstall を利用する</title> + <!-- kuriyama - Should use command tag? --> + + <para><command>/stand/sysinstall</command>を利用すると, + 新しいディスクの + パーティションやディスクラベルの設定をメニューから簡単に + 行うことができます. + <username>root</username>ユーザで login するか + <command>su</command> コマンドを使います. + <command>/stand/sysinstall</command> を動かし, + <literal>カスタム</literal> メニューに入ります. + <literal>カスタムメニュー</literal> で + <literal>パーティション</literal> + を選びます. そうするとシステムに接続されているハードディスクの + リストがあらわれるでしょう. <literal>sd1</literal> + がリストに無い場合は接続と + <filename>/var/run/dmesg.boot</filename> にある + <command>dmesg</command> の出力を + チェックする必要があります.</para> + <!-- kuriyama - カスタム is "Configure"? --> + + <para><literal>sd1</literal>を選び, <literal>FDISK + パーティションエディタ</literal> に入ります. ディスク全体を + FreeBSD でつかうのであれば <literal>A</literal> を選びます. + <quote>正しいパーティションエントリを保持して, このドライブには + 将来的に他のオペレーティングシステムを + 同居させる余地を残しますか?</quote> と聞かれますので, + そうしたい場合は<literal>YES</literal> を選んでください. + 変更をディスクに書き込むには<command>W</command> + コマンドを使います. FDISK + エディタを終了するには<command>q</command>コマンドを使います. + FDISK エディタを終了すると Master Boot Record + について質問されます. + すでに動いているシステムにディスクを追加するのですから + <literal>None</literal> を選びます.</para> + + <para>次に <literal>ディスクラベルエディタ</literal>に入ります. + ここで BSD の伝統的パーティションをつくります. + ディスクには <literal>a</literal> から <literal>h</literal> + までのラベルがついた + 8区画のパーティションをつくることができます. + 一部のパーティションのラベルについては特別に扱われます. + <literal>a</literal> パーティションは root パーティション + (<filename>/</filename>) に + 使われます. したがって, システムディスク(すなわち ブートを行う + ディスク)に 1つだけ<literal>a</literal> + パーティションをつくるべきです. + <literal>b</literal> + パーティションは swap パーティションとして使われ + ます. swap パーティションは複数のディスク上につくっても + かまいません. <literal>c</literal> + パーティションは「ディスク全体を使用」 + としている場合はディスク全体をさします. スライスを利用している + 場合は FreeBSD のスライス全体をさします. そのほかの + パーティションは一般的な目的に利用します.</para> + + <para>sysinstall のラベルエディタは root や swap 以外の + パーティションでは <literal>e</literal> + をつかうように勧めます. + ラベルエディタでは単一のファイルシステムを作成するには + <command>C</command> コマンドをつかいます. + FS (ファイルシステム) か swap かを聞いてきますので + <literal>FS</literal> を + 選びマウントポイントを入力(<filename>/mnt</filename> + のように)します. + インストール後の設定のモードではディスクの追加をするときに, + sysinstall は <filename>/etc/fstab</filename> + にエントリを作成しません. + したがってここでのマウントポイントの入力は + 重要ではありません.</para> + + <para>これでディスクへのディスクラベルの書き込みと + ファイルシステムの作成の準備ができました. + <command>W</command> を + 押してください. sysinstall が新しいパーティションがマウント + できないことについてエラーを出しますが無視してください. + ラベルエディタから抜けて sysinstall を終了してください.</para> + + <para>最後のステップは <filename>/etc/fstab</filename> + の編集で, 新しいディスクのエントリを追加します.</para> + </sect1> + + <sect1> + <title>コマンドラインユーティリティの利用</title> + + <sect2> + <title>* スライスを利用する</title> + + <para></para> + </sect2> + + <sect2> + <title>ディスク全体を利用する</title> + + <para>新しいドライブを別のオペレーティングシステムで共有しない + 場合, ディスク全体を利用 (<literal>dedicated</literal> mode) + することも + できます. このモードではダメージが与えられるということは + ありませんが Microsoft のオペレーティングシステムが混乱する + ということを覚えておいてください. + IBM の OS/2 では認識できない場合, すべて占有されていると + 解釈します.</para> + + <screen>&prompt.root; <userinput>dd if=/dev/zero of=/dev/rsd1 bs=1k count=1</userinput> +&prompt.root; <userinput>disklabel -Brw sd1 auto</userinput> +&prompt.root; <userinput>disklabel -e sd</userinput>1 # `e' パーティションの作成 +&prompt.root; <userinput>newfs -d0 /dev/rsd1e</userinput> +&prompt.root; <userinput>mkdir -p /1</userinput> +&prompt.root; <userinput>vi /etc/fstab</userinput> # /dev/sd1e のエントリ +&prompt.root; <userinput>mount /1</userinput></screen> + + <para>別の方法は:</para> + + <screen>&prompt.root; <userinput>dd if=/dev/zero of=/dev/rsd1 count=2</userinput> +&prompt.root; <userinput>disklabel /dev/rsd1 | disklabel -BrR sd1 /dev/stdin</userinput> +&prompt.root; <userinput>newfs /dev/rsd1e</userinput> +&prompt.root; <userinput>mkdir -p /1</userinput> +&prompt.root; <userinput>vi /etc/fstab</userinput> # /dev/sd1e のエントリ +&prompt.root; <userinput>mount /1</userinput></screen> + </sect2> + </sect1> + + <sect1> + <title>* 伝統的なものとは異なるドライブ</title> + + <sect2> + <title>* Zip ドライブ</title> + + <para></para> + </sect2> + + <sect2> + <title>* Jazz ドライブ</title> + + <para></para> + </sect2> + + <sect2> + <title>* Sequest ドライブ</title> + + <para></para> + </sect2> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/eresources/chapter.sgml b/ja_JP.eucJP/books/handbook/eresources/chapter.sgml new file mode 100644 index 0000000000..c9a5567c30 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/eresources/chapter.sgml @@ -0,0 +1,1318 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.11 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:46:00 kuriyama Exp $ +--> + +<chapter id="eresources"> + <title>インターネット上のリソース</title> + + <para><emphasis>原作: &a.jkh;.</emphasis></para> + + <para><emphasis>訳: &a.jp.yuki;.<!-- <br> --> + 28 August 1996</emphasis></para> + + <para>FreeBSD の進歩が急速であるため, + 最新の開発をフォローするためには, + 印刷したメディアは実用的でなくなっています. 大抵の場合, + 最新情報を入手する方法としては, 電子的なリソースが ベストです. + FreeBSDはボランティアの努力によって, ユーザコミュニティ自体が, + 一種の“テクニカルサポート部門”としての + 役割も通常果たしており, + 電子メールやUsenetのニュースがこれらのコミュ + ニティにたどり着く最も効果的な方法になっています.</para> + + <para>以下に, FreeBSD + ユーザコミュニティに連絡を取る場合の最も重要な点についての + 概略を示します. + もしここに書かれていない他のリソースに気がついた場合は, それらを + &a.doc; に送って頂ければ, + それらをここに含めるかもしれません.</para> + + <sect1 id="eresources-mail"> + <title>メーリングリスト</title> + + <para>多くのFreeBSDの開発メンバはUSENETを読むことができますが, + もし, <literal>comp.unix.bsd.freebsd.*</literal> + のグループの一つに質問を投稿したとしても + タイムリにその質問を受け取るということは保証できません. + 質問を適切なメーリングリストに投稿すれば, + 私たちかFreeBSDの関係者から, よりよい + (そして少なくともより早い) + 反応がいつでも得られることでしょう.</para> + + <para>さまざまなメーリングリストの憲章を + このドキュメントの最後に記載しま す. <emphasis>私たちは, + メーリングリストの質, 特に技術面に関する質を高く保つ + ために努力しているので, + メーリングリストに参加する前にその憲章を読んで ください. + </emphasis> 私たちのメーリングリストの参加者のほとんどは, + 現在非常 にたくさんの FreeBSD + に関連したメッセージを毎日受け取っており, メーリン + グリストに対するふさわしい + 用いられ方をするための憲章やルールを決めるこ とによって, + メーリングリストの S/N 比を高くする保つように励んでいます. + そうしないと, 結果的に, メーリングリストがプロジェクトにとって + 事実上のコミュニケーションの手段になってしまうでしょう.</para> + + <para>メーリングリストはいずれもアーカイブされており, それらは + <ulink URL="../search.html">FreeBSD World Wide Web + server</ulink> で検索することができます. + キーワード検索可能なアーカイブの提供は, + 良くある質問に対する回答を見つけるすぐれた方法ですから, + 質問を投稿する前に調べてみるべきでしょう.</para> + + <sect2 id="eresources-summary"> + <title>メーリングリストの概説</title> + + <para><emphasis>一般的なメーリングリスト:</emphasis> + 以下のものは誰でも自由に参加できる (そしておすすめの) + 一般的なものです:</para> + + <informaltable frame="none"> + <tgroup cols="2"> + <thead> + <row> + <entry>リスト</entry> + <entry>目的</entry> + </row> + </thead> + + <tbody> + <row> + <entry>freebsd-advocacy</entry> + <entry>FreeBSD の福音伝道</entry> + </row> + + <row> + <entry>freebsd-announce</entry> + <entry>重要なイベントやプロジェクトのマイルストン</entry> + </row> + + <row> + <entry>freebsd-bugs</entry> + <entry>バグレポート</entry> + </row> + + <row> + <entry>freebsd-chat</entry> + <entry>FreeBSD + コミュニティに関連する技術的ではない話題</entry> + </row> + + <row> + <entry>freebsd-current</entry> + <entry>FreeBSD-current の使用に関連する議論</entry> + </row> + + <row> + <entry>freebsd-isp</entry> + <entry>FreeBSD を用いている + インターネットサービスプロバイダの話題</entry> + </row> + + <row> + <entry>freebsd-jobs</entry> + <entry>FreeBSD 関連の雇用機会に関する話題</entry> + </row> + + <row> + <entry>freebsd-newbies</entry> + <entry>FreeBSD 初心者ユーザの活動と議論</entry> + </row> + + <row> + <entry>freebsd-questions</entry> + <entry>ユーザからの質問と技術サポート</entry> + </row> + + <row> + <entry>freebsd-stable</entry> + <entry>FreeBSD-stable の使用に関連する議論</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para><emphasis>技術的なメーリングリスト:</emphasis> + 以下のメーリングリストは, 技術的な 議論のためのものです. + それらの利用や内容のためにしっかりとしたガイドラ + インがあるので, これらのメーリングリストに入ったり, + どれか一つにメール を送ったりする前には, + それらのメーリングリストの憲章を注意深く読むべきで す.</para> + + <informaltable frame="none"> + <tgroup cols="2"> + <thead> + <row> + <entry>リスト</entry> + <entry>目的</entry> + </row> + </thead> + + <tbody> + <row> + <entry>freebsd-afs</entry> + <entry>FreeBSD へのAFSの移植</entry> + </row> + + <row> + <entry>freebsd-alpha</entry> + <entry>FreeBSD の Alpha への移植</entry> + </row> + + <row> + <entry>freebsd-doc</entry> + <entry>FreeBSD 関連ドキュメントの作成</entry> + </row> + + <row> + <entry>freebsd-database</entry> + <entry>FreeBSD + 上でのデータベースの利用や開発に関する議論</entry> + </row> + + <row> + <entry>freebsd-emulation</entry> + <entry>Linux/DOS/Windows + のような他のシステムのエミュレーション</entry> + </row> + + <row> + <entry>freebsd-fs</entry> + <entry>ファイルシステム</entry> + </row> + + <row> + <entry>freebsd-hackers</entry> + <entry>一般的な技術の議論</entry> + </row> + + <row> + <entry>freebsd-hardware</entry> + <entry>FreeBSD の走るハードウェアの一般的な議論</entry> + </row> + + <row> + <entry>freebsd-isdn</entry> + <entry>ISDN 開発者</entry> + </row> + + <row> + <entry>freebsd-java</entry> + <entry>Java 開発者や, FreeBSD へ JDK + を移植する人たち</entry> + </row> + + <row> + <entry>freebsd-mobile</entry> + <entry>モーバイルコンピューティングについての議論</entry> + </row> + + <row> + <entry>freebsd-mozilla</entry> + <entry>mozilla の FreeBSD への移植に関する議論</entry> + </row> + + <row> + <entry>freebsd-net</entry> + <entry>ネットワークおよび TCP/IP + ソースコードに関する議論</entry> + </row> + + <row> + <entry>freebsd-platforms</entry> + <entry>Intel 以外のアーキテクチャのプラットフォームへの移植</entry> + </row> + + <row> + <entry>freebsd-ports</entry> + <entry>ports コレクションに関する議論</entry> + </row> + + <row> + <entry>freebsd-scsi</entry> + <entry>SCSI サブシステム</entry> + </row> + + <row> + <entry>freebsd-security</entry> + <entry>セキュリティに関する話題</entry> + </row> + + <row> + <entry>freebsd-small</entry> + <entry>組み込みアプリケーションにおける FreeBSD の利用</entry> + </row> + + <row> + <entry>freebsd-smp</entry> + <entry>対称 / 非対称の + マルチプロセッシングの設計に関する議論</entry> + </row> + + <row> + <entry>freebsd-sparc</entry> + <entry>FreeBSD の Sparc への移植</entry> + </row> + + <row> + <entry>freebsd-tokenring</entry> + <entry>FreeBSD でのトークンリングのサポート</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para><emphasis>制限されているメーリングリスト:</emphasis> + 以下のメーリングリストは参加 + するには<email>core@FreeBSD.ORG</email>の 認可が必要ですが, + それぞれの憲章の範囲内であれば, 提案やコメントは誰で + も自由に投稿することができます.</para> + + <informaltable frame="none"> + <tgroup cols="2"> + <thead> + <row> + <entry>メーリングリスト</entry> + <entry>目的</entry> + </row> + </thead> + + <tbody> + <row> + <entry>freebsd-admin</entry> + <entry>管理に関する話題</entry> + </row> + + <row> + <entry>freebsd-arch</entry> + <entry>アーキテクチャや設計の議論</entry> + </row> + + <row> + <entry>freebsd-core</entry> + <entry>FreeBSDコアチーム</entry> + </row> + + <row> + <entry>freebsd-hubs</entry> + <entry>ミラーサイトを運営している人達 + (基盤のサポート)</entry> + </row> + + <row> + <entry>freebsd-install</entry> + <entry>インストール関係の開発</entry> + </row> + + <row> + <entry>freebsd-security-notifications</entry> + <entry>セキュリティに関する通知</entry> + </row> + + <row> + <entry>freebsd-user-groups</entry> + <entry>ユーザグループの調整</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para><emphasis>CVSメーリングリスト:</emphasis> + 以下のメーリングリストはソースツリーの + さまざまな場所の変更のログメッセージを見ることに + 興味のある人向けです. + これらは<emphasis>読み専用</emphasis>のリストで, + これらにメールを送る事は出来ません.</para> + + <informaltable frame="none"> + <tgroup cols="3"> + <thead> + <row> + <entry>メーリングリスト</entry> + <entry>ソースの範囲</entry> + <entry>(ソースの) 範囲の説明</entry> + </row> + </thead> + + <tbody> + <row> + <entry>cvs-all</entry> + <entry>/usr/src</entry> + <entry>ツリーのすべての変更 (スーパーセット)</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </sect2> + + <sect2 id="eresources-subscribe"> + <title>参加方法</title> + + <para>どのメーリングリストも<hostid + role="fqdn">FreeBSD.ORG</hostid>にあるので, + メーリングリストにメールを送るには, ただ + <email><replaceable>listname</replaceable>@FreeBSD.ORG</email> + にメールを送るだけです. すると, + メーリングリストに登録されている世界中のメンバに + 再配布されます.</para> + + <para>メーリングリストに参加するには, <programlisting> + subscribe <listname> [<optional + address>]</programlisting> + という内容をメッセージの本文に含むメールを &a.majordomo; + に送ります. 例えば, <literal>freebsd-announce</literal> + に参加したい場合は次のようにします:</para> + + <screen>&prompt.user; <userinput>mail majordomo@FreeBSD.ORG</userinput> +subscribe freebsd-announce +^D</screen> + + <para>もし, あなたが, 自分自身を違う名前 (メールアドレス) + で登録したい場合, あるいは, ローカルなメーリングリスト + (もしあなたのサイトに, 興味を持った仲間がいるなら, + これはより有効ですし, 私たちにとっても非常に嬉しいことです.) + を登録する申し込みをおこないたいのであれば, 次のようにします: + </para> + + <screen>&prompt.user; <userinput>mail majordomo@FreeBSD.ORG</userinput> +subscribe freebsd-announce local-announce@somesite.com +^D</screen> + + <para>最後に, majordomo に対して + 他のタイプのコントロールメッセージを送ることで + メーリングリストから脱退したり, + メーリングリストの他のメンバのリストを 得たり, + 再びメーリングリストのリストを見たりすることも可能です. + 利用できるコマンドの完全なリストを入手するには, + 次のようにします: </para> + + <screen>&prompt.user; <userinput>mail majordomo@FreeBSD.ORG</userinput> +help +^D</screen> + + <para>再度言いますが, + 私たちは技術的なメーリングリストでは技術的な議論を保つよう + 要求します. もし, + “高いレベル”にのみ興味があるなら, freebsd-announce + に参加するように勧めます. + これは少ないトラフィックの予定です.</para> + <!-- kuriyama - high point ??? --> + </sect2> + + <sect2 id="eresources-charters"> + <title>メーリングリストの憲章</title> + + <para><emphasis>全て</emphasis> FreeBSD + メーリングリストは誰でもそれらを利用することに + 固守しなければいけないという一定の簡単なルールがあります. + これらのルー ルに従わないと, 結果として FreeBSD の Postmaster + <email>postmaster@freebsd.org</email>から 2 回までは警 + 告を受けます. 3回違反すると, + 投稿者は全てのFreeBSDのメーリングリストか ら削除され, + そのメーリングリストへのさらなる投稿から締め出されるでしょ う. + これらのルールや対策が必要なのは残念です. + しかし, 今日のインターネッ + トはずいぶんいやらしい環境になっており, 一般の人々は, + その(対策の) メカニズムがいかにもろいかという事すら + 認識する事が出来ていないと思われます.</para> + + <para>道標</para> + + <itemizedlist> + <listitem> + <para>いかなる投稿記事もそのメーリングリストの + 基本的な憲章を守るべきで す. 例えば, + そのメーリングリストが技術的な問題に関するものであ れば, + 技術的な議論を含む投稿でなければなりません. 現在継続中の + 不適切な憲章やフレイムは, + 所属している全ての人に対してメーリングリスト + の価値を下げてしまうだけですし, + 許される行為ではないでしょう. + とくに話題のない自由形式の議論に対してはfreebsd-chat + <email>freebsd-chat@freebsd.org</email>メーリ + ングリストが自由に認可されているので, + かわりに使うべきでしょう.</para> + </listitem> + + <listitem> + <para>一度に 3 + つ以上のメーリングリストには決して投稿すべきでは + ありません. 2 + つのメーリングリストには双方に明確な必要性がある場合にのみ + 投稿すべきです. どのリ ストに対しても, + (メーリングリストの)参加者は(複数のメーリングリ + ストに)重複して参加しており, 関連する部分が少ない(例えば, + "-stable と -scsi")メーリングリストを除いては, + 一度に複数のメー + リングリストに投稿する理由は全くありません. もし, + Ccに複数の メーリングリストがそのような形で現れて, + あなたに届いたのであれば, 再びそのメールに返事を出す前に, + ccの部分もまた編集するべきです. + <emphasis>元記事を書いたのが誰であっても, + あなた自身のクロスポストに + <emphasis>まだ</emphasis>責任があります. + </emphasis></para> + </listitem> + + <listitem> + <para>ユーザであれ開発者であれ, (議論の中で) + 個人を攻撃したり冒涜した りすることは許されません. + 個人的なメールを引用したり再投稿したり + する許可をもらえなかったり, もらえそうにない時に, + それをおこなう ようなネチケット (訳注: + ネットワークにおけるエチケット) に対する + ひどい違反は好まれませんが, + してはならないと特別に定められている わけではありません. + <emphasis>しかしながら</emphasis>, そのような内容がメー + リングリストの憲章に沿う場合はほとんどありません. + このため, メー + リングリストの憲章に違反しているということだけで警告 + (または禁止) に値するものと考えていいでしょう.</para> + </listitem> + + <listitem> + <para>FreeBSD 以外の関連する製品やサービスの広告は, + 絶対に禁止し, spam + による違反者が宣伝していることが明確であったら, + すぐに禁止しま す.</para> + </listitem> + </itemizedlist> + + <para><emphasis>個々のメーリングリストの憲章:</emphasis></para> + + <variablelist> + <varlistentry><term>FREEBSD-AFS</term> + <listitem> + <para><emphasis>Andrew ファイルシステム</emphasis></para> + <para>このリストは, CMU/Transarc の AFS + の移植や使用に関する議論のためです.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-ADMIN</term> + <listitem> + <para><emphasis>管理上の話題</emphasis></para> + <para>このリストは, 純粋に <hostid role="domainname"> + freebsd.org </hostid> + 関係の議論のためのメーリングリストで,プ + ロジェクトの資源の問題や乱用の報告を行ないます. + これはクローズドなリ ストですが, + 誰でも問題(私達のシステムを含みます!) + を報告できます.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-ANNOUNCE</term> + <listitem> + <para><filename>重要なイベント/マイルストン</filename></para> + <para>これは, 単にたまに発表される重要な freebsd + のイベントに関心がある人のた めのメーリングリストです. + これは, スナップショットやその他のリリースに + ついてのアナウンスを含みます. + そのアナウンスは新しいFreeBSDの機能のア + ナウンスを含んでいます. + ボランティア等の呼びかけがあるかもしれませ ん. + これは流通量の少ないメーリングリストで, + 完全なモデレートメーリン グリストです.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-ARCH</term> + <listitem> + <para><emphasis>アーキテクチャと設計の議論</emphasis></para> + <para>これは, FreeBSD + の設計に関する議論を行うモデレートメーリングリストです. + 内容は, 技術的な内容にほぼ限定されます. 稀に, + 全てのリスト登録者に配送する必要があると + 思われるメッセージを, モデレータが送る場合もあります. + 適切な話題の例: + </para> + + <itemizedlist> + <listitem> + <para>複数のカスタマイズされたビルドを同時に行うには, + ビルドシステムをどういじり直せばよいか</para> + </listitem> + + <listitem> + <para>VFS で Heidemann レイヤを動作させるには, + 何を修正する必要があるか</para> + </listitem> + + <listitem> + <para>同一のドライバを複数のバスや + アーキテクチャで美しく使うには + デバイスドライバインターフェースを + どう改変すれば良いか</para> + </listitem> + + <!-- kuriyama - 不適切な話題の例: --> + <listitem> + <para>ネットワークドライバを + かくにはどうすればいいか</para> + </listitem> + </itemizedlist> + + <para>議長はこのリストに投稿されたメッセージに対し, + たいして重要ではない編集(スペルチェック, + 文法の修正と整頓) を行う権限を持っています. + このメーリングリストの流通量は少ないでしょう. + 活発な議論が行われている場合は, + 論議がおさまるまで新たなトピックの投稿を + 遅らせなければならないかも知れません.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-BUGS</term> + <listitem> + <para><emphasis>バグレポート</emphasis></para> + <para>これは, FreeBSD + のバグレポートのためのメーリングリストです. 可能である + 場合はいつでも, バグは &man.send-pr.1; + を使うか, <ulink + URL="http://www.freebsd.org/send-pr.html">WEB + interface</ulink>を用い + て送られる必要があります.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-CHAT</term> + <listitem> + <para><emphasis>FreeBSDのコミュニティに関する + 技術的ではない話題</emphasis></para> + <para>このメーリングリストは技術的ではなく, + 社会的な情報について, + 他のメーリングリストでは取り扱わない話題を含みます. + これは, Jordanがシロイタチに似ているかどうか, + 大文字で打つかどうか, 誰がたくさんコーヒーを飲むか, + どこのビールが一番うまいか, + 誰が地下室でビールを作っているか, + などについての議論を含みます. 時々重要なイベント + (将来開催されるパーティーや, 結婚式, 誕生日, + 新しい仕事など) のお知らせが, + 技術的なメーリングリストから でてきます. しかし, + フォローは直接 + -chatメーリングリストにするべきです.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-CORE</term> + <listitem> + <para><emphasis>FreeBSDコアチーム</emphasis></para> + <para>これは, コアメンバが使う内部メーリングリストです. + FreeBSDに関連する深 刻なやっかい事の裁定や + ハイレベルな綿密な調査を要求するときに, このメー + リングリストにメッセージを送る事が出来ます.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-CURRENT</term> + <listitem> + <para><emphasis>FreeBSD-currentの使用に関する議論 + </emphasis></para> + <para>これは freebsd-current + のユーザのためのメーリングリストです. + メーリングリストでの話題は, -current + で登場した新しい機能について, + その新機能によってユーザに影響することについての注意, + および -current + のままでいるために必要な手順についての説明を含みます. + “current” + を走らせている人はこのメーリングリストに + 登録しなくてはなりません. + これは技術的なメーリングリストなので, + 完全に技術的な内容を要求します.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-CURRENT-DIGEST</term> + <listitem> + <para><emphasis>FreeBSD-currentの使用に関する議論 + </emphasis></para> + <para>freebsd-current + メーリングリストのダイジェスト版です. こ + のダイジェストは freebsd-current + に送られたすべてのメッセージをまとめた ものを, + 1つのメールにして送り出します. + 平均のサイズは約40kbyteです. こ + のメーリングリストは <emphasis>読み専用</emphasis>で, + メールを送るような事はしない で下さい.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-DOC</term> + <listitem> + <para><emphasis>ドキュメンテーションプロジェクト + </emphasis></para> + <para>このメーリングリストは, の発行物や FreeBSD + 用のドキュメントの作成に関 + わるプロジェクトに関する議論を行なうためのものです. + このメーリングリストに参加しているメンバーを “ + FreeBSD ドキュメンテーションプロジェクト” + と呼びます. + このメーリングリストは公開されているので自由に参加 + ・投稿することができます. </para> + </listitem><!-- kuriyama - strange translation --> + </varlistentry> + + <varlistentry><term>FREEBSD-FS</term> + <listitem> + <para><emphasis>ファイルシステム</emphasis></para> + <para>FreeBSDのファイルシステムに関する議論 + これは技術的なメーリングリストなので, + 完全に技術的な内容を要求します.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-ISDN</term> + <listitem> + <para><emphasis>ISDNコミュニケーション</emphasis></para> + <para>このメーリングリストは, + FreeBSDに対するISDNサポートの開発の議論を + おこなう人のためのものです.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-JAVA</term> + <listitem> + <para><emphasis>Javaの開発</emphasis></para> + <para>このメーリングリストは, FreeBSD + 向けのの重要なJavaアプリケーションの開発や, JDK + の移植やメンテナンスの + 議論をする人のためのものです.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-HACKERS</term> + <listitem> + <para><emphasis>技術的な議論</emphasis></para> + <para>これはFreeBSDに関する技術的な議論のための + フォーラムです. + これは最もテクニカルなメーリングリストです. + このメーリングリストは, FreeBSD + 上でアクティブに活動をしている人のためのもので, + 問題を持ち出したり, 代わりの解決法を議論します. + 技術的な議論をフォローするのに興味がある人も歓迎します. + これは技術的なメーリングリストなので, + 完全に技術的な内容を要求します.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-HACKERS-DIGEST</term> + <listitem> + <para><emphasis>技術的な議論</emphasis></para> + <para>freebsd-hackersメーリングリストのダイジェスト版です. + このダイジェスト はfreebsd-hackers + に送られたすべてのメッセージをまとめたものを, 1つのメー + ルにして送り出します. 平均のサイズは約40kbyteです. + このメーリングリス トは<emphasis>読み専用</emphasis>で, + メールを送るような事はしないで下さい.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-HARDWARE</term> + <listitem> + <para><emphasis>FreeBSDのハードウェアの一般的な議論 + </emphasis></para> + <para>FreeBSDが走っているハードウェアのタイプや, + 何を買ったり避けたりするかに関する様々な問題や, + 提案に関する議論.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-INSTALL</term> + <listitem> + <para><emphasis>インストールに関する議論</emphasis></para> + <para>このメーリングリストは将来のリリースの + インストールに関する開発の 議論のためのもので, + クローズドなメーリングリストです.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-ISP</term> + <listitem> + <para><emphasis> + インターネットサービスプロバイダのについての話題 + </emphasis></para> + <para>このメーリングリストは, + FreeBSDを用いたインターネット サービスプロバイダ (ISP) + に関する話題の議論のためのものです. + これは技術的なメーリングリストなので, + 完全に技術的な内容を要求します.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-NEWBIES</term> + <listitem> + <para><emphasis>初心者の活動の議論</emphasis></para> + <para>どのメーリングリストでも扱われていなかった + 初心者の活動すべてをカバーします. 独学や問題解決, + リソースの見つけ方や使い方, 質問のしかた, + メーリングリストの使い方, + どのメーリングリストを読めばいいのか, 普通の世間話, + 間違いの犯し方, 自慢話, アイディアの共有, 物語, 道徳的な + (技術的でない) お手伝い, FreeBSD + コミュニティでの貢献のしかたなどの話題をが含まれます. + これらの問題を取り扱い, freebsd-questions + へ質問できるようサポートします. また, + 初心者の頃にはまった同じ事柄に悩んでいる + 他の初心者との出会いの場としてfreebsd-newbies + を活用してください. </para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-PLATFORMS</term> + <listitem> + <para><emphasis>Intel以外のプラットフォームへの移植 + </emphasis></para> + <para>クロスプラットフォームのFreeBSDの問題. Intel + 以外のプラットフォームへの FreeBSD + の移植についての一般的な議論や提案. + これは技術的なメーリングリストなので, + 完全に技術的な内容を要求します.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-PORTS</term> + <listitem> + <para><emphasis>“ports” の議論</emphasis></para> + <para>FreeBSD の “ports コレクション” + (<filename>/usr/ports</filename>) や, 移植の提案, ports + コレクションの基盤の変更, + 一般的な整合化活動についての議論. + これは技術的なメーリングリストなので, + 完全に技術的な内容を要求します.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-QUESTIONS</term> + <listitem> + <para><emphasis>ユーザからの質問</emphasis></para> + <para>FreeBSDに関する質問のためののメーリングリストです. + その質問がかなり技術的だと思わないのであれば, + “どのようにして” + という質問を技術的なメーリングリストに + 送るべきではありません.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-QUESTIONS-DIGEST</term> + <listitem> + <para><emphasis>ユーザからの質問</emphasis></para> + <para>freebsd-questions + メーリングリストのダイジェスト版です. このダイジェストは + freebsd-questions + に送られたすべてのメッセージをまとめたものを, + 1つのメールにして送り出します. + 平均のサイズは約40kbyteです.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-SCSI</term> + <listitem> + <para><emphasis>SCSIサブシステム</emphasis></para> + <para>これは FreeBSD のための scsi + サブシステムについて作業している人向けです. + これは技術的なメーリングリストなので, + 完全に技術的な内容を要求します.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-SECURITY</term> + <listitem> + <para><emphasis>セキュリティの関連の話題</emphasis></para> + <para>FreeBSDコンピュータのセキュリティの話題 (DES, + Kerberos, よく知られている セキュリティホールや, + それらのふさぎ方など) + これは技術的なメーリングリストなので, + 完全に技術的な内容を要求します.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-SECURITY-NOTIFICATIONS</term> + <listitem> + <para><emphasis>セキュリティ関連の通知</emphasis></para> + <para>FreeBSD のセキュリティ問題や, + 修正に関する通知を行ないます. + このメーリングリストは議論を行なうための + メーリングリストではありません. 議論は FreeBSD-security + で行ないます.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-SMALL</term> + <listitem> + <para><emphasis>FreeBSD 組み込み技術</emphasis></para> + <para>特殊な FreeBSD 小型システムおよび FreeBSD + の組み込み技術に関する議論. + これは技術的なメーリングリストなので, + 完全に技術的な内容を要求します. </para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-STABLE</term> + <listitem> + <para><emphasis>FreeBSD-stable の使用に関する議論 + </emphasis></para> + <para>これは freebsd-stable のユーザ用のメーリングリスト + です. メーリングリストでの話題は, -stable + で登場した新しい 機能について, + その新機能によってユーザに影響すること についての注意, + および -stable + のままでいるために必要な手順についての説明を含みます. + “stable” を走らせている人はこの + メーリングリストに登録すべきです. + これは技術的なメーリングリストなので, 完全に技術的な + 内容を要求します.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FREEBSD-USER-GROUPS</term> + <listitem> + <para><emphasis>ユーザグループの調整のメーリングリスト + </emphasis></para> + <para>これは, ローカルなユーザグループがお互いに, または, + コアチームが指定した個人と問題を議論する, + それぞれのローカルエリアのユーザグループからの + 調整人向けの メーリングリストです. + このメーリングリストはユーザグループ間の + ミーティングの概要やプロジェクトの調整に + 制限されるべきです. + これはクローズドなメーリングリストです.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + </sect1> + + <sect1 id="eresources-news"> + <title>Usenet ニュースグループ</title> + + <para>2つのFreeBSD用のニュースグループがあります. ここでは + FreeBSDの議論をするたくさんの様々な人がおり, + 他にもFreeBSD関連するユーザがいます. + これらのいくつかのニュースグループは Warren Toomey + <email>wkt@cs.adfa.oz.au</email> によって <ulink + URL="http://minnie.cs.adfa.oz.au/BSD-info/bsdnews_search.html"> + Keyword searchable archives</ulink> で, + 検索できるようになっています.</para> + <sect2> + <title>BSD用のニュースグループ</title> + + <itemizedlist> + <listitem> + <para><ulink URL="news:comp.unix.bsd.freebsd.announce">comp.unix.bsd.freebsd.announce</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.unix.bsd.freebsd.misc">comp.unix.bsd.freebsd.misc</ulink></para> + </listitem> + </itemizedlist> + </sect2> + + <sect2> + <title>関連する他のUnixのニュースグループ</title> + + <itemizedlist> + <listitem> + <para><ulink URL="news:comp.unix">comp.unix</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.unix.questions">comp.unix.questions</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.unix.admin">comp.unix.admin</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.unix.programmer">comp.unix.programmer</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.unix.shell">comp.unix.shell</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.unix.user-friendly">comp.unix.user-friendly</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.security.unix">comp.security.unix</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.sources.unix">comp.sources.unix</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.unix.advocacy">comp.unix.advocacy</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.unix.misc">comp.unix.misc</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.bugs.4bsd">comp.bugs.4bsd</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.bugs.4bsd.ucb-fixes">comp.bugs.4bsd.ucb-fixes</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.unix.bsd">comp.unix.bsd</ulink></para> + </listitem> + </itemizedlist> + </sect2> + + <sect2> + <title>X Window システム</title> + + <itemizedlist> + <listitem> + <para><ulink URL="news:comp.windows.x.i386unix">comp.windows.x.i386unix</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.windows.x">comp.windows.x</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.windows.x.apps">comp.windows.x.apps</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.windows.x.announce">comp.windows.x.announce</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.windows.x.intrinsics">comp.windows.x.intrinsics</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.windows.x.motif">comp.windows.x.motif</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.windows.x.pex">comp.windows.x.pex</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="news:comp.emulators.ms-windows.wine">comp.emulators.ms-windows.wine</ulink></para> + </listitem> + </itemizedlist> + </sect2> + </sect1> + + <sect1 id="eresources-web"> + <title>World Wide Web サイト</title> + + <itemizedlist> + <listitem> + <para><ulink URL="http://www.FreeBSD.ORG/"> + http://www.FreeBSD.ORG/</ulink> + — 本家のサーバ.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.au.freebsd.org/FreeBSD/"> + http://www.au.freebsd.org/FreeBSD/</ulink> + — オーストラリア/1.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www2.au.freebsd.org/FreeBSD/"> + http://www.au.freebsd.org/FreeBSD/</ulink> + — オーストラリア/2.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www3.au.freebsd.org/FreeBSD/"> + http://www.au.freebsd.org/FreeBSD/</ulink> + — オーストラリア/3.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.br.freebsd.org/www.freebsd.org/"> + http://www.au.freebsd.org/www.freebsd.org/</ulink> + — ブラジル/1.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.br2.freebsd.org/www.freebsd.org/"> + http://www.br2.freebsd.org/www.freebsd.org/</ulink> + — ブラジル/2.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www3.br.freebsd.org/"> + http://www3.br.freebsd.org/</ulink> + — ブラジル/3.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.bg.freebsd.org/"> + http://www.bg.freebsd.org/</ulink> + — ブルガリア.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.ca.freebsd.org/"> + http://www.bg.freebsd.org/</ulink> + — カナダ/1.</para> + </listitem> + + <listitem> + <para><ulink URL="http://freebsd.kawartha.com/"> + http://freebsd.kawartha.com/</ulink> + — カナダ/2.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.dk.freebsd.org/"> + http://www.dk.freebsd.org/</ulink> + — デンマーク.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.ee.freebsd.org/"> + http://www.ee.freebsd.org/</ulink> + — エストニア.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.fi.freebsd.org/"> + http://www.fi.freebsd.org/</ulink> + — フィンランド.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.fr.freebsd.org/"> + http://www.fr.freebsd.org/</ulink> + — フランス.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.de.freebsd.org/"> + http://www.de.freebsd.org/</ulink> + — ドイツ/1.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www1.de.freebsd.org/"> + http://www1.de.freebsd.org/</ulink> + — ドイツ/2.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www2.de.freebsd.org/"> + http://www2.de.freebsd.org/</ulink> + — ドイツ/3.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.hu.freebsd.org/"> + http://www.hu.freebsd.org/</ulink> + — ハンガリー.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.is.freebsd.org/"> + http://www.is.freebsd.org/</ulink> + — アイスランド.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.ie.freebsd.org/"> + http://www.ie.freebsd.org/</ulink> + — アイルランド.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.jp.freebsd.org/www.freebsd.org/"> + http://www.jp.freebsd.org/www.freebsd.org/</ulink> + — 日本.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.kr.freebsd.org/"> + http://www.kr.freebsd.org/</ulink> + — 韓国.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.lv.freebsd.org/"> + http://www.lv.freebsd.org/</ulink> + — ラトビア.</para> + </listitem> + + <listitem> + <para><ulink URL="http://rama.asiapac.net/freebsd/"> + http://rama.asiapac.net/freebsd/</ulink> + — マレーシア.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.nl.freebsd.org/"> + http://www.nl.freebsd.org/</ulink> + — オランダ.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.no.freebsd.org/"> + http://www.no.freebsd.org/</ulink> + — ノルウェー.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.pl.freebsd.org/"> + http://www.pl.freebsd.org/</ulink> + — ポーランド.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.pt.freebsd.org/"> + http://www.pt.freebsd.org/</ulink> + — ポルトガル/1.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www2.pt.freebsd.org/"> + http://www2.pt.freebsd.org/</ulink> + — ポルトガル/2.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www3.pt.freebsd.org/"> + http://www3.pt.freebsd.org/</ulink> + — ポルトガル/3.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.ro.freebsd.org/"> + http://www.ro.freebsd.org/</ulink> + — ルーマニア.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.ru.freebsd.org/"> + http://www.ru.freebsd.org/</ulink> + — ロシア/1.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www2.ru.freebsd.org/"> + http://www2.ru.freebsd.org/</ulink> + — ロシア/2.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www3.ru.freebsd.org/"> + http://www3.ru.freebsd.org/</ulink> + — ロシア/3.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www4.ru.freebsd.org/"> + http://www4.ru.freebsd.org/</ulink> + — ロシア/4.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.sk.freebsd.org/"> + http://www.sk.freebsd.org/</ulink> + — スロバキア.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.si.freebsd.org/"> + http://www.si.freebsd.org/</ulink> + — スロベニア.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.es.freebsd.org/"> + http://www.es.freebsd.org/</ulink> + — スペイン.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.za.freebsd.org/"> + http://www.za.freebsd.org/</ulink> + — 南アフリカ/1.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www2.za.freebsd.org/"> + http://www2.za.freebsd.org/</ulink> + — 南アフリカ/2.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.se.freebsd.org/"> + http://www.se.freebsd.org/</ulink> + — スウェーデン.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.tr.freebsd.org/"> + http://www.tr.freebsd.org/</ulink> + — トルコ.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.ua.freebsd.org/"> + http://www.ua.freebsd.org/</ulink> + — ウクライナ/1.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www2.ua.freebsd.org/"> + http://www2.ua.freebsd.org/</ulink> + — ウクライナ/2.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www.uk.freebsd.org/"> + http://www.uk.freebsd.org/</ulink> + — イギリス.</para> + </listitem> + + <listitem> + <para><ulink URL="http://freebsd.advansys.net/"> + http://freebsd.advansys.net/</ulink> + — アメリカ/インディアナ.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www6.freebsd.org/"> + http://www6.freebsd.org/</ulink> + — アメリカ/オレゴン.</para> + </listitem> + + <listitem> + <para><ulink URL="http://www2.freebsd.org/"> + http://www2.freebsd.org/</ulink> + — アメリカ/テキサス.</para> + </listitem> + </itemizedlist> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/hw/chapter.sgml b/ja_JP.eucJP/books/handbook/hw/chapter.sgml new file mode 100644 index 0000000000..17e64ae5dc --- /dev/null +++ b/ja_JP.eucJP/books/handbook/hw/chapter.sgml @@ -0,0 +1,6230 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.12 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:59 kuriyama Exp $ +--> + +<chapter id="hw"> + <title>PC ハードウェアコンパチビリティ</title> + + <para><emphasis>訳: &a.jp.yoshiaki;. <!-- <br> --> + 23 March 1998. </emphasis></para> + + <para>ハードウェアコンパチビリティの問題は現在の + コンピュータ業界でもっ とも多く起きる種類の問題であり, + FreeBSDもこれに無縁ではありません. + 市場にある驚くほど多様な種類の製品をサポートしたことで, + 安価に普及し ている PCハードウェアで動かすことができるという + FreeBSDの利点はこの 点では不利でもあります. + FreeBSDのサポートするハードウェアを徹底的に調べて提供することは不 + 可能ですが, このセクションでは + FreeBSDに含まれるデバイスドライバとそ + のドライバがサポートするハードウェアのカタログを示します. + 可能で適切 なものについては特定の製品についての注釈を含めました. + また, このハンドブックの <link + linkend="kernelconfig-config">コンフィグレーション + ファイル</link> のセクションにも + サポートされているデバイスのリストがありますので + そちらもご覧ください.</para> + + <para>FreeBSD + はボランティアプロジェクトでテスト部門には資金がありません から, + より多くの情報をこのカタログに載せるにはあなたがたユーザに + 頼らなければなりません. あなた自身の経験により, + あるハードウェアが + FreeBSDで動くか動かないかがわかったとしたら&a.doc; へ + e-mailして知らせてください. サポートされているハードウェアについて + の質問は, &a.questions;(詳しいことは <link + linkend="eresources-mail">メーリングリスト</link> + を参照してください) へ 宛ててください. + 情報を提供したり質問をする時は FreeBSDのバージョンと使っ + ているハードウェアのできるだけ詳しい情報を含めることを + 忘れないでくだ さい.</para> + + <sect1> + <title>インターネット上のリソース</title> + + <para>以下のリンクはハードウェアを選ぶのに役に立ちます. + FreeBSDに対して は必要のない (あるいは適用できない) + ように見えるかもしれませんが, ここ + からのハードウェアの情報のほとんどは OSに依存しないものです. + 購入をする前にはあなたの選んだものがサポートされているか + FreeBSDハード ウェアガイドを注意して読んでください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="http://www.tomshardware.com/">Toms's Hardware & Performance Guide</ulink></para> + </listitem> + </itemizedlist> + + <para>訳注: 日本国内でFreeBSDの動くハードウェアの情報を提供してい + るWWWサーバがあります.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="http://freebsd.chem.nagoya-u.ac.jp/~ugoita/">FreeBSD POWERED hardwares</ulink></para> + </listitem> + </itemizedlist> + + <para>これ以外にも情報を提供しているサーバはあります. いくつかの + URLについて は<ulink URL="http://www.jp.freebsd.org">FreeBSD + Japan.</ulink> からたどることができます.</para> + </sect1> + + <sect1 id="hw-configs"> + <title>組合せの見本</title> + + <para>以下のハードウェアの組合せのサンプルリストは + ハードウェアベンダや <emphasis>FreeBSD + プロジェクト</emphasis>が保証するものではありません. この情 + 報は公共の利益のために公開しているものであり, + 極めて数多くあるであろう + 異なったハードウェアの組合せの中からのある経験の + カタログに過ぎません. やり方はいろいろあります. + 場合によってはうまく行かないこともあります. + 十分気をつけてください.</para> + + <sect2 id="hw-jordans-picks"> + <title>Jordan氏の選んだ組合せ</title> + + <para>私の作ったワークステーションとサーバの構成は + まずまずうまく行っ ています. + 私はこれを保証できるわけでもありませんし, ここにあげた組 + 合せがずっと “best buys”であるわけではありません. + 私はできればリス + トを更新して行きますがそれがいつになるかはわかりません.</para> + + <para>訳注: &a.jkh; 氏は FreeBSDプロジェクト <link + linkend="staff-core">FreeBSD + コアチーム</link>のメンバです.</para> + + <sect3 id="hw-mb"> + <title>マザーボード</title> + + <para>Pentium Pro (P6)システム用で気に入っているのは <ulink + URL="http://www.tyan.com/html/products.html">Tyan</ulink> + S1668 デュアルプロセッサマザーボードです. これは Intel + PR440FX 同様 オンボードの WIDE SCSI と 100/10MB Intel + Etherexpress NIC が ついています. + これを使えば最高の小型のシングルあるいは + デュアルプロセッサシステム (FreeBSD + 3.0ではサポートされています)を作ることができます. Pentium + Pro 180/256K チップの価格は非常に安くなっていますが, + いつまで手にはいるかはわかりません..</para> + + <para>Pentium II には, どちらかと言えばひいき目ですが, Adaptec + SCSI WIDE コントローラのついた <ulink + URL="http://www.asus.com.tw">ASUS</ulink> <ulink + URL="http://www.asus.com.tw/Products/Motherboard/Pentiumpro/P2l97-s/index.html">P2l97-S</ulink> マザーボードです.</para> + + <para>For Pentium machines, the ASUS <ulink + URL="http://www.asus.com.tw/Products/Motherboard/Pentium/P55tp4/index.html">http://www.asus.com.tw/Products/Motherboard/Pentium/P55tp4/index.html</ulink> + はミッドレンジからハイエンドの Pentium + サーバあるいはワークステーションシステムには + よい選択です. </para> + + <para>フォルトトレラントシステムを構築したいのであれば + パリティメモリを 使い, + 真に24時間/週7日間動作させ続けるアプリケーションであれば + ECCメモリを使うべきでしょう.</para> + + <note> + <para>ECCメモリはいくらか性能のトレードオ フがあります + (それが重要なものであるかそうでないかはあなたのアプ + リケーションによりますが). しかし, + メモリエラーに対しては明らかに + フォルトトレランス性が強化されます.</para> + </note> + </sect3> + + <sect3> + <title>ディスクコントローラ</title> + + <para>これはいくらかトリッキーです. 私は ISAから + PCIまですべてコンパチブ ルな <ulink + URL="http://www.buslogic.com">Buslogic</ulink> コント + ローラを使うようにすすめていましたが, 現在では ISAでは + <ulink URL="http://www.adaptec.com">Adaptec</ulink> 1542CF, + EISA では Bt747c, PCIでは Adaptec 2940UW + をすすめるよう変わってきています.</para> + + <para>NCR/Symbios の + PCIカードも私のところではうまく動いています, ただ し + BIOS-less モデルのボード(SCSI ボード上に ROMらしいものがない + 場合は, マザーボード上に SCSIアダプタのための BIOSが必要な + ボードである可能性があります 訳注: SC-200など) + を使うのであれば + マザーボードがそれをサポートしているかどうか + 注意しなくてはなりま せん.</para> + + <para>PCIマシンで2つ以上の + SCSIコントローラが必要となるのであれば, + PCIバスの不足を防ぐために Adaptec 3940 + カードを考えてもいいでしょ う. これは1つのスロットで2台の + SCSIコントローラ(と内部バス)を持ち ます.</para> + + <note> + <para> + ます. 市場には2つのタイプの 3940 がありますので + 注意しましょう. — 古いモデルでは AIC 7880 + チップを使っていますが, 新しいモデルでは AIC 7895 + を使っています. 新しいモデルでは <ulink + url="http://www.freebsd.org/pub/FreeBSD/development/cam/"> CAM </ulink> + ドライバのサポートが必要です. + これはまだ FreeBSD の一部では ありません. + 自分で付け加えるか, CAM binary snapshot リリースから + インストールする必要があります(URLを参照してください). + </para> + </note> + </sect3> + + <sect3 id="hw-disks"> + <title>ディスクドライブ</title> + + <para>私は, 極々特殊な状況を除いて + “それだけのお金をかけることができる なら SCSIは + IDEよりもよい” と言っています. + 小規模なデスクトップ構成 のシステムでも, + SCSIであればディスクが安くなっていった時にサーバの + (古い入れ換えた) + ディスクを比較的簡単に移し替えることができます. あ + なたが複数のマシンの管理をしているのであれば単純に + 容量について考え るのではなく, 食物連鎖のように考えましょう. + 重要なサーバの場合は議論の余地はありません. + SCSI機器と品質の良いケーブルを使いましょう. </para> + </sect3> + + <sect3 id="hw-jordans-picks-cdrom"> + <title>CDROM ドライブ</title> + + <para>私は SCSIの方が好みであるのでもちろん SCSI + CDROMを選びました. <ulink + URL="http://www.toshiba.com">東芝</ulink> のドライブは + 常に(スピードがどうであっても)お気に入りでしたが, 古い + <ulink URL="http://www.plextor.com">Plextor</ulink> PX-12CS + ドライブも好きです. 高々 12倍速のドライブですが, + 高い性能と信頼性を提供して くれています.</para> + + <para>一般的には, 大部分の SCSI CDROM + ドライブは私の見た限りではほと んどしっかりした構造ですので + 多分 HPや NECの SCSI CDROMでも問題が起き + ることはないでしょう. SCSI CDROM + の価格はここ数ヶ月でかなり下落したよ うで, 技術的に + 優れた方法でありながら 現在では IDE CDROMと同じ程度の価 + 格になって います. もし IDE と SCSI の CDROM + ドライブの間で選択す ることができるのなら, 特に IDE + を選ぶ理由はないでしょう.</para> + </sect3> + + <sect3 id="hw-worm"> + <title>CD-R (CD Recordable: WORM) ドライブ</title> + + <para>この原稿を書いている時点で, FreeBSDは 3種類の + CDRドライブ (私は これらすべては結局は + Phillips社のドライブであるのではない かと考えているのですが) + をサポートしています : Phillips CDD 522 (Plasmon + のドライブと同様の動作をします), PLASMON RF4100, HP 6020i + です. 私は HP 6020i を CDROMを焼くのに使っています(2.2 + 以降の システムで動きます. — それ以前のリリースの + SCSIコードでは動きません). 非常に調子よく動いています. + システムの <ulink + URL="file:/usr/share/examples/worm">/usr/share/examples/worm</ulink> + を見てください. + ISO9660ファイルシステムイメージ (RockRidge拡張) + を作 るスクリプトと それを HP6020i CDR + で焼くためのスクリプトの例があり ます.</para> + </sect3> + + <sect3 id="hw-tape"> + <title>テープドライブ</title> + + <para>私はたまたま <ulink + URL="http://www.exabyte.com">Exabyte</ulink> の <ulink + URL="http://www.Exabyte.COM:80/Products/8mm/8505XL/Rfeatures.html">8mm drives</ulink> と <ulink URL="http://www.hp.com">HP</ulink>の <ulink URL="http://www-dmo.external.hp.com:80/tape/_cpb0001.htm">4mm (DAT)</ulink> を持っています.</para> + + <para>バックアップのためであれば, より本質的に丈夫な (また, + より容量が大きい) Exabyteの + 8mmテープの方がおすすめできます.</para> + </sect3> + + <sect3 id="hw-video"> + <title>ビデオカード</title> + + <para>もし (米国では) 99USドルをかけて商品の Xサーバを<ulink + URL="http://www.xig.com/">Xi Graphics, Inc. (以前の X + Inside, Inc.)</ulink>から買うことができる なら間違いなく + <ulink URL="http://www.matrox.com/">Matrox</ulink> <ulink + URL="http://www.matrox.com/mgaweb/brochure.htm">Millenium + II</ulink>カードをおすすめします. + このカードは無償提供されている <ulink + URL="http://www.xfree86.org">XFree86</ulink> + (現在のバージョンは 3.3.2です) + のサーバでも非常によく動きます.</para> + + <para><ulink URL="http://www.nine.com/">Number 9</ulink>の S3 + Vision 868と 968 ベースのカード (the 9FX series) + はわりあいと速く, <ulink + URL="http://www.xfree86.org">XFree86</ulink>の S3サーバで + うまくサポートされています, 加えて現在では非常に低価格です. + まず問題も起きないでしょう. </para> + </sect3> + + <sect3 id="hw-monitors"> + <title>モニタ</title> + + <para>私の持っている <ulink + URL="http://cons3.sel.sony.com/SEL/ccpg/display/ms17se2.html">Sony Multiscan 17seII monitors</ulink> + は非常に調子がいいので, 同じ (トリニトロン) + ブラウン管を使っている Viewsonic をおすすめします. + 17"よりも 大きなモニタ, 例えば 21" + のモニタが実際に必要だとしたらこの文章の執筆時点では + 2,000USドル以下のもの (20"のモニタでは 1,700USドル以下のもの) + はまったくすすめられません. + 20" 以上のク ラスでよいモニタは(いくつも) ありますし, + 20" クラスで安いモニタもあり ます. + うまくいかないことに安くてよいモニタはほとんどありません! + </para> + </sect3> + + <sect3 id="hw-networking"> + <title>ネットワーキング</title> + + <para>まず最初に, Intel EtherExpress Pro/100B + カードをすすめます. ISA カードでは <ulink + url="http://www.smc.com/">SMC</ulink> Ultra 16 + コントローラ, いくらか安めのPCIベースのカード では SMC + 9392DST, SMC EtherPower と Compex ENET32カードがおすすめ + できます. 一般的に DECの DC2104x + イーサネットコントローラチップを 使っている Zynx ZX342 や + DEC DE435 などのカードはうまく動く でしょうし, (firewall や + roouter に便利な) 2-port 品や 4-port 品を + よく見つけることができますが, Pro/100B カードは最も少ない + オーバーヘッドで最高の性能を出すでしょう.</para> + + <para>もう一方, + できるだけ低コストでそこその性能で動くものを探しているなら, + ほとんどの NE2000のクローンは極めて低価格で + うまく動いてくれます. </para> + </sect3> + + <sect3 id="hw-serial"> + <title>(特殊な) シリアル</title> + + <para>高速のシリアル ネットワーク インタフェース + (同期シリアルカード) を探しているのであれば <ulink + URL="http://www.dgii.com/">Digi International</ulink>製の + <ulink + URL="http://www.dgii.com/prodprofiles/profiles-prices/di + giprofiles/digispecs/sync570.html">SYNC/570</ulink> + シリーズのド ライバが今の FreeBSD-currentにあります. <ulink + URL="http://www.etinc.com">Emerging Technologies</ulink> + も 提供 するソフトウェアにより T1/E1 + の性能が得られるボードを製造しています. + もっとも私が直接これらの製品を動かした + 経験があるわけではありません.</para> + + <para>訳注:Emerging TechnologiesのWeb + ページを見るとカードのスペックに Operating Systems: MS-DOS, + MS-WINDOWS, System V UNIX, BSD/OS, FreeBSD, NetBSD and Linux + と書いてあります. また "BSD/OS, FreeBSD and LINUX Router + Card Solutions" というページ + もあってサポートは良さそうです.</para> + + <para>マルチポートカードの選択の幅はかなり広いですが, + FreeBSDがサポー トするいう点では <ulink + URL="http://www.cyclades.com/"> Cyclades</ulink> + の製品が最も信頼できるでしょう. この最大の理由はこ + の会社が私たちに十分な評価用ボードとスペックを + 供給することを約束し てくれているからです. 私は Cyclom-16Y + が最高の性能価格比であると聞 + いていましたが最近は価格のチェックはしていません.</para> + + <para>訳注: cycladesの WWWサーバでも Supported Operating + Systemsに Linuxや BSDi, FreeBSD が明記されています.</para> + + <para>他のマルチポートカードで評判がよいのは BOCAおよび + ASTのカードと <ulink + URL="http://www.stallion.com/">Stallion + Technologies</ulink>で, このカードには <ulink + URL="ftp://ftp.stallion.com/drivers/unsupported/freebsd/s + talbsd-0.0.4.tar.gz">ここ</ulink> + で非公式なドライバが提供されてい るようです.</para> + </sect3> + + <sect3 id="hw-audio"> + <title>オーディオ</title> + + <para>私は現在 <ulink URL="http://www.creaf.com/">Creative + Labs</ulink> AWE32 を 使っています. + もっともクリエイティブラボ製品が現在一般的にうまく + 動いているから, ということにすぎませんが. + 他のタイプのサウンド + カードは同様にうまくは動かないと聞いています. 単に私の経験が + 乏しいということにすぎないと言うことなのかも知れませんが. + (私は以前は GUS のファンでしたが, Gravis はサウンドカード + から撤退してしまいました).</para> + </sect3> + + <sect3 id="hw-vgrabbers"> + <title>ビデオキャプチャー</title> + + <para>ビデオキャプチャーについては2つのいい選択肢があります + — Hauppage や WinTV などの Brooktree BT848 + チップベースのボードは FreeBSD で 非常にうまく動きます. + もう一つの動作するボードは <ulink + URL="http://www.matrox.com/">Matrox</ulink> <ulink + URL="http://www.matrox.com/imgweb/meteor.htm">Meteor + </ulink> カードです. FreeBSD はクリエィティブラボの古い + video spigotカードの + サポートはしていますがこれは見つけるのは非常に + むずかしいでしょう. Meteor は 440FX + チップセットベースのマザーボードでは + <emphasis>動きません</emphasis>ので注意してください. + 詳細は<link + linkend="hw-mb">マザーボード</link>の節を参照してください. + このような場合には BT848 ベースの + ボードを使った方がよいでしょう.</para> + </sect3> + </sect2> + </sect1> + + <sect1 id="hw-core"> + <title>中心部/プロセッサ</title> + <para></para> + + <sect2> + <title>マザーボード, バス, チップセット</title> + + <sect3> + <title>* ISA</title> + + <para></para> + </sect3> + + <sect3> + <title>* EISA</title> + + <para></para> + </sect3> + + <sect3> + <title>* VLB</title> + + <para></para> + </sect3> + + <sect3 id="hw-mb-pci"> + <title>PCI</title> + + <para><emphasis>原作: &a.obrien; 投稿者: &a.rgrimes;.<!-- <br> --> + 25 April 1995.</emphasis></para> + + <para><emphasis>更新: &a.jkh;.</emphasis><!-- <br> -->最終更新 + <emphasis>26 August 1996.</emphasis></para> + + <para><emphasis>訳: &a.jp.yoshiaki;.<!-- <br> --> + 12 October 1996.</emphasis></para> + + <para>Intelの PCIチップセットについて, 以下にさまざまな種類 + の既知の不具合と問題の程度のリストを示します.</para> + + <variablelist> + <varlistentry><term>Mercury:</term> + <listitem> + <para>ISAバスマスタがISAとPCIブリッジの向 + こう側にある場合は,キャッシュコヒーレンシ(一貫性)の + 問題があります. このハードウェア欠陥に対処してうま + く動かす方法はキャッシュを + offにする以外にはありません.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Saturn-I <emphasis> + (82424ZX の rev 0, 1 ,2)</emphasis>:</term> + <listitem> + <para>ライトバックキャッシュのコヒーレンシに + 問題があります. + このハードウェア欠陥に対処してうまく動かす方法は + 外部キャッ + シュをライトスルーにすること以外にはありませ ん. + Saturn-IIにアップデートしましょう.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Saturn-II <emphasis> + (82424ZX の rev 3 or 4)</emphasis>:</term> + <listitem> + <para>問題なく動きます. + ただし多くのマザーボードではライトバッ ク動作に必要な + 外部ダーティビット SRAMが実装されていま せん. + 対策としてはライトスルーモードで動かすか, ダーティ + ビット SRAMをインストールするかがあります. (これは + ASUS PCI/I-486SP3G の rev 1.6 + 以降で使われています)</para> + </listitem> + </varlistentry> + + <varlistentry><term>Neptune:</term> + <listitem> + <para>2つより多くの(3台以上の)バスマスタデ + バイスを動かすことができません. Intelは設計の欠陥を + 認めています. 2つを越えるバスマスタを許さない, 特別な + 設計のハードウェアで PCIバスアービタを置き換えることに + より解決されています. (Intelの Altair boardや他にはい + くつかの Intelサーバグループマザーボードに見られます). + そして, もちろん Intelの公式の回答は Triton + チップセットへの 移行で, + “こちらでは修整した”ということです.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Triton <emphasis>(430FX)</emphasis>:</term> + <listitem> + <para>知られているキャッシュコヒーレンシ + やバスマスタの問題はありませんがパリティチェック機能が + ありません. パリティを使いたいような場合は, 可能であ + れば Triton-II + ベースのマザーボードを選びましょう.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Triton-II <emphasis>(430HX)</emphasis>:</term> + <listitem> + <para>このチップセット + を使っているマザーボードに関するすべての + 報告によれば今の ところ好評です. + 既知の問題はありません.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Orion:</term> + <listitem> + <para>このチップセットの初期のバージョンでは PCI + write-posting にバグがあり, 大量の PCIバストラフィッ + クのあるアプリケーションでは性能の著しい低下があるとい + う障害がありました. B0以降のリビジョンのチップセットで + は問題は解決されています.</para> + </listitem> + </varlistentry> + + <varlistentry><term> + <ulink URL="http://developer.intel.com/design/pcisets/desktop.htm#440FX">440FX</ulink>:</term> + <listitem> + <para>これは <ulink + URL="http://www.intel.com/procs/ppro/index.htm"> + Pentium Pro</ulink> に対応したチップセットで, + 初期の Orion チップセットにあったような問題は見られず, + 問題なく動 いているようです. + また, これは ECCやパリティを含んだ広い + 種類のメモリに対応しています. + 既知の問題は Matrox Meteor + ビデオキャプチャカードに関するものだけです.</para> + </listitem> + </varlistentry> + </variablelist> + </sect3> + </sect2> + + <sect2> + <title>CPU/FPU</title> + + <para><emphasis>原作 &a.asami;.<!-- <br> --> + 27 December 1997.</emphasis></para> + + <sect3> + <title>P6 クラス (Pentium Pro/Pentium II)</title> + + <para>Pentim Pro, Pentim IIとも + FreeBSDで使うのに全く問題はありません. 実際, 私たちのメイン + FTPサイトである <ulink + URL="ftp://ftp.freebsd.org/">ftp.freebsd.org</ulink> + (世界一大きな FTPサイト "<filename>ftp.cdrom.com</filename>" + としても知られています) では Pentium Proで + FreeBSDを使っています. 詳しいことが知りたい人は, <ulink + URL="ftp://ftp.cdrom.com/archive-info/wcarchive.txt"> + コンフィグレーション</ulink> へどうぞ.</para> + </sect3> + + <sect3> + <title>Pentium クラス</title> + + <para>Intel Pentium (P54C), Pentium MMX (P55C), AMD K6と + Cyrix/IBM 6x86MXプロセッサは全て + FreeBSDで動作確認がされています. どの + CPUが速いかということはここでは述べません. + インターネットを探せばあれが + 速いとかこっちの方がいいとか教えてくれるサイトは + いっぱいありますので, そちらをご覧ください. <!-- smiley + --><emphasis>:)</emphasis></para> + + <note> + <para>一つ注意しないといけないのは, CPU + によって必要な電源電圧や冷却の仕様が 異なるということです. + マザーボードが指定された電圧を供給できることを + 必ず確認しましょう. 例えば, 最近の + MMX チップにはコアと入出力で違う電圧を使うもの (コア 2.9V, + 入出力 3.3V など) がたくさんあります. また, AMDと + Cyrix/IBMのチップには + Intelの製品より熱くなるものがいくつかあります. + その場合には強力なヒートシンク/ファンを使いましょう. + (各社のホームページにお勧めの部品のリストがあります.) + </para> + </note> + + <sect4> + <title>クロックスピード</title> + + <para><emphasis>原作 &a.rgrimes;.<!-- <br> --> + 1 October 1996.</emphasis></para> + + <para><emphasis>更新 &a.asami;.<!-- <br> --> + 最終更新 27 December 1997.</emphasis></para> + + <para>Pentium クラスのマシンはシステムの + いくつかの部分で異なったクロックスピードを使っています. + これは CPU, 外部メモリバス, PCIバスです. + 別々のクロックスピードが使われるために“高速な” + CPUを使ったシステムが “低速な” + システムよりも必ずしも速いとは限りません. + それぞれの場合の違いを以下の表に示します.</para> + + <informaltable frame="none"> + <tgroup cols="4"> + <thead> + <row> + <entry>CPUクロック MHz</entry> + <entry>外部クロックとメモリバス MHz</entry> + <entry>外部クロックと内部クロックの比</entry> + <entry>PCIバスクロック MHz</entry> + </row> + </thead> + + <tbody> + <row> + <entry>60</entry><entry>60</entry> + <entry>1.0</entry><entry>30</entry></row> + <row> + <entry>66</entry><entry>66</entry> + <entry>1.0</entry><entry>33</entry></row> + <row> + <entry>75</entry><entry>50</entry> + <entry>1.5</entry><entry>25</entry></row> + <row> + <entry>90</entry><entry>60</entry> + <entry>1.5</entry><entry>30</entry></row> + <row> + <entry>100</entry><entry>50</entry> + <entry>2</entry><entry>25</entry></row> + <row> + <entry>100</entry><entry>66</entry> + <entry>1.5</entry><entry>33</entry></row> + <row> + <entry>120</entry><entry>60</entry> + <entry>2</entry><entry>30</entry></row> + <row> + <entry>133</entry><entry>66</entry> + <entry>2</entry><entry>33</entry></row> + <row> + <entry>150</entry><entry>60</entry> + <entry>2.5</entry><entry>30 (Intel, AMD)</entry></row> + <row> + <entry>150</entry><entry>75</entry> + <entry>2</entry><entry>37.5 (Cyrix/IBM 6x86MX)</entry></row> + <row> + <entry>166</entry><entry>66</entry> + <entry>2.5</entry><entry>33</entry></row> + <row> + <entry>166</entry><entry>66</entry> + <entry>2.5</entry><entry>33</entry></row> + <row> + <entry>180</entry><entry>60</entry> + <entry>3</entry><entry>30</entry></row> + <row> + <entry>200</entry><entry>66</entry> + <entry>3</entry><entry>33</entry></row> + <row> + <entry>233</entry><entry>66</entry> + <entry>3.5</entry><entry>33</entry></row> + </tbody> + </tgroup> + </informaltable> + + <note> + <para>66 MHz は実際には 66.667 MHzかもしれませんが, + そうだと決まっているわけでもありません.</para> + + <para>Pentium 100 は 50MHzの外部クロックの 2 + 倍または 66MHz の 1.5 倍の両方で + 動かすことができます.</para> + </note> + + <para>3 倍クロック以上の CPU ではメモリアクセス速度が + 不足気味であるという点には注意していただきたいですが, + 上の表を見るかぎりでは 100, 133, 166, 200, 233 + MHzを使うのが最良だというのがわかります.</para> + </sect4> + + <sect4> + <title>AMD K6のバグ</title> + + <para>AMDの K6プロセッサで大きなコンパイルをすると, + セグメンテーションフォルトで + プロセスが落ちることがあるという事例が + 1997年に多数報告されました. これは + '97年の第3四半期に直ったようです. 情報を総合すると, + チップ上の製造年週が “9733” (97年の + 第33週に製造) + 以降のものは大丈夫ということのようです.</para> + </sect4> + </sect3> + + <sect3> + <title>* 486 クラス</title> + + <para></para> + </sect3> + + <sect3> + <title>* 386 クラス</title> + + <para></para> + </sect3> + + <sect3> + <title>286 クラス</title> + + <para>FreeBSDは 80286マシンでは動きません. 現在の巨大なフ + ルスペックの + UNIXをこのようなハードウェアで動かすことはほとんど + 不可能でしょう.</para> + </sect3> + </sect2> + + <sect2> + <title>メモリ</title> + + <para>FreeBSDをインストールするのに最低限必要なメモリ量は 5 + MBです. いったんシステムが起動して<link + linkend="kernelconfig-building">カスタムカーネルを + 作る</link>ことができるならば, もっと少ないメモリ + で動かすこともできます. <filename>boot4.flp</filename> + を使えば 4 MB しかメモリがなく + てもインストールできます.</para> + </sect2> + + <sect2> + <title>* BIOS</title> + + <para></para> + </sect2> + </sect1> + + <sect1 id="hw-io"> + <title>入力/出力デバイス</title> + + <sect2> + <title>* ビデオカード</title> + + <para></para> + </sect2> + + <sect2> + <title>* サウンドカード</title> + + <para></para> + </sect2> + + <sect2> + <title>シリアルポートとマルチポートカード</title> + + <sect3 id="uart"> + <title>UART とは何か, そしてどのように動作するか</title> + + <para><emphasis>Copyright © 1996 &a.uhclem;, + All Rights Reserved.<!-- <br> --> + 13 January 1996.</emphasis></para> + + <para><emphasis>訳: &a.jp.saeki;, &a.jp.iwasaki;.<!-- <br> --> + 11 November 1996.</emphasis></para> + + <para>( ここからは &a.jp.saeki; が翻訳を担当)</para> + + <para>汎用非同期送受信コントローラ (UART) + はコンピュータのシリアル通信 サブシステムの鍵となる部品です. + UART は何バイトかのデータを受けとり, これを 1 + ビットずつ順番に送信します. 受信側では, もう一つの UART が + このビット列を完全なバイト列に組み立て直します.</para> + + <para>シリアル転送は, + モデムやコンピュータ間の非ネットワーク型の通信, + ターミナルその他のデバイスで広く使われています.</para> + + <para>シリアル転送には主に同期と非同期という + 二つの形式があります: 通信サブシステムの名前は, + そのハードウェアでサポートされている + 通信モードによって変化します. 通常, + 非同期通信をサポートしているものは文字 <literal>A</literal> + を含み, 同期通信をサポートしているものは文字 + <literal>S</literal> を含みます. + 以下で両方の形式について詳しく説明します.</para> + + <para>通常使われている略号は以下の通りです: + <blockquote> + <para>UART 汎用非同期送受信装置 (Universal + Asynchronous Receiver/Transmitter)</para> + </blockquote> + + <blockquote> + <para>USART 汎用同期-非同期送受信装置 (Universal + Synchronous-Asynchronous Receiver/Transmitter)</para> + </blockquote></para> + + <sect4> + <title>同期シリアル転送</title> + + <para>同期シリアル転送では, + 送信側と受信側がクロックを共有している 必要があります. + さもなければ, 送信側がストローブまたは + その他のタイミング信号を供給して, + 受信側にデータの次のビットを いつ“読み込” + めばよいのかを知らせる必要があります.</para> + + <para>ほとんどの同期シリアル通信では, + 常に何らかのデータが転送され続けます. そのため, + 転送のタイミングまでに送信データが用意できていなければ, + 通常のデータのかわりに「埋め草」 (fill character) + が送られます. 同期通信では, + 送信側と受信側との間でデータビットのみが転送されるため, + 同じビット速度の非同期シリアル通信に比べて効率的です. + しかし, + 送信側と受信側でクロック信号を共有するために余分な電線と + 回路が必要となる場合には, + よりコスト高となる可能性があります.</para> + + <para>プリンタやハードディスクでも同期転送の + 一種が使用されています. このときデータが 1 + 組みの電線で送られる一方, クロック信号または + ストローブ信号が別の電線で送られます. + プリンタやハードディスクは通常, + シリアルデバイスではありません. + ほとんどのハードディスクのインターフェース規格では, + データを送るための + 線とは別にクロックまたはストローブ信号を + 送るための線を持っていて, ストローブ 1 + 回毎に一つのデータ全体を送ります. PC 産業界では, + これらはパラレルデバイスとして知られています.</para> + + <para>PC の標準的なシリアル通信ハードウェアは, + 同期モードをサポートして いません. + ここで同期モードについて述べたのは, 非同期モードとの + 比較のために過ぎません.</para> + </sect4> + + <sect4> + <title>非同期シリアル転送</title> + + <para>非同期転送は, + 送信側がクロック信号を受信側に送らなくても + データを転送することができます. そのかわり, + 送信側と受信側は + あらかじめタイミングパラメータや同期のために追加される + 特別なビットについて + 取り決めをおこなっておかなければなりません.</para> + + <para>非同期転送をおこなうために UART + にデータが与えられると, 「スタートビット」 + と呼ばれるビットが転送データの先頭に追加されます. + スタートビットはデータの転送開始を受信側に + 知らせるために使われ, + これにより受信側のクロックを送信側のクロックに + 同期させます. この二つのクロックは, + 転送データの残りのビットを転送する間に 10% + 以上ふらつかないように正確なものでなければなりません. + (この条件は機械式テレタイプの時代に定められたものなので, + 現代の電子装置であれば容易に満足させることができます). + </para> + + <para>スタートビットが送られた後, データの各ビットが最下位 + (LSB) から 順番に送られます. + 転送されるビットの長さはすべて同じになっていて, + 受信側はそれぞれのビットの中央部でそれが + <literal>1</literal> か <literal>0</literal> + かを判断します. 例えば, 仮に 1 ビットを送るのに 2 + 秒かかるとすると, 受信側は + スタートビットの始まりを認識した 1 秒後に信号が + <literal>1</literal> か <literal>0</literal> かを調べ, + その後 2 + 秒ごとに次のビットの値を調べるという動作を繰り返します. + </para> + + <para>送信側は, いつ受信側がビットの値を “見た” + のかはわかりません. 送信側はクロックにしたがって + 次々にビットを転送するだけです.</para> + + <para>設定によっては, 1 ワードのデータ全体が送られたあとに + 送信側が内部で生成したパリティビットを + 付加する場合があります. + パリティビットは受信側で簡単なエラーチェックを + するために使われます. その後に, 最低でも 1 + ビットのストップビットが送られます.</para> + + <para>1 ワードのすべてのビットを受信すると, + 受信側がパリティビットの + チェックをおこなうように設定することができます. + (パリティビットを 使用するかどうか, + 送信側と受信側であらかじめ取り決めておかなければ + なりません). + それから受信側はストップビットをチェックします. + もしもストップビットが期待通りの位置に存在しなければ, UART + は 転送エラーが発生したと判断して, + ホストがデータを読もうとした時に + フレーミングエラーが起きたと報告します. 通常, + フレーミングエラーは + 送信側と受信側のクロックが一致していなかったり, + 信号に割り込みが 入った時に起こります.</para> + + <para>データが正しく受信されたかどうかにかかわらず, UART + はスタート, パリティ, ストップビットを自動的に捨てます. + 送信側と受信側で設定が正しく一致していれば, + これらのビットが + 誤ってホストに転送されることはありません.</para> + + <para>1 + 回の転送が終了する前に次のデータの転送準備ができていれば, + 前のデータのストップビットを送った後, 間を空けずに + 次のデータのスタートビットを送ることができます.</para> + + <para>非同期転送データは“自己同期”なので, + 転送するべきデータがない場合は + 転送路は空き状態になります.</para> + </sect4> + + <sect4> + <title>UART のその他の機能</title> + + <para>転送のためにデータをパラレルからシリアルに変換し, + 受信時に + シリアルからパラレルに戻すという基本的な機能の他に, UART + は通常, 転送路の状態を示したり, + リモートデバイスで次のデータを受けとる準備が + できていない場合にデータの流れを抑制するのに + 使われる信号のための 付加回路も持っています. 例えば UART + に接続されているデバイスがモデムの場合, モデムは + 回線上に搬送波 (carrier) + が存在していることを報告するかもしれません. 一方, + コンピュータはこれらの付加信号を操作することにより + モデムのリセットをおこなったり, + かかってきた電話を取らないように + モデムに指示するかもしれません. + これらの付加信号の機能はそれぞれ EIA RE232-C + 規格で定義されています.</para> + </sect4> + + <sect4> + <title>RS-232C と V.24 規格</title> + + <para>ほとんどのコンピュータシステムでは, UART は EIA + RS-232C 規格に + 準拠した信号を生成するための回路に接続されています. また, + RS-232C の仕様を反映した, V.24 という CCITT 規格に + 準拠したシステムも存在しています.</para> + + <sect5> + <title>RS-232C のビット割り当て (マークとスペース)</title> + + <para>RS-232C では, <literal>1</literal> + の値を<literal>マーク</literal>, <literal>0</literal> + の値を<literal>スペース</literal>と 呼びます. + 通信路にデータが流れていない時, + 回線は“マーキング” であるとか, + <literal>1</literal> + の値を連続して転送し続けているとか言われます.</para> + + <para>スタートビットは常に <literal>0</literal> (スペース) + で, ストップビットは常に <literal>1</literal> (マーク) + です. このことは, + たとえ複数のデータが連続して転送されている場合でも, + それぞれのデータの転送開始時には必ず, マーク (1) から + スペース (0) + への遷移が回線上で起こるということを意味しています.</para> + + <para>これによって, + 転送されるデータビットの内容にかかわらず, + 送信側と受信側の + クロックを同期させることができるのです.</para> + + <para>ストップビットとスタートビットの間の空き時間は, + その通信路で 1 + ビットを転送するのに必要な時間の正確な倍数である + 必要はありません. (倍数にはゼロを含みます). しかし, + ほとんどの UART では 設計の単純化のために, + 倍数になるように設計されています.</para> + + <para>RS-232C では, 「マーク」信号 (<literal>1</literal>) + は -2V から -12V の間の電圧で, 「スペース」信号 + (<literal>0</literal>) は 0V から +12V + の間の電圧で示されます. 送信部は +12V または -12V + を送ることになっていて, 受信部では + 長いケーブルによるいくらかの電圧ロスを + 許容するように定められています. + (ポータブルコンピュータなどで使用されている) + 低消費電力デバイスの 送信部では しばしば +5V と -5V + のみを使用していますが, 短いケーブルを使用するならば, + これらの電圧も RS-232C 受信部の + 許容範囲に入っています.</para> + </sect5> + + <sect5> + <title>RS-232C のブレーク信号</title> + + <para>RS-232C は <literal>ブレーク</literal> + と呼ばれる信号についても定めています. これは + (スタートビットもストップビットも無しで) 連続して + スペースの値を送ることで発生されます. + データ回路に電流が流れていない場合は, 回線は + <literal>ブレーク</literal> + を送り続けているものと解釈されます.</para> + + <para><literal>ブレーク</literal> 信号は完全な 1 + バイトとスタート, ストップ, パリティ + ビットを送るために必要な時間よりも + 長い間続かなければなりません. ほとんどの UART + はフレーミングエラーとブレークを区別することが + できますが, もしも これを区別できない UART があった場合, + フレーミングエラーの検出をブレークの識別のために + 使用することができます.</para> + + <para>テレタイプの時代には, + 国中でおびただしい数のテレタイプが + (ニュースサービスなどで) 電線で直列に接続されていました. + 任意のテレタイプユニットは, + 電流が流れないように一時的に回路を オープンにすることで + <literal>ブレーク</literal> + 信号を発生させることができました. これは, + 他のテレタイプが情報を送信している間に, 緊急ニュースを + 送る必要のあるテレタイプが + 割り込みをかけるために使われました.</para> + + <para>現在のシステムでは, + ブレーク信号には二つのタイプがあります. + もしブレーク信号が 1.6 秒よりも長ければ, それは + 「モデムブレーク」であると解釈されます. + モデムがこの信号を検出すると, + 通信を終了して電話を切ったり, コマンドモードに入るように + プログラムされていることがあります. もしブレーク信号が + 1.6 秒よりも短ければ, それはデータブレークを 示します. + この信号に応答するのはリモートコンピュータの仕事です. + この形のブレークは, + しばしば注意喚起または割り込みのための信号として 使われ, + ASCII の CONTROL-C + 文字の代用とされることもあります.</para> + + <para>マークとスペースは紙テープシステムでの + “穴空き” と “穴無し” に + 相当しています.</para> + + <note> + <para>ブレーク信号は, + 紙テープまたはその他のバイト列から生成できない + ことに注意してください. + なぜならバイト列は常にスタートビットや + ストップビットとともに送られるからです. UART + には通常, ホストプロセッサからの特別なコマンドにより + 連続したスペース信号を生成する能力があります.</para> + </note> + </sect5> + + <sect5> + <title>RS-232C の DTE デバイスおよび DCE デバイス</title> + + <para>RS-232C 規格は二つのタイプの装置を定めています: + それはデータターミナル装置 (DTE) とデータキャリア装置 + (DCE) です. 通常, DTE デバイスはターミナル + (またはコンピュータ) で, DCE は モデムです. + 電話回線を介した通信のもう一方の端である受信側のモデムも + また DCE デバイスで, + そのモデムに接続されているコンピュータは DTE + デバイスです. DCE デバイスが信号を受け取るピンは DTE + デバイスが 信号を送るピンであり, + また逆も同様です.</para> + + <para>二つのデバイスがともに DTE であったり, ともに DCE + であって, + モデムやそれに類似したメディア変換装置を介さずに + 接続する必要が ある場合, ヌルモデム (NULL modem) + を使わなければなりません. + ヌルモデムはケーブルを電気的に再配列し, + 一方のデバイスの送信出力が + もう一方のデバイスの受信入力に接続され, + その逆もまた同様に 接続されるようにしてくれます. + 同様の変換はすべての制御信号についておこなわれ, + それぞれのデバイスが 他方のデバイスからの DCE (または + DTE) 信号を受けとれるようになります.</para> + + <para>DTE デバイスと DCE + デバイスで生成される信号の数は等しくありません. DTE + デバイスが DCE デバイスのために生成する信号の数は, DTE + デバイスが DCE デバイスから受けとる信号の数よりも + 少なくなっています.</para> + </sect5> + + <sect5> + <title>RS-232C のピン割当て</title> + + <para>EIA の RS-232C 規格 (およびこれに相当する ITU の + V.24 規格) は 25 ピンのコネクタ (通常 DB25 が使われます) + を要求し, そのコネクタのほとんどのピンの + 使用目的を定義しています.</para> + + <para>IBM PC および類似のシステムでは, RS-232C + 信号のサブセットが 9 ピンのコネクタ (DB9) + で提供されています. 主に同期モードで使用される信号は PC + のコネクタには含まれていませんが, もともと + この転送モードは IBM が IBM PC で使用することにした UART + ではサポートされていません.</para> + + <para>メーカーによっては RS-232C 用のコネクタに DB25 か + DB9, + またはその両タイプのコネクタを使っている場合があります. + (IBM PC はパラレルプリンタインターフェースにも DB25 + コネクタを 使っているので, このことは + しばしば混乱を引き起こします.)</para> + + <para>以下は DB25 および DB9 コネクタにおける RS-232C + 信号の割り当て表です.</para> + + <informaltable frame="none"> + <tgroup cols="7"> + <thead> + <row> + <entry>DB25 RS232-C 端子</entry> + <entry>DB9 IBM PC 端子</entry> + <entry>EIA 回路符号</entry> + <entry>CCITT 回路符号</entry> + <entry>一般名称</entry> + <entry>信号源</entry> + <entry>説明</entry> + </row> + </thead> + + <tbody> + <row> + <entry>1</entry> + <entry>-</entry> + <entry>AA</entry> + <entry>101</entry> + <entry>PG/FG</entry> + <entry>-</entry> + <entry>保安用接地</entry> + </row> + + <row> + <entry>2</entry> + <entry>3</entry> + <entry>BA</entry> + <entry>103</entry> + <entry>TD</entry> + <entry>DTE</entry> + <entry>送信データ</entry> + </row> + + <row> + <entry>3</entry> + <entry>2</entry> + <entry>BB</entry> + <entry>104</entry> + <entry>RD</entry> + <entry>DCE</entry> + <entry>受信データ</entry> + </row> + + <row> + <entry>4</entry> + <entry>7</entry> + <entry>CA</entry> + <entry>105</entry> + <entry>RTS</entry> + <entry>DTE</entry> + <entry>送信要求</entry> + </row> + + <row> + <entry>5</entry> + <entry>8</entry> + <entry>CB</entry> + <entry>106</entry> + <entry>CTS</entry> + <entry>DCE</entry> + <entry>送信可</entry> + </row> + + <row> + <entry>6</entry> + <entry>6</entry> + <entry>CC</entry> + <entry>107</entry> + <entry>DSR</entry> + <entry>DCE</entry> + <entry>データセットレディ</entry> + </row> + + <row> + <entry>7</entry> + <entry>5</entry> + <entry>AV</entry> + <entry>102</entry> + <entry>SG/GND</entry> + <entry>-</entry> + <entry>信号用接地</entry> + </row> + + <row> + <entry>8</entry> + <entry>1</entry> + <entry>CF</entry> + <entry>109</entry> + <entry>DCD/CD</entry> + <entry>DCE</entry> + <entry>受信キャリア検出</entry> + </row> + + <row> + <entry>9</entry> + <entry>-</entry> + <entry>-</entry> + <entry>-</entry> + <entry>-</entry> + <entry>-</entry> + <entry>予約 (テスト用)</entry> + </row> + + <row> + <entry>10</entry> + <entry>-</entry> + <entry>-</entry> + <entry>-</entry> + <entry>-</entry> + <entry>-</entry> + <entry>予約 (テスト用)</entry> + </row> + + <row> + <entry>11</entry> + <entry>-</entry> + <entry>-</entry> + <entry>-</entry> + <entry>-</entry> + <entry>-</entry> + <entry>未割当て</entry> + </row> + + <row> + <entry>12</entry> + <entry>-</entry> + <entry>CI</entry> + <entry>122</entry> + <entry>SRLSD</entry> + <entry>DCE</entry> + <entry>従局受信キャリア検出</entry> + </row> + + <row> + <entry>13</entry> + <entry>-</entry> + <entry>SCB</entry> + <entry>121</entry> + <entry>SCTS</entry> + <entry>DCE</entry> + <entry>従局送信可</entry> + </row> + + <row> + <entry>14</entry> + <entry>-</entry> + <entry>SBA</entry> + <entry>118</entry> + <entry>STD</entry> + <entry>DTE</entry> + <entry>従局送信データ</entry> + </row> + + <row> + <entry>15</entry> + <entry>-</entry> + <entry>DB</entry> + <entry>114</entry> + <entry>TSET</entry> + <entry>DCE</entry> + <entry>送信信号エレメントタイミング</entry> + </row> + + <row> + <entry>16</entry> + <entry>-</entry> + <entry>SBB</entry> + <entry>119</entry> + <entry>SRD</entry> + <entry>DCE</entry> + <entry>従局受信データ</entry> + </row> + + <row> + <entry>17</entry> + <entry>-</entry> + <entry>DD</entry> + <entry>115</entry> + <entry>RSET</entry> + <entry>DCE</entry> + <entry>受信信号エレメントタイミング</entry> + </row> + + <row> + <entry>18</entry> + <entry>-</entry> + <entry>-</entry> + <entry>141</entry> + <entry>LOOP</entry> + <entry>DTE</entry> + <entry>ローカルループバック</entry> + </row> + + <row> + <entry>19</entry> + <entry>-</entry> + <entry>SCA</entry> + <entry>120</entry> + <entry>SRS</entry> + <entry>DTE</entry> + <entry>従局送信要求</entry> + </row> + + <row> + <entry>20</entry> + <entry>4</entry> + <entry>CD</entry> + <entry>108.2</entry> + <entry>DTR</entry> + <entry>DTE</entry> + <entry>データ端末レディ</entry> + </row> + + <row> + <entry>21</entry> + <entry>-</entry> + <entry>-</entry> + <entry>-</entry> + <entry>RDL</entry> + <entry>DTE</entry> + <entry>リモートデジタルループバック</entry> + </row> + + <row> + <entry>22</entry> + <entry>9</entry> + <entry>CE</entry> + <entry>125</entry> + <entry>RI</entry> + <entry>DCE</entry> + <entry>被呼表示</entry> + </row> + + <row> + <entry>23</entry> + <entry>-</entry> + <entry>CH</entry> + <entry>111</entry> + <entry>DSRS</entry> + <entry>DTE</entry> + <entry>データ信号速度選択</entry> + </row> + + <row> + <entry>24</entry> + <entry>-</entry> + <entry>DA</entry> + <entry>113</entry> + <entry>TSET</entry> + <entry>DTE</entry> + <entry>送信信号エレメントタイミング</entry> + </row> + + <row> + <entry>25</entry> + <entry>-</entry> + <entry>-</entry> + <entry>142</entry> + <entry>-</entry> + <entry>DCE</entry> + <entry>テストモード</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </sect5> + </sect4> + + <sect4> + <title>ビット, ボー, そしてシンボル</title> + + <para>ボーとは非同期通信における転送速度の単位です. + モデム通信技術の進歩により, 新しいデバイスのデータ速度を + 表記するにあたって, この用語が + しばしば誤って使われるようになりました.</para> + + <para>ボーレートは伝統的に, + 通信路を通して実際に送られるビットの数を 表します. ある + DTE デバイスからもう一方へと実際に移動した + データの量を表すものではありません. ボーレートは, 送信側 + UART で生成されて受信側 UART で取り除かれる スタート, + ストップ, パリティといったオーバーヘッドビットをも + 含んでいます. これは 1 ワード 7 + ビットのデータを送るためには, 実際には 10 ビットの + データが完全に転送される必要があるということを意味します. + そのため, もしパリティを使い, + スタートビットとストップビットが それぞれ 1 + ビットずつ存在する場合には, 1 秒あたり 300 ビットの + 転送能力を持つモデムでは, 7 ビットのワードを通常 30 個しか + 転送することができません.</para> + + <para>もし 1 ワード 8 + ビットのデータとパリティビットを使用する場合には, + データ転送速度は 1 秒あたり 27.27 ワードまで低下します. + なぜなら 8 ビットのワードを送るのに 11 ビットが必要で, + このモデムは 1 秒間に 300 + ビットしか送ることができないからです.</para> + + <para>1 秒あたりの転送バイト数をボーレートに変換したり, + その逆をおこなう 計算式は, + エラー訂正をおこなうモデムが現れるまでは単純でした. + エラー訂正をおこなうモデムは, ホストコンピュータの UART + から シリアルのビット列を受けとり, + それをバイト列に戻します. + (内蔵モデムを使用している場合でさえ, データは今まで通り + 頻繁にシリアル化されます) + その後これらのバイトはパケットに変換され, + 同期転送方式を用いて 電話回線を通じて送信されます. これは + DTE (コンピュータ) 中の UART で追加されたストップ, + スタート およびパリティビットは, + モデムから送り出される前に, モデムによって + 取り除かれるということを意味します. + これらのバイト列がリモートモデムに受信されると, + リモートモデムは スタート, + ストップおよびパリティビットを追加して, それらを + シリアル形式に変換し, リモートコンピュータの受信側 UART + に送ります. そしてリモートコンピュータの UART はスタート, + ストップおよび パリティビットを取り除きます.</para> + + <para>これらの特別な変換はすべて, + 二つのモデムの間でエラー訂正が + 実行できるようにするためおこなわれています. + エラー訂正とは, 受信側のモデムが正しいチェックサムで + 受信できなかったデータブロックの再送を, + 送信側のモデムに要求することができるということです. + この作業はモデムにより処理されて, DTE デバイスは + このようなプロセスがおこなわれていることに, + 通常気がつきません.</para> + + <para>スタート, + ストップおよびパリティビットを取り除くことにより, + エラー訂正のために二つのモデムの間で共有しなければならない + 追加のビットを, + 実効転送速度を低下させずに送ることができます. そのため, + 送受信 DTE にはエラー訂正がおこなわれているかどうかが + ほとんど見えなくなります. 例えば, もしモデムが 10 個の 7 + ビットデータをもう一方のモデムに送る 際に, スタート, + ストップ, およびパリティビットを送る必要がなければ, + その分の 30 ビットの情報を, + 真のデータの転送速度に影響を与えることなく + エラー訂正のために追加することができるわけです.</para> + + <para>データ圧縮をおこなうモデムでは, + ボーという言葉の使い方は さらに混乱することになります. + 例えば電話回線を通じて送られた二つの 8 ビットデータは, + 送信側モデムに送られた 12 + バイトのデータを表すかもしれません. + 受信側モデムはそのデータを本来の内容に展開し, 受信側の DTE + に渡します.</para> + + <para>また, 最近のモデムはバッファを内蔵しており, (DCE から + DCE へ) 電話線を 流れるデータの転送速度と, 両端の DTE と + DCE の間で流れるデータの + 転送速度とを別々に設定することができます. + モデムによる圧縮を使用する場合, 通常は DTE と DCE + の間の速度を DCE と DCE + の間の速度より速くしておきます.</para> + + <para>1 バイトを記述するのに必要なビットの数は, + 二つのマシンの間でも DTE-DCE と DCE-DCE + のリンクでそれぞれ変化する場合がありますし, そのうえ, + それぞれのビット転送速度が異なる場合もあります. そのため, + 全体としての通信速度を表現するために + ボーという言葉を使うことは 問題でもありますし, + 真の転送速度を正しく伝えない場合があります. 1 + 秒あたりの転送ビット数 (bps) は DCE と DCE + の間のインターフェースに + おける転送速度を記述するために使うなら正しい用語ですし, + ボーまたは 1 秒あたりのビット数は, + 二つのシステムが電線で直接 接続されていたり, + エラー訂正や圧縮をおこなわないモデムが + 使われている場合には, 許容可能な用語です.</para> + + <para>最近の高速モデム (2400, 9600, 14,400, 19,200bps + などのもの) も, 実際には 2,400 ボー (正確には 2,400 + シンボル/秒) か, それ以下の 速度で通信しています. + 高速モデムでは, 複数のビットを一つのシンボルで + 伝送する技術 (多値符合化など) を用いて, シンボル速度 + (シンボル/秒) よりも 高い通信速度 (ビット/秒) + を達成しています. これが電話の限られた音声帯域で + 高い伝送速度を得られる理由です. 28,800bps + やそれ以上のモデムでは, シンボル速度自体が + 可変になっていますが, + それ以外は同様の技術が用いられています.</para> + </sect4> + + <sect4> + <title>IBM PC の UART</title> + + <para>元祖 IBM PC を設計した際に, IBM + はナショナル・セミコンダクタ社の INS8250 UART を IBM PC + パラレル/シリアルアダプタで使用することに + 決めました.</para> + + <para>IBM 自身やその他のベンダが作っている後継世代の AT + 互換機でも, INS8250 + そのものやナショナル・セミコンダクタの UART ファミリの + 改良版を使い続けられています.</para> + + <sect5> + <title>ナショナル・セミコンダクタの UART + ファミリ系統図</title> + + <para>INS8250 UART + にはいくつかのバージョンと後継の部品があります. + 主要なバージョンを以下に示します.</para> + <!-- This should really be a graphic --> + + <programlisting> +INS8250 -> INS8250B + \ + \ + \-> INS8250A -> INS82C50A + \ + \ + \-> NS16450 -> NS16C450 + \ + \ + \-> NS16550 -> NS16550A -> PC16550D</programlisting> + + <variablelist> + <varlistentry><term>INS8250</term> + <listitem> + <para>この部品は元祖 IBM PC と IBM PC/XT で + 使われていました. この部品は本来 INS8250 ACE + (Asynchronous Communications Element) と + いう名前で, NMOS 技術で作られていました.</para> + + <para>8250 は八つの I/O ポートを占有し, 送信バッファ + 1 バイトと 受信バッファ 1 バイトを持っています. + この元祖の UART はいくつかの + 競合状態などに関する欠陥を持っています. 元祖の + IBM BIOS + はこれらの欠陥を回避してうまく動くようなコードを + 含んでいましたが, そのために BIOS + が欠陥の存在に依存するように なってしまいました. + このため, 元祖 IBM PC や IBM PC/XT では 8250A, + 16450, または 16550 のような後継部品を使うことは + できませんでした.</para> + </listitem> + </varlistentry> + + <varlistentry><term>INS8250-B</term> + <listitem> + <para>これは NMOS 技術で作られた INS8250 + の低速版です. これもオリジナルの INS8250 + と同じ問題を含んでいます.</para> + </listitem> + </varlistentry> + + <varlistentry><term>INS8250A</term> + <listitem> + <para>XMOS 技術を使い, + さまざまな機能的欠陥を修正した INS8250 + の改良版です. INS8250A は当初, + “クリーン”な BIOS を 使用したベンダの + PC クローンで使用されていました. + なぜなら欠陥が修正されたことにより, この部品は + INS8250 や INS8250B の ために書かれた BIOS + で使うことはできなかったからです.</para> + </listitem> + </varlistentry> + + <varlistentry><term>INS82C50A</term> + <listitem> + <para>これは INS8250A の CMOS 版 (低消費電力版) で, + INS8250A と同じ機能特性を持っています.</para> + </listitem> + </varlistentry> + + <varlistentry><term>NS16450</term> + <listitem> + <para>より高速な CPU バスにも対応できるように + 改良されたこと以外は NS8250A と同じです. IBM + はこの部品を IBM AT で使うことに決め, もはや IBM + BIOS が INS8250 + のバグに依存しなくなるように + 変更をおこないました.</para> + </listitem> + </varlistentry> + + <varlistentry><term>NS16C450</term> + <listitem> + <para>これは NS16450 の CMOS 版 (低消費電力版) + です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>NS16550</term> + <listitem> + <para>送信バッファと受信バッファをそれぞれ 16 + バイトに 変更したこと以外は NS16450 と同じですが, + バッファの設計に 欠陥があるため, + 信頼して使用することはできません.</para> + </listitem> + </varlistentry> + + <varlistentry><term>NS16550A</term> + <listitem> + <para>バッファの欠陥が修正されたこと以外は NS16550 + と 同じです. 割り込みへの反応が遅い OS + でも高い信頼性で高速なデータを + 扱うことができることから, 16550A とその後継部品は + PC 産業界で 最も一般的に使われる UART + となりました.</para> + </listitem> + </varlistentry> + + <varlistentry><term>NS16C552</term> + <listitem> + <para>これは 2 個の NS16C550A CMOS UARTを + 一つのパッケージに入れた部品です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>PC16550D</term> + <listitem> + <para>ささいな欠陥が修正されたこと以外は NS16550A と + 同じです. これは 16550 ファミリの D リビジョンで, + ナショナル・セミコンダクタ社から + 提供されている最新の部品です.</para> + </listitem> + </varlistentry> + </variablelist> + </sect5> + + <sect5> + <title>NS16550AFとPC16550Dは同じもの</title> + + <para>( ここからは &a.jp.iwasaki; が翻訳を担当)</para> + + <para>ナショナル・セミコンダクタは + 数年前に部品番号体系を再編成して おり, NS16550AFN + という名称はもはや存在しません. (もしあなたが + NS16550AFN を持っていたら, + 部品の日付コードを見てください. それは 通常 9 + から始まる4桁の数字です. 最初の2桁の数字は年度, 次の2桁 + は部品がパッケージされた年度の週です. あなたの持っている + NS16550AFN は, おそらく数年前のものでしょう.)</para> + + <para>新しい番号は PC16550DV の様に, + パッケージ材料と形状により接尾辞 に小さな違いがあります + (番号体系についての記述は後述します).</para> + + <para>ここで注意しなければいけないことがあります. 例えば, + ある店に行って 1990年製の NS16550AFN + を15米ドルで売っているとします. ところが, + そのすぐ隣には ナショナル・セミコンダクタが AFN + を生産開始してから それにマイナーな変更を加えて作った + PC16550DN があり, そちらは 最近 + 6ヶ月に作られたものなのに, 簡単に入手できるため + NS16550AFN の 半額 (たくさん一度に買うと + 5米ドルまで下がることもあります) 位で + 買えたりすることがあるのです.</para> + + <para>NS16550AFN のチップ供給は減少し続けているため, + PC16550DN が古い + 部品番号のものとまったく同じ機能を持っていることに, + より多くの人が 気付いて受け入れるまでは, + 価格はおそらく上昇し続けるでしょう.</para> + </sect5> + + <sect5> + <title>ナショナル・セミコンダクタの部品番号体系</title> + + <para>古い NS<replaceable>nnnnnrqp</replaceable> + の部品番号は, 現在 + PC<replaceable>nnnnnrgp</replaceable> + というフォーマットになっています.</para> + + <para><replaceable>r</replaceable> + はリビジョンのフィールドです. 現在のナショナルセ + ミコンダクタの 16550 + のリビジョンは<literal>D</literal>です.</para> + + <para><replaceable>p</replaceable> + はパッケージタイプのフィールドです. タイプは以下 + の通りです:</para> + + <informaltable frame="none"> + <tgroup cols="3"> + <tbody> + <row> + <entry>"F"</entry> + <entry>QFP</entry> + <entry>(quad flat pack) L lead type</entry> + </row> + + <row> + <entry>"N"</entry> + <entry>DIP</entry> + <entry>(dual inline package) through hole straight + lead type</entry> + </row> + + <row> + <entry>"V"</entry> + <entry>LPCC</entry> + <entry>(lead plastic chip carrier) J lead type</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>訳注: 具体的なパッケージ形状についての情報は <ulink + URL="http://www.national.com/packaging/plastic.html">http://www.national.com/packaging/plastic.html</ulink> を参照 してください.</para> + + <para><replaceable>g</replaceable> + は製品グレードのフィールドです. もしパッケージタイ + プの文字の前に<literal>I</literal>があれば, + “工業用”グレード部品を表し, 標準 + 部品より高いスペックを持ちますが, Miltary 仕様 (Milspec) + ほど高 くはありません. + これは付加的なフィールドです.</para> + + <para>私たちがかつて NS16550AFN (DIP パッケージ) + と呼んでいたものは, 現在 は PC16550DN または PC16550DIN + と呼ばれています.</para> + </sect5> + </sect4> + + <sect4> + <title>他のベンダと類似の UART</title> + + <para>長年に渡り, 8250, 8250A, 16450 そして 16550 + はライセンスされ, + または他のチップベンダにコピーされてきました. 8250, 8250A + そして 16450 の場合は, そのものの回路 + (“megacell”: LSIの中に組み込む + ことのできるライブラリ化された回路の大規模な物) が Western + Digital と Intel + を含むたくさんのベンダにライセンスされまし た. + 他のベンダは部品を + リバースエンジニアリングした物か同じように + 動作する互換品を製造しました.</para> + + <para>内蔵モデムにおいては, + モデム設計者はモデムのマイクロプロセッサで 8250A/16450 + をエミュレートすることはよくおこなわれます. + このエミュレート による (互換の) UART + は数百バイトの隠れたバッファを持つでしょう. + バッファのサイズのため, + このような互換品は高速データ処理の能力では 16550A + と変わらない信頼性を持つことができます. しかし, それでも + ほとんどのオペレーティングシステムは UART は 8250A か + 16450 である と報告し, 特殊なドライバが使用されなければ + エミュレートによる UART の余分に存在する + バッファリングの効果的な使用はおこないません.</para> + + <para>幾つかのモデムメーカーは, + 市場における競争を有利にするために数百バ + イトのバッファを持ち 16550A + の置き換えができるはずの設計を, たとえ + 性能が低下する事になったとしても + 棄てざるを得なくなるような市場の圧 + 力を受けています.</para> + + <para>一般的にある誤解は, “16550A” + と書かれたすべての部品が同じ性能であると いうことです. + それらは異なるものであり, 状況によってはまちがいなく + 欠陥と呼べるものがこれらの 16550A + クローンのほとんどにあります.</para> + + <para>NS16550 が開発された時に, + ナショナル・セミコンダクタは設計に関する + 幾つかの特許を取得し, + 彼らはライセンスを制限して他のベンダが類似 + の特徴を持つチップを供給することを困難にしました. + 特許のため, リバー + スエンジニアリングによる設計とエミュレーションは, + 特許がカバーする + 請求権を侵害を回避しなくてはなりませんでした. 結果として, + これらの コピーのほとんどは, + 多くのコンピュータとモデムのメーカーは支払いた + くはない程の価格であった本物の部品の NS16550A または + PC16550D とまった + く同じような動作をさせることはできませんでした.</para> + + <para>16550A のクローンに存在する相違点のうち + いくつかは些細なものですが, そのほかに + 特定のオペレーティングシステムやドライバでは + 全然使いものにならないような相違が存在する場合もあります. + あるドライバでは問題なく動作しても, + 別のドライバを使用した場合には + 問題が発生することもありますし, Windows + のドライバにおいても + 充分にテストや考慮がおこなわれなかったイベントの組合わせが + 起こった場合には, + これらの相違点が明らかになるかもしれません. + これはほとんどのモデムベンダと 16550 クローンメーカーが, + NS16550A との互換性のプライマリテストとして Windows for + Workgroups 3.11 と Microsoft MSD ユーティリティの + Microsoft ドライバを使用しているか らです. + この安易過ぎる規準は, もし異なるオペレーティングシステムが + 使用されたらクローンと + 本物の部品の微妙な違いのために問題が発生し得 る, + ということを意味しています.</para> + + <para>ナショナル・セミコンダクタは, どんな OS + のドライバからも独立した互 換性テストを実行する + <application>COMTEST</application> + という名前の入手可能なプログラムを作 成しました. + このタイプのプログラムの目的は, 競合製品にある欠陥のデ + モンストレーションであることをおぼえておくべきです. + ですからそのプ ログラムは, + テスト中の部品の動作の重要な問題と極めてささいな相違を + 同じように報告するでしょう.</para> + + <para>この文書の著者が 1994 + 年に実行した一連のテストでは, ナショナルセミ コンダクタ, + TI, StarTech そして CMD が製造した部品は megacell 及び + COMTEST + でテストされた内蔵モデムに埋め込まれたエミュレーションと同 + 等です. + これらの部品のの幾つかで注目される相違点を以下に示します. + これらのテストは1994年に実行されたので, + これらはベンダから供給さ + れた製品の現在の性能には反映されないでしょう.</para> + + <para>極端に多くの問題やあるタイプの問題が検出された場合に, + COMTEST は通 常は実行を中止することに注意してください. + このテストの一部では, たと + え何回相違点に遭遇しても中止しないように COMTEST + を修正しました.</para> + + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>ベンダ</entry> + <entry>部品番号</entry> + <entry>報告された「相違点」として知られるエラー</entry> + </row> + </thead> + + <tbody> + <row> + <entry>National</entry> + <entry>(PC16550DV)</entry> + <entry>0</entry> + </row> + + <row> + <entry>National</entry> + <entry>(NS16550AFN)</entry> + <entry>0</entry> + </row> + + <row> + <entry>National</entry> + <entry>(NS16C552V)</entry> + <entry>0<!-- kuriyama - should be added "*" as footnote --></entry> + </row> + + <row> + <entry>TI</entry> + <entry>(TL16550AFN)</entry> + <entry>3</entry> + </row> + + <row> + <entry>CMD</entry> + <entry>(16C550PE)</entry> + <entry>19</entry> + </row> + + <row> + <entry>StarTech</entry> + <entry>(ST16C550J)</entry> + <entry>23</entry> + </row> + + <row> + <entry>Rockwell</entry> + <entry>Reference modem with internal 16550 or an + emulation (RC144DPi/C3000-25)</entry> + <entry>117</entry> + </row> + + <row> + <entry>Sierra</entry> + <entry>Modem with an internal 16550 + (SC11951/SC11351)</entry> + <entry>91</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <note> + <para>この文書の著者は今まで, COMTEST プログラムを + 使用して相違点がゼロと報告されるナショナル・ + セミコンダクタ以外の部品を一つも発見しませんでした. + ナショナル・セミコンダクタは長年に渡り 16550 + の五つのバージョンを持っており, 最新の部品は + 機能性のために, ベンチマークを考慮した古い + NS16550AFN と少し異なる振る舞いをすることに + 注意するべきです. + COMTEST はナショナル・セミコンダクタの製品ラインの + 相違点については見て見ぬふりをするようになり, + 部品のリビジョン A, B そして C にあるバグが + 記述されている公式な正誤表がある時でも, + (オリジナルの 16550 を除いては) ナショナル・ + セミコンダクタの部品についてエラーを + 報告しなくなったので, この COMTEST のひいきを + 考慮にいれるべきです.</para> + </note> + + <para>COMTEST からの相違点の単純なカウントが, + 何の相違点が重要であり どれがそうでないのかについて + 多くを明らかにしないことを 理解すること が大切です. + 例えば, 内蔵の UART を持つ上記の二つのモデムで報告され + た相違点の約半分が, + 5及び6ビットキャラクタモードをサポートしないク ローンの + UART によって引き起こされました. 本物の 16550, 16450 そし + て 8250 UART すべてはこれらのモードをサポートし, COMTEST + はこれらの モードの機能性をチェックするので, + 50を越える相違点が報告されました. しかし, + 5及び6ビットキャラクタモードを + サポートするモデムは殆どなく, + 特ににこれらはエラー修正と圧縮機能付のものです. + これは5及び6ビット キャラクタモードに関連した相違点は + 差し引いて考えることができること を意味しています.</para> + + <para>COMTEST が報告した相違点の多くは, + タイミングに関する点でしょう. 多くのクローンの設計では, + ホストが一つのポートから読み込んだ時に他 + のあるポートのステータスビットは, + <emphasis>本当の</emphasis> NS16550AFN と同じ + 長さの時間内で更新されない (あるものは速く, + あるものは遅く) かもしれ ませんが, COMTEST + はこれらの相違点を探します. これは相違点の数は誤 + 解を招き易いものです. + あるデバイスには一つか二つの相違点しかありま + せんがそれらは非常に重大かもしれません. + また別のデバイスは基準部品 と比べて速くまたは遅く status + レジスタを更新するために (適切に書か + れたドライバの操作にはまったく影響しないかもしれません) + 多くの相違点を 報告されるかもしれません.</para> + + <para>COMTEST は問題を引き起こすかも知れない, + または特殊なケースとして処 + 理しなければならない潜在的に矛盾した部品の存在に対して, + 管理者に警 + 告を出すスクリーニングツールとして使用できます.</para> + + <para>もしモデムの中にある 16550 + やシリアルポート接続されているモデムに 対して COMTEST + を実行する場合, モデムがテストキャラクタをエコーし + ないように最初に ATE0&W + コマンドをモデムに発行する必要がありま す. + これをおこなうことを忘れた場合, COMTEST + は少なくともこの相違点を 報告するでしょう: </para> + + <screen>Error (6)...Timeout interrupt failed: IIR = c1 LSR = 61</screen> + </sect4> + + <sect4> + <title>8250/16450/16550 のレジスタ</title> + + <para>8250/16450/16550 UART は八つの連続する I/O + ポートアドレスを予約 しています. IBM PC + ではこれらの八つのポートに対して二つの定義された + 位置があり, それらは集合的に COM1 と COM2 + として知られています. PC + クローンとアドオンカードのメーカーは COM3 と COM4 + として知られる二つ の付加的な領域を作成しましたが, + 幾つかのシステムではこれらの余分な COM + ポートは他のハードウェアと衝突します. 最もよく起きるものは + IBM 8514 + エミュレーションを提供するビデオアダプタとの衝突です. + </para> + + <para>COM1 には 0x3f8 から 0x3ff が割り当てられ, 通常 IRQ 4 + が使用されます. COM2 には 0x2f8 から 0x2ff が割り当てられ, + 通常 IRQ 3 が使用されます. COM3 には 0x3e8 から 0x3ef + が割り当てられ, IRQ は標準化されていません. COM4 には + 0x2e8 から 0x2ef が割り当てられ, IRQ + は標準化されていません.</para> + + <para>8250/16450/16550 UART + のI/Oポートの詳細は以下に提供されています.</para> + + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>I/O ポート</entry> + <entry>許可されたアクセス</entry> + <entry>説明</entry> + </row> + </thead> + + <tbody> + <row> + <entry>+0x00</entry> + <entry>write (DLAB==0)</entry> + <entry><para>Transmit Holding Register (THR).</para><para> + このポートに書き込まれた情報は + データ命令として 処理され, UART + により送信されます.</para></entry> + </row> + + <row> + <entry>+0x00</entry> + <entry>read (DLAB==0)</entry> + <entry><para>Receive Buffer Register (RBR).</para><para> + シリアル接続から UART + によって受信されたすべての データ命令は, + このポートを読むことによってホス + トによりアクセスされます.</para></entry> + </row> + + <row> + <entry>+0x00</entry> + <entry>write/read (DLAB==1)</entry> + <entry><para>Divisor Latch LSB (DLL)</para><para> + マスタ入力クロックの周波数を + このレジスタに入っ ている値で割ることにより, + UART の周波数が決定 されます (IBM PCでは, + マスタクロックの周波数は 1.8432MHzです). + このレジスタには上記の除数の下 + 位8ビットが入っています.</para></entry> + </row> + + <row> + <entry>+0x01</entry> + <entry>write/read (DLAB==1)</entry> + <entry><para>Divisor Latch MSB (DLH)</para><para> + マスタ入力クロックの周波数をこの + レジスタに入っ ている値で割ることにより, UART + の周波数が決定 されます (IBM PCでは, + マスタクロックの周波数は 1.8432MHzです). + このレジスタには上記の除数の上 + 位8ビットが入っています.</para></entry> + </row> + + <row> + <entry>+0x01</entry> + <entry>write/read (DLAB==0)</entry> + <entrytbl cols="2"> + <colspec colnum="1" colname="col1"> + <colspec colnum="2" colname="col2"> + <spanspec namest="col1" nameend="col2" spanname="1to2"> + <tbody> + <row> + <entry spanname="1to2"><para>Interrupt Enable + Register (IER)</para><para> + 8250/16450/16550 の UART + はイベントを四つのカテ + ゴリの一つに分類します. + それぞれのカテゴリは設 定可能です. + それぞれのカテゴリは, どんな類のイ + ベントの発生時に割り込みを + 生成するように設定可 能です. + 8250/16450/16550 の UART は, 有効になっ + ているカテゴリ内でいくつの + イベントが発生してい るかに関わらず, + 単一の外部割り込みシグナルを生 成します. + 割り込みに応答し有効になっている割り + 込みカテゴリ + (通常すべてのカテゴリが有効になって + いる割り込みを持ちます) + を割り込みの本当の原因 + を決定するためにポーリングするかは, + ホストのプ + ロセッサ次第です.</para></entry> + </row> + + <row> + <entry>Bit 7</entry> + <entry>予約済み, 常に 0. </entry> + </row> + + <row> + <entry>Bit 6</entry> + <entry>予約済み, 常に 0. </entry> + </row> + + <row> + <entry>Bit 5</entry> + <entry>予約済み, 常に 0. </entry> + </row> + + <row> + <entry>Bit 4</entry> + <entry>予約済み, 常に 0. </entry> + </row> + + <row> + <entry>Bit 3</entry> + <entry>Enable Modem Status Interrupt (EDSSI). + このビットを「1」に設定することで, + 一つ以上の状態ラインで変更が発生した時 + に, UART が割り込みを生成可能となりま + す. </entry> + </row> + + <row> + <entry>Bit 2</entry> + <entry>Enable Receiver Line Status Interrupt (ELSI) + このビットを「1」に設定することで, 入っ + てくるデータにエラー (または BREAK シ + グナル) が検知された時に, UART が割り + 込みを生成するようになります. </entry> + </row> + + <row> + <entry>Bit 1</entry> + <entry>Enable Transmitter Holding Register + Empty Interrupt (ETBEI) + このビットを「1」に設定することで, UART + に送信される一つ以上の付加的な文 + 字に対する空きが生じた時に, UART が割 + り込みを生成するようになります. </entry> + </row> + + <row> + <entry>Bit 0</entry> + <entry>Enable Received Data Available + Interrupt (ERBFI) + このビットを「1」に設定することで, UART が + FIFO のトリガーレベルを越え + る十分な文字を受け取るか, FIFO のタイ + マが期限切れとなるか (古くなったデータ), + FIFO が無効の場合にシグナル文字が受信 + された時に, UART が割り込みを生成する + ようになります. </entry> + </row> + </tbody> + </entrytbl> + </row> + + <row> + <entry>+0x02</entry> + <entry>write</entry> + <entrytbl cols="4"> + <colspec colnum="1" colname="col1"> + <colspec colnum="2" colname="col2"> + <colspec colnum="3" colname="col3"> + <colspec colnum="4" colname="col4"> + <spanspec namest="col1" nameend="col4" spanname="1to4"> + <spanspec namest="col2" nameend="col4" spanname="2to4"> + + <tbody> + <row> + <entry spanname="1to4">FIFO Control Register (FCR) + (このポートは 8250 と 16450 の UART では + 存在しません.)</entry> + </row> + + <row> + <entry>Bit 7</entry> + <entry spanname="2to4">Receiver Trigger Bit + #1</entry> + </row> + + <row> + <entry>Bit 6</entry> + <entry spanname="2to4"><para>Receiver Trigger + Bit #0</para><para>この二つのビットは FIFO + が機能している + 場合にレシーバがどの時点で割り込みを生 + 成するかを制御します.</para></entry> + </row> + + <row> + <entry colname="col2">7</entry> + <entry colname="col3">6</entry> + <entry + colname="col4">割り込み生成前にいくつの命令 + が 受信されたか. </entry> + </row> + + <row> + <entry colname="col2">0</entry> + <entry colname="col3">0</entry> + <entry colname="col4">1</entry> + </row> + + <row> + <entry colname="col2">0</entry> + <entry colname="col3">1</entry> + <entry colname="col4">4</entry> + </row> + + <row> + <entry colname="col2">1</entry> + <entry colname="col3">0</entry> + <entry colname="col4">8</entry> + </row> + + <row> + <entry colname="col2">1</entry> + <entry colname="col3">1</entry> + <entry colname="col4">14</entry> + </row> + + <row> + <entry>Bit 5</entry> + <entry spanname="2to4">予約済み, 常に 0. </entry> + </row> + + <row> + <entry>Bit 4</entry> + <entry spanname="2to4">予約済み, 常に 0. </entry> + </row> + + <row> + <entry>Bit 3</entry> + <entry spanname="2to4">DMA Mode Select. Bit 0 + が「1」 (FIFO 有効) に設定されて いる場合, + このビットの設定は -RXRDY と -TXRDY + の処理を Mode 0 から Mode 1 へ 変更します. + </entry> + </row> + + <row> + <entry>Bit 2</entry> + <entry spanname="2to4">Transmit FIFO Reset. + このビットに「1」が書き込まれている場 合, + FIFO の内容は破棄されます. 現在送 + 信されているすべての命令は損なわれずに送 + られるでしょう. この機能は送信中止の場 + 合に役に立ちます. </entry> + </row> + + <row> + <entry>Bit 1</entry> + <entry spanname="2to4">Receiver FIFO Reset. + このビットに「1」が書き込まれている場 合, + FIFO の内容は破棄されます. 現在 shift + レジスタ内で組み立てられているすべ + ての命令は損なわれずに受信されるでしょ う. + </entry> + </row> + + <row> + <entry>Bit 0</entry> + <entry spanname="2to4">16550 FIFO Enable. + 設定されている場合, 送信 / 受信両方の FIFO + が有効になります. holding レジス タ, shift + レジスタまたは FIFO 内のすべて の内容は, + FIFO が有効または無効になっ + た時点で失われます. </entry> + </row> + </tbody> + </entrytbl> + </row> + + <row> + <entry>+0x02</entry> + <entry>read</entry> + <entrytbl cols="6"> + <colspec colnum="1" colname="col1"> + <colspec colnum="2" colname="col2"> + <colspec colnum="3" colname="col3"> + <colspec colnum="4" colname="col4"> + <colspec colnum="5" colname="col5"> + <colspec colnum="6" colname="col6"> + <spanspec namest="col1" nameend="col6" spanname="1to6"> + <spanspec namest="col2" nameend="col6" spanname="2to6"> + <tbody> + <row> + <entry spanname="1to6">Interrupt Identification + Register</entry> + </row> + + <row> + <entry>Bit 7</entry> + <entry spanname="2to6">FIFO有効. + 8250/16450 UART では, このビットはゼロ. </entry> + </row> + + <row> + <entry>Bit 6</entry> + <entry spanname="2to6">FIFO有効. + 8250/16450 UART では, このビットはゼロ. </entry> + </row> + + <row> + <entry>Bit 5</entry> + <entry spanname="2to6">予約済み, 常に0. </entry> + </row> + + <row> + <entry>Bit 4</entry> + <entry spanname="2to6">予約済み, 常に0. </entry> + </row> + + <row> + <entry>Bit 3</entry> + <entry spanname="2to6">Interrupt ID Bit #2. + 8250/16450 UART では, このビットはゼロ. + </entry> + </row> + + <row> + <entry>Bit 2</entry> + <entry spanname="2to6">Interrupt ID Bit #1</entry> + </row> + + <row> + <entry>Bit 1</entry> + <entry spanname="2to6">Interrupt ID Bit #0. + これらの3つのビットは進行中の割り込み + を引き起こしたイベントのカテゴリを併せ + て報告します. これらのカテゴリは優先度 + を持つため, イベントの複数のカテゴリが + 同時に発生した場合, UART は最初に最も + 重要なイベントを報告し, ホストは報告さ + れた順に解決するでしょう. 現在の割り込 + みを引き起こしたすべてのイベントは, 新し + い割り込みが生成される前に解決されなけ + ればなりません (これは PC のアーキテク + チャの制限です).</entry> + </row> + + <row> + <entry colname="col2">2</entry> + <entry colname="col3">1</entry> + <entry colname="col4">0</entry> + <entry colname="col5">優先度</entry> + <entry colname="col6">説明</entry> + </row> + + <row> + <entry colname="col2">0</entry> + <entry colname="col3">1</entry> + <entry colname="col4">1</entry> + <entry colname="col5">First</entry> + <entry colname="col6">レシーバエラー (OE, PE, BI, + また FE)</entry> + </row> + + <row> + <entry colname="col2">0</entry> + <entry colname="col3">1</entry> + <entry colname="col4">0</entry> + <entry colname="col5">Second</entry> + <entry colname="col6">有効な受信データ</entry> + </row> + + <row> + <entry colname="col2">1</entry> + <entry colname="col3">1</entry> + <entry colname="col4">0</entry> + <entry colname="col5">Second</entry> + <entry colname="col6">トリガーレベル識別子 + (受信バッファ中の古いデータ)</entry> + </row> + + <row> + <entry colname="col2">0</entry> + <entry colname="col3">0</entry> + <entry colname="col4">1</entry> + <entry colname="col5">Third</entry> + <entry colname="col6">トランスミッタに + 命令用の空きがある + (THRE)</entry> + </row> + + <row> + <entry colname="col2">0</entry> + <entry colname="col3">0</entry> + <entry colname="col4">0</entry> + <entry colname="col5">Fourth</entry> + <entry colname="col6">モデムの状態が + 変わった (-CTS, + -DSR, -RI, または + -DCD)</entry> + </row> + + <row> + <entry>Bit 0</entry> + <entry spanname="2to6">Interrupt Pending Bit. + このビットが「0」に設定されている場合, + 少なくとも一つの割り込みがペンディング + されています. </entry> + </row> + </tbody> + </entrytbl> + </row> + + <row> + <entry>+0x03</entry> + <entry>write/read</entry> + <entrytbl cols="5"> + <colspec colnum="1" colname="col1"> + <colspec colnum="2" colname="col2"> + <colspec colnum="3" colname="col3"> + <colspec colnum="4" colname="col4"> + <colspec colnum="5" colname="col5"> + <spanspec namest="col1" nameend="col5" spanname="1to5"> + <spanspec namest="col2" nameend="col5" spanname="2to5"> + <spanspec namest="col4" nameend="col5" spanname="4to5"> + <tbody> + <row> + <entry spanname="1to5">Line Control + Register (LCR)</entry> + </row> + + <row> + <entry>Bit 7</entry> + <entry spanname="2to5">Divisor Latch Access + Bit (DLAB). 設定されている場合, + transmit/receive register (THR/RBR) と + Interrupt Enable Register (IER) + へのアクセスが無効にな ります. + 現在これらのポートへのすべてのア クセスは + Divisor Latch Register へリダ + イレクトされます. このビットの設定, Divisor + Register のローディング, そし て DLAB + のクリアは割り込みが無効になっ + ている状態でおこなわれるべきです. </entry> + </row> + + <row> + <entry>Bit 6</entry> + <entry spanname="2to5">Set Break. + 「1」に設定されている場合, トランスミッ + タはこのビットが「0」に設定されるまで + スペースを切り目なく送信します. これは + 送信されている文字のすべてのビットに優先 + します. </entry> + </row> + + <row> + <entry>Bit 5</entry> + <entry spanname="2to5">Stick Parity. parity + が有効になっている場合, このビッ + トの設定はビット4の値に基づき parity + を常に「1」か「0」にします. </entry> + </row> + + <row> + <entry>Bit 4</entry> + <entry spanname="2to5">Even Parity Select + (EPS). parity が有効でビット5が「0」の場合, + このビットの設定は偶数 parity が送信そ + して要求されるようにします. そうでなけ + れば奇数 parity が使用されます. </entry> + </row> + + <row> + <entry>Bit 3</entry> + <entry spanname="2to5">Parity Enable (PEN). + 「1」に設定されている場合, データの最 + 後のビットとストップビットの間に parity + ビットが挿入されます. また UART + は受信データに存在する parity を要求す + るでしょう. </entry> + </row> + + <row> + <entry>Bit 2</entry> + <entry spanname="2to5">Number of Stop Bits + (STB). 「1」に設定されている場合, 5-bit デー + タ命令を使用して, 1.5の Stop ビットが + 送信され各データ命令内に要求されま す. 6, 7 + そして 8-bit データ命令に対し ては, 2つの + Stop ビットが送信され要求 されます. + このビットが「0」に設定され ている場合, + 1つの Stop ビットが各デー + タ命令で使用されます. </entry> + </row> + + <row> + <entry>Bit 1</entry> + <entry spanname="2to5">Word Length Select Bit #1 + (WLSB1)</entry> + </row> + + <row> + <entry>Bit 0</entry> + <entry spanname="2to5">Word Length Select Bit #0 + (WLSB0)</entry> + </row> + + <row> + <entry colname="col2" + spanname="2to5">これらのビットは共に + 各データ命令内のビッ トの数を指定します. + </entry> + </row> + + <row> + <entry colname="col2">1</entry> + <entry colname="col3">0</entry> + <entry colname="col4" spanname="4to5">命令長</entry> + </row> + + <row> + <entry colname="col2">0</entry> + <entry colname="col3">0</entry> + <entry colname="col4" spanname="4to5">5 Data + Bits</entry> + </row> + + <row> + <entry colname="col2">0</entry> + <entry colname="col3">1</entry> + <entry colname="col4" spanname="4to5">6 Data + Bits</entry> + </row> + + <row> + <entry colname="col2">1</entry> + <entry colname="col3">0</entry> + <entry colname="col4" spanname="4to5">7 Data + Bits</entry> + </row> + + <row> + <entry colname="col2">1</entry> + <entry colname="col3">1</entry> + <entry colname="col4" spanname="4to5">8 Data + Bits</entry> + </row> + </tbody> + </entrytbl> + </row> + + <row> + <entry>+0x04</entry> + <entry>write/read</entry> + <entrytbl cols="2"> + <colspec colnum="1" colname="col1"> + <colspec colnum="2" colname="col2"> + <spanspec namest="col1" nameend="col2" spanname="1to2"> + <tbody> + <row> + <entry spanname="1to2">Modem Control Register + (MCR)</entry> + </row> + + <row> + <entry>Bit 7</entry> + <entry>予約済み, 常に 0. </entry> + </row> + + <row> + <entry>Bit 6</entry> + <entry>予約済み, 常に 0. </entry> + </row> + + <row> + <entry>Bit 5</entry> + <entry>予約済み, 常に 0. </entry> + </row> + + <row> + <entry>Bit 4</entry> + <entry>Loop-Back Enable. + 「1」に設定されている場合, UART のトラ + ンスミッタとレシーバは診断処理のために + 内部的に相互に接続されます. 付け加えて UART + のモデム制御出力はモデム制御入力 + に接続されます. CTS は RTS へ, DTR は + DSRへ, OUT 1 は R1 へ, OUT 2 は DCD へ + 各々接続されます. </entry> + </row> + + <row> + <entry>Bit 3</entry> + <entry>OUT 2. ホストのプロセッサが high または + low に設定するであろう補助的な出力. IBM PC + のシリアルアダプタ (とクローンの殆ど) では, + OUT 2 は 8250/16450/16550 UART + からの割り込み信号をハイインピーダンス + (無効) にするのに使用されます. </entry> + </row> + + <row> + <entry>Bit 2</entry> + <entry>OUT 1. ホストのプロセッサが high または + low に設定するであろう補助的な出力. IBM PC + のシリアルアダプタではこの出力は使用 + されません. </entry> + </row> + + <row> + <entry>Bit 1</entry> + <entry>Request to Send (RTS). + 「1」に設定されている場合, UART の -RTS + ラインの出力は Low (有効) となり ます. + </entry> + </row> + + <row> + <entry>Bit 0</entry> + <entry>Data Terminal Ready (DTR). + 「1」に設定されている場合, UART の -DTR + ラインの出力は Low (有効) となり ます. + </entry> + </row> + </tbody> + </entrytbl> + </row> + + <row> + <entry>+0x05</entry> + <entry>write/read</entry> + <entrytbl cols="2"> + <colspec colnum="1" colname="col1"> + <colspec colnum="2" colname="col2"> + <spanspec namest="col1" nameend="col2" spanname="1to2"> + <tbody> + <row> + <entry spanname="1to2">Line Status Register + (LSR)</entry> + </row> + + <row> + <entry>Bit 7</entry> + <entry>Error in Receiver FIFO. 8250/16450 UART + では, このビットはゼロ です. + FIFOの中に次のエラー条件が一つ以 + 上含まれている場合, このビットは「1」 + に設定されます: PE, FE, または BI. </entry> + </row> + + <row> + <entry>Bit 6</entry> + <entry>Transmitter Empty (TEMT). + 「1」に設定されている場合, 送信 FIFO + または送信 shift レジスタ中に残ってい + る命令はありません. トランスミッタは完 + 全に働いていません. </entry> + </row> + + <row> + <entry>Bit 5</entry> + <entry>Transmitter Holding Register Empty + (THRE). 「1」に設定されている場合, 現在 FIFO + (または holding レジスタ) には少なくと + も一つの送信される付加的な命令に対する + 空きあります. このビットが「1」に設定 + されている時は, 多分トランスミッタはま + だ送信しています. </entry> + </row> + + <row> + <entry>Bit 4</entry> + <entry>Break Interrupt (BI). レシーバは Break + シグナルを検知しました. </entry> + </row> + + <row> + <entry>Bit 3</entry> + <entry>Framing Error (FE). Start + ビットが検知されましたが, Stop + ビットは要求された時間内には現れません + でした. 受信された命令はおそらく勝手に + 解釈されます. </entry> + </row> + + <row> + <entry>Bit 2</entry> + <entry>Parity Error (PE). parity + ビットが受信された命令に対して 不正です. + </entry> + </row> + + <row> + <entry>Bit 1</entry> + <entry>Overrun Error (OE). + 新しい命令が受信され, 受信バッファに空 + きがありませんでした. shift レジスタに + 新たに到着した命令は破棄されます. + 8250/16450 UART では, holding レジスタ + 内の命令は破棄され新たに到着した命令は + holding レジスタに置かれます. </entry> + </row> + + <row> + <entry>Bit 0</entry> + <entry>Data Ready (DR) + 一つ以上の命令がホストが読むであろう受 信 + FIFO にあります. このビットが設定さ + れる前に, 命令は完全に受信され shift + レジスタから FIFO (または 8250/16450 + の設計では holding レジスタ) へ移動さ + れなければなりません. </entry> + </row> + </tbody> + </entrytbl> + </row> + + <row> + <entry>+0x06</entry> + <entry>write/read</entry> + <entrytbl cols="2"> + <colspec colnum="1" colname="col1"> + <colspec colnum="2" colname="col2"> + <spanspec namest="col1" nameend="col2" spanname="1to2"> + <tbody> + <row> + <entry spanname="1to2">Modem Status Register + (MSR)</entry> + </row> + + <row> + <entry>Bit 7</entry> + <entry>Data Carrier Detect (DCD). UART の DCD + ラインの状態を反映します. </entry> + </row> + + <row> + <entry>Bit 6</entry> + <entry>Ring Indicator (RI). UART の RI + ラインの状態を反映します. </entry> + </row> + + <row> + <entry>Bit 5</entry> + <entry>Data Set Ready (DSR). UART の DSR + ラインの状態を反映します. </entry> + </row> + + <row> + <entry>Bit 4</entry> + <entry>Clear To Send (CTS). UART の CTS + ラインの状態を反映します. </entry> + </row> + + <row> + <entry>Bit 3</entry> + <entry>Delta Data Carrier Detect (DDCD). + ホストによって MSR が最後に読み込まれ + た時点から, -DCD ラインが状態を一回以 + 上変えた場合に「1」に設定されます. </entry> + </row> + + <row> + <entry>Bit 2</entry> + <entry>Trailing Edge Ring Indicator (TERI). + ホストによって MSR が最後に読み込まれ + た時点から, -RI ラインが low から high + へ移り変わった場合に「1」に設定されま + す.</entry> + </row> + + <row> + <entry>Bit 1</entry> + <entry>Delta Data Set Ready (DDSR). + ホストによって MSR が最後に読み込まれ + た時点から, -DSR ラインが状態を一回以 + 上変えた場合に「1」に設定されます. </entry> + </row> + + <row> + <entry>Bit 0</entry> + <entry>Delta Clear To Send (DCTS). + ホストによって MSR が最後に読み込まれ + た時点から, -CTS ラインが状態を一回以 + 上変えた場合に「1」に設定されます. </entry> + </row> + </tbody> + </entrytbl> + </row> + + <row> + <entry>+0x07</entry> + <entry>write/read</entry> + <entry>Scratch Register (SCR). このレジスタは UART + では機能しません. この場所 には + どんな値でもホストによって書き込まれるこ とができ, + その後ホストによって読み込むことが可 + 能です.</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </sect4> + + <sect4> + <title>16550A UART を越えて</title> + + <para>ナショナル・セミコンダクタは付加的な機能を持つ 16550 + と互換 性のある部品を提供していませんが, + 色々な他のベンダがそれを持っ ています. + これらの部品の幾つかは以下に記述されています. 効果的 + にこれらの改良を使用するためには, + 殆どのポピュラーなオペレーティ ングシステムが 16550 + が提供する機能以上のものをサポートしない ため, + ドライバはチップベンダから提供されなければならないことを + 理解しておく必要があります.</para> + + <variablelist> + <varlistentry><term>ST16650</term> + <listitem> + <para>デフォルトではこの部品は NS16550A + と似ていますが, 拡 + 張された32バイトの送受信バッファを + オプションで有効にで きます. Startech + により製造されました.</para> + </listitem> + </varlistentry> + + <varlistentry><term>TIL16660</term> + <listitem> + <para>デフォルトではこの部品は NS16550A + と類似した振舞いを しますが, + 拡張された64バイトの送受信バッファをオプショ + ンで有効にできます. Texas Instruments + により製造されま した.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Hayes ESP</term> + <listitem> + <para>この専売特許のプラグインカードは, + 2048バイトの送受 信バッファを含み, 230.4Kbit/sec + のデータレートをサポー トします. Hayes + により製造されました.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>これらの“ダム”UART に加え, + たくさんのベンダがインテリジェ + ントシリアルコミニュケーションボードを製造しています. こ + のタイプの設計は通常マイクロプロセッサを提供しており, + このマイ クロプロセッサは幾つかの UART + へのインタフェースとなってデータ を処理 / + バッファリングし, そして必要な時にメインの PC のプロセッ + サへ警告を出します. UART + はこのタイプのコミニュケーションシ ステムにおいて PC + のプロセッサによって直接アクセスされないため, + ベンダにとっては 8250, 16450, または 16550 UART + と互換性のある UART を使用する必要はありません. + これにより設計者は, より良い + 性能特性を持つ部品が自由に利用できます.</para> + </sect4> + </sect3> + + <sect3 id="sio"> + <title><devicename>sio</devicename>ドライバの設定</title> + + <para><devicename>sio</devicename> ドライバは, NS8250-, + NS16450-, NS16550とNS16550A ベースの EIA RS-232C(CCITT V.24) + 通信用インタフェースをサポートします. ま た, + いくつかのマルチポートシリアルカードもサポートされています. + 技術的 な詳細についてはマニュアル &man.sio.4; + を見てください.</para> + + <sect4> + <title>Digi International (DigiBoard) PC/8</title> + + <para><emphasis>原作: &a.awebster;.<!-- <br> --> + 1995年8月26日.</emphasis></para> + + <para><emphasis>訳: &a.jp.masaki;.<!-- <br> -->6 + September 1996.</emphasis></para> + + <para>以下にDigi International + PC/8Dと16550チップを動作させるための, カーネ + ルconfigの部分を示します. このボードは, + 8本の回線にすべてモデムを接続 + した場合でも良好に動作します.</para> + + <para><literal>options COM_MULTIPORT</literal> + を加えるのを忘れないでください. 忘れる + とうまく動作しません!</para> + + <programlisting> +device sio4 at isa? port 0x100 tty flags 0xb05 device + sio5 at isa? port 0x108 tty flags 0xb05 device + sio6 at isa? port 0x110 tty flags 0xb05 device + sio7 at isa? port 0x118 tty flags 0xb05 device + sio8 at isa? port 0x120 tty flags 0xb05 device + sio9 at isa? port 0x128 tty flags 0xb05 device + sio10 at isa? port 0x130 tty flags 0xb05 device + sio11 at isa? port 0x138 tty flags 0xb05 irq 9 vector + siointr</programlisting> + + <para>ここで各 SIO + ポートが割り込みを共有する一つのグループであることを表現 + するために, トリッキーな設定をしなければなりません. フラグ + (flags の後 ろの 16 進数) の下から 2 + バイト目にこのグループの最後の SIO ポートの番 + 号を設定します. この例では 11 (16進数では 0x0b) ですから, + 各デバイスの フラグは 0xb05 となります.</para> + </sect4> + + <sect4> + <title>Boca 16</title> + + <para><emphasis>寄贈 &a.whiteside;.<!-- <br> --> + 1995年8月26日</emphasis></para> + + <para>FreeBSD で Boca 16pord + のボードを動かすことは簡単ですが, そのた + めにはいくつかの作業が必要です. :</para> + + <orderedlist> + <listitem> + <para>2.0.5 のデフォルトのカーネルは, + マルチポートのサポートを<emphasis>して + いない</emphasis> ので, + あなたは各ポート毎にデバイスエントリを追加する必要が + あります. つまり必要なオプションを付けて, + カーネルの再構築をしなければ なりません. そのためには, + あなたのマシンにカーネルのソースコードが既に + インストールされているか, + あなたの替わりの誰かにカーネル再構築をやって + もらう必要があります.</para> + </listitem> + + <listitem> + <para>2番目に, + あなたはカーネルオプションを正しく設定するために, あな + たのBoca Boardの IO + と割り込みの値を知っている必要があります.</para> + </listitem> + </orderedlist> + + <para>ひとつ重要なことがあります. Boca 16 + に使われている実際の UART チップ は, Boca 16 + のボードではなく, + 外付けのコネクタボックスの中に存在します. + コネクタボックスを接続しないと, + ポートの検出に失敗するでしょう. 私は, + 接続しないまま起動したり, + 後から接続しなおしたりした時にどうなるかをテ + ストしていません. + どちらも実行しないようお奨めします.</para> + + <para>もしあなたがカスタマイズ済みのカーネル + コンフィグレーションファイルを持っ ていなければ, + 一般的な事柄については, <link + linkend="kernelconfig">FreeBSD + カーネルのコンフィグレーション</link> + を参考にしてください. 以下にBoca 16のボード + に関係する部分だけを記述します. この例では, + あなたがMYKERNELという名前 のカーネルを使っていて, + エディタには viを使っていることを仮定していま す.</para> + + <procedure> + <step> + <para>次の1行をconfigファイルに追加してください.</para> + + <programlisting> +options COM_MULTIPORT</programlisting> + </step> + + <step> + <para>この <literal>device + sio<replaceable>n</replaceable></literal>という行を, + 必要に応じて 16 個のデバイス分を追加してください. + 最後のデバイスにだけ, このボード + の割り込みベクタを記述します. (詳細は &man.sio.4; + のマニュア ルページを参照してください.) 以下の例は, + 割り込み 3, ベース IO アドレス 100h の値を持つ Boca + Board の場合です. 各ポートのための IO アドレスは, + 100h, 108h, 110h, ... のよ うに 16 進法で 8 + づつ加えていきます.</para> + + <programlisting> +device sio1 at isa? port 0x100 tty flags 0x1005 device sio2 at isa? + port 0x108 tty flags 0x1005 device sio3 at isa? port + 0x110 tty flags 0x1005 device sio4 at isa? port 0x118 + tty flags 0x1005 … device sio15 at isa? port + 0x170 tty flags 0x1005 device sio16 at isa? port 0x178 + tty flags 0x1005 irq 3 vector siointr</programlisting> + + <para>フラグエントリは, + あなたが全く同じsioの割り当てを使っていない限り + <emphasis>必ず</emphasis> + 上記の例から変更してください. フラグは, + 次のように設定します. 0x <replaceable>M</replaceable> + <replaceable>YY</replaceable> + の<replaceable>M</replaceable>は, マスタポート (Boca + 16に搭載された最後 + のポート)のマイナー番号を指定します. さらに + <replaceable>YY</replaceable> の部分はFIFOが + 有効または無効であること (この場合は有効), 割り込みを + (ボード内で) 共 有しているか (この場合はYES), そして, + AST/4 と互換性のある持つ割り込み + 制御レジスタを持っているか (この場合はNO) + を指定します. この例では,</para> + + <programlisting> +flags 0x1005</programlisting> + + <para>というフラグによって, + マスタポートが sio16 であることを示します. も + し同じボードをもう一枚追加し, sio17 から sio28 + を割り当てるなら, <emphasis>新しい方の</emphasis> + ボードに対応する 16 個のポートのフラグはすべて 0x1C05 + に なります. 28 (== 0x1C) + は新しいボードのマスタポートのマイナー番号で す. + フラグの 05 の部分は変更しないでください.</para> + </step> + + <step> + <para>カーネルコンフィグレーションファイルを + 保存してカーネルの設定を完了しま す. + カーネルをコンパイル後, インストールし, + 新しいカーネルでリブートし てください. + 再コンパイルされたカーネルがうまくインストールされて, + そのカーネルに正 + しいアドレスと割り込みが設定されていたならば, + ブートメッセージは次の ように Boca + ポートの検出に成功するはずです: (sioの番号, + IOとIRQの値は, この例とは異なっているでしょう)</para> + + <screen>sio1 at 0x100-0x107 flags 0x1005 on isa +sio1: type 16550A (multiport) +sio2 at 0x108-0x10f flags 0x1005 on isa +sio2: type 16550A (multiport) +sio3 at 0x110-0x117 flags 0x1005 on isa +sio3: type 16550A (multiport) +sio4 at 0x118-0x11f flags 0x1005 on isa +sio4: type 16550A (multiport) +sio5 at 0x120-0x127 flags 0x1005 on isa +sio5: type 16550A (multiport) +sio6 at 0x128-0x12f flags 0x1005 on isa +sio6: type 16550A (multiport) +sio7 at 0x130-0x137 flags 0x1005 on isa +sio7: type 16550A (multiport) +sio8 at 0x138-0x13f flags 0x1005 on isa +sio8: type 16550A (multiport) +sio9 at 0x140-0x147 flags 0x1005 on isa +sio9: type 16550A (multiport) +sio10 at 0x148-0x14f flags 0x1005 on isa +sio10: type 16550A (multiport) +sio11 at 0x150-0x157 flags 0x1005 on isa +sio11: type 16550A (multiport) +sio12 at 0x158-0x15f flags 0x1005 on isa +sio12: type 16550A (multiport) +sio13 at 0x160-0x167 flags 0x1005 on isa +sio13: type 16550A (multiport) +sio14 at 0x168-0x16f flags 0x1005 on isa +sio14: type 16550A (multiport) +sio15 at 0x170-0x177 flags 0x1005 on isa +sio15: type 16550A (multiport) +sio16 at 0x178-0x17f irq 3 flags 0x1005 on isa +sio16: type 16550A (multiport master)</screen> + + <para>もしメッセージの表示が速くて読み取れないときは, + + <screen>&prompt.root; <userinput>dmesg | more</userinput></screen> + + とするとブート時のメッセージを + ゆっくり見ることができます.</para> + </step> + + <step> + <para>次に, root になってから, + デバイスにあわせたエントリを + <filename>/dev/MAKEDEV</filename> + スクリプトを使って<filename>/dev</filename> + に追加します. </para> + + <screen>&prompt.root; <userinput>cd /dev</userinput> +&prompt.root; <userinput>./MAKEDEV tty1</userinput> +&prompt.root; <userinput>./MAKEDEV cua1</userinput> +<emphasis>(中略)</emphasis> +&prompt.root; <userinput>./MAKEDEV ttyg</userinput> +&prompt.root; <userinput>./MAKEDEV cuag</userinput></screen> + + <para>もし, 何らかの理由で発信するデバイスが不要な場合, + <filename>cua*</filename> デバ + イスを作らないで済ますこともできます.</para> + </step> + + <step> + <para>デバイスが確実に動作しているかどうか + 確認する手っ取り早い方法は, あなたが (rootになって) + 各ポートにモデムを接続してみて, あなたが作成し + た各デバイス毎に</para> + + <screen>&prompt.root; <userinput>echo at> ttyd*</userinput></screen> + + <para>とやってみてください. 各ポー トが動作していれば + RXの表示が光るのが見える<emphasis>はず</emphasis> + です.</para> + </step> + </procedure> + </sect4> + </sect3> + + <sect3 id="cy"> + <title><devicename>cy</devicename> ドライバのコンフィグ</title> + + <para><emphasis>原作: &a.alex;.<!-- <br> --> + 6 June 1996.</emphasis></para> + + <para><emphasis>訳: &a.jp.yuki;.<!-- <br> --> + 6 September 1996.</emphasis></para> + + <para>Cyclades 社のマルチポートカードは, + 他のマルチポートカードが 使う <devicename>sio</devicename> + の代わりに <devicename>cy</devicename>ドライバを使います. + コンフィグレーションは非常に簡単で,</para> + + <procedure> + <step> + <para><devicename>cy</devicename> デバイスをあなたの <link + linkend="kernelconfig-config">カーネルの + コンフィグレーション</link>に足します. (注意. + あなたのirqやiomemの設定が違っているかもしれません)</para> + + <programlisting> +device cy0 at isa? tty irq 10 iomem 0xd4000 iosiz 0x2000 vector cyintr</programlisting> + </step> + + <step> + <para>新しいカーネルの <link + linkend="kernelconfig-building">再構成と + インストール</link> をします.</para> + </step> + + <step> + <para><link + linkend="kernelconfig-nodes">デバイスノード</link> + を次(8ポートと仮定しています.) + のように打って作ります:</para> + + <screen>&prompt.root; <userinput>cd /dev</userinput> +&prompt.root; <userinput>for i in 0 1 2 3 4 5 6 7;do ./MAKEDEV cuac$i ttyc$i;done</userinput></screen> + </step> + + <step> + <para>もし, 必要なら シリアルデバイス + (<literal>ttyd</literal>) とそっくりにコピーして <link + linkend="dialup">dialup</link>エントリを作り, + <literal>ttyd</literal>の代わりに + <literal>ttyc</literal>を使います. 例:</para> + + <programlisting> +ttyc0 "/usr/libexec/getty std.38400" unknown on insecure +ttyc1 "/usr/libexec/getty std.38400" unknown on insecure +ttyc2 "/usr/libexec/getty std.38400" unknown on insecure +… +ttyc7 "/usr/libexec/getty std.38400" unknown on insecure</programlisting> + </step> + + <step> + <para>新しいカーネルで立ち上げます.</para> + </step> + </procedure> + </sect3> + </sect2> + + <sect2> + <title>* パラレルカード</title> + + <para></para> + </sect2> + + <sect2> + <title>* モデム</title> + + <para></para> + </sect2> + + <sect2> + <title>* ネットワークカード</title> + + <para></para> + </sect2> + + <sect2> + <title>* キーボード</title> + + <para></para> + </sect2> + + <sect2> + <title>* マウス</title> + + <para></para> + </sect2> + + <sect2> + <title>* その他</title> + + <para></para> + </sect2> + </sect1> + + <sect1 id="hw-storage"> + <title>記憶装置</title> + + <sect2 id="esdi"> + <title>ESDIハードディスクの使い方</title> + + <para><emphasis>原作および Copyright © 1995, &a.wilko;. + <!-- <br> -->24 September 1995.</emphasis></para> + + <para><emphasis>訳: &a.jp.ts;<!-- <br> --> + 2 September 1996.</emphasis></para> + + <para>ESDIとは Enhanced Small Device Interfaceの略語です. + この技術は, 馴染み 深い ST506や + ST412といったインタフェースに基づくものであり, 世界初の普 及型 + 5.25インチのウィンチェスタディスクを造ったSeagate + Technology社に よって最初に作られました.</para> + + <para>ESDIの Eは拡張 (Enhanced) を表しており, + 実際そのとおりです. まず, イン タフェースの速度は速く, 10 + ないし 15Mビット/秒であり, ST412インタフェー + スに接続したドライブの 5Mビット/秒よりも高速です. また, + 上位レベルのコ マンドがいくつか追加されて, + オペレーティングシステムレベルのドライバ作 成者にとって, + ESDIインタフェースはある程度インテリジェントなものとなり + ました. ただし SCSIほどにインテリジェントではありません. + ESDIは ANSIが 標準化をおこなっています.</para> + + <para>トラックごとのセクタ数を増やすことで, + ESDIドライブの記憶容量は引き上げ られました. 通常, + トラックあたり 35セクタですが, 今までに筆者がみたド + ライブの中で大容量のものは, トラックあたり + 54セクタもありました.</para> + + <para>ESDIは IDEや + SCSIといったインタフェースの普及によって消えつつあります が, + 無料あるいは在庫処分の 格安なドライブが入手可能であることを + 考えると, 少ない (もしくは現状の) + 予算で縛られたシステムにとって, ESDIドライブは + 理想的です.</para> + + <sect3> + <title>ESDIのコンセプト</title> + + <sect4> + <title>物理的な接続</title> + + <para>ESDIインタフェースでは, + ドライブごとに2つのケーブルを接続します. 第 1 + のケーブルは34ピンのフラットケーブルエッジコネクタで, + コントローラとド ライブ間のコマンドおよびステータスの + 両信号のやりとりのためのものです. コマンド用ケーブルは, + すべての ESDIドライブをデイジーチェーンで結び ますから, + すべてのドライブを接続したバスを構成することに + なります.</para> + + <para>第 2 のケーブルは 20 ピンのフラットケーブル + エッジコネクタで, ドライブへの データ入出力に使います. + このケーブルは放射状に接続しますから, ドライブ + ごとにコントローラへの専用接続を持つことに + なるわけです.</para> + + <para>筆者の経験によれば, PC向け ESDI コントローラには, + コントローラあたり最 大 2 + 台までのデバイス接続が可能という制限がありました. これは, + ドライ ブのアドレス割り当てのために, + 単一ビットだけを用意したという WD1003 か + ら持ち越された互換 (?) 機能なのだと思われます.</para> + </sect4> + + <sect4> + <title>デバイスのアドレス指定</title> + + <para>1本のコマンドケーブルには最大で 7つのデバイスと + 1つのコントローラを接 続することができます. + どのドライブをコントローラがアドレスしているのか + を個別に認識できるようにするために, ESDIデバイスは, + デバイスアドレスを + 設定するためのジャンパかスイッチを備えています.</para> + + <para>PC向けコントローラでは, + 最初のドライブにはアドレス0を設定し, 第2番目の + ディスクへはアドレス1を設定します. + <emphasis>いつも留意すべきことは, </emphasis> + ディスクごとに固有のアドレスを必ず設定するということです! + つまり, コン トローラあたり最大2台のドライブというような + PC向けのものでは, 第1 ドラ イブは第0番ドライブで, + 第2ドライブは第1番ドライブだということです.</para> + </sect4> + + <sect4> + <title>ターミネート処理 (termination)</title> + + <para>デイジーチェーン接続用コマンドケーブル + (34ピンのケーブルであることを覚 えていますか? ) では, + 最後のチェーン接続ドライブでターミネートしなけれ + ばなりません. このために, + ESDIドライブにはターミネート用抵抗ネットワー + クが付属しており, + ターミネートする必要がないときにはその抵抗をドライブ + から外したり, またはジャンパで無効 (disable) + にすることができるようになっ ています.</para> + + <para>したがって, ひとつのドライブ, + すなわちコマンドケーブルの最終端に位置す + るドライブ<emphasis>だけ</emphasis>が, + そのターミネート用抵抗を有効 (installまたは enable) + にすることができます. + コントローラは自動的にコマンドケーブルのもう一方 + の端のターミネート用抵抗を有効にします. + ご注意いただきたいのは, コント + ローラは必ずコマンドケーブルのいずれかの + 端に位置しなければならず, けっ + して途中に位置するようにしては + <emphasis>いけない</emphasis> ということです.</para> + </sect4> + </sect3> + + <sect3> + <title>ESDIディスクの FreeBSDでの使い方</title> + + <para>ESDI を初めて動かすようにすることが, + どうしてこうも大変なことなのでしょ うか ?</para> + + <para>ESDIディスクを FreeBSD + で動かそうと試みた人たちが激烈なイライラを募らせ + たことは知られています. 今までまったく + ESDIを知らない場合には, 複数の 要因の組み合わせが悪く働いて, + ESDIへの理解を妨げることになるかもしれま せん.</para> + + <para>このことは, ESDIと + FreeBSDの組み合わせは選んではいけないという俗説も生 + み出しました. 以下の節において, 落し穴のすべてとその解決策を + 述べてみようと思います.</para> + + <sect4> + <title>ESDI速度の違い</title> + + <para>すでに簡単に紹介したように, + ESDIは2種類の速度を持っています. 旧式のド + ライブとコントローラは 10Mビット/秒のデータ転送速度ですが, + 新しいもの では 15Mビット/秒が利用できます.</para> + + <para>仮に 10Mビット/秒のコントローラへ + 15Mビット/秒のドライブを接続したよ + うな場合に問題が生じることを予想することは簡単です. + したがって必ず, コ ントローラ <emphasis>および</emphasis> + ドライブのマニュアルを参照して, それぞれの 転送速度が + 一致しているかどうかを調べるようにしてください.</para> + </sect4> + + <sect4> + <title>トラックについて</title> + + <para>主流の ESDIドライブは, + トラックあたり34ないし36個のセクタを持ちます. + しかし大部分の (古い) + コントローラは36個以上のセクタを扱うことができま + せん.</para> + + <para>新しい大容量のドライブでは, + トラックごとにさらに多くの数のセクタを持つ ことができます. + たとえば筆者の 670MBのドライブは, トラックあたり 54セ + クタも持たせることができます.</para> + + <para>筆者のコントローラは 54 + セクタ数をサポートしていませんでしたが, トラック あたり 35 + セクタという設定で, 問題なく動作しました. しかし, + これが意味す + るのは大量のディスク容量を失うということです.</para> + + <para>もう一度, + 詳しい情報についてハードウェアのドキュメントを + 調べてください. + この例のような仕様からはずれた設定をしたときには, + うまく動くかもしれま せんが, 動かないこともあります. + そのようなときには, 別のより多くの機能 + をもつコントローラで試してみるようにしてください.</para> + </sect4> + + <sect4> + <title>ハードセクタとソフトセクタ</title> + + <para>多くの ESDIドライブでは, + ハードセクタまたはソフトセクタによる処理を, + ジャンパ設定で指定することができます. ハードセクタとは, + 新しいセクタの 開始位置において, + ESDIドライブにセクタパルス (sector pulse) を発生させ + ることです. コントローラはこのパルスを利用して, + 書き込みや読み取りのタ イミングを指示します.</para> + + <para>ハードセクタではセクタのサイズを選ぶことができます + (通常はフォーマット 後セクタあたり256, 512, + および1024バイト). FreeBSDは512バイトのセクタ + サイズを使います. トラックあたりのセクタ数は, + 同じように選択に幅があり ますが, + フォーマット後のセクタのバイト数はすべて同じです. + セクタごとの <emphasis>未フォーマット</emphasis> + のバイト数は, コントローラがどの程度の調整用の + バイト数を必要とするかによって異なります. + トラックあたりのセクタ数を多 くすれば記憶容量は増えますが, + もしドライブから与えられるバイト数よりも + 多くのものをコントローラが必要とするのであれば, + 問題を生じることがあり ます.</para> + + <para>ソフトセクタでは, + コントローラ自身が読み書きの始まりと終りの位置を決め ます. + なお, ESDI (筆者が知り得たものすべて) では, + ハードセクタがデフォ ルトのようです. + ソフトセクタを試みる必要性は感じたことがありません.</para> + + <para>通常, FreeBSDをインストールする以前に, + まずセクタ処理の設定を試される ことをおすすめします. + というのも, セクタ処理の設定を変えるたびに, 物理 + フォーマット (low-level format) + をしなければならないからです.</para> + </sect4> + + <sect4> + <title>物理フォーマット処理</title> + + <para>ESDIドライブは, 使い始める前に, + 物理フォーマットをおこなう必要があります. + もしトラックあたりのセクタ数を変えたり, + ドライブの物理的な設置方法 (水 平や垂直方向) + を変えたときには, ふたたびフォーマットする必要があります + から, よく検討した後でフォーマットしてください. + フォーマット処理の所要 時間を短く予想してはいけません. + 大容量のディスクでは数時間を要します.</para> + + <para>物理フォーマットが終わったならば, サーフィススキャン + (surface scan) を おこない, + バッドセクタの検出とフラグの処理をします. + ほとんどのディスクには, + メーカが作成したバッドブロックリストを + 記録した用紙またはステッカーが付 いています. さらに, + ほとんどのディスク内にもバッドブロックリストが記録 + されています. + メーカが作成したリストを利用するようにしてください. この + 時点で不良部分をマップし直す方が, + FreeBSDのインストール後におこなうよりも, + はるかに簡単です.</para> + + <para>物理フォーマットプログラムのなかでも, + トラックの中にひとつでもバッドセ クタがあれば, + 同じトラック内の残りのすべてのセクタを不良とするようなプ + ログラムがありますから, + そのようなものは利用しないようにしてください. + ディスクスペースの浪費だけでなく, より重大な + bad144と関連した悲劇の原 因にもなるからです + (bad144の節を参照のこと).</para> + </sect4> + + <sect4> + <title>トランスレーション</title> + + <para>トランスレーションが, + ESDIだけに限定された問題ではないにもかかわらず, + 重大な困難になることがあります. + トランスレーションにはいくつかの側面が あります. + 多くに共通なものは, IBM + PC/ATのオリジナルの設計に起因するディ + スクジオメトリに関する制限を, + うまく回避するような調整を試みるものです (IBM に感謝 ! + ).</para> + + <para>まずはじめに, 1024シリンダに関する (悪) + 名高い制限があります. すなわ ち, + ブート可能なシステムについて, システム関連ファイルは + (オペレーティ ングシステムがどのようなものであっても) , + ディスクの先頭部分の 1024シ リンダ内になければいけない, + という制限です. シリンダ番号を表すためには + 10ビットしか与えられていません. セクタの総数については, + 上限は 64 (0か ら 63) です. この1024シリンダの制限を, + 16ヘッドの制限 (これも ATの仕様 による) と組み合わせると, + かなり限定されたディスク容量しか利用できませ ん.</para> + + <para>この難点を解消するために, PC 向け + ESDIコントローラのメーカは, 自社のコ ントローラボードへ + BIOS PROM拡張を施しました. この BIOS拡張の内容は, + ブート時のディスクI/Oを (OSによっては + <emphasis>すべて</emphasis> のディスクI/Oも) , + トランスレーションを用いておこなうというものです. + すなわち, 大容量のディ スクを, あたかも 32 + ヘッドかつトラックあたり 64 セクタであるようなデバイス + として OSへ知らせるのです. この結果, 総シリンダー数は + 1024よりも少なく なりますから, + 上記の難点などなかったものとして大容量ディスクを使うこと + ができるようになります. なお, 注目いただきたいことは, + FreeBSDカーネル の起動以降, FreeBSDはこの + BIOS拡張機能を使わないということです. 詳しく + は後ほどご説明いたします.</para> + + <para>トランスレーションの第 2 の存在理由は, + 多くの旧いシステムBIOSが, トラッ クあたり 17 + セクタのドライブだけしか扱えない (ST412 という古い仕様) + から, というものです. 比較的新しい BIOSは通常, + 自由な値を設定できるドライブ タイプ + (多くの場合ドライブタイプ47) を持っています.</para> + + <warning> + <para>この文書を読み終えられた後で, + どのようにトランスレーションを利用す るにせよ, + ぜひご留意いただきたいことがあります. もし複数の + OSをひとつ のディスクにインストールするときには, + 必ず同じトランスレーションを使わ なければなりません. + </para> + </warning> + + <para>トランスレーションに関して, + 筆者が使用したコントローラは, ひとつのドラ + イブを複数のパーティションに論理的に + 分けることができる機能を BIOS のオ + プションとして持っていました + (このような製品はいくつかあると思われる). しかし, + ひとつのドライブにはひとつのパーティションに限定しました. + なぜ なら, このコントローラはパーティション情報を + ディスクへ書き出すからです. つまり, 電源を入れると, + コントローラはこの情報を読み取り, OSに対してディ + スクから読みとった情報に基づくデバイスとして + 知らせるからです.</para> + </sect4> + + <sect4> + <title>代替セクタ処理</title> + + <para>多くの ESDI コントローラはバッドセクタを + 取り替える機能を備えています. + ディスクの物理フォーマット処理の途中もしくは終了時に, + バッドセクタであ ることを記録して, + 代わりのセクタを壊れたセクタの位置へ (論理的に) 置き + ます.</para> + + <para>通常この置き換え処理は, トラック内の N-1 + 個のセクタを実際のデータ記録に 使い, + 第N番目のセクタだけを代替セクタとすることで実現します. + ここでNと いう値はトラック内の物理的セクタの総数です. + このアイデアが生まれた背景 は, + オペレーティングシステムが壊れたセクタを持たない 「完全」 + なディスク を想定している, というものです. しかし + FreeBSDではこのアイデアを使うこ とはできません.</para> + + <para>理由は, <emphasis>使用不可 (bad)</emphasis> から + <emphasis>使用可能</emphasis> への変換をおこなう のが + ESDIコントローラ上の BIOSだからなのです. FreeBSDは, 真の + 32ビット のオペレーティングシステムであるために, + ブート後には BIOSを使いません. 代わりに + FreeBSDが使うのは, + ハードウェアと直接「対話」するデバイスドラ + イバというものです.</para> + + <para><emphasis>結論: + 代替セクタ処理やバッドブロックマッピングなど, + コントローラ・ メーカがなんと呼ぶかは判りませんが, + それらに似た機能を FreeBSDのディス + クへは使わないでください. </emphasis></para> + </sect4> + + <sect4> + <title>バッドブロックの取り扱い</title> + + <para>前節から残された問題があります. すなわち, + コントローラによるバッドブロッ + ク処理は利用できない状況であるにもかかわらず, + FreeBSDのファイルシステ + ムが想定しているのはあくまで完全無欠なディスクである, + という問題で す. これを解消するために, FreeBSDは + <command>bad144</command> というツールを採用 しています. + この <command>bad144</command> (この名前は + DEC社の標準となったバッドブロック 処理に由来している) は, + FreeBSDのスライスごとにバッドブロックを調べま す. + バッドブロックを見つけ出すと, <command>bad144</command> + は傷ついたブロック番号によるテー ブルを + FreeBSDスライスの末尾へ書き込みます.</para> + + <para>ディスクが動作し始めると, + ディスクから読みとられたテーブルを基に, ディ + スクアクセスを調べます. この <command>bad144</command> + リストに記録されたブロック番号への 要求が起こると, + 代わりのブロック (同じく FreeBSDスライスの末尾に位置す る) + を使います. このように, <command>bad144</command> + による置換手続きによって 「完全」 なディ スクを FreeBSD + ファイルシステムへ提供しているのです.</para> + + <para><command>bad144</command> + の使用により陥るかもしれない落し穴があります. まず, + ひとつのス ライスには 126 + 個以上のバッドセクタを持てません. もしドライブに 126 + 個以上 のバッドセクタがあったときには, 複数の FreeBSD + のスライスに分けて, 各ス ライスのバッドセクタが 126 + 個以下となるようにする必要があります. くれぐ れも, + ひとつのトラック内にたったひとつの欠陥セクタが + 見つかっただけで, そのトラック内セクタ + <emphasis>すべて</emphasis> + を傷ついたものとして記録するよう + な物理フォーマットプログラムを使わないようにしてください. + 簡単にお解り いただけると思いますが, + このような物理フォーマットをおこなえば, 126個の制 + 限は短時間で達成してしまいます.</para> + + <para>次に, もしスライスが root + ファイルシステムを含んでいるときには, 1024シ + リンダ以内という BIOSの制限を守っていなければなりません. + ブート処理の ときですから, bad144 リストは BIOS + を使って読み取りますので, このリスト が 1024 + シリンダ限界以内に位置していなければ読みとれません.</para> + + <note> + <para>この制限は root + <emphasis>ファイルシステム</emphasis> だけ + が1024シリンダ限界以内にあれば十分ということではなく, + rootシステムを含 んだ <emphasis>スライス</emphasis> + 全体が1024シリンダ限界以内におさまっている必要 + があります.</para> + </note> + </sect4> + + <sect4> + <title>カーネルのコンフィグレーション</title> + + <para>ESDIディスクを扱うドライバは, IDEや ST412 + MFMディスクなどと同じ <literal>wd</literal> ドライバです. + この <literal>wd</literal> ドライバは, すべての WD1003 + 互換インタフェースにも利用できるはずです.</para> + + <para>大部分のハードウェアは, ジャンパの設定によって, + ふたつの I/Oアドレス範 囲と IRQ 値のうちから, + それぞれひとつを選ぶことができます. したがって, wd + タイプのふたつのコントローラを + ひとつのシステムで使うことができます.</para> + + <para>もし設定しようとしているハードウェアが + 標準以外の割り当てをサポートして いれば, + 適切な設定情報をカーネルのコンフィグレーションファイルに + 記述す ることで, この非標準割り当てを利用できます. + 次にカーネルのコンフィグレー ションファイルの例を示します + (このファイルがあるディレクトリは + <filename>/sys/i386/conf</filename> である).</para> + + <programlisting> +# First WD compatible controller +controller wdc0 at isa? port "IO_WD1" bio irq 14 vector wdintr +disk wd0 at wdc0 drive 0 +disk wd1 at wdc0 drive 1 + +# Second WD compatible controller +controller wdc1 at isa? port "IO_WD2" bio irq 15 vector wdintr +disk wd2 at wdc1 drive 0 +disk wd3 at wdc1 drive 1</programlisting> + </sect4> + </sect3> + + <sect3> + <title>ESDIハードウェアの例</title> + + <sect4> + <title>Adaptec 2320コントローラ</title> + + <para>筆者は, ACB-2320でコントロールされた ESDIディスクへ, + FreeBSDをインストー ルすることができました. なお, + このディスクには他のオペレーティングシス + テムをインストールしていません.</para> + + <para>インストールするために, まず, + <command>NEFMT.EXE</command> (<hostid + role="fqdn">www.adaptec.com</hostid> から + <command>ftp</command>可能) + でディスクを物理フォーマットし, かつトラックを代替セ + クタとともにフォーマットするかどうかの設問に + NOと答えました. また ACB-2320の + BIOSは使わないように設定しました. そしてシステム + BIOSがブー トできるように, システム + BIOSの<literal>自由に設定可能</literal> + オプションを使いまし た.</para> + + <para>実は, <command>NEFMT.EXE</command>を使う以前に, まず + ACB-2320 の BIOSに組み込まれているフォー + マットプログラムでディスクをフォーマットしてみましたが, + 使えないことが 判りました. なぜなら, + 代替セクタの処理をおこなわないようにするオプションが + 用意されていないからです. + 代替セクタ処理をおこなうようにすると, FreeBSDの + インストール作業は + <command>bad144</command>の実行の段階で失敗しました.</para> + + <para>もし ACB-232<replaceable>xy</replaceable> + をお持ちであれば, そのバージョン番号に注意してください. + 文字 <replaceable>x</replaceable> には + <literal>0</literal> か <literal>2</literal> が入りまして, + ボード上にフロッピーコントローラがあるかど + うかを見分けることができます.</para> + <!-- kuriyama - y should replaceable? --> + + <para>文字 <literal>y</literal>はさらに興味深いもので, + ブランクか, <literal>A-8</literal>か, または + <literal>D</literal>のいずれかで す. ブランクは, + 単純な10Mビット/秒のコントローラであることを表します. + <literal>A-8</literal>は, 15Mビット/秒のコントローラで, + かつ 52セクタ/トラックをサポート + しているものであることを表します. <literal>D</literal>は, + 15Mビット/秒のコントローラで, かつ 36セクタ/トラック以上 + (52セクタも可能か?) のドライブをサポートし + ているものであることを表します.</para> + + <para>このコントローラのすべてのバージョンはインターリーブ比 + 1:1に対応してい るはずです. FreeBSDは充分高速なので, ぜひ + 1:1と指定してください.</para> + </sect4> + + <sect4> + <title>Western Digital WD1007コントローラ</title> + + <para>筆者は, WD1007でコントロールされた ESDIディスクへ, + FreeBSDをインストー ルすることができました. 正確には + WD1007-WA2というコントローラでした. + これ以外の複数のバージョンも WD1007にあります.</para> + + <para>利用できるようにするために, + セクタトランスレーションとWD1007の BIOSと + を使わないように設定しました. この設定の意味は, + BIOSに組み込まれた物理 + フォーマットプログラムを使えないようにしたということです. + 代わりに, <hostid role="fqdn">www.wdc.com</hostid>から + <command>WDFMT.EXE</command>を入手して, + ディスクをフォーマットし ました. 以後, + 順調に動いています.</para> + </sect4> + + <sect4> + <title>Ultrastor U14Fコントローラ</title> + + <para>ネットに流れたいくつかの報告によれば, Ultrastorの + ESDIボードも FreeBSD で動作するようです. + 実際の設定についての詳しい情報はありません.</para> + </sect4> + </sect3> + + <sect3 id="esdi-further-reading"> + <title>追加資料</title> + + <para>本格的に ESDIのプログラミングを計画している方は, + 次の公式規格仕様書を 入手なさることをおすすめします.</para> + + <para>最新の ANSI X3T10 委員会の文書は次のものです: + + Enhanced Small Device Interface (ESDI) + [X3.170-1990/X3.170a-1991] [X3T10/792D Rev 11]</para> + + <para>USENETのニュースグループ <ulink + URL="news:comp.periphs">comp.periphs</ulink> は, + 詳しい情報を得ることができる注目すべきもので す.</para> + + <para>World Wide Web (WWW) もまた便利な情報源です. Adaptec社の + ESDIコントロー ラについては <ulink + URL="http://www.adaptec.com/">http://www.adaptec.com/</ulink> を参照ください. Western Digital 社のコントローラについては <ulink URL="http://www.wdc.com/">http://www.wdc.com/</ulink> を参照ください. </para> + </sect3> + + <sect3> + <title>感謝</title> + + <para>Andrew Gordon氏より, テスト用の Adaptec + 2320コントローラと ESDIディス + クを送っていただきました.</para> + </sect3> + </sect2> + + <sect2 id="scsi"> + <title>SCSIとは?</title> + + <para><emphasis>原作:&a.wilko;. <!-- <br> --> + July 6, 1996.</emphasis></para> + + <para><emphasis>訳: &a.jp.yoshiaki;. <!-- <br> --> + 4 November 1996. </emphasis></para> + + <para>SCSI は Small Computer Systems Interface + (小規模コンピュータシ ステムインタフェース) + の頭文字をとったものです. + これはANSI標準でコンピュータ業界においては最もよく使われるI/O + バスの一つになっています. SCSIはシュガート社 + (ミニフロッピーディ スクを世界で最初に販売しました) の開発した + SASI (Shugart Associates Standard Interface) + バスが元になって規格化されました.</para> + + <para>その後の業界の努力により, + 異なるベンダのデバイスが混在して使え + るようにより厳密な規格へと規格化されました.この結果が ANSIの + SCSI-1規格として認可されました. SCSI-1の仕様は (1985年ごろ + に規格化されました 訳注: SCSI-1の最終案決定は1985年, + ANSIの標準 規格としての認可は1986年です) + すでに現在では時代遅れです. 現在の標準は SCSI-2 (<link + linkend="scsi-further-reading">さらに詳しい情報</link> + を参照してください) で, SCSI-3へ移行していくでしょう.</para> + + <para>物理的な相互接続の規格に加えて, + SCSIではディスクドライブに不可欠な 論理的な規格 + (コマンドセット) も定義しています. + この規格は標準コマンドセット (CCS : Common Command Set) + と呼ばれ, ANSIのSCSI-1とほぼ同時期に制定されました. + SCSI-2には (改定された) CCSが規格の一部として組み込まれました. + コマンドはデバイスの 種類によって変わります. + 例えばスキャナでは Writeコマンドは意味が ありません.</para> + + <para>SCSIバス は多くの種類があるパラレルバスです. 最も古く, + 最も利用されているのが 8 bit 幅, シングルエンド (不平衡) 信号, + 50線の信号線のバスです. + (もしシングルエンドの意味が分からなくても気にするこ + とはありません. このドキュメントはまさにそのような人たちのため + のものです.) より新しい設計では 16 + bit幅で平衡信号のバスを使います. この場合, 転送速度は + 20Mbytes/second まで, ケーブルの長さは 25mまで可能です. + SCSI-2では追加のケーブルを使った最大32 bitのバス幅までが + 定義されています. 最近急速に増えているものに Ultra SCSI + (Fast-20とも呼ばれます) があります. また, SCSI-2には Ultra2 + (Fast-40ともいいます) というものも定義されています. + Fast-20は1秒間に2000万回の転送 (8bitバスで20Mbyte/sec), + Fast-40は1秒間に 4000万回の転送 (8bitバスで 40Mbytes/sec) + をおこないます. 最近売られているハードディスクの + ほとんどは不平衡信号の Ultra SCSI (8ビットまたは 16ビット) + です.</para> + + <note> + <para>訳注: ここでは電気的な用語としては平衡, 不平衡を用いて, + バスの名称としては基本的にはシングルエンド, + ディファレンシャルとしました.</para> + </note> + + <para>もちろん SCSIバスにはデータ信号だけではなく, + 多くのコントロール信号線があります. + 複数のデバイスがバスを効率よく共有するための + 複雑なプロトコルも規格の一部です. + SCSI-2ではデータは常に独立したパリティ信号を + 使ってチェックされます. + SCSI-2以前ではパリティはオプションでした.</para> + + <para>SCSI-3ではさらに高速なバスタイプが導入され, + それと共にケーブルの線数を減らし, + より最大バス長を伸ばしたシリアルSCSIが導入されます. SSAや + Fiberchannelといった名前を聞いたことはありませんか? + シリアルバスは現在ではまだいずれの方式も普及していません + (特に一般的な FreeBSD環境では). + このためシリアルバスタイプについてはここでは + これ以上は触れません.</para> + + <para>今までの記述から想像されるように + SCSIデバイスはインテリジェント です. これは SCSIの規格 + (この文書は2インチ以上の厚さがあります) + と切り離すことはできません. + このため例えばハードディスクでは特定のブロックをさすのに + ヘッド/シリンダ/セクタ + によって決めるのではなく単に必要なブロック番号を指定します. + 巧妙なキャッシュ動作や, + 不正ブロックの自動置き換えなどの機能はこの + 「インテリジェントデバイス」 + のアプローチによって可能になっています.</para> + + <para>SCSI バスでは任意のデバイスの組で通信することが可能です. + (訳注: 任意のデバイスがイニシエータになれるという意味です.) + デバイスの機能がそれを許すかどうかは また別の問題ですが, + 規格では 禁止されていません. + 信号の衝突を防ぐために2つのデバイスはバスを使う前に調停 + (arbitrate) をおこなう必要があります.</para> + + <para>SCSI の考え方として古い規格のデバイスと + 新しい規格のデバイスが + 同じバスの上で動くように規格を作っています. したがって, 古い + SCSI-1の デバイスは SCSI-2バスの上でも普通は動きます. 普通は, + とことわった理由は, + ある古いデバイスが新しいバスでも問題ない程に (古い) + 規格に対して十分沿った実装になっているかどうかは絶対的に + 保証はできないということです. + 一般に最近のデバイスはよりうまく動作します. + その理由は規格化がより厳密になり, + またメーカーがデバイスの製造に + おいてよりきちんと規格に従うようになってきているからです. + </para> + + <para>一般的に言って, 単一のバス上で動かすデバイスは SCSI-2 + あるいはより新しいデバイスであれば + うまく動く可能性は高いと言えます. これは新しい + 2GBのディスクを手に入れたとしたら + 古いデバイスを捨ててしまわなければならないという + 意味ではありません. 私のシステムでは SCSI-1以前のディスク, + SCSI-2の QICテープユニット, + SCSI-1のヘリカルスキャンテープユニット (訳注: + VTRのような回転ヘッドを 持ったテープ装置のことです. + DATテープドライブもその一つです), 2台の SCSI-1 + ディスクが一緒に問題なく動いています. + ただし効率の点から古いデバイスと新しい (= 速い) + デバイスを分けたいかもしれません. (訳注: 古いデバイスの中には + disconnectをサポートしないために一連のコマンド実行中に + SCSIバスを占有してしまうデバイスもあります.)</para> + + <sect3> + <title>SCSIの構成要素</title> + + <para>先に述べたように, SCSIデバイスはインテリジェントです. + つまりハードウェア細部にからむ知識は SCSIデバイス自身に + 持たせてしまおうという考え方です. この考え方では + SCSIデバイスはそれ自身のハードウェアの詳細を知っています. + この場合, ホストシステムはハードディスクがいくつのヘッド + を持ち, テープデバイスがいくつのトラックを持つかというような + ことを知る必要がありません. もしあなたが知りたいのであれば, + 規格で定義されているコマンドを + 使ってデバイスにハードウェアの詳細について + 質問することができます.</para> + + <para>インテリジェントデバイスの利点は明らかです. + ホストのデバイスドライバはより一般的に書くことができ, + 新しいデバイスを導入する場合でも変更の必要がありません. + </para> + + <sect4> + <title>接続でおこなうべきこと, してはならないこと</title> + + <para>ケーブルの接続には鉄則があります. + よい部品を使うことです. バスの速度を上げることができ, + 多くの災難を防ぐことができます.</para> + + <para>ですから, 金メッキのコネクタ, シールドケーブル, + 固定器具付きの頑丈なコネクタカバーなどを + 選ぶのは正しいことです. 2つ目の鉄則は, + ケーブルを必要以上に長くしないことです. + 私は以前にあるマシンでトラブルの 原因を探すのに + 3日間悩んでいましたが, SCSIバスを 1m 短く + することで問題を解決したことがあります. もちろん, + 元のバスの長さでもSCSIの仕様はきちんと + 満たしていたのですが.</para> + </sect4> + </sect3> + + <sect3> + <title>SCSI バスのタイプ</title> + + <para>電気的に互換性のない 2種類のバスのタイプがあります. + シングルエンドとディファレンシャルのバスです. これは SCSI + デバイスとコントローラは同一のバス上に混在することのできない + 2つのグループにに大きく分けられるということを意味しています. + しかし, 特別なハードウェアを使えばシングルエンドバスを + ディファレンシャルバスに (その逆も) 変換することはできます. + これらのバスのタイプの違いは次のセクションで説明します. + </para> + + <para>SCSI関連のドキュメントでは + 異なるタイプのバスを一種の用語とし て略語で表します. + これを次の表に示します.</para> + + <itemizedlist> + <listitem> + <para>FWD: Fast Wide Differential (高速 ワイド 平衡)</para> + </listitem> + + <listitem> + <para>FND: Fast Narrow Differential (高速 ナロー 平衡)</para> + </listitem> + + <listitem> + <para>SE: Single Ended (不平衡)</para> + </listitem> + + <listitem> + <para>FN: Fast Narrow (高速 ナロー)</para> + </listitem> + + <listitem> + <para>etc.</para> + </listitem> + </itemizedlist> + + <para>少し想像力を働かせればどのような + 意味であるかはわかるでしょう.</para> + + <para>ワイド (Wide) はいくらか曖昧で, 16 または 32 + bitのバスを示します. 私の知る限りでは, 32 bit + のインタフェースは (まだ) 使われていませんので Wide は通常 + 16 bitを意味します.</para> + + <para>高速 (Fast) はバスのタイミングがいくつかの点で異なり, + ナロー (8 bit) バスでは 低速 (slow) SCSIバスの 5 Mbytes/sec + に対して 10 Mbytes/sec の能力があります. 前にも述べたように, + 20Mbytes/sec や 40Mbytes/sec + のバス速度を持つものも現れてきています (Fast-20 == Ultra + SCSI で Fast-40 == Ultra2 SCSI です).</para> + + <note> + <para>データ線の上位 (> 8) + はデータの転送とデバイスの指定だけに利用されています. + コマンドの送出とステータスメッセージ等は下位側の 8 + bitのデータ線のみを使います. この規格により + ナローデバイスはワイドバス上でも 動作する事ができます. + 利用できるバスの幅はデバイス間で調停 (ネゴシエーション) + されます. デバイスの + IDについてはワイドとナローが混在する時には + 気をつけなければなりません.</para> + </note> + + <sect4> + <title>シングルエンドバス (不平衡バス)</title> + + <para>シングルエンド SCSIバスは 5Vと 0Vの電圧 + (つまりTTLレベルです) を信号として使い, + それらは共通のグラウンド (GND) レベルを基準 にします. + シングルエンド SCSI 8 bitバスは約25本のグラウンド線 + を持ち, すべてのデバイスを「直線状」に接続します. + 基準ではシングルエンドバスは最大の長さは 6mです. Fast-SCSI + デバイスを使う場合には, この最大長さは 3mに短くなります. + Fast-SCSIでは 5Mbytes/sec ではなく 10Mbytes/sec の転送速度 + が可能になります.</para> + + <para>Fast-20 (Ultra SCSI) と + Fast-40ではそれぞれ1秒間に2000万 (20M) ないしは 4000万 + (40M) 回の転送ができます. したがって, Fast-20では + 8bitバスで 20Mbytes/sec, 16bitバスで 40Mbytes/secとなりま + す. Fast-20ではバスの最大の長さは 1.5m, Fast-40では + 0.75mに なります. Fast-20は限界を相当に広げるものなので + SCSIバス + に雑音が多い場合はその影響を即座に受けます.</para> + + <note> + <para>バス上のいずれかのデバイスが 「高速の」 + 転送を利用する場合は + Fastバスの長さの制限を受けます.</para> + </note> + + <para>最近の Fast-SCSI デバイスではバスの長さが実際の問題に + なりつつあるのが明らかになっています. + これがディファレンシャル + SCSIバスがSCSI-2の規格に導入された理由です.</para> + + <para>コネクタのピン配置やコネクタの種類については + SCSI-2の規格 (<link + linkend="scsi-further-reading">さらに詳しい情報</link>) + を参照してください.コネクタ等について + 詳細なリストがあります.</para> + + <para>非標準のケーブルを使うデバイスに気をつけてください. + 例えば Apple (の Macintosh は) 25pin の D-type のコネクタ + (シリアルポートやパラレルプリンタに使われているコネクタ -- + 訳注: 日本では一般的に D-sub 25pinと言っています) + を使っています. 公式なSCSIバスでは50 pin + が必要である事からこのコネクタでは + 「独創的なピン配置」が必要な事が想像できるでしょう. ここ + でおこなわれているようにグラウンド線の数を + 減らすことはよい考え ではありません. SCSIの規格通りの 50 + pinの接続の方が望まし いです. Fast-20 や 40 + でこのようなケーブルを使おうなんて + 考えてはいけません.</para> + <!-- kuriyama - use mdash --> + </sect4> + + <sect4> + <title>ディファレンシャル (平衡) バス</title> + + <para>ディファレンシャル SCSIバスは最大長が 25m です. + シングルエンド Fast-SCSIバスの 3mとはまったく違います. + 平衡信号の背景と なっている考え方は, + それぞれのバスの信号はそれぞれ + 独立したリターン信号線を持つというものです. つまり, + それぞれの信号は (できればより線の) ペアの信号線で + 伝えられます. + これら2つの信号線の差分の電圧で信号が「真」(assert) で + あるか「偽」(de-assert) であるか判定されます. + かなりの電圧 + がグラウンド電位と信号線ペアの間にかかったとしても影響があ + りません (だからといって 10kVの電圧をかけてみたりしないで + ください.. ).</para> + + <para>なぜ平衡信号が よいのかについての説明は + このドキュメントの 範囲を越えています. + 電気的に平衡信号はノイズマージンの点で + 非常に優れたものとして利用されているということを + 受け入れて ください. + ディファレンシャルバスは普通は外部接続に 利用されています. + これは低コストのシングルエンドバスが筐体内の短 + い距離のバスでは非常に多く利用されているからです.</para> + + <para>FreeBSDを使うにおいて, FreeBSD でサポートされている + デバイスドライバがあるのであれば + ディファレンシャルバスの利用で 問題になることは + 何もありません. 例をあげれば, アダプテックの + AHA1740はシングルエンドで, + AHA1744はディファレンシャルです. + 双方のソフトウェアインタフェースはまったく同一です.</para> + </sect4> + + <sect4> + <title>ターミネータ</title> + + <para>SCSIにおける用語でのターミネータとはインピーダンスの + マッチングを正確におこなうための抵抗ネットワークです. + インピーダンス マッチングは反射やリンギングを抑え, + バスの信号をきれいにす る重要なものです. たとえば, + あまり状態のよくない回線で長距 + 離の電話をかけた時にあなたは反射をどんなものか + 感じるかもしれません. 20Mbytes/sec で信号の伝わる + SCSIバスでは信号のエコーはあ りがたくありません.</para> + + <para>訳注: + 電気信号のパルスは進行波としての性格を持っています. + このため, 一般的には信号線の両端で反射が起きます. + 3mのバスの端からパルスを入れた場合, + 反対の端からの反射波は 20ns後 - 本当は電線中の信号の伝達は + 光速よりも少し遅くなるのでもう少し時間がかかりますが - + に返ってきます. 低速のバスの場合タイミング的な余裕があり, + 反射を繰り返しているうちに反射波は減衰してしまうのですが + 高速のバスの場合は, 反射波の影響が落ち着く前に信号の + 読み込みなどを行うために波形の乱れが誤動作の原因に + なる場合があります. + このためターミネータを使用して反射波の発生をできるだけ + おさえます.</para> + + <para>ターミネータはいろいろな - + 洗練されたものもそうでないものも - 実現方法があります. + もちろん, 内蔵のものと外部という 区別もあります. 多くの + SCSIデバイスにはいくつかの ソケットがあり, + その中には抵抗ネットワーク (集合抵抗) が + 入っているものもあるかもしれません (いや, おそらく + 間違いなくあるでしょう). ターミネータを + デバイスから外す時は大事にしまっておいてください. SCSIの接 + 続の変更をしようと思った時に必要になるかもしれません. ま + た, + それらしい抵抗ネットワークが見つからないこともあります. + この場合, SCSIデバイスは内蔵ターミネータの有効と無効を切替 + えるジャンパがあります. フラットケーブルに取り付ける特別 + なターミネータもあります. 他には外部コネクタのような形をし + たものやケーブルのないコネクタヘッドだけのものもあります. + いろいろと見られるように多くの選択があります.</para> + <!-- kuriyama - mdash --> + + <para>どのような場合に単純な抵抗 (パッシブ) ターミネータから + アクティブターミネータへ切替えるかという問題があります. + アクティブターミネータはいくらか精巧な回路が信号をより + きれいにするために入っています. + 一般的に受け入れられている意見としては, 長いバスを使ったり + 高速なデバイスを使う場合はアクティブターミネータの + 有効性は増加すると言えます. SCSI バスですでに問題が起きて + いるならアクティブターミネータを試すことを考えていいで + しょう. まず借りることができないか探してみてください. + アクティブターミネータは非常に高価だそうですから.</para> + + <para>ディファレンシャルと + シングルエンドバスのターミネータは互換 + 性がないということを覚えておいてください. これらの2つの種 + 類を + <emphasis>混在させることはできません</emphasis>.</para> + + <para>OK, ではあなたは + ターミネータをどこに入れればいいでしょうか? これは + SCSIで最も多く誤解されているところです. しかし, これ + は極めて単純なことです.. ここでのルールは + <emphasis>SCSIバスの線 一本一本は必ず両端に + 2個のターミネータを入れる</emphasis> ということです. + つまり 2個であって1個でも3個でもありません. + このルールを受け入れてしたがってください. そうすれば終りの + ない苦しみから救われるでしょう. + なぜなら間違ったターミネーションは不可解なバグを引き起こす + 可能性が非常に高いからです. (ここの “可能性” + に注意; 一見動いているように見える + ことがあるのがやっかいです.)</para> + + <para>よく陥りやすい落し穴はマシンの内部 (フラット) + ケーブルと外部 + ケーブルがコントローラにつながっている場合です. よく見られ + るのはコントローラのターミネータを外すのを忘れることです. + ターミネータは最後の外部デバイスで必要で, コントローラ + には必要ありません! 一般的に, SCSIバスの接続の変更をする場 + 合はこのようなことに注意をしなければなりません.</para> + + <note> + <para>ターミネータの位置は + 信号線ごとに決まることに注意して下さい. + ナローとワイドのケーブルを + 両方コントローラにつないでいる場 合には, + ケーブルの両端とともにコントローラ上ではバスの上位 + 8ビットをターミネートしないといけません.</para> + </note> + + <para>私自身は, + すべてのデバイスとコントローラのターミネータを外し + ています. 2個の外部ターミネータをセントロニクスタイプ + (訳注: 日本ではケーブルに対してこういう言い方は + あまりしないのでは ないでしょうか) + 外部ケーブルと内部フラットケーブルの + コネクタの両端に接続しています. + こうすることにより接続の変更はかなり簡単になります.</para> + + <para>最近のデバイスは, + ICターミネータが使われることもあります. + コントロールピンにより無効 / 有効を設定できる 特別の IC + があります. + これは物理的にデバイスから外す必要がありません. + 新しいホストアダプタではセットアップツール等を使って + ソフトウェア的に設定をおこなう場合があります. + また, 中には端子に接続されたケーブルを検出して + ターミネータ を必要に応じて自動的に + 有効にするものもあります. いずれにしろ, マニュアルを見てく + ださい.</para> + </sect4> + + <sect4> + <title>ターミネータの電源</title> + + <para>ここまでの章で議論したターミネータは + 正常に動作するためには 電源が必要です. + SCSIバス上にはこの目的のために利用される線があります. + だから特に気にする必要はないと思いますか?</para> + + <para>ところがそうではないのです. + それぞれのデバイスはデバイス上 + にあるターミネータソケットに電源を供給することはできます. + けれども外部ターミネータがある場合やSCSIバスにターミネータ + の電源を供給するデバイスのスイッチがオフになっているような + 場合にはトラブルが起きるかもしれません.</para> + + <para>イニシエータ (ここではバスの動作を開始-initiate-させる + デバイスを指します -- 訳注: + 簡単に言えばホスト側のアダプタですがSCSIの 規格によれば, + 例えばディスク側がコマンドを発行するような + システムがあってもかまわないことになっているので + こういう言い方をしています) は + ターミネータ電源を供給しなければなりません. + すべてのSCSIデバイスはターミネータの電源を供給することが + できます (必ずしも供給しなければならないというわけ + ではありません).</para> + <!-- kuriyama - mdash --> + + <para>スイッチがオフになっているデバイスが + バス上に存在することを 許すために, + ターミネータの電源はダイオードを通して供給され + なければなりません. これはスイッチを切ったデバイスに電流 + が逆流することを防ぐためです.</para> + + <para>最悪の事態を避けるために, + ターミネータの電源は普通はヒュー ズが入っています. + 当然ヒューズは飛ぶかもしれません. この + 場合でもバスが機能停止するとは限りません. 複数のデバイスが + ターミネータの電源を供給しているのであれば, ヒューズが一つ + 飛んでも全体の機能には影響しません. ただ一つの供給線の + ヒューズが飛んだのであれば確かに問題になるでしょう. + 外部ターミネータによっては LED でターミネータ電源 + が与えられていることを示すものもあります.</para> + + <para>最新の設計ではある程度の時間がたつと 「リセット」され + 自動復帰するヒューズが使われることもあります.</para> + </sect4> + + <sect4> + <title>デバイス アドレッシング</title> + + <para>SCSIバスでは接続された異なるデバイスを区別して指定 + できなければなりません.</para> + + <para>これには SCSIではターゲットIDが使われます. + それぞれのデバイ スは特定のターゲットIDを持ちます. + デバイスの IDはジャンパや DIPスイッチなどで設定できます. + ブート時のメニューからIDを + 変更できるようになっているコントローラもあります. (また, + IDを 7から変えることができないコントローラもあります.) + より詳しい情報はデバイスのマニュアルを見てください.</para> + + <para>複数のデバイスを使う場合は + IDの重複に気をつけてください. + 重複すると普通は混乱状態になります. 同じ IDを共有している + デバイスのうちの一つがI/Oリクエストに答えられたりすると + 非常にやっかいなことになります.</para> + + <para>8 bitバスでは, 最大8台のターゲットまで可能です. + 最大8台で ある理由は, + バスの8本のデータ線がデバイスの選択に使われる からです. + ワイドなバスでは使えるデバイスの数は増えます + (通常は16になるわけです).</para> + + <note> + <para>ナロー SCSI デバイスは 8 以上のターゲット ID + を持つデバイスとは 通信できないことに注意してください. + ですから, コントローラ + のターゲットIDを8以上にするのはあまりいい考えとは + いえません (CD-ROMが使えなくなったりします).</para> + </note> + + <para>同時にバス使用の要求が発生した場合, 最も + IDの大きいデバイス が優先されるという調停がおこなわれます. + このことは SCSIホストアダプタの + IDは通常7番が使われる理由でもあり ます. ただし, + ワイドバスでは下位8ビットが上位8ビットより優 + 先度が高いことに注意してください. つまり, ワイドSCSIのシス + テムではターゲットIDの優先度は高い順に [7 6 .. 1 0 15 14 + .. 9 8] となります. + (どうして下位8ビットの方が優先度が高いかは, + 一つ前の段落を読んで考えてみて下さい.)</para> + + <para>さらにサブユニットとして, 規格では ロジカルユニット, + 短縮形で LUNを持つことができます. + 一つのターゲットIDが複数の LUNを 持つことができます. + 例えば, テープチェンジャを持つテープ ドライブは LUN + 0をテープドライブ自身, LUN 1を テープチェンジャ + に与えることができます. このようにして, + ホストシステムはテープチェンジャの目的の + テープユニットの部分を指定することができます.</para> + </sect4> + + <sect4> + <title>バスの形状</title> + + <para>SCSIバスは直線状です. つまり, Y接続, スター接続, + 円形, クモの巣状の接続などの直線以外の接続ではありません. + 初心者が + よくやる間違いとしてはワイドSCSIのコントローラの端子3つと + もにケーブルをつないでしまうというものがあります. (外部, + 内部ナロー, 内部ワイド.) + よほど運がよければこんなトポロジー + でもちゃんと動くように見えるかもしれませんが, えてしてこう + いうシステムは一番大切な時に使えなくなったりするものです + (これを“マーフィーの法則”といいます).</para> + + <para>先に議論したターミネータの問題は直線状以外の場合では + より困難になるだろうということに注意してください. また, + 内部バス用の ケーブルの端子の数よりデバイスの + 数の方が少ない場合には, + 必ず両端の端子にはデバイスをつなぐようにしてください. + 内側の端子を使ってケーブルの端を余らせておくと, + ターミネータの効果が半減します.</para> + + <para>電気的特性はそのノイズマージンや全体の信頼性において, + 直線状のバスのルールに強く依存しています.</para> + + <para><emphasis>直線状バスであるというルールに + したがってください!</emphasis></para> + </sect4> + </sect3> + + <sect3> + <title>FreeBSD で SCSIを使う</title> + <sect4> + <title>トランスレーション, BIOS, そしてマジック...</title> + + <para>まず始める前に, + 電気的に問題のないバスであるか調べておいてく + ださい.</para> + + <para>SCSIディスクをPCでブートディスクとして使う場合に, PC + BIOSに 関する気まぐれについて知っておく必要があります. PC + BIOSは ハードディスクへの低レベル物理インタフェースを + 利用するように 実現されています. したがって, BIOSに + (セットアップツールやBIOSビルトイン セットアップを使って) + ディスクの物理パラメタを教えてやる 必要があります. + これはヘッドの数, シリンダの数, + トラックあたりのセクタなどがあり, + プリコンペンセーションや書き込み電流を 減少させるトラック, + などのあまりよく知られていないものもあります.</para> + + <para>SCSIディスクはこれらのことをユーザは + 気にする必要がないはず だと考えるかもしれません. しかし, + 不思議なことに (これらの項 目の) + セットアップはいまだにあるのです. システム BIOSはブート + 時にFreeBSDのカーネルを読み込むためにSCSIディスクに + /ヘッド/シリンダ/セクタ を指定する方法でアクセスするため, + パラメタを知る必要があるのです.</para> + + <para>AT/EISA/PCIバスなどにあり, ディスクに接続される + SCSIホストアダプタや SCSIコントローラは + それ自身のオンボードBIOSを持っています. + システムの起動時に, SCSI BIOSは + システムBIOSのハードディスクの + インタフェースルーチンを乗っ取ります. + システムBIOSをごまかすために + システムセットアップでは普通は `No hard disk' とします. + 簡単ですね?</para> + + <para>訳注: BIOS で `No hard disk' という設定をおこなうのは + SCSI ドライブから直接起動させるためのテクニックです. + 現在のマザーボードでは SCSI ドライブから起動させるための + オプションを持つ BIOS を使用しているものもあります. また, + ブートセレクタを使って IDEドライブのブートブロックから + SCSIドライブ上の FreeBSDをブートすることもできます.</para> + + <para>SCSI BIOS はドライブの + <emphasis>トランスレーション</emphasis> と呼ばれる + 機能を持ちます. + これはPCがブートするために作られたドライブテー + ブルをごまかすものです. このトランスレーションは多くは + (すべての場合ではありません) + トラックあたり64あるいは32個のヘッドを + 持つ仮想的なドライブを使います. + シリンダの数を変更することで SCSI BIOS + は実際のドライブのサイズに適合させます. 総セクタ数 を 32 * + 64 / 2 で割った結果がメガバイト単位のドライブのサイズ + になります. 2で割っているのは, 通常 512バイトのサイズの + セクタを kByte 単位に変換するためです.</para> + + <para>ではこれですべてうまくいくのでしょうか. いいえ, + そういう訳で はありません. + ブート可能なハードディスクのシリンダ数は 1024よ + り多くすることはできないのです. + トランスレーションを使った 場合でもディスクの + 1GB以上の領域は見えません. ディスクの容量 + がどんどん増加していくにつれこれは問題になってきました. + </para> + + <para>幸いにして, 単純な解決方法があります. + 単に別のトランスレーショ ンを使えばよいのです. 例えば, + 32個に代わり, 128個のヘッドを使います. ほとんどの場合, + 古いSCSIホストアダプタをアップグレードす + るための新しいバージョンの SCSI BIOS が用意されています. + 新しいアダプタではジャンパ やセットアップソフトによって + SCSI BIOSの使う + トランスレーションを選択できる物もあります.</para> + + <para>ここで非常に重要なことは, + ディスク上の<emphasis>すべての</emphasis> + オペレーティングシステムが + <emphasis>同一のトランスレーション</emphasis>を使って + 正しいパーティションを得ることです. つまり + FreeBSDをインストールする時に, + ヘッド/シリンダなどについての + 質問にあなたのホストアダプタが + 使用しているトランスレートされた + 値を使わなくてはなりません.</para> + + <para>トランスレーションに関する失敗でよく見られるものは, + ブートしないシステムができたり, 他のパーティションを + 上書きしてしまうことです. すべてのシステムが見えるように + fdiskを使うべきです.</para> + + <para>あなたはデバイスについて + これとは食い違った話を聞いたことが あるかもしれません. + 古い FreeBSDのカーネルはブートする時に SCSI + ディスクのジオメトリ情報を報告していました. + 私のシステムの一つの例を示しましょう.</para> + + <screen>aha0 targ 0 lun 0: <MICROP 1588-15MB1057404HSP4> + sd0: 636MB (1303250 total sec), 1632 cyl, 15 head, 53 sec, bytes/sec 512</screen> + + <para>最近のカーネルは, 普通はこのような情報を報告しません. + たとえば, このようになっています.</para> + + <screen>(bt0:0:0): "SEAGATE ST41651 7574" type 0 fixed SCSI 2 + sd0(bt0:0:0): Direct-Access 1350MB (2766300 512 byte sectors)</screen> + + <para>なぜこのように変わったのでしょう?</para> + + <para>この情報は SCSIディスク自身から得られます. + 最近のディスクで はよくゾーンビット記録方式 (zone bit + recording) という 技術が使われています. + これはドライブの外側のシリンダは + 内側よりもスペースが広いのでトラックあたりのセクタ数を + 増やすことができるというアイディアです. この結果, + 外側のシリンダ上のトラックの容量は内側の + シリンダよりも大きくなり, + 全体ではより大きな容量となります. この場合, + ドライブのジオメトリについての報告は, + 最善のものかどうか疑わしく, + ほとんどの場合誤解を招くものであ ることがわかるでしょう. + ジオメトリを調べる場合, ほとんどの場合は BIOSの用い + ている値を与える方がよい結果となり, + <emphasis>BIOSがそのディスクに + ついてまったく関知しないのであれば</emphasis> + (例えばブートディスクで はないなら) + 都合のよい仮想のジオメトリを与えればいいでしょう.</para> + </sect4> + + <sect4> + <title>SCSI サブシステムの設計</title> + + <para>FreeBSDでは階層的な SCSIサブシステムを用いています. + それぞれ 異なるコントローラカードの + デバイスドライバが書かれています. + このドライバはコントローラのハードウェアの + 詳細を知っています. ドライバは + SCSIサブシステムのより上位の階層のコマンドを受け取り, + ステータスを報告するインタフェースを持ちます.</para> + + <para>カードのドライバの最上位には, デバイスのクラスのための + いくつかの一般的なドライバがあります. 具体的にいうと, + テープドライブのためのドライバ (略号は: st), 磁気ディスク + (sd), CD-ROM (cd) などです. これらのソースコードは + <filename>/sys/scsi</filename>にあります. + マニュアルページ (man) のセクション 4 にはより詳しい内容が + あるので見てください.</para> + + <para>多階層の設計は低レベルとより高位の + レベルを分離させることが できます. + 新たに他の種類のハードウェアのサポートを加えることを + より処理しやすい問題にします.</para> + </sect4> + + <sect4> + <title>カーネルコンフィグレーション</title> + + <para>あなたのハードウェア構成にしたがって, カーネルの + コンフィグファイルに ホストアダプタについて + 1行あるいは数行程度の記述をする 必要があります. これには + I/O アドレスや割り込みなどについての内容も 含みます. + あなたのアダプタのドライバについてのマニュアルページ + にはより多くの情報があるのでよく読んでください. + これとは別に <filename>/sys/i386/conf/LINT</filename> + にはカーネルコンフィグファイルについての 概要があります. + <filename>LINT</filename> + には一般的なものについては可能なすべての + オプションが含まれています. ただし, + <filename>LINT</filename> + では実際に動作するカーネルを作ることは + <emphasis>できません</emphasis>.</para> + + <para>当然のことを言うようで恐縮ですが, + カーネルコンフィグファイルは実際のハードウェア構成を + 反映すべきです. そのように割り込みやI/Oアドレス等に + 合わせてカーネルコンフィグファイルを書か + なければなりません. + システムのブート時のメッセージは実際に + 見つけたハードウェアの設定を表示します.</para> + + <note> + <para>ほとんどの EISA/PCI 用のドライバ (具体的には + <devicename>ahb</devicename>, + <devicename>ahc</devicename>, + <devicename>ncr</devicename> と + <devicename>amd</devicename>です) + はブート時にコントローラから直接パラメータ + を読みこみます. これらについては, 何も引数をつ + けずにただ <literal>controller ahc0</literal> + のように書けば大丈夫で す.</para> + </note> + + <para>例として FreeBSD 2.2.5-Releaseのいくつかのコメント + ([]の中) をつけた <filename>LINT</filename> + カーネルコンフィグファイルを示 します.</para> + + <programlisting> +# SCSI host adapters: `aha', `ahb', `aic', `bt', `nca' +# +# aha: Adaptec 154x +# ahb: Adaptec 174x +# ahc: Adaptec 274x/284x/294x +# aic: Adaptec 152x and sound cards using the Adaptec AIC-6360 (slow!) +# amd: AMD 53c974 based SCSI cards (e.g., Tekram DC-390 and 390T) +# bt: Most Buslogic controllers +# nca: ProAudioSpectrum cards using the NCR 5380 or Trantor T130 +# ncr: NCR/Symbios 53c810/815/825/875 etc based SCSI cards +# uha: UltraStore 14F and 34F +# sea: Seagate ST01/02 8 bit controller (slow!) +# wds: Western Digital WD7000 controller (no scatter/gather!). +# + +[ Adaptec AHA274x/284x/294x/394x などのコントローラ] +controller ahc0 + +[ NCR/Symbios 53c875 コントローラ] +controller ncr0 + +[Ultrastor アダプタ] +controller uha0 at isa? port "IO_UHA0" bio irq ? drq 5 vector uhaintr + +# Map SCSI buses to specific SCSI adapters +controller scbus0 at ahc0 +controller scbus2 at ncr0 +controller scbus1 at uha0 + +# The actual SCSI devices +disk sd0 at scbus0 target 0 unit 0 [SCSI ディスク 0 は scbus 0, LUN 0] +disk sd1 at scbus0 target 1 [unit を省略すると暗黙で LUN 0] +disk sd2 at scbus1 target 3 [uha0 上の SCSIディスク] +disk sd3 at scbus2 target 4 [ncr0 上の SCSIディスク] +tape st1 at scbus0 target 6 [SCSI テープ は ターゲット (ID)6] +device cd0 at scbus? [最初に見つけた CD-ROM, 固定にしない]</programlisting> + + <para>上の例では カーネルは ahc (Adaptec 274x) + コントローラをまず探し, その次に NCR/Symbios + のボードというように順番に探して 行きます. その下の行の + controller の記述ではデバイスの詳細 を記述して, + 対応するバスでターゲット ID と LUN が指定された + ものと一致する場合<emphasis>だけ + </emphasis>認識するようにカーネルに 伝えています.</para> + + <para>固定された (Wired down) デバイスは + “最初に”ユニット番号が 与えられるので, + “固定”されていないデバイスは同じ種類の + “固定”されたユニット + 番号の最も大きい番号の1つ上の番号から割り当てられます. + したがって, ターゲットID 2の SCSIテープを加えると, + ターゲットID 6 + のテープがユニット番号1に固定されているので, + それはst2に設定 されるでしょう.</para> + + <note> + <para>ブート時に見つからなくても<emphasis>固定されたデバ + イスにはユニット番号が常に割り当てられます</emphasis>. + 固定のデバイスに 割り当てられたユニット番号は, + もしそのデバイスのスイッチが + ブート時に切られていてもそのデバイスに + リザーブされています. これは, + 電源を入れて接続した時のユニット番号が与えられます. + デバイスのユニット番号は SCSIバスのターゲットID とは + <emphasis>何の関係もない</emphasis> + ことに注意してください.</para> + </note> + + <para>下の例は FreeBSD のバージョン 2.0.5 以前の + カーネルコンフィ グファイルです. + 最初の例との違いはデバイスの“固定 (wired + down)” がないことです. “固定” + によりどのSCSIターゲットをどの + デバイスに割り当てるかを記述できるようになりました.</para> + + <para>下のコンフィグファイルにより + 構築されたカーネルでは最初に見つ けた SCSIディスクが + sd0になり, 次に見つけたディスクが sd1に, + という具合に割り当てられます. + もしディスクの削除や追加をおこなう と, + 他の同じタイプのデバイス (この場合はディスク) のすべてが + 「移動して」しまうかもしれません. これによりそのたびに + <filename>/etc/fstab</filename> + を変更する必要があります.</para> + + <para>古いスタイルでも動きますが, + 新しいスタイルを使うことが<emphasis>強 く</emphasis> + 推奨されています. これにより SCSIバスのハードウェアを + どのように変更した場合でもトラブルを避けることができます. + ですから, 2.0.5.R以前の + FreeBSDからアップグレードした後に古い + 信頼できるコンフィグファイルを再利用する時はこの部分を + チェックして直してください.</para> + + <programlisting> +[Adaptec 174x用のドライバ] +controller ahb0 at isa? bio irq 11 vector ahbintr +[Adaptec 154x用のドライバ ] +controller aha0 at isa? port "IO_AHA0" bio irq 11 drq 5 vector ahaintr +[Seagate ST01/02インタフェースのドライバ] +controller sea0 at isa? bio irq 5 iomem 0xc8000 iosiz 0x2000 vector seaintr +controller scbus0 + +device sd0 [4台のSCSI ディスクのサポート, sd0 から sd3] + +device st0 [2台の SCSI テープのサポート] + +[CD-ROMのドライバ] +device cd0 #Only need one of these, the code dynamically grows</programlisting> + + <para>両方の例で SCSIディスクがサポートされています. + ブート中に 「固定」の記述がされているタイプ(例えば sd + ディスク) のデバ イスで記述より多くのデバイスが見つかると, + システムは単純に最後の “固定” + のデバイスの番号より + 1つずつ増加させた番号をデバイスに割り当てて行きます. もし + “固定” のデバイスがなければユニット番号は 0 + から始まります.</para> + + <para><command>man 4 scsi</command> によって + SCSIサブシステムの最新の情報を チェックしてください. + より詳細なホストアダプタドライバの使い 方は, たとえば + Adaptec 294xドライバの場合は<command>man 4 ahc</command> + にあります.</para> + </sect4> + + <sect4> + <title>カーネルセットアップでの SCSI チューニング</title> + + <para>経験的に SCSIバスリセット (ブート時におきます) + 後のINQUIRYコマ + ンドに対して応答が遅くなるデバイスがあります. + INQUIRYコマンドは ブート時にカーネルがどの種類のデバイス + (ディスク, テープ, CD-ROMなど) + がどのターゲットIDに接続されているかを調べるために + 発行します. ちなみにこのプロセスをデバイスプロービング + (デバイス検出) と言います.</para> + + <para>「応答の遅いデバイス」の問題を解決するために, + FreeBSDは SCSIバスをリセットした後に SCSIデバイスの検出を + おこなうまでのディレイタイムを調整することができます. + カーネルコンフィグレーションファイルの下に示すような + 行にディレイタイムを設定してください.</para> + + <programlisting> +options SCSI_DELAY=15 #Be pessimistic about Joe SCSI device</programlisting> + + <para>この行ではディレイタイムは 15秒です. 私のシステムでは, + 信頼できる古い + CD-ROMが認識できるように3秒の値を使っています. もし + デバイスの認識で問題が起きる時は大きな値 (30秒であるとか) + から 始めてください. うまく動いたら, + 値を減らしてちょうどよい値 + にチューニングしてください.</para> + </sect4> + + <sect4 id="scsi-rogue-devices"> + <title>Rogue な SCSI デバイス</title> + <para>(訳注: rogue は有名なゲーム, ではなくて 悪党, + 群から離れた, 凶暴な, という意味)</para> + + <para>SCSI の規定は完全で簡潔なものにしようという + 努力はされましたが, 複雑な規定となり, + 正確に実現するのは簡単なことではありません. + いくつかのベンダは他よりもよい仕事をしています.</para> + + <para>ここで “イカレた” + デバイスが現れることになります. このような デバイスは + FreeBSD のカーネルにいくらか標準的 + ではない振舞をするものと認識されます. + “イカレた”デバイスは + ブート時にカーネルによって報告されます. 次の例は私の2つの + カートリッジテープユニットです.</para> + + <screen>Feb 25 21:03:34 yedi /kernel: ahb0 targ 5 lun 0: <TANDBERG TDC 3600 -06:> +Feb 25 21:03:34 yedi /kernel: st0: Tandberg tdc3600 is a known rogue + +Mar 29 21:16:37 yedi /kernel: aha0 targ 5 lun 0: <ARCHIVE VIPER 150 21247-005> +Mar 29 21:16:37 yedi /kernel: st1: Archive Viper 150 is a known rogue</screen> + + <para>例えば, + あるターゲットIDから実際には1つのデバイスしかないの + にすべての + LUNからの応答があるようなデバイスがあるとします. カー + ネルはその特定のターゲットIDに8個の + LUNがあると誤解してしまう かもしれません. + このような混乱の起きる原因については読者へ + の課題にしておきます.</para> + + <para>FreeBSDの SCSIサブシステムは 検出時の + INQUIRYの応答を見て + 悪い習慣を持つデバイスの認識をしています. + INQUIRYの応答には + デバイスのファームウェアのバージョン番号が含まれるため, + 異なる 動作をするファームウェアのバージョンを + 区別することも可能です. 例えば, + <filename>/sys/scsi/st.c</filename> や + <filename>/sys/scsi/scsiconf.c</filename> を 見てください. + どのように行っているか, より多くの情報があります.</para> + + <para>この方法はうまく行きますが, + もちろん既知のデバイスがつながっ + ている場合だけうまくいくということに + 気をつける必要があります. もしあなた以前に Mumbletech + SCSI CD-ROM (訳注: 架空のメーカ のデバイスです) + を接続した人がいないとしたら, どんな 「ワザ」 + を使ってそれを使うか自分で見つけないと + いけないかもしれません.</para> + + <para>あなたの Mubletech を動かすことができたらその成果を + FreeBSDの 次のリリースへ含めるために + FreeBSD開発チームへ送ってくださ い. 他の + Mumbletechの利用者たちはあなたに感謝するでしょう.</para> + </sect4> + + <sect4> + <title>複数の LUNを持つデバイス</title> + + <para>単一の SCSI ID上に複数の論理ユニット (LUN) + を持つデバイスを使う ような場合もあるかもしれません. + 多くの場合では FreeBSDは LUN 0 のみを検出します. + このような例としては2台の SCSIではないハード ディスクを + SCSIバスにつなぐブリッジボード (例えば古い Sunシステ + ムに見られる Emulex MD21) があります.</para> + + <para>LUN + が0ではないデバイスは普通はシステムブート時の検出では + 見つかりません. この問題にうまく対処するには + /sys/scsi/scsiconf.c + に適切なエントリを加えてカーネルを再構築 + しなければなりません.</para> + + <para>以下のように初期化されている構造体を探します.</para> + + <programlisting> +{ + T_DIRECT, T_FIXED, "MAXTOR", "XT-4170S", "B5A", + "mx1", SC_ONE_LU +}</programlisting> + + <para>LUNが複数あるあなたの Mumbletech BRIDGE2000 + はハードディスク として働きます. + またファームウェアのリビジョン123などを次のよ + うに書き加えます.</para> + + <programlisting> +{ + T_DIRECT, T_FIXED, "MUMBLETECH", "BRIDGE2000", "123", + "sd", SC_MORE_LUS +}</programlisting> + + <para>訳注: 複数 LUNに対応するためには構造体の最後の要素を + SC_MORE_LUSにします. エントリを作る必要がある場合は + scsiconf.c にある + MBR-7等のエントリを参考にするといいでしょう.</para> + + <para>カーネルは + INQUIRYに一致するデータをブート時にテーブルから + 探してこれにしたがってふるまいます. より多くの情報は + ソースコードを見てください.</para> + </sect4> + + <sect4> + <title>タグ コマンド キューイング</title> + + <para>最近の SCSI デバイス, 特に磁気ディスクではタグ + コマンド キューイング (tagged command queuing: TCQ) + がサポートされています.</para> + + <para>要約すれば, TCQ は複数の I/O + リクエストを同時に受けることを可能 にすることです. + デバイスはインテリジェントですから,リクエスト + キューにある処理 (ヘッドのポジショニングなど) の最適化を + おこなうことができます. RAID (Redundant Array of + Independent Disks) + のようなSCSIデバイスではTCQ機能はデバイスの持つ並列性の + 利点を生かすために不可欠です.</para> + + <para>各々の I/O リクエストは単一の “tag” (タグ + コマンド キューイン グの名前の由来) が与えられます. + FreeBSDはこの tagによりデバ イスドライバのキューの中のどの + I/Oリクエストが完了したかの 識 別をおこないます.</para> + + <para>TQC のリクエストはデバイスドライバが + サポートしていたとしても + あるデバイスのファームウェアではインプリメントが + “正しくない” かもしれません. + このような問題に出会うと非常に不可解な問題に つながります. + このような場合は TCQ を無効にしてみてください.</para> + </sect4> + + <sect4> + <title>バスマスタ ホストアダプタ</title> + + <para>すべてではありませんが多くの SCSIホストアダプタは + バスマスタコントローラです. これはホストCPUにデータ転送の + 負荷をかけず, ボード自身がI/Oをおこないます.</para> + + <para>これは + FreeBSDのようなマルチタスクのオペレーティングシステム + では大きな利点になります. しかし, + 何らかの問題の起きることも あります.</para> + + <para>例えば Adaptec 1542 コントローラは ホストバス + (ここでは ISA または AT バス) + を異なった転送速度に設定できます. コントローラが + 異なるレートに設定できるのは すべてのマザーボードで + 高速な転送が できるわけではないからです. + マザーボードに合っていない高速の + データ転送速度を用いた時には, + ハングアップやデータの損傷等の + 問題が起きるかもしれません.</para> + + <para>これを解決する方法は明らかです. + より低いデータ転送速度に設定 + してうまく動くか確かめることです.</para> + + <para>Adaptec 1542 の場合, + 可能な限り高速な転送レートを動的に読み取って, + 正しい決定をおこなうためのオプションを + カーネルコンフィグファイルに 追加することができます. + このオプションはデフォルトでは無効に なっています.</para> + + <programlisting> +options "TUNE_1542" #dynamic tune of bus DMA speed</programlisting> + + <para>あなたの使うホストアダプタについてのマニュアルページを + チェックしてください. + また最終的な手段としては究極のドキュメントを + 使ってください + (つまりドライバのソースを読んでくださいというこ + とです).</para> + + <para>訳注: 2.1.5R + の時点ではすべてのドライバに関してマニュアルページ + があるわけではありません. また上の例の + TUNE_1542のオプション も <emphasis remap=tt>man aha + </emphasis>にはないようです. ソースのコメントだけで + も一度見ておいてもいいかもしれません.</para> + </sect4> + </sect3> + + <sect3> + <title>問題を突き止める</title> + + <para>以下は SCSI + で一般的に問題が起きた場合に解決をするためのチェッ + クリストの試みです. これは完全な物ではありません.</para> + + <itemizedlist> + <listitem> + <para>コネクタとケーブルがゆるんでいないかチェックする. + </para> + </listitem> + + <listitem> + <para>ターミネータの場所と数を念には念を入れて + チェックする.</para> + </listitem> + + <listitem> + <para>少なくとも 1 + つのターミネータの電源の供給源があるかチェック する + (特に外部ターミネータを使う場合).</para> + </listitem> + + <listitem> + <para>ターゲットIDが重複していないかチェックする.</para> + </listitem> + + <listitem> + <para>使用するすべてのデバイスの電源が ON + になっているかチェックする.</para> + </listitem> + + <listitem> + <para>必要最小限のデバイスだけの構成を試してみる.</para> + </listitem> + + <listitem> + <para>可能であれば, + ホストアダプタのスピードを遅くする.</para> + </listitem> + + <listitem> + <para>問題をより単純にするために, + タグコマンドキューイングを可能 であれば無効にする. + (NCRベースのホストアダプタについては man ncrcontrol + を見てください)</para> + </listitem> + + <listitem> + <para>カーネルのコンパイルができるのであれば, + <literal>SCSIDEBUG</literal>オプショ ンをつけて + makeして, デバイスをデバッグモードにしてアクセ + スしてみてください. もしそれでも起動時にデバイスが検出 + されないのであれば, デバイスの設定アドレスが間違っている + のかもしれません. また, <emphasis + remap=tt>/sys/scsi/scsidebug.h </emphasis>に + あるデバッグレベルを変えてみてください. 検出はされるが + 動かないのであれば, &man.scsi.8; コマンドで + (<literal>SCSIDEBUG</literal> をつけてmakeした) + カーネルが動いている状態で動的にデバッグ + レベルを設定することができます. これは guru (UNIXの達人) + で も混乱してしまうほどの非常に大量のデバッグ情報を + 出すでしょ う. <command>man 4 scsi + </command>にはより正確な情報があります. また<command>man + 8 scsi</command> も見てください.</para> + </listitem> + </itemizedlist> + </sect3> + + <sect3 id="scsi-further-reading"> + <title>さらに詳しい情報</title> + + <para>もしあなたがいくらかは本気で + SCSIハッキングをする気があるなら + たぶん正規の規格を持っていたくなるでしょう.</para> + + <para>承認ずみのアメリカ工業規格は ANSI から購入できます. + 住所と電話番号は + + <address> + <otheraddr>13th Floor</otheraddr> + <street>11 West 42nd Street</street> + <city>New York</city> + <state>NY</state> <postcode>10036</postcode> + Sales Dept: <phone>(212) 642-4900</phone> + </address> + + です.</para> + + <para>また, ANSIの規格および委員会の規格案 (ドラフト) + のほとんどは Global Engineering Documents + より買うことができます. 連絡先は + + <address> + <street>15 Inverness Way East</street> + <city>Englewood</city> + <state>CO</state>, <postcode>80112-5704</postcode> + Phone: <phone>(800) 854-7179</phone> + Outside USA and Canada: <phone>(303) 792-2181</phone> + Fax: <fax>(303) 792- 2192</fax> + </address> + + です.</para> + + <para>X3T10 のドラフトの多くは電子的に利用できる形で SCSI BBS + (719-574-0424) と <hostid + role="fqdn">ncrinfo.ncr.com</hostid> の Anonymous FTP + (誰でも ファイルを取ってくることができるFTPサービス) + サイトから得るこ とができます.</para> + + <para>最新の X3T10委員会のドキュメントは:</para> + + <itemizedlist> + <listitem> + <para>AT Attachment (ATA or IDE) [X3.221-1994] + (<emphasis>Approved</emphasis>)</para> + </listitem> + + <listitem> + <para>ATA Extensions (ATA-2) [X3T10/948D Rev 2i]</para> + </listitem> + + <listitem> + <para>Enhanced Small Device Interface (ESDI) + [X3.170-1990/X3.170a-1991] + (<emphasis>Approved</emphasis>)</para> + </listitem> + + <listitem> + <para>Small Computer System Interface — + 2 (SCSI-2) [X3.131-1994] (<emphasis>Approved</emphasis>)</para> + </listitem> + + <listitem> + <para>SCSI-2 Common Access Method Transport and + SCSI Interface Module (CAM) + [X3T10/792D Rev 11]</para> + </listitem> + </itemizedlist> + + <para>追加情報を得ることのできる出版物は:</para> + + <itemizedlist> + <listitem> + <para>“SCSI: Understanding the Small Computer + System Interface”, NCR社 + 編. 出版: Prentice Hall, Englewood Cliffs, NJ, 07632 + Phone: (201) 767-5937 ISBN 0-13-796855-8</para> + </listitem> + + <listitem> + <para>“Basics of SCSI”, + a SCSI tutorial, Ancot Corporation 編 + Ancot の連絡先: + Phone: (415) 322-5322 Fax: (415) 322-0455</para> + </listitem> + + <listitem> + <para>“SCSI Interconnection Guide Book”, + AMP社の出版物 (発行 4/93, カ + タログ 65237) 色々な + SCSI コネクタのリスト と ケーブル接続方法のガイド. + AMP 社より入手可能. (800) 522-6752 + または (717) 564-0100</para> + </listitem> + + <listitem> + <para>“Fast Track to SCSI”, + 富士通によるプロダクトガイド, + 入手先: Prentice Hall, Englewood Cliffs, NJ, 07632 + 電話: (201) 767-5937 ISBN 0-13-307000-X</para> + </listitem> + + <listitem> + <para>“The SCSI Bench Reference”, + “The SCSI Encyclopedia”, “SCSI Tutor”, + ENDL Publications, 14426 Black Walnut Court, Saratoga CA, 95070 + 電話: (408) 867-6642</para> + </listitem> + + <listitem> + <para>“Zadian SCSI Navigator” + (クイックリファレンス) および + “Discover the Power of SCSI” + (最初の本は1時間のビデオとチュートリアルが付属), + Zadian Software, + Suite 214, 1210 S. Bascom Ave., + San Jose, CA 92128, (408) 293-0800</para> + </listitem> + </itemizedlist> + + <para>Usenet のニュースグループ <ulink + URL="news:comp.periphs.scsi">comp.periphs.scsi</ulink> と + <ulink URL="news:comp.periphs">comp.periphs</ulink> + は特により多くの情報を得るには注目すべき場所です. + また定期的に ポストされる + SCSI-FAQをここから得ることができます.</para> + + <para>多くの主要な SCSIデバイスとホストアダプタの供給元は FTP + サイト や BBSを開いています. + これらはあなたの持っているデバイスに関す + る貴重な情報源となるでしょう.</para> + </sect3> + </sect2> + + <sect2 id="hw-storage-controllers"> + <title>* ディスク/テープ コントローラ</title> + + <sect3> + <title>* SCSI</title> + + <para></para> + </sect3> + + <sect3> + <title>* IDE</title> + + <para></para> + </sect3> + + <sect3> + <title>* フロッピー</title> + + <para></para> + </sect3> + </sect2> + + <sect2> + <title>ハードディスクドライブ</title> + + <sect3> + <title>SCSI ハードディスク装置</title> + + <para><emphasis>寄稿: &a.asami; .<!-- <br> --> + 17 February 1998.</emphasis></para> + + <para><emphasis>訳: &a.jp.miyasita;.<!-- <br> --> + 20 February 1998.</emphasis></para> + + <para><link linkend="scsi">SCSI</link> の章で述べたように, + 実際, 現在販売されている SCSI ハードディスク装置はすべて + SCSI-2 互換であり, サポートされている SCSI ホストアダプタに + 接続すればそれらは正常に動作するでしょう. + 人々が直面する問題の多くは, ケーブル接続が間違っていたり + (ケーブルが長過ぎる, スター型接続になっている, など), + ケーブル終端の処理が不十分だったり, + 部品が故障していたりのうちのどれかです. + SCSI ハードディスク装置が動作しないときには, まず + <link linkend="scsi">SCSI</link> の章を参照して下さい. + しかし SCSI ハードディスク装置を購入するときに + 気を付けておきたいことがふたつあります.</para> + + <sect4> + <title>回転速度</title> + + <para>現在販売されている SCSI ドライブの回転速度の範囲は + 4,500RPM から 10,000RPM であり, その大部分は 5,400RPM か + 7,200RPM です. 一般的に 7,200RPM + のドライブの方がデータ転送は速いのですが, 5,400RPM + の同容量のものと比べてとても熱くなります. + 現在のディスク装置の故障の大半は熱によるものです. もし PC + のケースの中が非常によく冷却されていなければ, 5,400RPM + かそれ以下のドライブにしておいた方がよいでしょう.</para> + + <para>より高密度で記録するようになっている新しいドライブは + 以前のものに比べてより多くのビットを + 各回転毎に転送することが + できるということに気をつけて下さい. 現在, 5,400RPM + の最高級機種では 1, 2 世代前の 7,200RPM の + ドライブに匹敵する転送速度が出せます. + 仕様一覧からバンド幅の数値を探すには “内部データ + (または転送) 速度” という欄を見て下さい. + 通常その数値は Mbits/s で書かれているので, それを 8 + で割ればそのドライブで出せる速度が Mbytes/s で + おおよそ見当をつけることができます.</para> + + <para>(もしあなたがスピード狂で, + あなたの愛する小さなパソコンちゃんに 10,000RPM + のドライブを載せたいのならそうしても構いませんが, + そのようなドライブはものすごく熱くなります. ドライブへ + <emphasis>直接</emphasis> 風を当てられるようなファンや + きちんと換気されているディスク区画を持っていないときには + そういうことは考えない方がよいでしょう.)</para> + + <para>最新の 10,000RPM のドライブや 7,200RPM + のドライブは当然 最新の 5,400RPM + のドライブよりも多くのデータを転送することが できますから, + 絶対的なバンド幅がアプリケーションにとって 必要ならば, + より速いドライブを選ぶしかありません. また, + レイテンシを小さくする必要があるときも, + より速いドライブが適当です. なぜなら, + より速いドライブの方が平均シーク時間が 少ないだけでなく, + 回転遅延という尺度において + 低回転速度のドライブが高回転速度のものに + 勝ることはないからです. (平均回転レイテンシはディスクが 1 + 回転するために要する時間を半分に したものです. すなわち, + 10,000RPM のドライブでは 3 ms, 7,200RPM のドライブでは 4.2 + ms, 5,400RPM のドライブでは 5.6 ms となります.) + レイテンシはシーク時間と回転遅延との和になります. + しかしここで, レイテンシの少ないドライブが欲しいのか, 1 + 秒あたりのアクセス数を増やす方がよいのかを + はっきりさせておかなければいけません. 後者の場合 (例 : + ニュースサーバ) では, 大きな速いドライブを 1 + つ購入することは最適解とはならないでしょう. + 遅いドライブを複数個使ってストライピングされた + ディスクアレイを 作る ccd (連結ディスク) + ドライバを用いることによって, + 全体に必要な費用の点で同様かまたはより + 良い結果を得ることができます.</para> + + <para>ドライブのまわりに適切な空気の + 流れを作るようにする必要が あります. + 高回転速度のドライブを使おうとしているときには特に + 注意してください. 一般的に, ドライブの上下には少なくとも + 1/2 インチ (1.25cm) の すき間が必要です. PC + のケース内の空気がどんなふうに流れているか + 理解しておいてください. + 多くのケースには背面から空気を吸い込む電源が付いています. + どこから空気が入ってくるかを確かめて, まわりに最大量の + 冷たい空気が流れるようにドライブを設置してください. + 効果的に冷却するためには, 不要な穴をいくつか塞いだり + 新しいファンを追加する必要があるかも知れません.</para> + + <para>もうひとつ考慮するべき事柄は騒音です. 7,200RPM + やそれより速い回転速度のドライブの多くは高い周波数の + 音を発生し, この音は多くの人をとても不快にします. + それに加えて, 冷却のために追加されたファンによっても, + 7,200RPM + やそれより速い回転速度のドライブはオフィスや家の環境に + そぐわないものになるかもしれません.</para> + </sect4> + + <sect4> + <title>形状</title> + + <para>現在販売されている大部分の SCSI ドライブは 3.5 + インチの 大きさです. それらは高さが 1.6 インチ + (“ハーフハイト”) のものと 1 インチ + (“ロープロファイル”) のものとの 2 + 種類に分類されます. ハーフハイトのドライブは CD-ROM + ドライブと同じ高さです. しかし前節で述べたすき間についての + ルールを忘れないでください. 3.5 インチドライブ用のベイが 3 + 段用意されているときに, ハーフハイトのドライブ 3 個を + (焦がすことなく) + そこに設置することはできないでしょう.</para> + </sect4> + + <sect4> + <title>インタフェース</title> + + <para>現在売られている SCSI ハードドライブの多くは Ultra + または Ultra-wide SCSI です. Ultra SCSI の最大バンド幅は + 20MB/s, Ultra-wide SCSI の場合は 40MB/s です. Ultra と + Ultra-wide の間にケーブル最大長の相違はありませんが, + 同一バスに接続されるデバイスが増えれば増えるほど + 早い時期にバスの整理に関する問題を + 抱えることになるでしょう. + うまく設計されたディスク区画を持っているのでなければ, 5 + 個か 6 個以上の Ultra SCSI ドライブを 1 本のバスに + 接続することは容易なことではありません.</para> + + <para>一方, 多数のドライブを接続する必要があるときに + Fast-wide SCSI を利用することは悪くないアイデアでしょう. + これは Ultra (narrow) SCSI + と同じ最大バンド幅であると同時に “正しく” + 接続することが電気的にとても容易です. + アドバイスとしてはこのようになるでしょうか : + ディスクを多数接続したいときには wide SCSI のドライブを + 選んで下さい. 通常 wide SCSI の方が少し高価ですが, + 将来きっと役に立ちます. (なお, + 価格差を補う余裕がないときにはディスクアレイを + 作るべきではありません.)</para> + + <para>wide SCSI ドライブには 68 ピンのものと 80ピン SCA + (単コネクタ型) のものとの 2 種類があります. SCA + ドライブには 4 ピンの電源コネクタがなく, SCSI ID も 80 + ピンコネクタを通じて設定されます. + 真面目に大規模な記憶システムを作成するような場合には, SCA + ドライブと SCA 筺体 (2 + 種類の電圧が供給できる電源と少なくとも 1 + 個のファンが付いたもの) を使ってください. その方が 68 + ピンの同様のドライブよりも電気的に優れています. なぜなら, + 68 ピンのドライブで作ったディスクアレイに 見られるような + SCSI バスの “スタブ” + がディスクキャニスタの内部に 存在しないからです. + それらはより簡単に設置することができます + (キャニスタの中にドライブをねじで固定すればよいだけで, + (SCSI ID やディスクアクセス LED 用の線のような) + 細かいケーブルを全部持ち上げるために狭いところへ指を入れて + 握らなくてもよいのです).</para> + </sect4> + </sect3> + + <sect3> + <title>* IDE ハードディスクドライブ</title> + + <para></para> + </sect3> + </sect2> + + <sect2> + <title>テープドライブ</title> + + <para><emphasis>原作: &a.jmb;.<!-- <br> --> + 2 July 1996.</emphasis></para> + + <para><emphasis>訳: &a.jp.yoshiaki;.<!-- <br> --> + 13 October 1996.</emphasis></para> + + <sect3> + <title>一般的なテープアクセスコマンド</title> + + <para>&man.mt.1; はテープドライブへの一般的なアクセス方法を提 + 供します. <command>rewind</command>, + <command>erase</command>, <command>status</command>など + の共通コマンドがあります. マニュアルページの &man.mt.1; を見 + てください. より詳しい解説があります.</para> + </sect3> + + <sect3> + <title>コントローラインタフェース</title> + + <para>テープドライブにはいくつかの異なったインタフェースがあり + ます. SCSI, IDE, フロッピー, パラレルポートのインタフェース + です. + 非常に多くの種類のテープドライブがこれらのインタフェー + スで使えます. コントローラについての議論は<link + linkend="hw-storage-controllers">ディスク/テープ + のコントローラ</link>にあります(訳注:現在未完成です).</para> + </sect3> + + <sect3> + <title>SCSI ドライブ</title> + + <para>&man.st.4; ドライバは 8mm (Exabyte), 4mm (DAT: Digital + Audio Tape), QIC (1/4インチカートリッジ), + DLT (デジタルリニアテープ), + QIC ミニカートリッジ, 9トラック (大きなリールがハリウッドの + コンピュータルームで回っているのを見たことがあるでしょう) + をサポートします. + &man.st.4; マニュアルページにより詳しい解説があります. + </para> + + <para>以下のドライブリストは現在 FreeBSDコミュニティのメンバが + 使っているものです. これらだけが FreeBSDで動くドライブという + わけではありません. + これらは単にたまたま私たちのうちの誰かが使っ + ているというだけです.</para> + + <sect4> + <title>4mm (DAT: Digital Audio Tape )</title> + + <para><link linkend="hw-storage-python">Archive Python</link></para> + <para><link linkend="hw-storage-hp1533a">HP C1533A</link></para> + <para><link linkend="hw-storage-hp1534a">HP C1534A</link></para> + <para><link linkend="hw-storage-hp35450a">HP 35450A</link></para> + <para><link linkend="hw-storage-hp35470a">HP 35470A</link></para> + <para><link linkend="hw-storage-hp35480a">HP 35480A</link></para> + <para><link linkend="hw-storage-sdt5000">SDT-5000</link></para> + <para><link linkend="hw-storage-wangtek6200">Wangtek 6200</link></para> + </sect4> + + <sect4> + <title>8mm (Exabyte)</title> + + <para><link linkend="hw-storage-exb8200">EXB-8200</link></para> + <para><link linkend="hw-storage-exb8500">EXB-8500</link></para> + <para><link linkend="hw-storage-exb8505">EXB-8505</link></para> + </sect4> + + <sect4> + <title>QIC (1/4 インチカートリッジ)</title> + + <para><link linkend="hw-storage-anaconda">Archive Anaconda 2750</link></para> + <para><link linkend="hw-storage-viper60">Archive Viper 60</link></para> + <para><link linkend="hw-storage-viper150">Archive Viper 150</link></para> + <para><link linkend="hw-storage-viper2525">Archive Viper 2525</link></para> + <para><link linkend="hw-storage-tandberg3600">Tandberg TDC 3600</link></para> + <para><link linkend="hw-storage-tandberg3620">Tandberg TDC 3620</link></para> + <para><link linkend="hw-storage-tandberg4222">Tandberg TDC 4222</link></para> + <para><link linkend="hw-storage-wangtek5525es">Wangtek 5525ES</link></para> + </sect4> + + <sect4> + <title>DLT (Digital Linear Tape)</title> + + <para><link linkend="hw-storage-dectz87">Digital TZ87</link></para> + </sect4> + + <sect4> + <title>Mini-Cartridge</title> + + <para><link linkend="hw-storage-ctms3200">Conner CTMS 3200</link></para> + <para><link linkend="hw-storage-exb2501">Exabyte 2501</link></para> + </sect4> + + <sect4> + <title>Autoloaders/Changers</title> + + <para><link linkend="hw-storage-hp1553a">Hewlett-Packard HP C1553A Autoloading DDS2</link></para> + </sect4> + </sect3> + + <sect3> + <title>* IDE ドライブ</title> + + <para></para> + </sect3> + + <sect3> + <title>フロッピードライブ</title> + + <para><link linkend="hw-storage-conner420r">Conner 420R</link></para> + </sect3> + + <sect3> + <title>* パラレルポートドライブ</title> + + <para></para> + </sect3> + + <sect3> + <title>詳細な情報</title> + + <sect4 id="hw-storage-anaconda"> + <title>Archive Ananconda 2750</title> + + <para>このドライブのブートメッセージの識別子は + <literal>ARCHIVE ANCDA 2750 28077 -003 type 1 removable + SCSI 2</literal> です.</para> + + <para>これは QIC テープドライブです.</para> + + <para>QIC-1350テープを利用した場合の標準の容量は 1.35GBです. + このドライブは QIC-150 (DC6150), QIC-250 (DC6250), QIC-525 + (DC6525) の + テープを問題なく読み書きすることができます.</para> + + <para>&man.dump.8; を使った時のデータ転送レートは + 350kB/sです. <link + linkend="backups-programs-amanda">Amanda</link> + における転送レートは 530kB/sと報告されています.</para> + + <para>このドライブは既に生産中止になっています.</para> + + <para>このテープドライブの + SCSIバスコントローラは他のほとんどの + SCSIドライブとピン配置が逆です. Anaconda + テープドライブの前後でSCSIケー + ブルを1/2ひねることができるくらい SCSI + ケーブルが長いことを確認しておく か, 他の + SCSIデバイスのピン配置を入れ換えておく必要 + があります.</para> + + <para>そして, このドライブではカーネルコードの変更が + 2箇所必要です. そ のままではうまく動かないでしょう.</para> + + <para>SCSI-2コントローラを持っているなら, ジャンパの + 6番をショート してください. そうしないとこのドライブは + SCSI-1として働きます. SCSI-1の デバイスとして動作する時, + このドライブはテープのfsf (早送り), rewind (巻 + 戻し),rewoffl (巻戻してオフラインにする) + 等を含む操作を行っている間, + SCSIバスを“ロック”します.</para> + + <para>NCR SCSIコントローラを使う場合, + <filename>/usr/src/sys/pci/ncr.c</filename> (以 + 下を参照してください)にパッチを行って, カーネルを作り直し, + 新しいカーネ ルをインストールしてください.</para> + + <programlisting> +*** 4831,4835 **** }; ! if (np->latetime>4) { /* + ** Although we tried to wake it up, --- 4831,4836 + ---- }; ! if (np->latetime>1200) { /* + ** Although we tried to wake it up,</programlisting> + + <para>報告者: &a.jmb;</para> + </sect4> + + <sect4 id="hw-storage-python"> + <title>Archive Python</title> + + <para>このドライブのブートメッセージの識別子は + <literal>ARCHIVE Python 28454-XXX4ASB</literal> + <literal>type 1 removable SCSI 2</literal> + <literal>density code 0x8c, 512-byte blocks</literal> + です.</para> + + <para>これは DDS-1 テープドライブです.</para> + + <para>90m テープを使った場合の標準容量は 2.5GBです.</para> + + <para>データ転送速度は不明です.</para> + + <para>このドライブは Sun マイクロシステムが再パッケージして + model 411として出しています.</para> + + <para>報告者: Bob Bishop <email>rb@gid.co.uk</email></para> + </sect4> + + <sect4 id="hw-storage-viper60"> + <title>Archive Viper 60</title> + + <para>このドライブのブートメッセージ識別子は + <literal>ARCHIVE VIPER 60 21116 -007</literal> + <literal>type 1 removable SCSI 1</literal> です.</para> + + <para>これは QICテープドライブです.</para> + + <para>標準の容量は 60MB です.</para> + + <para>データ転送レートは不明です.</para> + + <para>このドライブは生産中止になっています.</para> + + <para>報告者: Philippe Regnauld <email>regnauld@hsc.fr</email></para> + </sect4> + + <sect4 id="hw-storage-viper150"> + <title>Archive Viper 150</title> + + <para>このドライブのブートメッセージの識別子は + <literal>ARCHIVE VIPER 150 21531 -004</literal> + <literal>Archive Viper 150 is a known rogue</literal> + <literal>type 1 removable SCSI 1</literal>です. + このドライブのファームウェアには多くのリビジョ + ンがあります. + あなたのドライブではことなった数字が表示されるかもしれま + せん(例えば <literal>21247 -005</literal>).</para> + + <para>これは QICテープドライブです.</para> + + <para>標準容量は 150/250MBです. 150MB (DC6150) テープと + 250MB (DC6250)テープの記録フォーマットがあります. + 250MBテープは およそ67% 150MBテープより長いです. + このドライブは 120MBのテープを問題 なく読むことができます. + 120MBテープに書き込むことはできません.</para> + + <para>データ転送レートは100kB/sです.</para> + + <para>このドライブは DC6150 (150MB) と DC6250 (250MB) + テープの読み 書きができます.</para> + + <para>このドライブの奇妙な癖は + SCSIテープデバイスドライバはあら かじめ (&man.st.4;) + にあらかじめ組み込まれています.</para> + + <para>FreeBSD 2.2-currentでは, + ブロックサイズの設定を設定するため<command>mt blocksize + 512</command>としてください. (ファームウェアリビジョンが + 21247 -005 である場合の問題です. + 他のリビジョンのファームウェアでは異 なる場合があります.) + これ以前の + FreeBSDバージョンにはこの問題はありません.</para> + + <para>このドライブは生産中止になっています.</para> + + <para>報告者: Pedro A M Vazquez + <email>vazquez@IQM.Unicamp.BR</email></para> + + <para>Mike Smith + <email>msmith@atrad.adelaide.edu.au</email></para> + </sect4> + + <sect4 id="hw-storage-viper2525"> + <title>Archive Viper 2525</title> + + <para>このドライブのブートメッセージの識別子は + <literal>ARCHIVE VIPER 2525 25462 -011</literal> + <literal>type 1 removable SCSI 1</literal>です.</para> + + <para>これは QICテープドライブです.</para> + + <para>標準容量は 525MBです.</para> + + <para>データ転送レートは 90inch/secの場合で 180kB/sです.</para> + + <para>QIC-525, QIC-150, QIC-120, + QIC-24のテープを読むことができま す. QIC-525, QIC-150, + QIC-120 に書き込むことができます.</para> + + <para>ファームウェアのリビジョンが <literal>25462 + -011</literal> 以前の物はバグが 多く, + 正しく機能しません.</para> + + <para>このドライブは生産中止になっています.</para> + </sect4> + + <sect4 id="hw-storage-conner420r"> + <title>Conner 420R</title> + + <para>このドライブのブートメッセージの識別子は + <literal>Conner tape</literal> です.</para> + + <para>これはフロッピーコントローラを + 使うミニカートリッジテープド ライブです.</para> + + <para>標準容量は不明です.</para> + + <para>データ転送レートは不明です.</para> + + <para>このドライブは QIC-80テープドライブを使います.</para> + + <para>報告者: Mark Hannon <email>mark@seeware.DIALix.oz.au</email></para> + </sect4> + + <sect4 id="hw-storage-ctms3200"> + <title>Conner CTMS 3200</title> + + <para>このドライブのブートメッセージの識別子は + <literal>CONNER CTMS 3200 7.00</literal> <literal>type 1 + removable SCSI 2</literal> です.</para> + + <para>これはミニカートリッジテープドライブです.</para> + + <para>標準容量は不明です.</para> + + <para>データ転送レートは不明です.</para> + + <para>このドライブは QIC-3080テープカートリッジを使います.</para> + + <para>報告者: Thomas S. Traylor <email>tst@titan.cs.mci.com</email></para> + </sect4> + + <sect4 id="hw-storage-dectz87"> + <title><ulink URL="http://www.digital.com/info/Customer-Update/931206004.txt.html">DEC TZ87</ulink></title> + + <para>このドライブのブートメッセージの識別子は <literal>DEC + TZ87 (C) DEC 9206</literal> <literal>type 1 removable + SCSI 2</literal> <literal>density code 0x19</literal> + です.</para> + + <para>これは DLTテープドライブです.</para> + + <para>標準容量は 10GBです.</para> + + <para>このドライブはハードウェアデータ圧縮の機能があります.</para> + + <para>データ転送レートは 1.2MB/sです.</para> + + <para>このドライブは Quantum DLT2000と同一の物です. + このドライブ のファームウェアは Exabyteの + 8mmドライブ等のよく知られたいくつかのドラ + イブのエミュレートをおこなうよう設定ができます.</para> + + <para>報告者: &a.wilko;</para> + </sect4> + + <sect4 id="hw-storage-exb2501"> + <title><ulink URL="http://www.Exabyte.COM:80/Products/Minicartridge/2501/Rfeatures.html">Exabyte EXB-2501</ulink></title> + + <para>このドライブのブートメッセージ識別子は + <literal>EXABYTE EXB-2501</literal>です.</para> + + <para>これはミニカートリッジテープドライブです.</para> + + <para>MC3000XLミニカートリッジを使った時の標準容量は 1GBです.</para> + + <para>データ転送レートは不明です.</para> + + <para>このドライブは DC2300 (550MB), DC2750 (750MB), MC3000 + (750MB), MC3000XL (1GB) + ミニカートリッジの読み書きができます.</para> + + <para>注意: このドライブは SCSI-2の仕様に適合していません. + このドライブは, フォーマット済みのテープ以外を入れた場合, + SCSI MODE_SELCTコマンドで完全にロックアップしてしまいます. + このドライブを使 う前に, + テープブロックサイズを次のように設定します.</para> + + <screen>&prompt.root; <userinput>mt -f /dev/st0ctl.0 blocksize 1024</userinput></screen> + + <para>ミニカートリッジは最初に使う前に + フォーマットしなければなりません. FreeBSD 2.1.0-RELEASE + およびそれ以前の場合は</para> + + <screen>&prompt.root; <userinput>/sbin/scsi -f /dev/rst0.ctl -s 600 -c "4 0 0 0 0 0"</userinput></screen> + + <para>(あるいは, FreeBSD 2.1.5/2.2から + <command>scsiformat</command>シェルスクリプトを + コピーして持ってきた場合と) FreeBSD + 2.1.5およびそれ以降の場合は <screen>&prompt.root; + <userinput>/sbin/scsiformat -q -w + /dev/rst0.ctl</userinput></screen> とします.</para> + + <para>今のところ, + FreeBSDではこのドライブはあまりおすすめできません.</para> + + <para>報告者: Bob Beaulieu <email>ez@eztravel.com</email></para> + </sect4> + + <sect4 id="hw-storage-exb8200"> + <title>Exabyte EXB-8200</title> + + <para>このドライブのブートメッセージの識別子は + <literal>EXABYTE EXB-8200 252X</literal> <literal>type 1 + removable SCSI 1</literal>です.</para> + + <para>これは8mmテープドライブです.</para> + + <para>標準容量は 2.3GBです.</para> + + <para>データ転送レートは 270kB/sです.</para> + + <para>このドライブはブート時の + SCSIバスへの応答はわりあい遅いです. + カスタムカーネルが必要かもしれません (SCSI_DELAYを + 10秒に設定しましょう). 訳注: GENERICカーネルの設定では + 15秒になっています.</para> + + <para>このドライブには非常に多くのファームウェアの + 構成があります. + あるドライブでは特定のベンダのハードウェアに + カスタマイズしてあります. ファームウェアは + EPROMを置き換えることで変更できます.</para> + + <para>このドライブは生産中止になっています.</para> + + <para>報告者: Mike Smith <email>msmith@atrad.adelaide.edu.au</email></para> + </sect4> + + <sect4 id="hw-storage-exb8500"> + <title>Exabyte EXB-8500</title> + + <para>このドライブのブートメッセージの識別子は + <literal>EXABYTE EXB-8500-85Qanx0 0415</literal> + <literal>type 1 removable SCSI 2</literal> です.</para> + + <para>これは 8mmテープドライブです.</para> + + <para>標準容量は 5GBです.</para> + + <para>データ転送レートは 300kB/sです.</para> + + <para>報告者: Greg Lehey <email>grog@lemis.de</email></para> + </sect4> + + <sect4 id="hw-storage-exb8505"> + <title><ulink URL="http://www.Exabyte.COM:80/Products/8mm/8505XL/Rfeatures.html">Exabyte EXB-8505</ulink></title> + + <para>このドライブのブートメッセージ識別子は + <literal>EXABYTE EXB-85058SQANXR1 05B0</literal> + <literal>type 1 removable SCSI 2</literal>です.</para> + + <para>これは 圧縮機能を持った 8mmテープドライブで, EXB-5200 + と EXB-8500に対する上位互換品です.</para> + + <para>標準容量は 5GBです.</para> + + <para>このドライブは + ハードウェアデータ圧縮機能があります.</para> + + <para>データ転送レートは 300kB/sです.</para> + + <para>報告者: Glen Foster <email>gfoster@gfoster.com</email></para> + </sect4> + + <sect4 id="hw-storage-hp1533a"> + <title>Hewlett-Packard HP C1533A</title> + + <para>このドライブのブートメッセージの識別子は <literal>HP + C1533A 9503</literal> <literal>type 1 removable SCSI + 2</literal>です.</para> + + <para>これはDDS-2テープドライブです. DDS-2 + とはデータ容量を増や すためにハードウェア圧縮と + 狭いトラックを採用したものです.</para> + + <para>120mテープを使った場合の標準容量は4GBです. + このドライブは + ハードウェアデータ圧縮機能があります.</para> + + <para>データ転送レートは510kB/sです.</para> + + <para>このドライブはヒューレットパッカード社の 6000eU および + 6000i テー プドライブ, C1533A DDS-2 DAT + ドライブに使われています.</para> + + <para>このドライブは 8接点のディップスイッチがあります. + FreeBSDで の適切な設定は 1 ON; 2 ON; 3 OFF; 4 ON; 5 ON; 6 + ON; 7 ON; 8 ON です. </para> + + <informaltable frame="none"> + <tgroup cols="3"> + <thead> + <row> + <entry>スイッチ 1</entry> + <entry>スイッチ 2</entry> + <entry>結果</entry> + </row> + </thead> + + <tbody> + <row> + <entry>On</entry> + <entry>On</entry> + <entry>電源投入時に圧縮 ON, + ホストによるコントロール可能</entry> + </row> + + <row> + <entry>On</entry> + <entry>Off</entry> + <entry>電源投入時に圧縮 ON, + ホストによるコントロール不可</entry> + </row> + + <row> + <entry>Off</entry> + <entry>On</entry> + <entry>電源投入時に圧縮 OFF, + ホストによるコントロール可能</entry> + </row> + + <row> + <entry>Off</entry> + <entry>Off</entry> + <entry>電源投入時に圧縮 OFF, + ホストによるコントロール不可</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>スイッチ 3 は MRS (Media Recognition System + :メディア認識システ ム) をコントロールします. MRS + テープは透明なテープリーダ部分にしま模 様があります. + これはテープが DDS (Digital Data Storage) グレードである + ことを示します. + しま模様のないテープはライトプロテクトされたものとして + 扱います. スイッチ3をOFFにすると MRSが有効になります. + スイッチ3をONに すると MRSは無効になります.</para> + + <para>訳注: 安価な音楽用のDATテープを使うには + MRSをOFFにしておきます</para> + + <para>このドライブの設定についてのより詳しい情報は <ulink + URL="http://www.hp.com/tape/c_intro.html">HP SureStore + Tape Products</ulink> および <ulink + URL="http://www.impediment.com/hp/hp_technical.html">Hewlett-Packard Disk and Tape Technical Information</ulink> をご覧ください.</para> + + <para><emphasis>注意:</emphasis> + これらのドライブの品質管理は非常に幅がありま す. ある + FreeBSDコアチームのメンバは + このドライブを2つ返品しました.</para> + + <para>報告者: &a.se;</para> + </sect4> + + <sect4 id="hw-storage-hp1534a"> + <title>Hewlett-Packard HP 1534A</title> + + <para>このドライブのブートメッセージの識別子は <literal>HP + HP35470A T503</literal> <literal>type 1 removable SCSI + 2</literal> <literal>Sequential-Access density code + 0x13, variable blocks</literal>です.</para> + + <para>これは DDS-1テープドライブです. DDS-1 は最初の DAT + テープフォーマットです.</para> + + <para>90m テープを使った場合の標準容量は 2GBです.</para> + + <para>データ転送レートは 183kB/sです.</para> + + <para>ヒューレットパッカード社の SureStore <ulink + URL="http://www.dmo.hp.com/tape/sst2000.htm"> 2000i + </ulink> テープドライブ, C35470A DDS フォーマット + DATドライブ, C1534A DDS フォーマット DATドライブ, HP + C1536A DDS フォーマット DATドライブと + 同じ機構を使用しています.</para> + + <para>HP C1534A DDSフォーマット + DATドライブはグリーンと黄色(アンバー) + の2つの表示ランプがあります. グリーンのランプは動作状 + 態を示し, ローディング中はゆっくり点滅, + ローディングが終了すると点灯, + read/write動作中は速く点滅します. 黄色のランプは警告灯で, + クリーニング + が必要であるかまたはテープが寿命に近くなるとゆっくり点滅, + 致命的なエラー + の場合は点灯します(工場での修理が必要かもしれません). + </para> + + <para>報告者:Gary Crutcher + <email>gcrutchr@nightflight.com</email></para> + </sect4> + + <sect4 id="hw-storage-hp1553a"> + <title>Hewlett-Packard HP C1553A Autoloading DDS2</title> + + <para>このドライブのブートメッセージの識別子は未確認です. + </para> + + <para>これはテープチェンジャ付の DDS-2テープドライブです. + DDS-2 とはデータ容量を増や + すためにハードウェア圧縮と狭いトラックを + 採用したものです.</para> + + <para>120mテープを使用した場合の標準容量は 24GB です. + このドライブはハードウェアデータ圧縮機能があります.</para> + + <para>データ転送レートは510kB/s (標準) です.</para> + + <para>このドライブはヒューレットパッカード社の SureStore + <ulink URL="http://www.dmo.hp.com/tape/sst12000.htm"> + 12000e </ulink> テープドライブに使われています.</para> + + <para>このドライブはリアパネルに2つの選択スイッチがあります. + ファンに近いスイッチは SCSI IDです. もうひとつは + 7に設定しておきます.</para> + + <para>内部に 4個のスイッチがあります. これらは 1 ON; 2 ON; + 3 ON; 4 OFF に設定しておきましょう.</para> + + <para>現在のカーネルドライバはボリュームの終りで + 自動的にテープを 交換しません. ここに示す + shellスクリプトでテープを交換できます.</para> + + <programlisting> +#!/bin/sh +PATH="/sbin:/usr/sbin:/bin:/usr/bin"; export PATH + +usage() +{ + echo "Usage: dds_changer [123456ne] raw-device-name + echo "1..6 = Select cartridge" + echo "next cartridge" + echo "eject magazine" + exit 2 +} + +if [ $# -ne 2 ] ; then + usage +fi + +cdb3=0 +cdb4=0 +cdb5=0 + +case $1 in + [123456]) + cdb3=$1 + cdb4=1 + ;; + n) + ;; + e) + cdb5=0x80 + ;; + ?) + usage + ;; +esac + +scsi -f $2 -s 100 -c "1b 0 0 $cdb3 $cdb4 $cdb5"</programlisting> + </sect4> + + <sect4 id="hw-storage-hp35450a"> + <title>Hewlett-Packard HP 35450A</title> + + <para>このドライブのブートメッセージの識別子は <literal>HP + HP35450A -A C620</literal> <literal>type 1 removable + SCSI 2</literal> <literal>Sequential-Access density code + 0x13</literal> です.</para> + + <para>これは DDS-1テープドライブです. DDS-1 は最初の DAT + テープフォーマットです.</para> + + <para>標準容量は 1.2GBです.</para> + + <para>データ転送レートは 160kB/sです.</para> + + <para>報告者: mark thompson + <email>mark.a.thompson@pobox.com</email></para> + </sect4> + + <sect4 id="hw-storage-hp35470a"> + <title>Hewlett-Packard HP 35470A</title> + + <para>このドライブのブートメッセージの識別子は <literal>HP + HP35470A 9 09</literal> <literal>type 1 removable SCSI + 2</literal>です.</para> + + <para>これは DDS-1テープドライブです. DDS-1は最初の DAT + テープフォーマットです.</para> + + <para>90mテープを使用した時の標準容量は 2GBです.</para> + + <para>データ転送レートは 183kB/sです.</para> + + <para>これはヒューレットパッカード社の SureStore <ulink + URL="http://www.dmo.hp.com/tape/sst2000.htm"> 2000i + </ulink> テープドライブ, C35470A + DDSフォーマットDATドライブ, C1534A + DDSフォーマットDATドライブ, HP C1536A DDS + フォーマットDATドライブと同 じ機構が使われています.</para> + + <para><emphasis>注意:</emphasis> + これらのドライブの品質管理には非常に大き な幅があります. + ある FreeBSDコアチームのメンバは 5台のドライブを返品し + ました. 9ヶ月以上もったものはありません.</para> + + <para>報告者: David Dawes + <email>dawes@rf900.physics.usyd.edu.au</email> (9 09)</para> + </sect4> + + <sect4 id="hw-storage-hp35480a"> + <title>Hewlett-Packard HP 35480A</title> + + <para>このドライブのブートメッセージの識別子は <literal>HP + HP35480A 1009</literal> <literal>type 1 removable SCSI + 2</literal> <literal>Sequential-Access density code + 0x13</literal> です.</para> + + <para>これは DDS-DCテープドライブです. + DDS-DCはハードウェアデータ 圧縮のついたDDS-1です. + DDS-1は最初のDATテープフォーマットです.</para> + + <para>90mテープを使った場合の標準容量は 2GBです. + 120mテープは使用 できません. + このドライブはハードウェア圧縮機能があります. + 適切なスイッチ設定に関しては, <link + linkend="hw-storage-hp1533a">HP C1533A</link> + の節を参照してください.</para> + + <para>データ転送レートは 183kB/sです.</para> + + <para>このドライブはヒューレットパッカード社の SureStore + <ulink URL="http://www.dmo.hp.com/tape/sst5000.htm"> + 5000eU </ulink> , <ulink + URL="http://www.dmo.hp.com/tape/sst5000.htm"> 5000i + </ulink> テープドラ イブ, C35480A DDS フォーマット DAT + ドライブと同じ機構を使っています.</para> + + <para>このドライブは時々, テープの eject操作 (<command>mt + offline</command>) + を行っている時にハングアップすることがあります. + テープをejectさせたり, + ドライブを回復させるにはフロントパネルのボタンを + 押してください.</para> + + <para>注意: HP 35480-03110 では特有の問題がありました. + 少なくとも2回, FreeBSD 2.1.0 で IBM Server 320に 2940W + SCSIコントローラ + をつけてこのドライブを使っている時にすべての + SCSIディスクのパーティショ ンが失われたことがあります. + この問題は解析も解決もできていません.</para> + </sect4> + + <sect4 id="hw-storage-sdt5000"> + <title><ulink URL="http://www.sel.sony.com/SEL/ccpg/storage/tape/t5000.html">Sony SDT-5000</ulink></title> + + <para>これらには少なくとも DDS-1のものと + DDS-2のものの2つのモデルが あります. DDS-1のものは + <literal>SDT-5000 3.02</literal>です. DDS-2のものは + <literal>SONY SDT-5000 327M</literal> です. + DDS-2バージョンには 1MBのキャッシュがあります. この + キャッシュによりあらゆる状況で + テープのデータの流れを途切れさせません.</para> + + <para>このドライブのブートメッセージの識別子は <literal>SONY + SDT-5000 3.02</literal> <literal>type 1 removable SCSI + 2</literal> <literal>Sequential-Access density code + 0x13</literal>です.</para> + + <para>120mテープを使用した場合の標準容量は 4GBです. + このドライブ + はハードウェアデータ圧縮機能があります.</para> + + <para>データ転送レートはドライブのモデルによります. + <literal>SONY SDT-5000 327M</literal> + でデータ圧縮を行った場合のレートは 630kB/s です. + <literal>SONY SDT-5000 3.02</literal>では + 225kB/sです.</para> + + <para>Kenneth Merry + ken@ulc199.residence.gatech.eduの報告によれば + このドライブからデータを読むためには, ブロックサイズを + 512バイトにしま す (<command>mt blocksize + 512</command>).</para> + + <para><literal>SONY SDT-5000 327M</literal> の情報は Charles + Henrich henrich@msu.edu による報告です.</para> + + <para>報告者: &a.jmz;</para> + </sect4> + + <sect4 id="hw-storage-tandberg3600"> + <title>Tandberg TDC 3600</title> + + <para>このドライブのブートメッセージの識別子は + <literal>TANDBERG TDC 3600 =08:</literal> <literal>type 1 + removable SCSI 2</literal>です.</para> + + <para>このドライブはQIC テープドライブです.</para> + + <para>標準容量は150/250MBです.</para> + + <para>このドライブには奇妙な癖があることが知られていますが, + SCSIテープドライバ (&man.st.4;) + には問題なく動くコードが含まれてい + ます. 問題の修整とSCSI + 2へのコンパチビリティを得るためにファームウェ アをある + (具体的には不明の) バージョンより上にしてください.</para> + + <para>データ転送レートは80kB/sです.</para> + + <para>IBMと Emerald製品のユニットは動かないでしょう. + 問題を解決するためにファームウェア + EPROMを交換してください.</para> + + <para>報告者: Michael Smith + <email>msmith@atrad.adelaide.edu.au</email></para> + </sect4> + + <sect4 id="hw-storage-tandberg3620"> + <title>Tandberg TDC 3620</title> + + <para>これは <link + linkend="hw-storage-tandberg3600">Tandberg TDC + 3600</link>ドライ ブに非常によく似ています.</para> + + <para>報告者: &a.joerg;</para> + </sect4> + + <sect4 id="hw-storage-tandberg4222"> + <title>Tandberg TDC 4222</title> + + <para>このドライブのブートメッセージの識別子は + <literal>TANDBERG TDC 4222 =07</literal> <literal>type 1 + removable SCSI 2</literal>です.</para> + + <para>これは QICテープドライブです.</para> + + <para>標準容量は2.5GBです. このドライブは 60M (DC600A) + 以上のすべての カートリッジを読むことができ, 150MB + (DC6150) 以上のすべてのカートリッジを 読み書きできます. + ハードウェア圧縮は 2.5GB カートリッジを使用した時の + オプションとしてサポートされています.</para> + + <para>このドライブには奇妙な癖がありますが, FreeBSD の + 2.2-current以降の SCSIテープデバイスドライバ (&man.st.4;) + には対応が組み込まれています. それ以前のバージョンの + FreeBSDでは<command>mt</command>を用いてテープから1ブロッ + ク読み, テープを巻戻してからバックアッププログラムを + 実行してください. (<command>mt fsr 1; mt rewind; dump + ...</command>).</para> + + <para>データ転送レートは 600kB/s + (データ圧縮時のベンダによる公称) で, start/stop モードでも + 350kB/s にはなります. 容量の小さいカー + トリッジを使った場合にはレートは下がります.</para> + + <para>報告者: &a.joerg;</para> + </sect4> + + <sect4 id="hw-storage-wangtek5525es"> + <title>Wangtek 5525ES</title> + + <para>このドライブのブートメッセージの識別子は + <literal>WANGTEK 5525ES SCSI REV7 3R1</literal> + <literal>type 1 removable SCSI 1</literal> + <literal>density code 0x11, 1024-byte + blocks</literal>です.</para> + + <para>これは QICテープドライブです.</para> + + <para>標準容量は 525MBです.</para> + + <para>データ転送レートは 180kB/sです.</para> + + <para>60, 120, 150, 525MB のテープを読むことができます. 60MB + (DC600カートリッジ) には書き込むことはできません. + 120および150テー プに確実に上書きするには, + 先にテープを消去 (<command>mt erase</command>) します. + 120および 150のテープは + 525MBのテープより幅の広いトラックを使用してい + ます(テープ当たりのトラック数は少なくなります). + トラックの幅の“外側”には上書きされませんので, + テープが消去されない限り 両側に古いデータが残ったまま + 新しいデータが置かれることになります.</para> + + <para>このドライブの奇妙な癖は知られていて, SCSI + テープドライバ (&man.st.4;) に組み込まれています.</para> + + <para>他のファームウェアのリビジョンで動くことが + 確認されているも のは M75Dです.</para> + + <para>報告者: Marc van Kempen + <email>marc@bowtie.nl</email> <literal>REV73R1</literal> + Andrew Gordon <email>Andrew.Gordon@net-tel.co.uk</email> + <literal>M75D</literal></para> + </sect4> + + <sect4 id="hw-storage-wangtek6200"> + <title>Wangtek 6200</title> + + <para>このドライブのブートメッセージの識別子は + <literal>WANGTEK 6200-HS 4B18</literal> <literal>type 1 + removable SCSI 2</literal> <literal>Sequential-Access + density code 0x13</literal>です.</para> + + <para>これは DDS-1テープドライブです.</para> + + <para>90mテープを使用した場合の標準容量は 2GBです.</para> + + <para>データ転送レートは 150kB/sです.</para> + + <para>報告者: Tony Kimball <email>alk@Think.COM</email></para> + </sect4> + </sect3> + + <sect3> + <title>* 問題のあるドライブ</title> + + <para></para> + </sect3> + </sect2> + + <sect2> + <title>CD-ROM ドライブ</title> + + <para><emphasis>原作: &a.obrien;.<!-- <br> --> + 23 November 1997.</emphasis></para> + + <para><link linkend="hw-jordans-picks-cdrom"> Jordan + 氏の選んだ組合せ</link> でふれられているように + <emphasis>FreeBSD プロジェクト</emphasis>では一般的には IDE + CDROM よりも SCSI CDROM の方が好まれています. しかし全ての + SCSI CDROM ドライブが同じであるというわけではありません. + いくつかの SCSI CDROM ドライブの品質は IDE CDROM + ドライブよりも 低いものであると感じている人もいます. + 東芝は信頼性が高いという評判が ありましたが, 12倍速の XM-5701A + は, SCSI メーリングリストでは ( オーディオ CDROM の再生で) + 何種類かのオーディオ再生ソフトウェアで + ボリュームのコントロールができない, という不満のメールを大量に + 見ることがありました.</para> + + <para>SCSI CDROM のメーカー間の競争のもう一つの局面は, <link + linkend="scsi-further-reading">SCSI + 規格</link>に対する忠実度です. 多くの SCSI CDROM は + ターゲットアドレス(ID)の <link + linkend="scsi-rogue-devices">マルチ LUN</link> に応答します. + 既知の規格違反デバイスにはティアックの6倍速ドライブ CD-56S + 1.0D があります.</para> + </sect2> + + <sect2> + <title>* その他</title> + + <para></para> + </sect2> + </sect1> + + <sect1 id="hw-other"> + <title>* その他</title> + + <sect2> + <title>* PCMCIA</title> + + <para></para> + </sect2> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/install/chapter.sgml b/ja_JP.eucJP/books/handbook/install/chapter.sgml new file mode 100644 index 0000000000..0bdfb1ff7f --- /dev/null +++ b/ja_JP.eucJP/books/handbook/install/chapter.sgml @@ -0,0 +1,1285 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.10 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:46:00 kuriyama Exp $ +--> + +<chapter id="install"> + <title>FreeBSDのインストール</title> + + <para><emphasis>原作: 不明</emphasis></para> + + <para><emphasis>訳: &a.jp.mita;, <!-- <br> -->&a.hanai;, <!-- <br> --> + &a.jp.iwasaki;. <!-- <br> -->26 January 1997.</emphasis></para> + + <para>それでは, FreeBSD のインストールに挑戦してみましょう. + この章には, あなたが何をする必要があるかの簡単なガイドが + 書いてあります. FreeBSD は, CD-ROM, フロッピーディスク, + 磁気テープ, MS-DOSのパーティション, + ネットワーク接続しているところでは anonymous FTP や NFS + を通じてインストールすることができます.</para> + + <para>どのインストールメディアを利用する場合も, まず後で説明するよう + な<emphasis>インストールディスク</emphasis>の作成から始めます. + すぐにイン + ストールするわけではない場合であってもこのディスクであなたのコ + ンピュータを立ち上げることで, FreeBSD とあなたのハードウェアと + の相性に関する重要な情報を手に入れることができ, このハードウェ + アではどんなインストールオプションが使えるかを指定することがで + きます. もしもあなたが anonymous FTP を使用してインストールす + る予定なら, + インストールフロッピーだけをダウンロードして作成するだけで OK です + - インストールプログラム自身がさらに必要なも のを (Ethernet + 接続やモデムによるダイアルアップなどを用いて) + 直接ダウンロードしてくれます.</para> + <!-- kuriyama - mdash? --> + + <para>FreeBSDの配布に関する情報は, 付録の <link + linkend="mirrors">FreeBSD の入手方法</link> + をご覧ください.</para> + + <para>仕事にとりかかるには, 以下のような手順を踏みます. </para> + + <procedure> + <step> + <para>このインストールガイドの <link + linkend="install-hw">サポートされている設定一覧</link> + の節を読んで, あなたのハードウェアが FreeBSD + でサポートされていることを確認します. SCSI コントローラだとか, + イーサネットアダプタだとか, サウンドカードだとかの, + あなたのマシンが + 装備している特別なカードのリストを作っておくと便利です. この + リストには, 割り込み番号 (IRQ) とか, IO + ポートのアドレスとかの, カードに + 関係する設定も書いておきましょう.</para> + </step> + + <step> + <para>FreeBSD を CDROM メディアからインストールする場合, いく + つかの異なる選択肢があります.</para> + + <itemizedlist> + <listitem> + <para>もし CD のマスターが El Torrito ブートサポートで焼か + れており, あなたのシステムが CDROM + からのブートをサポートして いるなら(多くの古いシステムは + <emphasis>サポートしていません</emphasis>), + 単にドライブに CD を入れてブートするだけです.</para> + </listitem> + + <listitem> + <para>もしDOS を動かしていて CD へアクセスするための適切な + ドライバを持っているならば, CD に入っている install.bat + スクリ プトを起動します. これは, DOS から直接 FreeBSD + のインストール へと進みます.</para> + + <note> + <para>これは本当の DOS から行なわなければいけま せん. + Windows の DOS プロンプトからでは駄目です.</para> + </note> + + <para>また, DOS パーティションから FreeBSD + をインストールしたい場合 (恐らく, CDROM ドライブが + FreeBSD で全くサポートされていない場合でしょ う), setup + プログラムを起動します. setup プログラムは, まず CD + から適切なファイルを DOS パーティションにコピーし, + インストー ルへと進みます.</para> + </listitem> + + <listitem> + <para>上記二つのうちのどちらかがうまくいったなら, この節の + 残りは必要ありません. そうでないならば, 最後の選択肢は + <filename>floppies\boot.flp</filename> + イメージからブートフロッピーを作る + ことです—そのやり方の説明はステップ 4 + へ進みます.</para> + </listitem> + </itemizedlist> + </step> + + <step> + <para>もし CDROM を持っていないなら, <ulink + URL="ftp://ftp.freebsd.org/pub/FreeBSD/&rel.current;-RELEASE/floppies/boot.flp"> ブートディスクのイメージ </ulink> ファイルをあなたの ハードディスクにダウンロードしてきます.</para> + + <note> + <para>ブラウザのコマンドでは, <emphasis>display</emphasis> + ではなくて <emphasis>save</emphasis> + を選ぶことに注意してください.</para> + </note> + + <!-- kuriyama - use warning --> + <para><emphasis remap=bf>注意:</emphasis> + このディスクイメージは, 1.44 メガバイトの 3.5 + インチフロッピーディスクのみで使用可能です.</para> + </step> + + <step> + <para>このイメージファイルからブートディスクを作成します, + </para> + + <itemizedlist> + <listitem> + <para>MS-DOSを使っている場合: <ulink + URL="ftp://ftp.FreeBSD.ORG/pub/FreeBSD/tools/fdimage.exe"> + fdimage.exe </ulink> をダウンロードするか, CDROM から + <filename>tools\fdiomage.exe</filename> を取り, + これを実行します. </para> + + <screen><prompt>E:\></prompt> <userinput>tools\fdimage floppies\boot.flp a:</userinput></screen> + + <para>このプログラムは, <devicename>A:</devicename> + ドライブをフォーマットした後 <filename>boot.flp</filename> + の内容を書き込みます (ここでは通常の通り, FreeBSD + の配布物のトップレベルディレクトリにおり, + フロッピーイメージ は floppies + ディレクトリにあると仮定しています).</para> + </listitem> + + <listitem> + <para>UNIX システムを使っている場合:</para> + + <screen>&prompt.root; <userinput>dd if=boot.flp of=<replaceable>disk_device</replaceable></userinput></screen> + + <para>を実行します. ここで, + <replaceable>disk_device</replaceable> + はフロッピードライブに 対応する + <filename>/dev</filename>の中のエントリです. FreeBSD では, + <filename>/dev/rfd0</filename> が + <devicename>A:</devicename>ドライブに, + <filename>/dev/rfd1</filename> が + <devicename>B:</devicename>ドライブに + 対応しています.</para> + </listitem> + </itemizedlist> + </step> + + <step> + <para>インストールディスクを A:ドライブに入れて, コンピュータを + 立ち上げ直します. + そうすると次のようなプロンプトが出てくるはずです. </para> + + <screen> +>> FreeBSD BOOT ... +Usage: [[[0:][wd](0,a)]/kernel][-abcCdhrsv] +Use 1:sd(0,a)kernel to boot sd0 if it is BIOS drive 1 +Use ? for file list or press Enter for defaults +Boot: + </screen> + + <para>ここで何もタイプしない場合, 5秒間の待ち時間の後に FreeBSD + は 自動的にデフォルトの設定で立ち上がります. 立ち上げの際, + どんな ハードウェアが装備されているかを検出 (プローブ) します. + この結果は スクリーン上に表示されます.</para> + </step> + + <step> + <para>立ち上げプロセスが終了したら, FreeBSD + インストールメニューが 表示されます.</para> + </step> + </procedure> + + <para><emphasis>もしも問題が起こった場合</emphasis></para> + + <para>PC アーキテクチャの制限のため, + 100パーセントの信頼をもって検出する ことは不可能です. + もしもあなたのハードウェアが間違って認識されたり, + 検出途中でコンピュータが固まってしまうようなことが起こった場合, + まずこのガイドの <link + linkend="install-hw">サポートされている設定一覧</link> + の節を読んで, あなたのハードウェアが本当に FreeBSD + でサポートされているかどうかを確かめてください.</para> + + <para>ハードウェアがサポートされていた場合, リセットして + <prompt>Boot:</prompt> プロンプトが出てきたところで, + <literal>-c</literal> と打ち込んで ください. こうすると, FreeBSD + はコンフィグレーションモードになり, ハードウェアに関する情報を + FreeBSD に与えることができるようになります. インストールディスクの + FreeBSD カーネルは, 多くのデバイスの IRQ, IO + アドレスが工場出荷時の値に設定されているものと + 仮定して作られています. + もしもあなたのハードウェアの設定を変更したなら, <command> + -c</command> オプションで立ち上げて, + 設定がどうなっているかを指定してあげること + が必要になるでしょう.</para> + + <para>存在しないデバイスを検出すると, + 実際に存在している他のデバイスの 検出に失敗することが考えられます. + そのような場合は, 衝突している + デバイスを無効にしなくてはなりません. スクリーンデバイス + (<devicename>sc0</devicename>) + などインストールに必要なデバイスを無効にしてはいけません.</para> + + <para>コンフィグレーションモードでは, + + <itemizedlist> + <listitem> + <para>カーネルに組み込まれているデバイスドライバの + 一覧を表示する</para> + </listitem> + + <listitem> + <para>あなたのシステムにないハードウェアのデバイスドライバを + 無効にする</para> + </listitem> + + <listitem> + <para>デバイスドライバの IRQ, DRQ, IO + ポートアドレスなどの変更する</para> + </listitem> + </itemizedlist> + + などができます.</para> + + <para><prompt>config></prompt> プロンプトが出ているところで, + <command>help</command> と打ち込むと, + 使用可能なコマンドについての詳しい説明が出てきます. + あなたのマシンのハードウェア設定に合うようにカーネルを変更したら, + <prompt>config></prompt> プロンプトが出たところで + <command>quit</command> と打ち込んで, + 新しい設定でマシンを立ち上げます.</para> + + <para>FreeBSD のインストールがひとたび終了した後は, + コンフィグレーションモード での変更はずっと保持されますので, + 立ち上げのたびに設定変更をする必要は なくなりますが, + あなたのシステムの性能を高めるために, + カスタムカーネルを作るのが好ましいでしょう. + カスタムカーネルの作成に関しては, <link + linkend="kernelconfig">FreeBSD + カーネルのコンフィグレーション</link> の章をご覧ください.</para> + + <sect1 id="install-hw"> + <title>サポートされている設定一覧</title> + + <para>現在 FreeBSD は, ISA, VL, EISA, PCI バスや, 386SX から + Pentium クラス までのさまざまな種類の PC で動作します + (386SXはおすすめではありません). IDE, ESDIドライブや, + さまざまな SCSI コントローラ, ネットワークカードや + シリアルカードにも対応しています.</para> + + <para>FreeBSD を走らせるには, 最低 4メガバイトの RAM が必要です. X + Window System を 走らせるには最低でも 8メガバイトの RAM + が推奨されます.</para> + + <para>以下のリストでは, FreeBSD + で動作が確認されているディスクコントローラ + やイーサネットカードです. 他の設定でもうまく動いてくれると + 思いますが, 私たちのところには情報は入ってきていません.</para> + + <sect2> + <title>ディスクコントローラ</title> + + <itemizedlist> + <listitem> + <para>WD1003 (あらゆる MFM/RLL)</para> + </listitem> + + <listitem> + <para>WD1007 (あらゆる IDE/ESDI)</para> + </listitem> + + <listitem> + <para>IDE</para> + </listitem> + + <listitem> + <para>ATA</para> + </listitem> + + <listitem> + <para>Adaptec 1505 ISA SCSI コントローラ</para> + </listitem> + + <listitem> + <para>Adaptec 152x シリーズ ISA SCSI コントローラ</para> + </listitem> + + <listitem> + <para>Adaptec 1535 ISA SCSI コントローラ</para> + </listitem> + + <listitem> + <para>Adaptec 154x シリーズ ISA SCSI コントローラ</para> + </listitem> + + <listitem> + <para>Adaptec 174x シリーズ EISA SCSI コントローラ + (スタンダード, エンハンスドモード)</para> + </listitem> + + <listitem> + <para>Adaptec 274x/284x/2940/2940U/3940 + (Narrow/Wide/Twin) + シリーズ EISA/VLB/PCI SCSI コントローラ</para> + </listitem> + + <listitem> + <para>Adaptec AIC7850 オンボード SCSI コントローラ</para> + </listitem> + + <listitem> + <para>Adaptec AIC-6360系のボード + AHA-152x や SoundBlaster SCSI などがこれにあたります.</para> + + <note> + <para>Soundblaster カードには, オンボード BIOS + が載っていないので, このカードからは FreeBSD + を起動できません. オンボード BIOS とは, システム BIOS + の I/O ベクタにブートデバイスを + 登録するときに必要なものです. + このカードは外部テープであるとか, CD-ROM + であるとかその他の場合には十分利用可能です. 同じことは, + ブート ROM の載っていない AIC-6x60 + 系のカードにもいえます. + いくつかのシステムでは実際にブート ROM を持っています. + それは電源を入れるかリセットしたとき, + 最初に表示されます. + 詳しくはあなたのシステムやボードの解説書をご覧ください. + </para> + </note> + </listitem> + + <listitem> + <para>Buslogic 545S & 545c</para> + + <note> + <para>Buslogic 社は古くは “ Bustek ” + 社といっていました.</para> + </note> + </listitem> + + <listitem> + <para>Buslogic 445S/445c VLバス SCSI コントローラ</para> + </listitem> + + <listitem> + <para>Buslogic 742A, 747S, 747c EISA SCSI コントローラ.</para> + </listitem> + + <listitem> + <para>Buslogic 946c PCI SCSI コントローラ</para> + </listitem> + + <listitem> + <para>Buslogic 956c PCI SCSI コントローラ</para> + </listitem> + + <listitem> + <para>NCR 53C810 , 53C825 PCI SCSI コントローラ.</para> + </listitem> + + <listitem> + <para>NCR5380/NCR53400 (“ProAudio Spectrum”) + SCSI コントローラ.</para> + </listitem> + + <listitem> + <para>DTC 3290 EISA SCSI コントローラ (1542 + エミュレーション)</para> + </listitem> + + <listitem> + <para>UltraStor 14F, 24F, 34F SCSI コントローラ.</para> + </listitem> + + <listitem> + <para>Seagate ST01/02 SCSI コントローラ.</para> + </listitem> + + <listitem> + <para>Future Domain 8xx/950 シリーズ SCSI コントローラ.</para> + </listitem> + + <listitem> + <para>WD7000 SCSI コントローラ.</para> + </listitem> + </itemizedlist> + + <para>サポートされている SCSI コントローラのすべてで, ディスク, + テープドライブ (含む DAT), CD-ROM + ドライブなどの周辺機器との通信に SCSI-I, SCSI-II + が利用可能です.</para> + + <para>現在, 次にあげるタイプの CD-ROM + ドライブがサポートされてます. </para> + + <itemizedlist> + <listitem> + <para>Soundblaster SCSI , ProAudio Spectrum SCSI + (<literal>cd</literal>)</para> + </listitem> + + <listitem> + <para>ミツミ (全モデル) 独自のインタフェース + (<literal>mcd</literal>)</para> + </listitem> + + <listitem> + <para>松下 / Panasonic (Creative) + CR-562/CR-563 インタフェース (<literal>matcd</literal>)</para> + </listitem> + + <listitem> + <para>ソニー インタフェース (<literal>scd</literal>)</para> + </listitem> + + <listitem> + <para>ATAPI IDE インタフェース + (まだまだお試し段階で, クオリティは低いです) + (<literal>wcd</literal>)</para> + </listitem> + </itemizedlist> + </sect2> + + <sect2 id="install-nics"> + <title>イーサネットカード</title> + + <itemizedlist> + <listitem> + <para>Allied-Telesis AT1700, RE2000 カード</para> + </listitem> + + <listitem> + <para>SMC Elite 16 WD8013 Ethernet インタフェース, + その他多くの WD8003E, WD8003EBT, WD8003W, WD8013W, + WD8003S, WD8003SBT や WD8013EBTなどの互換品. SMC Elite + Ultra 及び 9432TX + ベースのカードもサポートされています.</para> + </listitem> + + <listitem> + <para>DEC EtherWORKS III ネットワークインタフェースカード + (DE203, DE204, DE205)</para> + </listitem> + + <listitem> + <para>DEC EtherWORKS II ネットワークインタフェースカード + (DE200, DE201, DE202, DE422)</para> + </listitem> + + <listitem> + <para>DEC DC21040/DC21041/DC21140 + ベースのネットワークインタフェースカード:</para> + + <itemizedlist> + <listitem> + <para>ASUS PCI-L101-TB</para> + </listitem> + + <listitem> + <para>Accton ENI1203</para> + </listitem> + + <listitem> + <para>Cogent EM960PCI</para> + </listitem> + + <listitem> + <para>Compex CPXPCI/32C</para> + </listitem> + + <listitem> + <para>D-Link DE-530</para> + </listitem> + + <listitem> + <para>DEC DE435</para> + </listitem> + + <listitem> + <para>Danpex EN-9400P3</para> + </listitem> + + <listitem> + <para>JCIS Condor JC1260</para> + </listitem> + + <listitem> + <para>Kingston KNE100TX</para> + </listitem> + + <listitem> + <para>Linksys EtherPCI</para> + </listitem> + + <listitem> + <para>Mylex LNP101</para> + </listitem> + + <listitem> + <para>SMC EtherPower 10/100 (Model 9332)</para> + </listitem> + + <listitem> + <para>SMC EtherPower (Model 8432)</para> + </listitem> + + <listitem> + <para>SMC EtherPower (2)</para> + </listitem> + + <listitem> + <para>Zynx ZX314</para> + </listitem> + + <listitem> + <para>Zynx ZX342</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>DEC FDDI (DEFPA/DEFEA) + ネットワークインタフェースカード</para> + </listitem> + + <listitem> + <para>富士通 FMV-181, FMV-182</para> + </listitem> + + <listitem> + <para>富士通 MB86960A/MB86965A</para> + </listitem> + + <listitem> + <para>Intel EtherExpress</para> + </listitem> + + <listitem> + <para>Intel EtherExpress Pro/100B 100Mbit.</para> + </listitem> + + <listitem> + <para>Isolan AT 4141-0 (16 bit)</para> + </listitem> + + <listitem> + <para>Isolink 4110 (8 bit)</para> + </listitem> + + <listitem> + <para>Lucent WaveLAN + ワイアレスネットワークインターフェイス</para> + </listitem> + + <listitem> + <para>Novell NE1000, NE2000, NE2100 + イーサネットインタフェース</para> + </listitem> + + <listitem> + <para>3Com 3C501 カード</para> + </listitem> + + <listitem> + <para>3Com 3C503 Etherlink II</para> + </listitem> + + <listitem> + <para>3Com 3c505 Etherlink/+</para> + </listitem> + + <listitem> + <para>3Com 3C507 Etherlink 16/TP</para> + </listitem> + + <listitem> + <para>3Com 3C509, 3C579, 3C589 (PCMCIA) Etherlink III</para> + </listitem> + + <listitem> + <para>3Com 3C590, 3C595 Etherlink III</para> + </listitem> + + <listitem> + <para>3Com 3C90x カード</para> + </listitem> + + <listitem> + <para>HP PC Lan Plus (27247B と 27252A)</para> + </listitem> + + <listitem> + <para>東芝 イーサネットカード</para> + </listitem> + + <listitem> + <para>IBM , National Semiconductor社 PCMCIA + イーサネットカードもサポートされています.</para> + </listitem> + </itemizedlist> + + <note> + <para>FreeBSD は今のところ, いくつかのイーサネットカードの PnP + (プラグ&プレイ) 機能には対応していません. もし PnP + で問題が起こる ようでしたら, PnP + 機能を無効にしてください.</para> + </note> + </sect2> + + <sect2 id="install-misc"> + <title>その他のデバイス</title> + + <itemizedlist> + <listitem> + <para>AST 4 ポート シリアルカード (シェアード IRQ 使用)</para> + </listitem> + + <listitem> + <para>ARNET 8 ポート シリアルカード (シェアード IRQ 使用)</para> + </listitem> + + <listitem> + <para>BOCA IOAT66 6 ポート シリアルカード (シェアード IRQ + 使用)</para> + </listitem> + + <listitem> + <para>BOCA 2016 16 ポート シリアルカード (シェアード IRQ + 使用)</para> + </listitem> + + <listitem> + <para>Cyclades Cyclom-y シリアルボード</para> + </listitem> + + <listitem> + <para>STB 4 ポート カード (シェアード IRQ 使用)</para> + </listitem> + + <listitem> + <para>SDL Communications Riscom/8 シリアルボード</para> + </listitem> + + <listitem> + <para>SDL Communications RISCom/N2 と N2pci + 同期シリアルカード</para> + </listitem> + + <listitem> + <para>Digiboard Sync/570i high-speed 同期シリアルカード</para> + </listitem> + + <listitem> + <para>Decision-Computer Intl. “Eight-Serial” 8 + ポートシリアルカード (シェアード IRQ 使用)</para> + </listitem> + + <listitem> + <para>Adlib, SoundBlaster, SoundBlaster Pro, + ProAudioSpectrum, Gravis UltraSound, Gravis UltraSound MAX + Roland MPU-401 などのサウンドカード</para> + </listitem> + + <listitem> + <para>Matrox Meteor video フレームグラバー</para> + </listitem> + + <listitem> + <para>Creative Labs Video spigot フレームグラバー</para> + </listitem> + + <listitem> + <para>Omnimedia Talisman フレームグラバー</para> + </listitem> + + <listitem> + <para>Brooktree BT848 チップベースのフレームグラバー</para> + </listitem> + + <listitem> + <para>X-10 power コントローラ</para> + </listitem> + + <listitem> + <para>PC ジョイスティックおよびスピーカ</para> + </listitem> + </itemizedlist> + + <para>FreeBSD は今のところ, + IBM社のマイクロチャネルアーキテクチャ (MCA) バスには + 対応していません.</para> + </sect2> + </sect1> + + <sect1> + <title>インストールの下準備</title> + + <para>FreeBSD のインストール方法はさまざまあります. それぞれの + インストール方法に対して, + どのような下準備が必要かをこれから説明します.</para> + + <sect2> + <title>CD-ROM からインストールする前に</title> + + <para>あなたの CD-ROM + ドライブがサポートされていないタイプの場合は, <link + linkend="install-msdos">ハードディスクの MS-DOS + パーティションからインストールする前に</link> + に飛んでください. Walnut Creek の FreeBSD CD-ROM + からインストールする場合は, 大した下準備 + をしないでもうまくインストールできることでしょう (その他の + CD-ROM でもうまくいくでしょうが, その CD-ROM + がどうやって作られているか, 私たち + はわかりませんので確実なことは言えません). Walnut Creek の + CD-ROM に収録されている, <filename>install.bat</filename> + で直接 FreeBSD を立ち上げることもできますし, + <filename>makeflp.bat</filename> でブートフロッピーディスクを + つくることもできます.</para> + + <note> + <para>もし FreeBSD 2.1-RELEASE を使っていて IDE CD-ROM + ドライブを持っている場合, install.bat のかわりに + <filename>inst_ide.bat</filename> もしくは + <filename>atapiflp.bat</filename> を使ってください. ]</para> + </note> + + <para>DOS から最も楽なインタフェースを使いたい場合は + <command>view</command> と打ち込みます. そうすると DOS + でのメニューが立ち上がって, 可能なオプション + すべてを選択できます.</para> + + <para>あなたが UNIX + マシンでブートフロッピーディスクを作成している場合は, <link + linkend="install">FreeBSD のインストール</link> + を参考にしてください.</para> + + <para>DOS から, もしくはフロッピーディスクから起動をおこなうと, + メニュー ``Media'' から, インストールメディアとして CDROM を + 選択することで, + 配布ファイルをロードすることができるようになります. + 他の種類のインストールメディアは不要なはずです.</para> + <!-- kuriyama - ldquo;? --> + + <para>CD-ROM を取り出す前には <command>umount /cdrom</command> + と打ち込まなくてはならない ことを覚えておいてください. + 単純にドライブから取り出さないように!</para> + + <note> + <para>インストールに入る前に, CD-ROM + をドライブに入れておいて, + インストールフロッピーディスクが立ち上がる ときに CD-ROM + を見つけられるようにしておくようにしましょう. CD-ROM を + デフォルトでシステムにつけ加えたい場合も CD-ROM + を入れておきます (インストールメディアとして実際に CDROM + を選択しない場合も同様).</para> + </note> + + <para>おわりに, あなたのマシンの CD-ROM を直接使って, FTP + 経由で別のマシンに FreeBSD をインストールさせたいとします. + やり方は簡単です. あなたのマシンのインストールが終了した後に, + vipw コマンドを使って, passwd + ファイルに以下の行を追加します.</para> + <!-- kuriyama - filename passwd --> + + <programlisting> +ftp:*:99:99::0:0:FTP:/cdrom:/nonexistent</programlisting> + + <para>こうするとあなたのマシンにネットワーク接続できる人 + (そして, login 許可を持っている人) は, メディアタイプとして + FTP を選択できるように なります. 具体的には, FTP + サイトの選択メニューから “Other” を選択して, + <userinput>ftp://<replaceable> あなたのマシンのアドレス + </replaceable></userinput> を入力します.</para> + </sect2> + + <sect2> + <title>フロッピーディスクからのインストールの前に</title> + + <para>あなたがフロッピーディスクからのインストールをしなくては + ならない場合, + その理由はハードウェアがサポートされてなかったためか, + 単にいばらの道を通ることを楽しんでいるからでしょうが, + インストール用の + フロッピーディスクを用意する必要があります.</para> + + <para>最低でも bin (基本配布ファイル) + ディレクトリ内のすべてのファイル を入れられるだけの 1.44 + メガバイトか 1.2 メガバイトのフロッピーディスク が必要です. + これらのフロッピーディスクを DOS で作成している場合は, + フロッピーディスクは「MS-DOS の FORMAT + コマンドでフォーマット」 されなくてはなりません. Windows + をお使いの場合は, Windowsの + ファイルマネージャの初期化コマンドを使用してください.</para> + + <para>工場での初期化済みディスクを「信用しないでください」. + 念のためにあなた 自身でフォーマットし直してください. + ユーザからのトラブル報告の多くは + ちゃんと初期化されていないディスクを + 使用していたことが原因となっています. + 私が特にフォーマットし直してくださいと述べているのも, + この理由からです.</para> + + <para>他の FreeBSD マシンでフロッピーディスクを作成している場合, + フォーマットすることは悪いことではありません. いちいち DOS + ファイルシステムのフロッピーディスクを作成する必要は + ありませんので, <command>disklabel</command> コマンドと + <command>newfs</command> コマンドを使って, 次のような手順で + (3.5 インチ 1.44 メガバイトディスク用の) UFS + ファイルシステムを 作成することもできます.</para> + + <screen>&prompt.root; <userinput>fdformat -f 1440 fd0.1440</userinput> +&prompt.root; <userinput>disklabel -w -r fd0.1440 floppy3</userinput> +&prompt.root; <userinput>newfs -t 2 -u 18 -l 1 -i 65536 /dev/rfd0</userinput> + </screen> + + <note> + <para>5.25 インチの 1.2 メガバイトディスクの場合は "fd0.1200" + と "floppy5" にしてください</para> + </note> + + <para>これで他のファイルシステムと同様に mount + して書き込むことができます.</para> + + <para>フォーマットされたフロッピーディスクを用意したら, + それらにファイル をコピーしなくてはなりません. + 配布ファイルはいくつかのかたまり にわかれていて, + これらのかたまり五つで一般的な 1.44 メガバイトの + フロッピーディスクに収まるようになっています. + フロッピーディスクに 入るだけファイルを入れていって, + 配布ファイルをすべてコピーしてください. + それぞれの配布ファイルはサブディレクトリに + コピーする必要があります. 例えば, + <filename>a:\bin\bin.aa</filename>とか, + <filename>a:\bin\bin.ab</filename>といった感じです.</para> + + <para>インストールメディアの選択場面になったら, + “Floppy” を選択して, + 残りの指定をやってください.</para> + </sect2> + + <sect2 id="install-msdos"> + <title>ハードディスクの MS-DOS + パーティションからインストールする前に</title> + + <para>ハードディスクの MS-DOS + パーティションからインストールするときは, まずファイルを + <filename>C:\FREEBSD</filename> にコピーします. CD-ROM + にあるディレクトリ構造を反映してコピーしなくてはなりません. + DOS の <command>xcopy</command> + コマンドの使用をおすすめします.</para> + + <para>例えば, FreeBSD の最低限のインストールをするには, + このような手順で コピーします. </para> + + <screen><prompt>C:\></prompt> <userinput>MD C:\FREEBSD</userinput> +<prompt>C></prompt> <userinput>XCOPY /S E:\BIN C:\FREEBSD\BIN\</userinput> +<prompt>C></prompt> <userinput>XCOPY /S E:\MANPAGES C:\FREEBSD\MANPAGES\</userinput></screen> + + <para>ここで, <devicename>C:</devicename> + ドライブには十分なディスクスペースが残っており, CD-ROM は + <devicename> E:</devicename> + ドライブに接続されているものとします.</para> + + <para>MS-DOS からたくさんの <abbrev>配布ファイル + (DISTS)</abbrev> をインストールしたい + (そしてディスクの余裕がある) 場合は, それぞれ + <filename>C:\FREEBSD</filename> ディレクトリにコピーします + — <abbrev>BIN</abbrev> 配布ファイルは, + 最低限必要なものです.</para> + </sect2> + + <sect2> + <title>QIC/SCSI テープからのインストールの前に</title> + + <para>テープからのインストールは, おそらく FTP + を利用したオンライン インストールか, CD-ROM + を利用したインストールができない場合の, + もっとも簡単な方法でしょう. インストールプログラムは, + 以下のような コマンドを使用して, + 単純に配布ファイルがテープ上に tar されていることを + 期待しています.</para> + + <screen>&prompt.root; <userinput>cd /freebsd/distdir</userinput> +&prompt.root; <userinput>tar cvf /dev/rwt0 (または /dev/rst0) dist1 .. dist2</userinput></screen> + + <para>インストールに入る前に, テンポラリ (一時使用) + ディレクトリに 十分なディスクスペースを確保して, + 作成したテープの<emphasis>すべての</emphasis> + ファイルを格納できることを確認してください + (テンポラリディレクトリは 自分で選ぶことができます). + テープの特性上, ランダムにアクセスするこ とができませんので, + 一時的に極めて大量の容量を必要とします. + テープに準備しただけの量のディスクスペースを + 一時的に使用することに 留意してください.</para> + + <note> + <para>インストールに入るときは, ブートフロッピーディスク + から立ち上げる <emphasis remap=bf>前</emphasis> + にテープをドライブに入れておかなくてはなりません. + さもないとインストール時のデバイス検出のときにテープを + 見つけられません.</para> + </note> + </sect2> + + <sect2> + <title>ネットワーク経由のインストールの前に</title> + + <para>三つの物理的な接続形態で, ネットワーク経由のインストールを + おこなうことができます. </para> + + <variablelist> + <varlistentry><term>シリアルポート</term> + <listitem> + <para>SLIP もしくは PPP 方式.</para> + </listitem> + </varlistentry> + + <varlistentry><term>パラレルポート</term> + <listitem> + <para>PLIP (laplink ケーブル使用)</para> + </listitem> + </varlistentry> + + <varlistentry><term>イーサネット</term> + <listitem> + <para>標準的なイーサネットコントローラ + (いくつかの PCMCIA カードにも対応)</para> + </listitem> + </varlistentry> + </variablelist> + + <para>SLIP のサポートはまだまだ原始的とも呼べる方法なので, + ラップトップと + 他のコンピュータをシリアルケーブルで接続するといった具合いに, + 直接接続してなくてはいけません. SLIP インストールは, + ダイヤル機能を 持っていませんので, + インストールするためには直接接続しなくてはなりません. PPP + インストールではダイヤルアップ接続が可能ですので, できれば PPP + 接続の 方を選択しましょう.</para> + + <para>もしもあなたがモデムを使用しているなら, + あなたに残された選択肢は ほぼ間違いなく PPP + インストールでしょう. インストール時に必要になりますので, + サービスプロバイダ (ISP) に関する情報を用意しておきましょう. + PPP ダイヤルの際は, + とてもシンプルな端末エミュレーターで作業する + ことになりますので, お手持ちのモデムで ISP にダイヤルするため + の“ATコマンド”の使い方を知っておく必要があります. + もし PAP や CHAP を用いるなら, + <command>term</command>を入力する前に<command>set + authname</command>や <command>set authkey</command> + といったコマンドを入力する必要があるでしょう. + これ以上の情報については, <link + linkend="userppp">handbook</link> や <ulink + URL="../FAQ/userppp.html">FAQ</ulink> のユーザー PPP + エントリーを参照して下さい. 問題が起きた場合には, <command>set + log local ...</command> + コマンドを用いてログを画面に吐くこともできます.</para> + + <para>FreeBSD (2.0R 以降) + の動いている別のマシンと直接接続が可能でしたら, + “laplink” + パラレルポートケーブルで接続することを考えてみましょう. + パラレルポート経由のデータ転送スピードは, シリアルラインでの + 一般的なスピード (最高 50kbit/sec) よりもずっと高速ですので, + 高速にインストールすることができます.</para> + + <para>最後になりますが, + ネットワークインストールのうちでもっとも高速なものとしては + イーサネットアダプタを使用するのがあげられます. FreeBSD + ではきわめて多くの PC イーサネットカードをサポートしています. + サポートされている カードの表 (と, 必要な設定) は, <link + linkend="install-hw">サポートされている設定一覧</link> + に書いてあります. サポートされている PCMCIA + カードを使っている場合には, ラップトップの電源を + 入れる「前」に差し込んでおくことにも注意してください. + 残念ながら今の FreeBSD は, + インストール時の活線挿抜には対応していません.</para> + + <para>ネットワークでの IP アドレス, + あなたのアドレスクラスに対応した ネットマスク, + マシン名を知っておくことも必要です. ネットワーク管理者の方に + たずねればどんな値を使ったらよいかを教えてくれるでしょう. + もしも他のホストを IP アドレスではなくて名前で引きたい場合, + ネームサーバとゲートウェイ のアドレスも知らなくてはなりません + (PPP をご使用の場合は, プロバイダの IP アドレスになります). + これらのうちのすべて, またはいくつかを 知らない場合は, + イーサネット経由でのインストールを始める前に「まず」 + ネットワーク管理者に相談してください.</para> + + <para>何らかのネットワーク接続ができたら, 続けてインストールを + NFS か FTP 経由でおこないます.</para> + + <sect3> + <title>NFS インストールのための下準備</title> + + <para>NFS インストールはまったく単純明解です. FreeBSD + の配布ファイルを サーバの好きな場所にコピーしておいて, + メディア選択で NFS を選択します.</para> + + <para>もしサーバが “privileged (特権) ポート” + へのアクセスのみをサポート している場合, (Sun + ワークステーションの標準ではこうなっています) + インストールを進める前に Options メニューを選択して, + ``privileged port'' オプションを選択してください.</para> + + <para>イーサネットカードの性能が悪くて, + 転送速度が遅くて困っている場合も, 適当な Options + を選択するとよいでしょう.</para> + + <para>NFS 経由でインストールするためには, サブディレクトリも + 含めたマウントにサーバが対応している必要があります. 例えば, + FreeBSD &rel.current; の配布ファイルが + <filename>ziggy:/usr/archive/stuff/FreeBSD</filename> + にあるとすると, マシン <hostid>ziggy</hostid> では + <filename>/usr</filename> や + <filename>/usr/archive/stuff</filename> だけではなく, + <filename>/usr/archive/stuff/FreeBSD</filename> + の直接マウントが可能に なっていなければなりません.</para> + + <para>FreeBSD の <filename>/etc/exports</filename> + ファイルでは, このことは <option>-alldirs</option> + オプションによって制御されています. 他の NFS + サーバの場合だとまた話が違ってくるかもしれません. + もしもサーバから <errortype>Permission Denied</errortype> + というメッセージが 返ってくるようでしたら, + サブディレクトリマウントをちゃんと + 有効にできていないことが考えられます.</para> + </sect3> + + <sect3> + <title>FTP インストールのための下準備</title> + + <para>FTP 経由のインストールは, FreeBSD &rel.current; + の最新バージョンを ミラーしているどのサイトからでも可能です. + 世界中の妥当な FTP サイトの + 選択肢をメニューに並べておきました.</para> + + <para>このメニューに出ていない他の FTP サイトからインストール + する場合や, ネームサーバの設定に問題が生じた場合は, + メニューでサイト “Other” を選ぶところで, + お好みの URL でサイトを指定することができます. URL + として直接 IP アドレスで指定してもよく, + 直接指定した場合はネームサーバ がなくても FTP + インストールが可能になります. 例えば, + + <screen><userinput>ftp://165.113.121.81/pub/FreeBSD/&rel.current;-RELEASE</userinput></screen> + + のような感じですね.</para> + + <para>FTP 経由のインストールモードとして, このようなものが + 使用可能です:</para> + + <variablelist> + <varlistentry><term>FTP Active</term> + <listitem> + <para>すべての FTP 転送の際に “Active” + モードを使用します. + ファイアウォール内部のマシンではうまく動きませんが, + passive モードをサポートしていない古い FTP サーバでも + 動作します. passive モードでの FTP 転送 (こちらが + デフォルトです) が失敗した場合は, active + を使ってください.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FTP Passive</term> + <listitem> + <para>すべての FTP 転送の際に “Passive” + モードを使用します. このモードを使用することで, + ランダムポートアクセスインを + 許さないファイアウォールを + 越えることができるようになります.</para> + </listitem> + </varlistentry> + </variablelist> + + <note> + <para>Active, passive モードは “proxy” + 接続と同じではありません! proxy FTP サーバは FTP 要求 + を受け付け実際の FTP サーバへ転送します.</para> + </note> + + <para>通常 proxy FTP サーバ に対しては, ユーザ名の一部として + @ 記号に続いて実際に接続したいサーバの名称を与える必要が + あります. そうすると proxy サーバは本当のサーバの「ふり」 + をするようになります. 例えば: <hostid + role="fqdn">ftp.freebsd.org</hostid> から ポート番号 1234 + で要求を待つ proxy FTP サーバ <hostid + role="fqdn">foo.bar.com</hostid> を使って + インストールしたいとします.</para> + + <para>この場合では, 「オプション」メニューで FTP username を + ftp@ftp.freebsd.org, + パスワードとして自分の電子メールアドレス を指定します. + インストールメディアとして FTP (または proxy + サーバがサポートしていれば passive FTP), URL + を以下のようにします: <literal> + ftp://foo.bar.com:1234/pub/FreeBSD </literal></para> + + <para><hostid role="fqdn">ftp.freebsd.org</hostid> の + <filename>/pub/FreeBSD</filename> に対する FTP + 要求については <hostid role="fqdn">foo.bar.com</hostid> + が代理で処理をおこなうことになり, + <emphasis>むこう</emphasis> + のマシンからインストールすることができます (インストール時 + の要求により <hostid role="fqdn">ftp.freebsd.org</hostid> + からファイルをもってきます).</para> + </sect3> + </sect2> + </sect1> + + <sect1> + <title>FreeBSD のインストール</title> + + <para>インストールの下準備を適切に書き留めておけば, なんの + 問題もなく FreeBSD のインストールができることと思います.</para> + + <para>何かうまくいかなかった場合は, あなたが使おうとしている + インストールメディアのことが書いてある箇所まで戻って + もう一度読むとよいでしょう. おそらく最初読んだときに + 見落していた, 有効なヒントがあるものと思います. + ハードウェアの問題が出てきたとか, FreeBSD がまったく + 立ち上がらない場合は, boot フロッピーディスクに提供されている + Hardware Guide を読んで, + 何か解決方法はないか探してください.</para> + + <para>FreeBSD のブートフロッピーディスクには, + インストールをおこなうために + 必要と思われるすべてのオンラインドキュメントを用意してあります. + もしもそのドキュメントがお望みのものでないようでしたら, + 私たちはあなたが何にもっとも困っているのかを知りたいと思います. + コメントを &a.doc; にお送りください. FreeBSD + のインストールプログラム (sysinstall) を, うっとうしい + “step-by-step” ガイドなしに, + プログラム自身で使用方法がわかるようにするのが最終目標です. + 目標達成までには時間がかかりそうですが, ともかくそれが + 目標なのであります.</para> + + <para>閑話休題. ここに, + “典型的なインストールの手順”を まとめてみましたので, + お役にたてるものと思います. </para> + + <orderedlist> + <listitem> + <para>ブートフロッピーディスクから起動します. + ハードウェアの性能に よりますが, 起動には 30秒から + 3分かかります. 起動したら 初期選択画面が出てくるでしょう, + もしもフロッピーディスクから まったく起動しなかったり, + どこかの段階で起動が止まってしまった 場合は, + ハードウェアガイドの Q&A を読んで, 理由を + 探ってみます.</para> + </listitem> + + <listitem> + <para>F1 キーを叩きます. + メニューシステムとインストールプログラム + 全般に対しての使い方が表示されます. このメニューシステムを + 使ったことがない場合は, + <emphasis>徹底的に</emphasis>読んでください.</para> + </listitem> + + <listitem> + <para>Options を選択し, 他に必要な特別な選択を + おこないます.</para> + </listitem> + + <listitem> + <para>典型的なインストールでおまかせしたい方は Novice を, + インストールのそれぞれの段階をいちいちコントロールしたい方は + Custom を, (可能であれば適切なデフォルトを使用して) + 簡単にさっさと済ませたい方は Express を, + それぞれ好みに応じて選んでください. FreeBSD + を初めて使う方には, Novice を一番におすすめします.</para> + </listitem> + + <listitem> + <para>final configuration メニューからは, メニュー形式のさらに + 進んだ設定をおこなうことができます. ネットワーク周りの + 設定は, 特に CD-ROM / テープ / フロッピーディスクから + インストールして, まだネットワーク設定をおこなっていない + 人にとっては特に重要でしょう. インストールの時点できちんと + 設定しておけば, ハードディスクからシステムを立ち上げ直した + 時点でネットワーク接続ができるようになっていることでしょう. + </para> + </listitem> + </orderedlist> + </sect1> + + <sect1> + <title>MS-DOS ユーザのためのQ&A</title> + + <para>多くのFreeBSD ユーザは, MS-DOS が入っている PC に FreeBSD を + インストールしたいと考えます. そのようなシステムに FreeBSD + をインストールする際によく聞かれる質問を集めて あります.</para> + + <para><emphasis>助けて! ディスクスペースが余ってないのです. + 最初に MS-DOS のファイルを全部削除しないといけませんか? + </emphasis></para> + + <para>もしあなたのマシンですでに MS-DOS が走っていて, FreeBSD の + インストール用の空きスペースが少ないか, まったくない場合でも + 大丈夫です. FreeBSD の CD-ROM や, FTP サイトの + <filename>tools</filename> ディレクトリに FIPS + プログラムというのがありますが, これが非常に役立ちます.</para> + + <para>FIPS を使えば, すでに存在している MS-DOS のパーティションを + 二つに分けることができ, さらにもともとのパーティションは + 残してくれて, 二つめのパーティションを FreeBSD の + インストールに使用することができるようになります. まず DOS6.xx + についてくる DEFRAG か, Norton Disk ツールを使って, MS-DOS + パーティションからフラグメント情報を取り去って, その後に FIPS + を走らせます. FIPS ユーティリティから必要な情報が 手に入ります. + その後マシンを立ち上げ直して, 空いた場所に FreeBSD + をインストールします. どのくらいの空きスペースが + インストールに必要かは, <emphasis>Distributions</emphasis> + メニューを 参考にしてください.</para> + + <para><emphasis>FreeBSD で MS-DOS の圧縮ファイルシステムにアクセス + できますか? </emphasis></para> + + <para>いいえ. もし Stacker(tm) や DoubleSpace(tm) のような + ユーティリティをお使いの場合, FreeBSD は非圧縮の部分にしか + アクセスできません. 残りの場所は一つの大きなファイルとして + (stack された, もしくは doublespace されたファイルとして) + 見えます. + <emphasis>そのファイルを削除しないでください!!</emphasis> + 削除してしまうと後できっと後悔します.</para> + + <para>非圧縮の MS-DOS の基本区画を作って, そちらを MS-DOS と + FreeBSD とのやり取りに使うのがよろしいでしょう.</para> + + <para><emphasis>MS-DOS + 拡張フォーマットをマウントできますか?</emphasis></para> + + <para>はい. DOS 拡張パーティションは FreeBSD + の他の“スライス”の最後に マップされます. 例えば + <devicename>D:</devicename>ドライブ が + <filename>/dev/sd0s5</filename>, + <devicename>E:</devicename>ドライブが + <filename>/dev/sd0s6</filename>, といった具合いです. もちろん, + この例では拡張 パーティションが SCSI ドライブ 0 + にあることを仮定しています. IDE ドライブでは当然, + <filename>sd</filename> が <filename>wd</filename> となります. + 他の DOS ドライブを マウントするのと同様に, + 次のようにして拡張パーティションもちゃんと + マウントできます:</para> + + <screen>&prompt.root; <userinput>mount -t msdos /dev/sd0s5 /dos_d</userinput></screen> + + <para><emphasis>MS-DOS のバイナリを FreeBSD + で実行できますか?</emphasis></para> + + <para>BSDI が BSD のコミュニティに対して寄贈した DOS + エミュレータが あり, これが FreeBSD 用に移植されています.</para> + + <para>またこれとは別に, <link linkend="ports">ports + コレクション</link> には, pcemu という (技術的に) + 素晴らしいアプリケーションがあり, これをつか うことで多くの + MS-DOS のテキストモードで動くプログ ラムを完全な 8088CPU + のエミュレーション環境で走らせることがで きます.</para> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/internals/chapter.sgml b/ja_JP.eucJP/books/handbook/internals/chapter.sgml new file mode 100644 index 0000000000..d510f32188 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/internals/chapter.sgml @@ -0,0 +1,2046 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.8 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:46:01 kuriyama Exp $ +--> + +<chapter id="internals"> + <title>FreeBSD の内部</title> + + <sect1 id="booting"> + <title>FreeBSDのブート処理の流れ</title> + + <para><emphasis>原作: &a.phk;. v1.1, April 26th.</emphasis></para> + + <para><emphasis>訳: &a.jp.nakai;. September 6 1996.</emphasis></para> + + <para>FreeBSDのブートには基本的に3つの段階があります: + カーネルの読み込み, ルートのファイルシステムの決定, そして + ユーザ領域にあるものの初期化です. このことは下に述べる + いくつかの興味深い可能性につながっています.</para> + + <sect2> + <title>カーネルの読み込み</title> + + <para>現在, カーネルの読み込みには基本的に下に挙げる3つの方法が + あります: + これらはカーネルが次に何をしたらいいのかという情報をカーネルに + 与えます.</para> + + <variablelist> + <varlistentry><term>Biosboot</term> + <listitem> + <para>Biosboot は “ブートブロック” + に相当するもので, 2つのファイル から構成されており, + フロッピーディスクやハードディスクのブートを + 開始する側の 8K + バイトにインストールされています.</para> + + <para>Biosboot は FreeBSD のファイルシステムからカーネルを + 読み込むことができます.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Dosboot</term> + <listitem> + <para>Dosbootは DI. Christian + Gusenbauerによって書かれましたが, + 不幸にしてこの場合には, コードのある一部分が + マイクロソフトの + コンパイラ向けに書かれているため, FreeBSD + 単体ではコンパイル することはできません.</para> + + <para>Dosboot は MS-DOS のファイルから, またはディスクの + FreeBSD ファイルシステムのパーティションから + カーネルをブートします. これは MS-DOS + システムのハイメモリ領域に潜んでいる + メモリマネージャ等の + さまざまな怪しい代物とメモリの取り合いをして, + なんとかブートしています.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Netboot</term> + <listitem> + <para>Netboot + はサポートされているイーサネットカードを検出し, BOOTP + や TFTP, NFS + を使ってブートするカーネルを探そうとします.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + <sect2> + <title>ルートファイルシステムの決定</title> + + <para>カーネルが読み込まれ, + ブートプログラムがカーネルに移行したら, + カーネルは自身の初期化をし, + どんなハードウェアが組み込まれいるか を決定し, + それからルートファイルシステムを探さなくてはなりません.</para> + + <para>現在サポートされているルートファイルシステムは + 次の通りです :</para> + + <variablelist> + <varlistentry><term>UFS</term> + <listitem> + <para>UFS は, もっとも一般的なタイプのルートシステムです. + フロッピーディスクやハードディスク上に存在します.</para> + </listitem> + </varlistentry> + + <varlistentry><term>MSDOS</term> + <listitem> + <para>技術的に可能ですが, あまり有用ではありません. + なぜならば, <acronym>FAT</acronym> + ファイルシステムではリンクやデバイスノードなどの + “UNIX 主義” を実現できないからです.</para> + </listitem> + </varlistentry> + + <varlistentry><term>MFS</term> + <listitem> + <para>MFS はカーネル内部に組み込みになっている UFS + ファイルシステムです. つまり MFS を機能させるのに + ディスクやフロッピーディスクなどのハードウェアは + 必要ではありません.</para> + </listitem> + </varlistentry> + + <varlistentry><term>CD9660</term> + <listitem> + <para>CD9660 は CD-ROM + をルートファイルシステムに使用したものです.</para> + </listitem> + </varlistentry> + + <varlistentry><term>NFS</term> + <listitem> + <para>これはルートシステムにファイルサーバを使用していて, + 基本的に ディスクレスのマシンのためにあります.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + <sect2> + <title>ユーザ領域にあるものの初期化</title> + + <para>ユーザ領域で動作させるようにするために, + カーネルが初期化を終えると, カーネルは <literal>pid == + 1</literal>のプロセスを生成し, ルートファイルシステム + 上のプログラムを実行します. このプログラムは通常 + <command>/sbin/init</command> です.</para> + + <para><filename>/sbin/init</filename> + を別なプログラム置き換えてしまうことは可能ですが, そのプロセス + には以下のような制約があります:</para> + + <para>pid が 1 のプロセスには stdin/stdout/stderr + は割り当てられていませんので, + プログラムは自分でこれらをオープンしないとなりません. + このプロセスが終了するとカーネルはパニックメッセージを表示して + 停止します. + また, このプロセスに対するシグナル処理は特殊です.</para> + + <para>この例として, インストール用のフロッピーディスクにある + <command>/stand/sysinstall</command>があります.</para> + </sect2> + + <sect2> + <title>興味深い連係</title> + + <para>カーネルを MFS でブートするのには次のような特別の + <filename>/sbin/init</filename> を使います.</para> + + <variablelist> + <varlistentry><term>A — DOS を使う場合</term> + <listitem> + <itemizedlist> + <listitem> + <para><filename>C:</filename> を + <filename>/C:</filename> にマウントします.</para> + </listitem> + + <listitem> + <para><filename>C:/freebsd.fs</filename> を + <filename>/dev/vn0</filename> + にアタッチします.</para> + </listitem> + + <listitem> + <para><filename>/dev/vn0</filename> を + <filename>/rootfs</filename> + にマウントします.</para> + </listitem> + + <listitem> + <para>シンボリックリンクを作ります.<!-- <br> --> + <filename>/rootfs/bin</filename> -> + <filename>/bin</filename><!-- <br> --> + <filename>/rootfs/etc</filename> -> + <filename>/etc</filename><!-- <br> --> + <filename>/rootfs/sbin</filename> -> + <filename>/sbin</filename><!-- <br> --> (etc...)<!-- + <br> --></para> + </listitem> + </itemizedlist> + + <para>これでハードディスクのパーティションを切り直さずに + FreeBSD を 使うことができます.</para> + </listitem> + </varlistentry> + + <varlistentry><term>B — NFS を使う場合</term> + <listitem> + <para>NFS は<filename>サーバ:~you/FreeBSD</filename> を + <filename>/nfs</filename> にマウントし, + ルートディレクトリを <filename>/nfs</filename> + に変更して, そこで <filename>/sbin/init</filename> + を実行します.</para> + + <para>これで FreeBSD をディスクレスで実行できますが, NFS + サーバを コントロールできないままです...</para> + </listitem> + </varlistentry> + + <varlistentry><term>C — X-server を起動する場合</term> + <listitem> + <para>これで X ターミナルが手に入りました. これは, + これでハードウェア に費用を割いたりするよりはいい, + と上司が主張した, Windows で + 動作する遅くて何がおこなわれているのか + 見ることができるような すすけた X Window + エミュレータなんかよりよいものです.</para> + </listitem> + </varlistentry> + + <varlistentry><term>D — テープを使う場合</term> + <listitem> + <para><filename>/dev/rwd0</filename> + のコピーを取って, リモートにあるテープ + ステーションやファイルサーバに書き込んでください.</para> + + <para>これで一年前に取っておくべきだった + バックアップをやっと 取ることができました.</para> + </listitem> + </varlistentry> + + <varlistentry><term>E — ファイアウォール/Web + サーバとして動作させる場合 + (私の知っている範囲で...)</term> + + <listitem> + <para>これは特に面白いもので, + 書き込み禁止のフロッピーディスクから ブートができて, + ルートのファイルシステムに書き込むことができる + というものです.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + </sect1> + + <sect1 id="memoryuse"> + <title>PC におけるメモリの利用</title> + + <para><emphasis>原作: &a.joerg;.<!-- <br> --> + 16 Apr 1995.</emphasis></para> + + <para><emphasis>訳: &a.jp.tomo;. <!-- <br> --> + 29 Oct 1996.</emphasis></para> + + <para><emphasis>FreeBSD が i386 + プラットフォーム上でどのようにメモリを使うかに + ついての説明です. </emphasis></para> + + <para>ブート部分は<literal>0:0x7c00</literal>にロードされ, + すぐに自分自身を <literal>0x7c0:0</literal>に移します. + (これは手品ではなく, 単なる<literal>%cs</literal> + セレクタのための調節であり, + <literal>ljmp</literal>により行われます. )</para> + + <para>それから最初の 15 セクタを <literal>0x10000</literal> + (biosboot の Makefile のなかの + <makevar>BOOTSEG</makevar>部分)にロードし, 作業領域のスタックを + <literal>0x1fff0</literal>以下に セットします. このあと, boot2 + に飛びます. つまり, boot1 自身と (ダミーの) DOS + パーティションテーブルを飛び越えて, %csセレクタを 調節します + — この時点ではまだ16ビットモードです.</para> + + <para>boot2 はブートファイルを要求し, + <filename>a.out</filename>ヘッダを調べます. + <literal>0x00ffffff</literal>によってファイルエントリポイントを + (通常は<literal>0xf0100000</literal>に)マスクし, ロードします. + このため, 通常のロードポイントは 1MB + (<literal>0x00100000</literal>) になります. ロードしている間, + リアルモードでBIOSを使うため, ブートコードは, + リアルモードとプロテクトモードの間を行ったり来たりします (訳注: + これは, BIOSがリアルモード用に書かれていて, + ロードすべき領域がリアルモードではアクセスできない1MBより上位の + アドレスであることから, ブートコードがリアルモードと + プロテクトモードを切り替えながら動作するためです).</para> + + <para>ブートコード自身はプロテクトモードで + <literal>%cs</literal>と<literal>%ds/%es</literal> 用に + セグメントセレクタ <literal>0x18</literal> と + <literal>0x20</literal> を使い, + リアルモードに戻るのに<literal>0x28</literal>を使います. + 最終的にカーネルはアドレス空間全体をカバーできるようなダミーの + ディスクリプタを参照して<literal>%cs</literal> + <literal>0x08</literal>と <literal>%ds/%es/%ss</literal> + <literal>0x10</literal>でスタートします.</para> + + <para>カーネルはそのロードポイントで起動されます. + 別の(高位)アドレスにリンクされるので, + ページテーブルやページディレクトリなどが適切に設定され, + ページングが有効になり, カーネルがリンクされたアドレスで + 動作するようになるまでは, カーネルはロードアドレスからの + 相対アドレス (PIC: position independent code) を用いて + 実行されなければなりません.</para> + + <para><emphasis>寄贈: &a.dg;.<!-- <br> --> + 16 Apr 1995.</emphasis></para> + + <para>カーネルの BSS セグメントの直後の物理ページ (実メモリ) に + proc0 (訳注: プロセス番号 0, swapper) のページディレクトリや + ページテーブル, Uページが配置されます. + 仮想記憶機構が初期化された少しあと, + <literal>0x1000-0x9ffff</literal>の実メモリとカーネル (text + + data + bss + 上記の proc0 に関わるもの + その他) + の後ろの実メモリは, 通常の仮想記憶ページの形で利用可能となり, + グローバルな空きページリストに追加されます.</para> + </sect1> + + <sect1 id="dma"> + <title>DMAとはどういったものでどういう働きをするのか</title> + + <para><emphasis>原作: &a.uhclem;<!-- <br> --><!-- <br> --> + 訳: &a.jp.yasu;<!-- <br> --> + 10 December 1996. 最終更新日 8 October 1997.</emphasis></para> + + <para>Direct Memory Access (DMA)は, 中央演算処理装置 + (CPU)からの干渉なく + データを計算機中である場所から別の場所に動かすための手法です. + </para> + + <para>DMA 機能の実装の方法はそれぞれの + 計算機アーキテクチャ間で異なるもので あるため, + ここでの議論はIBMパーソナルコンピュータ(PC), PC/AT + とその互換機における DMA + サブシステムの実装と働きに限定します.</para> + + <para>PCの DMAサブシステムは, Intelの 8237 + DMAコントローラをベースにして います. + 8237はそれぞれ独立にプログラムできる4つのDMAチャネルを持ち, + それぞれどのチャネルもいつでもアクティブにできます. + これらのチャネルは順に 0, 1, 2, 3となっています. PC/ATからは, + セカンド 8237 チップが追加され,それらは 4, 5, 6, 7と + なっています.</para> + + <para>オリジナルの DMAコントローラ(0, 1, 2, 3)は, + 1回の転送で1バイト 転送します. セカンドDMAコントローラ(4, 5, 6, + 7)は1回で 隣接する2つのメモリ番地から 16ビット転送します. + ここで, 最初のバイトは通常偶数のアドレスになります. + 2つのコントローラは全く同じものであり, 転送量が異なるのは + セカンドコントローラがシステムに直結しているためです.</para> + + <para>8237 は個々のチャネルについて, + DRQと-DACKという2つの電気信号を 持っています. その他に, HRQ + (Hold Request), HLDA (Hold Acknowledge), -EOP (End of + Process)があり, バス制御信号として -MEMR (Memory Read), -MEMW + (Memory Write), -IOR (I/O Read), and -IOW (I/O + Write)があります.</para> + + <para>8237 DMACは, いわゆる“fly-by” + DMAコントローラです. これは, データの移動を行う際に, データは + DMACチップを通過せず, DMACチップに格納されないことを意味します. + また, DMACはI/Oポートとメモリアドレス間でのみデータを + 転送することができますが, + 2つのI/Oポートもしくは2つのメモリアドレス + 間ではできません.</para> + + <note> + <para>8237 は, 非 “fly-by”モードでは, + 互いに接続された + 2つのチャネルでのメモリ-メモリ間でのDMA操作を許可します. + しかし, PC メーカは, + ただでさえ乏しいこのリソースをこんなふうに 使ったりしません. + なぜなら, + CPUを使用してメモリ間のデータを動かす方が早いからです.</para> + </note> + + <para>PC アーキテクチャでは, それぞれのDMAチャネルは, 通常 + 与えられた DMA + チャネルを使用するハードウェアがそのチャネルについて + DRQ線を使って転送を要求した時のみ動作します.</para> + + <sect2> + <title>DMA転送の例</title> + + <para>DMA転送の発生と処理の手順の例をあげてみましょう. + この例では, フロッピーディスクコントローラ (FDC)が + ディスケットから1バイト読み込んで, + DMAを使って,メモリの0x00123456番地に 格納したいとします. + 処理は, FDCが, DRQ2信号(DMAチャンネル2に + 対するDRQ線)を有効にして + DMAコントローラに要求を伝えることで開始されます.</para> + + <para>DMAコントローラは DRQ2 + シグナルが有効になったことを記録します. + するとDMAコントローラはDMAチャネル2がプログラムされ, マスクが + かかっていない(有効になっている)ことを確認します. 同様に, + DMAコントローラは, 他のDMAチャネルがアクティブまたは + アクティブになろうとしていないこと, + そしてより高い優先度を持って いないことを確認します. + 一旦これらのチェックが完了すると, DMACはDMACがバスを使うために + バスを開放するようにCPUに要求します. + DMACはCPUにHRQ信号を送ってバスを要求します.</para> + + <para>CPUはHRQ信号を検出し, 現在の指示の実行を完了します. + 一旦プロセッサがバスを開放することができる状態になると, 解放を + 行います. 通常は CPU により駆動される信号 (-MEMR, -MEMW, + -IOR, -IOW, その他)を すべてハイインピーダンス + (ハイともローとも指定しない)状態にした後, CPUは + HLDA信号を有効にして DMAコントローラにバスを明け渡したことを + 伝えます.</para> + + <para>プロセッサによっては, CPUはバスを使用しないいくつかの + 命令を追加して実行することもできますが, + しかし,プロセッサの内部キャッシュや + パイプライン以外のメモリから + 何か読み出すといった指示に到達したら結局 CPU + は待たなくてはなりません.</para> + + <para>ここで,DMACが バスを“託される”と, DMACはその + -MEMR, -MEMW, -IOR, -IOW 出力信号をアクティブにし, + DMACから出力されるアドレスは 0x3456にセットされます.これは + 転送しようとする特定のメモリ番地をバイトで + 指示するのに使われます.</para> + + <para>すると DMAC は DMA + 転送をリクエストしたデバイスに転送が始まることを + 知らせます.これは -DACK + 信号をアクティブにすることで行われます. + フロッピーディスクコントローラの場合は, -DACK2を + アクティブにすることで行われます.</para> + + <para>バスのデータ線に転送されるバイトにを出力することについては + フロッピーディスクコントローラが責任をもつことになります. + もし,フロッピーディスクコントローラがバス上にバイトデータを + 出力するのに余計な時間を必要としなければ + (もし周辺装置がもっと時間を必要とする場合には, READY信号を + 経由してDMACに通知します), DMAは 1 DMAクロック待ち, + メモリにバス上のバイトデータを格納するために -MEMW および -IOR + 信号を解除します. そして + FDCはバイトデータが転送されたことを認識します.</para> + + <para>DMAサイクルは1度に1バイトしか転送しないので, + FDCはDRQ2信号を止めて, DMACに転送が終了したことを知らせます. + DMACは-DACK2信号を解除して, FDCはバス上へのデータ出力を + 停止しなくてはならないことを知らせます.</para> + + <para>次にDMACは他のDMAチャネルのいずれかに要求がきていないか + チェックを行います. + もしどのチャネルのDRQも有効になっていなければ, + DMAコントローラは処理を完了して, -MEMR, -MEMW, -IOR, -IOW + および アドレス信号をハイインピーダンス状態にします.</para> + + <para>最後に, DMAはHRQ信号を解除します. + CPUはこれを見ると,HOLDA信号を 解除します. そしてCPUは自らの + -MEMR, -MEMW, -IOR, -IOW 信号および アドレス線を有効にし, + 命令の実行やメインメモリや周辺機器へのアクセスを + 再開します.</para> + + <para>典型的なフロッピーディスクの1セクタについては, + 上記のプロセスが それぞれのバイトについて1回行われ, + 全部で512回繰り返されます. 1 バイト転送される毎に, DMAC + 内のアドレスレジスタはインクリメントされ, 同じくDMAC内にある, + 何バイト転送すればよいかを示すカウンタが + デクリメントされます.</para> + + <para>カウンタが0になると, DMAはEOP信号を送ります. この信号は + カウンタが0であり, DMAコントローラがCPUによって再び + プログラムされるまで, これ以上データは転送されないことを + 示すものです.</para> + + <para>このイベントはターミナルカウント(TC)とも呼ばれます. + EOP信号は1本しかありません. そして, 一度にアクティブにできる + DMAチャネルは一本だけなので, + 現在アクティブであるDMAチャネルこそが, + たった今処理を終了したDMAチャネルだと言うことができます.</para> + + <para>もし, + バッファの転送が完了した時に周辺機器から割り込みを発生させたい + とき, 周辺機器は + -DACKn信号およびEOP信号の両方が同時に発信されたか + どうかをテストします. その場合, DMACはCPUの介在がなければ + これ以上はその周辺機器についての情報を転送しません. その後で, + 周辺機器はプロセッサに割り込みを生じさせるために, + 何らかの割り込み信号を発生させることができます. + PCアーキテクチャ においては, + DMAチップ自身が割り込みを生じさせることはできません. + 周辺機器とそれに関連するハードウェアが割り込みを生成する責任を + 持ちます. また, DMAを使用する周辺機器が割り込みを使用しない + 可能性もあります.</para> + + <para>DMAC が要求を出したときには CPU は常にバスを DMAC + に開放しますが, この動作は, DMAC + がアクティブになった時にプロセッサが命令を実行するのに + かかる時間がわずかに変化することを除いては, アプリケーション, + オペレーティングシステムの両方からはわからないということを + 理解することが重要です. そのため, + プロセッサが確かにDMA転送が完了したことを知るためには, + 周辺装置や DMA + チップ中のレジスタを調べたり,周辺装置からの割り込みを + 受け取る必要があります.</para> + </sect2> + + <sect2> + <title>DMA ページレジスタ および 16メガ アドレス空間制限</title> + + <para>これまで述べたのとは異なり, DMACはアドレス線を 0x0123456 + にセットする 代わりに 0x3456 + だけをセットすることにあなたは気づいたかも しれません. + この理由について少し説明します.</para> + + <para>オリジナルのIBM PCがデザインされた時, IBMは, + DMACと割込み制御チップの 両方を, 8085(8ビットプロセッサで, + 16ビットのアドレス空間(64k)を持つ)と + 組み合わせて使うように設計されたチップを使うことを選びました. + IBM PCが64k以上のメモリをサポートしていたため, + DMACが64kを越えるメモリ番地に読み込み又は書き込みを行うために + 変更を行う必要が生じました. + この問題を解決するためにIBMが行ったのは, + それぞれのDMAチャネルに, + 読み込み元または書き込み先のアドレスの + 上位ビットを保持するための 外部的なラッチを追加することでした. + DMAチャネルがアクティブな時はいつでも, + このラッチの内容はアドレスバスに書かれて, + そのチャネルのDMA操作が 終了するまでそこに保持されます. IBM + はこれらのラッチを “ページレジスタ” + と呼んでいます.</para> + + <para>そのため上記に示した例では, + DMACはアドレスの0x3456の部分をバス上に 置き, + DMAチャネル2に対するページレジスタは, 0x0012xxxxをバス上に + 置きます. + これらの2つの値が組み合わされてアクセスされるメモリ中の完全な + アドレスを形成します.</para> + + <para>ページレジスタのラッチはDMAチップとは独立であるので, + 読み込まれる又は書き込まれるメモリ領域は, 64kの物理的境界を + またいではなりません. 例えば, もし + DMACがメモリの0xffff番地をアクセスした場合, データの転送後, + DMACはアドレスレジスタをインクリメントし, + 0x0000番地にある次のバイトを アクセスします. + 0x10000番地ではありません. + これはおそらく意図されたものとは異なっているでしょう.</para> + + <note> + <para>“物理的な” 64Kの境界を 8086モードの + 64k“セグメント”と混同してはいけません. + セグメントは, セグメント + レジスタに数学的にオフセットレジスタを + 加算して作られるものです. + ページレジスタにはアドレスのオーバーラップも無く, 数学的に + OR を取られることもありません.</para> + </note> + + <para>さらに複雑なことには, PC/ATでは外部のDMAアドレスのラッチは + 8ビットしか保持しません. よって8+16で24ビットになり, これは + DMAが0から16メガの間のメモリ番地しか指し示せないことを + 意味します. + 16メガ以上のメモリを持ったより新しいマシンにおいても, + 標準的なPCコンパチブルなDMAでは16メガ以上のメモリ番地には + アクセスできません.</para> + + <para>この制限を避けるために, オペレーティングシステムは 16 + メガ以下にある物理的な 64k の境界をまたがない領域に RAM + バッファを 予約します. そして, + DMACはデータを周辺機器からそのバッファに + 転送するようにプログラムされます. 一旦DMACがこのバッファに + データを動かすと, オペレーティングシステムは本当にデータを + 格納したいアドレスにバッファからデータをコピーします.</para> + + <para>16メガを越えるアドレスからDMAベースの周辺機器にデータを + 書き込む際には, データは16メガ以下に位置したバッファから最初に + コピーされなくてはならず, その後, + DMACはバッファからハードウェアに + データをコピーすることができます. FreeBSDでは, + これらの予約バッファは + “バウンスバッファ”と呼ばれます. MS-DOSの世界では, + これらは“スマートバッファ”などと呼ばれます.</para> + + <note> + <para>82374と呼ばれる8237の新しい実装においては, + ページレジスタを16ビットで指定して, + バウンスバッファを使用しなくても, 32 + ビットのアドレス空間全体にアクセスすることが可能です.</para> + </note> + </sect2> + + <sect2> + <title>DMA操作モードとその設定</title> + + <para>8237 DMA はいくつかのモードで動作します. 主なモードは, + 以下のとおりです.</para> + + <variablelist> + <varlistentry><term>シングル転送モード</term> + <listitem> + <para>シングルバイト(もしくはワード)が転送されます. + DMAは1バイト毎にバスを開放し, + 再び要求しなくてはなくてはなりません. これは一般に, + すぐにはデータのブロック全てを転送できないデバイスに + よって使用されます. + 周辺装置は次の転送の準備ができる毎にDMAを要求します. + </para> + + <para>標準的な PC + コンパチブルなフロッピーディスクコントローラ(NEC 765)は + 1バイトのバッファしか持たないので, + このモードを使用します.</para> + </listitem> + </varlistentry> + + <varlistentry><term>ブロック/デマンド転送モード</term> + <listitem> + <para>一旦 DMAC がシステムバスを取得すると, + 最大64kまでのデータブロック 全体が転送されます. + もし周辺装置が余分に時間を必要とするときは, + 転送を一時中断するためにREADY信号を有効にします. + READY信号は過度に使われるべきではなく, + 遅い周辺装置の転送の場合は + シングル転送モードを代わりに使うべきです.</para> + + <para>ブロック転送モードとデマンド転送モードの違いは, + 一旦ブロック転送が 始まると, 転送カウンタか 0 + になるまでそれが行われるところです. DRQ は -DACK + が有効になるまでの間は有効でなければなりません. + デマンドモードは DRQ が有効な間転送が続けられます. + DRQが有効でなくなった場合, DMA はその時点で転送を中断し, + バスを解放して CPU に返します. + その後, DRQが有効になると, + 転送は中断したところから再開されます.</para> + + <para>データの転送, + 特に転送に使われるメモリ番地が16Mを越える場合に, CPU + を使った方が効率がよくなるまで CPU + の速度が向上する以前の + 古いハードディスクコントローラはデマンドモードを + 使っていました.</para> + </listitem> + </varlistentry> + + <varlistentry><term>カスケード転送モード</term> + <listitem> + <para>このメカニズムは DMA + チャネルがバスを要求することを許可する ものですが, + 接続されたデバイスはバス上のアドレス情報の配置に + ついてDMACに代わって責任を持ちます. + これは“バスマスタ” + と呼ばれる技術の実装に利用されます.</para> + + <para>カスケードモードの DMA + チャネルがバスのコントロールを受け取ると, DMA + は通常行われるようなバス上のアドレスと I/O + コントロール信号の 出力を行いません. 代わりに, + DMAはアクティブなチャネルの -DACK信号を + 有効にします.</para> + + <para>この時点で, アドレスとバスコントロール信号の供給は + DMAチャネルに接続された周辺機器が担当します. + 周辺機器はシステムバスの完全なコントロールを行い, 16 + メガ以下の任意のアドレスの読み込みおよび書き込みを + 行うことが できます. 周辺機器はバスの使用を終えると DRQ + 線を無効にするので, DMA コントローラは CPU + もしくは他のDMAチャネルに制御を返すことが + できます.</para> + + <para>カスケードモードは複数の DMA + コントローラを相互接続するのに 使われます. + PC内ではDMAチャネル4がまさにこの用途に使われています. + 周辺機器がDMAチャネル0, 1, 2, 3でバスを要求すると, + スレーブDMAコントローラは HLDREQ を有効にしますが, + この線はCPUではなく, + 実際にはプライマリDMAコントローラのDRQ4に + 接続されています. その後, + チャンネル4になにか仕事があるものと見なしたプライマリの + DMAコントローラは HLDREQ を使ってCPUにバスを 要求します. + バスが与えられると, -DACK4が有効になりますが, + この線は実際にはスレーブDMAコントローラの HLDA信号に + 接続されています. + スレーブDMAコントローラはその後要求したDMAチャネル (0, + 1, 2, 3) に対してデータを転送するか, + SCSIコントローラのような + バスマスタリングを要求する周辺機器にバスを許可します. + </para> + + <para>このような配線がおこなわれているため, + PC/ATシステムの 周辺機器ではDMAチャネルは 0, 1, 2, 3, 5, + 6, 7のみが使用できます.</para> + + <note> + <para>初期のIBM PCコンピュータでは, DMAチャネル0は操作の + リフレッシュのために予約されていますが, + 最近のシステムでは通常, + 周辺機器によって使用することができます.</para> + </note> + + <para>周辺機器がバスマスタリングを行っている時は, + システムバスを保持している間絶えずメモリに + もしくはメモリから データを転送することが重要です.もし, + 周辺機器がこのように できないときは, + システムがメインメモリのリフレッシュを + 行なえるようにしばしばバスを開放しなくては + なりません.</para> + + <para>全ての PC でメインメモリとして使われるダイナミック + RAM は, 中身が “満たされている” + ビットを保持するため + 頻繁にアクセスされなくてはなりません. ダイナミック RAM + は, それぞれが 1 ビットのデータを記憶するコンデンサが + たくさん集まって構成されています. + これらのコンデンサは充電された 状態で + <literal>1</literal>, 充電されていない状態で + <literal>0</literal> を表します. + 全てのコンデンサは放電するため, <literal>1</literal> + の値を保持するために, + 一定の間隔で電力を加える必要があります. 実際に RAM + チップは RAM の適切な場所に電力を送る作業を行ないますが, + メモリのリフレッシュ作業が RAM を普通にアクセスする時と + 衝突しないように, それをいつ行なうかを + コンピュータが休止状態の時に知らせなくてはなりません. + もしコンピュータがメモリのリフレッシュを + 行なえない場合は, + メモリの中身はわずか数ミリ秒で壊れてしまいます.</para> + + <para>メモリの読み込みと書き込みのサイクルは + リフレッシュサイクルとして カウントされる(ダイナミック + RAM のリフレッシュサイクルは + 実際には不完全なメモリ読み込みサイクルになります)ので, + 周辺機器のコントローラが連続するメモリ番地から + データの読み込み または書き込みを行う間は, + メモリの全てがリフレッシュされます.</para> + + <para>バスマスタリングはいくつかの SCSI + ホストインターフェースやその他の + ハイパフォーマンスな周辺機器コントローラに + 見られます.</para> + </listitem> + </varlistentry> + + <varlistentry><term>自動初期化転送モード</term> + <listitem> + <para>このモードにおいてDMAはバイト, ブロック, + デマンド転送を行いますが, DMA転送カウンタが0になると, + カウンタとアドレスはDMAチャネルが + もともとプログラムされた時のものに戻されます. これは, + 周辺機器が転送を要求している間は転送が続けられることを + 意味します. + 転送領域としてDMACにプログラムされた固定バッファの中で, + 出力操作でDMACがデータを読み出す前もって新しいデータを + 書き込んだり入力操作でDMACが書き込んだあとに, + そこから新しいデータを読み出す作業は CPU + が受け持ちます.</para> + + <para>このテクニックは, “サンプリング” + 用のバッファが小さいもしくは + それを持たないオーディオデバイスによく使われます. + この“環状” バッファの管理は更なる CPU + オーバーヘッドになりますが, DMAカウンタが0になり, + 再プログラムされるまでDMAが停止してしまう + ことによって起きる遅延は, + この方法でしかなくす事ができない 場合もあります.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + <sect2> + <title>DMAのプログラミング</title> + + <para>プログラムされるDMAチャネルは, 通常, 設定を行う前に + “マスクする”べきです. + これはハードウェアが予期せずそのチャンネルに対してDRQを有効に + した場合, たとえ全てのパラメータが + 満たされてない場合や更新されていない場合でも, DMACは + それに応答してしまう可能性があるからです.</para> + + <para>マスクを行ってから,ホストは転送の方向(メモリからI/O, + もしくはI/Oからメモリ)と, 転送に使用するDMA操作のモード + (シングル, ブロック, デマンド, カスケードなど)を設定し, 最後に + アドレスや転送の長さを設定します. + 設定される長さはDMACに転送させたい量よりも1少なくなります. + アドレスや転送長のLSBとMSBは同じ8ビットI/O + ポートに書き込まれます. そのためDMACが最初のバイトをLSBとして, + 2番目のバイトをMSBとして 受け取ることを保証するために, + 最初に別のポートに書き込みを行なって LSBとMSB + の判別を行なうフリップフロップをクリアしておく必要があります. + </para> + + <para>そして,DMAのページレジスタを更新します. + これはDMACの外部にあり I/O + ポートの別のセットを通してアクセスされます.</para> + + <para>すべての設定ができると, + DMAチャネルはマスクを解除することができます. + そのDMAチャネルは“準備ができた”とみなされ, + そのチャンネルのDRQが 有効になると応答します.</para> + + <para>8237のプログラミングの正確な詳細については, + ハードウェアデータブックを参照してください. PCシステムにおける + I/O マップについても参照する必要があるでしょう. このマップには + DMA およびページレジスタのポートがどこに位置するのかを + 書いてあります. + 以下に完全なポートのマップテーブルを示します.</para> + </sect2> + + <sect2> + <title>DMAポートのマップ</title> + + <para>IBM-PCとPC/ATに基づくすべてのシステムでは, + 同じI/Oポートに配置された DMAハードウェアを持っています. + その完全なリストを以下に示します. + DMAコントローラ2に割り当てられたポートは, AT以外のデザインでは + 未定義になっています.</para> + + <sect3> + <title>0x00 – 0x1f DMA コントローラ #1 (Channels 0, 1, 2 + and 3)</title> + + <para>DMA アドレス および カウントレジスタ</para> + + <informaltable frame="none"> + <tgroup cols="3"> + <tbody> + <row> + <entry>0x00</entry> + <entry>write</entry> + <entry>Channel 0 starting address</entry> + </row> + + <row> + <entry>0x00</entry> + <entry>read</entry> + <entry>Channel 0 current address</entry> + </row> + + <row> + <entry>0x01</entry> + <entry>write</entry> + <entry>Channel 0 starting word count</entry> + </row> + + <row> + <entry>0x01</entry> + <entry>read</entry> + <entry>Channel 0 remaining word count</entry> + </row> + + <row> + <entry>0x02</entry> + <entry>write</entry> + <entry>Channel 1 starting address</entry> + </row> + + <row> + <entry>0x02</entry> + <entry>read</entry> + <entry>Channel 1 current address</entry> + </row> + + <row> + <entry>0x03</entry> + <entry>write</entry> + <entry>Channel 1 starting word count</entry> + </row> + + <row> + <entry>0x03</entry> + <entry>read</entry> + <entry>Channel 1 remaining word count</entry> + </row> + + <row> + <entry>0x04</entry> + <entry>write</entry> + <entry>Channel 2 starting address</entry> + </row> + + <row> + <entry>0x04</entry> + <entry>read</entry> + <entry>Channel 2 current address</entry> + </row> + + <row> + <entry>0x05</entry> + <entry>write</entry> + <entry>Channel 2 starting word count</entry> + </row> + + <row> + <entry>0x05</entry> + <entry>read</entry> + <entry>Channel 2 remaining word count</entry> + </row> + + <row> + <entry>0x06</entry> + <entry>write</entry> + <entry>Channel 3 starting address</entry> + </row> + + <row> + <entry>0x06</entry> + <entry>read</entry> + <entry>Channel 3 current address</entry> + </row> + + <row> + <entry>0x07</entry> + <entry>write</entry> + <entry>Channel 3 starting word count</entry> + </row> + + <row> + <entry>0x07</entry> + <entry>read</entry> + <entry>Channel 3 remaining word count</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>DMA コマンドレジスタ</para> + + <informaltable frame="none"> + <tgroup cols="3"> + <tbody> + <row> + <entry>0x08</entry> + <entry>write</entry> + <entry>Command Register</entry> + </row> + + <row> + <entry>0x08</entry> + <entry>read</entry> + <entry>Status Register</entry> + </row> + + <row> + <entry>0x09</entry> + <entry>write</entry> + <entry>Request Register</entry> + </row> + + <row> + <entry>0x09</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0x0a</entry> + <entry>write</entry> + <entry>Single Mask Register Bit</entry> + </row> + + <row> + <entry>0x0a</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0x0b</entry> + <entry>write</entry> + <entry>Mode Register</entry> + </row> + + <row> + <entry>0x0b</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0x0c</entry> + <entry>write</entry> + <entry>Clear LSB/MSB Flip-Flop</entry> + </row> + + <row> + <entry>0x0c</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0x0d</entry> + <entry>write</entry> + <entry>Master Clear/Reset</entry> + </row> + + <row> + <entry>0x0d</entry> + <entry>read</entry> + <!-- kuriyama - nik typo --> + <entry>Temporary Register + (新しいバージョンでは利用不可)</entry> + </row> + + <row> + <entry>0x0e</entry> + <entry>write</entry> + <entry>Clear Mask Register</entry> + </row> + + <row> + <entry>0x0e</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0x0f</entry> + <entry>write</entry> + <entry>Write All Mask Register Bits</entry> + </row> + + <row> + <entry>0x0f</entry> + <entry>read</entry> + <entry>Read All Mask Register Bits (Intel + 82374にのみ存在する)</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </sect3> + + <sect3> + <title>0xc0 – 0xdf DMA コントローラ #2 (Channels 4, 5, 6 + and 7)</title> + + <para>DMA アドレス および カウントレジスタ</para> + + <informaltable frame="none"> + <tgroup cols="3"> + <tbody> + <row> + <entry>0xc0</entry> + <entry>write</entry> + <entry>Channel 4 starting address</entry> + </row> + + <row> + <entry>0xc0</entry> + <entry>read</entry> + <entry>Channel 4 current address</entry> + </row> + + <row> + <entry>0xc2</entry> + <entry>write</entry> + <entry>Channel 4 starting word count</entry> + </row> + + <row> + <entry>0xc2</entry> + <entry>read</entry> + <entry>Channel 4 remaining word count</entry> + </row> + + <row> + <entry>0xc4</entry> + <entry>write</entry> + <entry>Channel 5 starting address</entry> + </row> + + <row> + <entry>0xc4</entry> + <entry>read</entry> + <entry>Channel 5 current address</entry> + </row> + + <row> + <entry>0xc6</entry> + <entry>write</entry> + <entry>Channel 5 starting word count</entry> + </row> + + <row> + <entry>0xc6</entry> + <entry>read</entry> + <entry>Channel 5 remaining word count</entry> + </row> + + <row> + <entry>0xc8</entry> + <entry>write</entry> + <entry>Channel 6 starting address</entry> + </row> + + <row> + <entry>0xc8</entry> + <entry>read</entry> + <entry>Channel 6 current address</entry> + </row> + + <row> + <entry>0xca</entry> + <entry>write</entry> + <entry>Channel 6 starting word count</entry> + </row> + + <row> + <entry>0xca</entry> + <entry>read</entry> + <entry>Channel 6 remaining word count</entry> + </row> + + <row> + <entry>0xcc</entry> + <entry>write</entry> + <entry>Channel 7 starting address</entry> + </row> + + <row> + <entry>0xcc</entry> + <entry>read</entry> + <entry>Channel 7 current address</entry> + </row> + + <row> + <entry>0xce</entry> + <entry>write</entry> + <entry>Channel 7 starting word count</entry> + </row> + + <row> + <entry>0xce</entry> + <entry>read</entry> + <entry>Channel 7 remaining word count</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>DMA コマンドレジスタ</para> + + <informaltable frame="none"> + <tgroup cols="3"> + <tbody> + <row> + <entry>0xd0</entry> + <entry>write</entry> + <entry>Command Register</entry> + </row> + + <row> + <entry>0xd0</entry> + <entry>read</entry> + <entry>Status Register</entry> + </row> + + <row> + <entry>0xd2</entry> + <entry>write</entry> + <entry>Request Register</entry> + </row> + + <row> + <entry>0xd2</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0xd4</entry> + <entry>write</entry> + <entry>Single Mask Register Bit</entry> + </row> + + <row> + <entry>0xd4</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0xd6</entry> + <entry>write</entry> + <entry>Mode Register</entry> + </row> + + <row> + <entry>0xd6</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0xd8</entry> + <entry>write</entry> + <entry>Clear LSB/MSB Flip-Flop</entry> + </row> + + <row> + <entry>0xd8</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0xda</entry> + <entry>write</entry> + <entry>Master Clear/Reset</entry> + </row> + + <row> + <entry>0xda</entry> + <entry>read</entry> + <!-- kuriyama - nik typo --> + <entry>Temporary Register (Intel 82374には存在しない)</entry> + </row> + + <row> + <entry>0xdc</entry> + <entry>write</entry> + <entry>Clear Mask Register</entry> + </row> + + <row> + <entry>0xdc</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0xde</entry> + <entry>write</entry> + <entry>Write All Mask Register Bits</entry> + </row> + + <row> + <entry>0xdf</entry> + <entry>read</entry> + <entry>Read All Mask Register Bits (Intel + 82374にのみ存在する)</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </sect3> + + <sect3> + <title>0x80 – 0x9f DMA ページレジスタ</title> + + <informaltable frame="none"> + <tgroup cols="3"> + <tbody> + <row> + <entry>0x87</entry> + <entry>r/w</entry> + <entry>Channel 0 Low byte (23-16) page Register</entry> + </row> + + <row> + <entry>0x83</entry> + <entry>r/w</entry> + <entry>Channel 1 Low byte (23-16) page Register</entry> + </row> + + <row> + <entry>0x81</entry> + <entry>r/w</entry> + <entry>Channel 2 Low byte (23-16) page Register</entry> + </row> + + <row> + <entry>0x82</entry> + <entry>r/w</entry> + <entry>Channel 3 Low byte (23-16) page Register</entry> + </row> + + <row> + <entry>0x8b</entry> + <entry>r/w</entry> + <entry>Channel 5 Low byte (23-16) page Register</entry> + </row> + + <row> + <entry>0x89</entry> + <entry>r/w</entry> + <entry>Channel 6 Low byte (23-16) page Register</entry> + </row> + + <row> + <entry>0x8a</entry> + <entry>r/w</entry> + <entry>Channel 7 Low byte (23-16) page Register</entry> + </row> + + <row> + <entry>0x8f</entry> + <entry>r/w</entry> + <entry>Low byte page Refresh</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </sect3> + + <sect3> + <title>0x400 – 0x4ff 82374 Enhanced DMA Registers</title> + + <para>Intel 82374 EISA System Component + (ESC)は1996年の初めに発表されました. この中 + には機能的には8237のスーパーセットであり, + 1つのパッケージの中にその他の PC + 互換機のコアとなる周辺コンポーネントをも含んだ DMA + コントローラも含まれています. このチップはEISAとPCI + 両方のプラットホームをターゲットにしたものであり, + scatter-gather I/O やリングバッファを始めとして, + システムDMAをして32ビットの + アドレス空間全体に直接アクセスする能力も提供しています. + </para> + + <para>これらの機能を使用する場合でも, + 過去16年間のPC互換機で利用されてきた + 同等機能を提供するコードも含めておく必要があります. + 互換性の問題から, 82374の レジスタの一部は, + 従来の8237のレジスタをプログラムした <emphasis>後</emphasis> + に, 転送の度にプログラムされる必要があります. + 8237のレジスタに書き込みを行うとき, + ソフトウェアの下位互換性のために, + 82374で追加された一部のレジスタの内容が + 強制的に0にクリアされるからです.</para> + + <informaltable frame="none"> + <tgroup cols="3"> + <tbody> + <row> + <entry>0x401</entry> + <entry>r/w</entry> + <entry>Channel 0 High byte (bits 23-16) word count</entry> + </row> + + <row> + <entry>0x403</entry> + <entry>r/w</entry> + <entry>Channel 1 High byte (bits 23-16) word count</entry> + </row> + + <row> + <entry>0x405</entry> + <entry>r/w</entry> + <entry>Channel 2 High byte (bits 23-16) word count</entry> + </row> + + <row> + <entry>0x407</entry> + <entry>r/w</entry> + <entry>Channel 3 High byte (bits 23-16) word count</entry> + </row> + + <row> + <entry>0x4c6</entry> + <entry>r/w</entry> + <entry>Channel 5 High byte (bits 23-16) word count</entry> + </row> + + <row> + <entry>0x4ca</entry> + <entry>r/w</entry> + <entry>Channel 6 High byte (bits 23-16) word count</entry> + </row> + + <row> + <entry>0x4ce</entry> + <entry>r/w</entry> + <entry>Channel 7 High byte (bits 23-16) word count</entry> + </row> + + <row> + <entry>0x487</entry> + <entry>r/w</entry> + <entry>Channel 0 High byte (bits 31-24) page + Register</entry> + </row> + + <row> + <entry>0x483</entry> + <entry>r/w</entry> + <entry>Channel 1 High byte (bits 31-24) page + Register</entry> + </row> + + <row> + <entry>0x481</entry> + <entry>r/w</entry> + <entry>Channel 2 High byte (bits 31-24) page + Register</entry> + </row> + + <row> + <entry>0x482</entry> + <entry>r/w</entry> + <entry>Channel 3 High byte (bits 31-24) page + Register</entry> + </row> + + <row> + <entry>0x48b</entry> + <entry>r/w</entry> + <entry>Channel 5 High byte (bits 31-24) page + Register</entry> + </row> + + <row> + <entry>0x489</entry> + <entry>r/w</entry> + <entry>Channel 6 High byte (bits 31-24) page + Register</entry> + </row> + + <row> + <entry>0x48a</entry> + <entry>r/w</entry> + <entry>Channel 6 High byte (bits 31-24) page + Register</entry> + </row> + + <row> + <entry>0x48f</entry> + <entry>r/w</entry> + <entry>High byte page Refresh</entry> + </row> + + <row> + <entry>0x4e0</entry> + <entry>r/w</entry> + <entry>Channel 0 Stop Register (bits 7-2)</entry> + </row> + + <row> + <entry>0x4e1</entry> + <entry>r/w</entry> + <entry>Channel 0 Stop Register (bits 15-8)</entry> + </row> + + <row> + <entry>0x4e2</entry> + <entry>r/w</entry> + <entry>Channel 0 Stop Register (bits 23-16)</entry> + </row> + + <row> + <entry>0x4e4</entry> + <entry>r/w</entry> + <entry>Channel 1 Stop Register (bits 7-2)</entry> + </row> + + <row> + <entry>0x4e5</entry> + <entry>r/w</entry> + <entry>Channel 1 Stop Register (bits 15-8)</entry> + </row> + + <row> + <entry>0x4e6</entry> + <entry>r/w</entry> + <entry>Channel 1 Stop Register (bits 23-16)</entry> + </row> + + <row> + <entry>0x4e8</entry> + <entry>r/w</entry> + <entry>Channel 2 Stop Register (bits 7-2)</entry> + </row> + + <row> + <entry>0x4e9</entry> + <entry>r/w</entry> + <entry>Channel 2 Stop Register (bits 15-8)</entry> + </row> + + <row> + <entry>0x4ea</entry> + <entry>r/w</entry> + <entry>Channel 2 Stop Register (bits 23-16)</entry> + </row> + + <row> + <entry>0x4ec</entry> + <entry>r/w</entry> + <entry>Channel 3 Stop Register (bits 7-2)</entry> + </row> + + <row> + <entry>0x4ed</entry> + <entry>r/w</entry> + <entry>Channel 3 Stop Register (bits 15-8)</entry> + </row> + + <row> + <entry>0x4ee</entry> + <entry>r/w</entry> + <entry>Channel 3 Stop Register (bits 23-16)</entry> + </row> + + <row> + <entry>0x4f4</entry> + <entry>r/w</entry> + <entry>Channel 5 Stop Register (bits 7-2)</entry> + </row> + + <row> + <entry>0x4f5</entry> + <entry>r/w</entry> + <entry>Channel 5 Stop Register (bits 15-8)</entry> + </row> + + <row> + <entry>0x4f6</entry> + <entry>r/w</entry> + <entry>Channel 5 Stop Register (bits 23-16)</entry> + </row> + + <row> + <entry>0x4f8</entry> + <entry>r/w</entry> + <entry>Channel 6 Stop Register (bits 7-2)</entry> + </row> + + <row> + <entry>0x4f9</entry> + <entry>r/w</entry> + <entry>Channel 6 Stop Register (bits 15-8)</entry> + </row> + + <row> + <entry>0x4fa</entry> + <entry>r/w</entry> + <entry>Channel 6 Stop Register (bits 23-16)</entry> + </row> + + <row> + <entry>0x4fc</entry> + <entry>r/w</entry> + <entry>Channel 7 Stop Register (bits 7-2)</entry> + </row> + + <row> + <entry>0x4fd</entry> + <entry>r/w</entry> + <entry>Channel 7 Stop Register (bits 15-8)</entry> + </row> + + <row> + <entry>0x4fe</entry> + <entry>r/w</entry> + <entry>Channel 7 Stop Register (bits 23-16)</entry> + </row> + + <row> + <entry>0x40a</entry> + <entry>write</entry> + <entry>Channels 0-3 Chaining Mode Register</entry> + </row> + + <row> + <entry>0x40a</entry> + <entry>read</entry> + <entry>Channel Interrupt Status Register</entry> + </row> + + <row> + <entry>0x4d4</entry> + <entry>write</entry> + <entry>Channels 4-7 Chaining Mode Register</entry> + </row> + + <row> + <entry>0x4d4</entry> + <entry>read</entry> + <entry>Chaining Mode Status</entry> + </row> + + <row> + <entry>0x40c</entry> + <entry>read</entry> + <entry>Chain Buffer Expiration Control Register</entry> + </row> + + <row> + <entry>0x410</entry> + <entry>write</entry> + <entry>Channel 0 Scatter-Gather Command Register</entry> + </row> + + <row> + <entry>0x411</entry> + <entry>write</entry> + <entry>Channel 1 Scatter-Gather Command Register</entry> + </row> + + <row> + <entry>0x412</entry> + <entry>write</entry> + <entry>Channel 2 Scatter-Gather Command Register</entry> + </row> + + <row> + <entry>0x413</entry> + <entry>write</entry> + <entry>Channel 3 Scatter-Gather Command Register</entry> + </row> + + <row> + <entry>0x415</entry> + <entry>write</entry> + <entry>Channel 5 Scatter-Gather Command Register</entry> + </row> + + <row> + <entry>0x416</entry> + <entry>write</entry> + <entry>Channel 6 Scatter-Gather Command Register</entry> + </row> + + <row> + <entry>0x417</entry> + <entry>write</entry> + <entry>Channel 7 Scatter-Gather Command Register</entry> + </row> + + <row> + <entry>0x418</entry> + <entry>read</entry> + <entry>Channel 0 Scatter-Gather Status Register</entry> + </row> + + <row> + <entry>0x419</entry> + <entry>read</entry> + <entry>Channel 1 Scatter-Gather Status Register</entry> + </row> + + <row> + <entry>0x41a</entry> + <entry>read</entry> + <entry>Channel 2 Scatter-Gather Status Register</entry> + </row> + + <row> + <entry>0x41b</entry> + <entry>read</entry> + <entry>Channel 3 Scatter-Gather Status Register</entry> + </row> + + <row> + <entry>0x41d</entry> + <entry>read</entry> + <entry>Channel 5 Scatter-Gather Status Register</entry> + </row> + + <row> + <entry>0x41e</entry> + <entry>read</entry> + <entry>Channel 5 Scatter-Gather Status Register</entry> + </row> + + <row> + <entry>0x41f</entry> + <entry>read</entry> + <entry>Channel 7 Scatter-Gather Status Register</entry> + </row> + + <row> + <entry>0x420-0x423</entry> + <entry>r/w</entry> + <entry>Channel 0 Scatter-Gather Descriptor Table Pointer + Register</entry> + </row> + + <row> + <entry>0x424-0x427</entry> + <entry>r/w</entry> + <entry>Channel 1 Scatter-Gather Descriptor Table Pointer + Register</entry> + </row> + + <row> + <entry>0x428-0x42b</entry> + <entry>r/w</entry> + <entry>Channel 2 Scatter-Gather Descriptor Table Pointer + Register</entry> + </row> + + <row> + <entry>0x42c-0x42f</entry> + <entry>r/w</entry> + <entry>Channel 3 Scatter-Gather Descriptor Table Pointer + Register</entry> + </row> + + <row> + <entry>0x434-0x437</entry> + <entry>r/w</entry> + <entry>Channel 5 Scatter-Gather Descriptor Table Pointer + Register</entry> + </row> + + <row> + <entry>0x438-0x43b</entry> + <entry>r/w</entry> + <entry>Channel 6 Scatter-Gather Descriptor Table Pointer + Register</entry> + </row> + + <row> + <entry>0x43c-0x43f</entry> + <entry>r/w</entry> + <entry>Channel 7 Scatter-Gather Descriptor Table Pointer + Register</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </sect3> + </sect2> + </sect1> + + <sect1 id="internals-vm"> + <title>FreeBSD VM システム</title> + + <para><emphasis>原作: &a.dillon;. 6 Feb 1999</emphasis></para> + + <sect2> + <title>物理メモリ管理 — <literal>vm_page_t</literal></title> + + <para>物理メモリはページ単位に, + <literal>vm_page_t</literal>構造体を用いて管理されます. + 物理メモリのページは, ページキューの一つに存在する, + それぞれの <literal>vm_page_t</literal> + 構造体の配置によって分類されます.</para> + + <para>ページは, wired(ワイヤード), active(活性状態), + inactive(非活性状態), cache(キャッシュ状態), + free(使われていない状態)の 各状態をとります. wired + 状態を除いて, ページは通常 + その状態を示す二重連結リストのキューに置かれます. wired + 状態のページがキューに置かれることはありません.</para> + + <para>FreeBSD は, ページカラーリング(page + coloring)を実装するため, cache 状態, free + 状態にあるページ用に, + さらに複雑なページキューを実装しています. その各々の状態は, + プロセッサの L1, L2 キャッシュサイズに応じて最適化された + 多重キューを利用します. FreeBSD は, + 新たなページを確保(allocate)することが + 必要になった場合に確保される VM オブジェクトのために, L1, L2 + キャッシュに対して合理的にアライン(align)されたページを + 得ようと試みます.</para> + + <para>加えて, ページは参照カウントとともに保持され, + ビジーカウントとともにロックされます. VM システムは, + ページフラグとして PG_BUSY を使う “完全ロック状態” + も実装しています. + </para> + + <para>一般的には, 各々のページキューは最長不使用 (LRU) + 方式で動作します. ページは普通, 最初に wired, もしくは active + 状態に置かれます. wired 状態の場合, + そのページはどこかにあるページテーブルに 関連づけられています. + VM システムはアクティブなキュー内のページをスキャンし, wired + 状態のページにエイジング (訳注: + ページ参照頻度を量る手法の一つ; aging) を施します. そして, + そのページはあまりアクティブでないキューへ + 移動することになります. cache キューに移動させられたページは, + 再利用の候補になっている VM + オブジェクトに割り付けられています. free + キューにあるページは, 完全に自由の状態にあります. FreeBSD は, + free キューにあるページ数を最小限にとどめようと 試みますが, + 割り込み発生時のページ確保を融通するため, + 完全に自由なページをいくつか持っていなければなりません. + </para> + + <para>プロセスがページテーブルに存在しない, + ページキューの一つ(例えば, inactive, cache キュー等)に + 存在するページをアクセスしようとしたとき, + 比較的負荷の小さなページ再活性化フォールトが起こります. + システムメモリに全く存在していないページの場合は, + ディスクからページを読み出す間, + そのプロセスはブロック(block)されます.</para> + + <para>FreeBSD は, ページキューを動的に調節し, + 同期済(clean)のページ, 同期していない(dirty)ページの分類を + 合理的に保つのと同様に, それぞれのキューにあるページが合理的な + 比率に保つように試みます. 再バランス化処理が起こる量は, + システムのメモリ負荷に依存します. この再バランス化処理は + ページアウトデーモンによって実装されていて, + (補助記憶とページを同期して)同期していないページの + クリーニングすることや, (LRU + キュー内でのページ位置を再配置したり, + ページをキューの間を移動することで)ページが頻繁に + 参照状態にあることに注目すること, キューを均等にするための + キュー間ページ移動等を伴います. + ページが実際にどれだけ使われているかを決定するために, FreeBSD + の VM システムは, ページの再活性化フォールトを 自発的に, + 合理的な数だけ発生します. これは, + ページをスワップアウトしたり, クリーニングする時期を + より良く決めることに繋がります.</para> + </sect2> + + <sect2> + <title>統合バッファキャッシュ — + <literal>vm_object_t</literal></title> + + <para>FreeBSD は, 一般化した “VM オブジェクト” + という考え方を実装しています. VM オブジェクトは, + 様々な種類の補助記憶(backing store) — 補助記憶なし, + スワップ, 物理デバイス, ファイル, に割り付けられます. + ファイルシステムは + ファイルと関連するインコアデータを管理するのに, 同じ VM + オブジェクトを利用するため, + 統合バッファキャッシュと呼ばれます.</para> + + <para>VM オブジェクトは, <emphasis>シャドウ化</emphasis> + することができます. シャドウ化とは, + オブジェクトがそれぞれ互いの上に + スタック(stack)されるということです. 例えば, MAP_PRIVATE + mmap() の 動作を実装するために, ファイルに割り付けられた VM + オブジェクトの上にスタックされた, スワップに割り付けられた VM + オブジェクトが存在しているでしょう. このスタッキングは, fork + されたアドレス空間のための 様々な共有属性, + コピーオンライト(訳注: ページ共有のための 手法の一つ; + cow,copy-on-write) を実装するのにも利用されています.</para> + + <para><literal>vm_page_t</literal> は, 同時に一つの VM + オブジェクトしか割り付けられることが + できないことに注意しなければなりません. VM + オブジェクトのシャドウ化は, 複数のインスタンスが同じページに + 共有できるように実装されています.</para> + </sect2> + + <sect2> + <title>ファイルシステム I/O — <literal>struct + buf</literal> + </title> + + <para>補助記憶にファイルを使う VM オブジェクトのように, v + ノードを使う VM オブジェクトは通常, + 処理されているかどうかという情報を, + VMシステムが管理する処理情報から独立して + 管理される必要があります. 例えば, VM + システムが物理ページと補助記憶を同期させようとしたとき, VM + システムは, 実際に書き戻す前に, + ページがクリーニング済であるという + マークを付ける必要があるわけです. さらに, ファイルシステムは, + KVM 内で操作できるように, ファイルや, + ファイルメタデータの一部分を KVM にマッピングすることが + できなくてはなりません.</para> + + <para>これを管理するために使われる実体は, + ファイルシステムバッファ, <literal>struct buf</literal>, + <literal>bp</literal> として知られています. + ファイルシステムに VM オブジェクトの一部を操作することが + 必要となるときは通常, オブジェクトの部分が struct buf に + マッピングされ, KVM に struct buf + 内のページがマッピングされます. 同じ方法で, ディスク I/O + はオブジェクトの部分を バッファ構造体内にマッピングし, + その時バッファ構造体上の I/O を 発行することで発行されます. + 基礎となっている vm_page_t は, I/O 処理の間 + ビジー(busy)状態になります. ファイルシステムにも + 独立したビジー状態があり, それはハードウェア上の VM + ページの代わりに ファイルシステムバッファで動作する + ファイルシステムドライバのコードに とって有用です.</para> + + <para>FreeBSD は, マッピングを保持するためにある量に制限された + KVM を 予約していますが, KVM + がマッピングを保持するためだけに使われ, + キャッシュデータの能力を制限しないということは + 明確にされるべきでしょう. + 物理データキャッシュを行うことは厳密に + <literal>vm_page_t</literal> の機能になっており, + ファイルシステムバッファの機能ではありません. しかし, + ファイルシステムバッファは placehold I/O に使われるため, + それは実質的に同時処理可能な I/O 処理量を制限します. + 通常は二, 三千のファイルバッファが利用可能ですから, + このことは問題にならないでしょう.</para> + </sect2> + + <sect2> + <title>マッピングページテーブル — + <literal>vm_map_t</literal>, + <literal>vm_entry_t</literal></title> + <!-- kuriyama - Eng should use literal and mdash --> + + <para>FreeBSD は, 物理ページテーブルの形態を VM + システムと分離しています. + ハードウェア上にある全てのプロセス毎のページテーブルは, + その場その場で再構成され, 通常, 使い捨てだとみなされています. + KVM を管理するような特殊なページテーブルは, + 最初に永続的な確保が 行われ, + これらのページテーブルが破棄されることはありません. + </para> + + <para>FreeBSD は, vm_objects の部分を, + 仮想メモリのアドレス範囲に <literal>vm_map_t</literal> と + <literal>vm_entry_t</literal> 構造体を通して割り付けます. + ページテーブルは, <literal>vm_map_t</literal> + /<literal>vm_entry_t</literal>/<literal>vm_object_t</literal> + という階層から 直接つくられます. “物理ページは, + 直接一つの <literal>vm_object</literal> に + 割り付けられる” と私が述べたことを思い出して下さい. + ええと, そうですね, しかしそれはいつでも完全に当てはまる, + というわけでもないのです. <literal>vm_page_t</literal> のは, + 実際に割り付けられた ページテーブルにもリンクされています. + 一つの <literal>vm_page_t</literal> は + ページテーブルが呼ばれた時, いくつかの + <emphasis>pmaps</emphasis> と リンクされることがあります. + しかし, そのような階層的な割り付けは, 同じ + <literal>vm_page_t</literal> を参照するオブジェクト内の, + 同じページへの参照全てを保持しているため, その結果, + 常にバッファキャッシュの統合を得ることができるわけです. + </para> + </sect2> + + <sect2> + <title>KVM メモリマッピング</title> + + <para>FreeBSD は, 様々なカーネル構造体を保持するため, KVM + を利用します. ファイルシステムバッファキャッシュは, KVM + 内で最も大きなものです. それはつまり, <literal>struct + buf</literal> の実体に対するマッピングに他なりません.</para> + + <para>Linux と異なり, FreeBSD は全ての物理メモリを KVM + にマッピングしません. これは, FreeBSD が 32 + ビットプラットフォームで 4G バイトまでの メモリを扱える, + ということを意味します. 実際, MMU + がそれを可能にしているならば, 理論上, FreeBSD は 32 + ビットプラットフォームで 8TB + までのメモリを扱うことができることになります. しかし, + 大部分の 32 ビットプラットフォームは 4G バイトの RAM しか + マッピングできないようになっている, + ということには議論の余地があるでしょう. + </para> + <!-- kuriyama - This translate is difficult to understand --> + + <para>KVM は, いくつかのメカニズムによって管理されています. + 中心となっているのは, <emphasis>ゾーンアロケータ(zone + allocator)</emphasis>です. ゾーンアロケータは, + 特定の構造体型を確保するために KVM の部分(chunk)を得て, + 一定の大きさのメモリブロックに分割します. <command>vmstat + -m</command> コマンドで, ゾーンによって 分割された, 現在の + KVM 利用状況一覧を得ることができます. + </para> + </sect2> + + <sect2> + <title>FreeBSD VM システムのチューニング</title> + + <para>FreeBSD カーネルでは, + 動的に自分自身をチューニングするために, + 協調的な努力が行なわれています. 普通は, + <literal>maxusers</literal> と <literal>NMBCLUSTERS</literal> + という カーネルオプション, つまり, + <filename>/usr/src/sys/i386/conf/<replaceable>CONFIG_FILE</replaceable></filename> で 指定されるもの以外, 変更する必要はありません. 可能なカーネルオプションの一覧は, <filename>/usr/src/sys/i386/conf/LINT</filename> に 記載されています.</para> + + <para>大きなシステムに対しては, <literal>maxusers</literal> + を増やしたいと思うかも知れませんね. この値は普通, 10 から 128 + の間の値にします. + <literal>maxusers</literal> を増やしすぎるとシステムの利用可能な + KVM がオーバフローしてしまい, + 予測できない動作に陥ってしまうことに注意して下さい. + <literal>maxusers</literal> はある適度な値にとどめておいて, + 特定のリソースを制御する <literal>NMBCLUSTERS</literal> + のような, 他のオプションを増加させる方が良いでしょう. + </para> + + <para>もし, システムが負荷の高いネットワーク用途に使われるなら, + <literal>NMBCLUSTERS</literal> を増やしたいと望むことでしょう. + この値は普通, 1024 から 4096 の間です. + </para> + + <para><literal>NBUF</literal> パラメータも, + 伝統的にシステムの規模を決めるのに使われます. これは, + システムがファイルシステムバッファを I/O のために + マッピングするのに使われる, KVA + の大きさを決めるのに使われます. このパラメータは, + 統合バッファキャッシュには何の影響も与えません. これは + 3.0-RELEASE 以降のカーネルでは動的にチューニングされるため, + 普通は手作業で調整されるべきものではありません. + <literal>NBUF</literal> パラメータは, + 指定しようとしないことを推奨します. + システムに選択させれば良いのです. + 小さすぎる値は極端に非効率的なファイルシステム動作を招き, + 一方で, 大きすぎる値は wired 状態のページを数多くつくりだし, + ページキューを枯渇させてしまうでしょう.</para> + + <para>デフォルトでは, FreeBSD カーネルは最適化されていません. + カーネルコンフィグにある <literal>makeoption</literal> + ディレクティブを使って + 最適化とデバッグフラグをセットすることができます. ただし, + それによって得られる大きな (7MB + 超の)カーネルを相手にするのが嫌なら, <option>-g</option> + オプションは使ってはいけません.</para> + + <programlisting>makeoptions DEBUG="-g" +makeoptions COPTFLAGS="-O2 -pipe"</programlisting> + + <para>sysctl は, 実行時にカーネルパラメータをチューニングする + 手段を提供しています. しかし, 普通は sysctl 変数, 特に VM + に関連したものを変更する必要が + 生じるようなことはありません.</para> + + <para>実行時の VM とシステムのチューニングは, 比較的単純です. + まず, 可能ならば UFS/FFS ファイルシステムで softupdates + を使いましょう. + <filename>/usr/src/contrib/sys/softupdates/README</filename> + のファイルに, + 設定方法に関する手順(と制限)について書かれています. + </para> + + <para>次に, 十分なスワップを設定します. “作業” + ディスクを含む 各物理ディスク装置毎に一つずつ + (最大四つまで)のスワップパーティションを 設定すべきです. + 少なくとも, メインメモリの 2 倍の スワップ空間が望ましく, + メモリがあまりない場合には, + おそらくそれより多く必要になります. また, + スワップパーティションのサイズは, + 後でパーティションをつくり直しする必要がないように + マシンに設定したいメモリ設定の最大値を基準に + 決めるべきでしょう. もし, クラッシュダンプをとりたい場合, + スワップパーティションは最低限メインメモリと同じの大きさで, + <filename>/var/crash</filename> にはダンプを保持するのに十分な + 空きがなければなければなりません.</para> + + <para>NFS 経由のスワップは, -4.x + 以降のシステムで完全に動作しますが, NFS サーバ側では, + ページングがその負荷の主な原因になることに + 注意しなければなりません.</para> + </sect2> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/introduction/chapter.sgml b/ja_JP.eucJP/books/handbook/introduction/chapter.sgml new file mode 100644 index 0000000000..4d78c6bb1a --- /dev/null +++ b/ja_JP.eucJP/books/handbook/introduction/chapter.sgml @@ -0,0 +1,724 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.10 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:46:01 kuriyama Exp $ +--> + +<chapter id="introduction"> + <title>はじめに</title> + + <para>FreeBSD は, Intel アーキテクチャ (x86) ベースの PC のための + 4.4BSD-Lite をベースとしたオペレーティングシステムです. FreeBSD + の概要については, <link linkend="nutshell">FreeBSD + とは</link>をご覧ください. このプロジェクトの歴史については, + <link linkend="history">FreeBSD 小史</link> をご覧ください. + 最新のリリースについての記述は, <link + linkend="relnotes">現在のリリースについて</link>をご覧ください. + FreeBSD プロジェクトへの何らかの貢献 (ソースコード, 機器, + 資金の提供など) について興味があれば, <link + linkend="contrib">FreeBSD への貢献</link> + の章をご覧ください.</para> + + <sect1 id="nutshell"> + <title>FreeBSD とは</title> + + <para><emphasis>原作: 不明.</emphasis></para> + + <para><emphasis>訳: &a.jp.tomo;.</emphasis></para> + + <para>FreeBSDはIntel社の (SXやDXも含めた) 386や486, Pentium + プロセッサ といった CPU + アーキテクチャに基づくパーソナルコンピュータ用としては + 現在求めうる最高水準のオペレーティングシステムです. + AMD社やCyrix社のIntel互換CPUもサポートされています. FreeBSDは, + 以前は高価なコンピュータでしか利用できなかった多くの + 高度な機能を提供します. + FreeBSDには次のような機能があります:</para> + + <itemizedlist> + <listitem> + <para>アプリケーションとユーザとの間で円滑かつ公平に + コンピュータを 共有することを保証する, + 優先度を動的に調節する機能を備えた + <emphasis>プリエンプティブマルチタスキング</emphasis>.</para> + </listitem> + + <listitem> + <para>多くの人々が1つのFreeBSD + システムをさまざまな目的で同時に 使うことを可能にする + <emphasis>マルチユーザ</emphasis> アクセス. また, + プリンタやテープドライブのようなシステムの周辺機器も + すべてのユーザ間で適切に共有されます.</para> + </listitem> + + <listitem> + <para>SLIPやPPP, NFS, NISのサポートを含んだ完全な + <emphasis>TCP/IPネットワーキング</emphasis>. これによって, + FreeBSDマシンが商用サーバと同じように相互に運用でき, NFS + (リモートファイルアクセス) + や電子メールサービスのような極めて 重要な機能を提供します. + また, WWWやftp, ルーティング, ファイアウォール + (セキュリティ) サービスを用いてインターネットと + 接続できます.</para> + </listitem> + + <listitem> + <para>アプリケーション (あるいはユーザ) がお互いに干渉できない + ようにする<emphasis>メモリ保護</emphasis>機能. + アプリケーションがクラッシュしても, どのような場合でも + 他のアプリケーションには影響を与えません.</para> + </listitem> + + <listitem> + <para>FreeBSD は <emphasis>32ビット</emphasis> + のオペレーティングシステムであり, + 最初からそのようにこつこつと設計されました.</para> + </listitem> + + <listitem> + <para>業界標準である<emphasis>X Windowシステム</emphasis> + (X11R6) は, 普通のVGAカードやモニタでグラフィカルユーザ + インタフェース (GUI) を提供し, + すべてのソースコードも一緒に提供されます.</para> + </listitem> + + <listitem> + <para>SCOやBSDI, NetBSD, Linux, 386BSD用に作られた多くの + プログラムにおける<emphasis>バイナリ互換性</emphasis>.</para> + </listitem> + + <listitem> + <para>何百もの <emphasis>すぐに実行可能な</emphasis> + アプリケーションが FreeBSDの <emphasis>ports</emphasis> や + <emphasis>packages</emphasis> コレクション で利用可能です. + ここに用意されているものは + ネットを探し回る必要がありません</para> + </listitem> + + <listitem> + <para>インターネット上で入手可能な, + <emphasis>移植が容易な</emphasis> + 何千ものアプリケーションを追加できます. FreeBSD + は最も評判の よい商用の Unix + システムとソースコードレベルで互換性があります. このため, + ほとんどのアプリケーションは, もしあったとしてもほんの + 少しの変更でコンパイルすることができます.</para> + </listitem> + + <listitem> + <para>デマンドページング <emphasis>仮想メモリ</emphasis> + とそれに “付随の VM/buffer キャッシュ”の設計は, + 多くのメモリを要求する + アプリケーションに対して効率よくメモリを + 与えるようにする一方で, + 他のユーザに対しても対話的な応答を維持します.</para> + </listitem> + + <listitem> + <para><emphasis>共有ライブラリ</emphasis> + (MS-WindowsのDLLと同等のUnixの 機能) によって, + ディスクスペースとメモリを効果的に使用する + ことができます.</para> + </listitem> + + <listitem> + <para>完全な <emphasis>C</emphasis> や + <emphasis>C++</emphasis>, <emphasis>Fortran</emphasis>の + 開発ツール. 進んだ研究や開発のための多くの他の言語も + ports や packages コレクションで提供されています.</para> + </listitem> + + <listitem> + <para>システム全体の <emphasis>ソースコード</emphasis> + が提供されているので, + 要求に合わせて環境を最大限に適合させることができます. + 真のオープンシステムが利用できるのですから, + 所有権のある解決方法に 締めつけられ, + ベンダのなすがままになる必要はありません.</para> + </listitem> + + <listitem> + <para>膨大な量の + <emphasis>オンラインドキュメント</emphasis>.</para> + </listitem> + + <listitem> + <para><emphasis>もう書ききれません!</emphasis></para> + </listitem> + </itemizedlist> + + <para>FreeBSD はカリフォルニア大学バークレイ校のComputer Systems + Research Group (CSRG) による4.4BSD-Liteリリースを基にしており, + BSDシステムの開発の優れた伝統を守り続けています. + CSRGによる素晴らしい活動に加えて, + FreeBSDプロジェクトは何千時間もの時間を注ぎ込んで, + 実際の使用の場において最大の性能と信頼性を + 発揮するためにシステムのチューニングをおこなっています. + 多くの大企業がPCオペレーティングシステムの分野で + 実現しようと奮闘しているそのような機能や性能, 信頼性を + FreeBSDは<emphasis>今すぐ</emphasis>提供できます!</para> + + <para>あなたの思いつく限りのアプリケーションは, 何でもFreeBSDで + 実行できます. ソフトウェア開発から ファクトリオートメーション, + 在庫制御から遠く離れた人工衛星の アンテナの方向調整まで; + 商用UNIX製品でできることは, FreeBSDでも十分にできるのです! + また, FreeBSDは世界中の研究センターや大学によって開発される + 文字通り何千もの高品質で, たいていはほとんど無料で利用できる + アプリケーションによる恩恵を得ることができます. + 商用のアプリケーションも提供されており, + 日々増え続けています.</para> + + <para>FreeBSDのソースコードは広く提供されているので, + システムも特別なアプリケーションやプロジェクトに合わせて, + いくらでもカスタマイズすることができます. これは + 有名な商業ベンダから出ているほとんどのオペレーティング + システムでは不可能なことです. 以下に現在FreeBSDを + 使っている人々のアプリケーションの例をいくつか上げます:</para> + + <itemizedlist> + <listitem> + <para><emphasis>インターネットサービス:</emphasis> + FreeBSDに組み込まれている 頑強なTCP/IP + ネットワーキング機能は次のようなさまざまなインターネット + サービスの理想的なプラットフォームになります:</para> + + <itemizedlist> + <listitem> + <para>FTP サーバ</para> + </listitem> + + <listitem> + <para>World Wide Web サーバ</para> + </listitem> + + <listitem> + <para>Gopher サーバ</para> + </listitem> + + <listitem> + <para>電子メールサーバ</para> + </listitem> + + <listitem> + <para>USENET ニュース</para> + </listitem> + + <listitem> + <para>電子掲示板システム</para> + </listitem> + + <listitem> + <para>さらにいろいろ...</para> + </listitem> + </itemizedlist> + + <para>まずは高価ではない386クラスのPCで始めておいて, + 仕事の成長に合わせてアップグレードできます.</para> + </listitem> + + <listitem> + <para><emphasis>教育:</emphasis> + あなたは計算機科学または工学の学生ですか? + オペレーティングシステムやコンピュータアーキテクチャ, + ネットワーキングを学習するなら, FreeBSDを手に + 経験するのが一番よい方法です. 自由に利用できるCADや数学, + グラフィックデザインのパッケージもいくつもあり, + コンピュータに関心を持った人が <emphasis>他の人</emphasis> + の成果を 手に入れて利用するのにとても役に立ちます.</para> + </listitem> + + <listitem> + <para><emphasis>研究:</emphasis> + システム全体のソースコードが利用できるため, + FreeBSDはオペレーティングシステムの研究だけでなく, + 計算機科学の他の部門においても優れたプラットフォームです. + 自由に利用できるFreeBSDの特長は, オープンフォーラムで + 議論される特別なライセンスの同意や制限について + 心配することなく, 離れたグループでもアイディアや開発の共有に + よる共同研究を可能にします.</para> + </listitem> + + <listitem> + <para><emphasis>ネットワーキング:</emphasis> + 新しいルータが必要? ネームサーバ (DNS) は? + 内部のネットワークを人々から守る ファイアウォールは? + FreeBSDはすみに眠っている使われていない386や486のPCを簡単に + 洗練されたパケットフィルタリング機能を持つ高級なルータに + 変えることができます.</para> + </listitem> + + <listitem> + <para><emphasis>X Windowワークステーション:</emphasis> + 自由に利用できるXFree86サーバやX Inside社から提供される + 優れた商業サーバを使うことによって, 安価なX端末 + としてFreeBSDを使うこともできます. X端末とは違ってFreeBSDは + 多くのアプリケーションをローカルに走らせることもでき, + 中心のサーバの負荷を軽減することも可能です. + FreeBSDは“ディスクレス”でもブート可能であり, + 個々のワークステーションを安価で, 容易に管理することさえ + 可能にします.</para> + </listitem> + + <listitem> + <para><emphasis>ソフトウェア開発:</emphasis> + 基本的なFreeBSDシステムには + 有名なGNUのC/C++コンパイラやデバッガ含んだ完全な開発ツールが + ついてきます.</para> + </listitem> + </itemizedlist> + + <para>FreeBSDはCDROMまたはanonymous ftpによってソース, + バイナリとも 利用可能です. 詳しくは, <link + linkend="mirrors">FreeBSD の入手方法</link> + を見てください.</para> + </sect1> + + <sect1 id="history"> + <title>FreeBSD 小史</title> + + <para><emphasis>原作: &a.jkh;</emphasis>.</para> + + <para><emphasis>訳: &a.jp.masaki;, &a.jp.hino;. + <!-- <br> -->19 December 1996.</emphasis></para> + + <para>FreeBSD プロジェクトは 1993年の始めに “Unofficial + 386BSD Patchkit” の最後の 3人のまとめ役によって, 部分的に + patchkit から派生する形で開始 されました. ここでの + 3人のまとめ役というのは, Nate Williams と, Rod Grimes と, 私 + (Jordan K. Hubbard) です.</para> + + <para>私たちのもともとの目標は, patchkit + という仕組みではもう十分に解 決できなくなってしまった 386BSD + の数多くの問題を修正するための, 386BSD + の暫定的なスナップショットを作成することでした. + こういった経緯を経てい るので, + このプロジェクトの初期の頃の名前が “ 386BSD 0.5 ” や + “386BSD 暫定版 (Interim)” + であったということを覚えている人もいるでしょう.</para> + + <para>386BSD は, Bill Jolitz が (訳注: バークレイ Net/2 + テープを基に) 作成し たオペレーティングシステムです. 当時の + 386BSD は, ほぼ一年にわたって放っ ておかれていた (訳注: + 作者がバグの報告を受けても何もしなかった) という + ひどい状況に苦しんでいました. + 作者の代わりに問題を修正し続けていた patchkit + は日を追うごとに不快なまでに膨張してしまっていました. このよ + うな状況に対して, このままではいけない, + 何か行動を起こさなければ, とい + うことで異議を唱えるものは私たちのなかにはいませんでした. + そして私たち は挑戦することを決断し, + 暫定的な“クリーンアップ”スナップショットを作 + 成することで Bill を手助けしようと決めたのです. しかし, + この計画は唐突 に終了してしまいました. Bill Jolitz が, + このプロジェクトに対する受け + 入れ支持を取り下げることを突然決意し, + なおかつこのプロジェクトの代わり + に何をするのかを一切言明しなかったのです.</para> + + <para>たとえ Bill が支持してくれないとしても, + われわれの目標には依然としてや + る価値があると決心するのにさしたる時間はかかりませんでした. + そこで David Greenman が考案した名称 “FreeBSD” + を私たちのプロジェクトの名前 に採用し, + 新たなスタートを切りました. この時点でのプロジェクトの初期目 + 標は, すでにこのシステム (訳注: 386BSD + Patchkit) + を使っていた利用者 たちと相談して決められました. + プロジェクトが実現に向けて軌道に乗ってき + たことが明確になった時点で, 私は Walnut Creek CDROM + 社に連絡してみまし た. CDROM を使って FreeBSD + を配布することによって, インターネットに容 + 易に接続できない多くの人々が FreeBSD + を簡単に入手できるようになると考 えたからです. Walnut Creek + CDROM 社は FreeBSD を CD で配布するというア + イデアを採用してくれたばかりか, + 作業するためのマシンと高速なインターネッ + ト回線を私たちのプロジェクトに提供してくれました. + 当時は海のものとも山 + のものともわからなかった私たちのプロジェクトに対して, Walnut + Creek CDROM 社が信じられないほどの信頼を寄せてくれたおかげで, + FreeBSD は短期 間のうちにここまで大きく成長したのです.</para> + + <para>CDROM による最初の配布 (そしてネットでの, + ベータ版ではない最初の一般向 け配布) は FreeBSD 1.0 で, 1993年 + 12月に公開されました. これは カリフォ ルニア大学バークレイ校の + 4.3BSD-Lite (“Net/2”) を基とし, 386BSD や Free + Software Foundation からも多くの部分を取り入れたものです. これは + 初めて公開したものとしては十分に成功しました. 続けて 1994年 + 5月に FreeBSD 1.1 を公開し, + 非常に大きな成功を収めました.</para> + + <para>この時期, + あまり予想していなかった嵐が遠くから接近してきていました. バー + クレイ Net/2 テープの法的な位置づけについて, Novell 社と + カリフォルニア大学バークレイ校との間の長期にわたる + 法廷論争において和解が成立したの です. 和解の内容は, Net/2 + のかなりの部分が“権利つき (encumbered)”コー + ドであり, それは Novell 社の所有物である, + というバークレイ校側が譲歩し たものでした. なお, Novell + 社はこれらの権利を裁判が始まる少し前に AT&T + 社から買収していました. 和解における譲歩の見返りにバークレイ + 校が得たのは, 4.4BSD-Lite が最終的に発表された時点で, + 4.4BSD-Lite は権 利つきではないと公式に宣言されること, + そしてすべての既存の Net/2 の利 用者が 4.4BSD-Lite + の利用へと移行することが強く奨励されること, という Novell + 社からの“ありがたき天からの恵み”でした. (訳注: + 4.4BSD-Lite は その後 Novell + 社のチェックを受けてから公開された.) FreeBSD も Net/2 を利 + 用していましたから, 1994年の 7月の終わりまでに Net/2 ベースの + FreeBSD の出荷を停止するように言われました. ただし, + このときの合意によって, 私 + たちは締め切りまでに一回だけ最後の公開をすることを許されました. + そして それは FreeBSD 1.1.5.1 となりました.</para> + + <para>それから FreeBSD プロジェクトは, まっさらでかなり不完全な + 4.4BSD-Lite を基に, 文字どおり一から再度作り直すという, + 難しくて大変な作業の準備を始めまし た. “Lite” + バージョンは, 部分的には本当に軽くて, 中身がなかったので す. + 起動し, + 動作できるシステムを実際に作り上げるために必要となるプログ + ラムコードのかなりの部分がバークレイ校 の CSRG (訳注: + BSDを作っている グループ) によって (いろいろな法的要求のせいで) + 削除されてしまっていた ということと, 4.4BSD の Intel + アーキテクチャ対応が元々かなり不完全であっ + たということがその理由です. この移行作業は結局 1994年の + 12月までかかり ました. そして 1995年の 1月に FreeBSD 2.0 + をネットと CDROM を通じて公 開しました. これは, + かなり粗削りなところが残っていたにもかかわらず, か + なりの成功を収めました. そしてその後に, より信頼性が高く, + そしてインス トールが簡単になった FreeBSD 2.0.5 が 1995年の + 6月に公開されました.</para> + + <para>私たちは 1996年の 8月に FreeBSD 2.1.5 を公開しました. + この出来が非常に 良く, 特に業務で運用しているサイトや ISP + での人気が高かったので, 私た ちは 2.1-STABLE + 開発分流から更に公開をおこなうことにメリットがあると考 えました. + それが FreeBSD 2.1.7.1 で, 2.1-STABLE 開発分流の最後を締めく + くるものとして, 1997年の 2月に公開されました. 2.1-STABLE + 開発分流 (RELENG_2_1_0) は現在, + 保守のみをおこなう状態になっており, 今後は, セ + キュリティの改善や他の何か重要なバグフィックスのみが + おこなわれるでしょ う.</para> + + <para>FreeBSD 2.2 の開発は, RELENG_2_2 開発分流として, 開発の本流 + (“-current”) から 1996年 11月に分岐し, そして 1997年 + 4月に最初の公開 (2.2.1) がおこなわれました. 2.2 + 開発分流からはさらに 97 年の夏と秋に公 開がおこなわれ, 98 年 7 + 月の終わりには最新版の 2.2.7 が登場しました. FreeBSD 3.0 + の初めての公式なリリースが 1998 年 10 月上旬に登場し, 2.2 + 開発分流からの最後のリリースである 2.2.8 が 1998 年 11 + 月に登場しまし た.</para> + + <para>1999 年 1 月 20 日には, FreeBSD + の開発ツリーが再び分岐しました. 4.0-current と 3.x-stable + の分流です. 3.x-stable からは 3.1 が 1999 年 2 月 15 + 日にリリースされる予定です.</para> + + <para>長期的な開発プロジェクトは 4.0-current 開発分流で続けられ, + スナップショットの CDROM (もちろん, ネットワーク上でも) + で公開されます.</para> + </sect1> + + <sect1 id="goals"> + <title>FreeBSDプロジェクトの目的</title> + + <para><emphasis>原作: &a.jkh;</emphasis></para> + + <para><emphasis>訳: &a.jp.kiroh; + <!-- <br> -->24 September 1996.</emphasis></para> + + <para>FreeBSD + プロジェクトの目的は, いかなる用途にも使用でき, 何ら制限のない + ソフトウェアを供給することです. + 私たちの多くは, コード(そしてプロジェ + クト)に対してかなりの投資をしてきており, + これからも多少の無駄はあって も投資を続けて行くつもりです. ただ, + 他の人達にも同じような負担をするよ + うに主張しているわけではありません. FreeBSD + に興味を持っている一人の残 らず全ての人々に, + 目的を限定しないでコードを提供すること. これが, + 私たちの最初のそして最大の “任務” + であると信じています. そうすれば, コード は可能な限り広く使われ, + 最大の恩恵をもたらすことができるでしょう. これ + が, 私たちが熱烈に支持しているフリーソフトウェアの + 最も基本的な目的であ ると, 私は信じています.</para> + + <para>私たちのソースツリーに含まれるソースのうち, + GNU一般公有使用許諾(GPL)ま + たはGNUライブラリ一般公有使用許諾(GLPL) + に従っているものについては, 多 少制限が科されています. ただし, + ソースコードへのアクセスの保証という, + 一般の制限とはいわば逆の制限(訳注1)です. + ただしGPLソフトウェアを商用で + 利用する場合, さらに複雑になるのは避けられません. + そのため, それらのソ フトウェアを, より制限の少ない BSD + 著作権に従ったソフトウェアで置き換え + る努力を, 可能な限り日々続けています.</para> + + <para>(訳注1) GPL では, 「ソースコードを実際に受け取るか, + あるいは, 希望しさ えすればそれを入手することが可能であること」 + を求めています.</para> + </sect1> + + <sect1 id="development"> + <title>FreeBSDの開発モデル</title> + + <para><emphasis>原作: &a.asami;.<!-- <br> --> + 18 October 1996.</emphasis></para> + + <para><emphasis>訳: &a.asami;.<!-- <br> --> + 31 October 1996.</emphasis></para> + + <para>FreeBSD の開発は非常に開かれた, 柔軟性のあるプロセスです. + <link linkend="staff"> コントリビュータのリスト + </link>を見ていただければわかる とおり, + FreeBSDは文字通り世界中の何百という人々の努力によって開発され + ています. 新しい開発者はいつでも大歓迎ですので, &a.hackers; + にメールを 送ってください. また, + 大勢で議論するよりは一人で静かに開発にふけりた + いという人は私たちのFTPサイト <ulink + URL="ftp://ftp.freebsd.org/pub/FreeBSD/incoming"> + ftp.freebsd.org</ulink> + を使ってパッチや開発中のソースを公開してくださっ て結構です. + &a.announce; もありますので, 他のFreeBSDユーザに自分のやっ + ていることを宣伝したい時にはどうぞ使ってください.</para> + + <para>あと, FreeBSD プロジェクトとその開発プロセスについて, + どなたにも知って + いていただきたいのは以下のようなことです.</para> + + <variablelist> + <varlistentry><term>CVSリポジトリ + <anchor id="development-cvs-repository"></term> + <listitem> + <para>FreeBSDのソースツリーは <ulink + URL="http://www.cyclic.com/cyclic-pages/CVS-sheet.html"> + CVS </ulink> (Concurrent Versions System) + によってメンテナンスされています. CVSはソー + スコード管理用のフリーソフトウェアで, + FreeBSDのリリースにも含まれてい ます. FreeBSD の <ulink + URL="http://www.freebsd.org/cgi/cvsweb"> メインの CVS + リポジトリ </ulink> + は米国カリフォルニア州のコンコルド市に存在 し, + そこから世界中のたくさんのミラーサイトに + コピーされています. CVSツ リーそのもの, + そしてそのチェックアウトされたバージョンである<link + linkend="current">-current</link>と<link + linkend="stable">-stable</link>はあな + たのマシンにも簡単に取ってくることができます. + これについては <link linkend="synching"> + ソースツリーの同期 </link> の章をご覧ください.</para> + </listitem> + </varlistentry> + + <varlistentry><term>ソースツリー管理者 + <anchor id="development-committers"></term> + <listitem> + <para><link linkend="staff-committers"> + ソースツリー管理者</link>はCVSツリー + への書き込み権限を持っている人, + つまりFreeBSDのソースに変更を加えるこ とができる人です. + (CVSでリポジトリに変更を加えるには &man.cvs.1; + <command>commit</command> というコマンドを使うので, + これらの人々は英語では “committers” + と呼ばれます.) 開発者にコードを送って見てもらうのに一 + 番いい方法は &man.send-pr.1; コマンドを使うことです. もし, + 何か問題があって <emphasis remap=tt>send-pr</emphasis> + が使えないなら<email>committers@freebsd.org</email>にメー + <!-- kuriyama - remap=tt? --> + ルを送っていただいても結構です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>FreeBSDコアチーム + <anchor id="development-core"></term> + <listitem> + <para><link linkend="staff-core">FreeBSD + コアチーム</link>はFreeBSDプロジェク + トが会社だとすると取締役会にあたるものです. + コアチームとして一番重要 な役割は FreeBSD + プロジェクトが全体としてよい方向に向かっていることを確 + 認することです. + 責任感あふれる開発者を上記のソースツリー管理者として + 招くこと, また仕事上の都合などでコアチームを + やめた人たちの後任を見つけ ることもコアチームの役割です. + 現在のコアチームのほとんどは最初は単な + る一開発者としてプロジェクトに関わりはじめ, + ずるずるといつのまにか深み + にはまってしまった人です.</para> + + <para>コアチームのうち何人かは特定の <link + linkend="staff-who">担当分野</link> を持っており, + システムのうち一部に特に重点をおいて + 面倒を見ています.</para> + + <note> + <para>忘れてほしくないのはコアチームのほとんどは FreeBSD + についてはボラ ンティアであり, FreeBSD + プロジェクトからは何ら金銭的な支援を受けていな + いということです. ですから, ここでの “責任” + は “保証されたサポート” ではありません. + そういう意味で, + 上記の“取締役会”という例えはあまりよく + ないかもしれません. むしろ, + FreeBSDのために人生を棒に振ってしまった人 + の集まりといった方が正しいかも.... <!-- smiley + --><emphasis>;)</emphasis></para> + </note> + </listitem> + </varlistentry> + + <varlistentry><term>その他のコントリビュータ</term> + <listitem> + <para>最後になりますが, + もっとも重要で多数をしめる開発者はフィードバック + やバグフィクスをどんどん送ってくれるユーザ自身です. + FreeBSDの開発に外 郭から関わっていきたいという人は + &a.hackers; (<link linkend="eresources-mail"> + メーリングリスト情報 </link> を見てください) + に参加するといいでしょう.</para> + + <para>FreeBSD + のソースツリーに入っている何かを書いた人の<link + linkend="contrib-additional"> リスト </link> + は日に日に長くなっています. あ なたも今日, + 何か送ることからはじめてみませんか? <!-- smiley + --><emphasis>:-)</emphasis></para> + + <para>もちろんFreeBSD + に貢献するにはコードを書くほかにもいろいろな方法があ + ります. 助けが求められている分野については, + このハンドブックの <link linkend="contrib"> 貢献の仕方 + </link> の節を見てください.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>ひとことで言うと, FreeBSD + の開発組織はゆるやかな同心円状になっています. + ともすると中央集権的に見えがちなこの組織は, + FreeBSDの<emphasis>ユーザ</emphasis>が + きちんと管理されたコードベースを + 容易に追いかけられるようにデザインされ ているもので, + 貢献したいという人を締め出す意図は全くありません! 私た + ちの目標は安定したオペレーティングシステムと + 簡単にインストールして使う ことのできる<link + linkend="ports">アプリケーション</link>を提供することであ り, + この方法は結構うまくはたらくのです.</para> + + <para>これからFreeBSDの開発にたずさわろうという人に, + 私たちが望むことはただ 一つです: + FreeBSDの成功を継続的なものにするために, 現在の開発者と同じ + ような情熱を持って接してください!</para> + </sect1> + + <sect1 id="relnotes"> + <title>現在のリリースについて</title> + + <para>FreeBSD は自由に利用でき Intel + i386/i486/Pentium/PentiumPro/Pentium II (とその互換 CPU) の + PCで動作する, 4.4BSD-Lite ベースの全ソー スつきのリリースです. + これはもともとカリフォルニア大学バーク レイ校 + CSRGグループのソフトウェアがベースとなっており, NetBSD, OpenBSD, + 386BSD, そして Free Software Foundation の + ソフトウェアなどにより拡張されています.</para> + + <para>95年1月の FreeBSD 2.0 のリリースからみると, FreeBSD は性能, + 機能, 安定性の面で劇的に改善されました. + もっとも大きな変化は仮想メモリシステムに おける改良で, + 統合化された VM/file バッファキャッシュを用いる + ことで性能を向上させながらも FreeBSD + のメモリの使用量を減らすことが できたことです. おかげで, 最低 + 5MB メモリという制約上でも動作する ようになりました. + その他の拡張としては NIS のクライアントとサーバの 完全サポート, + トランザクション TCP のサポート, ダイヤルオンデマンド PPP, 改良 + SCSI サブシステム, ISDN の初期サポート, FDDI や Fast Ethernet + (100Mbps) などのサポート, Adaptec 2940 (WIDE と narrow) + のサポートの改良と数百件のバグの修正, などがあります.</para> + + <para>私たちはたくさんのユーザからのコメントや + 提案をまじめに受け取り, 私たちが正しいと考え, + かつ導入の手順が分かりやすいものを提供しようと 努力しています. + この (継続的に進化する) プロセスに対するあなたの意見を + 心からお待ちしています.</para> + + <para>FreeBSD では基本配布セットに加え, 移植されたソフトウェア集 + として 数百の人気の高いプログラムを提供しています. 98年8月 + 下旬の時点で 1700 以上の ports (移植ソフトウェア) が存在します. + ports には http (WWW) サーバから, ゲーム, 言語, + エディタまでありとあらゆるものが含まれています. + portsはオリジナル + ソースに対する“差分”という形で表現されており, + すべての portsを 集めても 26MB程度にしかなりません. + こうすることで ports の更新を 容易にし, + portsに必要なディスクスペースを小さくすることができます. + portsをコンパイルするには, + インストールしたいと思っているプログラムの ディレクトリに移動し, + <command>make all</command> と実行してコンパイルが成 功したら, + <command>make install</command> とすると, あとはすべてシステムが + やってくれます. どの portsもオリジナルの配布セットを動的に + CDROM または近くの FTP サーバから取ってくるので, ディスクは + 構築したいと思っている portsの分だけを準備しておけば十分です. + ほとんどの portsは, すでにコンパイルされた状態で + “package” として提供されており, + ソースコードからコンパイルしたくない場 合, これを使うと (pkg_add + というコマンドで) 簡単にインストー ルできます.</para> + + <para>FreeBSD 2.1 以降のマシンであれば, + <filename>/usr/share/doc</filename> + ディレクトリにインストールの手順や FreeBSD を利用する上で有用な + ドキュメントがたくさんあります. + これらのローカルにインストールされたドキュメントは, HTML + ブラウザを使って, 以下の URL から 参照することができます.</para> + + <variablelist> + <varlistentry><term>FreeBSD ハンドブック (英文オリジナル)</term> + <listitem> + <para><ulink URL="file:/usr/share/doc/handbook/handbook.html">file:/usr/share/doc/handbook/handbook.html</ulink></para> + </listitem> + </varlistentry> + + <varlistentry><term>FreeBSD に関する FAQ</term> + <listitem> + <para><ulink URL="file:/usr/share/doc/FAQ/FAQ.html">file:/usr/share/doc/FAQ/FAQ.html</ulink></para> + </listitem> + </varlistentry> + </variablelist> + + <para>また, <ulink + URL="http://www.freebsd.org">http://www.freebsd.org</ulink> + にはマスタ (かなり頻繁に更新されます) がありますので, + こちらも参照してください.</para> + + <para>合衆国の輸出規制のため, FreeBSD のコア配布セットには DES + のコードは 含まれていません. 合衆国国内に限り, DES + を使うプログラムなどが, + コア配布セットに加えるパッケージとして提供されています. + 誰でも使えるパッケージは, 別途, 合衆国国外で提供されています. + 合衆国国外からも自由に取得可能な DES の配布セットに関する + 詳細は, <ulink URL="../FAQ/FAQ.html">FreeBSD FAQ</ulink> + にあります.</para> + + <para>FreeBSD 上で必要とされるセキュリティがパスワードだけであり, + Sun や DEC + などの別のホストから暗号化されたパスワードをコピーする必要が + ないのであれば, FreeBSD の MD5 ベースのセキュリティで十分です. + この標準のセキュリティモデルは DES + よりも適していると私たちは思って いますし, また, + やっかいな輸出規制にもひっかかることはありません. + あなたが合衆国国外にいるなら (あるいは国内にいても) + 一度試してみて ください!</para> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/jauthors.ent b/ja_JP.eucJP/books/handbook/jauthors.ent new file mode 100644 index 0000000000..cfe025cb9e --- /dev/null +++ b/ja_JP.eucJP/books/handbook/jauthors.ent @@ -0,0 +1,82 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: + $Id: jauthors.ent,v 1.1.1.1 1999-04-08 15:45:57 kuriyama Exp $ + + Names and email address of Japanese local contributing authors and + jaz.jp.freebsd.org CVS committers. + Entity names for committers on jaz should be the same as their login + names on jaz.jp.FreeBSD.ORG. + + Use these entities when referencing people. + + Please keep this list in alphabetical order by entity names. +--> + +<!ENTITY a.jp.arimura "有村 光晴 <email>arimura@jp.FreeBSD.org</email>"> + +<!ENTITY a.jp.candy "神田敏広 <email>candy@fct.kgc.co.jp</email>"> + +<!ENTITY a.jp.condle "森 直之 <email>condle@mcu.or.jp</email>"> + +<!ENTITY a.jp.g92k0323 "狩野 宏樹 <email>g92k0323@cfi.waseda.ac.jp</email>"> + +<!ENTITY a.jp.graphite "石墨 紀孝 <email>graphite@jp.FreeBSD.org</email>"> + +<!ENTITY a.jp.hino "日野 浩志 <email>hino@ccm.cl.nec.co.jp</email>"> + +<!ENTITY a.jp.ikuo "中川 郁夫 <email>ikuo@jp.FreeBSD.org</email>"> + +<!ENTITY a.jp.iwasaki "岩崎 満 <email>iwasaki@jp.FreeBSD.ORG</email>"> + +<!ENTITY a.jp.katsu "勝間田 淳 <email>katsu@baum.kiyose.tokyo.jp</email>"> + +<!ENTITY a.jp.kimura "木村 成伴 <email>kimura@netlab.is.tsukuba.ac.jp</email>"> + +<!ENTITY a.jp.kiroh "はらだ きろう <email>kiroh@jp.FreeBSD.org</email>"> + +<!ENTITY a.jp.kmiyakoda "都田 克郎 <email>kmiyakoda@ctn.co.jp</email>"> + +<!ENTITY a.jp.masaki "櫛田 昌希 <email>masaki@po.iijnet.or.jp</email>"> + +<!ENTITY a.jp.mihoko "田中 美穂子 <email>Mihoko_Tanaka@yokogawa.co.jp</email>"> + +<!ENTITY a.jp.mita "三田 吉郎 <email>mita@jp.FreeBSD.ORG</email>"> + +<!ENTITY a.jp.miyasita "宮下健輔 <email>miyasita@hashilab.ee.ous.ac.jp</email>"> + +<!-- +<!ENTITY a.jp.motoyuki "今野 元之 <email>motoyuki@jp.FreeBSD.org</email>"> +authors.sgml に入っているのでコメントアウト +--> + +<!ENTITY a.jp.mrt "むらたしゅういちろう <email>mrt@mickey.ai.kyutech.ac.jp</email>"> + +<!ENTITY a.jp.nakai "中井 幸博 <email>nakai@mlab.t.u-tokyo.ac.jp</email>"> + +<!ENTITY a.jp.nao "浜田 直樹 <email>nao@tom-yam.or.jp</email>"> + +<!ENTITY a.jp.saeki "佐伯 隆司 <email>saeki@jp.FreeBSD.org</email>"> + +<!ENTITY a.jp.shou "広瀬 昌一 <email>shou@kt.rim.or.jp</email>"> + +<!ENTITY a.jp.simokawa "下川 英敏 <email>simokawa@jp.FreeBSD.org</email>"> + +<!ENTITY a.jp.sugimura "杉村 貴士 <email>taka-su@is.aist-nara.ac.jp</email>"> + +<!ENTITY a.jp.tmaruya "丸山 剛司 <email>tmaruya@nnc.or.jp</email>"> + +<!ENTITY a.jp.tomo "渡辺 智雄 <email>tomo@jp.FreeBSD.ORG</email>"> + +<!ENTITY a.jp.ts "冨田 重成 <email>ts@icu.ac.jp</email>"> + +<!ENTITY a.jp.y-koga "こがよういちろう <email>y-koga@ccs.mt.nec.co.jp</email>"> + +<!ENTITY a.jp.yasu "鈴木 康修 <email>yasu@hike.te.chiba-u.ac.jp</email>"> + +<!ENTITY a.jp.yoshiaki "内川 喜章 <email>yoshiaki@kt.rim.or.jp</email>"> + +<!ENTITY a.jp.yuki "前田 幸範 <email>yuki@jp.FreeBSD.org</email>"> + diff --git a/ja_JP.eucJP/books/handbook/jcontrib/chapter.sgml b/ja_JP.eucJP/books/handbook/jcontrib/chapter.sgml new file mode 100644 index 0000000000..c43843a7d1 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/jcontrib/chapter.sgml @@ -0,0 +1,247 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:58 kuriyama Exp $ +--> + +<chapter id="jcontrib"> + <title>FreeBSD Handbook 日本語化について</title> + + <para>FreeBSD 日本語ドキュメンテーションプロジェクトは, FreeBSD + 関係の日本語 ドキュメントが少ないことを嘆いた数人の FreeBSD + ユーザの提唱によって 1996年2月26日にスタートし, + その最初の作業として, FreeBSD Handbook + の日本語への翻訳を始めました. + 当初の予定から大幅に遅れながらもなんとか + 完成することができましたが, これで終りではありません. オリジナルの + FreeBSD Handbook は日毎に更新されており, 私たちもまた + これに追い付くために作業を続けていきます. もちろん, + 新しいメンバも大歓迎 です. 日本語翻訳版について, + 何かお気づきの点がありましたら, FreeBSD + 日本語ドキュメンテーションプロジェクト <!-- kuriyama - should go + to jauthors.ent? --> <emphasis + remap=tt><email>doc-jp@jp.FreeBSD.ORG</email></emphasis> + までご連絡ください. また, もし私たちの作業を手伝ってくれるなら, + <ulink URL="http://www.jp.FreeBSD.ORG/doc-jp/">FreeBSD + 日本語ドキュメンテーションプロジェクトのページ + </ulink>をご覧の上, 是非参加してください.</para> + + <sect1> + <title>翻訳者 (五十音順)</title> + + <itemizedlist> + <listitem> + <para>&a.asami;</para> + </listitem> + + <listitem> + <para>&a.jp.arimura;</para> + </listitem> + + <listitem> + <para>&a.jp.graphite;</para> + </listitem> + + <listitem> + <para>&a.jp.iwasaki;</para> + </listitem> + + <listitem> + <para>&a.jp.yoshiaki;</para> + </listitem> + + <listitem> + <para>&a.jp.candy;</para> + </listitem> + + <listitem> + <para>&a.jp.kimura;</para> + </listitem> + + <listitem> + <para>&a.jp.y-koga;</para> + </listitem> + + <listitem> + <para>&a.jp.masaki;</para> + </listitem> + + <listitem> + <para>&a.motoyuki;</para> + </listitem> + + <listitem> + <para>&a.jp.saeki;</para> + </listitem> + + <listitem> + <para>&a.jp.simokawa;</para> + </listitem> + + <listitem> + <para>&a.jp.sugimura;</para> + </listitem> + + <listitem> + <para>&a.jp.yasu;</para> + </listitem> + + <listitem> + <para>&a.jp.mihoko;</para> + </listitem> + + <listitem> + <para>&a.jp.ts;</para> + </listitem> + + <listitem> + <para>&a.jp.nakai;</para> + </listitem> + + <listitem> + <para>&a.jp.ikuo;</para> + </listitem> + + <listitem> + <para>&a.max;</para> + </listitem> + + <listitem> + <para>&a.hanai;</para> + </listitem> + + <listitem> + <para>&a.jp.kiroh;</para> + </listitem> + + <listitem> + <para>&a.jp.hino;</para> + </listitem> + + <listitem> + <para>&a.jp.shou;</para> + </listitem> + + <listitem> + <para>&a.jp.yuki;</para> + </listitem> + + <listitem> + <para>&a.jp.tmaruya;</para> + </listitem> + + <listitem> + <para>&a.jp.mita;</para> + </listitem> + + <listitem> + <para>&a.jp.kmiyakoda;</para> + </listitem> + + <listitem> + <para>&a.jp.miyasita;</para> + </listitem> + + <listitem> + <para>&a.jp.condle;</para> + </listitem> + + <listitem> + <para>&a.jp.tomo;</para> + </listitem> + </itemizedlist> + </sect1> + + <sect1> + <title>査読者 (五十音順)</title> + + <itemizedlist> + <listitem> + <para>&a.asami;</para> + </listitem> + + <listitem> + <para>&a.jp.iwasaki;</para> + </listitem> + + <listitem> + <para>&a.jp.yoshiaki;</para> + </listitem> + + <listitem> + <para>&a.jp.g92k0323;</para> + </listitem> + + <listitem> + <para>&a.jp.y-koga;</para> + </listitem> + + <listitem> + <para>&a.jp.saeki;</para> + </listitem> + + <listitem> + <para>&a.jp.sugimura;</para> + </listitem> + + <listitem> + <para>&a.max;</para> + </listitem> + + <listitem> + <para>&a.hanai;</para> + </listitem> + + <listitem> + <para>&a.jp.nao;</para> + </listitem> + + <listitem> + <para>&a.jp.kiroh;</para> + </listitem> + + <listitem> + <para>&a.jp.hino;</para> + </listitem> + + <listitem> + <para>&a.jp.shou;</para> + </listitem> + + <listitem> + <para>&a.jp.yuki;</para> + </listitem> + + <listitem> + <para>&a.jp.mrt;</para> + </listitem> + </itemizedlist> + </sect1> + + <sect1> + <title>ツール作成者</title> + + <itemizedlist> + <listitem> + <para>&a.jp.katsu;</para> + </listitem> + + <listitem> + <para>&a.jp.iwasaki;</para> + </listitem> + </itemizedlist> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/kernelconfig/chapter.sgml b/ja_JP.eucJP/books/handbook/kernelconfig/chapter.sgml new file mode 100644 index 0000000000..4ab47cf1bc --- /dev/null +++ b/ja_JP.eucJP/books/handbook/kernelconfig/chapter.sgml @@ -0,0 +1,1698 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.14 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:46:01 kuriyama Exp $ +--> + +<chapter id="kernelconfig"> + <title>FreeBSDカーネルのコンフィグレーション</title> + + <para><emphasis>原作: &a.jehamby;. + <!-- <br> -->6 October 1995.</emphasis></para> + + <para><emphasis>訳: &a.jp.tomo;, &a.jp.yoshiaki;. + <!-- <br> -->2 November 1996. </emphasis></para> + + <para>この章はシステムに合わせたカーネルの再構築の基礎について + 述べたものです. この章は, システム管理の初心者から Unix + システム管理に十分な経験を積んだ人までを対象としています.</para> + + <sect1> + <title>なぜカスタムカーネルを作るか?</title> + + <para>システムに合わせたカーネルの構築はすべての + Unixシステム管理者が + 避けて通ることのできない最も重要な通過儀礼の1つです. + この作業は, 多くの時間を必要としますが, あなたの FreeBSD + システムに多くの利益をもたらします. + <literal>GENERIC</literal>カーネルは, + めったに使われることのないハードウェアをサポートするとともに, + 考えられるすべての SCSIカードやネットワークカードをサポート + しなければなりませんが, システムに合わせたカーネルは + <emphasis>あなたの</emphasis> PC + のハードウェアのみをサポートします. これは, + 次にあげるような利益をもたらします.</para> + + <itemizedlist> + <listitem> + <para>あなたが持っていない + ハードウェアについては検出をおこなわな いので, + ブートにかかる時間が短くなります.</para> + </listitem> + + <listitem> + <para>システムに合わせたカーネルは多くの場合メモリ使用量が + 減ります. カーネルはいつもメモリ上に存在するので, + 不必要なコードがあると本来プログラムが利用できるはずの RAM + (実メモリ) を占めてしまいますのでこれは重要なことだ + といえます. したがって, メモリが少ないシステムでは, + カーネルの再構築は大変重要です.</para> + </listitem> + + <listitem> + <para>必要に応じていくつかのカーネルオプションは調整すること + ができ, またサウンドカードのような GENERICカーネルには + <emphasis>ない</emphasis> + デバイスドライバをカーネルに含めることが できます.</para> + </listitem> + </itemizedlist> + </sect1> + + <sect1 id="kernelconfig-building"> + <title>カスタムカーネルの構築とインストール</title> + + <para>まず, + カーネル再構築に必要なディレクトリをざっと見てみましょう. + ここではディレクトリはすべて + <filename>/usr/src/sys</filename>以下の相対位 置で示します. + また, <filename>/sys</filename>からもアクセス可能です. + ここには, カーネルの各部分を構成するサブディレクトリが + いくつもあります. しかし, 私たちの目的では 最も重要なのは + <filename>i386/conf</filename>です. ここで, あなたの + システムに合わせてカーネル コンフィグレーションを編集します. + それから <filename>compile</filename>ディレクトリ, + ここはカーネルが作られる 場所です. + サポートされているデバイスやファイルシステムのディレ + クトリツリーがオプション毎にサブディレクトリに分かれている論理 + 的構成に注意してください. また, + <filename>i386</filename>のディレクトリは + PCのハードウェアのみを扱い, + <filename>i386</filename>以外のディレクトリは + FreeBSDが他のプラットフォームに移植される際には共有されるコー + ドです.</para> + + <note> + <para>もし, あなたのシステムに<filename>/usr/src/sys</filename> + 以下のディレクトリが<emphasis>なければ</emphasis>, + カーネルのソースが インストールされていません. + もっとも簡単な方法は (<username>root</username>で) + <command>/stand/sysinstall</command> + を用いて以下のようにします. <literal>設定(Configure)</literal> + を選んでから <literal>配布ファイル(Distribution)</literal> + を選択し, <literal>src</literal> の中の <literal>sys</literal> + をインストールしてください. + </para> + </note> + + <para>つぎに, <filename>i386/conf</filename>に移動して, + <filename>GENERIC</filename> + コンフィグレーションファイルをカーネルに与えたい名前に + コピーしてください. たとえば:</para> + + <screen>&prompt.root; <userinput>cd /usr/src/sys/i386/conf</userinput> +&prompt.root; <userinput>cp GENERIC MYKERNEL</userinput></screen> + + <para>慣習として, この名前はすべて大文字でつづられます. もし, + いくつかの異なるハードウェアの FreeBSDマシンを扱うなら, + この名前にホスト名を含めるとよいでしょう. ここでは, 例として + <filename>MYKERNEL</filename> と呼ぶことにします.</para> + + <note> + <para>この作業は root権限でおこなう必要があります. + そうでなければ, <errortype>permission + denied</errortype>というエラーが出ます.</para> + </note> + + <para>では, <filename>MYKERNEL</filename> + をあなたの好きなエディタで編集してください. もし, + システムをインストールしたばかりならば, 利用できる エディタは + <command>vi</command>だけかもしれません. ここでは使い方 + の説明はしませんが, <link linkend="bibliography">参考図書</link> + にあるような多くの本で詳しく説明 されていますので, + そちらを参照してください. + まずファイルの最初の方のコメント行を編集し, あなたのコンフィグ + レーションに合せて変更した点などを記述して + <filename>GENERIC</filename> と区別がつく + ようにしておきましょう.</para> + + <para>もし SunOSや他の BSDオペレーティングシステムでカーネルの + 再構築をしたことがあれば, このファイルはとても親しみ + やすいでしょう. しかし, DOSのようなその他の + オペレーティングシステムしか知らない人から見れば, + <filename>GENERIC</filename> + コンフィグレーションファイルはとても + なじみにくいものかもしれません. そのような場合は, <link + linkend="kernelconfig-config"> コンフィグレーションファイル + </link> の節をゆっくりと注意深く読んでください.</para> + + <note> + <para>古いバージョンの FreeBSD からアップグレードを + おこなう場合, + 新しいカーネルソースを得た場所より新しいバージョンの + &man.config.8; を取ってくる必要があるかもしれません. これは + <filename>/usr/src/usr.sbin</filename>にあります. + したがってこれらのソースをダ ウンロードする必要があります. + 次のコマンドを実行する前に + (configを)作りインストールをしておいてください.</para> + </note> + + <para>編集し終ったら, 次のコマンドによってコンパイル, インストール + を行ってください. </para> + + <screen>&prompt.root; <userinput>/usr/sbin/config MYKERNEL</userinput> +&prompt.root; <userinput>cd ../../compile/MYKERNEL</userinput> +&prompt.root; <userinput>make depend</userinput> +&prompt.root; <userinput>make</userinput> +&prompt.root; <userinput>make install</userinput></screen> + + <para>新しいカーネルはルートディレクトリに + <filename>/kernel</filename>という 名前でコピーされ, + 今までのカーネルは <filename>/kernel.old</filename> + という名前へ変更されます. では, システムをシャットダウン, リブー + トして新しいカーネルを使ってください. うまく行かない場合は, + この章の終りの <link + linkend="kernelconfig-trouble">問題が起きた場合には</link> + を参照してください. この章の新しい <link + linkend="kernelconfig-noboot">カーネルがブートしない</link> + 場合のリカバリの方法を注意深く読んでおいてください.</para> + + <note> + <para>(サウンドカードのような)新しいデバイスを 追加した場合は, + 使う前に <filename>/dev</filename>ディレクトリで + デバイスノードを追加しなければならないかもしれません. + 詳しくは, <link linkend="kernelconfig-nodes">デバイスノード + </link> を読んでください.</para> + </note> + </sect1> + + <sect1 id="kernelconfig-config"> + <title>コンフィグレーション ファイル</title> + + <para>コンフィグレーション ファイルの一般的なフォーマット + はとてもシンプルです. 各行は1つのキーワードと1つ以上の + 引数を含んでいます. 見やすくするために, ほとんどのキーワードは + 引数を1つしか書いてありません. + <literal>#</literal>に続くものはすべてコメントとして扱われ, + 無視されます. ここでは, それぞれのキーワードについて だいたい + <filename>GENERIC</filename> に出てくる順番で説明します. しかし, + お互いに関係のあるキーワードは, 実際には + <filename>GENERIC</filename> ファイル上に + バラバラに現れていても, (ネットワーキングのように)1つにまとめ + てあります. <anchor id="kernelconfig-options"> おびただしい数の + オプションの一覧が + <filename>GENERIC</filename>と同じディレクトリの + <filename>LINT</filename> コンフィグ + レーションファイルにあります. もし, ある行の目的や必要性に疑 + 問を持ったら最初に <filename>LINT</filename> + をチェックしてください.</para> + + <para>カーネルは現在, オプションを扱う方法をよりよい機構に移行しよ + うとしています. 従来は, 各々のオプションは単純にカーネルの + Makefile中の <acronym>CFLAGS</acronym>行の + <option>-D</option>スイッチに変換されて いました. + 自然とオプションは際限なく増えて行きます. だれも実際に + はどのオプションがどのファイルで参照されているかは知りません. + </para> + + <para>新しい方法では, すべてのオプション依存の + <literal>#ifdef</literal>は当該オプショ ンを + <filename>opt_<replaceable>foo</replaceable>.h</filename> + (これらのファイルは<command>config</command>によって + compileディレ クトリに作られます) + から読み込むように変わりました. <command>config</command> + の有効なオプションのリストは2つのファイルにお かれます. + アーキテクチャに依存しないオプションは + <filename>/sys/conf/options</filename>に置かれ, + アーキテクチャ依存のオプショ ンは + <filename>/sys/<replaceable>arch</replaceable>/conf/options</filename> + に置かれます. <emphasis>arch</emphasis> の部分は例えば + <filename>i386</filename>となります.</para> + + <sect2> + <title>必須キーワード</title> + + <para>ここにあるキーワードはカーネルの構築に必要不可欠です. + </para> + + <variablelist> + <varlistentry><term><literal>machine "i386"</literal></term> + <listitem> + <para>最初のキーワードは <literal>machine</literal>です. + FreeBSDは Intelの 386とその互換チップ上でしか + 動かないので, i386を指定します.</para> + + <note> + <para>数字を含むキーワードはすべて + クォーテーションマークで囲む必要があります. + そうしないと, <command>config</command>は混乱し, + 386を実際の数値として扱ってしまいます.</para> + </note> + </listitem> + </varlistentry> + + <varlistentry><term><literal>cpu "<replaceable>cpu_type</replaceable>"</literal></term> + <listitem> + <para>次のキーワードは <literal>cpu</literal>です. + FreeBSDでサポートしている CPUの中から記述します. + <replaceable>cpu_type</replaceable>として指定可能な値は + 次の通りです. </para> + + <itemizedlist> + <listitem> + <para>I386_CPU</para> + </listitem> + + <listitem> + <para>I486_CPU</para> + </listitem> + + <listitem> + <para>I586_CPU</para> + </listitem> + + <listitem> + <para>I686_CPU</para> + </listitem> + </itemizedlist> + + <para><filename>GENERIC</filename> カーネルのように + <literal>cpu</literal>の行の + <replaceable>cpu_type</replaceable> + が異なった値を持つものが 複数あってもかまいません. + カスタムカーネルでは, あなたが持っている + cpuを1つだけ指定するのが 一番です. 例えば, もし Intelの + Pentiumを持っていれば, + <replaceable>cpu_type</replaceable>には, + <literal>I586_CPU</literal> を使ってください.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>ident <replaceable>machine_name</replaceable></literal></term> + <listitem> + <para>次は, + カーネルの識別名となる<literal>ident</literal>です. + <literal>GENERIC</literal> + からあなたがカーネルに与えたい名前に 変えてください. + ここでは, <literal>MYKERNEL</literal> とします. + <literal>ident</literal>に与えた名前はカーネルの + ブート時に表示されるので, 普段のカーネルとは別に + カーネルに違う名前を与えたいとき(例えば, + 実験用のカーネルを作りたい時など), 便利でしょう. + 数字を含む名前にしたい場合は + <literal>machine</literal>や <literal>cpu</literal> + の時と同じようにクォーテーションマークで + 囲む必要があります.</para> + + <para>C コンパイラに <option>-D</option> + スイッチで渡されるので, + <literal>DEBUG</literal>のような名前にしたり, + <literal>vax</literal> + といった他のCPUの名前など紛らわしい名前にしないで + ください.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>maxusers <replaceable>number</replaceable></literal></term> + <listitem> + <para>これは, 重要なシステムテーブルのサイズを決めます. + ここ + で与えられる数字はマシンに同時にログインすると考えられ + るおよそのユーザ数です. しかし, 通常の使用環境であれば, + 特に X Window System を立ち上げたり, ソフトウェアを + コンパイルするような使用であれば + <literal>maxusers</literal>には少 なくとも + <literal>4</literal> 以上を指定したほうがいいでしょう. + その理由は, <literal>maxusers</literal> + で決るテーブルで最も重要なものはプロセス + の最大数であるからです. プロセス最大数は <literal>20 + + 16 * maxusers</literal>で与えられ, + <literal>maxusers</literal>を<literal>1</literal> + にすると36プロセスしか同時には持てません. この中にはブー + ト時にシステムによって起動する18個ぐらいのプロセス, Xを + 起動する時の15程度のプロセスも含みます. <!-- kuriyama - + should be katakana --> + manページを読むという1つのタスクでさえ, フィ + ルタやファイル伸長や表示のために9つのプロセスを起動し + ます. <literal>maxusers</literal>を<literal>4</literal> + にすれば, 同時に84個のプロセ + スを持つことができるのでどんな人でも十分な数だといえる + でしょう. それでも他のプログラムを起動した場合に, + あるいは, (Walnut Creek CDROMのFTPサイトのように) + 同時に多くの ユーザを抱えるサーバを走らせた場合に + <errorname>proc table full</errorname> + というおぞましいエラーが起きる場合はこの値を増や し, + カーネルを再構築してください.</para> + + <note> + <para><literal>maxuser</literal>はあなたのマシン + にログインできるユーザの数を制限するものでは + <emphasis>ありません</emphasis>. 単に, + あなたのシステムに + ログインするユーザ数の最大値と各々のユーザが + いくつのプロセスを走らせるかを考慮することに + よってさまざまなテーブルの値を適切な値に設定 + するだけです. これに対し, <link + linkend="kernelconfig-ptys">pseudo-device pty + 16</link>の <emphasis>remote + logins</emphasis>というキーワードは + 同時にリモートログインできるユーザ数を制限 + <emphasis>します</emphasis>.</para> + </note> + </listitem> + </varlistentry> + + <varlistentry><term><literal>config <replaceable>kernel_name</replaceable> root on <replaceable>root_device</replaceable></literal></term> + <listitem> + <para>これはカーネルの位置と名前を特定します. + 伝統的にカーネルは + <filename>vmunix</filename>と呼ばれますが, FreeBSDでは + <filename>kernel</filename>とふさわしい名前になりました. + <replaceable>kernel_name</replaceable>にはいつも + <literal>kernel</literal> を 使ってください. + 名前を変えると多くのシステム + ユーティリティが使えなくなります. 2番目の部分は + ルートファイルシステムとカーネルのあるディスクと + パーティションを指定してください. + SCSIドライブでなければ, <literal>wd0</literal>を, + SCSIドライブならば <literal>sd0</literal>です.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + <sect2> + <title>一般的なオプション</title> + + <para>以下はカーネルのサポートするさまざまなファイルシステムおよ + びその他のオプションです.</para> + + <variablelist> + <varlistentry><term><literal>options MATH_EMULATE</literal></term> + <listitem> + <para>これは, 数値演算コプロセッサがない コンピュータ + (386や486SX) で数値演算コプロセッサ + のエミュレーションを可能にします. もし, Pentiumや 486DX, + あるいは387や487があれば, コメントアウト + できます.</para> + + <note> + <para>FreeBSD付属の数値演算 + コプロセッサエミュレータはあまり正確では + <emphasis>ありません</emphasis>. + 非常に正確な計算をおこないたい ならば, より優れた + GNUのエミュレータである + <literal>GPL_MATH_EMULATE</literal>に変えることを + おすすめします. これはライセンスの関係でデフォルトでは + 含まれていません.</para> + </note> + </listitem> + </varlistentry> + + <varlistentry><term><literal>options "COMPAT_43"</literal></term> + <listitem> + <para>4.3BSDとの互換性のためのオプションです. + そのままにしておいてください. コメントアウトすると, + いくつかのプログラムで動作がおかしくなります.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>options BOUNCE_BUFFERS</literal></term> + <listitem> + <para>ISAデバイスやISA互換モードで動作する EISAデバイス + では DMA (Direct Memory Access) は16MB以下のメモリに対し + てのみ動作します. このオプションによりメモリが16MB以上 + のシステムで DMA + を使うデバイスを動作させることができます.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>options UCONSOLE</literal></term> + <listitem> + <para>ユーザがコンソールを横取り (grab) + できるようにします. これは X Window System + 上で便利です. 例えば, コ ンソール xtermを <command>xterm + -C</command>とタイプして作ると, そこに + <command>write</command>, <command>talk</command> + などのメッセージがカーネルからコ + ンソールへ送られるメッセージと同じように表示されます. + </para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>options SYSVSHM</literal></term> + <listitem> + <para>このオプションは System V の共有メモリを提供します. + X Window System の XSHM拡張での利用がもっとも一般に見 + られる例で, 多くのグラフィックを多用したプログラム + (movie player の Xanimや Linux DOOMなど) ではこれを + 利用することで速度が増加するというメリットがあります. X + Window System を利用するのであればこれは間違いな + く含めたくなるでしょう.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>options SYSVSEM</literal></term> + <listitem> + <para>System V のセマフォをサポートします. + 一般的に利用される + ことは少ないですがカーネルサイズの増加は数百バイトだ + けです.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>options SYSVMSG</literal></term> + <listitem> + <para>System V のメッセージをサポートします. + これを指定した場 + 合もカーネルサイズの増加は数百バイトだけです.</para> + + <note> + <para>&man.ipcs.1; コマンドは これらの System V + の機構を利用しているプロセスを表示し ます.</para> + </note> + + <note> + <para><emphasis>訳注: </emphasis>共有メモリ, セマフォ, + メッセージ(メッ セージキュー) は System V系 + で一般的なプロセス間通信の機 構です. くわしくは System + Vのプロセス間通信に関する文 献, 「詳解 + UNIXプログラミング」 (ソフトバンク) , 「UNIXネッ + トワークプログラミング」 (トッパン) + などを参照してくださ い.</para> + </note> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + <sect2> + <title>ファイルシステムオプション</title> + + <para>これらのオプションはさまざまなファイルシステムへのサポート + を追加します. 少なくともブートするためのデバイスのサポートを含 + める必要があります. 標準的にはハードディスクからブートするので + あれば <acronym>FFS</acronym> , + ディスクレスワークステーションとしてイー + サネットからブートするのであれば <acronym>NFS</acronym>です. + 一般的に利用される他のファイルシステムをカーネルに含め, あまり + 利用しないファイルシステム (多分 MS-DOSファイルシステム?) + のサポー トをコメントアウトすることができます. これは Loadable + Kernel Module ディレクトリ <filename>/lkm</filename> から, + 最初にそのタイプのファイ ルシステムがマウントされる時に + 動的にドライバがロードされるからです.</para> + + <variablelist> + <varlistentry><term><literal>options FFS</literal></term> + <listitem> + <para>基本的なハードドライブ ファイルシステムです. + ハードディ + スクからブートする場合は残しておいてください.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>options NFS</literal></term> + <listitem> + <para>ネットワーク ファイルシステムです. Ethernet経由で + Unixファ + イルサーバからパーティションをマウントする予定がない場 + 合はコメントアウトすることができます.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>options MSDOSFS</literal></term> + <listitem> + <para>MS-DOS ファイルシステムです. ブート時に + DOSフォーマット のハード + ドライブをマウントする予定のない場合はコメン + トアウトしても安全です. 先に示したように, DOSパーティ + ションをマウントする時に自動的にロードされます. また + (ports コレクションにある) + <application>mtools</application> という素晴 + らしいソフトウェアにより mount , unmountなしで DOSフロッ + ピーにアクセスすることができます (これは MSDOSFSも必要 + ありません).</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>options "CD9660"</literal></term> + <listitem> + <para>CD-ROMのための ISO 9660 ファイルシステムです. + CD-ROMを 持っていないか, 時々 データ + CDをマウントするだけならコ メントアウトしましょう + (データ CDを最初にマウントする + 時に動的にロードされます). オーディオ CDはこのファイル + システムは必要ありません.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>options PROCFS</literal></term> + <listitem> + <para>プロセス ファイルシステムです. + これは疑似的なファイルシ ステムで + <filename>/proc</filename> にマウントされ, + &man.ps.1; などのプロ + グラムがプロセスに関してより詳しい情報を与えてくれるよ + うになります.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>options MFS</literal></term> + <listitem> + <para>メモリマップド ファイルシステムです. + これは基本的に一時 ファイルを記憶するための高速な + RAMディスクで, 大きな swap領域がある場合に有効です. + MFSパーティションをマウ + ントするに適した場所は多くのプログラムが一時ファイルを + 置く <filename>/tmp</filename>です. MFS RAMディスクを + <filename>/tmp</filename> にマウントするには以下の内容を + <filename>/etc/fstab</filename>に追 加してリブートするか + <command>mount /tmp</command>とタイプします.</para> + + <programlisting> +/dev/wd1s2b /tmp mfs rw 0 0</programlisting> + + <note> + <para><filename>/dev/wd1s2b</filename>をあなたが使用して + いるswap パーティションに置き換えてください. これは以 + 下のように <filename>/etc/fstab</filename> + に書かれているでしょう. + </para> + + <programlisting> +/dev/wd1s2b none swap sw 0 0</programlisting> + </note> + + <note> + <para>また, <acronym>MFS</acronym> ファ + イルシステムは動的にロードすることは + <emphasis>できません </emphasis>. + したがって使いたい場合はコンパイル時に カーネルに + <emphasis>含める必要があります</emphasis>.</para> + </note> + </listitem> + </varlistentry> + + <varlistentry><term><literal>options "EXT2FS"</literal></term> + <listitem> + <para>Linux のファイルシステム. ext2fs のサポートにより, + Linux パーティションを読み書きすることができます. + これは, FreeBSD と Linux + のデュアルブートシステムにおいて + 両者でデータを共有したい場合に有用です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>options QUOTA</literal></term> + <listitem> + <para>ディスククォータを有効にします. + アクセスが公開されてい るシステムで (一人のユーザが) + <filename>/home</filename>パーティショ ン (全体) + をあふれさせることができないようにそれぞれのユーザ + にディスククォータを発行することができます. + ディスククォータについての詳しい内容は<link + linkend="quotas">ディスク + クォータ</link>の章を見てください.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + <sect2> + <title>基本的なコントローラとデバイス</title> + + <para>この節では FreeBSDでサポートされているディスク, テー プ, + CD-ROMコントローラについて示します. <link + linkend="kernelconfig-scsi">SCSI</link> コントローラと <link + linkend="kernelconfig-network">ネットワーク</link> + カードについ ては別の節になっています.</para> + + <variablelist> + <varlistentry><term><literal>controller isa0</literal></term> + <listitem> + <para>FreeBSD のサポートするすべての PCで必要です. IBM + PS/2 (マイ クロチャネルアーキテクチャ) では現時点では + FreeBSDは動 きません.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>controller pci0</literal></term> + <listitem> + <para>PCIバスを持つマザーボードの場合は含めます. + これにより PCIカードの自動認識と PCIから + ISAバスへのゲートウェイが 可能になります.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>controller fdc0</literal></term> + <listitem> + <para>フロッピードライブコントローラです. + <literal>fd0</literal> は <devicename>A:</devicename> + ドライブで <literal>fd1</literal> は + <devicename>B:</devicename> ドライブです. + <literal>ft0</literal> は + フロッピーコントローラに接続する QIC-80 テープドライブで + す. 対応するデバイスがない場合はそれぞれの行をコメント + アウトしてください.</para> + + <note> + <para>QIC-80テープのサポートは別に + &man.ft.8; というフィルタプログラムが必要です. + くわしくはマニュアルページを見てください.</para> + </note> + </listitem> + </varlistentry> + + <varlistentry><term><literal>controller wdc0</literal></term> + <listitem> + <para>プライマリIDEコントローラです. + <literal>wd0</literal> と + <literal>wd1</literal>はそれぞれマスタ, + スレーブドライブで す. <literal>wdc1</literal> は + セカンダリの IDEコントローラで3台 目, + 4台目のハードディスクまたは IDE CD-ROMのある場合に + 使います. 利用しない行はコメントアウトしてください (例え + ば, SCSIハードディスクのみを使う場合は6行全部をコメント + アウトしてもよいかもしれません).</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device wcd0<anchor id="kernelconfig-atapi"></literal></term> + <listitem> + <para>このデバイスは IDE CD-ROMのサポートをします. + <literal>wdc0</literal>を有効にしておく必要があり, もし + 2つ以上の IDE コントローラがあり, そのうちの + 2つ目のカードに CD-ROMを接 続する場合 + <literal>wdc1</literal> も必要です. また + <literal>options + ATAPI</literal>を書いておく必要もあります.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device npx0 at isa? port "IO_NPX" irq 13 vector npxintr</literal></term> + <listitem> + <para><literal>npx0</literal> は FreeBSD + ハードウェアコプロセッサとソフト + ウェアエミュレータ両方の浮動小数点演算ユニットへのインタ + フェースです. これは <emphasis>不可欠</emphasis> + です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device wt0 at isa? port 0x300 bio irq 5 drq 1 vector wtintr</literal></term> + <listitem> + <para>Wangtek と Archive の QIC-02/QIC-36 + テープドライブのサポートです.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Proprietary CD-ROM support</term> + <listitem> + <para>以下のようなドライブを + <emphasis>proprietary</emphasis>(独自の) CD-ROM + ドライブと呼ぶことにします. これらのドライブは専 + 用のコントローラを持つか, サウンドブラスタ16などのサウ + ンドカードに接続します. これらは IDEでも + SCSIでも<emphasis>あ りません</emphasis>. + 多くの標準速や2倍速の古い CD-ROMはこれら + のインタフェースを持っていますが, より新しい四倍速の + ものは <link linkend="kernelconfig-atapi">IDE</link> か + <link linkend="kernelconfig-scsi">SCSI</link> + でしょう.</para> + + <variablelist> + <varlistentry><term><literal>device mcd0 at isa? port 0x300 bio irq 10 vector mcdintr</literal></term> + <listitem> + <para>ミツミ製 CD-ROM (LU002, + LU005, FX001D)です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device scd0 at isa? port 0x230 bio</literal></term> + <listitem> + <para>ソニー製 CD-ROM (CDU31,CDU33A)です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>controller matcd0 at isa? port ? bio</literal></term> + <listitem> + <para>松下/パナソニック製 CD-ROM (サウンドブラスタ用 + クリエィティブ ラボ製として販売されていました) + です.</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + <sect2 id="kernelconfig-scsi"> + <title>SCSI デバイスのサポート</title> + + <para>この節では FreeBSDのサポートするいろいろな SCSIコント + ローラとデバイスのサポートについて書きます.</para> + + <variablelist> + <varlistentry><term>SCSI コントローラ</term> + <listitem> + <para>以下の十数行は異る種類の + SCSIコントローラのサポートです. + 使用しているもの以外の部分は + コメントアウトしてください.</para> + + <variablelist> + <varlistentry><term><literal>controller bt0 at isa? port "IO_BT0" bio irq ? vector btintr</literal></term> + <listitem> + <para>ほとんどの Buslogic社のコントローラです.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>controller uha0 at isa? port "IO_UHA0" bio irq ? drq 5 vector uhaintr</literal></term> + <listitem> + <para>UltraStor 14F と 34F です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>controller ahc0</literal></term> + <listitem> + <para>Adaptec 274x/284x/294x です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>controller ahb0 at isa? bio irq ? vector ahbintr</literal></term> + <listitem> + <para>Adaptec 174x です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>controller aha0 at isa? port "IO_AHA0" bio irq ? drq 5 vector ahaintr</literal></term> + <listitem> + <para>Adaptec 154x です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>controller aic0 at isa? port 0x340 bio irq 11 vector aicintr</literal></term> + <listitem> + <para>Adaptec 152x や + サウンドカードなどに使われている Adaptec AIC-6360 + チップです. (slow!)</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>controller nca0 at isa? port 0x1f88 bio irq 10 vector ncaintr</literal></term> + <listitem> + <para>NCR 5380を使っている ProAudioSpectrum や + Trantor T130 で す.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>controller sea0 at isa? bio irq 5 iomem 0xc8000 iosiz 0x2000 vector seaintr</literal></term> + <listitem> + <para>Seagate ST01/02 8 ビットコントローラです. + (slow!)</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>controller wds0 at isa? port 0x350 bio irq 15 drq 6 vector wdsintr</literal></term> + <listitem> + <para>Western Digital WD7000コントローラです.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>controller ncr0</literal></term> + <listitem> + <para>NCR 53C810, 53C815, 53C825, 53C860, 53C875 + チップを使った PCI SCSI コントローラです.</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + + <varlistentry><term><literal>options "SCSI_DELAY=15"</literal></term> + <listitem> + <para>このオプションによりカーネルはそれぞれの + SCSIデバイスを プローブする前に 15秒間待ちます. + IDEドライブのみを使用 している場合は無視して構いません. + ブートを速くするため にこの数値を + 5秒ぐらいまで小さくしたいでしょう. そうし た場合, + FreeBSDが SCSIデバイスを認識しにくくなるかもし れません. + その時は, もちろんこのオプションの値は元に戻 + さないといけません.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>controller scbus0</literal></term> + <listitem> + <para>SCSIコントローラがある場合, この行で + SCSI全般のサポー トを与えます. SCSIのない場合, + この行と以下の3つの行をコメ + ントにすることができます.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device sd0</literal></term> + <listitem> + <para>SCSIハードディスクのサポートです.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device st0</literal></term> + <listitem> + <para>SCSIテープドライブのサポートです.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device cd0</literal></term> + <listitem> + <para>SCSI CD-ROM のサポートです.</para> + + <para>上のエントリについている + <literal>0</literal>はいくらか誤解を招き + やすいかもしれません. これらのデバイスはすべてカーネルが + 見つけた時に割り当てがおこなわれ, + SCSIバスに何台つながってい るか, ターゲット + IDが何番であるかはここの記述とは関係あ りません.</para> + + <para>明示的に “固定的な”ターゲット + IDの特定のデバイスへの 割り当てをおこないたい場合は + <filename>LINT</filename> + カーネルコンフィグレーションファイルの + 該当する部分の説明を参照してください.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + <sect2> + <title>コンソール, バスマウス, Xサーバのサポート</title> + + <para>2 つのタイプのコンソールからどちらか 1 + つを選ぶ必要があります. 標準ではない方の vt220 + コンソールを選んだ場合, X Window System を利用するには XSERVER + オプションを有効にする必要があります (訳注: sc0 には XSERVER + オプション相当の機能が始めから入っています). + またバスマウスと PS/2 マウスのオプションもあります.</para> + + <variablelist> + <varlistentry><term><literal>device sc0 at isa? port "IO_KBD" tty irq 1 vector scintr</literal></term> + <listitem> + <para><literal>sc0</literal> + はデフォルトのコンソールドライバで SCOコン + ソールに似ています. このデバイス, あるいは VT220コンパ + チブルドライバの + <literal>vt0</literal>いずれを使う場合もほとんど + のフルスクリーンプログラムは + <filename>termcap</filename>などのターミ + ナルデータベースライブラリを通してアクセスしますので, + あまり違いはないでしょう. + このコンソールを使う場合でフルスクリーンプログラムでト + ラブルが起きる場合にはログインした時に + <envar>TERM</envar>変数の値を + “scoansi”にしてください.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device vt0 at isa? port "IO_KBD" tty irq 1 vector pcrint</literal></term> + + <listitem> + <para>これはVT-220コンパチブルコンソールドライバで + VT100/102の 上位互換です. これは + <literal>sc0</literal>の使えない種類のラッ + プトップ機でもうまく動きます. ログイン時に + <envar>TERM</envar>変数の値 を<literal>>vt100</literal> + か <literal>vt220</literal>にしてください. また, + このドラ + イバはネットワークを介して多くの異るマシンから接続する + 場合も便利です. + <devicename>sc0</devicename>デバイスのための + <filename>termcap</filename>や + <filename>terminfo</filename>エントリは必ずしも + 利用できるわけではありませんが — + <literal>vt100</literal>はいずれの + プラットフォームでも利用可能でしょう.</para> + + <variablelist> + <varlistentry><term><literal>options "PCVT_FREEBSD=210"</literal></term> + <listitem> + <para><literal>vt0</literal> + コンソールドライバを使う場合に必要で す.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>options XSERVER</literal></term> + <listitem> + <para><literal>vt0</literal> + コンソールドライバを使う時のみ有効です. これは + <literal>vt0</literal> コンソールドライバのもとで + <application>XFree86</application> X + サーバを動かすのに必要なコードを含めます.</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device mse0 at isa? port 0x23c tty irq 5 vector ms</literal></term> + <listitem> + <para>Logitech や + ATIのバスマウス入力カードを利用する場合のデ + バイスです.</para> + + <note> + <para>シリアルマウスを使う場合にはこれら2つ + の行(バスマウスとPS/2マウスに関する行) は無視して, + 代わりに <link + linkend="kernelconfig-serial">シリアル</link> + ポート(おそらくはCOM1)を有効にしてくだ さい.</para> + </note> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device psm0 at isa? port "IO_KBD" conflicts tty irq 12 vector psmintr</literal></term> + <listitem> + <para>このデバイスは + PS/2マウスポートにマウスを接続する場合に + 使います.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + <sect2> + <title>シリアル, パラレルポート</title> + + <para>ほとんどすべてのシステムにこれらはあります. + プリンタを接続す る場合は <link + linkend="printing">プリンタの利用</link>の章が非常 + に役に立つでしょう. モデムを使う場合は <link + linkend="dialup">ダイヤルアップ アクセス</link> + に非常に詳しいシリアルポートの設定とデ + バイスの使い方があります.</para> + + <variablelist> + <varlistentry><term><literal>device sio0 at isa? port "IO_COM1" tty irq 4 vector siointr</literal><anchor id="kernelconfig-serial"></term> + <listitem> + <para><literal>sio0</literal>から<literal>sio3</literal>は + MS-DOSにおける COM1から + COM4に相当する4本のシリアルポートです. + COM4に内蔵モデムがあり COM2を使う場合, FreeBSDからアク + セスするためにはモデムのIRQを2へ変更する必要があるとい + うことを注意しておきます (技術的な理由より IRQ 2 = IRQ + 9となります). + マルチポートシリアルカードを使う場合にマニュアルページ + の &man.sio.4; にはこのオプションで使う値などのよ + り多くの情報があります. ビデオカードの中には (特に S3 + チップベースのものには) IOアドレスの + <literal>0x*2e8</literal>から を利用するものがあり, + また多くの安価なシリアルカードは + IOアドレス空間を16-bitフルデコードしていませんので, こ + れらのカードは衝突します. この場合 COM4ポートは実質上 + 利用できません.</para> + + <para>それぞれのシリアルポートは + (割込みの共有をサポートした + マルチポートカードを利用していないのであれば) 別々の IRQ + を割り当てる必要がありますので COM3と COM4のデフォルトの + IRQは利用できません.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device lpt0 at isa? port? tty irq 7 vector lptintr</literal></term> + <listitem> + <para><literal>lpt0</literal> から + <literal>lpt2</literal>は利用可能な3本のプリン + タポートです. 多くの場合は1本のみですので他の2本はない + のであればコメントアウトして構いません.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + <sect2 id="kernelconfig-network"> + <title>ネットワーク</title> + + <para>FreeBSDでは他の一般的な + Unixと同様にネットワークが<emphasis>非常に</emphasis> + 重視されています. イーサネットカードが + なくても必須のオプションとダイヤルアップ ネットワークのサポー + トに注意してください.</para> + + <variablelist> + <varlistentry><term><literal>options INET</literal></term> + <listitem> + <para>ネットワーキングのサポートです. + ネットワークに接続する予定がな + くても残しておいてください. + 多くのプログラムは少なくともループ + バックネットワーキングが必要です(つまり, + PCの中でネットワーク コネクションをおこないます). + したがってこのオプションは本質的 に不可欠です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Ethernet cards</term> + <listitem> + <para>以下にさまざまなイーサネットカードを + 有効にするオプショ ンを示します. + ネットワークカードがなければこれらすべてを + コメントアウトすることができます. そうでなければ利用す + る特定のイーサネットカードをサポートするオプションを残 + しておきます.</para> + + <variablelist> + <varlistentry><term><literal>device de0</literal></term> + <listitem> + <para>DECの DC21040, DC21041, DC21140チップを使った + PCIイー サネットアダプタです.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device fxp0</literal></term> + <listitem> + <para>Intel EtherExpress Pro/100B + 高速イーサネットカード です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device vx0</literal></term> + <listitem> + <para>3Com の 3C590, 3C595です (いくらか + bugがあります).</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device cx0 at isa? port 0x240 net irq 15 drq 7 vector cxintr</literal></term> + <listitem> + <para>Cronyx/Sigma の + マルチポート同期/非同期カードです. (with Cisco or + PPP framing)</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device ed0 at isa? port 0x280 net irq 5 iomem 0xd8000 vector edintr</literal></term> + <listitem> + <para>Western Digital と SMC の 80xx, 8216 Elite + Ultra ; ノベル NE1000, NE2000; 3Com の 3C503; + HPの PC Lan Plus (HP27247B とHP27252A) + です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device el0 at isa? port 0x300 net irq 9 vector elintr</literal></term> + <listitem> + <para>3Com の 3C501 です. (slow!)</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device eg0 at isa? port 0x310 net irq 5 vector egintr</literal></term> + <listitem> + <para>3Com の 3C505です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device ep0 at isa? port 0x300 net irq 10 vector epintr</literal></term> + <listitem> + <para>3Com の 3C509 です(バグがあります).</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device fe0 at isa? port 0x240 net irq ? vector feintr</literal></term> + <listitem> + <para>富士通 MB86960A/MB86965A + ベースのイーサネットカード です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device fea0 at isa? net irq ? vector feaintr</literal></term> + <listitem> + <para>DEC DEFEA EISA FDDI アダプタです.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device ie0 at isa? port 0x360 net irq 7 iomem 0xd0000 vector ieintr</literal></term> + <listitem> + <para>AT&T StarLAN 10 と EN100; 3Com の 3C507; + NI5210; Intel EtherExpress 16 です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device le0 at isa? port 0x300 net irq 5 iomem 0xd0000 vector le_intr</literal></term> + <listitem> + <para>DEC の EtherWorks 2 and EtherWorks + 3 (DEPCA, DE100, DE101, DE200, DE201, DE202, + DE203, DE204, DE205, DE422)です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device lnc0 at isa? port 0x300 net irq 10 drq 0 vector lncintr</literal></term> + <listitem> + <para>Lance/PCnet カード (Isolan, Novell NE2100, + NE32-VL)です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device ze0 at isa? port 0x300 net irq 5 iomem 0xd8000 vector zeintr</literal></term> + <listitem> + <para>IBM/ナショナルセミコンダクタの PCMCIA + イーサネット コントローラです.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device zp0 at isa? port 0x300 net irq 10 iomem 0xd8000 vector zpintr</literal></term> + <listitem> + <para>3Com の PCMCIA Etherlink III です.</para> + </listitem> + </varlistentry> + </variablelist> + + <note> + <para>いくつかのカードでは (特に NE2000では) + “標準値” がありませんので + IOポートやIRQの値を変更す + る必要がある場合があります.</para> + </note> + </listitem> + </varlistentry> + + <varlistentry><term><literal>pseudo-device loop</literal></term> + <listitem> + <para><literal>loop</literal> は + TCP/IPの一般的なループバックデバイスで す. telnet や + FTPを <hostid>localhost</hostid> (<hostid + role="ipaddr">127.0.0.1</hostid>) + に対して行なうとこの疑似デバイスを通して帰ってきます. + 不可欠です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>pseudo-device ether</literal></term> + <listitem> + <para><literal>ether</literal> + はイーサネットカードがある場合のみ必要で + 一般的なイーサネットプロトコルを含めます.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>pseudo-device sl <replaceable>number</replaceable></literal></term> + <listitem> + <para><literal>sl</literal> は SLIP (Serial Line Internet + Protocol) をサポー トします. これはほとんど完全に, + より簡単に設定ができ, モ デム to モデム接続に適した, + よりパワフルな PPPに取って代 わられています. + <literal>sl</literal>の後の + <replaceable>number</replaceable> は同 時にいくつの + SLIPセッションをサポートするかを示します. + SLIPの設定のより詳しい情報はこのハンドブックの + 「PPPとSLIP」の章の <link + linkend="slipc">SLIPクライアントのセットアップ</link> + と <link linkend="slips">SLIP + サーバのセットアップ方法</link> + について書かれた節にあります.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>pseudo-device ppp <replaceable>number</replaceable></literal></term> + <listitem> + <para><literal>ppp</literal>はダイヤルアップ + インターネット接続のための カーネルモード PPP + (Point-to-Point Protocol) をサポート します. + ユーザアプリケーションとして<devicename>tun</devicename> + を 利用する PPPの実装もあり, + こちらはより柔軟性がありデマ + ンドダイアリング(プログラムが接続要求を出した時に自動 + 的にダイヤルをおこなう)などの機能もあります. それでもこ + の PPPドライバを利用したい場合は <link + linkend="ppp">カーネル PPP の設定</link> + の節を読んでください. + <literal>sl</literal>デバイスと同じように + <replaceable>number</replaceable>は同時 に + PPP接続できる数を示します.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>pseudo-device tun <replaceable>number</replaceable></literal></term> + <listitem> + <para><literal>tun</literal> はユーザモード + PPPソフトウェアが利用しま す. + このプログラムは設定が簡単で非常に高速です. + また自動ダイヤル オン デマンドなどの機能を持ちます. + <literal>tun</literal>の後のnumber + は同時におこなうことのできる + PPPセッションの数を示します. <link + linkend="userppp">ユーザ PPP のセットアップ</link> + の節により多くの情報があ ります.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>pseudo-device bpfilter <replaceable>number</replaceable></literal></term> + <listitem> + <para>バークレイ パケットフィルタです. + この疑似デバイスはネッ トワークインタフェースを無差別 + (promiscuous) モードにし てネットワーク + (例えば単一のイーサネット) にブロードキャス + トされるすべてのパケットを取り入れることを可能にします. + こ れらのパケットはディスクに取り入れられたり + &man.tcpdump.1; によって検査されます. この機能の実現 + はネットワーク全体のセキュリティとの微妙な妥協点であるこ + とに注意してください. bpffilter の後の + <replaceable>number</replaceable>は同時に検査することの + できるインタフェースの数を示します. + 危険の可能性について十分解っている場合を除いてこのオプ + ションは奨めません. すべてのネットワークカードでこの機能 + をサポートをしてはいません.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + <sect2> + <title>サウンドカード</title> + + <para>ここは + GENERICカーネルに含まれていない最初のセクションです. + サウンドカードのサポートをするためには LINTコンフィグレーショ + ンファイル(これには <emphasis>すべての</emphasis> + デバイスが含まれています)か + ら以下のような適切な行をコピーする必要があります.</para> + + <variablelist> + <varlistentry><term><literal>controller snd0</literal></term> + <listitem> + <para>サウンドドライバ一般のコードです. + <literal>pca</literal> + を除く以下のすべてのサウンドカードで必要で す.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device pas0 at isa? port 0x388 irq 10 drq 6 vector pasintr</literal></term> + <listitem> + <para>ProAudioSpectrum のオーディオ と MIDI です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device sb0 at isa? port 0x220 irq 7 conflicts drq 1 vector sbintr</literal></term> + <listitem> + <para>SoundBlaster です.</para> + + <note> + <para>SoundBlaster の IRQが標準と異る値, 例えば + 5になっている場合, <literal>irq + 7</literal>を<literal>irq 5</literal>に書き換え, + キーワード <literal>conflicts</literal>を削除し + てください. さらに <literal>options + "SBC_IRQ=5"</literal>の行を + 加える必要があります.</para> + </note> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device sbxvi0 at isa? drq 5</literal></term> + <listitem> + <para>SoundBlaster 16 の 16-bit オーディオです.</para> + + <note> + <para>SB16の DMAチャネルが標準と異っている( 例えば + 6か7)キーワード <literal>drq + 5</literal>を適切な値に書き直 して, (DMA 6の場合) + <literal>options "SB16_DMA=6"</literal>を付け + 加えてください.</para> + </note> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device sbmidi0 at isa? port 0x330</literal></term> + <listitem> + <para>SoundBlaster 16 の MIDI インタフェースです. + SoundBlaster 16を使う場合必ずこの行を含めてコンパイル + してください.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device gus0 at isa? port 0x220 irq 10 drq 1 vector gusintr</literal></term> + <listitem> + <para>Gravis Ultrasound です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device mss0 at isa? port 0x530 irq 10 drq 1 vector adintr</literal></term> + <listitem> + <para>Microsoft Sound System です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device opl0 at isa? port 0x388 conflicts</literal></term> + <listitem> + <para>AdLib FMシンセサイザオーディオです. AdLib, + SoundBlaster, ProAudioSpectrum を使い + <command>playmidi</command> (ports にあります) + などのプログラムで + MIDIの演奏をしたい場合にこの行を含めます.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device mpu0 at isa? port 0x330 irq 6 drq 0</literal></term> + <listitem> + <para>Roland MPU-401 カードです.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device uart0 at isa? port 0x330 irq 5 vector "m6850intr"</literal></term> + <listitem> + <para>MIDIインタフェースの 6850 UART です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>device pca0 at isa? port "IO_TIMER1" tty<anchor id="kernelconfig-pcaudio"></literal></term> + <listitem> + <para>PC のスピーカーを使ったオーディオです. + これは非常に品質 が悪く, CPUの性能, + 負荷に強く依存します, と言っておき ます + (サウンドカードは必要ありませんが).</para> + </listitem> + </varlistentry> + </variablelist> + + <note> + <para>追加のドキュメントが + <filename>/usr/src/sys/i386/isa/sound/sound.doc</filename> + にあります. また, これらのデバイスを追加する場合は, + サウンド<link + linkend="kernelconfig-nodes">デバイスノード</link> + を作る必要があり ます.</para> + </note> + </sect2> + + <sect2> + <title>疑似デバイス</title> + + <para>疑似デバイスドライバはデバイスドライバと同様に働きますがマ + シン上に対応する実際のハードウェアがないカーネルの部分です. + <link linkend="kernelconfig-network">ネットワーク</link>関連の + 疑似デバイスはそちらのセクションに示しました. ここでは残りにつ + いて示します.</para> + + <variablelist> + <varlistentry><term><literal>pseudo-device gzip</literal></term> + <listitem> + <para><literal>gzip</literal>は + <command>gzip</command>によって圧縮された FreeBSDの + プログラムを実行できるようにします. /standにあるプログ + ラムは圧縮されているのでカーネルにこのオプションをつけ + ておくのはいい考えでしょう.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>pseudo-device log</literal></term> + <listitem> + <para><literal>log</literal> + はカーネルエラーのログを取るのに使います. + 不可欠です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>pseudo-device pty <replaceable>number</replaceable><anchor id="kernelconfig-ptys"></literal></term> + <listitem> + <para><literal>pty</literal> + は“仮想ターミナル”や仮想ログインポート です. + 外部からの <command>telnet</command>や + <command>rlogin</command>セッ ション, xterm, + emacsなどのアプリケーションが使います. + <replaceable>number</replaceable>は作ることのできる + <literal>pty</literal>の数を示 します. + <filename>GENERIC</filename>のデフォルトは16で, 同時の + xtermウィンドウやリモー + トログインのために増やす場合は最大で 64までです.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>pseudo-device snp <replaceable>number</replaceable></literal></term> + <listitem> + <para>スヌープデバイスです. + この疑似デバイスはあるターミナル セッションが + &man.watch.8; command によって他のター + ミナルを監視することを可能にします. この機能の実現はセ + キュリティとプライバシに対して極めて微妙な関係があり + ます. snp の後の <replaceable>number</replaceable> + は同時におこなうことのでき + るスヌープセッションの総数です. 選択可能です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>pseudo-device vn</literal></term> + <listitem> + <para>V ノードドライバです. ファイルを &man.vnconfig.8; + コマンドによって + デバイスとして取り扱うことを可能にします. + このドライバによりフロッピーディスクイメージを + 操作したりファ イルをスワップデバイスとして (MS + Windowsのスワッ プファイルなどを)用いることができます. + 選択可能です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>pseudo-device ccd <replaceable>number</replaceable></literal></term> + <listitem> + <para>ccd (concatenated + disk)デバイスはいくつかのディスクパーティ + ションを融合して大きなディスクのように + 見せることができます. ccdの後の + <replaceable>number</replaceable> + は同時に作ることのできる疑似ディスクの数です. + (詳しいことは &man.ccd.4; と &man.ccdconfig.8; のマニュ + アルを参照してください.) 選択可能です.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + <sect2> + <title>ジョイスティック, スピーカー, その他</title> + + <para>この節は FreeBSDのここまでに示した以外のハードウェア + デバイスへのサポートについて示します. これらは GENERICカーネル + には含まれませんのでこのハンドブックや LINT (このファイルには + <emphasis>すべての</emphasis>デバイスのサポートが含まれます) + からコピーする必 要があります.</para> + + <variablelist> + <varlistentry><term><literal>device joy0 at isa? port "IO_GAME"</literal></term> + <listitem> + <para>PC のジョイスティックです.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal>pseudo-device speaker</literal></term> + <listitem> + <para>IBM BASIC スタイルの PC内蔵スピーカーのサポートです. + シェルスクリプトで簡単な演奏をする + <filename>/usr/sbin/spkrtest</filename> + やキーボードを使って単純なピ + アノのように演奏することができる + <filename>/usr/games/piano</filename> + (<literal>games</literal>パッケージをイ + ンストールした場合にはあります) のようないくつかのプロ + グラムで使われます. また素晴らしいテキストロールプレイ + ングゲームである <application>NetHack</application> + (ports コレクションにあります) + はゲーム中の楽器の演奏でこのデバイスを使うように設定を + することができます (訳注:日本語化されたJNetHackもportsに + あります).</para> + + <para><link linkend="kernelconfig-pcaudio">pca0</link> デバイスの + 項も参照してください.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + </sect1> + + <sect1 id="kernelconfig-nodes"> + <title>デバイスノードを作る</title> + + <para>カーネル内のほとんどすべてのデバイスは対応する + “node” エント リが <filename>/dev</filename> + ディレクトリにあります. これらのノードは普 + 通のファイルのように見えますが, 実際にはプログラムがデバイスに + アクセスするのに用いるカーネル内への特別なエントリです. + シェルスクリプトである + <filename>/dev/MAKEDEV</filename>はオペレーティング + システムを最初にインストールする時に実行され, サポートされてい + る大部分のデバイスのノードを作ります. しかし, + <emphasis>すべての</emphasis> + ノードが作られるわけではありませんので + 新しいデバイスのサポートを加える時は対応するエントリがこのディ + レクトリにあるかどうか確認してもしなければ, 作ってください. + 以下に例を示します.</para> + + <para>IDE CD-ROMのサポートをカーネルに加えるとします. 次の行 + を加えます.</para> + + <programlisting> +controller wcd0</programlisting> + + <para>これにしたがって, <filename>/dev</filename>ディレクトリに + <filename>wcd0</filename>で始ま るエントリを捜してください. + 1文字が後ろにつくかもしれません. 後 ろについた文字が + <literal>c</literal>であるか先に + <literal>r</literal>のつくエントリは “raw”デバ + イスを示します. + それらのファイルがないことが明らかになったとします. そこで + <filename>/dev</filename> + ディレクトリに移動して次のようにタイプします.</para> + + <screen>&prompt.root; <userinput>sh MAKEDEV wcd0</userinput></screen> + + <para>スクリプトの実行が終ったら <filename>/dev</filename>に + <filename>wcd0c</filename> と <filename>rwcd0c</filename> + エントリがあることを確認してください. これによ + り正しく実行されたことがわかります.</para> + + <para>サウンドカードの場合のコマンドは次の通りです. + + <screen>&prompt.root; <userinput>sh MAKEDEV snd0</userinput></screen> + + これにより対応するエントリが作られます.</para> + + <note> + <para>サウンドカードのようなデバイスのノードを作る場合で, もし他 + の人がマシンにアクセスするようであれば, そのデバイスを + <filename>/etc/fbtab</filename> + ファイルに追加して外部からのアクセスから + 保護するのが望ましいでしょう. このファイルの詳細については + <command>man fbtab</command> を参照してください.</para> + </note> + + <para><filename>GENERIC</filename> + に含まれていないデバイスはエントリがありませんから,以上 + の簡単な手順をおこなうことになります.</para> + + <note> + <para>すべての SCSI コントローラは同じ <filename>/dev</filename> + の エントリを使用しますのでノードを作る必要はありません. + またネッ トワークカードと SLIP/PPP 疑似デバイスは + <filename>/dev</filename> にはエント + リがありませんのでこれらについても作る必要がありません.</para> + </note> + </sect1> + + <sect1 id="kernelconfig-trouble"> + <title>問題が起きた場合には</title> + + <para>カスタムカーネルを作る場合に起きるトラブルは 4 + 種類に分けられま す.</para> + + <variablelist> + <varlistentry><term>Config コマンドの失敗</term> + <listitem> + <para>カーネルにあなたの設定をおこなった場合で + <command>config</command>コ マンドが失敗したのであれば, + 多分どこかで単純な間違いを やっているのでしょう. さいわい, + <command>config</command>はトラ + ブルの起きた行番号を出力しますので + <command>vi</command>で素早く 見つけることができます. + 例えばもし次のように出力されれ ば, <screen>config: line + 17: syntax error</screen> + <command>vi</command>のコマンドモードで + <COMMAND>17G</COMMAND>とタイプすればあな + たは問題のところへ飛ぶことができます. + <filename>GENERIC</filename> カーネル + のファイルや他のリファレンスと比較して注意深く修正して + ください.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Make コマンドの失敗</term> + <listitem> + <para><command>make</command> コマンドが失敗した場合には, + カーネル設定で <command>config</command> + がとらえられなかったような間違いをして + いることが多いようです. ふたたびコン + フィグレーションを見直してください. それでも問題を解決 + することができなければ &a.questions; + へあなたのカーネルのコンフィグレーションをつけてメー + ルしてください. 誰かが素早く間違いを見つけてくれるで + しょう.</para> + </listitem> + </varlistentry> + + <varlistentry><term>カーネルがブートしない + <anchor id="kernelconfig-noboot"></term> + <listitem> + <para>新しいカーネルがブートしなかったり, + デバイスの認識をしな い場合でもあわてないでください! + さいわい, BSDは利用で + きないカーネルから復帰する優れたメカニズムがあります. + FreeBSDの bootプロンプトでリターンキーを押すかわりに + 単にブートさせたいカーネルの名前 (例えば + <filename>kernel.old</filename>) をタイプするだけです. + カーネルの再設定 + をおこなう場合に現在のカーネルを利用できるように取ってお + くのはよい考えです.</para> + + <para>問題のないカーネルでブートした後に + あなたのコンフィグレー ションファイルを調べ, + 再び構築を試みてください. + <filename>/var/log/messages</filename> + ファイルにはすべての成功した + ブートのカーネルのメッセージやその他の記録があり, これ + は助けになる情報の一つでしょう. また, + &man.dmesg.8; コマンドは現在のブート時のカーネルメッ + セージを出力します.</para> + + <note> + <para>カーネルの構築中にトラブルが起きた時に使うために + GENERICや他のカーネルを次の構築で消されない + ように異る名前で保存するようにしてください. <emphasis + remap=tt>kernel.old</emphasis> + は新しいカーネルをインストールする 時に, + その一つ前にインストールしたうまく動かないかもしれ + ないカーネルで上書きされてしまいますので当てにできませ + ん. またできる限り早く動作しているカーネルを本来の + <filename>kernel</filename>の位置に移動させてください. + そうしないと + &man.ps.1; のようなコマンドが正しく動きません. + <command>make</command> + でインストールされたカーネルのファイルを + (別のカーネルに戻すために) + “アンロック” するための特別 + のコマンドは</para> + + <screen>&prompt.root; <userinput>chflags noschg + /kernel</userinput></screen> + + <para>です. また, + 新しい置き換えたカーネルあるいは重要ファイ + ルを動かしたり変更されないように + “ロック” するには 次のようにします. </para> + + <screen>&prompt.root; <userinput>chflags schg + /kernel</userinput></screen> + </note> + </listitem> + </varlistentry> + + <varlistentry><term>カーネルは動くが + <command>ps</command> は動かない!</term> + + <listitem> + <para>システムユーティリティと異る + バージョンのカーネルをインス トールした場合, 例えば + 実験的に “2.2.0” のカーネルを 2.1.0-RELEASE + システム上にインストールするような場合, + &man.ps.1; や &man.vmstat.8; のような多くのシ + ステムステータスコマンドは動かなくなります. + <filename>libkvm</filename> を + 再コンパイルしてこれらのユーティリティを作りなおす + 必要がありま す. これは, + オペレーティングシステムのそれ以外の部分と異るバージョ + ンのカーネルを使うことが普通はあまりよくない + 理由の一つです.</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/kerneldebug/chapter.sgml b/ja_JP.eucJP/books/handbook/kerneldebug/chapter.sgml new file mode 100644 index 0000000000..4e1a45a5fb --- /dev/null +++ b/ja_JP.eucJP/books/handbook/kerneldebug/chapter.sgml @@ -0,0 +1,689 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.11 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:46:01 kuriyama Exp $ +--> + +<chapter id="kerneldebug"> + <title>カーネルデバッグ</title> + + <para><emphasis>原作 &a.paul; and &a.joerg;</emphasis></para> + + <para><emphasis>訳: &a.jp.yoshiaki;. <!-- <br> --> + 18 March 1997. </emphasis></para> + + <sect1> + <title><command>kgdb</command> + によるカーネルのクラッシュダンプのデバッグ</title> + + <para>ここではクラッシュダンプ (crash dump : 訳注 この文脈では + kernel 自身 + の異常によって停止した場合に出力されるイメージを指します) + によるカー ネルデバッグの方法を示します.</para> + + <para>ここではダンプするための十分なスワップ + (swap) の容量があるものとします. + もし複数のスワップパーティションを持ち, + 最初のパーティションがダンプ + を保持するのに十分な大きさを持たない場合は + 別のダンプデバイスを使うよ + うに (<literal>config kernel</literal> 行で) + カーネルのコンフィグをおこなうか, &man.dumpon.8; + コマンドを使って別のデバイスを示すことができます. &man.dumpon.8; + を使うもっともよい方法は変数 <literal>dumpdev</literal> を + <filename>/etc/rc.conf</filename> で設定することです. 一般的には + <filename>/etc/fstab</filename> で設定されているスワップデバイスが + 使われるでしょう. + スワップに使えないデバイスへのダンプ, + 例えばテープへのダンプは現在サポートさ + れていません. カーネルのコンフィグは + <command>config -g</command> によって行ってください. + <link linkend="kernelconfig"> FreeBSD + カーネルのコンフィグレーション </link> + には FreeBSD のカーネルの設定の詳細がありますので + 参照してください.</para> + + <para>&man.dumpon.8; コマンドを使ってどこへダンプするか + カーネルに伝えてください + (&man.swapon.8; によってそのパーティションが + スワップとして設定された + 後でなければならないことに注意してください). これは普通は + <filename>/etc/rc.conf</filename> や <filename>/etc/rc</filename> + で設定されます. あるいは + 別の方法としてカーネルコンフィグレーションファイルの + <literal>config</literal> 行の <literal>dump</literal> 節 で + ダンプデバイスをハードコードすることができます. + この方法はあまりよくは + ありません. カーネルがブート時に crash + する場合のクラッシュダンプを取り + たい時だけ使うべきです.</para> + + <note> + <para>以下では <command>kgdb</command>という用語は + <command>gdb</command>を “カーネルデバッグモード” + で動かしていることを意味します. <command>gdb</command>を + <option>-k</option>オプションをつけて起動するか + <command>kgdb</command>という名前でリン + クして起動することでこのモードになります. デフォルトでは + このリンク は作られていません. また, このアイデアは + GNU関係者たちが彼らのツール + を別の名前で呼び出した時に異なった動作をするということを + 好まない, と いう点で不評です. + あるいは将来この機能を廃止することになるかもしれません.</para> + </note> + + <para>カーネルを作った時にそのコピーを + <filename>kernel.debug</filename> という名前で作 りましょう. + また, オリジナルに対して <command>strip + -d</command>を実行します. + オリジナルを普通にインストールします. また strip + していないカーネル も同様にインストールすることができますが, + シンボルテーブルの参照時間 + がいくつかのプログラムでは劇的に増加するでしょう. また, + カーネル全体 はブート時に読み込まれ + スワップアウトされないため数メガバイトの物理メ + モリが無駄になります.</para> + + <para>例えばブートプロンプトで + 新しいカーネルの名前をタイプすることによって, + 新しいカーネルをテストした場合で, + 再びシステムを動かすのに別のカーネ + ルで立ち上げることが必要な場合はブートプロンプトで + <option>-s</option>フラグ + を使いシングルユーザの状態にしてください. + そして以下のような操作をおこな います.</para> + + <screen>&prompt.root; <userinput>fsck -p</userinput> +&prompt.root; <userinput>mount -a -t ufs</userinput> # /var/crash 用のファイルシステムを書き込み可能にする +&prompt.root; <userinput>savecore -N /kernel.panicked /var/crash</userinput> +&prompt.root; <userinput>exit</userinput> # ...マルチユーザモードへ移行</screen> + + <para>ここに示した &man.savecore.8; は (現在動いているものとは別の) + カーネルのシンボル名の抽出をおこなうために使っています. + 抽出はデフォルトで + は現在動いているカーネルに対しておこなわれ, + クラッシュダンプとカーネルシンボ + ルのくい違いのためにまったく何もしません + (訳注:そのためにオプション + で実際にダンプをおこしたカーネルを指定します).</para> + + <para>クラッシュダンプの起きた後に + <filename>/sys/compile/WHATEVER</filename>へ行き + <command>kgdb</command>を動かします. <command>kgdb</command> + より次のようにします.</para> + + <screen><userinput>symbol-file kernel.debug</userinput> +<userinput>exec-file /var/crash/kernel.0</userinput> +<userinput>core-file /var/crash/vmcore.0</userinput></screen> + + <para>こうすると, + クラッシュダンプを使ってカーネルソースを他のプログラムと同様に + デバッグすることができます.</para> + + <para>次に <command>kgdb</command> + での手順のセッションのログを示します. 長い行は読 + みやすくするために改行しました. また, + 参照のために行番号を入れてあり ます. ただし, これは実際の + pcvtコンソールドライバの開発中の実際のエ + ラーのトレースです.</para> + + <screen> 1:Script started on Fri Dec 30 23:15:22 1994 + 2:&prompt.root; <userinput>cd /sys/compile/URIAH</userinput> + 3:&prompt.root; <userinput>kgdb kernel /var/crash/vmcore.1 </userinput> + 4:Reading symbol data from /usr/src/sys/compile/URIAH/kernel...done. + 5:IdlePTD 1f3000 + 6:panic: because you said to! + 7:current pcb at 1e3f70 + 8:Reading in symbols for ../../i386/i386/machdep.c...done. + 9:<prompt>(kgdb)</prompt> <userinput>where</userinput> +10:#0 boot (arghowto=256) (../../i386/i386/machdep.c line 767) +11:#1 0xf0115159 in panic () +12:#2 0xf01955bd in diediedie () (../../i386/i386/machdep.c line 698) +13:#3 0xf010185e in db_fncall () +14:#4 0xf0101586 in db_command (-266509132, -266509516, -267381073) +15:#5 0xf0101711 in db_command_loop () +16:#6 0xf01040a0 in db_trap () +17:#7 0xf0192976 in kdb_trap (12, 0, -272630436, -266743723) +18:#8 0xf019d2eb in trap_fatal (...) +19:#9 0xf019ce60 in trap_pfault (...) +20:#10 0xf019cb2f in trap (...) +21:#11 0xf01932a1 in exception:calltrap () +22:#12 0xf0191503 in cnopen (...) +23:#13 0xf0132c34 in spec_open () +24:#14 0xf012d014 in vn_open () +25:#15 0xf012a183 in open () +26:#16 0xf019d4eb in syscall (...) +27:<prompt>(kgdb)</prompt> <userinput>up 10</userinput> +28:Reading in symbols for ../../i386/i386/trap.c...done. +29:#10 0xf019cb2f in trap (frame={tf_es = -260440048, tf_ds = 16, tf_\ +30:edi = 3072, tf_esi = -266445372, tf_ebp = -272630356, tf_isp = -27\ +31:2630396, tf_ebx = -266427884, tf_edx = 12, tf_ecx = -266427884, tf\ +32:_eax = 64772224, tf_trapno = 12, tf_err = -272695296, tf_eip = -26\ +33:6672343, tf_cs = -266469368, tf_eflags = 66066, tf_esp = 3072, tf_\ +34:ss = -266427884}) (../../i386/i386/trap.c line 283) +35:283 (void) trap_pfault(&frame, FALSE); +36:<prompt>(kgdb)</prompt> <userinput>frame frame->tf_ebp frame->tf_eip</userinput> +37:Reading in symbols for ../../i386/isa/pcvt/pcvt_drv.c...done. +38:#0 0xf01ae729 in pcopen (dev=3072, flag=3, mode=8192, p=(struct p\ +39:roc *) 0xf07c0c00) (../../i386/isa/pcvt/pcvt_drv.c line 403) +40:403 return ((*linesw[tp->t_line].l_open)(dev, tp)); +41:<prompt>(kgdb)</prompt> <userinput>list</userinput> +42:398 +43:399 tp->t_state |= TS_CARR_ON; +44:400 tp->t_cflag |= CLOCAL; /* cannot be a modem (:-) */ +45:401 +46:402 #if PCVT_NETBSD || (PCVT_FREEBSD >= 200) +47:403 return ((*linesw[tp->t_line].l_open)(dev, tp)); +48:404 #else +49:405 return ((*linesw[tp->t_line].l_open)(dev, tp, flag)); +50:406 #endif /* PCVT_NETBSD || (PCVT_FREEBSD >= 200) */ +51:407 } +52:<prompt>(kgdb)</prompt> <userinput>print tp</userinput> +53:Reading in symbols for ../../i386/i386/cons.c...done. +54:$1 = (struct tty *) 0x1bae +55:<prompt>(kgdb)</prompt> <userinput>print tp->t_line</userinput> +56:$2 = 1767990816 +57:<prompt>(kgdb)</prompt> <userinput>up</userinput> +58:#1 0xf0191503 in cnopen (dev=0x00000000, flag=3, mode=8192, p=(st\ +59:ruct proc *) 0xf07c0c00) (../../i386/i386/cons.c line 126) +60: return ((*cdevsw[major(dev)].d_open)(dev, flag, mode, p)); +61:<prompt>(kgdb)</prompt> <userinput>up</userinput> +62:#2 0xf0132c34 in spec_open () +63:<prompt>(kgdb)</prompt> <userinput>up</userinput> +64:#3 0xf012d014 in vn_open () +65:<prompt>(kgdb)</prompt> <userinput>up</userinput> +66:#4 0xf012a183 in open () +67:<prompt>(kgdb)</prompt> <userinput>up</userinput> +68:#5 0xf019d4eb in syscall (frame={tf_es = 39, tf_ds = 39, tf_edi =\ +69: 2158592, tf_esi = 0, tf_ebp = -272638436, tf_isp = -272629788, tf\ +70:_ebx = 7086, tf_edx = 1, tf_ecx = 0, tf_eax = 5, tf_trapno = 582, \ +71:tf_err = 582, tf_eip = 75749, tf_cs = 31, tf_eflags = 582, tf_esp \ +72:= -272638456, tf_ss = 39}) (../../i386/i386/trap.c line 673) +73:673 error = (*callp->sy_call)(p, args, rval); +74:<prompt>(kgdb)</prompt> <userinput>up</userinput> +75:Initial frame selected; you cannot go up. +76:<prompt>(kgdb)</prompt> <userinput>quit</userinput> +77:&prompt.root; <userinput>exit</userinput> +78:exit +79: +80:Script done on Fri Dec 30 23:18:04 1994</screen> + + <para>上の出力についてのコメントをします.</para> + + <variablelist> + <varlistentry><term>line 6:</term> + <listitem> + <para>これは DDB (後述) からのダンプです. このため + “because you said to!” という + panicコメントがつき, ページフォルトのト ラップによって + DDBに入ったことが原因の, やや長いスタックトレー + スがあります.</para> + </listitem> + </varlistentry> + + <varlistentry><term>line 20:</term> + <listitem> + <para>スタックトレースでのこれは + <function>trap()</function>関数の位置で す.</para> + </listitem> + </varlistentry> + + <varlistentry><term>line 36:</term> + <listitem> + <para>新しいスタックフレームの使用を指定しています. これは現 + 在は必要ありません. trapの場合ではスタックフレームは正 + しい場所を指していると考えられます. (私は新しいコアダンプ + を持っていません. 私のカーネルは長い間 panicを起こしていま + せん.) ソースコードの + 403行を見ると,“tp”ポインタのアク + セスが失敗しているか配列のアクセスが範囲外である可能性が高 + いことがわかります.</para> + </listitem> + </varlistentry> + + <varlistentry><term>line 52:</term> + <listitem> + <para>怪しいポインタですが, + アクセスは正常におこなえました.</para> + </listitem> + </varlistentry> + + <varlistentry><term>line 56:</term> + <listitem> + <para>ところが, 明らかにポインタはゴミを指しています. これで + エラーを見つけました! (ここのコードの部分からはよくわかり + ませんが, + <literal>tp->t_line</literal>はコンソールデバイスの規定 + する行を参照しているので, + もっと小さな整数でなければなりませ ん. )</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + + <sect1> + <title>DDD によるクラッシュダンプのデバッグ</title> + + <para>カーネルのクラッシュダンプは <command>ddd</command> + のようなグラフィカルなデバッガで調べることもできます. + 通常はコマンドラインで <option>-k</option> オプションをつけて + <command>ddd</command> を起動します. たとえば:</para> + + <screen>&prompt.root; <userinput>ddd -k /var/crash/kernel.0 /var/crash/vmcore.0</userinput></screen> + + <para>クラッシュダンプを <command>ddd</command> + のグラフィカルなインターフェースを使って + 見ることができます.</para> + </sect1> + + <sect1> + <title>突然ダンプした場合の解析</title> + + <para>カーネルが予想もしない時にコアダンプして <command>config + -g</command> + を行ってコンパイルされていなかった場合にはどうしたら + よいでしょう. すべてが失われるわけではありません. + パニックを起こさないでください.</para> + + <para>もちろん, クラッシュダンプを使えるようにする必要があります. + 使い方は前述の部分を見てください.</para> + + <para>カーネルのコンパイルディレクトリで, (Makefileの) + <literal>COPTFLAGS?=-O</literal> とある行を編集します. + <option>-g</option>オプショ ンをここに加えます + (オプティマイズオプションのレベルは <emphasis>変更しな + いでください</emphasis> ). + もし大まかにコードのどこで問題が起きているか (例 えば, + 上の例では <devicename>pcvt</devicename>ドライバ) + わかっているのでしたら, その部 + 分のコードについてのすべてのオブジェクトファイルを + 消してください. カーネ ルを再構築しましょう. + Makefileのタイムスタンプの変更により, 例えば <!-- kuriyama - + should be filename --> <emphasis remap=tt> trap.o + </emphasis>などのいくつかの他のオブジェクトファイルも作り直さ + れます. 少しの幸運があれば, + <option>-g</option>オプションが追加されても作ら + れるコードは変更されず, いくらかのデバッグシンボル以外には + 問題を + 起こしたコードとそっくりな新しいカーネルを手に入れることが + できます. 少なくとも &man.size.1; + コマンドで古い方と新しい方のサイズを比較すべ きです. + これが食い違っていれば, + 多分あきらめなければならないでしょう.</para> + + <para>ダンプを使って前述のように動かして調べます. + デバッグシンボルは 必ずしも十分ではありません. + 上の例ではスタックトレースでいくつかの関 + 数の行番号や引数リストが表示されないかもしれません. + もしより多くのデ バッグシンボルが必要であれば,十分になるまで + 適切なオブジェクトファイ ルを消して (makeして) + <command>kgdb</command>セッションを繰り返してください.</para> + + <para>これは必ずしもうまく動くと保証はできません. + しかしほとんどの場合でう まくいくでしょう.</para> + </sect1> + + <sect1> + <title>DDBを使ったオンラインカーネルデバッグ</title> + + <para><command>kgdb</command> + は非常に高レベルのユーザインタフェースを提 + 供するオフラインデバッガですが, いくつかのことはできません. + (できないことの中で) + 極めて重要なことはカーネルコードへのブレークポイ + ントの設定とシングルステップ実行です.</para> + + <para>カーネルの低レベルデバッグが必要であれば, DDBと呼ばれる + on-lineデバッ ガが使えます. ブレークポイントの設定, + シングルステップのカーネルの実 行, + 変数の検査と変更などができます. + ただし,これはカーネルのソースファ + イルにアクセスすることはできません. + <command>kgdb</command>のようにすべてのデ + バッグ情報にはアクセスできず, globalと + staticのシンボルにアクセス することができるだけです.</para> + + <para>カーネルに DDB + を含めるためにはコンフィグファイルに次のようなオプショ + ンを加えて,</para> + + <programlisting> +options DDB</programlisting> + + <para>再構築をおこないます. ( + FreeBSDのカーネルの設定の詳細については<link + linkend="kernelconfig"> FreeBSD + カーネルのコンフィグレーション</link>を参照してくださ + い.</para> + + <note> + <para>もしブートブロックが古いバージョンですと, + デバッガのシンボルが完 + 全にはロードされないかもしれませんので注意してください. DDB + シンボル がロードされるようにブートブロックを + 最新の物にアップデートしてくださ い)</para> + </note> + + <para>DDB カーネルの実行において, + DDBに入るいくつかの方法があります. 最初 の, + 最も早い方法はブートプロンプトが出ている時に + <option>-d</option>のブート フラグをタイプすることです. + カーネルはデバッグモードで起動し, デバ イスのプローブ以前に + DDBに入ります. したがって, デバイスのプローブ/初期 + 設定ファンクションのデバッグができます.</para> + + <para>2つ目のシナリオはキーボードのホットキーで, 通常は + Ctrl-Alt-ESCです. syscons ではホットキーは再設定することができ, + 配付されているいくつかの キーマッピングでは別のキーに + 再設定されていますので確認しておいてください. シリアルラインの + BREAKを使って シリアルコンソールから DDBへ入ることを可 + 能にするオプションもあります + (カーネルコンフィグレーションファイルの <literal>options + BREAK_TO_DEBUGGER</literal>). これは 多くのつまらないシリ + アルアダプタが, 例えばケーブルを引き抜いた時に + BREAK状態を意味もなく + 作り出してしまうのでデフォルトでは無効になっています.</para> + + <para>3つ目は, DDB + を使うようになっているカーネルがパニック状態になると DDB + へ入るというものです. このため, + 無人運転するマシンのカーネルにDDBを + 入れるのは賢明ではありません.</para> + + <para>DDB のコマンドはおおまかには <command>gdb</command> + のいくつかのコマンドと似て + います. おそらく最初にブレークポイントを + 設定する必要があるでしょう.</para> + + <screen><userinput>b function-name</userinput> +<userinput>b address</userinput></screen> + + <para>数値はデフォルトでは16進数で, + シンボル名とはまったく異ります. 16進数で <literal>a-f</literal> + の文字で始まる場合は, 先頭に <literal>0x</literal> + をつける必要があります(それ以外の数字の場合はどちらでもか + まいません). <literal>function-name + + 0x103</literal>のような単純な式を使うこ とができます.</para> + + <para>割り込みされたカーネルから処理を続行するためには, </para> + + <screen><userinput>c</userinput></screen> + + <para>とタイプするだけです. + スタックのトレースには</para> + + <screen><userinput>trace</userinput></screen> + + <para>とします.</para> + + <note> + <para>DDB にホットキーで入った場合は, カーネルはその + (ホットキーの) 割り込み + の処理を行っていますのでスタックトレースは + あまり役にたたないことに注 意してください.</para> + </note> + + <para>ブレークポイントを削除したい場合は,</para> + + <screen><userinput>del</userinput> +<userinput>del address-expression</userinput></screen> + + <para>とします. + 最初の形式はブレークポイントにヒットしたすぐ後で使うことが でき, + 現在のブレークポイントを削除します. 2番目の形式では任意のブレー + クポイントを削除することができますが, + 次の形式で得られるような正確な + アドレスを与えることが必要です.</para> + + <screen><userinput>show b</userinput></screen> + + <para>カーネルをシングルステップ実行させるには</para> + + <screen><userinput>s</userinput></screen> + + <para>としてみてください. これは関数呼出し先までステップ実行 (step + into function) するでしょう. + 次のステートメントが終了するまでのDDBトレースは</para> + + <screen><userinput>n</userinput></screen> + + <para>によっておこなうことができます.</para> + + <note> + <para>これは <command>gdb</command> の <command>next</command> + 命令とは異ります. <command>gdb</command>の + <command>finish</command>命令と似ています.</para> + </note> + + <para>メモリ上のデータを調べるには (例として) 次のようにします. + + <screen><userinput>x/wx 0xf0133fe0,40</userinput> +<userinput>x/hd db_symtab_space</userinput> +<userinput>x/bc termbuf,10</userinput> +<userinput>x/s stringbuf</userinput></screen> + + word/halfword/byte 単位でアクセスをおこない, hex (16進) + /dec (10進) / + char (文字) /string (文字列) で表示します. + カンマの後ろの数字はオブジェク + トカウントです. 次の 0x10個の要素を表示するには, 単純に</para> + + <screen><userinput>x ,10</userinput></screen> + + <para>とします. 同様に次のように使うことができます. + + <screen><userinput>x/ia foofunc,10</userinput></screen> + + <function>foofunc</function> + の最初の 0x10個の命令語をディスアセンブルし, + <function>foofunc</function> + の先頭からのオフセットとともに表示します.</para> + + <para>メモリの内容を変更するには writeコマンドを使います.</para> + + <screen><userinput>w/b termbuf 0xa 0xb 0</userinput> +<userinput>w/w 0xf0010030 0 0</userinput></screen> + + <para>コマンドモディファイアの + (<literal>b</literal>/<literal>h</literal>/<literal>w</literal>) + はデータを 書くサイズを定義し, + これに続く最初の式は書き込むアドレス, 残りがこれ + に続く連続するメモリアドレスに書き込まれるデータになります. + </para> + + <para>現在のレジスタ群の内容を知りたい場合は</para> + + <screen><userinput>show reg</userinput></screen> + + <para>とします. また, 単一のレジスタの値を表示するには, 例えば + + <screen><userinput>p $eax</userinput></screen> + + とします. また値の変更は</para> + + <screen><userinput>set $eax new-value</userinput></screen> + + <para>とします.</para> + + <para>DDBからカーネルの関数を呼び出す必要がある場合は, 単に</para> + + <screen><userinput>call func(arg1, arg2, ...)</userinput></screen> + + <para>とします. return 値が出力されます.</para> + + <para>動いているプロセスの &man.ps.1; スタイルの概要は</para> + + <screen><userinput>ps</userinput></screen> + + <para>です.</para> + + <para>カーネルの失敗の原因の調査が終わったらリブートすべきです. + それまでの 不具合によりカーネルのすべての部分が期待するような + 動作をしているわけ ではないということを忘れないでください. + 以下のうちいずれかの方法でシ + ステムのシャットダウンおよびリブートを行ってください.</para> + + <screen><userinput>call diediedie()</userinput></screen> + + <para>カーネルをコアダンプしてリブートしますので, 後で + kgdbによってコアの高 レベル解析をすることができます. + このコマンドは通常 + <command>continue</command>命令にエイリアスされています. + <command>panic</command>にエイリアスされている</para> + + <screen><userinput>call boot(0)</userinput></screen> + + <para> は動いているシステムを `clean' に shut + downするよい方法です. すべて のディスクを + <function>sync()</function>して最後にリブートします. + ディスクとカー + ネルのファイルシステムインタフェースが破損していない限り, + ほぼ完全 に `clean'にシャットダウンするよい方法でしょう.</para> + <!-- kuriyama - ldquo? --> + + <screen><userinput>call cpu_reset()</userinput></screen> + + <para>は大惨事を防ぐための最後の手段で 「赤い大きなボタン」 + を押すのとほとんど 同じです.(訳注: + リセットボタンを押すのとほぼ同じであるという意味です)</para> + + <para>短いコマンドの要約は</para> + + <screen><userinput>help</userinput></screen> + + <para>をタイプします. ただし, デバッグセッションのために + &man.ddb.4; の + マニュアルページのプリントアウトを用意しておくことを + 強くお奨めします. + カーネルのシングルステップ中にオンラインマニュアルを + 読むことは難しい ということを覚えておいてください.</para> + </sect1> + + <sect1> + <title>リモート GDB を使ったオンラインカーネルデバッグ</title> + + <para>この機能は FreeBSD 2.2 からサポートされました. + これは本当にすばらし い機能です.</para> + + <para>GDB はすでにかなり以前より + <emphasis>リモートデバッグ</emphasis> をサポートしてい ます. + これはシリアル回線を使い非常に単純なプロトコルで行ないます. + もちろん, この方法では今までに示した方法とは違い, + 2台のマシンが必 要になります. 1台はデバッグ環境のためのホストで, + すべてのソースとす + べてのシンボルを含んだバイナリのコピーを持っています. もう 1台は + ターゲットマシンで, 同一のカーネルのコピー (ただしデバッグ情報は + 取り除いてあるもの) を単に実行するためのものです.</para> + + <para>この場合, カーネルのコンフィグレーションは <command>config + -g</command> で行な い, <option>DDB</option> + を含めなくてはなりません. そうして通常通りコンパイルし ます. + こうして作ったバイナリファイルはデバッグ情報のために非常に大き + くなります. このカーネルをターゲットマシンにコピーして + <command>strip -x</command> でデバッグシンボルを取り除きます. + そして <option>-d</option> ブートオプションを使いブートします. + ターゲットマシンの 1番目の シリアル回線をデバッグホストの + いずれかのシリアル回線につないでおきま しょう. + それからデバッグ(訳注:ホスト)マシン上で, ターゲットとなって + いるカーネルのコンパイルディレクトリで gdb を起動します:</para> + + <screen>&prompt.user; <userinput>gdb -k kernel</userinput> +GDB is free software and you are welcome to distribute copies of it + under certain conditions; type "show copying" to see the conditions. +There is absolutely no warranty for GDB; type "show warranty" for details. +GDB 4.16 (i386-unknown-freebsd), +Copyright 1996 Free Software Foundation, Inc... +<prompt>(kgdb)</prompt> </screen> + + <para>リモートデバッグセッションの初期化 + (1番目のシリアルポートを使用する ことの設定) + を以下のように行ないます.</para> + + <screen><prompt>(kgdb)</prompt> <userinput>target remote /dev/cuaa0</userinput></screen> + + <para>次にターゲットマシン (デバイスのプローブ直前で DDB + に入っています) で次のように入力します:</para> + + <screen>Debugger("Boot flags requested debugger") +Stopped at Debugger+0x35: movb $0, edata+0x51bc +<prompt>db></prompt> <userinput>gdb</userinput></screen> + + <para>DDB は次のような出力を返すでしょう. </para> + + <screen>Next trap will enter GDB remote protocol mode</screen> + + <para><command>gdb</command>と入力するたびに リモート GDB + とローカル DDB が交互に切り替わ ります. + トラップをすぐに起こすために単に ``s'' (step) と入力して下 さい. + そうするとホストの GDB はターゲットのカーネルの制御を行なうよ + うになります.</para> + + <screen>Remote debugging using /dev/cuaa0 +Debugger (msg=0xf01b0383 "Boot flags requested debugger") + at ../../i386/i386/db_interface.c:257 +<prompt>(kgdb)</prompt></screen> + + <para>このセッションではソースコードへのフルアクセスや Emacs の + window 上 の gud-mode (これは別の Emacs window + に自動的にソースコードを表示し ます) で動かすなど, 通常の GDB + セッションでできることのほとんどのこ とができます.</para> + + <para>リモート GDB は LKM のデバッグも行なうことができます. + 最初に LKM を デバッグシンボルを含めた形で作ります. </para> + + <screen>&prompt.root; <userinput>cd /usr/src/lkm/linux</userinput> +&prompt.root; <userinput>make clean; make COPTS=-g</userinput></screen> + + <para>そしてターゲットマシン上で + モジュールのこのバージョンをインストールし ます. + これをロードしてから, <command>modstat</command> + を使ってロードされている ことを確認してください:</para> + + <screen>&prompt.root; <userinput>linux</userinput> +&prompt.root; <userinput>modstat</userinput> +Type Id Off Loadaddr Size Info Rev Module Name +EXEC 0 4 f5109000 001c f510f010 1 linux_mod</screen> + + <para>示されたロードアドレスに 0x20 + (a.outのヘッダはおそらくこの大きさでしょ う) を加えます. + それがモジュールコードの再配置されるアドレスです. GDB の + <command>add-symbol-file</command> + コマンドを使ってデバッガにモジュールの 情報をつたえます.</para> + +<!-- kuriyama - This part of English is different caused by nik? --> + <screen><prompt>(kgdb)</prompt> <userinput>add-symbol-file /usr/src/lkm/linux/linux_mod.o 0xf5109020</userinput> +add symbol table from file "/usr/src/lkm/linux/linux_mod.o" at +text_addr = 0xf5109020? +(y or n) <userinput>y</userinput> +<prompt>(kgdb)</prompt></screen> + + <para>これで LKM + のすべてのシンボルにアクセスできるようになります.</para> + </sect1> + + <sect1> + <title>コンソールドライバのデバッグ</title> + + <para>DDBを動かすためにはコンソールドライバが必要ですから, + コンソールドラ イバ自身に不具合のある場合は複雑になります. + シリアルコンソールを利 用する方法 (ブートブロックを変更するか + <prompt>Boot:</prompt>プロンプトで + <option>-h</option>と入力する) を思い出してください. + そして標準ター ミナルを最初のシリアルポートに設定します. DDBは, + もちろんシリアルコ ンソールを含むいずれの + コンソールドライバの設定でも動作します.</para> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/kernelopts/chapter.sgml b/ja_JP.eucJP/books/handbook/kernelopts/chapter.sgml new file mode 100644 index 0000000000..6dc0f9cfdd --- /dev/null +++ b/ja_JP.eucJP/books/handbook/kernelopts/chapter.sgml @@ -0,0 +1,213 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.9 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:46:01 kuriyama Exp $ +--> + +<chapter id="kernelopts"> + <title>カーネルコンフィグレーションの + 新しいオプションを追加する</title> + + <para><emphasis>原作: &a.joerg;</emphasis></para> + + <para><emphasis>訳: &a.jp.yoshiaki;. + <!-- <br> --> 29 December 1996.</emphasis></para> + + <note> + <para>この章をお読みになる前に <link + linkend="kernelconfig">FreeBSD + カーネルのコンフィグレーション</link> の章の内容を + 理解しておいてください.</para> + </note> + + <sect1> + <title>そもそも<emphasis>カーネル + オプション</emphasis>って何?</title> + + <para>カーネルオプションの使い方は基本的には + <link linkend="kernelconfig-options"> FreeBSD + カーネルのコンフィグレーション </link> + の章に書いてあります. + そこには “伝統的な形式” と “新しい形式” + のオプションの説明があります. + すべてのカーネルのオプションを新しい形式のものに置き換え, + コンフィグファイル + を修正して &man.config.8; を実行した後に + カーネルのコンパイルディレクトリで + <command>make depend</command> を実行すれば, + ビルドプロセスが自動的に変更された + オプションを検出し, 必要なファイルだけを + 再コンパイルするようにすることが + 最終的な目的です. &man.config.8; + を実行するたびに古いコンパイルディレクトリ + を消してしまう現在のやりかたは, + やがておこなわれなくなるでしょう.</para> + + <para>基本的に, カーネルオプションはカーネルのコンパイルプロセスの + C プリプロセッサのマクロの定義にすぎません. 実際に選択的に make + できる ようにするためには, 対応する部分のカーネルソース + (またはカーネルの <filename>.h</filename> ファイル) + がオプションを使えるようにあらかじめ書かれていなければ + なりません. + つまりデフォルト値をコンフィグファイルのオプションで置き換え + られるようになっていなければなりません. + これは普通は次のようになっています.</para> + + <programlisting> +#ifndef THIS_OPTION +#define THIS_OPTION (some_default_value) +#endif /* THIS_OPTION */</programlisting> + + <para>この場合, + 管理者がコンフィグファイルのオプションに別の値を記述すれば, + デフォルトの設定を打ち消して新しい値に置き換えられます. 当然, + 新しい値はプリプロセッサによってソースコード中で + 置き換えられるため, デフォルトの値が使われていた場所において C + の式として有効な値でなければ なりません.</para> + + <para>また, 単に特定のコードを有効にするか + 無効にするかを設定するための + 値を持たないオプションも作ることができます.</para> + + <programlisting> +#ifdef THAT_OPTION + +[あなたのコードが入ります] + +#endif</programlisting> + + <para>コンフィグファイルに <literal>THAT_OPTION</literal> + と記述するだけで (値の有無 にかかわらず) + 対応する部分のコードが組み込まれます.</para> + + <para>C 言語にくわしい人であれば + “コンフィグオプション” とされているもの + は少なくとも一つの <literal>#ifdef</literal> + で参照されているということはすぐに理解 できるでしょう. ところで, + ごく一部の人たちは次のようなものを試して + みようとするかもしれません.</para> + + <programlisting> +options notyet,notdef</programlisting> + + <para>このようにコンフィグファイルをしておくと, + カーネルのコンパイルは うまく行きません. <!-- smiley + -->:-)</para> + + <para>(訳注: たとえば MATH_EMULATE のように + 有効/無効のためのパラメタを 持たないオプションの場合, + 無効とするためのパラメタをつけて, オプション + で「無効とする」と明示することはできないという意味です)</para> + + <para>明らかに, + 任意のオプション名がカーネルソースツリー全体でどのように + 使われているかを追いかけることは非常に難しいことです. このことが + <emphasis>新しい形式</emphasis> + のオプションの機構を採り入れる理由の背景です. + ここではそれぞれのオプションは + カーネルコンパイルディレクトリにある別々の + <filename>.h</filename> ファイルとなり, + <filename>opt_<replaceable>foo</replaceable>.h</filename> + という名前に されます. この方法では, 通常の Makefile + の依存関係が適用され, <command>make</command> + プログラムはオプションが変更された時に再コンパイルが必要な + ものを見つけることができます.</para> + + <para>古い形式のオプションの機構は, + 局部的なオプションや実験的なオプション + のような一時的に利用されると考えられるオプションにおいては + 有効です. つまり <emphasis remap=tt>#ifdef</emphasis> + をカーネルのソースに追加するのは簡単であり, + それがそのままカーネルコンフィグオプションになります. この場合, + 管理者はオプションの利用において + 依存関係を把握しておく責任があります (また, + 手動でカーネルの一部分を + 強制的に再コンパイルする必要があるかもしれません). + サポートされている + オプションのすべてについて一つでも変更があると, &man.config.8; + は サポートされていないオプションがコンフィグファイルの中に + あるという警告 を出しますが, カーネルの Makefile + 内にはそれを含めます.</para> + </sect1> + + <sect1> + <title>ではどのようにして追加するのでしょう?</title> + + <para>最初に <filename>sys/conf/options</filename> (または + <filename>sys/i386/conf/options.<replaceable><arch></replaceable></filename>, たとえば <filename>sys/i386/conf/options.i386</filename>) + を編集し, 新しいオプション を含めるのに最適な + <filename>opt_<replaceable>foo</replaceable>.h</filename> + ファイルを選びます.</para> + + <para>新しいオプションの必要がなくなったとしたら, + これを取り除きます. たとえば, SCSI + サブシステムに関するすべてのふるまいについてのオプション + の変更は <filename>opt_scsi.h</filename> に入れられます. + デフォルトでは, 適切 なオプションファイルに単に記述されます. + たとえば <literal>FOO</literal> であれば 値は対応するファイルの + <filename>opt_foo.h</filename> に格納されます. これは右端に別 + のファイル名を書いて置き換えることができます.</para> + + <para>新しいオプションを加えるのに使えそうな + <filename>opt_<replaceable>foo</replaceable>.h</filename> + がない場合は新しい名前を作ってください. 意味のある名前を作り + <filename>options[<replaceable>.<arch></replaceable>]</filename> + ファイル に新しいセクションのコメントをつけてください. + &man.config.8; は自動的 + に変更を検出して, 次の実行からは (訳注: 新しい + <filename>.h</filename>) ファイル を作ります. + ほとんどのオプションはヘッダファイルに入れられます.</para> + + <para>大量のオプションを一つの + <filename>opt_<replaceable>foo</replaceable>.h</filename> + にまとめると + コンフィグファイルの一つのオプションを変更したときに + 多くのファイルが 再コンパイルされる原因になります.</para> + + <para>新しいオプションに依存するカーネルファイルは + 最終的には見つけ出 されます. ただし, + オプションを作っただけで対応するソースがどこにも + ない場合は別です. + + <screen>&prompt.user; <userinput>find /usr/src/sys -name type f | xargs fgrep NEW_OPTION</userinput></screen> + + オプションに対応するソースを見つけるのに上記のコマンドは + 便利です. 見つけたすべてのファイルで編集, 追加をおこないます. + + <programlisting>#include "opt_foo.h"</programlisting> + + <emphasis>ファイルの先頭の</emphasis>, すべての + <literal>#include <xxx.h></literal> より前に入れます. + この場合, オプションによって次のようにしてデフォルト値 + を持たせている標準のヘッダファイル内の値を置き換えるため, + 順番は非常に 重要です. + + <programlisting>#ifndef NEW_OPTION +#define NEW_OPTION (something) +#endif</programlisting> + + システムヘッダファイル (たとえば + <filename>/usr/include/sys/</filename> にある ファイル) + をオプションで置き換えることは, ほとんどの場合で失敗します. + そうすると, ヘッダファイルを深刻な状態に破壊してしまうので, + include しないとオプションの値によって + 不整合が起きてしまう場合を除き, それらの ファイルに + <filename>opt_<replaceable>foo</replaceable>.h</filename> + を include しないでください. + そう, 現在このような例がいくつか存在していますが, + 必ずしも正しい方法 ではありません.</para> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/l10n/chapter.sgml b/ja_JP.eucJP/books/handbook/l10n/chapter.sgml new file mode 100644 index 0000000000..857d7e2069 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/l10n/chapter.sgml @@ -0,0 +1,375 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.9 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:59 kuriyama Exp $ +--> + +<chapter id="l10n"> + <title>ローカル化</title> + + <sect1 id="russian"> + <title>ロシア語 (KOI8-R encoding)</title> + + <para><emphasis>Contributed by &a.ache;<!-- <br> --> + 1 May 1997</emphasis>.</para> + + <para><emphasis>訳: &a.motoyuki;. + <!-- <br> -->18 June 1997.</emphasis></para> + + <para>KOI8-R encoding についてのさらに詳しいことは, <ulink + URL="http://www.nagual.pp.ru/~ache/koi8.html">KOI8-R + References (Russian Net Character Set)</ulink> + をご覧ください.</para> + + <sect2 id="russian-console"> + <title>コンソールのセットアップ</title> + + <procedure> + <step> + <para>マウスカーソルのために用いられている文字コードを + KOI8-R 擬似グラフィックの範囲外に動かすために, + カーネルのコンフィグレーションファイルに + 以下の行を付け加えます.</para> + + <programlisting> +options "SC_MOUSE_CHAR=0x03"</programlisting> + </step> + + <step> + <para><filename>/etc/rc.conf</filename> + でのロシア語コンソールの + エントリーは以下のようになります.</para> + + <programlisting> +keymap=ru.koi8-r +keychange="61 ^[[K" +scrnmap=koi8-r2cp866 +font8x16=cp866b-8x16 +font8x14=cp866-8x14 +font8x8=cp866-8x8</programlisting> + + <note> + <para>^[ は + <filename>/etc/rc.conf</filename>, + に ^[ の文字列ではなく本当の + ESC キャラクターを入れることを意味します.</para> + </note> + + <para>これは, KOI8-R キーボードで, KOI8-R encoding + の代替スクリーンフォントを 疑似グラフィックに割り当て, + <literal>灰色のデリート</literal> キーを + &man.termcap.5; の FreeBSD + コンソールのロシア語エントリーに一致するように再配置する, + ということです.</para> + + <para>RUS/LAT スイッチは <literal>CapsLock</literal> + に割り当てられます. 元の CapsLock の機能は + <literal>Shift+CapsLock</literal> で使えます. CapsLock の + LED は CapsLock のモードではなく RUS + モードを示します.</para> + </step> + + <step> + <para><filename>/etc/ttys</filename> の中の + <literal>ttyv?</literal> の各エントリの + ターミナルのタイプを <literal>cons25</literal> から + <literal>cons25r</literal> に変更します, + つまり各エントリは以下のようになります</para> + + <programlisting> +ttyv0 "/usr/libexec/getty Pc" cons25r on secure</programlisting> + </step> + </procedure> + </sect2> + + <sect2 id="russian-locale"> + <title>Locale のセットアップ</title> + + <para><anchor id="russian-env"> Locale + のセットアップには二つの環境変数を使います:</para> + + <itemizedlist> + <listitem> + <para><envar>LANG</envar> + は POSIX &man.setlocale.3; ファミリの関数に;</para> + </listitem> + + <listitem> + <para><envar>MM_CHARSET</envar> はアプリケーションの MIME + キャラクタセットに使われます.</para> + </listitem> + </itemizedlist> + + <para>一番良い方法は &man.passwd.5; エントリの login class + の場所で + <filename>/etc/login.conf</filename> の + <literal>russian</literal> ユーザの login class + を使うことです. + 詳しくは &man.login.conf.5; を参照してください.</para> + + <sect3 id="russian-class"> + <title>Login Class の設定方法</title> + + <para>まず最初に <filename>/etc/login.conf</filename> に + <literal>russian</literal> login class がある + ことを確認してください, + このエントリは以下のようになります:</para> + + <programlisting> +russian:Russian Users Accounts:\ + :charset=KOI8-R:\ + :lang=ru_RU.KOI8-R:\ + :tc=default:</programlisting> + + <sect4> + <title>&man.vipw.8; ではどうするのか</title> + + <para>新しいユーザを追加するのに &man.vipw.8; + を使うのであれば, + <filename>/etc/master.passwd</filename> + のエントリは以下のようになります:</para> + + <programlisting> +user:password:1111:11:russian:0:0:User Name:/home/user:/bin/csh</programlisting> + </sect4> + + <sect4> + <title>&man.adduser.8; ではどうするのか</title> + + <para>&man.adduser.8; を使って新しいユーザを追加するには:</para> + + <itemizedlist> + <listitem> + <programlisting> +defaultclass = russian</programlisting> + + <para>を <filename>/etc/adduser.conf</filename> + にセットする. (この場合, 全ての非ロシア語ユーザに + <literal>default</literal> class を入力しなけ + ればなりません);</para> + </listitem> + + <listitem> + <para>もう一つの方法は &man.adduser.8; の + + <screen><prompt>Enter login class:</prompt> default []:</screen> + + という表示に <literal>russian</literal> + と答えるものです;</para> + </listitem> + + <listitem> + <para>また, ロシア語ユーザを追加する際に: + + <screen>&prompt.root; <userinput>adduser -class russian</userinput></screen> + + とする方法もあります.</para> + </listitem> + </itemizedlist> + </sect4> + + <sect4> + <title>&man.pw.8; ではどうするのか</title> + + <para>&man.pw.8; を使って新しいユーザを追加するには, + 次のようにします:</para> + + <screen>&prompt.root; <userinput>pw useradd user_name -L russian</userinput></screen> + </sect4> + </sect3> + + <sect3> + <title>シェルのスタートアップファイルでの設定方法</title> + + <para>何らかの理由で + <link linkend="russian-class">login class の設定方法</link> + を使いたくない場合は, この + <link linkend="russian-env">二つの環境変数</link> + をシェルのスタートアップファイルに設定します:</para> + + <itemizedlist> + <listitem> + <para><filename>/etc/profile</filename>:</para> + + <programlisting> +LANG=ru_RU.KOI8-R; export LANG +MM_CHARSET=KOI8-R; export MM_CHARSET</programlisting> + </listitem> + + <listitem> + <para><filename>/etc/csh.login</filename>:</para> + + <programlisting> +setenv LANG ru_RU.KOI8-R +setenv MM_CHARSET KOI8-R</programlisting> + </listitem> + </itemizedlist> + + <para>もう一つの方法は, これらを以下のファイルに + 設定することです.</para> + + <itemizedlist> + <listitem> + <para><filename>/usr/share/skel/dot.profile</filename>:</para> + + <para>(上の <filename>/etc/profile</filename> と同様にします); + </para> + </listitem> + + <listitem> + <para><filename>/usr/share/skel/dot.login</filename>:</para> + + <para>(上の <filename>/etc/csh.login</filename> と同様にします). + </para> + </listitem> + </itemizedlist> + </sect3> + </sect2> + + <sect2 id="russian-printer"> + <title>プリンターのセットアップ</title> + + <para>ロシア語の文字を内蔵したプリンターのほとんどは CP866 + というハードウェアコードページを塔載しているため, KOI8-R → + CP866 の変換用に特別な出力フィルターが必要となります. + そのようなフィルターは, + <filename>/usr/libexec/lpr/ru/koi2alt</filename> + としてデフォルトでインストールされていますので, + <filename>/etc/printcap</filename> + のロシア語プリンター用のエントリーは次のようになります.</para> + + <programlisting> +lp|Russian local line printer:\ + :sh:of=/usr/libexec/lpr/ru/koi2alt:\ + :lp=/dev/lpt0:sd=/var/spool/output/lpd:lf=/var/log/lpd-errs:</programlisting> + + <para><filename>/etc/printcap</filename> ファイルの詳細については + &man.printcap.5; + を参照して下さい.</para> + </sect2> + + <sect2 id="russian-msdosfs"> + <title>MSDOS ファイルシステムとロシア語のファイル名</title> + + <para>MSDOS ファイルシステムにおいてロシア語のファイル名を + サポートするには, 次の + &man.fstab.5; エントリーの例を参考にしてください.</para> + + <programlisting> +/dev/sd0s1 /dos/c msdos rw,-W=koi2dos,-L=ru_RU.KOI8-R 0 0</programlisting> + + <para><option>-W</option> と <option>-L</option> + というオプションに関する詳細は + &man.mount.msdos.8; をご覧ください.</para> + </sect2> + + <sect2 id="russian-xwindow"> + <title>X Window System のセットアップ</title> + + <para>以下の順序で設定します:</para> + + <procedure> + <step> + <para>まず最初に <link linkend="russian-locale">X 以外の + locale のセットアップ</link> の通りに行います.</para> + + <note> + <para><anchor id="russian-note"> ロシア語の KOI8-R locale + は XFree86 の古いリリース (3.3 より前) + では動かないかもしれません. + <filename>/usr/ports/x11/XFree86</filename> の XFree86 + の port には XFree86 の最近のほとんどの + バージョンが入っています. したがってこの port から + XFree86 をインストール したのならきちんと動くでしょう. + 最新の FreeBSD ディストリビューションに付属する XFree86 + のバージョンも動くはず です (XFree86 のバージョンが 3.3 + より前でないことを確認して下さい).</para> + </note> + </step> + + <step> + <para><filename>/usr/ports/russian/X.language</filename> + ディレクトリに行き, ここで + + <screen>&prompt.root; <userinput>make all install</userinput></screen> + + とします. このポートは最新バージョンの KOI8-R + フォントをインストールします. + XFree86 3.3 には既にいくつかの KOI8-R + フォントが含まれていますが, こちらの + フォントのほうがより釣り合いがとれています.</para> + + <para><filename>/etc/XF86Config</filename> の + <literal>"Files"</literal> セクションに以下の行が + 他のどんな <literal>FontPath</literal> + エントリよりも前にあることを確認します:</para> + + <programlisting> +FontPath "/usr/X11R6/lib/X11/fonts/cyrillic/misc" +FontPath "/usr/X11R6/lib/X11/fonts/cyrillic/75dpi" +FontPath "/usr/X11R6/lib/X11/fonts/cyrillic/100dpi"</programlisting> + + <para>高解像度のビデオモードを使っている場合は, 75 dpi と + 100 dpi の行を入れ替えます.</para> + </step> + + <step> + <para>ロシア語キーボードを有効にするには + + <programlisting> +XkbKeymap "xfree86(ru)"</programlisting> + + を <filename>/etc/XF86Config</filename> の + <literal>"Keyboard"</literal> セクションに追加します, + また <literal>XkbDisable</literal> が無効に + (コメントアウト) されていることをここで + 確認します.</para> + + <para>RUS/LAT スイッチは + <literal>CapsLock</literal>に割り当てられます. 元の + CapsLock の機能は <literal>Shift+CapsLock</literal> + で使えます (LAT モード内でのみ).</para> + + <note> + <para>ロシア語 XKB キーボードは XFree86 + の古いバージョンでは動かないかもしれません, 詳しくは + <link linkend="russian-note">locale note</link> + を参照してください. ロシア語 XKB + キーボードはローカル化されていないアプリケーション + でも動かない かもしれません, + 最低限のローカル化されたアプリケーションでは + そのプログラムの 初期に <literal>XtSetLanguageProc(NULL, + NULL, NULL); </literal> 関数を呼ばなければ + なりません.</para> + </note> + </step> + </procedure> + </sect2> + </sect1> + + <sect1 id="german"> + <title>ドイツ語(ISO 8859-1)</title> + + <para>Slaven Rezic + <email>eserte@cs.tu-berlin.de</email> + が FreeBSD上でウムラウトを使う方法についての + チュートリアルを書きました. + チュートリアルはドイツ語で書かれていて, + <ulink URL="http://www.de.freebsd.org/de/umlaute/"> + http://www.de.freebsd.org/de/umlaute/</ulink> + でご覧になれます.</para> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/linuxemu/chapter.sgml b/ja_JP.eucJP/books/handbook/linuxemu/chapter.sgml new file mode 100644 index 0000000000..5ea6f7bd17 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/linuxemu/chapter.sgml @@ -0,0 +1,923 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.11 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:57 kuriyama Exp $ +--> + +<chapter id="linuxemu"> + <title>Linux エミュレーション</title> + + <para><emphasis>原作: &a.handy; and &a.rich;</emphasis></para> + + <para><emphasis>訳: &a.jp.kiroh;.<!-- <br> --> + 24 September 1996.</emphasis></para> + + <sect1> + <title>Linux エミュレータのインストール</title> + + <para>FreeBSD での Linux エミュレーションは, 大部分の Linux + バイナリ(a.out および ELF + フォーマット)を実行できる状態になっています. 2.1-STABLE ブラン + チでのエミュレーションでは, Linux DOOM や Mathematica + が実行できます. &rel.current;-RELEASE でのエミュレーションは, + さらに強化されており, Linux 用 の Quake, Abuse, IDL, netrek + など, 多数のソフトウェアが実行できます.</para> + + <para>Linux + オペレーティングシステムには, 特有の機能がいくつかあり, FreeBSD + でサポートされていないものもあります. Linux の + <filename>/proc</filename> ファイルシステム を使ったバイナリは, + FreeBSD では実行できません (FreeBSD で使用可能な + <filename>/proc</filename> + ファイルシステムとは仕様が異なっているためです). + また仮想8086モー ドを有効にするなど, i386 + に特有なシステムコールを使っている場合も実行 できません.</para> + + <para>Linux エミュレーションの設定方法は, 使用している FreeBSD + のバージョン によって多少異なっています.</para> + + <sect2> + <title>2.1-STABLE への Linux エミュレーションのインストール</title> + + <para>2.1-STABLE の <filename>GENERIC</filename> カーネルは, + Linux との互換性を保つように構築 されていません. + カーネルの再構築が必要です. 再構築をおこなうには, 2つの方 + 法があります. 1つは, + エミュレータをカーネル自体にスタティックリンクす る方法. + もう1つは, 動的に Linux + ローダブルカーネルモジュール(LKM)をロー + ドするようにする方法です.</para> + + <para>エミュレータを有効にするには, + 以下をコンフィグレーションファイル + (<filename>/sys/i386/conf/LINT</filename> など) + に追加します.</para> + + <programlisting> +options COMPAT_LINUX</programlisting> + + <para>Linux DOOM などのアプリケーションを実行したい場合は, + 共有メモリも有効 にしておかなければなりません. + 以下を追加します.</para> + + <programlisting> +options SYSVSHM</programlisting> + + <para>Linux のシステムコールを使用するには, 4.3BSD + のシステムコールとの互換 性が保たれていることが必要です. + 以下の行が含まれていることを確認してく ださい.</para> + + <programlisting> +options "COMPAT_43"</programlisting> + + <para>LKM + を使用せずエミュレータをカーネルにスタティックにリンクしたい場合は, 以下の行を追加します.</para> + + <programlisting> +options LINUX</programlisting> + + <para><link linkend="kernelconfig"> FreeBSD + カーネルのコンフィグレーション </link> の節の記述に + したがって config と, + 新しいカーネルのインストールをおこなってください.</para> + + <para>LKM を使用する場合は, + ローダブルモジュールをインストールしなければなり ません. + カーネルとローダブルモジュールのバージョンが異なると, カーネル + がクラッシュする場合がありますので, 安全を期すためには, + カーネルをイン ストールするごとに, LKM + も再インストールしてください.</para> + + <screen>&prompt.root; <userinput>cd /usr/src/lkm/linux</userinput> +&prompt.root; <userinput>make all install</userinput></screen> + + <para>カーネルと LKM のインストールが終了したら, root で `linux' + コマンドを 実行することで LKM をロードできます.</para> + + <screen>&prompt.root; <userinput>linux</userinput> +Linux emulator installed +Module loaded as ID 0 +&prompt.root; </screen> + + <para>LKM がロードされたかどうかを確認するには, + <command>modstat</command> を実行します.</para> + + <screen>&prompt.user; modstat +Type Id Off Loadaddr Size Info Rev Module Name +EXEC 0 3 f0baf000 0018 f0bb4000 1 linux_emulator</screen> + + <para>システムブート時に, LKM をロードするようにするには, + 2つの方法がありま + す. FreeBSD 2.2.1-RELEASE または 2.1-STABLE では, + <filename>/etc/sysconfig</filename> を, + + <programlisting> +linux=YES</programlisting> + + のように, NO を YES に変更してください. + FreeBSD 2.1-RELEASE およびそれ以 + 前のバージョンでは, そのような行はありませんので, + <filename>/etc/rc.local</filename> に以下 + の行を追加する必要があります.</para> + + <programlisting> +linux</programlisting> + </sect2> + + <sect2> + <title>2.2-RELEASE への Linux エミュレーションのインストール</title> + + <para><literal>options LINUX</literal> や <literal>options + COMPAT_LINUX</literal> を指定する必要 はなくなりました. + Linux エミュレーションは + LKM(“ローダブルカーネルモジュール”) を使用して, + リブートせず簡単にインストールできます. スタートアッ + プファイルで以下のように指定します.</para> + + <orderedlist> + <listitem> + <para><filename>/etc/rc.conf</filename> + に以下の行が必要です.</para> + + <programlisting> +linux_enable=YES</programlisting> + </listitem> + + <listitem> + <para>これは結果的に, <filename>/etc/rc.i386</filename> + の以下の指定を有効にします.</para> + + <programlisting> +# Start the Linux binary emulation if requested. +if [ "X${linux_enable}" = X"YES" ]; then echo -n ' + linux'; linux > /dev/null 2>&1 +fi</programlisting> + </listitem> + </orderedlist> + + <para>実行されたかどうかを確認するには, modstat + を使用します.</para> + <!-- kuriyama - command? --> + + <screen>&prompt.user; modstat +Type Id Off Loadaddr Size Info Rev Module Name +EXEC 0 4 f09e6000 001c f09ec010 1 linux_mod</screen> + + <para>2.2-RELEASE とそれ以降のシステムの中には, + modstat の実行がうまくいかない + ものがあるという報告もあります. + 何らかの理由で, Linux LKM がロードできな + い場合は, + + <programlisting> +options LINUX</programlisting> + + をカーネルの設定ファイルに指定して, + エミュレータをスタティックにリンク + してください. + <link linkend="kernelconfig"> + FreeBSDカーネルのコンフィグレーション</link> + の節の記述にしたがって config と, + 新しいカーネルのインストールをおこ + なってください.</para> + </sect2> + + <sect2> + <title>Linux ランタイムライブラリのインストール</title> + + <sect3> + <title>linux_lib port を使用してのインストール</title> + + <para>多くの Linux + アプリケーションはシェアードライブラリを使用しますので, + シェアードライブラリのインストールが終了しなければ, + エミュレータのイン ストールは終わったことになりません. + 手動でもインストールできますが, linux_lib port + を使用するのが簡単です.</para> + + <screen>&prompt.root; <userinput>cd /usr/ports/emulators/linux_lib</userinput> +&prompt.root; <userinput>make all install</userinput></screen> + + <para>これで, Linux + エミュレータが動作するようになったはずです. 伝説(とメー + ルのアーカイブ <!-- smiley --> :-) によれば, Linux + エミュレーションは, ZMAGIC ライブラ リとリンクされている + Linux バイナリに対して, 最もうまく動作するようで す. + Slackware V2.0 などに使われている QMAGIC ライブラリだと, + エミュレー タが胸やけするかもしれません. + マイナーバージョンの不一致などを + 報告するプログラムもありますが, + 普通は 問題にならないようです.</para> + </sect3> + + <sect3> + <title>手動でのライブラリのインストール</title> + + <para>“ports” + ディストリビューションが手元にない場合は, 手動でライブラ + リをインストールする必要があります. プログラムが必要とする + Linux のシェ アードライブラリとラインタイムリンカが必要です. + また Linux ライブラリ の用の``shadow root'' ディレクトリ, + <filename>/compat/linux</filename>, を作成する必要があ + ります. FreeBSD で動作する Linux + のプログラムが使用するシェアードライ + ブラリは,まずこのファイルツリーから検索されます. 例えば, + Linux のプロ グラムが <filename>/lib/libc.so</filename> + をロードしようとした場合には, FreeBSD は, まず + <filename>/compat/linux/lib/libc.so</filename> + を開こうとします. 存在にしなかった場合には, 次に + <filename>/lib/libc.so</filename> を試します. + シェアードライブラリは, Linux の <command>ld.so</command> + が参照するライブラリではなく, + <filename>/compat/linux/lib</filename> + 以下にインストールする 必要があります.</para> + + <!-- kuriyama - why command? --> + <para>FreeBSD 2.2-RELEASE 以降では, + <command>/compat/linux</command> + にかかわる動作が多少異なっており, + ライブラリだけでなくすべてのファイルが, “shadow + root” /compat/linux + から検索されるようになっています.</para> + + <para>Linux のプログラムが必要とする + シェアードライブラリを探す必要があるのは, FreeBSD + のシステムに Linux + のプログラムをインストールする最初の数回だ けでしょう. + それが過ぎれば, 十分な Linux のシェアードライブラリがシス + テムにインストールされ, 新しくインストールした Linux + のバイナリも, 余 + 計な作業をせずに動作させることができるようになります.</para> + </sect3> + + <sect3> + <title>シェアードライブラリの追加</title> + + <para><filename>linux_port</filename> をインストールした後に, + アプリケーションが必要なライブラリ + が存在しないというエラーを出したらどうしたらよいでしょうか? + Linux のバ イナリがどのシェアードライブラリを必要とし, + そしてどこで入手できるか, どのように探したらよいでしょうか? + 基本的には, 以下の2種類の方法があり + ます(以下の手順にしたがう場合には, + 必要なインストール作業をおこなう FreeBSD シ ステム上で root + として作業をおこなう必要があります).</para> + + <para>Linux システムを使用でき, + 必要なシェアードライブラリが調べられる場 合には, 単に + FreeBSD のシステムにそのライブラリをコピーするだけで す. + 例えば, DOOM の Linux バイナリを ftp で持ってきたとします. + 使用で きる Linux システムの上に転送して, <command>ldd + linuxxdoom</command> とやれば, 必要とす + るシェアードライブラリがチェックできます.</para> + + <screen>&prompt.user; <userinput>ldd linuxxdoom</userinput> +libXt.so.3 (DLL Jump 3.1) => /usr/X11/lib/libXt.so.3.1.0 +libX11.so.3 (DLL Jump 3.1) => /usr/X11/lib/libX11.so.3.1.0 +libc.so.4 (DLL Jump 4.5pl26) => /lib/libc.so.4.6.29</screen> + + <para>最後のカラムに表示されている + すべてのファイルを持って来て, + <filename>/compat/linux</filename> の下 に置き, + 最初のカラムに示されるファイル名から + シンボリックリンクを張る必 要があります. すなわち, FreeBSD + のシステムで, 以下のようなファイルが必 要となります.</para> + + <!-- kuriyama - Here of English ver. should be checked. --> + <screen>/compat/linux/usr/X11/lib/libXt.so.3.1.0 +/compat/linux/usr/X11/lib/libXt.so.3 -> libXt.so.3.1.0 +/compat/linux/usr/X11/lib/libX11.so.3.1.0 +/compat/linux/usr/X11/lib/libX11.so.3 -> libX11.so.3.1.0 +/compat/linux/lib/libc.so.4.6.29 +/compat/linux/lib/libc.so.4 -> libc.so.4.6.29</screen> + + <note> + <para>最初のカラムに表示されているファイルと, + メジャーバージョンの同じ Linux + シェアードライブラリを既にインストールしている場合は, + 新たにコピーする 必要はありません. + 既にあるライブラリで動作するはずです. ただ, 新しいバー + ジョンのシェアードライブラリがある場合は, + 新しいものをコピーすることを お奨めします. + 新しいライブラリにシンボリックリンクを変更したら, 古いラ + イブラリは削除してかまいません. + + <screen>/compat/linux/lib/libc.so.4.6.27 +/compat/linux/lib/libc.so.4 -> libc.so.4.6.27</screen> + + 以上のようなライブラリがインストールされており, + 新しいバイナリに対する + <command>ldd</command> の出力が + 以下のようになる場合を考えます.</para> + + <screen>libc.so.4 (DLL Jump 4.5pl26) -> libc.so.4.6.29</screen> + + <para>このように最後の番号が1つか2つ古いだけならば, 普通は + <filename>/lib/libc.so.4.6.29</filename> + をコピーする必要はありません. わずかに古いライブラ リでも, + プログラムは動作するはずだからです. もちろん, + 新しいライブラリ と置き換えて, + 以下のようにしても構いません.</para> + + <screen>/compat/linux/lib/libc.so.4.6.29 +/compat/linux/lib/libc.so.4 -> libc.so.4.6.29</screen> + </note> + + <note> + <para>シンボリックリンクのメカニズムは, Linux + バイナリに<emphasis>のみ</emphasis>必要 + なことに注意してください. FreeBSD のランタイムリンカは, + メジャーリビジョ + ン番号の一致したライブラリを検索しますから, + ユーザが気にする必要はあり ません.</para> + </note> + </sect3> + + <sect3> + <title><filename>ld.so</filename> の設定 — FreeBSD + 2.2-RELEASE およびそれ以降</title> + + <para>このセクションは, FreeBSD 2.2-CURRENT + 以降にのみ当てはまります. 2.1-STABLE を使用している方は, + 飛ばしてください.</para> + + <para>最後に, FreeBSD 2.2-RELEASE を使われている場合は, Linux + のランタイムリンカと + その設定ファイルがシステムに導入されていることを + 確認してください. これらのファイルは, FreeBSD + システムの適切な位置(<filename>/compat/linux</filename> + ツリー以 下)にコピーされている必要があります.</para> + + <screen>/compat/linux/lib/ld.so +/compat/linux/etc/ld.so.config</screen> + + <para>使用できる Linux システムがない場合は, + 必要なファイルは近くの FTP サイ トから入手してください. + 各種ファイルの入手先についての情報を, 後に付 けておきます. + ここでは, 必要なファイルの入手先がわかっているものとしま + す.</para> + + <para>以下のファイルを取得します + (バージョンの不一致を避けるために, すべて同一 の FTP + サイトから入手してください). 取得したファイルを + <filename>/compat/linux</filename> + 以下にインストールしてください(例えば, + <filename>/foo/bar</filename> は, + <filename>/compat/linux/foo/bar</filename> + にインストールされます).</para> + + <screen>/sbin/ldconfig +/usr/bin/ldd +/lib/libc.so.x.y.z +/lib/ld.so</screen> + + <para><command>ldconfig</command> と <command>ldd</command> + は, <filename>/compat/linux</filename> + の下にある必要はありません. システム + のどこにあっても構いません. ただ, FreeBSD + の同名のコマンドと間違えないように 注意してください. + <filename>/usr/local/bin</filename> の中に, + <command>ldconfig-linux</command>, + <command>ldd-linux</command> とし + てインストールするのもよいアイディアでしょう.</para> + + <para><filename>/compat/linux/etc/ld.so.conf</filename> + ファイルを作成し, Linux ラインタイムリンカ + がシェアードライブラリを検索する + ディレクトリを記述してください. このファ + イルはプレインテキストファイルで, + それぞれの行にディレクトリ名を含みま す. + <filename>/lib</filename> と <filename>/usr/lib</filename> + は標準ですから, 以下のようなディレクトリが追加できま + す.</para> + + <programlisting> +/usr/X11/lib +/usr/local/lib</programlisting> + + <para>Linux バイナリが, <filename>/lib/libc.so</filename> + というライブラリを開いた場合, エミュレー タは内部で, + ファイル名を <filename>/compat/linux/lib/libc.so</filename> + にマップします. エ ミュレータがライブラリを検索するために, + すべての Linux のライブラリ + (<filename>/compat/linux/lib/libc.so</filename>, + <filename>/compat/linux/usr/X11/lib/libX11.so</filename> + など) は, /compat/linux + 以下にインストールされていなければなりません.</para> + + <para>FreeBSD 2.2-RELEASE を使用している場合は, Linux の + ldconfig プログラム を実行する必要があります.</para> + + <screen>&prompt.root; <userinput>cd /compat/linux/lib</userinput> +&prompt.root; <userinput>/compat/linux/sbin/ldconfig</userinput></screen> + + <para><command>ldconfig</command> + はスタティックリンクされていますから, + 実行するのにシェアードラ イブラリを必要としません. ldconfig + は, <filename>/compat/linux/etc/ld.so.cache</filename> + ファイルを作成し, + すべてのシェアードライブラリの名前を格納します. ライ + ブラリの追加をおこなった場合には, ldconfig を再実行して, + このファイルを作り 直さなければなりません.</para> + + <para>2.1-STABLE では, + <filename>/compat/linux/etc/ld.so.cache</filename> + をインストールしたり, <command>ldconfig</command> + を実行したりしないでください. 2.1-STABLE では, システムコー + ルの実装方法が異なるため, <command>ldconfig</command> + は使用されません.</para> + + <para>これで, libc シェアードライブラリを必要とする Linux + バイナリを実行する設 定が終了しました. + <command>ldd</command> を <command>ldd</command> + 自身に実行してテストしてください. + <command>ldd-linux</command> + としてインストールしている場合は, 以下のような結果になるはず + です.</para> + + <screen>&prompt.root; <userinput>ldd-linux `which ldd-linux`</userinput> +libc.so.4 (DLL Jump 4.5pl26) => /lib/libc.so.4.6.29</screen> + + <para>ここまで終了すれば, 新しい Linux のバイナリを + インストールできます. + 新しい Linux バイナリをインストールするときは, + それがシェアードライブ + ラリを必要とするかどうか確認してください. 必要とする場合は, + <filename>/compat/linux</filename> 以下に + インストールされているかどうか確認してください. こ + れは, Linux の <command>ldd</command> を新しいプログラムに + 対して実行し, 出力を確認するこ + とによりおこなえます. + <command>ldd</command> + (&man.ldd.1; マニュアルページも参照してください)は, プ + ログラムが必要とするシェアードライブラリのリストを, + <literal><replaceable>majorname</replaceable> + (<replaceable>jumpversion</replaceable>) => + <replaceable>fullname</replaceable></literal> + という形式で出力します.</para> + + <para><replaceable>fullname</replaceable> のかわりに + <literal>not found</literal> と出力される場合は, + ライブラリの追加をす る必要があります. + 必要なライブラリの名前は, majorname に <!-- kuriyama - Eng: + mm? --> <literal> lib<replaceable>XXXX</replaceable> + .so.<replaceable>N.mm</replaceable></literal> + という形式で示されています. Linux の FTP サイトで <filename> + lib<replaceable>XXXX</replaceable>.so.N.mm</filename> + を探し, インストールしてください. <replaceable> + XXXX</replaceable>(名前)と<replaceable>N</replaceable> + (メジャー リビジョン番号)は一致している必要があります. + マイナー番号 <replaceable>mm</replaceable> は, それほ + ど重要ではありませんが, + なるべく最新のものをインストールするようにして + ください.</para> + </sect3> + </sect2> + + <sect2> + <title>Linux の ELF バイナリをインストールする</title> + + <para>ELF のバイナリを使うためには, + “焼き印を押す(branding)” 作業が必要になります. + 焼き印を押していない ELF バイナリを実行しようとすると, + 以下のようなエラーメッセージを + うけとってしまうことでしょう.</para> + + <screen>&prompt.user; <userinput>./my-linux-elf-binary</userinput> +ELF binary type not known +Abort</screen> + + <para>カーネルが FreeBSD の ELF バイナリと Linux のバイナリとを + 見分けられるようにするためには, &man.brandelf.1; + を以下のようにして使ってください:</para> + + <screen>&prompt.user; <userinput>brandelf -t Linux my-linux-elf-binary</userinput></screen> + + <para>今ではGNU のツールたちが, + ELFバイナリに自動的に適切な焼き印を押すようになったので, + 今後はこの作業もだんだんと必要なくなってゆくでしょう.</para> + </sect2> + + <sect2> + <title>ホストネームリゾルバの設定</title> + + <para>DNS がうまく動作しなかったり, + 以下のようなエラーメッセージが表示され + る場合は, <filename>/compat/linux/etc/host.conf</filename> + ファイルを設定する必要があります. + + <!-- kuriyama - Check English version of here --> + <screen>resolv+: "bind" is an invalid keyword +resolv+: "hosts" is an invalid keyword</screen> + + ファイルの内容を以下のように設定してください. + + <programlisting> +order hosts, bind +multi on</programlisting> + + ここで, order は <filename>/etc/hosts</filename> を最初に検索し, + 次にDNSを検索するように指定 + します. <filename>/compat/linux/etc/host.conf</filename> + がインストールされていない場合は, + Linux のアプリケーションは, FreeBSD の + <filename>/etc/host.conf</filename> を使用しようとして, + 文法の違いによる警告を表示します. + <filename>/etc/resolv.conf</filename> を使用してネームサー + バを設定していない場合には, + <literal>bind</literal> を削除してください.</para> + + <para>最後になりますが, 2.1-STABLE を使用している場合は, + <envar>RESOLV_HOST_CONF</envar> 環境変数を指定して, + アプリケーションにホストテーブル + の検索方法を指定する必要があります. FreeBSD 2.2-RELEASE + かそれ以降を使用している場合 は, スキップしてください. + <filename>/bin/csh</filename> を使っている場合は, + 以下のようにし ます.</para> + + <screen>&prompt.user; <userinput>setenv RESOLV_HOST_CONF /compat/linux/etc/host.conf</userinput></screen> + + <para><filename>/bin/sh</filename>の場合は, + 以下のようにします.</para> + + <screen>&prompt.user; <userinput>RESOLV_HOST_CONF=/compat/linux/etc/host.conf; export RESOLV_HOST_CONF</userinput></screen> + </sect2> + + <sect2> + <title>必要なファイルを探すには</title> + + <note> + <para>以下の情報は, この文書が書かれた時点では有効ですが, FTP + サイトの 名前, ディレクトリ, 配布ファイル名などは, + 変更されている可能性がありま す.</para> + </note> + + <note> + <para>訳注: ここに取り上げられている FTP サイトは, + 日本国内にもミラーサイト が多数存在します. なるべく近くの + FTP サイトからファイルを入手してくだ さい.</para> + </note> + + <para>Linux は, いくつかのグループが, + それぞれ独自のバイナリ配布セットを作成 して配布しています. + 配布セットは, “Slackware” や + “Yggdrasil” など の名前がつけられています. + これらの配布セットは, 多くの FTP サイトから 入手できます. + ファイルが展開されており, 必要なファイルのみを取得できる + 場合もありますが, + 通常は圧縮された配布セットの形で入手できます. 配布 セットは, + いくつかのサブディレクトリに, gzip で圧縮された tar ファイル + として格納されています. それぞれの配布セットの一次配布先は, + 以下の通り です.</para> + + <orderedlist> + <listitem> + <para>sunsite.unc.edu:/pub/Linux/distributions</para> + </listitem> + + <listitem> + <para>tsx-11.mit.edu:/pub/linux/distributions</para> + </listitem> + </orderedlist> + + <para>ヨーロッパのミラーサイトの例:</para> + + <orderedlist> + <listitem> + <para>ftp.luth.se:/pub/linux/distributions</para> + </listitem> + + <listitem> + <para>ftp.demon.co.uk:/pub/unix/linux</para> + </listitem> + + <listitem> + <para>src.doc.ic.ac.uk:/packages/linux/distributions</para> + </listitem> + </orderedlist> + + <para>混乱を避けるために, ここでは Slackware だけを取り上げます. + この配布セッ トは, 多くのサブディレクトリ内にある + 別々のパッケージから構成されていま す. 通常, + パッケージはインストールプログラムにより自動的に制御されま + すが, “手動で”おこなうことも可能です. + まず配布セットの中の, <filename>contents</filename> + サブディレクトリの内容を書くにしてください. ここには多く + の小さなテキストファイルが含まれおり, + それぞれのパッケージの内容が記述 されています. + 必要なファイルを探している場合は, まず contents 内のテキ + ストファイルを取得し, そのファイルの中から grep + を使用して検索するのが, 最も速い方法でしょう. + 以下に必要となるであろうファイルを, grep を使用 + して検索した例を示します.</para> + + <informaltable frame="none"> + <tgroup cols="2"> + <thead> + <row> + <entry>Library</entry> + <entry>Package</entry> + </row> + </thead> + + <tbody> + <row><entry><filename>ld.so</filename></entry><entry>ldso </entry></row> + <row><entry><filename>ldconfig</filename></entry><entry>ldso </entry></row> + <row><entry><filename>ldd</filename></entry><entry>ldso </entry></row> + <row><entry><filename>libc.so.4</filename></entry><entry>shlibs </entry></row> + <row><entry><filename>libX11.so.6.0</filename></entry><entry>xf_lib </entry></row> + <row><entry><filename>libXt.so.6.0</filename></entry><entry>xf_lib </entry></row> + <row><entry><filename>libX11.so.3</filename></entry><entry>oldlibs </entry></row> + <row><entry><filename>libXt.so.3</filename></entry><entry>oldlibs </entry></row> + </tbody> + </tgroup> + </informaltable> + + <para>この場合は, ldso, shlibs, xf_lib, oldlibs + というパッケージが必要なこと がわかります. + それぞれのcontentsファイルの中で, <literal>PACKAGE + LOCATION</literal> と書いてある行を探してください. + その行に, パッケージが含まれている“ディ スク”, + 今回の場合はサブディレクトリ名が書かれています. たとえば, + 以下の ようになります.</para> + + <informaltable frame="none"> + <tgroup cols="2"> + <thead + <row> + <entry>Package</entry> + <entry>Location</entry> + </row> + </thead> + + <tbody> + <row><entry>ldso </entry><entry>diska2 </entry></row> + <row><entry>shlibs </entry><entry>diska2 </entry></row> + <row><entry>oldlibs </entry><entry>diskx6 </entry></row> + <row><entry>xf_lib </entry><entry>diskx9 </entry></row> + </tbody> + </tgroup> + </informaltable> + + <para>“disk<replaceable>XX</replaceable>” + というのは, 配布セットの + <filename>slackware/<replaceable>XX</replaceable></filename> + サブディレクトリ を示します. それ以外の場合は, + <filename>contrib</filename> サブディレクトリに格納されて + います. 今回の場合は, + 以下のファイルを取得すればいいことがわかります (ファイル名は, + 配布セットのルートディレクトリからの相対パスで示してあ + ります).</para> + + <itemizedlist> + <listitem> + <para><filename>slakware/a2/ldso.tgz</filename></para> + </listitem> + + <listitem> + <para><filename>slakware/a2/shlibs.tgz</filename></para> + </listitem> + + <listitem> + <para><filename>slakware/x6/oldlibs/tgz</filename></para> + </listitem> + + <listitem> + <para><filename>slakware/x9/xf_lib.tgz</filename></para> + </listitem> + </itemizedlist> + + <para>gzip で圧縮された tar ファイルから必要なファイルを + <filename>/compat/linux</filename> ディ + レクトリに格納してください(必要なファイルのみを展開するか, + あるいは必 要でないファイルを後で削除してください). + これで作業は終了です.</para> + + <para><emphasis>参照:</emphasis> + <filename> + ftp.freebsd.org:pub/FreeBSD/2.0.5-RELEASE/xperimnt/linux-emu/README + </filename> と <filename> + /usr/src/sys/i386/ibcs2/README.iBCS2</filename></para> + </sect2> + </sect1> + + <sect1 id="mathematica"> + <title>FreeBSD への Mathematica のインストール</title> + + <para><emphasis>原作: &a.rich; and &a.chuck;</emphasis></para> + + <para><emphasis>訳: &a.jp.kiroh;.</emphasis></para> + + <para>この文書は, Mathematica 2.2 の Linux + バイナリディストリビューションを, FreeBSD 2.1 + にインストールする方法について説明します.</para> + + <para>Mathematica は, そのままでは FreeBSD + をサポートしていませんが, Linux は サポートしています. ですから, + Linux エミュレータの設定が終わってしまえ ば, Mathematica + を動作させる環境はほとんど整ったことになります.</para> + + <para>DOS 用のスチューデント版 Mathematica から Linux + バージョンへのアップグレー ド価格は, 執筆時点 (1996年5月) では, + $45.00 です. 直接 Wolfram(電話番号(217) 398-6500)に注文して, + 支払いはクレジットカー ドでおこなえます.</para> + + <sect2> + <title>Mathematica ディストリビューションの展開</title> + + <para>バイナリは, Wolfram から CDROM で配布されています. CDROM + には, 1ダー スほどの tar ファイルが含まれており, + それぞれサポートされているアーキテ クチャに対応しています. + Linux 用のファイルは, <filename>LINUX.TAR</filename> です. + 例えば <filename>/usr/local/Mathematica</filename> + 以下にインストールする場合は, 以下のようにしま す.</para> + + <screen>&prompt.root; <userinput>cd /usr/local</userinput> +&prompt.root; <userinput>mkdir Mathematica</userinput> +&prompt.root; <userinput>cd Mathematica</userinput> +&prompt.root; <userinput>tar -xvf /cdrom/LINUX.TAR</userinput></screen> + </sect2> + + <sect2> + <title>Mathematica パスワードの取得</title> + + <para>Mathematica を実行する前に, 使用するマシンに対応した + “machine ID” を Wolfram + から取得する必要があります.</para> + + <para>Linux 互換ランタイムライブラリがインストールされており, + mathematica の展 開が終了したら, Install ディレクトリで + <command>mathinfo</command> プログラムを使用す ることで + “machine ID” を得ることができます.</para> + + <screen>&prompt.root; <userinput>cd /usr/local/Mathematica/Install</userinput> +&prompt.root; <userinput>mathinfo</userinput> +LINUX: 'ioctl' fd=5, typ=0x89(), num=0x27 not implemented +richc.isdn.bcm.tmc.edu 9845-03452-90255</screen> + + <para>ここで, <hostid>richc</hostid> の “machine ID” + は, <literal>9845-03452-90255</literal> となります. ioctl + のメッセージは無視してください. まだ FreeBSD + では実装されていません. Mathematica + を実行するたびに同様のメッセージが表示されますが, 実際の使 + 用に問題はありませんので, 無視してかまいません.</para> + + <para>電子メールや電話, ファックスなどで Wolfram に + “machine ID” を知らせ て登録すると, + いくつかの番号のグループからなるパスワードが送り返されて + きます. パスワードを, マシン名, ライセンス番号とともに, + mathpass ファ イルに追加します.</para> + + <para>追加は, 以下のようにおこないます.</para> + + <screen>&prompt.root; <userinput>cd /usr/local/Mathematica/Install</userinput> +&prompt.root; <userinput>math.install</userinput></screen> + + <para>ライセンス番号と, Wolfram + から送られてきたパスワードを入力を求めます. + 入力を間違えたりして, math.install + の実行が失敗しても大丈夫です. <filename>mathpass</filename> + ファイルを手動で編集して, 情報を訂正してください.</para> + + <para>パスワードの入力後, <command>math.install</command> では, + インストール方法を, デフォルト 設定でのインストールか, + 自分で方法を指定するインストールから選ぶことが できます. + 筆者のようにインストールプログラムを信用していない場合は, 自 + 分でディレクトリを指定する方を選択するでしょう. + 自分で指定するインストー ルを選んだ場合, math.install + 自身ではディレクトリの作成はおこないません. 注意してください. + 別のウィンドウでシェルを開いて, 指定するディレクトリ + を作成してください. 存在しないディレクトリを指定して, + math.install が インストールに失敗した場合には, + ディレクトリを作成し, math.install を 再び実行してください. + 筆者らがインストール先に選んだディレクトリは, 以 下の通りです. + くれぐれもあらかじめ作成してから, + <command>math.install</command> で指定す + るようにしてください.</para> + + <!-- kuriyama - I've lost original translation of here. Check original Japanese version --> + <informaltable frame="none"> + <tgroup cols="2"> + <tbody> + <row> + <entry><filename>/usr/local/Mathematica/bin</filename></entry> + <entry>for binaries</entry> + </row> + + <row> + <entry><filename> + /usr/local/Mathematica/man/man1</filename></entry> + <entry>for man pages</entry> + </row> + + <row> + <entry>/usr/local/Mathematica/lib/X11</entry> + <entry>for the XKeysymb file</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>また, システムレコードファイルとして, + <filename>/tmp/math.record</filename> を使用するように + 設定することもできます. このファイルには, + セッションのログが記録されま す. この設定が終了すると, + <command>math.install</command> は残りのファイルを展開して, 必 + 要な場所に格納します.</para> + + <para>Mathematica ノートブックの機能は, X + フロントエンドとして本体とは別に含 まれています. X + フロントエンドを正しくインストールするには, + <filename>/usr/local/Mathematica/FrontEnd</filename> + ディレクトリに移動し, <command>./xfe.install</command> シェ + ルスクリプトを実行します. + インストール先を指定しなければなりませんが, + あらかじめ作成する必要はありません. 必要なディレクトリは, + すべて math.install によって作成されているからです. + インストールが終了したら, + <filename>/usr/local/Mathematica/bin</filename> + ディレクトリに, <filename>mathematica</filename> という名前の + シェルスクリプトが新たに作成されているはずです.</para> + + <para>最後に, Mathematica + がインストールしたシェルスクリプトを修正する必要 があります. + <filename>/usr/local/Mathematica/bin</filename> + に含まれるすべてのシェルスクリプ + トの先頭部分に以下の行を追加します.</para> + <!-- kuriyama - nik mistaken for here? --> + + <screen>XKEYSYMDB=/usr/local/Mathematica/lib/X11/XKeysymDB; export XKEYSYMDB</screen> + + <para>これは, Mathematica が使用する Mathematica + バージョンのキーマップファイル <filename>XKeysymDB</filename> + の場所を指定するものです.</para> + + <para>2.1-STABLE を使用している場合は, + 以下の行も追加してください.</para> + <!-- kuriyama - Same as above --> + + <screen>RESOLV_HOST_CONF=/compat/linux/etc/host.conf; export RESOLV_HOST_CONF</screen> + + <para>これは, Mathematica に Linux バージョンの host.conf + を使用するように指定し ます. FreeBSD の host.conf の文法は, + Linux のものと異なっているため, この 指定をおこなわないと, + <filename>/etc/host.conf</filename> + に関わるエラーが発生します.</para> + + <para>新しいマニュアルページを利用したい場合は, さらに + <filename>/etc/manpath.config</filename> ファイ + ルを修正する必要があります. また自分の + <filename>~/.cshrc</filename> を変更して, + <filename>/usr/local/Mathematica/bin</filename> + をパスに追加してください.</para> + + <para>これでインストール作業はすべて終了です. + <command>mathematica</command> とタイプすれば, 見栄えのする + Mathematica ノートブックが表示されるはずです. Mathematica + には, Motif ユーザインタフェースが含まれますが, + スタティックにリンクさ れているため, Motif + のライブラリは必要ありあません. 頑張って Mathematica + をインストールしてください.</para> + </sect2> + + <sect2> + <title>バグ</title> + + <para>ノートブックフロントエンドは, + 以下のようなエラーメッセージを表示して, + ハングすることがあることが知られています.</para> + + <screen><errorname>File .../Untitled-1.mb appears to be broken for OMPR.257.0</errorname></screen> + + <para>今のところ原因はわかっていませんが, + このバグが影響を及ぼすのは, ノートブッ クの X window + フロントエンドのみです. Mathematica エンジン本体に影響は + ありません. そのため, ``math'' + によって起動されるコマンドラインのインタ + フェースを使用している場合は, このバグは関係ありません.</para> + </sect2> + + <sect2> + <title>謝辞</title> + + <para>&a.sos;と&a.peter;に深く感謝します. + Linuxエミュレーションが現在の形に あるのは, 彼らのおかげです. + そして, 彼ら二人にハッパをかけて, 犬のよう に働かせた Michael + Smithに. 今やLinuxエミュレーションは, linuxよりうま + くlinuxバイナリを実行できます! <!-- smiley -->:-)</para> + </sect2> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/mail/chapter.sgml b/ja_JP.eucJP/books/handbook/mail/chapter.sgml new file mode 100644 index 0000000000..ec6b8f0ce6 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/mail/chapter.sgml @@ -0,0 +1,692 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.8 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:58 kuriyama Exp $ +--> + +<chapter id="mail"> + <title>電子メール</title> + + <para><emphasis>原作: &a.wlloyd;.</emphasis></para> + + <para><emphasis>訳: &a.jp.mihoko;. 14 January 1997.</emphasis></para> + + <para>電子メールのコンフィグレーションは, 多くの <link + linkend="bibliography">システム管理</link> の書籍で主題 + として取り上げられています. + ネットワークに合わせたメールホスト構築の + 範疇を越えるようなことをする のは, 簡単にはいきません.</para> + + <para>電子メールのコンフィグレーションの一部は, + ドメインネームシステム (DNS) によって制御されています. + あなた自身で DNS サーバを 立ち上げたい場合には, + <filename>/etc/namedb</filename> ファイルを + あなたのサーバに合うように変更してください. + さらに詳しい情報が必要な場合には,<command>man -k named</command> + コマンドを実行してください.</para> + + <sect1> + <title>基本事項</title> + + <para>電子メール交換の主要なプログラムや構成要素を, 次に示します. + “メールホスト” + はあなたのホストやネットワークに対するすべて + の電子メールを配送したり受け取ったりするサーバです.</para> + + <sect2> + <title>ユーザプログラム</title> + + <para>これは, <application>elm</application>, + <application>pine</application>, + <application>mail</application> や, より洗練された WWW + ブラウザ のようなプログラムです. このプログラムは, 単純に + すべてのメールをローカルメールホスト転送します. この転送は, + <command>sendmail</command> を呼び出すか, + “メールホスト”に対して TCP 上 + の通信を使ってメールを配送するかの + いずれかによっておこないます.</para> + </sect2> + + <sect2> + <title>メールホストサーバデーモン</title> + + <para>通常, このプログラムはバックグラウンドで実行されている + <command>sendmail</command> または <command>smail</command> + です. 実行をやめたり, コマンドライン引数を変更するには, + <filename>/etc/rc.conf</filename> ファイル (FreeBSD 2.2.2 + より前のバージョンの場合は <filename>/etc/sysconfig</filename> + ファイル)を編集します. 特別な理由(<link + linkend="firewalls">ファイアウォール</link> を + 構築している場合など)がないかぎり, + 実行する設定にしておくべきです.</para> + + <para><command>sendmail</command> + は安全なサイト上であっても潜在的にセキュリティ上の + 弱点になることを覚えておいてください. + <command>sendmail</command> のいくつかのバージョンでは, + セキュリティ上の問題が 知られています.</para> + + <para><command>sendmail</command> は, 電子メールの配送, + 受信の二つの仕事をおこないます.</para> + + <para><command>sendmail</command> は, + サイトの外側へメールを配送する必要が ある場合, DNS + を参照して配送先のメールを受け取る実際の + ホストを決定します.</para> + + <para><command>sendmail</command> + が配送エージェントとして動作する場合は, + ローカルキューからメッセージを取り出し, 受信側 + コンピュータ上の sendmail + へインターネットを介して配送します.</para> + </sect2> + + <sect2> + <title>DNS — ネームサービス</title> + + <para>ドメインネームシステムとそのデーモン + <command>named</command> は, ホストから IP アドレス, および + ホスト名からメールホストへのマッピングをおこなう + データベースを持っています. IP アドレスは A + レコードで定義します. MX レコードでは, + あなた宛のメールを受け取るメールホストを定義します. もし + あなたのホスト宛のメールに対する MX + レコードを持っていない場合には, + メールはあなたのホストに直接配送されます.</para> + + <para>あなたが自分自身の DNS サーバを実行させていない場合には, + DNS 上の情報を自分で変更することはできません. + インターネットプロバイダを使用している場合には, + プロバイダに依頼して 変更してもらってください.</para> + </sect2> + + <sect2> + <title>POP サーバ</title> + + <para>このプログラムはメールボックスからメールを取り出し, + ブラウザにメールを渡します. POP サーバをあなたのマシン上で + 動かしたい場合には, 次の二つの作業をする必要があります. + </para> + + <procedure> + <step> + <para>pop ソフトウェアを <ulink + URL="../ports/mail.html">ports コレクション</ulink> + から入手 します. pop ソフトウェアは, + <filename>/usr/ports</filename> または + パッケージコレクションにあります. このハンドブックには, + <link linkend="ports">ポート</link> システム + についての完全な解説のセクションがあります.</para> + </step> + + <step> + <para>POP サーバを起動できるように, + <filename>/etc/inetd.conf</filename> + ファイルを編集します.</para> + </step> + </procedure> + + <para>入手した pop プログラムには説明文が付属していますので, + それを読んで ください.</para> + </sect2> + </sect1> + + <sect1> + <title>コンフィグレーション</title> + + <sect2> + <title>基本事項</title> + + <para>あなたのマシンに FreeBSD を普通にインストールして, + <filename>/etc/resolv.conf</filename> ファイルを設定するか, + またはネームサーバを走らせれば, + 他のホストへ電子メールを送ることができるようになります. + あなたのホスト宛の + メールを特定のホストに配送するようにしたい場合 には, + 次の二つの方法があります.</para> + + <itemizedlist> + <listitem> + <para>ネームサーバ (<command>man -k named</command>) + を実行し, あなた自身のドメイン <hostid + role="domainname">smallminingco.com</hostid> + を定義する.</para> + </listitem> + + <listitem> + <para>あなたのホストに対する現在の DNS + 名に配送されたメールを受け取る. つまり <hostid + role="fqdn">dorm6.ahouse.school.edu</hostid> + 宛に送られたメールを受け取る.</para> + </listitem> + </itemizedlist> + + <para>インターネットへ完全に接続された + あなたのホストに直接メールが配送される ためには, + ネームサーバのどのオプションを使用するかは + あまり重要なことではありません. 大切なのは, あなたが恒久的な + IP アドレスを持っていなくてはいけないと いうことです. + ダイナミック PPP で得られる IP アドレスではダメです. + もしあなたがファイアウォールの内側にいる場合は, + ファイアウォールが smtp トラフィックを + あなたのホストに渡すように設定されていなければいけません. + そのためには, ファイアウォールとなるホストの + <filename>/etc/services</filename> に</para> + + <!-- kuriyama - Eng ver of style shuld fix --> + <programlisting> +smtp 25/tcp mail #Simple Mail Transfer</programlisting> + + <para>と書いておきます. + あなたのホスト上でメールを受けたい場合には, DNS の MX + エントリが あなたのホストアドレスを指しているか, + あなたのホストの DNS 名に対して MX エントリが存在しないことを + 確認してください.</para> + + <para>次のコマンドを実行してみてください.</para> + + <screen>&prompt.root; <userinput>hostname</userinput> +newbsdbox.freebsd.org +&prompt.root; <userinput>host newbsdbox.freebsd.org</userinput> +newbsdbox.freebsd.org has address 204.216.27.xx</screen> + + <para>もしあなたのマシンが上記のメッセージだけを出力したならば, + <email>root@newbsdbox.freebsd.org</email> へのメールは, + 問題なく 配送されるでしょう.</para> + + <para>上記のメッセージの代わりに, </para> + + <screen>&prompt.root; <userinput>host newbsdbox.freebsd.org</userinput> +newbsdbox.FreeBSD.org has address 204.216.27.xx +newbsdbox.FreeBSD.org mail is handled (pri=10) by freefall.FreeBSD.org</screen> + + <para>というメッセージが出力された場合は, + あなたのマシンに直接配送された すべてのメールは, + <hostid>freefall</hostid> + 上の同じユーザ名に配送されてます.</para> + + <para>この情報は, あなたのドメインネームサーバ上で設定します. + この設定をおこなうホストは, + <filename>/etc/resolv.conf</filename> + にプライマリネームサーバとして + 書いたホストと同じホストであるべきです.</para> + + <para>メールルーティング情報をもつ DNS レコードは, + メールエクスチェンジャエントリ (MX エントリ) です. MX + エントリが存在しない場合には, アドレスレコードにしたがって, + 直接宛先ホストに配送されます.</para> + + <para><hostid role="fqdn">freefall.freebsd.org</hostid> + の現時点での MX エントリは, 次のようになっています.</para> + + <programlisting> +freefall MX 30 mail.crl.net +freefall MX 40 agora.rdrop.com +freefall HINFO Pentium FreeBSD +freefall MX 10 freefall.FreeBSD.org +freefall MX 20 who.cdrom.com +freefall A 204.216.27.xx +freefall CNAME www.FreeBSD.org</programlisting> + + <para><hostid>freefall</hostid> は多くの MX + エントリを持っています. もっとも MX の値が小さいホストが, + 最終的にメールを受け取ります. もし <hostid>freefall</hostid> + が他の処理で忙しかったり, ダウンしているような場合には, + 他のホストが, 一時的にメールをキューにいれます.</para> + + <para>使い勝手をよくするためには, 代替の MX サイトは, それぞれ + 別の経路でインターネットへ接続しているとよいでしょう. + インターネットプロバイダまたは他の関連サイトが, このサービスを + 提供することができます.</para> + + <para><command>dig</command>, <command>nslookup</command> や + <command>host</command> コマンド を使うと, + とても便利です.</para> + </sect2> + + <sect2 id="mail-domain"> + <title>あなたのドメイン (ネットワーク) に対するメール設定</title> + + <para>ネットワークメールホストをセットアップするためには, + すべての + ワークステーション宛のメールを直接受ける必要があります. + 言いかえれば, <hostid + role="domainname">*.smallminingco.com</hostid> + 宛のすべてのメールを ハイジャックし, そのメールをあなたの + “メールホスト” である個々のマシンにに配送 + します.</para> + + <para>それらのワークステーション上のネットワークユーザは, + たいていメールを POP や telnet 等で受け取ります.</para> + + <para><emphasis>同じユーザ名</emphasis>のユーザアカウントが, + 両方のマシンに存在しなければな りません. 必要ならば, + アカウントを作成するために <command>adduser</command> + コマンドを使用してください. <literal>shell</literal> を + <literal>/nonexistant</literal> に設定すると, + ユーザはログインできなくなります.</para> + + <para>使用する予定のメールホストは, + 各ワークステーションごとにメール交換が + できるように設定されていなければなりません. これは, DNS + (すなわち BIND や named) の設定が必要です. 詳細は, + ネットワークの本を参照してください.</para> + + <para>基本的には, 以下の行を DNS サーバに追加する必要があります. + </para> + + <programlisting> +pc24.smallminingco.com A <replaceable>xxx.xxx.xxx.xxx</replaceable> ; Workstation ip + MX 10 smtp.smallminingco.com ; Your mailhost</programlisting> + + <para>自前で DNS サーバを実行しているのでなければ, この作業は, + 自分では おこなえません. 自分で DNS + サーバを実行したくない場合は, + インターネットプロバイダ等に依頼して, + 作業をおこなってもらってください.</para> + + <para>この作業により, このワークステーション宛のメールは, MX + (メールエクスチェンジャ) ホストに送られるようになります. A + レコードがどのマシンを指しているかどいうことには関係なく, + メールは MX ホストに送られます.</para> + + <para>この機能は, 仮想電子メールホスト (Virtual E-Mail Hosting) + を実装するために使用されています.</para> + + <para>例</para> + + <para>foo.bar というドメインを持つ顧客がいて, foo.bar + 宛のメールをすべて, わたしのマシン smtp.amalliap.com + に送りたいと思っています. このような場合, あなたの DNS + サーバ上で, 以下のようなエントリを作成 + しなければなりません:</para> + + <programlisting> +foo.bar MX 10 smtp.smalliap.com ; your mailhost</programlisting> + + <para>そのドメインに対して電子メールを送りたいだけなら, A + レコードは必要ありません. つまり, <filename>foo.bar</filename> + に対するアドレスレコードが存在しない限り, <command>ping + foo.bar</command> コマンドが動作することを期待しては + いけません</para> + + <para>メールボックスへの最終的な配送が行われる + メールを実際に受けている メールホスト上では, + <command>sendmail</command> はメールを受け付けているホストを + 知っている必要があります.</para> + + <para>そのためには, (<literal>FEATURE(use_cw_file)</literal> + を使用している場合) <filename>/etc/sendmail.cw</filename> + ファイルに <literal>pc24.smallminingco.com</literal> + を追加するか, <filename>/etc/sendmail.cf</filename> + ファイルに, <literal>Cw myhost.smalliap.com</literal> + の行を追加してください.</para> + + <para>もしあなたが本気で <command>sendmail</command> + を使って何かしようと思うなら, <command>sendmail</command> + のソースをインストールするべきです. ソースには, + たくさんのドキュメントも付いています. <link + linkend="sendmailuucp">UUCP のセットアップ</link> の節に + <command>sendmail</command> の + ソースを入手するのに必要な情報が掲載されています.</para> + </sect2> + + <sect2 id="sendmailuucp"> + <title>UUCP のセットアップ</title> + + <para><emphasis>よくある質問 (FAQ) より抜粋.</emphasis></para> + + <para>FreeBSD に付属する <command>sendmail</command> + のコンフィグレーションは, + 直接インターネット接続しているサイトに合うように作られてい + ます. メールを UUCP 経由で交換するようにしたい場合には, 別の + <command>sendmail</command> + コンフィグレーションファイルをインストールし + なければなりません.</para> + + <para><filename>/etc/sendmail.cf</filename> + を手動で作成することは, 純正主義者 + がおこなうことだと考えられています. sendmail のバージョン 8 + では, <command>m4</command> プリプロセッサを使用して, + コンフィグレーションファイルを生成する方法が取られています. + この場合, 実際に手動で作成したコンフィグレーションは, + 実際のコンフィグレーションより簡潔です. + 以下の場所にあるコンフィグレーションファイルを + 使用してください. + <filename>/usr/src/usr.sbin/sendmail/cf</filename></para> + + <para>システム上にすべてのソースをインストールして いない場合, + <command>sendmail</command> の設定ツールは不完全なままであり, + それは個別のソース配布物の中にあります. CD-ROM + をマウントしてあれば, 以下のようにします.</para> + + <screen>&prompt.root; <userinput>cd /usr/src</userinput> +&prompt.root; <userinput>tar -xvzf /cdrom/dists/src/ssmailcf.aa</userinput></screen> + + <para>驚かないでください. + これはたった数百キロバイトのサイズのファ イルです. + <filename>cf</filename> ディレクトリ上にある + <filename>README</filename> ファイル には, m4 + コンフィグレーションの基本的な紹介が書かれてい ます.</para> + + <para>UUCP での配送には, <emphasis>mailertable</emphasis> + 機能を使用すること をおすすめします. これは + <command>sendamil</command> が配送経路を決定するのに + 使用するデータベースファイルです.</para> + + <para>まずはじめに, <filename>.mc</filename> + ファイルを作成します. + <filename>/usr/src/usr.sbin/snemdail/cf/cf</filename> + ディレクトリに これらのファイルを置きます. + ここには既にいくつかの例が 置いてあるので, 見てください. + <filename>foo.mc</filename> という名前で作成したと仮定すると, + それを有効な <filename>sendmail.cf</filename> + に変換するためには, まず次のようにします:</para> + + <screen>&prompt.root; <userinput>cd /usr/src/usr.sbin/sendmail/cf/cf</userinput> +&prompt.root; <userinput>make foo.cf</userinput></screen> + + <para>続いて, もし <filename>/usr/obj</filename> + 以下のディレクトリが存在しなければ:</para> + + <screen>&prompt.root; <userinput>cp foo.cf /etc/sendmail.cf</userinput></screen> + + <para>とし, 存在すれば次のようにします:</para> + + <screen>&prompt.root; <userinput>cp /usr/obj/`pwd`/foo.cf /etc/sendmail.cf</userinput></screen> + + <para>典型的な <filename>.mc</filename> + ファイルは次のような内容です:</para> + + <programlisting> +include(`../m4/cf.m4') +VERSIONID(`<replaceable>Your version number</replaceable>') +OSTYPE(bsd4.4) + +FEATURE(nodns) +FEATURE(nocanonify) +FEATURE(mailertable) + +define(`UUCP_RELAY', <replaceable>your.uucp.relay</replaceable>) +define(`UUCP_MAX_SIZE', 200000) + +MAILER(local) +MAILER(smtp) +MAILER(uucp) + +Cw <replaceable>your.alias.host.name</replaceable> +Cw <replaceable>youruucpnodename.UUCP</replaceable></programlisting> + + <para><literal>nodns</literal> と <literal>nocanonify</literal> + は, メール配送をおこなう 際に, DNS + を参照しないようにするための設定です. + <literal>UUCP_RELAY</literal> は, 必要な設定ですが, + ここでは理由を 説明できません. その理由について, + ここでは質問しないでください. .UUCP + 仮想ドメインアドレスを扱うことができるインターネット + ホスト名を書いてください. おそらく, 使用する ISP + のメール中継ホスト名をそこに記述する ことになります.</para> + + <para>この設定が終了したら, + <filename>/etc/mailertable</filename> と呼ばれる + ファイルが必要になります. + このファイルの典型的な例を示します:</para> + + <programlisting> +# +# makemap hash /etc/mailertable.db < /etc/mailertable +# +horus.interface-business.de uucp-dom:horus +.interface-business.de uucp-dom:if-bus +interface-business.de uucp-dom:if-bus +.heep.sax.de smtp8:%1 horus.UUCP +uucp-dom:horus if-bus.UUCP +uucp-dom:if-bus . uucp-dom:sax</programlisting> + + <para>見て分かるように, これは実際に使用されているファイルの一部 + です. はじめの三行は, ドメインアドレスが指定されたメールが + デフォルトルートに送信せずに, + 配送パスを“短縮”して, 隣接 UUCP + サイトにメールを送るための設定です. 次の行は, メールを SMTP + を使用して配送されているローカル + イーサネットドメイン上のマシンに送信するための設定です. + 最後に, UUCP 接続されているドメインが, .UUCP という仮想ド + メイン表記されている場合です. これは, + <literal>uucp-neighbor!recipient</literal> + をデフォルト規則で書換えるため です. 最終行は必ず + シングルドット (.) を指定します. + 上記のどのパターンにも当てはまらない送信先に対して, あなた + のメールの世界中へのゲートウェイとして動作してくれる隣接 UUCP + サイトに, UUCP を使って配送します. + <literal>uucp-dom:</literal> + というキーワードの後に書かれたすべての ノード名は, 隣接 UUCP + サイトでなければなりません. そのサイトと UUCP + 接続を行っているかどうかは, コマンド + <command>uuname</command> + を使用して確かめることができます.</para> + + <para>実際に使用するには, このファイルを DBM データベースファイ + ルに変換する必要があることを忘れないでください. + これを実行するためのコマンド 行は, + <filename>mailertable</filename> + の先頭にコメントとして記述されています. 通常, このコマンドは, + <filename>mailertable</filename> を変更するたびに実行しな + ければなりません.</para> + + <para>最終ヒント: もしいくつかの特定のメール経路が正しく動作する + かどうかが心配ならば, <command>sendmail</command> の + <option>-bt</option> オプション を覚えておいてください. + このオプションは <command>sendmail </command> を + “アドレステストモード” で起動します. + メールの経路をテストするには, <literal>0</literal> + のあとにメール経路をテスト したいアドレスを入力してください. + 最後の行にあなたが使用する インターネットメールエージェント + (メール中継プログラム) と, + このエージェントに呼び出される宛先のホスト名と, + (翻訳可能な場合) アドレスがが表示されます. このモードを + 終了するには, Control-D を入力します.</para> + + <screen>&prompt.user; <userinput>sendmail -bt</userinput> +ADDRESS TEST MODE (ruleset 3 NOT automatically invoked) +Enter <ruleset> <address> +<prompt>></prompt> <userinput>0 foo@interface-business.de</userinput> +rewrite: ruleset 0 input: foo @ interface-business . de +… +rewrite: ruleset 0 returns: $# uucp-dom $@ if-bus $: foo < @ interface-business . de</screen> + </sect2> + </sect1> + + <sect1 id="mailfaq"> + <title>よくある質問 (FAQ)</title> + + <para><emphasis>このセクションは, FAQ + から移動してきました.</emphasis></para> + + <sect2> + <title>どうして 同じサイトのホストに対して完全な形のドメイン名 + (FQDN) を使わなければいけないの?</title> + + <para>おそらく, + そのホストは実際には違うドメインに属しているのでしょう. + 例えば, もしあなたが <hostid role="fqdn">foo.bar.edu</hostid> + ドメインにいて, <hostid role="domainname">bar.edu</hostid> + ドメインの中の<hostid>mumble</hostid> + というホストに接続したいと します. その場合あなたは, + <hostid>mumble</hostid>ではなく <hostid + role="fqdn">mumble.bar.edu</hostid> + という完全な形のドメイン名 (FQDN) によっ + てそのホストを参照しなければなりません.</para> + + <para>伝統的に, これは BSD BIND リゾルバでは許されていました. + しかしながら, FreeBSD に付属する現在の + <application>BIND</application> の バージョンでは, + 自分が属しているドメイン以外では, + 完全な形でないドメイン名に対するデフォルトの省略形は + 使用できません. ですから, 完全でないホスト名 + <hostid>mumble</hostid> は, <hostid + role="fqdn">mumble.foo.bar.edu</hostid> として解決されるか, + ルートドメインに検索しにいくでしょう.</para> + + <para>これは, <hostid role="domainname">mumble.bar.edu</hostid>, + <hostid role="domainname">mumble.edu</hostid> + というように検索し続けるような過去の動作とは異なります. + なぜこれが悪い慣例, さらにはセキュリティーホールと考えられ + るようになった理由については, RFC1535 + を参照してください.</para> + + <para>この問題を回避するには, + + <programlisting> +search foo.bar.edu bar.edu</programlisting> + + という行を + + <programlisting> +domain foo.bar.edu</programlisting> + + に置き換えます.これを自分のマシン上の + <filename>/etc/resolv.conf</filename> ファイルに + 記述してください. しかしながら, 検索順序は, RFC 1535 に + 書かれている, “ローカル管理と公共の管理の間の境界線” + を越えないことを, あらかじめ確認してください.</para> + </sect2> + + <sect2> + <title>Sendmail が <errorname>mail loops back to + myself</errorname> というエラーを出します</title> + + <para>これについては, sendmail FAQ の中で, 次のように答えられて + います:</para> + + <programlisting> +* 次のような 「Local configuration error」というメッセージが出ます: + +553 relay.domain.net config error: mail loops back to myself +554 <user@domain.net>... Local configuration error + +この問題をどうやって解決すればよいでしょうか? + +MX レコードを使って, あるドメイン(例: domain.net)宛にメールを +特定のホスト (この場合, relay.domain.net) に転送しようと設定したと +していますが, 中継ホストは自身が domain.net であるとは認識 +していません. +(FEATURE(use_cs_file) を使用している場合は) +/etc/sendmail.cw に, domain.net を追加してください. +または, 「Cw domain.net」を /etc/sendmail.cf に追加してください. </programlisting> + + <para>sendmail FAQ は, + <filename>/usr/src/usr.sbin/sendmail</filename> に あります. + “ちょっと凝った”メール設定 をしたい場合は, FAQ + を読むことをおすすめします.</para> + </sect2> + + <sect2> + <title>ダイアルアップ PPP + ホストで電子メールを使うにはどうしたらいいの?</title> + + <para>LAN 上にある FreeBSD マシンを, + インターネットに接続したいと します. FreeBSD マシンは, その + LAN でのメールゲートウェイになります. FreeBSD + マシンは専用線接続ではありません + (訳注:ダイアルアップ接続など).</para> + + <para>これには, 少なくとも二つの方法があります.</para> + + <para>一つは UUCP を使うことです.</para> + + <para>このとき鍵になるのは, あなたのドメインに対するセカンダリ + MX サービス + を提供してくれるインターネットサイトをみつけることです.</para> + + <para>例:</para> + + <programlisting> +bigco.com. MX 10 bigco.com. + MX 20 smalliap.com.</programlisting> + + <para>最終的なメール受信先としては, + 一つのホストだけが定義されるべきです (bigco.com 上の + <filename>/etc/sendmail.cf</filename> ファイルに, <literal>Cw + bigco.com</literal> を追加します).</para> + + <para>送信側の <command>sendmail</command> が, + メールを配送しようとしている時, モデムの接続を + 介してあなたのところに接続しようとします. 大抵の場合, + あなたのマシンがオンラインでないために, 接続はタイムアウト + してしまうでしょう. <command>sendmail</command> は自動的に, + メールをセカンダリの MX サイト に + (あなたのインターネットプロバイダ) に配送します. セカンダリ MX + サイトは, (<filename>/etc/rc.conf</filename> ファイル に + <literal>sendmail_flag = "-bd + -q15m"</literal>と書かれている場合) 15 分ごとに, + プライマリ MX サイトにメールを配送しようと, + あなたのホストに接続しに いきます.</para> + + <para>ログインスクリプトとして, + このようなものを使うとよいでしょう. </para> + + <programlisting> +#!/bin/sh +# Put me in /usr/local/bin/pppbigco +( sleep 60 ; /usr/sbin/sendmail -q ) & +/usr/sbin/ppp -direct pppbigco</programlisting> + + <para>ユーザごとにログインスクリプトを作りたい場合には, 上記 + のスクリプトの代わりに, <command>sendmail + -qRbigco.com</command> を使用する こともできます. + このようにすると, キューの中の bigco.com に対する + すべてのメールは, すぐに強制的に処理されます.</para> + <!-- kuriyama - hostid? --> + + <para>さらに, 次のような改良もできます.</para> + + <para>以下は, freebsd-isp + メイリングリストから抜粋してきたメッセージです. </para> + + <programlisting> +> 私たちはお客様に対して, セカンダリ MX を提供しています. お客様は一日 +> に何回か私たちのサービスに接続し, メールを彼らのプライマリ MX に +> 受け取ります (彼らのドメインに対するメールが到着した時には, 私たちは +> 彼らのサイトを呼び出しません). +> 私たちの sendmail は, 30 分ごとにメールキューに溜っているメールを +> 配送します. ちょうどその時に, すべてのメールがプライマリ MX に送られ +> たかどうかを確かめるためには, 彼らは 30 分は オンラインでいなけれ +> ばなりません. +> +> すべてのメールを今すぐ送るために sendmail を初期化するコマンドはあ +> るでしょうか? もちろん私たちのマシン上には, ユーザはルート (root) 権限 +> を持っていません. + +sendmail.cf の 「privacy flags」 セクションに,「Opgoaway,restrictqrun」の定義があります. + +root 以外のユーザがキューを処理できるようにするには, +restrictqrun を削除してください. また, MX を再調整が必要かもしれません. +あなたがたは, 顧客のサイトに対する一番優先度の高い MX なので, +次のように定義します: + +# If we are the best MX for a host, try directly instead of generating +# local config error. +OwTrue + +このようにすると, リモートサイトからのメールが, 顧客のマシンと接続し +ようとせず, 直接あなたがたのホストマシンに配送されるようになります. +ホストマシンに配送されたメールは, 続いて顧客のマシンに送られます. +これはホスト名にのみ有効なので, 顧客のメールマシンに, +「host.customer.com」とは別に, 「customer.com」も定義する必要があり +ます. DNS 上で, 「customer.com」に対する A レコードを定義してください.</programlisting> + </sect2> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/mailing-lists.ent b/ja_JP.eucJP/books/handbook/mailing-lists.ent new file mode 100644 index 0000000000..1469f5b360 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/mailing-lists.ent @@ -0,0 +1,107 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.2 + $Id: mailing-lists.ent,v 1.1.1.1 1999-04-08 15:45:57 kuriyama Exp $ + + Names of FreeBSD mailing lists and related software. +--> + +<!ENTITY a.announce "FreeBSD announcements mailing list + <email>freebsd-announce@FreeBSD.ORG</email>"> + +<!ENTITY a.advocacy "FreeBSD advocacy メーリングリスト + <email>freebsd-advocacy@FreeBSD.ORG</email>"> + +<!ENTITY a.cvsall "FreeBSD CVS commit message mailing list + <email>cvs-all@FreeBSD.ORG</email>"> + +<!ENTITY a.database "FreeBSD ベースのデータベースに関するメーリングリスト + <email>freebsd-database@FreeBSD.ORG</email>"> + +<!ENTITY a.doc "FreeBSD documentation project mailing list + <email>freebsd-doc@FreeBSD.ORG</email>"> + +<!ENTITY a.bugs "FreeBSD problem reports mailing list + <email>freebsd-bugs@FreeBSD.ORG</email>"> + +<!ENTITY a.chat "FreeBSD chat メーリングリスト + <email>freebsd-chat@FreeBSD.ORG</email>"> + +<!ENTITY a.current "FreeBSD-current mailing list + <email>freebsd-current@FreeBSD.ORG</email>"> + +<!ENTITY a.emulation "FreeBSD-emulation mailing list + <email>freebsd-emulation@FreeBSD.ORG</email>"> + +<!ENTITY a.fs "FreeBSD filesystem project mailing list + <email>freebsd-fs@FreeBSD.ORG</email>"> + +<!ENTITY a.hackers "FreeBSD technical discussions mailing list + <email>freebsd-hackers@FreeBSD.ORG</email>"> + +<!ENTITY a.hardware "FreeBSD のハードウェア・周辺機器に関するメーリングリスト + <email>freebsd-hardware@FreeBSD.ORG</email>"> + +<!ENTITY a.isdn "FreeBSD ISDN メーリングリスト + <email>freebsd-isdn@FreeBSD.ORG</email>"> + +<!ENTITY a.isp "FreeBSD インターネットサービスプロバイダーメーリングリスト + <email>freebsd-isp@FreeBSD.ORG</email>"> + +<!ENTITY a.java "FreeBSD Java 言語メーリングリスト + <email>freebsd-java@FreeBSD.ORG</email>"> + +<!ENTITY a.jobs "FreeBSD 関連の雇用に関するメーリングリスト + <email>freebsd-jobs@FreeBSD.ORG</email>"> + +<!ENTITY a.mobile "FreeBSD ラップトップコンピューターメーリングリスト + <email>freebsd-mobile@FreeBSD.ORG</email>"> + +<!ENTITY a.mozilla "Mozilla ブラウザーの FreeBSD への移植に関するメーリングリスト + <email>freebsd-mozilla@FreeBSD.ORG</email>"> + +<!ENTITY a.multimedia "FreeBSD マルチメディア関連のメーリングリスト + <email>freebsd-multimedia@FreeBSD.ORG</email>"> + +<!ENTITY a.net "FreeBSD ネットワーク関係のメーリングリスト + <email>freebsd-net@FreeBSD.ORG</email>"> + +<!ENTITY a.newbus "New Bus アーキテクチャのメーリングリスト + <email>new-bus-arch@bostonradio.org</email>"> + +<!ENTITY a.newbies "FreeBSD 初心者メーリングリスト + <email>freebsd-newbies@FreeBSD.ORG</email>"> + +<!ENTITY a.ports "FreeBSD ports mailing list + <email>freebsd-ports@FreeBSD.ORG</email>"> + +<!ENTITY a.questions "FreeBSD general questions mailing list + <email>freebsd-questions@FreeBSD.ORG</email>"> + +<!ENTITY a.scsi "FreeBSD SCSI subsystem mailing list + <email>freebsd-scsi@FreeBSD.ORG</email>"> + +<!ENTITY a.security "FreeBSD セキュリティ関連メーリングリスト + <email>freebsd-security@FreeBSD.ORG</email>"> + +<!ENTITY a.security-notifications "FreeBSD セキュリティ関連のお知らせメーリングリスト + <email>freebsd-security-notifications@FreeBSD.ORG</email>"> + +<!ENTITY a.small "FreeBSD-small メーリングリスト + <email>freebsd-small@FreeBSD.ORG</email>"> + +<!ENTITY a.smp "FreeBSD 対称型マルチプロセッシングに関するメーリングリスト + <email>freebsd-smp@FreeBSD.ORG</email>"> + +<!ENTITY a.stable "FreeBSD-stable mailing list + <email>freebsd-stable@FreeBSD.ORG</email>"> + +<!ENTITY a.tokenring "FreeBSD TokenRing メーリングリスト + <email>freebsd-tokenring@FreeBSD.ORG</email>"> + +<!ENTITY a.majordomo "<email>majordomo@FreeBSD.ORG</email>"> + +<!ENTITY a.core "FreeBSD core team + <email>freebsd-core@FreeBSD.ORG</email>"> diff --git a/ja_JP.eucJP/books/handbook/mirrors/chapter.sgml b/ja_JP.eucJP/books/handbook/mirrors/chapter.sgml new file mode 100644 index 0000000000..d103cb2707 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/mirrors/chapter.sgml @@ -0,0 +1,1217 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.10 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:58 kuriyama Exp $ +--> + +<chapter id="mirrors"> + <title>FreeBSD の入手方法</title> + + <sect1> + <title>CD-ROM 出版社</title> + + <para>FreeBSD は Walnut Creek CDROM から出されている CD-ROM + から入手できます: + + <address> + <otheraddr>Walnut Creek CDROM</otheraddr> + <street>4041 Pike Lane, Suite F</street> + <city>Concord</city> + <state>CA</state>, <postcode>94520</postcode> + <country>USA</country> + Phone: <phone>+1 925 674-0783</phone> + Fax: <fax>+1 925 674-0821</fax> + Email: <email>info@cdrom.com</email> + WWW: <otheraddr>http://www.cdrom.com/</otheraddr> + </address></para> + </sect1> + + <sect1 id="mirrors-ftp"> + <title>FTP サイト</title> + + <para>FreeBSD の公式な情報は anonymous FTP によって以下の場所から + 入手できます: + + <blockquote> + <para><ulink URL="ftp://ftp.FreeBSD.ORG/pub/FreeBSD">ftp://ftp.FreeBSD.ORG/pub/FreeBSD</ulink>.</para> + </blockquote> + </para> + + <para><ulink + url="http://www.itworks.com.au/~gavin/FBSDsites.php3">FreeBSD + ミラーサイトデーターベース</ulink> FreeBSD ハンドブックの + “ミラーサイト一覧” + よりも正確です.というのはその情報を DNS から取得するので, + 静的に記述されたリストよりも信頼性が高いのです.</para> + + <para>さらに, FreeBSD は以下のミラーサイトから anonymous FTP + によって 入手できます. もし FreeBSD を anonymous FTP + によって手にいれる場合は, + 近くのサイトを利用するようにしてください.</para> + + <para><link linkend="mirrors-ar">Argentina</link>, + <link linkend="mirrors-au">Australia</link>, + <link linkend="mirrors-br">Brazil</link>, + <link linkend="mirrors-ca">Canada</link>, + <link linkend="mirrors-cz">Czech Republic</link>, + <link linkend="mirrors-dk">Denmark</link>, + <link linkend="mirrors-ee">Estonia</link>, + <link linkend="mirrors-fi">Finland</link>, + <link linkend="mirrors-fr">France</link>, + <link linkend="mirrors-de">Germany</link>, + <link linkend="mirrors-hk">Hong Kong</link>, + <link linkend="mirrors-ie">Ireland</link>, + <link linkend="mirrors-il">Israel</link>, + <link linkend="mirrors-jp">Japan</link>, + <link linkend="mirrors-kr">Korea</link>, + <link linkend="mirrors-nl">Netherlands</link>, + <link linkend="mirrors-pl">Poland</link>, + <link linkend="mirrors-pt">Portugal</link>, + <link linkend="mirrors-ru">Russia</link>, + <link linkend="mirrors-za">South Africa</link>, + <link linkend="mirrors-es">Spain</link>, + <link linkend="mirrors-sk">Slovak Republic</link>, + <link linkend="mirrors-si">Slovenia</link>, + <link linkend="mirrors-se">Sweden</link>, + <link linkend="mirrors-tw">Taiwan</link>, + <link linkend="mirrors-th">Thailand</link>, + <link linkend="mirrors-uk">UK</link>, + <link linkend="mirrors-ua">Ukraine</link>, + <link linkend="mirrors-us">USA</link>.</para> + + <variablelist> + <varlistentry><term><anchor id="mirrors-ar">アルゼンチン</term> + <listitem> + <para>何か問題がある場合は,このドメインの + hostmaster <email>hostmaster@ar.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.ar.FreeBSD.ORG/pub/FreeBSD">ftp.ar.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-au">オーストラリア</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@au.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.au.FreeBSD.ORG/pub/FreeBSD">ftp://ftp.au.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp2.au.FreeBSD.ORG/pub/FreeBSD">ftp://ftp2.au.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp3.au.FreeBSD.ORG/pub/FreeBSD">ftp://ftp3.au.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp4.au.FreeBSD.ORG/pub/FreeBSD">ftp://ftp4.au.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-br">ブラジル</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@br.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.br.FreeBSD.ORG/pub/FreeBSD">ftp://ftp.br.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp2.br.FreeBSD.ORG/pub/FreeBSD">ftp://ftp2.br.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp3.br.FreeBSD.ORG/pub/FreeBSD">ftp://ftp3.br.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp4.br.FreeBSD.ORG/pub/FreeBSD">ftp://ftp4.br.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp5.br.FreeBSD.ORG/pub/FreeBSD">ftp://ftp5.br.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp6.br.FreeBSD.ORG/pub/FreeBSD">ftp://ftp6.br.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp7.br.FreeBSD.ORG/pub/FreeBSD">ftp://ftp7.br.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-ca">カナダ</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@ca.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.ca.FreeBSD.ORG/pub/FreeBSD">ftp://ftp.ca.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-cz">チェコ</term> + <listitem> + <itemizedlist> + <listitem> + <para><ulink URL="ftp://sunsite.mff.cuni.cz/OS/FreeBSD">ftp://sunsite.mff.cuni.cz/OS/FreeBSD</ulink><!-- <br> --> + 連絡先: <email>jj@sunsite.mff.cuni.cz</email>.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-dk">デンマーク</term> + <listitem> + <para>何か問題がある場合は,このドメインの hostmaster + <email>hostmaster@dk.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.dk.freeBSD.ORG/pub/FreeBSD">ftp://ftp.dk.freeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-ee">エストニア</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@ee.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.ee.freebsd.ORG/pub/FreeBSD">ftp://ftp.ee.freebsd.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-fi">フィンランド</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@fi.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.fi.freebsd.ORG/pub/FreeBSD">ftp://ftp.fi.freebsd.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-fr">フランス</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@fr.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.fr.FreeBSD.ORG/pub/FreeBSD">ftp://ftp.fr.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp2.fr.FreeBSD.ORG/pub/FreeBSD">ftp://ftp2.fr.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp3.fr.FreeBSD.ORG/pub/FreeBSD">ftp://ftp3.fr.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-de">ドイツ</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@de.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.de.FreeBSD.ORG/pub/FreeBSD">ftp://ftp.de.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp2.de.FreeBSD.ORG/pub/FreeBSD">ftp://ftp2.de.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp3.de.FreeBSD.ORG/pub/FreeBSD">ftp://ftp3.de.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp4.de.FreeBSD.ORG/pub/FreeBSD">ftp://ftp4.de.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp5.de.FreeBSD.ORG/pub/FreeBSD">ftp://ftp5.de.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp6.de.FreeBSD.ORG/pub/FreeBSD">ftp://ftp6.de.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp7.de.FreeBSD.ORG/pub/FreeBSD">ftp://ftp7.de.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-hk">香港</term> + <listitem> + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.hk.super.net/pub/FreeBSD">ftp://ftp.hk.super.net/pub/FreeBSD</ulink><!-- <br> --> +連絡先: <email>ftp-admin@HK.Super.NET</email>.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-ie">アイルランド</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@ie.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.ie.FreeBSD.ORG/pub/FreeBSD">ftp://ftp.ie.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-il">イスラエル</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@il.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.il.FreeBSD.ORG/pub/FreeBSD">ftp://ftp.il.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp2.il.FreeBSD.ORG/pub/FreeBSD">ftp://ftp2.il.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-jp">日本</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@jp.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.jp.FreeBSD.ORG/pub/FreeBSD">ftp://ftp.jp.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp2.jp.FreeBSD.ORG/pub/FreeBSD">ftp://ftp2.jp.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp3.jp.FreeBSD.ORG/pub/FreeBSD">ftp://ftp3.jp.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp4.jp.FreeBSD.ORG/pub/FreeBSD">ftp://ftp4.jp.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp5.jp.FreeBSD.ORG/pub/FreeBSD">ftp://ftp5.jp.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp6.jp.FreeBSD.ORG/pub/FreeBSD">ftp://ftp6.jp.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-kr">韓国</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@kr.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.kr.FreeBSD.ORG/pub/FreeBSD">ftp://ftp.kr.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp2.kr.FreeBSD.ORG/pub/FreeBSD">ftp://ftp2.kr.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + <!-- kuriyama - remove br around here --> + + <listitem> + <para><ulink URL="ftp://ftp3.kr.FreeBSD.ORG/pub/FreeBSD">ftp://ftp3.kr.FreeBSD.ORG/pub/FreeBSD</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp4.kr.FreeBSD.ORG/pub/FreeBSD">ftp://ftp4.kr.FreeBSD.ORG/pub/FreeBSD</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp5.kr.FreeBSD.ORG/pub/FreeBSD">ftp://ftp5.kr.FreeBSD.ORG/pub/FreeBSD</ulink></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp6.kr.FreeBSD.ORG/pub/FreeBSD">ftp://ftp6.kr.FreeBSD.ORG/pub/FreeBSD</ulink></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-nl">オランダ</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@nl.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.nl.freebsd.ORG/pub/FreeBSD">ftp://ftp.nl.freebsd.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-pl">ポーランド</term> + <listitem> + <para>何か問題がある場合は,このドメインの hostmaster + <email>hostmaster@pl.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.pl.freebsd.ORG/pub/FreeBSD">ftp://ftp.pl.freebsd.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-pt">ポルトガル</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@pt.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.pt.freebsd.org/pub/FreeBSD">ftp://ftp.pt.freebsd.org/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp2.pt.freebsd.org/pub/FreeBSD">ftp://ftp2.pt.freebsd.org/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-ru">ロシア</term> + <listitem> + <para>何か問題がある場合は, このドメインの + hostmaster <email>hostmaster@ru.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.ru.freebsd.org/pub/FreeBSD">ftp://ftp.ru.freebsd.org/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp2.ru.freebsd.org/pub/FreeBSD">ftp://ftp2.ru.freebsd.org/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp3.ru.freebsd.org/pub/FreeBSD">ftp://ftp3.ru.freebsd.org/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp4.ru.freebsd.org/pub/FreeBSD">ftp://ftp4.ru.freebsd.org/pub/FreeBSD</ulink></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-za">南アフリカ</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@za.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.za.FreeBSD.ORG/pub/FreeBSD">ftp://ftp.za.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp2.za.FreeBSD.ORG/pub/FreeBSD">ftp://ftp2.za.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp3.za.FreeBSD.ORG/FreeBSD">ftp://ftp3.za.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-si">スロベニア</term> + <listitem> + <para>何か問題がある場合には, このドメインの hostmaster + <email>hostmaster@si.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.si.freebsd.ORG/pub/FreeBSD">ftp://ftp.si.freebsd.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-sk">スロヴァキア共和国</term> + <listitem> + <para>何か問題がある場合には, このドメインの hostmaster + <email>hostmaster@sk.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.sk.freebsd.ORG/pub/FreeBSD">ftp://ftp.sk.freebsd.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + <!-- kuriyama - remove br around here --> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-es">スペイン</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@es.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.es.freebsd.ORG/pub/FreeBSD">ftp://ftp.es.freebsd.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-se">スウェーデン</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@se.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.se.FreeBSD.ORG/pub/FreeBSD">ftp://ftp.se.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp2.se.FreeBSD.ORG/pub/FreeBSD">ftp://ftp2.se.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp3.se.FreeBSD.ORG/pub/FreeBSD">ftp://ftp3.se.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-tw">台湾</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@tw.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.tw.FreeBSD.ORG/pub/FreeBSD">ftp://ftp.tw.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp2.tw.FreeBSD.ORG/pub/FreeBSD">ftp://ftp2.tw.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp3.tw.FreeBSD.ORG/pub/FreeBSD">ftp://ftp3.tw.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-th">タイ</term> + <listitem> + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.nectec.or.th/pub/FreeBSD">ftp://ftp.nectec.or.th/pub/FreeBSD</ulink><!-- <br> --> + 連絡先: <email>ftpadmin@ftp.nectec.or.th</email>.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-ua">ウクライナ</term> + <listitem> + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.ua.FreeBSD.ORG/pub/FreeBSD">ftp://ftp.ua.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --> + 連絡先: <email>freebsd-mnt@lucky.net</email>.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-uk">イギリス</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@uk.FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.uk.FreeBSD.ORG/pub/FreeBSD">ftp://ftp.uk.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp2.uk.FreeBSD.ORG/pub/FreeBSD">ftp://ftp2.uk.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp3.uk.FreeBSD.ORG/pub/FreeBSD">ftp://ftp3.uk.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp4.uk.FreeBSD.ORG/pub/FreeBSD">ftp://ftp4.uk.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term><anchor id="mirrors-us">アメリカ</term> + <listitem> + <para>何か問題がある場合は, このドメインの hostmaster + <email>hostmaster@FreeBSD.ORG</email> + に連絡してください.</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.FreeBSD.ORG/pub/FreeBSD">ftp://ftp.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp2.FreeBSD.ORG/pub/FreeBSD">ftp://ftp2.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp3.FreeBSD.ORG/pub/FreeBSD">ftp://ftp3.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp4.FreeBSD.ORG/pub/FreeBSD">ftp://ftp4.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp5.FreeBSD.ORG/pub/FreeBSD">ftp://ftp5.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp6.FreeBSD.ORG/pub/FreeBSD">ftp://ftp6.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> + + <para>FreeBSD (2.0C またはそれ以降) の輸出規制コード (eBones と + secure) の 最新のバージョンは以下の場所から入手できます. + もしあなたがアメリカやカナダ以外にいるのであれば, secure (DES) + と eBones (Kerberos) を + 以下の外国向けの配布サイトから手にいれてください:</para> + + <variablelist> + <varlistentry><term>南アフリカ</term> + <listitem> + <para>このドメインの Hostmaster + <email>hostmaster@internat.FreeBSD.ORG</email> .</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.internat.FreeBSD.ORG/pub/FreeBSD">ftp://ftp.internat.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ftp2.internat.FreeBSD.ORG/pub/FreeBSD">ftp://ftp2.internat.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>ブラジル</term> + <listitem> + <para>このドメインの Hostmaster + <email>hostmaster@br.FreeBSD.ORG</email> .</para> + + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.br.FreeBSD.ORG/pub/FreeBSD">ftp://ftp.br.FreeBSD.ORG/pub/FreeBSD</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>フィンランド</term> + <listitem> + <itemizedlist> + <listitem> + <para><ulink URL="ftp://nic.funet.fi/pub/unix/FreeBSD/eurocrypt">ftp://nic.funet.fi/pub/unix/FreeBSD/eurocrypt</ulink><!-- <br> --> +連絡先: <email>count@nic.funet.fi</email>.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> + </sect1> + + <sect1 id="mirrors-ctm"> + <title>CTM サイト</title> + + <para><link linkend="ctm">CTM</link>/FreeBSD + は以下のミラーサイトから anonymous FTP によって入手できます. + もし CTM を anonymous FTP によって手にいれる場合は, + 近くのサイトを利用するようにしてください.</para> + + <para>何か問題がある場合は, &a.phk;に連絡してください.</para> + + <variablelist> + <varlistentry><term>カリフォルニア, サンフランシスコ近辺, + 公式なソース</term> + <listitem> + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.freebsd.org/pub/FreeBSD/CTM">ftp://ftp.freebsd.org/pub/FreeBSD/CTM</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>ドイツ, トリエル</term> + <listitem> + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.uni-trier.de/pub/unix/systems/BSD/FreeBSD/CTM">ftp://ftp.uni-trier.de/pub/unix/systems/BSD/FreeBSD/CTM</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>南アフリカ, ctm, sup, + CVSupなどの古い差分ファイルのバックアップサーバ</term> + <listitem> + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ftp.internat.freebsd.org/pub/FreeBSD/CTM">ftp://ftp.internat.freebsd.org/pub/FreeBSD/CTM</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>台湾/中華民国, チャーイー(嘉義)</term> + <listitem> + <itemizedlist> + <listitem> + <para><ulink URL="ftp://ctm.tw.freebsd.org/pub/freebsd/CTM">ftp://ctm.tw.freebsd.org/pub/freebsd/CTM</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ctm2.tw.freebsd.org/pub/FreeBSD/CTM">ftp://ctm2.tw.freebsd.org/pub/FreeBSD/CTM</ulink><!-- <br> --></para> + </listitem> + + <listitem> + <para><ulink URL="ftp://ctm3.tw.freebsd.org/pub/freebsd/CTM">ftp://ctm3.tw.freebsd.org/pub/freebsd/CTM</ulink><!-- <br> --></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> + + <para>近くにミラーサイトがない場合やミラーが不完全な場合は, + <ulink URL="http://ftpsearch.ntnu.no/ftpsearch/"> + http://ftpsearch.ntnu.no/ftpsearch</ulink> の + <ulink URL="http://ftpsearch.ntnu.no/">FTP search</ulink> + を試してください. + FTP search はノルウェーの Trondheim にある, + フリーの素晴らしい アーカイブサーバです.</para> + </sect1> + + <sect1 id="mirrors-cvsup"> + <title>CVSup サイト</title> + + <para>FreeBSD の <link linkend="cvsup">CVSup</link> + サーバは以下のサイトで稼働しています:</para> + + <variablelist> + <varlistentry><term>アルゼンチン</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.ar.FreeBSD.ORG + (maintainer <email>msagre@cactus.fi.uba.ar</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>オーストラリア</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.au.FreeBSD.ORG + (maintainer <email>dawes@physics.usyd.edu.au</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>ブラジル</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.br.FreeBSD.ORG + (maintainer <email>cvsup@cvsup.br.freebsd.org</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>カナダ</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.ca.FreeBSD.ORG + (maintainer <email>dm@globalserve.net</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>デンマーク</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.dk.FreeBSD.ORG + (maintainer <email>jesper@skriver.dk</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>エストニア</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.ee.FreeBSD.ORG + (maintainer <email>taavi@uninet.ee</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>フィンランド</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.fi.FreeBSD.ORG + (maintainer <email>count@key.sms.fi</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>ドイツ</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.de.FreeBSD.ORG + (maintainer <email>wosch@freebsd.org</email>)</para> + </listitem> + + <listitem> + <para>cvsup2.de.FreeBSD.ORG + (maintainer <email>petzi@freebsd.org</email>)</para> + </listitem> + + <listitem> + <para>cvsup3.de.FreeBSD.ORG + (maintainer <email>ag@leo.org</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>アイスランド</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.is.FreeBSD.ORG + (maintainer <email>adam@veda.is</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>日本</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.jp.FreeBSD.ORG + (maintainer <email>simokawa@sat.t.u-tokyo.ac.jp</email>)</para> + </listitem> + + <listitem> + <para>cvsup2.jp.FreeBSD.ORG + (maintainer <email>max@FreeBSD.ORG</email>)</para> + </listitem> + + <listitem> + <para>cvsup3.jp.FreeBSD.ORG + (maintainer <email>shige@cin.nihon-u.ac.jp</email>)</para> + </listitem> + + <listitem> + <para>cvsup4.jp.FreeBSD.ORG + (maintainer + <email>cvsup-admin@ftp.media.kyoto-u.ac.jp</email>)</para> + </listitem> + + <listitem> + <para>cvsup5.jp.FreeBSD.ORG + (maintainer <email>cvsup@imasy.or.jp</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>オランダ</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.nl.FreeBSD.ORG + (maintainer <email>xaa@xaa.iae.nl</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>ノルウェー</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.no.FreeBSD.ORG + (maintainer <email>Tor.Egge@idt.ntnu.no</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>ポーランド</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.pl.FreeBSD.ORG + (maintainer <email>Mariusz@kam.pl</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>ロシア</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.ru.FreeBSD.ORG + (maintainer <email>mishania@demos.su</email>)</para> + </listitem> + + <listitem> + <para>cvsup2.ru.FreeBSD.ORG + (maintainer <email>dv@dv.ru</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>スロヴァキア共和国</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.sk.FreeBSD.ORG + (maintainer <email>tps@tps.sk</email>)</para> + </listitem> + + <listitem> + <para>cvsup2.sk.FreeBSD.ORG + (maintainer <email>tps@tps.sk</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>南アフリカ</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.za.FreeBSD.ORG + (maintainer <email>markm@FreeBSD.ORG</email>)</para> + </listitem> + + <listitem> + <para>cvsup2.za.FreeBSD.ORG + (maintainer <email>markm@FreeBSD.ORG</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>スウェーデン</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.se.FreeBSD.ORG + (maintainer <email>pantzer@ludd.luth.se</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>台湾</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.tw.FreeBSD.ORG + (maintainer + <email>jdli@freebsd.csie.nctu.edu.tw</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>ウクライナ</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup2.ua.FreeBSD.ORG + (maintainer <email>freebsd-mnt@lucky.net</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>イギリス</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.uk.FreeBSD.ORG + (maintainer <email>joe@pavilion.net</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>アメリカ</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup1.FreeBSD.ORG + (maintainer + <email>skynyrd@opus.cts.cwu.edu</email>), ワシントン州</para> + </listitem> + + <listitem> + <para>cvsup2.FreeBSD.ORG + (maintainer + <email>jdp@FreeBSD.ORG</email>), カリフォルニア</para> + </listitem> + + <listitem> + <para>cvsup3.FreeBSD.ORG + (maintainer + <email>wollman@FreeBSD.ORG</email>), マサチューセッツ</para> + </listitem> + + <listitem> + <para>cvsup4.FreeBSD.ORG + (maintainer <email>shmit@rcn.com</email>), バージニア</para> + </listitem> + + <listitem> + <para>cvsup5.FreeBSD.ORG + (maintainer + <email>cvsup@adsu.bellsouth.com</email>), ジョージア</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> + + <para>FreeBSD の輸出規制されたコード (eBones と secure) は + <application>CVSup</application> 経由で以下 + の国際的なリポジトリから入手できます. + アメリカ合衆国やカナダ以外に居る 場合は, + このサイトを使って輸出規制されたコードを入手してください.</para> + + <variablelist> + <varlistentry><term>南アフリカ</term> + <listitem> + <itemizedlist> + <listitem> + <para>cvsup.internat.FreeBSD.ORG + (maintainer <email>markm@FreeBSD.ORG</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> + + <para>以下の <application>CVSup</application> サイトは, <link + linkend="ctm">CTM</link>ユーザのことを特に + 考慮して運用されています. 他の CVSup のミラーサイトとは異なり, + これら のサイトでは <application>CTM</application> + を使って最新の状態を保っています. つまり, もし以下の サイトから + <literal>cvs-all</literal> を <literal>release=cvs</literal> で + <application>CVSup</application> すれば, + <application>CTM</application> の <literal>cvs-cur</literal> + のデルタを使って更新するのに適した CVS のリポ ジトリ + (必須となる<filename> .ctm_status</filename> + ファイルも含まれています.) を 入手することができます. + これにより, これまで <application>CVSup</application> を使って + <literal>cvs-all</literal> 全部を入手していたユーザも + <application>CTM</application> のベースデルタを使って + 最初からリポジトリを構築し直すことなく + <application>CVSu</application>p から + <application>CTM</application> へと移行すること + が可能です.</para> + + <note> + <para>この機能は, リリースタグを <command>cvs</command> として + <literal>cvs-all</literal> ディ + ストリビューションを入手する時のみ + 利用できるものですので注意してくださ い. + 他のディストリビューションやリリースタグを + 指定した場合でも指定した ファイルを入手することは可能ですが, + これらのファイルを <application>CTM</application> で更新する + ことはできません.</para> + </note> + + <note> + <para>また, <application>CTM</application> + の現在のバージョンではタイムスタンプを保存しないため, 以 + 下のサイトのファイルのタイムスタンプは + 他のミラーとは異なる物となってい ますので注意が必要です. + 利用するサイトを以下のサイトと他のサイトの間で + 変更することはお勧めできません. + ファイルの転送は問題なくできますが, 少々 非能率的です.</para> + </note> + + <variablelist> + <varlistentry><term>ドイツ</term> + <listitem> + <itemizedlist> + <listitem> + <para>ctm.FreeBSD.ORG + (maintainer <email>blank@fox.uni-trier.de</email>)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> + </sect1> + + <sect1 id="mirrors-afs"> + <title>AFS サイト</title> + + <para>FreeBSD の AFS サーバは以下のサイトで稼働しています:</para> + + <variablelist> + <varlistentry> + <term>スウェーデン</term> + <listitem> + <para>ファイルは以下の場所にあります: + <filename>/afs/stacken.kth.se/ftp/pub/FreeBSD</filename></para> + + <itemizedlist> + <listitem> + <para><hostid role="fqdn">stacken.kth.se</hostid>, + Stacken Computer Club, KTH, Sweden</para> + </listitem> + + <listitem> + <para><hostid role="ipaddr">130.237.234.3</hostid>, <hostid + role="fqdn">milko.stacken.kth.se</hostid></para> + </listitem> + + <listitem> + <para><hostid role="ipaddr">130.237.234.43</hostid>, <hostid + role="fqdn">hot.stacken.kth.se</hostid></para> + </listitem> + + <listitem> + <para><hostid role="ipaddr">130.237.234.44</hostid>, <hostid role="fqdn">dog.stacken.kth.se</hostid></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/newsgroups.ent b/ja_JP.eucJP/books/handbook/newsgroups.ent new file mode 100644 index 0000000000..809207361b --- /dev/null +++ b/ja_JP.eucJP/books/handbook/newsgroups.ent @@ -0,0 +1,14 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.1 + $Id: newsgroups.ent,v 1.1.1.1 1999-04-08 15:45:57 kuriyama Exp $ + + Names of FreeBSD newsgroups +--> + +<!ENTITY ng.misc "the + <ulink url='news:comp.unix.bsd.freebsd.misc'>comp.unix.bsd.freebsd.misc</ulink> + newsgroup"> + diff --git a/ja_JP.eucJP/books/handbook/pgpkeys/chapter.sgml b/ja_JP.eucJP/books/handbook/pgpkeys/chapter.sgml new file mode 100644 index 0000000000..5daeeb727d --- /dev/null +++ b/ja_JP.eucJP/books/handbook/pgpkeys/chapter.sgml @@ -0,0 +1,586 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.8 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:58 kuriyama Exp $ +--> + +<chapter id="pgpkeys"> + <title>PGP 公開鍵</title> + + <para><emphasis>原作: 不明.</emphasis></para> + + <para><emphasis>訳: &a.jp.kiroh;.</emphasis></para> + + <para>署名を検証したり, コアチームメンバやオフィサに暗号メー + ルを送りたい場合のために, PGPの公開鍵を添付します.</para> + + <sect1> + <title>オフィサ</title> + + <sect2> + <title>FreeBSD Security Officer + <email>security-officer@freebsd.org</email></title> + + <programlisting> +FreeBSD Security Officer <security-officer@freebsd.org> +Fingerprint = 41 08 4E BB DB 41 60 71 F9 E5 0E 98 73 AF 3F 11 + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.3i + +mQCNAzF7MY4AAAEEAK7qBgPuBejER5HQbQlsOldk3ZVWXlRj54raz3IbuAUrDrQL +h3g57T9QY++f3Mot2LAf5lDJbsMfWrtwPrPwCCFRYQd6XH778a+l4ju5axyjrt/L +Ciw9RrOC+WaPv3lIdLuqYge2QRC1LvKACIPNbIcgbnLeRGLovFUuHi5z0oilAAUR +tDdGcmVlQlNEIFNlY3VyaXR5IE9mZmljZXIgPHNlY3VyaXR5LW9mZmljZXJAZnJl +ZWJzZC5vcmc+iQCVAwUQMX6yrOJgpPLZnQjrAQHyowQA1Nv2AY8vJIrdp2ttV6RU +tZBYnI7gTO3sFC2bhIHsCvfVU3JphfqWQ7AnTXcD2yPjGcchUfc/EcL1tSlqW4y7 +PMP4GHZp9vHog1NAsgLC9Y1P/1cOeuhZ0pDpZZ5zxTo6TQcCBjQA6KhiBFP4TJql +3olFfPBh3B/Tu3dqmEbSWpuJAJUDBRAxez3C9RVb+45ULV0BAak8A/9JIG/jRJaz +QbKom6wMw852C/Z0qBLJy7KdN30099zMjQYeC9PnlkZ0USjQ4TSpC8UerYv6IfhV +nNY6gyF2Hx4CbEFlopnfA1c4yxtXKti1kSN6wBy/ki3SmqtfDhPQ4Q31p63cSe5A +3aoHcjvWuqPLpW4ba2uHVKGP3g7SSt6AOYkAlQMFEDF8mz0ff6kIA1j8vQEBmZcD +/REaUPDRx6qr1XRQlMs6pfgNKEwnKmcUzQLCvKBnYYGmD5ydPLxCPSFnPcPthaUb +5zVgMTjfjS2fkEiRrua4duGRgqN4xY7VRAsIQeMSITBOZeBZZf2oa9Ntidr5PumS +9uQ9bvdfWMpsemk2MaRG9BSoy5Wvy8VxROYYUwpT8Cf2iQCVAwUQMXsyqWtaZ42B +sqd5AQHKjAQAvolI30Nyu3IyTfNeCb/DvOe9tlOn/o+VUDNJiE/PuBe1s2Y94a/P +BfcohpKC2kza3NiW6lLTp00OWQsuu0QAPc02vYOyseZWy4y3Phnw60pWzLcFdemT +0GiYS5Xm1o9nAhPFciybn9j1q8UadIlIq0wbqWgdInBT8YI/l4f5sf6JAJUDBRAx +ezKXVS4eLnPSiKUBAc5OBACIXTlKqQC3B53qt7bNMV46m81fuw1PhKaJEI033mCD +ovzyEFFQeOyRXeu25Jg9Bq0Sn37ynISucHSmt2tUD5W0+p1MUGyTqnfqejMUWBzO +v4Xhp6a8RtDdUMBOTtro16iulGiRrCKxzVgEl4i+9Z0ZiE6BWlg5AetoF5n3mGk1 +lw== +=ipyA +-----END PGP PUBLIC KEY BLOCK-----</programlisting> + </sect2> + + <sect2> + <title>&a.imp;</title> + + <programlisting> +Warner Losh <imp@village.org> + aka <imp@freebsd.org> +Fingerprint = D4 31 FD B9 F7 90 17 E8 37 C5 E7 7F CF A6 C1 B9 +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.2 + +mQCNAzDzTiAAAAEEAK8D7KWEbVFUrmlqhUEnAvphNIqHEbqqT8s+c5f5c2uHtlcH +V4mV2TlUaDSVBN4+/D70oHmZc4IgiQwMPCWRrSezg9z/MaKlWhaslc8YT6Xc1q+o +EP/fAdKUrq49H0QQbkQk6Ks5wKW6v9AOvdmsS6ZJEcet6d9G4dxynu/2qPVhAAUR +tCBNLiBXYXJuZXIgTG9zaCA8aW1wQHZpbGxhZ2Uub3JnPokAlQMFEDM/SK1VLh4u +c9KIpQEBFPsD/1n0YuuUPvD4CismZ9bx9M84y5sxLolgFEfP9Ux196ZSeaPpkA0g +C9YX/IyIy5VHh3372SDWN5iVSDYPwtCmZziwIV2YxzPtZw0nUu82P/Fn8ynlCSWB +5povLZmgrWijTJdnUWI0ApVBUTQoiW5MyrNN51H3HLWXGoXMgQFZXKWYiQCVAwUQ +MzmhkfUVW/uOVC1dAQG3+AP/T1HL/5EYF0ij0yQmNTzt1cLt0b1e3N3zN/wPFFWs +BfrQ+nsv1zw7cEgxLtktk73wBGM9jUIdJu8phgLtl5a0m9UjBq5oxrJaNJr6UTxN +a+sFkapTLT1g84UFUO/+8qRB12v+hZr2WeXMYjHAFUT18mp3xwjW9DUV+2fW1Wag +YDKJAJUDBRAzOYK1s1pi61mfMj0BARBbA/930CHswOF0HIr+4YYUs1ejDnZ2J3zn +icTZhl9uAfEQq++Xor1x476j67Z9fESxyHltUxCmwxsJ1uOJRwzjyEoMlyFrIN4C +dE0C8g8BF+sRTt7VLURLERvlBvFrVZueXSnXvmMoWFnqpSpt3EmN6TNaLe8Cm87a +k6EvQy0dpnkPKokAlQMFEDD9Lorccp7v9qj1YQEBrRUD/3N4cCMWjzsIFp2Vh9y+ +RzUrblyF84tJyA7Rr1p+A7dxf7je3Zx5QMEXosWL1WGnS5vC9YH2WZwv6sCU61gU +rSy9z8KHlBEHh+Z6fdRMrjd9byPf+n3cktT0NhS23oXB1ZhNZcB2KKhVPlNctMqO +3gTYx+Nlo6xqjR+J2NnBYU8p +=7fQV +-----END PGP PUBLIC KEY BLOCK-----</programlisting> + </sect2> + </sect1> + + <sect1> + <title>コアチームメンバ</title> + + <sect2> + <title>&a.asami;</title> + + <programlisting> +Satoshi Asami <asami@cs.berkeley.edu> + aka <asami@FreeBSD.ORG> +Fingerprint = EB 3C 68 9E FB 6C EB 3F DB 2E 0F 10 8F CE 79 CA + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.2 + +mQCNAzPVyoQAAAEEAL7W+kipxB171Z4SVyyL9skaA7hG3eRsSOWk7lfvfUBLtPog +f3OKwrApoc/jwLf4+Qpdzv5DLEt/6Hd/clskhJ+q1gMNHyZ5ABmUxrTRRNvJMTrb +3fPU3oZj7sL/MyiFaT1zF8EaMP/iS2ZtcFsbYOqGeA8E/58uk4NA0SoeCNiJAAUR +tCVTYXRvc2hpIEFzYW1pIDxhc2FtaUBjcy5iZXJrZWxleS5lZHU+iQCVAwUQM/AT ++EqGN2HYnOMZAQF11QP/eSXb2FuTb1yX5yoo1Im8YnIk1SEgCGbyEbOMMBznVNDy +5g2TAD0ofLxPxy5Vodjg8rf+lfMVtO5amUH6aNcORXRncE83T10JmeM6JEp0T6jw +zOHKz8jRzygYLBayGsNIJ4BGxa4LeaGxJpO1ZEvRlNkPH/YEXK5oQmq9/DlrtYOJ +AEUDBRAz42JT8ng6GBbVvu0BAU8nAYCsJ8PiJpRUGlrz6rxjX8hqM1v3vqFHLcG+ +G52nVMBSy+RZBgzsYIPwI5EZtWAKb22JAJUDBRAz4QBWdbtuOHaj97EBAaQPA/46 ++NLUp+Wubl90JoonoXocwAg88tvAUVSzsxPXj0lvypAiSI2AJKsmn+5PuQ+/IoQy +lywRsxiQ5GD7C72SZ1yw2WI9DWFeAi+qa4b8n9fcLYrnHpyCY+zxEpu4pam8FJ7H +JocEUZz5HRoKKOLHErzXDiuTkkm72b1glmCqAQvnB4kAlQMFEDPZ3gyDQNEqHgjY +iQEBFfUEALu2C0uo+1Z7C5+xshWRYY5xNCzK20O6bANVJ+CO2fih96KhwsMof3lw +fDso5HJSwgFd8WT/sR+Wwzz6BAE5UtgsQq5GcsdYQuGI1yIlCYUpDp5sgswNm+OA +bX5a+r4F/ZJqrqT1J56Mer0VVsNfe5nIRsjd/rnFAFVfjcQtaQmjiQCVAwUQM9uV +mcdm8Q+/vPRJAQELHgP9GqNiMpLQlZig17fDnCJ73P0e5t/hRLFehZDlmEI2TK7j +Yeqbw078nZgyyuljZ7YsbstRIsWVCxobX5eH1kX+hIxuUqCAkCsWUY4abG89kHJr +XGQn6X1CX7xbZ+b6b9jLK+bJKFcLSfyqR3M2eCyscSiZYkWKQ5l3FYvbUzkeb6K0 +IVNhdG9zaGkgQXNhbWkgPGFzYW1pQEZyZWVCU0QuT1JHPg== +=39SC +-----END PGP PUBLIC KEY BLOCK-----</programlisting> + </sect2> + + <sect2> + <title>&a.jmb;</title> + + <programlisting> +Jonathan M. Bresler <jmb@FreeBSD.org> +f16 Key fingerprint16 = 31 57 41 56 06 C1 40 13 C5 1C E3 E5 DC 62 0E FB + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: PGPfreeware 5.0i for non-commercial use + +mQCNAzG2GToAAAEEANI6+4SJAAgBpl53XcfEr1M9wZyBqC0tzpie7Zm4vhv3hO8s +o5BizSbcJheQimQiZAY4OnlrCpPxijMFSaihshs/VMAz1qbisUYAMqwGEO/T4QIB +nWNo0Q/qOniLMxUrxS1RpeW5vbghErHBKUX9GVhxbiVfbwc4wAHbXdKX5jjdAAUR +tCVKb25hdGhhbiBNLiBCcmVzbGVyIDxqbWJARnJlZUJTRC5PUkc+iQCVAwUQNbtI +gAHbXdKX5jjdAQHamQP+OQr10QRknamIPmuHmFYJZ0jU9XPIvTTMuOiUYLcXlTdn +GyTUuzhbEywgtOldW2V5iA8platXThtqC68NsnN/xQfHA5xmFXVbayNKn8H5stDY +2s/4+CZ06mmJfqYmONF1RCbUk/M84rVT3Gn2tydsxFh4Pm32lf4WREZWRiLqmw+J +AJUDBRA0DfF99RVb+45ULV0BAcZ0BACCydiSUG1VR0a5DBcHdtin2iZMPsJUPRqJ +tWvP6VeI8OFpNWQ4LW6ETAvn35HxV2kCcQMyht1kMD+KEJz7r8Vb94TS7KtZnNvk +2D1XUx8Locj6xel5c/Lnzlnnp7Bp1XbJj2u/NzCaZQ0eYBdP/k7RLYBYHQQln5x7 +BOuiRJNVU4kAlQMFEDQLcShVLh4uc9KIpQEBJv4D/3mDrD0MM9EYOVuyXik3UGVI +8quYNA9ErVcLdt10NjYc16VI2HOnYVgPRag3Wt7W8wlXShpokfC/vCNt7f5JgRf8 +h2a1/MjQxtlD+4/Js8k7GLa53oLon6YQYk32IEKexoLPwIRO4L2BHWa3GzHJJSP2 +aTR/Ep90/pLdAOu/oJDUiQCVAwUQMqyL0LNaYutZnzI9AQF25QP9GFXhBrz2tiWz +2+0gWbpcGNnyZbfsVjF6ojGDdmsjJMyWCGw49XR/vPKYIJY9EYo4t49GIajRkISQ +NNiIz22fBAjT2uY9YlvnTJ9NJleMfHr4dybo7oEKYMWWijQzGjqf2m8wf9OaaofE +KwBX6nxcRbKsxm/BVLKczGYl3XtjkcuJAJUDBRA1ol5TZWCprDT5+dUBATzXA/9h +/ZUuhoRKTWViaistGJfWi26FB/Km5nDQBr/Erw3XksQCMwTLyEugg6dahQ1u9Y5E +5tKPxbB69eF+7JXVHE/z3zizR6VL3sdRx74TPacPsdhZRjChEQc0htLLYAPkJrFP +VAzAlSlm7qd+MXf8fJovQs6xPtZJXukQukPNlhqZ94kAPwMFEDSH/kF4tXKgazlt +bxECfk4AoO+VaFVfguUkWX10pPSSfvPyPKqiAJ4xn8RSIe1ttmnqkkDMhLh00mKj +lLQuSm9uYXRoYW4gTS4gQnJlc2xlciA8Sm9uYXRoYW4uQnJlc2xlckBVU2kubmV0 +PokAlQMFEDXbdSkB213Sl+Y43QEBV/4D/RLJNTrtAqJ1ATxXWv9g8Cr3/YF0GTmx +5dIrJOpBup7eSSmiM/BL9Is4YMsoVbXCI/8TqA67TMICvq35PZU4wboQB8DqBAr+ +gQ8578M7Ekw1OAF6JXY6AF2P8k7hMcVBcVOACELPT/NyPNByG5QRDoNmlsokJaWU +/2ls4QSBZZlb +=zbCw +-----END PGP PUBLIC KEY BLOCK-----</programlisting> + </sect2> + + <sect2> + <title>&a.ache;</title> + + <programlisting> +Andrey A. Chernov <ache@FreeBSD.org> + aka <ache@nagual.pp.ru> +Key fingerprint = 33 03 9F 48 33 7B 4A 15 63 48 88 0A C4 97 FD 49 + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.3ia + +mQCNAiqUMGQAAAEEAPGhcD6A2Buey5LYz0sphDLpVgOZc/bb9UHAbaGKUAGXmafs +Dcb2HnsuYGgX/zrQXuCi/wIGtXcZWB97APtKOhFsZnPinDR5n/dde/mw9FnuhwqD +m+rKSL1HlN0z/Msa5y7g16760wHhSR6NoBSEG5wQAHIMMq7Q0uJgpPLZnQjrAAUT +tCVBbmRyZXkgQS4gQ2hlcm5vdiA8YWNoZUBuYWd1YWwucHAucnU+iQCVAwUQM2Ez +u+JgpPLZnQjrAQEyugP8DPnS8ixJ5OeuYgPFQf5sy6l+LrB6hyaS+lgsUPahWjNY +cnaDmfda/q/BV5d4+y5rlQe/pjnYG7/yQuAR3jhlXz8XDrqlBOnW9AtYjDt5rMfJ +aGFTGXAPGZ6k6zQZE0/YurT8ia3qjvuZm3Fw4NJrHRx7ETHRvVJDvxA6Ggsvmr20 +JEFuZHJleSBBLiBDaGVybm92IDxhY2hlQEZyZWVCU0Qub3JnPokAlQMFEDR5uVbi +YKTy2Z0I6wEBLgED/2mn+hw4/3peLx0Sb9LNx//NfCCkVefSf2G9Qwhx6dvwbX7h +mFca97h7BQN4GubU1Z5Ffs6TeamSBrotBYGmOCwvJ6S9WigF9YHQIQ3B4LEjskAt +pcjU583y42zM11kkvEuQU2Gde61daIylJyOxsgpjSWpkxq50fgY2kLMfgl/ftCZB +bmRyZXkgQS4gQ2hlcm5vdiA8YWNoZUBuaWV0enNjaGUubmV0PokAlQMFEDR5svDi +YKTy2Z0I6wEBOTQD/0OTCAXIjuak363mjERvzSkVsNtIH9hA1l0w6Z95+iH0fHrW +xXKT0vBZE0y0Em+S3cotLL0bMmVE3F3D3GyxhBVmgzjyx0NYNoiQjYdi+6g/PV30 +Cn4vOO6hBBpSyI6vY6qGNqcsawuRtHNvK/53MpOfKwSlICEBYQimcZhkci+EtCJB +bmRyZXkgQS4gQ2hlcm5vdiA8YWNoZUBuYWd1YWwucnU+iQCVAwUQMcm5HeJgpPLZ +nQjrAQHwvQP9GdmAf1gdcuayHEgNkc11macPH11cwWjYjzA2YoecFMGV7iqKK8QY +rr1MjbGXf8DAG8Ubfm0QbI8Lj8iG3NgqIru0c72UuHGSn/APfGGG0AtPX5UK/k7B +gI0Ca2po6NA5nrSp8tDsdEz/4gyea84RXl2prtTf5Jj07hflbRstGXK0MkFuZHJl +eSBBLiBDaGVybm92LCBCbGFjayBNYWdlIDxhY2hlQGFzdHJhbC5tc2suc3U+iQCV +AwUQMCsAo5/rGryoL8h3AQHq1QQAidyNFqA9hvrmMcjpY7csJVFlGvj574Wj4GPa +o3pZeuQaMBmsWqaXLYnWU/Aldb6kTz6+nRcQX50zFH0THSPfApwEW7yybSTI5apJ +mWT3qhKN2vmLNg2yNzhqLTzHLD1lH3i1pfQq8WevrNfjLUco5S/VuekTma/osnzC +Cw7fQzCJAJUDBRAwKvwoa1pnjYGyp3kBARihBACoXr3qfG65hFCyKJISmjOvaoGr +anxUIkeDS0yQdTHzhQ+dwB1OhhK15E0Nwr0MKajLMm90n6+Zdb5y/FIjpPriu8dI +rlHrWZlewa88eEDM+Q/NxT1iYg+HaKDAE171jmLpSpCL0MiJtO0i36L3ekVD7Hv8 +vffOZHPSHirIzJOZTYkAlQMFEDAau6zFLUdtDb+QbQEBQX8D/AxwkYeFaYxZYMFO +DHIvSk23hAsjCmUA2Uil1FeWAusb+o8xRfPDc7TnosrIifJqbF5+fcHCG5VSTGlh +Bhd18YWUeabf/h9O2BsQX55yWRuB2x3diJ1xI/VVdG+rxlMCmE4ZR1Tl9x+Mtun9 +KqKVpB39VlkCBYQ3hlgNt/TJUY4riQCVAwUQMBHMmyJRltlmbQBRAQFQkwP/YC3a +hs3ZMMoriOlt3ZxGNUUPTF7rIER3j+c7mqGG46dEnDB5sUrkzacpoLX5sj1tGR3b +vz9a4vmk1Av3KFNNvrZZ3/BZFGpq3mCTiAC9zsyNYQ8L0AfGIUO5goCIjqwOTNQI +AOpNsJ5S+nMAkQB4YmmNlI6GTb3D18zfhPZ6uciJAJUCBRAwD0sl4uW74fteFRkB +AWsAA/9NYqBRBKbmltQDpyK4+jBAYjkXBJmARFXKJYTlnTgOHMpZqoVyW96xnaa5 +MzxEiu7ZWm5oL10QDIp1krkBP2KcmvfSMMHb5aGCCQc2/P8NlfXAuHtNGzYiI0UA +Iwi8ih/S1liVfvnqF9uV3d3koE7VsQ9OA4Qo0ZL2ggW+/gEaYIkAlQMFEDAOz6qx +/IyHe3rl4QEBIvYD/jIr8Xqo/2I5gncghSeFR01n0vELFIvaF4cHofGzyzBpYsfA ++6pgFI1IM+LUF3kbUkAY/2uSf9U5ECcaMCTWCwVgJVO+oG075SHEM4buhrzutZiM +1dTyTaepaPpTyRMUUx9ZMMYJs7sbqLId1eDwrJxUPhrBNvf/w2W2sYHSY8cdiQCV +AwUQMAzqgHcdkq6JcsfBAQGTxwQAtgeLFi2rhSOdllpDXUwz+SS6bEjFTWgRsWFM +y9QnOcqryw7LyuFmWein4jasjY033JsODfWQPiPVNA3UEnXVg9+n8AvNMPO8JkRv +Cn1eNg0VaJy9J368uArio93agd2Yf/R5r+QEuPjIssVk8hdcy/luEhSiXWf6bLMV +HEA0J+OJAJUDBRAwDUi+4mCk8tmdCOsBAatBBACHB+qtW880seRCDZLjl/bT1b14 +5po60U7u6a3PEBkY0NA72tWDQuRPF/Cn/0+VdFNxQUsgkrbwaJWOoi0KQsvlOm3R +rsxKbn9uvEKLxExyKH3pxp76kvz/lEWwEeKvBK+84Pb1lzpG3W7u2XDfi3VQPTi3 +5SZMAHc6C0Ct/mjNlYkAlQMFEDAMrPD7wj+NsTMUOQEBJckD/ik4WsZzm2qOx9Fw +erGq7Zwchc+Jq1YeN5PxpzqSf4AG7+7dFIn+oe6X2FcIzgbYY+IfmgJIHEVjDHH5 ++uAXyb6l4iKc89eQawO3t88pfHLJWbTzmnvgz2cMrxt94HRvgkHfvcpGEgbyldq6 +EB33OunazFcfZFRIcXk1sfyLDvYE +=1ahV +-----END PGP PUBLIC KEY BLOCK-----</programlisting> + </sect2> + + <sect2> + <title>&a.jkh;</title> + + <programlisting> +Jordan K. Hubbard <jkh@FreeBSD.org> +Fingerprint = 3C F2 27 7E 4A 6C 09 0A 4B C9 47 CD 4F 4D 0B 20 + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.3ia + +mQCNAzFjX0IAAAEEAML+nm9/kDNPp43ZUZGjYkm2QLtoC1Wxr8JulZXqk7qmhYcQ +jvX+fyoriJ6/7ZlnLe2oG5j9tZOnRLPvMaz0g9CpW6Dz3nkXrNPkmOFV9B8D94Mk +tyFeRJFqnkCuqBj6D+H8FtBwEeeTecSh2tJ0bZZTXnAMhxeOdvUVW/uOVC1dAAUR +tCNKb3JkYW4gSy4gSHViYmFyZCA8amtoQEZyZWVCU0Qub3JnPokBFQMFEDXCTXQM +j46yp4IfPQEBwO8IAIN0J09AXBf86dFUTFGcAMrEQqOF5IL+KGorAjzuYxERhKfD +ZV7jA+sCQqxkWfcVcE20kVyVYqzZIkio9a5zXP6TwA247JkPt54S1PmMDYHNlRIY +laXlNoji+4q3HP2DfHqXRT2859rYpm/fG/v6pWkos5voPKcZ2OFEp9W+Ap88oqw+ +5rx4VetZNJq1Epmis4INj6XqNqj85+MOOIYE+f445ohDM6B/Mxazd6cHFGGIR+az +VjZ6lCDMLjzhB5+FqfrDLYuMjqkMTR5z9DL+psUvPlCkYbQ11NEWtEmiIWjUcNJN +GCxGzv5bXk0XPu3ADwbPkFE2usW1cSM7AQFiwuyJAJUDBRAxe+Q9a1pnjYGyp3kB +AV7XA/oCSL/Cc2USpQ2ckwkGpyvIkYBPszIcabSNJAzm2hsU9Qa6WOPxD8olDddB +uJNiW/gznPC4NsQ0N8Zr4IqRX/TTDVf04WhLmd8AN9SOrVv2q0BKgU6fLuk979tJ +utrewH6PR2qBOjAaR0FJNk4pcYAHeT+e7KaKy96YFvWKIyDvc4kAlQMFEDF8ldof +f6kIA1j8vQEBDH4D/0Zm0oNlpXrAE1EOFrmp43HURHbij8n0Gra1w9sbfo4PV+/H +U8ojTdWLy6r0+prH7NODCkgtIQNpqLuqM8PF2pPtUJj9HwTmSqfaT/LMztfPA6PQ +csyT7xxdXl0+4xTDl1avGSJfYsI8XCAy85cTs+PQwuyzugE/iykJO1Bnj/paiQCV +AwUQMXvlBvUVW/uOVC1dAQF2fQP/RfYC6RrpFTZHjo2qsUHSRk0vmsYfwG5NHP5y +oQBMsaQJeSckN4n2JOgR4T75U4vS62aFxgPLJP3lOHkU2Vc7xhAuBvsbGr5RP8c5 +LvPOeUEyz6ZArp1KUHrtcM2iK1FBOmY4dOYphWyWMkDgYExabqlrAq7FKZftpq/C +BiMRuaw= +=C/Jw +-----END PGP PUBLIC KEY BLOCK-----</programlisting> + </sect2> + + <sect2> + <title>&a.phk;</title> + + <programlisting> +Poul-Henning Kamp <phk@FreeBSD.org> +Fingerprint = A3 F3 88 28 2F 9B 99 A2 49 F4 E2 FA 5A 78 8B 3E + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.3ia + +mQCNAzAdpMIAAAEEALHDgrFUwhZtb7PbXg3upELoDVEUPFRwnmpJH1rRqyROUGcI +ooVe7u+FQlIs5OsXK8ECs/5Wpe2UrZSzHvjwBYOND5H42YtI5UULZLRCo5bFfTVA +K9Rpo5icfTsYihrzU2nmnycwFMk+jYXyT/ZDYWDP/BM9iLjj0x9/qQgDWPy9AAUR +tCNQb3VsLUhlbm5pbmcgS2FtcCA8cGhrQEZyZWVCU0Qub3JnPokAlQMFEDQQ0aZ1 +u244dqP3sQEBu4ID/jXFFeJgs2MdTDNOZM/FbfDhI4qxAbYUsqS3+Ra16yd8Wd/A +jV+IHJE2NomFWl8UrUjCGinXiwzPgK1OfFJrS9Og1wQLvAl0X84BA8MTP9BQr4w7 +6I/RbksgUSrVCIO8MJwlydjSPocWGBeXlVjbZxXzyuJk7H+TG+zuI5BuBcNIiQCV +AwUQMwYr2rNaYutZnzI9AQHiIQP/XxtBWFXaBRgVLEhRNpS07YdU+LsZGlLOZehN +9L4UnJFHQQPNOpMey2gF7Y95aBOw5/1xS5vlQpwmRFCntWsm/gqdzK6rulfr1r5A +y94LO5TAC6ucNu396Y4vo1TyD1STnRC466KlvmtQtAtFGgXlORWLL9URLzcRFd1h +D0yXd9aJAJUDBRAxfo19a1pnjYGyp3kBAQqyA/4v64vP3l1F0Sadn6ias761hkz/ +SMdTuLzILmofSCC4o4KWMjiWJHs2Soo41QlZi1+xMHzV32JKiwFlGtPHqL+EHyXy +Q4H3vmf9/1KF+0XCaMtgI0wWUMziPSTJK8xXbRRmMDK/0F4TnVVaUhnmf+h5K7O6 +XdmejDTa0X/NWcicmIkAlQMFEDF8lef1FVv7jlQtXQEBcnwD/0ro1PpUtlkLmreD +tsGTkNa7MFLegrYRvDDrHOwPZH152W2jPUncY+eArQJakeHiTDmJNpFagLZglhE0 +bqJyca+UwCXX+6upAclWHEBMg2byiWMMqyPVEEnpUoHM1sIkgdNWlfQAmipRBfYh +2LyCgWvR8CbtwPYIFvUmGgB3MR87iQCVAwUQMUseXB9/qQgDWPy9AQGPkwP/WEDy +El2Gkvua9COtMAifot2vTwuvWWpNopIEx0Ivey4aVbRLD90gGCJw8OGDEtqFPcNV +8aIiy3fYVKXGZZjvCKd7zRfhNmQn0eLDcymq2OX3aPrMc2rRlkT4Jx425ukR1gsO +qiQAgw91aWhY8dlw/EKzk8ojm52x4VgXaBACMjaJAJUDBRAxOUOg72G56RHVjtUB +AbL4A/9HOn5Qa0lq9tKI/HkSdc5fGQD/66VdCBAb292RbB7CS/EM07MdbcqRRYIa +0+0gwQ3OdsWPdCVgH5RIhp/WiC+UPkR1cY8N9Mg2kTwJfZZfNqN+BgWlgRMPN27C +OhYNl8Q33Nl9CpBLrZWABF44jPeT0EvvTzP/5ZQ7T75EsYKYiYkAlQMFEDDmryQA +8tkJ67sbQQEBPdsEALCj6v1OBuJLLJTlxmmrkqAZPVzt5QdeO3Eqa2tcPWcU0nqP +vHYMzZcZ7oFg58NZsWrhSQQDIB5e+K65Q/h6dC7W/aDskZd64jxtEznX2kt0/MOr +8OdsDis1K2f9KQftrAx81KmVwW4Tqtzl7NWTDXt44fMOtibCwVq8v2DFkTJy +=JKbP +-----END PGP PUBLIC KEY BLOCK-----</programlisting> + </sect2> + + <sect2> + <title>&a.rich;</title> + + <programlisting> +Rich Murphey <rich@FreeBSD.org> +fingerprint = AF A0 60 C4 84 D6 0C 73 D1 EF C0 E9 9D 21 DB E4 + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.2 + +mQCNAy97V+MAAAEEALiNM3FCwm3qrCe81E20UOSlNclOWfZHNAyOyj1ahHeINvo1 +FBF2Gd5Lbj0y8SLMno5yJ6P4F4r+x3jwHZrzAIwMs/lxDXRtB0VeVWnlj6a3Rezs +wbfaTeSVyh5JohEcKdoYiMG5wjATOwK/NAwIPthB1RzRjnEeer3HI3ZYNEOpAAUR +tCRSaWNoIE11cnBoZXkgPHJpY2hAbGFtcHJleS51dG1iLmVkdT6JAJUDBRAve15W +vccjdlg0Q6kBAZTZBACcNd/LiVnMFURPrO4pVRn1sVQeokVX7izeWQ7siE31Iy7g +Sb97WRLEYDi686osaGfsuKNA87Rm+q5F+jxeUV4w4szoqp60gGvCbD0KCB2hWraP +/2s2qdVAxhfcoTin/Qp1ZWvXxFF7imGA/IjYIfB42VkaRYu6BwLEm3YAGfGcSw== +=QoiM +-----END PGP PUBLIC KEY BLOCK-----</programlisting> + </sect2> + + <sect2> + <title>&a.jdp;</title> + + <programlisting> +John D. Polstra <jdp@polstra.com> +Fingerprint = 54 3A 90 59 6B A4 9D 61 BF 1D 03 09 35 8D F6 0D + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.2 + +mQCNAzMElMEAAAEEALizp6ZW9QifQgWoFmG3cXhzQ1+Gt+a4S1adC/TdHdBvw1M/ +I6Ok7TC0dKF8blW3VRgeHo4F3XhGn+n9MqIdboh4HJC5Iiy63m98sVLJSwyGO4oM +dkEGyyCLxqP6h/DU/tzNBdqFzetGtYvU4ftt3RO0a506cr2CHcdm8Q+/vPRJAAUR +tCFKb2huIEQuIFBvbHN0cmEgPGpkcEBwb2xzdHJhLmNvbT6JAJUDBRAzBNBE9RVb ++45ULV0BAWgiA/0WWO3+c3qlptPCHJ3DFm6gG/qNKsY94agL/mHOr0fxMP5l2qKX +O6a1bWkvGoYq0EwoKGFfn0QeHiCl6jVi3CdBX+W7bObMcoi+foqZ6zluOWBC1Jdk +WQ5/DeqQGYXqbYjqO8voCScTAPge3XlMwVpMZTv24u+nYxtLkE0ZcwtY9IkAlQMF +EDMEt/DHZvEPv7z0SQEBXh8D/2egM5ckIRpGz9kcFTDClgdWWtlgwC1iI2p9gEhq +aufy+FUJlZS4GSQLWB0BlrTmDC9HuyQ+KZqKFRbVZLyzkH7WFs4zDmwQryLV5wkN +C4BRRBXZfWy8s4+zT2WQD1aPO+ZsgRauYLkJgTvXTPU2JCN62Nsd8R7bJS5tuHEm +7HGmiQCVAwUQMwSvHB9/qQgDWPy9AQFAhAQAgJ1AlbKITrEoJ0+pLIsov3eQ348m +SVHEBGIkU3Xznjr8NzT9aYtq4TIzt8jplqP3QoV1ka1yYpZf0NjvfZ+ffYp/sIaU +wPbEpgtmHnVWJAebMbNs/Ad1w8GDvxEt9IaCbMJGZnHmfnEqOBIxF7VBDPHHoJxM +V31K/PIoYsHAy5w= +=cHFa +-----END PGP PUBLIC KEY BLOCK-----</programlisting> + </sect2> + + <sect2> + <title>&a.guido;</title> + + <programlisting> +Guido van Rooij <guido@gvr.win.tue.nl> +Fingerprint = 16 79 09 F3 C0 E4 28 A7 32 62 FA F6 60 31 C0 ED + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.2 + +mQCNAzGeO84AAAEEAKKAY91Na//DXwlUusr9GVESSlVwVP6DyH1wcZXhfN1fyZHq +SwhMCEdHYoojQds+VqD1iiZQvv1RLByBgj622PDAPN4+Z49HjGs7YbZsUNuQqPPU +wRPpP6ty69x1hPKq1sQIB5MS4radpCM+4wbZbhxv7l4rP3RWUbNaYutZnzI9AAUR +tCZHdWlkbyB2YW4gUm9vaWogPGd1aWRvQGd2ci53aW4udHVlLm5sPokAlQMFEDMG +Hcgff6kIA1j8vQEBbYgD/jm9xHuUuY+iXDkOzpCXBYACYEZDV913MjtyBAmaVqYo +Rh5HFimkGXe+rCo78Aau0hc57fFMTsJqnuWEqVt3GRq28hSK1FOZ7ni9/XibHcmN +rt2yugl3hYpClijo4nrDL1NxibbamkGW/vFGcljS0jqXz6NDVbGx5Oo7HBByxByz +iQCVAwUQMhmtVjt/x7zOdmsfAQFuVQQApsVUTigT5YWjQA9Nd5Z0+a/oVtZpyw5Z +OljLJP3vqJdMa6TidhfcatjHbFTve5x1dmjFgMX/MQTd8zf/+Xccy/PX4+lnKNpP +eSf1Y4aK+E8KHmBGd6GzX6CIboyGYLS9e3kGnN06F2AQtaLyJFgQ71wRaGuyKmQG +FwTn7jiKb1aJAJUDBRAyEOLXPt3iN6QQUSEBATwQA/9jqu0Nbk154+Pn+9mJX/YT +fYR2UqK/5FKCqgL5Nt/Deg2re0zMD1f8F9Dj6vuAAxq8hnOkIHKlWolMjkRKkzJi +mSPEWl3AuHJ31k948J8it4f8kq/o44usIA2KKVMlI63Q/rmNdfWCyiYQEVGcRbTm +GTdZIHYCOgV5dOo4ebFqgYkAlQMFEDIE1nMEJn15jgpJ0QEBW6kEAKqN8XSgzTqf +CrxFXT07MlHhfdbKUTNUoboxCGCLNW05vf1A8F5fdE5i14LiwkldWIzPxWD+Sa3L +fNPCfCZTaCiyGcLyTzVfBHA18MBAOOX6JiTpdcm22jLGUWBf/aJK3yz/nfbWntd/ +LRHysIdVp29lP5BF+J9/Lzbb/9LxP1taiQCVAwUQMgRXZ44CzbsJWQz9AQFf7gP/ +Qa2FS5S6RYKG3rYanWADVe/ikFV2lxuM1azlWbsmljXvKVWGe6cV693nS5lGGAjx +lbd2ADwXjlkNhv45HLWFm9PEveO9Jjr6tMuXVt8N2pxiX+1PLUN9CtphTIU7Yfjn +s6ryZZfwGHSfIxNGi5ua2SoXhg0svaYnxHxXmOtH24iJAJUDBRAyAkpV8qaAEa3W +TBkBARfQBAC+S3kbulEAN3SI7/A+A/dtl9DfZezT9C4SRBGsl2clQFMGIXmMQ/7v +7lLXrKQ7U2zVbgNfU8smw5h2vBIL6f1PyexSmc3mz9JY4er8KeZpcf6H0rSkHl+i +d7TF0GvuTdNPFO8hc9En+GG6QHOqbkB4NRZ6cwtfwUMhk2FHXBnjF4kAlQMFEDH5 +FFukUJAsCdPmTQEBe74EAMBsxDnbD9cuI5MfF/QeTNEG4BIVUZtAkDme4Eg7zvsP +d3DeJKCGeNjiCWYrRTCGwaCWzMQk+/+MOmdkI6Oml+AIurJLoHceHS9jP1izdP7f +N2jkdeJSBsixunbQWtUElSgOQQ4iF5kqwBhxtOfEP/L9QsoydRMR1yB6WPD75H7V +iQCVAwUQMZ9YNGtaZ42Bsqd5AQH0PAQAhpVlAc3ZM/KOTywBSh8zWKVlSk3q/zGn +k7hJmFThnlhH1723+WmXE8aAPJi+VXOWJUFQgwELJ6R8jSU2qvk2m1VWyYSqRKvc +VRQMqT2wjss0GE1Ngg7tMrkRHT0il7E2xxIb8vMrIwmdkbTfYqBUhhGnsWPHZHq7 +MoA1/b+rK7CJAJUDBRAxnvXh3IDyptUyfLkBAYTDA/4mEKlIP/EUX2Zmxgrd/JQB +hqcQlkTrBAaDOnOqe/4oewMKR7yaMpztYhJs97i03Vu3fgoLhDspE55ooEeHj0r4 +cOdiWfYDsjSFUYSPNVhW4OSruMA3c29ynMqNHD7hpr3rcCPUi7J2RncocOcCjjK2 +BQb/9IAUNeK4C9gPxMEZLokAlQMFEDGeO86zWmLrWZ8yPQEBEEID/2fPEUrSX3Yk +j5TJPFZ9MNX0lEo7AHYjnJgEbNI4pYm6C3PnMlsYfCSQDHuXmRQHAOWSdwOLvCkN +F8eDaF3M6u0urgeVJ+KVUnTz2+LZoZs12XSZKCte0HxjbvPpWMTTrYyimGezH79C +mgDVjsHaYOx3EXF0nnDmtXurGioEmW1J +=mSvM +-----END PGP PUBLIC KEY BLOCK-----</programlisting> + </sect2> + + <sect2> + <title>&a.peter;</title> + + <programlisting> +Peter Wemm <peter@FreeBSD.org> + aka <peter@spinner.dialix.com> + aka <peter@haywire.dialix.com> + aka <peter@perth.dialix.oz.au> +Key fingerprint = 47 05 04 CA 4C EE F8 93 F6 DB 02 92 6D F5 58 8A + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.3ia + +mQCNAy9/FJwAAAEEALxs9dE9tFd0Ru1TXdq301KfEoe5uYKKuldHRBOacG2Wny6/ +W3Ill57hOi2+xmq5X/mHkapywxvy4cyLdt31i4GEKDvxpDvEzAYcy2n9dIup/eg2 +kEhRBX9G5k/LKM4NQsRIieaIEGGgCZRm0lINqw495aZYrPpO4EqGN2HYnOMZAAUT +tCVQZXRlciBXZW1tIDxwZXRlckBoYXl3aXJlLmRpYWxpeC5jb20+iQCVAwUQMwWT +cXW7bjh2o/exAQEFkQP+LIx5zKlYp1uR24xGApMFNrNtjh+iDIWnxxb2M2Kb6x4G +9z6OmbUCoDTGrX9SSL2Usm2RD0BZfyv9D9QRWC2TSOPkPRqQgIycc11vgbLolJJN +eixqsxlFeKLGEx9eRQCCbo3dQIUjc2yaOe484QamhsK1nL5xpoNWI1P9zIOpDiGJ +AJUDBRAxsRPqSoY3Ydic4xkBAbWLA/9q1Fdnnk4unpGQsG31Qbtr4AzaQD5m/JHI +4gRmSmbj6luJMgNG3fpO06Gd/Z7uxyCJB8pTst2a8C/ljOYZxWT+5uSzkQXeMi5c +YcI1sZbUpkHtmqPW623hr1PB3ZLA1TIcTbQW+NzJsxQ1Pc6XG9fGkT9WXQW3Xhet +AP+juVTAhLQlUGV0ZXIgV2VtbSA8cGV0ZXJAcGVydGguZGlhbGl4Lm96LmF1PokA +lQMFEDGxFCFKhjdh2JzjGQEB6XkD/2HOwfuFrnQUtdwFPUkgtEqNeSr64jQ3Maz8 +xgEtbaw/ym1PbhbCk311UWQq4+izZE2xktHTFClJfaMnxVIfboPyuiSF99KHiWnf +/Gspet0S7m/+RXIwZi1qSqvAanxMiA7kKgFSCmchzas8TQcyyXHtn/gl9v0khJkb +/fv3R20btB5QZXRlciBXZW1tIDxwZXRlckBGcmVlQlNELm9yZz6JAJUDBRAxsRJd +SoY3Ydic4xkBAZJUA/4i/NWHz5LIH/R4IF/3V3LleFyMFr5EPFY0/4mcv2v+ju9g +brOEM/xd4LlPrx1XqPeZ74JQ6K9mHR64RhKR7ZJJ9A+12yr5dVqihe911KyLKab9 +4qZUHYi36WQu2VtLGnw/t8Jg44fQSzbBF5q9iTzcfNOYhRkSD3BdDrC3llywO7Ql +UGV0ZXIgV2VtbSA8cGV0ZXJAc3Bpbm5lci5kaWFsaXguY29tPokAlQMFEDGxEi1K +hjdh2JzjGQEBdA4EAKmNFlj8RF9HQsoI3UabnvYqAWN5wCwEB4u+Zf8zq6OHic23 +TzoK1SPlmSdBE1dXXQGS6aiDkLT+xOdeewNs7nfUIcH/DBjSuklAOJzKliXPQW7E +kuKNwy4eq5bl+j3HB27i+WBXhn6OaNNQY674LGaR41EGq44Wo5ATcIicig/z +=gv+h +-----END PGP PUBLIC KEY BLOCK-----</programlisting> + </sect2> + + <sect2> + <title>&a.joerg;</title> + + <programlisting> +Type Bits/KeyID Date User ID +pub 1024/76A3F7B1 1996/04/27 Joerg Wunsch <joerg_wunsch@uriah.heep.sax.de> + Key fingerprint = DC 47 E6 E4 FF A6 E9 8F 93 21 E0 7D F9 12 D6 4E + Joerg Wunsch <joerg_wunsch@interface-business.de> + Joerg Wunsch <j@uriah.heep.sax.de> + Joerg Wunsch <j@interface-business.de> + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.3ia + +mQCNAzGCFeAAAAEEAKmRBU2Nvc7nZy1Ouid61HunA/5hF4O91cXm71/KPaT7dskz +q5sFXvPJPpawwvqHPHfEbAK42ZaywyFp59L1GaYj87Pda+PlAYRJyY2DJl5/7JPe +ziq+7B8MdvbX6D526sdmcR+jPXPbHznASjkx9DPmK+7TgFujyXW7bjh2o/exAAUR +tC1Kb2VyZyBXdW5zY2ggPGpvZXJnX3d1bnNjaEB1cmlhaC5oZWVwLnNheC5kZT6J +AJUDBRA0FFkBs1pi61mfMj0BAfDCA/oCfkjrhvRwRCpSL8klJ1YDoUJdmw+v4nJc +pw3OpYXbwKOPLClsE7K3KCQscHel7auf91nrekAwbrXv9Clp0TegYeAQNjw5vZ9f +L6UZ5l3fH8E2GGA7+kqgNWs1KxAnG5GdUvJ9viyrWm8dqWRGo+loDWlZ12L2OgAD +fp7jVZTI1okAlQMFEDQPrLoff6kIA1j8vQEB2XQEAK/+SsQPCT/X4RB/PBbxUr28 +GpGJMn3AafAaA3plYw3nb4ONbqEw9tJtofAn4UeGraiWw8nHYR2DAzoAjR6OzuX3 +TtUV+57BIzrTPHcNkb6h8fPuHU+dFzR+LNoPaGJsFeov6w+Ug6qS9wa5FGDAgaRo +LHSyBxcRVoCbOEaS5S5EiQCVAwUQM5BktWVgqaw0+fnVAQGKPwP+OiWho3Zm2GKp +lEjiZ5zx3y8upzb+r1Qutb08jr2Ewja04hLg0fCrt6Ad3DoVqxe4POghIpmHM4O4 +tcW92THQil70CLzfCxtfUc6eDzoP3krD1/Gwpm2hGrmYA9b/ez9+r2vKBbnUhPmC +glx5pf1IzHU9R2XyQz9Xu7FI2baOSZqJAJUDBRAyCIWZdbtuOHaj97EBAVMzA/41 +VIph36l+yO9WGKkEB+NYbYOz2W/kyi74kXLvLdTXcRYFaCSZORSsQKPGNMrPZUoL +oAKxE25AoCgl5towqr/sCcu0A0MMvJddUvlQ2T+ylSpGmWchqoXCN7FdGyxrZ5zz +xzLIvtcio6kaHd76XxyJpltCASupdD53nEtxnu8sRrQxSm9lcmcgV3Vuc2NoIDxq +b2VyZ193dW5zY2hAaW50ZXJmYWNlLWJ1c2luZXNzLmRlPokAlQMFEDIIhfR1u244 +dqP3sQEBWoID/RhBm+qtW+hu2fqAj9d8CVgEKJugrxZIpXuCKFvO+bCgQtogt9EX ++TJh4s8UUdcFkyEIu8CT2C3Rrr1grvckfxvrTgzSzvtYyv1072X3GkVY+SlUMBMA +rdl1qNW23oT7Q558ajnsaL065XJ5m7HacgTTikiofYG8i1s7TrsEeq6PtCJKb2Vy +ZyBXdW5zY2ggPGpAdXJpYWguaGVlcC5zYXguZGU+iQCVAwUQMaS91D4gHQUlG9CZ +AQGYOwQAhPpiobK3d/fz+jWrbQgjkoO+j39glYGXb22+6iuEprFRs/ufKYtjljNT +NK3B4DWSkyIPawcuO4Lotijp6jke2bsjFSSashGWcsJlpnwsv7EeFItT3oWTTTQQ +ItPbtNyLW6M6xB+jLGtaAvJqfOlzgO9BLfHuA2LY+WvbVW447SWJAJUDBRAxqWRs +dbtuOHaj97EBAXDBA/49rzZB5akkTSbt/gNd38OJgC+H8N5da25vV9dD3KoAvXfW +fw7OxIsxvQ/Ab+rJmukrrWxPdsC+1WU1+1rGa4PvJp/VJRDes2awGrn+iO7/cQoS +IVziC27JpcbvjLvLVcBIiy1yT/RvJ+87a3jPRHt3VFGcpFh4KykxxSNiyGygl4kA +lQMFEDGCUB31FVv7jlQtXQEB5KgD/iIJZe5lFkPr2B/Cr7BKMVBot1/JSu05NsHg +JZ3uK15w4mVtNPZcFi/dKbn+qRM6LKDFe/GF0HZD/ZD1FJt8yQjzF2w340B+F2GG +EOwnClqZDtEAqnIBzM/ECQQqH+6Bi8gpkFZrFgg5eON7ikqmusDnOlYStM/CBfgp +SbR8kDmFtCZKb2VyZyBXdW5zY2ggPGpAaW50ZXJmYWNlLWJ1c2luZXNzLmRlPokA +lQMFEDHioSdlYKmsNPn51QEByz8D/10uMrwP7MdaXnptd1XNFhpaAPYTVAOcaKlY +OGI/LLR9PiU3FbqXO+7INhaxFjBxa0Tw/p4au5Lq1+Mx81edHniJZNS8tz3I3goi +jIC3+jn2gnVAWnK5UZUTUVUn/JLVk/oSaIJNIMMDaw4J9xPVVkb+Fh1A+XqtPsVa +YESrNp0+iQCVAwUQMwXkzcdm8Q+/vPRJAQEA4QQAgNNX1HFgXrMetDb+w6yEGQDk +JCDAY9b6mA2HNeKLQAhsoZl4HwA1+iuQaCgo3lyFC+1Sf097OUTs74z5X1vCedqV +oFw9CxI3xuctt3pJCbbN68flOlnq0WdYouWWGlFwLlh5PEy//VtwX9lqgsizlhzi +t+fX6BT4BgKi5baDhrWJAJUDBRAyCKveD9eCJxX4hUkBAebMA/9mRPy6K6i7TX2R +jUKSl2p5oYrXPk12Zsw4ijuktslxzQhOCyMSCGK2UEC4UM9MXp1H1JZQxN/DcfnM +7VaUt+Ve0wZ6DC9gBSHJ1hKVxHe5XTj26mIr4rcXNy2XEDMK9QsnBxIAZnBVTjSO +LdhqqSMp3ULLOpBlRL2RYrqi27IXr4kAlQMFEDGpbnd1u244dqP3sQEBJnQD/RVS +Azgf4uorv3fpbosI0LE3LUufAYGBSJNJnskeKyudZkNkI5zGGDwVneH/cSkKT4OR +ooeqcTBxKeMaMuXPVl30QahgNwWjfuTvl5OZ8orsQGGWIn5FhqYXsKkjEGxIOBOf +vvlVQ0UbcR0N2+5F6Mb5GqrXZpIesn7jFJpkQKPU +=97h7 +-----END PGP PUBLIC KEY BLOCK-----</programlisting> + </sect2> + </sect1> + + <sect1> + <title>開発者</title> + + <sect2> + <title>&a.wosch;</title> + + <programlisting> +Type Bits/KeyID Date User ID +pub 1024/2B7181AD 1997/08/09 Wolfram Schneider <wosch@FreeBSD.org> +Fingerprint = CA 16 91 D9 75 33 F1 07 1B F0 B4 9F 3E 95 B6 09 + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.3ia + +mQCNAzPs+aEAAAEEAJqqMm2I9CxWMuHDvuVO/uh0QT0az5ByOktwYLxGXQmqPG1G +Q3hVuHWYs5Vfm/ARU9CRcVHFyqGQ3LepoRhDHk+JcASHan7ptdFsz7xk1iNNEoe0 +vE2rns38HIbiyQ/2OZd4XsyhFOFtExNoBuyDyNoe3HbHVBQT7TmN/mkrcYGtAAUR +tCVXb2xmcmFtIFNjaG5laWRlciA8d29zY2hARnJlZUJTRC5vcmc+iQCVAwUQNmrS +AzmN/mkrcYGtAQFQjAP8CthNueur8XDAZqC5q6NQcDs0PqqQ+raTUfQTv6Km6ykf +UzdpDlBoRC+CCyHfBfC5zo9N6mB7iV7qS1PljrdIh6VAwHxJN9iopB/x6+nsBvmy +0YSNt7eyfFrIVegCJvd4ALz5JBV8ZstznOwo8RAhDD0gX58F8nDhgWjy62JekGK0 +IldvbGZyYW0gU2NobmVpZGVyIDx3b3NjaEBhcGZlbC5kZT6JARUDBRA2Z9ZcCMks +sk6wLt0BAQBICACcTiDZ/AyYWRDLXsBOK+WMRoNk3+bQZ1cdy11nwJo+taT/389M +0r5TrEJ7CogpXC2rFUExTVWldSFZd8A1YIHtrTsP7YauUH0nA7k0wUnqDRYj8YJR +eMLFvc1OQ2y+mkvxF2BzzBzh/bcYbgJdWCB1MPahSNQfkGXtp+A5PjEs8Cp4+FLu +EUFScyxsD3g5/E+0d7mirJpe3pxcf9KCmFGHM89mrTKODQR/7N8dVqa9npeXZotm +ZK8Jz+tvRKFgNiLf2XL048+IE8ZtJXDYaDzTirHdcAqJMWQuxthCdG3ta4I+w5WM +WR8JtBLfVNpyU7LN6dl0IB7O5sYhyskApmMwiQCVAwUQM+z5oTmN/mkrcYGtAQGU +gAP/cJGro/SbV+L19s/Gem26KmegUH+bfIXoh2EzyRJ7heVdybu1LrSDFApmAE7d +sMDlAA1wd2XjVWD3nIEBl6k+J7qJB4ACjKVGs414jLpdKGPHdLRYqYDj4LyQFMv6 +/BpSoX1gnWp6xlC2xeWRan9ns3XZGS55UBVDvBE/B+fPoTe0JFdvbGZyYW0gU2No +bmVpZGVyIDxzY2huZWlkZXJAemliLmRlPokAlQMFEDZq0dI5jf5pK3GBrQEB38QD +/3NYyRPIejtXXq/okdDRyhWmA8cv0KG6gEupKCQKa7ep/OZTw/KxrN3ZOS8zlPod +tEn8mol+4SvY5AgSMdjQ0jTd1JdFcMKFnbJJrJ3b9IpwCqbkXy25rTUcQn9ICP47 +rFKC4qR/Ucrg5YVVhQ3pVJX6XuO2XvuG7euHAQNXV3e2 +=EpJQ +-----END PGP PUBLIC KEY BLOCK-----</programlisting> + </sect2> + + <sect2> + <title>&a.brian;</title> + + <programlisting> +Type Bits/KeyID Date User ID +pub 1024/666A7421 1997/04/30 Brian Somers <brian@Awfulhak.org> + Key fingerprint = 2D 91 BD C2 94 2C 46 8F 8F 09 C4 FC AD 12 3B 21 + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.3ia + +mQCNAzNmogUAAAEEALdsjVsV2dzO8UU4EEo7z3nYuvB2Q6YJ8sBUYjB8/vfR5oZ9 +7aEQjgY5//pXvS30rHUB9ghk4kIFSljzeMudE0K2zH5n2sxpLbBKWZRDLS7xnrDC +I3j9CNKwQBzMPs0fUT46gp96nf1X8wPiJXkDUEia/c0bRbXlLw7tvOdmanQhAAUR +tCFCcmlhbiBTb21lcnMgPGJyaWFuQGF3ZnVsaGFrLm9yZz6JAJUDBRAzbedc77Ox +BWZTbW0BAVtFA/42QelA3RBXYUtIcYGob+QsWkA1kGyBKQGPSS9coHdUVjClBRl3 +UZFmZhxAODb7cBRXmpvx2ZuMrhn/MpXTMqPOJaE3FYm+5SoeArphsRU+T8XofxfL +vRHkM3JURUjIVZdAQNvxxBso8NJG5KayP0Q96Vw+3sEwFK49jt14RCJy4IkAlQMF +EDNzvb1sq+iWcxFJBQEBfZwD/R3KNFf9ype9Dea8j1YIeNZ1E3e03en1I8fMj6Em +S1/L1WfFzMnfFCxZs7JgPtkBuB3CqP8f+LOdDt6PHPqNakmI9E6fiuGfJZ3jFZYA +TXa0XKuIoxIJNKhqkpbF8ixJZFTxFwAAwVYM3+sqr4qQ8FzVc5entxjyxPFNkwJw +RWV+iQCVAwUQM2aiBQ7tvOdmanQhAQE7LgQAiN6Hz+zd8bh0nO6VizbJxWFRHPbr +QWnJXGoMYyy88DyszAXC4zRshlyGUDQdHeP/1DFCXDEu78GfDCLaJ1bm25yVR7kL +xDZaEUQEbWqxfiwuzizAjkaxrW7dBbWILwWqrYF5TXClw+oUU/oIUW4t6t+GpAO1 +8PLYhSMXVYErrAA= +=EdyZ +-----END PGP PUBLIC KEY BLOCK-----</programlisting> + </sect2> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/policies/chapter.sgml b/ja_JP.eucJP/books/handbook/policies/chapter.sgml new file mode 100644 index 0000000000..dfc9a09cb4 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/policies/chapter.sgml @@ -0,0 +1,368 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.7 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:58 kuriyama Exp $ +--> + +<chapter id="policies"> + <title>ソースツリーのガイドラインおよび方針</title> + + <para><emphasis>原作: &a.phk;</emphasis><!-- <br> -->.</para> + + <para><emphasis>訳者: &a.jp.mihoko;<!-- <br> --> + 6 September 1996 </emphasis>.</para> + + <para>本章は, FreeBSD + のソースツリーについてのさまざまなガイドラインや + ポリシーについて書かれています.</para> + + <sect1 id="policies-maintainer"> + <title>Makefile 中の <makevar>MAINTAINER</makevar></title> + + <para>1996年6月.</para> + + <para>FreeBSD 配布物の特定の部分が, 一人の人やグループによって保守 + されている場合は, ソースツリーの当該 + <filename>Makefile</filename> に + + <programlisting> +MAINTAINER= email-addresses</programlisting> + + が付け加えられています. これを記述することによって, + この部分が誰 + に保守管理されているかを世界中のユーザに + 伝えることができます.</para> + + <para>この意味は次のとおりです:</para> + + <para>保守担当者がそのコードを所有し, そのコードに対する責任を持っ + ています. すなわち, + その人がそのコードに関するバグの修正やトラブル報告 + に対する回答をします. また, + そのコードが寄贈ソフトウェアの場合には, そのソフトウェアの + 新しいバージョンに適切に追従させる作業をその人が行い + ます.</para> + + <para>保守担当者が決められているディレクトリに対して + 変更をおこなう場合は, 変更をおこなう前に, + その変更内容を保守担当者に送って, + 保守担当者にレビューをしてもらってください. 保守担当者が, + 電子メールに一定期間応答しない場合にのみ, + 保守担当者がレビューすることなしに, + 変更をおこなうことが認められます. しかしながら, + そのような場合でも可能な限り, 変更点を第三者にレビュー + してもらうようにしてください.</para> + + <para>もちろん, この義務を引き受けることができない人やグループを + 保守管理者として追加することはできません. また, + 保守管理者がソースツリー管理者 ("committer") である必要は + ありません.</para> + </sect1> + + <sect1> + <title>寄贈ソフトウェア</title> + + <para><emphasis>原作: &a.phk; and &a.obrien;.</emphasis></para> + <para><emphasis>訳者: &a.jp.mihoko;</emphasis></para> + + <para>1996年6月.</para> + + <para>FreeBSD 配布物のうちのいくつかのソフトウェアは FreeBSD + プロジェクト 以外のところで保守されています. 歴史的な経緯から, + 私たちはこれを <emphasis> 寄贈 </emphasis> ソフトウェアと + 呼んでいます. perl や gcc, patch などがその例です.</para> + + <para>ここ数年来, この種のソフトウェアの取り扱いには, + さまざまな方法が 取られてきましたが, + どの方法にもいくつかの利点と欠点があります. + これまで欠点のない明確な方法はありませんでした.</para> + + <para>議論した結果, これらの方法のうちの一つが + “公式な”方法として選択され ました. その方法が, 今後, + この種のソフトウェアを取り込む場合に, 使用 されます. その上, + この方法では, だれもが(cvs + にアクセス権のない人でさえ)“公式” + バージョンのソースに対する差分を簡単に得ることができます. + これは古い方法にはなかった大きな利点です. ですから, + 既存の寄贈ソフトウェアも, + この方法に収束していくことを強く望んでいます. + この方法を使用することにより, 寄贈ソフトウェアの主な開発者に, + 変更 点を返すのがとても容易になります.</para> + + <para>しかしながら結局, 寄贈ソフトウェアの取扱は, + 実際に作業を行って いる人々に委ねられています. + もしこの方法を使用することが, その人が扱っているパッケージには + 極端に合わないような場合には, コアチームの承認さえあれば, + これらの ルールに反しても, + 他の開発者の一般的な合意は得られるでしょう. + 将来にわたってパッケージを保守できるということは, + 大変重要な事柄に なってきます.</para> + + <note> + <para>RCS のファイルフォーマットと CVS + のベンダブランチの使用には不幸な設計上の制限があります. + したがって, + ベンダブランチの内容をいまだに引きずっているファイルに + 対して小さな, 些細な変更, そして / あるいは + 膨大な変更を加えることには, + <emphasis>強い反対があります</emphasis>. + “誤字訂正”はもちろんこの中に入りますし, <!-- + kuriyama - cosmetic? --> + しかも“膨大な”の範疇に入るので, リビジョンが + 1.1.x.x + であるファイルに対する誤字訂正は避けられることになっています. + 一文字の変更したことによるリポジトリの肥大は, + 非常に劇的なものになり得るのです.</para> + </note> + + <para>プログラミング言語 <application>Tcl</application> は, + この方法が活用されているよい例になっています:</para> + + <para><filename>src/contrib/tcl</filename> には, + このパッケージの保守管理者が 配布したソースが含まれています. + この中からは FreeBSD に完全には適用 + できない部分が削除されています. Tcl の場合は, + <filename>mac</filename>, <filename>win</filename>, + <filename>compat</filename> というサブディレクトリは, FreeBSD + に取り込む前に削除されて いました.</para> + + <para><filename>src/lib/libtcl</filename> には, + ライブラリを生成したり, ドキュ + メントをインストールする際に使用される, 標準の + <filename>bsd.lib.mk</filename> の 規則を使用した「bmake + スタイル」の <filename>Makefile</filename> だけが + 含まれています.</para> + + <para><filename>src/usr.bin/tclsh</filename> には, + <filename>bsd.prog.mk</filename> 規則 を使用して, + <command>tclsh</command> + プログラムや関連するマニュアルページを生成 /インストール する + bmake スタイルの <filename>Makefile</filename> + だけが含まれています.</para> + + <para><filename>src/tools/tools/tcl_bmake</filename> には, tcl + ソフトウェアを更新する必要が生じたときの助けになる2つのシェルス + クリプトが含まれています. これらは, + ソフトウェアを構築するのに使用し たり, + インストール対象になるソフトウェアではありません.</para> + + <para>ここ重要なのは, <filename>src/contrib/tcl</filename> + ディレクトリが, 規則にしたがっ て作られているということです. + つまり, できるだけ FreeBSD に特化した + 変更をおこなわないようにしたソースを(RCS + のキーワードを拡張しないで, CVS のベンダブランチに)おくようにし + ています. <!-- kuriyama - easyimport --> freefall + 上の「簡易取り込み」ツールは, 寄贈ソフトウェアを取り込む + 手助けとなります. けれども, + このツールの実行方法に疑問が生じた場合は, まずはじめに質問して, + 失敗をしないようにしてください. そして, + その疑問を“解決して”からツールを使用してください. + CVS に寄贈ソフトウェアを取り込む際には, + 事故があってはいけません. + よくあるような間違いをおかさないように, + 十分注意してください.</para> + + <para>先ほど述べたように, 残念なことに CVS + にはベンダブランチという設計制限があります. このため, CVS + に寄贈ソフトウェアを取り込むには, オリジナル配布ソースに + 適用されるベンダからの“公式”パッチと, + ベンダブランチに逆輸入された 結果が必要です. + ベンダブランチの一貫性を破壊したり, 将来, + 新しいバージョンを取り込む + 時に衝突を起こしてしまったりというような + 困難な事態に陥らないように しなければなりません. そのために, + FreeBSD が管理しているバージョンに 対して, + 公式パッチを決して当ててはいけませんし, 公式パッチを "commit" + してはいけません.</para> + + <para>多くのパッケージが, 他のアーキテクチャや他の環境と FreeBSD + との互換性を保ためのファイルをいくつか含んでいます. そこで, + スペースを節約するために, FreeBSD + にとっては無意味な配布ツリー上の一 + 部を削除することが許されています. けれども, + 削除されずに残ったファイルに対する, 著作権の通知やリリース + ノートのような情報を含んだファイルは, 決して削除しては + <emphasis> いけませ ん </emphasis>.</para> + + <para><command>bmake</command> <filename>Makefile</filename> + が何らかのユーティリティによって, 配布ツリー + から自動的に生成できると, うまくいけば, 新しいバージョンへの + アップグレードをより簡単におこなうことができます. + もしこのようなユーティリティを作成できた場合には, 将来の管理者に + とって便利になるように, 移植の際に, + <filename>src/tools</filename> ディレクトリ上に, (必要に応じて) + そのユーティリティを必ずチェックインしてください.</para> + + <para><filename>src/contrib/tcl</filename> + レベルのディレクトリには, <filename>FREEBSD-upgrade</filename> + と 呼ばれるファイルが追加されており, そのファイルでは + 次のような内容が 記述されています.</para> + + <itemizedlist> + <listitem> + <para>ディレクトリ上に存在するファイル</para> + </listitem> + + <listitem> + <para>オリジナルの配布物をどこから入手すればよいか また, + 公式配布 サイトはどこか</para> + </listitem> + + <listitem> + <para>オリジナルの作者にパッチを送り返すためには, + どこに送ればよいか</para> + </listitem> + + <listitem> + <para>FreeBSD に特化した変更点の概要</para> + </listitem> + </itemizedlist> + + <para>しかしながら, 寄贈ソースと一緒に + <filename>FREEBSD-upgrade</filename> ファイルを + 取り込まないでください. それよりむしろ, + (訳注:このファイルを)初回に取り込んだ後は, コマンド <command>cvs + add FREEBSD-upgrade ; cvs ci</command> を実行してください. + <filename>src/contrib/cpio</filename> を例にすると, + 次のようになります:</para> + + <programlisting> +このディレクトリは「ベンダ」ブランチ上のオリジナル配布ファイル +の初期ソースが含まれています. いかなる事情があっても, +パッチや cvs コミットによってこのディレクトリ上のファイルを +アップグレードしてはいけません. +(訳注:ベンダから配布された)新しいバージョンや公式パッチだけが +(訳注:このディレクトリに)取り込まれなくてはいけません. +ベンダの RCS Id が CVS に入ってしまうのを避けるために, "-ko" オプ +ションをつけてインポートすることを忘れないで下さい. + +GNU cpio 2.4.2 を取り込むためには, 以下のファイルが削除されました: + + INSTALL cpio.info mkdir.c + Makefile.in cpio.texi mkinstalldirs + +cpio を新しいバージョンにアップデートするためには, 次の作業を +おこないます: + + 1. 空のディレクトリに新しいバージョンを取り出します. + [ファイルに「いかなる変更」も加えてはいけません] + + 2. 上記にリストされたファイルと, FreeBSD には無意味な + ファイルを削除します. + + 3. 次のコマンドを実行します: + cvs import -ko -m 'Virgin import of GNU cpio v<version>' \ + src/contrib/cpio GNU v<version> + + 例えば, バージョン 2.4.2 を取り込むためには, 次のように + タイプします: + cvs import -ko -m 'Virgin import of GNU v2.4.2' \ + src/contrib/cpio GNU v2.4.2 + + 4. FreeBSD に対するローカルな変更と, 新しいバージョンとの間での + 矛盾を解消するために, ステップ 3 で出力された命令を実行します. + +いかなる事情があっても, この手順から外れてはいけません. + +cpio にローカルな変更を加えたい場合には, メインブランチ(別名 HEAD)に対して +パッチを実行し, コミットしてください. +決して GNU のブランチにローカルな変更を加えないでください. + +ローカルにおこなわれたすべての変更を次のリリースに含めるために, +"cpio@gnu.ai.mit.edu" に提出してください. + +obrien@freebsd.org - 30 March 1997</programlisting> + </sect1> + + <sect1 id="policies-shlib"> + <title>共有ライブラリ</title> + + <para><emphasis>Contributed by &a.asami;, &a.peter;, and &a.obrien;. + <!-- <br> -->9 December 1996.</emphasis></para> + + <para>もしあなたが共有ライブラリをサポートする機能を port + に追加した り, + 共有ライブラリをサポートしていない他のソフトウェアに追加する + 場合には, 共有ライブラリのバージョン番号を次の規則にしたがって + つけてください. 一般的には, この規則は, + ソフトウェアのリリースバージョンとは 全く関係ありません.</para> + + <para>共有ライブラリを作成する三つの重要な規則は + 次の通りです:</para> + + <itemizedlist> + <listitem> + <para><literal>1.0</literal> から始める</para> + </listitem> + + <listitem> + <para>過去のバージョンに互換性のある変更の場合は, + マイナー番号を増やす</para> + </listitem> + + <listitem> + <para>互換性のない変更の場合は, メジャー番号を増やす</para> + </listitem> + </itemizedlist> + + <para>例えば, 機能追加とバグ吸収の場合は, + マイナー番号を増やします. 機能削除, + 関数呼び出しのシンタックスなどが変更された場合は, + 強制的にメジャー番号を変更します.</para> + + <para>メジャー.マイナーー + (<replaceable>x</replaceable>,<replaceable>y</replaceable>) + の形式のバージョン番号を使用します. FreeBSD + のダイナミックリンカは, <replaceable> + x</replaceable>.<replaceable>y</replaceable>.<replaceable>z + </replaceable> という形式のバージョン番号 は扱えません. + この場合, <replaceable>y</replaceable> の後のバージョン番号 + (つまり三つ目の数字)は, + どのライブラリがリンクされているかを決めるために, 共有ライブラ + リ番号を比較する際に, すべて無視されます. + “小さな”リビジョンだけが + 異なる二つの共有ライブラリが指定 されると, + <command>ld.so</command> は, + リビジョンの大きい方の共有ライブラリを リンクします. すなわち, + もしあなたが <filename>libfoo.so.3.3.3</filename> をリンク + していたとすると, リンカは頭の <literal>3.3</literal> + という部分だけを認識し, <replaceable>libfoo.so.3</replaceable> + ではじまり その後に <replaceable>3 + 以上の数字</replaceable>が続くもののうち, + <replaceable>最も大きい番号</replaceable> + の付いているライブラリをリンクします.</para> + + <note> + <para><command>ld.so</command> はいつも最も大きい + “マイナー” リビジョンのものを使うことに + 注意してください. 例えば, プログラムがはじめ + <filename>libc.so.2.0</filename> を リンクしていたとしても, + <filename>libc.so.2.0</filename> よりも + <filename>libc.so.2.2</filename> を優先 して使用します.</para> + </note> + + <para>移植されていないライブラリに対しては, + リリースごとに共有ライブラリの + バージョン番号を一度だけ変更するのが私たちのポリシーです. + あなたがシステムライブラリのバージョン番号を上げた場合は, + <filename>Makefile</filename> の commit ログを確認してください. + 結果としてそのリリースには, 共有ライブラリのバージョン番号が + アップデートされた <filename>Makefile</filename> + に入るので, 最初にその変更を 確かめるのがソースツリー管理者 + ("committer") の責務です. その後のどんな変更も, + そのリリースには入りません.</para> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/ports/chapter.sgml b/ja_JP.eucJP/books/handbook/ports/chapter.sgml new file mode 100644 index 0000000000..40d992c56d --- /dev/null +++ b/ja_JP.eucJP/books/handbook/ports/chapter.sgml @@ -0,0 +1,1139 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.9 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:59 kuriyama Exp $ +--> + +<chapter id="ports"> + <title>アプリケーションのインストール : ports コレクション</title> + + <para><emphasis>原作: &a.jraynard;.</emphasis></para> + + <para><emphasis>訳: &a.jp.masaki;, &a.jp.saeki;.<!-- <br> --> + 11 November 1996.</emphasis></para> + + <para>FreeBSD の ports コレクションを利用すると, 最小限の労力で + 非常に幅広くのアプリケーションのコンパイルとインストールがおこなえます.</para> + + <para>やってみたことのある方はよくご存知でしょうが, + オープンな規格とは 全くの誇大広告であって, + あるプログラムを異なるバージョンの Unix 上で + 動作させることは退屈で手間のかかる仕事です. + 求めているプログラムが自分のシステムでうまくコンパイルでき, + 正しいところにインストールできて, + 完璧に動作するとしたらとてもラッキーです. しかし, + あいにくこれは滅多にないことなのです. + ほとんどのプログラムについて, + あなたは髪を掻きむしることになるでしょうし, + かなりのプログラムでは, 白髪混じりの頭になってしまったり, + あるいは慢性の 脱毛症にすら なってしまうかもしれません...</para> + + <para>いくつかのソフトウェアディストリビューションでは, + 設定用のスクリプトを + 配布することでこの問題を解決しようとしています. + これらのスクリプトの中には非常に精巧なものもありますが, + 残念ながら, 中にはこれまで + 聞いたこともないようなシステムの名前をしゃあしゃあと + 言い放ったうえに, まるでシステムレベルの Unix + プログラミングに関する 最終試験のような, + たくさんの質問をしてくる場合があります. (例えば, + <literal>このシステムの gethitlist 関数は fromboz への const + ポインタを 返しますか? それとも const fromboz + へのポインタを返しますか?</literal>, <literal>このシステムには + Foonix スタイルの, 容認できない例外処理をおこなう + ルーチンがありますか? もしもないとしたら, + それはなぜですか?</literal>)</para> + + <para>幸いなことに, ports コレクションがあれば, + これらのきつい作業はすべて 完了しています. <command>make + install</command> とタイプするだけで, 動作するプログラムを + 入手することができるのです.</para> + + <sect1> + <title>なぜ ports コレクションを作ったのか?</title> + + <para>FreeBSD の基本システムは, + 非常に多くのツールやユーティリティから 構成されています. しかし, + よく使われるプログラムのうち多くのものが, + この基本システムには含まれていません. その理由は:-</para> + + <orderedlist> + <listitem> + <para>ある Lisp ベースのエディタのように, + それがないと生きていけないと 言う人もいれば, + ディスクの無駄だと言う人もいるようなプログラム.</para> + </listitem> + + <listitem> + <para>基本システムに組み込むには特殊すぎるプログラム. (CAD + やデータベースなど.)</para> + </listitem> + + <listitem> + <para>“時間のある時に, + ちょっと見ておかなければ”というような類の, + それがシステムに含まれていないことが + 致命的とは言えないプログラム. (おそらく, + 何らかの言語などでしょう.)</para> + </listitem> + + <listitem> + <para>FreeBSD + のような真面目なオペレーティングシステムの一部として + 供給するには遊びが過ぎるようなプログラム. ;-)</para> + </listitem> + + <listitem> + <para>たくさんのプログラムを基本システムに組み込んだとしても, + もっともっと 組み込みたいという要求が出てくるので, + どこかで制限を引かなくてはならないため. (そうしなければ + FreeBSD の配布物は, + とてつもなく膨大になってしまうでしょう.)</para> + </listitem> + </orderedlist> + + <para>すべての人が自分のお気に入りの + プログラムを手作業で移植しなければ ならないとしたら, + (途方もない膨大な作業の繰り返しをさておいたとしても) + それは明らかに不合理な話です. そこで, FreeBSD プロジェクトでは, + 標準のツールを使って移植のプロセスを + 自動化する巧妙な方法を考え出しました.</para> + + <para>なお, + これは単純ながら非常に柔軟なツールを組み合わせることで, + 非常に強力な働きをさせるという“Unix + 流”の作業の優れた実例です.</para> + </sect1> + + <sect1> + <title>ports コレクションはどのように動くのでしょうか?</title> + + <para>インターネットでは通常, <link + linkend="ports-tarball">tarball</link> の形で + プログラムが配布されています. これは, Makefile + とソースコードで構成され, 普通は何らかの説明書 (あいにく, + いつもわかりやすく書かれているとは 限りませんが) + が付属しています. ことによるとコンフィグレーションスクリプトも + 含まれているかもしれません.</para> + + <para>標準的な手順では, FTP で tarball を入手して, + 適当なディレクトリで展開します. 次に説明書を読んで, + 必要な変更をおこないます. そして, 設定スクリプトを実行し, 標準の + <command>make</command> + コマンドを使ってソースのコンパイルとインストールを + おこないます.</para> + + <para>FreeBSD の ports も tarball の仕組みを利用していますが, + これはユーザが 苦労して作業することを期待したものではなく, + どのようにすれば FreeBSD 上で + そのプログラムが動くようになるかという「ノウハウ」を <link + linkend="ports-skeleton">スケルトン</link> + を使用して収めているものです. スケルトンは, カスタマイズ済みの + <link linkend="ports-makefile">Makefile</link> も + 提供していますので, ほとんどすべての ports + は同じ手順でインストールすることが できます.</para> + + <para>もしあなたが (<ulink + URL="file://localhost/usr/ports/devel/ElectricFence">あなたの + FreeBSD システム</ulink> または <ulink + URL="ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/devel/ElectricFence"> + FTP サイト</ulink> にある) ports スケルトンを見ていて, + そこに潜んでいる あらゆる種類の先端的な + ロケット工学的なものを見つけられると期待していると, + つまらなそうなファイルやディレクトリがそこにあるだけなのを見て, + がっかりするかもしれません. + (ports を手に入れる方法については, すぐに + <link linkend="ports-getting">FreeBSD ports コレクションの入手方法 + </link> の節でお話します.)</para> + + <para>“一体どうしたらいいんだ? ここにはソースコードが + ないじゃないか?” + というあなたの叫びが聞こえるようです.</para> + + <para>心配いりません. おとなしく読んでいけば, すべてが (たぶん) + 明らかに なるでしょう. 試しに ports をインストールして, + 何が起きるのかを見てみましょう. + ここではサンプルとして開発者向けの便利なツール, + <application>ElectricFence</application> を選択します. + このスケルトンを選んだ理由は, 他の ports + に比べても素直で理解しやすく 書かれているからです.</para> + + <note> + <para>自宅で試してみる場合には, root + になる必要があるでしょう.</para> + </note> + + <!-- kuriyama - remove informalexample --> + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports/devel/ElectricFence</userinput> +&prompt.root; <userinput>make install</userinput> +>> Checksum OK for ElectricFence-2.0.5.tar.gz. +===> Extracting for ElectricFence-2.0.5 +===> Patching for ElectricFence-2.0.5 +===> Applying FreeBSD patches for ElectricFence-2.0.5 +===> Configuring for ElectricFence-2.0.5 +===> Building for ElectricFence-2.0.5 +[大量のメッセージをコンパイラが出力します...] +===> Installing for ElectricFence-2.0.5 +===> Warning: your umask is "0002". + If this is not desired, set it to an appropriate value + and install this port again by ``make reinstall''. +install -c -o bin -g bin -m 444 /usr/ports/devel/ElectricFence/work/ElectricFence-2.0.5/libefence.a /usr/local/lib +install -c -o bin -g bin -m 444 /usr/ports/devel/ElectricFence/work/ElectricFence-2.0.5/libefence.3 /usr/local/man/man3 +===> Compressing manual pages for ElectricFence-2.0.5 +===> Registering installation for ElectricFence-2.0.5</screen> + </informalexample> + + <para>ここではあなたが混乱しないように, コンパイル時の出力を + すべて取り除いてあります.</para> + + <para>もしもあなた自身で実行されたら, 最初にこのような + 出力結果が得られるはずです:-</para> + + <informalexample id="ports-fetch"> + <screen>&prompt.root; <userinput>make install</userinput> +>> ElectricFence-2.0.5.tar.gz doesn't seem to exist on this system. +>> Attempting to fetch from ftp://ftp.doc.ic.ac.uk/Mirrors/sunsite.unc.edu/pub/Linux/devel/lang/c/.</screen> + </informalexample> + + <para><command>make</command> プログラムは, + あなたの手元にソースコードがないことを検出し, + 処理を続けられるようにソースを FTP でダウンロードしようとします. + この例では, あらかじめ手動でソースコードを用意してあったので, + 持ってくる必要はありませんでした.</para> + + <para>では, 続けて <command>make</command> + プログラムが何をしているのか見てみましょう.</para> + + <procedure> + <step> + <para>ソースコード <link + linkend="ports-tarball">tarball</link> のありかを + 確認します. 手元にファイルが存在しなければ, FTP + サイトから入手しようとします.</para> + </step> + + <step> + <para><link linkend="ports-checksum">チェックサム</link> + テストを実行して, その tarball + が事故か何かで途中で切れていたり, ASCII モードで + ダウンロードされていたり, + 転送中にニュートリノによって傷められたりして + 改変されたりしていないかどうかを確認します.</para> + </step> + + <step> + <para>tarball を一時的な作業用ディレクトリに展開します.</para> + </step> + + <step> + <para>FreeBSD 上でコンパイルしたり, 動作させるのに必要な + すべての <link linkend="ports-patch">パッチ</link> + をソースコードに当てます.</para> + </step> + + <step> + <para>構築のために必要な + コンフィグレーションスクリプトを実行します. + コンフィグレーションスクリプトの + 質問には正確に答えてください.</para> + </step> + + <step> + <para>(いよいよ!) ソースコードをコンパイルします.</para> + </step> + + <step> + <para>実行形式のプログラム, マニュアル, + その他のサポートファイルを, + システムのプログラムと混ざってしまわないように + <filename>/usr/local</filename> 以下に インストールします. + ports はすべて同じ場所にインストールされ, + システムのあちこちにばらまかれることはありません.</para> + </step> + + <step> + <para>インストール結果はデータベースに登録されます. + これにより, + インストールしたプログラムがもしも気に入らなかったときも, + システムから すべての痕跡をきれいに <link + linkend="ports-remove">消去</link> + することができます.</para> + </step> + </procedure> + + <para>以上のステップが <command>make</command> + の出力と一致しているかどうか確認してください. + 今まで確認していなかったのなら, + 今からするようにしてください!</para> + </sect1> + + <sect1 id="ports-getting"> + <title>FreeBSD ports コレクションの入手</title> + + <para>あるプログラムの FreeBSD port + を入手するには二つの方法があります. ひとつは <link + linkend="ports-cd">FreeBSD CD-ROM</link> を使う方法で, + もうひとつは <link + linkend="ports-inet">インターネット接続</link> + を使う方法です.</para> + + <sect2 id="ports-cd"> + <title>CD-ROM からコンパイルする</title> + + <para>FreeBSD CD-ROM がドライブに入っており, + <filename>/cdrom</filename> にマウントされていると仮定すると + (マウントポイントが <filename>/cdrom</filename> + である必要があります), ただ普通に実行するだけで ports + を構築できるようになり, tarball + をネットワーク経由でダウンロードするのではなく + <filename>/cdrom/ports/distfiles/</filename> + からさがすようになります (そこにあればの話ですが).</para> + + <para>CD-ROM にある port スケルトンを使いたければ, 他に + <filename>/etc/make.conf</filename> の + 変数を以下のようにセットする方法があります:</para> + + <programlisting> +PORTSDIR= /cdrom/ports +DISTDIR= /tmp/distfiles +WRKDIRPREFIX= /tmp</programlisting> + + <para>(任意の十分な空きスペースの場所を <literal>/tmp</literal> + とおいています). + 次に, <filename>/cdrom/ports</filename> 下の適宜のサブディレクトリに + <command>cd</command> して, 例のごとく + <command>make install</command> とタイプします. + <makevar>WRKDIRPREFIX</makevar> は port に + <filename>/tmp/cdrom/ports</filename> の下でビルドさせようとします; + 例えば, <filename>games/oneko</filename> は + <filename>/tmp/cdrom/ports/games/oneko</filename> の下で + ビルドされるでしょう. + </para> + + <para>ライセンスの制限により, いくつかの ports + でオリジナルのソースコードを CD-ROM + に入れることができなかったものがあることに注意してください. + この場合, <link linkend="ports-inet">インターネット経由で + ports をコンパイルする</link> の + 節を参照してください.</para> + </sect2> + + <sect2 id="ports-inet"> + <title>インターネット経由で ports をコンパイルする</title> + + <para>CD-ROM を持っていなかったり, その ports + の最新バージョンを確実に入手したい 場合は, その ports の <link + linkend="ports-skeleton">スケルトン</link> を + ダウンロードする必要があります. ところで, これは落し穴が + たくさんある作業に見えるかもしれませんが, + 実際には非常に簡単です.</para> + + <para>初めに, あなたの動かしている FreeBSD + がリリースバージョンなら <ulink + url="http://www.freebsd.org/ports/">ports ページ </ulink> + でその FreeBSD 用の “アップグレードキット” + を手にいれてください. このパッケージには, 最新の ports + をコンパイルするのに必要な, + リリース以降に更新されたファイルが含まれています.</para> + + <para>FreeBSD の FTP サーバーがその場で <link + linkend="ports-tarball">tarball</link> + を作成できることを利用してスケルトンを入手すると + 非常に便利です. ここでは例として databases ディレクトリにある + gnats プログラムを使って説明します. + (角型かっこの中の文はコメントなので, 実際に実行する場合には, + これをタイプしないでください!):-</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports</userinput> +&prompt.root; <userinput>mkdir databases</userinput> +&prompt.root; <userinput>cd databases</userinput> +&prompt.root; <userinput>ftp ftp.freebsd.org</userinput> +[ユーザ名 `ftp' でログインし, パスワードを要求されたら, あなたの電子メール +アドレスを入力してください. バイナリモードを (イメージモードと呼ばれることも +あります) 使うのをお忘れなく!] +<prompt>></prompt> <userinput>cd /pub/FreeBSD/ports/ports/databases</userinput> +<prompt>></prompt> <userinput>get gnats.tar</userinput> +[gnats スケルトンの tarballs を取得] +<prompt>></prompt> <userinput>quit</userinput> +&prompt.root; <userinput>tar xf gnats.tar</userinput> +[gnats スケルトンの展開] +&prompt.root; <userinput>cd gnats</userinput> +&prompt.root; <userinput>make install</userinput> +[gnats の構築とインストール]</screen> + </informalexample> + + <para>さて何が起きるでしょうか? FTP + サイトにいつも通りに接続して, データベースの + サブディレクトリに移動します. <command>get gnats.tar</command> + とコマンドを入力すると, FTP サイトでは gnats ディレクトリを + <link linkend="ports-tarball">tarred</link> + にしてくれるのです.</para> + + <para>gnats スケルトンを展開したら, gnats ディレクトリへ移動して + ports を構築します. <link linkend="ports-fetch">すでに</link> + 説明したように, make の過程で + 手元にソースコードがないことを検出すると, + ソースコードを取得してから 展開し, + パッチ当てと構築をおこないます.</para> + + <para>それでは, 少し冒険をしてみましょう. 一つの ports + スケルトンを 取得するかわりに, たとえば ports + コレクションの中のデータベースの スケルトンをすべて, + サブディレクトリ全体を取得してみましょう. + やり方はほとんど同じです:-</para> + + <para> + <literallayout> &prompt.root; cd /usr/ports + &prompt.root; ftp ftp.freebsd.org + [ユーザ名 `ftp' でログインし, パスワードを要求されたら, あなたの電子メール +アドレスを入力してください. バイナリモードを (イメージモードと呼ばれることも +あります) 使うのをお忘れなく!] + > cd /pub/FreeBSD/ports/ports + > get databases.tar [データベースディレクトリの tarballs を取得] + > quit + &prompt.root; tar xf databases.tar [すべてのスケルトンを展開] + &prompt.root; cd databases + &prompt.root; make install [データベース ports 全部の構築とインストール] </literallayout> + </para> + <!-- kuriyama - literallayout? --> + + <para>わずかばかりの簡単なコマンドで, この FreeBSD + マシン上にデータベース + プログラムを一揃い手に入れてしまいました! 一つの ports + スケルトンを取ってきて それを構築する場合との違いは, + すべてのディレクトリを一度に取得して, + 全部を一度にコンパイルしたということだけです. + かなり感動的だと思いませんか?</para> + + <para>たくさんの ports をインストールする つもりなら, + おそらくすべての ports ディレクトリをダウンロードしておく + 価値があるでしょう.</para> + </sect2> + </sect1> + + <sect1 id="ports-skeleton"> + <title>スケルトン</title> + + <para>スケルトン (訳注: skeleton とは骸骨のことです) とは, + 締め切りを守るため, 食事をするのを忘れるほど仕事にのめり込んだ + ハッカーたちのなれの果ての ことでしょうか? FreeBSD + の屋根裏に潜む, なにか気持ちの悪いものでしょうか? いいえ, + ここでスケルトンの意味するところは, ports の魔術を実現するのに + 必要とされるすべてのものを提供する最小の骨組みのことです.</para> + + <sect2 id="ports-makefile"> + <title><filename>Makefile</filename></title> + + <para>スケルトンのもっとも重要な要素は Makefile です. Makefile + は ports を どのようにコンパイルし, + インストールをおこなうかを指示する + いろいろな命令を含んでいます. 以下に ElectricFence の Makefile + を示します:-</para> + + <programlisting> +# New ports collection makefile for: Electric Fence +# Version required: 2.0.5 +# Date created: 13 November 1997 +# Whom: jraynard +# +# $Id$ +# + +DISTNAME= ElectricFence-2.0.5 +CATEGORIES= devel +MASTER_SITES= ${MASTER_SITE_SUNSITE} +MASTER_SITE_SUBDIR= devel/lang/c + +MAINTAINER= jraynard@freebsd.org + +MAN3= libefence.3 + +do-install: + ${INSTALL_DATA} ${WRKSRC}/libefence.a ${PREFIX}/lib + ${INSTALL_MAN} ${WRKSRC}/libefence.3 ${PREFIX}/man/man3 + +.include <bsd.port.mk></programlisting> + + <para>"#" で始まる行は, 人間のためのコメント行です. + (ほとんどの Unix のスクリプトと同じですね.)</para> + + <para><literal>DISTNAME</literal> は <link + linkend="ports-tarball">tarball</link> + の名前から拡張子を取ったものです.</para> + + <para><literal>CATEGORIES</literal> + はこのプログラムの種類を示します. この場合, + 開発者向けのユーティリティということになります. + 完全なリストはこのハンドブックの <link + linkend="porting-categories">カテゴリ</link> + をみてください.</para> + + <para><literal>MASTER_SITES</literal> はマスタ FTP サイトの URL + です. もしローカルシステムに <link + linkend="ports-tarball">tarball</link> がない場合には, + ここから取得します. これは信頼できると考えられているサイトで, + 通常はそのプログラムを + インターネット上で公式に配布しているサイトです. + (そのソフトウェアがインターネット上で「公式に」 + 配布されているとしたら)</para> + + <para><literal>MAINTAINER</literal> は, + 例えば新しいバージョンのプログラムが出た場合に, 必要であれば + スケルトンの更新をおこなう保守担当者の + 電子メールアドレスです.</para> + + <para>次の数行はとりあえず飛ばします. + + <literal>.include <bsd.port.mk></literal> + + この行は, この ports に必要なその他の命令やコマンドは + <filename>bsd.port.mk</filename> に + 入っているということを示しています. + これらはすべての ports で共通のものなので, + それぞれの Makefile に書いておく必要はありません. + そのため単一の標準ファイルに + まとめられているのです.</para> + + <para>ここでは Makefile + がどう働くかを詳細に調査するのが目的ではありませんので, + <literal>MAN3</literal> で始まる行は, インストールの後に + ElectricFence のマニュアルを 圧縮するために使用される, + と言っておくだけで充分でしょう. これにより, + 貴重なディスクスペースが保護されているわけです. オリジナルの + port では <maketarget>install</maketarget> + ターゲットが用意されていないので, + <maketarget>do-install</maketarget> からの 3 行が この ports + によって生成されたファイルを + 正しい場所に置くために使用されます.</para> + </sect2> + + <sect2> + <title><filename>files</filename> ディレクトリ</title> + + <para>ports のチェックサム算出には MD5 + アルゴリズムを使用しているので, この <link + linkend="ports-checksum">チェックサム</link> を含んでいる + ファイルは <filename>md5</filename> と呼ばれます. + ちょっと混乱するかもしれませんが, このファイルは + <filename>files</filename> という + 名前のディレクトリに置かれています.</para> + + <para>このディレクトリは, ports に必要だけれども, + 他のどこにも属さない 雑多なファイルも含んでいます.</para> + </sect2> + + <sect2> + <title><filename>patches</filename> ディレクトリ</title> + + <para>このディレクトリには, FreeBSD + ですべてを正常に動作させるのに 必要な <link + linkend="ports-patch">パッチ</link> が含まれています.</para> + </sect2> + + <sect2> + <title><filename>pkg</filename> ディレクトリ</title> + + <para>このディレクトリには, + 非常に役立つ三つのファイルが含まれています:-</para> + + <itemizedlist> + <listitem> + <para><filename>COMMENT</filename> — + プログラムについての 1 行の説明.</para> + </listitem> + + <listitem> + <para><filename>DESCR</filename> — より詳細な説明.</para> + </listitem> + + <listitem> + <para><filename>PLIST</filename> — + プログラムのインストール時に作成される, + すべてのファイルのリスト.</para> + </listitem> + </itemizedlist> + </sect2> + </sect1> + + <sect1 id="ports-troubleshooting"> + <title>ports が動かないのですが, どうしたらよいでしょう</title> + + <para>おやおや. では, 次の四つのどれかをやってみてください:</para> + + <orderedlist> + <listitem> + <para>自分で修正する. ports + の仕組みに関する技術的な詳細については, <link + linkend="porting"> + アプリケーションの移殖方法</link>をご覧ください.</para> + </listitem> + + <listitem> + <para>苦情をいう. これは電子メールで <emphasis>だけ</emphasis> + にしてください! このようなメールの宛先は &a.ports; です. + なお, 必ず port の名前やバージョン, その port のソースや + distfile(s) を どこから入手したか, + どんなエラーが発生したのかを書いておいてください.</para> + </listitem> + + <listitem> + <para>忘れてしまう. これはほとんどの場合最も簡単な方法です. + ports + のプログラムのうち必要不可欠な物はごくわずかです.</para> + </listitem> + + <listitem> + <para>FTP サイトからコンパイル済みのパッケージを入手する. + “マスター”パッケージコレクションは FreeBSD の + FTP サイトの <ulink + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/"> + パッケージディレクトリ</ulink> に置いてありますが, + まずあなたの近くのローカルミラーサイトを確認してください! + ソースからのコンパイルに挑戦するよりも, + パッケージを使うほうが (全体的に見て) + ずっと確実に動作するでしょうし, + より手っ取り早い方法でもあります. + システムにパッケージをインストールするには, &man.pkg.add.1; + を使ってください.</para> + </listitem> + </orderedlist> + </sect1> + + <sect1> + <title>質問と回答集</title> + + <itemizedlist> + <listitem> + <para>Q. 私はモデムについての議論を + しているのかと思っていました??!</para> + + <para>A.なるほど, あなたはきっとコンピュータの背面についている + シリアルポートのことだと思ってしまったのでしょう. + あるバージョンの Unixから別のバージョンの Unix + へとプログラムを 移殖することを “porting” + というのですが, ここで我たちは “porting” の結果 + という意味で “port” を使っています. + (コンピュータに関わる人々の悪しき習慣として, + ひとつの同じ言葉を複数の + まったく違う意味として使うことがあるのです.)</para> + </listitem> + + <listitem> + <para>Q. 私は, 標準以外のプログラムのインストールには packages + を使うと 思っていたのですが.</para> + + <para>A. そのとおり. 通常は packages + が最も手早くて簡単な方法です.</para> + </listitem> + + <listitem> + <para>Q. それではどうして面倒な ports があるのですか?</para> + + <para>A. いくつかの理由があります:-</para> + + <orderedlist> + <listitem> + <para>いくつかのソフトウェアのライセンス条件には, + バイナリではなくソースコードでの + 配布を求めているものがあります.</para> + </listitem> + + <listitem> + <para>バイナリ配布を信用していない人もいます. + 少なくともソースコード があれば, ソースコードを読んで, + (理論的には) 潜在的な問題点を自分で + 見つけ出すこともできるはずです.</para> + </listitem> + + <listitem> + <para>ローカルなパッチを入手した場合, + それを自分で追加するために + ソースコードが必要になります.</para> + </listitem> + + <listitem> + <para>プログラムがいかにコンパイルされるべきかについて, + あなたはパッケージを作った人とは + 異なる見解を持っているかもしれません. + どんな最適化オプションをつけるべきかとか, + デバッグバージョンを作ってから それを strip + するべきだとか, いや, そうするべきでない, などなど, + 確固たる見解を持っている人もいるでしょう.</para> + </listitem> + + <listitem> + <para>ソースコードを手元に置いておきたい人たちもいます. + 彼らは, 退屈したときに眺めたり, あちこち解析してみたり, + ソースコードを 借用したり (もちろん, + ライセンスが許せばの話ですが) するのです.</para> + </listitem> + + <listitem> + <para>あなたがソースコードを持っていなければ, + それはソフトウェアとは 言えませんね! <!-- smiley + -->;-)</para> + </listitem> + </orderedlist> + </listitem> + + <listitem> + <para><anchor id="ports-patch"> + Q. パッチとは何ですか?</para> + + <para>A. パッチとは, + あるバージョンから他のバージョンへどのように変更するかを + 示す, (通常は) 小さなファイルです. “23 + 行目を削除”, “468 行目の後に これらの 2 + 行を追加”, または“197 + 行目をこのように変更”というような 内容を含んでいます. + これは, “diff” + という名前のプログラムで生成されます.</para> + </listitem> + + <listitem> + <para><anchor id="ports-tarball"> + Q. tarball とは一体何ですか?</para> + + <para>A. <filename>.tar</filename> または + <filename>.tar.gz</filename> という拡張子を持つファイルです. + (<filename>.tar.Z</filename> のようなバリエーションも + ありますし, DOS のファイルシステム用に + <filename>.tgz</filename> + と短縮される場合もあります.)</para> + + <para>これは基本的に, 一つのファイルに固めた + (<filename>.tar</filename>) ディレクトリツリーです. + 圧縮されている (<filename>.gz</filename>) 場合もあります. + これは元々 <emphasis>T</emphasis>ape + <emphasis>AR</emphasis>chives (訳注: テープアーカイブ) + (このため <command>tar</command> という名前なのです) + で使われていたものなのですが, + インターネット上でプログラムのソースコードを配布するために + 広く使われている方法です.</para> + + <para>これらのファイルの中身を見たり, + 展開したりすることもできます. FreeBSD + の基本システムに付属する Unix 標準の tar + コマンドを使ってみると 次のようになります:-</para> + + <informalexample> + <screen>&prompt.user; <userinput>tar tvzf foobar.tar.gz</userinput> +&prompt.user; <userinput>tar xzvf foobar.tar.gz</userinput> +&prompt.user; <userinput>tar tvf foobar.tar</userinput> +&prompt.user; <userinput>tar xvf foobar.tar</userinput> + </screen> + </informalexample> + </listitem> + + <listitem> + <para><anchor id="ports-checksum"> + Q. チェックサムとは何ですか?</para> + + <para>A. これは, + チェックしたいファイル中のすべてのデータを加えて生成した + 数値です. 何か文字が書き換わっていたら, + チェックサムが一致しなくなります. そのため, + 単純な比較だけで違いを見つけることができるのです. + (実際には, 文字の位置が入れ替わるなどの, + 単純な加算ではわからない問題も + 見つけることができる複雑な方法で計算されています.)</para> + </listitem> + + <listitem> + <para>Q. 私は, <link linkend="ports-cd">CD-ROM から ports + をコンパイルする</link> にしたがって ports + をインストールしていました. kermit + をインストールしようとするまではうまくいっていました:-</para> + + <informalexample> + <screen>&prompt.root; <userinput>make install</userinput> +>> cku190.tar.gz doesn't seem to exist on this system. +>> Attempting to fetch from ftp://kermit.columbia.edu/kermit/archives/.</screen> + </informalexample> + + <para>なぜ cku190.tar.gz が見つからないのでしょうか? 不良品の + CD-ROM を買ってしまったのでしょうか?</para> + + <para>A. Kermit の権利を持つチームは, 私たちの CDROM に kermit + の tarball を 入れることを許可しませんでした. + 申し分けありませんが, 手動でファイルを 入手してください. + このようなエラーメッセージが出たのは, + あなたがそのときインターネットに 接続していなかったためです. + あらかじめ上記のサイトのいずれかからファイルを + ダウンロードしておけば, プロセスを再開することができます. + (ダウンロードの際には, + あなたに最も近いサイトを選ぶようにしてください. そうすれば, + 時間とインターネットの帯域の節約になります)</para> + </listitem> + + <listitem> + <para>Q. kermit の tarball を入手しましたが, + <filename>/usr/ports/distfiles</filename> に + ファイルを置こうとすると, + 書き込み権がないというエラーがでます.</para> + + <para>A. ports のしくみは + <filename>/usr/ports/distfiles</filename> から tarball + を探します. しかし, これは read-only の CD-ROM + へのシンボリックリンクなので, + ここにファイルを置くことはできません. 次のようにすれば, + 他の場所を探すよう ports に指示することができます.</para> + + <informalexample> + <screen>&prompt.root; <userinput>make DISTDIR=/where/you/put/it install</userinput></screen> + </informalexample> + </listitem> + + <listitem> + <para>Q. ports では, すべてを <filename>/usr/ports</filename> + に置いたときだけ動作するのでしょうか? + システムの管理者によると, 私の個人的なファイルは + <filename>/u/people/guests/wurzburger</filename> + に入れなければならないのですが, これでは + うまくいかないように思います.</para> + + <para>A. <makevar>PORTSDIR</makevar> 変数と + <makevar>PREFIX</makevar> 変数を変更することで, + 違うディレクトリを 使用することができます. 例えば,</para> + + <informalexample> + <screen>&prompt.root; <userinput>make PORTSDIR=/u/people/guests/wurzburger/ports install</userinput></screen> + </informalexample> + + <para>とすると, ports は + <filename>/u/people/guests/wurzburger/ports</filename> + でコンパイルされ, すべて <filename>/usr/local</filename> + 以下にインストールされます.</para> + + <informalexample> + <screen>&prompt.root; <userinput>make PREFIX=/u/people/guests/wurzburger/local install</userinput></screen> + </informalexample> + + <para>この場合, コンパイルは <filename>/usr/ports</filename> + でおこない, + <filename>/u/people/guests/wurzburger/local</filename> + にインストールします. もちろん, + 以下のように両者を組み合わせることも可能です.</para> + + <informalexample> + <screen>&prompt.root; <userinput>make PORTSDIR=.../ports PREFIX=.../local install</userinput></screen> + </informalexample> + + <para>(省略せずに記述したら, + このページに収めるには長すぎるのですが, + 考え方は理解していただけたと思います)</para> + + <para>もし ports をインストールするたびに, + これらを毎回タイプするのが 気に入らないのであれば, + (正直に言って, 誰もそう思わないでしょう) + これらを環境変数にセットしてしまうという手があります.</para> + </listitem> + + <listitem> + <para>Q. 私は, FreeBSD の CD-ROM を持っていませんが, + 私はすべての tarball を 私のシステムに置いておきたいのです. + そうすれば, 私は ports をインストール するたびに, + 毎回ダウンロードが終わるのを待たなくてすむでしょう. + これを一度におこなう簡単な方法はありませんか?</para> + + <para>A. ports コレクション全体の tarball を持ってくるには, + 次のようにしてください.</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports</userinput> +&prompt.root; <userinput>make fetch</userinput></screen> + </informalexample> + + <para>ports の下のディレクトリひとつの tarball + を持ってくるには, 次のように してください.</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports/directory</userinput> +&prompt.root; <userinput>make fetch</userinput></screen> + </informalexample> + + <para>ports をひとつだけ持ってくる方法は, + きっと既にご存知だと思います.</para> + </listitem> + + <listitem> + <para>Q. マスタ FTP サイトから tarball を持ってくるより, + 近くにある FreeBSD の + ミラーサイトから持ってきた方が速いはずです. MASTER_SITES + に書かれている サイト以外から持ってくるように ports + に指示する方法はありませんか?</para> + + <para>A. もちろんあります. 例えば <hostid + role="fqdn">ftp.FreeBSD.ORG</hostid> が + <makevar>MASTER_SITES</makevar> に書かれている + サイトより近いとしたら, 以下のようにしてください.</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports/directory</userinput> +&prompt.root; <userinput>make MASTER_SITE_OVERRIDE=ftp://ftp.FreeBSD.ORG/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen> + </informalexample> + </listitem> + + <listitem> + <para>Q. ダウンロードをする前に, + どんなファイルが必要なのか知りたいのですが.</para> + + <para>A. <command>make fetch-list</command> とすると, ports + に必要なファイルの一覧を表示できます.</para> + </listitem> + + <listitem> + <para>Q. ports のコンパイルを途中で止める方法はありますか? + 私はインストールをする前に + いろいろとソースコードを解析したいのですが, 毎回 control-C + を打たなければならないのが少し面倒です.</para> + + <para>A. <command>make extract</command> を実行すると, + ファイル転送とソースコードの展開まで + おこなったところで停止します.</para> + </listitem> + + <listitem> + <para>Q. 自分で ports を作ろうとしています. 私の作ったパッチが + 正しく処理できることを確認できるように, + コンパイルを止めたいのです. パッチのための <command>make + extract</command> のようなものはありませんか?</para> + + <para>A. あります. <command>make patch</command> + があなたのお望みのものです. おそらく + <makevar>PATCH_DEBUG</makevar> オプションも同様に + お役に立つことでしょう. ところで, + あなたの努力に感謝いたします!!</para> + </listitem> + + <listitem> + <para>Q. あるコンパイルオプションはバグの + 原因になるという話を聞きました. 本当なのでしょうか? + どうやったら正しい設定で ports + をコンパイルできますか?</para> + + <para>A. 本当です. <command>gcc</command> の バージョン 2.6.3 + (FreeBSDの 2.1.0 と 2.1.5 に付属している バージョン) では, + <option>-O2</option> オプションを + <option>-fno-strength-reduce</option> オプションなしで + 使うと, バグのあるコードを出力します (ほとんどの ports は + <option>-O2</option> オプションを 使いません). + コンバイラオプションは次のように定義 <emphasis> すべき + </emphasis> です.</para> + + <informalexample> + <screen>&prompt.root; <userinput>make CFLAGS='-O2 -fno-strength-reduce' install</userinput></screen> + </informalexample> + + <para>これを <filename>/etc/make.conf</filename> + に書いておくこともできますが, 残念なことに すべての ports + がこの指定を尊重してくれる 訳ではありません. + もっとも確実なのは <command>make configure</command> + を実行し, ソースディレクトリの Makefile + を見て手で修整することですが, ソースが + 多くのサブディレクトリにわかれていて, 各々に Makefile + がある場合は 大変な仕事になります.</para> + </listitem> + + <listitem> + <para>Q. ports がたくさんありすぎて, + 私の欲しいものがなかなか見つけられません. どんな ports + が使えるのか, リストはどこかにありませんか?</para> + + <para>A. <filename>/usr/ports</filename> の中にある + <filename>INDEX</filename> ファイルを見てみましょう. + あるキーワードで ports コレクションを検索したければ, + それも可能です. たとえば, + 以下のようにすればプログラミング言語 LISP に関連した ports + を見つけることができます: </para> + + <screen>&prompt.user; <userinput>cd /usr/ports</userinput> +&prompt.user; <userinput>make search key=lisp</userinput></screen> + </listitem> + + <listitem> + <para>Q. <literal>foo</literal> ports + をインストールしたいのですが, それのコンパイルは + すぐに停止して, <literal>bar</literal> ports + のコンパイルが始まってしまいます. 一体どうして?</para> + + <para>A. <literal>foo</literal> ports が, + <literal>bar</literal> ports + の提供する何らかの機能を必要としているからです. 例えば + <literal>foo</literal> が画像を使うとすると, + <literal>bar</literal> は画像処理に必要な + ライブラリを持っている, などです. または, + <literal>bar</literal> は <literal>foo</literal> + をコンパイルするのに必要なツールなのかもしれません.</para> + </listitem> + + <listitem> + <para><anchor id="ports-remove"> Q. ports から + <literal>grizzle</literal> + プログラムをインストールしましたが, まったく + ディスクスペースの浪費です. 削除したいのですが, + すべてのファイルが どこへインストールされたのかわかりません. + 何か手がかりはありませんか?</para> + + <para>A. 大丈夫, 次のようにしてください.</para> + + <informalexample> + <screen>&prompt.root; <userinput>pkg_delete grizzle-6.5</userinput></screen> + </informalexample> + </listitem> + + <listitem> + <para>Q. ちょっと待ってください. + 削除しようとするコマンドのバージョン番号を + 知っていなくてはならないのでしょうか? あなたは, + 私がバージョン番号を + 覚えていることを本気で当てにしているのでしょうか?</para> + + <para>A. そんなことはありません. + バージョン番号は次のようにすればわかります.</para> + + <informalexample> + <screen>&prompt.root; <userinput>pkg_info -a | grep grizzle</userinput> +Information for grizzle-6.5: +grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arcade game.</screen> + </informalexample> + </listitem> + + <listitem> + <para>Q. ディスク容量のことなのですが, ports + のディレクトリは非常に膨大な容量を 使うように見えます. + 残しておいた方がよいのでしょうか? 削除してしまっても + よいのでしょうか?</para> + + <para>A. はい. インストールが首尾よく終わり, + もうソースコードが必要でないと思うなら, + それらを残しておく理由はないでしょう. 一番よい方法は, + 次の通りです.</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports</userinput> +&prompt.root; <userinput>make clean</userinput></screen> + </informalexample> + + <para>これは, すべての ports のサブディレクトリを調べ, 各 + ports のスケルトン以外の削除をおこないます.</para> + </listitem> + + <listitem> + <para>Q. これを試してみたのですが, tarball や ports + で使われたファイルが <filename>distfiles</filename> + ディレクトリに残っています. + これも削除してしまっても大丈夫ですか?</para> + + <para>A. はい. それを使った作業が終わったのであれば, + 削除してしまっても大丈夫です.</para> + </listitem> + + <listitem> + <para>Q. + 私はとてもとてもたくさんのプログラムを楽しみたいのです. + 一度にすべての ports + をインストールする方法はありませんか?</para> + + <para>A. 次のようにしてください.</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports</userinput> +&prompt.root; <userinput>make install</userinput></screen> + </informalexample> + </listitem> + + <listitem> + <para>Q. やってみました. 時間がとてもかかるだろうと思ったので, + そのまま実行を 続けさせて, 私は寝ました. + 翌朝コンピュータを見てみると, 三つ半の ports しか + 処理が終わっていませんでした. + なにか悪かったのでしょうか?</para> + + <para>A. これは ports の中には私たちの決められないこと + (例えば, あなたが A4 の 用紙に印刷したいのか, US + レターサイズの用紙に印刷したいのかなど) について + 質問してくるものがあるからです. + それらの質問には手動で答える必要があります.</para> + </listitem> + + <listitem> + <para>Q. + 私は一日中モニタの前に座って過ごしたりしたくないのですが. + 何かよいアイデアはありませんか?</para> + + <para>A. では, あなたが寝に / 仕事に / + 公園にいく前に以下を実行してください:-</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports</userinput> +&prompt.root; <userinput>make -DBATCH install</userinput></screen> + </informalexample> + + <para>これでユーザの入力を要求しないすべての ports + をインストールします. そして, 戻ってきてから, + 次のように実行してください.</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports</userinput> +&prompt.root; <userinput>make -DIS_INTERACTIVE install</userinput></screen> + </informalexample> + + <para>そして, 残りの作業を実行してください.</para> + </listitem> + + <listitem> + <para>Q. 私たちは ports コレクションにある + <literal>frobble</literal> を使っています. ですが, + 私たちの必要に応じて ports を変更したところがあるのです. + 自分でパッケージを作って, それを私たちのサイトのまわりに + 簡単に配布できるような方法がありますか?</para> + + <para>A. もちろんあります. + 変更点をパッチにする方法は知っていますよね:-</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports/somewhere/frobble</userinput> +&prompt.root; <userinput>make extract</userinput> +&prompt.root; <userinput>cd work/frobble-2.8</userinput> +[あなたのパッチを当ててください] +&prompt.root; <userinput>cd ../..</userinput> +&prompt.root; <userinput>make package</userinput></screen> + </informalexample> + </listitem> + + <listitem> + <para>Q. この ports の技術は本当に賢いですね. + どのようにして動いているのか + 私はどうしても知りたいと思います. その秘密は何ですか?</para> + + <para>A. 秘密は一切ありません. <ulink + URL="file://localhost/usr/share/mk/">Makefiles + ディレクトリ</ulink> にある + <filename>bsd.ports.mk</filename> と + <filename>bsd.ports.subdir.mk</filename> + ファイルを見るだけです.</para> + + <note> + <para>複雑なシェルスクリプトを嫌う読者は, + このリンクを追いかけないほうが よいでしょう.</para> + </note> + </listitem> + </itemizedlist> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/ppp-and-slip/chapter.sgml b/ja_JP.eucJP/books/handbook/ppp-and-slip/chapter.sgml new file mode 100644 index 0000000000..ba38c1dc4d --- /dev/null +++ b/ja_JP.eucJP/books/handbook/ppp-and-slip/chapter.sgml @@ -0,0 +1,2810 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.10 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:58 kuriyama Exp $ +--> + +<chapter id="ppp-and-slip"> + <title>PPP と SLIP</title> + + <para>もしあなたがモデムを使ってインターネットに接続したり, + 他の人々に FreeBSD によるインターネットへのダイヤルアップ接続を + 提供しようとしているのでしたら, PPP または SLIP + 接続を選択することができます. PPP 接続には, 2 + 種類の方法が提供されています: <emphasis>ユーザ</emphasis>PPP + (<emphasis>iijppp</emphasis> とも呼ばれます) + と<emphasis>カーネル</emphasis>PPP です. 両方の PPP の設定手順と, + SLIP の設定方法については以下の章に書かれています.</para> + + <sect1 id="userppp"> + <title>ユーザ ppp の設定</title> + + <para>ユーザ ppp は FreeBSD 2.0.5-RELEASE において, + 既存のカーネル実装版の PPP に加えて導入されました. それでは, + これまでの pppd との違い, すなわち この新しい PPP + が追加された理由とは いったい何なのでしょうか? + マニュアルから引用してみます:</para> + + <blockquote> + <para>これはユーザプロセス PPP ソフトウェアパッケージです. + 通常, PPP は (例えば <command>pppd</command> + でそうなっているように) カーネルの一部として + 実装されていますので, デバッグや動作の変更が少々困難です. + しかし, この実装では, PPP はトンネルデバイスドライバ (tun) の + 助けにより, ユーザプロセスとして実装されています.</para> + </blockquote> + + <para>本質として, これは常に PPP デーモンを実行しておかなくても, + 必要な時に ppp プログラムを実行できるということを意味します. + このプログラムはカーネルとのデータ送受のために + 一般のトンネルデバイスを 使うことができるため, PPP + インターフェースをカーネルに組み込んでおく + 必要がありません.</para> + + <para>以降では, ユーザ ppp と <command>pppd</command> のような他の + PPP クライアント/サーバ + ソフトウェアとを区別する必要が無い場合には, ユーザ ppp を単に + ppp とだけ 呼びます. 特に断らない限り, + このセクションのすべてのコマンドは root 権限で + 実行する必要があります.</para> + + <para>バージョン 2 の ppp では, + 数多くの機能強化がおこなわれています. どのバージョンの ppp + がインストールされているのかを調べるには, 引数なしで ppp + を起動し, プロンプトが表示されたら <command>show + version</command> とタイプしてください. 最新版の ppp + にアップグレードするのは, (どのバージョンの FreeBSD においても) + 難しいことではありません. <ulink + url="http://www.Awfulhak.org/ppp.html">www.Awfulhak.org</ulink> + から最新版のアーカイブをダウンロードしてください. </para> + + <sect2> + <title>スタートの前に</title> + + <para>このドキュメントでは, あなたが + およそ以下のような状況にあると仮定しています:</para> + + <para>PPP 接続の使えるインターネットサービスプロバイダ (ISP) + のアカウントを 持っている. さらに, 接続済みのモデム + (またはその他のデバイス) があり, + プロバイダとの接続が可能なように正しく設定されている.</para> + + <para>以下の情報を手に入れておく必要があるでしょう:</para> + + <itemizedlist> + <listitem> + <para>プロバイダの電話番号.</para> + </listitem> + + <listitem> + <para>ログイン名とパスワード. これは通常の unix + 形式のログイン名と パスワードの組という場合もありますし, + PPP PAP または CHAP の + ログイン名とパスワードの組という場合もあります.</para> + </listitem> + + <listitem> + <para>一つ以上のネームサーバの IP アドレス. 通常, + プロバイダから IP アドレスを二つ指示されている はずです. + 自分でネームサーバを立ち上げている場合を除き, バージョン + 1.X の <application>PPP</application> + を使用している場合には, + この情報は<emphasis>絶対に</emphasis>必要です. バージョン + 2 の <application>PPP</application> からは, + ネームサーバアドレスの 自動設定機能が追加されています. + この機能をプロバイダ側でもサポートしていれば, ppp + の設定ファイルに <command>enable dns</command> + と書いておくことで <application>PPP</application> + がネームサーバアドレスの設定をおこなうようになります. + </para> + </listitem> + </itemizedlist> + + <para>プロバイダからは以下の情報が提供されているはずですが, + どうしても必要というわけではありません: </para> + + <itemizedlist> + <listitem> + <para>プロバイダのゲートウェイの IP アドレス. + ゲートウェイとは, あなたがそこに接続をおこなって, + “デフォルトルート” + として設定することになるマシンです. + プロバイダがこのアドレスを明示していなくても, 最初は + 適当に設定しておいて, 接続時にプロバイダの PPP サーバから + 正しいアドレスを教えてもらうことができます.</para> + + <para>このアドレスは, 以降 <literal>HISADDR</literal> + と呼ぶことにします.</para> + </listitem> + + <listitem> + <para>プロバイダのネットマスク設定. + プロバイダが明示していないとしても, ネットマスクとして + <hostid role="netmask">255.255.255.0</hostid> + を使用しておけば問題ありません.</para> + </listitem> + + <listitem> + <para>もしプロバイダから固定の IP + アドレスとホスト名の割り当てを 受けていれば, + その情報を指定しておくこともできます. + 割り当てを受けていなければ, 接続先から適切な IP + アドレスを指定してもらいます. </para> + </listitem> + </itemizedlist> + + <para>もし, 必要な情報が不足していれば, プロバイダに連絡を取って + 確認しておいてください.</para> + </sect2> + + <sect2> + <title>ppp 対応カーネルの構築</title> + + <para>説明でも述べているように, <command>ppp</command> + はカーネルの <devicename>tun</devicename> デバイスを使います. + そのため, このデバイスがカーネルに組み込まれているかどうかを + 確認しておかなくてはいけません.</para> + + <para>これを確認するには, カーネルコンパイルディレクトリ + (<filename>/sys/i386/conf</filename> または + <filename>/sys/pc98/conf</filename>) に移動して, + カーネルコンフィグレーションファイルを調べます. + 以下の行がどこかに含まれている必要があります. + + <programlisting> +pseudo-device tun 1</programlisting> + + 元々の <filename>GENERIC</filename> カーネルは + 標準でこれを含んでいますので, + カスタムカーネルをインストールしているのではなかったり, + <filename>/sys</filename> ディレクトリが存在しないのであれば, + 何も変更する必要はありません.</para> + + <para>この行がカーネルコンフィグレーションファイルに + 含まれていなかったり, tun デバイスが一つでは足りない場合 + (例えば, 同時に 16 本の ダイアルアップ PPP + 接続を処理できるサーバを立ち上げるとしたら, + <literal>1</literal> のかわりに <literal>16</literal> + を指定する必要があるでしょう), この行を追加して + カーネルの再コンパイルとインストールをおこなう必要があります. + それからこの新しいカーネルを使ってブートしてください. + カーネルコンフィグレーションの詳細については, <link + linkend="kernelconfig">FreeBSD + カーネルのコンフィグレーション</link> + を参照してください.</para> + + <para>以下のコマンドを実行することで, + 現在のカーネルにトンネルデバイスが + いくつ組み込まれているかを調べることができます:</para> + + <screen>&prompt.root; <userinput>ifconfig -a</userinput> +tun0: flags=8051<UP,POINTOPOINT,RUNNING,MULTICAST> mtu 1500 + inet 200.10.100.1 --> 203.10.100.24 netmask 0xffffffff +tun1: flags=8050<POINTOPOINT,RUNNING,MULTICAST> mtu 576 +tun2: flags=8051<UP,POINTOPOINT,RUNNING,MULTICAST> mtu 1500 + inet 203.10.100.1 --> 203.10.100.20 netmask 0xffffffff +tun3: flags=8010<POINTOPOINT,MULTICAST> mtu 1500</screen> + + <para>この例ではトンネルデバイスが四つ存在し, そのうち二つに + 設定がおこなわれ, 使用中であることがわかります. 上の例で + <literal>RUNNING</literal> フラグがオンになっている + ものがありますが, これは + そのインターフェースが何かに使用されていることを示している + だけであるということに注意してください. つまり, + <literal>RUNNING</literal> になっていない + インターフェースがあったとしても, それはエラーではありません. + </para> + + <para>トンネルデバイスがカーネルに組み込まれておらず, + 何らかの理由で + カーネルの再構築ができない場合でも, + 方法がないわけではありません. + 動的にデバイスをロードすることができるはずです. + 詳細については + &man.modload.8; や &man.lkm.4; など, + 適切なマニュアルを参照してください.</para> + + <para>この機会にファイアウォールも + 設定しておきたいと思っているのであれば, 詳細については<link + linkend="firewalls">ファイアウォール</link>セクションを + 参照してください.</para> + </sect2> + + <sect2> + <title>tun デバイスの確認</title> + + <para>ほとんどのユーザは <devicename>tun</devicename> デバイス + (<filename>/dev/tun0</filename>) が一つあれば充分でしょう. + より多くのデバイスを使う場合 (すなわち, + カーネルコンフィグレーション ファイルで <literal>pseudo-device + tun</literal> の行に <literal>1</literal> + 以外の数値を指定している場合), 以下で + <devicename>tun0</devicename> と書かれている部分をすべて, + あなたが使うデバイスの番号に + あわせて読みかえてください.</para> + + <para><devicename>tun0</devicename> + デバイスが正しく作成されていることを確認する最も簡単な方法は, + それを作り直すことです. そのためには, + 以下のコマンドを実行します:</para> + + <screen>&prompt.root; <userinput>cd /dev</userinput> +&prompt.root; <userinput>./MAKEDEV tun0</userinput></screen> + + <para>カーネルに 16 個のトンネルデバイスを組み込んだのであれば, + tun0 だけでなく他の tun + デバイスも作成しておく必要があるでしょう:</para> + + <screen>&prompt.root; cd /dev +&prompt.root; ./MAKEDEV tun15</screen> + + <para>また, カーネルが正しく設定されているかどうかを調べるために + 以下のコマンドを実行して, + このような出力が得られることを確認します:</para> + + <screen>&prompt.root; <userinput>ifconfig tun0</userinput> +tun0: flags=8050<POINTOPOINT,RUNNING,MULTICAST> mtu 1500</screen> + + <para>まだ <literal>RUNNING</literal> + フラグがセットされていない場合もあります. + その時は以下のような出力が得られるでしょう: </para> + + <screen>&prompt.root; <userinput>ifconfig tun0</userinput> +tun0: flags=8010<POINTOPOINT,MULTICAST> mtu 1500</screen> + </sect2> + + <sect2> + <title>名前の解決に関する設定</title> + + <para>リゾルバ (resolver) はシステムの一部分で, IP + アドレスとホスト名との 変換をおこないます. IP + アドレスとホスト名を対応させるためのマップを, + 二つの場所のうちの一つから探すように設定できます. 一つめは + <filename>/etc/hosts</filename> (<command>man 5 + hosts</command>) と呼ばれるファイルです. <!-- kuriyama - + citerefentry? --> 二つめはインターネット + ドメインネームサービス (DNS) と呼ばれる + 分散データベースですが, これに関する議論は + このドキュメントで扱う範囲を 越えていますので, + これについての説明はおこないません.</para> + + <para>このセクションではリゾルバの + 設定方法について簡単に説明します.</para> + + <para>リゾルバは名前のマッピングを + おこなうシステムコールの集合体です. ただし + どこからマッピング情報を見つけるのかは, + 最初に指示しておく必要があります. これは まず + <filename>/etc/host.conf</filename> + ファイルを編集することでおこないます. 混乱の元になりますので, + このファイルを <filename>/etc/hosts.conf </filename>と + 呼んだりしては<emphasis>いけません</emphasis> (余分な + <literal>s</literal> がついていますね).</para> + + <sect3> + <title><filename>/etc/host.conf</filename> ファイルの編集</title> + + <para>このファイルには 以下の 2 行が (この順番で) + 書かれているはずです:</para> + + <programlisting> +hosts +bind</programlisting> + + <para>これは, 最初に <filename>/etc/hosts</filename> + ファイルを調べ, そこで目的の名前が 見つけられなかった場合に + DNS を引きにいくようリゾルバに指示します.</para> + </sect3> + + <sect3> + <title>/etc/hosts(5) ファイルの編集</title> + <!-- kuriyama - man.hosts.5? --> + + <para>このファイルはローカルネットワーク上に存在するマシンの + IP アドレスと ホスト名を含んでいるはずです. 最低でも ppp + を動作させるマシンのエントリが 含まれている必要があります. + そのマシンのホスト名が <hostid + role="fqdn">foo.bar.com</hostid> で, IP アドレスが + <hostid role="ipaddr">10.0.0.1</hostid> であると仮定すると, + <filename>/etc/hosts</filename> は + 以下の行を含んでいなければいけません:</para> + + <programlisting> +127.0.0.1 localhost +10.0.0.1 foo.bar.com foo</programlisting> + + <para>一つめの行は <hostid>localhost</hostid> + を現在のマシンの別名として定義しています. マシン固有の IP + アドレスが何であっても, この行の IP アドレスは 常に <hostid + role="ipaddr">127.0.0.1</hostid> でなければいけません. + 二つめの行はホスト名 <hostid + role="fqdn">foo.bar.com</hostid> (と, その省略形 + <hostid>foo</hostid>) を IP アドレス <hostid + role="ipaddr">10.0.0.1</hostid> にマップします.</para> + + <para>もしプロバイダから固定の IP + アドレスとホスト名を割り当てられて いるのであれば, それを + <hostid role="ipaddr">10.0.0.1</hostid> + エントリのかわりに使ってください.</para> + </sect3> + + <sect3> + <title><filename>/etc/resolv.conf</filename> ファイルの編集</title> + + <para><filename>/etc/resolv.conf</filename> + はリゾルバの振舞いを指定します. もし自前の DNS + サーバを走らせているのなら, このファイルは空のままに + しておくこともできます. 通常は, + 以下のように書いておく必要があるでしょう:</para> + + <programlisting> +nameserver <replaceable>x.x.x.x</replaceable> +nameserver <replaceable>y.y.y.y</replaceable> +domain <replaceable>bar.com</replaceable></programlisting> + + <para><hostid + role="ipaddr"><replaceable>x.x.x.x</replaceable></hostid> + と <hostid + role="ipaddr"><replaceable>y.y.y.y</replaceable></hostid> + はプロバイダから指示されたアドレスで, + 接続するプロバイダが提供しているネームサーバを + すべて書いてください. <literal>domain</literal> + に指定するのは このマシンのデフォルトのドメイン名で, + おそらく 書かなくても問題は無いでしょう. + このファイルの各エントリの詳細については, + <filename>resolv.conf</filename> + のマニュアルページを参照してください.</para> + + <para>バージョン 2 以降の ppp を使用している場合には, + <command>enable dns</command> + コマンドを使用してネームサーバのアドレスを + プロバイダに問い合わせるように指示することができます. + 上の指定とは異なるアドレスをプロバイダが指定してきた場合 + (または <filename>/etc/resolv.conf</filename> + でネームサーバが指定されていない場合), ppp + はプロバイダが指定したアドレスで + <filename>resolv.conf</filename> を書きかえます. </para> + </sect3> + </sect2> + + <sect2> + <title><command>ppp</command> の設定</title> + + <para>ユーザ ppp と <command>pppd</command> (カーネルレベルの + PPP 実装) は どちらも <filename>/etc/ppp</filename> + ディレクトリに置かれた設定ファイルを使います. + ここには設定ファイルのサンプルが用意されていて, ユーザ ppp + の設定を おこなう際に大変参考になりますので, + 削除したりしないでください.</para> + + <para><command>ppp</command> の設定をするためには, + 必要に応じていくつかのファイルを編集する必要が あります. + 書き込む内容は, プロバイダが静的に IP アドレスを割り当てる + (つまり, 固定の IP アドレスを一つ与えられて, 常にそれを使う) + か, または動的に IP アドレスを割り当てる (つまり, PPP + セッションごとに IP アドレスが変化する可能性がある) + かということに ある程度依存します.</para> + + <sect3 id="userppp-staticIP"> + <title>静的 IP アドレスによる PPP 接続</title> + + <para>まず <filename>/etc/ppp/ppp.conf</filename> + という設定ファイルを作成する必要があります. + これは以下の例とほとんど同じようなものになるでしょう.</para> + + <note> + <para><literal>:</literal> で終る行は 1 カラム目から始め, + その他の行はスペースまたはタブで以下の例のように + 段をつける (インデントする) 必要があります.</para> + </note> + + <programlisting> +1 default: +2 set device /dev/cuaa0 +3 set speed 115200 +4 set dial "ABORT BUSY ABORT NO\\sCARRIER TIMEOUT 5 \"\" ATE1Q0 OK-AT-OK +\\dATDT\\T TIMEOUT 40 CONNECT" +5 provider: +6 set phone "(0123) 456 7890" +7 set login "TIMEOUT 10 \"\" \"\" gin:-BREAK-gin: foo word: bar col: ppp" +8 set timeout 300 +9 set ifaddr <replaceable>x.x.x.x</replaceable> <replaceable>y.y.y.y</replaceable> 255.255.255.0 0.0.0.0 +10 add default HISADDR +11 enable dns</programlisting> + + <para>ファイルでは行番号を取り除いておいてください. + これは解説の際に参照する行を示すためにつけたものです.</para> + + <variablelist> + <varlistentry><term>Line 1:</term> + <listitem> + <para>デフォルトエントリを指定します. + このエントリ中のコマンドは ppp + が起動された際に自動的に実行されます.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Line 2:</term> + <listitem> + <para>モデムが接続されているデバイスを指定します. + <devicename>COM1:</devicename> は + <filename>/dev/cuaa0</filename> に, + <devicename>COM2:</devicename> は + <filename>/dev/cuaa1</filename> になります.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Line 3:</term> + <listitem> + <para>通信速度 (DTE 速度) を指定します. もし 115200 + が使えない (最近のモデムなら大抵使えるはずですが) + 場合には, かわりに 38400 + を指定してみてください.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Line 4:</term> + <listitem> + <para>ダイアルスクリプトを指定します. ユーザ PPP は + &man.chat.8; 言語に似た, 受信待ち文字列と + 送信文字列の対からなるスクリプトを使用します. + この言語の機能に関しては, + マニュアルページを参照してください.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Line 5:</term> + <listitem> + <para>接続するプロバイダの名前 “provider” を + エントリ名として指定します.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Line 6:</term> + <listitem> + <para>このプロバイダの電話番号を指定します. + 複数の電話番号を <literal>:</literal> や + <literal>|</literal> で区切って指定することができます. + これら区切り文字の違いについては, ppp + のマニュアルページに 詳しく書かれています. + 要約すると, 毎回違う番号に かけたいのであれば + <literal>:</literal> を使います. 常に + まず先頭の番号にかけてみて, つながらない時にだけ 2 + 番目以降の番号に かけたいのであれば + <literal>|</literal> を使います. + 例に示されているように, 常に電話番号全体を引用符で + くくって (クォートして) おきます.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Line 7:</term> + <listitem> + <para>ダイアルスクリプトと同様に, ログインスクリプトも + chat 言語風の記述をおこないます. この例は, + 以下のようなログインセッションを使用する + プロバイダのためのものです:</para> + + <screen> J. Random Provider +login: <replaceable>foo</replaceable> +password: <replaceable>bar</replaceable> +protocol: ppp</screen> + + <para>このスクリプトは必要に応じて + 書きかえなければならないでしょう. + 初めてスクリプトを書く時には, 予想した通りに + 処理が進んだかどうかを確認するため, “chat” + ログを とるようにしておいた方が良いでしょう. </para> + + <para>PAP や CHAP を使用する場合には, + ここでログインすることは ありませんから, + ログイン文字列は空白のままにしておくべきです. + 詳細については <link linkend="userppp-PAPnCHAP">PAP + および CHAP + による認証</link>を参照してください.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Line 8:</term> + <listitem> + <para>デフォルトの接続タイムアウト時間を (秒数で) + 指定します. この例では, 300 秒間 + 通信がおこなわれなければ + 自動的に接続を切るように指定しています. + タイムアウトさせたくない場合には, この値を 0 + に設定します.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Line 9:</term> + <listitem> + <para>インターフェースのアドレスを指定します. 文字列 + <replaceable>x.x.x.x</replaceable> は + プロバイダに割り当てられた IP + アドレスで置きかえてください. 文字列 + <replaceable>y.y.y.y</replaceable> + はプロバイダから指示されたゲートウェイ + (接続先となるマシン) の IP + アドレスで置きかえてください. + プロバイダがゲートウェイのアドレスを + 指示していない場合は, <hostid + role="netmask">10.0.0.2/0</hostid> + を使用しておいてください. もし“仮の” + アドレスを使用する必要がある場合には, <link + linkend="userppp-dynamicIP">動的 IP アドレスによる + PPP 接続</link>に関する指示に従って, + <filename>/etc/ppp/ppp.linkup</filename> + にエントリを作成していることを 確認してください. + この行が省略されている場合, ppp を + <option>-auto</option> + モードで動作させることはできません. </para> + </listitem> + </varlistentry> + + <varlistentry><term>Line 10:</term> + <listitem> + <para>プロバイダのゲートウェイへの経路を + デフォルトルートとして 追加します. 特殊文字列 + <literal>HISADDR</literal> は, 9 行目で指定された + ゲートウェイのアドレスで置きかえられます. + <literal>HISADDR</literal> は 9 + 行目までは初期化されていませんので, + その行よりも後でしか使えないことに + 注意してください.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Line 11:</term> + <listitem> + <para>ネームサーバのアドレスが正しいか + どうかを確認するため, + プロバイダに問い合わせをおこなうよう ppp に指示します. + プロバイダがこの機能をサポートしていれば, ppp は + <filename>/etc/resolv.conf</filename> + のネームサーバエントリを + 正しいアドレスに更新することができます. </para> + </listitem> + </varlistentry> + </variablelist> + + <para>静的な IP アドレスを持っていて, + 接続が完了する前にルーティングテーブルの + エントリが正しく設定されているのであれば, + <filename>ppp.linkup</filename> に + エントリを追加する必要はありません. しかし, + この場合でもエントリを追加して, 接続が完了した時点で + プログラムを呼び出したいことがあるかもしれません. + これについては後ほど sendmail を例として説明します.</para> + + <para>これらの設定ファイルのサンプルが + <filename>/etc/ppp</filename> ディレクトリに + 置かれています.</para> + </sect3> + + <sect3 id="userppp-dynamicIP"> + <title>動的 IP アドレスによる PPP 接続</title> + + <para>プロバイダが静的な IP + アドレスの割り当てをおこなっていない場合, + <command>ppp</command> が相手側のホスト (ゲートウェイ) + と交渉して, こちら側と相手側のアドレスを + 決めるように設定することができます. これは, + 起動時には“仮の”アドレスを使っておいて, + 接続後に IP コンフィグレーション プロトコル (IPCP) + を使用して <command>ppp</command> が IP + アドレスを正しく設定できるようにすることで実現されます. + <link linkend="userppp-staticIP">静的 IP アドレスによる PPP + 接続</link>に 以下の変更を加える以外は, + <filename>ppp.conf</filename> の設定は同じです:</para> + + <programlisting> +9 set ifaddr 10.0.0.1/0 10.0.0.2/0 255.255.255.0</programlisting> + + <para>繰り返しますが, 行番号は取り除いておいてください. + これは解説の際に参照する行を示すためにつけたものです. なお, + 少なくともスペース 1 個分の段づけ (インデント) + が必要です.</para> + + <variablelist> + <varlistentry><term>Line 9:</term> + <listitem> + <para><literal>/</literal> 文字の後ろの数字は, + アドレス交渉の際に固定しておきたい ビットの数です. + 場合によっては, もっと適切な IP アドレスを + 指定しておきたいこともあるかもしれませんが, + ほとんどの場合には 上の例の通りで問題ありません. + </para> + + <para>最後の引数 (<literal>0.0.0.0</literal>) は, + アドレスの交渉の際に <hostid + role="ipaddr">10.0.0.1</hostid> ではなく <hostid + role="ipaddr">0.0.0.0</hostid> を使用するよう ppp + に指示するためのものです. <command>set + ifaddr</command> コマンドの最初の引数として + <literal>0.0.0.0</literal> を指定してはいけません. + さもないと, <option>-auto</option> + モードで動作させる際に + 初期経路を設定することができなくなります. </para> + </listitem> + </varlistentry> + </variablelist> + + <para>バージョン 1.X の ppp を使用する場合, + <filename>/etc/ppp/ppp.linkup</filename> + にもエントリを作成しておく必要があります. + <filename>ppp.linkup</filename> + は接続が確立された後に使用されます. この時点では, + <command>ppp</command> は<emphasis>実際に</emphasis>どの IP + アドレスを使うべきなのか わかっているはずです. + 以下のエントリは存在する仮の経路を削除し, + 正しい経路を作成します:</para> + + <programlisting> +1 provider: +2 delete ALL +3 add default HISADDR</programlisting> + + <variablelist> + <varlistentry><term>Line 1:</term> + <listitem> + <para>接続を確立する際に, <command>ppp</command> + は以下のルールに従って + <filename>ppp.linkup</filename> + のエントリを検索します: まず + <filename>ppp.conf</filename> + で使用されたのと同じラベルを探します. + もし見つからなければ, ゲートウェイの IP + アドレスのエントリを 探します. このエントリは 4 + オクテットの IP アドレス形式の ラベルです. それでも + まだエントリが見つからなければ, + <literal>MYADDR</literal> エントリを探します.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Line 2:</term> + <listitem> + <para>この行は, 使用する tun + インターフェースに関する既存の経路を + (ダイレクトルートのエントリを除き) すべて削除するよう + <command>ppp</command> に指示します.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Line 3:</term> + <listitem> + <para>この行は <literal>HISADDR</literal> + への経路をデフォルトルートとして 追加するように ppp + に指示します. <literal>HISADDR</literal> は IPCP で + 決定されたゲートウェイの IP + アドレスで置きかえられます.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>詳細なサンプルについては, + <filename>/etc/ppp/ppp.conf.sample</filename> ファイル中の + pmdemand エントリと + <filename>/etc/ppp/ppp.linkup.sample</filename> + を参照してください.</para> + + <para>バージョン 2 の ppp から “sticky routes” + が導入されました. <literal>MYADDR</literal> や + <literal>HISADDR</literal> を含む <literal>add</literal> + コマンドと <literal>delete</literal> コマンドを記憶して, + <literal>MYADDR</literal> や <literal>HISADDR</literal> の + アドレスが変化した際には経路の再設定をおこないます. + したがって, これらのコマンドを + <filename>ppp.linkup</filename> に + 繰り返し記述する必要は無くなりました. </para> + </sect3> + + <sect3> + <title>かかってきた電話を <command>ppp</command> + で受けるには</title> + + <para>このセクションでは <command>ppp</command> + をサーバとして設定する方法について説明します.</para> + + <para>かかってきた電話を <command>ppp</command> + が受けるように設定する際に, そのマシンが LAN + に接続されているのであれば, パケットを LAN + に転送するかどうかを決定する必要があります. + 転送をおこなう場合には, その LAN のサブネットから IP + アドレスを ppp クライアントに割り当て, + 以下のコマンドを指定するのが良いでしょう. </para> + + <programlisting> +enable proxy</programlisting> + + <para>また, <filename>/etc/rc.conf</filename> + に以下のオプションが指定してあることを + 確認しておいてください. (以前のバージョンの FreeBSD では, + このファイルは <filename>/etc/sysconfig</filename> + と呼ばれていました): + </para> + + <programlisting> +gateway_enable=YES</programlisting> + + <sect4> + <title>どの getty を使いますか?</title> + + <para>getty + でダイアルアップサービスをおこなう場合の優れた解説が <link + linkend="dialup">FreeBSD + でダイアルアップサービスをおこなうための設定 + </link>にあります.</para> + + <para><command>getty</command> に代わるものとしては, <ulink + URL="http://www.leo.org/~doering/mgetty/index.html"> + mgetty</ulink> があります. これは + <command>getty</command> をより柔軟にしたもので, + ダイアルアップ回線での使用を意図して + 設計されています.</para> + + <para><command>mgetty</command> を使う場合の利点は, + <command>mgetty</command> + が積極的にモデムと<emphasis>通信する</emphasis> + ということです. つまり, もし + <filename>/etc/ttys</filename> でポートを閉じている場合, + モデムは電話をとらなくなります.</para> + + <para>最近のバージョンの <command>mgetty</command> (0.99beta + 以降) では, PPP ストリームの + 自動検出もサポートされています. これにより, + クライアント側で スクリプトを準備しなくてもサーバに + アクセスすることができます.</para> + + <para><command>mgetty</command> に関する, + より詳細な情報については <link + linkend="userppp-mgetty">Mgetty と AutoPPP</link> + を参照してください.</para> + </sect4> + + <sect4> + <title>ppp の実行許可</title> + + <para><command>ppp</command> は通常, ID 0 のユーザ (root) + として動作しなければいけませんが, 以下で説明するように, + <command>ppp</command> + を通常のユーザとしてサーバモードで実行させたい 場合には, + そのユーザを <filename>/etc/group</filename> の + <username>network</username> グループに 追加して, ppp + を実行する許可を与えておかなければいけません.</para> + + <para>また, そのユーザが設定ファイル内の目的のエントリに + アクセスできるように, 以下のように + <command>allow</command> + コマンドで許可を与えておく必要があります: </para> + + <programlisting> +allow users fred mary</programlisting> + + <para>このコマンドがデフォルトエントリに + 書かれている場合には, 指定されたユーザは + すべてのエントリをアクセスできるようになります.</para> + </sect4> + + <sect4> + <title>動的 IP ユーザのための ppp シェルの設定</title> + + <para><filename>/etc/ppp/ppp-shell</filename> という名前で, + 以下のような内容のファイルを 作成します:</para> + + <programlisting> +#!/bin/sh +IDENT=`echo $0 | sed -e 's/^.*-\(.*\)$/\1/'` +CALLEDAS="$IDENT" +TTY=`tty` + +if [ x$IDENT = xdialup ]; then + IDENT=`basename $TTY` +fi + +echo "PPP for $CALLEDAS on $TTY" +echo "Starting PPP for $IDENT" + +exec /usr/sbin/ppp -direct $IDENT</programlisting> + + <para>このスクリプトには実行可能属性をつけておきます. 次に, + 以下のコマンドを実行し, <filename>ppp-dialup</filename> + という名前で このスクリプトへのリンクを作成します:</para> + + <screen>&prompt.root; <userinput>ln -s ppp-shell /etc/ppp/ppp-dialup</userinput></screen> + + <para>すべてのダイアルアップ ppp + ユーザのログイン<emphasis>シェル</emphasis>として + このスクリプトを使用します. 以下は + <username>pchilds</username> というユーザ名の + ダイアルアップユーザを <filename>/etc/password</filename> + へ登録した場合の例です. + (パスワードファイルを直接エディタで編集したりせず, + <command>vipw</command> を使ってください)</para> + + <programlisting> +pchilds:*:1011:300:Peter Childs PPP:/home/ppp:/etc/ppp/ppp-dialup</programlisting> + + <para>任意のユーザが読むことのできる, + <filename>/home/ppp</filename> ディレクトリを 作成します. + <filename>/etc/motd</filename> + が表示されないようにするため, + このディレクトリには以下のように大きさが 0 + バイトのファイルを 作成しておきます.</para> + + <screen>-r--r--r-- 1 root wheel 0 May 27 02:23 .hushlogin +-r--r--r-- 1 root wheel 0 May 27 02:22 .rhosts</screen> + </sect4> + + <sect4> + <title>静的 IP ユーザのための PPP シェルの設定</title> + + <para>上記と同じように <filename>ppp-shell</filename> + ファイルを作成し, 静的な IP + アドレスを割り当てるアカウントそれぞれについて + <filename>ppp-shell</filename> + へのシンボリックリンクを作成します.</para> + + <para>例えば, クラス C ネットワークの経路制御を必要とする, + 三人のダイアルアップユーザ <username>fred</username>, + <username>sam</username>, <username>mary</username> + がいるとすると, + 以下のコマンドを実行することになります:</para> + + <screen>&prompt.root; <userinput>ln -s /etc/ppp/ppp-shell /etc/ppp/ppp-fred</userinput> +&prompt.root; <userinput>ln -s /etc/ppp/ppp-shell /etc/ppp/ppp-sam</userinput> +&prompt.root; <userinput>ln -s /etc/ppp/ppp-shell /etc/ppp/ppp-mary</userinput></screen> + + <para>これらのユーザのダイアルアップアカウントでは, + 上で作成した それぞれのシンボリックリンクを + ログインシェルとして設定しておきます. (つまり, ユーザ + <username>mary</username> のログインシェルは + <filename>/etc/ppp/ppp-mary</filename> に + なります).</para> + </sect4> + + <sect4> + <title>動的 IP ユーザのための ppp.conf の設定</title> + + <para><filename>/etc/ppp/ppp.conf</filename> ファイルは, + 大体以下のような内容になるでしょう:</para> + + <programlisting> +default: + set debug phase lcp chat + set timeout 0 + +ttyd0: + set ifaddr 203.14.100.1 203.14.100.20 255.255.255.255 + enable proxy + +ttyd1: + set ifaddr 203.14.100.1 203.14.100.21 255.255.255.255 + enable proxy</programlisting> + + <!-- kuriyama - remove Japanese "NOTE"ing --> + <note> + <para>上の例のように段をつける (インデントする) + 必要があることに注意してください.</para> + </note> + + <para><literal>default:</literal> + エントリはセッションごとにロードされます. + <filename>/etc/ttys</filename> + で有効にしてある各ダイアルアップ回線ごとに一つ, 上記の + <literal>ttyd0:</literal> のようなエントリを作成します. + 各行の相手側アドレスとして, それぞれ別の IP アドレスを + 動的 IP ユーザのための IP + アドレスのプールから割り当てておく必要があります.</para> + </sect4> + + <sect4> + <title>静的 IP ユーザのための <filename>ppp.conf</filename> + の設定</title> + + <para>上のサンプルの <filename>/etc/ppp/ppp.conf</filename> + の内容に加えて, 静的に IP + を割り当てられたダイアルアップユーザ + それぞれのためのエントリを追加する必要があります. + ここでも <username>fred</username>, + <username>sam</username>, <username>mary</username> + の例を使うことにしましょう.</para> + + <programlisting> +fred: + set ifaddr 203.14.100.1 203.14.101.1 255.255.255.255 + +sam: + set ifaddr 203.14.100.1 203.14.102.1 255.255.255.255 + +mary: + set ifaddr 203.14.100.1 203.14.103.1 255.255.255.255</programlisting> + + <para>必要であれば, それぞれの静的 IP + ユーザに対する経路制御情報も + <filename>/etc/ppp/ppp.linkup</filename> + ファイルに書いておくべきでしょう. + 以下の例ではクライアントの PPP リンクを経由する, クラス C + の <hostid role="ipaddr">203.14.101.0</hostid> + ネットワークへの経路を追加しています.</para> + + <programlisting> +fred: + add 203.14.101.0 netmask 255.255.255.0 HISADDR + +sam: + add 203.14.102.0 netmask 255.255.255.0 HISADDR + +mary: + add 203.14.103.0 netmask 255.255.255.0 HISADDR</programlisting> + </sect4> + + <sect4> + <title><command>mgetty</command>, AutoPPP, + マイクロソフト拡張の詳細</title> + + <sect5 id="userppp-mgetty"> + <title><command>mgetty</command> と AutoPPP</title> + + <para><literal>AUTO_PPP</literal> + オプションつきでコンパイルした <command>mgetty</command> + を使えば, <command>mgetty</command> が PPP 接続の LCP + フェーズを検出して, 自動的に PPP シェルを起動するように + 設定することができます. しかし この場合, デフォルトの + login/password シーケンスは発生しないので, + ユーザの認証は PAP または CHAP + を使っておこなう必要があります.</para> + + <para>このセクションでは, ユーザ (あなた) が問題なく + <literal>AUTO_PPP</literal> オプションつきの + <command>mgetty</command> (v0.99beta またはそれ以降) + の設定, コンパイル, + インストールができているものと仮定しています.</para> + + <para><filename> + /usr/local/etc/mgetty+sendfax/login.config</filename> + ファイルが + 以下の行を含んでいることを確認してください:</para> + + <programlisting> +/AutoPPP/ - - /etc/ppp/ppp-pap-dialup</programlisting> + + <para>これにより, PPP 接続を検出したら + <command>mgetty</command> が + <filename>ppp-pap-dialup</filename> + スクリプトを実行するようになります.</para> + + <para><filename>/etc/ppp/ppp-pap-dialup</filename> + という名前で, 以下のような内容のファイルを 作成します + (このファイルには実行可能属性を + つけておく必要があります):</para> + + <!-- kuriyama - en and ja are different with blank line. --> + <programlisting> +#!/bin/sh +exec /usr/sbin/ppp -direct pap</programlisting> + + <para>さらに, かかってきた電話すべてを自分で扱うエントリを + <filename>/etc/ppp/ppp.conf</filename> + に作成します.</para> + + <programlisting> +pap: + enable pap + set ifaddr 203.14.100.1 203.14.100.20-203.14.100.40 + enable proxy</programlisting> + + <para>この方法でログインする それぞれのユーザは, PAP + によるユーザ認証を おこなうために + <filename>/etc/ppp/ppp.secret</filename> + ファイルにユーザ名とパスワードを 書いておくか, または + <filename>/etc/password</filename> + ファイルを使うように,</para> + + <programlisting> +enable passwdauth</programlisting> + + <para>オプションを (/etc/ppp/ppp.conf に) + 追加しておく必要があるでしょう.</para> + + <para>ユーザに静的な IP アドレスを割り当てる場合には, + そのアドレスを <filename>/etc/ppp/ppp.secret</filename> + の第三引数として指定することができます. + サンプルについては, + <filename>/etc/ppp/ppp.secret.sample</filename> + を参照してください.</para> + </sect5> + + <sect5> + <title>マイクロソフト拡張</title> + + <para>クライアントからの要求に応じて, ppp が DNS や + NetBIOS ネームサーバの アドレスを通知するように + 設定をおこなうこともできます.</para> + + <para>これらの拡張機能を + <filename>/etc/ppp/ppp.conf</filename> + ファイルで有効にした例を 以下に示します.</para> + + <para>バージョン 1.X の ppp で + これらの拡張機能を有効にするには, 以下の行を + <filename>/etc/ppp/ppp.conf</filename> + の適切なセクションに追加する必要があるでしょう. </para> + + <programlisting> + enable msext + set ns 203.14.100.1 203.14.100.2 + set nbns 203.14.100.5</programlisting> + + <para>バージョン 2 以降の ppp では, + 以下のようになります:</para> + + <programlisting> +accept dns +set dns 203.14.100.1 203.14.100.2 +set nbns 203.14.100.5</programlisting> + + <para>これにより, クライアントはプライマリと + セカンダリのネームサーバアドレス および NetBIOS + ネームサーバホストを知ることができます.</para> + + <para>バージョン 2 以降の ppp では, <literal>set + dns</literal> の行を省略した場合には + <filename>/etc/resolv.conf</filename> + に書かれているネームサーバのアドレスを使用します. + </para> + </sect5> + </sect4> + </sect3> + + <sect3 id="userppp-PAPnCHAP"> + <title>PAP および CHAP による認証</title> + + <para>いくつかのプロバイダでは, PAP または CHAP + のいずれかの認証メカニズムを + 使用して接続時の認証をおこなうように + システムを設定しています. この場合, プロバイダは接続の際に + <prompt>login:</prompt> プロンプトを送信せず, 最初から PPP + で通信を始めようとするでしょう.</para> + + <para>PAP ではパスワードがそのまま送られてしまうため, CHAP + に比べると安全性が 低くなりますが, + このパスワードはシリアル回線のみを通して送られます. + そのため, + クラッカーが“盗み聞き”する余地は多くないので, + 通常ここの セキュリティは問題にはなりません.</para> + + <para><link linkend="userppp-staticIP">静的 IP アドレスによる + PPP 接続</link>または <link + linkend="userppp-dynamicIP">動的 IP アドレスによる PPP + 接続</link>の セクションに戻って, + 以下の変更をおこないます:</para> + + <programlisting> +7 set login +… +12 set authname <replaceable>MyUserName</replaceable> +13 set authkey <replaceable>MyPassword</replaceable></programlisting> + + <para>これまでと同様に, 行番号は取り除いておいてください. + これは解説の際に参照する行を示すためにつけたものです. なお, + 少なくともスペース 1 個分の段づけ (インデント) + が必要です.</para> + + <variablelist> + <varlistentry><term>Line 7:</term> + <listitem> + <para>PAP または CHAP を使用する場合, 通常 + プロバイダはサーバへの ログインを必要としません. + そのため, "set login" 文字列を + 無効にしておかなければいけません.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Line 12:</term> + <listitem> + <para>この行は PAP/CHAP ユーザ名を指定します. + <replaceable>MyUserName</replaceable> に + 正しい値を入れておく必要があります.</para> + </listitem> + </varlistentry> + + <varlistentry><term>Line 13:</term> + <listitem> + <para>この行は PAP/CHAP パスワードを指定します. + <replaceable>MyPassword</replaceable> に + 正しい値を入れておく必要があります. + PAP と CHAP はデフォルトで両方とも + 受け付けられるようになって + いますが, PAP や CHAP を使用するという + 意思を明示するために, + + <programlisting> +15 accept PAP</programlisting> + + または + + <programlisting> +15 accept CHAP</programlisting> + + という行を追加しておくのも良いでしょう.</para> + </listitem> + </varlistentry> + </variablelist> + </sect3> + + <sect3> + <title>動作中の ppp の設定変更</title> + + <para>適切な診断ポートが設定されている場合には, + バックグラウンドで動作中の <command>ppp</command> + プログラムと通信することができます. + この設定をおこなうためには, + 以下の行を設定ファイルに追加しておきます: </para> + + <programlisting> +set server /var/run/ppp-tun%d DiagnosticPassword 0177</programlisting> + + <para>これにより, ppp は指定された unix ドメインの + ソケットをモニタして, + クライアントから正しいパスワードを受け取った後に + アクセスを許可します. このソケット名に含まれる + <literal>%d</literal> は, この ppp が使用している tun + デバイスの デバイス番号で置きかえられます.</para> + + <para>一旦ソケットの設定が終了したら, スクリプト中で + &man.pppctl.8; を 使用して, 動作中の ppp + を操作することができるでしょう.</para> + </sect3> + </sect2> + + <sect2 id="userppp-final"> + <title>システムの最終設定</title> + + <para>これで <command>ppp</command> の設定は終りました. しかし + <command>ppp</command> を動かす前に, + まだ少し必要なことがあります. それらの設定は, すべて + <filename>/etc/rc.conf</filename> ファイルを + 編集することでおこないます. (このファイルは以前には + <filename>/etc/sysconfig</filename> と呼ばれていました)</para> + + <para>このファイルを上から順に設定していきます. まずは + <literal>hostname=</literal> + の行が設定されていることを確認します. + 例えば以下のように:</para> + + <programlisting> +hostname=foo.bar.com</programlisting> + + <para>もしプロバイダが静的な IP + アドレスとホスト名を割り当てているのなら, + ホスト名としてそれを使うのが おそらくベストでしょう.</para> + + <para>次に <literal>network_interfaces</literal> 変数を調べます. + 必要に応じて (on demand) + プロバイダにダイアルするようにシステムを設定したい場合には, + <devicename>tun0</devicename> + デバイスがこのリストに追加されていることを確認しておきます. + それ以外の場合には, tun0 + デバイスをリストから削除しておきます.</para> + + <!-- kuriyama - en needs break line --> + <programlisting> +network_interfaces="lo0 tun0" +ifconfig_tun0=</programlisting> + + <note> + <para><literal>ifconfig_tun0</literal> 変数が空で, + <filename>/etc/start_if.tun0</filename> という名前の + ファイルが作成されていなければなりません. + このファイルの内容は以下のようになります.</para> + + <programlisting> +ppp -auto mysystem</programlisting> + + <para>このスクリプトはネットワークの設定時に実行され, ppp + デーモンを自動モードで立ち上げます. このマシンがもし LAN + のゲートウェイであれば, <option>-alias</option> + スイッチも使用したいと思うかもしれません. 詳細に関しては, + マニュアルページを参照してください.</para> + </note> + + <para>以下のようにルータプログラムを <literal>NO</literal> + に設定します.</para> + + <programlisting> +router_enable=NO (/etc/rc.conf) +router=NO (/etc/sysconfig)</programlisting> + + <para><command>routed</command> は, <command>ppp</command> + が作成したデフォルトのルーティングテーブル + エントリを削除してしまう場合がありますので, + (初期設定では起動されるようになっている) + <command>routed</command> デーモンが + 起動されないようにしておくことが重要です.</para> + + <para><literal>sendmail_flags</literal> 行が <option>-q</option> + オプションを含まないように 設定しておいた方がよいでしょう. + さもないと, <command>sendmail</command> が + アドレスを調べようとして発信をおこなってしまう場合があります. + 以下のような設定で良いでしょう:</para> + + <programlisting> +sendmail_flags="-bd"</programlisting> + + <para>この結果, PPP リンクを立ち上げた時には + いつでも以下のコマンドを実行して, キューにたまっているメールを + <command>sendmail</command> + に送信させる作業が必要になるでしょう.</para> + + <screen>&prompt.root; <userinput>/usr/sbin/sendmail -q</userinput></screen> + + <para><filename>ppp.linkup</filename> 中で + <command>!bg</command> コマンドを使用することで, + これを自動的に おこなうこともできます:</para> + + <programlisting> +1 provider: +2 delete ALL +3 add 0 0 HISADDR +4 !bg sendmail -bd -q30m</programlisting> + + <para>こうするのが嫌であれば, SMTP + トラフィックをブロックするように “dfilter” + を設定しておくこともできます. + 詳細についてはサンプルファイルを参照してください.</para> + + <para>後はマシンをリブートするだけです.</para> + + <para>リブートが終ったら,</para> + + <screen>&prompt.root; <userinput>ppp</userinput></screen> + + <para>コマンドを実行し, 続いて PPP セッションを開始させるために + <command>dial provider</command> と入力することもできますし, + (<filename>start_if.tun0</filename> + スクリプトを作成していない場合に), + 外部へのトラフィックが発生した時に, <command>ppp</command> + が自動的に セッションを確立してくれるようにしたいのであれば, + 以下のコマンドを実行することもできます.</para> + + <screen>&prompt.root; <userinput>ppp -auto provider</userinput></screen> + </sect2> + + <sect2> + <title>まとめ</title> + + <para>要約すると, 初めて ppp を設定する際には, + 以下のステップが不可欠です:</para> + + <para>クライアント側:</para> + + <procedure> + <step> + <para>カーネルに <devicename>tun</devicename> + デバイスが組み込まれていることを確認.</para> + </step> + + <step> + <para><filename>/dev</filename> ディレクトリに + <filename>tun<replaceable>X</replaceable></filename> + デバイスファイルが 存在することを確認.</para> + </step> + + <step> + <para><filename>/etc/ppp/ppp.conf</filename> + にエントリを作成. ほとんどのプロバイダでは, + <filename>pmdemand</filename> の例で充分でしょう.</para> + </step> + + <step> + <para>動的 IP アドレスを使用するなら, + <filename>/etc/ppp/ppp.linkup</filename> に + エントリを作成.</para> + </step> + + <step> + <para><filename>/etc/rc.conf</filename> (または + <filename>sysconfig</filename>) ファイルを更新.</para> + </step> + + <step> + <para>必要に応じてダイヤル (demand dialing) + したいのであれば, <filename>start_if.tun0</filename> + スクリプトを作成.</para> + </step> + </procedure> + + <para>サーバ側:</para> + + <procedure> + <step> + <para>カーネルに <devicename>tun</devicename> + デバイスが組み込まれていることを確認.</para> + </step> + + <step> + <para><filename>/dev</filename> ディレクトリに + <filename>tun<replaceable>X</replaceable></filename> + デバイスファイルが 存在することを確認.</para> + </step> + + <step> + <para>(&man.vipw.8; コマンドを使って) + <filename>/etc/passwd</filename> にエントリを作成.</para> + </step> + + <step> + <para>このユーザのホームディレクトリに <command>ppp -direct + direct-server</command> + か何かを実行するプロファイルを作成.</para> + </step> + + <step> + <para><filename>/etc/ppp/ppp.conf</filename> + にエントリを作成. <filename>direct-server</filename> + の例で充分でしょう.</para> + </step> + + <step> + <para><filename>/etc/ppp/ppp.linkup</filename> + にエントリを作成.</para> + </step> + + <step> + <para><filename>/etc/rc.conf</filename> (または <emphasis + remap=tt>sysconfig</emphasis>) ファイルを更新.</para> + </step> + <!-- kuriyama - remap=tt? --> + </procedure> + </sect2> + + <sect2> + <title>謝辞</title> + + <para>ハンドブックの このセクションは, 1998 年 8 月 10 日 (月) + に &a.brian; によって 更新されました.</para> + + <para>以下の人々による情報提供, 批評そして提案に感謝します:</para> + + <para>&a.nik;</para> + + <para>&a.dirkvangulik;</para> + + <para>&a.pjc;</para> + </sect2> + </sect1> + + <sect1 id="ppp"> + <title>カーネル PPP の設定</title> + + <para><emphasis>原作: &a.gena;.</emphasis></para> + + <para><emphasis>訳: &a.jp.graphite;.<!-- <br> --> + 6 September 1996.</emphasis></para> + + <para>PPP の設定を始める前に, <command>pppd</command> が + <filename>/usr/sbin</filename> にあり, また + <filename>/etc/ppp</filename> という + ディレクトリが存在することを確認してください.</para> + + <para><command>pppd</command> はふたつのモードで動作します.</para> + + <orderedlist> + <listitem> + <para>“クライアント”モード. + シリアル接続やモデムを利用して, そのマシンを + 外部のネットワークに PPP 接続したい場合に用います.</para> + </listitem> + + <listitem> + <para>“サーバ”モード. + そのマシンがネットワーク上にあるときに, PPP を使って + ほかのコンピュータを接続する際に用います.</para> + </listitem> + </orderedlist> + + <para>どちらの場合でも, オプションファイルを設定する必要があります + (<filename>/etc/ppp/options</filename> または, そのマシン上で + PPP を使用する人が 複数いる場合には + <filename>~/.ppprc</filename>).</para> + + <para>また, ダイヤルとリモートホストへの接続をおこなうために, + シリアル接続やモデムを 操作する, + なんらかのソフトウェアが必要です (kermit + が適しているでしょう).</para> + + <sect2> + <title>PPP クライアントとしての動作</title> + + <para>私は, CISCO ターミナルサーバの PPP 回線に接続するために, + 下記のような <filename>/etc/ppp/options</filename> + を使用しています.</para> + + <programlisting> +crtscts # enable hardware flow control +modem # modem control line +noipdefault # remote PPP server must supply your IP address. + # if the remote host doesn't send your IP during IPCP + # negotiation , remove this option +passive # wait for LCP packets +domain ppp.foo.com # put your domain name here + +:<remote_ip> # put the IP of remote PPP host here + # it will be used to route packets via PPP link + # if you didn't specified the noipdefault option + # change this line to <local_ip>:<remote_ip> + +defaultroute # put this if you want that PPP server will be your + # default router</programlisting> + + <para>接続方法:</para> + + <procedure> + <step> + <para>kermit (またはその他のモデム操作プログラム) + を使ってリモートホストに ダイヤルし, 接続してください. + そして, あなたのユーザ名とパスワード (必要 であれば, + その他にもリモートホストで PPP を有効にするための操作) + を入力 します.</para> + </step> + + <step> + <para>kermit を抜けてください. (回線を切断せずに)</para> + </step> + + <step> + <para>下記のように入力します: </para> + + <screen>&prompt.root; <userinput>/usr/src/usr.sbin/pppd.new/pppd <replaceable>/dev/tty01</replaceable> <replaceable>19200</replaceable></userinput></screen> + + <para>(通信速度とデバイス名には, + あなたの環境に適したものを入れてください)</para> + </step> + </procedure> + + <para>これでこのコンピュータは PPP で接続されました. もし, + なんらかの理由で 接続に失敗したならば, + <filename>/etc/ppp/options</filename> ファイルに + <option>debug</option> オプションを追加して, + 問題点を突き止めるために, コンソールに表示される + メッセージを調べてください.</para> + + <para>下記の <filename>/etc/ppp/pppup</filename> スクリプトは, + 上記の作業を すべて自動的におこないます:</para> + + <programlisting> +#!/bin/sh +ps ax |grep pppd |grep -v grep +pid=`ps ax |grep pppd |grep -v grep|awk '{print $1;}'` +if [ "X${pid}" != "X" ] ; then + echo 'killing pppd, PID=' ${pid} + kill ${pid} +fi +ps ax |grep kermit |grep -v grep +pid=`ps ax |grep kermit |grep -v grep|awk '{print $1;}'` +if [ "X${pid}" != "X" ] ; then + echo 'killing kermit, PID=' ${pid} + kill -9 ${pid} +fi + +ifconfig ppp0 down +ifconfig ppp0 delete + +kermit -y /etc/ppp/kermit.dial +pppd /dev/tty01 19200</programlisting> + + <para><filename>/etc/ppp/kermit.dial</filename> は kermit + 用のスクリプトで, ダイヤルして, + リモートホストでの認証に必要なすべての処理をおこないます. + (そのようなスクリプトの例は + この文書の終わりに添付してあります)</para> + + <para>PPP 接続を切断するには, 下記のような + <filename>/etc/ppp/pppdown</filename> スクリプトを + 使用します:</para> + + <programlisting> +#!/bin/sh +pid=`ps ax |grep pppd |grep -v grep|awk '{print $1;}'` +if [ X${pid} != "X" ] ; then + echo 'killing pppd, PID=' ${pid} + kill -TERM ${pid} +fi + +ps ax |grep kermit |grep -v grep +pid=`ps ax |grep kermit |grep -v grep|awk '{print $1;}'` +if [ "X${pid}" != "X" ] ; then + echo 'killing kermit, PID=' ${pid} + kill -9 ${pid} +fi + +/sbin/ifconfig ppp0 down +/sbin/ifconfig ppp0 delete +kermit -y /etc/ppp/kermit.hup +/etc/ppp/ppptest</programlisting> + + <para>PPP が動作中かどうかを調べます + (<filename>/usr/etc/ppp/ppptest</filename>):</para> + + <programlisting> +#!/bin/sh +pid=`ps ax| grep pppd |grep -v grep|awk '{print $1;}'` +if [ X${pid} != "X" ] ; then + echo 'pppd running: PID=' ${pid-NONE} +else + echo 'No pppd running.' +fi +set -x +netstat -n -I ppp0 +ifconfig ppp0</programlisting> + + <para>モデム回線を切断します + (<filename>/etc/ppp/kermit.hup</filename>):</para> + + <programlisting> +set line /dev/tty01 ; put your modem device here +set speed 19200 +set file type binary +set file names literal +set win 8 +set rec pack 1024 +set send pack 1024 +set block 3 +set term bytesize 8 +set command bytesize 8 +set flow none + +pau 1 +out +++ +inp 5 OK +out ATH0\13 +echo \13 +exit</programlisting> + + <para>次は <command>kermit</command> の代わりに + <command>chat</command> を使う方法です.</para> + + <para><emphasis>原作: &a.rhuff;.</emphasis></para> + + <para>pppd 接続を確立するためには, + 次の二つのファイルの設定だけで十分です.</para> + + <para><filename>/etc/ppp/options</filename>:</para> + + <programlisting> +/dev/cuaa1 115200 + +crtscts # enable hardware flow control +modem # modem control line +connect "/usr/bin/chat -f /etc/ppp/login.chat.script" +noipdefault # remote PPP server must supply your IP address. + # if the remote host doesn't send your IP during + # IPCP negotiation, remove this option +passive # wait for LCP packets +domain <your.domain> # put your domain name here + +: # put the IP of remote PPP host here + # it will be used to route packets via PPP link + # if you didn't specified the noipdefault option + # change this line to <local_ip>:<remote_ip> + +defaultroute # put this if you want that PPP server will be + # your default router</programlisting> + + <para><filename>/etc/ppp/login.chat.script</filename>:</para> + + <para>(実際には一行になります.)</para> + + <programlisting> +ABORT BUSY ABORT 'NO CARRIER' "" AT OK ATDT<phone.number> + CONNECT "" TIMEOUT 10 ogin:-\\r-ogin: <login-id> + TIMEOUT 5 sword: <password></programlisting> + + <para>正しくインストールし編集した後は, + 必要な事はこれだけです</para> + + <screen>&prompt.root; <userinput>pppd</userinput></screen> + + <para>このサンプルは主に Trev Roydhouse + <Trev.Roydhouse@f401.n711.z3.fidonet.org> + から寄せられた情報に基づいており, + 承諾を得て使用しています.</para> + </sect2> + + <sect2> + <title>PPP サーバとしての動作</title> + + <para><filename>/etc/ppp/options</filename>:</para> + + <programlisting> +crtscts # Hardware flow control +netmask 255.255.255.0 # netmask ( not required ) +192.114.208.20:192.114.208.165 # ip's of local and remote hosts + # local ip must be different from one + # you assigned to the ethernet ( or other ) + # interface on your machine. + # remote IP is ip address that will be + # assigned to the remote machine +domain ppp.foo.com # your domain +passive # wait for LCP +modem # modem line</programlisting> + + <para>下記のような <filename>/etc/ppp/pppserv</filename> + スクリプトで, そのマシンを PPP + サーバにすることができます.</para> + + <programlisting> +#!/bin/sh +ps ax |grep pppd |grep -v grep +pid=`ps ax |grep pppd |grep -v grep|awk '{print $1;}'` +if [ "X${pid}" != "X" ] ; then + echo 'killing pppd, PID=' ${pid} + kill ${pid} +fi +ps ax |grep kermit |grep -v grep +pid=`ps ax |grep kermit |grep -v grep|awk '{print $1;}'` +if [ "X${pid}" != "X" ] ; then + echo 'killing kermit, PID=' ${pid} + kill -9 ${pid} +fi + +# reset ppp interface +ifconfig ppp0 down +ifconfig ppp0 delete + +# enable autoanswer mode +kermit -y /etc/ppp/kermit.ans + +# run ppp +pppd /dev/tty01 19200</programlisting> + + <para>PPP サーバを終了するには, この + <filename>/etc/ppp/pppservdown</filename> スクリプト + を使用します:</para> + + <programlisting> +#!/bin/sh +ps ax |grep pppd |grep -v grep +pid=`ps ax |grep pppd |grep -v grep|awk '{print $1;}'` +if [ "X${pid}" != "X" ] ; then + echo 'killing pppd, PID=' ${pid} + kill ${pid} +fi +ps ax |grep kermit |grep -v grep +pid=`ps ax |grep kermit |grep -v grep|awk '{print $1;}'` +if [ "X${pid}" != "X" ] ; then + echo 'killing kermit, PID=' ${pid} + kill -9 ${pid} +fi +ifconfig ppp0 down +ifconfig ppp0 delete + +kermit -y /etc/ppp/kermit.noans</programlisting> + + <para>下記の kermit スクリプトは, モデムの自動応答機能を有効, + または無効にします + (<filename>/etc/ppp/kermit.ans</filename>):</para> + + <programlisting> +set line /dev/tty01 +set speed 19200 +set file type binary +set file names literal +set win 8 +set rec pack 1024 +set send pack 1024 +set block 3 +set term bytesize 8 +set command bytesize 8 +set flow none + +pau 1 +out +++ +inp 5 OK +out ATH0\13 +inp 5 OK +echo \13 +out ATS0=1\13 ; change this to out ATS0=0\13 if you want to disable + ; autoanswer mode +inp 5 OK +echo \13 +exit</programlisting> + + <para>この <filename>/etc/ppp/kermit.dial</filename> + スクリプトは, リモートホストに ダイヤルし, + 認証手続きをするのに使用します. あなたは必要に応じて, これを + 変更しないといけないでしょう. + あなたのユーザ名とパスワードをこの + スクリプトに書かなければいけませんし, + モデムやリモートホストからの 応答によっては, + 入力待ちの文を変更する必要もあります.</para> + + <programlisting> +; +; put the com line attached to the modem here: +; +set line /dev/tty01 +; +; put the modem speed here: +; +set speed 19200 +set file type binary ; full 8 bit file xfer +set file names literal +set win 8 +set rec pack 1024 +set send pack 1024 +set block 3 +set term bytesize 8 +set command bytesize 8 +set flow none +set modem hayes +set dial hangup off +set carrier auto ; Then SET CARRIER if necessary, +set dial display on ; Then SET DIAL if necessary, +set input echo on +set input timeout proceed +set input case ignore +def \%x 0 ; login prompt counter +goto slhup + +:slcmd ; put the modem in command mode +echo Put the modem in command mode. +clear ; Clear unread characters from input buffer +pause 1 +output +++ ; hayes escape sequence +input 1 OK\13\10 ; wait for OK +if success goto slhup +output \13 +pause 1 +output at\13 +input 1 OK\13\10 +if fail goto slcmd ; if modem doesn't answer OK, try again + +:slhup ; hang up the phone +clear ; Clear unread characters from input buffer +pause 1 +echo Hanging up the phone. +output ath0\13 ; hayes command for on hook +input 2 OK\13\10 +if fail goto slcmd ; if no OK answer, put modem in command mode + +:sldial ; dial the number +pause 1 +echo Dialing. +output atdt9,550311\13\10 ; put phone number here +assign \%x 0 ; zero the time counter + +:look +clear ; Clear unread characters from input buffer +increment \%x ; Count the seconds +input 1 {CONNECT } +if success goto sllogin +reinput 1 {NO CARRIER\13\10} +if success goto sldial +reinput 1 {NO DIALTONE\13\10} +if success goto slnodial +reinput 1 {\255} +if success goto slhup +reinput 1 {\127} +if success goto slhup +if < \%x 60 goto look +else goto slhup + +:sllogin ; login +assign \%x 0 ; zero the time counter +pause 1 +echo Looking for login prompt. + +:slloop +increment \%x ; Count the seconds +clear ; Clear unread characters from input buffer +output \13 +; +; put your expected login prompt here: +; +input 1 {Username: } +if success goto sluid +reinput 1 {\255} +if success goto slhup +reinput 1 {\127} +if success goto slhup +if < \%x 10 goto slloop ; try 10 times to get a login prompt +else goto slhup ; hang up and start again if 10 failures + +:sluid +; +; put your userid here: +; +output ppp-login\13 +input 1 {Password: } +; +; put your password here: +; +output ppp-password\13 +input 1 {Entering SLIP mode.} +echo +quit + +:slnodial +echo \7No dialtone. Check the telephone line!\7 +exit 1 + +; local variables: +; mode: csh +; comment-start: "; " +; comment-start-skip: "; " +; end:</programlisting> + </sect2> + </sect1> + + <sect1 id="slipc"> + <title>SLIPクライアントのセットアップ</title> + + <para><emphasis>原作: &a.asami;<!-- <br> -->8 Aug 1995.</emphasis></para> + + <para><emphasis>訳: &a.hanai;<!-- <br> -->8 August 1996.</emphasis></para> + + <para>ここには FreeBSD + マシンを静的アドレスのネットワークにつなげる場合の + SLIPのセットアップの一つの方法を書いてあります. + ホスト名を動的に割り当てる(つまり, + ダイヤルアップするたびにアドレスが かわる)ためには, + おそらくもっと凝ったことが必要です.</para> + + <para>まず, + モデムがどのシリアルポートにつながっているか決めましょう. 私は + <filename>/dev/cuaa1</filename> から + <filename>/dev/modem</filename>へというシンボリックリンクを張り, + コンフィグレーションではその名前だけを使っています. + <filename>/etc</filename> や<filename>.kermrc</filename> + など, システム全体に散らばっているファイルを修正する + 必要がでるとまったく煩わしいのです!</para> + + <note> + <para>ここで, <filename>/dev/cuaa0</filename>は + <devicename>COM1</devicename>であり, + <filename>cuaa1</filename>は<devicename>COM2</devicename>です.</para> + </note> + + <para>カーネルのコンフィグレーションファイルに + + <programlisting> +pseudo-device sl 1</programlisting> + + という記述があるのを確認してください. + これは <filename>GENERIC</filename> カーネルに含まれている + ので削除していない限り大丈夫でしょう.</para> + + <sect2> + <title>最初の設定</title> + + <procedure> + <step> + <para><filename>/etc/hosts</filename> + ファイルにあなたのマシンのゲートウェイとネームサーバ + を加えてください. 私のは以下のようになっています.</para> + + <programlisting> +127.0.0.1 localhost loghost +136.152.64.181 silvia.HIP.Berkeley.EDU silvia.HIP silvia + +136.152.64.1 inr-3.Berkeley.EDU inr-3 slip-gateway +128.32.136.9 ns1.Berkeley.edu ns1 +128.32.136.12 ns2.Berkeley.edu ns2</programlisting> + + <para>余談ですが, + silviaというのは私が日本にいた時に持っていた + 車の名前です(米国では2?0SXと呼ばれています).</para> + </step> + + <step> + <para><filename>/etc/host.conf</filename> ファイル中で + <option>hosts</option>が<option>bind</option> + よりも前にあること を確認してください. + さもないとヘンなことが起こるかもしれません.</para> + </step> + + <step> + <para><filename>/etc/rc.conf</filename> + ファイルを編集してください. なお, お使いの FreeBSD が + 2.2.2 よりも前のバージョンのものの場合は, + <filename>/etc/sysconfig</filename> + を編集してください.</para> + + <orderedlist> + <listitem> + <para>行</para> + + <programlisting> +hostname=myname.my.domain</programlisting> + + <para>を編集してホスト名をセットしてください. + 完全なInternetホスト名を与えるべきです.</para> + </listitem> + + <listitem> + <para>行</para> + + <programlisting> +network_interfaces="lo0"</programlisting> + + <para>を</para> + + <programlisting> +network_interfaces="lo0 sl0"</programlisting> + + <para>へ変更することにより + ネットワークインタフェースのリストに sl0 + を加えてください.</para> + </listitem> + + <listitem> + <para>行</para> + + <programlisting> +ifconfig_sl0="inet ${hostname} slip-gateway netmask 0xffffff00 up"</programlisting> + + <para>を加えて sl0 + のスタートアップフラグをセットしてください.</para> + </listitem> + + <listitem> + <para>行</para> + + <programlisting> +defaultrouter=NO</programlisting> + + <para>を</para> + + <programlisting> +defaultrouter=slip-gateway</programlisting> + + <para>へ変更してデフォルトのルータを + 指定してください.</para> + </listitem> + </orderedlist> + </step> + + <step> + <para>次の</para> + + <programlisting> +domain HIP.Berkeley.EDU +nameserver 128.32.136.9 +nameserver 128.32.136.12</programlisting> + + <para>という内容を含むファイル + <filename>/etc/resolv.conf</filename> を作ってください. + 見ればわかるように, + これらはネームサーバホストを設定しています. もちろん, + 実際のドメイン名やアドレスは + あなたの環境に依存します.</para> + </step> + + <step> + <para>root と toor + (及びパスワードを持っていない他のアカウントすべて) + のパスワード を設定してください. + passwdコマンドを使いましょう. + <filename>/etc/passwd</filename> や + <filename>/etc/master.passwd</filename> + といったファイルを編集してはいけません!</para> + </step> + + <step> + <para>マシンを再起動して正しいホスト名で + 立ち上がることを確認してください.</para> + </step> + </procedure> + </sect2> + + <sect2> + <title>SLIP接続をおこなう</title> + + <procedure> + <step> + <para>モデムを起動, つながったらプロンプトで + <command>slip</command>とタイプし, マシン名と + パスワードを入力してください. + 入力する必要があるものは環境に よって異なります. + 私は次のようなスクリプトでkermitを使っています.</para> + + <programlisting> +# kermit setup +set modem hayes +set line /dev/modem +set speed 115200 +set parity none +set flow rts/cts +set terminal bytesize 8 +set file type binary +# The next macro will dial up and login +define slip dial 643-9600, input 10 =>, if failure stop, - +output slip\x0d, input 10 Username:, if failure stop, - +output silvia\x0d, input 10 Password:, if failure stop, - +output ***\x0d, echo \x0aCONNECTED\x0a</programlisting> + + <para>(もちろん, + ホスト名とパスワードは変える必要があります). + 接続するためには kermit のプロンプトで + <command>slip</command>とタイプするだけです.</para> + + <note> + <para>ファイルシステムのどんなところにもプレインテキスト + にパスワードを書いておくのは一般的にはよくありません. + 覚悟の上で やってください. + 私は単に不精なだけです.</para> + </note> + </step> + + <step> + <para>ここでkermitから抜け出し + (<command>z</command>でkermitをサスペンドできます), root + で</para> + + <screen>&prompt.root; <userinput>slattach -h -c -s 115200 /dev/modem</userinput></screen> + + <para>と入力しましょう. もしルータの向う側のホストへ + <command>ping</command> できるなら接続成功です! もしうまく + いかなければslattachへの引数として <option>-c</option> + の代わりに<option>-a</option>とやってみてください.</para> + </step> + </procedure> + </sect2> + + <sect2> + <title>接続の切り方</title> + + <para>slattachを殺すためにrootで + + <screen>&prompt.root; <userinput>kill -INT `cat /var/run/slattach.modem.pid`</userinput></screen> + + とタイプしてください. そして kermit に戻り + (もしkermitをサスペンドしていたなら + <command>fg</command>), kermitから抜けてください + (<command>q</command>).</para> + + <para>slattachのマニュアルページにはインタフェースを落すために + <command>ifconfig sl0 + down</command>をしなければいけないと書いていますが, + 私には差がないように見えます. (<command>ifconfig + sl0</command>とやっても同じ結果が得られる.)</para> + + <para>時にはモデムがキャリアを落すのを + 拒絶するかもしれません(私のは よくそうなります). + その時は単にkermitをスタートしてまた終了 してください. + 普通は2回目で落ちます.</para> + </sect2> + + <sect2> + <title>トラブルシューティング</title> + + <para>もし動かなければ自由に私に質問してください. + 今までいろんな人がつまずいた のは次のようなことです.</para> + + <itemizedlist> + <listitem> + <para>slattach で <option>-c</option> や <option>-a</option> + を使わなかった(私はなぜこれが致命的になり得るのか + わかりませんが, このフラグを付けることで少なくとも一人の + 問題は解決しました.)</para> + </listitem> + + <listitem> + <para><option>sl0</option> の代わりに <option>s10</option> + を使った(いくつかのフォントでは見分けるのは難しい + かもしれません).</para> + </listitem> + + <listitem> + <para>インタフェースの状態を見るために <command>ifconfig + sl0</command> をやってみてください. 私は,</para> + + <screen>&prompt.root; <userinput>ifconfig sl0</userinput> +sl0: flags=10<POINTOPOINT> + inet 136.152.64.181 --> 136.152.64.1 netmask ffffff00</screen> + + <para>となります.</para> + </listitem> + + <listitem> + <para>また, pingが "no route to host" + というメッセージを返す時には <command>netstat + -r</command>でルーティングテーブルを確認しましょう. + 私のは,</para> + + <screen>&prompt.root; <userinput>netstat -r</userinput> +Routing tables +Destination Gateway Flags Refs Use IfaceMTU Rtt +Netmasks: +(root node) +(root node) + +Route Tree for Protocol Family inet: +(root node) => +default inr-3.Berkeley.EDU UG 8 224515 sl0 - - +localhost.Berkel localhost.Berkeley UH 5 42127 lo0 - 0.438 +inr-3.Berkeley.E silvia.HIP.Berkele UH 1 0 sl0 - - +silvia.HIP.Berke localhost.Berkeley UGH 34 47641234 lo0 - 0.438 +(root node)</screen> + + <para>となります. + (これはたくさんのファイルを転送した後でのもので, + あなたの見る数字はもっと小さいかも + しれません).</para> + </listitem> + </itemizedlist> + </sect2> + </sect1> + + <sect1 id="slips"> + <title>SLIPサーバのセットアップ方法</title> + + <para><emphasis>原作: &a.ghelmer;.<!-- <br> --> + v1.0, 15 May 1995.</emphasis></para> + + <para><emphasis>訳: &a.jp.ts;.<!-- <br> --> + 6 September 1996.</emphasis></para> + + <para>この文書の目的は, SLIPサーバ機能を + FreeBSDシステムのもとで設定するため の助言を提供することです. + SLIPサーバ機能を設定するということは, リモー トの + SLIPクライアントがログインできるようにするために, 自動的に接続処 + 理をおこなうようにすることです. + この文書は著者の経験に基づいておりますが, + 実際のシステム構成や要望は異なりますから, + すべての疑問にこの文書が答え ることはできません. なお, + ここでの助言を試みた結果, あなたのシステムへ + の悪影響やデータの損失が生じたとしても, + 著者が責任を持つことはできませ + んのでご了解をお願いします.</para> + + <para>当初この文書は, FreeBSD 1.xシステムでの + SLIPサーバ機能のために書きまし た. その後, FreeBSD + 2.xの初期バージョンでのパス名の変更や SLIPインタフェー + ス向け圧縮フラグの削除といった変更点を反映するために, + 書き換えをおこないま した. これらが + FreeBSDのバージョン間の主要な変更点だったからです. もし + この文書の間違いを見つけられましたら, ぜひ, + 訂正に十分な情報とともに電 + 子メールでお知らせいただければ助かります.</para> + + <sect2 id="slips-prereqs"> + <title>前提</title> + + <para>この文書の内容はテクニカルなものなので, + 前提知識が必要です. すなわち, + TCP/IPネットワークプロトコルについての知識, 特に, + ネットワークとノード のアドレス指定をはじめ, + ネットワークアドレスマスク, サブネット化, ルー ティング, + および RIPなどのルーティングプロトコルなどに関する知識を前提 + としています. ダイヤルアップサーバで + SLIP機能を設定するためには, これ + らの概念についての知識が必要ですから, + もし不案内であると思われる方は, O'Reilly & Associates, + Inc.から出版されている Craig Hunt氏の <emphasis>TCP/IP + Network Administration</emphasis> (ISBN 0-937175-82-X)か, + または Douglas Comer氏の + TCP/IPプロトコルに関する一連の書籍をお読みください.</para> + + <para>前提知識に加え, さらに, モデムの設定が完了しており, + そのモデムを経由し てログインできるように, + システムファイル群が適切に記述できているものと 仮定しています. + もしモデムの準備ができていないときには, あらかじめダイヤ + ルアップ機能の設定についてのチュートリアルをお読みください. + Webブラ ウザが使えるのであれば <ulink + url="http://www.freebsd.org/"> http://www.freebsd.org/ + </ulink> におけるチュー トリアルの一覧を調べてください. + あるいは, この文書を見つけた場所を調べ て, + <filename>dialup.txt</filename> + やそれに類似した名前の文書をお読みください. 関連す + るマニュアルページとしては, + シリアルポート向けデバイスドライバについて + の &man.sio.4; をはじめ, モデムからのログインを + 受理できるようにシステ + ムを設定するための &man.ttys.5;, &man.gettytab.5;, &man.getty.8;, + &man.init.8; など, さらには, シリアルポート関連パラメタ ( たと + えば直接接続シリアルインタフェースの + <literal>clocal</literal> ) についての + &man.stty.1; なども助けになるかもしれません.</para> + </sect2> + + <sect2> + <title>概要</title> + + <para>一般的な設定内容で FreeBSDを SLIPサーバとして利用すると, + その動作は次 のようになります. まず, SLIPユーザが FreeBSD + による SLIPサーバへ電話し て, SLIP専用IDでログインします. + なお, このIDを持ったユーザはシェルとし て + <filename>/usr/sbin/sliplogin</filename> を使います. この + <command>sliplogin</command> は, ファ イル + <filename>/etc/sliphome/slip.hosts</filename> の中から, + ログインIDと一致する 記述行を探します. もし一致する行があれば, + ログインしたシリアル回線を, 利用可能な + SLIPインタフェースへ接続し, その後にシェルスクリプト + <filename>/etc/sliphome/slip.login</filename> で + SLIPインタフェースを設定します.</para> + + <sect3> + <title>SLIPサーバへのログイン例</title> + + <para>仮に SLIPユーザIDが <username>Shelmerg</username> + とします. すると, <filename>/etc/master.passwd</filename> + における <username>Shelmerg</username> のエントリは次のよ + うなものになります (実際には一つの行に続いている) .</para> + + <programlisting> +Shelmerg:password:1964:89::0:0:Guy Helmer - SLIP:/usr/users/Shelmerg:/usr/sbin/sliplogin</programlisting> + + <para><username>Shelmerg</username> がログインすると, + <command>sliplogin</command> は, ファイル + <filename>/etc/sliphome/slip.hosts</filename> + からユーザIDと一致する行を探しま す. いま仮に, + <filename>/etc/sliphome/slip.hosts</filename> + に次のような記述がなさ れていたとします.</para> + + <programlisting> +Shelmerg dc-slip sl-helmer 0xfffffc00 autocomp</programlisting> + + <para><command>sliplogin</command> + が上記のエントリを見つけると, <emphasis + remap=tt>Shelmerg</emphasis> が使用して + いるシリアル回線を, 利用可能な + SLIPインタフェースのなかの最初のものへ 接続し, 次の内容の + <filename>/etc/sliphome/slip.login</filename> + を実行します.</para> + + <programlisting> +/etc/sliphome/slip.login 0 19200 Shelmerg dc-slip sl-helmer 0xfffffc00 autocomp</programlisting> + + <para>もし上記の手順が正常に処理されると, + <filename>/etc/sliphome/slip.login</filename> は, + <command>sliplogin</command> が割り当てた SLIPインタフェース + (この例では <filename>slip.login</filename> + で与えられたパラメタのうちで最初の値である SLIP + インタフェース0である) に対して <command>ifconfig</command> + を実行し, ローカル IPアドレス + (<hostid>dc-slip</hostid>)をはじめ, リモート IPアドレス + (<hostid>sl-helmer</hostid>), + SLIPインタフェースへのネットワークマスク (<hostid + role="netmask">0xfffffc00</hostid>), およびその他のフラグ + (<literal>autocomp</literal>)を設定 します. 逆に, + さきほどの手順が正常に終了しなかった場合, 通常は + <command>sliplogin</command> は十分な情報を syslog の + <literal>daemon</literal> 機能経由で <!-- kuriyama - + facility? --> + <filename>/var/log/messages</filename> へ記録します + ( &man.syslogd.8; や + &man.syslog.conf.5; のマニュアルページを参照のうえ, さらに + <filename>/etc/syslog.conf</filename> を調べて + <command>syslogd</command> がどのファイルへ記 + 録するかを確認のこと) .</para> + + <para>例はこのくらいにして, + さっそくシステムのセットアップを始めてみましょう.</para> + </sect3> + </sect2> + + <sect2> + <title>カーネルのコンフィグレーション</title> + + <para>FreeBSD のデフォルトのカーネルには, 通常, 二つの + SLIPインタフェースが 準備されています + (<devicename>sl0</devicename> と <devicename>sl1</devicename>) + . これらのインタフェー + スが使用中のカーネルに準備されているかどうかを調べるには, + <command>netstat -i</command> を実行してください.</para> + + <para><command>netstat -i</command> の出力例</para> + + <screen>Name Mtu Network Address Ipkts Ierrs Opkts Oerrs Coll +ed0 1500 <Link>0.0.c0.2c.5f.4a 291311 0 174209 0 133 +ed0 1500 138.247.224 ivory 291311 0 174209 0 133 +lo0 65535 <Link> 79 0 79 0 0 +lo0 65535 loop localhost 79 0 79 0 0 +sl0* 296 <Link> 0 0 0 0 0 +sl1* 296 <Link> 0 0 0 0 0</screen> + + <para><command>netstat -i</command> の出力に + <devicename>sl0</devicename> と <devicename>sl1</devicename> + のインタフェー スが含まれているということから, + カーネルには二つの SLIPインタフェー + スが組み込まれているということを示しています. + (<literal>sl0</literal> と <literal>sl1</literal> + に付いたアスタリスクは, <command>netstat -i</command> + の実行時点で はインタフェースが “ダウン” + していることを表しています. )</para> + + <para>なお, パケットのフォワード機能は FreeBSD + のデフォルトのカーネルでは設定 されていません + (すなわちルータとしては動作しない) . もしインターネット + 接続ホストについての RFC要件 ( RFC 1009 [Requirements for + Internet Gateways] と 1122 [Requirements for Internet Hosts + — Communication Layers], おそらく 1127 [A Perspective on + the Host Requirements RFCs] も ) に準拠して, FreeBSDによる + SLIPサー バをルータとして動作させたいときには, + <filename>/etc/rc.conf</filename> (バージョ ン 2.2.2 より前の + FreeBSD では <filename>/etc/sysconfig</filename>) ファイル の + <literal>gateway</literal> 変数を <option>YES</option> + としてください. もし古いシステ ムで + <filename>/etc/sysconfig</filename> ファイルすらないときには, + 次のコマン ドを <filename>/etc/rc.local</filename> + へ追加してください.</para> + + <programlisting> +sysctl -w net.inet.ip.forwarding = 1</programlisting> + + <para>この新しい設定を有効とするには, + リブートする必要があります.</para> + + <para>デフォルトのカーネルコンフィグレーションファイル + (<filename>/sys/i386/conf/GENERIC</filename>) の最後の部分に, + 次のような行がありま す.</para> + + <programlisting> +pseudo-device sl 2</programlisting> + + <para>この行によって, 使用可能な SLIPデバイスの総数が決まります. + すなわち, 行 末の数値が, 同時に動作可能な + SLIP接続の最大数となります.</para> + + <para>カーネルの再構築については, <link + linkend="kernelconfig">FreeBSDカー + ネルのコンフィグレーション</link> を参照ください.</para> + </sect2> + + <sect2> + <title>Sliploginのコンフィグレーション</title> + + <para>すでにご説明したように, + <filename>/usr/sbin/sliplogin</filename> のコンフィグレー + ションのために, + 3種類のファイルが<filename>/etc/sliphome</filename> + ディレクトリに あります (<command>sliplogin</command> + についての実際のマニュアルページとしては + &man.sliplogin.8; を参照のこと) . + ファイル <filename>slip.hosts</filename> は + SLIPユーザおよびその IPアドレスを決めます. 通常, ファイル + <filename>slip.login</filename> は, + SLIPインタフェースを設定することだけに使 + 用します. <filename>slip.logout</filename> + はオプションのファイルで, + <filename>slip.login</filename> で設定した内容を, + シリアル接続が終了した時点で解除 + するときに使用します.</para> + + <sect3> + <title><filename>slip.hosts</filename> + のコンフィグレーション</title> + + <para><filename>/etc/sliphome/slip.hosts</filename> には, + 少なくとも 4 つの項目をホワイ トスペース (スペースやタブ) + で区切って指定します.</para> + + <itemizedlist> + <listitem> + <para>SLIPユーザのログインID</para> + </listitem> + + <listitem> + <para>SLIPリンクのローカル (SLIPサーバ側) アドレス</para> + </listitem> + + <listitem> + <para>SLIPリンクのリモートアドレス</para> + </listitem> + + <listitem> + <para>ネットワークマスク</para> + </listitem> + </itemizedlist> + + <para>ホスト名をローカルおよびリモートのアドレスとして + 記述できます (IPアドレ スの決定は, + <filename>/etc/host.conf</filename> の指定内容に応じて, + <filename>/etc/hosts</filename> か + DNSのいずれかによって決定される) . また, ネット + ワークマスクも <filename>/etc/networks</filename> + ファイルに記述された名前を参照す ることで, + 指定することもできると思います. これまでの例としてあげたシス + テムでの <filename>/etc/sliphome/slip.hosts</filename> + は次のようになります.</para> + + <programlisting> +# +# login local-addr remote-addr mask opt1 opt2 +# (normal,compress,noicmp) +# +Shelmerg dc-slip sl-helmerg 0xfffffc00 autocomp</programlisting> + + <para>それぞれの行の最後には, + 次に示すオプションを一つ以上指定できます.</para> + + <itemizedlist> + <listitem> + <para><option>normal</option> — ヘッダを圧縮しない</para> + </listitem> + + <listitem> + <para><option>compress</option> — ヘッダを圧縮する</para> + </listitem> + + <listitem> + <para><option>autocomp</option> — + リモートの設定に応じて, ヘッダを圧縮する</para> + </listitem> + + <listitem> + <para><option>noicmp</option> — + ICMPパケットを禁止する + (“ping”パケットは送出されず, + バンド幅を占有しない)</para> + </listitem> + </itemizedlist> + + <para>なお, FreeBSDバージョン2の初期リリースの + <command>sliplogin</command> は, 旧 FreeBSD + 1.xでは有効であった上記のオプションを無視していましたので, + <option>normal</option>, <option>compress</option>, + <option>autocomp</option>, そして <option>noicmp</option> + などのオ プションは FreeBSD + 2.2でサポートされるまでは効果がありませんでした (た + だしこれらのフラグを使うためには + <filename>slip.login</filename> スクリプトへ記述する + 必要がある) .</para> + + <para>SLIPリンクでのローカルとリモート向けのアドレスの + 選び方は, TCP/IPサブネッ トを専用に割り当てるか, + または“プロキシ ARP”を + SLIPサーバへ用いるかによっ て違います (プロキシ + ARPという用語のここでの使い方は本来のものではない が, + 説明のためにこの用語を使う) . もし, + どちらの方式を選ぶべきか判らな かったり, + IPアドレスの割り当て方が不明のときには, 上述の <link + linkend="slips-prereqs">前提</link> の節で紹介した + TCP/IP関連書籍を参考になさるか, またはあなたの + IPネットワークを管理している方に相談なさると + よいでしょう.</para> + + <para>独立したサブネットを SLIPクライアントへ適用するときには, + すでに割り当 てられている + IPネットワーク番号の範囲からサブネット番号を割り当て, 同 + 時にそのサブネットの範囲内で有効な IPアドレスを + SLIPクライアントの IP 番号として割り当てる必要があります. + さらに, この SLIPサブネットから SLIPサーバを経由して最も近い + IPルータへの経路を静的に設定するか, また は + <command>gated</command> を FreeBSDによる + SLIPサーバへインストールして, 適当 + なルーティングプロトコルを使って, + SLIPサーバ経由のサブネットへの経路情 + 報をルータ群へ通知できるように設定するか, + のいずれかをおこなう必要がありま す.</para> + + <para>“プロキシ ARP” 方式を採用するときには, + SLIPクライアント向けの IPアドレス + として, SLIPサーバのサブネットの範囲から + 選んで割り当てるとともに, + &man.arp.8; コマンドを使うために + <filename>/etc/sliphome/slip.login</filename> + と<filename>/etc/sliphome/slip.logout</filename> + のスクリプトを修正して, SLIPサー + バにおける ARPテーブル内のプロキシ ARPエントリへ + 反映させる必要がありま + す.</para> + </sect3> + + <sect3> + <title><filename>slip.login</filename> + のコンフィグレーション</title> + + <para>ファイル <filename>/etc/sliphome/slip.login</filename> + の一般的な内容は次にように なります.</para> + + <programlisting> +#!/bin/sh - +# +# @(#)slip.login 5.1 (Berkeley) 7/1/90 + +# +# generic login file for a slip line. sliplogin invokes this with +# the parameters: +# 1 2 3 4 5 6 7-n +# slipunit ttyspeed loginname local-addr remote-addr mask opt-args +# +/sbin/ifconfig sl$1 inet $4 $5 netmask $6</programlisting> + + <para>この <filename>slip.login</filename> + ファイルの役目は単に, SLIPインタフェースにつ + いてのローカルとリモートのアドレス, + およびそのネットワークマスクを <command>ifconfig</command> + コマンドで設定することです.</para> + + <para>もし“プロキシ ARP”方式を採用する + (SLIPクライアントへ独立したサブネットを 使わない) ときには, + ファイル <filename>/etc/sliphome/slip.login</filename> + は次の ような内容になります.</para> + + <programlisting> +#!/bin/sh - +# +# @(#)slip.login 5.1 (Berkeley) 7/1/90 + +# +# generic login file for a slip line. sliplogin invokes this with +# the parameters: +# 1 2 3 4 5 6 7-n +# slipunit ttyspeed loginname local-addr remote-addr mask opt-args +# +/sbin/ifconfig sl$1 inet $4 $5 netmask $6 +# Answer ARP requests for the SLIP client with our Ethernet addr +/usr/sbin/arp -s $5 00:11:22:33:44:55 pub</programlisting> + + <para>この <filename>slip.login</filename> で追加された行 + <command>arp -s $5 00:11:22:33:44:55 pub</command> は, + SLIPサーバにおける ARPテーブルへ新たなエントリを作ります. + SLIPサーバ は, この ARPエントリが作られると, + SLIPクライアントの IPアドレスと話し たい他の + IPノードが要求してきたときにはいつも, SLIPサーバ の Ethernet + MACアドレスを返すようになります.</para> + + <para>上記の例を実際に流用なさるときには, 例にある Ethernet + MACアドレス (<hostid role="mac">00:11:22:33:44:55</hostid>) + を, あなたのシステムの実際のEthernetカー ドの + MACアドレスと置き換えなければ“プロキシ + ARP”はうまく動作しません! SLIPサーバの Ethernet + MACアドレスを調べるには <command>netstat -i</command> コマ + ンドを利用してください. + 実行結果の第2行は次のようなものになるはずです.</para> + + <screen>ed0 1500 <Link>0.2.c1.28.5f.4a 191923 0 129457 0 116</screen> + + <para>この例での Ethernet MACアドレスは + <hostid role="mac">00:02:c1:28:5f:4a</hostid> であると + 読みます. なお &man.arp.8; における MAC + アドレスの指定に際しては, + コマンド <command>netstat -i</command> が付けた + Ethernet MACアドレスのピリオド記 + 号をコロン記号と置き換え, かつ単一桁の 16 + 進数にはゼロを先頭に加える必 + 要があります. この指定についての正確な情報は &man.arp.8; + を参照く + ださい.</para> + + <note> + <para><filename>/etc/sliphome/slip.login</filename> と + <filename>/etc/sliphome/slip.logout</filename> + を作成したならば, ファイル属性の“実行”ビット + (すなわち <command>chmod 755 /etc/sliphome/slip.login + /etc/sliphome/slip.logout</command>) を + 設定しなければなりません. さもなければ + <command>sliplogin</command> が + うまく実行されません.</para> + </note> + </sect3> + + <sect3> + <title><filename>slip.logout</filename> + のコンフィグレーション</title> + + <para>ファイル <filename>/etc/sliphome/slip.logout</filename> + は必ずしも必要なものではあ りません (ただし“プロキシ + ARP”を利用する場合を除く) . もしこのファイルを + 作成するときには, 次に示す標準的な + <filename>slip.logout</filename> スクリプト例を + 参考にしてください.</para> + + <programlisting> +#!/bin/sh - +# +# slip.logout + +# +# logout file for a slip line. sliplogin invokes this with +# the parameters: +# 1 2 3 4 5 6 7-n +# slipunit ttyspeed loginname local-addr remote-addr mask opt-args +# +/sbin/ifconfig sl$1 down</programlisting> + + <para>“プロキシ ARP”を利用する場合, この + <filename>/etc/sliphome/slip.logout</filename> を 使って, + 特定の SLIPクライアント向けの + ARPエントリを削除したくなるよう なときがあります.</para> + + <programlisting> +#!/bin/sh - +# +# @(#)slip.logout + +# +# logout file for a slip line. sliplogin invokes this with +# the parameters: +# 1 2 3 4 5 6 7-n +# slipunit ttyspeed loginname local-addr remote-addr mask opt-args +# +/sbin/ifconfig sl$1 down +# Quit answering ARP requests for the SLIP client +/usr/sbin/arp -d $5</programlisting> + + <para>コマンド <command>arp -d $5</command> は, + SLIPクライアントがログインした 際に, “プロキシ + ARP”を使った <filename>slip.login</filename> + によって追加され た ARPエントリを削除します.</para> + + <para>これによって, 繰り返して利用することができるわけです. + 必ず, <filename>/etc/sliphome/slip.logout</filename> + を作成した後に, 実行ビットを設定し てください ( + <command>chmod 755 /etc/sliphome/slip.logout</command> ) + .</para> + </sect3> + </sect2> + + <sect2> + <title>ルーティングについての考慮点</title> + + <para>“プロキシ ARP”方式を利用せずに + SLIPクライアントとその他のネットワーク (Internetも含む) + の構成要素との間でパケットをルーティングするときには, + SLIPサーバ経由で + SLIPクライアントが属するサブネットまでの経路を, 最も + 近いデフォルトのルータ群へ静的な経路情報として + 追加しなければならないか, または <command>gated</command> を + FreeBSDによる SLIPサーバへインストールして, SLIP + サブネットについての経路情報を, + 適当なルーティングプロトコルでルー + タ群へ通知できるように設定するか, + のどちらかをおこなわなければなりません.</para> + + <sect3> + <title>静的な経路</title> + + <para>静的な経路を最も近いデフォルトの + ルータ群へ追加することが困難なことがあ ります + (経路情報を追加できる権限がなければそもそも不可能となる). + もし あなたの組織に複数のルータで構成された + ネットワークがあるならば, ある種 のルータ (たとえば Ciscoや + Proteonなど) は, 静的な経路を SLIPサブネッ + トへ使うようにルータを設定しなければならないだけでなく, + その静的経路を 他のどのルータへ知らせるのかもあらかじめ + 指定しておく必要がありますから, + 静的経路に基づくルーティングを軌道に乗せるには + それなりの専門的技術やト + ラブルシューティングやコツが必要だと思います.</para> + </sect3> + + <sect3> + <title><command>gated</command>の稼働</title> + + <para>静的経路についての頭痛への代替手段は, + <command>gated</command> を FreeBSDによる SLIPサー + バへインストールして, 適切なルーティングプロトコル + (RIP/OSPF/BGP/EGP) を使って + SLIPサブネットについての経路情報を他のルータへ知らせるように + 設定することです. <link linkend="ports">ports + コレクション</link>から <command>gated</command> + を用いることもできますし, <ulink + URL="ftp://ftp.gated.merit.edu/research.and.development/gated/"> + the GateD 匿名 FTP サイト</ulink> + から探して自分自身で構築することもで きます. + この文章を執筆時点の最新バージョンは + <filename>gated-R3_5Alpha_8.tar.Z</filename> であり, + このファイルだけで FreeBSDで 動作させることができます. + <command>gated</command> についてのすべての情報と文書 は + <ulink URL="http://www.gated.merit.edu/"> + Merit GateD コンソーシアム</ulink> からはじまる Web + 上で入手でき ます. <command>gated</command> + のコンパイルとインストールを行ったならば, + 独自の 設定のために <filename>/etc/gated.conf</filename> + ファイルを記述してください. 次の 例は, + 筆者が FreeBSDによる SLIP + サーバで使っている内容と類似のものです.</para> + + <programlisting> +# +# gated configuration file for dc.dsu.edu; for gated version 3.5alpha5 +# Only broadcast RIP information for xxx.xxx.yy out the ed Ethernet interface +# +# +# tracing options +# +traceoptions "/var/tmp/gated.output" replace size 100k files 2 general ; + +rip yes { + interface sl noripout noripin ; + interface ed ripin ripout version 1 ; + traceoptions route ; +} ; + +# +# Turn on a bunch of tracing info for the interface to the kernel: +kernel { + traceoptions remnants request routes info interface ; +} ; + +# +# Propagate the route to xxx.xxx.yy out the Ethernet interface via RIP +# + +export proto rip interface ed { + proto direct { + <replaceable>xxx.xxx.yy</replaceable> mask 255.255.252.0 metric 1; # SLIP connections + } ; +} ; + +# +# Accept routes from RIP via ed Ethernet interfaces + +import proto rip interface ed { + all ; +} ;</programlisting> + + <para>この <filename>gated.conf</filename> ファイルの例では, + SLIPのサブネット <replaceable>xxx.xxx.yy</replaceable> + についての経路情報を RIPを使って Ethernetへブロー + ドキャストしています. もし <devicename>ed</devicename> + ドライバ以外の Ethernetドライバを使 うのであれば, + <devicename>ed</devicename> + インタフェースの記述を適切なものに置き換えてくだ さい. + またこの例では, + <command>gated</command>の動作をデバッグするために, + <filename>/var/tmp/gated.output</filename> + へトレース情報を出力するように指示して います. + <command>gated</command> が希望通りに動作したならば, + このトレースオプショ ンを止めることができます. なお, + 例における <replaceable>xxx.xxx.yy</replaceable> を, あ + なた自身の + SLIPサブネットのネットワークアドレスに換えてください (また + <literal>proto direct</literal> + 部分のネットワークマスクも換えることを忘れないこ と) + .</para> + + <para><command>gated</command> + のコンパイルとインストールが終了し, コンフィグレーショ + ンファイルの作成も完了したら, + FreeBSDシステムではデフォルトの + <command>routed</command>に代わって <command>gated</command> + を起動してください. そのため には, + <filename>/etc/netstart</filename> の + <filename>routed/gated</filename> 起動パラメタを + 適切な値に設定してください. <command>gated</command> + のコマンドラインパラメタにつ いての情報は, + <command>gated</command> + のマニュアルページを参照してください.</para> + </sect3> + </sect2> + + <sect2> + <title>謝辞</title> + + <para>このチュートリアルについての + コメントやアドバイスを寄せてくれた次の方々 + に感謝します.</para> + + <variablelist> + <varlistentry><term>&a.wilko;</term> + <listitem> + <para></para> + </listitem> + </varlistentry> + + <varlistentry><term>Piero Serini</term> + <listitem> + <para><email>Piero@Strider.Inet.IT</email></para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/printing/chapter.sgml b/ja_JP.eucJP/books/handbook/printing/chapter.sgml new file mode 100644 index 0000000000..791d4d4e90 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/printing/chapter.sgml @@ -0,0 +1,5407 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.12 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:58 kuriyama Exp $ +--> + +<chapter id="printing"> + <title>プリンタの利用</title> + + <para><emphasis>著者 &a.kelly;<!-- <br> --> + 30 September 1995</emphasis></para> + + <para><emphasis>訳者 &a.jp.kimura;.<!-- <br> --> + 3 September 1996</emphasis></para> + + <para>FreeBSD でプリンタを使用するためには, バークレイラインプリンタ + スプーリングシステム (LPDスプーリングシステムとしても知られて + います) が機能するようにプリンタをセットアップする必要がありま す. + 本節では, LPDスプーリングシステム (大抵の場合, 単にLPDと呼 ばれる) + について紹介します.</para> + + <para>もし, LPDや他のプリンタスプーリングシステムについて既に詳しい + 知識をお持ちの方は, 「<link linkend="printing-intro-setup"> + スプーリングシステムのセットアップ</link>」から読み始めて + も結構です.</para> + + <sect1 id="printing-intro-spooler"> + <title>スプーラは何をするか</title> + + <para>LPDはあるホストのプリンタに関する制御の一切をおこないます. + こ こで言う制御としては, 次のことが挙げられます.</para> + + <itemizedlist> + <listitem> + <para>ホストに接続されたプリンタ, あるいはネットワーク + 上の他ホストに接続されたプリンタに対するアクセスを制御しま + す.</para> + </listitem> + + <listitem> + <para>ファイルをプリントする要求に対して許可を与えます. + この要求は特に <emphasis>ジョブ</emphasis> + と呼ばれています.</para> + </listitem> + + <listitem> + <para>各々のプリンタの <emphasis>キュー</emphasis> + を管理することにより, + 複数のユーザがあるプリンタに対して同時にアクセスすることを + 防ぎます.</para> + </listitem> + + <listitem> + <para><emphasis>ヘッダページ</emphasis> + (<emphasis>バナー</emphasis> または + <emphasis>バースト</emphasis> ページとしても知られています) + をプリントすることができます. これにより, + プリントアウトの山の中から自分がプリントしたジョ + ブを見つけ易くなります.</para> + </listitem> + + <listitem> + <para>シリアルポートに接続したプリンタ用に通信パラ + メータを管理します.</para> + </listitem> + + <listitem> + <para>ネットワーク経由で他のホスト上の, 別のLPDスプーラにジョ + ブを送ることができます.</para> + </listitem> + + <listitem> + <para>様々なプリンタ言語やプリンタの能力に応じてジョブの + 形式を整えるため, + 特別なフィルタを起動することができます.</para> + </listitem> + + <listitem> + <para>プリンタの使用に対して + 課金をおこなうことができます.</para> + </listitem> + </itemizedlist> + + <para>設定ファイルを通して, また, 特別なフィルタプログラムを供給 + することにより, 多種多様なプリンタ機器に対して, 上述の機能の + 全部または一部をLPDシステムにおこなわせることができます.</para> + </sect1> + + <sect1 id="printing-intro-why"> + <title>どうしてスプーラを使うべきなのか</title> + + <para>あなたのシステムを利用するのがあなた一人だけだとしたら, ア + クセス制御もヘッダページも + プリンタ利用に対する課金も必要ないのに, + なぜわざわざスプーラに煩わされなければならないのか疑問に思うか + もしれません. + プリンタに対する直接アクセスを許可することもできるので すが, + とにかくスプーラを使用するべきです. その理由は,</para> + + <itemizedlist> + <listitem> + <para>LPDはジョブをバックグラウンドで処理します. データが + プリンタに送信されるまで待つ必要はありません.</para> + </listitem> + + <listitem> + <para>LPDではジョブをフィルタを通してプリントすることが簡 + 単にできます. これにより, 印刷物のヘッダに時刻や日付を入れ + たり, 特別なファイル形式 (TeX の DVI ファイルなど) をプリン + タが処理できる形式に変更することができます. これらの作業を + 手動でおこなう必要がなくなります.</para> + </listitem> + + <listitem> + <para>プリント処理をおこなうフリーのまたは商用のプログラムの + ほとんどは, システムのスプーラとやりとりするように作られて + います. スプーリングシステムをセットアップすることで, 今後 + 加えるかもしれない, あるいは, 既に持っている別のソフトウエ + アをより簡単にサポートすることができるでしょう.</para> + </listitem> + </itemizedlist> + </sect1> + + <sect1 id="printing-intro-setup"> + <title>スプーリングシステムのセットアップ</title> + + <para>LPDスプーリングシステムを用いてプリンタを使用するためには, + プリンタ機器とLPD用ソフトウェアの両方を準備する必要があります. + 本ドキュメントでは次の2段階のレベルに分けて説明をします.</para> + + <itemizedlist> + <listitem> + <para>プリンタを接続する方法, プリンタにどの + ように通信するかをLPDに指示する方法や, プレインテキスト + をプリンタで印字する方法については, 「<link + linkend="printing-simple"> + プリンタの簡単な設定</link>」をご覧ください.</para> + </listitem> + + <listitem> + <para>様々な形式のファイルを印字する方法, ヘッダページを + 印字する方法, ネットワーク経由でプリンタに印字する方法, + プリンタを制御する方法, プリンタの使用に対する課金をおこなう + 方法については「<link linkend="printing-advanced"> + プリンタ設定上級編</link>」をご覧ください.</para> + </listitem> + </itemizedlist> + </sect1> + + <sect1 id="printing-simple"> + <title>プリンタ設定導入編</title> + + <para>この節では, プリンタ機器やプリンタを使用するためのLPD用ソフ + トウェアを設定する方法について述べます. この節の概要は次の通り + です.</para> + + <itemizedlist> + <listitem> + <para>「<link linkend="printing-hardware"> + プリンタ機器の設定</link>」では, + プリンタをコンピュータに接 + 続するためのヒントがいくつか書かれています.</para> + </listitem> + + <listitem> + <para>「<link linkend="printing-software"> + ソフトウェアの設定</link>」では, LPDのスプーラ設定ファイル + <filename>/etc/printcap</filename> + の設定方法について書かれています.</para> + </listitem> + </itemizedlist> + + <para>データをプリンタに送るためにシリアルまたは + パラレルインタフェー スではなく, + ネットワークプロトコルを使用する場合は, 「<link + linkend="printing-advanced-network-net-if"> + ネットワークにおけるデータストリームの + インタフェースを持つプリンタ</link>」をご覧くださ い.</para> + + <para>この節のタイトルは“プリンタ設定導入編”ですが, + 実際の設定は かなり複雑です. プリンタをコンピュータに接続し, + LPDスプーラを 起動させることは一番困難な作業です. + ヘッダページを出力させたり, 課金したりするオプションの設定は, + 一度プリンタがうまく動くよう になれば, とても簡単です.</para> + <sect2 id="printing-hardware"> + + <title>プリンタ機器の設定</title> + + <para>この節では, プリンタにPCを接続するための様々な方法について + 説明しています. ここでは, ポートやケーブルの種類, FreeBSDが + プリンタとの通信に必要なカーネルコンフィグレーションについて + も言及しています.</para> + + <para>もし, プリンタが既に接続されていて, + 他のオペレーティングシステ + ム上でプリンタからの印字に成功している場合は, 「<link + linkend="printing-software"> + ソフトウェアの設定</link>」まで読み飛 + ばすことが多分できるでしょう.</para> + + <sect3 id="printing-ports"> + <title>ポートとケーブル</title> + + <para>最近のPC用のプリンタほとんどには次のインタフェースの一つ + もしくは両方がついています.</para> + + <itemizedlist> + <listitem> + <para><emphasis>シリアル</emphasis>インタフェースでは, + プリンタにデータを + 送信するためにコンピュータにあるシリアルポートが使用され + ます. シリアルインタフェースはコンピュータ業界で共通し + て使用されています. そのケーブルは容易に手に入り, また, + 簡単に自作することもできます. + シリアルインタフェースには, + 特別なケーブルが必要なことがときどきあり, また, 何か複 + 雑な通信方式選択の設定が必要になることがあります.</para> + </listitem> + + <listitem> + <para><emphasis>パラレル</emphasis>インタフェースでは, + プリンタにデータを + 送信するためにコンピュータにあるパラレルポートを使用しま + す. パラレルインタフェースはPC業界では共通して使われてい + ます. ケーブルの入手は容易ですが, 自作するのはシリアルよ + りも難しいです. パラレルインタフェースには通常, + 通信方式の選 択はなく, このため, + 設定が極めて単純になっています.</para> + + <para>パラレルインタフェースは + “セントロニクス”インタフェー + スとして知られています. これは, プリンタ用のコネクタタ + イプとして採用された後に名付けられました.</para> + </listitem> + </itemizedlist> + + <para>シリアルインタフェースはパラレルインタフェースより + も普通はデータの伝送速度が遅くなります. + パラレルインタフェースで は, 通常, + (コンピュータからプリンタへの) 単方向通信のみをおこな + うのに対して, + シリアルインタフェースは双方向通信をおこないます. + 最近のパラレルポートの多くはプリンタ側からデータを受けとる + こともできますが, コンピュータ側にデータを送り返すことが必 + 要となるプリンタはほとんどありません. さらに, FreeBSDでは + 双方向のパラレル通信をまだサポートしていません.</para> + + <para>通常, プリンタで双方向通信が必要となるのは, プリンタが + PostScript 言語に対応しているときだけです. PostScript プリ + ンタは非常に冗長に動作させることができます. 事実, PostScript + によるジョブでは, プログラムを本当にプリンタ に送信します. + このことは, 印字作業を必ずしもする必要がない ことを意味し, + また, プログラムの結果をコンピュータに直接返 + されるかもしれません. PostScript プリンタでは, 双方向 + 通信を使って, PostScript プログラムのエ + ラーや紙づまりといった問題をコンピュータに報告します. ユー + ザはそれらの情報を知りたいと思うかもしれません. さらに, + PostScript プリンタで課金作業をもっとも効率よくおこなうため + には双方向通信が必要となります. この方法では, まず, プ + リンタの現在のページカウント (起動してから今まで何枚の紙を + 印字したか) の情報を得ます. 次に, ユーザのジョブをおこない, + 終 了後, 再びページカウントを得ます. この2数を差によって, 課 + 金対象となる紙の枚数を知ることができます.</para> + + <para>それでは, + どちらのインタフェースを使うべきなのでしょうか.</para> + + <itemizedlist> + <listitem> + <para>双方向通信が必要なら, シリアルポートを使ってくださ + い. + FreeBSDではパラレルポート上での双方向通信はまだサポー + トされていません.</para> + </listitem> + + <listitem> + <para>双方向通信の必要がなく, パラレルかシリアルかの選 + 択ができる場合はパラレルインタフェースを使うのが好ましい + です. これにより, シリアルポートを他の周辺機器 (端末やモ + デムのなど) のために残しておくことができます. また, パラ + レルインタフェースの方がほとんどの場合高速であり, 設定も + より簡単になっています.</para> + </listitem> + + <listitem> + <para>結局のところは + 動いてくれるものを使えばよいのです.</para> + </listitem> + </itemizedlist> + </sect3> + + <sect3 id="printing-parallel"> + <title>パラレルポート</title> + + <para>プリンタをパラレルインタフェースを使って接続する場合は, + セントロニクスケーブルでプリンタと + コンピュータをつないでくださ い. 詳しい説明はプリンタ, + コンピュータ, あるいは両方に付属す + る説明書に書かれているはずです.</para> + + <para>その際, + どのパラレルポートを使用したかを覚えておいてください. + FreeBSDでは最初のポートは <filename>/dev/lpt0</filename>, + 2番目は <filename>/dev/lpt1</filename> であ り, + 3番目以降も同様に続きます.</para> + </sect3> + + <sect3 id="printing-serial"> + <title>シリアルポート</title> + + <para>シリアルインタフェースを使ってプリンタを使う場合は, 適切 + なシリアルケーブルでプリンタ + とコンピュータを接続してください. 詳しい説明はプリンタ, + コンピュータ, あるいは両方に付属する説 + 明書に書かれているはずです.</para> + + <para>“適切なシリアルケーブル” + がよくわからないときは, 次のどれか + を試してみてください.</para> + + <itemizedlist> + <listitem> + <para><emphasis>モデム</emphasis>用ケーブルでは, + それぞれのピンは他方の + コネクタの対応するピンと線でつながっています. このタイプ + のケーブルは, “DTE-DCE” + 間ケーブルとしても知られています. (訳注: + 日本ではストレートケーブルという名前で売られています) + </para> + </listitem> + + <listitem> + <para><emphasis>ヌルモデム</emphasis>用ケーブルでは, + あるピンは対応するピ ント接続していますが, あるピン + (例えば, データ送信用とデー タ受信用のピン) + が交差して接続したり, いくつかのピンは内部 + で短絡していたりします. このタイプのケーブルは, + “DTE-DTE” 間ケーブルと呼ばれています. + (訳注:日本ではクロスケーブル + という名前で売られています)</para> + </listitem> + + <listitem> + <para>A <emphasis>シリアルプリンタ</emphasis>用ケーブルは, + ある特定のプ リンタで必要とされ, + ヌルモデムケーブルと似ていますが, 内 + 部で短絡させる代わりに, ある信号を他方側に送るために使用 + しています.</para> + </listitem> + </itemizedlist> + + <para>この他に, + プリンタ用の通信パラメータを設定する必要がありま す. 通常, + プリンタのフロントパネルやDIPスイッチによって制 御します. + コンピュータとプリンタの双方で設定できる最高の通 信速度[bps] + (ビット/秒. + <emphasis>ボーレート</emphasis>と示されているときも ある) + を選んでください. そして, データビット (7または8), パリ ティ + (偶/奇/なし), ストップビット (1または2) を選んでください. + そして, フローコントロールの有無 (制御なし, または + XON/XOFF(“イン・バンド” または + “ソフトウェア”フローコ ントロールとも呼ばれる)) + を選びます. 以下に続くソフトウェア の設定のために, + ここでの設定を覚えておいてください.</para> + </sect3> + </sect2> + + <sect2 id="printing-software"> + <title>ソフトウェアの設定</title> + + <para>本節では FreeBSD の LPD + スプーリングシステムで印字をおこなうために + 必要となるソフトウェアの設定について説明しています.</para> + + <para>本節の概要は次のようになります.</para> + + <procedure> + <step> + <para>プリンタで使用するポートのために, 必要があれば, カー + ネルの書き変えをおこないます. 「<link + linkend="printing-kernel">カーネルの変更</link>」で, + このためにしなくてはなら ないことを説明しています.</para> + </step> + + <step> + <para>パラレルポートを使用している場合は, パラレルポートの + ための通信モードの設定します. 詳細は, 「<link + linkend="printing-parallel-port-mode"> + パラレルポートの通信モードを設定する + </link>」で説明しています.</para> + </step> + + <step> + <para>オペレーティングシステムからプリンタにデータが送ら + れているかをテストします. 「<link + linkend="printing-testing"> + プリンタとの通信状況を調べる</link>」で, どのように + テストするかの提案をいくつかおこなっています.</para> + </step> + + <step> + <para>ファイル<filename>/etc/printcap</filename>を変更し, + LPDの設定を おこないます. 「<link + linkend="printing-printcap">/etc/printcap + ファイル</link>」で, どのように変更するかを + 説明しています.</para> + </step> + </procedure> + + <sect3 id="printing-kernel"> + <title>カーネルの変更</title> + + <para>オペレーティングシステムのカーネルの + コンパイルをおこなうこと によって, + 指定されたのデバイスが機能するようになります. シリ アル, + または, パラレルインタフェースをプリンタで使用する場合, + 必要なデバイスがこの指定の中に含まれていなくてはなりません. + したがって, + 必要なデバイスがカーネルに組み込まれていない場合, 追 + 加のシリアル, または, パラレルポートをサポートするために, + カー ネルの再コンパイルが必要となるかもしれません.</para> + + <para>シリアルポートが現在使用しているカーネルで + サポートされている かどうかを調べるためには, + 次のように入力します.</para> + + <screen>&prompt.root; <userinput>dmesg | grep sio<replaceable>N</replaceable></userinput></screen> + + <para>ここで, <replaceable>N</replaceable> + はシリアルポートの番号を示し, この番号は0から 始まります. + 次のような出力があった場合, カーネルはそのポー + トをサポートしています.</para> + + <screen>sio2 at 0x3e8-0x3ef irq 5 on isa +sio2: type 16550A</screen> + + <para>パラレルポートが現在使用しているカーネルで + サポートされている かどうかを調べるためには, + 次のように入力します.</para> + + <screen>&prompt.root; <userinput>dmesg | grep lpt<replaceable>N</replaceable></userinput></screen> + + <para>ここで, <emphasis remap=it>N</emphasis> + はパラレルポートの番号を示し, この番号は0から 始まります. + 次のような出力があった場合, カーネルはそのポー + トをサポートしています.</para> + + <screen>lpt0 at 0x378-0x37f on isa</screen> + + <para>上記の出力が得られない場合, プリンタを使うため, + オペレーティ ングシステムにパラレル, または, + シリアルポートを認識し, 使用 できるようにするためには + カーネルを変更する必要があります.</para> + + <para>シリアルポートをサポートさせるには, 「<link + linkend="kernelconfig"> + FreeBSDカーネルのコンフィグレーション</link>」の節をご覧く + ださい. パラレルポートをサポートさせる場合も, その節と, + <emphasis>あ わせて</emphasis>, + この節に続く節もご覧ください.</para> + + <sect4 id="printing-dev-ports"> + <title>ポート用エントリを <filename>/dev</filename> + に追加する</title> + + <para>カーネルがシリアル, または, パラレルポートを通じての通 + 信をサポートしていたとしても, システム上で動いているプログ + ラムがデータの送受信をおこなうための + ソフトウェアインタフェース がさらに必要になります. + そのインタフェースは, <filename>/dev</filename> + ディレクトリにあるエントリに相当します.</para> + + <para><emphasis><filename>/dev</filename> + エントリにポートを加えるために</emphasis></para> + + <procedure> + <step> + <para>&man.su.1; コマンドで root になります. suコマンド + でパスワードを聞かれたら, ルート用のパスワードを入力し + ます.</para> + </step> + + <step> + <para><filename>/dev</filename> + ディレクトリに移動します. </para> + + <screen>&prompt.root; cd /dev</screen> + </step> + + <step> + <para>次のように入力します. </para> + + <screen>&prompt.root; <userinput> ./MAKEDEV <replaceable>port</replaceable></userinput></screen> + + <para>ここで, <replaceable>port</replaceable> は, + 作成するポート名です. 1番目 のパラレルポートのときは + <literal>lpt0</literal> に, 2番目のときは + <literal>lpt1</literal> になり, 以降同様になります. + 1番目のシリア ルポートのときは, + <literal>ttyd0</literal> に, 2番目のときは + <literal>ttyd1</literal> になり, + これも以降同様となります.</para> + </step> + + <step> + <para>次を入力し, デバイスのエントリができたか確認し + ます. </para> + + <screen>&prompt.root; <userinput>ls -l <replaceable>port</replaceable></userinput></screen> + </step> + </procedure> + </sect4> + + <sect4 id="printing-parallel-port-mode"> + <title>パラレルポートの通信モードを設定する</title> + + <para>パラレルインタフェースを使用している場合, FreeBSDでは, + 割り込み駆動型にするか, + プリンタとの通信の状況をカーネルに監 + 視させるかのいずれかを選択できます.</para> + + <itemizedlist> + <listitem> + <para>GENERIC + カーネルでは<emphasis>割り込み駆動</emphasis>方式が, + デフォルトになっています. この方式では, + オペレーティングシ + ステムはプリンタがデータを受け付けられるかどうかを調べ + るために, IRQ ラインを一つ使用します.</para> + </listitem> + + <listitem> + <para><emphasis>監視</emphasis>方式では, + オペレーティングシステムにプ + リンタがもっとデータを受け付けられるかどうかを繰り返し + 尋ねるように指示します. そして, 受け付けるという応答を + 受けたとき, + カーネルはさらなるデータを送信します.</para> + </listitem> + </itemizedlist> + + <para>割り込み駆動方式は, いくらか高速になりますが, 貴重な + IRQ ラインを一つ消費します. + うまく機能するものをお使いください.</para> + + <para>通信モードを設定するためには2つの方法があります. + 1つはカー + ネルを変更することで, もう一つは + &man.lptcontrol.8; プログラムを使用する方法です.</para> + + <para><emphasis> カーネルを設定することによって, + 通信モードを変更する. </emphasis></para> + + <procedure> + <step> + <para>カーネルコンフィグレーションファイルを変更しま す. + <literal>lpt0</literal> + のエントリを探すか追加してください. 2番目 + のパラレルポートを設定するときは, 代わりに + <literal>lpt1</literal> を使います. 以下, + 3番目のポートは <literal>lpt2</literal> となってい + きます. </para> + + <itemizedlist> + <listitem> + <para>イベント駆動方式にする場合は, + <literal>irq</literal> 指 定を追加します. </para> + + <programlisting> +device lpt0 at isa? port? tty irq <replaceable>N</replaceable> vector lptintr</programlisting> + + <para>ここで, <replaceable>N</replaceable> + はパラレルポート用の IRQ 番号で す.</para> + </listitem> + + <listitem> + <para>監視方式を使用する場合は, + <literal>irq</literal> を追加 してはいけません. + </para> + + <programlisting> +device lpt0 at isa? port? tty vector lptintr</programlisting> + </listitem> + </itemizedlist> + </step> + + <step> + <para>ファイルをセーブし, config プログラムを起動 し, + カーネルの構築, インストールをおこないます. そして, リ + ブートしてください. 詳細は, 「<link + linkend="kernelconfig"> + FreeBSDカーネルのコンフィグレーション</link>」を参照 + してください.</para> + </step> + </procedure> + + <para>&man.lptcontrol.8; <emphasis> + で通信モードを設定する場合 </emphasis></para> + + <procedure> + <step> + <para><literal>lpt<replaceable>N</replaceable></literal> + をイベント駆動方式に設定する場合は, + 次のように入力します. </para> + + <screen>&prompt.root; <userinput>lptcontrol -i -u <replaceable>N</replaceable></userinput></screen> + </step> + + <step> + <para><literal>lpt<replaceable>N</replaceable></literal> + を監視方式に設定する場合は, 次のように入力します. + </para> + + <screen>&prompt.root; <userinput>lptcontrol -p -u <replaceable>N</replaceable></userinput></screen> + </step> + </procedure> + + <para>これらのコマンドを <filename>/etc/rc.local</filename> + ファイルに追加 + しておくと, システムをブートする度に通信モードを設定する + ことができます. 詳細については, + &man.lptcontrol.8; をご覧ください.</para> + </sect4> + + <sect4 id="printing-testing"> + <title>プリンタとの通信状況を調べる</title> + + <para>スプーリングシステムの設定に進む前に, オペレーティング + システムがプリンタにデータを送ることに成功しているかどうか + を確かめるべきでしょう. これにより, 印字がうまくいかないと + き, プリンタとの通信が問題なのか, スプーリングシステムが問 + 題なのかを分けて調べることがかなり容易になります.</para> + + <para>プリンタをテストするためには, + プリンタに何かのテキストを送 + 信してみます. 送信した文字をすぐに印字してくれるプリンタに + は, &man.lptest.1; コマンドを使うと有用です. このコマンドは印 + 字可能な96文字のASCII文字すべてを96行生成します.</para> + + <para>PostScript (または他の言語に対応した) プリンタの場合 + は, もっと巧妙なテストが必要になります. 次のような, 簡単な + PostScript プログラムを使えば十分でしょう. </para> + + <programlisting> +%!PS +100 100 moveto 300 300 lineto stroke +310 310 moveto +/Helvetica findfont 12 scalefont setfont +(Is this thing working?) show +showpage</programlisting> + + <note> + <para>このドキュメントでプリンタ用言語を参照するとき は, + PostScript のような言語を仮定しており, Hewlett Packard + の PCL は考慮していません. PCL は非常に機能的なの + ですが, + プレインテキストにエスケープシーケンスを混ぜること + ができます. PostScript ではプレインテキストを直接印字 + することはできません. + このような種類のプリンタ言語に対して は, + 特別な対応をおこなわなければなりません.</para> + </note> + + <sect5 id="printing-checking-parallel"> + <title>パラレルポートのプリンタとの接続を調べる</title> + + <para>この節では, FreeBSDがパラレルポートに接続されたプリ + ンタと通信できているかどうかを調べる方法について説明し + ています.</para> + + <para><emphasis> + パラレルポートのプリンタをテストするために + </emphasis></para> + + <procedure> + <step> + <para>&man.su.1; コマンドで root になります.</para> + </step> + + <step> + <para>プリンタにデータを送ります. </para> + + <itemizedlist> + <listitem> + <para>プリンタがプレインテキストを印字できる場合, + &man.lptest.1; コマンドを使います. + 次のように入力してください. </para> + + <screen>&prompt.root; <userinput>lptest > /dev/lpt<replaceable>N</replaceable></userinput></screen> + + <para>ここで, <replaceable>N</replaceable> + はパラレルポートの番号で, 番号は + 0から始まります.</para> + </listitem> + + <listitem> + <para>プリンタが PostScript か他のプリンタ + 言語を使用している場合, そのプリンタに簡単なプロ + グラムを送信してください. 次のように入力します. + </para> + + <screen>&prompt.root; <userinput>cat > /dev/lpt<replaceable>N</replaceable></userinput></screen> + + <para>そして, 一行一行, + プログラムを<emphasis>慎重に</emphasis>入力して + 下さい. RETUREN または ENTER キーを入力してしま + うと, その行は編集できなくなります. プログラムの + 入力が終わったら, CONTROL+Dか, あなたが設定して + いるファイル終了のキーを押してください.</para> + + <para>もしくは, プログラムを入力したファイルがある + 場合は, 次のように入力してください. </para> + + <screen>&prompt.root; <userinput>cat <replaceable>file</replaceable> > /dev/lpt<replaceable>N</replaceable></userinput></screen> + + <para>ここで, <replaceable>file</replaceable> + はプログラムが格納されていて, + プリンタに送信するファイルの名前です.</para> + </listitem> + </itemizedlist> + </step> + </procedure> + + <para>これで何かがプリントされることでしょう. + 印字されたテキ + ストがおかしくても心配しなくても構いません. それについ + ては, 後で修正します.</para> + </sect5> + + <sect5 id="printing-checking-serial"> + <title>シリアルポートのプリンタとの接続を調べる</title> + + <para>この節では, FreeBSDがシリアルポートに接続されたプリ + ンタと通信できているかどうかを調べる方法について述べられ + ています.</para> + + <para><emphasis remap=bf> + シリアルポートのプリンタをテストするために + </emphasis></para> + <!-- kuriyama - remap=bf? --> + + <procedure> + <step> + <para>&man.su.1; コマンドで root になります.</para> + </step> + + <step> + <para><filename>/etc/remote</filename> + ファイルを編集します. 次の エントリを加えてください. + </para> + + <programlisting> +printer:dv=/dev/<replaceable>port</replaceable>:br#<replaceable>bps-rate</replaceable>:pa=<replaceable>parity</replaceable></programlisting> + + <para>ここで, <replaceable>port</replaceable> + シリアルポート (<literal>ttyd0</literal>, + <literal>ttyd1</literal> など) のデバイスエントリで, + <replaceable>bps-rate</replaceable>は + プリンタとの通信の転送速度[bit/秒], + <replaceable>parity</replaceable>はプリ + ンタとの通信で必要とされるパリティ + (<literal>even</literal>, <literal>odd</literal>, + <literal>none</literal>, + <literal>zero</literal>のいずれか) を表わしていま + す.</para> + + <para>次の例は, + プリンタをシリアルケーブルでパリティなし, 転送速度 + 19200bpsで第3番目のシリアルポートに接続した場 + 合です.</para> + + <programlisting> +printer:dv=/dev/ttyd2:br#19200:pa=none</programlisting> + </step> + + <step> + <para>&man.tip.1; コマンドでプリンタと接続します. 次のよ + うに入力してください. </para> + + <screen>&prompt.root; <userinput>tip printer</userinput></screen> + + <para>これがうまくいかなかった場合は, + <filename>/etc/remote</filename>を 編集して, + <filename> + /dev/ttyd<replaceable>N</replaceable></filename> + の代わりに <filename> + /dev/cuaa<replaceable>N</replaceable></filename> + を試してみてください.</para> + </step> + + <step> + <para>プリンタにデータを送ります. </para> + + <itemizedlist> + <listitem> + <para>プリンタがプレインテキストを印字できる場合, + &man.lptest.1; コマンドを使います. + 次のように入力してください. </para> + + <screen><prompt>~</prompt><userinput>$lptest</userinput></screen> + </listitem> + + <listitem> + <para>プリンタが PostScript か他のプリンタ + 言語を使用している場合, そのプリンタに簡単なプロ + グラムを入力します. 一行一行, + プログラムを<emphasis>慎 + 重に</emphasis>入力してください. + バックスペースキーや他の編 集用のキーは, + プリンタの制御コードに割り当てられ + ているかもしれません. プログラムが終了したことを + プリンタに伝えるための特別なファイル終了キーを入 + 力する必要があるかもしれません. PostScript + プリンタの場合, CONTROL+Dを入力します.</para> + + <para>もしくは, プログラムを入力したファイルがある + 場合は, 次のように入力してください.</para> + + <screen><prompt>~</prompt><userinput>><replaceable>file</replaceable></userinput></screen> + + <para>ここで, <replaceable>file</replaceable> + はプログラムが格納されている + ファイル名です. + &man.tip.1; コマンドでファイルを送 + 信した後は, ファイル終了を表わすキーを入力する必要 + があります.</para> + </listitem> + </itemizedlist> + </step> + </procedure> + + <para>これで何かがプリントされることでしょう. + 印字されたテキ + ストがおかしくても心配しなくても構いません. それについ + ては, 後で修正します.</para> + </sect5> + </sect4> + </sect3> + + <sect3 id="printing-printcap"> + <title>スプーラに許可を与える: + <filename>/etc/printcap</filename> ファイル</title> + + <para>ここまでで, プリンタはコンピュータに接続され, (必要なら) + プリンタと通信できるようにカーネルを変更し, 簡単なデータをプ + リンタに送信することができているはずです. これで, LPDにプリ + ンタへのアクセスを + 制御させる設定をおこなう準備が整いました.</para> + + <para>LPDの設定は <filename>/etc/printcap</filename> + を編集することでおこないます. + LPDスプーリングシステムはスプーラが使われる毎にこのファイル + を参照します. そのため, ファイルを更新するとすぐにその変更が + 反映されます.</para> + + <para>&man.printcap.5; ファイルの書式は簡単です. + <filename>/etc/printcap</filename> + の編集はお好みのテキストエディタをお + 使いください. このファイルの書式は, + <filename>/usr/share/misc/termcap</filename> や + <filename>/etc/remote</filename> + といった他のケイパビリティファイルと一致しています. + この書式 + のついての詳細な情報については + &man.cgetent.3; をご覧ください.</para> + + <para>スプーラの単純な設定法は, + 次のステップでおこないます.</para> + + <procedure> + <step> + <para>プリンタに名前 (と簡単な別名2〜3個) を付け, それを + <filename>/etc/printcap</filename> ファイルに記述します. + これについ ては, 「<link linkend="printing-naming"> + プリンタに名前を付ける</link>」 + を参照してください.</para> + </step> + + <step> + <para><literal>sh</literal> の項目を追加することで, + ヘッダページの出 力を禁止します (デフォルトは許可). + これについては, 「<link + linkend="printing-no-header-pages"> + ヘッダページの印字を禁止する</link>」 + を参照してください.</para> + </step> + + <step> + <para>スプール用のディレクトリを作成し, その位置を + <literal>sd</literal> 項目で指定します. これについては, + 「<link linkend="printing-spooldir"> + スプーリングディレクトリの作成</link>」 + を参照してください.</para> + </step> + + <step> + <para>プリンタを使用するために <filename>/dev</filename> + エントリを 設定し, <filename>/etc/printcap</filename> の + <literal>lp</literal> 項目でそのエ ントリを指定します. + これについては, 「<link linkend="printing-device"> + プリンタデバイスの特定</link>」 を参照してください. + プリンタをシリアルポートに接続した場合は, + <literal>fs</literal>, <literal>fc</literal>, + <literal>xs</literal>, <literal>xc</literal> + の項目を設定する必要があります. こちらについては, + 「<link linkend="printing-commparam"> + スプーラのための通信パラメータの設定</link>」 + を参照してください.</para> + </step> + + <step> + <para>プレインテキスト用の入力フィルタのインストールを + おこないます. 「<link linkend="printing-textfilter"> + テキストフィルタのインストール</link>」 + を参照してください.</para> + </step> + + <step> + <para>&man.lpr.1; コマンドで何かを印字することで設定のテス + トをおこないます. <link linkend="printing-trying"> + 印字してみよう</link> と + <link linkend="printing-troubleshooting"> + トラブルシューティング</link> を参照してください.</para> + </step> + </procedure> + + <note> + <para>PostScript プリンタのような, プリンタ言語を + 使用しているプリンタには, プレインテキストを直接印字させる + ことができません. 上にアウトラインを示し, 以下の節で説明す + る簡単な設定方法の説明では, そのようなプリンタを設置してい + る場合は, プリンタが認識できるファイルだけを印字の対象とし + ているという仮定をしています.</para> + </note> + + <para>多くの場合, + 利用者はシステムに設置されているプリンタすべてでプ + レインテキストが印字できることを期待しています. 印字作業を + おこなうためにLPDのインタフェースを利用するプログラムでも, + 通 常, そのような仮定を置きます. + プリンタ言語を使用するプリン タを設置しており, + そのプリンタ言語で記述されたジョブと, + <emphasis>これに加えて</emphasis>, + プレインテキストのジョブも印字できるよ うにしたいならば, + 上で示した簡単な設定方法に加えて, さら + なる設定をおこなうことを強くお勧めします. すなわち, + 原始的なプ レインテキストから PostScript (もしくは, + 他のプリンタ 言語) + に変換するプログラムをインストールしてください. 「<link + linkend="printing-advanced-if-conversion"> + プレインテキストのジョブを PostScript + プリンタで印字する</link>」 + で, そ れをどのようにおこなえばよいのかが + 説明されています.</para> + + <note> + <para>日本語を印字したい場合は, プリンタ言語を使用し + ていない「日本語プリンタ」についても, + プリンタ固有のエスケー プシーケンスを送る必要があります. + また, 漢字コードをプリン + タが設定しているものに変換したりする必要があり, 各プリンタ + 毎に, 日本語用のフィルタが必要になります.</para> + </note> + + <sect4 id="printing-naming"> + <title>プリンタに名前を付ける</title> + + <para>最初の (簡単な) ステップで, プリンタの名前を考えます. + プ リンタには別名をいくつか付けることもできるので, + 機能的な名前 + でも風変わりな名前でもどちらを選んでもまったく + 問題はありません.</para> + + <para>少なくとも1つのプリンタには, + <filename>/etc/printcap</filename> の中 で, + <literal>lp</literal> という別名を持たせるべきでしょう. + この名前は デフォルトのプリンタ名になっています. + ユーザが環境変数 <envar>PRINTER</envar> を設定しておらず, + かつ, LPDコマンドのコマンドラインでプリ + ンタの名前が指定されていない場合, <literal>lp</literal> + がデフォルトのプリ ンタ名となり, + そのプリンタに出力されます.</para> + + <para>それから, これは共通の慣習ですが, + プリンタの最後の別名には, + メーカーやモデル名を含むプリンタの完全な名称をつけることに + なっています.</para> + + <para>名前と別名のいくつかを決めたら, + <filename>/etc/printcap</filename> ファ イルに設定します. + プリンタ名は一番左のカラムから書き始めま す. + 別名はそれぞれ縦棒によって区切られ, 最後の別名の後ろに + コロンを置きます.</para> + + <para>次の例では, 2台のプリンタ (Diablo 630 ラインプリンタと + Panasonic KX-P4455 PostScript レーザライタプリンタ) が定義 + されている <filename>/etc/printcap</filename> + のスケルトンを記しています.</para> + + <programlisting> +# +# /etc/printcap for host rose +# +rattan|line|diablo|lp|Diablo 630 Line Printer: + +bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:</programlisting> + + <para>この例では, 最初のプリンタに <literal>rattan</literal> + という名前と別名 として, <literal>line</literal>, + <literal>diablo</literal>, <literal>lp</literal> そして + <literal>Diablo 630 Line Printer</literal> + が付けられています. 別名とし て <literal>lp</literal> + があるので, このプリンタはデフォルトのプリンタとなっ + ています. 2番目は <literal>bamboo</literal> と名付けられ, + 別名として, <literal>ps</literal> と + <literal>PS</literal>, <literal>S</literal>, + <literal>panasonic</literal>, <literal>Panasonic KX-P4455 + PostScript v51.4</literal> が付けられていま す.</para> + </sect4> + + <sect4 id="printing-no-header-pages"> + <title>ヘッダページの印字を禁止する</title> + + <para>LPDスプーリングシステムでは, + デフォルトでジョブ毎に<emphasis>ヘッ + ダページ</emphasis>を印字します. + ヘッダページにはジョブを要求したユー ザ名, + ジョブが送られたホスト名, そして, ジョブの名前が素晴 + らしい大きな文字で印字されています. 残念なことに, この余分 + なテキストすべてが, + 簡単なプリンタ設定法のデバッグの際に紛れ + 込んできてしまいます. このため, ヘッダページの出力を禁止し + ておきます.</para> + + <para>ヘッダページの出力を禁止するには, + <filename>/etc/printcap</filename> + にあるプリンタのエントリに <literal>sh</literal> + の項目を追加します. 次 に, <literal>sh</literal> を加えた + <filename>/etc/printcap</filename> の例を示します.</para> + + <programlisting> +# +# /etc/printcap for host rose - no header pages anywhere +# +rattan|line|diablo|lp|Diablo 630 Line Printer:\ + :sh: + +bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ + :sh:</programlisting> + + <para>この書式を正しく使うための注意をしておきます. + 最初の行は左 端のカラムから始まります. それに続く行は TAB + ひとつ分だけ 字下げします. 最後の行以外のすべての行は, + 行末にバックスラッ シュを記述します.</para> + </sect4> + + <sect4 id="printing-spooldir"> + <title>スプーリングディレクトリの作成</title> + + <para>スプーラの簡単な設定の次のステップでは, + <emphasis>スプーリン + グディレクトリ</emphasis>を作成します. + プリンタに送られるジョブ は, + その印字が終了するまでこのディレクトリに置かれます. また, + 他のたくさんのスプーラもこのディレクトリにファイ + ルを置きます.</para> + + <para>様々な事情によりスプーリングディレクトリは, 通常, 慣例 + として <filename>/var/spool</filename> の下に置きます. + また, スプーリングディレクトリの内容はバックアップをす + る必要はありません. + &man.mkdir.1; によってディレクトリを + 作るだけでスプーリングディレクトリの復旧は完了します. + </para> + + <para>スプーリングディレクトリの名前は, これも慣例ですが, 次 + のようにプリンタの名前と同じにします.</para> + + <screen>&prompt.root; <userinput>mkdir /var/spool/<replaceable>printer-name</replaceable></userinput></screen> + + <para>しかしながら, ネットワーク上に使用可能なプリンタがたく + さんあるならば, LPDで印字するための専用のディレクトリに + スプーリングディレクトリを置きたいと思うかもしれません. + 例に出てきたプリンタ <literal>rattan</literal> と + <literal>bamboo</literal> につい て, この方式を採用すると, + 次のようになります.</para> + + <screen>&prompt.root; <userinput>mkdir /var/spool/lpd</userinput> +&prompt.root; <userinput>mkdir /var/spool/lpd/rattan</userinput> +&prompt.root; <userinput>mkdir /var/spool/lpd/bamboo</userinput></screen> + + <note> + <para>各ユーザが印字するジョブのプライバシを守りた + いと考えているならば, スプーリングディレクトリを保護し + て, これを誰からでもアクセスできないようにしたいと思う + かもしれません. スプーリングディレクトリは, deamon ユー + ザと daemon グループに所有され, 読み込み, 書き込み, 検 + 索可能であり, 他からはアクセスできないようにするべきで + す. 例題のプリンタに対して, 次のようにすることにしましょ + う.</para> + + <screen>&prompt.root; <userinput>chown daemon.daemon /var/spool/lpd/rattan</userinput> +&prompt.root; <userinput>chown daemon.daemon /var/spool/lpd/bamboo</userinput> +&prompt.root; <userinput>chmod 770 /var/spool/lpd/rattan</userinput> +&prompt.root; <userinput>chmod 770 /var/spool/lpd/bamboo</userinput></screen> + </note> + + <para>最後に, <filename>/etc/printcap</filename> ファイルで, + これらのディ レクトリの位置を LPD に伝える必要があります. + スプーリ ングディレクトリのパス名は <literal>sd</literal> + 項目で指定します.</para> + + <programlisting> +# +# /etc/printcap for host rose - added spooling directories +# +rattan|line|diablo|lp|Diablo 630 Line Printer:\ + :sh:sd=/var/spool/lpd/rattan: + +bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ + :sh:sd=/var/spool/lpd/bamboo:</programlisting> + + <para>プリンタ名が最初のカラムから始まっており, そのプリンタ + に関して記述される他のエントリは TAB で字下げされてい + ること, 各行がバックスラッシュで終わっていることに注意 + してください.</para> + + <para><literal>sd</literal> + によりスプーリングディレクトリが指定されていな い場合, + スプーリングシステムは <filename>/var/spool/lpd</filename> + デフォルト値として使用します.</para> + </sect4> + + <sect4 id="printing-device"> + <title>プリンタデバイスの特定</title> + + <para>「<link + linkend="printing-dev-ports">ポート用エントリを /dev + に追加する</link>」では, FreeBSD でプリン + タとの通信に使用される <filename>/dev</filename> + ディレクトリ内の エントリを特定します. そして, LPD + にその情報を伝えま す. 印字するジョブを受け取ると, + スプーリングシステムは, + (プリンタにデータを渡す義務がある) フィルタプログラムに + 代わって指定されたデバイスをオープンします.</para> + + <para><filename>/etc/printcap</filename> ファイルで + <literal>lp</literal> 項目を使って + <filename>/dev</filename> エントリを記入します.</para> + + <para>ここでの例では, <hostid>rattan</hostid> + は1番目のシリアルポートに, <hostid>bamboo</hostid> + は6番目のシリアルポートに接続されているこ とにしましょう. + このとき, <filename>/etc/printcap</filename> には + 次のようになります.</para> + + <programlisting> +# +# /etc/printcap for host rose - identified what devices to use +# +rattan|line|diablo|lp|Diablo 630 Line Printer:\ + :sh:sd=/var/spool/lpd/rattan:\ + :lp=/dev/lpt0: + +bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ + :sh:sd=/var/spool/lpd/bamboo:\ + :lp=/dev/ttyd5:</programlisting> + + <para><filename>/etc/printcap</filename> でプリンタの + <literal>lp</literal> 項目が指定 されていない場合は, LPD + はデフォルトとして <filename>/dev/lp</filename> + を使用します. <filename>/dev/lp</filename> は, 現在の + FreeBSD には存在していません.</para> + + <para>設置したプリンタがパラレルポートに + 接続されている場合は, + 「<link linkend="printing-textfilter"> + テキストフィルタのインストール</link>」 + まで読み飛ばしてください. + そうでない場合は, 次節の説明に続いてください.</para> + </sect4> + + <sect4 id="printing-commparam"> + <title>スプーラのための通信パラメータの設定</title> + + <para>シリアルポートにプリンタを接続した場合, プリンタにデー + タを送信するフィルタプログラムに代わり, 通信速度やパリ + ティ, その他のシリアル通信パラメータを設定することがで + きます. このことによる利点は,</para> + + <itemizedlist> + <listitem> + <para><filename>/etc/printcap</filename> + を編集するだけで, 様々な + 通信パラメータを試してみることができます. フィルタプロ + グラムを再コンパイルする必要はありません.</para> + </listitem> + + <listitem> + <para>スプーリングシステムで, シリアル通信の設定が異 + なっているかもしれない複数のプリンタに同じフィルタプロ + グラムを使うことが可能になります.</para> + </listitem> + </itemizedlist> + + <para>次の <filename>/etc/printcap</filename> の項目で, + <literal>lp</literal> で指定 + されたデバイスのシリアル通信 + パラメータを制御できます.</para> + + <variablelist> + <varlistentry><term><literal> + br#<replaceable>bps-rate</replaceable></literal></term> + <listitem> + <para>デバイスの通信速度を + <replaceable>bps-rate</replaceable> に設定します. + ここ で, <replaceable>bps-rate</replaceable> は 50, + 75, 110, 134, 150, 200, 300, 600, 1200, 1800, 2400, + 4800, 9600, 19200, 38400[bit/秒] + のいずれかです.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal> + fc#<replaceable>clear-bits</replaceable></literal></term> + <listitem> + <para>デバイスをオープンした後で, + <replaceable>sgttyb</replaceable> 構造体の + <replaceable>clear-bits</replaceable> + フラグビットをクリアします.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal> + fs#<replaceable>set-bits</replaceable></literal></term> + <listitem> + <para><replaceable>sgttyb</replaceable> 構造体の + <replaceable>clear-bits</replaceable> + フラグビットをセッ トします.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal> + xc#<replaceable>clear-bits</replaceable></literal></term> + <listitem> + <para>デバイスをオープンした後で, ローカルモードビット + <replaceable>clear-bits</replaceable> + をクリアします.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal> + xs#<replaceable>set-bits</replaceable></literal></term> + <listitem> + <para>ローカルモードビット + <replaceable>set-bits</replaceable> + をセットします.</para> + </listitem> + </varlistentry> + </variablelist> + + <para><literal>fc</literal>, <literal>fs</literal>, + <literal>xc</literal>, そして <literal>xs</literal> + のビットに関 する詳しい情報については, + <filename>/usr/include/sys/ioctl_compat.h</filename> + を参照してく ださい.</para> + + <para>項目 <literal>lp</literal> で指定されたデバイスを LPD + がオープンする とき, LPD は <literal>sgttyb</literal> + 構造体のフラグビットを読み出 します. そして, 項目 + <literal>fc</literal> の全ビットをクリアします. 次に, + 項目 <literal>fs</literal> のビットをセットし, + その結果を設定 します. + ローカルモードビットに関しても同様におこなわれます.</para> + + <para>例題のプリンタで6番目のシリアルポートに接続されたプリ + ンタの設定を追加してみましょう. 通信速度は38400bpsに設 + 定します. フラグビットとして, TANDEM, ANYP, LITOUT, + FLUSHO, PASS8 をセットします. ローカルモードビットでは, + LITOUT と PASS8 フラグをセットします.</para> + + <programlisting> +bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ + :sh:sd=/var/spool/lpd/bamboo:\ + :lp=/dev/ttyd5:fs#0x82000c1:xs#0x820:</programlisting> + </sect4> + + <sect4 id="printing-textfilter"> + <title>テキストフィルタのインストール</title> + + <para>ここまでで, + プリンタにジョブを送るために使うテキストフィ ルタを LPD + に設定する準備が整いました. <emphasis>テキストフィ + ルタ</emphasis>とは, + <emphasis>入力フィルタ</emphasis>としても知られていますが, + 印字するジョブがあるときに LPD が起動するプログラムで す. + LPD がプリンタのためにテキストフィルタを起動する とき, LPD + はフィルタの標準入力からプリントするジョブ を入力し, + フィルタの標準出力に項目 <literal>lp</literal> で指定され + たプリンタデバイスを接続します. フィルタは, 標準入力か + らジョブを読み込み, プリンタのための必要な変換をおこなった + 後, その結果を標準出力に出力する, これにより印字がなさ + れることを期待されています. テキストフィルタについての + 更に詳しい情報については, 「<link + linkend="printing-advanced-filters"> + フィルタはどのように機能しているか</link>」 + をご覧ください.</para> + + <para>ここでの簡単なプリンタ設定では, + プリンタにジョブを送るため, <command>/bin/cat</command> + を実行するだけの簡単なシェルスクリプ トで間に合います. + FreeBSD に標準で付属している <command>lpf</command> + というフィルタでは, バックスペース文字を使っ + た下線引きの動作をおこなう文字ストリームをうまく扱うことが + できないプリンタのための代替処理をおこなってくれます. + もちろん, + 他のどんなフィルタプログラムを使っても構いません. + フィルタ <filename>lpf</filename> については, 「<link + linkend="printing-advanced-lpf">テキストフィルタ + lpf</link>」で詳しく説明します.</para> + + <para>最初に, 簡単なテキストフィルタであるシェルスクリプト + <filename>/usr/local/libexec/if-simple</filename> + を作ってみましょ う. + 次のテキストをお好みのテキストエディタでファイルに + 書き込んでください.</para> + + <programlisting> +#!/bin/sh +# +# if-simple - Simple text input filter for lpd +# Installed in /usr/local/libexec/if-simple +# +# Simply copies stdin to stdout. Ignores all filter arguments. + +/bin/cat && exit 0 +exit 2</programlisting> + + <para>そして, このファイルを実行可能にします. </para> + + <screen>&prompt.root; <userinput>chmod 555 /usr/local/libexec/if-simple</userinput></screen> + + <para>LPD + にこのテキストフィルタを使うことを設定するためには, + <filename>/etc/printcap</filename> に + <literal>if</literal> 項目を使って指定しま す. これまでの + <filename>/etc/printcap</filename> の例のプリンタ 2台に, + このフィルタを加えてみましょう. </para> + + <programlisting> +# +# /etc/printcap for host rose - added text filter +# +rattan|line|diablo|lp|Diablo 630 Line Printer:\ + :sh:sd=/var/spool/lpd/rattan:\ + :lp=/dev/lpt0:\ + :if=/usr/local/libexec/if-simple: + +bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ + :sh:sd=/var/spool/lpd/bamboo:\ + :lp=/dev/ttyd5:fs#0x82000e1:xs#0x820:\ + :if=/usr/local/libexec/if-simple:</programlisting> + </sect4> + + <sect4 id="printing-trying"> + <title>印字してみよう</title> + + <para>簡単な LPD 設定も終わりにたどり着きました. 残念ながら, + 設定はこれでおしまいというわけではありません. なぜなら, + さらに, 設定をテストし, すべての問題点を解決しなくては + ならないからです. 設定をテストするために, 何かを印字し + てみましょう. LPD システムで印字をするためには, + &man.lpr.1; コマンドを使います. このコマンドは, 印字する + ためのジョブを投入する働きをします.</para> + + <para>&man.lpr.1; コマンドを + 「<link linkend="printing-testing"> + プリンタとの通信状況を調べる</link>」で紹介した, + あるテスト用のテキストを生成してくれる + &man.lptest.1; プログラムと一緒に使うこともできます.</para> + + <para><emphasis>簡単な LPD + 設定をテストするために:</emphasis></para> + + <para>次のように入力してください. </para> + + <screen>&prompt.root; <userinput>lptest 20 5 | lpr -P<replaceable>printer-name</replaceable></userinput></screen> + + <para>ここで, <replaceable>printer-name</replaceable> + は <filename>/etc/printcap</filename> + で指定したプリンタ名 (もしくはその別名) です. デフォルト + のプリンタを使用する場合は, + <option>-P</option> 引数を付けないで + &man.lpr.1; を打ち込んでください. もう一度述べますが, ポス + トスクリプトを期待しているプリンタをテストするならば, + &man.lptest.1; を使う代わりに PostScript で書かれたプ + ログラムをプリンタに送ってください. プログラムを送るた + めには, プログラムをファイルに格納して, <command>lpr + <replaceable>file</replaceable></command> + と打ち込みます.</para> + + <para>PostScript プリンタの場合, 送信したプログラムによ + る結果が得られるでしょう. + &man.lptest.1; を使った場合は, + 以下のような結果が見られるでしょう.</para> + + <programlisting> +!"#$%&'()*+,-./01234 +"#$%&'()*+,-./012345 +#$%&'()*+,-./0123456 +$%&'()*+,-./01234567 +%&'()*+,-./012345678</programlisting> + + <para>更にプリンタをテストしたい場合は, (言語ベースのプリン + タのための) もっと大きなプログラムを送信するか, 引数を + 変えて + &man.lptest.1; を実行します. 例えば, <command>lptest + 80 60</command> で それぞれ80文字の行を60 + 行生成します.</para> + + <para>プリンタがうまく動かなかった場合は, 次の節, 「<link + linkend="printing-troubleshooting"> + トラブルシューティング</link>」をご覧ください.</para> + </sect4> + + <sect4 id="printing-troubleshooting"> + <title>トラブルシューティング</title> + + <para>&man.lptest.1; を使った簡単なテストをおこなった結果, + 正しい出 + 力を得られずに, 以下に示すような出力が得られるかもしれ + ません. </para> + + <variablelist> + <varlistentry><term>しばらくしたら出力される, または, + 紙の全体が出て こない</term> + <listitem> + <para>プリンタは上で示されたような印字を + おこなったのですが, しばら くして止まってしまい, + 動かなくなってしまいました. 印字 + された結果をプリンタから取り出すためには, + プリンタにある PRINT REMAINING ボタン, また は, FORM + FEED ボタンを押す必要があるようです.</para> + + <para>この場合は, + おそらくジョブはプリントをする前に更にデー + タが送られてこないか待ち続けているのでしょう. + この問題を解決するためには, プリンタに FORM FEED + 文字 (あるいは特定の必要な文字コード) を + 送るテキストフィルタを使ってください. + プリンタ内部に残っ + たデータをプリンタにすぐに印字させるには, 普通は, + これ で十分です. + 次のジョブが前のジョブの最終ページの中央の + どこかから印字を開始させないためにも, + 紙の途中で印字の + ジョブが終了したかどうかを確認するのは有益です.</para> + + <para>シェルスクリプト + <filename>/usr/local/libexec/if-simple</filename> + を次のように変更して, プリンタへジョブを送信した後に + FROM FEED 文字を印字させるようにします. </para> + + <programlisting> +#!/bin/sh +# +# if-simple - Simple text input filter for lpd +# Installed in /usr/local/libexec/if-simple +# +# Simply copies stdin to stdout. Ignores all filter arguments. +# Writes a form feed character (\f) after printing job. + +/bin/cat && printf "\f" && exit 0 +exit 2</programlisting> + </listitem> + </varlistentry> + + <varlistentry><term>“階段効果”が現れた</term> + <listitem> + <para>次のような印字結果が得られた. </para> + + <programlisting> +!"#$%&'()*+,-./01234 + "#$%&'()*+,-./012345 + #$%&'()*+,-./0123456</programlisting> + + <para>あなたは<emphasis>「階段効果」</emphasis> + の新たなる犠牲者になってしま いました. この原因は, + 改行を表わすべき文字がなんであるか + の解釈が混乱していることにあります. UNIX + スタイルのオ ペレーティングシステムでは, 改行文字は + ASCII コード10 の line feed (LF) + の1文字が使われています. MS-DOS や OS/2などは ASCII + コード10の LF <emphasis>と</emphasis>, ASCII コード + 13の文字 (carriage return または CR) + をペアで使います. (訳注:Machintosh では CR + のみで表現されています). 大抵のプリンタでは, + 改行を表わすために MS-DOS の慣習にしたが + います.</para> + + <para>FreeBSD で印字する場合, 印字したテキストは LF + 文字だけ が使われていました. プリンタでは LF + 文字を見つけると, 紙を1行分送り出しました. しかし, + 次の文字を印字するた + めの紙の水平方向の位置は維持されました. すなわち, CR + 文字が意味することは, + 次の文字を印字する位置を紙の左端 + に動かすことです.</para> + + <para>FreeBSD + がプリンタに動作をして欲しいと思っている動作を + 以下に示します. </para> + + <informaltable frame="none"> + <tgroup cols="2"> + <tbody> + <row> + <entry>プリンタが CR を受け取ったとき</entry> + <entry>CR 動作 (復帰) をおこなう</entry> + </row> + + <row> + <entry>プリンタが LF を受け取ったとき</entry> + <entry>CR + LF 動作 (復帰, 改行) をおこなう</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>このように動作させるための方法が + いくつかあります.</para> + + <itemizedlist> + <listitem> + <para>これらの文字の解釈を変えるために, プリンタ + の設定スイッチかコントロールパネルを操作する方 + 法. どのようにして設定をするかはプリンタのマニュ + アルを参照してください.</para> + + <note> + <para>FreeBSD 以外のオペレーティン + グシステムを切り替えて使う場合, CR と LF 文字 + の解釈をそのオペレーティングシステムで使われて + いるようにプリンタを + <emphasis>再設定</emphasis>する必要がある + かもしれません. 以下に示す解決方法のいずれかを + 選ぶのがよいかもしれませんね.</para> + </note> + </listitem> + + <listitem> + <para>自動的に LF を CR+LF に変換してくれる + FreeBSD 用のシリアルドライバを入手する方法. も + ちろん, このドライバはプリンタ専用に接続される + シリアルポート + <emphasis>のみ</emphasis>で動作します. この機能 + を許可するためには, + <filename>/etc/printcap</filename> ファ + イルで対象プリンタの <literal>fs</literal> + 項目で CRMOD ビッ トをセットします.</para> + </listitem> + + <listitem> + <para>LF + 文字の扱いを一時的に変更するための<emphasis>エ + スケープコード</emphasis>をプリンタに送る方法. + プリンタ + がサポートしているかもしれないエスケープコード + については, プリンタのマニュアルを参照してくだ + さい. 適切なエスケープコードが見つかったら, 最 + 初にそのコードを送り, 次にプリントジョブを送信 + するようにテキストフィルタを変更してください. + </para> + + <para>次に, Hewlett Packard 社の PCL + エスケープコー + ドに対応しているプリンタのためのテキストフィル + タの例を示します. このフィルタでは, プリンタ に + LF 文字を LF と CR の2文字として扱わせます. + その後に, プリンタにジョブを送ります. 最後に, + ジョブの最終ページの紙を排出するため, FROM FEED + 文字を送ります. このフィルタは Hewlett Packard + 社のほとんどすべてのプリンタで機能するは + ずです.</para> + + <programlisting> +#!/bin/sh +# +# hpif - Simple text input filter for lpd for HP-PCL based printers +# Installed in /usr/local/libexec/hpif +# +# Simply copies stdin to stdout. Ignores all filter arguments. +# Tells printer to treat LF as CR+LF. Writes a form feed character +# after printing job. + +printf "\033&k2G" && cat && printf "\f" && exit 0 +exit 2</programlisting> + + <para>ホスト orchid にある + <filename>/etc/printcap</filename> の + 例を以下に示します. ここには, 一番目のパラレル + ポートにプリンタ (Hewlett Packard LaserJet 3Si) + が一台接続されており, そのプリンタ名は + <hostid>teak</hostid> です. </para> + + <programlisting> +# +# /etc/printcap for host orchid +# +teak|hp|laserjet|Hewlett Packard LaserJet 3Si:\ + :lp=/dev/lpt0:sh:sd=/var/spool/lpd/teak:mx#0:\ + :if=/usr/local/libexec/hpif:</programlisting> + </listitem> + + <listitem> + <note> + <para><emphasis>訳注:</emphasis> LF を CR+LF + に置き換える cat コマンド + を作る方法も当然考えられます. そして, このコマ + ンドと, <emphasis + remap=tt>if-simple</emphasis> の cat の部分 + を置き換えればよいわけです. 具体的にどのように + するかは, 読者への練習問題としましょう.</para> + </note> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>各行が重ね書きされてしまった</term> + <listitem> + <para>プリンタは紙送りをまったくしませんでした. + テキストすべての行 + がある行の上で重ねて印字されてしまいました.</para> + + <para>この問題は, + 階段現象とは“正反対”な問題で, ほとんどま + れにしか起こりません. FreeBSDでは行末として扱われる + LF 文字が, 紙の左端に印字位置を復帰しますが, + 紙送りはしな い CR 文字として扱われています.</para> + + <para>プリンタの設定スイッチかコントロールパネルを + 使って, LF と CR + の文字を次のような解釈をするようにしてください. + </para> + + <informaltable frame="none"> + <tgroup cols="2"> + <thead> + <row> + <entry>プリンタが受け取ったとき</entry> + <entry>プリンタがおこなう</entry> + </row> + </thead> + + <tbody> + <row> + <entry>CR</entry> + <entry>CR 動作 (復帰)</entry> + </row> + + <row> + <entry>LF</entry> + <entry>CR + LF (復帰, 改行)</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <note> + <para><emphasis>訳注:</emphasis> LF を CR+LF + に置き換える cat コマンドを作る方法 + も当然考えられます. そして, このコマンドと, + <filename>if-simple</filename> の cat + の部分を置き換えればよいわけ です. + 具体的にどのようにするかは, 読者への練習問題とし + ましょう.</para> + </note> + </listitem> + </varlistentry> + + <varlistentry><term>プリンタが文字を紛失してしまう</term> + <listitem> + <para> 印字しているのですが, + 各行の2〜3文字が印字されません. + プリンタを動かせば動かすほど, + もっとたくさんの文字が紛 失されていき, + この問題は更に悪くなっていくかもしれませ + んでした.</para> + + <para>この問題は, + シリアルポートを通してコンピュータから送ら + れてくるデータの速度に, + プリンタがついていけないことに 起因します + (この問題は, パラレルポートに接続されたプリ + ンタでは発生することはありません). + この問題を克服する 方法が2つあります. </para> + + <itemizedlist> + <listitem> + <para>プリンタが XON/XOFF のフロー制御をサポート + している場合は, 項目 <literal>fs</literal> で + TANDEM ビット をセットして, FreeBSD + にこの機能を使用させて ください.</para> + </listitem> + + <listitem> + <para>プリンタがキャリアフロー制御をサポートして + いる場合は, 項目 <literal>fs</literal> で MDMBUF + ビットをセッ トして下さい. それから, + プリンタとコンピュータ + を接続しているシリアルケーブルがキャリアフロー + 制御用に正しく配線されたものかどうかを確認して + ください.</para> + </listitem> + + <listitem> + <para>プリンタがフロー制御をまったく + サポートしていな い場合は, 項目 + <literal>fs</literal> の NLDELAY と TBDELAY, + CRDELAY, VTDELAY, BSDELA のいくつかのビッ + トを組み合わせて使い, プリンタへ送るデータの流 + れに適当な遅延を加えてください.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + + <varlistentry><term>プリンタは意味不明な + 文字列を印字した</term> + <listitem> + <para>プリンタはランダムなゴミのように + 見えるものを印字しまし たが, + 意図したテキストは印字してくれませんでした.</para> + + <para>この問題は, 通常, + シリアルポートに接続したプリンタでの + 通信パラメータの誤りからくる前項とは別の症状です. + <literal>br</literal> 項目の通信速度と + <literal>fs</literal> と <literal>fc</literal> + 項目のパリ ティビットの設定を共に調べてみてください. + また, プリン タでの設定が + <filename>/etc/printcap</filename> + ファイルで設定した + 内容と一致しているかどうかも確認してください.</para> + + <note> + <para><emphasis>訳注:</emphasis> simple-if + のような単純なフィルタだけの状態で, 日 + 本語を含むテキストを印字しようとした場合にも, + シリアル ポート, パラレルポートの使用に関係なく, + このような症状 は見られます. 日本語プリンタの場合, + 漢字コードそのもの + を送信しただけでその漢字を印字してくれるものは, + 少なく とも訳者は見たことがありません. + 漢字を印字するための制御 + コードを別途送信するフィルタが必要となります. + また, そ のようなフィルタを使用していても, + そのフィルタが想定し + てる漢字コードと異なった文書を + プリントしようとしたとき もこのような症状は出ます. + もちろん, これはプリンタ用の + 言語を持たないプリンタの話で, PostScript プリンタ + などにプレインテキストを送信しても, 日本語対応, + 非対応 に関らず, 意味不明な文字列が印字される + (もしくは, 何も 印字されない) ことでしょう.</para> + </note> + </listitem> + </varlistentry> + + <varlistentry><term>何も起きない</term> + <listitem> + <para>もしプリンタが何の動作もしないのであれば, + ハード的な問 題ではなく, 多分 FreeBSD + の中に問題があります. + <filename>/etc/printcap</filename> ファイルで, + デバッグしているプ リンタのエントリに + (<literal>lf</literal> 項目で) ログファイルを取るよ + うに設定を追加してください. 例えば, プリンタ + <literal>rattan</literal> 用のエントリの項目 + <literal>lf</literal> は次のようになります. </para> + + <programlisting> +rattan|line|diablo|lp|Diablo 630 Line Printer:\ + :sh:sd=/var/spool/lpd/rattan:\ + :lp=/dev/lpt0:\ + :if=/usr/local/libexec/if-simple:\ + :lf=/var/log/rattan.log</programlisting> + + <para>次に, もう一度印字をおこなってみます. そして, + 発生したと思 + われるエラーメッセージを見るためにログファイル + (上記の 例では, + <filename>/var/log/rattan.log</filename>) + を調べます. そこ で見られたメッセージを元に, + 問題を解決してみてください.</para> + + <para>項目 <literal>lf</literal> + が指定されていない場合, LPD はデフォルト + のログファイルとして + <filename>/dev/console</filename> を使います.</para> + </listitem> + </varlistentry> + </variablelist> + </sect4> + </sect3> + </sect2> + </sect1> + + <sect1 id="printing-using"> + <title>プリンタを使う</title> + + <para>この節では, FreeBSD で設定したプリンタを使う方法について説明 + します. ここでは, ユーザレベルでのコマンドを概説します. </para> + + <variablelist> + <varlistentry><term>&man.lpr.1;</term> + <listitem> + <para>印字をおこないます.</para> + </listitem> + </varlistentry> + + <varlistentry><term>&man.lpq.1;</term> + <listitem> + <para>プリンタキューを調べます.</para> + </listitem> + </varlistentry> + + <varlistentry><term>&man.lprm.1;</term> + <listitem> + <para>プリンタキューにあるジョブを削除します.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>管理者用コマンド &man.lpc.8; もありますが, + これは 「<link linkend="printing-lpc">プリンタを管理する</link>」 + に記 + します. このコマンドは, プリンタやそのキューの制御のために用い + られます.</para> + + <para>&man.lpr.1;, &man.lprm.1;, そして &man.lpq.1; の 3 + コマンドは, <option>-P<replaceable>printer-name</replaceable></option> + オプションをとり, これによって, + <filename>/etc/printcap</filename> のように操作の対象となる + プリンタやキュー + を指定します. これによって, 様々なプリンタに対してジョブを送る + , 取り消す, 調査することができます. + <option>-P</option> が使われなかった場 + 合は, これらのコマンドは + <envar>PRINTER</envar> 環境変数で指定されたプリンタ + を使用します. + そして, <envar>PRINTER</envar> 環境変数がなかった場合は, これ + らのコマンドはデフォルトのプリンタ + <literal>lp</literal> を使います.</para> + + <para>以下では, <emphasis>デフォルトプリンタ</emphasis> + という用語が意味するプリンタ は, <envar>PRINTER</envar> + 環境変数で指定されたプリンタ, もしくは, <envar>PRINTER</envar> + 環境変数がない場合は, <literal>lp</literal> + という名前のプリンタです.</para> + + <sect2 id="printing-lpr"> + <title>印字する</title> + + <para>ファイルを印字するためには, + 次のように入力してください.</para> + + <screen>&prompt.user; <userinput>lpr <replaceable>filename</replaceable> <replaceable>...</replaceable></userinput></screen> + + <para>これにより, + 入力されたファイルのそれぞれをデフォルトのプリンタ + から印字します. ファイル名が与えられなかった場合, + &man.lpr.1; + は標準入力から印字するデータを読み込みます. 例えば, 次のコマン + ドにより, ある重要なシステムファイルが印字されます. </para> + + <screen>&prompt.user; <userinput>lpr /etc/host.conf /etc/hosts.equiv</userinput></screen> + + <para>印字させるプリンタを選択するためには, + 次のように入力します. </para> + + <screen>&prompt.user; <userinput>lpr -P <replaceable>printer-name</replaceable> <replaceable>filename</replaceable> <replaceable>...</replaceable></userinput></screen> + + <para>次の例では, プリンタ <literal>rattan</literal> に, + カレントディレクトリにあ + るファイルの詳細なリストを印字しています. </para> + + <screen>&prompt.user; <userinput>ls -l | lpr -P rattan</userinput></screen> + + <para>上記の &man.lpr.1; コマンドではファイル名の指定がないので, + <command>lpr</command> は標準入力から印字するデータ, + この場合, <command>ls -l</command> + コマンドの出力, を読み込みます.</para> + + <para>&man.lpr.1; コマンドでは, + 出力の整形を制御したり, ファイル変換を + 適用したり, 複数部数のコピーを作成したり, などといた様々な幅広 + いオプションを受け付けることもできます. + 詳細については, + 「<link linkend="printing-lpr-options"> + その他の印字オプション</link>」をご + 覧ください.</para> + </sect2> + + <sect2 id="printing-lpq"> + <title>ジョブの処理状況を調べる</title> + + <para>&man.lpr.1; コマンドを使って印字をする場合, プリントしようと + するデータは “プリントジョブ” + と呼ばれる箱に一緒に置かれ, こ + れが LPD スプーリングシステムに送られます. プリンタにはそれぞ + れ, ジョブ用のキューがあり, + 送られてきたジョブはあなたや他のユー + ザからの別のジョブと一緒にそのキューで並んで, + 処理される順番を + 待ちます. + プリンタは到着順にこれらのジョブの印字をおこないます.</para> + + <para>デフォルトプリンタのキューの状態を表示するには, + &man.lpq.1; と入 + 力します. プリンタを指定するときは, + <option>-P</option> オプションを使い + ます. 例えば, 次のコマンド</para> + + <screen>&prompt.user; <userinput>lpq -P bamboo</userinput></screen> + + <!-- kuriyama - hostid should literal --> + <para>は, プリンタ <hostid>bamboo</hostid> + のキューの状態を表示します. この <command>lpq</command> + コマンドの出力結果の例を次に示します. </para> + + <screen>bamboo is ready and printing +Rank Owner Job Files Total Size +active kelly 9 /etc/host.conf, /etc/hosts.equiv 88 bytes +2nd kelly 10 (standard input) 1635 bytes +3rd mary 11 ... 78519 bytes</screen> + + <para>この例では, <literal>bamboo</literal> + のキューに3つのジョブがあることが分か ります. + 最初のジョブはユーザ kelly からのものであり, “ジョ + ブ番号”9が割り当てられています. + プリンタのすべてのジョブには一意 + なジョブ番号が付けられています. ほとんどの場合, このジョブ番号 + は無視することができますが, ジョブをキャンセルするときにはこの + 番号が必要になります. このことの詳細については, 「<link + linkend="printing-lprm">ジョブの削除</link> + 」をご覧ください.</para> + + <para>ジョブ番号9のジョブは2つのファイルを処理します. すなわち, + &man.lpr.1; + のコマンドラインに複数のファイル名が与えられたときは, + 1つのジョブとして扱われるのです. このジョブは, 現在, アクティ + ブジョブ (“Rank” + の欄の <literal>active</literal> という後に注目) になってい + ます. これは, プリンタからそのジョブが現在印字されているはずで + あることを意味しています. 2番目のジョブでは, + &man.lpr.1; コマン + ドに標準入力からデータが与えられています. + 3番目のジョブはユー + ザ mary から与えられました. + このジョブのサイズはとても大きくなっ + ています. 彼女がプリントしようとしたファイルのパス名はここで表 + 示させるには長すぎるため, + &man.lpq.1; コマンドはドットを3つだけ + 表示しています.</para> + + <para>&man.lpq.1; からの + 出力で一番最初の行もまた有益な情報を与えていま + す. この行から, プリンタが現在何をしているか (あるいは, 少なく + とも LPD がプリンタが + していると思っていること) が分かります.</para> + + <para>&man.lpq.1; コマンドは + <option>-l</option> オプションもサポートしています. こ + れにより, + 詳しい情報が表示されます. <command>lpq -l</command> の実行例を次 + に示します. </para> + + <screen>waiting for bamboo to become ready (offline ?) +kelly: 1st [job 009rose] + /etc/host.conf 73 bytes + /etc/hosts.equiv 15 bytes + +kelly: 2nd [job 010rose] + (standard input) 1635 bytes + +mary: 3rd [job 011rose] + /home/orchid/mary/research/venus/alpha-regio/mapping 78519 bytes</screen> + </sect2> + + <sect2 id="printing-lprm"> + <title>ジョブの削除</title> + + <para>印字するようジョブを + 送った後で印字を中断したくなったときは, + &man.lprm.1; コマンドで, + キューの中からそのジョブを削除することが + できます. 大抵の場合, アクティブジョブでさえも + &man.lprm.1; を使っ + て削除することができますが, + そのジョブの一部またはすべてが印字さ + れてしまうかもしれません.</para> + + <para>デフォルトプリンタへのジョブを削除するためには, 最初に, + &man.lpq.1; を使ってそのジョブ番号を調べます. + すなわち, それから, + 次のように入力して, ジョブを削除します. </para> + + <screen>&prompt.user; <userinput>lprm <replaceable>job-number</replaceable></userinput></screen> + + <para>特定のプリンタへのジョブを削除するときは, + <option>-P</option> オプション + を使ってそのプリンタを指定します. + 例えば, プリンタ <hostid>bamboo</hostid> + のキューからジョブ番号 + 10のジョブを削除するには次のようにします. </para> + + <screen>&prompt.user; <userinput>lprm -P bamboo 10</userinput></screen> + + <para>&man.lprm.1; コマンドには略記法がいくつかあります. </para> + + <variablelist> + <varlistentry><term>lprm -</term> + <listitem> + <para>あなたが (デフォルトプリンタへ) + 送ったジョブをすべて削除し ます.</para> + </listitem> + </varlistentry> + + <varlistentry><term>lprm <replaceable>user</replaceable></term> + <listitem> + <para>ユーザ <replaceable>user</replaceable> が + (デフォルトプリンタへ) 送ったジョブ をすべて削除します. + 他のユーザのジョブを削除できるのはスー パユーザだけです. + あなたは, あなた自身のジョブしか削 + 除することはできません.</para> + </listitem> + </varlistentry> + + <varlistentry><term>lprm</term> + <listitem> + <para>ジョブ番号もユーザ名もシンボル + <option>-</option>も指定されない + ときは, &man.lprm.1; は現在のアクティブジョブを, そのジョ + ブを送ったのがあなた自身であるときに限り, デフォルトプ + リンタから削除します. ただし, スーパユーザは任意のア + クティブジョブを削除することができます.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>上記の略記法をデフォルトプリンタではなく + 特定のプリンタに対して おこなうときは, <option>-P</option> + オプションでそのプリンタを指定するだけよ いのです. 例えば, + プリンタ <literal>rattan</literal> のキューへあなたが送っ + たジョブをすべて削除するためには次のようにします.</para> + + <screen>&prompt.user; <userinput>lprm -P rattan -</userinput></screen> + + <note> + <para>ネットワーク環境で作業をしている場合, あるホストか + ら送られたプリンタジョブは, これを送ったホストで + &man.lprm.1; を + 使った場合に限って, + これを削除することができます. 他のホストで + 同じプリンタを使えたとしても, + このジョブを削除することはできま + せん. + 次の例では, 他ホストからジョブを削除することを試みていま + す. </para> + + <screen>&prompt.user; <userinput>lpr -P rattan myfile</userinput> +&prompt.user; <userinput>rlogin orchid</userinput> +&prompt.user; <userinput>lpq -P rattan</userinput> +Rank Owner Job Files Total Size +active seeyan 12 ... 49123 bytes +2nd kelly 13 myfile 12 bytes +&prompt.user; <userinput>lprm -P rattan 13</userinput> +rose: Permission denied +&prompt.user; <userinput>logout</userinput> +&prompt.user; <userinput>lprm -P rattan 13</userinput> +dfA013rose dequeued +cfA013rose dequeued + </screen> + </note> + </sect2> + + <sect2 id="printing-lpr-options"> + <title>その他の印字オプション</title> + + <para>&man.lpr.1; コマンドには, テキストの整形や, + 図や他のファイル形 + 式の変換, 複数部コピーの生成, ジョブの扱いなどをを制御すること + ができます. + この節では, これに関するオプションについて記してい + ます.</para> + + <sect3 id="printing-lpr-options-format"> + <title>整形と変換に関するオプション</title> + + <para>以下の &man.lpr.1; 用のオプションはジョブにおける + ファイルの + 整形の制御に関するものです. + このオプションは, ジョブにプレイン + テキストが含まれない場合や + &man.pr.1; ユーティリティを使ってプレイ + ンテキストを整形する場合に用いてください.</para> + + <para>次の例では, プリンタ + <literal>bamboo</literal> に (TeX 組版システムによる) + DVI ファイル + <filename>fish-report.dvi</filename> を印字しています. </para> + + <screen>&prompt.user; <userinput>lpr -P bamboo -d fish-report.dvi</userinput></screen> + + <para>このオプションは, + ジョブに含まれるすべてのファイルに対して適用さ れます. + したがって, 1つのジョブに (例えば) DVI ファイルと ditroff + ファイルを混在させることはできません. その代わりに, + ファイルを 形式毎に別々のジョブに分け, + それぞれのジョブでその形式用の変換 + オプションを使って印字してください.</para> + + <note> + <para><option>-p</option> と <option>-T</option> + を除くすべてのオプションを使用 するためには, + 出力先プリンタ用の変換フィルタが必要です. 例えば, + <option>-d</option> オプションを使用するには, DVI + 用の変換フィルタが必要 です. 詳細については, 「<link + linkend="printing-advanced-convfilters"> + 変換フィルタ</link>」で説明しています.</para> + </note> + + <variablelist> + <varlistentry><term><option>-c</option></term> + <listitem> + <para>cifplot ファイルを印字します.</para> + </listitem> + </varlistentry> + + <varlistentry><term><option>-d</option></term> + <listitem> + <para>DVI ファイルを印字します.</para> + </listitem> + </varlistentry> + + <varlistentry><term><option>-f</option></term> + <listitem> + <para>FORTRAN プログラムを印字します.</para> + </listitem> + </varlistentry> + + <varlistentry><term><option>-g</option></term> + <listitem> + <para>plot のデータを印字します.</para> + </listitem> + </varlistentry> + + <varlistentry><term><option>-i <replaceable>number</replaceable></option></term> + <listitem> + <para>出力に対して, <replaceable>number</replaceable> + カラム分の字下げをおこないます. + <replaceable>number</replaceable> が省略されると, + 8カラム分字下げされます. + このオプションはある変換フィルタと一緒の指定されたとき + のみに機能します.</para> + + <note> + <para><option>-i</option> + と数字の間に空白を入れてはいけません.</para> + </note> + </listitem> + </varlistentry> + + <varlistentry><term><option>-l</option></term> + <listitem> + <para>制御文字を含む文字通りの + テキストデータを印字します.</para> + </listitem> + </varlistentry> + + <varlistentry><term><option>-n</option></term> + <listitem> + <para>ditroff (device independent troff) データ + を印字します.</para> + </listitem> + </varlistentry> + + <varlistentry><term>-p</term> + <listitem> + <para>印字する前に &man.pr.1; + によってプレインテキストを整形し + ます. 詳細については &man.pr.1; をご覧ください.</para> + </listitem> + </varlistentry> + + <varlistentry><term><option>-T <replaceable>title</replaceable></option></term> + <listitem> + <para>&man.pr.1; コマンドにより生成されるヘッダを, + ファイル名の + 代わりに <replaceable>title</replaceable> とする. + このオプションは, <option>-p</option> + と一緒に使ったときのみ機能する.</para> + </listitem> + </varlistentry> + + <varlistentry><term><option>-t</option></term> + <listitem> + <para>troff データを印字します.</para> + </listitem> + </varlistentry> + + <varlistentry><term><option>-v</option></term> + <listitem> + <para>ラスタのデータを印字します.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>次の例では, &man.ls.1; の + マニュアルを美しく整形したものをデフォ + ルトプリンタで印字しています. </para> + + <screen>&prompt.user; <userinput>zcat /usr/share/man/man1/ls.1.gz | troff -t -man | lpr -t</userinput></screen> + + <para>&man.zcat.1; コマンドで + &man.ls.1; のマニュアルのソースファイルの圧 + 縮を復元し, これを + &man.troff.1; コマンドに渡しています. これによ + り, ソースファイルが整形され, GNU troff の形式となります. そ + の結果は &man.lpr.1; に渡され, + LPD スプーラへジョブの要求が発せ + られます. &man.lpr.1; には + <option>-t</option> オプションが使われているため, + スプーラにて, GNU troff の形式からジョブを印字したときにデフォ + ルトプリントが解釈できる形式へと変換されます.</para> + </sect3> + + <sect3 id="printing-lpr-options-job-handling"> + <title>ジョブに関するオプション</title> + + <para>以下のオプションは, &man.lpr.1; によって, そのジョブを特殊 + な扱いにするよう LPD に指示するためのものである.</para> + + <variablelist> + <varlistentry><term>-# <replaceable>copies</replaceable></term> + <listitem> + <para>ジョブに含まれるファイルのそれぞれを + 1部だけ印字するの ではなく, + <replaceable>copies</replaceable> + 部のコピーを生成させるものです. 管理者によっては, + プリンタの消耗を避け, コピー機による + 複製を奨励するためにこのオプションの使用が禁止されてい + るかもしれません. これに関しては, 「<link + linkend="printing-advanced-restricting-copies"> + 複数部のコピーの印字を制限する + </link>」をご覧ください.</para> + + <para>次の例では, デフォルトプリンタで + <filename>parser.c</filename> を3 部コピーし, 次に, + <filename>parser.h</filename> を3部コピーしています. + </para> + + <screen>&prompt.user; <userinput>lpr -#3 parser.c parser.h</userinput></screen> + </listitem> + </varlistentry> + + <varlistentry><term>-m</term> + <listitem> + <para>印字ジョブが完了した後で, メールを送ります. + このオプショ ンを付けると, LPD + システムはジョブの扱いが終了したと きに, + あなたのアカウントにメールを送ります. メールのメッ + セージには, ジョブが正常終了したのか, あるいは, 何か異 + 常があり, (しばしば) + その異常が何であったのかが書かれて います.</para> + </listitem> + </varlistentry> + + <varlistentry><term>-s</term> + <listitem> + <para>印字ファイルをスプールディレクトリにコピーせず, + 代わりに, + シンボリックリンクを作成するよう指示します.</para> + + <para>印字させるジョブのサイズが大きいとき, このオプショ + ンを使うと便利かもしれません. このオプションにより, + スプー ルディレクトリの容量が節約されます (それに, + 巨大なジョ + ブのお陰でスプールディレクトリのあるファイルシステムの + 空き容量がなくなってしまうかもしれません). さらに, + LPD + がいちいちすべてのデータをコピーする必要がなくなりま + すので, 時間の節約にもなります.</para> + + <para>ただし, 欠点もあります. LPD + はオリジナルのファイルを 直接参照するので, + 印字が終了するまでそのファイルを変更 + したり削除することができません.</para> + + <note> + <para>リモートのプリンタで印字している場合, LPD は, + 結局のところ, ローカルホストからリモートホストにファ + イルをコピーする必要があります. したがって, + <option>-s</option> オプ + ションはローカルのスプーリングディレクトリの + 空き容量を 節約するだけで, + リモート側では節約されません. それに も関わらず, + このオプションはそれでも有用です.</para> + </note> + </listitem> + </varlistentry> + + <varlistentry><term>-r</term> + <listitem> + <para>ジョブに含まれるファイルを, + スプーリングディレクトリに + ファイルをコピーした後に削除します. もしくは, + <option>-s</option> オプションと一緒に使われた場合は, + 印字終了後に削除され ます. + このオプションの使用には十分注意して下さい.</para> + </listitem> + </varlistentry> + </variablelist> + </sect3> + + <sect3 id="printing-lpr-options-misc"> + <title>ヘッダページ用オプション</title> + + <para>以下のオプションにより, + ジョブのヘッダページに通常印字さ + れるテキストを + &man.lpr.1; に調整させることができます. 対象のプリ + ンタからヘッダページが出力されない場合は, + これらのオプションは + 何の効力も持ちません. + ヘッダページの設定に関する情報については, + 「<link linkend="printing-advanced-header-pages"> + ヘッダページ</link>」を参照してください.</para> + + <variablelist> + <varlistentry><term>-C <replaceable>text</replaceable></term> + <listitem> + <para>ヘッダページに印字されるホスト名を + <replaceable>text</replaceable> に置き換 えます. なお, + ホスト名の場所には, 通常, ジョブの要求が + あったホストの名前が印字されます.</para> + </listitem> + </varlistentry> + + <varlistentry><term>-J <replaceable>text</replaceable></term> + <listitem> + <para>ヘッダページに印字されるジョブ名を + <replaceable>text</replaceable> に置き換 えます. + ジョブ名の場所には, 通常, ジョブの最初のファイ ル名, + または, 標準入力からデータが印字されたときは + <filename>stdin</filename>が印字されます.</para> + </listitem> + </varlistentry> + + <varlistentry><term>-h</term> + <listitem> + <para>ヘッダページを出力を禁止します.</para> + + <note> + <para>サイトによっ ては, + そのヘッダページの生成方法により, このオプション + の効果が現れないかもしれません. 詳細は, 「<link + linkend="printing-advanced-header-pages"> + ヘッダページ</link>」をご覧ください.</para> + </note> + </listitem> + </varlistentry> + </variablelist> + </sect3> + </sect2> + + <sect2 id="printing-lpc"> + <title>プリンタを管理する</title> + + <para>プリンタの管理者として, プリンタの設置, 設定, + そして, それ + らのテストをおこなう必要がありました. + &man.lpc.8; コマンドにより, + これまでとは別な管理方法がプリンタと対話的におこなわれます. + &man.lpc.8; により, 次のことが可能となります.</para> + + <itemizedlist> + <listitem> + <para>プリンタの起動, 停止をおこなう.</para> + </listitem> + + <listitem> + <para>キューへの入力の許可, 禁止をおこなう.</para> + </listitem> + + <listitem> + <para>それぞれのキューにあるジョブの順番を変更する.</para> + </listitem> + </itemizedlist> + + <para>最初に用語に関する注意をしておきます. + プリンタが<emphasis>停止してい る</emphasis>とは, + キューの中にあるどのジョブも印字されることがない状態 + を言います. この状態においても, + ユーザはまだジョブの要求をおこなう ことができますが, + これらのジョブはキューの中で, + プリンタが<emphasis>スタートする</emphasis>状態になるまで, + あるいは, キューの内容が削除され + るまで待たされることになります.</para> + + <para>キューが<emphasis>禁止状態にある</emphasis>とは, (root + 以外の) すべてのユーザが + プリンタにジョブを要求することができない状態のことを言います. + キューが<emphasis>許可状態にある</emphasis>場合は, + ジョブの入力が許可されます. + キューが<emphasis>禁止状態にある</emphasis>場合でも, + プリンタを<emphasis>スタートす + る</emphasis>状態にすることは可能です. この場合は, + キューが空になるまで, + キュー内のジョブの印字が続けられます.</para> + + <para>一般的に, + &man.lpc.8; コマンドを使用するには root の権限を持って + いる必要があります. 一般のユーザも + &man.lpc.8; コマンドを使うこと + はできますが, プリンタの状態を取得することとハングしたプリンタ + を再スタートすることだけに使用が制限されています.</para> + + <para>以下に, + &man.lpc.8; コマンドに関する説明の要約を述べます. ほとん + どのコマンドでは, 操作対象となるプリンタを指定するため + <replaceable>printer-name</replaceable> 引数を与えます. + <replaceable>printer-name</replaceable> の代わり + に <literal>all</literal> が与えられると, 操作は + <filename>/etc/printcap</filename> 内に + ある全プリンタに対しておこなわれることになります.</para> + + <variablelist> + <varlistentry><term><command> + abort <replaceable>printer-name</replaceable></command></term> + <listitem> + <para>現在のジョブをキャンセルし, プリンタを停止させます. + キュー が許可状態にある場合は, + ユーザはまだジョブを入力する ことができます.</para> + </listitem> + </varlistentry> + + <varlistentry><term><command> + clean <replaceable>printer-name</replaceable></command></term> + <listitem> + <para>プリンタのスプーリングディレクトリから, + ジョブの古いファ イルを削除します. 状況によって, + とりわけ, 印字途中でエ ラーが発生していたり, + 管理操作が頻発していた場合には, + ジョブで作られたファイルを LPDが完全に削除しないことが + あります. このコマンドでは, スプーリングディレクトリに + 入っていないファイルを見つけ出し, + それを削除しています.</para> + </listitem> + </varlistentry> + + <varlistentry><term><command> + disable <replaceable>printer-name</replaceable></command></term> + <listitem> + <para>キューに新しいジョブを入れることを禁止します. + プリンタ がスタート状態にあるときは, + キューに残っているジョブの 印字は続けられます. ただし, + キューが禁止状態にあったと しても, スーパーユーザ (root) + は常にジョブを入力するこ とができます.</para> + + <para>このコマンドは, + 新しいプリンタやフィルタを設置している + 間に使用すると有用です. すなわち, キューを禁止状態にし + ておくと, root によるジョブのみが入力されます. そして, + その他のユーザは, テストが完了し, + <command>enable</command> コマン + ドでキューが再度許可状態になるまで, ジョブの入力はでき + なくなります.</para> + </listitem> + </varlistentry> + + <varlistentry><term><command> + down <replaceable>printer-name</replaceable> + <replaceable>message</replaceable></command></term> + <listitem> + <para>プリンタをダウンさせます. これは, + <command>disable</command> をおこなっ + た後で, <command>stop</command> をおこなった場合と + 等価になります. + <replaceable>message</replaceable> は, ユーザが + &man.lpq.1; コマンドでプリンタ + のキューの状態を調べたり, <command>lpc status</command> + でプリンタの + 状態を調べたときに, プリンタの状況として表示されるメッ + セージです.</para> + </listitem> + </varlistentry> + + <varlistentry><term><command> + enable <replaceable>printer-name</replaceable></command></term> + <listitem> + <para>プリンタのキューを許可状態にします. + ユーザはジョブの入 力ができるようになりますが, + プリンタがスタートの状態に なるまでは, + プリンタからは何も印字されません.</para> + </listitem> + </varlistentry> + + <varlistentry><term><command> + help <replaceable>command-name</replaceable></command></term> + <listitem> + <para><replaceable>command-name</replaceable> + コマンドのヘルプメッセージを表示しま + す. <replaceable>command-name</replaceable> + が指定されなかった場合は, 利用 + できるコマンドの要約が表示されます.</para> + </listitem> + </varlistentry> + + <varlistentry><term><command> + restart <replaceable>printer-name</replaceable></command></term> + <listitem> + <para>プリンタをスタートさせます. 通常のユーザは, LPD があ + る異常な状況でハングしたときに限り, このコマンドを使用 + することができます. しかし, <command>stop</command> + または <command>down</command> コマンドにより, + 停止状態にあるプリンタをスター トさせることはできません. + <command>restart</command> コマンドは, + <command>abort</command> の後に <command>start</command> + をおこなったことと同じになり ます.</para> + </listitem> + </varlistentry> + + <varlistentry><term><command> + start <replaceable>printer-name</replaceable></command></term> + <listitem> + <para>プリンタをスタートさせます. + プリンタのキューにあるジョ + ブを印字することでしょう.</para> + </listitem> + </varlistentry> + + <varlistentry><term><command> + stop <replaceable>printer-name</replaceable></command></term> + <listitem> + <para>プリンタを停止します. プリンタは, + 現在のジョブを終了さ せ, そして, + キューにあるその他のジョブは印字しません. + プリンタが停止状態にあったとしても, まだ, 許可状態にあ + るキューに対して, ジョブを送ることができます.</para> + </listitem> + </varlistentry> + + <varlistentry><term><command> + topq <replaceable>printer-name</replaceable> + <replaceable>job-or-username</replaceable></command></term> + <listitem> + <para><replaceable>printer-name</replaceable> + のキューに対して, ジョブ番号 + <replaceable>job</replaceable> のジョブ, または, ユーザ + <replaceable>username</replaceable> から送 + られたジョブを置き換えて, キューの先頭に持ってきます. + このコマンドに関しては, + <replaceable>printer-name</replaceable> の代わりに + <literal>all</literal> + を使用することはできません.</para> + </listitem> + </varlistentry> + + <varlistentry><term><command> + up <replaceable>printer-name</replaceable></command></term> + <listitem> + <para>プリンタをアップ状態にします. これの反対のコマンドが + <command>down</command> です. <command>start</command> + の次に <command>enable</command> をおこなっ + たことと等しくなります.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>コマンドラインから上記のコマンドを入力すると, + &man.lpc.8; はこれ + を受け付けます. コマンドが入力されなかった場合は, + &man.lpc.8; は + 対話モードに入り, + <command>exit</command>, <command>quit</command>, + または, ファイル終端 + 文字が入力されるまでコマンドの入力ができます.</para> + </sect2> + </sect1> + + <sect1 id="printing-advanced"> + <title>プリンタ設定上級編</title> + + <para>この節では, 特殊な形式のファイルを印字するためのフィルタ, + ヘッ ダページ, ネットワーク越しのプリンタへの印字, そして, + プリンタ 使用の制限や課金について説明しています.</para> + + <sect2 id="printing-advanced-filter-intro"> + <title>フィルタ</title> + + <para>LPD では, ネットワークプロトコル, キュー, アクセス制御, そ + して, 印字のためのその他の側面について扱いますが, + <emphasis>実際の</emphasis> 作業のほとんどは + <emphasis>フィルタ</emphasis> によっておこなわれています. + フィルタ は, プリンタと通信し, + プリンタのデバイス依存性や特殊な要求を扱 うプログラムです. + 簡単なプリンタ設定では, プレインテキストのた + めのフィルタをインストールしました. このプレインテキストフィル + タは, ほとんどのプリンタで機能する極めて単純なものでした. + (「<link linkend="printing-textfilter"> + テキストフィルタのインストール</link>」を参照)</para> + + <para>しかしながら, 形式変換やプリンタ課金, 特定のプリンタの癖, + など をうまく利用するためには, + フィルタがどのように機能するかという + ことを理解しておくべきです. これらの側面を扱うためには, 最終的 + には, フィルタの責任であるからです. そして, これは悪い情報です + が, ほとんどの場合において, + <emphasis>あなた自身</emphasis>がフィルタを供給す + る必要があるということです. また都合のよいことには, + たくさんのフィルタが 一般的に利用できるということです. + もしフィルタがなかったとし ても, 普通は, + フィルタを作るのは簡単です.</para> + + <para>FreeBSD にも, プレインテキストを印字させることができる + <filename>/usr/libexec/lpr/lpf</filename> + というフィルタが1つ付いています. + (このフィルタはファイルに含まれるバックスペースやタブを扱いま + す. また, 課金をすることもできますが, できることはこれだけしか + ありません.) いくつかのフィルタとフィルタの構成要素が FreeBSD + の ポート集にもあります.</para> + + <para>この節で述べることは次の通りです.</para> + + <itemizedlist> + <listitem> + <para>「<link linkend="printing-advanced-filters"> + フィルタはどのように機能しているか</link>」では, + 印字の過程におけ るフィルタの役割を概説します. + この節を読むことで, LPD がフィルタを使うときに, + “見えないところで”何が起こっている + かが理解できるでしょう. このことを知っておくと, プリン + タそれぞれに様々なフィルタをインストールしたときに遭遇 + するかもしれない問題を予期したり, デバッグするときに役 + 立つでしょう.</para> + </listitem> + + <listitem> + <para>LPD では, すべてのプリンタからデフォルトでプレインテ + キストを印字できることを期待しています. このことは, プ + レインテキストを直接印字できない PostScript (また + は他の言語用の) プリンタでは問題を引き起こします. 「<link + linkend="printing-advanced-if-conversion"> + プレインテキストのジョブを PostScript + プリンタで印字する</link>」 で, + この問題を克服する方法について述べます. PostScript + プリンタをお持ちの方は, この節をお読みになること + をお薦めします.</para> + </listitem> + + <listitem> + <para>PostScript は様々なプログラムのための有名な出 + 力形式です. ある人たちは (著者自身を含めて) PostScript + のコードさえも直接書いてしまいます. しかし, PostScript + プリンタは高価です. 「<link + linkend="printing-advanced-ps">非 PostScript プリンタで + PostScript をシミュレートする</link>」では, PostScript + データを<emphasis>非 PostScript + プリンタ</emphasis>に受けつけさせ, 印字させるために, + どのようにしてプリンタ用のテキストフィルタをさらに変更 + すればよいのか, ということについて述べます. PostScript + プリンタを持っていない方は, この節をお読みになる + ことをお薦めします.</para> + </listitem> + + <listitem> + <para>「<link linkend="printing-advanced-convfilters"> + 変換フィルタ</link>」では, 図形や組版データといっ + た特定のファイル形式を, プリンタが理解できる形式へ変換 + する作業を自動的におこなわせる方法について述べます. この節 + を読むと, troff のデータを印字するには <command>lpr + -t</command>, または, TeX DVI を印字するには + <command>lpr -d</command>, ラスタイ + メージデータを印字するには <command>lpr -v</command>, + などといったよ + うにユーザが入力することができるようにプリンタの設定を + おこなうことができます. この節もお読みになることをお薦めし + ます.</para> + </listitem> + + <listitem> + <para>「<link + linkend="printing-advanced-of">出力フィルタ</link>」 + では, あまり使われない LPD の機能のすべて, すなわち, + 出力フィルタに関することが記述されています. ヘッダページ + (「<link linkend="printing-advanced-header-pages"> + ヘッダページ</link>」参照) を印字させていない場合は, + 多分, この節は飛ばしても構わないでしょう.</para> + </listitem> + + <listitem> + <para>「<link + linkend="printing-advanced-lpf">テキストフィルタ + lpf</link>」では, <command>lpf</command> + についての説明が, ほぼ完全におこなわれています. これは + FreeBSD に付属するラ インプリンタ (または, + ラインプリンタのように動作するレー ザプリンタ) のための, + 単純なテキストフィルタです. プレ + インテキストを印字したことに対して課金をおこなう方法が至急 + 必要な場合, もしくは, バックスペース文字を印字しようと + すると煙を発するプリンタを持っている場合は, 絶対に + <command>lpf</command> を検討するべきです.</para> + </listitem> + </itemizedlist> + + <sect3 id="printing-advanced-filters"> + <title>フィルタはどのように機能しているか</title> + + <para>既に言及したように, フィルタとは, プリンタにデータを送る + 際に, デバイスに依存した部分を取り扱うために LPD + によって起動 される実行プログラムです.</para> + + <para>LPD がジョブ中のファイルを印字しようとするとき, LPD + はフィル タプログラムを起動します. このとき, + フィルタの標準入力を印字す るファイルに, + 標準出力をプリンタに, そして, 標準エラー出力をエ + ラーログファイル (<filename>/etc/printcap</filename> 内の + <literal>lf</literal> 項目で指 定されたファイル, または, + 指定されていない場合は, デフォルトと して + <filename>/dev/console</filename>) にセットします.</para> + + <para>LPD が起動するフィルタと, その引数が何であるかは, + <filename>/etc/printcap</filename> + ファイルの内容と, ジョブの起動時に + ユーザが指定した + &man.lpr.1; コマンドの引数に依存しています. 例え + ば, ユーザが <command>lpr -t</command> と入力した場合は, + LPD は出力先のプリ + ンタ用の <literal>tf</literal> 項目で指定されている troff + 用のフィルタを起動 + させるでしょう. + ユーザがプレインテキストの印字を指示したときは, + <literal>if</literal> で指定されたフィルタが + 起動されるでしょう (このことはほ + とんどの場合にあてはまります. + 詳細については, 「<link linkend="printing-advanced-of"> + 出力フィルタ</link>」をご覧ください).</para> + + <para><filename>/etc/printcap</filename> + で指定可能なフィルタは次の3種類がありま す. </para> + + <itemizedlist> + <listitem> + <!-- kuriyama - shoule 'para'rize? --> + <para><emphasis>テキストフィルタ</emphasis> + (LPD のドキュメントでは紛ら + わしいことに + <emphasis>入力フィルタ</emphasis>と呼んでいますが) は一般の + テキストの印字を扱います. これはデフォルトのフィルタと + 考えてください. LPD では, すべてのプリンタに対して, デフォ + ルトでプレインテキストが印字できることを期待しています. + さらに, バックスペースやタブを正しく扱い, また, 他の特 + 殊な文字が入力されてもプリンタに混乱を来さないようにす + るのはテキストフィルタの仕事であると考えています. + + プリンタの使用に対して課金をしなくてはならない環境にあ + るときは, テキストフィルタが印字したページ数を数える作 + 業もしなくてはなりません. この作業は, 通常, 印字した行 + 数を数え, これをプリンタが1ページ当たりに印字できる行 + 数と比較することでおこなわれます. + + テキストフィルタは, 次のような引数を付けて起動されます. + + <cmdsynopsis> + <command>filter-name</command> + <arg>-c</arg> + <arg choice="plain">-w<replaceable>width</replaceable></arg> + <arg choice="plain">-l<replaceable>length</replaceable></arg> + <arg choice="plain">-i<replaceable>indent</replaceable></arg> + <arg choice="plain">-n <replaceable>login</replaceable></arg> + <arg choice="plain">-h <replaceable>host</replaceable></arg> + <arg choice="plain"><replaceable>acct-file</replaceable></arg> + </cmdsynopsis> + + ここで, + + <variablelist> + <varlistentry><term><option>-c</option></term> + <listitem> + <para><command>lpr -l</command> + によってジョブが入力されたときに与 + えられます.</para> + </listitem> + </varlistentry> + + <varlistentry><term><replaceable>width</replaceable></term> + <listitem> + <para><filename>/etc/printcap</filename> + で指定された <literal>pw</literal> (page width) + 項目の値が与えられます. デフォル トは, + 132です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><replaceable>length</replaceable></term> + <listitem> + <para><literal>pl</literal> (page length) + 項目で指定された値が与え られます. + デフォルトは66です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><replaceable>indent</replaceable></term> + <listitem> + <para><command>lpr -i</command> + によって与えられた字下げの量で, デ + フォルトは0です.</para> + </listitem> + </varlistentry> + + <varlistentry><term><replaceable>login</replaceable></term> + <listitem> + <para>ファイルを印字したユーザのアカウント名が + 与えら れます.</para> + </listitem> + </varlistentry> + + <varlistentry><term><replaceable>host</replaceable></term> + <listitem> + <para>ジョブが入力されたホスト名が + 与えられます.</para> + </listitem> + </varlistentry> + + <varlistentry><term><replaceable>acct-file</replaceable></term> + <listitem> + <para><literal>af</literal> + 項目で指定されている課金データファイル + の名前が与えられます.</para> + </listitem> + </varlistentry> + </variablelist> + </para> + </listitem> + + <listitem> + <para><emphasis>変換フィルタ</emphasis>は, + 特定のファイル形式をプリンタ + が紙に印字できるようなものに変換します. 例えば, プリン + タで ditroff 組版データを直接印字することはできません. + しかし, ditroff データをプリンタが消化し, 印字するこ + とができる形式へ変換するために, ditroff ファイル用フィ + ルタをインストールすることができます. + 「<link linkend="printing-advanced-convfilters"> + 変換フィルタ</link>」 + で, これらに関するすべてについて説明します. + プリンタの課金をする必要がある場合は, 変換フィルタでも + 印字ページを数える作業が必要となります. + + 変換フィルタは次の引数をとって起動されます. + + <cmdsynopsis> + <command>filter-name</command> + <arg choice="plain">-x<replaceable>pixel-width</replaceable></arg> + <arg choice="plain">-y<replaceable>pixel-height</replaceable></arg> + <arg choice="plain">-n <replaceable>login</replaceable></arg> + <arg choice="plain">-h <replaceable>host</replaceable></arg> + <arg choice="plain"><replaceable>acct-file</replaceable></arg> + </cmdsynopsis> + + ここで, <replaceable>pixel-width</replaceable> は, + <literal>px</literal> 項目で指定され + た値 (デフォルトは0), + <replaceable>pixel-height</replaceable> は, + <literal>py</literal> 項 + 目で指定された値 (デフォルトは0) です.</para> + </listitem> + + <listitem> + <para><emphasis>出力フィルタ</emphasis>は, + テキストフィルタが指定されて + おらず, かつ, ヘッダページの出力が許可されている場合に + のみ使われます. + 「<link linkend="printing-advanced-of"> + 出力フィルタ</link>」で, これらのことについて説明し + ます. アウトプットフィルタに対する引数は次の2つだけです. + + <cmdsynopsis> + <command>filter-name</command> + <arg choice="plain">-w<replaceable>width</replaceable></arg> + <arg choice="plain">-l<replaceable>length</replaceable></arg> + </cmdsynopsis> + + ここで, <option>-w</option> と <option>-l</option> は, + テキストフィルタの場合 + と同じです.</para> + </listitem> + </itemizedlist> + + <para>フィルタは, 次に示すの終了状態をもってプログラムを + <emphasis>exit</emphasis> するべきです. </para> + + <variablelist> + <varlistentry><term>exit 0</term> + <listitem> + <para>フィルタがファイルを正常に印字した場合.</para> + </listitem> + </varlistentry> + + <varlistentry><term>exit 1</term> + <listitem> + <para>フィルタはファイルの印字に失敗したが, LPD + に再度ファ イルの印字を試みて欲しい場合. + この終了状態で終了した場 合, LPD + はフィルタを再スタートします.</para> + </listitem> + </varlistentry> + + <varlistentry><term>exit 2</term> + <listitem> + <para>フィルタはファイルの印字に失敗し, かつ, LPD + に再出力 を試みて欲しくない場合. この場合, LPD + はそのファイル を放棄します.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>FreeBSD に付属するテキストフィルタ + <filename>/usr/libexec/lpr/lpf</filename> は, FROM FEED + 文字が送られたと + きやプリンタ使用に対する課金をどのようにするかを + 決定するために, ページ幅やページ長の引数を利用します. また, + 課金用のエントリを 作成するため, ログイン名, ホスト名, + 課金ファイル名の引数を利用 します.</para> + + <para>もし, フィルタの購入を検討しているならば, LPD + と互換性がある かどうかを確認してください. もしそうならば, + 上述の引数リストをサ ポートしていなければなりません. + 一般向けの使用のためにフィルタ + を作成する計画をしている場合は, + 同じ引数リストと終了コードをサ ポートしてください.</para> + </sect3> + + <sect3 id="printing-advanced-if-conversion"> + <title>プレインテキストのジョブを PostScript プリン + タで印字する</title> + + <para>コンピュータと PostScript (または, 他の言語に対応し た) + プリンタをあなたしか使用しない場合は, プリンタにプレ + インテキストを絶対に送らない, そして, + プリンタにプレインテキス + トを送りたがっている様々なプログラムの機能を決して + 使わないこと にしてください. そうすれば, + この節に書かれたことに心を煩わせる必 + 要はまったくなくなります.</para> + + <para>しかし, PostScript + とプレインテキストの両方のジョブをプリン + タへ送りたいと思っている場合は, + プリンタ設定についての要求が増 えるでしょう. + 両者をプリンタへ送信するためには, 到着 + したジョブがプレインテキストであるか PostScript であるかを + 検出するテキストフィルタが必要です. PostScript のジョブは + すべて <literal>%!</literal> + で始まらなければならないことになっています + (他のプリンタ言語に関しては, + プリンタのドキュメントをご覧くだ さい). + ジョブの最初の2文字がこれならば, PostScript である + ことが分かります. したがって, + ジョブのそれ以降の部分をプリンタに直 接送ることができます + (訳注:PostScript では, <emphasis remap=tt>%</emphasis> + 以降はコメントとして扱われるので, 最初の <emphasis + remap=tt>%!</emphasis> の行を 読み捨てても問題はない). + 最初の2文字が <emphasis remap=tt>%!</emphasis> でない場 + 合は, フィルタはテキストを PostScript に変換し, その結果を + 使って印字をおこないます.</para> + + <para>この作業をどうやってやればよいのでしょうか.</para> + + <para>シリアルポートにプリンタを接続した場合は, + <command>lprps</command> をインス + トールすることをお勧めします. <command>lprps</command> は + PostScript 用のフィルタで, + プリンタとの双方向通信をおこないます. このフィルタでは, + プリンタか らの冗長な情報を得ることで, + プリンタの状況を示すファイルが更新 されていきます. + したがって, ユーザや管理者は + (<errorname>トナー残量少</errorname>や + <errorname>紙詰まり</errorname>といった) + プリンタの状況を正確に知ることができます. しかし, + もっと重要なことは, <command>psif</command> + と呼ばれるプログラムが 含まれているということです. + このプログラムは, 入力されたジョブ + がプレインテキストかどうかを検出し, これを PostScript に変 + 換するために, <command>textps</command> + (<command>lprps</command> に付属する別のプログラ ム) + を呼び出します. そして, このジョブをプリンタに送るために, + <command>lprps</command> が使われます.</para> + + <para><command>lprps</command> は FreeBSD + のポート集に含まれています (「<link linkend="ports"> + ポートコレクション</link>」を参照してください). + もちろん,自分自身でプログラムを取ってきて, コンパイルし, + インストールす ることもできます. <command>lprps</command> + をインストールした後は, <command>lprps</command> + の一部である <command>psif</command> + プログラムのパス名を指定する だけです. ポート集から + <command>lprps</command> をインストールしたときは, + <filename>/etc/printcap</filename> の中のシリアル接続した + PostScript プリンタのエントリに対して, 次を使ってください. + </para> + + <programlisting> +:if=/usr/local/libexec/psif:</programlisting> + + <para>LPD + にプリンタをリード・ライトモードでオープンさせるために, + <literal>rw</literal> 項目も指定すべきです.</para> + + <para>パラレルポートに接続したプリンタの場合 (すなわち, + <command>lprps</command> が + 必要としているプリンタとの双方向通信ができない), + テキストフィ + ルタとして次のシェルスクリプトを使うことができます. </para> + + <programlisting> +#!/bin/sh +# +# psif - Print PostScript or plain text on a PostScript printer +# Script version; NOT the version that comes with lprps +# Installed in /usr/local/libexec/psif +# + +read first_line +first_two_chars=`expr "$first_line" : '\(..\)'` + +if [ "$first_two_chars" = "%!" ]; then + # + # PostScript job, print it. + # + echo "$first_line" && cat && printf "\004" && exit 0 + exit 2 +else + # + # Plain text, convert it, then print it. + # + ( echo "$first_line"; cat ) | /usr/local/bin/textps && printf "\004" && exit 0 + exit 2 +fi</programlisting> + + <para>上記のスクリプトにおいて, <command>textps</command> + はプレインテキストから PostScript + へ変換するために別にインストールしたプログラム です. + テキストから PostScript へ変換するのには, お好みのどんなプロ + グラムでも使うことができます. FreeBSD の ポート集 (「<link + linkend="ports">ポートコレクション</link>」 + を参照してください) には, <literal>a2ps</literal> + と呼ばれるテキストから PostScript に変換するプログラムが + 入っています.</para> + + <note> + <para><emphasis>訳注:</emphasis> 上記スクリプトでは, + 先頭の行を読み込むために read を使っていますが, + 困ったことに, read は読み込んだ文字列の先頭 + の空白文字を取り除いてしまいます. 従って, + これらの空白文字は印 字されないことになり, + 印字結果がファイルのイメージと異なる場合 が出てきます. + この事情は csh を利用した場合でも変わりません. 仮に, + 先頭の空白文字を除去しない read コマンドを作ったとしても, + 「echo $first_line」の $first_line + 変数の内容をシェルが展開す る際に $first_line + の先頭の空白文字が失われるため, 問題の解決 にはなりません. + 残念ながら, 訳者はこの問題をシェルプログラムだ + けで解決する方法をしりません. perl か C + 言語の力を借りないと解 決できないと思います.</para> + </note> + </sect3> + + <sect3 id="printing-advanced-ps"> + <title>非 PostScript プリンタで PostScript + をシミュレートする</title> + + <para>PostScript + は質の高い組版と印字をおこなうための<emphasis>事実 + 上の</emphasis>標準です. しかしながら, PostScript は, + <emphasis>高価な</emphasis>標 準です. ありがたいことに, + Alladin Enterprises から + <application>Ghostscript</application> と呼ばれる, + PostScript 互換の動作をするフリー + のプログラムが出されていて, FreeBSDで動きます. Ghostscript + はほとんどの PostScript ファイルを読むことができ, これらの + 各ページをたくさんのブランドの非 PostScript プリンタを含む + 様々なデバイス用に変換することができます. Ghostscript をイン + ストールし, + プリンタ用の特別なテキストフィルタを使うことによっ て, 非 + PostScript プリンタをあたかも本物の PostScript + プリンタであるかのように動作させることができます.</para> + + <para>Ghostscript はポート集に入っていますので, + そこからインストール することができます. また, + 自分でソースプログラムを持ってきて, コンパイルし, インストー + ルすることもできます. この作業はとても簡単にできます.</para> + + <para>PostScript プリンタをシミュレートさせる場合は, + テキストフィ ルタに PostScript + ファイルを印字しようとしているかどうかを 検出させます. + PostScript ファイルでない場合は, フィルタは + そのファイルを直接プリンタに送ります + (訳注:テキストファイルを直 接印字できない場合は, もちろん, + 変換フィルタを通す必要がありま す). PostScript の場合は, + まず, Ghostscript を使い, ファ + イルをそのプリンタが理解できる形式へ変換します.</para> + + <para>次の例のスクリプトは, Hewlett Packard DeskJet 500 + プリンタ用 のテキストフィルタです. + 他のプリンタで用いるときは, <option>-sDEVICE</option> + 引数を <command>gs</command> (Ghostscript) + コマンドに変えてくだ さい. (<command>gs -h</command> + と入力すると, 現在インストールされている Ghostscript + でサポートされているデバイスのリストが得られます). </para> + + <programlisting> +#!/bin/sh +# +# ifhp - Print Ghostscript-simulated PostScript on a DeskJet 500 +# Installed in /usr/local/libexec/hpif + +# +# Treat LF as CR+LF: +# +printf "\033&k2G" || exit 2 + +# +# Read first two characters of the file +# +read first_line +first_two_chars=`expr "$first_line" : '\(..\)'` + +if [ "$first_two_chars" = "%!" ]; then + # + # It is PostScript; use Ghostscript to scan-convert and print it + # + /usr/local/bin/gs -dSAFER -dNOPAUSE -q -sDEVICE=djet500 -sOutputFile=- - \ + && exit 0 + +else + # + # Plain text or HP/PCL, so just print it directly; print a form + # at the end to eject the last page. + # + echo "$first_line" && cat && printf "\f" && exit 0 +fi + +exit 2</programlisting> + + <para>最後に, <literal>if</literal> 項目を通して, LPD + にこのフィルタを教えてやる 必要があります. </para> + + <programlisting> +:if=/usr/local/libexec/hpif:</programlisting> + + <para>これでおしまいです. <command>lpr plain.text</command> + とか <filename>lpr whatever.ps</filename> + と入力してみましょう. どちらも正常に印字されるは + ずです.</para> + + <note> + <para><emphasis>訳注:</emphasis> 日本語を印字する場合は, + 日本語対応の Ghostscript が必要で す. 日本語対応版の + Ghostscript もポート集に入っているはずです.</para> + </note> + </sect3> + + <sect3 id="printing-advanced-convfilters"> + <title>変換フィルタ</title> + + <para>「<link + linkend="printing-simple">プリンタ設定導入編</link>」 + に書かれた簡単な設定が完了したら, 最初に, やってみたいと思 + うことは, 多分(プレイン ASCII テキストに加えて) + 好みのファイル形式 + のための変換フィルタをインストールすることでしょう.</para> + + <sect4> + <title>なぜ, 変換フィルタをインストールするのか?</title> + + <para>変換フィルタによって, 様々な種類のファイルを印字するこ + とが簡単になります. 例えば, TeX + 組版システムでたくさんの仕事 をしたと仮定しましょう. + そして, PostScript プリンタが接続 されているとします. + すると, TeX で DVI ファイルを作成する度に, DVI + ファイルを印字するために, これを PostScript ファイルに + 変換する必要があります. + このコマンドは次のようになるでしょう. </para> + + <screen>&prompt.user; <userinput>dvips seaweed-analysis.dvi</userinput> +&prompt.user; <userinput>lpr seaweed-analysis.ps</userinput></screen> + + <para>DVI ファイル用の変換フィルタがインストールしてあると, + LPD に 変換を肩代わりさせることで毎回毎回 + おこなわなければならなかった面倒 + な変換作業を省くことができます. つまり, DVI を生成したら, + 次のような1回のコマンド入力だけで, これが印字されます. + </para> + + <screen>&prompt.user; <userinput>lpr -d seaweed-analysis.dvi</userinput></screen> + + <para>LPD に DVI ファイルの変換をさせるためには, + <option>-d</option> オプション を指定します. + 変換オプションのリストは「<link + linkend="printing-lpr-options-format"> + 整形と変換に関するオプション</link>」 + に載せてあります.</para> + + <para>変化のオプションのそれぞれをプリンタに + サポートさせるためには, + <emphasis>変換フィルタ</emphasis>をインストールし, + そのパス名を <filename>/etc/printcap</filename> + の中で指定しなくてはなりません. 変換フィ ルタは, + プレインテキストを印字する代わりに, フィルタはファイル + をプリンタが理解できる形式に変換するところを除けば, + 「プリンタ の簡単な設定」で説明したテキストファイル + (「<link linkend="printing-textfilter"> + テキストフィルタのインストール</link>」 を見て下さい) + に似ています.</para> + </sect4> + + <sect4> + <title>どの変換フィルタをインストールすべきか?</title> + + <para>使いたいと思う変換フィルタをインストールすべきです. + DVI のデータを頻繁に印字するならば, DVI 変換フィルタ + をインストールするのが適切でしょう. 印字しなくてはなら + ない troff を大量に抱えている場合は, 多分, troff フィ + ルタが欲しくなるはずです.</para> + + <para>次の表は, LPD で動作するフィルタと, + <filename>/etc/printcap</filename> + ファイルでのエントリする項目, そして, + <command>lpr</command> + コマンドで呼び出す方法をまとめたもの です. </para> + + <informaltable frame="none"> + <tgroup cols="3"> + <thead> + <row> + <entry>ファイル形式</entry> + <entry><filename>/etc/printcap</filename>項目</entry> + <entry><command>lpr</command> オプション</entry> + </row> + </thead> + + <tbody> + <row> + <entry>cifplot</entry> + <entry><literal>cf</literal></entry> + <entry><option>-c</option></entry> + </row> + <row> + <entry>DVI</entry> + <entry><literal>df</literal></entry> + <entry><option>-d</option></entry> + </row> + <row> + <entry>plot</entry> + <entry><literal>gf</literal></entry> + <entry><option>-g</option></entry> + </row> + <row> + <entry>ditroff</entry> + <entry><literal>nf</literal></entry> + <entry><option>-n</option></entry> + </row> + <row> + <entry>FORTRAN text</entry> + <entry><literal>rf</literal></entry> + <entry><option>-f</option></entry> + </row> + <row> + <entry>troff</entry> + <entry><literal>tf</literal></entry> + <entry><option>-t</option></entry> + </row> + <row> + <entry>raster</entry> + <entry><literal>vf</literal></entry> + <entry><option>-v</option></entry> + </row> + <row> + <entry>プレインテキスト</entry> + <entry><literal>if</literal></entry> + <entry>なし, <option>-p</option>, または + <option>-l</option></entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>先の例のように, <command>lpr -d</command> + を使うためには, 出力先の プリンタの + <filename>/etc/printcap</filename> 内のエントリで, + <literal>df</literal> + 項目が必要であることが分かります.</para> + + <para>反論はあるかも知れませんが, FORTRAN テキストや plot + のような形式は, 多分, 廃れ てていくでしょう. + あなたのサイトで, 自前のフィルタをイ ンストールするだけで, + プリントオプションのいくつか, あ るいは, + 全部に新しい意味を与えることができます. 例えば, + Prinerleaf ファイル (Interleaf デスクトップパブリッシン + グプログラムによるファイル) を直接印字したいとします. + そして, Printerleaf 用の変換フィルタを + <literal>gf</literal> 項目で + 指定したパスにインストールすれば, <command>lpr + -g</command> の意味 は“Printerleaf + ファイルを印字する”意味だとユーザに教 + えることができます.</para> + </sect4> + + <sect4> + <title>変換フィルタのインストール</title> + + <para>変換フィルタは FreeBSD + の基本システムのインストールとは別 + にインストールするプログラムなので, 変換フィルタは, 多 分, + <filename>/usr/local</filename> ディレクトリの下に置くべ + きです. フィルタは LPD だけが実行する特別なプログラム, + すなわち, 一般ユーザが実行する必要すらない + プログラムなので, <filename>/usr/local/libexec</filename> + ディレ クトリに置くのが普通です.</para> + + <para>変換フィルタを使用可能にするためには, + <filename>/etc/printcap</filename> + の目的のプリンタの適切な項目に + フィルタがあるパス名を指定します.</para> + + <para>DVI 変換フィルタをプリンタ <literal>bamboo</literal> + のエントリに加 えてみましょう. プリンタ + <literal>bamboo</literal> の <literal>df</literal> 項目を + 新たに加えた<filename>/etc/printcap</filename> + ファイルの例を以下 に再掲します. </para> + + <programlisting> +# +# /etc/printcap for host rose - added df filter for bamboo +# +rattan|line|diablo|lp|Diablo 630 Line Printer:\ + :sh:sd=/var/spool/lpd/rattan:\ + :lp=/dev/lpt0:\ + :if=/usr/local/libexec/if-simple: + +bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ + :sh:sd=/var/spool/lpd/bamboo:\ + :lp=/dev/ttyd5:fs#0x82000e1:xs#0x820:rw:\ + :if=/usr/local/libexec/psif:\ + :df=/usr/local/libexec/psdf:</programlisting> + + <para>DVI フィルタは + <filename>/usr/local/libexec/psdf</filename> という + 名前のシェルスクリプトです. このスクリプトは次のように + なっています. </para> + + <programlisting> +#!bin/sh +# +# psdf - DVI to PostScript printer filter +# Installed in /usr/local/libexec/psdf +# +# Invoked by lpd when user runs lpr -d +# +exec /usr/local/bin/dvips -f | /usr/local/libexec/lprps "$@"</programlisting> + + <para>このスクリプトでは, <command>dvips</command> + をフィルタモード (引数 <option>-f</option>) で, + 標準入力上で起動しています. 標準入力は印字 するジョブです. + それから, PostScript プリンタ用フィ ルタ + <command>lprps</command> (これについては「<link + linkend="printing-advanced-if-conversion"> + プレインテキストのジョブを PostScript + プリンタで印字する</link>」 を参照してください) を LPD + に与えられた引数を付けて起動 します. + <command>lprps</command> + はこれらの引数を印字されたページ分 + の課金をおこなうために使われます.</para> + </sect4> + + <sect4> + <title>変換フィルタのその他の例</title> + + <para>変換フィルタのインストールには決まったステップがないの + で, その代わりに, 例をもっと挙げることにします. これを, + 自分でフィルタを作る際のガイドにしてください. 適当な例が + あったら, それをそのまま使ってください.</para> + + <para>次のスクリプト例は, Hewlett Packard LaserJet III-Si の + ための, raster (ええと・・実は, GIF ファイル) 用の変 + 換フィルタです. </para> + + <programlisting> +#!/bin/sh +# +# hpvf - Convert GIF files into HP/PCL, then print +# Installed in /usr/local/libexec/hpvf + +PATH=/usr/X11R6/bin:$PATH; export PATH + +giftopnm | ppmtopgm | pgmtopbm | pbmtolj -resolution 300 \ + && exit 0 \ + || exit 2</programlisting> + + <para>ここでは, GIF ファイルから PNM (portable anymap) 形式 + に変換し, 次に PGM (portable graymap) 形式に変換してか ら, + LaserJet/PCL-互換データに変換しています.</para> + + <para>上記のフィルタを使うプリンタのためのエントリを付け加え + た <filename>/etc/printcap</filename> + ファイルは次のようになります. </para> + + <programlisting> +# +# /etc/printcap for host orchid +# +teak|hp|laserjet|Hewlett Packard LaserJet 3Si:\ + :lp=/dev/lpt0:sh:sd=/var/spool/lpd/teak:mx#0:\ + :if=/usr/local/libexec/hpif:\ + :vf=/usr/local/libexec/hpvf:</programlisting> + + <para>次のスクリプトは, PostScript プリンタ + <literal>bamboo</literal> のための groff 組版システムの + troff データのための変換 フィルタです. </para> + + <programlisting> +#!/bin/sh +# +# pstf - Convert groff's troff data into PS, then print. +# Installed in /usr/local/libexec/pstf +# +exec grops | /usr/local/libexec/lprps "$@"</programlisting> + + <para>上記のスクリプトではプリンタとの通信をおこなうため, + <command>lprps</command> をまた利用しています. + プリンタがパラレルポー トに接続されている場合は, 代わりに, + 次のスクリプトを使 うかもしれません. </para> + + <programlisting> +#!/bin/sh +# +# pstf - Convert groff's troff data into PS, then print. +# Installed in /usr/local/libexec/pstf +# +exec grops</programlisting> + + <para>これで完成しました. 次に, フィルタを使用可能にするため + に <filename>/etc/printcap</filename> + に加える必要があるエントリを 示します. </para> + + <programlisting> +:tf=/usr/local/libexec/pstf:</programlisting> + + <para>次の例をみたら, FORTRAN のベテランは赤面するかもしれ + ません. この FORTRAN テキストフィルタは, プレインテキ + ストを直接印字できるすべてのプリンタで利用できます. この + フィルタをプリンタ <literal>teak</literal> + にインストールすることに しましょう. </para> + + <programlisting> +#!/bin/sh +# +# hprf - FORTRAN text filter for LaserJet 3si: +# Installed in /usr/local/libexec/hprf +# + +printf "\033&k2G" && fpr && printf "\f" && exit 0 +exit 2</programlisting> + + <para>そして, このフィルタを使用可能にするため, 以下の行を + <filename>/etc/printcap</filename> のプリンタ + <literal>teak</literal> のエントリ に加えます. </para> + + <programlisting> +:rf=/usr/local/libexec/hprf:</programlisting> + + <para>これが最後の, そして, 若干複雑な例です. 前に紹介した + LaserJet プリンタ <literal>teak</literal> に, DVI + フィルタを加える ことにしましょう. 最初に, + 簡単な部分をおこないます. すなわ ち, DVI フィルタの位置を + <filename>/etc/printcap</filename> に書 き加えます. + </para> + + <programlisting> +:df=/usr/local/libexec/hpdf:</programlisting> + + <para>さて, 難しい部分であるフィルタの作成をおこないます. + このた めに, DVI から LaserJet/PCL + への変換プログラムが必要 です. FreeBSD のポート集 (「<link + linkend="ports">ポートコレクション</link>」 + を参照してください) には, それがあ ります. + <command>dvi2xx</command> というのがそのパッケージの名前で + す. これをインストールすると, 必要なプログラム + <command>dvilj2p</command> が使えます. このプログラムは + DVI を LaserJet IIp, LaserJet III, そして LaserJet 2000 + の互 換コードへ変換してくれます.</para> + + <para><command>dvilj2p</command> はフィルタ + <command>hpdf</command> を極めて複雑にしてい ます. + なぜなら, <command>dvilj2p</command> + は標準入力からデータを読 み込むことができないからです. + このプログラムを働かせる ためには, ファイル名が必要です. + もっと悪いことに, ファ イル名は <filename>.dvi</filename> + で終わっている必要があり, 標準入力 の代わりに, + <filename>/dev/fd/0</filename> を使うのは問題がありま す. + この問題は, (<filename>.dvi</filename> で終わる) + 一時的なファイル名 から<filename>/dev/fd/0</filename> に + (シンボリックな) リンクを張る + ことで回避することができます. これで, + <command>dvilj2p</command> に 強制的に標準入力からデータを + 読み込ませることができます.</para> + + <para>もう1つの問題は, 一時的なリンクを張るために + <filename>/tmp</filename> ディ + レクトリを使うことができないという事実です. シンボリッ + クリンクはユーザ, グループが <username>bin</username> + であるユーザに所 有されています. フィルタはユーザ + <username>daemon</username> として起 動します. そして, + <filename>/tmp</filename> ディレクトリはスティッ + キービットが立っています. フィルタはリンクを作ることが + できます. しかし, リンクは別のユーザに所有されているた め, + 作業が終了したとき, このリンクを削除することができ + ません.</para> + + <para>その代わりに, シンボリックリンクは現在の作業ディレクト + リ, すなわち, スプーリングディレクトリ + (<filename>/etc/printcap</filename> の + <literal>sd</literal> 項目で指定する) に作 ることにします. + フィルタが作業するにはここの場所は完璧 な場所で, なぜなら, + 特に, スプーリングディレクトリのディ スクの空き容量は + (ときどき) <filename>/tmp</filename> ディレクトリ + よりもたくさんあるからです.</para> + + <para>以下に示すのが最後のフィルタです. </para> + + <programlisting> +#!/bin/sh +# +# hpdf - Print DVI data on HP/PCL printer +# Installed in /usr/local/libexec/hpdf + +PATH=/usr/local/bin:$PATH; export PATH + +# +# Define a function to clean up our temporary files. These exist +# in the current directory, which will be the spooling directory +# for the printer. +# +cleanup() { + rm -f hpdf$$.dvi +} + +# +# Define a function to handle fatal errors: print the given message +# and exit 2. Exiting with 2 tells LPD to do not try to reprint the +# job. +# +fatal() { + echo "$@" 1>&2 + cleanup + exit 2 +} + +# +# If user removes the job, LPD will send SIGINT, so trap SIGINT +# (and a few other signals) to clean up after ourselves. +# +trap cleanup 1 2 15 + +# +# Make sure we are not colliding with any existing files. +# +cleanup + +# +# Link the DVI input file to standard input (the file to print). +# +ln -s /dev/fd/0 hpdf$$.dvi || fatal "Cannot symlink /dev/fd/0" + +# +# Make LF = CR+LF +# +printf "\033&k2G" || fatal "Cannot initialize printer" + +# +# Convert and print. Return value from dvilj2p does not seem to be +# reliable, so we ignore it. + +# +dvilj2p -M1 -q -e- dfhp$$.dvi + +# +# Clean up and exit +# +cleanup +exit 0</programlisting> + </sect4> + + <sect4 id="printing-advanced-autoconv"> + <title>自動変換: その他の変換フィルタ</title> + + <para>ここまでに述べてきたフィルタによって, 印字環境の能率が + 上がったことと思います. しかし, これはどのフィルタを使 + うかを ( &man.lpr.1; のコマンドライン上で) ユーザが指定しな + くてはならないという代価を支払って実現されています. コ + ンピュータの事情にあまり詳しくないユーザにとって, フィ + ルタのオプションを指定させられるということはいらいらさ + せられるものになるでしょう. 更に悪いことに, 間違ったフィ + ルタオプションを指定されると, 間違った形式のファイルが + そのフィルタに適用されることになり, その結果, 何百枚も + の紙を掃き出すことになるかもしれません.</para> + + <para>そのような結果になるならば, 変換フィルタをインストール + するよりもむしろ, テキストフィルタ (これがデフォルトフィ + ルタなので) に印字するよう要求されたファイルの形式を検 + 出させ, 自動的に, 適切な変換フィルタを起動するようにし + たいと思うかもしれません. ここでは <command>file</command> + コマンド のようなツールを役立たせることができます. + もちろん, <emphasis>いくつかの</emphasis> + ファイル形式の違いを見分けることは難しい ことでしょう. + そして, もちろん, それらのファイルに対し ては, + 変換フィルタを提供するだけで済ますこともできるの + です.</para> + + <para>FreeBSD のポート集には, <command>apsfilter</command> + と呼ばれる自 動変換をおこなうテキストフィルタがあります. + このフィルタは プレインテキスト, PostScript, DVI + ファイルを検 出し, 適当な変換をおこなった後, + データを印字することができ ます.</para> + </sect4> + </sect3> + + <sect3 id="printing-advanced-of"> + <title>出力フィルタ</title> + + <para>LPD スプーリングシステムでは, + ここまでにまだ取り上げていな いフィルタ形式, + 出力フィルタをサポートしています. 出力 フィルタは, + テキストフィルタのように, プレインテキスト + のみを印字するために意図されたものですが, 非常に簡単化 + されています. テキストフィルタを用いずに, 出力フィルタ + を使っている場合は, 次のようになります. </para> + + <itemizedlist> + <listitem> + <para>LPD はジョブ中の各ファイルに一度ではなく, ジョブ + 全体に対して一度だけ出力フィルタを起動します.</para> + </listitem> + + <listitem> + <para>LPD は出力フィルタに対し, ジョブ中のファイルの先 + 頭や末尾を特定するための対策を一切 + おこなっていません.</para> + </listitem> + + <listitem> + <para>LPD はユーザのログイン名やホスト名をフィルタに渡 + しません. したがって, 課金の処理をおこなうことは考えてい + ません. 実際, 出力フィルタには, 以下2つの引数しか与え + られません. </para> + + <cmdsynopsis> + <command>filter-name</command> + <arg choice="plain">-w<replaceable>width</replaceable></arg> + <arg choice="plain">-l<replaceable>length</replaceable></arg> + </cmdsynopsis> + + <para>ここで, <replaceable>width</replaceable> + は対象となるプリンタの <literal>pw</literal> 項 目, + <replaceable>length</replaceable> は + <literal>pl</literal> 項目に指定された数です.</para> + </listitem> + </itemizedlist> + + <para>出力フィルタの簡便さに誘惑されてはいけません. もし, ジョ + ブ中のそれぞれのファイルに別のページ番号を付加しようと + しても, + 出力フィルタは<emphasis>うまく動作しないでしょう</emphasis>. + そのような動作を期待しているならば, (入力フィルタとし + ても知られている) テキストフィルタを使ってください. 詳 + しくは, 「<link linkend="printing-textfilter"> + テキストフィルタのインストール</link>」をご覧ください. + さらに, 出力 フィルタは, 実のところ, + <emphasis>もっと複雑</emphasis>になっています. まず, + 特殊なフラグ文字を検出するために, フィルタに送ら + れてくるバイトストリームを検査する必要があります. また, LPD + に代わって, 自分自身にシグナルを送らなければなりま + せん.</para> + + <para>しかしながら, ヘッダページの印字をおこないたい場合, + また, + エスケープシーケンスやヘッダページを印字できるようにす + るその他の初期化文字列を送信する必要がある場合, 出力ファ + イルが<emphasis>必要</emphasis>です.</para> + + <para>1台のプリンタに対し, LPD では出力フィルタとテキスト, + または, 他のフィルタを両方使うことができます. このよう + な場合, LPD はヘッダページ (「<link + linkend="printing-advanced-header-pages"> + ヘッダページ</link>」 を参照してください) + だけを印字させるために, 出 力フィルタを起動させます. + それから LPD では, アウトプッ トフィルタに2バイトの文字 + (ASCII 031 の次に ASCII 001) を送ることで, + 出力フィルタが<emphasis>自力で停止する</emphasis>ことを + 期待しています. 2バイト (031, 001) が出力フィルタに送られ + たとき, 出力フィルタは自分自身にシグナル SIGSTOP を送 + ることによって停止するべきです. LPD がその他のフィル + タの起動を完了したとき, LPD は出力フィルタにシグナル + SIGCONT を送ることで, 出力フィルタを再起動させます.</para> + + <para>出力フィルタがあり, + テキストフィルタが<emphasis>ない</emphasis>場合, LPD + はプレインテキストのジョブをおこなう際に, 出力フィル + タを使います. 前述したように, 出力フィルタでは, ジョブ + 中の各ファイルの並びの間に FROM FEED 文字や紙を排出す + る他の文字を入れることはしません. この動作は多分, あな + たが求めているものとは + <emphasis>異なっている</emphasis>でしょう. ほと + んどすべての場合において, テキストフィルタが必要とされる + はずです.</para> + + <para>プログラム <command>lpf</command> は, + テキストフィルタの項で既に紹介 しましたが, + 出力フィルタとしても動作させることができま す. もし, + 簡便で極悪な出力フィルタが必要で, かつ, バイ + トストリームを検査したりシグナルを送るコードを書きたく + ないときには, <command>lpf</command> をお試しください. + あるいは, プ リントが要求する初期化コードを送るために, + <command>lpf</command> を + シェルスクリプトに包んで使うこともできます.</para> + </sect3> + + <sect3 id="printing-advanced-lpf"> + <title>テキストフィルタ <command>lpf</command></title> + + <para>プログラム <filename>/usr/libexec/lpr/lpf</filename> は, + FreeBSD の バイナリ配布に付属しているテキストフィルタ + (入力フィル タ) で, 出力を字下げしたり (<command>lpr + -i</command> でジョブが入力さ れたとき), + 文字を未処理のままプリンタに送ったり (<command>lpr + -l</command> でジョブが入力されたとき), ジョブ中のバッ + クスペースやタブの印字位置を調節したり, 印字したページ + に対して課金したりすることができます. また, このフィル + タは出力フィルタとしても動作させることができます.</para> + + <para><command>lpf</command> + は多くの印字環境において使用することに適して います. + このフィルタには, プリンタに初期化文字列を送る + 機能はありませんが, 必要とされる初期化をおこない, それから + <command>lpf</command> + を実行させるためのシェルスクリプトを作成する + のはたやすいことです.</para> + + <para><command>lpf</command> に対して, + 印字ページへの課金を正確におこなわせる ためには, + <filename>/etc/printcap</filename> ファイルの中の + <literal>pw</literal> と <literal>pl</literal> + の項目に正確な値を入れておく必要が あります. これらの値は, + どのくらいの量のテキストがペー ジにフィットするか, また, + ユーザのジョブが何ページある のかを調べるために使われます. + プリンタの課金についての 詳しい情報については, 「<link + linkend="printing-advanced-acct"> + プリンタの利用に対する課金</link>」をご覧ください.</para> + </sect3> + </sect2> + + <sect2 id="printing-advanced-header-pages"> + <title>ヘッダページ</title> + + <para>あなたが管理するシステムのユーザが + <emphasis>たくさん</emphasis>おり, ユー + ザ全員が様々なプリンタを使用する場合, 多分, 必要悪である + <emphasis>ヘッダページ</emphasis> + を印字させることを検討したいと思うかもしれま せん.</para> + + <para>ヘッダページは, <emphasis>バナー</emphasis> とか + <emphasis>バーストページ</emphasis> としても知ら れていますが, + 出力されたジョブが誰によるものなのかを特定させる + 働きがあります. 印字結果の山の中において, ユーザのジョブによっ + て印字された本物のドキュメント部分よりも際立たせるために, ヘッ + ダページは, 通常, 多分, 縁が装飾されている大きな太文字で印字さ + れます. ヘッダページにより, ユーザは自分が出したジョブがどこに + あるのかをすばやく見つけることができます. + ヘッダページの欠点は, 明らかに, すべてのジョブに対して, + 紙が1枚余分に印字されるという ことです. + この紙の有効期間は短く, 2〜3 分も続きません. 最終的に, + これらの紙は再利用紙入れの中か + くずの山に入れられることでしょう. + (ヘッダページはジョブ中の各ファイル毎に印字されるのではなく, + ジョブ毎に印字されるということに注意してください. したがって, + 紙の 消費はそれほどひどくはないかもしれません).</para> + + <para><emphasis>もし</emphasis>, + プリンタがプレインテキストを直接印字できるならば, LPD + システムは印字物に対して自動的にヘッダページを付けることが + できます. PostScript プリンタを使っている場合は, ヘッダペー + ジを生成する外部プログラムが必要になります. これについては, + 「<link linkend="printing-advanced-header-pages-ps">PostScript + プリンタでのヘッダページ</link>」をご覧ください.</para> + + <sect3 id="printing-advanced-header-pages-enabling"> + <title>ヘッダページの印字を許可する</title> + + <para>「<link linkend="printing-simple">プリンタ設定導入編 + </link>」 では, <filename>/etc/printcap</filename> + ファイルの <literal>sh</literal> (``suppress header'' : + “ヘッダを供給しない” という意味) を指定して, + ヘッダペー ジの印字を止めていました. + プリンタでのヘッダページの印字を許可 するには, + <literal>sh</literal> 項目を取り除くだけよい訳です.</para> + + <para>とても簡単そうに見えるけど, 本当かな?</para> + + <para>それは本当です. + プリンタに初期化文字列を送るための出力フィ + ルタを用意しなくてはならないかもしれません. 次に, Hewlett + Packard PCL 互換プリンタの例を挙げます. </para> + + <programlisting> +#!/bin/sh +# +# hpof - Output filter for Hewlett Packard PCL-compatible printers +# Installed in /usr/local/libexec/hpof + + +printf "\033&k2G" || exit 2 +exec /usr/libexec/lpr/lpf</programlisting> + + <para><literal>of</literal> + 項目に出力フィルタのパス名を指定してください. 詳細につ + いては, 「<link + linkend="printing-advanced-of">出力フィルタ</link>」 + をご覧ください.</para> + + <para>次に, 以前紹介したプリンタ <literal>teak</literal> + のための <filename>/etc/printcap</filename> + ファイルの例を示します. ここでは, ヘッ + ダページの印字を許可し, 上記の出力フィルタを追加しました. + </para> + + <programlisting> +# +# /etc/printcap for host orchid +# +teak|hp|laserjet|Hewlett Packard LaserJet 3Si:\ + :lp=/dev/lpt0:sd=/var/spool/lpd/teak:mx#0:\ + :if=/usr/local/libexec/hpif:\ + :vf=/usr/local/libexec/hpvf:\ + :of=/usr/local/libexec/hpof:</programlisting> + + <!-- kuriyama - literallayout? --> + <para>さて, ユーザが <literallayout>teak</literallayout> + からジョブを印字させたとき, それぞれ + のジョブ毎にヘッダページが印字されます. + もし, ユーザが印字物を + 探すのに時間を費やしたいと思うなら, + <command>lpr -h</command> によってジョ + ブを入力することで, + ヘッダページの印字を止めることができます. + これ以外の + &man.lpr.1; のオプションについては, + 「<link linkend="printing-lpr-options-misc"> + ヘッダページ用オプション</link>」 + をご覧ください.</para> + + <note> + <para>LPD では, ヘッダページの最後に, FROM FEED 文字が印 + 字されます. プリンタに紙排出をさせるために, 別な文字, + もしくは, 別な文字列が利用されている場合は, + <filename>/etc/printcap</filename> 中の + <literal>ff</literal> 項目で指定することができます.</para> + </note> + </sect3> + + <sect3 id="printing-advanced-header-pages-controlling"> + <title>ヘッダページを制御する</title> + + <para>ヘッダページの印字が許可されていると, LPD は + <emphasis>長いヘッ ダ</emphasis>を作ります. これには, + 紙全面に大きな文字でユーザ名, ホスト 名, + ジョブ名が書かれています. 次に, このヘッダページの例を示 + します (kelly が ジョブ名 outline を rose + というホストから印字 された場合). </para> + + <programlisting> +k ll ll +k l l +k l l +k k eeee l l y y +k k e e l l y y +k k eeeeee l l y y +kk k e l l y y +k k e e l l y yy +k k eeee lll lll yyy y + y + y y + yyyy + + + ll + t l i + t l + oooo u u ttttt l ii n nnn eeee +o o u u t l i nn n e e +o o u u t l i n n eeeeee +o o u u t l i n n e +o o u uu t t l i n n e e + oooo uuu u tt lll iii n n eeee + + + + + + + + + +r rrr oooo ssss eeee +rr r o o s s e e +r o o ss eeeeee +r o o ss e +r o o s s e e +r oooo ssss eeee + + + + + + + + Job: outline + Date: Sun Sep 17 11:04:58 1995</programlisting> + + <para>LPD はこのテキストの終わりに FROM FEED 文字を加えます + ので, ジョブは新しいページから開始されます (ただし, + <filename>/etc/printcap</filename> + で出力先のプリンタのエントリに <literal>sf</literal> + (suppress form feeds) が指定されているときはこ + の限りではありません).</para> + + <para>お望みならば, LPD + に<emphasis>短いヘッダページ</emphasis>を出力させる + こともできます. この場合は, + <filename>/etc/printcap</filename> ファ イルの中で + <literal>sb</literal> (short banner) を指定してください. + ヘッダページは次のようになります. </para> + + <programlisting> +rose:kelly Job: outline Date: Sun Sep 17 11:07:51 1995</programlisting> + + <para>デフォルトでは, LPD はヘッダページを最初に印字し, 次 + にジョブの印字をおこないます. この順番を逆にするときは, + <filename>/etc/printcap</filename> で <literal>hl</literal> + (header last) を指定 してください.</para> + </sect3> + + <sect3 id="printing-advanced-header-pages-accounting"> + <title>ヘッダページに対する課金</title> + + <para>LPD に備わっているヘッダページ出力機能を使うと, 入力され + たジョブに対して課金をおこなうことができても, + ヘッダページは<emphasis>無 + 料</emphasis>で提供しなくてはならない, + という特有のやり方を強要されます.</para> + + <para>なぜでしょうか.</para> + + <para>出力フィルタは単なる外部プログラムなので, + 課金をするための制御 をおこなうとすれば, + それはヘッダページを印字するときですが, 出力フィ ルタには, + <emphasis>ユーザ名とホスト名</emphasis> + の情報や課金情報を格納するファ イルがどれな + のかということが知らされません. それゆえ, 出力ファイルには, + 誰 + にプリンタ利用の課金をおこなえばよいのかが分からないのです. + テキス トフィルタやその他の変換フィルタ + (これらのフィルタはユーザやホ ストの情報が知らされます) + が出力ページの枚数に“1ページ分水増し + する”だけでは十分ではありません. なぜなら, ユーザは + <command>lpr -h</command> に + よってヘッダページの出力を止めることができるからです. + やみくも に1ページを水増しすると, + 印字されてもいないヘッダページに対する + 料金をとることになります. 基本的に, <command>lpr + -h</command> は環境に優し + い心を持つユーザに好まれるオプションですが, + これを使うように奨 励することもできません.</para> + + <para>各々のフィルタに独自のヘッダページを生成させる + (その結果, ヘッ ダページに課金することができる) + という方法<emphasis>でも十分であると + はいえません</emphasis>. この場合, LPD はフィルタに + <option>-h</option> の情報を送 りませんので, <command>lpr + -h</command> によってヘッダページを印字しないオ + プションを選択したとしても, + 依然としてヘッダページは印字され, + その分の課金がおこなわれてしまいます.</para> + + <para>では, どのような選択肢があるのでしょうか.</para> + + <para>ヘッダページへの課金に関しては, + 次のことができます.</para> + + <itemizedlist> + <listitem> + <para>LPD のやり方を受け入れ, + ヘッダページは無料とする.</para> + </listitem> + + <listitem> + <para>LPDng や PLP といった LPD の代替品をインストール + する. LPD と入れ替えが可能な他のスプーリングソフトウェ + アに関しては, 「<link + linkend="printing-lpd-alternatives"> + 標準スプーラの代替品</link>」をご覧ください.</para> + </listitem> + + <listitem> + <!-- kuriyama - more para --> + <para><emphasis>スマートな</emphasis> + 出力フィルタを作成する. 通常, 出力 + フィルタはプリンタを初期化するか, 単純な文字列変換をす + る程度の働きしかしません. (テキスト (入力) フィルタがな + い場合) 出力フィルタはヘッダページとプレインテキストの + 印字をおこなうのに適しています. + + プレインテキストを印字するためのテキストフィルタがない + 場合, LPD はヘッダページを印字するためだけの目的で出 + 力フィルタを起動します. そして, LPD が生成するヘッダ + ページのテキストを解析することにより, 出力フィルタはヘッ + ダページに課金するために必要なユーザ名とホスト名を取得 + することができます. この方式の唯一の問題点は, 出力フィ + ルタは課金情報を格納するデータファイルの名前を知ることが + できないということです + (<literal>af</literal> 項目で指定されたファイ + ル名は出力ファイルに渡されません). しかし, 既知の + 名前の課金データファイルを使うのならば, その名前を出 + 力フィルタのプログラム中に埋め込むことができます. + + 解析の手順を簡単にするためには, + <filename>/etc/printcap</filename> + で <literal>sh</literal> 項目 (短いヘッダを指 + 定) を使うとよいでしょう. + + そしてまた, ここまでの方法は少なからぬトラブルを生じさ + せるかもしれません. + そうなれば, もちろんユーザはヘッダペー + ジを無料で + 提供してくれる気前のよいシステム管理者に感謝することで + しょう.</para> + </listitem> + </itemizedlist> + </sect3> + + <sect3 id="printing-advanced-header-pages-ps"> + <title>PostScript プリンタでのヘッダページ</title> + + <para>これまでに述べたように, LPD ではプレインテキストのヘッ + ダページをたくさんのプリンタに合うように生成することが + できます. 残念ながら, PostScript プリンタは, + プレインテキストを直接 印字することができません. ですから, + LPD のヘッダページ機能は まったく役に立たない, + あるいはほとんどの場合で役に立ちません.</para> + + <para>ヘッダページを出力するための自明な方法の1つに, + すべての変換フィ + ルタとテキストフィルタにヘッダページを生成させる + 方法があります. フィルタは, + 適切なヘッダページを生成するために, ユーザ名とホス + ト名の引数を使うべきです. この方法の欠点は, いつでも, + <emphasis remap=tt>lpr -h</emphasis> + によってジョブが入力された場合でさえも, ヘッダページが印字 + されるということです.</para> + + <para>この方法で試してみましょう. 次のスクリプトは, 3つの引数 + (ユーザ のログイン名, ホスト名, ジョブ名) をとり, 簡単な + PostScript 用 のヘッダページを生成します.</para> + + <programlisting> +#!/bin/sh +# +# make-ps-header - make a PostScript header page on stdout +# Installed in /usr/local/libexec/make-ps-header +# + +# +# These are PostScript units (72 to the inch). Modify for A4 or +# whatever size paper you are using: +# +page_width=612 +page_height=792 +border=72 + +# +# Check arguments +# +if [ $# -ne 3 ]; then + echo "Usage: `basename $0` <user> <host> <job>" 1>&2 + exit 1 +fi + +# +# Save these, mostly for readability in the PostScript, below. +# +user=$1 +host=$2 +job=$3 +date=`date` + +# +# Send the PostScript code to stdout. +# +exec cat <<EOF +%!PS + +% +% Make sure we do not interfere with user's job that will follow +% +save + +% +% Make a thick, unpleasant border around the edge of the paper. +% +$border $border moveto +$page_width $border 2 mul sub 0 rlineto +0 $page_height $border 2 mul sub rlineto +currentscreen 3 -1 roll pop 100 3 1 roll setscreen +$border 2 mul $page_width sub 0 rlineto closepath +0.8 setgray 10 setlinewidth stroke 0 setgray + +% +% Display user's login name, nice and large and prominent +% +/Helvetica-Bold findfont 64 scalefont setfont +$page_width ($user) stringwidth pop sub 2 div $page_height 200 sub moveto +($user) show + +% +% Now show the boring particulars +% +/Helvetica findfont 14 scalefont setfont +/y 200 def +[ (Job:) (Host:) (Date:) ] { + 200 y moveto show /y y 18 sub def +} forall + +/Helvetica-Bold findfont 14 scalefont setfont +/y 200 def +[ ($job) ($host) ($date) ] { + 270 y moveto show /y y 18 sub def +} forall + +% +% That is it +% +restore +showpage +EOF</programlisting> + + <para>そして, 変換フィルタやテキストフィルタがそれぞれ, + 最初にこのス クリプトを起動することで, + ヘッダページが出力され, それから, ユー + ザのジョブの印字をおこないます. 次に, + このドキュメントの始めのほう で紹介した DVI 変換フィルタを, + ヘッダページを印字するように変 更したものを示します. </para> + + <programlisting> +#!/bin/sh +# +# psdf - DVI to PostScript printer filter +# Installed in /usr/local/libexec/psdf +# +# Invoked by lpd when user runs lpr -d +# + +orig_args="$@" + +fail() { + echo "$@" 1>&2 + exit 2 +} + +while getopts "x:y:n:h:" option; do + case $option in + x|y) ;; # Ignore + n) login=$OPTARG ;; + h) host=$OPTARG ;; + *) echo "LPD started `basename $0` wrong." 1>&2 + exit 2 + ;; + esac +done + +[ "$login" ] || fail "No login name" +[ "$host" ] || fail "No host name" + +( /usr/local/libexec/make-ps-header $login $host "DVI File" + /usr/local/bin/dvips -f ) | eval /usr/local/libexec/lprps $orig_args</programlisting> + + <para>このフィルタがユーザ名やホスト名を決定するために + 引数リストをど + のように解析しなくてはならないかという点に注意してください. + こ の解析方法は他の変換フィルタに対しても同様です. + しかしながら, テキストフィルタについては, + 引数の設定が少し異なっています (こ れについては, 「<link + linkend="printing-advanced-filters"> + フィルタはどのように機能しているか</link>」 + をご覧ください).</para> + + <para>前述の通り, 上記の手法は, 極めて単純なのにも関らず, + <literal>lpr</literal> + で“ヘッダページを印字しない”オプション + (<option>-h</option> オプション) が 使えなくなっています. + ユーザが森林資源を (あるいは, ヘッダペー + ジが課金されているならば, その僅かな金額を), + 節約したいと望んでい る場合でも, + すべてのフィルタがすべてのジョブ毎にヘッダページを印字 + することになっているので, 節約することはできません.</para> + + <para>ジョブ毎に印字されるヘッダページを + ユーザが抑制できるようにする ためには, 「<link + linkend="printing-advanced-header-pages-accounting"> + ヘッダページに対する課金</link>」で紹介したトリックを + 使う必要があります. すな わち, LPD + が生成するヘッダページの解析をおこない, PostScript + 版のヘッダページを出力させる出力フィルタを作るのです. この場 + 合, ユーザが <command>lpr -h</command> でジョブを入力すると, + LPD はヘッダペー ジを生成しなくなり, また, + 出力フィルタも起動されません. そうで ないならば, + 作成した出力フィルタが LPD からのテキストを読み込 み, + ヘッダページを印字する適当な PostScript のコードがプリ + ンタに送られるでしょう.</para> + + <para>PostScript プリンタがシリアルポートに接続されている場合, + 出力フィルタとして <command>lprps</command> を, + 上記の動作をおこなうものとして <command>psof</command> + を使うことができます. ただし, <command>psof</command> + はヘッダペー + ジに対して課金をおこないませんので注意してください.</para> + </sect3> + </sect2> + + <sect2 id="printing-advanced-network-printers"> + <title>リモートプリンタからの出力</title> + + <para>FreeBSD では, ネットワーク越しの印字, すなわち, ジョブをリ + モートプリンタに送ることをサポートしています. リモートプリンタ + からの出力をするには, 一般に, 次の2つを参照してください. + </para> + + <itemizedlist> + <listitem> + <para>リモートホストに接続されたプリンタにアクセスする方 法. + プリンタがあるホストのシリアル, または, パラレルイ + ンタフェースに接続されている場合, ネットワーク上の他の + ホストからこのプリンタにアクセスできるように LPD を設 + 定します. 「<link + linkend="printing-advanced-network-rm">リモートホストに + 接続されたプリンタ</link>」 + でどのよう にするかを説明します.</para> + </listitem> + + <listitem> + <para>ネットワークに直接接続されているプリンタにアクセ + スする方法. プリンタに, 旧来のシリアル, または, パラレ + ルインタフェースに加えて (もしくは, これらに代わって) ネッ + トワーク用のインタフェースがある場合. そのようなプリン + タは次のように動作するでしょう. </para> + + <itemizedlist> + <listitem> + <para>そのプリンタが LPD のプロトコルを理解でき, リモー + トホストからのジョブを + キューに入れることさえできる場合. この場合, + プリンタは, LPD が起動している一般のホスト + のように振る舞います. そのようなプリンタを設定するため + に, 「<link linkend="printing-advanced-network-rm"> + リモートホストに接続されたプリンタ</link>」 + と同様の手 順をおこなってください.</para> + </listitem> + + <listitem> + <para>そのプリンタが, データストリームによるネットワー + ク接続をサポートしている場合. この場合, ネットワーク上 + の1つのホストとしてプリンタを“接続”します. + このホス トは, ジョブをスプーリングする責任を負い, + スプーリング されたジョブはプリンタに送られます. + そのようなプリンタ + をインストールするためのいくつかの提案が「<link + linkend="printing-advanced-network-net-if"> + ネットワークにおけるデータストリームの + インタフェースを持つプリンタ</link>」にあります.</para> + </listitem> + </itemizedlist> + </listitem> + </itemizedlist> + + <sect3 id="printing-advanced-network-rm"> + <title>リモートホストに接続されたプリンタ</title> + + <para>LPD スプーリングシステムでは LPD (または LPD 互換のシス + テム) + が起動している他のホストへジョブを送る機能が始めからサポー + トされています. この機能により, + あるホストに接続されたプリンタ へ, + 他のホストからアクセスできるようになります. また, LPD プ + ロトコルを理解するネットワークインタフェースを持った + プリンタに 対しても, この機能は働きます.</para> + + <para>リモートプリンタへの出力を許可するためには, 最初に, + あるホスト (これを, + <emphasis>プリンタホスト</emphasis>と呼びます) + にプリンタを接続します. そして, 「 <link + linkend="printing-simple"> プリンタ設定導入編</link>」 + に書かれた簡単なプリンタの設定をおこなってください. + 必要ならば, 「<link + linkend="printing-advanced">プリンタ設定上級編</link>」 + にあ る, 更に進んだ設定をおこなってください. そして, + そのプリンタをテス トしてうまく動作することを確認し, LPD + に許可した機能がうまく働 くかどうかを見てください. さらに + <emphasis>ローカルホスト</emphasis> が + <emphasis>プリンタホスト</emphasis> の LPD サービスの使用を + 許可されているか確認して 下さい (「<link + linkend="printing-advanced-restricting-remote"> + リモートホストからのプリンタの利用を制限する + </link>」参照).</para> + + <para>LPD + 互換のネットワークインタフェースを持つプリンタを使用してい + る場合は, そのプリンタ自身が以下で説明する + <emphasis>プリンタホスト</emphasis> になります. そして, + <emphasis>プリンタ名</emphasis>とは, そのプリンタに設定し + た名前のことを指します. これについては, プリンタ, および + (また は), + プリンタのネットワークインタフェースに付属するドキュメン + トを参照してください.</para> + + <para>次に, + そのプリンタにアクセスしたいと思っている他ホストにおいて, + そのホストの <filename>/etc/printcap</filename> + ファイルに次にあげるエント リを作ります. </para> + + <orderedlist> + <listitem> + <para>名前のエントリ. どんな名前でもよいのですが, 簡単 + のため, 多分, プリンタホストで設定されたプリンタ名や別 + 名と同じものを使いたいと思うでしょう.</para> + </listitem> + + <listitem> + <para><literal>lp</literal> + 項目で指定されるデバイスは明示的に空にす る + (<literal>:lp=:</literal> とする).</para> + </listitem> + + <listitem> + <para>スプーリングディレクトリを作成し, + <literal>sd</literal> 項目で その位置を指定する. LPD + では, プリンタホストにジョブ を送信するまでの間, + このディレクトリにジョブを格納しま す.</para> + </listitem> + + <listitem> + <para><literal>rm</literal> + 項目でプリンタホストの名前を指定します.</para> + </listitem> + + <listitem> + <para><literal>rp</literal> 項目で + <emphasis>プリンタホスト</emphasis> に接続したプリン + タ名を指定します.</para> + </listitem> + </orderedlist> + + <para>これで終わりです. + 変換フィルタやページの大きさやその他の事項を + <filename>/etc/printcap</filename> + に加える必要はありません.</para> + + <para>次に, + リモートホストに接続されたプリンタで印字するための設定例 + を示します. ホスト <hostid>rose</hostid> には2台のプリンタ + <literal>bamboo</literal> と <literal>rattan</literal> + が接続されています. これらのプリンタをホスト <!-- kuriyama + - check English version: orchid --> <hostid>orchid</hostid> + のユーザが使えるようにしましょう. 最初に + <hostid>orchid</hostid> の + <filename>/etc/printcap</filename> を示します + (このファイルは, 「<link + linkend="printing-advanced-header-pages-enabling"> + ヘッダページの出力を許可する</link>」 + で参照することができます). このファイルには, 既に, プリンタ + <literal>teak</literal> 用のエントリがありました. 以下では, + <!-- kuriyama - chech English version: rose --> これに, + ホスト <hostid>rose</hostid> + にある2台のプリンタ用のエントリが加えられ ています. </para> + + <programlisting> +# +# /etc/printcap for host orchid - added (remote) printers on rose +# + +# +# teak is local; it is connected directly to orchid: +# +teak|hp|laserjet|Hewlett Packard LaserJet 3Si:\ + :lp=/dev/lpt0:sd=/var/spool/lpd/teak:mx#0:\ + :if=/usr/local/libexec/ifhp:\ + :vf=/usr/local/libexec/vfhp:\ + :of=/usr/local/libexec/ofhp: + +# +# rattan is connected to rose; send jobs for rattan to rose: +# +rattan|line|diablo|lp|Diablo 630 Line Printer:\ + :lp=:rm=rose:rp=rattan:sd=/var/spool/lpd/rattan: + +# +# bamboo is connected to rose as well: +# +bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ + :lp=:rm=rose:rp=bamboo:sd=/var/spool/lpd/bamboo:</programlisting> + + <para><hostid>orchid</hostid> + で必要となる作業はスプーリングディレクトリを + 作ることだけです. </para> + + <screen>&prompt.root; <userinput>mkdir -p /var/spool/lpd/rattan /var/spool/lpd/bamboo</userinput> +&prompt.root; <userinput>chmod 770 /var/spool/lpd/rattan /var/spool/lpd/bamboo</userinput> +&prompt.root; <userinput>chown daemon.daemon /var/spool/lpd/rattan /var/spool/lpd/bamboo</userinput></screen> + + <para>これで, <hostid>orchid</hostid> のユーザが + <literal>rattan</literal> と <literal>bamboo</literal> で印字す + ることができるようになりました. + 例えば, orchid のユーザが次の + ように入力したとします. + + <screen>&prompt.user; <userinput>lpr -P bamboo -d sushi-review.dvi</userinput></screen> + + すると, orchid の LPD システムは, ジョブをスプーリングディレ + クトリ <filename>/var/spool/lpd/bamboo</filename> + にコピーし, これが DVI + ファイルを印字するジョブであることを記録します. + ホスト rose の + <hostid>bamboo</hostid> + 用のスプーリングディレクトリに十分な容量が確保でき + 次第, 両者の LPD は, ジョブのファイルを rose に転送します. こ + のファイルは, そのすべてが印字されるまで, rose + のキューに留まり + ます. (bamboo は PostScript プリンタなので) DVI から PostScript + への変換は rose でおこなわれます.</para> + </sect3> + + <sect3 id="printing-advanced-network-net-if"> + <title>ネットワークにおけるデータストリームのインタ + フェースを持つプリンタ</title> + + <para>プリンタのネットワークインタフェースカードは, 2種類に分 + 類することができます. 1つはスプーラをエミュレートするもの + (高価) で, もう 1 + つはシリアルやパラレルポートを使うようにプリンタにデー + タを送ることができるだけのもの (安価) です. この節では, + 後者の使 い方を説明します. 前者のプリンタは, 前節「<link + linkend="printing-advanced-network-rm"> + リモートホストに接続されたプリンタ</link>」 + の方法が適用できます.</para> + + <para><filename>/etc/printcap</filename> ファイルでは, + シリアルかパラレルのイン タフェースのどちらを使うのか, + そして, (シリアルインタフェース を使う場合) + そのボーレートはいくらであるか, フロー制御は使うのか, + タブのための遅延を加えるのか, + 改行文字を変換するかなどの指定を おこなうことができます. + しかし, TCP/IP や他のネットワークポートか + らデータを受け取るプリンタを接続するための + 指定をおこなうことはでき ません.</para> + + <para>ネットワーク接続されたプリンタにデータを送るためには, + テキスト フィルタと変換フィルタから呼び出すことができる + 通信プログラムを 開発する必要があります. 以下に, + そのようなプログラムの例を示し ます. スクリプト + <command>netprint</command> では, 標準入力から印字データを + すべて受け取り, + ネットワーク接続されたプリンタにこれを送ります. + <command>netprint</command> + の最初の引数でプリンタのホスト名を, 2番目の引数 + で接続するポート番号を指定します. + このプログラムでは単方向通信 (FreeBSD からプリンタ) + のみをサポートしていることに注意してくだ さい. + ネットワークプリンタの多くは双方向通信をサポートしていま + すので, その恩恵 (プリンタの状態を得たり, + 課金をおこなうなど) にあず かりたいと思われるかもしれません. + </para> + + <programlisting> +#!/usr/bin/perl +# +# netprint - Text filter for printer attached to network +# Installed in /usr/local/libexec/netprint +# + +$#ARGV eq 1 || die "Usage: $0 <printer-hostname> <port-number>"; + +$printer_host = $ARGV[0]; +$printer_port = $ARGV[1]; + +require 'sys/socket.ph'; + +($ignore, $ignore, $protocol) = getprotobyname('tcp'); +($ignore, $ignore, $ignore, $ignore, $address) + = gethostbyname($printer_host); + +$sockaddr = pack('S n a4 x8', &AF_INET, $printer_port, $address); + +socket(PRINTER, &PF_INET, &SOCK_STREAM, $protocol) + || die "Can't create TCP/IP stream socket: $!"; +connect(PRINTER, $sockaddr) || die "Can't contact $printer_host: $!"; +while (<STDIN>) { print PRINTER; } +exit 0;</programlisting> + + <para>このスクリプトは, + 様々なフィルタが利用することができます. 仮に, Diablo 750-N + ラインプリンタを持っており, これがネットワークに + 接続されているとしましょう. + プリンタはポート番号5100にて印字す るデータを受け取ります. + プリンタのホスト名は scrivener としま す. このとき, + このプリンタのテキストフィルタは次のようになりま す. </para> + + <programlisting> +#!/bin/sh +# +# diablo-if-net - Text filter for Diablo printer `scrivener' listening +# on port 5100. Installed in /usr/local/libexec/diablo-if-net +# + +exec /usr/libexec/lpr/lpf "$@" | /usr/local/libexec/netprint scrivener 5100</programlisting> + </sect3> + </sect2> + + <sect2 id="printing-advanced-restricting"> + <title>プリンタの利用に制約を与える</title> + + <para>本節では, プリンタの利用に制約を与えるための情報を記して + います. LPD システムでは, プリンタ (ローカル, リモートのいずれ + に接続されていても) にアクセスできる人を制限する機能, 複数部の + コピーの印字の可否を制御する機能, ジョブのサイズの最大値やプリ + ンタキューに入るジョブの最大個数を制御する + 機能を提供しています.</para> + + <sect3 id="printing-advanced-restricting-copies"> + <title>複数部のコピーの印字を制限する</title> + + <para>LPD + システムではユーザが複数部のコピーの印字を簡単におこなう + 機能を提供しています. ユーザが, (例えば) <command>lpr + -#5</command> コマ ンドを使ってジョブを印字すると, + ジョブのそれぞれのファイルのコ ピーを5部得ることができます. + これがよい機能であると思うかどう + かは人それぞれでしょう.</para> + + <para>複数部のコピーの印字によってプリンタが + 必要以上に消耗してしまう + と感じるならば, <filename>/etc/printcap</filename> + ファイルに <literal>sc</literal> 項 + 目を加えてください. これにより, + &man.lpr.1; の <option>-#</option> オプションの使用 + が禁止されます. このオプションが指定されているにも関らず, + <option>-#</option> オプションを使うと, + 次のようなメッセージが表示され, + このオプションの利用できない旨を伝えます. </para> + + <screen>lpr: multiple copies are not allowed</screen> + + <para>リモートホストからプリンタをアクセスできる + 設定にしている場合 (この 設定については, 「<link + linkend="printing-advanced-network-rm"> + リモートホストに接続されたプリンタ</link>」 + をご覧ください), その リモートホストの + <filename>/etc/printcap</filename> にも同じように + <literal>sc</literal> + 項目を追加する必要があることに注意してください. + そうしないと, ユーザは別なホストから複数部のコピーの + 印字することができてしま います.</para> + + <para>例を使って説明しましょう. 次に示す + <filename>/etc/printcap</filename> ファ イルは, ホスト + <hostid>rose</hostid> のものです. プリンタ + <literal>rattan</literal> は極めて 頑丈なので, + 複数部のコピーの印字は許可されています. しかし, レー + ザプリンタの <literal>bamboo</literal> + はもう少しデリケートで, このプリンタ + から複数部のコピーを印字することを <literal>sc</literal> + 項目を追加すること で禁止しています. </para> + + <programlisting> +# +# /etc/printcap for host rose - restrict multiple copies on bamboo +# +rattan|line|diablo|lp|Diablo 630 Line Printer:\ + :sh:sd=/var/spool/lpd/rattan:\ + :lp=/dev/lpt0:\ + :if=/usr/local/libexec/if-simple: + +bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ + :sh:sd=/var/spool/lpd/bamboo:sc:\ + :lp=/dev/ttyd5:fs#0x82000e1:xs#0x820:rw:\ + :if=/usr/local/libexec/psif:\ + :df=/usr/local/libexec/psdf:</programlisting> + + <para>さらに, orchid の <filename>/etc/printcap</filename> + にも <literallayout>sc</literallayout> 項目を + 追加する必要があります (<hostid>orchid</hostid> + でこの編集をおこなっているときに, つ いでに, プリンタ + <literal>teak</literal> でも複数部のコピーの印字を禁止する + ことにしましょう). </para> + + <programlisting> +# +# /etc/printcap for host orchid - no multiple copies for local +# printer teak or remote printer bamboo + +teak|hp|laserjet|Hewlett Packard LaserJet 3Si:\ + :lp=/dev/lpt0:sd=/var/spool/lpd/teak:mx#0:sc:\ + :if=/usr/local/libexec/ifhp:\ + :vf=/usr/local/libexec/vfhp:\ + :of=/usr/local/libexec/ofhp: + +rattan|line|diablo|lp|Diablo 630 Line Printer:\ + :lp=:rm=rose:rp=rattan:sd=/var/spool/lpd/rattan: + +bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ + :lp=:rm=rose:rp=bamboo:sd=/var/spool/lpd/bamboo:sc:</programlisting> + + <para><literal>sc</literal> 項目を指定することにより, + <command>lpr -#</command> の使用を防 + ぐことができます. しかし, この状態では + &man.lpr.1; を複数回起動し + たり, 1回のジョブで次のように同じファイルを + 複数個指定すること + を防ぐまでには至っていません. </para> + + <screen>&prompt.user; <userinput>lpr forsale.sign forsale.sign forsale.sign forsale.sign forsale.sign</userinput></screen> + + <para>このような悪用を防ぐ方法は + (その指示を無視することも含めて) たく さんあります. + 各自で調べてみてください.</para> + </sect3> + + <sect3 id="printing-advanced-restricting-access"> + <title>プリンタを使用できる人を限定する</title> + + <para>それぞれのプリンタを使用できる人を限定するには, UNIX の + グループ権限のメカニズムを利用し, さらに, + <filename>/etc/printcap</filename> で <literal>rg</literal> + 項目を指定することでおこないます. + あるプリンタにアクセスさせてもよいと思うユーザすべてを + UNIXのある グループに入れてください. そして, + そのグループ名を <literal>rg</literal> で 指定します.</para> + + <para>このとき, そのグループに含まれないユーザ + (root も含む) が + <emphasis remap=tt>rg</emphasis> + の指定がされたプリンタを使用すると, 次のようなメッセー + ジが表示され, プリンタの使用はできません. + + <errorname> + lpr: Not a member of the restricted group + </errorname> + + <literal>sc</literal> (suppress multiple copies : + 複数部のコピーの印字を禁止 + する) を指定するときと同様に, <literal>rg</literal> + が指定されたプリンタがリ + モートホストからもアクセスでき + (この設定については, + 「<link linkend="printing-advanced-network-rm"> + リモートホストに接続されたプリンタ</link>」 + をご覧ください), かつ, そ + のホストでもプリンタを使用できる人を限定するのが + 妥当であると思 + う場合は, そのホストの + <filename>/etc/printcap</filename> にも + <emphasis remap=tt>rg</emphasis> 指 + 定をおこなう必要があります.</para> + + <para>例えば, プリンタ <literal>rattan</literal> + は誰でも利用できるが, <literal>bamboo</literal> はグループ + <literal>artists</literal> に属している人のみが利用で + きるようにしてみましょう. 以下に, もうお馴染みとなったホスト + <hostid>rose</hostid> の <filename>/etc/printcap</filename> + を示します. </para> + + <programlisting> +# +# /etc/printcap for host rose - restricted group for bamboo +# +rattan|line|diablo|lp|Diablo 630 Line Printer:\ + :sh:sd=/var/spool/lpd/rattan:\ + :lp=/dev/lpt0:\ + :if=/usr/local/libexec/if-simple: + +bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ + :sh:sd=/var/spool/lpd/bamboo:sc:rg=artists:\ + :lp=/dev/ttyd5:fs#0x82000e1:xs#0x820:rw:\ + :if=/usr/local/libexec/psif:\ + :df=/usr/local/libexec/psdf:</programlisting> + + <para>これ以外の <filename>/etc/printcap</filename> ファイル + (ホスト <hostid>orchid</hostid> のもの) + はそのままにしておくことにします. もちろん, + <hostid>orchid</hostid> のユーザは 全員 + <literal>bamboo</literal> を利用することができます. これは, + <hostid>orchid</hostid> に + は特定のユーザのみにしかアクセスさせておらず, + そのユーザにはプ + リンタを利用させたいと思っているからなのかもしれませんし, + そう でないかもしれません.</para> + + <note> + <para>1台のプリンタを複数グループのユーザに利用させること + はできません.</para> + </note> + </sect3> + + <sect3 id="printing-advanced-restricting-sizes"> + <title>入力可能なジョブのサイズを制限する</title> + + <para>たくさんのユーザからプリンタが利用される場合には, 多分, + ユーザが印字要求を出すことができるファイルのサイズに + 上限値を置 く必要が生じるでしょう. 結局のところ, + スプーリングディレクトリ + が置かれているファイルシステムの空き容量がその + 上限値になる訳で すが, + あるユーザがこれを独占的に使用すること避けるために, 他ユー + ザからのジョブ用の空き容量を確保する必要もあります.</para> + + <para>LPD では, <literal>mx</literal> + 項目を指定することにより, ジョブ中の個々のファ + イルのサイズの上限値を制限する機能を提供しています. + 指定される ファイルサイズの単位は BUFSIZ ブロックで, 1 + BUFSIZ ブロックは 1024バイトを表わします. この <emphasis + remap=tt>mx</emphasis> 項目の値として0が指定される と, + ファイルサイズの制限はなくなります.</para> + + <note> + <para>この制限はジョブ中の各 + <emphasis>ファイル</emphasis>に対して適用されるものであり, + ジョブ全体のサイズ + を制限するものでは<emphasis>ありません</emphasis>.</para> + </note> + + <para>ところで, + プリンタに設定された上限値を超えるファイルサイズのファ + イルが入力された場合でも, LPD はこれを拒否しません. その代わ + りに, このファイルは, + その先頭から上限値のファイルサイズまでし + かキューに入れられません. そして, その部分までが印字され, + 残り の部分は捨てられます. + これが正しい動作といえるのかどうかは議 + 論の余地があるところです.</para> + + <para>それでは, 設定例に登場しているプリンタ + <literal>rattan</literal> と <literal>bamboo</literal> + の印字可能なファイルサイズに制限を加えてみましょう. artists + グループの人達が作る PostScript ファイルのサイズは + 巨大になる傾向があるので, 上限値を5Mバイトとします. + それから, + プレインテキスト用のラインプリンタは無制限とします. </para> + + <programlisting> +# +# /etc/printcap for host rose +# + +# +# No limit on job size: +# +rattan|line|diablo|lp|Diablo 630 Line Printer:\ + :sh:sd=/var/spool/lpd/rattan:\ + :lp=/dev/lpt0:\ + :if=/usr/local/libexec/if-simple: + +# +# Limit of five megabytes: +# +bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ + :sh:sd=/var/spool/lpd/bamboo:sc:rg=artists:mx#5000:\ + :lp=/dev/ttyd5:fs#0x82000e1:xs#0x820:rw:\ + :if=/usr/local/libexec/psif:\ + :df=/usr/local/libexec/psdf:</programlisting> + + <para>この場合もそうですが, この制限はローカル (ホスト rose) + のユーザ のみに適用されます. + リモートホストからプリンタを利用できるよう + に設定している場合は, + そのリモートホストのユーザはこの制限を受 けません. + これらのユーザにも制限を加える場合は, リモートホスト の + <filename>/etc/printcap</filename> の <literal>mx</literal> + を指定する必要があります. + リモートホストから印字するための詳しい情報については, + 「<link + linkend="printing-advanced-network-rm"> + リモートホストに接続されたプリンタ</link>」 + を参照してください.</para> + + <para>リモートホストに接続されたプリンタへのジョブの + サイズを制限する 特別な方法は他にもあります. これについては, + 「<link linkend="printing-advanced-restricting-remote"> + リモートホストからのプリンタの利用を制限する</link>」 + を参照してください.</para> + </sect3> + + <sect3 id="printing-advanced-restricting-remote"> + <title>リモートホストからのプリンタの利用を制限する</title> + + <para>LPD スプーリングシステムでは, リモートホストから要求され + たジョブの印字を制限するための方法がいくつか + 提供されています.</para> + + <variablelist> + <varlistentry><term>ホストの制限</term> + <listitem> + <para>ローカルの LPD + が印字要求を受け付けるリモートホストは, ファイル + <filename>/etc/hosts.equiv</filename> と + <filename>/etc/hosts.lpd</filename> + によって制御することができます. LPD では, + あるホストから印字の要求がきたとき, このホス + トの名前がこれら2つのファイルのどちらかに含まれている + かどうかを調べます. これが含まれていない場合は, LPD + はこの要求を拒否します.</para> + + <para>これらのファイルの形式は単純です. + 各行にホストの名前を + 1つずつ書いていきます. ファイル + <filename>/etc/hosts.equiv</filename> の方は + &man.ruserok.3; プロトコル + でも利用され, &man.rsh.1; や &man.rcp.1; + といったプログラム + の動作に影響するので注意が必要です. + <filename>/etc/hosts.equiv</filename> + の記述は慎重におこないましょう.</para> + + <para>例として, 以下にホスト <hostid>rose</hostid> の + <filename>/etc/hosts.lpd</filename> を示します. + </para> + + <programlisting> +orchid +violet +madrigal.fishbaum.de</programlisting> + + <para>この例では, <hostid>rose</hostid> はホスト + <hostid>orchid</hostid>, <hostid>violet</hostid>, + そして <hostid + role="fqdn">madrigal.fishbaum.de</hostid> + からの要求を受け付けることになり ます. + その他のホストが <hostid>rose</hostid> の LPD + にアクセスしようと しても, LPD はこれを拒否します + (訳注:拒否されるのは, そのホストが + <filename>/etc/hosts.equiv</filename> にも含まれてい + ない場合です).</para> + </listitem> + </varlistentry> + + <varlistentry><term>サイズの制限</term> + <listitem> + <para>スプーリングディレクトリがある + ファイルシステムに残して + おく必要がある空き容量の大きさを制御することが + できます. + ローカルプリンタ用のスプーリングディレクトリに + <filename>minfree</filename> + という名前のファイルを作成します. そして, + そのファイルの中にリモートホストからのジョブの要求を受 + け付けるために必要な空き容量のディスクブロックサイズ + (1 ディスクブロック=512バイト) を記します.</para> + + <para>これで, + リモートホストのユーザにファイルシステムを満杯 + にされないことが保証されます. この機能を使うと, ローカ + ルホストのユーザに対してある種の優先権を与えることもで + きます. ローカルホストのユーザは, + <filename>minfree</filename> ファイ + ルで指定された値よりもディスクの空き容量が下回った後で + もずっと, + ジョブをキューに入れることができるのです.</para> + + <para>例えば, プリンタ <hostid>bamboo</hostid> 用の + <filename>minfree</filename> を作っ てみましょう. + このプリンタのスプーリングディレクトリを 調べるために, + <filename>/etc/printcap</filename> を調べてみましょ + う. 以下に, <hostid>bamboo</hostid> + のエントリ部分を示します. </para> + + <programlisting> +bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ + :sh:sd=/var/spool/lpd/bamboo:sc:rg=artists:mx#5000:\ + :lp=/dev/ttyd5:fs#0x82000e1:xs#0x820:rw:mx#5000:\ + :if=/usr/local/libexec/psif:\ + :df=/usr/local/libexec/psdf:</programlisting> + + <para>スプーリングディレクトリは + <literallayout>sd</literallayout> で指定されます. LPD + がリモートホストからのジョブを受け付けるために必要 + なファイルシステムの空き容量を3Mバイト + (=6144ディスクブ ロック) にすることにしましょう. + </para> + + <screen>&prompt.root; <userinput>echo 6144 > /var/spool/lpd/bamboo/minfree</userinput></screen> + </listitem> + </varlistentry> + + <varlistentry><term>利用ユーザの制限</term> + <listitem> + <para><filename>/etc/printcap</filename> の + <literal>rs</literal> 項目を指定することで, + ローカルプリンタを利用できるリモートホストのユーザを制 + 限することができます. ローカルホストに接続されたプリン + タ用のエントリに <literal>rs</literal> + 項目が指定されている場合, LPD + は印字を要求したユーザのアカウントと同じログイン名 + がローカルホストに登録されている/em/場合に限り/, その + ジョブが受け付けられます. そうでないユーザからのジョブ + は LPD は拒否します.</para> + + <para>この機能は, (例えば) + 複数の部署がネットワークを共有して おり, + この内のあるユーザが部署の境界を越えて活動してい + る場合には特に有用です. そのようなユーザに対して, シス + テムのアカウントを与えるだけで, これらのユーザは自分が + 所属する部署のシステムからそのシステムに接続されている + プリンタを使用することができます. これらのユーザにはむ + しろ, プリンタの使用<emphasis>だけ</emphasis>を認め, + その他のコンピュー タ資源を利用させたくないときは, + それらのユーザにはホー ムディレクトリを与えず, + ログインシェルはシェルとしては 何の役にも立たない + <filename>/usr/bin/false</filename> などを指定 して, + これらのユーザのアカウントはプリンタ用の“形式的 + な”ものとします.</para> + </listitem> + </varlistentry> + </variablelist> + </sect3> + </sect2> + + <sect2 id="printing-advanced-acct"> + <title>プリンタの利用に対する課金</title> + + <para>という訳で, 印字するためには料金をとることが必要です. 取ら + ない理由などありましょうか. 紙やインクにはお金がかかります. そ + して, プリンタの維持費もかかります. プリンタには可動部分が搭載 + されており, これらの部分は壊れやすいという傾向があります. プリ + ンタや, その利用形態, 維持費について調査をし, 1ページ (1フィー + ト, 1メートルなど) 当たりにかかるコストを調べておいてください. + これに基づき, プリンタの利用に対する課金を, 実際に, どのように + 始めればよいのでしょうか.</para> + + <para>さて, 残念ながら, この部分に関しては LPD + スプーリングシステム はほとんど役に立ちません. + 課金は使用しているプリンタの種類, 印 + 字するもののファイルの形式, + プリンタの利用に対する課金での + <emphasis>あなた自身の</emphasis>要求に大きく左右されます.</para> + + <para>課金システムを実現するためには, プリンタのテキストフィルタ + (プ レインテキストのジョブに対して課金するため) と変換フィルタ + (その 他のファイル形式に対して課金するため) を変更して, + 印字したペー ジを数えたり, + プリンタに印字したページ数を取得するための要求を + 送る必要があります. ただし, 出力フィルタのみを利用している場合 + は, 課金をおこなうことができません. フィルタに関しては, + 「<link + linkend="printing-advanced-filter-intro"> + フィルタ</link>」をご覧く ださい.</para> + + <para>一般に, 課金方式には次の2つがあります. </para> + + <itemizedlist> + <listitem> + <para><emphasis>定期的に課金する方法</emphasis> + はよく利用される方法です. この理由は, 恐らく, + 比較的簡単に実現できるからです. 誰 + かがジョブを印字する度に, フィルタはそのユーザ名, ホス + ト名, 印字したページ数を課金データファイルに記録します. + 毎月, 毎学期, 毎年, あるいは, お好みの時期に, 様々なプ + リンタの課金用ファイルを集め, それぞれのユーザが印字し + たページ数を合計し, その分の課金をおこないます. 次回の課金 + 時期のためのデータを0にして課金を再開するために, この + 処理をおこなった後, すべてのログファイルを削除し,</para> + </listitem> + + <listitem> + <para><emphasis>利用毎に課金する方法</emphasis> + はあまり利用されていません. これは, + 実現するのが比較的難しいからです. この方式では, + プリンタを使用したらすぐに, フィルタがユーザにその利用 + に対する課金をおこないます. ディスククオータのように, 課金 + 作業は瞬時におこなわれます. この方式では, ユーザのアカウン + トが赤字になる場合に, ユーザが印字をおこなうことを拒否する + ことができます. また, ユーザに“プリンタ版 + quota”を 調べたり, + 調整したりする方法を提供したいと思うかもしれ ません. + これを実現するためには, ユーザとその quota を + 追跡するために, あるデータベース用のコードが必要となり + ます.</para> + </listitem> + </itemizedlist> + + <para>LPD スプーリングシステムでは, 両方式を簡単にですがサポー + トしています. これは, (ほとんどの場合で) 印字作業をフィ + ルタがおこなっていたように, 課金作業もこのためのコードも用 + 意することで実現されています. しかし, 明るい面もありま す. + それは, 課金方式に関して, 非常に大きな柔軟性が与え + られたということです. 例えば, 「定期的に課金する方法」 か, + 「利用毎に課金する方法」のどちらかを選びまず, そし て, + どんな情報 (ユーザ名, ホスト名, ジョブのタイプ, 印 + 字された頁数, 使用した紙の大きさ, 印字をするために要した + 時間など) をログに記録するかを決めます. 以上のことをおこな + うには, 上記の情報を保持するために, フィルタを変更しな + くてはなりません.</para> + + <sect3> + <title>手軽なプリンタ課金方法</title> + + <para>FreeBSD には, 「定期的に課金する方法」による課金をすぐに + 設定できるように, 2個のプログラムを添付しています. そ + の内の1つはテキストフィルタ <command>lpf</command> で, + これについて + は, 「<link linkend="printing-advanced-lpf"> + テキストフィルタ lpf</link>」をご覧ください. もう1つは, + &man.pac.8; で, + これはプリンタの課金データファイルからのエントリを集め, + これを合計するプログラムです.</para> + + <para>「<link linkend="printing-advanced-filters"> + フィルタはどのように機能しているか</link>」で述べたように, + LPD では テキストフィルタや変換フィルタを起動しますが, + そのコマ + ンドラインで使用している課金データファイルの名前が指定 + されます. 両フィルタはこの引数を使って, どの課金データ + ファイルのエントリに書き込めばよいのかを知ることができ ます. + このファイルの名前は <filename>/etc/printcap</filename> 中の + <literal>af</literal> 項目によって指定されます. + このファイルが絶対パ スで指定されない場合は, + スプーリングディレクトリからの + 相対パスとして扱われます.</para> + + <para>LPD は, 紙のページの幅と行数 (<literal>pw</literal> と + <literal>pl</literal> 項目で 指定される) を引数として + <command>lpf</command> を起動します. <command>lpf</command> + では, 何ページ印字したかを決定するためにこれ + らの引数を使用します. ファイルをプリンタに送った後, 課 + 金情報を課金データファイルに書き込みます. このファイル + は次のようになります. </para> + + <programlisting> +2.00 rose:andy +3.00 rose:kelly +3.00 orchid:mary +5.00 orchid:mary +2.00 orchid:zhang</programlisting> + + <!-- kuriyama - this para is not sync with Eng. ver? --> + <para>課金データファイルはプリンタ毎に分けて作るべきです. こ + れは, <command>lpf</command> + にはデータファイルをロックする機構が組 + み込まれていないためです. したがって, <command>lpf</command> + が2つ起動 されたとき, + 同じファイルに同時に書き込みをおこなった場合, + お互いのエントリが破壊されてしまうかもしれません. 課金 + 用ファイルを各プリンタ毎に確実に分けるには, + <filename>/etc/printcap</filename> 中の + <literal>af=acct</literal> 項目を使いま す.</para> + + <para>プリンタの利用に対してユーザに課金する準備ができたら, + スプーリングディレクトリに移動した後, + &man.pac.8; と入力 + してください. 次のような, ドル中心主義の課金リストが表 + 示されます(訳注:ドル中心主義という表現は, 表示がドルで + 出ることへの著者の皮肉でしょう. セントがあるので小数点 + 以下が表示されますが, この機能も日本では邪魔ですね).</para> + + <screen> Login pages/feet runs price +orchid:kelly 5.00 1 $ 0.10 +orchid:mary 31.00 3 $ 0.62 +orchid:zhang 9.00 1 $ 0.18 +rose:andy 2.00 1 $ 0.04 +rose:kelly 177.00 104 $ 3.54 +rose:mary 87.00 32 $ 1.74 +rose:root 26.00 12 $ 0.52 + +total 337.00 154 $ 6.74</screen> + + <para>&man.pac.8; が受け付ける引数には + 次のようなものがあります. </para> + + <variablelist> + <varlistentry><term><option>-P<replaceable>printer</replaceable></option></term> + <listitem> + <para> プリンタ <replaceable>printer</replaceable> + の利用に対する課金リストを作成し ます. + このオプションは, <filename>/etc/printcap</filename> + の <literal>af</literal> + が絶対パスで指定されていた場合に限り, 動作しま + す.</para> + </listitem> + </varlistentry> + + <varlistentry><term><option>-c</option></term> + <listitem> + <para>ユーザ名のアルファベット順ではなく, + 課金額の低い順にリ ストを並べます.</para> + </listitem> + </varlistentry> + + <varlistentry><term><option>-m</option></term> + <listitem> + <para>課金データファイルにあるホスト名を無視します. + このオプショ ンを使用すると, ホスト + <hostid>alpha</hostid> のユーザ + <username>smith</username> とホスト + <hostid>gamma</hostid> のユーザ + <username>smith</username> は同一人物として扱われます. + この オプションが指定されない場合は, + 両者は別なユーザとして 扱います.</para> + </listitem> + </varlistentry> + + <varlistentry><term><option>-p<replaceable>price</replaceable></option></term> + <listitem> + <para><filename>/etc/printcap</filename> の + <literal>pc</literal> 項目で指定された値, または, + デフォルトの値 (2セント) に代わり, 紙1ページ, ま たは, + 1フィート当たりの価格を指定します. + <replaceable>price</replaceable> として, + 浮動小数点数を指定することができます.</para> + </listitem> + </varlistentry> + + <varlistentry><term><option>-r</option></term> + <listitem> + <para>リストの並べる順番を逆順にします.</para> + </listitem> + </varlistentry> + + <varlistentry><term><option>-s</option></term> + <listitem> + <para>課金リストを作成し, + 課金データファイルを削除します.</para> + </listitem> + </varlistentry> + + <varlistentry><term><replaceable>name</replaceable> <replaceable>…</replaceable></term> + <listitem> + <para>ユーザ <replaceable>names</replaceable> + に対する課金情報のみを表示します.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>&man.pac.8; が生成するデフォルトのリストには, + 各ホストのユーザ別 + に印字ページ数が表示されます. + (ユーザがサイト内のすべてのホスト + を使用できるため) ホスト名の情報が意味を持たない場合, + <command>pac -m</command> + を実行してください. 次のようなリストが得られます.</para> + + <screen> Login pages/feet runs price +andy 2.00 1 $ 0.04 +kelly 182.00 105 $ 3.64 +mary 118.00 35 $ 2.36 +root 26.00 12 $ 0.52 +zhang 9.00 1 $ 0.18 + +total 337.00 154 $ 6.74</screen> + + <para>課金額を決めるために, + &man.pac.8; は <filename>/etc/printcap</filename> ファ + イルの <literal>pc</literal> + 項目で指定された値 (デフォルト値は200, すなわち1 + ページ当たり2セント) + を使います. この項目で, 印字物に課金したい + と思う1ページ当たり, + または, 1フィート当たりの価格を100分の1セ + ント単位で指定します. + &man.pac.8; を <option>-p</option> オプション付きで起動 + すると, この値を置き換えることができます. + この <option>-p</option> オプショ + ンで指定する額の単位は, + 100分の1セント単位ではなく, ドル単位で + す. 例えば, 次の指定では, + 1ページ当たりの単価が1ドル50セントに + なります. + + <screen>&prompt.root; <userinput>pac -p1.50</userinput></screen> + + このオプションを使うと, + 実際の課金額を集計することができます.</para> + + <para>最後に, <command>pac -s</command> + を起動すると, 課金情報は課金データ累計ファ + イルに保存されます. + このファイルの名前は, プリンタの課金データ + ファイルの後ろに + <literal>_sum</literal> を付けたものとなります. そして, 課 + 金データファイルは削除されます. 次に + &man.pac.8; が起動されると, + その時点までの累計金額を得るために, + 課金データ累計ファイルが読 + み込まれ, 通常の課金データファイルからの情報に + 加算されます.</para> + </sect3> + + <sect3> + <title>印字されたページ数をどのように数えるか?</title> + + <para>課金を, リモートホストからの印字でさえも, + 正確におこなうため には, + ジョブで使用された紙が何ページであるかを特定でき + る必要があります. このことは, プリンタ利用に対する課金 + をおこなう上の根本的な問題です.</para> + + <para>プレインテキストのジョブの場合, 問題を解決するのはさほ + ど難しくはありません. ジョブが何行であったかを数え, プ + リンタがサポートしている紙1ページに印字できる最大の行 + 数と比較すればよいのです. 重ね打ちするために利用される + ファイル中のバックスペース文字や, 物理的に複数の行に渡 + る長い論理行に対する取り扱いを + 忘れずにおこなってください.</para> + + <para>(「<link + linkend="printing-advanced-lpf">テキストフィ,ルタ + lpf</link>」で紹介した) テキストフィルタ + <command>lpf</command> では, 課金をおこなうときに, + これらの取り扱いをおこなってくれます. 課 + 金をおこなうために必要なテキストフィルタを作成している方は, + <command>lpf</command> + のソースコードが参考になるでしょう.</para> + + <para>これに対して, 他のファイル形式の処理はどのようにすれば + よいのでしょうか.</para> + + <para>まず, DVI から LaserJet, または, DVI から PostScript + への変換の場合, フィルタが <command>dvilj</command> や + <command>dvips</command> の 出力メッセージを解析することで, + 何ページ分の変換がおこなわ れたかを知ることができます. + 他のファイル形式とその変換 プログラムに関しても, + 同様のことができるかもしれません.</para> + + <para>しかし, この方式には問題点があります. それは, 変換され + たページがすべて印字されるとは限らないということです. 例 + えば, プリンタが紙詰まりを起こしたり, トナー切れになっ たり, + はたまた, 爆発したりするかもしれません. そのよう + な状況により印字が途中で中止されたとしても, この方式で は, + ユーザは全ページ分の料金を課されてしまうのです.</para> + + <para>それでは, どのような対策をたてることができるのでしょう + か.</para> + + <para><emphasis>正確な</emphasis> + 課金をおこなうための唯一の<emphasis>確実な</emphasis>方法は, + 何 ページ印字したのかを知らせることができるプリンタを入手 + し, これをシリアルポートかネットワークに接続することで す. + ほとんどすべての PostScript プリンタではこの概念 + がサポートされています. 他のプリンタも同様です (Imagen + レーザプリンタをネットワーク接続するなど). それぞれの + プリンタのフィルタを, ジョブを印字した後で印字ページ数 + を得るように, 変更してください. そして, 課金情報はここ + で得られた値<emphasis>のみに</emphasis> + 基づいて記録してください. 行数 を数えたり, + エラーが生じやすいファイルの調査は必要とさ れません.</para> + + <para>もちろん, 気前よく印字料 + 金をすべて無料にすることもできます.</para> + </sect3> + </sect2> + </sect1> + + <sect1 id="printing-lpd-alternatives"> + <title>標準スプーラの代替品</title> + + <para>このマニュアルを最初から通読されている方ならば, ここまでで, + FreeBSD 付属の LPD スプーリングシステムに関して知っておくべき + ことすべてを学ばれたことと思います. 多分, このシステムに + あるたくさんの欠点について認識できたことでしょう. すると, + “(FreeBSD 上で動作する) + スプーリングシステムには他にどのような + ものがあるのか”という疑問が自然と湧いてきます.</para> + + <para>残念ながら, 著者は代替のスプーラを <emphasis>2つ</emphasis> + だけしか探し出すこと ができませんでした. そして, + それぞれはほとんど同一のものです. 以下に, + 両システムの紹介をおこないます. </para> + + <variablelist> + <varlistentry><term>PLP (Portable Line Printer スプーリングシステム) </term> + <listitem> + <para>PLP は Patrick Powell によって開発されたソフトウエアを + ベースにされており, インタネット規模のグループの開発者 + によって管理されていました. このソフトの主要サイトは「 + <ulink + URL="ftp://ftp.iona.ie/pub/plp"> + ftp://ftp.iona.ie/pub/plp</ulink>」です. + 「<ulink URL="http://www.iona.ie:8000/www/hyplan/jmason/plp.html"> + web page</ulink>」にもあります.</para> + + <para>PLP は BSD LPD スプーラと極めて似ていますが, 以下のも + のを含むホストの機能が自慢です. </para> + + <itemizedlist> + <listitem> + <para>ネットワークサポートの強化. ネットワーク接続され + るプリンタのサポートや NIS で管理可能な printcap ファ + イル, NFS マウントされるスプーリングディレクトリの機 + 能が組み込まれています.</para> + </listitem> + + <listitem> + <para>洗練されたなキュー管理. 1つのキューで複数のプリン + タに対応可能. キュー間でジョブを転送したり, キューのリ + ダイレクトができます.</para> + </listitem> + + <listitem> + <para>リモートプリンタの制御機能</para> + </listitem> + + <listitem> + <para>ジョブの優先順位付け</para> + </listitem> + + <listitem> + <para>拡張性のあるセキュリティとアクセスオプション</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry><term>LPRng</term> + <listitem> + <para>LPRng は, その称するところの意味は“LPR: the Next + Generation”ですが, PLP を完全に書き換えたものになっ + ています. Patrick Powell と Justin Mason (PLP の主要 + なの管理者) の共同で LPRng が作成されました. LPRng の + 主要サイトは「 <ulink + URL="ftp://dickory.sdsu.edu/pub/LPRng"> + ftp://dickory.sdsu.edu/pub/LPRng</ulink>」です.</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + + <sect1> + <title>謝辞</title> + + <para>このドキュメントの開発の手助けをして頂いた以下の方々に感謝の + 意を表わしたいと思います.</para> + + <variablelist> + <varlistentry><term>Daniel Eischen <email>deischen@iworks.interworks.org</email></term> + <listitem> + <para>精読するためのあり余るほどの HP 用フィルタを提供してく + れたことに.</para> + </listitem> + </varlistentry> + + <varlistentry><term>&a.jehamby;</term> + <listitem> + <para>提供して頂いた Ghostscript から HP + へのフィルタに.</para> + </listitem> + </varlistentry> + + <varlistentry><term>私の妻, Mary Kelly <email>urquhart@argyre.colorado.edu</email></term> + <listitem> + <para>彼女と一緒にいるよりもずっと長い時間を FreeBSD のため + に費やすことを許してくれたことに.</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/quotas/chapter.sgml b/ja_JP.eucJP/books/handbook/quotas/chapter.sgml new file mode 100644 index 0000000000..5707a188e8 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/quotas/chapter.sgml @@ -0,0 +1,296 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.8 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:57 kuriyama Exp $ +--> + +<chapter id="quotas"> + <title>ディスク クォータ</title> + + <para><emphasis>原作: &a.mpp;<!-- <br> --> + 26 February 1996 </emphasis>.</para> + + <para><emphasis>訳者: &a.jp.mihoko;.<!-- <br> --> + 6 September 1996 </emphasis>.</para> + + <para>クォータシステムは, + オペレーティングシステムのオプション機能で, + 各ファイルシステム上で ユーザやグループのメンバが使用するディスク + スペースの総量を規制したり, 作成できるファイルの個数を制限したりす + ることができます. この機能は, 各ユーザ, + 各グループごとに使用できる資源の総量を制限で + きるようなタイムシェアリングシステム上で + もっともよく使用されていま す. これは, 一人のユーザが, + 使用可能な全てのディスクスペースを使い + きってしまうことを防止できます.</para> + + <sect1> + <title>ディスククォータを使用するための設定</title> + + <para>ディスククォータを使用しようとする前に, + あなたが使用しているカー + ネルで, クォータが組み込まれているかどうかを + 確認する必要があります. + クォータを使用できるカーネルを構築するためには, + カーネルコンフィギュ レーションファイルに, + 次の行を追加してください:</para> + + <programlisting> +options QUOTA</programlisting> + + <para>標準の <filename>GENERIC</filename> + カーネルでは, この機能は有効になっていません. + したがって, ディスククォータを使用するためには, + カーネルをコンフィグレーションして構築しなおし, そのカーネ + ルをインストールしなければいけません. カーネルの構築方法について + の詳細情報は, <link linkend="kernelconfig">FreeBSD + カーネルのコンフィグレーション</link> + を参照してください.</para> + + <para>次に, ファイル <filename>/etc/sysconfig</filename> の中で, + ディスククォー + タ機能を、使用可能に設定する必要があります. + そのためには, 以下の行を変更します: + + <programlisting> +quotas=NO</programlisting> + + を次のように: + + <programlisting> +quotas=YES</programlisting></para> + + <para>FreeBSD 2.2.2 以降では, <filename>/etc/rc.conf</filename> + でこの設定を行いま + す. また, 変数の変更は以下のようにします.</para> + + <programlisting> +check_quotas=YES</programlisting> + + <para>最後に, 各ファイルシステム毎にディスククォータを設定する + ために, ファイル <filename>/etc/fstab</filename> + を編集する必要があります. + 全てのファイルシステムに対して, + ユーザ又はグループのいずれかのクォー タ + を設定することも, + ユーザとグループの両方のクォータを設定すること + もできます.</para> + + <para>ファイルシステム上で, ユーザ毎のクォータを設定するためには, + <literal>userquota</literal> オプションを, ファイル + <filename>/etc/fstab</filename> の中 で, + クォータを設定したいファイルシステムの + エントリののオプションフィー ルドに追加してください. + 例えば:</para> + + <programlisting> +/dev/sd1s2g /home ufs rw,userquota 1 2</programlisting> + + <para>同様に, グループのクォータを設定するためには, + <literal>groupquota</literal> オプションを + <literal>userquota</literal> の代わりに使用 してください. + ユーザとグループの両方のクォータを設定するためには, + 次のようにエントリを変更してください:</para> + + <programlisting> +/dev/sd1s2g /home ufs rw,userquota,groupquota 1 2</programlisting> + + <para>デフォルトでは, クォータファイルは ファイルシステムの root + ディ レクトリ上に, ユーザとグループのクォータに対して それぞれ + <filename>quota.user</filename> と + <filename>quota.group</filename> という名前で置いてあり + ます. 詳細情報は, <command>man fstab</command> を御覧ください. + man + ページには, クォータファイルを別な場所に置くことができると書い + てありますが, さまざまな + クォータユーティリティのうち, この機能を + 適切に処理できていないものがあるので, + クォータファイルをデフォルト + の場所以外に置くことは勧められません.</para> + + <para>ここまで準備ができたら, 新しいカーネルを使って, + システムを立ち 上げ直してください. <filename>/etc/rc</filename> + ファイルが, 自動的に適切なコマンドを起動してくれ, あなたが + <filename>/etc/fstab</filename> + ファイルで使用可能にした全てのクォー + タに対して, 初期クォータファイルを作成してくれます. + したがって, 手動で サイズ 0 + のクォータファイルを作成する必要はあり ません.</para> + + <para>通常の作業の流れでは, 手動で <command>quotacheck</command>, + <command>quotaon</command>, または <command>quotaoff</command> + コマンドを起動すべきで はありません. しかしながら, + それらの作業について詳しく知りたい場合に は, man + ページを御覧ください.</para> + </sect1> + + <sect1> + <title>クォータ制限の設定</title> + + <para>一旦システムのクォータを有効に設定したら, + 本当にクォータが使用可能になっていることを確かめてください. + これを簡単に確かめるには,</para> + + <screen>&prompt.root; <userinput>quota -v</userinput></screen> + + <para>コマンドを実行してみて ください. ディスク使用量の総計と, + クォータが設定されている各ファイ + ルシステム毎の現在のクォータ制限が表示されます.</para> + + <para>さてこれで, <command>edquota</command> + コマンドによって, クォータ制限をか ける準備ができました.</para> + + <para>ユーザまたはグループが使用できるディスクスペースの総計や, + 作成 することのできるファイル数に制限をかけるための + オプションがいくつか あります. ディスクスペース容量規制 + (ブロッククォータ) または ファイ ル数制限 (iノードクォータ) + またはその両方を行うことができます. + これらの個々の制限は, 二つのカテゴリ, すなわち ハード制限とソ + フト制限, でもっと細かく分類できます.</para> + + <para>ハード制限は越えることができません. + ユーザがハード制限に到達す ると, 該当するファイルシステム上で + ディスクスペースを確保することが できなくなります. + 例えば, もしユーザがファイルシステム上で 500 ブ + ロックのハード的制限をされていて, かつ, 現在, 490 + ブロック使用して いたとすると, ユーザはあと 10 + ブロックしか確保できません. + 11 ブロック目を確保しようとすると, 失敗します.</para> + + <para>一方, ソフト制限は, + 定められたある一定の期間以内ならば制限を越 + えることができます. この一定期間は, 猶予期間と呼ばれています. + 猶予期間のデフォルトは + 1週間です. もし、ユーザが猶予期間を過ぎても + ソフト制限を越えて使用し続けていた場合には, + ソフト制限はハード制限 に切り替わり, もはやこれ以上は, + ディスクスペースを確保できなくなり + ます. ユーザのディスク使用量がソフト制限以下に戻った時に, + 猶予期間 がリセットされます.</para> + + <para>以下は, <command>edquota</command> + コマンドを実行した時の出力例です. <command>edquota</command> + コマンドが起動されると, <envar>EDITOR</envar> 環境変数 + で定義されたエディタ, または, <envar>EDITOR</envar> + 環境変数が設定されて いない場合には <command>vi</command> + エディタが起動され, クォータ制限を編集 + することができます.</para> + + <screen>&prompt.root; <userinput>edquota -u test</userinput></screen> + + <programlisting> +Quotas for user test: +/usr: blocks in use: 65, limits (soft = 50, hard = 75) + inodes in use: 7, limits (soft = 50, hard = 60) +/usr/var: blocks in use: 0, limits (soft = 50, hard = 75) + inodes in use: 0, limits (soft = 50, hard = 60)</programlisting> + + <para>通常は, + クォータが設定されているファイルシステム毎に2行の表示が + 行われます. 1行は, ブロック制限に関する情報で, + もう1行は, i ノード + 制限に関する情報です. + クォータ制限の値を変更したい値に書き換えてく + ださい. 例えば, ユーザのブロック制限を, 50 ブロックまでのソ + フト制限と 75 ブロックまでのハード制限から, + 500 ブロックまでのソフ + ト制限と 600 ブロックまでのハード制限にしたい場合は, + 次のように書き換えます: + + <programlisting> +/usr: blocks in use: 65, limits (soft = 50, hard = 75)</programlisting> + + を次のように:</para> + + <programlisting> +/usr: blocks in use: 65, limits (soft = 500, hard = 600)</programlisting> + + <para>新しいクォータ制限は, + エディタを終了した時に置き換えられます.</para> + + <para>uid の範囲によってクォータを設定する個とも可能です. + そのためには <command>edquota</command> + コマンドで, <option>-p</option> オプションを + 使用します. まずはじめに, + かけたいクォータ制限を, 一人のユーザに対 + して設定します. それから次のコマンドを実行します + <command>edquota -p protouser startuid-enduid</command>. + 例えば, もし, ユーザ <username>test</username> + がクォータ制限をかけられていた + とすると, 次のコマンドは, 同じ制限を, uid 10,000 から 19,999 + まで のユーザにかけることができます:</para> + + <screen>&prompt.root; <userinput>edquota -p test 10000-19999</userinput></screen> + + <para>uid の範囲によって制限をかけることができる機能は, 2.1 + がリリー スされたあとに追加されました. もし、2.1 + のシステム上で, この機能を 必要とする場合には, 新しい edquota + を入手する必要があります.</para> + + <para>詳細情報は <command>man edquota</command> を御覧ください.</para> + </sect1> + + <sect1> + <title>クォータ制限およびディスク使用状況のチェック</title> + + <para>クォータ制限およびディスク使用状況をチェックするには, + <command>quota</command> または <command>repquota</command> + コマンドを使用することがで きます.<command>quota</command> + コマンドは, 各ユーザ, 各グループ毎のクォー + タ制限およびディスク使用状況をチェックすることができます. + スーパーユーザだけが, + 他のユーザまたは自分が所属していないグループに + 関するクォータ制限とディスク使用状況を調べることができます. + <command>repquota</command> + コマンドは, クォータが設定されているファイルシス テムに対する, + 全てのクォータ制限およびディスク使用状況の総計を表示 + します.</para> + + <para>以下は, 2つのファイルシステム上で + クォータ制限がかけられているユー ザに対して <command>quota + -v</command> コマンドを実行した出力結果の例です.</para> + + <programlisting> +Disk quotas for user test (uid 1002): + Filesystem blocks quota limit grace files quota limit grace + /usr 65* 50 75 5days 7 50 60 + /usr/var 0 50 75 0 50 60</programlisting> + + <para>上の例では, <filename>/usr</filename> + ファイルシステム上で, このユーザは現在 50 + ブロックまでのソフト制限を 15 ブロック超過して使用しており, + 残り 5 日間の猶予期間を設定されています. アスタリスク + <literal>*</literal> + は, ユーザが現在クォータ制限を越えていることを示 + しています.</para> + + <para>通常, + ユーザがディスクスペースを全く使用していないファイルシス + テムは, たとえ + そのファイルシステムにクォータ制限が設定されていた + としても, <command>quota</command> + コマンドによる出力では表示されません. <option>-v</option> + オプションを付けると, 上の例の <filename>/usr/var</filename> + ファ イルシステムのように, + これらのファイルシステムも表示します.</para> + </sect1> + + <sect1> + <title>* NFS ファイルシステム上でのクォータ</title> + + <para>このセクションはまだ作成中です.</para> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/security/chapter.sgml b/ja_JP.eucJP/books/handbook/security/chapter.sgml new file mode 100644 index 0000000000..42003d26dd --- /dev/null +++ b/ja_JP.eucJP/books/handbook/security/chapter.sgml @@ -0,0 +1,1901 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.12 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:58 kuriyama Exp $ +--> + +<chapter id="security"> + <title>セキュリティ</title> + + <sect1 id="crypt"> + <title>DES, MD5, と Crypt</title> + + <para><emphasis>原作: &a.wollman;<!-- <br> --> + 24 September 1995.</emphasis></para> + + <para><emphasis>訳: &a.hanai;<!-- <br> --> + 12 September 1996.</emphasis></para> + + <para>UN*X システムにおいてパスワードを保護し, + 簡単に覗かれるのを防 ぐために, + 従来パスワードはある方法によりスクランブルされてきました. + ベル研の Unix 第7版に始まって以来, + パスワードはセキュリティの専門家がい うところの + “一方向ハッシュ関数” + というものを用いることにより暗号化されるようになりました. + つまり, 可能な限りのパスワード空間を検索するという強引な + 方法以外にそのオリジナルを得ることができない, + といった方法でパスワードは変換 されるのです. 不幸なことに, + その当時 AT&T の研究者たちが手に入れることができ + た唯一の暗号化方法は DES(Data Encryption Standard) + に基づいたものでし た. + これは営利企業にとっては大して問題ではありませんが, FreeBSD のよ + うにすべてのソースコードが自由に手に入る + オペレーティングシステムにとっ ては重大な問題となります. + なぜなら, 多くの政府は DES やその他の暗号化ソフ + トウェアが国境を越えることに + 制限をつけようとしているからです.</para> + + <para>ここで, FreeBSD チームは一つのジレンマに直面しました. + つまり, どうす れば法に触れることなく国外にあるそれらの UNIX + システムのすべてに互換性を持 たせることができるか, + ということです. 私たちは ``dual track approach'' を + 取ることに決めました. + 規制されていないパスワードスクランブラのみを含む + 配布用物件を作り, DES + に基づいたパスワードハッシュを付加ライブラリ + として分けて供給するのです. + パスワードをスクランブルさせる関数は, C ライブラリから + <filename>libcrypt</filename> と呼ばれる(それを実行する C 関数が + <function>crypt</function> と + いう名前だからです)別のライブラリへ移されました. FreeBSD 1.x + 及び 2.0 のリリース前のスナップショットでは, + その規制されていないスクランブラは Nate Williams + によって書かれた安全でない関数を使っていますが, 次の + リリースでは RSA Data Security 社の一方向ハッシュ関数の MD5 + を使う方法 に置き換えられました. + これらの関数はどれも暗号化を含んでいないため, + 合衆国から持ち出し, + 他の多くの国へ持ち込めるものであるとされています.</para> + + <para>一方, DES + に基づいたパスワードハッシュ関数に関する作業もまた進行中 でした, + まず, 合衆国及び他の国で書かれたコードの同期をとりながら, + 合衆国の外で書かれた <function>crypt</function> + のあるバージョンが持ち込まれました. そしてライブラリは修正され, + 二つにわけられました. すなわち DES <filename>libcrypt</filename> + は一方向パスワードハッシュをおこなうのに必要なコード のみを含み, + それとは別の <filename>libcipher</filename> + は実際に暗号化をおこなう + ためのエントリポイントとして生成されました. + コンパイルされたライブラリに対 + して国外に持ち出す許可を得るのを簡単にするために, + コードはこのように分け られたのです.</para> + + <sect2> + <title><command>crypt</command> メカニズムを理解する</title> + + <para>あるパスワード文字列を作るのに, DES + に基づいたハッシュ関数を使っ たのか, + MD5に基づいたハッシュ関数を使ったのかは非常に簡単にわかります. + MD5 を使ったパスワード文字列は必ず + <literal>$1$</literal> という文字 で始まります. + DESを使ったパスワード文字列はどんな特定の文字も持っていま + せんが, MD5を使ったパスワードよりも短く, + <literal>$</literal> という文字 + を持たない64文字のアルファベットで構成されています. + したがって, ドル記号で 始まっていない比較的短い文字列は DES + を使ったパスワードである可能性が非常 に高いです.</para> + + <para>あなたのシステムで, + どちらのライブラリが使われているかを決めるの は, + スタティックにリンクされている <command>init</command> + のようなもの(その ようなプログラムに対する唯一の方法は + わかっているパスワードを試してみ + て動くかどうかを確認することです.) + を除いたほとんどのプログラムについ ては非常に簡単なことです. + <function>crypt</function> を使うようなプログラムは + <filename>libcrypt</filename> にリンクされています. + そしてそれぞれのライブラリに 対する <emphasis + remap=tt>libcrypt</emphasis> + は適切な実装へのシンボリックリンクとなってい ます. 例えば, DES + 版を使っているようなシステムにおいては次のようになって + います:</para> + + <screen>&prompt.user; <userinput>cd /usr/lib</userinput> +&prompt.user; <userinput>ls -l /usr/lib/libcrypt*</userinput> +lrwxr-xr-x 1 bin bin 13 Sep 5 12:50 libcrypt.a -> libdescrypt.a +lrwxr-xr-x 1 bin bin 18 Sep 5 12:50 libcrypt.so.2.0 -> libdescrypt.so.2.0 +lrwxr-xr-x 1 bin bin 15 Sep 5 12:50 libcrypt_p.a -> libdescrypt_p.a</screen> + + <para>MD5 に基づいたライブラリを使っているシステムにおいては, + 同じようなリンクが 見られるでしょうが, そのターゲットは + <filename>libdescrypt</filename> ではなく + <filename>libscrypt</filename> になっているでしょう.</para> + </sect2> + </sect1> + + <sect1 id="skey"> + <title>S/KEY</title> + + <para><emphasis>原作: &a.wollman;<!-- <br> --> + 25 September 1995.</emphasis></para> + + <para><emphasis>訳: &a.jp.hino;.<!-- <br> --> + 24 September 1996.</emphasis></para> + + <para>S/KEY は一方向ハッシュ関数 (ここで述べているバージョンでは, + 過去と の互換性を保つために MD4 を用いています. S/KEY + の他のバージョンでは MD5 や DES-MAC を用いているものもあります) + を基にしたワンタイムパスワー ド方式です. S/KEY は, バージョン + 1.1.5 以降のすべての FreeBSD に標準的 に含まれています. S/KEY は + FreeBSD 以外の数多くのシステムの上でも利用 可能であり, + その実装の数も増えています. S/KEY ば Bell Communications + Research, Inc. の登録商標です.</para> + + <para>以下の説明では, 三種類の異なる「パスワード」が使われます. + まず一つ 目は, あなたが普段使っている普通の UNIX スタイルの, + もしくは Kerberos でのパスワードです. ここではこれを + “UNIX パスワード” と呼ぶことにし ます. 二つ目は, + S/KEY の <command>key</command> プログラムによって生成され, + <command>keyinit</command> + プログラムとログインプロンプトが受け付ける, 一回限りの + パスワードです. ここではこれを + “ワンタイムパスワード” と呼ぶことにし ます. + 三つ目のパスワードは, <command>key</command> (と場合により + <command>keyinit</command>) + プログラムに対してユーザが入力する秘密のパスワードで, + ワンタイムパスワー ドを生成するのに使われます. ここではこれを + “秘密のパスフレーズ” もし くは単に + “パスフレーズ” と呼ぶことにします. (訳注: + ユーザが頭の中だ けにしまっておくべきものが, + この秘密のパスフレーズです. なお, 原文では + これをパスワードと表記していますが, + 混乱を避けるために訳文ではすべて “ + 秘密のパスフレーズ” に統一しています.)</para> + + <para>秘密のパスフレーズは, UNIX + パスワードと同じである必要はありませんし, また UNIX + パスワードと何らかの関連性を持たなければならないということも + ありません (両者を同一に設定することは可能ですが, + お奨めしません). UNIX パスワードは長さが 8 + 文字に制限されています (訳注: FreeBSD で DES + を導入していない場合はもっと長いパスワードも認識されます). + これに対し, S/KEY + では秘密のパスフレーズを好きなだけ長くすることができます (訳注: + 実装上, `<emphasis remap=tt>key</emphasis>' + コマンドなどのバッファ長で制限されてしまう可能性が あります. + 200文字程度に押えておいた方がよいでしょう :-). 筆者は 7 語か + らなる文を使っています. 通常の設定では, S/KEY システムは UNIX + のパスワー + ドシステムと完全に独立して動作するようになっています.</para> + + <para>S/KEY システムでは他に二種類のデータを使用します. 一つは + “シード (種)” または (混乱を招きますが) + “キー” と呼ばれるもので, (訳注: デ フォルトでは) + 二つの文字と五つの数字で構成されます. もう一つは + “<quote>シー ケンス番号</quote> で, 1 以上の整数です. + シーケンス番号は特に指定しなければ 100以下です (訳注: + ``<emphasis remap=tt>keyinit</emphasis>' プログラムでは 9999 + まで指定できま す). S/KEY + はここまでに述べたデータを利用してワンタイムパスワードを生 + 成します. その方法は, まずシードと秘密のパスフレーズを連結し, + それに対 してシーケンス番号の回数だけ一方向ハッシュ (RSA Data + Security, Inc. に よる MD4 セキュアハッシュ関数) + を繰り返し計算します. そしてその結果を 六つの英単語に変換します + (訳注: ハッシュ計算の後, 64ビットに収まるよう + にデータを処理したものが厳密な意味でのワンタイムパスワードです. + 通常は ユーザの便宜のために, この + 64ビットデータと六つの英単語との間で変換処 理をおこなっています) + . <command>login</command> プログラムと <command>su</command> + プログラム は, + 前回最後に受け付けられたワンタイムパスワードを記録しています. + そし て, その前回のワンタイムパスワードと, + ユーザが入力したワンタイムパスワー + ドを一回ハッシュ関数にかけた結果とが一致した場合に, + このユーザは認証さ れます. 一方向ハッシュ関数を使うことにより, + もし (ログイン等に成功した) + ワンタイムパスワードが一回盗聴されたとしても, + 次回以降に使われる複数の + ワンタイムパスワードを生成することは不可能です. + シーケンス番号はログイ ン (等) + が成功するたびに一つずつ減らされて, ユーザとログインプログラム + の間で同期が取られます. (シーケンス番号が 1 になったら, S/KEY + を再度初 期化する必要があります.)</para> + + <para>次に, S/KEY 関連の四つのプログラムについて説明します. + <command>key</command> プ ログラムは, シーケンス番号と, + シードと, 秘密のパスフレーズを受け付けて, + ワンタイムパスワードを生成します. <command>keyinit</command> + プログラムは, S/KEY を初期化するのに使用され, + また秘密のパスフレーズやシーケンス番号やシー + ドを変更するためにも使用されます. このプログラムを実行するには, + 秘密の パスフレーズか, または, + シーケンス番号とシードとワンタイムパスワードの 一組かの, + どちらかが必要になります. <command>keyinfo</command> + プログラムは, <filename>/etc/skeykeys</filename> + というファイルを調べて, このプログラムを起動し + たユーザの現在のシーケンス番号とシードを表示します. 最後に, + <command>login</command> と <command>su</command> + プログラムについてですが, これらは S/KEY の + ワンタイムパスワードを, (訳注:システムが) + ユーザを認証するものとして受 理する処理をおこないます. + <command>login</command> プログラムは, 指定された特定の + アドレスからの接続に対して, UNIX + パスワードの使用を認めなくする機能, 逆に言えば S/KEY + の利用を強制する機能も持っています.</para> + + <para>このドキュメントでは, 四種類の異なる操作について説明します. + 一つ目 は, <command>keyinit</command> + プログラムを信頼できる通信路上で利用する場合で, 一 番始めに + S/KEY を設定する操作や, 使い始めたあとで秘密のパスフレーズや + シードを変更する操作です. 二つ目は, <command>keyinit</command> + プログラムを信頼で きない通信路上で利用する場合で, + 操作の目的は一つ目と同じです. この場合 には + <command>key</command> プログラムを併用する必要があります. + 三つ目は, <command>key</command> プログラムを使い, + 信頼できない通信路を通じてログインする操 作です. 四番目は, + <command>key</command> プログラムを使って, 複数のワンタイムパス + ワードを一気に生成する操作です. + ここで生成した複数のワンタイムパスワー ドは, + メモしたり印刷したりして携帯し, 信頼できる通信路が一切ないところ + (例えば展示会場など) で利用することができます. (訳注: + ワンタイムパスワー ドを記録した紙をなくさないこと! + 電話番号やIPアドレス, ユーザ名を一緒に + メモしていたら最悪です!!)</para> + + <sect2> + <title>信頼できる通信路での初期化</title> + + <para>信頼できる通信路 (例えばあるマシンのコンソール画面など) + を利用して いるときに, S/KEY の初期化, S/KEY + の秘密のパスフレーズの変更, またはシー + ドの変更をおこなうことができます. そのためには, + まずあなた自身がログイ ンし, <command>keyinit</command> + コマンドを以下のようにパラメタなしで実行します:</para> + + <screen>&prompt.user; keyinit +Updating wollman: ) この部分は始めて S/KEY を使 +Old key: ha73895 ) うときには表示されません. +Reminder - Only use this method if you are directly connected. +If you are using telnet or rlogin exit with no password and use keyinit -s. + ) `keyinit' コマンドが出力する注意です. 訳すと, + ) 注意 - この動作モードはマシンに直接入力しているときのみ利用 + ) すること. もし今 telnet や rlogin を使っているなら, 秘密のパ + ) スフレーズを入力せずにこのままコマンドを終了し, かわりに + ) keyinit -s を実行すること. +<prompt>Enter secret password:</prompt> ) ここで秘密のパスフレーズを入力します. +<prompt>Again secret password:</prompt> ) もう一回入力します. + +ID wollman s/key is 99 ha73896 ) あとで説明します. +SAG HAS FONT GOUT FATE BOOM )</screen> + + <para>上の例で出てきた事柄について説明しましょう. <prompt>Enter + secret password:</prompt> + というプロンプトに対してあなたが考えた秘密のパスフレーズを + 入力します (筆者は 7 + 単語以上の文を秘密のパスフレーズにしています). こ + の秘密のパスフレーズは後でログインするために + 必要になるものです. `ID' から始まる行は, S/KEY + における一回分のパラメタであり, あなたのログイ + ン名とシーケンス番号とシードです. (訳注: + `<command>keyinit</command>' コマンドは次回 + にログインするときに使われるパラメタを参考のために + ここで表示しま す. ) S/KEY を使ってログインするときには, + システム側が自動的にこれらの パラメタを表示してくれますから, + これらのパラメタを覚えておく必要は ありません. 最後の行が, + 今述べたパラメタと入力された秘密のパスフレー + ズから計算されたワンタイムパスワードです. この例を実行した後, + 次にログ インするときに打ち込むべきワンタイムパスワードが + これです.</para> + </sect2> + + <sect2> + <title>信頼できない通信路での初期化</title> + + <para>信頼できない通信路を使って S/KEY を初期化, + または秘密のパスフレーズ やシードを変更するためには, + 信頼できる通信路として, その信頼できない通 + 信路とは別のものを用意する必要があります. + その信頼できる通信路は <command>key</command> + プログラムを実行するために必要となるもので, 例えばそれは, + あなたが信頼できる Macintosh + のデスクアクセサリや信頼できるマシンのシェ + ルプロンプトだったりするでしょう + (そこでの操作に関しては後述します). (訳注: + ここでの通信路とはマシンそのものになります. 信頼できるマシンと + は, 信頼できる人がしっかり管理しているマシンということです.) + 他に準備 しておくものとして, シーケンス番号 + (100は適切な値といえるでしょう) と, + 場合によっては自分で考えた, + またはランダムに生成されたシードがあります. あなたが S/KEY + を初期化しようとしているマシンへの通信路が, 信頼できな + いものである場合には <command>keyinit -s</command> + コマンドを以下のように使用しま す:</para> + + <!-- kuriyama - missed by nik? --> + <screen>&prompt.user; <userinput>keyinit -s</userinput> +Updating wollman: +Old key: kh94741 +Reminder you need the 6 English words from the skey command. + ) `keyinit' コマンドが出力する注意です. 訳すと, + ) 注意 - skey コマンドの出力する 6 英単語が必要になります. +<prompt>Enter sequence count from 1 to 9999:</prompt> <userinput>100</userinput> ) ここを入力. +<prompt>Enter new key [default kh94742]:</prompt> ) リターンのみ入力. +s/key 100 kh94742</screen> + + <para>デフォルトのシード (<command>keyinit</command> + プログラムは困ったことにこれを <literal>key</literal> と + 読んでいるのですが, 混乱しないよう注意してください) + で構わなければ, リ ターンキーを押してください. 次に, + あらかじめ用意しておいた信頼できる通 信路 + (信頼できるマシンや信頼できる S/KEY デスクアクセサリなど) + へ移っ て, 先ほどと同じパラメタを入力します.</para> + + <screen>$prompt.user; <userinput>key 100 kh94742</userinput> +Reminder - Do not use this program while logged in via telnet or rlogin. +<prompt>Enter secret password:</prompt> ) ここで秘密のパスフレーズを入力します. +HULL NAY YANG TREE TOUT VETO</screen> + + <para>ここで信頼できない通信路の方に戻って, + <command>key</command> コマンドが出力したワ + ンタイムパスワードをコピーして <command>keyinit</command> + プログラムに入力します.</para> + + <screen><prompt>s/key access password:</prompt> <userinput>HULL NAY YANG TREE TOUT VETO</userinput> +ID wollman s/key is 100 kh94742 +HULL NAY YANG TREE TOUT VETO</screen> + + <para>後は, 前章で説明したことと同様です.</para> + </sect2> + + <sect2> + <title>ちょっと寄り道: ログインプロンプトについて</title> + + <para>どうやってワンタイムパスワードを生成するかを説明する前に, + S/KEY を 使う場合のログインプロンプトを + 見ておいた方がよいでしょう.</para> + + <screen>&prompt.user; <userinput>telnet himalia</userinput> +Trying 18.26.0.186... +Connected to himalia.lcs.mit.edu. +Escape character is '^]'. +s/key 92 hi52030 +<prompt>Password:</prompt></screen> + + <para>パスワードを要求する前に, + ログインプログラムがシーケンス番号とシードを + 表示していることがわかります. + この二つのパラメタを使ってワンタイムパ + スワードを計算することになります. + ここではまだ使っていませんが, 便利な + 機能がログインプログラムに備わっています: + パスワードプロンプトに対して, + 何も入力せずにリターンを押すとエコーモードに切り替わります. + つまりタイ プした文字がそのまま見えるようになるのです. これは + S/KEY のワンタイム パスワードを紙に印刷していた場合など, + ワンタイムパスワードを手で入力し + なければならない場合に特に役立つ機能です.</para> + + <para>このログインしようとしてるマシンが, + あなたが今使っているマシンから UNIX + パスワードを使ってログインすることができないように + 設定されている 場合があります. その場合には, + ログインプロンプトには S/KEY のワンタイ + ムパスワードの利用が必要であることを示す <literal>(s/key + required)</literal> という注釈が表示されます.</para> + </sect2> + + <sect2> + <title>ワンタイムパスワードを生成する</title> + + <para>次に前章のログインプロンプトに対して入力するための + ワンタイムパスワー ドを生成しましょう. そのために, + 信頼できるマシンと <command>key</command> プログラ + ムを使用します. (<command>key</command> プログラムには DOS や + Windows の上で動くも の, + Macintoshのデスクアクセサリとして動くものなどもあります.) + コマンド ラインで <command>key</command> + プログラムを起動するときには, シーケンス番号とシー + ドを引数として指定します. 入力が面倒な人は, + ログインプロンプトに表示さ れたもののうちで + <literal>key</literal> からその行の最後までを, + そのままカットア ンドペーストすることもできます. + <command>key</command> プログラムの実行は以下のよ + うになります:</para> + + <screen>&prompt.user; <userinput>key 92 hi52030</userinput> ) 前章の例からペースト. +Reminder - Do not use this program while logged in via telnet or rlogin. +<prompt>Enter secret password:</prompt> ) 秘密のパスフレーズを入力. +ADEN BED WOLF HAW HOT STUN</screen> + + <para>そして別のウィンドウで:</para> + + <screen>s/key 92 hi52030 ) 前章の例の続き. +<prompt>Password:</prompt> ) ここでリターンキーを押した. + (turning echo on) +<prompt>Password:</prompt>ADEN BED WOLF HAW HOT STUN +Last login: Wed Jun 28 15:31:00 from halloran-eldar.l +[以下略.]</screen> + + <para>以上の手順は, 信頼できるマシンが利用できる場合 + <emphasis>のみに</emphasis> 使えるもっ とも簡単な方法です. + Java S/Key の <command>key</command> applet もあり, <ulink + URL="http://www.cs.umd.edu/~harry/jotp/src.html">The Java + OTP Calculator</ulink> からダウンロードして Java + をサポートするブラウザ上でローカルに + 実行することができます.</para> + </sect2> + + <sect2> + <title>複数のワンタイムパスワードを生成する</title> + + <para>都合によっては, + 信頼できるマシンや信頼できる通信路が一切確保できな + いようなところで S/KEY を使う必要があるでしょう. + このような場合には, <command>key</command> + コマンドを使って複数のワンタイムパスワードを一気に生成する + ことが可能です. + そして結果を紙に印刷して携帯していくことができます. 例 + えば:</para> + + <screen>&prompt.user; <userinput>key -n 25 57 zz99999</userinput> +Reminder - Do not use this program while logged in via telnet or rlogin. +<prompt>Enter secret password: </prompt> +33: WALT THY MALI DARN NIT HEAD +34: ASK RICE BEAU GINA DOUR STAG +[...] +56: AMOS BOWL LUG FAT CAIN INCH +57: GROW HAYS TUN DISH CAR BALM </screen> + + <para><option>-n 25</option> という引数によって 25 + 個のワンタイムパスワードの生成を要 求します. ここで + <option>57</option> は, + <emphasis>最後に表示されている</emphasis> (もっとも大き い) + シーケンス番号です. 残りのパラメタは前出の例と同様です. + 出力は普 通に使う順番とは <emphasis>逆</emphasis> + に出力されていることに注意してください (訳注: + 一番最初に使うワンタイムパスワードは + 一番最後に出力されたものです). こ + の結果をカットアンドペーストして <command>lpr</command> + コマンドを使って印刷すると よいでしょう. + もしあなたがセキュリティに偏執するなら, この結果を紙と鉛 + 筆を使って手で書き移した方がよいかもしれません. ここで, + 出力の各行はシー + ケンス番号とそれに対応する一回分のワンタイムパスワードです. + 消費済みの ワンタイムパスワードの行をペンで消していくと + 便利でしょう.</para> + </sect2> + + <sect2> + <title>UNIX パスワードの利用を制限する</title> + + <para>設定ファイル <filename>/etc/skey.access</filename> + を使って UNIX パスワードの利 + 用を制限することができます. この場合の判断基準として, + ログインを受け付 + ける際のホスト名, ユーザ名, 端末のポート, IP + アドレスなどが利用できま + す. この設定ファイルの詳細に関してはマニュアル + &man.skey.access.5; を + ご覧ください. マニュアルにはこの機能に関わるセキュリティに + ついて, いく + つかの警告が記述してあります. この機能を使って + セキュリティを高めようと + するのならば絶対にこのマニュアルを読んでください.</para> + + <para>もし <filename>/etc/skey.access</filename> + ファイルが存在しないならば (FreeBSD + をインストールした直後の状態では存在しません), + すべてのユーザが UNIX パスワードを利用することができます. + 逆に, もしファイルが存在するならば, + <filename>/etc/skey.access</filename> + ファイルに明示的に記述されていない限り, すべ てのユーザは + S/KEY の利用を要求されます. どちらの場合においても, その + マシンのコンソールからはいつでも UNIX + パスワードを使ってログインするこ とが可能です.</para> + + <para>以下によく使われるであろう + 三種類の設定を含む設定ファイルの例を示し ます:</para> + + <programlisting> +permit internet 18.26.0.0 255.255.0.0 +permit user jrl +permit port ttyd0</programlisting> + + <para>はじめの行 (<literal>permit internet</literal>) で, telnet + などで接続するときの IP のソースアドレス (注意: + これは偽造されるおそれがあります) が特定の値と + マスクに一致している場合に, UNIX + パスワードの利用を許可することを指定 しています. + この設定自体はセキュリティを高めるための機能ではありません. + そうではなく, ログインの権利を持つ許可されたユーザに対して, + 現在そのユー + ザが使っているネットワークが信頼できないと考えられるので S/KEY + を使う べきである, + ということを気づかせるための機能であると考えてください.</para> + + <para>二行目 (<literal>permit user</literal>) によって, + ある特定のユーザに対して, い つでも UNIX + パスワードの利用を許可するように指定しています. 一般的には + この設定をおこなうべきではありません. <command>key</command> + プログラムがどうして も使えない環境にいる人や, + ダム端末しかない環境にいる人, または何度教え + ても聞く耳を持たないような人を + サポートする必要がある場合にのみ設定をお + こなってください.</para> + + <para>三行目 (<literal>permit port</literal>) によって, + ある特定の端末ポートからログ + インしようとするすべてのユーザに対して UNIX + パスワードの利用を許可する ように指定しています. + この設定はダイヤルアップ回線に対する設定として利 + 用できるでしょう.</para> + </sect2> + </sect1> + + <sect1 id="kerberos"> + <title>Kerberos</title> + + <para><emphasis>原作: &a.markm; + (&a.md; からの寄稿に基づいています).</emphasis></para> + + <para><emphasis>訳: &a.jp.arimura;.</emphasis></para> + + <para>Kerberosは, + サーバのサービスによってユーザが安全に認証を受けられる + ようにするための, ネットワークの付加システム及びプロトコルです. + リモートログイン, リモートコピー, + システム間での安全なファイルのコピ + ーやその他のリスクの高い仕事がかなり安全に, + そしてこれまでより制御 できるようになります.</para> + + <para>以下の文章は, + FreeBSD用として配布されているKerberosをセットアップ + する際のガイドとして読むことができます. しかし, + 完全な説明が必要な場合には, マニュアルページを読んだ方がよい + でしょう.</para> + + <para>FreeBSDのKerberosは, + オリジナルの4.4BSD-Liteの配布に含まれている ものではなく, + FreeBSD 1.1.5.1のときに移植されたeBonesです. + これはアメリカ/カナダの外で作成されており, + これら以外の国の人々にも 手に入れられるものです.</para> + + <para>このソフトウェアを合法的な配布物として得るために, アメリカも + しくはカナダのサイトから + <emphasis>持ってこないでください</emphasis>. でないと, + そのサイトが<emphasis>大変な</emphasis>問題に巻き込まれます. + 合法的な配布は, 南アフリカの<hostid + role="fqdn">ftp.internat.freebsd.org</hostid>や, FreeBSD + の公式ミラーサイトから入手することができます.</para> + + <sect2> + <title>初期データベースの作成</title> + + <para>この作業はKerberosサーバだけでおこないます. まず, + 古いKerberosの データベースが存在しないことを確認してください. + ディレクトリ<filename>/etc/kerberosIV</filename>に移って, + 次のファイルだけが 存在することをチェックします:</para> + + <screen>&prompt.root; <userinput>cd /etc/kerberosIV</userinput> +&prompt.root; <userinput>ls</userinput> +README krb.conf krb.realms</screen> + + <para>もし他のファイル (<filename>principal.*</filename> や + <filename>master_key</filename>) が 存在する場合には, + <command>kdb_destroy</command>というコマンドで古い + Kerberosデータベースを消してください. + Kerberosが走っていなければ, + 単に余計なファイルを消せばよいです.</para> + + <para>まず, <filename>krb.conf</filename> と + <filename>krb.realms</filename>を編集してKerberosの 管理領域 + (realm) を定義してください. + ここでは管理領域が<filename>GRONDAR.ZA</filename> で, + サーバ名が<filename>grunt.grondar.za</filename>であるとします. + <filename>krb.conf</filename> + というファイルを次のように編集してください:</para> + + <screen>&prompt.root; <userinput>cat krb.conf</userinput> +GRONDAR.ZA +GRONDAR.ZA grunt.grondar.za admin server +CS.BERKELEY.EDU okeeffe.berkeley.edu +ATHENA.MIT.EDU kerberos.mit.edu +ATHENA.MIT.EDU kerberos-1.mit.edu +ATHENA.MIT.EDU kerberos-2.mit.edu +ATHENA.MIT.EDU kerberos-3.mit.edu +LCS.MIT.EDU kerberos.lcs.mit.edu +TELECOM.MIT.EDU bitsy.mit.edu +ARC.NASA.GOV trident.arc.nasa.gov</screen> + + <para>この例にあるような他の管理領域は, 実際には必要ありません. + この例は複数の管理領域を認識する方法を示したものですので, + これらの行は含めなくても結構です.</para> + + <para>1行目はこのシステムが動いている管理領域の名前です. + 他の行は管理領域とホスト名のエントリです. + 行の1つめの単語が管理領域で, 2つめがその管理領域の中で + “鍵配布センター”(Key Distribution Center) + として働くホスト名です. ホスト名の次に <literal>admin + server</literal> と書いてある場合には, そのホストが + ``管理データベースサーバ''(Administrative Database Server) + も提供 することを意味します. + これらの単語について詳しく知りたい場合にはKerberosのマニュアル + ページをご覧ください.</para> + + <para>ここで, + <filename>GRONDAR.ZA</filename>という管理領域に<hostid + role="fqdn">grunt.grondar.za</hostid> およびその他の<hostid + role="domainname">.grondar.za</hostid> + ドメインのすべてのホストを追加し なければなりません. + <filename>krb.realms</filename>は次のようになります:</para> + + <screen>&prompt.root; <userinput>cat krb.realms</userinput> +grunt.grondar.za GRONDAR.ZA +.grondar.za GRONDAR.ZA +.berkeley.edu CS.BERKELEY.EDU +.MIT.EDU ATHENA.MIT.EDU +.mit.edu ATHENA.MIT.EDU</screen> + + <para>もう一度注意しますが, 他の管理領域を書く必要はありません. + これらは複数の管理領域を認識できるようにマシンを設定する方法を + 示した例ですので, これらの行は消して構いません.</para> + + <para>1行目は名前をつけた管理領域に <emphasis>特定の</emphasis> + システムを含めるための ものです. + 残りの行は名前をつけた管理領域にサブドメインのデフォルトの + システムを含めるためのものです.</para> + + <para>これでデータベースを作成する準備ができました. + この操作はKerberos サーバ (鍵配布センター) を起動するだけです. + <command>kdb_init</command>コ + マンドを次のように実行してください:</para> + + <screen>&prompt.root; <userinput>kdb_init</userinput> +<prompt>Realm name [default ATHENA.MIT.EDU ]: </prompt> <userinput>GRONDAR.ZA</userinput> +You will be prompted for the database Master Password. +It is important that you NOT FORGET this password. + +<prompt>Enter Kerberos master key:</prompt> </screen> + + <para>ここで鍵を保存して, + ローカルのマシンにあるサーバが取り出せるように します. + それには<command>kstash</command>コマンドを使用します.</para> + + <screen>&prompt.root; <userinput>kstash</userinput> + +<prompt>Enter Kerberos master key: </prompt> + +Current Kerberos master key version is 1. + +Master key entered. BEWARE!</screen> + + <para>これで暗号化されたマスタパスワードが + <filename>/etc/kerberosIV/master_key</filename> + に保存されました.</para> + </sect2> + + <sect2> + <title>すべてが動くようにするための設定</title> + + <para>Kerberosを導入する <emphasis>それぞれの</emphasis> + システムのデータベースに, 2つ のprincipal (主体名) + を追加する必要があります. その名前は + <literal>kpasswd</literal>と<literal>rcmd</literal>です. + これら2つのprincipalは, 個々 のシステムにおいて, + システム名と同じ名前のインスタンスと組にして作成 + されます.</para> + + <para>これらの <command>kpasswd</command> と + <command>rcmd</command> というデーモンによって, 他の + システムからKerberosのパスワードを変更したり, + <command>rcp</command>や <command>rlogin</command>, + <command>rsh</command>といったコマンドを実行したりできるよ + うになります.</para> + + <para>それでは実際にこれらのエントリを追加しましょう:</para> + + <screen>&prompt.root; <userinput>kdb_edit</userinput> +Opening database... + +<prompt>Enter Kerberos master key: </prompt> + +Current Kerberos master key version is 1. + +Master key entered. BEWARE! +Previous or default values are in [brackets] , +enter return to leave the same, or new value. + +<prompt>Principal name:</prompt> <userinput>passwd</userinput> +<prompt>Instance:</prompt> <userinput>grunt</userinput> + +<Not found>, <prompt>Create [y] ?</prompt> <userinput>y</userinput> + +Principal: passwd, Instance: grunt, kdc_key_ver: 1 +<prompt>New Password:</prompt> <---- ここは「RANDOM」と入力してください +Verifying password + +<prompt>New Password:</prompt> <---- ここは「RANDOM」と入力してください + +<prompt>Random password [y] ?</prompt> <userinput>y</userinput> + +Principal's new key version = 1 +<prompt>Expiration date (enter yyyy-mm-dd) [ 2000-01-01 ] ? </prompt> +<prompt>Max ticket lifetime (*5 minutes) [ 255 ] ? </prompt> +<prompt>Attributes [ 0 ] ? </prompt> +Edit O.K. +<prompt>Principal name:</prompt> <userinput>rcmd</userinput> +<prompt>Instance:</prompt> <userinput>grunt</userinput> + +<Not found>, <prompt>Create [y] ?</prompt> + +Principal: rcmd, Instance: grunt, kdc_key_ver: 1 +<prompt>New Password:</prompt> <---- ここは「RANDOM」と入力してください +Verifying password + +<prompt>New Password:</prompt> <---- ここは「RANDOM」と入力してください + +<prompt>Random password [y] ? </prompt> + +Principal's new key version = 1 +<prompt>Expiration date (enter yyyy-mm-dd) [ 2000-01-01 ] ? </prompt> +<prompt>Max ticket lifetime (*5 minutes) [ 255 ] ? </prompt> +<prompt>Attributes [ 0 ] ? </prompt> +Edit O.K. +<prompt>Principal name:</prompt> <---- 何も入力しないと終了します</screen> + </sect2> + + <sect2> + <title>サーバファイルの作成</title> + + <para>次に, 各マシンにおけるサービスを定義している, + すべてのインスタンス を展開します. + これには<command>ext_srvtab</command>というコマンドを使用しま + す. このコマンドで作成されるファイルは, Kerberosの各クライアン + トの/etc/kerberosIVディレクトリに + <emphasis>安全な方法で</emphasis>コピーまたは + 移動する必要があります. このファイルはそれぞれのサーバとクラ + イアントに存在しなければならず, + またKerberosの運用において重要なも のです.</para> + + <screen>&prompt.root; <userinput>ext_srvtab grunt</userinput> + +<prompt>Enter Kerberos master key: </prompt> + +Current Kerberos master key version is 1. + +Master key entered. BEWARE! +Generating 'grunt-new-srvtab'....</screen> + + <para>このコマンドは一時的なファイルを作成するだけです. + ファイル名をすべ てのサーバが読めるような + <filename>srvtab</filename> という名前に変更しな + ければなりません. + <command>mv</command>コマンドを用いてシステムの場所に移動 + してください.</para> + + <screen>&prompt.root; mv grunt-new-srvtab srvtab</screen> + + <para>そのファイルがクライアントに配るためのもので, + ネットワークが安全で はないと思われる場合には, <filename> + <replaceable>client</replaceable>-new-srvtab</filename> + を移動 + 可能なメディアにコピーして物理的に安全な方法で運んでください. + クラ + イアントの<filename>/etc/kerberosIV</filename>ディレクトリで, + 名前を <filename>srvtab</filename>に変更し, + modeを600にするのを忘れないでください:</para> + + <screen>&prompt.root; <userinput>mv grumble-new-srvtab srvtab</userinput> +&prompt.root; <userinput>chmod 600 srvtab</userinput></screen> + </sect2> + + <sect2> + <title>データベースへのユーザの追加</title> + + <para>ここで, + ユーザのエントリをデータベースに追加する必要があります. + 始めに, + ユーザ<username>jane</username>のエントリを作成してみましょう. + <command>kdb_edit</command> + を用いて次のように作成してください:</para> + + <screen>&prompt.root; <userinput>kdb_edit</userinput> +Opening database... + +<prompt>Enter Kerberos master key: </prompt> + +Current Kerberos master key version is 1. + +Master key entered. BEWARE! +Previous or default values are in [brackets] , +enter return to leave the same, or new value. + +<prompt>Principal name:</prompt> <userinput>jane</userinput> +<prompt>Instance:</prompt> + +<Not found>, <prompt>Create [y] ?</prompt> <userinput>y</userinput> + +Principal: jane, Instance: , kdc_key_ver: 1 +<prompt>New Password:</prompt> <---- 安全なパスワードを入れてください +Verifying password + +<prompt>New Password:</prompt> <---- もう一度パスワードを入れてください + +Principal's new key version = 1 +<prompt>Expiration date (enter yyyy-mm-dd) [ 2000-01-01 ] ? </prompt> +<prompt>Max ticket lifetime (*5 minutes) [ 255 ] ? </prompt> +<prompt>Attributes [ 0 ] ? </prompt> +Edit O.K. +<prompt>Principal name:</prompt> <---- 何も入力しないと終了します</screen> + </sect2> + + <sect2> + <title>すべてのテスト</title> + + <para>まず始めにKerberosデーモンを起動する必要があります. + <filename>/etc/rc.conf</filename> + ファイルを正しく編集してあれば, マシンを再 + 起動することでに自動的にデーモンが起動します. + これはKerberosサー バでのみ必要です. + Kerberosクライアントは<filename>/etc/kerberosIV</filename>か + ら必要なものを自動的に入手します.</para> + + <screen>&prompt.root; <userinput>kerberos &</userinput> +Kerberos server starting +Sleep forever on error +Log file is /var/log/kerberos.log +Current Kerberos master key version is 1. + +Master key entered. BEWARE! + +Current Kerberos master key version is 1 +Local realm: GRONDAR.ZA +&prompt.root; <userinput>kadmind -n &</userinput> +KADM Server KADM0.0A initializing +Please do not use 'kill -9' to kill this job, use a +regular kill instead + +Current Kerberos master key version is 1. + +Master key entered. BEWARE!</screen> + + <para>さあ, これで上で作成した <username>jane</username> + というIDのチケットを + <command>kinit</command>コマンドで得ることができます:</para> + + <screen>&prompt.user; <userinput>kinit jane</userinput> +MIT Project Athena (grunt.grondar.za) +Kerberos Initialization for "jane" +<prompt>Password:</prompt> </screen> + + <para><command>klist</command> コマンドを用いてトークンを見て, + きちんとチケットを持って いるかどうか確認してください:</para> + + <screen>&prompt.user; <userinput>klist</userinput> +Ticket file: /tmp/tkt245 +Principal: jane@GRONDAR.ZA + + Issued Expires Principal +Apr 30 11:23:22 Apr 30 19:23:22 krbtgt.GRONDAR.ZA@GRONDAR.ZA</screen> + + <para><command>passwd</command> + コマンドを用いてパスワードを変更して, kpasswdデーモ + ンがKerberos + データベースに対して認証されるかどうかチェックして + ください:</para> + + <screen>&prompt.user; <userinput>passwd</userinput> +realm GRONDAR.ZA +<prompt>Old password for jane:</prompt> +<prompt>New Password for jane:</prompt> +Verifying password +<prompt>New Password for jane:</prompt> +Password changed.</screen> + </sect2> + + <sect2> + <title><command>su</command>特権の追加</title> + + <para>root権限が必要なユーザは<emphasis>誰でも</emphasis>, + <command>su</command>コマンドのパス + ワードをユーザ毎に<emphasis>別のもの</emphasis> + として持つことができます. + <username>root</username>に<command>su</command> + できる権利を与えられたidを追加します. これは, + principalに付いている<username>root</username> + というインスタンスに よって制御されています. + <command>kdb_edit</command>を用いて + <literal>jane.root</literal>というエントリを + Kerberosデータベースに作成します:</para> + + <screen>&prompt.root; <userinput>kdb_edit</userinput> +Opening database... + +<prompt>Enter Kerberos master key: </prompt> + +Current Kerberos master key version is 1. + +Master key entered. BEWARE! +Previous or default values are in [brackets] , +enter return to leave the same, or new value. + +<prompt>Principal name:</prompt> <userinput>jane</userinput> +<prompt>Instance:</prompt> <userinput>root</userinput> + +<Not found>, Create [y] ? y + +Principal: jane, Instance: root, kdc_key_ver: 1 +<prompt>New Password:</prompt> <---- 安全なパスワードを入れます +Verifying password + +<prompt>New Password:</prompt> <---- もう一回パスワードを入れます + +Principal's new key version = 1 +<prompt>Expiration date (enter yyyy-mm-dd) [ 2000-01-01 ] ? </prompt> +<prompt>Max ticket lifetime (*5 minutes) [ 255 ] ?</prompt> <userinput>12</userinput> <--- ここは短くしてください +<prompt>Attributes [ 0 ] ? </prompt> +Edit O.K. +<prompt>Principal name:</prompt> <---- 何も入力しないと終了します</screen> + + <para>実際にトークンをもらって, + ちゃんと働いているかどうか確認しましょう:</para> + + <screen>&prompt.root; <userinput>kinit jane.root</userinput> +MIT Project Athena (grunt.grondar.za) +Kerberos Initialization for "jane.root" +<prompt>Password: </prompt></screen> + + <para>ここでrootユーザの <filename>.klogin</filename> + ファイルにユーザを追加する必要が あります.</para> + + <screen>&prompt.root; <userinput>cat /root/.klogin</userinput> +jane.root@GRONDAR.ZA</screen> + + <para><command>su</command>してみましょう:</para> + + <screen>&prompt.user; <userinput>su</userinput> +<prompt>Password: </prompt></screen> + + <para>どのトークンを持っているか見てみましょう:</para> + + <screen>&prompt.root; klist +Ticket file: /tmp/tkt_root_245 +Principal: jane.root@GRONDAR.ZA + + Issued Expires Principal +May 2 20:43:12 May 3 04:43:12 krbtgt.GRONDAR.ZA@GRONDAR.ZA</screen> + </sect2> + + <sect2> + <title>他のコマンドの使用</title> + + <para>ここまでの例では, <literal>jane</literal> という principal + を <literal>root</literal> とい + うインスタンス付きで作成しました. + これはユーザと同じ名前をprincipalと しており, + Kerberosのデフォルトの値です; + <literal><username>.</literal><literal>root</literal> + という形式の + <literal><principal>.<instance></literal>で, + 必要なエント + リが<username>root</username>のホームディレクトリの + <filename>.klogin</filename>ファイルに あれば, + <literal><username></literal>がrootに + <command>su</command>することができま す.</para> + + <screen>&prompt.root; <userinput>cat /root/.klogin</userinput> +jane.root@GRONDAR.ZA</screen> + + <para>同様に, ユーザのホームディレクトリの + <filename>.klogin</filename>ファイルに次の + ような行がある場合には:</para> + + <screen>&prompt.user; <userinput>cat ~/.klogin</userinput> +jane@GRONDAR.ZA +jack@GRONDAR.ZA</screen> + + <para><username>jane</username> または <username>jack</username> + という名前で (前述の<command>kinit</command> によって) + 認証されている <filename>GRONDAR.ZA</filename> + という管理領域のユーザ なら誰でも<command>rlogin</command> や + <command>rsh</command>, <command>rcp</command>等によってこ + のシステム (<hostid>grunt</hostid>) + の<username>jane</username>のアカウントまたはファ + イルにアクセスできます.</para> + + <para>例えば, Janeが他のシステムにKerberos + を用いてloginします:</para> + + <screen>&prompt.user; <userinput>kinit</userinput> +MIT Project Athena (grunt.grondar.za) +<prompt>Password: </prompt> +&prompt.user; <userinput>rlogin grunt</userinput> +Last login: Mon May 1 21:14:47 from grumble +Copyright (c) 1980, 1983, 1986, 1988, 1990, 1991, 1993, 1994 + The Regents of the University of California. All rights reserved. + +FreeBSD BUILT-19950429 (GR386) #0: Sat Apr 29 17:50:09 SAT 1995</screen> + + <para>次の例では, Jackが同じマシンの Jane + のアカウントにloginします. Janeは <filename>.klogin</filename> + ファイルを前述のように設定しており, + Kerberosでは<emphasis>jack</emphasis>というprincipal + をインスタンスなしで設定してあ ります.</para> + + <screen>&prompt.user; <userinput>kinit</userinput> +&prompt.user; <userinput>rlogin grunt -l jane</userinput> +MIT Project Athena (grunt.grondar.za) +<prompt>Password: </prompt> +Last login: Mon May 1 21:16:55 from grumble +Copyright (c) 1980, 1983, 1986, 1988, 1990, 1991, 1993, 1994 + The Regents of the University of California. All rights reserved. + +FreeBSD BUILT-19950429 (GR386) #0: Sat Apr 29 17:50:09 SAT 1995</screen> + </sect2> + </sect1> + + <sect1 id="firewalls"> + <title>ファイアウォール</title> + + <para><emphasis>原作: &a.gpalmer;, &a.alex;.</emphasis></para> + + <para><emphasis>訳: &a.jp.saeki;.<!-- <br> --> + 11 November 1996.</emphasis></para> + + <para>ファイアウォールは, + インターネットに参加している人はもちろんのこと, + プライベートネットワークのセキュリティ向上のための + アプリケーションを 探している人にとっても, + ますます興味深くなりつつある分野です. + このセクションではファイアウォールとは何か, + ファイアウォールの使用法, + そしてファイアウォールを構築するために FreeBSD のカーネルで + 提供されているファシリティ (機能) + の使用法について説明したいと思います.</para> + + <note> + <para>社内のネットワークと “巨大かつ信頼のおけない + インターネット” との間にファイアウォールを構築することで + セキュリティ上のすべての問題が解決できると考える人がいます. + ファイアウォールはセキュリティ上の問題を + 解決する助けになる場合もありますが, + 充分な設定がなされていないファイアウォールは, + まったくファイアウォールを + 持たない場合よりもセキュリティ上の危険を増大させてしまいます. + ファイアウォールにできることは, + あなたのシステムにもう一つのセキュリティ層を + 追加することだけで, + 本気でアタックをしかけてくるクラッカーが内部ネットワークに + 侵入するのを妨げることはできません. + ファイアウォールを侵入不可能と過信して + 内部のセキュリティをおろそかにすることは, + 単にクラッカーの仕事を少し簡単にするだけでしか + ありません.</para> + </note> + + <sect2> + <title>ファイアウォールとは何か ?</title> + + <para>現在インターネットで普通に使用されている + ファイアウォールには 二つの異なるタイプがあります. 一つは, + 厳密には <emphasis> パケットフィルタリングルータ </emphasis> + と 呼ばれるタイプのものです. これはマルチホームのホストマシン + (複数の ネットワークに接続されているマシン) のカーネルが, + ある規則にしたがって + パケットを転送したりブロックしたりするものです. もう一つは, + <emphasis> proxy (代理) サーバ </emphasis> + として知られているタイプのものです. これは, + おそらくはマルチホームのホストマシン上で, + カーネルによるパケット転送を 禁止して, + デーモンにより認証の提供とパケットの転送とを + おこなうものです.</para> + + <para>二つのタイプのファイアウォールを組み合わせて使用して, + 特定のマシン (<emphasis> 要塞ホスト </emphasis> と呼ばれる) + だけが パケットフィルタリングルータを通して内部ネットワークへ + パケットを送ることができるよう設定している + サイトがしばしば存在します. proxy (代理) + サービスは通常の認証メカニズムよりもセキュリティを + 強化してある 要塞ホストで動作させます.</para> + + <para>FreeBSD は (<application>IPFW</application> + として知られる) カーネルパケットフィルタ込みで + 提供されています. このセクションの後の方では, + このフィルタについての 説明を集中しておこないます. + サードパーティから提供されるソフトウェアを使用することにより, + Proxy サーバを FreeBSD 上に構築することができます. しかし, + 現在入手可能な proxy サーバは + たいへんバラエティに富んでいるので, + このドキュメントでそれらすべてを + カバーすることは不可能です.</para> + + <sect3 id="firewalls-packet-filters"> + <title>パケットフィルタリングルータ</title> + + <para>ルータとは, 二つまたはそれ以上のネットワークの間で + パケットの転送をおこなう マシンのことです. + パケットフィルタリングルータは, そのカーネルの内部に, + 一つ一つのパケットをルールリストと比較して + 転送するかしないかを決める 特別なコードを持っています. + 最近の IP ルーティングソフトウェアのほとんどは, 内部に + パケットのフィルタリングをおこなうためのコードを持っていて, + デフォルトでは すべてのパケットを転送するようになっています. + このフィルタを有効にするためには, + パケットの通過を許すべきかどうかを決める + ルールを自分で定義する必要があります.</para> + + <para>パケットを通すべきか通すべきでないかを決めるために, + パケットヘッダの内容にマッチするものが + ルールリストから探されます. マッチするルールが見つかると, + ルールアクションが実行されます. ルールアクションには, + パケットを捨てる, パケットを転送する, + またはパケットの発信元に ICMP + メッセージを送り返すというものがあります. + ルールの検索は先頭から順番におこなわれ, + 通常は最初にマッチしたものだけが 適用されます. そのため, + このルールリストは “ルールチェーン” + と呼ばれることもあります.</para> + + <para>パケットマッチングの基準は使用するソフトウェアに + よって異なりますが, 通常はパケットの発信元 IP アドレス, + 宛先 IP アドレス, 発信元ポート番号, 宛先ポート番号 + (ポート番号はポートをサポートするプロトコルの場合のみ), + パケットタイプ (UDP, TCP, ICMP など) + に基づくルールを指定することができます.</para> + </sect3> + + <sect3 id="firewalls-proxy-servers"> + <title>Proxy サーバ</title> + + <para>Proxy サーバとは通常のシステムデーモン (telnetd, ftpd + など) を 特別なサーバで置き換えたマシンのことです. + これらのサーバは, + 通常は中継をおこなって特定方向への接続だけを許すため, + <emphasis>proxy サーバ </emphasis> と呼ばれます. (例えば) + proxy telnet + サーバをファイアウォールホストで走らせておきます. + 外部からユーザがファイアウォールに対して telnet + を実行すると, proxy telnet サーバが応答して, + 何らかの認証メカニズムを実行します. これを通過した後で, + 内部ネットワークへのアクセスがおこなえるように なるのです. + (内部ネットワークからの信号は proxy + サーバがかわりに受け取り, 外へ向けて送り出します.)</para> + + <para>Proxy サーバは通常, + 普通のサーバより堅固に構築されていて, しばしば + “使い捨て” パスワードシステムなどを含む, + 多様な認証メカニズムを持っています. + “使い捨て”パスワードシステムとは, + どういうものなのでしょうか. 仮に誰かが何らかの方法で, + あなたが使用したパスワードを手に入れたとします. しかし, + 一度使用したことで, + そのパスワードは既に無効になっているのです. ですから, + そのパスワードをもう一度使用したとしても, あなたのシステムへ + アクセスすることはできないというわけです. + これらのサーバは中継をおこなうだけで, + 実際のところサーバホスト自身への + アクセスをユーザに許してはいません. そのため, + 何者かがセキュリティシステムに + 侵入用の裏口を取り付けることは, + より困難になっています.</para> + + <para>proxy サーバはアクセス制限の方法をいくつも持っていて, + 特定のホスト + だけがサーバへのアクセス権を得ることができるように + なっていることがあり ます. + そして目的のマシンと通信できるユーザを制限するように + 設定することもできます. もう一度言いますが, + どんなファシリティ (機能) が使えるかは, どんな proxy + サービスをおこなうソフトウェアを選ぶかに大きく + 依存します.</para> + </sect3> + </sect2> + + <sect2> + <title>IPFW で何ができるか</title> + + <para>FreeBSD とともに配布されている + <application>IPFW</application> は, カーネル内部にあって + パケットのフィルタリングとアカウンティングを + おこなうシステムであり, + ユーザ側のコントロールユーティリティである &man.ipfw.8; を + 含んでいます. ルーティングの決定をおこなう際に, + これらは互いに協力して, + カーネルで使用されるルールを定義したり, + 現在使用されているルールを + 問い合わせたりすることができます.</para> + + <para><application>IPFW</application> + は互いに関連する二つの部分からなっています. + ファイアウォールセクションは + パケットフィルタリングをおこないます. また, IP + アカウンティングセクションはファイアウォールセクションのものと + 似たルールに基づいてルータの使用を追跡します. これにより, + (例えば) 特定のマシンからルータへのトラフィックがどのくらい + 発生しているか調べたり, どれだけの WWW (World Wide Web) + トラフィックが + フォワードされているかを知ることができます.</para> + + <para><application>IPFW</application> は, + ルータではないマシンにおいても入出力コネクションの + パケットフィルタリングのために + 使用することができるように設計されています. これは一般的な + <application>IPFW</application> + の使用法とは異なる特別な使い方ですが, + こういった状況でも同じコマンドと + テクニックが使用されます.</para> + </sect2> + + <sect2> + <title>FreeBSD で IPFW を有効にする</title> + + <para><application>IPFW</application> + システムの中心となる部分はカーネル内部にあります. そのため, + どのファシリティ (機能) を必要とするかによって, 一つまたは + それ以上のオプションをカーネルコンフィグレーション + ファイルに追加し, + カーネルを再コンパイルする必要があるでしょう. + カーネルの再コンパイル方法の詳細については, <link + linkend="kernelconfig">カーネルコンフィグレーション</link> + を参照してください.</para> + + <para>現在, IPFW + に関係するカーネルコンフィグレーションオプションは + 三つあります:</para> + + <variablelist> + <varlistentry><term><literal>options IPFIREWALL</literal></term> + <listitem> + <para>パケットフィルタリングのためのコードを + カーネルに組み込みます.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal> + options IPFIREWALL_VERBOSE</literal></term> + <listitem> + <para>&man.syslogd.8; を通じて + パケットのログを取るためのコードを有効にします. + フィルタルールでパケットのログを取るように指定しても, + このオプションが指定されていなければ, + ログを取ることはできません.</para> + </listitem> + </varlistentry> + + <varlistentry><term><literal> + options IPFIREWALL_VERBOSE_LIMIT=10</literal></term> + <listitem> + <para>&man.syslogd.8; を通じて + ログを取るパケットの数をエントリ毎に制限します. + 敵対的な環境においてファイアウォールの + 動作のログを取りたいけれど, + syslog の洪水によるサービス拒絶攻撃に対し + 無防備でありたくないという場合に, + このオプションを使用したいと思うことが + あるかもしれません.</para> + + <para>チェーンエントリのログが指定された制限数に達すると, + そのエントリに関するログ取りは停止されます. + ログ取りを再開するには, &man.ipfw.8; + ユーティリティを使用して + 関連するカウンタをリセットする必要があります:</para> + + <screen>&prompt.root; <userinput>ipfw zero 4500</userinput></screen> + + <para>4500 とは, + ログ取りを続行したいチェーンエントリの番号です.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>以前のバージョンの FreeBSD は + <literal>IPFIREWALL_ACCT</literal> というオプションを + 持っていました. しかし, + ファイアウォールコードがアカウンティングファシリティ (機能) を + 自動的に含むようになったため, + 現在では使用されることはなくなっています.</para> + </sect2> + + <sect2> + <title>IPFW の設定</title> + + <para><application>IPFW</application> ソフトウェアの設定は + &man.ipfw.8; ユーティリティを + 通じておこないます. このコマンドの構文は非常に + 複雑に見えますが, + 一旦その構造を理解すれば比較的単純です.</para> + + <para>このユーティリティでは今のところ四つの異なる + コマンドカテゴリが 使用されています: それは追加 / 削除, 表示, + フラッシュ, およびクリアです. 追加 / + 削除はパケットの受け入れ, 拒絶, ログ取りをどのようにおこなうか + というルールを構築するのに使用します. 表示はルールリスト + (またはチェーン) と (アカウンティング用) パケットカウンタの + 内容を調べるのに使用します. + フラッシュはチェーンからすべてのエントリを + 取り除くのに使用します. + クリアは一つまたはそれ以上のアカウンティングエントリを + ゼロにするのに 使用します.</para> + + <sect3> + <title>IPFW ルールの変更</title> + + <para>この形式での使用法は: + <cmdsynopsis> + <command>ipfw</command> + <arg>-N</arg> + <arg choice="plain">コマンド</arg> + <arg>index</arg> + <arg choice="plain">アクション</arg> + <arg>log</arg> + <arg choice="plain">プロトコル</arg> + <arg choice="plain">アドレス</arg> + <arg>オプション</arg> + </cmdsynopsis> + </para> + + <para>この形式で使用する際に有効なフラグは一つだけです:</para> + + <variablelist> + <varlistentry><term>-N</term> + <listitem> + <para>アドレスやサービス名を + 文字列に変換して表示します.</para> + </listitem> + </varlistentry> + </variablelist> + + <para><emphasis> コマンド </emphasis> + は一意である限り短縮可能です. 有効な <emphasis> コマンド + </emphasis> は:</para> + + <variablelist> + <varlistentry><term>add</term> + <listitem> + <para>ファイアウォール / アカウンティングルールリストに + エントリを追加します.</para> + </listitem> + </varlistentry> + + <varlistentry><term>delete</term> + <listitem> + <para>ファイアウォール / + アカウンティングルールリストから + エントリを削除します.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>以前のバージョンの <application>IPFW</application> では, + ファイアウォールエントリと + パケットアカウンティングエントリが別々に利用されていました. + 現在のバージョンでは, それぞれのファイアウォールエントリ毎に + パケットアカウンティングエントリが備えられています.</para> + + <para><emphasis>index</emphasis> が指定されていると, + エントリはチェーン中の <emphasis remap=tt>index</emphasis> + で示される位置に置かれます. <emphasis + remap=tt>index</emphasis> が指定されて いなければ, + エントリは (65535 番のデフォルトルールである + パケット拒絶を別にして) 最後のチェーンエントリの index に + 100 を足した 位置 (チェーンの最後) に置かれます.</para> + + <para>カーネルが <literal>IPFIREWALL_VERBOSE</literal> + つきでコンパイルされている場合, <literal>log</literal> + オプションはマッチしたルールを + システムコンソールに出力させます.</para> + + <para>有効な <emphasis> アクション </emphasis> は:</para> + + <variablelist> + <varlistentry><term>reject</term> + <listitem> + <para>パケットを捨てます, ICMP ホスト / + ポート到達不能パケットを (適切な方を) + 発信元へ送ります.</para> + </listitem> + </varlistentry> + + <varlistentry><term>allow</term> + <listitem> + <para>通常通りパケットを通過させます. (別名: + <literal>pass</literal> および + <literal>accept</literal>)</para> + </listitem> + </varlistentry> + + <varlistentry><term>deny</term> + <listitem> + <para>パケットを捨てます. 発信元は ICMP メッセージによる + 通知を受けません (そのためパケットが + 宛先に到達しなかったように見えます).</para> + </listitem> + </varlistentry> + + <varlistentry><term>count</term> + <listitem> + <para>このルールはパケットカウンタを更新するだけで, + パケットを 通過させたり拒絶したりしません. + 検索は次のチェーンエントリから続けられます.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>それぞれの <emphasis> アクション </emphasis> + は一意な先頭部分だけでも認識されます.</para> + + <para>指定可能な <emphasis> プロトコル </emphasis> + は以下の通り:</para> + + <variablelist> + <varlistentry><term>all</term> + <listitem> + <para>任意の IP パケットにマッチします.</para> + </listitem> + </varlistentry> + + <varlistentry><term>icmp</term> + <listitem> + <para>ICMP パケットにマッチします.</para> + </listitem> + </varlistentry> + + <varlistentry><term>tcp</term> + <listitem> + <para>TCP パケットにマッチします.</para> + </listitem> + </varlistentry> + + <varlistentry><term>udp</term> + <listitem> + <para>UDP パケットにマッチします.</para> + </listitem> + </varlistentry> + </variablelist> + + <para><emphasis> アドレス </emphasis> の指定は:</para> + <cmdsynopsis> + <arg choice="plain">from</arg> + <arg choice="plain"><replaceable>address/mask</replaceable></arg> + <arg><replaceable>port</replaceable></arg> + <arg choice="plain">to</arg> + <arg choice="plain"><replaceable>address/mask</replaceable></arg> + <arg><replaceable>port</replaceable></arg> + <arg>via <replaceable>interface</replaceable></arg> + </cmdsynopsis> + + <para><replaceable>port</replaceable> はポートをサポートする + <emphasis> プロトコル </emphasis> (UDP と TCP) の + 場合にだけ指定可能です.</para> + + <para><option>via</option> は必須ではなく, + 特定のインターフェースを通ってきたパケット + だけにマッチするように, IP アドレスまたはローカル IP + インターフェースの ドメイン名, またはインターフェース名 + (例えば <devicename>ed0</devicename>) を + 指定することができます. + インターフェースユニット番号はオプションで, + ワイルドカードで指定することが できます. 例えば, + <literal>ppp*</literal> はすべてのカーネル PPP + インターフェースに マッチします.</para> + + <para><replaceable>address/mask</replaceable> の指定は: + + <screen><replaceable>address</replaceable></screen> + + または + + <screen><replaceable>address</replaceable>/<replaceable>mask-bits</replaceable></screen> + + または + + <screen><replaceable>address</replaceable>:<replaceable>mask-pattern</replaceable></screen> + </para> + + <para>IP + アドレスのかわりに有効なホスト名を指定することも可能です. + <option><replaceable>mask-bits</replaceable></option> + はアドレスマスクで上位何ビットを1にするべきかを + 示す十進数値です. 例えば次の指定, + <literal>192.216.222.1/24</literal> はクラス C のサブネット + (この場合 192.216.222) の任意のアドレスにマッチする + マスクを作成します. + <option><replaceable>mask-pattern</replaceable></option> + は与えられたアドレスと 論理 AND される IP アドレスです. + キーワード <literal>any</literal> は“任意の IP + アドレス”を指定するために + 使用することができます.</para> + + <para>ブロックするポート番号は以下のように指定します: + + <cmdsynopsis> + <arg choice="plain"><replaceable>port</replaceable><arg>, + <replaceable>port</replaceable><arg>, + <replaceable>port</replaceable><arg>… + </arg></arg></arg></arg> + </cmdsynopsis> + + のように単独のポートまたはポートのリストを指定します. + または + + <cmdsynopsis> + <arg choice="plain"><replaceable>port</replaceable>- + <replaceable>port</replaceable></arg> + </cmdsynopsis> + + のようにポートの範囲を指定します. + 単独のポートとポートのリストを + 組み合わせて指定することも可能ですが, + その場合は常に範囲の方を + 最初に指定しなければなりません.</para> + + <para>使用可能な <emphasis> オプション </emphasis> は:</para> + + <variablelist> + <varlistentry><term>frag</term> + <listitem> + <para>データグラムの最初の + フラグメントでなければマッチします.</para> + </listitem> + </varlistentry> + + <varlistentry><term>in</term> + <listitem> + <para>入力途中のパケットであればマッチします.</para> + </listitem> + </varlistentry> + + <varlistentry><term>out</term> + <listitem> + <para>出力途中のパケットであればマッチします.</para> + </listitem> + </varlistentry> + + <varlistentry><term>ipoptions <replaceable>spec</replaceable></term> + <listitem> + <para>IP ヘッダが <replaceable>spec</replaceable> + に指定された カンマで区切られた + オプションのリストを含んでいればマッチします. + サポートされている IP オプションのリストは: + <literal>ssrr</literal> (ストリクトソースルート), + <literal>lsrr</literal> (ルーズソースルート), + <literal>rr</literal> (レコードパケットルート), + そして <literal>ts</literal> (タイムスタンプ) です. + 特定のオプションを含まないことを指定するには + <literal>!</literal> を先頭につけます.</para> + </listitem> + </varlistentry> + + <varlistentry><term>established</term> + <listitem> + <para>パケットが既に確立されている TCP + コネクションの一部であれば (つまり RST または ACK + ビットがセットされていれば) マッチします. + <emphasis>established</emphasis> + ルールをチェーンの最初の方に置くことで, + ファイアウォールのパフォーマンスを向上させることが + できます.</para> + </listitem> + </varlistentry> + + <varlistentry><term>setup</term> + <listitem> + <para>パケットが TCP + コネクションを確立しようとするものであれば (SYN + ビットがセットされ ACK ビットはセットされていなければ) + マッチします.</para> + </listitem> + </varlistentry> + + <varlistentry><term>tcpflags <replaceable>flags</replaceable></term> + <listitem> + <para>TCP ヘッダが <replaceable>flags</replaceable> + に指定された カンマで区切られたフラグの + リストを含んでいればマッチします. + サポートされているフラグは, <literal>fin</literal>, + <literal>syn</literal>, <literal>rst</literal>, + <literal>psh</literal>, <literal>ack</literal> と + <literal>urg</literal> です. + 特定のフラグを含まないことを指定するには + <literal>!</literal> を先頭につけます.</para> + </listitem> + </varlistentry> + + <varlistentry><term>icmptypes <replaceable>types</replaceable></term> + <listitem> + <para>ICMP タイプが <replaceable>types</replaceable> + リストに 存在していればマッチします. + リストはタイプの範囲または個々のタイプを + カンマで区切った任意の組合せで指定できます. + 一般的に使用されている ICMP タイプは: + <literal>0</literal> エコーリプライ (ping リプライ), + <literal>3</literal> 相手先到達不可能, + <literal>5</literal> リダイレクト, + <literal>8</literal> エコーリクエスト (ping + リクエスト), そして <literal>11</literal> 時間超過 + (&man.traceroute.8; で使用されているように, TTL + 満了を示すのに使用されます) です.</para> + </listitem> + </varlistentry> + </variablelist> + </sect3> + + <sect3> + <title>IPFW ルールリストの表示</title> + + <para>この形式での使用法は: + <cmdsynopsis> + <command>ipfw</command> + <arg>-a</arg> + <arg>-t</arg> + <arg>-N</arg> + <arg choice="plain">l</arg> + </cmdsynopsis> + </para> + + <para>この形式で使用する際に有効なフラグは三つあります:</para> + + <variablelist> + <varlistentry><term>-a</term> + <listitem> + <para>リスト表示の際にカウンタの値も表示します. + このオプションは アカウンティングカウンタの + 内容を見る唯一の手段です.</para> + </listitem> + </varlistentry> + + <varlistentry><term>-t</term> + <listitem> + <para>各チェーンエントリが最後に + マッチした時刻を表示します. この時刻表示は + &man.ipfw.8; ユーティリティで使用される入力形式と + 互換性がありません.</para> + </listitem> + </varlistentry> + + <varlistentry><term>-N</term> + <listitem> + <para>(可能であれば) + アドレスやサービス名を文字列に変換して表示します.</para> + </listitem> + </varlistentry> + </variablelist> + </sect3> + + <sect3> + <title>IPFW ルールのフラッシュ</title> + + <para>チェーンをフラッシュするには: + <cmdsynopsis> + <command>ipfw</command> + <arg choice="plain">flush</arg> + </cmdsynopsis> + </para> + + <para>カーネルに固定されているデフォルトルール (インデックス + 65535 番) 以外の, + ファイアウォールチェーンの中のすべてのエントリを削除します. + デフォルトではすべてのパケットが拒絶されるので, + 一旦これを実行すると, + パケットを許可するエントリがチェーンに追加されるまで, + あなたのシステムがネットワークから切り放されてしまいます. + そのため, + ルールのフラッシュをおこなうときは注意が必要です.</para> + </sect3> + + <sect3> + <title>IPFW パケットカウンタのクリア</title> + + <para>一つまたはそれ以上のパケットカウンタをクリアするためには: + <cmdsynopsis> + <command>ipfw</command> + <arg choice="plain">zero</arg> + <arg choice="opt"><replaceable>index</replaceable></arg> + </cmdsynopsis> + </para> + + <para><replaceable>index</replaceable> が指定されていなければ, + すべてのパケットカウンタが クリアされます. + <replaceable>index</replaceable> が指定されていれば, + 特定のチェーンエントリだけが クリアされます.</para> + </sect3> + </sect2> + + <sect2> + <title>ipfw に対するコマンドの例</title> + + <para>このコマンドはルータを介して転送される, ホスト <hostid + role="fqdn">evil.crackers.org</hostid> から ホスト <hostid + role="fqdn">nice.people.org</hostid> の telnet ポートへの + すべてのパケットを拒絶します:</para> + + <screen>&prompt.root; <userinput>ipfw add deny tcp from evil.crackers.org to nice.people.org 23</userinput></screen> + + <para>次の例は, ネットワーク <hostid + role="domainname">crackers.org</hostid> (クラス C) 全体から + マシン <hostid role="fqdn">nice.people.org</hostid> + (の任意のポート) への 任意の TCP トラフィックを拒絶し, + ログを取ります.</para> + + <screen>&prompt.root; <userinput>ipfw add deny log tcp from evil.crackers.org/24 to nice.people.org</userinput></screen> + + <para>あなたの内部ネットワーク (クラス C のサブネット) に対する + X セッションを 張れないようにする場合, + 以下のコマンドで必要なフィルタリングがおこなえます:</para> + + <screen>&prompt.root; <userinput>ipfw add deny tcp from any to my.org/28 6000 setup</userinput></screen> + + <para>アカウンティングレコードを見るには: + + <screen>&prompt.root; <userinput>ipfw -a list</userinput></screen> + + または短縮形式で</para> + + <screen>&prompt.root; <userinput>ipfw -a l</userinput></screen> + + <para>最後にチェーンエントリがマッチした + 時刻を見ることもできます. </para> + + <screen>&prompt.root; <userinput>ipfw -at l</userinput></screen> + </sect2> + + <sect2> + <title>パケットフィルタリングファイアウォールの構築</title> + + <note> + <para>以下の提案は, ただの提案にすぎません: + 必要な処理はそれぞれのファイアウォールで異なるため, + あなた独自の要求にあったファイアウォールを構築する方法を + ここで述べることはできないのです.</para> + </note> + + <para>最初にファイアウォールをセットアップするとき, + コントロールされた環境でファイアウォールホストの + 設定がおこなえるような + テストベンチセットアップが用意できない場合には, + カーネルのログ取りを + 有効にしてログ取り版のコマンドを使用することを + 強くおすすめします. そうすることで, + 大した混乱や中断なしに問題となる範囲の特定と処置を + 素早くおこなうことができます. + 初期セットアップフェーズが完了してからであっても, + アタックの可能性のあるアクセスをトレースしたり, + 要求の変化に応じてファイアウォールルールを + 変更したりできるので, `deny' + に対するログ取りをおこなうことをおすすめします.</para> + + <note> + <para><command>accept</command> + コマンドのログ取りをおこなっていると, + ファイアウォールをパケットが一つ通過する毎に 1 + 行のログが生成されるため <emphasis>大量の</emphasis> + ログデータが発生します. そのため, 大規模な ftp/http + 転送などをおこなうと, システムが非常に 遅くなってしまいます. + また, パケットが通過するまでにカーネルにより + 多くの仕事を要求するため, パケットのレイテンシ (latency) + を増加させてしまいます. syslogd + もログをディスクに記録するなど, より多くの CPU タイムを + 使用し始め, 実に容易に <filename>/var/log</filename> + が置かれているパーティションを + パンクさせてしまう可能性があります.</para> + </note> + + <para>現状では, FreeBSD + はブート時にファイアウォールルールをロードする + 能力を持っていません. 私は <filename>/etc/netstart</filename> + スクリプトにロードをおこなうスクリプトを + 追加することをおすすめします. IP + インターフェースの設定がおこなわれる前に + ファイアウォールの設定がおこなわれるように, netstart + ファイル中の 充分に早い位置にルールをロードする + スクリプトを配置してください. こうすることで, + ネットワークがオープンな間は常に抜け道が塞がれている + ことになります.</para> + + <para>ルールをロードするために使用するスクリプトは, + あなたが作成しなければなりません. 現在のところ + <command>ipfw</command> は 1 コマンドで複数のルールを + ロードするユーティリティをサポートしていません. + 私が使用しているシステムでは以下のようにしています:</para> + + <screen>&prompt.root; <userinput>ipfw list</userinput></screen> + + <para>ファイルに現在のルールリストを出力し, + テキストエディタを使用して すべての行の前に + <literal>ipfw</literal> と書き足します. こうすることで, + このスクリプトを /bin/sh に与えてルールをカーネルに再読み込み + させることができます. + これは最も効率的な方法とはいえないかもしれませんが, + きちんと動作しています.</para> + + <para>次の問題は, ファイアウォールが実際には何を <emphasis> する + </emphasis> べきかです ! + これは外部からそのネットワークへのどんなアクセスを許したいか, + また内部から外界へのアクセスを + どのくらい許したいかに大きく依存します. + いくつか一般的なルールを挙げると:</para> + + <itemizedlist> + <listitem> + <para>1024 番以下のポートへのすべての TCP + 入力アクセスをブロックします. ここは finger, SMTP (mail) + そして telnet など, 最もセキュリティに敏感な + サービスが存在する場所だからです.</para> + </listitem> + + <listitem> + <para><emphasis> すべての </emphasis> 入力 UDP + トラフィックをブロックします. これは UDP + を使用しているサービスで有用なものは極めて少ないうえ, + 有用なトラフィック (例えば Sun の RPC と NFS プロトコル) + は, 通常セキュリティに対する脅威となるためです. UDP + はコネクションレスプロトコルであるため, 入力 UDP + トラフィックを拒絶することは すなわち出力 UDP + トラフィックに対する返答をも ブロックすることになるので, + このことはそれなりの不利益をもたらします. たとえば外部の + archie (prospero) サーバを使用している (内部の) ユーザに + とって問題となる可能性があります. もし archie + へのアクセスを許したければ, 191 番と 1525 番のポートから + 任意の UDP + ポートへ来るパケットがファイアウォールを通過することを + 許可しなければなりません. 123 + 番のポートから来るパケットは ntp パケットで, + これも通過の許可を考慮する必要がある + もう一つのサービスです.</para> + </listitem> + + <listitem> + <para>外部から 6000 + 番のポートへのトラフィックをブロックします. 6000 + 番のポートは X11 サーバへのアクセスに使用されるポートで, + セキュリティに対する脅威となりえます. + (特に自分のワークステーションで <command>xhost + +</command> + をおこなう癖を持っている人がいればなおさらです). X11 + は実際に 6000 番以降のポートを使用する可能性があるため, + 通過許可に 上限を定めると, + そのマシンで走らせることのできる X ディスプレイの + 個数が制限されます. RFC 1700 (Assigned Numbers) + で定義されているように, 上限は 6063 です.</para> + </listitem> + + <listitem> + <para>内部のサーバ (例えば SQL サーバなど) + がどのポートを使用するかを チェックします. + それらのポートは通常, 上で指定した 1-1024 + 番の範囲から外れていますので, + これらも同様にブロックしておくことは + おそらく良い考えです.</para> + </listitem> + </itemizedlist> + + <para>これとは別のファイアウォール設定に 関するチェックリストが + CERT から 入手可能です. <ulink + URL="ftp://ftp.cert.org/pub/tech_tips/packet_filtering"> + ftp://ftp.cert.org/pub/tech_tips/packet_filtering</ulink></para> + + <para>前にも述べたように, これはただの <emphasis> ガイドライン + </emphasis> にすぎません. + ファイアウォールでどのようなフィルタルールを使用するかは, + あなた自身が 決めなければなりません. + これまでのアドバイスにしたがったにも関わらず, + 誰かがあなたのネットワークに 侵入してきたとしても, + 私は「いかなる」責任もとることはできません.</para> + </sect2> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/serialcomms/chapter.sgml b/ja_JP.eucJP/books/handbook/serialcomms/chapter.sgml new file mode 100644 index 0000000000..20b76739bc --- /dev/null +++ b/ja_JP.eucJP/books/handbook/serialcomms/chapter.sgml @@ -0,0 +1,2350 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.10 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:46:01 kuriyama Exp $ +--> + +<chapter id="serialcomms"> + <title>シリアル通信</title> + + <sect1 id="serial"> + <title>シリアル接続の基礎</title> + + <para><emphasis>Assembled from FAQ.</emphasis></para> + + <para>このセクションには, + シリアルポートについての一般的な情報が書かれていま す. + あなたが求めている情報が, もしここで見つからなかった場合には, + ハン ドブックの端末とダイアルアップのセクションを見てください. + </para> + + <para><filename>ttyd<replaceable>X</replaceable></filename> + (または <filename>cuaa<replaceable>X</replaceable></filename>) + デバイスは, アプリケーション上 + でシリアルポートをオープンする時に使用する, + 標準的なデバイスです. プロセスがデバイスをオープンする際, 端末 + I/O 設定の デフォルトセットが使用されます. これらの設定内容は, + 次のコマンドで確認することができます. </para> + + <screen>&prompt.root; <userinput>stty -a -f /dev/ttyd1</userinput></screen> + + <para>このデバイスの設定を変更した場合, その設定はデバイスが + クローズされるまで有効です. デバイスが再びオープンされる時, + デフォルトの設定値に戻ります. + デフォルトの設定を変更するためには, + “初期状態”を設定した + いデバイスをオープンして調節することができます. 例えば, ttyd5 + というデバイスに対して, デフォルトで <acronym>CLOCAL</acronym> + モードを ON にして, 8 bits の設定をおこない, + <emphasis>XON/XOFF</emphasis> + フロー制御を行うように設定したい場合は, 次のようにします. + </para> + + <screen>&prompt.root; <userinput>stty -f /dev/ttyid5 clocal cs8 ixon ixoff</userinput></screen> + + <para>このコマンドを記述するのに適しているファイルは, + <filename>/etc/rc.serial</filename> です. + アプリケーションが<filename>ttyd5</filename> + をオープンするときに, + デフォルトでこの設定をおこなうようになります. これらの設定は, + 好きなように変更することができます.</para> + + <para>また, “固定状態”のデバイスに調節を行うことで, + ある一定の設定が + アプリケーションに変更されることを防ぐこともできます. 例えば, + <filename>ttyd5</filename> のスピードを 57600 bps + に固定したい場合には, 次のようにします. </para> + + <screen>&prompt.root; <userinput>stty -f /dev/ttyld5 57600</userinput></screen> + + <para>これで, <filename>ttyd5</filename> をオープンして, + シリアルポートの転送スピードを + 変更しようとするアプリケーションは 57600 bps + に固定されるでしょう.</para> + + <para>本来, デバイスの初期状態を変更したり設定を固定するのは, + <username>root</username> だけが行うべきです. + <filename>MAKEDEV</filename> + スクリプトがデバイスエントリを作成する時は, + これをおこない<emphasis>ません</emphasis>.</para> + </sect1> + + <sect1 id="term"> + <title>シリアル端末</title> + + <para><emphasis>原作: &a.kelly;<!-- <br> --> + 28 July 1996</emphasis></para> + + <para><emphasis>訳: &a.max;</emphasis></para> + + <para>シリアル端末を利用することで, + コンピュータのコンソールのそばにいないと きや, + 手近にネットワーク接続されているコンピュータがないときでも, + FreeBSD の機能を便利に, かつ安価に利用することができます. + ここでは, FreeBSD + にシリアル端末を接続する方法を解説します.</para> + + <sect2 id="term-uses"> + <title>端末の種類と利用方法</title> + + <para>もともと Unix システムにはコンソールがありませんでした. + ユー ザはコンピュータのシリアル + ポートに接続された端末からログインして + プログラムを利用していました. + ちょうどモデムと通信ソフトを使ってリモート + のコンピュータにログインし, テキスト + ベースのプログラムを利用するのと よく似ています.</para> + + <para>最近の PC は, + 高品質の画像を表示できるコンソールを搭載していま すが, + ほとんどすべての Unix 系 OS には未だにシリアル + ポートを使ってログ インするための機能があり, FreeBSD + でもこの機能がサポートされています. + 現在使用されていないシリアル + ポートに端末を接続することでシステムに ログインし, + 通常はコンソールや Xウィンドウ システムの + <command>xterm</command> のウィ ンドウ上で起動しているテキスト + ベースのプログラムであれば何 + でも利用することができます.</para> + + <para>職場での利用ということで考えるならば, FreeBSD + が動作しているコンピュー タに接続された何台ものシリアル端末を + 各社員の机に配置するというようなこ とが可能です. また, + 家庭での利用方法としては, 余っている古い IBM PC や Macintosh + を FreeBSD が動いているパワフルなコンピュータの端末として利 + 用することができます. 普通ならシングルユーザのコンピュータを, + パワフ + ルなマルチユーザのシステムに変えることができるのです.</para> + + <para>FreeBSD では, 以下に挙げる3種類の端末が利用できます.</para> + + <itemizedlist> + <listitem> + <para><link linkend="term-dumb">ダム (dumb) 端末</link></para> + </listitem> + + <listitem> + <para><link linkend="term-pcs">PCを利用した端末</link></para> + </listitem> + + <listitem> + <para><link linkend="term-x">X 端末</link></para> + </listitem> + </itemizedlist> + + <para>以下は, それぞれについての解説です.</para> + + <sect3 id="term-dumb"> + <title>ダム端末</title> + + <para>ダム端末は, シリアルライン経由でのコンピュータとの接続専 + 用のハードウェアです. ダム端末は, + テキストの送受信および表示ができる + 程度の計算能力しかもっていないので, “dumb” + (間抜け) というように呼ば れています. + この端末上でプログラムを実行することはできません. テキスト + エディタ, コンパイラ, E-mail, + ゲームなどなどのプログラムを実行するのは, + ダム端末を接続しているコンピュータの方です.</para> + + <para>Digital Equipment社の VT-100 や, Wyse社の WY-75 + を初めとして, 多くのメーカが何百種類もの + ダム端末を作っています. ほとんどどんな種 類のダム端末でも + FreeBSD に接続して使用できます. さらに, 高性能の端 + 末の中には画像を取り扱えるものもありますが, + 限られた数のソフトウェア + パッケージしかこういった機能には対応していません.</para> + + <para>ダム端末は, X ウィンドウ システムで提供されるようなグラ + フィックアプリケーションを必要としない + 職場で広く用いられています.</para> + </sect3> + + <sect3 id="term-pcs"> + <title>PC を端末として利用する</title> + + <para><link linkend="term-dumb">ダム端末</link> + がテキストの表示およ + び送受信の機能をそなえただけのものならば, 言うまでもなく, + どんなPC もダム端末になり得ます. + 必要なものは適切なケーブルと, そのPCの上 + で動作する<emphasis>端末エミュレーション</emphasis> + を行うソフトウェアのみです.</para> + + <para>このような環境は, 家庭においてよく利用されます. + たとえば, あなたの同居 人が FreeBSD + のコンソールを専有している時などに, あまりパワーのないコ + ンピュータを FreeBSD システムにシリアル端末として接続し, + その端末上で + テキストだけを用いる作業をおこなうことができます.</para> + </sect3> + + <sect3 id="term-x"> + <title>X 端末</title> + + <para>X 端末は, 既存のものの中で最も洗練された種類の端末といえ + ます. X 端末は, たいていの場合シリアル ポートではなく, + イーサネッ + トのようなネットワークを利用した接続をおこないます. また, + アプリケーション の利用においても, + テキストベースのものだけでなく, X アプリケーション + の利用が可能です.</para> + + <para>ここでは, 参考までに 端末について紹介しただけで, X 端 + 末の設定や利用についての解説は + <emphasis>おこないません</emphasis>.</para> + </sect3> + </sect2> + + <sect2 id="term-cables-ports"> + <title>ケーブルとポート</title> + + <para>シリアル端末を FreeBSD システムに接続するためには, + 適切なケー ブルと, + 端末を接続するためのシリアルポートが必要です. ここでは, これ + らについて説明します. もし既にあなたの利用したい端末と, + その端末 を接続するためのケーブルについてよく理解していれば, + <link linkend="term-config">設定</link> + の章まで読み飛ばしてください.</para> + + <sect3 id="term-cables"> + <title>ケーブル</title> + + <para>端末の接続は, シリアルポートを利用します. そこで, 端末を + FreeBSD システムに接続するためには, シリアルケーブル + (RS-232C ケーブ ルとも呼ばれています) + が必要となります.</para> + + <para>シリアルケーブルには2種類のケーブルがあります. + どちらの種類の ケーブルを使わなければいけないかは, + どんな端末を接続したいかによります.</para> + + <itemizedlist> + <listitem> + <para>もし, PC を端末として利用したい場合は, <link + linkend="term-null">ヌルモデム</link> ケーブル + (リバースケーブルもしくは + クロスケーブルと呼ばれることもしばしばあります) + を使用してください. ヌルモデムケーブルは, + コンピュータ同士や端末同士を接続するために用い + られるケーブルです.</para> + </listitem> + + <listitem> + <para>もし, 本物の端末を接続するのであれば, その端末につい + てきたドキュメントからどのようなケーブルを + 使うべきか調べてください. も しドキュメントがない場合は, + まず <link linkend="term-null">ヌルモデム</link> + ケーブルを試してみて, うまくいかない場合は <link + linkend="term-std">スタンダード</link> ケーブル + (しばしばストレートケーブルと呼 ばれます) + を試してみてください.</para> + </listitem> + </itemizedlist> + + <para>また, 端末側と FreeBSD 側の <emphasis>両方の</emphasis> + シリア ポート の形状が, + あなたが使用しようとしているケーブルについているコネクタの形 + 状と一致していなければなりません.</para> + + <sect4 id="term-null"> + <title>ヌルモデムケーブル</title> + + <para>ヌルモデムケーブル (またはリバースケーブルあるいはクロ + スケーブル) は, たとえば “signal ground” + 信号のように, いくつかの信 号はそのまま通しますが, + 他の信号は途中で入れ替えて通します. たとえば, “send + data” 信号のピンは, 反対側のコネクタの + “receive data” 信号の + ピンと繋がっています.</para> + + <para>自分で使うケーブルは自分で作りたいということであれば, + 以下にター ミナルを接続する際に推奨される + ヌルモデムケーブルの結線を示しておきま す. この表では, + RS-232C の信号線の名前と, DB-25 コネクタ上のピンの番 + 号を示しています.</para> + + <informaltable frame="none"> + <tgroup cols="5"> + <thead> + <row> + <entry>Signal</entry> + <entry>Pin #</entry> + <entry></entry> + <entry>Pin #</entry> + <entry>Signal</entry> + </row> + </thead> + + <tbody> + <row> + <entry>TxD</entry> + <entry>2</entry> + <entry>connects to</entry> + <entry>3</entry> + <entry>RxD</entry> + </row> + + <row> + <entry>RxD</entry> + <entry>3</entry> + <entry>connects to</entry> + <entry>2</entry> + <entry>TxD</entry> + </row> + + <row> + <entry>DTR</entry> + <entry>20</entry> + <entry>connects to</entry> + <entry>6</entry> + <entry>DSR</entry> + </row> + + <row> + <entry>DSR</entry> + <entry>6</entry> + <entry>connects to</entry> + <entry>20</entry> + <entry>DTR</entry> + </row> + + <row> + <entry>SG</entry> + <entry>7</entry> + <entry>connects to</entry> + <entry>7</entry> + <entry>SG</entry> + </row> + + <row> + <entry>DCD</entry> + <entry>8</entry> + <entry>connects to</entry> + <entry>4</entry> + <entry>RTS</entry> + </row> + + <row> + <entry>RTS</entry> + <entry>4</entry> + <entry></entry> + <entry>5</entry> + <entry>CTS</entry> + </row> + + <row> + <entry>CTS</entry> + <entry>5</entry> + <entry>connects to</entry> + <entry>8</entry> + <entry>DCD</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <note> + <para>DCD と RST では, コネクタ内部でピン4を5に接続し, + そして逆側のコネクタのピン8と接続します.</para> + </note> + </sect4> + + <sect4 id="term-std"> + <title>スタンダード RS-232C ケーブル</title> + + <para>スタンダードシリアルケーブル + (またはストレートケーブル) の場合は, すべての RS-232C + 信号をそのまま通します. つまり, 片方の “send + data” 信号のピンは, 逆側の “send data” + 信号のピンと繋がっています. モデムを FreeBSD + に接続するときや, 一部の端末を接続するときにこのタイプの + ケーブルを使用します.</para> + </sect4> + </sect3> + + <sect3 id="term-ports"> + <title>ポート</title> + + <para>シリアルポートは, FreeBSDが動作しているホスト + コンピュータと端 + 末の間でデータのやりとりを行うために用いるデバイスです. + ここでは, 現在存在するポートの種類と FreeBSD + でのポートのアクセス方法について解 説します.</para> + + <sect4 id="term-portkinds"> + <title>ポートの種類</title> + + <para>シリアルポートには何種類かのものがあります. + ケーブルを購 入したり自作したりする前に, + そのケーブルのコネクタの形状が端末および FreeBSD + システムのポートの形状と一致していることを + 確認してください.</para> + + <para>ほとんどの端末は DB25 ポートを搭載しています. + FreeBSDが動作しているも のを含めて, PCは DB25 または DB9 + ポートを搭載しています. マルチポート + のシリアルカードの場合は, RJ-12 や RJ-45 + のポートを搭載しているかもし れません.</para> + + <para>利用されているポートの種類に関しては, + ハードウェアについてきたドキュメ ントを参照してください. + また, 多くの場合, ポートの形状から判断すること + もできるでしょう.</para> + </sect4> + + <sect4 id="term-portnames"> + <title>ポートの名前</title> + + <para>FreeBSDでは, <filename>/dev</filename> + ディレクトリ内のエントリを介 + してシリアルポートへのアクセスがおこなわれます. + 2種類の異なったエン トリがあります. </para> + + <itemizedlist> + <listitem> + <para>着信用のポートの名前は, <filename> + /dev/ttyd<replaceable>x</replaceable></filename> ( + <replaceable>x</replaceable> は 0から始まるポート番号) + となっています. 一般に端末の接続には + 着信用ポートを用います. 着信用のポートでは, + シリアルラインのデータ キャリア検出 (DCD) + 信号がオンになっている必要があります.</para> + </listitem> + + <listitem> + <para>発信用のポートの名前は, <filename> + /dev/cuaa<replaceable>x</replaceable></filename> + となっています. + 発信用のポートは普通モデムの接続に用い, 端末の接続には + 利用しません. ただ, + ケーブルまたは端末がキャリア検出信号を使えない + タイプのものの場合は, + 発信用のポートを使うとよいでしょう.</para> + </listitem> + </itemizedlist> + + <para>詳しくは, &man.sio.4; + のマニュアルをご覧ください.</para> + + <para>たとえば, 端末を一つ目のシリアルポート (DOS + でいうところの <devicename>COM1</devicename>) に接 + 続したとすると, <filename>/dev/ttyd0</filename> + がこの端末を指すことになります. また, + 二つ目のシリアルポート (<devicename>COM2</devicename>) + ならば <filename>/dev/ttyd1</filename> となり, + 以下この形式のデバイスエントリを使います.</para> + + <para>各シリアルポート, + 特にマルチポートのシリアルカードを利用する ために, kernel + の設定をおこなう必要がある場合がありますので, 注意してくだ + さい. 詳しくは, <link linkend="kernelconfig">FreeBSD + カーネルのコンフィグレーション</link> + をご覧ください.</para> + </sect4> + </sect3> + </sect2> + + <sect2 id="term-config"> + <title>設定</title> + + <para>ここでは, 端末からのログインを可能にするために必要な + FreeBSD 側の設定について解説します. + 既に端末を接続するポートが利用できるように kernel + の設定をおこない, 端末が接続されているものと考えて, 解説を進め + ます.</para> + + <para>簡単に言えば, プロセス管理や初期化をおこなっている + <command>init</command> プロセス に対して, + ログイン名を読み込み <command>login</command> + プログラムを起動している <command>getty</command> + を実行するように指示します.</para> + + <para>これをおこなうには, <filename>/etc/ttys</filename> + の内容を編集する必要があります. まず, <command>su</command> + コマンドで root になって, <filename>/etc/ttys</filename> + に以下の 変更を加えてください.</para> + + <procedure> + <step> + <para>端末を接続するポートの <filename>/dev</filename> + のエントリが含ま れている行がまだ存在しなければ, これを + <filename>/etc/ttys</filename> に追加してく ださい.</para> + </step> + + <step> + <para><filename>/usr/libexec/getty</filename> + が対象となるポートに対して + 実行されるように指定してください. また, + <filename>/etc/gettytab</filename> ファイ ル内の適切な + <replaceable>getty</replaceable> + タイプのエントリを指定してください.</para> + </step> + + <step> + <para>デフォルトのターミナルタイプを指定してください.</para> + </step> + + <step> + <para>対象となるポートを “on” + に設定してください.</para> + </step> + + <step> + <para>そのポートが “secure” + であるかどうかを指定してください.</para> + </step> + + <step> + <para><command>init</command> に + <filename>/etc/ttys</filename> を読み込みなおさせてく + ださい.</para> + </step> + </procedure> + + <para>また, 必要に応じて <filename>/etc/gettytab</filename> + を変更し, 上の 2で使用する + <replaceable>getty</replaceable> のエントリを追加してください. + このドキュメントではこの方 + 法については特に解説しませんので, &man.gettytab.5; + および &man.getty.8; のマニュアルをご覧ください.</para> + + <para>以下では, 上のステップについて詳しく解説します. + 実例を用いて, 何をす べきかを解説していきます. Wyse-50 と, + 古い IBM の 286 マシン上で通信 ソフト Procomm を使って VT-100 + エミュレーションをおこなっているものを端 + 末の例として紹介します. また, Wyse は 2番目のポートに, + 286マシンは 6 番目のポート + (マルチポートのシリアルカード上のポート) に接続します.</para> + + <para><filename>/etc/ttys</filename> について, + より詳しくは, &man.ttys.5; のマニュアルをご覧 + ください.</para> + + <sect3 id="term-etcttys"> + <title><filename>/etc/ttys</filename> へのエントリの追加</title> + + <para>既にエントリがある場合を除いて, まず初めに + <filename>/etc/ttys</filename> + にエントリを追加しなければいけません.</para> + + <para><filename>/etc/ttys</filename> には, + FreeBSDシステム上のログインを許可するすべての + ポートを記述します. たとえば, 一つ目の仮想コンソール + <filename>ttyv0</filename> のエン + トリもこのファイルにあります. このエントリのおかげで, + コンソールからの ログインが可能になっています. + このファイルには, 他の仮想コンソール, シ + リアルポートおよび仮想端末のエントリも含まれています. + 端末を接続する 場合は, そのポートの + <filename>/dev</filename> のエントリを, + <filename>/dev</filename> の部分 + を省略して記述します.</para> + + <para>FreeBSD のインストール当初の状態では, + <filename>ttyd0</filename> から <filename>ttyd3</filename> + までの, 初めの四つのシリアルポートのエントリが + <filename>/etc/ttys</filename> に記述され ています. + これらのポートのいずれかに端末を接続する場合は, 新たなエント + リを追加する必要はありません.</para> + + <para>ここで紹介している例では, + 既にファイルにエントリが存在する 2番目のシリ アルポート, + <filename>ttyd1</filename> に Wyse-50 を接続しています. + 一方, 6番目のシ リアルポートに接続する + 286マシン用のエントリは, 新たに追加してやらな + ければなりません. 以下に, エントリを追加した後の + <filename>/etc/ttys</filename> か ら抜粋して示します. + </para> + + <programlisting> +ttyd1 "/usr/libexec/getty std.9600" unknown off secure +ttyd5</programlisting> + </sect3> + + <sect3 id="term-getty"> + <title><replaceable>getty</replaceable> タイプの指定</title> + + <para>次に, + 端末からのログインを処理するプログラムの指定をおこな います. + FreeBSDでは, 標準的には + <filename>/usr/libexec/getty</filename> をこの目的 + で利用しています. <prompt>login:</prompt> + プロンプトを送り出しているのは, このプロ グラムです.</para> + + <para><command>getty</command> プログラムは, + コマンドラインパラメータとして, + <replaceable>getty</replaceable> タイプをとります. ただし, + このパラメータは必須ではあ りません. + <replaceable>getty</replaceable> タイプは, + ボーレートやパリティといった, 接続され + た端末の特徴を表すものです. <command>getty</command> + プログラムは, 与えられた <replaceable>getty</replaceable> + タイプに対応したこれらの特徴を + <filename>/etc/gettytab</filename> から 読み込みます.</para> + + <para>ファイル <filename>/etc/gettytab</filename> には, + 新旧の端末に関する多数のエントリ が記述されています. + ほとんどの場合, <literal>std</literal> + という文字列で始まる名前 のエントリを使えば, + 接続された端末に対してログインセッションを提供す + ることができます. これらのエントリを利用した場合, + パリティは無視されま す. 110 bps から 115200 bps + までのボーレートに対応した <literal>std</literal> のエン + トリがあります. 当然, + 新たなエントリを追加することも可能です. + &man.gettytab.5; のマニュアルに, + さらに詳しく解説されています.</para> + + <para><filename>/etc/ttys</filename> の <emphasis + remap=tt>getty</emphasis> タイプの設定をする際は, + 端末側の通信 パラメータの設定が, <emphasis + remap=tt>getty</emphasis> + タイプのものと一致していることを確認し てください.</para> + + <para>紹介している実例では, Wyse50 はパリティなし 38400 bps + で接続していま す. また, 286 マシンの方は, パリティなし + 19200 bps の接続です. 以下は, + この段階でのこの二つの端末に関する + <filename>/etc/ttys</filename> の設定です. </para> + + <programlisting> +ttyd1 "/usr/libexec/getty std.38400" unknown off secure +ttyd5 "/usr/libexec/getty std.19200"</programlisting> + + <para>ここで, 実行するプログラムを指定している + 2番目のフィールドが, ダブルクォー + テーションに囲まれていることに注意してください. + こうしないと, <command>getty</command> のタイプの指定が, + つぎのフィールドとして判断されてしまう可 能性があるので, + 十分注意することが必要です.</para> + </sect3> + + <sect3 id="term-deftermtype"> + <title>デフォルトのターミナルタイプの指定</title> + + <para><filename>/etc/ttys</filename> の 3番目のフィールドには, + そのポートのター ミナルタイプのデフォルトを指定します. + ダイアルアップ用のポートの場合 は, + ユーザがどのタイプの端末あるいは + 通信ソフトを利用してダイアルアップ + してくるかは分からないので, <literal>unknown</literal> や + <literal>dialup</literal> を記述するの が一般的です. 一方, + 直結された端末の場合, ターミナルタイプが変わるこ + とはありませんから, + このフィールドには実際のターミナルタイプを記述し + ます.</para> + + <para>一般に, ユーザは <filename>.login</filename> や + <filename>.profile</filename> などのファイル内で + <command>tset</command> コマンドを使って, + ターミナルタイプをチェックし, 必要ならば + ターミナルタイプの入力を求めるプロンプトを + 表示するようにします. この とき, + <filename>/etc/ttys</filename> + の中でターミナルタイプが指定されていれば, + このプロンプトを表示せずに先に進むことが可能です.</para> + + <para>FreeBSD 上で, どのターミナルタイプを利用できるかは, + <filename>/usr/share/misc/termcap</filename> をご覧ください. + このファイルには, お + よそ 600 のターミナルタイプが定義されています. + 必要ならば, 新たなエン + トリを追加することも可能です. 詳しくは &man.termcap.5; + のマニュアルをご覧ください.</para> + + <para>紹介している例では, Wyse-50 のターミナルタイプは + Wyse-50 です (もっ + とも他のタイプをエミュレートすることも可能ですが, ここでは + Wyse-50 モー ドで使用します. ). また, 286マシン上では + Procomm が VT-100 エミュレー + ションをおこなうように設定されています. 以下が, まだ未完成の + <filename>/etc/ttys</filename> の関連部分です. </para> + + <programlisting> +ttyd1 "/usr/libexec/getty std.38400" wy50 off secure +ttyd5 "/usr/libexec/getty std.19200" vt100</programlisting> + </sect3> + + <sect3 id="term-enable"> + <title>ポートを利用可能にする</title> + + <para><filename>/etc/ttys</filename> のつぎのフィールド, + つまり 4番目のフィー ルドは, + そのポートをアクティブにするかどうかの設定です. + このフィールド に <literal>on</literal> を指定すると, + <command>init</command> プロセスが2番目のフィールドに書かれ + たプログラム, <command>getty</command> を実行し, + ログインのためのプロンプトを送り出 すようになります. + このフィールドに <literal>off</literal> を記述すると, + <command>getty</command> は起動されず, + よってこのポートからのログインもできなくなります.</para> + + <para>ということで, 当然このフィールドには + <literal>on</literal> を指定します. 以下が + <filename>/etc/ttys</filename> です. それぞれのポートを + <literal>on</literal> にしました. </para> + + <programlisting> +ttyd1 "/usr/libexec/getty std.38400" wy50 on secure +ttyd5 "/usr/libexec/getty std.19200" vt100 on</programlisting> + </sect3> + + <sect3 id="term-secure"> + <title>``secure'' なポートの指定</title> + + <para>とうとう最後のフィールドの設定です. + (実際にはここでは触れ ませんが, + オプショナルな<literal>window</literal> + の設定のフィールドも存在するので, + ほぼ最後のフィールドといった方が正確かもしれません. ) + 最後のフィールド では, + そのポートが安全かどうかを指定します.</para> + + <para>ここで, “安全” + なポートとはどういうポートのことでしょう?</para> + + <para>これは, root のアカウント (または, ユーザ ID が 0 + のアカウント) がロ グインしてもよいポートということです. + 安全でないポートでは, root のロ + グインは許可されません.</para> + + <para>では, どのように安全なポートとそうでない + ポートを使えばよいでしょう?</para> + + <para>ポートを安全ではないとすることで, + そのポートに接続された端末からは, root + のログインを禁止することができます. FreeBSDシステムの root + のパス ワードを知っている人は, + まず一般ユーザとしてログインしなければなりませ ん. + スーパユーザの特権を得るためには, そのうえで + <command>su</command> コマンドを + 利用しなければいけません.</para> + + <!-- kuriyama - Eng ver has bare login --> + <para>これによって, root アカウントが不正に利用された場合に, + その経過を調査 する上で二つの記録を利用できるようになります. + <command>login</command> と <command>su</command> + コマンドは, 共にシステムのログに記録を残します (また, + ログイン は <filename>wtmp</filename> にも記録を残します. + ).</para> + + <para>ポートを安全なものとして指定すると, その端末からの root + のログインが可 能になります. root + のパスワードを知っている人は, 単に root としてログ + インできます. この場合は, 当然ログインの記録や + <command>su</command> コマンドのログ は残りません.</para> + + <para>では, どちらを使うべきでしょうか?</para> + + <para>単純に “insecure” を使うのがよいでしょう. + 公共の場所にある訳では<emphasis>な い</emphasis>端末や, + 鍵のかかったドアの内側にある端末<emphasis>にも</emphasis> + “insecure” を指 定する方がよいでしょう. + スーパユーザの特権が必要な場合でも, ログイ ンして + <command>su</command> を実行するのは, + ごく簡単なことなんですから.</para> + + <para>以下に, ようやく完成した <filename>/etc/ttys</filename> + のエントリに端末の場所を表 + すコメントを追加したものを示します. </para> + + <programlisting> +ttyd1 "/usr/libexec/getty std.38400" wy50 on insecure # Kitchen +ttyd5 "/usr/libexec/getty std.19200" vt100 on insecure # Guest bathroom</programlisting> + </sect3> + + <sect3 id="term-hup"> + <title><command>init</command> にファイル + <filename>/etc/ttys</filename> の再読み 込みをさせる</title> + + <para>FreeBSD をブートすると, 最初に起動されるプロセス, + <command>init</command>が <filename>/etc/ttys</filename> + を読み込んで, 記述されているプログラムを利用可能な + ポートに対して実行し, + ログインプロンプトを送り出させます.</para> + + <para><filename>/etc/ttys</filename> の編集が終わった後, + <command>init</command> に変更を認識させるた めに, わざわざ + FreeBSD をブートしなおしたくはないでしょう. このような + 場合のために, <command>init</command> は, + <literal>SIGHUP</literal> (hangup) シグナルを受信すると, + <filename>/etc/ttys</filename> + を読み込みなおすようになっています.</para> + + <para><filename>/etc/ttys</filename> の変更を保存したら, + 以下のようなコマンドを実行して, <command>init</command> + に対して SIGHUP を送信します. </para> + + <screen>&prompt.root; <userinput>kill -HUP 1</userinput></screen> + + <para>(<command>init</command> プロセスのプロセス ID は + <emphasis>常に</emphasis> 1です. )</para> + + <para>すべての設定が正しくおこなわれ, + すべてのケーブルがただしく接続されてい て, + かつ端末の電源が入っていれば, + 端末にはログインプロンプトが表示され ているはずです. これで, + これらの端末からの最初のログインの準備が完了で す!</para> + </sect3> + </sect2> + + <sect2 id="term-debug"> + <title>トラブルシューティング</title> + + <para>細心の注意を払って設定をおこなっても, + ときには端末の接続がう まくいかない場合があるでしょう. 以下に, + よく見られる問題とその解決方法 を示します.</para> + + <variablelist> + <varlistentry><term>ログインプロンプトが表示されない</term> + <listitem> + <para>端末の電源が接続され, + スイッチが入っていることを確認してください. もし, PC + を端末として利用している場合は, + 通信ソフトが適切なシリアルポー + トを利用する設定になっているかどうか確かめてください. + </para> + + <para>ケーブルがしっかりと端末と + FreeBSDが動作しているコンピュータの両方に接続され + ていることを確認してください. また, + 正しい種類のケーブルを利用している + か確かめてください.</para> + + <para>端末と FreeBSD + の間の通信速度とパリティの設定が一致していることを確認 + してください. + 出力をモニタに表示するタイプの端末の場合は, モニタ + のコントラストと明るさの設定を確認してください. また, + 出力が印刷 されるタイプの端末の場合は, + 紙とインクが十分にあるかどうかを確かめてく + ださい.</para> + + <para><command>getty</command> が動いていて, + 端末を認識していることを確認してください. 以 + 下のコマンドで動作中の <command>getty</command> + プロセスのリストを得ることができます. + + <screen>&prompt.root; <userinput>ps -axww|grep getty</userinput></screen> + + その端末に対する <command>getty</command> + の情報が表示されるはずです. たとえば, 以下 + の表示例は, <command>getty</command> は + 2番目のシリアルポート (<literal>ttyd1</literal>) に対し + て <filename>/etc/gettytab</filename> 中の + <literal>std.38400</literal> のエントリを使って動作し + ているということを示しています. </para> + + <screen>22189 d1 Is+ 0:00.03 /usr/libexec/getty std.38400 ttyd1</screen> + + <para>もし, <command>getty</command> + プロセスが一つも動いていないようであれば, + <filename>/etc/ttys</filename> の中で, + そのポートを利用可能にする設定をしたかどう + か確かめてください. また, <command>kill -HUP + 1</command> を確実に実行してください.</para> + </listitem> + </varlistentry> + + <varlistentry><term> + ログインプロンプトの代わりにゴミが表示される</term> + <listitem> + <para>端末と FreeBSD + の間の通信速度およびパリティの設定が一致していることを確 + かめてください. また, <command>getty</command> + プロセスの情報を調べて, 適切な + <replaceable>getty</replaceable> + のタイプが使用されていることを確認してください. 間違った + <emphasis remap=tt>getty</emphasis> + タイプが使用されている場合は, + <filename>/etc/ttys</filename> を修正し てから, + <command>kill -HUP 1</command> + を実行してください.</para> + </listitem> + </varlistentry> + + <varlistentry><term>文字が重複して表示される, + 入力したパスワードが表示される</term> + <listitem> + <para>端末または通信ソフトの設定で, “半二重 (half + duplex)”あるいは“ローカ + ルエコー”となっているところを, “全二重 (full + duplex)”に変更してく ださい.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + </sect1> + + <sect1 id="dialup"> + <title>ダイアルインサービス</title> + + <para><emphasis>原作: &a.ghelmer;.</emphasis></para> + + <para><emphasis>訳: &a.max;.<!-- <br> --> + 6 September 1996.</emphasis></para> + + <para>このドキュメントでは, FreeBSD + で外部からのモデムによるアクセスを受け付 + けるための設定に関してまとめてあります. このドキュメントは筆者が + FreeBSD 1.0, 1.1 および 1.1.5.1 での経験と, 他の UNIX 系 OS + での経験を 基に書いたものですが, + 必ずしも十分な内容でないかもしれませんし, 掲載し + た実例もあなたが今お使いの環境とは一致しないかもしれません. + また, 筆者 はこのドキュメントに従って行われた作業で + データが失われたりシステムが破 壊されるようなことがあっても, + 一切責任をとれません.</para> + + <sect2 id="dialup-prereqs"> + <title>設定を始める前に</title> + + <para>筆者は, 読者が FreeBSD + に関する基本的な知識をもっていることを仮定して + このドキュメントをまとめました. まず, FreeBSD + が既にインストールされ ていて, UNIX + 系環境においてファイルの編集の方法やシステムに付属のマニュ + アルを参照する方法を知っている必要があります. また, + 以下に示すように, FreeBSD + の特定のバージョンが必要となりますし, いくつかの用語に関する + 知識, + そしてモデムや多少の配線に関する知識も必要となります.</para> + + <sect3> + <title>FreeBSD のバージョン</title> + + <para>まず, FreeBSD のバージョンは 1.1 以上を使用してください + (バージョン 2.x でもかまいません. ). FreeBSD 1.0 には, + 2種類のシリアル ドライバ が含まれているので, + 混乱の元となり得ます. また, FreeBSD のシリアル ディバイス + ドライバ (<devicename>sio</devicename>) は, + バージョンを追う毎に改善されてき ていますので, + より新しいバージョンの FreeBSD を使用することで, よりよ い, + より効率の高いドライバを利用することができるはずです.</para> + </sect3> + + <sect3> + <title>用語解説</title> + + <para>以下, 簡単にいくつかの用語について解説しておきます.</para> + + <variablelist> + <varlistentry><term>bps</term> + <listitem> + <para>Bits per Second の略で, + データの転送速度を表す単位.</para> + </listitem> + </varlistentry> + + <varlistentry><term>DTE</term> + <listitem> + <para>Data Terminal Equipment の略. + たとえばコンピュータ本体のこと.</para> + </listitem> + </varlistentry> + + <varlistentry><term>DCE</term> + <listitem> + <para>Data Communications Equipment の略で, + 具体的にはモデムのこと.</para> + </listitem> + </varlistentry> + + <varlistentry><term>RS-232</term> + <listitem> + <para>EIA (米電気産業協会) + のハードウェア間シリアル通信の標準規 格.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>これらの用語やデータ通信一般に関して, + より詳しい情報が必要な場合は, <emphasis>The RS-232 + Bible</emphasis> という本 (誰か ISBN 分かる方いませんか?) + が参考 になると思います.</para> + + <para>通信においてのデータ転送速度に関して, + このドキュメントでは “ボーレー ト” (baud rate) + ではなく, “bps” (bits per second) + をその単位として 使うことにします. これは, + ボーというのは一定時間に生じる電気的状態の変 + 化の数を表す単位にすぎず, <emphasis remap=bf>bps</emphasis> + という単位の方が実体に即しているか らです. (少なくとも, + こういう表現をしておけば, 意地の悪い人に怒られる + こともないのではないかと思います. )</para> + </sect3> + + <sect3> + <title>外づけモデムと内蔵モデムについて</title> + + <para>ダイアルアップのサービスに関していえば, + 外づけのモデムの方が適している ようです. これは, + 多くの外づけのモデムは設定を不揮発ラムに書き込んで半 + 永久的に保存することができますし, また RS-232 + に関する重要な情報を知る + ための点滅するライトによるインディケータが + 搭載されているからです. 点滅 するライトは, + システムを見に来た訪問者に強い印象を与えるという効果だけ + でなく, モデムが適切に動作しているかどうかを知るためにも + 有効です.</para> + + <para>一方, たいていの内蔵型のモデムには + 不揮発性ラムが搭載されていないため, ディップ + スイッチの変更以外に設定を保存する方法がありません. また, も + しインディケータがついていても, おそらくコンピュータのケース + カバーが 外されていなければその状態を確認するのは + 難しいでしょう.</para> + </sect3> + + <sect3> + <title>モデムとケーブル</title> + + <para>以下のことに関して, 予め知っておく必要があります.</para> + + <itemizedlist> + <listitem> + <para>コンピュータとモデムの間での通信が + 行えるようにするための接続方 法. + (内蔵型の場合は接続の必要はありません)</para> + </listitem> + + <listitem> + <para>お使いのモデムのコマンドについての知識, + あるいはコマンドの解説 の在処</para> + </listitem> + + <listitem> + <para>(通信ソフトを使っての) + モデムの不揮発ラムに保存可能な設定の変更 方法</para> + </listitem> + </itemizedlist> + + <para>1番目のモデムの接続はたいてい簡単に行えるはずです. + ほとんどのストレー ト シリアル ケーブルが使えるでしょう. + 使用すべきケーブルは, 両端に適 切なコネクタ (DB-25 または + DB-9 の雄または雌) のついた, DCE-DTE 間接 続用のもので, + 以下の信号線が接続されていなければなりません.</para> + + <itemizedlist> + <listitem> + <para>Transmitted Data (<acronym>SD</acronym>)</para> + </listitem> + + <listitem> + <para>Received Data (<acronym>RD</acronym>)</para> + </listitem> + + <listitem> + <para>Request to Send (<acronym>RTS</acronym>)</para> + </listitem> + + <listitem> + <para>Clear to Send (<acronym>CTS</acronym>)</para> + </listitem> + + <listitem> + <para>Data Set Ready (<acronym>DSR</acronym>)</para> + </listitem> + + <listitem> + <para>Data Terminal Ready (<acronym>DTR</acronym>)</para> + </listitem> + + <listitem> + <para>Carrier Detect (<acronym>CD</acronym>)</para> + </listitem> + + <listitem> + <para>Signal Ground (<acronym>SG</acronym>)</para> + </listitem> + </itemizedlist> + + <para>FreeBSD で 2400bps 以上の転送速度を利用する場合には, + フロー制御のため に <acronym>RTS</acronym> 信号と + <acronym>CTS</acronym> 信号が必要です. また, + 接続の確立と回線の切 断を検出するために + <acronym>CD</acronym> 信号を利用します. さらに, + <acronym>DTR</acronym> 信号を使っ + て回線切断後のモデムのリセットを行います. ケーブルの中には, + 総ての必要 な信号線が接続されていないものもありますので, + たとえば, 回線切断後でも ログイン + セッションが残ってしまうといった問題が発生した場合などには, + ケーブルに問題がある可能性もあります.</para> + + <para>次に, お使いのモデムにもよりますが, + もしモデムのコマンドをよく覚えてい ない場合は, + モデムのマニュアルをすぐに参照できるようにしておいてくださ + い. このドキュメントでは例として USR Sportstar の 14,400 bps + の外づけ型 モデムのコマンドを示しておきます. + 他の種類のモデムをお使いの場合も, 参 + 考になるかもしれません.</para> + + <para>最後に, FreeBSDで快適にモデムを使うためにも, + モデムの設定方法を知って おく必要があります. FreeBSD も他の + UNIX 系 OS と同様, 回線の接続およ + び切断の検出や回線の切断および回線切断後の + モデムの初期化にハードウェア シグナルを利用します. FreeBSD + は, モデムに対するコマンドの送信やモデ + ムの状態の監視を行いません. パソコンで運用されている BBS + への接続に慣 れている方にとっては, + ちょっとめんどうかもしれませんね.</para> + </sect3> + + <sect3> + <title>シリアル インタフェースについて</title> + + <para>FreeBSD では, NS8250-, NS16450-, NS16550- および + NS16550A- に基づ いた EIA RS-232C (CCITT V.24) + 規格のシリアル インタフェースをサポート しています. 8250 + および 16450 ベースのディバイスには1文字のキャラクタ + バッファが搭載されています. また, 16550 系のディバイスには, + 16文字分 のバッファが搭載されていて, + はるかによいパフォーマンスを得られます. (ただし, 無印の + 16550 では, バグがあって 16 文字バッファが利用できませ + んので, 可能であれば 16550A + 系のディバイスを利用してください. ) 1文字 のバッファの物は, + 16550 系のものと比べて OS にかける負荷が大きいので, 16550A + 系ディバイスの利用を強く推奨します. 多数のシリアル + ポートを利 用する場合や, 負荷の高いシステムにおいては, + 16550A 系ディバイスを使う ことで, + エラー発生率を低く押さえることができます.</para> + </sect3> + </sect2> + + <sect2> + <title>概要</title> + + <para>FreeBSD は以下の手順でモデムからのログインを受付ます. + <command>init</command> から起 動された + <command>getty</command> のプロセスが, 割り当てられたシリアル + ポート (この 例では <filename>/dev/ttyd0</filename>) + がオープンされるのを辛抱強く待ちます. <command>ps + ax</command> コマンドを実行すると, + 以下のような出力が得られるはずです.</para> + + <screen> 4850 ?? I 0:00.09 /usr/libexec/getty V19200 ttyd0</screen> + + <para>ユーザがモデムに電話をかけ, モデム同士が接続されると, + モデムの <acronym>CD</acronym> が検出されます. その結果, + kernel がキャリア信号を検出して, <command>getty</command> + によるポートのオープンの処理が終了します. + <command>getty</command> は, <prompt>login:</prompt> + プロンプトを指定されている初期回線速度で送信します. + <command>getty</command> は, + 正常に文字列を受信できるかどうか監視し, 通常の設定では, + もし以上な文字列を検出した場合 (理由としては, + <command>getty</command> の速度とモデ + ムの接続速度が異なっているような場合が考えられます. ), + 正常に文字列が 受信できるまで, <command>getty</command> + は速度を変え続けます.</para> + + <para><command>getty</command> が正しい速度を検出すれば, + ユーザに対して <prompt>login:</prompt> プロン + プトが表示されるはずです. ユーザがログイン名を入力すると, + <command>getty</command> は + <filename>/usr/bin/login</filename> を起動して, + パスワードの入力を要求し, その + 後ユーザのシェルを起動します.</para> + + <para>それでは, 続いて設定についての解説です.</para> + </sect2> + + <sect2> + <title>kernel の設定</title> + + <para>通常, FreeBSD の kernel は, PC-DOS の世界で + <devicename>COM1:</devicename>, <devicename>COM2:</devicename> + , <devicename>COM3:</devicename> および + <devicename>COM4:</devicename> と呼ばれる四つのシリアル ポートを + 探す + ように設定されています. また, FreeBSD では, 現在のところ + Boca の 1008 + や 2016 のような, 単純なマルチポートのシリアル + インタフェースもサポー + トしています. (マルチポートのシリアル ボードに関しての + kernel の設定 + については, &man.sio.4; のマニュアルを参照してください. ) + デフォルト + の kernel は, COM ポートだけを探します.</para> + + <para>搭載されているシリアル ポートのいずれかを, kernel + が認識しているかどう か確認したい場合は, kernel + 起動時のメッセージを注意深く見ているか, あ るいは + <command>/sbin/dmesg</command> コマンドを使って, + ブート時の出力メッセージ を確認してください. 特に, + <literal>sio</literal> で始まるメッセージをよく見てくださ い. + 参考までに, 以下のコマンドで <literal>sio</literal> + という文字列を含むメッセージ + だけを表示することができます.</para> + + <screen>&prompt.root; <userinput>/sbin/dmesg | grep 'sio'</userinput></screen> + + <para>たとえば, シリアル ポートを四つ持つシステムの場合は, + 以下のようなシリ アル ポートに関するメッセージが kernel + によって表示されます.</para> + + <screen>sio0 at 0x3f8-0x3ff irq 4 on isa +sio0: type 16550A +sio1 at 0x2f8-0x2ff irq 3 on isa +sio1: type 16550A +sio2 at 0x3e8-0x3ef irq 5 on isa +sio2: type 16550A +sio3 at 0x2e8-0x2ef irq 9 on isa +sio3: type 16550A</screen> + + <para>もし, kernel に正常に認識されないポートがある場合は, + おそらくカスタマ イズした kernel + を構築する必要があるでしょう.</para> + + <para>kernel 構築と構築のための設定に関しては, BSD System + Manager's Manual の “Building Berkeley Kernels with + Config (config コマンドによる BSD kernel の構築) ” + [ソース ファイルは <filename>/usr/src/share/doc/smm</filename> + にあります]と “FreeBSD Configuration Options” [ + <filename>/sys/conf/options</filename> および <filename> + /sys/<replaceable>arch</replaceable>/conf/options.<replaceable>arch + </replaceable></filename> の <emphasis>arch</emphasis> + の部分をたとえば <filename>i386</filename> としたファイル ] + を参照 してください.</para> + + <para>kernel の設定と構築をするためには, kernel のソース + (FreeBSD 1.1 では <filename>srcdist/srcsys.??</filename>, + FreeBSD 1.1.5.1 では <filename>srcdist/sys.??</filename>, + またFreeBSD 2.0 では総てのソース)を展開 + する必要があります.</para> + + <para>まだ自分のシステムの kernel 用のコンフィギュレーション + ファイルを作っ ていない場合は, + <filename>/sys/i386/conf</filename> に <command>cd</command> + して作成してくださ い. 初めてコンフィギュレーション + ファイルを作る場合は, まず <filename>GENERICAH</filename> + (FreeBSD 1.x で BusTek の SCSI コントローラを使っている場合は + <filename>GENERICBT</filename>) というファイルを, + <filename>YOURSYS</filename> にコピーしてください. ここ で, + <filename>YOURSYS</filename> はあなたのシステム名で, + 大文字である必要があります. このファイルを編集して, + ディバイスに関する記述を変更します.</para> + + <programlisting> +device sio0 at isa? port "IO_COM1" tty irq 4 vector siointr +device sio1 at isa? port "IO_COM2" tty irq 3 vector siointr +device sio2 at isa? port "IO_COM3" tty irq 5 vector siointr +device sio3 at isa? port "IO_COM4" tty irq 9 vector siointr</programlisting> + + <para>システムに搭載されていないディバイスに関する記述は, + コメントアウトまた + は削除してしまってかまいません. + Boca の BB2016 のようなマルチポートの + シリアル ボードをお持ちの場合は, &man.sio.4; + のマニュアルを見て, マ + ルチポートのボードのためのコンフィギュレーション + ファイルの記述のし方 + に関して確認してください. ディバイスのフラグの + 指定方法がバージョンによっ + て異なりますので, 別のバージョンの FreeBSD + で利用していたコンフィギュ + レーション ファイルを流用する場合には + 十分注意してください.</para> + + <note> + <para>なお, <literal>port "IO_COM1"</literal>, + <literal>IO_COM2</literal>, <literal>IO_COM3</literal> + および <literal>IO_COM4</literal> は, + それぞれのポートの一般的なアドレスである + <literal>0x3f8</literal>, <literal>0x2f8</literal>, + <literal>0x3e8</literal> および <literal>0x2e8</literal> + を表します. また, 割り込 み番号 4, 3, 5 と 9 は, それぞれ + <devicename>COM1:</devicename> から + <devicename>COM4:</devicename> のポー トで一般的に使用される + IRQ です. また, ISA バスのコンピュータの場合, + 一般的なシリアルポートは複数のポートで一つの IRQ + を共有することが + <emphasis>できません</emphasis>ので注意が必要です. + (マルチポートのシリアル ボードの 場合は, 複数の 16550A + ベースのポートで一つまたは二つの IRQ を共有する + ための機構を備えています. )</para> + </note> + + <para>コンフィギュレーション ファイルの編集が終わったら, + “Building Berkeley Kernels with Config (config + コマンドによる BSD kernel の構築)” および + &man.config.8; のマニュアルにしたがって, + <command>config</command> コマンド を使って kernel + 構築のためのディレクトリを作成した後, kernel の構築, + インストールおよびテストを行ってください.</para> + </sect2> + + <sect2> + <title>ディバイス スペシャル ファイル</title> + + <para>kernel に組み込まれているほとんどのディバイスは, + <filename>/dev</filename> ディレ クトリにある, + “ディバイス スペシャル + ファイル”を介してアクセスされ ます. + <devicename>sio</devicename> ディバイスの場合は, 着信用の + <filename>/dev/ttyd<replaceable>?</replaceable></filename> + およ び, 発信用の + <filename>/dev/cua0<replaceable>?</replaceable></filename> + が利用されます. さらに, FreeBSD の 1.1.5 以降では, + 初期化ディバイス + (<filename>/dev/ttyi<replaceable>?</replaceable></filename> と + <filename>/dev/cuai0<replaceable>?</replaceable></filename>) + およびロッキング ディバイス + (<filename>/dev/ttyld<replaceable>?</replaceable></filename> + と + <filename>/dev/cual0<replaceable>?</replaceable></filename>) + も合わせて利用されます. 初期化ディバイスは, 通信 + ポートがオープンされる度に, + そのポートの初期設定を行うために使われます. たとえば, + <literal>CTS/RTS</literal> + によるフロー制御を行うモデムが接続されてい る場合の + <literal>crtscts</literal> + などのパラメータの初期化が行われます. ロッキング + ディバイスは, ポートの設定をロックし, + 他のユーザやプログラムにこれらを + 変更されることのないようにするために利用されます. + 通信ポートの設定, 初 期化とロックおよび設定の変更に関しては, + それぞれ &man.termios.4;, &man.sio.4; と &man.stty.1; + のマニュアルをご覧ください.</para> + + <sect3> + <title>ディバイス スペシャル ファイルの作成</title> + + <para>ディバイス スペシャル ファイルの管理は, ディレクトリ + <filename>/dev</filename> + にあるシェル スクリプト <command>MAKEDEV</command> + によって行います. (FreeBSD + 1.1.5 の &man.MAKEDEV.8; のマニュアルの <acronym>COM</acronym> + ポートに関する記述は, + かなりいい加減なので無視してください. ) + <command>MAKEDEV</command> を使って, + <devicename>COM1:</devicename> (ポート 0) + をダイアルアップのポートとして利用するためのディ + バイス スペシャル ファイルを作るには, + <filename>/dev</filename> に <command>cd</command> して + から, <command>MAKEDEV ttyd0</command> と実行してください. + 同様に, <command>MAKEDEV + ttyd1</command> とすることで, <devicename>COM2:</devicename> + (ポート 1) 用のディバイス スペシャル ファイル + を作成することができます.</para> + + <para><command>MAKEDEV</command> は, + <filename>/dev/ttyd<replaceable>?</replaceable></filename> + のディバイス ファイルだけでなく, + <filename>/dev/cua0<replaceable>?</replaceable></filename> + (および FreeBSD 1.1.5 以降では総ての初期化ディバイ + スとロッキング ディバイスのスペシャル ファイル) + も作成します. さらに, もしシリアル端末用のスペシャル + ファイル + <filename>/dev/tty0<replaceable>?</replaceable></filename> + が存在すれ ば, それらの削除も行います.</para> + + <para>ディバイス スペシャル ファイルの作成後, + これらのファイルのパーミション が適切に設定されていて, + これらのディバイスを利用してもよいユーザのみが + 読み書きできるようになっていることを確認してください. (特に + <filename>/dev/cua*</filename> + のパーミションには注意を払ってください. ) この確認 を怠ると, + 一般のユーザがあなたのモデムを使うことができるようなことにな + りかねません. デフォルトの <filename>/dev/cua*</filename> + のパーミションは, 以下の ようになっていて, + たいていの場合適切なものだと思います.</para> + + <screen>crw-rw---- 1 uucp dialer 28, 129 Feb 15 14:38 /dev/cua01 +crw-rw---- 1 uucp dialer 28, 161 Feb 15 14:38 /dev/cuai01 +crw-rw---- 1 uucp dialer 28, 193 Feb 15 14:38 /dev/cual01</screen> + + <para>上の設定では, ユーザ <username>uucp</username> と, + グループ <username>dialer</username> に属するユーザ + が発信用のディバイスを利用できます.</para> + </sect3> + </sect2> + + <sect2> + <title>設定ファイル</title> + + <para>FreeBSD のシステムへのダイアル + アップによるアクセスを実現するために編 + 集が必要と思われる設定ファイルが, <filename>/etc</filename> + ディレクトリに三つあ ります. まず, + <filename>/etc/gettytab</filename> には, + <filename>/usr/libexec/getty</filename> + デーモンの設定を記述します. つぎに, + <filename>/etc/ttys</filename> に保存されている情報から, + <filename>/sbin/init</filename> はど の + <filename>tty</filename> ディバイスに対して + <command>getty</command> のプロセスを実行するべきか判 + 断します. 最後に, お使いの FreeBSD が 1.1.5.1 以降のものならば + <filename>/etc/rc.serial</filename> スクリプトに, + それ以前のものならば <filename>/etc/rc.local</filename> + スクリプトにシリアル ポートの初期化のためのコマ + ンドを記述することができます.</para> + + <para>UNIX にダイアル アップ モデムを接続する方法には, + 二つの考え方がありま す. 一つの方法は, ダイアル + インしてくるユーザの接続速度に関係なく, 常 + にモデムとローカルのコンピュータの RS-232 + インタフェースの接続速度を一 定に保つように設定する方法です. + この設定の長所は, ユーザがダイアル イ ンして接続されると, + 即座にシステムからのログイン プロンプトが送信され + るということです. 短所は, + システムが実際のモデム間の速度を知ることがで きないために, + Emacs のようなフル スクリーンのプログラムが, 端末との接 + 続速度が遅い場合でも, + そのような場合に効果的な方法で画面出力を行わない + 点です.</para> + + <para>もう一つは, モデムの RS-232 + インタフェースとコンピュータの接続速度を, + モデム間の接続速度に応じて変化させるような設定です. たとえば, + モデム間 の接続が V.32bis (14.4 Kbps) ならば, + モデムとコンピュータの間の接続を 19.2 Kbps とし, + モデム間の接続が 2400 bps の時には, モデムとコンピュー タ間も + 2400 bps で接続するような設定をします. この場合, + <command>getty</command> は, モデムが返すリザルト + コードからモデムとコンピュータの接続速度を認識す + ることができませんので, <command>getty</command> は, + まず初期速度で <prompt>login:</prompt> とい + う文字列を送信して, それに対する応答の文字列を監視します. + ここで, ユー ザ側の端末に無意味な文字列が表示された場合, + ユーザは意味のある文字列を 受信するまで + <literal><Enter></literal> + キーを繰り返し押さなければならない + ということを知っていると仮定しています. + もし接続速度が間違っている場合, <command>getty</command> は, + ユーザから送られた文字を無意味な文字列として扱い, 次の + 速度を試します. そして, ここで再度 <prompt>login:</prompt> + プロンプトを送信します. + この一連の動作が異常な回数繰り返されることも考えられますが, + 普通は1度 か2度のキー入力があれば, + ユーザはまともなプロンプトを受信できます. こ + のログインの動作が前者の固定速度による方法に + 比べて美しくないのは明らか ですが, この方法では, + 低速度で接続しているユーザに対するフル スクリー + ンのプログラムからのレスポンスが改善されます.</para> + + <para>このドキュメントでは, 両方の設定方法について解説しますが, + どちらかとい うとモデム間の速度に応じて RS-232 + インタフェースの速度が変化するような + 設定の方に偏った説明になってしまうと思います.</para> + + <sect3> + <title><filename>/etc/gettytab</filename></title> + + <para><filename>/etc/gettytab</filename> は, &man.getty.8; + の設定ファイルで, &man.termcap.5; + と同様の形式で記述されます. ファイルのフォーマットや定 + 義できる機能についての詳細については, &man.gettytab.5; + のマニュアルを + ご覧ください.</para> + + <sect4> + <title>固定速度の設定</title> + + <para>モデムとコンピュータ間の通信速度を固定して使う場合, + おそらく <filename>/etc/gettytab</filename> + に特に変更を加える必要はないはずです.</para> + </sect4> + + <sect4> + <title>可変速度の設定</title> + + <para><command>getty</command> + が利用するモデムとコンピュータの接続速度に関する情報を + <filename>/etc/gettytab</filename> + に記述する必要があります. もし, 2400 bps のモ + デムをお使いになるのであれば, 既存の + <literal>D2400</literal> のエントリがそのまま利 + 用できるでしょう. このエントリは FreeBSD の 1.1.5.1 の + <filename>gettytab</filename> には既に含まれていますので, + あなたの FreeBSD のバージョンでこのエント + リが存在しているのであれば, + 新たに追加する必要はありません.</para> + + <programlisting> +# +# Fast dialup terminals, 2400/1200/300 rotary (can start either way) +# +D2400|d2400|Fast-Dial-2400:\ + :nx=D1200:tc=2400-baud: +3|D1200|Fast-Dial-1200:\ + :nx=D300:tc=1200-baud: +5|D300|Fast-Dial-300:\ + :nx=D2400:tc=300-baud:</programlisting> + + <para>高速モデムをお使いの場合は, おそらく + <filename>/etc/gettytab</filename> に新たなエ + ントリを追加する必要があります. 以下の例は, 14.4 Kbps + のモデムを, 最 大インタフェース速度を 19.2 Kbps + として利用するためのエントリです.</para> + + <programlisting> +# +# Additions for a V.32bis Modem +# +um|V300|High Speed Modem at 300,8-bit:\ + :nx=V19200:tc=std.300: +un|V1200|High Speed Modem at 1200,8-bit:\ + :nx=V300:tc=std.1200: +uo|V2400|High Speed Modem at 2400,8-bit:\ + :nx=V1200:tc=std.2400: +up|V9600|High Speed Modem at 9600,8-bit:\ + :nx=V2400:tc=std.9600: +uq|V19200|High Speed Modem at 19200,8-bit:\ + :nx=V9600:tc=std.19200:</programlisting> + + <para>上記の例を利用した場合, FreeBSD 1.1.5 + 以降ではパリティなし, 8ビットの 接続が行われます. FreeBSD + 1.1 では, <literal>:np:</literal> パラメータをファイルの + 先頭の + <literal>std.<replaceable>xxx</replaceable></literal> + のエントリに追加することで, パリティなし, + 8ビットの接続が行われますが, + このパラメータを追加しなければ接続は偶数 パリティ, + 7ビットになります.</para> + + <para>上記の例では, まず 19.2 Kbps (V.32bis) + によるモデムとコンピュータ間の 接続を試み, 続いて 9600 bps + (V.32), 2400 bps, 1200 bps, 300 bpsと順に 試み, 再び 19.2 + Kbps による接続を試みるという循環に入ります. この接続 + 速度の循環は, <literal>nx=</literal>(“next + table”) の機能で実現されています. ま た, + 各行はそれぞれ <literal>tc=</literal>(“table + continuation”) の機能を使って, + その他の接続速度に依存した “標準的な” + 設定を取り込んでいます.</para> + + <para>もし, お使いのモデムが 28.8 Kbps であったり, 14.4 Kbps + の圧縮転送の機 能を有効に利用したい場合は, 19.2 Kbps + よりも速い速度を利用するように 設定する必要があります. + 以下に 57.6 Kbps から接続を試みる + <filename>gettytab</filename> + の設定例を示しておきます.</para> + + <programlisting> +# +# Additions for a V.32bis or V.34 Modem +# Starting at 57.6 Kbps +# +vm|VH300|Very High Speed Modem at 300,8-bit:\ + :nx=VH57600:tc=std.300: +vn|VH1200|Very High Speed Modem at 1200,8-bit:\ + :nx=VH300:tc=std.1200: +vo|VH2400|Very High Speed Modem at 2400,8-bit:\ + :nx=VH1200:tc=std.2400: +vp|VH9600|Very High Speed Modem at 9600,8-bit:\ + :nx=VH2400:tc=std.9600: +vq|VH57600|Very High Speed Modem at 57600,8-bit:\ + :nx=VH9600:tc=std.57600:</programlisting> + + <para>もし, お使いの CPU が低速のものであったり, CPU + に対する負荷が高い場合 で, 16550A 系のシリアル + ポートをお使いでない場合, 57.6 Kbps の接続に おいて, sio + の “silo” + エラーが発生するかもしれません.</para> + </sect4> + </sect3> + + <sect3 id="dialup-ttys"> + <title><filename>/etc/ttys</filename></title> + + <para><filename>/etc/ttys</filename> には, + <command>init</command> が監視すべき <filename>tty</filename> + のリストを記<!-- kuriyama - filename? --> + 述します. さらに, <filename>/etc/ttys</filename> は, + <command>login</command> に対してセキュリ + ティに関する情報を提供します. (ユーザ + <username>root</username> は, <literal>secure</literal> とマー + クされている <emphasis remap=tt>tty</emphasis> + のみからログインできます. ) 詳しくは + &man.ttys.5; のマニュアルをご覧ください.</para> + <!-- kuriyama - remap=tt? --> + + <para><filename>/etc/ttys</filename> の既存の行を変更するか, + あるいは新しい行を追加して, <command>init</command> + が自動的に新しいダイアル アップ サービス用のポートに対して + <command>getty</command> + プロセスを起動するようにしてください. 書式は, 固定速度の設 + 定か可変速度の設定かに関わらず, 以下のとおりです.</para> + + <programlisting> +ttyd0 "/usr/libexec/getty xxx" dialup on</programlisting> + + <para>1番目の項目は, このエントリで対象とするディバイス + スペシャル ファイル です. 上の例では + <literal>ttyd0</literal> として, + <filename>/dev/ttyd0</filename> を <command>getty</command> + に監視させることを表しています. 2番目の項目 + <literal>"/usr/libexec/getty + <replaceable>xxx</replaceable>"</literal> + (<replaceable>xxx</replaceable> は初期段階で使われる + <filename>gettytab</filename> のエントリ + に置き換えてください. ) が, <command>init</command> + がこのディバイスに対して起動する プロセスです. 3番目の + <literal>dialup</literal> は, デフォルトのターミナル + タイプで す. 4番目の <literal>on</literal> は, + この行が有効であることを <command>init</command> に対して示 + しています. 5番目の項目に <literal>secure</literal> + を指定することもできますが, これ は, + たとえばシステムのコンソールのように, + 物理的に安全な端末に対しての + み指定するようにしてください.</para> + + <para>デフォルトのターミナル タイプ (上記の例では + <literal>dialup</literal>) は, ローカル + のユーザの好みによって異なってきます. ユーザがログイン + スクリプトをカ スタマイズして, ターミナル タイプが + <literal>dialup</literal> の時には自動的に他のター ミナル + タイプを設定できるように, ダイアル + アップのポートのデフォルトの ターミナル タイプには + <literal>dialup</literal> が伝統的に用いられています. + しかし, 筆者のサイトでは, ほとんどのユーザが VT102 + エミュレイションを使ってい るので, ダイアル + アップのポートのデフォルト ターミナル タイプとして + <literal>vt102</literal> を指定しています.</para> + + <para><filename>/etc/ttys</filename> の修正がすんだら, + 以下のようなコマンドを使って + <command>init</command> プロセスに <acronym>HUP</acronym> + シグナルを送り, <filename>/etc/ttys</filename> を + 読み込み直させてください. + + <screen>&prompt.root; <userinput>kill -1 1</userinput></screen> + + ただ, もし初めてシステムを設定しているのであれば, + モデムが適切に設定さ + れて接続されるまでは, <command>init</command> + に対してシグナルを送らない方がいいか + もしれません.</para> + + <sect4> + <title>固定速度の設定</title> + + <para>速度を固定する設定では, <filename>/etc/ttys</filename> + の中で, <command>getty</command> に対し + て固定速度のエントリを指定する必要があります. たとえば, + 以下の例はポー トのスピードが 19.2 Kbps + に固定されたモデムのための <filename>ttys</filename> + のエント リです.</para> + + <programlisting> +ttyd0 "/usr/libexec/getty std.19200" dialup on</programlisting> + + <para>別の速度でモデムのポートのスピードを固定したい場合は, + <filename>/etc/gettytab</filename> + から適切なエントリを選んで, 上の例の + <literal>std.19200</literal> の部分を + <literal>std.<replaceable>speed</replaceable></literal> + として, 適切な速度のも のに置き換えてください.</para> + </sect4> + + <sect4> + <title>可変速度の設定</title> + + <para>可変速度の設定では, <filename>ttys</filename> + のエントリが, <filename>/etc/gettytab</filename> + の中の適切な “自動速度調整” + の初期設定のエントリを参照していなければな りません. + たとえば, もし前述の 19.2 Kbps + から接続を試みる可変速度の設 定例 + (<literal>V19200</literal> の + <filename>gettytab</filename> エントリ)をそのまま + <emphasis remap=tt>ttys</emphasis> に追 加したのであれば, + <filename>ttys</filename> + エントリは以下のようになります.</para> + + <programlisting> +ttyd0 "/usr/libexec/getty V19200" dialup on</programlisting> + </sect4> + </sect3> + + <sect3> + <title><filename>/etc/rc.serial</filename> または + <filename>/etc/rc.local</filename></title> + + <para>V.32, V.32bis または V.34 + モデムのような高速モデムを利用する場合, ハー ドウェア + (<filename>RTS/CTS</filename>) + フロー制御を行う必要があります. FreeBSD kernel のモデム + ポートにハードウェア フロー制御のフラグを設定するため の + <command>stty</command> コマンドを, FreeBSD 1.1.5.1 以降では + <filename>/etc/rc.serial</filename> に, FreeBSD 1.1 では + <filename>/etc/rc.local</filename> に 記述できます.</para> + + <para>たとえば, FreeBSD 1.1.5.1 の + <filename>/etc/rc.serial</filename> のサンプルは以下 + のとおりです.</para> + + <programlisting> +#!/bin/sh +# +# Serial port initial configuration + +stty -f /dev/ttyid1 crtscts +stty -f /dev/cuai01 crtscts</programlisting> + + <para>この例では, <literal>termio</literal> のフラグ + <literal>crtscts</literal> をシリアル ポート #1 + (<devicename>COM2:</devicename>) のダイアル + インおよびダイアル アウトの初期化ディバイスに + 設定しています.</para> + + <para>古い FreeBSD 1.1 では, 以下のエントリが + <literal>crtscts</literal> フラグを設定する ために + <filename>/etc/rc.local</filename> + に追加されていました.</para> + + <programlisting> +# Set serial ports to use RTS/CTS flow control +stty -f /dev/ttyd0 crtscts +stty -f /dev/ttyd1 crtscts +stty -f /dev/ttyd2 crtscts +stty -f /dev/ttyd3 crtscts</programlisting> + + <para>FreeBSD 1.1 には初期化のためのディバイス スペシャル + ファイルがないので, ディバイス + ファイルそのものにフラグを設定して, その後はフラグをクリア + してしまうような極悪人が現れないことを願うしかありません. + </para> + </sect3> + </sect2> + + <sect2> + <title>モデムの設定</title> + + <para>もし, あなたのモデムがパラメータを不揮発ラムに + 保存できるタイプならば, PC-DOS 上の Telix や FreeBSD 上の + <command>tip</command> などのような通信プログラム を使って, + パラメータを設定してください. <command>getty</command> + が利用する初期速度でモデムに接続して, 以下の条件を満たすよ + うに不揮発ラムの設定を変更してください.</para> + + <itemizedlist> + <listitem> + <para>接続時に <acronym>CD</acronym> 信号がオンになる</para> + </listitem> + + <listitem> + <para>接続時に <acronym>DTR</acronym> がオンになり, + <abbrev>DTR</abbrev> オフで回線を切断しモ + デムをリセットする.</para> + </listitem> + + <listitem> + <para>送信時フロー制御には <acronym>CTS</acronym> を利用.</para> + </listitem> + + <listitem> + <para><acronym>XON/XOFF</acronym> + によるフロー制御を行わない.</para> + </listitem> + + <listitem> + <para>受信時のフロー制御は <acronym>RTS</acronym> を使用.</para> + </listitem> + + <listitem> + <para>Quiet mode (リザルト コードを返さない)</para> + </listitem> + + <listitem> + <para>コマンド エコーを返さない.</para> + </listitem> + </itemizedlist> + + <para>これらを実現するためのコマンドやディップ + スイッチの設定に関しては, モ + デムのマニュアルを参照してください.</para> + + <para>以下に, USRobotics Sportster の 14,400 bps + の外づけモデムの設定例を示 しておきます.</para> + + <programlisting> +ATZ +AT&C1&D2&H1&I0&R2&W</programlisting> + + <para>ことのついでに, たとえば, V42.bis や MNP5 + のデータ圧縮を使用するかど + うかなどのモデムの他の設定について確認, + 調整しておくのもよいかもしれま せん.</para> + + <para>さらに, USRobotics Sportster の 14,400 bps + の外づけモデムでは, 以下の ようなディップ + スイッチの設定も必要です. 他のモデムをお使いの方も, 以 + 下の例を設定の参考にしてください.</para> + + <itemizedlist> + <listitem> + <para>スイッチ1: UP — DTR 標準</para> + </listitem> + + <listitem> + <para>スイッチ2: 無視 (リザルト + コードを単語形式にするか数値形式にす るか)</para> + </listitem> + + <listitem> + <para>スイッチ3: UP — リザルト コードを返さない</para> + </listitem> + + <listitem> + <para>スイッチ4: DOWN — コマンド エコーを返さない</para> + </listitem> + + <listitem> + <para>スイッチ5: UP — 自動着信</para> + </listitem> + + <listitem> + <para>スイッチ6: UP — CD 標準</para> + </listitem> + + <listitem> + <para>スイッチ7: UP — + 不揮発ラムからデフォルト値をロードする</para> + </listitem> + + <listitem> + <para>スイッチ8: 無視 (Smart Mode/Dumb Mode)</para> + </listitem> + </itemizedlist> + + <para>リザルト コードを返さないように設定しておかないと, + <command>getty</command> が誤っ て <prompt>login:</prompt> + プロンプトをコマンド モードのモデムに送信してしまった場 合に, + モデムがこの入力をエコーしたり, この入力に対するリザルト + コード を返してしまったりすることになります. この結果として, + モデムと <command>getty</command> + の間で延々と無意味なやりとりが続いたというケースを聞いたこ + とがあります.</para> + + <sect3> + <title>固定速度の設定</title> + + <para>固定速度の設定では, + モデムとコンピュータ間の通信速度をモデムとモデム間 + の接続速度に関係なく, 常に一定に保つように, + モデムを設定する必要があり ます. USRobotics Sportster の + 14,400 bps 外づけモデムの場合, 以下のコ マンドで, + モデムとコンピュータ間の速度が, コマンド送信時の速度に固定さ + れます.</para> + + <programlisting> +ATZ +AT&B1&W</programlisting> + </sect3> + + <sect3> + <title>可変速度の設定</title> + + <para>可変速度の設定では, シリアル ポートの速度が, + 着信速度に応じて変化する ように設定しなければいけません. + USRobotics Sporster の 14,400 bps 外 づけモデムの場合, + 以下のコマンドで, エラー訂正機能を利用した通信の場合 は, + コマンドを送信した時の通信速度にシリアル + ポートの速度を固定し, エ ラー訂正機能を利用しない接続では, + シリアル ポートの速度が変化するよう に設定されます.</para> + + <programlisting> +ATZ +AT&B2&W</programlisting> + </sect3> + + <sect3> + <title>モデムの設定の確認</title> + + <para>ほとんどの高速モデムには, + 現在の設定をある程度人間にも理解できる形式に + して表示させるコマンドがあります. USRobotics Sporster の + 14,400 bps 外づけモデムの場合は, <command>ATI5</command> + コマンドで, 現在の不揮発ラムの設定を 表示することができます. + さらに, ディップ スイッチの設定も含めた現在の + 設定を確認するためには, <command>ATZ</command> + コマンドを送信してから, <command>ATI4</command> + コマンドを送信してください.</para> + + <para>他のメーカーのモデムをお使いの場合は, + モデムのマニュアルで設定値の確認 + 方法を確認してください.</para> + </sect3> + </sect2> + + <sect2> + <title>トラブルシューティング</title> + + <para>以下の手順でダイアル アップ + モデムの動作を確認することができます.</para> + + <sect3> + <title>FreeBSD システムの動作確認</title> + + <para>モデムを FreeBSD システムに接続し, + システムをブートします. あなたのモ + デムにモデムの状態を確認するためのインジケータがあれば, + <acronym>DTR</acronym> のイ + ンジケータの状態に注目してください. もし, + システムのコンソールに <prompt>login:</prompt> + プロンプトが表示された時に, <acronym>DTR</acronym> + のインジケータが点灯 すれば, FreeBSD が適切なポートに対して + <command>getty</command> を起動し, モデムへ + の着信を待っている状態であることを意味しています.</para> + + <para>もし <acronym>DTR</acronym> + のインジケータが点灯しない場合は, システムのコンソールか ら + FreeBSD にログインして, <command>ps ax</command> を実行し, + FreeBSD が 適切なポー トに対して<command>getty</command> + プロセスを起動しようとしているのかどうか確認して ください. + プロセスに関する情報の中に, 以下のような行が表示されるはずで + す.</para> + + <screen> 114 ?? I 0:00.10 /usr/libexec/getty V19200 ttyd0 + 115 ?? I 0:00.10 /usr/libexec/getty V19200 ttyd1</screen> + + <para>モデムにまだ着信がない状態の時に, + 以下のように上とは異なる出力があった + 場合, <command>getty</command> は既にモデム + ポートのオープンを終了したということに + なります. + + <screen> 114 d0 I 0:00.10 /usr/libexec/getty V19200 ttyd0</screen> + + <command>getty</command> は, <acronym>CD</acronym> + (carrier detect) 信号がオンの状態になるまで, + ポートのオープンを完了することはできませんので, + この場合は接続に問題が + あるか, あるいはモデムの設定に問題があることが考えられます. + </para> + + <para>もし, 適切なポートをオープンしようとしている + <command>getty</command> が見あたらない 場合は, 再度 + <filename>/etc/ttys</filename> の内容を確認し, + 書式などに誤りがないか 調べてみてください. また, ログ + ファイル <filename>/var/log/messages</filename> に + <command>init</command> および <command>getty</command> + から何か出力がないかどうかも確認してみてく ださい. + もし何かメッセージが記録されていたら, 再度 + <filename>/etc/ttys</filename> , + <filename>/etc/gettytab</filename> の二つの設定ファイルと, + ディバイス スペシャル <!-- kuriyama - ? to replaceble --> + ファイル <filename>/dev/ttyd?</filename> を確認し, + 記述に誤りがないか, 足りないエ ントリがないか, + 足りないディバイス スペシャルファイルがないかといった + 点について調べてみてください.</para> + </sect3> + + <sect3> + <title>モデムで接続してみる</title> + + <para>実際にモデムを使って別のコンピュータから + 接続してみてください. この時, 8ビット, パリティなし, + 1ストップ ビットで接続するようにしてください. + 接続後すぐにプロンプトが返ってこない場合や, + 無意味な文字列が表示される 場合は, 1秒に1回くらいの割合で + <literal><Enter></literal> キーを押してみて ください. + しばらくたって, なおも <prompt>login:</prompt> + プロンプトが現れない場合 は, <command>BREAK</command> + 信号を送信してみてください. この時, 端末側で使って + いるモデムが高速モデムならば, + このモデムのインタフェースの接続速度を固 定してから, + 再度ダイアル インしてみてください. (たとえば, USRobotics + Sportster の場合は, <command>AT&B1</command>)</para> + + <para>それでもまだ <prompt>login:</prompt> + プロンプトが表示されない場合は, + <filename>/etc/gettytab</filename> + の以下の点について再度確認してみてください.</para> + + <itemizedlist> + <listitem> + <para><filename>/etc/ttys</filename> の対応する行の + 2番目の項目で, <filename>/etc/gettytab</filename> + の中で定義されているエントリが指定されているか</para> + </listitem> + + <listitem> + <para>各 <literal>nx=</literal> で + <filename>/etc/gettytab</filename> + の中で定義されているもの が指定されているか</para> + </listitem> + + <listitem> + <para>各 <literal>tc=</literal> で + <filename>/etc/gettytab</filename> + の中で定義されているもの が指定されているか</para> + </listitem> + </itemizedlist> + + <para>もしダイアル インしても, FreeBSD + システム側のモデムが応答しない場合は, FreeBSD 側のモデムが + <acronym>DTR</acronym> + がオンになった時に電話にでるように設定さ + れているかを確認してください. + もしモデムの設定に問題がなさそうならば, + モデムのインジケータ (がもしあれば) で, + <acronym>DTR</acronym> がオンになっているか + を確認してください.</para> + + <para>この確認のステップを数回繰り返しても + うまくいかない場合は, 一度休憩して, + しばらくたってから挑戦してみましょう. それでもだめなら, + おそらく &a.questions; + にあなたのモデムについての情報と問題を書いたメールを送れ ば, + メーリング + リストのメンバーが問題の解決を助けるべく努力してくれる + でしょう.</para> + </sect3> + </sect2> + + <sect2> + <title>謝辞</title> + + <para>以下の方々から, + 多くのコメントやアドバイスをいただきました. ここに謝意 + を表します.</para> + + <variablelist> + <varlistentry><term>Sean Kelly</term> + <listitem> + <para><kelly@fsl.noaa.gov> 多くのすばらしい助言をいた + だきました</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + </sect1> + + <sect1 id="dialout"> + <title>ダイアルアウトサービス</title> + + <para><emphasis>原作: FAQ からの情報</emphasis></para> + + <para><emphasis>訳: &a.jp.tmaruya;.<!-- <br> --> + 31 December 1996.</emphasis></para> + + <para>以下はモデムを利用して他のコンピュータと + 接続する方法を説明しています. + これはリモートホストとターミナル接続を確立するための + 適切な方法です.</para> + + <para>これは BBS に接続するときによく使います.</para> + + <para>この種の接続は PPP 接続に問題がある場合, Internet + 上にあるファイルを 転送するのに非常に役に立ちます. FTP + で何らかのファイルを転送したいのに PPP + 接続を確立できない場合は, ファイルを FTP + 転送するためにターミナルセッション を利用します. そして ZMODEM + を利用してファイルを転送します.</para> + + <sect2> + <title><command>tip</command> や <command>cu</command> + が実行できないはなぜ?</title> + + <para>あなたのシステムで <command>tip</command> や + <command>cu</command> というプログラムは + <username>uucp</username> や <username>dialer</username> + というグループに所属しているユーザのみが + 実行できるようになっているのでしょう. リモートホストやモデムを + 利用できる <username>dialer</username> + のグループにあなたのアカウントを 加えましょう.</para> + + <para>もしくは下記のコマンドを使うことによって, そのシステムで + <command>tip</command> や <command>cu</command> + を誰でも使えるようになります:</para> + + <screen>&prompt.root; <userinput>chmod 4511 /usr/bin/tip</userinput></screen> + + <para> このコマンドは <command>cu</command> + に対しておこなう必要はありません, それは + <command>cu</command> は <command>tip</command> + に対するハードリンクだからです.</para> + </sect2> + + <sect2> + <title>私の Hayes モデムはサポートされていません, + どうしよう?</title> + + <para>実際, <command>tip</command> の + マニュアルページは古くなっています. 既に Hayes + ダイアラが組み込まれています. <filename>/etc/remote</filename> + ファイル中で <literal>at=hayes</literal> + を使ってください.</para> + + <para>Hayes ドライバは, 最近のモデムの新しい機能である + <literal>BUSY</literal>, <literal>NO DIALTONE</literal>, + <literal>CONNECT 115200</literal>などのメッセージを + 認識できるほど賢くはなく, 単に混乱を起こすだけです. + <command>tip</command>を使う場合には, + (<command>ATX0&W</command> とするなどして) これらの + メッセージを表示させないようにしなくてはいけません.</para> + + <para>また, <command>tip</command> のダイアルのタイムアウトは + 60秒です. モデムの タイムアウト設定はそれより短くすべきであり, + そうしないと <command>tip</command> + は通信に問題があると判断するでしょう. + <command>ATS7=45&W</command> を実行してください.</para> + + <para>実際, デフォルトの <command>tip</command> は Hayes + の完全なサポートを しているわけではありません. 解決方法は + <filename>/usr/src/usr.bin/tip/tip</filename> の下の + <filename>tipconf.h</filename> を変更することです. + もちろんこれにはソース配布ファイルが必要です.</para> + + <para><literal>#define HAYES 0</literal> と記述されている行を + <literal>#define HAYES 1</literal> と変更し, そして + <command>make</command>, <command>make install</command> + を実行します. これでうまく動作するでしょう.</para> + </sect2> + + <sect2 id="direct-at"> + <title>これらの AT コマンドを入力するには?</title> + + <para><filename>/etc/remote</filename> ファイルの中で + “direct” エントリを作ります. たとえばモデムが + 1番目のシリアルポートである <filename>/dev/cuaa0</filename> + に接続されている場合, 次のようにします:</para> + + <programlisting> +cuaa0:dv=/dev/cuaa0:br#19200:pa=none</programlisting> + + <para>モデムがサポートする最大の bps レートを br + フィールドに使います. そして <command>tip cuaa0</command> + を実行すると, モデムが利用できるようになります.</para> + + <para><filename>/dev/cuaa0</filename> + がシステムに存在しない場合は, 次のようにします:</para> + + <screen>&prompt.root; <userinput>cd /dev</userinput> +&prompt.root; <userinput>./MAKEDEV cuaa0</userinput></screen> + + <para>または root になって以下のように cu + コマンドを実行します:</para> + + <screen>&prompt.root; <userinput>cu -l<replaceable>line</replaceable> -s<replaceable>speed</replaceable></userinput></screen> + + <para><replaceable>line</replaceable> + にはシリアルポートを指定します (例えば + <filename>/dev/cuaa0</filename>). そして + <replaceable>speed</replaceable> には接続する速度を指定します + (例えば <literal>57600</literal>). その後 AT + コマンドを実行したら, <command>~.</command> + と入力すれば終了します.</para> + </sect2> + + <sect2> + <title>pn 機能の <literal>@</literal> 記号が使えません!</title> + + <para>電話番号 (pn) 機能の中での <literal>@</literal> 記号は, + tip に <filename>/etc/phone</filename> + にある電話番号を参照するように伝えます. しかし + <literal>@</literal> の文字は <filename>/etc/remote</filename> + のような 設定ファイルの中では特殊文字となります. + バックスラッシュを使ってエスケープをおこないます:</para> + + <programlisting> +pn=\@</programlisting> + </sect2> + + <sect2> + <title>コマンドラインから電話番号を指定するには?</title> + + <para>“generic” エントリと呼ばれるものを + <filename>/etc/remote</filename> に追加します. + 例えば次のようにします:</para> + + <programlisting> +tip115200|Dial any phone number at 115200 bps:\ + :dv=/dev/cuaa0:br#115200:at=hayes:pa=none:du: +tip57600|Dial any phone number at 57600bps:\ + :dv=/dev/cuaa0:br#57600:at=hayes:pa=none:du:</programlisting> + + <para>そして </para> + + <screen>&prompt.root; <userinput>tip -115200 5551234</userinput></screen> + + <para>のように利用できます. + <command>tip</command> より <command>cu</command> を使いたい場合, + <command>cu</command> の generic エントリを使います: + + <programlisting> +cu115200|Use cu to dial any number at 115200bps:\ + :dv=/dev/cuaa1:br#57600:at=hayes:pa=none:du:</programlisting> + + そして</para> + + <screen>&prompt.root; <userinput>cu 5551234 -s 115200</userinput></screen> + + <para> と実行します.</para> + </sect2> + + <sect2> + <title>毎回 bps レートを入力しなければいけませんか?</title> + + <para><literal>tip1200</literal> や <literal>cu1200</literal> + 用のエントリを記述し, 適切な通信速度を br + フィールドに設定します. <command>tip</command> は 1200 bps + が正しいデフォルト値であるとみなすので, + <literal>tip1200</literal> エントリを参照します. もちろん 1200 + bps を使わなければならないわけではありません.</para> + </sect2> + + <sect2> + <title>ターミナルサーバを経由して + 複数のホストへアクセスしたいんです.</title> + + <para>毎回接続されるのを待って + <command>CONNECT <host></command> と入力する + かわりに, tip の <literal>cm</literal> 機能を使います. + 例えば, <filename>/etc/remote</filename> + に次のようなエントリを追加します: + + <programlisting> +pain|pain.deep13.com|Forrester's machine:\ + :cm=CONNECT pain\n:tc=deep13: +muffin|muffin.deep13.com|Frank's machine:\ + :cm=CONNECT muffin\n:tc=deep13: +deep13:Gizmonics Institute terminal server:\ + :dv=/dev/cua02:br#38400:at=hayes:du:pa=none:pn=5551234:</programlisting> + + これで, <command>tip pain</command> や + <command>tip muffin</command> と実行すると + pain や muffin のホストに接続することができ, + <command>tip deep13</command> + を実行するとターミナルサーバに接続します.</para> + </sect2> + + <sect2> + <title>tip を使ってそれぞれのサイトの + 複数の回線に接続できますか?</title> + + <para>これは大学に電話回線がいくつかあって + 数千人の学生が接続しようとする 場合によくある問題です.</para> + + <para>あなたの大学のエントリを <filename>/etc/remote</filename> + ファイルに作成して, <literal>pn</literal> のフィールドには + <literal>@</literal> を使います:</para> + + <programlisting> +big-university:\ + :pn=\@:tc=dialout +dialout:\ + :dv=/dev/cuaa3:br#9600:at=courier:du:pa=none:</programlisting> + + <para>そして <filename>/etc/phone</filename> + ファイルに大学の電話番号の一覧を書きます:</para> + + <programlisting> +big-university 5551111 +big-university 5551112 +big-university 5551113 +big-university 5551114</programlisting> + + <para><command>tip</command> は一連の電話番号を試みて, + 最終的に接続できなければあきらめます. + リトライを続けさせたい場合は, <command>tip</command> を while + ループに入れて 実行します.</para> + </sect2> + + <sect2> + <title>CTRL+P を 1回送るために 2度押す必要があるのはなぜ?</title> + + <para>CTRL+P は通常 “force (強制)” 文字であり, + <command>tip</command> に次の文字が + リテラルデータであることを伝えます. force + 文字は“変数の設定” を意味する + <command>~s</command> + エスケープによって他の文字にすることができます.</para> + + <para><command> + ~sforce=<replaceable>single-char</replaceable></command> + と入力して改行します. <replaceable>single-char</replaceable> + は, 任意の 1バイト文字です. + <replaceable>single-char</replaceable> を省略すると NUL + 文字になり, これは CTRL+2 や CTRL+SPACE + を押しても入力できます. + いくつかのターミナルサーバで使われているのを 見ただけですが, + <replaceable>single-char</replaceable> に SHIFT+CTRL+6 + に割り当てるのもよいでしょう.</para> + + <para><filename>$HOME/.tiprc</filename> + に次のように定義することで, 任意の文字を force + 文字として利用できます:</para> + + <programlisting> +force=<single-char></programlisting> + </sect2> + + <sect2> + <title>打ち込んだ文字が突然すべて大文字になりました??</title> + + <para>CTRL+A を押してしまい, caps-lock + キーが壊れている場合のために設計された <command>tip</command> + の “raise character” モードに入ったのでしょう. + 既に述べたように <command>~s</command> を使って, + <literal>raisechar</literal> をより適切な値に + 変更してください. もしこれら両方の機能を使用しないのであれば, + force 文字と同じ設定にすることもできます.</para> + + <!-- kuriyama - file tiprc /file --> + <para>以下は CTRL+2 や CTRL+A などを頻繁に使う必要のある Emacs + ユーザにうってつけの. tiprc ファイルのサンプルです:</para> + + <programlisting> +force=^^ +raisechar=^^</programlisting> + + <para>^^ は SHIFT+CTRL+6 です.</para> + </sect2> + + <sect2> + <title><command>tip</command> でファイルを転送するには?</title> + + <para>もし他の UNIX のシステムと接続しているなら, + <command>~p</command>(put) や <command>~t</command>(take) + でファイルの送受信ができます. これらのコマンドは + 相手のシステムの上で <command>cat</command> や + <command>echo</command> を実行することで 送受信をします. + 書式は以下のようになります:</para> + + <cmdsynopsis> + <command>~p</command> + <arg choice="plain">ローカルのファイル名</arg> + <arg choice="opt">リモートのファイル名</arg> + </cmdsynopsis> + <cmdsynopsis> + <command>~t</command> + <arg choice="plain">リモートのファイル名</arg> + <arg choice="opt">ローカルのファイル名</arg> + </cmdsynopsis> + + <para>この方法ではエラーチェックをおこないませんので, zmodem + などの他のプロトコルを使った方がよいでしょう.</para> + </sect2> + + <sect2> + <title><command>tip</command> から zmodem を実行するには?</title> + + <para>ファイルを受信するには, + リモート側で送信プログラムを起動します. そして <command>~C + rz</command> と入力すると, ローカル側へのファイルの受信が + 始まります.</para> + + <para>ファイルを送信するには, + リモート側で受信プログラムを起動します. そして <command>~C sz + <replaceable>files</replaceable></command> と入力すると, + リモート側への ファイルの送信が始まります.</para> + </sect2> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/staff/chapter.sgml b/ja_JP.eucJP/books/handbook/staff/chapter.sgml new file mode 100644 index 0000000000..deb736ebc7 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/staff/chapter.sgml @@ -0,0 +1,782 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.13 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:57 kuriyama Exp $ +--> + +<chapter id="staff"> + <title>FreeBSDプロジェクトスタッフ</title> + + <para><emphasis>訳: &a.hanai;<!-- <br> -->28 August 1996.</emphasis></para> + + <para>FreeBSDプロジェクトは, + 以下の人々によって管理運営されています.</para> + + <sect1 id="staff-core"> + <title>FreeBSD コアチーム</title> + + <para>FreeBSD コアチームは, + プロジェクトの “運用委員会” を形成し, FreeBSD + プロジェクトの全般的な目的や方針の決定を行います. さらに, + FreeBSDプロジェクトの <link + linkend="staff-who">特定の分野</link>の + 運用も行っています.</para> + + <para>(姓でアルファベット順):</para> + + <itemizedlist> + <listitem> + <para>&a.asami;</para> + </listitem> + + <listitem> + <para>&a.jmb;</para> + </listitem> + + <listitem> + <para>&a.ache;</para> + </listitem> + + <listitem> + <para>&a.bde;</para> + </listitem> + + <listitem> + <para>&a.gibbs;</para> + </listitem> + + <listitem> + <para>&a.dg;</para> + </listitem> + + <listitem> + <para>&a.jkh;</para> + </listitem> + + <listitem> + <para>&a.phk;</para> + </listitem> + + <listitem> + <para>&a.rich;</para> + </listitem> + + <listitem> + <para>&a.gpalmer;</para> + </listitem> + + <listitem> + <para>&a.jdp;</para> + </listitem> + + <listitem> + <para>&a.sos;</para> + </listitem> + + <listitem> + <para>&a.peter;</para> + </listitem> + + <listitem> + <para>&a.wollman;</para> + </listitem> + + <listitem> + <para>&a.joerg;</para> + </listitem> + </itemizedlist> + </sect1> + + <sect1 id="staff-committers"> + <title>FreeBSD の開発者たち</title> + + <para>(CVSの)commitする権利を持っていて, FreeBSD + のソースツリーについて 作業をおこなっている人々がいます. + すべてのコアチームのメンバはま た 開発者でもあります.</para> + + <itemizedlist> + <listitem> + <para>&a.ugen;</para> + </listitem> + + <listitem> + <para>&a.mbarkah;</para> + </listitem> + + <listitem> + <para>&a.stb;</para> + </listitem> + + <listitem> + <para>&a.pb;</para> + </listitem> + + <listitem> + <para>&a.abial;</para> + </listitem> + + <listitem> + <para>&a.jb;</para> + </listitem> + + <listitem> + <para>&a.torstenb;</para> + </listitem> + + <listitem> + <para>&a.dburr;</para> + </listitem> + + <listitem> + <para>&a.charnier;</para> + </listitem> + + <listitem> + <para>&a.luoqi;</para> + </listitem> + + <listitem> + <para>&a.ejc;</para> + </listitem> + + <listitem> + <para>&a.kjc;</para> + </listitem> + + <listitem> + <para>&a.gclarkii;</para> + </listitem> + + <listitem> + <para>&a.archie</para> + </listitem> + + <listitem> + <para>&a.cracauer;</para> + </listitem> + + <listitem> + <para>&a.adam;</para> + </listitem> + + <listitem> + <para>&a.dillon;</para> + </listitem> + + <listitem> + <para>&a.dufault;</para> + </listitem> + + <listitem> + <para>&a.uhclem;</para> + </listitem> + + <listitem> + <para>&a.tegge;</para> + </listitem> + + <listitem> + <para>&a.eivind;</para> + </listitem> + + <listitem> + <para>&a.julian;</para> + </listitem> + + <listitem> + <para>&a.rse;</para> + </listitem> + + <listitem> + <para>&a.se;</para> + </listitem> + + <listitem> + <para>&a.sef;</para> + </listitem> + + <listitem> + <para>&a.fenner;</para> + </listitem> + + <listitem> + <para>&a.jfieber;</para> + </listitem> + + <listitem> + <para>&a.jfitz;</para> + </listitem> + + <listitem> + <para>&a.scrappy;</para> + </listitem> + + <listitem> + <para>&a.lars;</para> + </listitem> + + <listitem> + <para>&a.dirk;</para> + </listitem> + + <listitem> + <para>&a.shige;</para> + </listitem> + + <listitem> + <para>&a.billf;</para> + </listitem> + + <listitem> + <para>&a.tg;</para> + </listitem> + + <listitem> + <para>&a.gallatin;</para> + </listitem> + + <listitem> + <para>&a.brandon;</para> + </listitem> + + <listitem> + <para>&a.graichen;</para> + </listitem> + + <listitem> + <para>&a.jgreco;</para> + </listitem> + + <listitem> + <para>&a.rgrimes;</para> + </listitem> + + <listitem> + <para>&a.jmg;</para> + </listitem> + + <listitem> + <para>&a.hanai;</para> + </listitem> + + <listitem> + <para>&a.thepish;</para> + </listitem> + + <listitem> + <para>&a.jhay;</para> + </listitem> + + <listitem> + <para>&a.helbig;</para> + </listitem> + + <listitem> + <para>&a.ghelmer;</para> + </listitem> + + <listitem> + <para>&a.erich;</para> + </listitem> + + <listitem> + <para>&a.nhibma;</para> + </listitem> + + <listitem> + <para>&a.flathill;</para> + </listitem> + + <listitem> + <para>&a.foxfair;</para> + </listitem> + + <listitem> + <para>&a.hosokawa;</para> + </listitem> + + <listitem> + <para>&a.hsu;</para> + </listitem> + + <listitem> + <para>&a.mph;</para> + </listitem> + + <listitem> + <para>&a.itojun;</para> + </listitem> + + <listitem> + <para>&a.mjacob;</para> + </listitem> + + <listitem> + <para>&a.gj;</para> + </listitem> + + <listitem> + <para>&a.nsj;</para> + </listitem> + + <listitem> + <para>&a.kato;</para> + </listitem> + + <listitem> + <para>&a.andreas;</para> + </listitem> + + <listitem> + <para>&a.motoyuki;</para> + </listitem> + + <listitem> + <para>&a.jkoshy;</para> + </listitem> + + <listitem> + <para>&a.kuriyama;</para> + </listitem> + + <listitem> + <para>&a.grog;</para> + </listitem> + + <listitem> + <para>&a.jlemon;</para> + </listitem> + + <listitem> + <para>&a.truckman;</para> + </listitem> + + <listitem> + <para>&a.imp;</para> + </listitem> + + <listitem> + <para>&a.smace;</para> + </listitem> + + <listitem> + <para>&a.mckay;</para> + </listitem> + + <listitem> + <para>&a.mckusick;</para> + </listitem> + + <listitem> + <para>&a.ken;</para> + </listitem> + + <listitem> + <para>&a.hm;</para> + </listitem> + + <listitem> + <para>&a.tedm;</para> + </listitem> + + <listitem> + <para>&a.amurai;</para> + </listitem> + + <listitem> + <para>&a.markm;</para> + </listitem> + + <listitem> + <para>&a.max;</para> + </listitem> + + <listitem> + <para>&a.alex;</para> + </listitem> + + <listitem> + <para>&a.newton;</para> + </listitem> + + <listitem> + <para>&a.rnordier;</para> + </listitem> + + <listitem> + <para>&a.davidn;</para> + </listitem> + + <listitem> + <para>&a.obrien;</para> + </listitem> + + <listitem> + <para>&a.danny;</para> + </listitem> + + <listitem> + <para>&a.ljo;</para> + </listitem> + + <listitem> + <para>&a.fsmp;</para> + </listitem> + + <listitem> + <para>&a.smpatel;</para> + </listitem> + + <listitem> + <para>&a.wpaul;</para> + </listitem> + + <listitem> + <para>&a.jmacd;</para> + </listitem> + + <listitem> + <para>&a.wes;</para> + </listitem> + + <listitem> + <para>&a.steve;</para> + </listitem> + + <listitem> + <para>&a.mpp;</para> + </listitem> + + <listitem> + <para>&a.dfr;</para> + </listitem> + + <listitem> + <para>&a.jraynard;</para> + </listitem> + + <listitem> + <para>&a.darrenr;</para> + </listitem> + + <listitem> + <para>&a.csgr;</para> + </listitem> + + <listitem> + <para>&a.martin;</para> + </listitem> + + <listitem> + <para>&a.paul;</para> + </listitem> + + <listitem> + <para>&a.roberto;</para> + </listitem> + + <listitem> + <para>&a.chuckr;</para> + </listitem> + + <listitem> + <para>&a.guido;</para> + </listitem> + + <listitem> + <para>&a.dima;</para> + </listitem> + + <listitem> + <para>&a.sada;</para> + </listitem> + + <listitem> + <para>&a.wosch;</para> + </listitem> + + <listitem> + <para>&a.ats;</para> + </listitem> + + <listitem> + <para>&a.jseger;</para> + </listitem> + + <listitem> + <para>&a.simokawa;</para> + </listitem> + + <listitem> + <para>&a.vanilla;</para> + </listitem> + + <listitem> + <para>&a.msmith;</para> + </listitem> + + <listitem> + <para>&a.des;</para> + </listitem> + + <listitem> + <para>&a.brian;</para> + </listitem> + + <listitem> + <para>&a.mks;</para> + </listitem> + + <listitem> + <para>&a.stark;</para> + </listitem> + + <listitem> + <para>&a.karl;</para> + </listitem> + + <listitem> + <para>&a.dt;</para> + </listitem> + + <listitem> + <para>&a.cwt;</para> + </listitem> + + <listitem> + <para>&a.pst;</para> + </listitem> + + <listitem> + <para>&a.hoek;</para> + </listitem> + + <listitem> + <para>&a.nectar;</para> + </listitem> + + <listitem> + <para>&a.swallace;</para> + </listitem> + + <listitem> + <para>&a.dwhite;</para> + </listitem> + + <listitem> + <para>&a.nate;</para> + </listitem> + + <listitem> + <para>&a.yokota;</para> + </listitem> + + <listitem> + <para>&a.jmz;</para> + </listitem> + </itemizedlist> + </sect1> + + <sect1 id="staff-doc"> + <title>FreeBSD ドキュメンテーションプロジェクト</title> + + <para><ulink URL="../docproj.html">FreeBSD + ドキュメンテーションプロジェクト</ulink>は複数のサービスを提供 + しています. それぞれのサービスは, 以下の担当者とその + <emphasis>副担当者</emphasis>によって運用されています.</para> + + <variablelist> + <varlistentry><term>ドキュメンテーションプロジェクト担当</term> + <listitem> + <para>&a.nik;</para> + </listitem> + </varlistentry> + + <varlistentry><term>Web 管理責任者</term> + <listitem> + <para>&a.wosch;</para> + </listitem> + </varlistentry> + + <varlistentry><term>ハンドブックおよび FAQ 編集担当</term> + <listitem> + <para>&a.faq;</para> + </listitem> + </varlistentry> + + <varlistentry><term>ニュースフラッシュ編集担当</term> + <listitem> + <para>&a.nsj;</para> + <para><emphasis>副担当:</emphasis>&a.john;</para> + </listitem> + </varlistentry> + + <varlistentry><term>FreeBSD Really-Quick NewsLetter編集担当</term> + <listitem> + <para>Chris Coleman <email>chrisc@vmunix.com</email></para> + </listitem> + </varlistentry> + + <varlistentry><term>ギャラリーページ担当</term> + <listitem> + <para>&a.nsj;</para> + <para><emphasis>副担当</emphasis>&a.cawimm;</para> + </listitem> + </varlistentry> + + <varlistentry><term>商用ベンダーページ担当</term> + <listitem> + <para>&a.mbarkah;</para> + </listitem> + </varlistentry> + + <varlistentry><term>WEB 更新担当</term> + <listitem> + <para>&a.mbarkah;</para> + </listitem> + </varlistentry> + + <varlistentry><term>デザインやアートディレクション担当</term> + <listitem> + <para>&a.opsys;</para> + </listitem> + </varlistentry> + + <varlistentry><term>データベース技術担当</term> + <listitem> + <para>&a.mayo;</para> + </listitem> + </varlistentry> + + <varlistentry><term>CGI 技術担当</term> + <listitem> + <para>&a.stb;</para> + </listitem> + </varlistentry> + + <varlistentry><term>雑務担当</term> + <listitem> + <para>&a.nsj;</para> + </listitem> + </varlistentry> + + <varlistentry><term>LinuxDoc から DocBook への移行</term> + <listitem> + <para>&a.nik;</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + + <sect1 id="staff-who"> + <title>担当者</title> + + <variablelist> + <varlistentry><term>最高技術責任者</term> + <listitem> + <para>&a.dg;</para> + </listitem> + </varlistentry> + + <varlistentry><term><ulink url="../docproj/docproj.html"> + ドキュメンテーションプロジェクト担当</ulink></term> + <listitem> + <para>&a.nik;</para> + </listitem> + </varlistentry> + + <varlistentry><term><link linkend="l10n">国際化</link></term> + <listitem> + <para>&a.ache;</para> + </listitem> + </varlistentry> + + <varlistentry><term>ネットワーク</term> + <listitem> + <para>&a.wollman;</para> + </listitem> + </varlistentry> + + <varlistentry><term><link linkend="eresources-mail"> + ポストマスタ</link></term> + <listitem> + <para>&a.jmb;</para> + </listitem> + </varlistentry> + + <varlistentry><term>リリースコーディネータ</term> + <listitem> + <para>&a.jkh;</para> + </listitem> + </varlistentry> + + <varlistentry><term>広報および渉外担当</term> + <listitem> + <para>&a.jkh;</para> + </listitem> + </varlistentry> + + <varlistentry><term><ulink url="../security/security.html"> + セキュリティ担当</ulink></term> + <listitem> + <para>&a.imp;</para> + </listitem> + </varlistentry> + + <varlistentry><term><ulink url="../support.html#cvs"> + CVS ツリー管理者</ulink></term> + <listitem> + <para>責任者: &a.peter;</para> + <para>副責任者: &a.jdp;</para> + <para>国際版 (暗号) 担当: &a.markm;</para> + </listitem> + </varlistentry> + + <varlistentry><term><ulink url="../ports/"> + ports コレクション担当</ulink></term> + <listitem> + <para>&a.asami;</para> + </listitem> + </varlistentry> + + <varlistentry><term>XFree86 Project, Inc. との渉外担当</term> + <listitem> + <para>&a.rich;</para> + </listitem> + </varlistentry> + + <varlistentry><term><link linkend="eresources-news"> + Usenet サポート</link></term> + <listitem> + <para>&a.joerg;</para> + </listitem> + </varlistentry> + + <varlistentry><term><ulink url="../support.html#gnats"> + GNATS 管理者</ulink></term> + <listitem> + <para>&a.phk; と &a.steve;</para> + </listitem> + </varlistentry> + + <varlistentry><term><ulink url="../internal/">Web 管理者</ulink></term> + <listitem> + <para>&a.wosch;</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/handbook/x11/chapter.sgml b/ja_JP.eucJP/books/handbook/x11/chapter.sgml new file mode 100644 index 0000000000..61241e1b37 --- /dev/null +++ b/ja_JP.eucJP/books/handbook/x11/chapter.sgml @@ -0,0 +1,26 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.5 + $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:57 kuriyama Exp $ +--> + +<chapter id="x11"> + <title>X ウィンドウシステム</title> + + <para>この節の完成は保留にしてあります. + <ulink URL="http://www.xfree86.org/">The XFree86 Project, Inc</ulink> + から提供されるドキュメントを参考にしてください.</para> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/porter-handbook/book.sgml b/ja_JP.eucJP/books/porter-handbook/book.sgml new file mode 100644 index 0000000000..0bae98ef4c --- /dev/null +++ b/ja_JP.eucJP/books/porter-handbook/book.sgml @@ -0,0 +1,1139 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.9 + $Id: book.sgml,v 1.1.1.1 1999-04-08 15:45:59 kuriyama Exp $ +--> + +<chapter id="ports"> + <title>アプリケーションのインストール : ports コレクション</title> + + <para><emphasis>原作: &a.jraynard;.</emphasis></para> + + <para><emphasis>訳: &a.jp.masaki;, &a.jp.saeki;.<!-- <br> --> + 11 November 1996.</emphasis></para> + + <para>FreeBSD の ports コレクションを利用すると, 最小限の労力で + 非常に幅広くのアプリケーションのコンパイルとインストールがおこなえます.</para> + + <para>やってみたことのある方はよくご存知でしょうが, + オープンな規格とは 全くの誇大広告であって, + あるプログラムを異なるバージョンの Unix 上で + 動作させることは退屈で手間のかかる仕事です. + 求めているプログラムが自分のシステムでうまくコンパイルでき, + 正しいところにインストールできて, + 完璧に動作するとしたらとてもラッキーです. しかし, + あいにくこれは滅多にないことなのです. + ほとんどのプログラムについて, + あなたは髪を掻きむしることになるでしょうし, + かなりのプログラムでは, 白髪混じりの頭になってしまったり, + あるいは慢性の 脱毛症にすら なってしまうかもしれません...</para> + + <para>いくつかのソフトウェアディストリビューションでは, + 設定用のスクリプトを + 配布することでこの問題を解決しようとしています. + これらのスクリプトの中には非常に精巧なものもありますが, + 残念ながら, 中にはこれまで + 聞いたこともないようなシステムの名前をしゃあしゃあと + 言い放ったうえに, まるでシステムレベルの Unix + プログラミングに関する 最終試験のような, + たくさんの質問をしてくる場合があります. (例えば, + <literal>このシステムの gethitlist 関数は fromboz への const + ポインタを 返しますか? それとも const fromboz + へのポインタを返しますか?</literal>, <literal>このシステムには + Foonix スタイルの, 容認できない例外処理をおこなう + ルーチンがありますか? もしもないとしたら, + それはなぜですか?</literal>)</para> + + <para>幸いなことに, ports コレクションがあれば, + これらのきつい作業はすべて 完了しています. <command>make + install</command> とタイプするだけで, 動作するプログラムを + 入手することができるのです.</para> + + <sect1> + <title>なぜ ports コレクションを作ったのか?</title> + + <para>FreeBSD の基本システムは, + 非常に多くのツールやユーティリティから 構成されています. しかし, + よく使われるプログラムのうち多くのものが, + この基本システムには含まれていません. その理由は:-</para> + + <orderedlist> + <listitem> + <para>ある Lisp ベースのエディタのように, + それがないと生きていけないと 言う人もいれば, + ディスクの無駄だと言う人もいるようなプログラム.</para> + </listitem> + + <listitem> + <para>基本システムに組み込むには特殊すぎるプログラム. (CAD + やデータベースなど.)</para> + </listitem> + + <listitem> + <para>“時間のある時に, + ちょっと見ておかなければ”というような類の, + それがシステムに含まれていないことが + 致命的とは言えないプログラム. (おそらく, + 何らかの言語などでしょう.)</para> + </listitem> + + <listitem> + <para>FreeBSD + のような真面目なオペレーティングシステムの一部として + 供給するには遊びが過ぎるようなプログラム. ;-)</para> + </listitem> + + <listitem> + <para>たくさんのプログラムを基本システムに組み込んだとしても, + もっともっと 組み込みたいという要求が出てくるので, + どこかで制限を引かなくてはならないため. (そうしなければ + FreeBSD の配布物は, + とてつもなく膨大になってしまうでしょう.)</para> + </listitem> + </orderedlist> + + <para>すべての人が自分のお気に入りの + プログラムを手作業で移植しなければ ならないとしたら, + (途方もない膨大な作業の繰り返しをさておいたとしても) + それは明らかに不合理な話です. そこで, FreeBSD プロジェクトでは, + 標準のツールを使って移植のプロセスを + 自動化する巧妙な方法を考え出しました.</para> + + <para>なお, + これは単純ながら非常に柔軟なツールを組み合わせることで, + 非常に強力な働きをさせるという“Unix + 流”の作業の優れた実例です.</para> + </sect1> + + <sect1> + <title>ports コレクションはどのように動くのでしょうか?</title> + + <para>インターネットでは通常, <link + linkend="ports-tarball">tarball</link> の形で + プログラムが配布されています. これは, Makefile + とソースコードで構成され, 普通は何らかの説明書 (あいにく, + いつもわかりやすく書かれているとは 限りませんが) + が付属しています. ことによるとコンフィグレーションスクリプトも + 含まれているかもしれません.</para> + + <para>標準的な手順では, FTP で tarball を入手して, + 適当なディレクトリで展開します. 次に説明書を読んで, + 必要な変更をおこないます. そして, 設定スクリプトを実行し, 標準の + <command>make</command> + コマンドを使ってソースのコンパイルとインストールを + おこないます.</para> + + <para>FreeBSD の ports も tarball の仕組みを利用していますが, + これはユーザが 苦労して作業することを期待したものではなく, + どのようにすれば FreeBSD 上で + そのプログラムが動くようになるかという「ノウハウ」を <link + linkend="ports-skeleton">スケルトン</link> + を使用して収めているものです. スケルトンは, カスタマイズ済みの + <link linkend="ports-makefile">Makefile</link> も + 提供していますので, ほとんどすべての ports + は同じ手順でインストールすることが できます.</para> + + <para>もしあなたが (<ulink + URL="file://localhost/usr/ports/devel/ElectricFence">あなたの + FreeBSD システム</ulink> または <ulink + URL="ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/devel/ElectricFence"> + FTP サイト</ulink> にある) ports スケルトンを見ていて, + そこに潜んでいる あらゆる種類の先端的な + ロケット工学的なものを見つけられると期待していると, + つまらなそうなファイルやディレクトリがそこにあるだけなのを見て, + がっかりするかもしれません. + (ports を手に入れる方法については, すぐに + <link linkend="ports-getting">FreeBSD ports コレクションの入手方法 + </link> の節でお話します.)</para> + + <para>“一体どうしたらいいんだ? ここにはソースコードが + ないじゃないか?” + というあなたの叫びが聞こえるようです.</para> + + <para>心配いりません. おとなしく読んでいけば, すべてが (たぶん) + 明らかに なるでしょう. 試しに ports をインストールして, + 何が起きるのかを見てみましょう. + ここではサンプルとして開発者向けの便利なツール, + <application>ElectricFence</application> を選択します. + このスケルトンを選んだ理由は, 他の ports + に比べても素直で理解しやすく 書かれているからです.</para> + + <note> + <para>自宅で試してみる場合には, root + になる必要があるでしょう.</para> + </note> + + <!-- kuriyama - remove informalexample --> + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports/devel/ElectricFence</userinput> +&prompt.root; <userinput>make install</userinput> +>> Checksum OK for ElectricFence-2.0.5.tar.gz. +===> Extracting for ElectricFence-2.0.5 +===> Patching for ElectricFence-2.0.5 +===> Applying FreeBSD patches for ElectricFence-2.0.5 +===> Configuring for ElectricFence-2.0.5 +===> Building for ElectricFence-2.0.5 +[大量のメッセージをコンパイラが出力します...] +===> Installing for ElectricFence-2.0.5 +===> Warning: your umask is "0002". + If this is not desired, set it to an appropriate value + and install this port again by ``make reinstall''. +install -c -o bin -g bin -m 444 /usr/ports/devel/ElectricFence/work/ElectricFence-2.0.5/libefence.a /usr/local/lib +install -c -o bin -g bin -m 444 /usr/ports/devel/ElectricFence/work/ElectricFence-2.0.5/libefence.3 /usr/local/man/man3 +===> Compressing manual pages for ElectricFence-2.0.5 +===> Registering installation for ElectricFence-2.0.5</screen> + </informalexample> + + <para>ここではあなたが混乱しないように, コンパイル時の出力を + すべて取り除いてあります.</para> + + <para>もしもあなた自身で実行されたら, 最初にこのような + 出力結果が得られるはずです:-</para> + + <informalexample id="ports-fetch"> + <screen>&prompt.root; <userinput>make install</userinput> +>> ElectricFence-2.0.5.tar.gz doesn't seem to exist on this system. +>> Attempting to fetch from ftp://ftp.doc.ic.ac.uk/Mirrors/sunsite.unc.edu/pub/Linux/devel/lang/c/.</screen> + </informalexample> + + <para><command>make</command> プログラムは, + あなたの手元にソースコードがないことを検出し, + 処理を続けられるようにソースを FTP でダウンロードしようとします. + この例では, あらかじめ手動でソースコードを用意してあったので, + 持ってくる必要はありませんでした.</para> + + <para>では, 続けて <command>make</command> + プログラムが何をしているのか見てみましょう.</para> + + <procedure> + <step> + <para>ソースコード <link + linkend="ports-tarball">tarball</link> のありかを + 確認します. 手元にファイルが存在しなければ, FTP + サイトから入手しようとします.</para> + </step> + + <step> + <para><link linkend="ports-checksum">チェックサム</link> + テストを実行して, その tarball + が事故か何かで途中で切れていたり, ASCII モードで + ダウンロードされていたり, + 転送中にニュートリノによって傷められたりして + 改変されたりしていないかどうかを確認します.</para> + </step> + + <step> + <para>tarball を一時的な作業用ディレクトリに展開します.</para> + </step> + + <step> + <para>FreeBSD 上でコンパイルしたり, 動作させるのに必要な + すべての <link linkend="ports-patch">パッチ</link> + をソースコードに当てます.</para> + </step> + + <step> + <para>構築のために必要な + コンフィグレーションスクリプトを実行します. + コンフィグレーションスクリプトの + 質問には正確に答えてください.</para> + </step> + + <step> + <para>(いよいよ!) ソースコードをコンパイルします.</para> + </step> + + <step> + <para>実行形式のプログラム, マニュアル, + その他のサポートファイルを, + システムのプログラムと混ざってしまわないように + <filename>/usr/local</filename> 以下に インストールします. + ports はすべて同じ場所にインストールされ, + システムのあちこちにばらまかれることはありません.</para> + </step> + + <step> + <para>インストール結果はデータベースに登録されます. + これにより, + インストールしたプログラムがもしも気に入らなかったときも, + システムから すべての痕跡をきれいに <link + linkend="ports-remove">消去</link> + することができます.</para> + </step> + </procedure> + + <para>以上のステップが <command>make</command> + の出力と一致しているかどうか確認してください. + 今まで確認していなかったのなら, + 今からするようにしてください!</para> + </sect1> + + <sect1 id="ports-getting"> + <title>FreeBSD ports コレクションの入手</title> + + <para>あるプログラムの FreeBSD port + を入手するには二つの方法があります. ひとつは <link + linkend="ports-cd">FreeBSD CD-ROM</link> を使う方法で, + もうひとつは <link + linkend="ports-inet">インターネット接続</link> + を使う方法です.</para> + + <sect2 id="ports-cd"> + <title>CD-ROM からコンパイルする</title> + + <para>FreeBSD CD-ROM がドライブに入っており, + <filename>/cdrom</filename> にマウントされていると仮定すると + (マウントポイントが <filename>/cdrom</filename> + である必要があります), ただ普通に実行するだけで ports + を構築できるようになり, tarball + をネットワーク経由でダウンロードするのではなく + <filename>/cdrom/ports/distfiles/</filename> + からさがすようになります (そこにあればの話ですが).</para> + + <para>CD-ROM にある port スケルトンを使いたければ, 他に + <filename>/etc/make.conf</filename> の + 変数を以下のようにセットする方法があります:</para> + + <programlisting> +PORTSDIR= /cdrom/ports +DISTDIR= /tmp/distfiles +WRKDIRPREFIX= /tmp</programlisting> + + <para>(任意の十分な空きスペースの場所を <literal>/tmp</literal> + とおいています). + 次に, <filename>/cdrom/ports</filename> 下の適宜のサブディレクトリに + <command>cd</command> して, 例のごとく + <command>make install</command> とタイプします. + <makevar>WRKDIRPREFIX</makevar> は port に + <filename>/tmp/cdrom/ports</filename> の下でビルドさせようとします; + 例えば, <filename>games/oneko</filename> は + <filename>/tmp/cdrom/ports/games/oneko</filename> の下で + ビルドされるでしょう. + </para> + + <para>ライセンスの制限により, いくつかの ports + でオリジナルのソースコードを CD-ROM + に入れることができなかったものがあることに注意してください. + この場合, <link linkend="ports-inet">インターネット経由で + ports をコンパイルする</link> の + 節を参照してください.</para> + </sect2> + + <sect2 id="ports-inet"> + <title>インターネット経由で ports をコンパイルする</title> + + <para>CD-ROM を持っていなかったり, その ports + の最新バージョンを確実に入手したい 場合は, その ports の <link + linkend="ports-skeleton">スケルトン</link> を + ダウンロードする必要があります. ところで, これは落し穴が + たくさんある作業に見えるかもしれませんが, + 実際には非常に簡単です.</para> + + <para>初めに, あなたの動かしている FreeBSD + がリリースバージョンなら <ulink + url="http://www.freebsd.org/ports/">ports ページ </ulink> + でその FreeBSD 用の “アップグレードキット” + を手にいれてください. このパッケージには, 最新の ports + をコンパイルするのに必要な, + リリース以降に更新されたファイルが含まれています.</para> + + <para>FreeBSD の FTP サーバーがその場で <link + linkend="ports-tarball">tarball</link> + を作成できることを利用してスケルトンを入手すると + 非常に便利です. ここでは例として databases ディレクトリにある + gnats プログラムを使って説明します. + (角型かっこの中の文はコメントなので, 実際に実行する場合には, + これをタイプしないでください!):-</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports</userinput> +&prompt.root; <userinput>mkdir databases</userinput> +&prompt.root; <userinput>cd databases</userinput> +&prompt.root; <userinput>ftp ftp.freebsd.org</userinput> +[ユーザ名 `ftp' でログインし, パスワードを要求されたら, あなたの電子メール +アドレスを入力してください. バイナリモードを (イメージモードと呼ばれることも +あります) 使うのをお忘れなく!] +<prompt>></prompt> <userinput>cd /pub/FreeBSD/ports/ports/databases</userinput> +<prompt>></prompt> <userinput>get gnats.tar</userinput> +[gnats スケルトンの tarballs を取得] +<prompt>></prompt> <userinput>quit</userinput> +&prompt.root; <userinput>tar xf gnats.tar</userinput> +[gnats スケルトンの展開] +&prompt.root; <userinput>cd gnats</userinput> +&prompt.root; <userinput>make install</userinput> +[gnats の構築とインストール]</screen> + </informalexample> + + <para>さて何が起きるでしょうか? FTP + サイトにいつも通りに接続して, データベースの + サブディレクトリに移動します. <command>get gnats.tar</command> + とコマンドを入力すると, FTP サイトでは gnats ディレクトリを + <link linkend="ports-tarball">tarred</link> + にしてくれるのです.</para> + + <para>gnats スケルトンを展開したら, gnats ディレクトリへ移動して + ports を構築します. <link linkend="ports-fetch">すでに</link> + 説明したように, make の過程で + 手元にソースコードがないことを検出すると, + ソースコードを取得してから 展開し, + パッチ当てと構築をおこないます.</para> + + <para>それでは, 少し冒険をしてみましょう. 一つの ports + スケルトンを 取得するかわりに, たとえば ports + コレクションの中のデータベースの スケルトンをすべて, + サブディレクトリ全体を取得してみましょう. + やり方はほとんど同じです:-</para> + + <para> + <literallayout> &prompt.root; cd /usr/ports + &prompt.root; ftp ftp.freebsd.org + [ユーザ名 `ftp' でログインし, パスワードを要求されたら, あなたの電子メール +アドレスを入力してください. バイナリモードを (イメージモードと呼ばれることも +あります) 使うのをお忘れなく!] + > cd /pub/FreeBSD/ports/ports + > get databases.tar [データベースディレクトリの tarballs を取得] + > quit + &prompt.root; tar xf databases.tar [すべてのスケルトンを展開] + &prompt.root; cd databases + &prompt.root; make install [データベース ports 全部の構築とインストール] </literallayout> + </para> + <!-- kuriyama - literallayout? --> + + <para>わずかばかりの簡単なコマンドで, この FreeBSD + マシン上にデータベース + プログラムを一揃い手に入れてしまいました! 一つの ports + スケルトンを取ってきて それを構築する場合との違いは, + すべてのディレクトリを一度に取得して, + 全部を一度にコンパイルしたということだけです. + かなり感動的だと思いませんか?</para> + + <para>たくさんの ports をインストールする つもりなら, + おそらくすべての ports ディレクトリをダウンロードしておく + 価値があるでしょう.</para> + </sect2> + </sect1> + + <sect1 id="ports-skeleton"> + <title>スケルトン</title> + + <para>スケルトン (訳注: skeleton とは骸骨のことです) とは, + 締め切りを守るため, 食事をするのを忘れるほど仕事にのめり込んだ + ハッカーたちのなれの果ての ことでしょうか? FreeBSD + の屋根裏に潜む, なにか気持ちの悪いものでしょうか? いいえ, + ここでスケルトンの意味するところは, ports の魔術を実現するのに + 必要とされるすべてのものを提供する最小の骨組みのことです.</para> + + <sect2 id="ports-makefile"> + <title><filename>Makefile</filename></title> + + <para>スケルトンのもっとも重要な要素は Makefile です. Makefile + は ports を どのようにコンパイルし, + インストールをおこなうかを指示する + いろいろな命令を含んでいます. 以下に ElectricFence の Makefile + を示します:-</para> + + <programlisting> +# New ports collection makefile for: Electric Fence +# Version required: 2.0.5 +# Date created: 13 November 1997 +# Whom: jraynard +# +# $Id$ +# + +DISTNAME= ElectricFence-2.0.5 +CATEGORIES= devel +MASTER_SITES= ${MASTER_SITE_SUNSITE} +MASTER_SITE_SUBDIR= devel/lang/c + +MAINTAINER= jraynard@freebsd.org + +MAN3= libefence.3 + +do-install: + ${INSTALL_DATA} ${WRKSRC}/libefence.a ${PREFIX}/lib + ${INSTALL_MAN} ${WRKSRC}/libefence.3 ${PREFIX}/man/man3 + +.include <bsd.port.mk></programlisting> + + <para>"#" で始まる行は, 人間のためのコメント行です. + (ほとんどの Unix のスクリプトと同じですね.)</para> + + <para><literal>DISTNAME</literal> は <link + linkend="ports-tarball">tarball</link> + の名前から拡張子を取ったものです.</para> + + <para><literal>CATEGORIES</literal> + はこのプログラムの種類を示します. この場合, + 開発者向けのユーティリティということになります. + 完全なリストはこのハンドブックの <link + linkend="porting-categories">カテゴリ</link> + をみてください.</para> + + <para><literal>MASTER_SITES</literal> はマスタ FTP サイトの URL + です. もしローカルシステムに <link + linkend="ports-tarball">tarball</link> がない場合には, + ここから取得します. これは信頼できると考えられているサイトで, + 通常はそのプログラムを + インターネット上で公式に配布しているサイトです. + (そのソフトウェアがインターネット上で「公式に」 + 配布されているとしたら)</para> + + <para><literal>MAINTAINER</literal> は, + 例えば新しいバージョンのプログラムが出た場合に, 必要であれば + スケルトンの更新をおこなう保守担当者の + 電子メールアドレスです.</para> + + <para>次の数行はとりあえず飛ばします. + + <literal>.include <bsd.port.mk></literal> + + この行は, この ports に必要なその他の命令やコマンドは + <filename>bsd.port.mk</filename> に + 入っているということを示しています. + これらはすべての ports で共通のものなので, + それぞれの Makefile に書いておく必要はありません. + そのため単一の標準ファイルに + まとめられているのです.</para> + + <para>ここでは Makefile + がどう働くかを詳細に調査するのが目的ではありませんので, + <literal>MAN3</literal> で始まる行は, インストールの後に + ElectricFence のマニュアルを 圧縮するために使用される, + と言っておくだけで充分でしょう. これにより, + 貴重なディスクスペースが保護されているわけです. オリジナルの + port では <maketarget>install</maketarget> + ターゲットが用意されていないので, + <maketarget>do-install</maketarget> からの 3 行が この ports + によって生成されたファイルを + 正しい場所に置くために使用されます.</para> + </sect2> + + <sect2> + <title><filename>files</filename> ディレクトリ</title> + + <para>ports のチェックサム算出には MD5 + アルゴリズムを使用しているので, この <link + linkend="ports-checksum">チェックサム</link> を含んでいる + ファイルは <filename>md5</filename> と呼ばれます. + ちょっと混乱するかもしれませんが, このファイルは + <filename>files</filename> という + 名前のディレクトリに置かれています.</para> + + <para>このディレクトリは, ports に必要だけれども, + 他のどこにも属さない 雑多なファイルも含んでいます.</para> + </sect2> + + <sect2> + <title><filename>patches</filename> ディレクトリ</title> + + <para>このディレクトリには, FreeBSD + ですべてを正常に動作させるのに 必要な <link + linkend="ports-patch">パッチ</link> が含まれています.</para> + </sect2> + + <sect2> + <title><filename>pkg</filename> ディレクトリ</title> + + <para>このディレクトリには, + 非常に役立つ三つのファイルが含まれています:-</para> + + <itemizedlist> + <listitem> + <para><filename>COMMENT</filename> — + プログラムについての 1 行の説明.</para> + </listitem> + + <listitem> + <para><filename>DESCR</filename> — より詳細な説明.</para> + </listitem> + + <listitem> + <para><filename>PLIST</filename> — + プログラムのインストール時に作成される, + すべてのファイルのリスト.</para> + </listitem> + </itemizedlist> + </sect2> + </sect1> + + <sect1 id="ports-troubleshooting"> + <title>ports が動かないのですが, どうしたらよいでしょう</title> + + <para>おやおや. では, 次の四つのどれかをやってみてください:</para> + + <orderedlist> + <listitem> + <para>自分で修正する. ports + の仕組みに関する技術的な詳細については, <link + linkend="porting"> + アプリケーションの移殖方法</link>をご覧ください.</para> + </listitem> + + <listitem> + <para>苦情をいう. これは電子メールで <emphasis>だけ</emphasis> + にしてください! このようなメールの宛先は &a.ports; です. + なお, 必ず port の名前やバージョン, その port のソースや + distfile(s) を どこから入手したか, + どんなエラーが発生したのかを書いておいてください.</para> + </listitem> + + <listitem> + <para>忘れてしまう. これはほとんどの場合最も簡単な方法です. + ports + のプログラムのうち必要不可欠な物はごくわずかです.</para> + </listitem> + + <listitem> + <para>FTP サイトからコンパイル済みのパッケージを入手する. + “マスター”パッケージコレクションは FreeBSD の + FTP サイトの <ulink + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/"> + パッケージディレクトリ</ulink> に置いてありますが, + まずあなたの近くのローカルミラーサイトを確認してください! + ソースからのコンパイルに挑戦するよりも, + パッケージを使うほうが (全体的に見て) + ずっと確実に動作するでしょうし, + より手っ取り早い方法でもあります. + システムにパッケージをインストールするには, &man.pkg.add.1; + を使ってください.</para> + </listitem> + </orderedlist> + </sect1> + + <sect1> + <title>質問と回答集</title> + + <itemizedlist> + <listitem> + <para>Q. 私はモデムについての議論を + しているのかと思っていました??!</para> + + <para>A.なるほど, あなたはきっとコンピュータの背面についている + シリアルポートのことだと思ってしまったのでしょう. + あるバージョンの Unixから別のバージョンの Unix + へとプログラムを 移殖することを “porting” + というのですが, ここで我たちは “porting” の結果 + という意味で “port” を使っています. + (コンピュータに関わる人々の悪しき習慣として, + ひとつの同じ言葉を複数の + まったく違う意味として使うことがあるのです.)</para> + </listitem> + + <listitem> + <para>Q. 私は, 標準以外のプログラムのインストールには packages + を使うと 思っていたのですが.</para> + + <para>A. そのとおり. 通常は packages + が最も手早くて簡単な方法です.</para> + </listitem> + + <listitem> + <para>Q. それではどうして面倒な ports があるのですか?</para> + + <para>A. いくつかの理由があります:-</para> + + <orderedlist> + <listitem> + <para>いくつかのソフトウェアのライセンス条件には, + バイナリではなくソースコードでの + 配布を求めているものがあります.</para> + </listitem> + + <listitem> + <para>バイナリ配布を信用していない人もいます. + 少なくともソースコード があれば, ソースコードを読んで, + (理論的には) 潜在的な問題点を自分で + 見つけ出すこともできるはずです.</para> + </listitem> + + <listitem> + <para>ローカルなパッチを入手した場合, + それを自分で追加するために + ソースコードが必要になります.</para> + </listitem> + + <listitem> + <para>プログラムがいかにコンパイルされるべきかについて, + あなたはパッケージを作った人とは + 異なる見解を持っているかもしれません. + どんな最適化オプションをつけるべきかとか, + デバッグバージョンを作ってから それを strip + するべきだとか, いや, そうするべきでない, などなど, + 確固たる見解を持っている人もいるでしょう.</para> + </listitem> + + <listitem> + <para>ソースコードを手元に置いておきたい人たちもいます. + 彼らは, 退屈したときに眺めたり, あちこち解析してみたり, + ソースコードを 借用したり (もちろん, + ライセンスが許せばの話ですが) するのです.</para> + </listitem> + + <listitem> + <para>あなたがソースコードを持っていなければ, + それはソフトウェアとは 言えませんね! <!-- smiley + -->;-)</para> + </listitem> + </orderedlist> + </listitem> + + <listitem> + <para><anchor id="ports-patch"> + Q. パッチとは何ですか?</para> + + <para>A. パッチとは, + あるバージョンから他のバージョンへどのように変更するかを + 示す, (通常は) 小さなファイルです. “23 + 行目を削除”, “468 行目の後に これらの 2 + 行を追加”, または“197 + 行目をこのように変更”というような 内容を含んでいます. + これは, “diff” + という名前のプログラムで生成されます.</para> + </listitem> + + <listitem> + <para><anchor id="ports-tarball"> + Q. tarball とは一体何ですか?</para> + + <para>A. <filename>.tar</filename> または + <filename>.tar.gz</filename> という拡張子を持つファイルです. + (<filename>.tar.Z</filename> のようなバリエーションも + ありますし, DOS のファイルシステム用に + <filename>.tgz</filename> + と短縮される場合もあります.)</para> + + <para>これは基本的に, 一つのファイルに固めた + (<filename>.tar</filename>) ディレクトリツリーです. + 圧縮されている (<filename>.gz</filename>) 場合もあります. + これは元々 <emphasis>T</emphasis>ape + <emphasis>AR</emphasis>chives (訳注: テープアーカイブ) + (このため <command>tar</command> という名前なのです) + で使われていたものなのですが, + インターネット上でプログラムのソースコードを配布するために + 広く使われている方法です.</para> + + <para>これらのファイルの中身を見たり, + 展開したりすることもできます. FreeBSD + の基本システムに付属する Unix 標準の tar + コマンドを使ってみると 次のようになります:-</para> + + <informalexample> + <screen>&prompt.user; <userinput>tar tvzf foobar.tar.gz</userinput> +&prompt.user; <userinput>tar xzvf foobar.tar.gz</userinput> +&prompt.user; <userinput>tar tvf foobar.tar</userinput> +&prompt.user; <userinput>tar xvf foobar.tar</userinput> + </screen> + </informalexample> + </listitem> + + <listitem> + <para><anchor id="ports-checksum"> + Q. チェックサムとは何ですか?</para> + + <para>A. これは, + チェックしたいファイル中のすべてのデータを加えて生成した + 数値です. 何か文字が書き換わっていたら, + チェックサムが一致しなくなります. そのため, + 単純な比較だけで違いを見つけることができるのです. + (実際には, 文字の位置が入れ替わるなどの, + 単純な加算ではわからない問題も + 見つけることができる複雑な方法で計算されています.)</para> + </listitem> + + <listitem> + <para>Q. 私は, <link linkend="ports-cd">CD-ROM から ports + をコンパイルする</link> にしたがって ports + をインストールしていました. kermit + をインストールしようとするまではうまくいっていました:-</para> + + <informalexample> + <screen>&prompt.root; <userinput>make install</userinput> +>> cku190.tar.gz doesn't seem to exist on this system. +>> Attempting to fetch from ftp://kermit.columbia.edu/kermit/archives/.</screen> + </informalexample> + + <para>なぜ cku190.tar.gz が見つからないのでしょうか? 不良品の + CD-ROM を買ってしまったのでしょうか?</para> + + <para>A. Kermit の権利を持つチームは, 私たちの CDROM に kermit + の tarball を 入れることを許可しませんでした. + 申し分けありませんが, 手動でファイルを 入手してください. + このようなエラーメッセージが出たのは, + あなたがそのときインターネットに 接続していなかったためです. + あらかじめ上記のサイトのいずれかからファイルを + ダウンロードしておけば, プロセスを再開することができます. + (ダウンロードの際には, + あなたに最も近いサイトを選ぶようにしてください. そうすれば, + 時間とインターネットの帯域の節約になります)</para> + </listitem> + + <listitem> + <para>Q. kermit の tarball を入手しましたが, + <filename>/usr/ports/distfiles</filename> に + ファイルを置こうとすると, + 書き込み権がないというエラーがでます.</para> + + <para>A. ports のしくみは + <filename>/usr/ports/distfiles</filename> から tarball + を探します. しかし, これは read-only の CD-ROM + へのシンボリックリンクなので, + ここにファイルを置くことはできません. 次のようにすれば, + 他の場所を探すよう ports に指示することができます.</para> + + <informalexample> + <screen>&prompt.root; <userinput>make DISTDIR=/where/you/put/it install</userinput></screen> + </informalexample> + </listitem> + + <listitem> + <para>Q. ports では, すべてを <filename>/usr/ports</filename> + に置いたときだけ動作するのでしょうか? + システムの管理者によると, 私の個人的なファイルは + <filename>/u/people/guests/wurzburger</filename> + に入れなければならないのですが, これでは + うまくいかないように思います.</para> + + <para>A. <makevar>PORTSDIR</makevar> 変数と + <makevar>PREFIX</makevar> 変数を変更することで, + 違うディレクトリを 使用することができます. 例えば,</para> + + <informalexample> + <screen>&prompt.root; <userinput>make PORTSDIR=/u/people/guests/wurzburger/ports install</userinput></screen> + </informalexample> + + <para>とすると, ports は + <filename>/u/people/guests/wurzburger/ports</filename> + でコンパイルされ, すべて <filename>/usr/local</filename> + 以下にインストールされます.</para> + + <informalexample> + <screen>&prompt.root; <userinput>make PREFIX=/u/people/guests/wurzburger/local install</userinput></screen> + </informalexample> + + <para>この場合, コンパイルは <filename>/usr/ports</filename> + でおこない, + <filename>/u/people/guests/wurzburger/local</filename> + にインストールします. もちろん, + 以下のように両者を組み合わせることも可能です.</para> + + <informalexample> + <screen>&prompt.root; <userinput>make PORTSDIR=.../ports PREFIX=.../local install</userinput></screen> + </informalexample> + + <para>(省略せずに記述したら, + このページに収めるには長すぎるのですが, + 考え方は理解していただけたと思います)</para> + + <para>もし ports をインストールするたびに, + これらを毎回タイプするのが 気に入らないのであれば, + (正直に言って, 誰もそう思わないでしょう) + これらを環境変数にセットしてしまうという手があります.</para> + </listitem> + + <listitem> + <para>Q. 私は, FreeBSD の CD-ROM を持っていませんが, + 私はすべての tarball を 私のシステムに置いておきたいのです. + そうすれば, 私は ports をインストール するたびに, + 毎回ダウンロードが終わるのを待たなくてすむでしょう. + これを一度におこなう簡単な方法はありませんか?</para> + + <para>A. ports コレクション全体の tarball を持ってくるには, + 次のようにしてください.</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports</userinput> +&prompt.root; <userinput>make fetch</userinput></screen> + </informalexample> + + <para>ports の下のディレクトリひとつの tarball + を持ってくるには, 次のように してください.</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports/directory</userinput> +&prompt.root; <userinput>make fetch</userinput></screen> + </informalexample> + + <para>ports をひとつだけ持ってくる方法は, + きっと既にご存知だと思います.</para> + </listitem> + + <listitem> + <para>Q. マスタ FTP サイトから tarball を持ってくるより, + 近くにある FreeBSD の + ミラーサイトから持ってきた方が速いはずです. MASTER_SITES + に書かれている サイト以外から持ってくるように ports + に指示する方法はありませんか?</para> + + <para>A. もちろんあります. 例えば <hostid + role="fqdn">ftp.FreeBSD.ORG</hostid> が + <makevar>MASTER_SITES</makevar> に書かれている + サイトより近いとしたら, 以下のようにしてください.</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports/directory</userinput> +&prompt.root; <userinput>make MASTER_SITE_OVERRIDE=ftp://ftp.FreeBSD.ORG/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen> + </informalexample> + </listitem> + + <listitem> + <para>Q. ダウンロードをする前に, + どんなファイルが必要なのか知りたいのですが.</para> + + <para>A. <command>make fetch-list</command> とすると, ports + に必要なファイルの一覧を表示できます.</para> + </listitem> + + <listitem> + <para>Q. ports のコンパイルを途中で止める方法はありますか? + 私はインストールをする前に + いろいろとソースコードを解析したいのですが, 毎回 control-C + を打たなければならないのが少し面倒です.</para> + + <para>A. <command>make extract</command> を実行すると, + ファイル転送とソースコードの展開まで + おこなったところで停止します.</para> + </listitem> + + <listitem> + <para>Q. 自分で ports を作ろうとしています. 私の作ったパッチが + 正しく処理できることを確認できるように, + コンパイルを止めたいのです. パッチのための <command>make + extract</command> のようなものはありませんか?</para> + + <para>A. あります. <command>make patch</command> + があなたのお望みのものです. おそらく + <makevar>PATCH_DEBUG</makevar> オプションも同様に + お役に立つことでしょう. ところで, + あなたの努力に感謝いたします!!</para> + </listitem> + + <listitem> + <para>Q. あるコンパイルオプションはバグの + 原因になるという話を聞きました. 本当なのでしょうか? + どうやったら正しい設定で ports + をコンパイルできますか?</para> + + <para>A. 本当です. <command>gcc</command> の バージョン 2.6.3 + (FreeBSDの 2.1.0 と 2.1.5 に付属している バージョン) では, + <option>-O2</option> オプションを + <option>-fno-strength-reduce</option> オプションなしで + 使うと, バグのあるコードを出力します (ほとんどの ports は + <option>-O2</option> オプションを 使いません). + コンバイラオプションは次のように定義 <emphasis> すべき + </emphasis> です.</para> + + <informalexample> + <screen>&prompt.root; <userinput>make CFLAGS='-O2 -fno-strength-reduce' install</userinput></screen> + </informalexample> + + <para>これを <filename>/etc/make.conf</filename> + に書いておくこともできますが, 残念なことに すべての ports + がこの指定を尊重してくれる 訳ではありません. + もっとも確実なのは <command>make configure</command> + を実行し, ソースディレクトリの Makefile + を見て手で修整することですが, ソースが + 多くのサブディレクトリにわかれていて, 各々に Makefile + がある場合は 大変な仕事になります.</para> + </listitem> + + <listitem> + <para>Q. ports がたくさんありすぎて, + 私の欲しいものがなかなか見つけられません. どんな ports + が使えるのか, リストはどこかにありませんか?</para> + + <para>A. <filename>/usr/ports</filename> の中にある + <filename>INDEX</filename> ファイルを見てみましょう. + あるキーワードで ports コレクションを検索したければ, + それも可能です. たとえば, + 以下のようにすればプログラミング言語 LISP に関連した ports + を見つけることができます: </para> + + <screen>&prompt.user; <userinput>cd /usr/ports</userinput> +&prompt.user; <userinput>make search key=lisp</userinput></screen> + </listitem> + + <listitem> + <para>Q. <literal>foo</literal> ports + をインストールしたいのですが, それのコンパイルは + すぐに停止して, <literal>bar</literal> ports + のコンパイルが始まってしまいます. 一体どうして?</para> + + <para>A. <literal>foo</literal> ports が, + <literal>bar</literal> ports + の提供する何らかの機能を必要としているからです. 例えば + <literal>foo</literal> が画像を使うとすると, + <literal>bar</literal> は画像処理に必要な + ライブラリを持っている, などです. または, + <literal>bar</literal> は <literal>foo</literal> + をコンパイルするのに必要なツールなのかもしれません.</para> + </listitem> + + <listitem> + <para><anchor id="ports-remove"> Q. ports から + <literal>grizzle</literal> + プログラムをインストールしましたが, まったく + ディスクスペースの浪費です. 削除したいのですが, + すべてのファイルが どこへインストールされたのかわかりません. + 何か手がかりはありませんか?</para> + + <para>A. 大丈夫, 次のようにしてください.</para> + + <informalexample> + <screen>&prompt.root; <userinput>pkg_delete grizzle-6.5</userinput></screen> + </informalexample> + </listitem> + + <listitem> + <para>Q. ちょっと待ってください. + 削除しようとするコマンドのバージョン番号を + 知っていなくてはならないのでしょうか? あなたは, + 私がバージョン番号を + 覚えていることを本気で当てにしているのでしょうか?</para> + + <para>A. そんなことはありません. + バージョン番号は次のようにすればわかります.</para> + + <informalexample> + <screen>&prompt.root; <userinput>pkg_info -a | grep grizzle</userinput> +Information for grizzle-6.5: +grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arcade game.</screen> + </informalexample> + </listitem> + + <listitem> + <para>Q. ディスク容量のことなのですが, ports + のディレクトリは非常に膨大な容量を 使うように見えます. + 残しておいた方がよいのでしょうか? 削除してしまっても + よいのでしょうか?</para> + + <para>A. はい. インストールが首尾よく終わり, + もうソースコードが必要でないと思うなら, + それらを残しておく理由はないでしょう. 一番よい方法は, + 次の通りです.</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports</userinput> +&prompt.root; <userinput>make clean</userinput></screen> + </informalexample> + + <para>これは, すべての ports のサブディレクトリを調べ, 各 + ports のスケルトン以外の削除をおこないます.</para> + </listitem> + + <listitem> + <para>Q. これを試してみたのですが, tarball や ports + で使われたファイルが <filename>distfiles</filename> + ディレクトリに残っています. + これも削除してしまっても大丈夫ですか?</para> + + <para>A. はい. それを使った作業が終わったのであれば, + 削除してしまっても大丈夫です.</para> + </listitem> + + <listitem> + <para>Q. + 私はとてもとてもたくさんのプログラムを楽しみたいのです. + 一度にすべての ports + をインストールする方法はありませんか?</para> + + <para>A. 次のようにしてください.</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports</userinput> +&prompt.root; <userinput>make install</userinput></screen> + </informalexample> + </listitem> + + <listitem> + <para>Q. やってみました. 時間がとてもかかるだろうと思ったので, + そのまま実行を 続けさせて, 私は寝ました. + 翌朝コンピュータを見てみると, 三つ半の ports しか + 処理が終わっていませんでした. + なにか悪かったのでしょうか?</para> + + <para>A. これは ports の中には私たちの決められないこと + (例えば, あなたが A4 の 用紙に印刷したいのか, US + レターサイズの用紙に印刷したいのかなど) について + 質問してくるものがあるからです. + それらの質問には手動で答える必要があります.</para> + </listitem> + + <listitem> + <para>Q. + 私は一日中モニタの前に座って過ごしたりしたくないのですが. + 何かよいアイデアはありませんか?</para> + + <para>A. では, あなたが寝に / 仕事に / + 公園にいく前に以下を実行してください:-</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports</userinput> +&prompt.root; <userinput>make -DBATCH install</userinput></screen> + </informalexample> + + <para>これでユーザの入力を要求しないすべての ports + をインストールします. そして, 戻ってきてから, + 次のように実行してください.</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports</userinput> +&prompt.root; <userinput>make -DIS_INTERACTIVE install</userinput></screen> + </informalexample> + + <para>そして, 残りの作業を実行してください.</para> + </listitem> + + <listitem> + <para>Q. 私たちは ports コレクションにある + <literal>frobble</literal> を使っています. ですが, + 私たちの必要に応じて ports を変更したところがあるのです. + 自分でパッケージを作って, それを私たちのサイトのまわりに + 簡単に配布できるような方法がありますか?</para> + + <para>A. もちろんあります. + 変更点をパッチにする方法は知っていますよね:-</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports/somewhere/frobble</userinput> +&prompt.root; <userinput>make extract</userinput> +&prompt.root; <userinput>cd work/frobble-2.8</userinput> +[あなたのパッチを当ててください] +&prompt.root; <userinput>cd ../..</userinput> +&prompt.root; <userinput>make package</userinput></screen> + </informalexample> + </listitem> + + <listitem> + <para>Q. この ports の技術は本当に賢いですね. + どのようにして動いているのか + 私はどうしても知りたいと思います. その秘密は何ですか?</para> + + <para>A. 秘密は一切ありません. <ulink + URL="file://localhost/usr/share/mk/">Makefiles + ディレクトリ</ulink> にある + <filename>bsd.ports.mk</filename> と + <filename>bsd.ports.subdir.mk</filename> + ファイルを見るだけです.</para> + + <note> + <para>複雑なシェルスクリプトを嫌う読者は, + このリンクを追いかけないほうが よいでしょう.</para> + </note> + </listitem> + </itemizedlist> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/books/porters-handbook/book.sgml b/ja_JP.eucJP/books/porters-handbook/book.sgml new file mode 100644 index 0000000000..0bae98ef4c --- /dev/null +++ b/ja_JP.eucJP/books/porters-handbook/book.sgml @@ -0,0 +1,1139 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.9 + $Id: book.sgml,v 1.1.1.1 1999-04-08 15:45:59 kuriyama Exp $ +--> + +<chapter id="ports"> + <title>アプリケーションのインストール : ports コレクション</title> + + <para><emphasis>原作: &a.jraynard;.</emphasis></para> + + <para><emphasis>訳: &a.jp.masaki;, &a.jp.saeki;.<!-- <br> --> + 11 November 1996.</emphasis></para> + + <para>FreeBSD の ports コレクションを利用すると, 最小限の労力で + 非常に幅広くのアプリケーションのコンパイルとインストールがおこなえます.</para> + + <para>やってみたことのある方はよくご存知でしょうが, + オープンな規格とは 全くの誇大広告であって, + あるプログラムを異なるバージョンの Unix 上で + 動作させることは退屈で手間のかかる仕事です. + 求めているプログラムが自分のシステムでうまくコンパイルでき, + 正しいところにインストールできて, + 完璧に動作するとしたらとてもラッキーです. しかし, + あいにくこれは滅多にないことなのです. + ほとんどのプログラムについて, + あなたは髪を掻きむしることになるでしょうし, + かなりのプログラムでは, 白髪混じりの頭になってしまったり, + あるいは慢性の 脱毛症にすら なってしまうかもしれません...</para> + + <para>いくつかのソフトウェアディストリビューションでは, + 設定用のスクリプトを + 配布することでこの問題を解決しようとしています. + これらのスクリプトの中には非常に精巧なものもありますが, + 残念ながら, 中にはこれまで + 聞いたこともないようなシステムの名前をしゃあしゃあと + 言い放ったうえに, まるでシステムレベルの Unix + プログラミングに関する 最終試験のような, + たくさんの質問をしてくる場合があります. (例えば, + <literal>このシステムの gethitlist 関数は fromboz への const + ポインタを 返しますか? それとも const fromboz + へのポインタを返しますか?</literal>, <literal>このシステムには + Foonix スタイルの, 容認できない例外処理をおこなう + ルーチンがありますか? もしもないとしたら, + それはなぜですか?</literal>)</para> + + <para>幸いなことに, ports コレクションがあれば, + これらのきつい作業はすべて 完了しています. <command>make + install</command> とタイプするだけで, 動作するプログラムを + 入手することができるのです.</para> + + <sect1> + <title>なぜ ports コレクションを作ったのか?</title> + + <para>FreeBSD の基本システムは, + 非常に多くのツールやユーティリティから 構成されています. しかし, + よく使われるプログラムのうち多くのものが, + この基本システムには含まれていません. その理由は:-</para> + + <orderedlist> + <listitem> + <para>ある Lisp ベースのエディタのように, + それがないと生きていけないと 言う人もいれば, + ディスクの無駄だと言う人もいるようなプログラム.</para> + </listitem> + + <listitem> + <para>基本システムに組み込むには特殊すぎるプログラム. (CAD + やデータベースなど.)</para> + </listitem> + + <listitem> + <para>“時間のある時に, + ちょっと見ておかなければ”というような類の, + それがシステムに含まれていないことが + 致命的とは言えないプログラム. (おそらく, + 何らかの言語などでしょう.)</para> + </listitem> + + <listitem> + <para>FreeBSD + のような真面目なオペレーティングシステムの一部として + 供給するには遊びが過ぎるようなプログラム. ;-)</para> + </listitem> + + <listitem> + <para>たくさんのプログラムを基本システムに組み込んだとしても, + もっともっと 組み込みたいという要求が出てくるので, + どこかで制限を引かなくてはならないため. (そうしなければ + FreeBSD の配布物は, + とてつもなく膨大になってしまうでしょう.)</para> + </listitem> + </orderedlist> + + <para>すべての人が自分のお気に入りの + プログラムを手作業で移植しなければ ならないとしたら, + (途方もない膨大な作業の繰り返しをさておいたとしても) + それは明らかに不合理な話です. そこで, FreeBSD プロジェクトでは, + 標準のツールを使って移植のプロセスを + 自動化する巧妙な方法を考え出しました.</para> + + <para>なお, + これは単純ながら非常に柔軟なツールを組み合わせることで, + 非常に強力な働きをさせるという“Unix + 流”の作業の優れた実例です.</para> + </sect1> + + <sect1> + <title>ports コレクションはどのように動くのでしょうか?</title> + + <para>インターネットでは通常, <link + linkend="ports-tarball">tarball</link> の形で + プログラムが配布されています. これは, Makefile + とソースコードで構成され, 普通は何らかの説明書 (あいにく, + いつもわかりやすく書かれているとは 限りませんが) + が付属しています. ことによるとコンフィグレーションスクリプトも + 含まれているかもしれません.</para> + + <para>標準的な手順では, FTP で tarball を入手して, + 適当なディレクトリで展開します. 次に説明書を読んで, + 必要な変更をおこないます. そして, 設定スクリプトを実行し, 標準の + <command>make</command> + コマンドを使ってソースのコンパイルとインストールを + おこないます.</para> + + <para>FreeBSD の ports も tarball の仕組みを利用していますが, + これはユーザが 苦労して作業することを期待したものではなく, + どのようにすれば FreeBSD 上で + そのプログラムが動くようになるかという「ノウハウ」を <link + linkend="ports-skeleton">スケルトン</link> + を使用して収めているものです. スケルトンは, カスタマイズ済みの + <link linkend="ports-makefile">Makefile</link> も + 提供していますので, ほとんどすべての ports + は同じ手順でインストールすることが できます.</para> + + <para>もしあなたが (<ulink + URL="file://localhost/usr/ports/devel/ElectricFence">あなたの + FreeBSD システム</ulink> または <ulink + URL="ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/devel/ElectricFence"> + FTP サイト</ulink> にある) ports スケルトンを見ていて, + そこに潜んでいる あらゆる種類の先端的な + ロケット工学的なものを見つけられると期待していると, + つまらなそうなファイルやディレクトリがそこにあるだけなのを見て, + がっかりするかもしれません. + (ports を手に入れる方法については, すぐに + <link linkend="ports-getting">FreeBSD ports コレクションの入手方法 + </link> の節でお話します.)</para> + + <para>“一体どうしたらいいんだ? ここにはソースコードが + ないじゃないか?” + というあなたの叫びが聞こえるようです.</para> + + <para>心配いりません. おとなしく読んでいけば, すべてが (たぶん) + 明らかに なるでしょう. 試しに ports をインストールして, + 何が起きるのかを見てみましょう. + ここではサンプルとして開発者向けの便利なツール, + <application>ElectricFence</application> を選択します. + このスケルトンを選んだ理由は, 他の ports + に比べても素直で理解しやすく 書かれているからです.</para> + + <note> + <para>自宅で試してみる場合には, root + になる必要があるでしょう.</para> + </note> + + <!-- kuriyama - remove informalexample --> + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports/devel/ElectricFence</userinput> +&prompt.root; <userinput>make install</userinput> +>> Checksum OK for ElectricFence-2.0.5.tar.gz. +===> Extracting for ElectricFence-2.0.5 +===> Patching for ElectricFence-2.0.5 +===> Applying FreeBSD patches for ElectricFence-2.0.5 +===> Configuring for ElectricFence-2.0.5 +===> Building for ElectricFence-2.0.5 +[大量のメッセージをコンパイラが出力します...] +===> Installing for ElectricFence-2.0.5 +===> Warning: your umask is "0002". + If this is not desired, set it to an appropriate value + and install this port again by ``make reinstall''. +install -c -o bin -g bin -m 444 /usr/ports/devel/ElectricFence/work/ElectricFence-2.0.5/libefence.a /usr/local/lib +install -c -o bin -g bin -m 444 /usr/ports/devel/ElectricFence/work/ElectricFence-2.0.5/libefence.3 /usr/local/man/man3 +===> Compressing manual pages for ElectricFence-2.0.5 +===> Registering installation for ElectricFence-2.0.5</screen> + </informalexample> + + <para>ここではあなたが混乱しないように, コンパイル時の出力を + すべて取り除いてあります.</para> + + <para>もしもあなた自身で実行されたら, 最初にこのような + 出力結果が得られるはずです:-</para> + + <informalexample id="ports-fetch"> + <screen>&prompt.root; <userinput>make install</userinput> +>> ElectricFence-2.0.5.tar.gz doesn't seem to exist on this system. +>> Attempting to fetch from ftp://ftp.doc.ic.ac.uk/Mirrors/sunsite.unc.edu/pub/Linux/devel/lang/c/.</screen> + </informalexample> + + <para><command>make</command> プログラムは, + あなたの手元にソースコードがないことを検出し, + 処理を続けられるようにソースを FTP でダウンロードしようとします. + この例では, あらかじめ手動でソースコードを用意してあったので, + 持ってくる必要はありませんでした.</para> + + <para>では, 続けて <command>make</command> + プログラムが何をしているのか見てみましょう.</para> + + <procedure> + <step> + <para>ソースコード <link + linkend="ports-tarball">tarball</link> のありかを + 確認します. 手元にファイルが存在しなければ, FTP + サイトから入手しようとします.</para> + </step> + + <step> + <para><link linkend="ports-checksum">チェックサム</link> + テストを実行して, その tarball + が事故か何かで途中で切れていたり, ASCII モードで + ダウンロードされていたり, + 転送中にニュートリノによって傷められたりして + 改変されたりしていないかどうかを確認します.</para> + </step> + + <step> + <para>tarball を一時的な作業用ディレクトリに展開します.</para> + </step> + + <step> + <para>FreeBSD 上でコンパイルしたり, 動作させるのに必要な + すべての <link linkend="ports-patch">パッチ</link> + をソースコードに当てます.</para> + </step> + + <step> + <para>構築のために必要な + コンフィグレーションスクリプトを実行します. + コンフィグレーションスクリプトの + 質問には正確に答えてください.</para> + </step> + + <step> + <para>(いよいよ!) ソースコードをコンパイルします.</para> + </step> + + <step> + <para>実行形式のプログラム, マニュアル, + その他のサポートファイルを, + システムのプログラムと混ざってしまわないように + <filename>/usr/local</filename> 以下に インストールします. + ports はすべて同じ場所にインストールされ, + システムのあちこちにばらまかれることはありません.</para> + </step> + + <step> + <para>インストール結果はデータベースに登録されます. + これにより, + インストールしたプログラムがもしも気に入らなかったときも, + システムから すべての痕跡をきれいに <link + linkend="ports-remove">消去</link> + することができます.</para> + </step> + </procedure> + + <para>以上のステップが <command>make</command> + の出力と一致しているかどうか確認してください. + 今まで確認していなかったのなら, + 今からするようにしてください!</para> + </sect1> + + <sect1 id="ports-getting"> + <title>FreeBSD ports コレクションの入手</title> + + <para>あるプログラムの FreeBSD port + を入手するには二つの方法があります. ひとつは <link + linkend="ports-cd">FreeBSD CD-ROM</link> を使う方法で, + もうひとつは <link + linkend="ports-inet">インターネット接続</link> + を使う方法です.</para> + + <sect2 id="ports-cd"> + <title>CD-ROM からコンパイルする</title> + + <para>FreeBSD CD-ROM がドライブに入っており, + <filename>/cdrom</filename> にマウントされていると仮定すると + (マウントポイントが <filename>/cdrom</filename> + である必要があります), ただ普通に実行するだけで ports + を構築できるようになり, tarball + をネットワーク経由でダウンロードするのではなく + <filename>/cdrom/ports/distfiles/</filename> + からさがすようになります (そこにあればの話ですが).</para> + + <para>CD-ROM にある port スケルトンを使いたければ, 他に + <filename>/etc/make.conf</filename> の + 変数を以下のようにセットする方法があります:</para> + + <programlisting> +PORTSDIR= /cdrom/ports +DISTDIR= /tmp/distfiles +WRKDIRPREFIX= /tmp</programlisting> + + <para>(任意の十分な空きスペースの場所を <literal>/tmp</literal> + とおいています). + 次に, <filename>/cdrom/ports</filename> 下の適宜のサブディレクトリに + <command>cd</command> して, 例のごとく + <command>make install</command> とタイプします. + <makevar>WRKDIRPREFIX</makevar> は port に + <filename>/tmp/cdrom/ports</filename> の下でビルドさせようとします; + 例えば, <filename>games/oneko</filename> は + <filename>/tmp/cdrom/ports/games/oneko</filename> の下で + ビルドされるでしょう. + </para> + + <para>ライセンスの制限により, いくつかの ports + でオリジナルのソースコードを CD-ROM + に入れることができなかったものがあることに注意してください. + この場合, <link linkend="ports-inet">インターネット経由で + ports をコンパイルする</link> の + 節を参照してください.</para> + </sect2> + + <sect2 id="ports-inet"> + <title>インターネット経由で ports をコンパイルする</title> + + <para>CD-ROM を持っていなかったり, その ports + の最新バージョンを確実に入手したい 場合は, その ports の <link + linkend="ports-skeleton">スケルトン</link> を + ダウンロードする必要があります. ところで, これは落し穴が + たくさんある作業に見えるかもしれませんが, + 実際には非常に簡単です.</para> + + <para>初めに, あなたの動かしている FreeBSD + がリリースバージョンなら <ulink + url="http://www.freebsd.org/ports/">ports ページ </ulink> + でその FreeBSD 用の “アップグレードキット” + を手にいれてください. このパッケージには, 最新の ports + をコンパイルするのに必要な, + リリース以降に更新されたファイルが含まれています.</para> + + <para>FreeBSD の FTP サーバーがその場で <link + linkend="ports-tarball">tarball</link> + を作成できることを利用してスケルトンを入手すると + 非常に便利です. ここでは例として databases ディレクトリにある + gnats プログラムを使って説明します. + (角型かっこの中の文はコメントなので, 実際に実行する場合には, + これをタイプしないでください!):-</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports</userinput> +&prompt.root; <userinput>mkdir databases</userinput> +&prompt.root; <userinput>cd databases</userinput> +&prompt.root; <userinput>ftp ftp.freebsd.org</userinput> +[ユーザ名 `ftp' でログインし, パスワードを要求されたら, あなたの電子メール +アドレスを入力してください. バイナリモードを (イメージモードと呼ばれることも +あります) 使うのをお忘れなく!] +<prompt>></prompt> <userinput>cd /pub/FreeBSD/ports/ports/databases</userinput> +<prompt>></prompt> <userinput>get gnats.tar</userinput> +[gnats スケルトンの tarballs を取得] +<prompt>></prompt> <userinput>quit</userinput> +&prompt.root; <userinput>tar xf gnats.tar</userinput> +[gnats スケルトンの展開] +&prompt.root; <userinput>cd gnats</userinput> +&prompt.root; <userinput>make install</userinput> +[gnats の構築とインストール]</screen> + </informalexample> + + <para>さて何が起きるでしょうか? FTP + サイトにいつも通りに接続して, データベースの + サブディレクトリに移動します. <command>get gnats.tar</command> + とコマンドを入力すると, FTP サイトでは gnats ディレクトリを + <link linkend="ports-tarball">tarred</link> + にしてくれるのです.</para> + + <para>gnats スケルトンを展開したら, gnats ディレクトリへ移動して + ports を構築します. <link linkend="ports-fetch">すでに</link> + 説明したように, make の過程で + 手元にソースコードがないことを検出すると, + ソースコードを取得してから 展開し, + パッチ当てと構築をおこないます.</para> + + <para>それでは, 少し冒険をしてみましょう. 一つの ports + スケルトンを 取得するかわりに, たとえば ports + コレクションの中のデータベースの スケルトンをすべて, + サブディレクトリ全体を取得してみましょう. + やり方はほとんど同じです:-</para> + + <para> + <literallayout> &prompt.root; cd /usr/ports + &prompt.root; ftp ftp.freebsd.org + [ユーザ名 `ftp' でログインし, パスワードを要求されたら, あなたの電子メール +アドレスを入力してください. バイナリモードを (イメージモードと呼ばれることも +あります) 使うのをお忘れなく!] + > cd /pub/FreeBSD/ports/ports + > get databases.tar [データベースディレクトリの tarballs を取得] + > quit + &prompt.root; tar xf databases.tar [すべてのスケルトンを展開] + &prompt.root; cd databases + &prompt.root; make install [データベース ports 全部の構築とインストール] </literallayout> + </para> + <!-- kuriyama - literallayout? --> + + <para>わずかばかりの簡単なコマンドで, この FreeBSD + マシン上にデータベース + プログラムを一揃い手に入れてしまいました! 一つの ports + スケルトンを取ってきて それを構築する場合との違いは, + すべてのディレクトリを一度に取得して, + 全部を一度にコンパイルしたということだけです. + かなり感動的だと思いませんか?</para> + + <para>たくさんの ports をインストールする つもりなら, + おそらくすべての ports ディレクトリをダウンロードしておく + 価値があるでしょう.</para> + </sect2> + </sect1> + + <sect1 id="ports-skeleton"> + <title>スケルトン</title> + + <para>スケルトン (訳注: skeleton とは骸骨のことです) とは, + 締め切りを守るため, 食事をするのを忘れるほど仕事にのめり込んだ + ハッカーたちのなれの果ての ことでしょうか? FreeBSD + の屋根裏に潜む, なにか気持ちの悪いものでしょうか? いいえ, + ここでスケルトンの意味するところは, ports の魔術を実現するのに + 必要とされるすべてのものを提供する最小の骨組みのことです.</para> + + <sect2 id="ports-makefile"> + <title><filename>Makefile</filename></title> + + <para>スケルトンのもっとも重要な要素は Makefile です. Makefile + は ports を どのようにコンパイルし, + インストールをおこなうかを指示する + いろいろな命令を含んでいます. 以下に ElectricFence の Makefile + を示します:-</para> + + <programlisting> +# New ports collection makefile for: Electric Fence +# Version required: 2.0.5 +# Date created: 13 November 1997 +# Whom: jraynard +# +# $Id$ +# + +DISTNAME= ElectricFence-2.0.5 +CATEGORIES= devel +MASTER_SITES= ${MASTER_SITE_SUNSITE} +MASTER_SITE_SUBDIR= devel/lang/c + +MAINTAINER= jraynard@freebsd.org + +MAN3= libefence.3 + +do-install: + ${INSTALL_DATA} ${WRKSRC}/libefence.a ${PREFIX}/lib + ${INSTALL_MAN} ${WRKSRC}/libefence.3 ${PREFIX}/man/man3 + +.include <bsd.port.mk></programlisting> + + <para>"#" で始まる行は, 人間のためのコメント行です. + (ほとんどの Unix のスクリプトと同じですね.)</para> + + <para><literal>DISTNAME</literal> は <link + linkend="ports-tarball">tarball</link> + の名前から拡張子を取ったものです.</para> + + <para><literal>CATEGORIES</literal> + はこのプログラムの種類を示します. この場合, + 開発者向けのユーティリティということになります. + 完全なリストはこのハンドブックの <link + linkend="porting-categories">カテゴリ</link> + をみてください.</para> + + <para><literal>MASTER_SITES</literal> はマスタ FTP サイトの URL + です. もしローカルシステムに <link + linkend="ports-tarball">tarball</link> がない場合には, + ここから取得します. これは信頼できると考えられているサイトで, + 通常はそのプログラムを + インターネット上で公式に配布しているサイトです. + (そのソフトウェアがインターネット上で「公式に」 + 配布されているとしたら)</para> + + <para><literal>MAINTAINER</literal> は, + 例えば新しいバージョンのプログラムが出た場合に, 必要であれば + スケルトンの更新をおこなう保守担当者の + 電子メールアドレスです.</para> + + <para>次の数行はとりあえず飛ばします. + + <literal>.include <bsd.port.mk></literal> + + この行は, この ports に必要なその他の命令やコマンドは + <filename>bsd.port.mk</filename> に + 入っているということを示しています. + これらはすべての ports で共通のものなので, + それぞれの Makefile に書いておく必要はありません. + そのため単一の標準ファイルに + まとめられているのです.</para> + + <para>ここでは Makefile + がどう働くかを詳細に調査するのが目的ではありませんので, + <literal>MAN3</literal> で始まる行は, インストールの後に + ElectricFence のマニュアルを 圧縮するために使用される, + と言っておくだけで充分でしょう. これにより, + 貴重なディスクスペースが保護されているわけです. オリジナルの + port では <maketarget>install</maketarget> + ターゲットが用意されていないので, + <maketarget>do-install</maketarget> からの 3 行が この ports + によって生成されたファイルを + 正しい場所に置くために使用されます.</para> + </sect2> + + <sect2> + <title><filename>files</filename> ディレクトリ</title> + + <para>ports のチェックサム算出には MD5 + アルゴリズムを使用しているので, この <link + linkend="ports-checksum">チェックサム</link> を含んでいる + ファイルは <filename>md5</filename> と呼ばれます. + ちょっと混乱するかもしれませんが, このファイルは + <filename>files</filename> という + 名前のディレクトリに置かれています.</para> + + <para>このディレクトリは, ports に必要だけれども, + 他のどこにも属さない 雑多なファイルも含んでいます.</para> + </sect2> + + <sect2> + <title><filename>patches</filename> ディレクトリ</title> + + <para>このディレクトリには, FreeBSD + ですべてを正常に動作させるのに 必要な <link + linkend="ports-patch">パッチ</link> が含まれています.</para> + </sect2> + + <sect2> + <title><filename>pkg</filename> ディレクトリ</title> + + <para>このディレクトリには, + 非常に役立つ三つのファイルが含まれています:-</para> + + <itemizedlist> + <listitem> + <para><filename>COMMENT</filename> — + プログラムについての 1 行の説明.</para> + </listitem> + + <listitem> + <para><filename>DESCR</filename> — より詳細な説明.</para> + </listitem> + + <listitem> + <para><filename>PLIST</filename> — + プログラムのインストール時に作成される, + すべてのファイルのリスト.</para> + </listitem> + </itemizedlist> + </sect2> + </sect1> + + <sect1 id="ports-troubleshooting"> + <title>ports が動かないのですが, どうしたらよいでしょう</title> + + <para>おやおや. では, 次の四つのどれかをやってみてください:</para> + + <orderedlist> + <listitem> + <para>自分で修正する. ports + の仕組みに関する技術的な詳細については, <link + linkend="porting"> + アプリケーションの移殖方法</link>をご覧ください.</para> + </listitem> + + <listitem> + <para>苦情をいう. これは電子メールで <emphasis>だけ</emphasis> + にしてください! このようなメールの宛先は &a.ports; です. + なお, 必ず port の名前やバージョン, その port のソースや + distfile(s) を どこから入手したか, + どんなエラーが発生したのかを書いておいてください.</para> + </listitem> + + <listitem> + <para>忘れてしまう. これはほとんどの場合最も簡単な方法です. + ports + のプログラムのうち必要不可欠な物はごくわずかです.</para> + </listitem> + + <listitem> + <para>FTP サイトからコンパイル済みのパッケージを入手する. + “マスター”パッケージコレクションは FreeBSD の + FTP サイトの <ulink + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/"> + パッケージディレクトリ</ulink> に置いてありますが, + まずあなたの近くのローカルミラーサイトを確認してください! + ソースからのコンパイルに挑戦するよりも, + パッケージを使うほうが (全体的に見て) + ずっと確実に動作するでしょうし, + より手っ取り早い方法でもあります. + システムにパッケージをインストールするには, &man.pkg.add.1; + を使ってください.</para> + </listitem> + </orderedlist> + </sect1> + + <sect1> + <title>質問と回答集</title> + + <itemizedlist> + <listitem> + <para>Q. 私はモデムについての議論を + しているのかと思っていました??!</para> + + <para>A.なるほど, あなたはきっとコンピュータの背面についている + シリアルポートのことだと思ってしまったのでしょう. + あるバージョンの Unixから別のバージョンの Unix + へとプログラムを 移殖することを “porting” + というのですが, ここで我たちは “porting” の結果 + という意味で “port” を使っています. + (コンピュータに関わる人々の悪しき習慣として, + ひとつの同じ言葉を複数の + まったく違う意味として使うことがあるのです.)</para> + </listitem> + + <listitem> + <para>Q. 私は, 標準以外のプログラムのインストールには packages + を使うと 思っていたのですが.</para> + + <para>A. そのとおり. 通常は packages + が最も手早くて簡単な方法です.</para> + </listitem> + + <listitem> + <para>Q. それではどうして面倒な ports があるのですか?</para> + + <para>A. いくつかの理由があります:-</para> + + <orderedlist> + <listitem> + <para>いくつかのソフトウェアのライセンス条件には, + バイナリではなくソースコードでの + 配布を求めているものがあります.</para> + </listitem> + + <listitem> + <para>バイナリ配布を信用していない人もいます. + 少なくともソースコード があれば, ソースコードを読んで, + (理論的には) 潜在的な問題点を自分で + 見つけ出すこともできるはずです.</para> + </listitem> + + <listitem> + <para>ローカルなパッチを入手した場合, + それを自分で追加するために + ソースコードが必要になります.</para> + </listitem> + + <listitem> + <para>プログラムがいかにコンパイルされるべきかについて, + あなたはパッケージを作った人とは + 異なる見解を持っているかもしれません. + どんな最適化オプションをつけるべきかとか, + デバッグバージョンを作ってから それを strip + するべきだとか, いや, そうするべきでない, などなど, + 確固たる見解を持っている人もいるでしょう.</para> + </listitem> + + <listitem> + <para>ソースコードを手元に置いておきたい人たちもいます. + 彼らは, 退屈したときに眺めたり, あちこち解析してみたり, + ソースコードを 借用したり (もちろん, + ライセンスが許せばの話ですが) するのです.</para> + </listitem> + + <listitem> + <para>あなたがソースコードを持っていなければ, + それはソフトウェアとは 言えませんね! <!-- smiley + -->;-)</para> + </listitem> + </orderedlist> + </listitem> + + <listitem> + <para><anchor id="ports-patch"> + Q. パッチとは何ですか?</para> + + <para>A. パッチとは, + あるバージョンから他のバージョンへどのように変更するかを + 示す, (通常は) 小さなファイルです. “23 + 行目を削除”, “468 行目の後に これらの 2 + 行を追加”, または“197 + 行目をこのように変更”というような 内容を含んでいます. + これは, “diff” + という名前のプログラムで生成されます.</para> + </listitem> + + <listitem> + <para><anchor id="ports-tarball"> + Q. tarball とは一体何ですか?</para> + + <para>A. <filename>.tar</filename> または + <filename>.tar.gz</filename> という拡張子を持つファイルです. + (<filename>.tar.Z</filename> のようなバリエーションも + ありますし, DOS のファイルシステム用に + <filename>.tgz</filename> + と短縮される場合もあります.)</para> + + <para>これは基本的に, 一つのファイルに固めた + (<filename>.tar</filename>) ディレクトリツリーです. + 圧縮されている (<filename>.gz</filename>) 場合もあります. + これは元々 <emphasis>T</emphasis>ape + <emphasis>AR</emphasis>chives (訳注: テープアーカイブ) + (このため <command>tar</command> という名前なのです) + で使われていたものなのですが, + インターネット上でプログラムのソースコードを配布するために + 広く使われている方法です.</para> + + <para>これらのファイルの中身を見たり, + 展開したりすることもできます. FreeBSD + の基本システムに付属する Unix 標準の tar + コマンドを使ってみると 次のようになります:-</para> + + <informalexample> + <screen>&prompt.user; <userinput>tar tvzf foobar.tar.gz</userinput> +&prompt.user; <userinput>tar xzvf foobar.tar.gz</userinput> +&prompt.user; <userinput>tar tvf foobar.tar</userinput> +&prompt.user; <userinput>tar xvf foobar.tar</userinput> + </screen> + </informalexample> + </listitem> + + <listitem> + <para><anchor id="ports-checksum"> + Q. チェックサムとは何ですか?</para> + + <para>A. これは, + チェックしたいファイル中のすべてのデータを加えて生成した + 数値です. 何か文字が書き換わっていたら, + チェックサムが一致しなくなります. そのため, + 単純な比較だけで違いを見つけることができるのです. + (実際には, 文字の位置が入れ替わるなどの, + 単純な加算ではわからない問題も + 見つけることができる複雑な方法で計算されています.)</para> + </listitem> + + <listitem> + <para>Q. 私は, <link linkend="ports-cd">CD-ROM から ports + をコンパイルする</link> にしたがって ports + をインストールしていました. kermit + をインストールしようとするまではうまくいっていました:-</para> + + <informalexample> + <screen>&prompt.root; <userinput>make install</userinput> +>> cku190.tar.gz doesn't seem to exist on this system. +>> Attempting to fetch from ftp://kermit.columbia.edu/kermit/archives/.</screen> + </informalexample> + + <para>なぜ cku190.tar.gz が見つからないのでしょうか? 不良品の + CD-ROM を買ってしまったのでしょうか?</para> + + <para>A. Kermit の権利を持つチームは, 私たちの CDROM に kermit + の tarball を 入れることを許可しませんでした. + 申し分けありませんが, 手動でファイルを 入手してください. + このようなエラーメッセージが出たのは, + あなたがそのときインターネットに 接続していなかったためです. + あらかじめ上記のサイトのいずれかからファイルを + ダウンロードしておけば, プロセスを再開することができます. + (ダウンロードの際には, + あなたに最も近いサイトを選ぶようにしてください. そうすれば, + 時間とインターネットの帯域の節約になります)</para> + </listitem> + + <listitem> + <para>Q. kermit の tarball を入手しましたが, + <filename>/usr/ports/distfiles</filename> に + ファイルを置こうとすると, + 書き込み権がないというエラーがでます.</para> + + <para>A. ports のしくみは + <filename>/usr/ports/distfiles</filename> から tarball + を探します. しかし, これは read-only の CD-ROM + へのシンボリックリンクなので, + ここにファイルを置くことはできません. 次のようにすれば, + 他の場所を探すよう ports に指示することができます.</para> + + <informalexample> + <screen>&prompt.root; <userinput>make DISTDIR=/where/you/put/it install</userinput></screen> + </informalexample> + </listitem> + + <listitem> + <para>Q. ports では, すべてを <filename>/usr/ports</filename> + に置いたときだけ動作するのでしょうか? + システムの管理者によると, 私の個人的なファイルは + <filename>/u/people/guests/wurzburger</filename> + に入れなければならないのですが, これでは + うまくいかないように思います.</para> + + <para>A. <makevar>PORTSDIR</makevar> 変数と + <makevar>PREFIX</makevar> 変数を変更することで, + 違うディレクトリを 使用することができます. 例えば,</para> + + <informalexample> + <screen>&prompt.root; <userinput>make PORTSDIR=/u/people/guests/wurzburger/ports install</userinput></screen> + </informalexample> + + <para>とすると, ports は + <filename>/u/people/guests/wurzburger/ports</filename> + でコンパイルされ, すべて <filename>/usr/local</filename> + 以下にインストールされます.</para> + + <informalexample> + <screen>&prompt.root; <userinput>make PREFIX=/u/people/guests/wurzburger/local install</userinput></screen> + </informalexample> + + <para>この場合, コンパイルは <filename>/usr/ports</filename> + でおこない, + <filename>/u/people/guests/wurzburger/local</filename> + にインストールします. もちろん, + 以下のように両者を組み合わせることも可能です.</para> + + <informalexample> + <screen>&prompt.root; <userinput>make PORTSDIR=.../ports PREFIX=.../local install</userinput></screen> + </informalexample> + + <para>(省略せずに記述したら, + このページに収めるには長すぎるのですが, + 考え方は理解していただけたと思います)</para> + + <para>もし ports をインストールするたびに, + これらを毎回タイプするのが 気に入らないのであれば, + (正直に言って, 誰もそう思わないでしょう) + これらを環境変数にセットしてしまうという手があります.</para> + </listitem> + + <listitem> + <para>Q. 私は, FreeBSD の CD-ROM を持っていませんが, + 私はすべての tarball を 私のシステムに置いておきたいのです. + そうすれば, 私は ports をインストール するたびに, + 毎回ダウンロードが終わるのを待たなくてすむでしょう. + これを一度におこなう簡単な方法はありませんか?</para> + + <para>A. ports コレクション全体の tarball を持ってくるには, + 次のようにしてください.</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports</userinput> +&prompt.root; <userinput>make fetch</userinput></screen> + </informalexample> + + <para>ports の下のディレクトリひとつの tarball + を持ってくるには, 次のように してください.</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports/directory</userinput> +&prompt.root; <userinput>make fetch</userinput></screen> + </informalexample> + + <para>ports をひとつだけ持ってくる方法は, + きっと既にご存知だと思います.</para> + </listitem> + + <listitem> + <para>Q. マスタ FTP サイトから tarball を持ってくるより, + 近くにある FreeBSD の + ミラーサイトから持ってきた方が速いはずです. MASTER_SITES + に書かれている サイト以外から持ってくるように ports + に指示する方法はありませんか?</para> + + <para>A. もちろんあります. 例えば <hostid + role="fqdn">ftp.FreeBSD.ORG</hostid> が + <makevar>MASTER_SITES</makevar> に書かれている + サイトより近いとしたら, 以下のようにしてください.</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports/directory</userinput> +&prompt.root; <userinput>make MASTER_SITE_OVERRIDE=ftp://ftp.FreeBSD.ORG/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen> + </informalexample> + </listitem> + + <listitem> + <para>Q. ダウンロードをする前に, + どんなファイルが必要なのか知りたいのですが.</para> + + <para>A. <command>make fetch-list</command> とすると, ports + に必要なファイルの一覧を表示できます.</para> + </listitem> + + <listitem> + <para>Q. ports のコンパイルを途中で止める方法はありますか? + 私はインストールをする前に + いろいろとソースコードを解析したいのですが, 毎回 control-C + を打たなければならないのが少し面倒です.</para> + + <para>A. <command>make extract</command> を実行すると, + ファイル転送とソースコードの展開まで + おこなったところで停止します.</para> + </listitem> + + <listitem> + <para>Q. 自分で ports を作ろうとしています. 私の作ったパッチが + 正しく処理できることを確認できるように, + コンパイルを止めたいのです. パッチのための <command>make + extract</command> のようなものはありませんか?</para> + + <para>A. あります. <command>make patch</command> + があなたのお望みのものです. おそらく + <makevar>PATCH_DEBUG</makevar> オプションも同様に + お役に立つことでしょう. ところで, + あなたの努力に感謝いたします!!</para> + </listitem> + + <listitem> + <para>Q. あるコンパイルオプションはバグの + 原因になるという話を聞きました. 本当なのでしょうか? + どうやったら正しい設定で ports + をコンパイルできますか?</para> + + <para>A. 本当です. <command>gcc</command> の バージョン 2.6.3 + (FreeBSDの 2.1.0 と 2.1.5 に付属している バージョン) では, + <option>-O2</option> オプションを + <option>-fno-strength-reduce</option> オプションなしで + 使うと, バグのあるコードを出力します (ほとんどの ports は + <option>-O2</option> オプションを 使いません). + コンバイラオプションは次のように定義 <emphasis> すべき + </emphasis> です.</para> + + <informalexample> + <screen>&prompt.root; <userinput>make CFLAGS='-O2 -fno-strength-reduce' install</userinput></screen> + </informalexample> + + <para>これを <filename>/etc/make.conf</filename> + に書いておくこともできますが, 残念なことに すべての ports + がこの指定を尊重してくれる 訳ではありません. + もっとも確実なのは <command>make configure</command> + を実行し, ソースディレクトリの Makefile + を見て手で修整することですが, ソースが + 多くのサブディレクトリにわかれていて, 各々に Makefile + がある場合は 大変な仕事になります.</para> + </listitem> + + <listitem> + <para>Q. ports がたくさんありすぎて, + 私の欲しいものがなかなか見つけられません. どんな ports + が使えるのか, リストはどこかにありませんか?</para> + + <para>A. <filename>/usr/ports</filename> の中にある + <filename>INDEX</filename> ファイルを見てみましょう. + あるキーワードで ports コレクションを検索したければ, + それも可能です. たとえば, + 以下のようにすればプログラミング言語 LISP に関連した ports + を見つけることができます: </para> + + <screen>&prompt.user; <userinput>cd /usr/ports</userinput> +&prompt.user; <userinput>make search key=lisp</userinput></screen> + </listitem> + + <listitem> + <para>Q. <literal>foo</literal> ports + をインストールしたいのですが, それのコンパイルは + すぐに停止して, <literal>bar</literal> ports + のコンパイルが始まってしまいます. 一体どうして?</para> + + <para>A. <literal>foo</literal> ports が, + <literal>bar</literal> ports + の提供する何らかの機能を必要としているからです. 例えば + <literal>foo</literal> が画像を使うとすると, + <literal>bar</literal> は画像処理に必要な + ライブラリを持っている, などです. または, + <literal>bar</literal> は <literal>foo</literal> + をコンパイルするのに必要なツールなのかもしれません.</para> + </listitem> + + <listitem> + <para><anchor id="ports-remove"> Q. ports から + <literal>grizzle</literal> + プログラムをインストールしましたが, まったく + ディスクスペースの浪費です. 削除したいのですが, + すべてのファイルが どこへインストールされたのかわかりません. + 何か手がかりはありませんか?</para> + + <para>A. 大丈夫, 次のようにしてください.</para> + + <informalexample> + <screen>&prompt.root; <userinput>pkg_delete grizzle-6.5</userinput></screen> + </informalexample> + </listitem> + + <listitem> + <para>Q. ちょっと待ってください. + 削除しようとするコマンドのバージョン番号を + 知っていなくてはならないのでしょうか? あなたは, + 私がバージョン番号を + 覚えていることを本気で当てにしているのでしょうか?</para> + + <para>A. そんなことはありません. + バージョン番号は次のようにすればわかります.</para> + + <informalexample> + <screen>&prompt.root; <userinput>pkg_info -a | grep grizzle</userinput> +Information for grizzle-6.5: +grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arcade game.</screen> + </informalexample> + </listitem> + + <listitem> + <para>Q. ディスク容量のことなのですが, ports + のディレクトリは非常に膨大な容量を 使うように見えます. + 残しておいた方がよいのでしょうか? 削除してしまっても + よいのでしょうか?</para> + + <para>A. はい. インストールが首尾よく終わり, + もうソースコードが必要でないと思うなら, + それらを残しておく理由はないでしょう. 一番よい方法は, + 次の通りです.</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports</userinput> +&prompt.root; <userinput>make clean</userinput></screen> + </informalexample> + + <para>これは, すべての ports のサブディレクトリを調べ, 各 + ports のスケルトン以外の削除をおこないます.</para> + </listitem> + + <listitem> + <para>Q. これを試してみたのですが, tarball や ports + で使われたファイルが <filename>distfiles</filename> + ディレクトリに残っています. + これも削除してしまっても大丈夫ですか?</para> + + <para>A. はい. それを使った作業が終わったのであれば, + 削除してしまっても大丈夫です.</para> + </listitem> + + <listitem> + <para>Q. + 私はとてもとてもたくさんのプログラムを楽しみたいのです. + 一度にすべての ports + をインストールする方法はありませんか?</para> + + <para>A. 次のようにしてください.</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports</userinput> +&prompt.root; <userinput>make install</userinput></screen> + </informalexample> + </listitem> + + <listitem> + <para>Q. やってみました. 時間がとてもかかるだろうと思ったので, + そのまま実行を 続けさせて, 私は寝ました. + 翌朝コンピュータを見てみると, 三つ半の ports しか + 処理が終わっていませんでした. + なにか悪かったのでしょうか?</para> + + <para>A. これは ports の中には私たちの決められないこと + (例えば, あなたが A4 の 用紙に印刷したいのか, US + レターサイズの用紙に印刷したいのかなど) について + 質問してくるものがあるからです. + それらの質問には手動で答える必要があります.</para> + </listitem> + + <listitem> + <para>Q. + 私は一日中モニタの前に座って過ごしたりしたくないのですが. + 何かよいアイデアはありませんか?</para> + + <para>A. では, あなたが寝に / 仕事に / + 公園にいく前に以下を実行してください:-</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports</userinput> +&prompt.root; <userinput>make -DBATCH install</userinput></screen> + </informalexample> + + <para>これでユーザの入力を要求しないすべての ports + をインストールします. そして, 戻ってきてから, + 次のように実行してください.</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports</userinput> +&prompt.root; <userinput>make -DIS_INTERACTIVE install</userinput></screen> + </informalexample> + + <para>そして, 残りの作業を実行してください.</para> + </listitem> + + <listitem> + <para>Q. 私たちは ports コレクションにある + <literal>frobble</literal> を使っています. ですが, + 私たちの必要に応じて ports を変更したところがあるのです. + 自分でパッケージを作って, それを私たちのサイトのまわりに + 簡単に配布できるような方法がありますか?</para> + + <para>A. もちろんあります. + 変更点をパッチにする方法は知っていますよね:-</para> + + <informalexample> + <screen>&prompt.root; <userinput>cd /usr/ports/somewhere/frobble</userinput> +&prompt.root; <userinput>make extract</userinput> +&prompt.root; <userinput>cd work/frobble-2.8</userinput> +[あなたのパッチを当ててください] +&prompt.root; <userinput>cd ../..</userinput> +&prompt.root; <userinput>make package</userinput></screen> + </informalexample> + </listitem> + + <listitem> + <para>Q. この ports の技術は本当に賢いですね. + どのようにして動いているのか + 私はどうしても知りたいと思います. その秘密は何ですか?</para> + + <para>A. 秘密は一切ありません. <ulink + URL="file://localhost/usr/share/mk/">Makefiles + ディレクトリ</ulink> にある + <filename>bsd.ports.mk</filename> と + <filename>bsd.ports.subdir.mk</filename> + ファイルを見るだけです.</para> + + <note> + <para>複雑なシェルスクリプトを嫌う読者は, + このリンクを追いかけないほうが よいでしょう.</para> + </note> + </listitem> + </itemizedlist> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../handbook.sgml" "part" "chapter") + End: +--> diff --git a/ja_JP.eucJP/share/sgml/authors.ent b/ja_JP.eucJP/share/sgml/authors.ent new file mode 100644 index 0000000000..2668aa9bd8 --- /dev/null +++ b/ja_JP.eucJP/share/sgml/authors.ent @@ -0,0 +1,348 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: 1.9 + $Id: authors.ent,v 1.1.1.1 1999-04-08 15:45:57 kuriyama Exp $ + + Names and email address of contributing authors and CVS committers. + Entity names for committers should be the same as their login names on + freefall.FreeBSD.ORG. + + Use these entities when referencing people. + + Please keep this list in alphabetical order by entity names. +--> + +<!ENTITY a.abial "Andrzej Bialecki <email>abial@FreeBSD.ORG</email>"> + +<!ENTITY a.ache "Andrey A. Chernov <email>ache@FreeBSD.ORG</email>"> + +<!ENTITY a.adam "Adam David <email>adam@FreeBSD.ORG</email>"> + +<!ENTITY a.alex "Alex Nash <email>alex@freebsd.org</email>"> + +<!ENTITY a.amurai "Atsushi Murai <email>amurai@FreeBSD.ORG</email>"> + +<!ENTITY a.andreas "Andreas Klemm <email>andreas@FreeBSD.ORG</email>"> + +<!ENTITY a.archie "Archie Cobbs <email>archie@FreeBSD.ORG</email>"> + +<!ENTITY a.asami "浅見 賢 <email>asami@FreeBSD.ORG</email>"> + +<!ENTITY a.ats "Andreas Schulz <email>ats@FreeBSD.ORG</email>"> + +<!ENTITY a.awebster "Andrew Webster <email>awebster@pubnix.net</email>"> + +<!ENTITY a.bde "Bruce Evans <email>bde@FreeBSD.ORG</email>"> + +<!ENTITY a.billf "Bill Fumerola <email>billf@FreeBSD.ORG</email>"> + +<!ENTITY a.brandon "Brandon Gillespie <email>brandon@FreeBSD.ORG</email>"> + +<!ENTITY a.brian "Brian Somers <email>brian@FreeBSD.ORG</email>"> + +<!ENTITY a.cawimm "Charles A. Wimmer <email>cawimm@FreeBSD.ORG</email>"> + +<!ENTITY a.charnier "Philippe Charnier <email>charnier@FreeBSD.ORG</email>"> + +<!ENTITY a.chuck "Chuck Robey <email>chuckr@glue.umd.edu</email>"> + +<!ENTITY a.chuckr "Chuck Robey <email>chuckr@FreeBSD.ORG</email>"> + +<!ENTITY a.cracauer "Martin Cracauer <email>cracauer@FreeBSD.ORG</email>"> + +<!ENTITY a.csgr "Geoff Rehmet <email>csgr@FreeBSD.ORG</email>"> + +<!ENTITY a.cwt "Chris Timmons <email>cwt@FreeBSD.ORG</email>"> + +<!ENTITY a.danny "Daniel O'Callaghan <email>danny@FreeBSD.ORG</email>"> + +<!ENTITY a.darrenr "Darren Reed <email>darrenr@FreeBSD.ORG</email>"> + +<!ENTITY a.davidn "David Nugent <email>davidn@blaze.net.au</email>"> + +<!ENTITY a.dburr "Donald Burr <email>dburr@FreeBSD.ORG</email>"> + +<!ENTITY a.dcs "Daniel C. Sobral <email>dcs@FreeBSD.ORG</email>"> + +<!ENTITY a.des "Dag-Erling C. Smørgrav <email>des@FreeBSD.ORG</email>"> + +<!ENTITY a.dfr "Doug Rabson <email>dfr@FreeBSD.ORG</email>"> + +<!ENTITY a.dg "David Greenman <email>dg@FreeBSD.ORG</email>"> + +<!ENTITY a.dillon "Matthew Dillon <email>dillon@FreeBSD.ORG</email>"> + +<!ENTITY a.dima "Dima Ruban <email>dima@FreeBSD.ORG</email>"> + +<!ENTITY a.dirk "Dirk Frömberg <email>dirk@FreeBSD.ORG</email>"> + +<!ENTITY a.dirkvangulik "Dirk-Willem van Gulik <email>Dirk.vanGulik@jrc.it</email>"> + +<!ENTITY a.dt "Dmitrij Tejblum <email>dt@FreeBSD.ORG</email>"> + +<!ENTITY a.dufault "Peter Dufault <email>dufault@FreeBSD.ORG</email>"> + +<!ENTITY a.dwhite "Doug White <email>dwhite@FreeBSD.ORG</email>"> + +<!ENTITY a.dyson "John Dyson <email>dyson@FreeBSD.ORG</email>"> + +<!ENTITY a.eivind "Eivind Eklund <email>eivind@FreeBSD.ORG</email>"> + +<!ENTITY a.ejc "Eric J. Chet <email>ejc@FreeBSD.ORG</email>"> + +<!ENTITY a.erich "Eric L. Hernes <email>erich@FreeBSD.ORG</email>"> + +<!ENTITY a.faq "FAQ 保守担当者 <email>faq@freebsd.org</email>"> + +<!ENTITY a.fenner "Bill Fenner <email>fenner@FreeBSD.ORG</email>"> + +<!ENTITY a.flathill "平岡 征一朗 <email>flathill@FreeBSD.ORG</email>"> + +<!ENTITY a.foxfair "Howard F. Hu <email>foxfair@FreeBSD.ORG</email>"> + +<!ENTITY a.fsmp "Steve Passe <email>fsmp@FreeBSD.ORG</email>"> + +<!ENTITY a.gallatin "Andrew Gallatin <email>gallatin@FreeBSD.ORG</email>"> + +<!ENTITY a.gclarkii "Gary Clark II <email>gclarkii@FreeBSD.ORG</email>"> + +<!ENTITY a.gena "Gennady B. Sorokopud <email>gena@NetVision.net.il</email>"> + +<!ENTITY a.ghelmer "Guy Helmer <email>ghelmer@cs.iastate.edu</email>"> + +<!ENTITY a.gibbs "Justin T. Gibbs <email>gibbs@FreeBSD.ORG</email>"> + +<!ENTITY a.mjacob "Matthew Jacob <email>mjacob@FreeBSD.ORG</email>"> + +<!ENTITY a.gj "Gary Jennejohn <email>gj@FreeBSD.ORG</email>"> + +<!ENTITY a.gpalmer "Gary Palmer <email>gpalmer@FreeBSD.ORG</email>"> + +<!ENTITY a.graichen "Thomas Graichen <email>graichen@FreeBSD.ORG</email>"> + +<!ENTITY a.grog "Greg Lehey <email>grog@FreeBSD.ORG</email>"> + +<!ENTITY a.gryphon "Coranth Gryphon <email>gryphon@healer.com</email>"> + +<!ENTITY a.guido "Guido van Rooij <email>guido@FreeBSD.ORG</email>"> + +<!ENTITY a.hanai "花井浩之 <email>hanai@FreeBSD.ORG</email>"> + +<!ENTITY a.handy "Brian N. Handy <email>handy@sxt4.physics.montana.edu</email>"> + +<!ENTITY a.helbig "Wolfgang Helbig <email>helbig@FreeBSD.ORG</email>"> + +<!ENTITY a.hm "Hellmuth Michaelis <email>hm@FreeBSD.ORG</email>"> + +<!ENTITY a.hoek "Tim Vanderhoek <email>hoek@FreeBSD.ORG</email>"> + +<!ENTITY a.hosokawa "Tatsumi Hosokawa <email>hosokawa@FreeBSD.ORG</email>"> + +<!ENTITY a.hsu "Jeffrey Hsu <email>hsu@FreeBSD.ORG</email>"> + +<!ENTITY a.imp "Warner Losh <email>imp@FreeBSD.ORG</email>"> + +<!ENTITY a.itojun "Jun-ichiro Itoh <email>itojun@itojun.org</email>"> + +<!ENTITY a.jb "John Birrell <email>jb@cimlogic.com.au</email>"> + +<!ENTITY a.jdp "John Polstra <email>jdp@FreeBSD.ORG</email>"> + +<!ENTITY a.jehamby "Jake Hamby <email>jehamby@lightside.com</email>"> + +<!ENTITY a.jfieber "John Fieber <email>jfieber@FreeBSD.ORG</email>"> + +<!ENTITY a.jfitz "James FitzGibbon <email>james@nexis.net</email>"> + +<!ENTITY a.jgreco "Joe Greco <email>jgreco@FreeBSD.ORG</email>"> + +<!ENTITY a.jhay "John Hay <email>jhay@FreeBSD.ORG</email>"> + +<!ENTITY a.jkh "Jordan K. Hubbard <email>jkh@FreeBSD.ORG</email>"> + +<!ENTITY a.jkoshy "Joseph Koshy <email>jkoshy@FreeBSD.ORG</email>"> + +<!ENTITY a.jlemon "Jonathan Lemon <email>jlemon@FreeBSD.ORG</email>"> + +<!ENTITY a.jlind "John Lind <email>john@starfire.MN.ORG</email>"> + +<!ENTITY a.jlrobin "James L. Robinson <email>jlrobin@FreeBSD.ORG</email>"> + +<!ENTITY a.jmacd "Joshua Peck Macdonald <email>jmacd@FreeBSD.ORG</email>"> + +<!ENTITY a.jmb "Jonathan M. Bresler <email>jmb@FreeBSD.ORG</email>"> + +<!ENTITY a.jmg "John-Mark Gurney <email>jmg@FreeBSD.ORG</email>"> + +<!ENTITY a.jmz "Jean-Marc Zucconi <email>jmz@FreeBSD.ORG</email>"> + +<!ENTITY a.joerg "Jörg Wunsch <email>joerg@FreeBSD.ORG</email>"> + +<!ENTITY a.john "John Cavanaugh <email>john@FreeBSD.ORG</email>"> + +<!ENTITY a.jraynard "James Raynard <email>jraynard@freebsd.org</email>"> + +<!ENTITY a.jseger "Justin Seger <email>jseger@freebsd.org</email>"> + +<!ENTITY a.julian "Julian Elischer <email>julian@FreeBSD.ORG</email>"> + +<!ENTITY a.jvh "Johannes Helander <email>jvh@FreeBSD.ORG</email>"> + +<!ENTITY a.karl "Karl Strickland <email>karl@FreeBSD.ORG</email>"> + +<!ENTITY a.kato "Takenori KATO <email>kato@FreeBSD.ORG</email>"> + +<!ENTITY a.kelly "Sean Kelly <email>kelly@fsl.noaa.gov</email>"> + +<!ENTITY a.ken "Kenneth D. Merry <email>ken@FreeBSD.ORG</email>"> + +<!ENTITY a.kjc "Kenjiro Cho <email>kjc@FreeBSD.ORG</email>"> + +<!ENTITY a.kris "Kris Kennaway <email>kris@FreeBSD.ORG</email>"> + +<!ENTITY a.kuriyama "くりやま <email>kuriyama@FreeBSD.ORG</email>"> + +<!ENTITY a.lars "Lars Fredriksen <email>lars@FreeBSD.ORG</email>"> + +<!ENTITY a.ljo "L Jonas Olsson <email>ljo@FreeBSD.ORG</email>"> + +<!ENTITY a.luoqi "Luoqi Chen <email>luoqi@FreeBSD.ORG</email>"> + +<!ENTITY a.markm "Mark Murray <email>markm@FreeBSD.ORG</email>"> + +<!ENTITY a.martin "Martin Renters <email>martin@FreeBSD.ORG</email>"> + +<!ENTITY a.max "中根 雅文 <email>max@FreeBSD.ORG</email>"> + +<!ENTITY a.mayo "Mark Mayo <email>mark@vmunix.com</email>"> + +<!ENTITY a.mbarkah "Ade Barkah <email>mbarkah@FreeBSD.ORG</email>"> + +<!ENTITY a.mckay "Stephen McKay <email>mckay@FreeBSD.ORG</email>"> + +<!ENTITY a.mckusick "Kirk McKusick <email>mckusick@FreeBSD.ORG</email>"> + +<!ENTITY a.md "Mark Dapoz <email>md@bsc.no</email>"> + +<!ENTITY a.mks "Mike Spengler <email>mks@FreeBSD.ORG</email>"> + +<!ENTITY a.motoyuki "今野 元之 <email>motoyuki@FreeBSD.ORG</email>"> + +<!ENTITY a.mph "Matthew Hunt <email>mph@FreeBSD.ORG</email>"> + +<!ENTITY a.mpp "Mike Pritchard <email>mpp@FreeBSD.ORG</email>"> + +<!ENTITY a.msmith "Michael Smith <email>msmith@FreeBSD.ORG</email>"> + +<!ENTITY a.nate "Nate Williams <email>nate@FreeBSD.ORG</email>"> + +<!ENTITY a.nectar "Jacques Vidrine <email>nectar@FreeBSD.ORG</email>"> + +<!ENTITY a.newton "Mark Newton <email>newton@FreeBSD.ORG</email>"> + +<!ENTITY a.nhibma "Nick Hibma <email>n_hibma@FreeBSD.ORG</email>"> + +<!ENTITY a.nik "Nik Clayton <email>nik@FreeBSD.ORG</email>"> + +<!ENTITY a.nsj "Nate Johnson <email>nsj@FreeBSD.ORG</email>"> + +<!ENTITY a.obrien "David O'Brien <email>obrien@FreeBSD.ORG</email>"> + +<!ENTITY a.olah "Andras Olah <email>olah@FreeBSD.ORG</email>"> + +<!ENTITY a.opsys "Chris Watson <email>opsys@open-systems.net</email>"> + +<!ENTITY a.paul "Paul Richards <email>paul@FreeBSD.ORG</email>"> + +<!ENTITY a.pb "Pierre Beyssac <email>pb@fasterix.freenix.org</email>"> + +<!ENTITY a.pds "Peter da Silva <email>pds@FreeBSD.ORG</email>"> + +<!ENTITY a.peter "Peter Wemm <email>peter@FreeBSD.ORG</email>"> + +<!ENTITY a.phk "Poul-Henning Kamp <email>phk@FreeBSD.ORG</email>"> + +<!ENTITY a.pjc "Peter Childs <email>pjchilds@imforei.apana.org.au</email>"> + +<!ENTITY a.proven "Chris Provenzano <email>proven@FreeBSD.ORG</email>"> + +<!ENTITY a.pst "Paul Traina <email>pst@FreeBSD.ORG</email>"> + +<!ENTITY a.rgrimes "Rodney Grimes <email>rgrimes@FreeBSD.ORG</email>"> + +<!ENTITY a.rhuff "Robert Huff <email>rhuff@cybercom.net</email>"> + +<!ENTITY a.ricardag "Ricardo AG <email>ricardag@ag.com.br</email>"> + +<!ENTITY a.rich "Rich Murphey <email>rich@FreeBSD.ORG</email>"> + +<!ENTITY a.rnordier "Robert Nordier <email>rnordier@FreeBSD.ORG</email>"> + +<!ENTITY a.roberto "Ollivier Robert <email>roberto@FreeBSD.ORG</email>"> + +<!ENTITY a.rse "Ralf S. Engelschall <email>rse@FreeBSD.ORG</email>"> + +<!ENTITY a.sada "佐田 憲治 <email>sada@FreeBSD.ORG</email>"> + +<!ENTITY a.scrappy "Marc G. Fournier <email>scrappy@FreeBSD.ORG</email>"> + +<!ENTITY a.se "Stefan Esser <email>se@FreeBSD.ORG</email>"> + +<!ENTITY a.sef "Sean Eric Fagan <email>sef@FreeBSD.ORG</email>"> + +<!ENTITY a.shige "Shigeyuki Fukushima <email>shige@FreeBSD.ORG</email>"> + +<!ENTITY a.simokawa "Hidetoshi Shimokawa <email>simokawa@FreeBSD.ORG</email>"> + +<!ENTITY a.smace "Scott Mace <email>smace@FreeBSD.ORG</email>"> + +<!ENTITY a.smpatel "Sujal Patel <email>smpatel@FreeBSD.ORG</email>"> + +<!ENTITY a.sos "Søren Schmidt <email>sos@FreeBSD.ORG</email>"> + +<!ENTITY a.stark "Gene Stark <email>stark@FreeBSD.ORG</email>"> + +<!ENTITY a.stb "Stefan Bethke <email>stb@FreeBSD.ORG</email>"> + +<!ENTITY a.steve "Steve Price <email>steve@FreeBSD.ORG</email>"> + +<!ENTITY a.swallace "Steven Wallace <email>swallace@FreeBSD.ORG</email>"> + +<!ENTITY a.tedm "Ted Mittelstaedt <email>tedm@FreeBSD.ORG</email>"> + +<!ENTITY a.tegge "Tor Egge <email>tegge@FreeBSD.ORG</email>"> + +<!ENTITY a.tg "Thomas Gellekum <email>tg@FreeBSD.ORG</email>"> + +<!ENTITY a.thepish "Peter Hawkins <email>thepish@FreeBSD.ORG</email>"> + +<!ENTITY a.torstenb "Torsten Blum <email>torstenb@FreeBSD.ORG</email>"> + +<!ENTITY a.truckman "Don “Truck” Lewis <email>truckman@FreeBSD.ORG</email>"> + +<!ENTITY a.ugen "Ugen J.S.Antsilevich <email>ugen@FreeBSD.ORG</email>"> + +<!ENTITY a.uhclem "Frank Durda IV <email>uhclem@FreeBSD.ORG</email>"> + +<!ENTITY a.ulf "Ulf Zimmermann <email>ulf@FreeBSD.ORG</email>"> + +<!ENTITY a.vanilla "Vanilla I. Shu <email>vanilla@FreeBSD.ORG</email>"> + +<!ENTITY a.wes "Wes Peters <email>wes@FreeBSD.ORG</email>"> + +<!ENTITY a.whiteside "Don Whiteside <email>whiteside@acm.org</email>"> + +<!ENTITY a.wilko "Wilko Bulte <email>wilko@yedi.iaf.nl</email>"> + +<!ENTITY a.wlloyd "Bill Lloyd <email>wlloyd@mpd.ca</email>"> + +<!ENTITY a.wollman "Garrett Wollman <email>wollman@FreeBSD.ORG</email>"> + +<!ENTITY a.wosch "Wolfram Schneider <email>wosch@FreeBSD.ORG</email>"> + +<!ENTITY a.wpaul "Bill Paul <email>wpaul@FreeBSD.ORG</email>"> + +<!ENTITY a.yokota "Kazutaka YOKOTA <email>yokota@FreeBSD.ORG</email>"> + diff --git a/ja_JP.eucJP/share/sgml/jauthors.ent b/ja_JP.eucJP/share/sgml/jauthors.ent new file mode 100644 index 0000000000..cfe025cb9e --- /dev/null +++ b/ja_JP.eucJP/share/sgml/jauthors.ent @@ -0,0 +1,82 @@ +<!-- + The FreeBSD Documentation Project + The FreeBSD Japanese Documentation Project + + Original revision: + $Id: jauthors.ent,v 1.1.1.1 1999-04-08 15:45:57 kuriyama Exp $ + + Names and email address of Japanese local contributing authors and + jaz.jp.freebsd.org CVS committers. + Entity names for committers on jaz should be the same as their login + names on jaz.jp.FreeBSD.ORG. + + Use these entities when referencing people. + + Please keep this list in alphabetical order by entity names. +--> + +<!ENTITY a.jp.arimura "有村 光晴 <email>arimura@jp.FreeBSD.org</email>"> + +<!ENTITY a.jp.candy "神田敏広 <email>candy@fct.kgc.co.jp</email>"> + +<!ENTITY a.jp.condle "森 直之 <email>condle@mcu.or.jp</email>"> + +<!ENTITY a.jp.g92k0323 "狩野 宏樹 <email>g92k0323@cfi.waseda.ac.jp</email>"> + +<!ENTITY a.jp.graphite "石墨 紀孝 <email>graphite@jp.FreeBSD.org</email>"> + +<!ENTITY a.jp.hino "日野 浩志 <email>hino@ccm.cl.nec.co.jp</email>"> + +<!ENTITY a.jp.ikuo "中川 郁夫 <email>ikuo@jp.FreeBSD.org</email>"> + +<!ENTITY a.jp.iwasaki "岩崎 満 <email>iwasaki@jp.FreeBSD.ORG</email>"> + +<!ENTITY a.jp.katsu "勝間田 淳 <email>katsu@baum.kiyose.tokyo.jp</email>"> + +<!ENTITY a.jp.kimura "木村 成伴 <email>kimura@netlab.is.tsukuba.ac.jp</email>"> + +<!ENTITY a.jp.kiroh "はらだ きろう <email>kiroh@jp.FreeBSD.org</email>"> + +<!ENTITY a.jp.kmiyakoda "都田 克郎 <email>kmiyakoda@ctn.co.jp</email>"> + +<!ENTITY a.jp.masaki "櫛田 昌希 <email>masaki@po.iijnet.or.jp</email>"> + +<!ENTITY a.jp.mihoko "田中 美穂子 <email>Mihoko_Tanaka@yokogawa.co.jp</email>"> + +<!ENTITY a.jp.mita "三田 吉郎 <email>mita@jp.FreeBSD.ORG</email>"> + +<!ENTITY a.jp.miyasita "宮下健輔 <email>miyasita@hashilab.ee.ous.ac.jp</email>"> + +<!-- +<!ENTITY a.jp.motoyuki "今野 元之 <email>motoyuki@jp.FreeBSD.org</email>"> +authors.sgml に入っているのでコメントアウト +--> + +<!ENTITY a.jp.mrt "むらたしゅういちろう <email>mrt@mickey.ai.kyutech.ac.jp</email>"> + +<!ENTITY a.jp.nakai "中井 幸博 <email>nakai@mlab.t.u-tokyo.ac.jp</email>"> + +<!ENTITY a.jp.nao "浜田 直樹 <email>nao@tom-yam.or.jp</email>"> + +<!ENTITY a.jp.saeki "佐伯 隆司 <email>saeki@jp.FreeBSD.org</email>"> + +<!ENTITY a.jp.shou "広瀬 昌一 <email>shou@kt.rim.or.jp</email>"> + +<!ENTITY a.jp.simokawa "下川 英敏 <email>simokawa@jp.FreeBSD.org</email>"> + +<!ENTITY a.jp.sugimura "杉村 貴士 <email>taka-su@is.aist-nara.ac.jp</email>"> + +<!ENTITY a.jp.tmaruya "丸山 剛司 <email>tmaruya@nnc.or.jp</email>"> + +<!ENTITY a.jp.tomo "渡辺 智雄 <email>tomo@jp.FreeBSD.ORG</email>"> + +<!ENTITY a.jp.ts "冨田 重成 <email>ts@icu.ac.jp</email>"> + +<!ENTITY a.jp.y-koga "こがよういちろう <email>y-koga@ccs.mt.nec.co.jp</email>"> + +<!ENTITY a.jp.yasu "鈴木 康修 <email>yasu@hike.te.chiba-u.ac.jp</email>"> + +<!ENTITY a.jp.yoshiaki "内川 喜章 <email>yoshiaki@kt.rim.or.jp</email>"> + +<!ENTITY a.jp.yuki "前田 幸範 <email>yuki@jp.FreeBSD.org</email>"> + |