diff --git a/ja/handbook/cvsup.sgml b/ja/handbook/cvsup.sgml index 33db50ada1..ffcd65d376 100644 --- a/ja/handbook/cvsup.sgml +++ b/ja/handbook/cvsup.sgml @@ -1,505 +1,506 @@ - + - + CVSup

原作: &a.jdp;.

訳: &a.iwasaki;.22 February 1997. CVSup の紹介

CVSup は, リモートのサーバホストにあるマスタ CVS リポジトリから ソースツリーを配布し更新するためのソフトウェアパッケージです. FreeBSD のソースは, カリフォルニアにある中心的な開発マシンの CVS リポジトリの 中でメンテナンスしています. CVSup を使用することで, FreeBSD ユーザは 簡単に自分のソースツリーを最新の状態にしておくことができます.

CVSup は "pull" モデルとよばれる更新のモデルを採用しています. pull モデルでは, 各クライアントが更新したい場合に更新したい時点で, サーバに更新の問い合わせをおこないます. サーバはクライアントからの 更新の要求を受け身の状態で待ちます. したがって, すべての更新は クライアント主導でおこなわれます. サーバは頼まれもしない更新情報を 送るようなことはしません. ユーザは CVSup クライアントを手動で実行して 更新をおこなうか, cron ジョブを設定して定期的に自動実行する必要があります.

用語 "CVSup" のように大文字で表記しているものは, ソフトウェアパッケージ 全体を指します. 主な構成物は, 各ユーザマシンで実行するクライアントである "cvsup", FreeBSD の各ミラーサイトで実行するサーバ "cvsupd" です.

FreeBSD の文書やメーリングリストを読んだ際に, sup についての言及を 見かけたかもしれません. sup は CVSup の前に存在していたもので, 同様の 目的で使われていました. CVSup は sup と同じように使用されており, 実際, sup と互換性のあるコンフィグレーションファイルを使用します. しかし, CVSup の方がより高速で柔軟性もあるので, もはや sup は FreeBSD プロジェクトでは使用されていません. CVSup のインストール

FreeBSD 2.2 以降を使用している場合, CVSup をインストールするもっとも 簡単な方法は, FreeBSD または対応する を使うことです. どちらを使うかは, CVSupを自分で作りたいかどうかによります.

FreeBSD-2.1.6 を使用している場合は, 残念ながら FreeBSD-2.1.6 には 存在しないバージョンの C ライブラリが必要となるため バイナリ package は使用できません. しかし, は FreeBSD 2.2 とまったく同じように簡単に使うことができます. 単に tar ファイルを展開し, cvsup ディレクトリへ cd して "make install" とタイプするだけです.

CVSup は で書かれているため, package と port 両方とも Modula-3 ランタイムライブラリがインストールされていることが必要です. これらは port の および package の にあります. これらのライブラリの port や package に対して cvsup と同じ管理方法を取っていれば, CVSup の port や package をインストールする際に, これらのライブラリも自動的に コンパイルそして/またはインストールされます.

Modula-3 ライブラリはかなり大きく, これらの転送やコンパイルはすぐに 終わるものではありません. この理由から, 三つめの選択肢が提供されています. 以下のアメリカ合衆国にある配布サイトのどちらからでも, FreeBSD 用の スタティックリンクされた CVSup 実行形式が入手可能です: (クライアント). (サーバ). また, ドイツのミラーサイトは以下の通りです: (クライアント). (サーバ). 訳注: 日本国内のミラーサイトは以下の通りです: (クライアント). (サーバ).

ほとんどのユーザはクライアントのみが必要になるでしょう. これらの 実行形式は完全に自己完結しており, FreeBSD-2.1.0 から FreeBSD-current までの, どのバージョンでも動作します.

まとめると, CVSup をインストールするための選択肢は以下の通りです: FreeBSD-2.2以降: スタティックバイナリ, port, package FreeBSD-2.1.6: スタティックバイナリ, port FreeBSD-2.1.5 以前: スタティックバイナリ CVSup のコンフィグレーション

CVSup の動作は, "supfile" と呼ばれるコンフィグレーションファイルで 制御します. FreeBSD-2.2 からは, supfile のサンプルがディレクトリ の下にあります. 2.2 以前のシステムを使用している場合は, これらの サンプルを から入手することができます.

supfile には以下の cvsup に関する質問への答えを記述します:

次のセクションで, これらの質問に順番に答えながら典型的な supfile を組み立てていきます. 最初に supfile の全体構造を説明します.

supfile はテキストファイルです. コメントは "#" から行末までです. 空行とコメントだけの行は無視します.

残りの各行には, ユーザが受け取りたいファイル群について記述します. 行の始めは, サーバ側で定義した論理的なファイルのグループである 「コレクション」の名称です. コレクションの名称を指定して, 欲しいファイル群を サーバに伝えます. コレクション名の後には, ホワイトスペースで区切られた 0個以上のフィールドが続きます. これらのフィールドが上記の質問に対する 答えになります. フィールドには 2種類あります: flag フィールドと value フィールドです. flag フィールドは "delete" や "compress" のような 単独のキーワードから成ります. また, value フィールドもキーワードで 始まりますが, キーワードの後にはホワイトスペースは入らず, "=" と 二つめの単語が続きます. 例えば, "release=cvs" は value フィールドです.

