CI(1)

名称
ci - RCS ファイルにリビジョンをチェックインする

書式
ci [options] file ...

解説
ci は RCS ファイルに新たなリビジョンを格納します。 引数のうち、RCS ファイルの拡張子形式に一致する ファイル名を RCS ファイルとみなします。 それ以外のファイル名は、新たなリビジョンを含んだワークファイルとみなします。 ci はワークファイルの内容を対応した RCS ファイルに格納します。 もしワークファイルのみが指定されたなら、 ci はサブディレクトリ RCS、次にワークファイルがあるディレクトリの順に 対応する RCS ファイルを検索します。 詳細は後述の ファイル名規則 の項を参照してください。

ci が動作するには、 ci を起動したユーザが RCS ファイルのアクセスリスト に登録されているか、アクセスリストが空であるか、 ユーザが RCS ファイルの持ち主であるか、 あるいはスーパユーザである必要があります。 すでに存在する枝 (branch) に新しいリビジョンを追加するには、 枝の先端 (tip) リビジョンが、 追加しようとするユーザによってロックされていなければなりません。 ロックされていない場合、新たな枝のみ作成可能です。 非厳格モード ( rcs(1) 参照) の場合、 ファイルの所有者に対してはこの制限はありません。 他人が行っているロックは、 rcs コマンドによって解除できます。

-f オプションが指定されていなければ、 ci は追加しようとするリビジョンと直前のリビジョンとの比較を行います。 違いがなかった場合、新たなリビジョンを作成するかわりに、 ワークファイルを元のリビジョンのものに復元します。 復元するときには、ci はいったんワークファイルを削除し、 ロックを解除します。 ci -l はロックし、 ci -u はロックを解除します。 これらのオプションが指定されていれば、あたかも直前のリビジョンに対して co -l または co -u を実行したかのようにして直前のリビジョンの内容を取り出します。 復元が行われる場合、 -n と -s オプションは復元されるリビジョンに対して作用します。

リビジョンを格納するときに、 ci はログメッセージの入力を促すプロンプトを表示します。 ログメッセージは、そのリビジョンの変更点の要約です。 ファイル終端 (EOF) あるいは、 ピリオド . のみからなる行によって入力を完了させます。 複数のファイルが登録される場合、 ci は前に入力したログメッセージを 再利用するかどうかを聞いてきます。 もし標準入力が端末でなければ、 ci は確認を行わず、 登録されるすべてのファイルに対して同じログメッセージを使用します。 -m オプションの項も参照してください。

もし RCS ファイルが存在しなければ、 ci は新規に RCS ファイルを作成し、 ワークファイルの内容を初期リビジョン (デフォルトでは 1.1) として格納します。 その場合、アクセスリストは空に初期化されます。 初期リビジョンを格納するときは、 ログメッセージのかわりに ファイルの内容を記述したテキストを入力します (後述の -t オプションの項を参照してください)。

登録するリビジョン番号 ( rev ) は、 -f, -i, -I, -j, -k, -l, -M, -q, -r, -u のオプションのうちのいずれかで指定することができます。 rev はシンボル、数値、あるいは両者の組み合わせたものです。 rev で使用するシンボル名は定義済みでなければなりません; チェックイン時にシンボル名を割り当てる方法については -n および -N を参照して下さい。 もし rev が $ ならば、 ci はワークファイル中のキーワードからリビジョン番号を決定します。

もし rev がピリオドから始まる場合、デフォルトの枝 (通常は幹 (trunk)) に格納されます。 もし rev が枝番号に続いてピリオドである場合、当該枝の最新のリビジョンが使用されます。

rev がリビジョン番号の場合、 それは登録する枝のなかで最も大きな値である必要があります。 さもなければ、新しい枝を作成する必要があります。

rev がリビジョン番号ではなく枝番号の場合、 その枝に対する新しいリビジョンが作成されます。 新しいリビジョン番号は、その枝の先端リビジョン番号に 1 を加えたものとなります。 もし rev が存在しない枝番号ならば、新たな枝が作成され、初期リビジョンとして rev.1 が作成されます。

