ci

名称

書式

解説

オプション

-rrev

リビジョン rev をチェックインします。

-r

-r オプションをリビジョン抜きで使用した場合、 ci にとって特別な意味が有ります。他の RCS コマンドでは -r オプションを単体で使用するとデフォルト枝の最新のリビジョンを指定します。 しかし、 ci ではロック解除、ワークファイル削除を行い、 シェルのエイリアスやスクリプトによりデフォルトとされてしまった -l や -u オプションの効果を打ち消します。

-l[rev]

-r と同様の動作を行ったあと、 co -l と同様の動作も行います。 すなわち、登録されたリビジョンは即座にロックされ、チェックアウトされます。 これは、リビジョンをチェックインしてさらに編集を続けたい場合に便利です。

-u[rev]

-l とほぼ同様の動作をしますが、登録されたリビジョンはロックされません。 これは、チェックインしたリビジョンの内容をすぐに参照したい場合に便利です。

-f[rev]

強制的に登録します。 直前のリビジョンとの違いがない場合にも、 新しいリビジョンとして登録します。

-k[rev]

リビジョン番号などをローカルに算出せずに、 ワークファイルからキーワードを探し、 リビジョン番号、作成日時、状態、作者 ( co(1) を参照) を検索し、登録されるリビジョンに割り当てます。 さらに、 ci を起動したユーザ名と実際にチェックインされた日付を含む デフォルトのログメッセージを作成します。 本オプションは、配布されたソフトウェアを登録するのに便利です。 複数のサイトに配布されたリビジョンは、 元のリビジョン番号、作成日付、状態、作者を保存するために、 -k オプションを使って登録するべきです。 ワークファイルのキーワードから取り出した値とログメッセージは、 -d, -m, -s, -w や、他のリビジョン番号を生成するようなオプションにより 変更することができます。

-q[rev]

沈黙モードです。 診断メッセージを表示しません。 直前のリビジョンから変更がない場合、 -f オプションを指定していなければ、登録を行いません。

-i[rev]

最初のチェックイン; RCS ファイルが既に有る時にはエラー報告します。 特定のアプリケーションのレース状態を避けます。

-j[rev]

初期化を行わず、チェックインします; RCS ファイルが無いとエラー報告します。

-I[rev]

対話モードで動作します。 たとえ標準入力が端末でなくても、ユーザに対して問い合わせを行います。

-d[date]

チェックイン日付として指定された date を用います。 date は co(1) で記述された自由形式で指定することができます。 これは、チェックイン日時をごまかしたい場合や、 日付キーワードがワークファイルにないにもかかわらず -k オプションを使いたい場合に便利です。 date が指定されなかった場合、ワークファイルの最終更新日付が用いられます。

-M[rev]

作成されるワークファイルの最終更新日付を、 取り出されたリビジョンの日付にします。 たとえば、 ci -d -M -u f は、 f の内容がキーワード置換により変更された場合も最終更新日時を変更しません。 本オプションを指定すると make(1) に影響を与えるので、注意して使用する必要があります。

-mmsg

チェックインするすべてのリビジョンのログメッセージとして msg を用います。 慣習的に # で始まるログメッセージはコメントであり、GNU Emacs の vc パッケージのようなプログラムはこれを無視します。 また、 {clumpname} (の後に空白が続く) ログメッセージは可能であればまとめられることを意味します。 それはたとえ別々のファイルに関連づけられていてもです; {clumpname} ラベルは、まとめる目的でのみ使用されます。 それ自身はログメッセージであるとは見なされません。

-nname

チェックインしたリビジョンにシンボリック名 name をつけます。 もし同じシンボリック名が別のリビジョンに割り当てられていた場合、 ci はエラーメッセージを出力します。

-Nname

-n と同様の動作を行います。 ただし、同じシンボリック名が他のリビジョンに割り当てられていた場合は、 再割り当てを行います (こちらを優先します)。

-sstate

チェックインされるリビジョンの状態を state とします。デフォルトは Exp (Experimental: 実験的) です。

-tfile