通常, supfile には受け取りたいコレクションを一つ以上指定します. supfile を組み立てる一つの方法として, コレクション毎にすべての関係の あるフィールドを明示的に指定する方法があります. しかし, これでは supfile のすべてのコレクションに対してほとんどのフィールドが同じになるため, 行が非常に長くなってしまい不便になります. これらの問題を避けるため, CVSup ではデフォルトを指定することのできるメカニズムが提供されています. 特殊な擬似コレクション名 "*default" で始まる行は, supfile 中の後続の コレクションに対して使用する flag フィールドと value フィールドの デフォルトを設定するために利用できます. 個々のコレクションで固有の値を 指定すると, デフォルト値を無効にできます. また "*default" 行を追加すると, supfile の途中からデフォルト値の変更や追加が可能になります.

これまでの予備知識を基に, のメインのソースツリーを受け取って更新するための supfile を 組み立ててみましょう. どのファイルを受け取りたいのか?

sup の場合と同様に, CVSup を通して入手できるファイルは 「コレクション」と呼ばれる名前の付けられたグループにまとめられています. 利用可能なコレクションについては で説明しています. ここでは, FreeBSD システムのメインのソースツリー全体 を受け取るための設定例を紹介します. 輸出規制されている暗号化サポートのコード以外のすべてを含む "src-all" という 単一の大きなコレクションがあります. この例では私たちがアメリカ合衆国か カナダにいるものと仮定します. その場合, "cvs-crypto" という一つの付化的な コレクションで暗号化コードを入手することができます. supfile を組み立てる最初のステップとして, これらのコレクションを一行に一つづつ 記述します: src-all cvs-crypto

どのバージョンのものが欲しいのか?

CVSup を使用すると, かつて存在していたことのある, 事実上どのバージョンの ソースでも受け取ることができます. これは cvsupd サーバがすべてのバージョンを含む CVS リポジトリに基づいて動作することにより, 実現されています. "tag=" および "date=" の value フィールドを使用して, 欲しいバージョンの 一つを指定します.

"tag=" フィールドはリポジトリ中のシンボリックタグを指定します. tag には revision tag と branch tag の二種類があります. revision tag は特定のリビジョンを指します. これは, 毎日同じ状態に保つことになります. 一方 branch tag は, ある時点での開発分流の最新のリビジョンを指します. branch tag は特定のリビジョンを指定している訳ではないので, 今日と明日では 異なるリビジョンを参照することになるかもしれません.

以下はユーザが興味を持っていると思われる branch tag です:

以下はユーザが興味を持っていると思われる revision tag です:

tag 名を示した通りにタイプされているか十分注意してください. CVSup は tag 名が正しいかどうかを見分けることはできません. tag が間違っていた場合, たまたまファイルがまったく存在しない正しい tag が指定されたものとしてCVSup は動作します. その場合は, 現在あるソースが 削除されるでしょう.

branch tag を指定した際には, 通常はその開発分流の最新バージョンの ファイルを受け取ります. いくらか前のバージョンを受け取りたい場合は, "date=" の value フィールドを使って日付を指定することで, これを実現することが できます. cvsup(1) のマニュアルページで, その方法を説明しています.

例として, FreeBSD-current を受け取りたいとします. 次の行を supfile の始めに追加します: *default tag=.

"tag=" フィールドも "date=" フィールドも指定しなかった場合に 動き出す重要な特殊なケースがあります. そのケースでは, 特定のバージョンの ファイルを受け取るのではなく, サーバの CVS リポジトリから実際の RCS ファイルを直接受け取ります. 一般的に開発者はこの処理のモードが 好きなようです. 彼らのシステム上にリポジトリそのもののコピーを維持することで, リビジョン履歴を閲覧し過去のバージョンのファイルを検査できるようになります. しかし, これには大きなディスクスペースが必要になります.

どこから入手したいのか?

これは簡単なことです. cvsup に第一の FreeBSD 配布サイト -"cvsup.FreeBSD.org" から最新情報を持ってくるように伝える "host=" -フィールドを使います: +

更新情報をどこから入手するかを cvsup に伝えるために "host=" +フィールドを使用します。 +のどこからでも入手できますが、最寄りのサイトを選ぶべきでしょう。 +この例では、第一の FreeBSD 配布サイト "cvsup.FreeBSD.org" を使用します: *default host=cvsup.FreeBSD.org

どのように cvsup を実行しても, この設定は "-h hostname" を 使用してコマンドラインで変更することができます.

自分のマシンのどこに置きたいのか?

"prefix=" フィールドは, cvsup に受け取ったファイルをどこに置くかを 伝えます. この例では, ソースファイルを直接メインのソースツリー "/usr/src" に置きます. "src" ディレクトリはすでにファイルを受け取るために 選択したコレクションで暗黙に指定しているので, これは正しい仕様となります: *default prefix=/usr

どこに status ファイルを置きたいのか?

cvsup クライアントは "base" ディレクトリと呼ばれる場所に, ある status ファイルを維持しています. すでに受け取った更新情報を追従し続け ることで, これらのファイルは CVSup がより効果的に動作することを支援し ます. 標準の base ディレクトリ "/usr/local/etc/cvsup" を使用します: *default base=/usr/local/etc/cvsup

supfile に指定がない場合は, この設定をデフォルトで使用しますので, 実際には上の行は必要ありません.