rev が省略された場合、 ci はユーザが行った最後のロックからリビジョン番号を決定します。 ユーザがある枝の先端リビジョンをロックしている場合は、 新たなリビジョンがその枝に追加されます。 新しいリビジョン番号は 先端リビジョン番号に 1 を加えたものになります。 ユーザが先端ではないリビジョンをロックしている場合は、 新たな枝が作成されます。 新たな枝番号は、ロック対象のリビジョンの 最も大きな枝番号に 1 を加えたものになります。 デフォルトでは、新たな枝やリビジョンの番号は 1 となります。

rev が省略され、ユーザがロックを行わず、そのファイルの所有者であり、 かつロックが 非厳格モード であるなら、 デフォルトの枝 (通常は幹 (trunk); rcs(1) の -b オプションの項を参照) に新たなリビジョンが作成されます。

例外: 幹 (trunk) においてリビジョンを追加することはできますが、 途中に挿入することはできません。

オプション

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

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

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

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

    -l 、リビジョン無し -r, -u オプションは、最後に指定したもののみが効力を持ちます。 たとえば、 ci -u -r は ci -r と等価です。 リビジョン無し -r が -u に優先するからです。

-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 オプションは、どちらの形式で使う場合も、 最初のチェックイン時にしか意味を持ちません。 それ以外の場合は単に無視されます。

    最初のチェックイン時に -t オプションが指定されなかった場合、 ci は標準 入力から内容記述テキストを読み込みます。 テキストは、ファイル終端 (EOF) あるいはピリオド ( . ) のみの行で終了します。 ユーザへの問い合わせが可能な場合には、 テキストの入力を促すプロンプトが表示されます ( -I オプション参照)。

    旧バージョンとの互換性のため、引数のない -t オプションは無視されます。

-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

    -z オプションは RCS ファイルに格納されている日付 (常に UTC です) には影響しません。

ファイル名規則
RCS ファイルとワークファイルの組み合わせは 3 通りの方法で指定することができます (使用例の項目も参照してください)。

1) RCS ファイルとワークファイルの両方を指定する。 RCS ファイルのパス名は path1/workfileX 形式、ワークファイルのパス名は path2/workfile 形式をとります。この場合の path1/ と path2/ はパス (異なるパスや、空でも可) を示し、 workfile はファイル名、 X は RCS ファイルの拡張子です。もし X が空なら、 path1/ は RCS/ で始まるか、 /RCS/ を含まねばなりません。

2) RCS ファイルのみを指定する。 ワークファイルがカレントディレクトリに作成され、RCS ファイル名から path1/ と拡張子 X を取り除いたファイル名になります。

3) ワークファイルのみを指定する。 ci はまず、各 RCS 拡張子 X に対して、 path2/RCS/workfileX 形式の名前で検索を行います。 さらに、(もしこれが見つからず、 X が空でなければ、) path2/workfileX を検索します。

1) または 2) の方法で RCS ファイルが指定されていない場合、 ci はまずディレクトリ ./RCS を検索し、次にカレントディレクトリを検索します。

異常により RCS ファイルのオープンに失敗すると、 ci はエラー報告します。 他に RCS ファイルのパス名の候補があってもです。 たとえばディレクトリ d で RCS コマンドを利用できないようにするには、 d/RCS なる名前の通常ファイルを作成しておきます。 すると、RCS コマンドは d/RCS をディレクトリとしてオープンしようとしますが、 ディレクトリではないのでオープンすることができず失敗します。

使用例
RCS 拡張子が ,v 、カレントディレクトリには RCS ファイルを含む RCS というサブディレクトリがあり、 io.c,v があると仮定します。 ここで、以下に示したコマンドを実行すると、 どれもカレントディレクトリにある io.c を RCS/io.c,v にチェックインし、 io.c を削除します。

    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;

RCS 拡張子が空、カレントディレクトリには RCS ファイルを含む RCS というサブディレクトリがあり、 io.c があると仮定します。ここで以下に示すコマンドは、どれも新しい リビジョンのチェックインを行います。

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