RCS ファイル中の内容記述テキストをファイル file の内容で置き換えます。 すでに内容記述テキストがある場合はこれを削除します。ファイル名 file は - で始まってはいけません。

-t-string

RCS ファイル中の内容記述テキストを文字列 string で置き換えます。 すでに内容記述テキストがある場合は削除されます。

-T

新しいリビジョンが存在し、 RCS ファイルの修正時刻が新しいリビジョンの時刻よりも古ければ、 RCS ファイルの修正時刻に対して新しいリビジョンの時刻を代入します; そうでない場合は RCS ファイルの修正時刻は保たれます。 リビジョンをロックした場合は、 ci は通常 RCS ファイルの修正時刻を現在の時刻に設定します。 なぜならロックが RCS ファイルに格納され、 ロックの削除は RCS ファイルの変更を要するからです。 RCS ファイルがワークファイルよりも新しくなる方法として 2 通り有ります: まず、 ci -M は現在時刻以前の日付でワークファイルを作成します; 2 番目に、直前のバージョンを回復する時、 ワークファイルを変更しない場合にも RCS ファイルは変更され得ます。 RCS ファイルのワークファイルにおける make(1) 依存により、上記 2 ケースは過剰の再コンパイルという結果になり得ます。 -T オプションを使用することで、RCS ファイルの日付をごまかし、 再コンパイルを禁止します。 このオプションは注意して使って下さい; あるワークファイルのチェックインが、 同じ RCS ファイルに関連づけられている別のワークファイルに影響を及ぼすべき 時でも、再コンパイルを抑制し得ます。 例えば、RCS ファイルの時刻を 01:00、 (変更された) ワークファイルの時刻を 02:00、 別のワークファイルのコピーの時刻を 03:00、 現在の時刻を 04:00 とします。 ここで、 ci -d -T とすると、RCS ファイルの時刻は通常の 04:00 ではなく 02:00 になります; この結果、 make(1) は別のコピーが RCS ファイルよりも新しいと (誤って) 認識します。

-wlogin

指定された login をリビジョンの作者として登録します。 作者名をごまかしたい場合や、 作者キーワードがワークファイルにないにもかかわらず -k オプションを使いたい場合に便利です。 -V RCS のリビジョン番号を表示します。

-Vn

RCS システムのバージョン n のエミュレーションを行います。詳細は co(1) を参照してください。

-xsuffixes

RCS ファイルの拡張子を指定します。 拡張子が空ではない場合、 拡張子まで含めたすべてのパス名を RCS ファイル名であるとみなします。 拡張子が空の場合は、 RCS/path または path1/RCS/path2 形式のものを RCS ファイル名であるとみなします。 本オプションの場合、 / で区切ることにより、複数の拡張子を指定できます。たとえば、 -x,v/ は、 ,v と空の拡張子の 2 つの拡張子を持つ RCS ファイルを指定します。 複数の拡張子が指定された場合、指定された順に RCS ファイルを検索します。 最初に見つかったサフィックスが RCS ファイルに対して用いられます。 RCS ファイルを生成できるが、 RCS ファイルが見つからないときは、 これらのサフィックスを新しいファイル名に対して用います。 デフォルトの拡張子は、インストールされる環境により異なります。 UNIX のようなコンマをファイル名中に含めることの出来る計算機では、通常 -x,v/ が、それ以外の計算機では空の拡張子が用いられます。

-zzone

キーワード置換での日付の出力書式の指定を行い、また、 -ddate オプションでの date のデフォルトのタイムゾーンの指定を行います。 zone は、省略する事も、UTC からの数値差で指定する事も、特別な文字列 LT を使ってローカル時間で指定する事もできます。 デフォルトでは zone は空であり、 この場合は伝統的な RCS フォーマット、 すなわちタイムゾーン無しの UTC であり日付をスラッシュで区切ります; そうでない場合は時刻はタイムゾーン付の ISO 8601 フォーマットです。 例えば、ローカルタイムが 1990 年 1 月 11 日 太平洋標準時間 (UTC の 8 時間西) 午後 8 時の場合、時間の出力は次のようになります:

オプション時刻の出力
-z	1990/01/12 04:00:00	(デフォルト)
-zLT	1990-01-11 20:00:00-08
-z+05:30	1990-01-12 09:30:00+05:30

ファイル名規則

使用例

ci  io.c;    ci  RCS/io.c,v;   ci  io.c,v;
ci  io.c  RCS/io.c,v;    ci  io.c  io.c,v;
ci  RCS/io.c,v  io.c;    ci  io.c,v  io.c;

ci  io.c;    ci  RCS/io.c;
ci  io.c  RCS/io.c;
ci  RCS/io.c  io.c;

ファイルモード

関連ファイル

SETUID の使用

•

その計算機で RCS にて setuid が使用できるか確認します。 疑問があるときは、信頼できる専門家に意見を聞いてください。 最も良いのは、 seteuid() システムコールが Posix 1003.1a Draft 5 に 記述されているように動作することです。 なぜなら、実ユーザが root であっても、RCS は実ユーザと実効ユーザを簡単に切り替えることができるからです。 その次に良いのは、 setuid() システムコールが saved setuid (Posix 1003.1-1990の {_POSIX_SAVED_IDS} の動作) を サポートしている場合です; この場合、実ユーザもしくは実効ユーザが root である時のみ失敗します。 RCS は setuid に失敗すると、ただちに終了します。

•

ユーザグループの RCS 管理者として、ユーザ A を選びます。 A だけが、RCS ファイルに対して rcs コマンドを実行することができます。 A は root や、特権を持ったユーザであってはいけません。 相互に異なるユーザグループには、異なる管理者を使用するべきです。

•

ユーザが実行するファイルのディレクトリに、パス名 B を選びます。

•

以下のように、通常のインストールディレクトリ D から、 ci と co を B にコピーし、 A へ setuid します:

mkdir  B
cp  D/c[io]  B
chmod  go-w,u+s  B/c[io]

•

以下のように、各ユーザのパスに B を加えます:

PATH=B:$PATH;  export  PATH  # ordinary shell
set  path=(B  $path)  # C shell

•

以下のように、 A だけが書き込み許可を持つ RCS ディレクトリ R を作成します:

mkdir  R
chmod  go-w  R

•

特定のユーザだけに RCS ファイルの読み込みを許可したい場合、 そのユーザをユーザグループ G に入れて、さらに A が以下のように、RCS ディレクトリを保護します:

chgrp  G  R
chmod  g-w,o-rwx  R

•

(存在すれば) 古い RCS ファイルを R にコピーし、 A が所有であることを保証します。

•

RCS ファイルのアクセスリストは、 リビジョンをチェックインおよびロックできるユーザを制限します。 デフォルトのアクセスリストは空で、 RCS ファイルを読むことのできる全てのユーザに、登録の権限を与えます。 チェックインを制限したい場合は、 A がそのファイルに対して rcs -a を実行します; rcs(1) を参照してください。 特に rcs -e -aA は、 A だけにアクセスを制限します。

•

初めてチェックインを行う前に、 A は rcs -i によって新しい RCS ファイルを初期化します。 チェックインを制限したい場合、 -a オプションを付け加えます。

•

setuid 特権は、 ci, co, rcsclean のみに与えます; rcs や他のコマンドに、setuid 特権を与えてはなりません。

•

RCS コマンドに対して、他の setuid コマンドを実行しないでください。 setuid はあなたが考えるより扱いにくいものです。

環境変数

RCSINIT

本変数に空白で区切ったオプションを設定することで、 コマンドライン引数に先立って処理されます。 空白はバックスラッシュによってエスケープすることができます。 RCSINIT はほとんどの RCS コマンドで参照されます。特に -q, -V, -x, -z オプションを指定しておくと便利です。

TMPDIR

一時ディレクトリ名を指定します。 設定されていない場合は、環境変数 TMP と TEMP とを調べ、始めに見つかった値を用います; どれも設定されていない場合は、 計算機依存のデフォルトのディレクトリ (たいていは /tmp ) を使用します。

診断

作者

関連項目