base ディレクトリが存在しない場合は作成しておきましょう. base ディレクトリが存在しない場合, cvsup クライアントは実行を拒否します.

その他もろもろの supfileの設定:

通常 supfile に入れておくべき行がもう一つあります: *default release=cvs delete use-rel-suffix compress

"release=cvs" は, サーバがメインの FreeBSD CVS リポジトリから その情報を取得するように指示します. ほとんどの場合はこのようにしておきますが, ここでの説明の範疇をこえるような状況では他の指定をすることも可能です.

"delete" は CVSup にファイルを削除することを許可します. CVSup が ソースツリーを完全に最新の状態に保てるようにするためには, これは常に 指定しておくべきでしょう. CVSup は, これらの責任範囲のファイルだけを 慎重に削除します. たまたま存在する他の余分なファイルについては, まったく手をつけずに残しておきます.

"use-rel-suffix" は ... 神秘的なものです. これについて本当に 知りたい人は, cvsup(1) のマニュアルページをご覧ください. でなければ, 何も考えずに指定してみてください.

"compress" は通信チャネルで gzip 形式の圧縮の使用を有効にします. ご使用のネットワーク接続が T1 speed 以上である場合, この圧縮を 使用しない方がよいかもしれません. そうでない場合は十分に役に立ちます.

supfile の例のまとめ:

以下は supfile の例の全体です: *default tag=. *default host=cvsup.FreeBSD.org *default prefix=/usr *default base=/usr/local/etc/cvsup *default release=cvs delete use-rel-suffix compress src-all cvs-crypto CVSup の実行

さて, 更新の準備ができました. これを実行するコマンドラインは 実に簡単です: cvsup supfile

もちろん, ここでの "supfile" は作成したばかりの supfile のファイル名です. X11 環境で実行するものと仮定して, cvsup は 通常の操作に必要なボタンを持つ GUI ウィンドウを表示します. "go" ボタンを押して, 実行を監視してください.

この例では実際の "/usr/src" ツリーを更新しているので, cvsup にファイルを更新するのに必要なパーミッションを与えるために, ユーザ root で実行する必要があります. コンフィグレーションファイルを作ったばかりで, しかも以前にこのプログラムを実行したことがないので, 神経質になるのは 無理もない話だと思います. 大切なファイルに触らずに試しに実行する簡単な 方法があります. どこか適当な場所に空のディレクトリを作成して, コマンドラインの引数で指定するだけです: mkdir /var/tmp/dest cvsup supfile /var/tmp/dest

指定したディレクトリは, すべての更新されるファイルの 更新先ディレクトリとして使用します. CVSup は "/usr/src" の下の ファイルを検査しますが, 変更や削除はまったくおこないません. かわりに "/var/tmp/dest/usr/src" に更新されたすべてのファイルが 置かれるようになります. この方法で実行した場合は, CVSup は base ディレクトリの status ファイルを更新せずにそのままにします. これらのファイルの新しいバージョンは指定されたディレクトリ に書き込まれます. "/usr/src" の読み取り許可がある限り, このような 試し実行のためにユーザ root になる必要はありません.

X11 を利用していないとか単に GUI が気に入らない場合は, cvsup 起動時にコマンドラインに二つほどオプションを追加する必要があります: cvsup -g -L 2 supfile

"-g" オプションは cvsup に GUI を使用しないように伝えます. X11 を利用していない場合には自動的に指定されますが, そうでない場合は 明示的に指定します.

"-L 2" オプションは cvsup にファイル更新中の詳細情報をプリントアウト するように伝えます. 冗長性には "-L 0" から "-L 2" までの三つのレベル があります. デフォルトは 0 であり, エラーメッセージ以外はまったく出力 しません.

たくさんの他のオプション変数があります. それらの簡単な一覧は "cvsup -H" で表示されます. より詳しい説明はマニュアルページをご覧ください.

動作している更新の方法に満足したら, cron(8) を使って cvsup を定期的に 実行させる準備をすることができます. cron から起動する際には, 明示的に cvsup が GUI を使わないようにする必要があります. CVSup ファイルコレクション

CVSup 経由で入手できるファイルコレクションは階層的に組織化されています. いくつか大きなコレクションがあり, それらは小さなサブコレクションに 分割されています. 大きなコレクションは, そのサブコレクション毎に 受信することと同じことになります. 下の一覧ではコレクション間の階層関係を 字下げして表現します.

最も一般的に使用するコレクションは cvs-all release=cvs メインの FreeBSD CVS リポジトリであり, 輸出規制された暗号化コードは含まれていません.

distrib release=cvs FreeBSD の配布とミラーに関連するファイルです. ports-all release=cvs FreeBSD の ports コレクションです.

ports-archivers release=cvs

ports-astro release=cvs

ports-audio release=cvs

ports-base release=cvs

ports-benchmarks release=cvs

ports-cad release=cvs

ports-chinese release=cvs

ports-comms release=cvs

ports-databases release=cvs

ports-devel release=cvs

ports-editors release=cvs

ports-emulators release=cvs

ports-games release=cvs

ports-graphics release=cvs

ports-japanese release=cvs

ports-lang release=cvs

ports-mail release=cvs

ports-math release=cvs

ports-mbone release=cvs

ports-misc release=cvs

ports-net release=cvs

ports-news release=cvs

ports-plan9 release=cvs

ports-print release=cvs