ファイルモード
ci が作成した RCS ファイルは、 ワークファイルの読み込みと実行の許可属性を受け継ぎます。 すでに RCS ファイルが存在すれば、 ci はその読み込みと実行の許可属性を保持します。 ci は、つねに RCS ファイルの書き込み許可属性を不許可にします。

関連ファイル
いくつかの一時ファイルが、ワークファイルの存在するディレクトリまたは 一時ディレクトリ (環境変数の項の TMPDIR 参照) に作成されます。 セマフォファイル等のファイルが RCS ファイルが存在するディレクトリに作成されます。 空ではない拡張子を用いている場合、 セマフォファイル名の先頭文字には、 拡張子の先頭文字と同じ文字が用いられます; よって、拡張子として、ワークファイルの拡張子の先頭文字と同じ文字を 指定しないように注意してください。 空の拡張子を指定している場合、 セマフォファイル名の最後の文字がアンダスコア ( _ ) となります。

ci は、 RCS ファイルやワークファイルを変更しません。通常 ci はそれらのファイルをアンリンクし、新しいファイルを作成します; ただし、RCS ファイルへのシンボリックリンクの鎖を壊す代わりに、 目的のファイルをアンリンクします。 よって、 ci は変更されるワークファイルへの ハードリンク、シンボリックリンクを全て壊します; さらに、RCS ファイルへのハードリンクは無効となり、 シンボリックリンクは保存されます。

実効ユーザは、RCS ファイルを含むディレクトリの 検索および書き込み権を持っていなければなりません。 通常実ユーザは、 RCS ファイルとワークファイルの読み込み許可と、 それらを含むディレクトリの検索および書き込み権を持っていなければなりません。 しかし、古い計算機のなかには実ユーザと実効ユーザの間を 容易に行き来することができないものもあります。 これらの計算機では、実効ユーザのみが利用されます。 ci や co のコピーに setuid が設定されていなければ、 実ユーザと実効ユーザは同一です。 次節で説明するように、 もし実効ユーザが全 RCS ファイルとそれを含むディレクトリを所有し、 実効ユーザのみが RCS ディレクトリに書き込めるように設定できるなら、 RCS ファイルのセキュリティを強化することが可能です。

ユーザは RCS ファイルを含むディレクトリの許可属性を変更することで、 RCS ファイルに対するアクセスを制限できます; そのディレクトリに書き込み権のあるユーザだけが、 RCS ファイルを変更する RCS コマンドを使用することができます。 たとえば、ユーザが複数のグループに属することが出来る計算機では、 RCS ディレクトリをあるグループのみが書き込み権を持つように設定します。 これは、略式のプロジェクトでは十分ですが、 グループに所属するユーザが自由に RCS ファイルを変更することができ、 RCS ファイルすべてを削除することもできます。 そのため、正式なプロジェクトでは、 RCS ファイルを自由に操作きる RCS 管理者と、 新たなリビジョンをチェックインすること以外の操作はできない他のユーザとを、 区別することがあります。

SETUID の使用
RCS 管理者以外のユーザがリビジョンを削除できないようにするには、 以下のように 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 ) を使用します。

診断
各リビジョンに対して、 ci は RCS ファイル名、ワークファイル名、追加するリビジョン番号、直前の リビジョン番号を表示します。全ての処理が成功した場合のみ、 終了ステータスが 0 になります。

作者
Author: Walter F. Tichy.
Manual Page Revision: ; Release Date: .
Copyright © 1982, 1988, 1989 Walter F. Tichy.
Copyright © 1990, 1991, 1992, 1993, 1994, 1995 by Paul Eggert.

関連項目
co(1), ident(1), make(1), rcs(1), rcsclean(1), rcsdiff(1), rcsintro(1), rcsmerge(1), rlog(1), setuid(2), rcsfile(5)
Walter F. Tichy, RCS--A System for Version Control, Software--Practice & Experience 15, 7 (July 1985), 637-654.