名称

rcs − RCS ファイルの属性を変更する

形式

rcs [ options ] file ... 

解説

rcs は、新しい RCS ファイルを作成したり、 存在するファイルの属性を変更したりします。 RCS ファイルは、複数のテキストのリビジョン、アクセスリスト、 変更ログ、説明文、そしていくつかの制御属性を含んでいます。 rcs を実行する時には、 実行者のログイン名がアクセスリスト上になければなりません。 しかしアクセスリストが空の場合か、 実行者がファイルの所有者またはスーパーユーザである場合か、 −i オプションが与えられた場合には、その限りではありません。

‘,v’ で終るファイル名を持つファイルは RCS ファイルとして、 その他のファイルは作業ファイルとして扱われます。 co(1) で説明されているとおり、 作業ファイルが指定された場合、 rcs は関連する RCS ファイルを、 まずディレクトリ ./RCS 内、続いてカレントディレクトリ内という順で捜します。

−i 新しい RCS ファイルを作成し、初期化しますが、 リビジョンは格納しません。 RCS ファイルがパスプレフィックスを持たない時には、 rcs は RCS ファイルを、まず ./RCS サブディレクトリ内、 続いてカレントディレクトリ内に作成しようとします。 その RCS ファイルが既に存在するときには、 エラーメッセージが出力されます。

−alogins コンマで区切られたリスト logins に現れるログイン名を、 RCS ファイルのアクセスリストに付け加えます。

−Aoldfile oldfile のアクセスリストを、 RCS ファイルのアクセスリストに付け加えます。

−e[logins] RCS ファイルのアクセスリストから、 コンマで区切られたリスト logins に現れるログイン名を消去します。 logins が省略されたときには、アクセスリスト全体が消去されます。

−cstring コメントリーダを string にセットします。 コメントリーダはチェックアウトの際、 キーワード $Log$ によって作られた全てのログメッセージ行の前に出力されます ( co を参照してください)。 これは複数行コメントを持たないプログラミング言語を使用するときに便利です。 rcs −i、あるいは ci の最初では、 コメントリーダは作業ファイルのサフィックスから推測されます。

−l[rev] rev の番号を持つリビジョンのロックを行います。 ブランチが与えられた場合、そのブランチ上の最新リビジョンがロックされます。 rev が省略された場合、トランク上の最新リビジョンがロックされます。 ロックは、変更の上書きをできないようにします。 ロックは、 ci、 または rcs −u によって解除されます (以下を参照してください)。

−u[rev] rev の番号を持つリビジョンのロックを解除します。 ブランチが与えられた場合、 そのブランチ上の最新リビジョンのロックが解除されます。 rev が省略された場合、実行者によって施された最後のロックが解除されます。 通常、リビジョンにロックを施した者がロックを解除できます。 それ以外の者がアンロックを行えばロックは壊れます。 これによって、もともとロックを施した者に、 メールメッセージが送られます。 そのメッセージには、ロックを壊した者からのアンロック依頼文が含まれます。 依頼文は、1 つのピリオド (.) または control-D (^D) を含む一行で終了します。

−L ロッキングを strict にセットします。 strict 状態でのロッキングでは、RCS ファイルの所有者もチェックインに当って、 ロックを行わなくてはなりません。 このオプションは、共有されているファイルに対して使用しなければなりません。

−U ロッキングを non-strict にセットします。 non-strict 状態でのロッキングでは、 RCS ファイルの所有者はチェックインに当って、 リビジョンをロックする必要がありません。 このオプションは、共有されているファイルに使用してはいけません。 デフォルト値 (−L または −U) は、 システムの管理者によって決められます。

−nname[:rev]
シンボリック名 name をブランチまたは リビジョン rev に割り当てます。 name が既に他の番号に割り当てられている場合、 rcs はエラーメッセージを出力します。 rev が省略された場合、シンボリック名は消去されます。

−Nname[:rev]
−n オプションと同じですが、 name の以前の割り当てを変更する点が異なります。

−orange range によって与えられるリビジョンを削除 (古く) します。 1 つのリビジョン番号で構成される range は、そのリビジョンを意味します。 ブランチ番号で構成される range は、そのブランチ上の、 最新リビジョンを意味します。 rev1−rev2 という形式の range は同一ブランチ上 の rev1 から rev2 までを意味します。 −rev は、rev を含むブランチの始めから rev までを、 rev− は rev から rev を含むブランチの終りまでを、 それぞれ意味します。 古いリビジョンは、ブランチとロックを持つことができません。

−q quiet モードです。診断は出力されません。

−sstate[:rev]
リビジョン rev のステート属性を、state にセットします。 rev が省略された場合には、 トランク中の最新リビジョンになります。 rev がブランチ番号の場合には、 ブランチ中の最新リビジョンになります。 いくつかの識別子が state に適用できます。 便利なステートは、Exp (実験用)、 Stab (定常) と Rel (リリースされた) です。 デフォルトでは、 ci はリビジョンのステートを Exp にセットします。

−t[txtfile] RCS ファイルに説明用テキストを書き込みます (存在するテキストは削除します)。 txtfile が省略された場合、 rcs はプロンプトを出し、 標準入力より入力されるテキストを要求します。 このテキストは、1 つのピリオド (.) または CTRL−D (^D) を含む 1 行で終了していなければなりません。 省略されなかった場合には、 説明用テキストはテキストファイル txtfile からコピーされます。 −i オプションがあるときは、 −t オプションが与えられていなくても説明用テキストが要求されます。 標準入力がターミナルではない場合、プロンプトは省略されます。

診断

RCS ファイル名と古くなったリビジョンが、 診断出力に書き込まれます。 終了ステータスは、常に最後に操作の行われた RCS ファイルが関係し、 成功したときは 0、そうでないときは 1 になります。

関連ファイル

コマンドの実行者は、RCS ファイルの存在する ディレクトリに対し読み出し/書き込み許可を、 RCS ファイル自身に対し読み込み許可を保有していなければなりません。 rcs はセマフォファイルを同じディレクトリ内に作成して、 RCS ファイルが同時に更新されることを防いでいます。 変更のために、 rcs は、常に新しいファイルを作ります。 手続きが成功したときには、 rcs は古いファイルを消去し、 新しいものをリネームします。 このような方法が使われているため、RCS ファイルに対して リンクを張っても役に立ちません。

識別

著者： Walter F. Tichy, Purdue University, West Lafayette, IN, 47907. 
リビジョン番号： 4.701 ; リリース日付： 1992/04/03 .
Copyright © 1982 by Walter F. Tichy.

関連事項

co(1), ci(1), ident(1), rcsdiff(1), rcsintro(1), rcsmerge(1), rlog(1), rcsfile(5), sccstorcs(8)
Walter F. Tichy, "Design, Implementation, and Evaluation of a Revision Control System," in Proceedings of the 6th International Conference on Software Engineering, IEEE, Tokyo, Sept. 1982. 

NEWS-OSRelease 4.2.1R