ports-russian release=cvs

ports-security release=cvs

ports-shells release=cvs

ports-sysutils release=cvs

ports-vietnamese release=cvs

ports-www release=cvs

ports-x11 release=cvs

src-all release=cvs メインの FreeBSD ソース群であり, 輸出規制された暗号化コードは含まれていません.

src-base/cvs

src-bin/cvs

src-contrib/cvs

src-etc/cvs

src-games/cvs

src-gnu/cvs

src-include/cvs

src-lib/cvs

src-libexec/cvs

src-release/cvs

src-sbin/cvs

src-share/cvs

src-sys/cvs

src-tools/cvs

src-usrbin/cvs

src-usrsbin/cvs

www release=cvs World Wide Web のデータ用のソースです. cvs-crypto release=cvs 輸出規制された暗号化コードです.

src-eBones release=cvs

src-secure release=cvs

distrib release=self CVSup サーバ自身のコンフィグレーションファイルです. gnats release=current GNATS バグトラッキングデータベースです. src-sys release=lite2 lite2 kernel のマージ用の CVS リポジトリです. src-sys release=smp SMP プロジェクト用の CVS リポジトリです. www release=current インストールされた World Wide Web のデータです. CVSup のアナウンス, 質問およびバグ報告

CVSup のほとんどの FreeBSD 関連の議論は &a.hackers; で おこなわれています. ソフトウェアの新しいバージョンは &a.announce; で アナウンスされます.

質問とバグ報告はプログラムの作者, へ 送ってください. diff --git a/ja/handbook/mirrors.sgml b/ja/handbook/mirrors.sgml index 4f06aa7331..51262b9e20 100644 --- a/ja/handbook/mirrors.sgml +++ b/ja/handbook/mirrors.sgml @@ -1,584 +1,672 @@ - + - + FreeBSD の入手方法 -

FreeBSD の公式な情報は anonymous FTP によって以下の場所から -入手できます: - - - -また Walnut Creek CDROM から出ている CD-ROM からも入手できます: +CD-ROM 出版社 + +

FreeBSD は Walnut Creek CDROM から出されている CD-ROM から入手できます: Walnut Creek CDROM 1547 Palos Verdes Mall, Suite 260 Walnut Creek CA 94596 USA Phone: +1 510 674-0783 Fax: +1 510 674-0821 Email: WWW: +FTP サイト + +

FreeBSD の公式な情報は anonymous FTP によって以下の場所から +入手できます: + +. + +

さらに, FreeBSD は以下のミラーサイトから anonymous FTP によって 入手できます. もし FreeBSD を anonymous FTP によって手にいれる場合は, 近くのサイトを利用するようにしてください. , , , , , , , , , , , , , , , , , , , , , , . 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 連絡先: . 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 連絡先: . 何か問題がある場合は, このドメインの に連絡してください. 連絡先: . 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 連絡先: . 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 連絡先: . 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. FreeBSD (2.0C またはそれ以降) の輸出規制コード (eBones と secure) の 最新のバージョンは以下の場所から入手できます. もしあなたがアメリカやカナダ以外にいるのであれば, secure (DES) と eBones (Kerberos) を 以下の外国向けの配布サイトから手にいれてください: 南アフリカ このドメインの . ブラジル このドメインの . フィンランド 連絡先: . -

CTM/FreeBSD は以下のミラーサイトから anonymous FTP によって 入手できます. もし CTM を anonymous FTP によって手にいれる場合は, 近くのサイトを利用するようにしてください. 何か問題がある場合は, &a.phk;に連絡してください. カリフォルニア, サンフランシスコ近辺, 公式なソース ドイツ, ベルリン ドイツ, トリエル 南アフリカ, ctm, sup, CVSupなどの古い差分ファイルのバックアップサーバ 台湾/中華民国, チャーイー(嘉義) 近くにミラーサイトがない場合やミラーが不完全な場合は, を試してください. FTP search はノルウェーの Trondheim にある, フリーの素晴らしい アーカイブサーバです. + +CVSup サイト + +

FreeBSD の CVSup サーバは以下のサイトで稼働しています: + + + +アルゼンチン + +cvsup.ar.FreeBSD.ORG +() + + +オーストラリア + +cvsup.au.FreeBSD.ORG +() + + +ドイツ + +cvsup.de.FreeBSD.ORG +() + + +日本 + +cvsup.jp.FreeBSD.ORG +() + + +オランダ + +cvsup.nl.FreeBSD.ORG +() + + +ノルウェー + +cvsup.no.FreeBSD.ORG +() + + +南アフリカ + +cvsup.za.FreeBSD.ORG +() + + +台湾 + +sup.tw.FreeBSD.ORG +() + + +アメリカ + +cvsup.FreeBSD.ORG +() +cvsup2.FreeBSD.ORG +() +cvsup4.FreeBSD.ORG +() +cvsup5.FreeBSD.ORG +() + + + + +FreeBSD の輸出規制されたコード (eBones と secure) は CVSup 経由で以下 +の国際的なリポジトリから入手できます. アメリカ合衆国やカナダ以外に居る +場合は, このサイトを使って輸出規制されたコードを入手してください. + + + +南アフリカ + +cvsup.internat.FreeBSD.ORG +() + + + diff --git a/ja_JP.EUC/handbook/cvsup.sgml b/ja_JP.EUC/handbook/cvsup.sgml index 33db50ada1..ffcd65d376 100644 --- a/ja_JP.EUC/handbook/cvsup.sgml +++ b/ja_JP.EUC/handbook/cvsup.sgml @@ -1,505 +1,506 @@ - + - + CVSup

