Provided by: manpages-ja_0.5.0.0.20221215+dfsg-1_all 
名称
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: 1.6; Release Date: 1999/08/27.
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.