Provided by: manpages-ja_0.5.0.0.20110915-1_all bug

名称

       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 -rci -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 を用います。 dateco(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.cRCS/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 ファイルとワークファイルの読み込み許可と、  それらを含むディ
       レクトリの検索および書き込み権を持っていなければなりません。  しかし、古い計算機のなかには
       実ユーザと実効ユーザの間を 容易に行き来することができないものもあります。 これらの計算機で
       は、実効ユーザのみが利用されます。  cico のコピーに 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  コマンドを実行することができます。 Aroot や、特権を持ったユーザであってはいけま
         せん。 相互に異なるユーザグループには、異なる管理者を使用するべきです。

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

       · 以下のように、通常のインストールディレクトリ D から、 cicoB  にコピーし、  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 だけにアクセスを
         制限します。

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

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

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

環境変数

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

       TMPDIR 一時ディレクトリ名を指定します。 設定されていない場合は、環境変数 TMPTEMP  とを
              調べ、始めに見つかった値を用います;  どれも設定されていない場合は、  計算機依存のデ
              フォルトのディレクトリ (たいていは /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.