原作: &a.jdp;.

訳: &a.iwasaki;.22 February 1997. CVSup の紹介

CVSup は, リモートのサーバホストにあるマスタ CVS リポジトリから ソースツリーを配布し更新するためのソフトウェアパッケージです. FreeBSD のソースは, カリフォルニアにある中心的な開発マシンの CVS リポジトリの 中でメンテナンスしています. CVSup を使用することで, FreeBSD ユーザは 簡単に自分のソースツリーを最新の状態にしておくことができます.

CVSup は "pull" モデルとよばれる更新のモデルを採用しています. pull モデルでは, 各クライアントが更新したい場合に更新したい時点で, サーバに更新の問い合わせをおこないます. サーバはクライアントからの 更新の要求を受け身の状態で待ちます. したがって, すべての更新は クライアント主導でおこなわれます. サーバは頼まれもしない更新情報を 送るようなことはしません. ユーザは CVSup クライアントを手動で実行して 更新をおこなうか, cron ジョブを設定して定期的に自動実行する必要があります.

用語 "CVSup" のように大文字で表記しているものは, ソフトウェアパッケージ 全体を指します. 主な構成物は, 各ユーザマシンで実行するクライアントである "cvsup", FreeBSD の各ミラーサイトで実行するサーバ "cvsupd" です.

FreeBSD の文書やメーリングリストを読んだ際に, sup についての言及を 見かけたかもしれません. sup は CVSup の前に存在していたもので, 同様の 目的で使われていました. CVSup は sup と同じように使用されており, 実際, sup と互換性のあるコンフィグレーションファイルを使用します. しかし, CVSup の方がより高速で柔軟性もあるので, もはや sup は FreeBSD プロジェクトでは使用されていません. CVSup のインストール

FreeBSD 2.2 以降を使用している場合, CVSup をインストールするもっとも 簡単な方法は, FreeBSD または対応する を使うことです. どちらを使うかは, CVSupを自分で作りたいかどうかによります.

FreeBSD-2.1.6 を使用している場合は, 残念ながら FreeBSD-2.1.6 には 存在しないバージョンの C ライブラリが必要となるため バイナリ package は使用できません. しかし, は FreeBSD 2.2 とまったく同じように簡単に使うことができます. 単に tar ファイルを展開し, cvsup ディレクトリへ cd して "make install" とタイプするだけです.

CVSup は で書かれているため, package と port 両方とも Modula-3 ランタイムライブラリがインストールされていることが必要です. これらは port の および package の にあります. これらのライブラリの port や package に対して cvsup と同じ管理方法を取っていれば, CVSup の port や package をインストールする際に, これらのライブラリも自動的に コンパイルそして/またはインストールされます.

Modula-3 ライブラリはかなり大きく, これらの転送やコンパイルはすぐに 終わるものではありません. この理由から, 三つめの選択肢が提供されています. 以下のアメリカ合衆国にある配布サイトのどちらからでも, FreeBSD 用の スタティックリンクされた CVSup 実行形式が入手可能です: (クライアント). (サーバ). また, ドイツのミラーサイトは以下の通りです: (クライアント). (サーバ). 訳注: 日本国内のミラーサイトは以下の通りです: (クライアント). (サーバ).

ほとんどのユーザはクライアントのみが必要になるでしょう. これらの 実行形式は完全に自己完結しており, FreeBSD-2.1.0 から FreeBSD-current までの, どのバージョンでも動作します.

まとめると, CVSup をインストールするための選択肢は以下の通りです: FreeBSD-2.2以降: スタティックバイナリ, port, package FreeBSD-2.1.6: スタティックバイナリ, port FreeBSD-2.1.5 以前: スタティックバイナリ CVSup のコンフィグレーション

CVSup の動作は, "supfile" と呼ばれるコンフィグレーションファイルで 制御します. FreeBSD-2.2 からは, supfile のサンプルがディレクトリ の下にあります. 2.2 以前のシステムを使用している場合は, これらの サンプルを から入手することができます.

supfile には以下の cvsup に関する質問への答えを記述します:

次のセクションで, これらの質問に順番に答えながら典型的な supfile を組み立てていきます. 最初に supfile の全体構造を説明します.

supfile はテキストファイルです. コメントは "#" から行末までです. 空行とコメントだけの行は無視します.

残りの各行には, ユーザが受け取りたいファイル群について記述します. 行の始めは, サーバ側で定義した論理的なファイルのグループである 「コレクション」の名称です. コレクションの名称を指定して, 欲しいファイル群を サーバに伝えます. コレクション名の後には, ホワイトスペースで区切られた 0個以上のフィールドが続きます. これらのフィールドが上記の質問に対する 答えになります. フィールドには 2種類あります: flag フィールドと value フィールドです. flag フィールドは "delete" や "compress" のような 単独のキーワードから成ります. また, value フィールドもキーワードで 始まりますが, キーワードの後にはホワイトスペースは入らず, "=" と 二つめの単語が続きます. 例えば, "release=cvs" は value フィールドです.

通常, supfile には受け取りたいコレクションを一つ以上指定します. supfile を組み立てる一つの方法として, コレクション毎にすべての関係の あるフィールドを明示的に指定する方法があります. しかし, これでは supfile のすべてのコレクションに対してほとんどのフィールドが同じになるため, 行が非常に長くなってしまい不便になります. これらの問題を避けるため, CVSup ではデフォルトを指定することのできるメカニズムが提供されています. 特殊な擬似コレクション名 "*default" で始まる行は, supfile 中の後続の コレクションに対して使用する flag フィールドと value フィールドの デフォルトを設定するために利用できます. 個々のコレクションで固有の値を 指定すると, デフォルト値を無効にできます. また "*default" 行を追加すると, supfile の途中からデフォルト値の変更や追加が可能になります.

これまでの予備知識を基に, のメインのソースツリーを受け取って更新するための supfile を 組み立ててみましょう. どのファイルを受け取りたいのか?

sup の場合と同様に, CVSup を通して入手できるファイルは 「コレクション」と呼ばれる名前の付けられたグループにまとめられています. 利用可能なコレクションについては で説明しています. ここでは, FreeBSD システムのメインのソースツリー全体 を受け取るための設定例を紹介します. 輸出規制されている暗号化サポートのコード以外のすべてを含む "src-all" という 単一の大きなコレクションがあります. この例では私たちがアメリカ合衆国か カナダにいるものと仮定します. その場合, "cvs-crypto" という一つの付化的な コレクションで暗号化コードを入手することができます. supfile を組み立てる最初のステップとして, これらのコレクションを一行に一つづつ 記述します: src-all cvs-crypto

どのバージョンのものが欲しいのか?

CVSup を使用すると, かつて存在していたことのある, 事実上どのバージョンの ソースでも受け取ることができます. これは cvsupd サーバがすべてのバージョンを含む CVS リポジトリに基づいて動作することにより, 実現されています. "tag=" および "date=" の value フィールドを使用して, 欲しいバージョンの 一つを指定します.

"tag=" フィールドはリポジトリ中のシンボリックタグを指定します. tag には revision tag と branch tag の二種類があります. revision tag は特定のリビジョンを指します. これは, 毎日同じ状態に保つことになります. 一方 branch tag は, ある時点での開発分流の最新のリビジョンを指します. branch tag は特定のリビジョンを指定している訳ではないので, 今日と明日では 異なるリビジョンを参照することになるかもしれません.

以下はユーザが興味を持っていると思われる branch tag です:

以下はユーザが興味を持っていると思われる revision tag です:

tag 名を示した通りにタイプされているか十分注意してください. CVSup は tag 名が正しいかどうかを見分けることはできません. tag が間違っていた場合, たまたまファイルがまったく存在しない正しい tag が指定されたものとしてCVSup は動作します. その場合は, 現在あるソースが 削除されるでしょう.

branch tag を指定した際には, 通常はその開発分流の最新バージョンの ファイルを受け取ります. いくらか前のバージョンを受け取りたい場合は, "date=" の value フィールドを使って日付を指定することで, これを実現することが できます. cvsup(1) のマニュアルページで, その方法を説明しています.

例として, FreeBSD-current を受け取りたいとします. 次の行を supfile の始めに追加します: *default tag=.

"tag=" フィールドも "date=" フィールドも指定しなかった場合に 動き出す重要な特殊なケースがあります. そのケースでは, 特定のバージョンの ファイルを受け取るのではなく, サーバの CVS リポジトリから実際の RCS ファイルを直接受け取ります. 一般的に開発者はこの処理のモードが 好きなようです. 彼らのシステム上にリポジトリそのもののコピーを維持することで, リビジョン履歴を閲覧し過去のバージョンのファイルを検査できるようになります. しかし, これには大きなディスクスペースが必要になります.

どこから入手したいのか?

これは簡単なことです. cvsup に第一の FreeBSD 配布サイト -"cvsup.FreeBSD.org" から最新情報を持ってくるように伝える "host=" -フィールドを使います: +

更新情報をどこから入手するかを cvsup に伝えるために "host=" +フィールドを使用します。 +のどこからでも入手できますが、最寄りのサイトを選ぶべきでしょう。 +この例では、第一の FreeBSD 配布サイト "cvsup.FreeBSD.org" を使用します: *default host=cvsup.FreeBSD.org

どのように cvsup を実行しても, この設定は "-h hostname" を 使用してコマンドラインで変更することができます.

自分のマシンのどこに置きたいのか?

"prefix=" フィールドは, cvsup に受け取ったファイルをどこに置くかを 伝えます. この例では, ソースファイルを直接メインのソースツリー "/usr/src" に置きます. "src" ディレクトリはすでにファイルを受け取るために 選択したコレクションで暗黙に指定しているので, これは正しい仕様となります: *default prefix=/usr

どこに status ファイルを置きたいのか?

cvsup クライアントは "base" ディレクトリと呼ばれる場所に, ある status ファイルを維持しています. すでに受け取った更新情報を追従し続け ることで, これらのファイルは CVSup がより効果的に動作することを支援し ます. 標準の base ディレクトリ "/usr/local/etc/cvsup" を使用します: *default base=/usr/local/etc/cvsup

supfile に指定がない場合は, この設定をデフォルトで使用しますので, 実際には上の行は必要ありません.

base ディレクトリが存在しない場合は作成しておきましょう. base ディレクトリが存在しない場合, cvsup クライアントは実行を拒否します.

その他もろもろの supfileの設定:

通常 supfile に入れておくべき行がもう一つあります: *default release=cvs delete use-rel-suffix compress

"release=cvs" は, サーバがメインの FreeBSD CVS リポジトリから その情報を取得するように指示します. ほとんどの場合はこのようにしておきますが, ここでの説明の範疇をこえるような状況では他の指定をすることも可能です.

"delete" は CVSup にファイルを削除することを許可します. CVSup が ソースツリーを完全に最新の状態に保てるようにするためには, これは常に 指定しておくべきでしょう. CVSup は, これらの責任範囲のファイルだけを 慎重に削除します. たまたま存在する他の余分なファイルについては, まったく手をつけずに残しておきます.

"use-rel-suffix" は ... 神秘的なものです. これについて本当に 知りたい人は, cvsup(1) のマニュアルページをご覧ください. でなければ, 何も考えずに指定してみてください.

"compress" は通信チャネルで gzip 形式の圧縮の使用を有効にします. ご使用のネットワーク接続が T1 speed 以上である場合, この圧縮を 使用しない方がよいかもしれません. そうでない場合は十分に役に立ちます.

supfile の例のまとめ:

以下は supfile の例の全体です: *default tag=. *default host=cvsup.FreeBSD.org *default prefix=/usr *default base=/usr/local/etc/cvsup *default release=cvs delete use-rel-suffix compress src-all cvs-crypto CVSup の実行

さて, 更新の準備ができました. これを実行するコマンドラインは 実に簡単です: cvsup supfile

もちろん, ここでの "supfile" は作成したばかりの supfile のファイル名です. X11 環境で実行するものと仮定して, cvsup は 通常の操作に必要なボタンを持つ GUI ウィンドウを表示します. "go" ボタンを押して, 実行を監視してください.

この例では実際の "/usr/src" ツリーを更新しているので, cvsup にファイルを更新するのに必要なパーミッションを与えるために, ユーザ root で実行する必要があります. コンフィグレーションファイルを作ったばかりで, しかも以前にこのプログラムを実行したことがないので, 神経質になるのは 無理もない話だと思います. 大切なファイルに触らずに試しに実行する簡単な 方法があります. どこか適当な場所に空のディレクトリを作成して, コマンドラインの引数で指定するだけです: mkdir /var/tmp/dest cvsup supfile /var/tmp/dest

指定したディレクトリは, すべての更新されるファイルの 更新先ディレクトリとして使用します. CVSup は "/usr/src" の下の ファイルを検査しますが, 変更や削除はまったくおこないません. かわりに "/var/tmp/dest/usr/src" に更新されたすべてのファイルが 置かれるようになります. この方法で実行した場合は, CVSup は base ディレクトリの status ファイルを更新せずにそのままにします. これらのファイルの新しいバージョンは指定されたディレクトリ に書き込まれます. "/usr/src" の読み取り許可がある限り, このような 試し実行のためにユーザ root になる必要はありません.

X11 を利用していないとか単に GUI が気に入らない場合は, cvsup 起動時にコマンドラインに二つほどオプションを追加する必要があります: cvsup -g -L 2 supfile

"-g" オプションは cvsup に GUI を使用しないように伝えます. X11 を利用していない場合には自動的に指定されますが, そうでない場合は 明示的に指定します.

"-L 2" オプションは cvsup にファイル更新中の詳細情報をプリントアウト するように伝えます. 冗長性には "-L 0" から "-L 2" までの三つのレベル があります. デフォルトは 0 であり, エラーメッセージ以外はまったく出力 しません.

たくさんの他のオプション変数があります. それらの簡単な一覧は "cvsup -H" で表示されます. より詳しい説明はマニュアルページをご覧ください.

動作している更新の方法に満足したら, cron(8) を使って cvsup を定期的に 実行させる準備をすることができます. cron から起動する際には, 明示的に cvsup が GUI を使わないようにする必要があります. CVSup ファイルコレクション

CVSup 経由で入手できるファイルコレクションは階層的に組織化されています. いくつか大きなコレクションがあり, それらは小さなサブコレクションに 分割されています. 大きなコレクションは, そのサブコレクション毎に 受信することと同じことになります. 下の一覧ではコレクション間の階層関係を 字下げして表現します.

最も一般的に使用するコレクションは cvs-all release=cvs メインの FreeBSD CVS リポジトリであり, 輸出規制された暗号化コードは含まれていません.

distrib release=cvs FreeBSD の配布とミラーに関連するファイルです. ports-all release=cvs FreeBSD の ports コレクションです.

ports-archivers release=cvs

ports-astro release=cvs

ports-audio release=cvs

ports-base release=cvs

ports-benchmarks release=cvs

ports-cad release=cvs

ports-chinese release=cvs

ports-comms release=cvs

ports-databases release=cvs

ports-devel release=cvs

ports-editors release=cvs

ports-emulators release=cvs

ports-games release=cvs

ports-graphics release=cvs

ports-japanese release=cvs

ports-lang release=cvs

ports-mail release=cvs

ports-math release=cvs

ports-mbone release=cvs

ports-misc release=cvs

ports-net release=cvs

ports-news release=cvs

ports-plan9 release=cvs

ports-print release=cvs

ports-russian release=cvs

ports-security release=cvs

ports-shells release=cvs

ports-sysutils release=cvs

ports-vietnamese release=cvs

ports-www release=cvs

ports-x11 release=cvs

src-all release=cvs メインの FreeBSD ソース群であり, 輸出規制された暗号化コードは含まれていません.

src-base/cvs

src-bin/cvs

src-contrib/cvs

src-etc/cvs

src-games/cvs

src-gnu/cvs

src-include/cvs

src-lib/cvs

src-libexec/cvs

src-release/cvs

src-sbin/cvs

src-share/cvs

src-sys/cvs

src-tools/cvs

src-usrbin/cvs

src-usrsbin/cvs

www release=cvs World Wide Web のデータ用のソースです. cvs-crypto release=cvs 輸出規制された暗号化コードです.

src-eBones release=cvs

src-secure release=cvs

distrib release=self CVSup サーバ自身のコンフィグレーションファイルです. gnats release=current GNATS バグトラッキングデータベースです. src-sys release=lite2 lite2 kernel のマージ用の CVS リポジトリです. src-sys release=smp SMP プロジェクト用の CVS リポジトリです. www release=current インストールされた World Wide Web のデータです. CVSup のアナウンス, 質問およびバグ報告

CVSup のほとんどの FreeBSD 関連の議論は &a.hackers; で おこなわれています. ソフトウェアの新しいバージョンは &a.announce; で アナウンスされます.

質問とバグ報告はプログラムの作者, へ 送ってください. diff --git a/ja_JP.EUC/handbook/mirrors.sgml b/ja_JP.EUC/handbook/mirrors.sgml index 4f06aa7331..51262b9e20 100644 --- a/ja_JP.EUC/handbook/mirrors.sgml +++ b/ja_JP.EUC/handbook/mirrors.sgml @@ -1,584 +1,672 @@ - + - + FreeBSD の入手方法 -

FreeBSD の公式な情報は anonymous FTP によって以下の場所から -入手できます: - - - -また Walnut Creek CDROM から出ている CD-ROM からも入手できます: +CD-ROM 出版社 + +

FreeBSD は Walnut Creek CDROM から出されている CD-ROM から入手できます: Walnut Creek CDROM 1547 Palos Verdes Mall, Suite 260 Walnut Creek CA 94596 USA Phone: +1 510 674-0783 Fax: +1 510 674-0821 Email: WWW: +FTP サイト + +

FreeBSD の公式な情報は anonymous FTP によって以下の場所から +入手できます: + +. + +

さらに, FreeBSD は以下のミラーサイトから anonymous FTP によって 入手できます. もし FreeBSD を anonymous FTP によって手にいれる場合は, 近くのサイトを利用するようにしてください. , , , , , , , , , , , , , , , , , , , , , , . 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 連絡先: . 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 連絡先: . 何か問題がある場合は, このドメインの に連絡してください. 連絡先: . 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 連絡先: . 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. 連絡先: . 何か問題がある場合は, このドメインの に連絡してください. 何か問題がある場合は, このドメインの に連絡してください. FreeBSD (2.0C またはそれ以降) の輸出規制コード (eBones と secure) の 最新のバージョンは以下の場所から入手できます. もしあなたがアメリカやカナダ以外にいるのであれば, secure (DES) と eBones (Kerberos) を 以下の外国向けの配布サイトから手にいれてください: 南アフリカ このドメインの . ブラジル このドメインの . フィンランド 連絡先: . -

CTM/FreeBSD は以下のミラーサイトから anonymous FTP によって 入手できます. もし CTM を anonymous FTP によって手にいれる場合は, 近くのサイトを利用するようにしてください. 何か問題がある場合は, &a.phk;に連絡してください. カリフォルニア, サンフランシスコ近辺, 公式なソース ドイツ, ベルリン ドイツ, トリエル 南アフリカ, ctm, sup, CVSupなどの古い差分ファイルのバックアップサーバ 台湾/中華民国, チャーイー(嘉義) 近くにミラーサイトがない場合やミラーが不完全な場合は, を試してください. FTP search はノルウェーの Trondheim にある, フリーの素晴らしい アーカイブサーバです. + +CVSup サイト + +

FreeBSD の CVSup サーバは以下のサイトで稼働しています: + + + +アルゼンチン + +cvsup.ar.FreeBSD.ORG +() + + +オーストラリア + +cvsup.au.FreeBSD.ORG +() + + +ドイツ + +cvsup.de.FreeBSD.ORG +() + + +日本 + +cvsup.jp.FreeBSD.ORG +() + + +オランダ + +cvsup.nl.FreeBSD.ORG +() + + +ノルウェー + +cvsup.no.FreeBSD.ORG +() + + +南アフリカ + +cvsup.za.FreeBSD.ORG +() + + +台湾 + +sup.tw.FreeBSD.ORG +() + + +アメリカ + +cvsup.FreeBSD.ORG +() +cvsup2.FreeBSD.ORG +() +cvsup4.FreeBSD.ORG +() +cvsup5.FreeBSD.ORG +() + + + + +FreeBSD の輸出規制されたコード (eBones と secure) は CVSup 経由で以下 +の国際的なリポジトリから入手できます. アメリカ合衆国やカナダ以外に居る +場合は, このサイトを使って輸出規制されたコードを入手してください. + + + +南アフリカ + +cvsup.internat.FreeBSD.ORG +() + + +