Man page - cvsup(1)
Manual
UNTITLED () LOCAL UNTITLED ()
名 称
cvsup — CVS リ ポ ジ ト リ 用 の ネ ッ ト ワ ー ク 配 布 パ ッ ケ ー ジ
書 式
[ -1aDeEgksvzZ ] [ -A addr ] [ -b base ] [ -c collDir ] [ -d delLimit ] [ -h host ] [ -i pattern ] [ -l lockfile ] [ -L verbosity ] [ -p port ] [ -P m|a|port|lo-hi|- ] [ -r maxRetries ] supfile [ destDir ]
解 説
CVSup は 、 フ ァ イ ル 群 の 配 布 と 更 新 を ネ ッ ト ワ ー ク 上 で 行 う た め の ソ フ ト ウ ェ ア パ ッ ケ ー ジ で す 。 CVSup と い う 名 前 は パ ッ ケ ー ジ 全 体 を 指 し ま す 。 CVSup は ク ラ イ ア ン ト プ ロ グ ラ ム で あ る cvsup と サ ー バ プ ロ グ ラ ム で あ る cvsupd か ら で き て い ま す 。 こ の マ ニ ュ ア ル ペ ー ジ は 、 CVSup パ ッ ケ ー ジ の 概 要 を 説 明 し 、 ク ラ イ ア ン ト プ ロ グ ラ ム で あ る 特 有 の 事 項 も 説 明 し ま す 。 cvsupd の 詳 し い 説 明 に つ い て は 、 cvsupd (8) を ご 覧 く だ さ い 。
rdist や sup の よ う な 、 よ り 伝 統 的 な ネ ッ ト ワ ー ク 配 布 パ ッ ケ ー ジ と 異 な り 、 CVSup は 特 に CVS リ ポ ジ ト リ の 配 布 の た め に 作 ら れ て い ま す 。 CVSup は CVS リ ポ ジ ト リ と リ ポ ジ ト リ に 含 ま れ る フ ァ イ ル (特 に RCS フ ァ イ ル )の 特 性 を 生 か し 、 伝 統 的 な シ ス テ ム よ り も ず っ と 高 速 な 更 新 を 可 能 に し て い ま す 。
オ プ シ ョ ン
ク ラ イ ア ン ト プ ロ グ ラ ム は 、 少 な く と も 一 つ の 引 数 supfile を 必 要 と し ま す 。 こ れ は 、 サ ー バ か ら の 転 送 や 更 新 が 行 わ れ る 1 つ 以 上 の フ ァ イ ル を 記 述 し た フ ァ イ ル で す 。 supfile は 、 sup で 使 わ れ る 同 じ 目 的 の フ ァ イ ル に 似 た 形 式 で す 。 ほ と ん ど の 場 合 、 は 既 存 の sup supfiles を 使 え ま す 。
省 略 可 能 な 引 数 destDir も 指 定 で き ま す 。 指 定 さ れ た 場 合 に は 、 こ の 引 数 は 更 新 さ れ た 全 て の フ ァ イ ル が 置 か れ る デ ィ レ ク ト リ を 指 定 し ま す 。 destDir が 指 定 さ れ る と 、 ク ラ イ ア ン ト の 元 の フ ァ イ ル は そ の ま ま 残 さ れ ま す 。 こ の 機 能 は 主 に テ ス ト の た め の も の で す 。
cvsup は 以 下 の オ プ シ ョ ン を サ ポ ー ト し て い ま す :
-1
一 時 的 な 失 敗 が 起 き 、 か つ GUI が 使 わ れ て い な い 時 の 自 動 リ ト ラ イ を 無 効 に し ま す 。 こ の オ プ シ ョ ン を 指 定 し な い と 、 ネ ッ ト ワ ー ク 接 続 の 切 断 と い っ た 一 時 的 な 失 敗 が 起 き た 時 、 は リ ト ラ イ を 繰 り 返 し 行 い ま す 。 リ ト ラ イ の 際 に は ラ ン ダ ム 化 さ れ た 指 数 的 な 一 時 退 避 (randomized exponential backoff) ア ル ゴ リ ズ ム を 用 い て リ ト ラ イ の 間 隔 を 確 保 し ま す 。 こ の オ プ シ ョ ン は -r 0 と 同 等 で あ り 、 GUI を 使 う 時 に は 暗 黙 的 に 指 定 さ れ た こ と に な り ま す 。
-a
ク ラ イ ア ン ト に 対 し て 自 分 自 身 の 認 証 す る こ と (自 分 が 何 で あ る か を 示 す こ と ) を サ ー バ に 要 求 し ま す 。 サ ー バ の 認 証 が 失 敗 す る と 、 更 新 は キ ャ ン セ ル さ れ ま す 。 後 述 の “認 証 ” を 見 て く だ さ い 。
-A addr
サ ー バ に 接 続 す る 時 に 割 り 当 て る ロ ー カ ル の ア ド レ ス (ド ッ ト 区 切 り の 4 つ の 数 値 、 ま た は ホ ス ト 名 )を 指 定 し ま す 。 こ の オ プ シ ョ ン は 、 ホ ス ト が 複 数 個 の IP ア ド レ ス を 持 っ て い る 場 合 に 便 利 で す 。
-b base
が 管 理 す る 記 録 フ ァ イ ル を 置 く ベ ー ス デ ィ レ ク ト リ を 指 定 し ま す 。 こ の 際 に は 、 supfile に よ る base の 指 定 は 全 て 上 書 き さ れ ま す 。
-c collDir
コ レ ク シ ョ ン に 関 す る 情 報 を 管 理 す る 、 base の サ ブ デ ィ レ ク ト リ を 指 定 し ま す 。 デ フ ォ ル ト 値 は sup で す 。
-d delLimit
更 新 を 1 回 実 行 し た 際 に 削 除 で き る フ ァ イ ル 数 の 上 限 を 指 定 し ま す 。 こ の 上 限 を 超 え る フ ァ イ ル 削 除 の 試 み は 致 命 的 な エ ラ ー と な り ま す 。 こ の オ プ シ ョ ン を 使 う と 、 サ ー バ 上 の 一 時 的 な 設 定 ミ ス に よ る 被 害 を 、 あ る 程 度 防 げ ま す 。 デ フ ォ ル ト で は 無 制 限 で す 。
-D
に フ ァ イ ル の 削 除 だ け を 行 わ せ 、 ど ん な 種 類 の 更 新 も 行 い ま せ ん 。 こ の オ プ シ ョ ン は 、 ク ラ イ ア ン ト の デ ィ ス ク 容 量 が 非 常 に 少 な い と い っ た 状 況 で 役 に 立 ち ま す 。 ユ ー ザ は ま ず -D オ プ シ ョ ン を 使 っ て を 実 行 し て で き る 限 り の 容 量 を 空 け ま す 。 次 に も う 一 度 を 実 行 し ま す が 、 今 度 は -D オ プ シ ョ ン は 使 い ま せ ん 。 サ ー バ 上 で フ ァ イ ル や デ ィ レ ク ト リ の 名 前 が 変 更 さ れ た 場 合 は 、 こ の 方 法 を 取 る こ と に よ り 、 ク ラ イ ア ン ト 上 で 新 し い フ ァ イ ル が 生 成 さ れ る よ り も 前 に 、 全 て の 古 い フ ァ イ ル が 削 除 さ れ る こ と が 保 証 さ れ ま す 。 こ の オ プ シ ョ ン は 、 チ ェ ッ ク ア ウ ト モ ー ド で は ま だ 実 装 さ れ て い ま せ ん 。
-e
サ ー バ か ら 受 け 取 っ た シ ェ ル コ マ ン ド を 、 supfile 中 の 全 て の コ レ ク シ ョ ン に execute キ ー ワ ー ド が 追 加 さ れ た か の よ う に 実 行 機 能 を 有 効 に し ま す 。
-E
サ ー バ か ら 受 け 取 っ た シ ェ ル コ マ ン ド を 、 supfile 中 の 全 て の コ レ ク シ ョ ン に execute キ ー ワ ー ド が 追 加 さ れ た か の よ う に 実 行 す る 機 能 を 無 効 に し ま す 。
-g
GUI を 使 わ な い よ う に し ま す 。 DISPLAY 環 境 変 数 が 設 定 さ れ て い な け れ ば 、 こ の オ プ シ ョ ン が 暗 黙 的 に 指 定 さ れ ま す 。
-h host
接 続 す る サ ー バ ホ ス ト を 指 定 し ま す 。 supfile に お け る host の 指 定 は 全 て 上 書 き さ れ ま す 。
-i pattern
pattern に マ ッ チ す る フ ァ イ ル と デ ィ レ ク ト リ だ け を 更 新 対 象 に す る よ う に に 指 定 し ま す 。 デ ィ レ ク ト リ が パ タ ー ン に マ ッ チ す る 場 合 は 、 そ の デ ィ レ ク ト リ を ル ー ト と す る サ ブ ツ リ ー 全 体 が 含 ま れ ま す 。 こ の オ プ シ ョ ン が 複 数 回 指 定 さ れ た 場 合 は 、 パ タ ー ン は ‘or’ 操 作 で 結 合 さ れ ま す 。 -i オ プ シ ョ ン が 指 定 さ れ な い 場 合 の デ フ ォ ル ト 動 作 で は 、 各 コ レ ク シ ョ ン に 含 ま れ る 全 て の フ ァ イ ル が 更 新 さ れ ま す 。
pattern は 標 準 の フ ァ イ ル 名 パ タ ー ン で す 。 こ れ は コ レ ク シ ョ ン の プ レ フ ィ ッ ク ス デ ィ レ ク ト リ か ら の 相 対 パ ス で 解 釈 さ れ ま す 。 ス ラ ッ シ ュ 文 字 は 、 パ タ ー ン 中 に 陽 に ス ラ ッ シ ュ が 書 か れ た 場 合 だ け マ ッ チ し ま す 。 フ ァ イ ル 名 の 先 頭 に ピ リ オ ド が あ っ て も 、 特 別 扱 い は さ れ ま せ ん 。
GUI に は 、 パ タ ー ン を 編 集 で き る 入 力 フ ィ ー ル ド が あ り ま す 。
-k
チ ェ ッ ク サ ム の 不 一 致 が 起 き た 時 、 間 違 っ て 編 集 さ れ た フ ァ イ ル 全 て の 一 時 的 な コ ピ ー を 保 存 す る よ う に し ま す 。 こ の オ プ シ ョ ン は デ バ ッ グ 用 の も の で あ り 、 ど う し て フ ァ イ ル が 誤 っ て 編 集 さ れ た の か を 突 き 止 め る 役 に 立 ち ま す 。 こ の オ プ シ ョ ン が 指 定 さ れ て い る か ど う か に 関 わ ら ず 、 不 正 な フ ァ イ ル が ず っ と 残 っ て い る も の は 、 フ ァ イ ル を 丸 ご と 転 送 す る こ と に よ っ て 取 得 し た 正 し い フ ァ イ ル に 置 き 換 え ら れ ま す 。 こ の よ う な 転 送 は フ ィ ッ ク ス ア ッ プ (fixup, 修 理 の 意 味 )と 言 い ま す 。
-l lockfile
lockfile の 生 成 し 、 更 新 が 行 わ れ て い る 間 の ロ ッ ク を 行 い ま す 。 lockfile が 既 に ロ ッ ク さ れ て い る と 、 は 自 動 的 な リ ト ラ イ を 行 う こ と な く 失 敗 し ま す 。 こ の オ プ シ ョ ン が 役 に 立 つ の は 、 cron を 使 っ て を 定 期 的 に 実 行 す る 時 で す 。 こ れ は 、 あ る ジ ョ ブ が 、 ネ ッ ト ワ ー ク の 問 題 で 予 想 以 上 の 時 間 が か か っ て い る 以 前 の ジ ョ ブ の 邪 魔 を す る の を 防 ぎ ま す 。
POSIX 形 式 の フ ァ イ ル ロ ッ キ ン グ が 使 わ れ ま す 。 こ れ は fcntl (2) で 説 明 さ れ て い ま す 。 プ ロ セ ス ID は 、 ロ ッ ク フ ァ イ ル が 正 常 に 取 得 で き た 時 に 、 こ の フ ァ イ ル に テ キ ス ト 形 式 で 書 き 込 ま れ ま す 。 更 新 の 終 了 時 に ロ ッ ク フ ァ イ ル は 削 除 さ れ ま す 。
-L verbosity
GUI で な い 出 力 の 詳 し さ を 設 定 し ま す 。 レ ベ ル 0 で は 、 エ ラ ー が 起 こ ら な い 限 り は 何 も 出 力 し ま せ ん 。 レ ベ ル 1 (デ フ ォ ル ト 値 )で は 、 更 新 さ れ た そ れ ぞ れ の フ ァ イ ル が 出 力 さ れ ま す 。 レ ベ ル 2 で は 、 そ れ ぞ れ の フ ァ イ ル に 対 し て 行 わ れ た 更 新 に 関 す る さ ら に 詳 し い 情 報 が 出 力 さ れ ま す 。 メ ッ セ ー ジ は 全 て 、 標 準 出 力 に 出 力 さ れ ま す 。 GUI が 使 わ れ る 場 合 は 、 こ の オ プ シ ョ ン は 無 視 さ れ ま す 。
-p port
が 接 続 を 試 み る サ ー バ ホ ス ト の TCP ポ ー ト を 設 定 し ま す 。 こ の 機 能 は 主 に テ ス ト 用 で す 。 デ フ ォ ル ト 値 は 5999 で す 。 passive モ ー ド ( -P オ プ シ ョ ン の 説 明 を 参 照 )で な け れ ば 、 サ ー バ は こ れ よ り 一 つ 小 さ い 番 号 の ポ ー ト を 使 っ て 、 ク ラ イ ア ン ト 向 き の 2 つ 目 の 接 続 を 確 立 し ま す 。
-P m|a|port|lo-hi|-
ク ラ イ ア ン ト と サ ー バ 間 の 情 報 の や り と り に 使 う 補 助 的 な TCP 接 続 の 確 立 を 制 御 し ま す 。 全 体 で は 、 ク ラ イ ア ン ト と サ ー バ は 通 信 す る た め に 4 つ の 片 方 向 の チ ャ ネ ル を 必 要 と し ま す : 2 つ は ク ラ イ ア ン ト か ら サ ー バ へ の 接 続 で 、 2 つ は サ ー バ か ら ク ラ イ ア ン ト へ の 接 続 で す 。 色 々 な 防 火 壁 の 設 定 に 対 応 す る た め に 、 こ れ ら 4 つ の 片 方 向 チ ャ ネ ル に は 色 々 な 設 定 が で き ま す 。 こ の た め に 用 意 さ れ た モ ー ド は 、 multiplexed モ ー ド , passive モ ー ド 、 SOCKS モ ー ド 、 active モ ー ド で す 。 multiplexed モ ー ド を 除 く 全 て の モ ー ド は 、 古 く な っ て い ま す 。 multiplexed モ ー ド は 、 他 の モ ー ド が 扱 え る 全 て の 状 況 に 対 応 し て い ま す 。
デ フ ォ ル ト で は 、 サ ー バ が 十 分 新 し け れ ば チ ャ ネ ル は multiplexed モ ー ド で 確 立 し ま す 。 multiplexed モ ー ド は 、 1 つ の TCP 接 続 を 用 い て 4 つ の チ ャ ネ ル を 作 り ま す 。 組 み 込 み の パ ケ ッ ト 多 重 化 層 は 、 TCP 接 続 上 に あ る 異 な る 論 理 チ ャ ネ ル を 多 重 化 し ま す 。 こ れ は ssh ’s の ポ ー ト 転 送 機 能 と は 異 な る や り 方 で 行 わ れ ま す 。 こ れ に よ り 、 非 常 に 小 さ い (1% 未 満 )通 信 オ ー バ ー ヘ ッ ド と ご く わ ず か の CPU 負 荷 が か か り ま す が 、 ほ と ん ど ど ん な 防 火 壁 の 中 で も 動 作 す る は ず で す 。 防 火 壁 は 、 ク ラ イ ア ン ト ホ ス ト が サ ー バ ホ ス ト の 5999 番 ポ ー ト へ 接 続 を 開 始 す る こ と を 許 可 し て い な け れ ば な り ま せ ん 。 こ れ 以 外 に は 、 特 殊 な 許 可 は 全 く 必 要 あ り ま せ ん 。 明 示 的 に multiplexed モ ー ド を 指 定 す る に は 、 -P m オ プ シ ョ ン を 使 い ま す 。
multiplexed モ ー ド は SOCKS プ ロ キ シ サ ー バ と 組 み 合 わ せ て 使 え ま す 。 組 み 合 わ せ て 使 う に は 、 単 に m3socks コ マ ン ド の 元 で を 実 行 し 、 -P m オ プ シ ョ ン を 指 定 し ま す 。
active モ ー ド は 、 双 方 向 の TCP 接 続 を 2 つ 使 っ て 4 つ の 片 方 向 チ ャ ネ ル を 作 り ま す 。 ク ラ イ ア ン ト か ら サ ー バ へ の 元 の 接 続 は 2 つ の チ ャ ネ ル を 作 り 、 2 番 目 の TCP 接 続 が 残 り の 2 つ の チ ャ ネ ル を 作 り ま す 。 2 番 目 の TCP 接 続 を 確 立 す る た め に 、 サ ー バ か ら ク ラ イ ア ン ト へ の 接 続 が 行 わ れ ま す 。 -P a で 、 ク ラ イ ア ン ト は オ ペ レ ー テ ィ ン グ シ ス テ ム が 選 ん だ ポ ー ト 上 で 接 続 を 待 ち ま す 。 多 く の オ ペ レ ー テ ィ ン グ シ ス テ ム は 、 こ の 目 的 に は 1024-5000 の 範 囲 の ポ ー ト を 使 い ま す 。 ユ ー ザ は -P port を 使 っ て 特 定 の ポ ー ト を 指 定 で き ま す し 、 -P lo-hi を 使 っ て あ る 範 囲 の ポ ー ト も 指 定 で き ま す 。 こ れ ら の ポ ー ト 指 定 は SOCKS プ ロ キ シ サ ー バ で は 使 え ま せ ん 。
passive モ ー ド は 、 4 つ の 片 方 向 チ ャ ネ ル を 作 る た め に TCP 接 続 を 使 う と い う 点 で は 似 て い ま す 。 し か し 、 passive モ ー ド で は 2 番 目 の TCP 接 続 を 作 る た め の 接 続 は ク ラ イ ア ン ト か ら サ ー バ に 対 し て 行 わ れ ま す 。 passive モ ー ド は 、 外 向 き の 接 続 は 許 可 す る け れ ど 内 向 き の 接 続 は 禁 止 し て い る 防 火 壁 の 中 に ク ラ イ ア ン ト が い る 場 合 に 便 利 で す 。 passive モ ー ド を 選 択 す る に は 、 -P - オ プ シ ョ ン を 使 い ま す 。 passive モ ー ド は SOCKS プ ロ キ シ サ ー バ で は 使 え ま せ ん 。
SOCKS プ ロ キ シ サ ー バ を 使 う た め の 別 モ ー ド で す 。 SOCKS モ ー ド で は 、 4 つ の TCP 接 続 が 使 わ れ ま す 。 こ れ ら は 全 て 片 方 向 接 続 だ け で す 。 4 つ の 片 方 向 TCP 接 続 を 使 う こ と に よ り 、 SOCKS プ ロ キ シ サ ー バ の 制 限 を 回 避 し ま す 。 こ れ を 行 わ な け れ ば 、 デ ッ ド ロ ッ ク が 起 こ っ て し ま い ま す 。 (信 じ る か ど う か は 別 に し て 、 SOCKS サ ー バ は ブ ロ ッ キ ン グ I/O コ ー ル を 使 い ま す 。 ) SOCKS モ ー ド は 、 が m3socks コ マ ン ド の 元 で 実 行 さ れ 、 か つ -P オ プ シ ョ ン が 指 定 さ れ て い な い 時 に 選 択 さ れ ま す 。 後 述 の “SOCKS と 組 み 合 わ せ て の CVSup の 利 用 ” も ご 覧 く だ さ い 。
-r maxRetries
自 動 リ ト ラ イ の 回 数 を 制 限 し ま す 。 自 動 リ ト ラ イ は 、 ネ ッ ト ワ ー ク 接 続 が 切 れ る と い っ た 一 時 的 な エ ラ ー が 起 き た 時 に 試 み ら れ ま す 。 デ フ ォ ル ト で は 、 GUI を 使 っ て い な い 時 、 は 更 新 が う ま く 完 了 す る ま で 何 度 で も リ ト ラ イ を 行 い ま す 。 リ ト ラ イ の 間 隔 は 、 ラ ン ダ ム 化 さ れ た 指 数 的 な 一 時 退 避 ア ル ゴ リ ズ ム を 使 っ て 決 め ら れ ま す 。 GUI を 使 う と 、 暗 黙 的 に -r 0 が 指 定 さ れ ま す 。 -r 0 は -1 オ プ シ ョ ン と 同 じ 意 味 で あ る 点 に 注 意 し て く だ さ い 。
-s
リ ス ト フ ァ イ ル の 記 録 に 対 し て の 各 ク ラ イ ア ン ト フ ァ イ ル の 状 態 の チ ェ ッ ク を 行 い ま せ ん 。 チ ェ ッ ク を し な い 代 わ り に 、 リ ス ト フ ァ イ ル は 正 確 で あ る も の と 仮 定 し ま す 。 こ の オ プ シ ョ ン は デ ィ ス ク ア ク セ ス の 量 を 大 幅 に 減 ら し 、 小 さ な ク ラ イ ア ン ト ホ ス ト の 負 荷 で 高 速 に 更 新 を 行 い ま す 。 し か し 、 こ の オ プ シ ョ ン は 、 ク ラ イ ア ン ト の フ ァ イ ル が ロ ー カ ル で 修 正 さ れ て い な い 場 合 に 限 っ て 使 う べ き で す 。 ミ ラ ー サ イ ト は 、 こ の オ プ シ ョ ン を 使 う と シ ス テ ム の デ ィ ス ク 負 荷 を 減 る の で 利 益 が あ る で し ょ う 。 安 全 の た め に 、 ミ ラ ー サ イ ト で あ っ て も 時 々 (一 日 一 度 く ら い )は -s オ プ シ ョ ン な し で を 実 行 す べ き で す 。
-s オ プ シ ョ ン を 指 定 し な い と 、 は フ ァ イ ル ご と に stat (2) シ ス テ ム コ ー ル を 実 行 し 、 フ ァ イ ル の 属 性 が リ ス ト フ ァ イ ル の 記 録 と 一 致 す る か ど う か を 確 認 し ま す 。 こ れ に よ り 、 CVSup 外 部 で の フ ァ イ ル 変 更 は 全 て 検 出 ・ 訂 正 さ れ る こ と が 保 証 さ れ ま す 。
-s オ プ シ ョ ン を 指 定 し 、 か つ ロ ー カ ル で フ ァ イ ル が 1 つ 以 上 変 更 さ れ た 時 の 結 果 は 未 定 義 で す 。 ロ ー カ ル フ ァ イ ル の 損 傷 が 訂 正 さ れ な い ま ま 残 っ た り 、 更 新 を 取 り こ ぼ し た り 、 が 実 行 途 中 で 異 常 終 了 す る か も し れ ま せ ん 。
-v
バ ー ジ ョ ン 番 号 を 表 示 し て 終 了 し ま す 。 サ ー バ へ の 接 続 は 行 い ま せ ん 。
-z
全 て の コ レ ク シ ョ ン の 圧 縮 を 有 効 に し ま す 。 こ の 動 作 は 、 supfile に お い て 、 compress キ ー ワ ー ド を 全 て の コ レ ク シ ョ ン に 追 加 し た 時 と 同 様 で す 。
-Z
全 て の コ レ ク シ ョ ン の 圧 縮 を 無 効 に し ま す 。 こ の 動 作 は 、 supfile に お い て 、 compress キ ー ワ ー ド を 全 て の コ レ ク シ ョ ン か ら 削 除 し た 時 と 同 様 で す 。
supfile は 、 更 新 す べ き フ ァ イ ル の コ レ ク シ ョ ン を 指 定 す る テ キ ス ト フ ァ イ ル で す 。 コ メ ン ト は ‘#’ で 始 ま り 、 そ の 行 の 最 後 ま で 続 き ま す 。 コ メ ン ト と 空 白 を 除 く と 空 で あ る 行 は 無 視 さ れ ま す 。 残 り の そ れ ぞ れ の 行 は 、 サ ー バ 定 義 の フ ァ イ ル の コ レ ク シ ョ ン で 始 ま り ま す 。 こ の 行 で コ レ ク シ ョ ン 名 の 後 に 続 く の は 、 0 個 以 上 の キ ー ワ ー ド ま た は 「 キ ー ワ ー ド =値 」 の 組 で す 。
デ フ ォ ル ト の 設 定 は 、 コ レ ク シ ョ ン 名 が *default で あ る 行 で 指 定 で き ま す 。 こ の デ フ ォ ル ト は 、 supfile 内 の そ れ 以 降 の 行 に 適 用 さ れ ま す 。 *default 行 は 複 数 個 あ っ て も 構 い ま せ ん 。 新 し い 値 は 、 supfile で 前 に 指 定 さ れ た デ フ ォ ル ト 値 に 追 加 さ れ る か 、 デ フ ォ ル ト 値 を 上 書 き し ま す 。 コ レ ク シ ョ ン に 対 し て 明 示 的 に 指 定 さ れ た 値 は 、 全 て の デ フ ォ ル ト 値 を 上 書 き し ま す 。
特 に よ く 使 わ れ る キ ー ワ ー ド を 以 下 に 示 し ま す :
release= releaseName
こ れ は コ レ ク シ ョ ン 内 の フ ァ イ ル の リ リ ー ス を 指 定 し ま す 。 コ レ ク シ ョ ン 名 と 同 じ く 、 リ リ ー ス 名 も サ ー バ の 設 定 フ ァ イ ル 内 で 定 義 さ れ て い ま す 。 普 通 は 各 コ レ ク シ ョ ン 内 に 1 つ の リ リ ー ス し か 含 ま れ て い ま せ ん が 、 何 個 含 ん で も か ま い ま せ ん 。 CVS リ ポ ジ ト リ か ら 得 た コ レ ク シ ョ ン で は 、 慣 習 的 に release=cvs を よ く 使 い ま す 。 CVS で な い コ レ ク シ ョ ン で は 、 慣 習 的 に release=current を 使 い ま す 。
base= base
こ れ は cvsup が 記 録 フ ァ イ ル を 置 い て 管 理 す る デ ィ レ ク ト リ を 指 定 し ま す 。 記 録 フ ァ イ ル に は 、 ク ラ イ ア ン ト マ シ ン 上 に あ る 各 コ レ ク シ ョ ン の 状 態 が 書 か れ ま す 。 base デ ィ レ ク ト リ は 既 に 存 在 し て い な け れ ば な り ま せ ん 。 が こ の デ ィ レ ク ト リ を 作 成 す る こ と は あ り ま せ ん 。 base デ ィ レ ク ト リ の デ フ ォ ル ト 値 は /usr/local/etc/cvsup で す 。
prefix= prefix
こ れ は 、 更 新 さ れ た フ ァ イ ル が 置 か れ る デ ィ レ ク ト リ で す 。 デ フ ォ ル ト で は 、 こ れ は base と 同 じ で す 。 絶 対 パ ス で 指 定 し な け れ ば 、 base か ら の 相 対 パ ス と 解 釈 さ れ ま す 。 prefix デ ィ レ ク ト リ は 既 に 存 在 し て い な け れ ば な り ま せ ん 。 が こ の デ ィ レ ク ト リ を 作 成 す る こ と は あ り ま せ ん 。
特 殊 な 場 合 と し て 、 prefix が ‘SKIP’ と い う 名 の 存 在 し な い フ ァ イ ル を 指 す シ ン ボ リ ッ ク リ ン ク で あ る 場 合 は 、 は そ の コ レ ク シ ョ ン を ス キ ッ プ し ま す 。 こ の 場 合 で も コ レ ク シ ョ ン に 関 係 す る パ ラ メ ー タ の 正 し さ は チ ェ ッ ク さ れ ま す が 、 コ レ ク シ ョ ン の フ ァ イ ル は 全 く 更 新 さ れ ま せ ん 。 こ の 機 能 を 使 う と 、 一 つ の サ イ ト の 複 数 の マ シ ン で 標 準 の supfile を 使 い な が ら 、 更 新 す る コ レ ク シ ョ ン を マ シ ン ご と に 制 御 す る こ と が で き ま す 。
host= hostname
こ の オ プ シ ョ ン は 、 全 て の フ ァ イ ル を 取 り 寄 せ る 元 と な る サ ー バ マ シ ン を 指 定 し ま す 。 は 、 1 回 の 実 行 に お け る 全 て の コ レ ク シ ョ ン を 同 じ ホ ス ト か ら 得 る こ と を 必 要 と し ま す 。 異 な る 複 数 の ホ ス ト か ら コ レ ク シ ョ ン を 更 新 し た け れ ば 、 を 複 数 回 実 行 し な け れ ば な り ま せ ん 。
delete
こ の キ ー ワ ー ド が あ る と 、 は フ ァ イ ル の 削 除 を 許 可 し ま す 。 こ の キ ー ワ ー ド が な け れ ば 、 フ ァ イ ル は 全 く 削 除 さ れ ま せ ん 。
delete キ ー ワ ー ド が あ る と 、 は い わ ゆ る exact モ ー ド に 入 り ま す 。 exact モ ー ド で は 、 CVSup は で き る だ け ク ラ イ ア ン ト 側 の フ ァ イ ル を サ ー バ 側 の フ ァ イ ル に 対 応 さ せ よ う と し ま す 。 こ れ は 、 RCS フ ァ イ ル か ら 個 々 の 差 分 と シ ン ボ リ ッ ク な タ グ を 消 す こ と と 、 フ ァ イ ル 全 体 を 消 す こ と を 含 み ま す 。 exact モ ー ド で は 、 CVSup は 編 集 さ れ た そ れ ぞ れ の フ ァ イ ル を チ ェ ッ ク サ ム を 使 っ て 調 べ 、 編 集 に よ っ て サ ー バ 上 に あ る マ ス タ ー コ ピ ー と 同 一 の フ ァ イ ル が で き る こ と を 保 証 し ま す 。 あ る フ ァ イ ル に つ い て チ ェ ッ ク サ ム の テ ス ト が 失 敗 し た ら 、 CVSup は 最 後 の 手 段 と し て フ ァ イ ル 全 体 を 転 送 し ま す 。
一 般 的 に は 、 CVSup は サ ー バ が 知 っ て い る フ ァ イ ル だ け を 削 除 し ま す 。 ク ラ イ ア ン ト の ツ リ ー に 入 っ て い る 追 加 の フ ァ イ ル は 、 excact モ ー ド で あ っ て も そ の ま ま 残 さ れ ま す 。 よ り 正 確 に 述 べ る と 、 CVSup が 消 そ う と す る フ ァ イ ル は 2 種 類 で す :
•
過 去 に CVSup 自 身 が 生 成 ま た は 更 新 し た フ ァ イ ル 。
•
サ ー バ 上 で 不 要 の 印 が 付 け ら れ た チ ェ ッ ク ア ウ ト 済 み バ ー ジ ョ ン の フ ァ イ ル 。
use-rel-suffix
リ リ ー ス と タ グ か ら 作 っ た サ フ ィ ッ ク ス が が 管 理 し て い る 各 フ ァ イ ル の 名 前 に 追 加 さ れ る よ う に し ま す 。 詳 し く は “リ ス ト フ ァ イ ル ” を 参 照 し て く だ さ い 。
compress
ネ ッ ト ワ ー ク 上 で 送 ら れ る デ ー タ が 全 て 圧 縮 さ れ る よ う に し ま す 。 圧 縮 は 非 常 に 有 効 で あ り 、 圧 縮 し な か っ た 場 合 に 必 要 な 転 送 量 と 比 べ て 普 通 は 65% か ら 75% の バ イ ト デ ー タ を 削 減 で き ま す 。 し か し 、 ク ラ ア イ ン ト と サ ー バ 両 方 の CPU 時 間 と い う 点 で は コ ス ト が か か り ま す 。 LAN で は 、 圧 縮 は 一 般 的 に 生 産 性 を 落 と し ま す 。 実 際 に は フ ァ イ ル の 更 新 が 遅 く な っ て し ま い ま す 。 56K ビ ッ ト /秒 あ る い は そ れ 以 下 の 速 度 の 接 続 で は 、 圧 縮 は ほ ぼ 確 実 に 得 に な り ま す 。 こ れ ら 両 極 端 な ケ ー ス の 中 間 の 速 度 の ネ ッ ト ワ ー ク 接 続 で は 、 実 験 を 行 っ て 参 考 と し ま し ょ う 。
-z コ マ ン ド ラ イ ン オ プ シ ョ ン は 、 全 て の コ レ ク シ ョ ン に 対 し て compress キ ー ワ ー ド を 有 効 に し ま す 。 supfile で の 指 定 と は 無 関 係 で す 。 同 様 に -Z コ マ ン ド ラ イ ン オ プ シ ョ ン は 、 全 て の コ レ ク シ ョ ン に 対 し て compress オ プ シ ョ ン を 無 効 に し ま す 。
norcs
RCS フ ァ イ ル の 特 別 扱 い を な く し ま す 。 RCS フ ァ イ ル は 他 の フ ァ イ ル と 同 じ よ う に 扱 わ れ ま す 。
norsync
通 常 の (RCS で な い )フ ァ イ ル の 更 新 の 際 に 、 Tridgell と Mackerras の rsync ア ル ゴ リ ズ ム を 使 い ま せ ん 。 こ の ア ル ゴ リ ズ ム は ど ん な 種 類 の フ ァ イ ル で も 正 し く 動 作 し ま す が 、 圧 縮 さ れ た tar ア ー カ イ ブ の よ う な フ ァ イ ル に 対 し て は 、 効 率 的 で は あ り ま せ ん し 計 算 的 に も コ ス ト が 高 く 付 き ま す 。
strictrcs
更 新 さ れ た RCS フ ァ イ ル を バ イ ト 単 位 の 厳 密 な MD5 チ ェ ッ ク サ ム で 確 認 し ま す 。 通 常 、 CVSup は RCS フ ァ イ ル に 対 し て も っ と 緩 い チ ェ ッ ク サ ム を 用 い ま す 。 こ れ は 、 空 白 文 字 に よ る 無 意 味 な 違 い を 無 視 し ま す 。 異 な る バ ー ジ ョ ン の CVS と RCS は 、 同 じ RCS フ ァ イ ル に 対 し て も 空 白 が 様 々 に 異 な り ま す 。 し た が っ て 厳 密 な チ ェ ッ ク サ ム を 取 る と 、 論 理 的 に は 同 じ で あ る フ ァ イ ル に 対 し て 意 味 が な い 不 一 致 を 報 告 す る か も し れ ま せ ん 。 こ れ に よ り 不 要 な “fixups” が 大 量 に 行 わ れ 、 更 新 が 遅 く な る こ と が あ り ま す 。
nocheckrcs
更 新 さ れ た RCS フ ァ イ ル に 対 し て 、 MD5 チ ェ ッ ク サ ム の 比 較 を 行 い ま せ ん 。 delete キ ー ワ ー ド が 指 定 さ れ て い な け れ ば 、 こ の オ プ シ ョ ン が 自 動 的 に 有 効 に な り ま す 。
execute
サ ー バ か ら 受 け 取 っ た シ ェ ル コ マ ン ド を 実 行 で き る よ う に し ま す 。 こ の オ プ シ ョ ン は 注 意 し て 使 う べ き で す 。 と い う の も 、 セ キ ュ リ テ ィ な 危 険 を 及 ぼ す か も し れ な い か ら で す 。
preserve
に 、 可 能 な 全 て の 属 性 を サ ー バ か ら ク ラ イ ア ン ト に 転 送 し よ う と 試 み さ せ ま す 。 サ ポ ー ト さ れ る 属 性 は ホ ス ト の プ ラ ッ ト フ ォ ー ム と ク ラ イ ア ン ト の プ ラ ッ ト フ ォ ー ム に 依 存 し ま す 。 FreeBSD シ ス テ ム で は 、 以 下 の 属 性 が サ ポ ー ト さ れ て い ま す :
•
所 有 者
•
グ ル ー プ
•
パ ー ミ ッ シ ョ ン
•
フ ラ グ
•
修 正 時 刻
こ れ ら の う ち 、 最 初 の 4 つ の 属 性 は preserve キ ー ワ ー ド で 制 御 し ま す 。 5 つ 目 は ど ん な 場 合 で も 保 存 さ れ ま す 。
preserve キ ー ワ ー ド は 、 ユ ー ザ フ ァ イ ル や CVS リ ポ ジ ト リ の 更 新 に 使 う た め の も の で は あ り ま せ ん 。 こ れ は 、 ホ ス ト の 全 体 の フ ァ イ ル ツ リ ー を 正 確 に 複 製 す る と い っ た 特 殊 な 目 的 の た め だ け に 使 わ れ ま す 。 preserve が 指 定 さ れ て い る と 、 サ ー バ ホ ス ト と ク ラ イ ア ン ト ホ ス ト の 何 ら か の 違 い が 問 題 を 起 こ す か も し れ ま せ ん 。 例 え ば 、 ク ラ イ ア ン ト マ シ ン 上 に 存 在 し な い 所 有 者 が 所 有 す る フ ァ イ ル を ク ラ イ ア ン ト が 受 け 取 っ た 場 合 、 オ ー ナ を 保 存 す る こ と は で き ま せ ん 。 同 様 に こ れ に よ っ て 意 図 し な い パ ー ミ ッ シ ョ ン が 設 定 さ れ る こ と が あ り ま す 。 さ ら に 、 そ れ 以 降 の 更 新 で は 、 毎 回 ク ラ イ ア ン ト 上 の フ ァ イ ル の 所 有 者 を 訂 正 し よ う と し て 失 敗 し 、 時 間 と 帯 域 幅 を 無 駄 に し て し ま う で し ょ う 。 最 後 に な り ま す が 、 preserve モ ー ド は ネ ッ ト ワ ー ク の ト ラ フ ィ ッ ク を 増 大 さ せ 、 更 新 を 遅 く し ま す 。
preserve モ ー ド を 正 し く 機 能 さ せ る た め に は 、 ク ラ イ ア ン ト は root の ア ク セ ス 権 限 で 実 行 し な け れ ば な り ま せ ん 。 ク ラ イ ア ン ト が root で な け れ ば 、 所 有 者 、 グ ル ー プ 、 フ ラ グ の 情 報 を 保 存 し よ う と す る 機 能 は 無 効 に な り ま す 。
preserve キ ー ワ ー ド は 、 checkout モ ー ド で は 無 視 さ れ ま す 。
umask= n
コ レ ク シ ョ ン 内 の フ ァ イ ル を 更 新 す る 時 、 に umask 値 n (8 進 値 )を 使 わ せ ま す 。 こ の オ プ シ ョ ン は 、 preserve が 指 定 さ れ て い る と 無 視 さ れ ま す 。
い く つ か の 追 加 的 で 、 よ り 専 門 的 な キ ー ワ ー ド に つ い て は 後 述 し ま す 。 sup と の 後 方 互 換 性 の た め 、 認 識 で き な か っ た キ ー ワ ー ド は 黙 っ て 無 視 さ れ ま す 。
操 作
は GUI(グ ラ フ ィ カ ル ユ ー ザ イ ン タ フ ェ ー ス )を 持 っ て お り 、 こ れ を 使 う と ユ ー ザ は 更 新 中 の 進 行 状 況 と 処 理 を 監 視 で き ま す 。 こ の GUI は 、 コ マ ン ド ラ イ ン オ プ シ ョ ン -g が 指 定 さ れ る か 、 DISPLAY 環 境 変 数 が 設 定 さ れ て い な け れ ば 無 効 に な り ま す 。 GUI に は 、 “Filter” 入 力 フ ィ ー ル ド が あ り ま す 。 こ こ に パ タ ー ン を 入 力 し て 、 更 新 す る フ ァ イ ル を 制 限 す る こ と が で き ま す 。 パ タ ー ン は -i オ プ シ ョ ン の 指 定 と 同 様 に 記 述 し ま す 。 複 数 の パ タ ー ン を 入 力 す る 際 に は 、 空 白 で 区 切 ら な け れ ば な り ま せ ん 。
現 在 の と こ ろ は 、 supfile で 指 定 さ れ た パ ラ メ ー タ を GUI で 変 更 す る こ と は で き ま せ ん 。 こ の 点 は 将 来 の リ リ ー ス で の 計 画 に な っ て い ま す 。 ど ち ら か と い う と 必 要 な い も の で は あ り ま す が 、 GUI は 見 て 楽 し い も の で す 。
CVS モ ー ド
CVSup は 、 2 つ の 主 な 動 作 モ ー ド を サ ポ ー ト し て い ま す 。 こ れ ら は CVS モ ー ド と checkout モ ー ド と 呼 ば れ る も の で す 。
CVS モ ー ド で は 、 ク ラ イ ア ン ト は マ ス タ ー の CVS リ ポ ジ ト リ を 構 成 し て い る 実 際 の RCS フ ァ イ ル の コ ピ ー を 受 信 し ま す 。 CVS モ ー ド は デ フ ォ ル ト の 動 作 モ ー ド で す 。 こ の モ ー ド は 、 CVS リ ポ ジ ト リ の 完 全 な コ ピ ー を ク ラ イ ア ン ト マ シ ン 上 で メ ン テ ナ ン ス し よ う と ユ ー ザ が 考 え て い る 場 合 に は 適 し て い ま す 。
CVS モ ー ド は 、 CVS リ ポ ジ ト リ ベ ー ス で な い フ ァ イ ル の コ レ ク シ ョ ン に 対 し て も う ま く 使 え ま す 。 こ の 場 合 に は フ ァ イ ル は 解 釈 さ れ る こ と な く 、 単 に そ の ま ま 転 送 さ れ ま す 。
checkout モ ー ド
checkout モ ー ド で は 、 ク ラ イ ア ン ト は 特 定 の リ ビ ジ ョ ン の フ ァ イ ル を 受 信 し ま す 。 こ れ は サ ー バ の CVS リ ポ ジ ト リ か ら 直 接 チ ェ ッ ク ア ウ ト さ れ ま す 。 checkout モ ー ド を 使 う と 、 ク ラ イ ア ン ト は 任 意 の バ ー ジ ョ ン を リ ポ ジ ト リ か ら 取 得 で き ま す 。 こ の 際 、 チ ェ ッ ク ア ウ ト さ れ る 時 の 形 で 複 数 個 の バ ー ジ ョ ン を サ ー バ 上 に 持 つ 必 要 は あ り ま せ ん 。 し か し 、 checkout モ ー ド で は 、 そ の 基 本 機 能 よ り も ず っ と 柔 軟 に 動 作 さ せ る こ と が で き ま す 。 い ま す 。 ク ラ イ ア ン ト は CVS の シ ン ボ リ ッ ク タ グ を 指 定 で き ま す し 、 任 意 の 日 付 の 指 定 も で き ま す 。 両 方 を 指 定 す る こ と も で き ま す 。 ま た CVSup は 、 こ の 指 定 に 対 応 す る フ ァ イ ル を リ ポ ジ ト リ 内 か ら チ ェ ッ ク ア ウ ト 形 式 で 取 り 出 す こ と が で き ま す 。
checkout モ ー ド は コ レ ク シ ョ ン 別 に 指 定 し ま す 。 指 定 は 、 supfile 内 に 以 下 の キ ー ワ ー ド の 一 つ あ る い は 両 方 を 含 め る こ と に よ っ て 行 い ま す :
tag= tagname
シ ン ボ リ ッ ク タ グ を 指 定 し ま す 。 こ の タ グ は 、 CVS リ ポ ジ ト リ か ら 取 り 出 す リ ビ ジ ョ ン を 選 択 す る た め に 使 わ な け れ ば な り ま せ ん 。 こ の タ グ は ブ ラ ン チ ま た は 特 定 の リ ビ ジ ョ ン を 示 す こ と が で き ま す 。 タ グ は シ ン ボ リ ッ ク で な け れ ば な り ま せ ん 。 つ ま り 、 数 値 の リ ビ ジ ョ ン 番 号 は サ ポ ー ト さ れ て い ま せ ん 。
FreeBSD の ソ ー ス リ ポ ジ ト リ の 場 合 は 、 以 下 の タ グ が よ く 使 わ れ ま す :
RELENG_3
‘stable’ ブ ラ ン チ 。
.
メ イ ン ブ ラ ン チ ( ‘current’ リ リ ー ス )。 date キ ー ワ ー ド だ け が 指 定 さ れ る と 、 こ ち ら が デ フ ォ ル ト で す 。
date= [ cc ] yy.mm.dd.hh.mm.ss
こ れ は 、 CVS リ ポ ジ ト リ か ら チ ェ ッ ク ア ウ ト す る リ ビ ジ ョ ン の 選 択 に 使 う 日 付 を 指 定 し ま す 。 ク ラ イ ア ン ト は 実 際 に は 、 指 定 さ れ た 日 付 と 時 刻 の リ ビ ジ ョ ン を 受 け 取 り ま す 。
現 時 点 で は 、 日 付 の フ ォ ー マ ッ ト は 柔 軟 で は あ り ま せ ん 。 17 文 字 あ る い は 19 文 字 の 全 て を 、 説 明 し た フ ォ ー マ ッ ト で 正 確 に 指 定 し な け れ ば な り ま せ ん 。 2000 年 以 降 の 場 合 は 、 世 紀 を cc で 指 定 し ま す 。 こ れ よ り 前 の 年 の 場 合 は 、 最 後 の 2 桁 だ け を yy で 指 定 し ま す 。 日 付 と 時 刻 は GMT で 扱 い ま す 。 デ フ ォ ル ト の 日 付 は ‘.’ で す 。 こ れ は “で き る だ け 新 し い も の ” と い う 意 味 で す 。
checkout モ ー ド を 有 効 に す る た め に は 、 少 な く と も こ れ ら の キ ー ワ ー ド の い ず れ か を 指 定 し な け れ ば な り ま せ ん 。 ど ち ら も 指 定 さ れ て い な け れ ば 、 CVSup は デ フ ォ ル ト の CVS モ ー ド で 動 作 し ま す 。
ブ ラ ン チ タ グ と 日 付 が 両 方 と も 指 定 さ れ る と 、 指 定 さ れ た ブ ラ ン チ 上 の 指 定 さ れ た 日 付 の 時 点 の リ ビ ジ ョ ン が チ ェ ッ ク ア ウ ト さ れ ま す 。 日 付 を 特 定 の リ リ ー ス タ グ に 付 け て 指 定 す る こ と も で き ま す が 、 あ ま り 役 に は 立 た な い で し ょ う 。
checkout モ ー ド で は 、 タ グ や 日 付 を 更 新 と 更 新 の 間 に 変 え ら れ ま す 。 例 え ば 、 ‘tag=.’ と い う 指 定 を 使 っ て コ レ ク シ ョ ン が 転 送 さ れ た と し ま し ょ う 。 ユ ー ザ は 後 か ら 指 定 を ‘tag=RELENG_3’ に 変 え ら れ ま す 。 こ れ を 指 定 す る と 、 CVSup は チ ェ ッ ク ア ウ ト さ れ た フ ァ イ ル を 編 集 し 、 ‘current’ バ ー ジ ョ ン が ‘stable’ バ ー ジ ョ ン に な る よ う に し ま す 。 一 般 的 に は 、 CVSup は ど ん な タ グ /日 付 の 組 合 せ で あ っ て も 、 他 の タ グ /日 付 の 組 合 せ に 変 換 し て く れ ま す 。 変 換 は 、 両 者 の 間 に あ る RCS の 差 分 を 既 存 の フ ァ イ ル に 適 用 す る こ と に よ っ て 行 い ま す 。
チ ェ ッ ク ア ウ ト さ れ た フ ァ イ ル の コ レ ク シ ョ ン を 、 あ る タ グ か ら 別 の タ グ に 変 換 す る と き に は 、 変 換 の 前 後 で 必 ず 同 じ リ ス ト フ ァ イ ル が 使 わ れ る よ う に す る た め 、 supfile フ ァ イ ル 中 で list キ ー ワ ー ド を 指 定 す る こ と が 重 要 で す 。 リ ス ト フ ァ イ ル は 次 の “リ ス ト フ ァ イ ル ” の 節 で 説 明 し ま す 。 効 率 の た め 、 は 各 コ レ ク シ ョ ン に つ い て の 記 録 フ ァ イ ル を 管 理 し て い ま す 。 こ れ を リ ス ト フ ァ イ ル と 呼 び ま す 。 リ ス ト フ ァ イ ル に は 、 ク ラ イ ア ン ト が 現 在 持 っ て い る フ ァ イ ル と リ ビ ジ ョ ン に 関 す る 情 報 が 書 か れ て い ま す 。 こ の フ ァ イ ル に は 、 ク ラ イ ア ン ト の ツ リ ー に 入 っ て い る 実 際 の フ ァ イ ル と リ ス ト フ ァ イ ル が 一 致 し て い る こ と を 確 認 す る た め の 情 報 も 書 か れ て い ま す 。
厳 密 に 言 う と リ ス ト フ ァ イ ル は 必 要 で は あ り ま せ ん 。 こ の フ ァ イ ル が 削 除 さ れ る か 、 ク ラ イ ア ン ト が 持 っ て い る 実 際 の フ ァ イ ル と の 不 一 致 が 起 こ る と 、 は 最 後 の 手 段 と し て 少 し 効 率 の 悪 い 方 法 で ク ラ イ ア ン ト 側 の フ ァ イ ル の 識 別 と 更 新 を 行 い ま す 。 こ の 際 に は 、 CVSup の 動 作 モ ー ド に よ っ て 、 タ イ ム ス タ ン プ 、 チ ェ ッ ク サ ム 、 RCS フ ァ イ ル の 解 析 結 果 な ど が 使 わ れ ま す 。
リ ス ト フ ァ イ ル は 不 可 欠 で は な い の で 、 は FTP や CD-ROM か ら 入 手 し た 既 存 の フ ァ イ ル ツ リ ー を 「 利 用 」 で き ま す 。 は ク ラ イ ア ン ト 側 の フ ァ イ ル の バ ー ジ ョ ン を 識 別 し 、 必 要 に 応 じ て こ れ を 更 新 し ま す 。 さ ら に 、 将 来 使 う た め に リ ス ト フ ァ イ ル を 生 成 し ま す 。 他 の シ ス テ ム が 作 っ た フ ァ イ ル ツ リ ー を 使 う 場 合 の 動 作 は 、 通 常 の 更 新 ほ ど 高 速 で は あ り ま せ ん 。 ま た 、 サ ー バ に か か る 負 荷 も 高 く な り ま す 。 リ ス ト フ ァ イ ル は コ レ ク シ ョ ン 固 有 の デ ィ レ ク ト リ に 保 存 さ れ ま す 。 詳 し く は “フ ァ イ ル ” セ ク シ ョ ン を ご 覧 く だ さ い 。 リ ス ト フ ァ イ ル の 名 前 は 必 ず ‘checkouts’ で 始 ま り ま す 。 supfile 内 で キ ー ワ ー ド use-rel-suffix が 指 定 さ れ て い る と 、 リ リ ー ス と タ グ か ら 作 っ た サ フ ィ ッ ク ス が フ ァ イ ル 名 に 追 加 さ れ ま す 。 デ フ ォ ル ト の サ フ ィ ッ ク ス は 、 supfile で 明 示 的 に サ フ ィ ッ ク ス を 指 定 す る こ と に よ り 上 書 き さ れ ま す :
list= suffix
こ れ は リ ス ト フ ァ イ ル の 名 前 に 付 け る サ フ ィ ッ ク ス の 指 定 で す 。 サ フ ィ ッ ク ス の 先 頭 の ド ッ ト は 自 動 的 に 付 け ら れ ま す 。 例 え ば 、 ‘list=stable’ と す る と 、 checkouts.stable と い う 名 前 の リ ス ト フ ァ イ ル が 作 ら れ ま す 。 こ の 場 合 に は 、 リ リ ー ス 、 タ グ 、 use-rel-suffix キ ー ワ ー ド は 関 係 あ り ま せ ん 。
refuse フ ァ イ ル
ユ ー ザ は 受 け 取 り た く な い フ ァ イ ル の 集 合 を 指 定 で き ま す 。 こ う い っ た フ ァ イ ル は 、 い わ ゆ る refuse フ ァ イ ル 内 で フ ァ イ ル 名 パ タ ー ン と し て 指 定 さ れ ま す 。 パ タ ー ン は 空 白 文 字 で 区 切 ら れ 、 各 行 に は 複 数 個 の パ タ ー ン を 置 く こ と が で き ま す 。 パ タ ー ン に マ ッ チ す る フ ァ イ ル と デ ィ レ ク ト リ は 、 更 新 も 削 除 も さ れ ま せ ん 。 こ れ ら の フ ァ イ ル は 単 に 無 視 さ れ ま す 。
現 在 は 、 refuse フ ァ イ ル 内 に コ メ ン ト に 書 く 方 法 は あ り ま せ ん 。
パ タ ー ン は sh (1) の そ れ と 似 て い ま す が 、 ス ラ ッ シ ュ の 特 別 扱 い や 、 ピ リ オ ド で 始 ま る フ ァ イ ル の 特 別 扱 い が な い 点 が 異 な り ま す 。 例 え ば 、 パ タ ー ン ‘*.c’ は ‘.c’ で 終 わ る 全 て の フ ァ イ ル に マ ッ チ し ま す 。 こ れ に は ‘foo/bar/lam.c’ と い っ た サ ブ デ ィ レ ク ト リ 内 の フ ァ イ ル も 含 ま れ ま す 。 全 て の パ タ ー ン は コ レ ク シ ョ ン の プ レ フ ィ ッ ク ス デ ィ レ ク ト リ か ら の 相 対 パ ス と し て 解 釈 さ れ ま す 。
こ れ ら フ ァ イ ル が CVS リ ポ ジ ト リ か ら 得 た も の な ら ば ——普 通 は そ う な の で す が ——こ れ ら は RCS フ ァ イ ル と な り ま す 。 こ れ ら の フ ァ イ ル に は 、 ‘,v’ と い う サ フ ィ ッ ク ス が 付 き ま す 。 パ タ ー ン に つ い て は サ フ ィ ッ ク ス も 考 慮 に 入 れ な け れ ば な り ま せ ん 。 例 え ば 、 FreeBSD の 文 書 フ ァ イ ル は ‘doc’ と い う base デ ィ レ ク ト リ の サ ブ デ ィ レ ク ト リ に 入 っ て い ま す 。 そ の デ ィ レ ク ト リ に あ る ‘Makefile’ が 不 要 な 場 合 に
doc/Makefile
と 指 定 し て も う ま く 動 作 し ま せ ん 。 な ぜ な ら 、 サ ー バ 上 に あ る フ ァ イ ル は ‘Makefile,v’ だ か ら で す 。 も っ と よ い 解 決 方 法 は 、
doc/Makefile*
と 指 定 す る こ と で す 。 こ の 指 定 で あ れ ば 、 ‘Makefile’ が RCS フ ァ イ ル で あ ろ う と な か ろ う と マ ッ チ し ま す 。
別 の 例 と し て は 、 日 本 語 、 ロ シ ア 語 、 中 国 語 の 翻 訳 を 避 け て FreeBSD 文 書 フ ァ イ ル を 取 得 す る に は 、 以 下 の 行 を 含 む refuse フ ァ イ ル を 作 り ま す :
doc/ja*
doc/ru*
doc/zh*
そ れ ぞ れ の supfile 行 は 、 3 つ の refuse フ ァ イ ル に よ っ て 調 べ ら れ ま す 。 大 域 的 な refuse フ ァ イ ル と し て base/collDir/refuse が あ り ま す 。 こ れ は 全 て の コ レ ク シ ョ ン と リ リ ー ス に 適 用 さ れ ま す 。 コ レ ク シ ョ ン 別 の refuse フ ァ イ ル と し て
base/collDir/collection/refuse が あ り ま す 。 こ れ は 特 定 の コ レ ク シ ョ ン に 適 用 さ れ ま す 。 最 後 に 、 リ リ ー ス と タ グ 別 の refuse フ ァ イ ル が あ り ま す 。 こ れ は 、 コ レ ク シ ョ ン 内 の 指 定 さ れ た リ リ ー ス /タ グ の 組 み 合 わ せ に 対 し て の み 適 用 さ れ ま す 。 最 後 の refuse フ ァ イ ル の 名 前 は 、 コ レ ク シ ョ ン 別 の refuse フ ァ イ ル の 名 前 に サ フ ィ ッ ク ス を 加 え る こ と に よ っ て 付 け ら れ ま す 。 こ れ は 先 に 説 明 し た リ ス ト フ ァ イ ル と 同 じ 方 法 で す 。 ど ん な 種 類 の refuse フ ァ イ ル も 存 在 し な く て も か ま い ま せ ん 。
は 、 collDir に 対 す る base と sup の 組 み 込 み の デ フ ォ ル ト 値 を /usr/local/etc/cvsup に 持 っ て い ま す が 、 ど ち ら の 値 も 上 書 き 可 能 で す 。 base の 値 は -b オ プ シ ョ ン ま た は supfile フ ァ イ ル 中 の base=pathname エ ン ト リ で 変 更 で き ま す 。 (両 方 指 定 し た 場 合 は 、 -b オ プ シ ョ ン の 方 が supfile の エ ン ト リ よ り も 優 先 さ れ ま す 。 ) collDir の 値 は -c オ プ シ ョ ン で し か 変 更 で き ま せ ん 。 こ れ を 変 更 す る supfile コ マ ン ド は あ り ま せ ん 。
例 え ば 、 base と collDir の 両 方 に デ フ ォ ル ト 値 が 設 定 さ れ て お り 、 コ レ ク シ ョ ン が ‘src-all’ で リ リ ー ス が ‘cvs’ で あ る 場 合 を 考 え ま す 。 さ ら に 、 ‘tag=RELENG_3’ に 対 し て checkout モ ー ド が 使 わ れ て い る も の と し ま す 。 こ の 場 合 、 refuse フ ァ イ ル の 名 前 と し て は 以 下 の 3 つ が 考 え ら れ ま す :
/usr/local/etc/cvsup/sup/refuse
/usr/local/etc/cvsup/sup/src-all/refuse
/usr/local/etc/cvsup/sup/src-all/refuse.cvs:RELENG_3
supfile が コ マ ン ド base=/foo を 含 ん で い る 場 合 、 refuse フ ァ イ ル は 以 下 の よ う に な り ま す :
/foo/sup/refuse
/foo/sup/src-all/refuse
/foo/sup/src-all/refuse.cvs:RELENG_3
-b /bar が 使 わ れ て い る 場 合 ( supfile フ ァ イ ル 中 に base=/foo コ マ ン ド が あ っ て も ):
/bar/sup/refuse
/bar/sup/src-all/refuse
/bar/sup/src-all/refuse.cvs:RELENG_3
そ し て -c stool も 使 わ れ て い る 場 合 :
/bar/stool/refuse
/bar/stool/src-all/refuse
/bar/stool/src-all/refuse.cvs:RELENG_3
認 証
CVSup は 認 証 機 構 を 備 え て お り 、 こ れ を 使 っ て ク ラ イ ア ン ト と サ ー バ が お 互 い の 身 元 を 確 認 す る こ と が で き ま す 。 こ の 機 構 は 、 パ ケ ッ ト 盗 聴 や リ プ レ イ 攻 撃 の 影 響 を 受 け な い challenge-response プ ロ ト コ ル を 用 い て い ま す 。 ネ ッ ト ワ ー ク 上 で は 、 パ ス ワ ー ド は ど ち ら の 向 き に も 流 れ ま せ ん 。 ク ラ イ ア ン ト と サ ー バ の い ず れ も 、 お 互 い の 身 元 を 独 立 に 確 認 で き ま す 。
フ ァ イ ル $ HOME /.cvsup/auth に は 認 証 に 使 わ れ る 情 報 が 書 か れ て い ま す 。 こ の フ ァ イ ル に は 、 ク ラ イ ア ン ト が ア ク セ ス 可 能 な 各 サ ー バ に つ い て の レ コ ー ド が 入 っ て い ま す 。 そ れ ぞ れ の レ コ ー ド は 、 フ ァ イ ル 中 に 1 行 で 書 か れ ま す 。 ‘#’ で 始 ま る 行 は 無 視 さ れ ま す 。 空 白 文 字 だ け の 行 も 同 様 で す 。 た だ し 、 フ ァ イ ル 中 の 他 の 場 所 で は 空 白 文 字 も 意 味 を 持 ち ま す 。 フ ィ ー ル ド は ‘:’ 文 字 で 区 切 ら れ ま す 。
フ ァ イ ル の 各 レ コ ー ド は 以 下 の 形 式 で す :
serverName : clientName : password : comment
た と え 空 で あ っ て も 、 全 て の フ ィ ー ル ド は 存 在 し な け れ ば な り ま せ ん 。 ServerName は レ コ ー ド が 適 用 さ れ る サ ー バ 名 で す 。 慣 習 的 に 、 こ れ は カ ノ ニ カ ル か つ 完 全 に ド メ イ ン 名 が 指 定 さ れ た サ ー バ 名 で す (例 : ‘CVSup177.FreeBSD.ORG’ )。 こ れ は サ ー バ が 自 分 の 名 前 と 考 え て い る ホ ス ト 名 で な け れ ば な り ま せ ん 。 名 前 に つ い て は 大 文 字 ・ 小 文 字 は 区 別 さ れ ま せ ん 。
ClientName は ク ラ イ ア ン ト が サ ー バ へ の ア ク セ ス 権 を 得 る と き に 使 う 名 前 で す 。 慣 習 的 に 、 ク ラ イ ア ン ト 名 に は 全 て e-mail ア ド レ ス が 使 わ れ ま す (例 : ‘BillyJoe@FreeBSD.ORG’ )。 ク ラ イ ア ン ト 名 で は 大 文 字 ・ 小 文 字 は 区 別 さ れ ま せ ん 。
Password は 秘 密 の 文 字 列 で あ り 、 ク ラ イ ア ン ト が 身 元 を 証 明 す る た め に 使 い ま す 。 パ ス ワ ー ド 文 字 列 は ‘:’ や 改 行 文 字 を 含 ん で は い け ま せ ん 。
Comment は レ コ ー ド を 識 別 す る た め の 付 加 的 な 情 報 を 持 ち ま す 。 プ ロ グ ラ ム に 解 釈 さ れ る こ と は あ り ま せ ん 。
指 定 さ れ た サ ー バ に 対 す る 認 証 の 設 定 を 行 う に は 、 以 下 の 手 順 を 実 行 し な け れ ば な り ま せ ん :
1.
サ ー バ 管 理 者 ま た は 別 の 情 報 源 か ら 公 式 な serverName を 取 得 し ま す 。
2.
適 切 な clientName を 選 び ま す 。 こ れ は 有 効 な 電 子 メ ー ル ア ド レ ス の 形 式 に す べ き で す 。 こ れ は 、 サ ー バ 管 理 者 が 必 要 に 応 じ て ユ ー ザ に 連 絡 し や す く す る た め で す 。
3.
秘 密 の password と し て 任 意 の 文 字 列 を 選 び ま す 。
4.
cvpasswd ユ ー テ ィ リ テ ィ を 実 行 し 、 質 問 に 対 し て パ ス ワ ー ド を 入 力 し ま す 。 こ の ユ ー テ ィ リ テ ィ は サ ー バ の 管 理 者 に 送 る 行 を 出 力 し 、 そ れ か ら ユ ー ザ の $ HOME /.cvsup/auth フ ァ イ ル の 修 正 手 順 を 示 し ま す 。 こ の 行 を サ ー バ 管 理 者 に 送 る に は 、 安 全 な 手 段 を 使 う べ き で す 。
$ HOME /.cvsup/auth に は パ ス ワ ー ド が 入 っ て い る の で 、 必 ず 自 分 以 外 に は 誰 も 読 め な い よ う に し て く だ さ い 。
認 証 は そ れ ぞ れ の 向 き で 独 立 に 動 作 し ま す 。 サ ー バ の 管 理 者 は 、 ユ ー ザ が 身 元 を 証 明 し な け れ ば な ら な い か ど う か を 制 御 し ま す 。 ユ ー ザ は サ ー バ の 身 元 を チ ェ ッ ク す る か ど う か を 制 御 し ま す 。 制 御 に は -a コ マ ン ド ラ イ ン オ プ シ ョ ン を 使 い ま す 。
ミ ラ ー リ ン グ の た め の CVSup の 使 用
CVSup は CVS リ ポ ジ ト リ 用 に 最 適 化 さ れ て い る の で 、 汎 用 的 な ミ ラ ー リ ン グ と し て 非 常 に う ま く 動 作 し ま す 。 CVSup は ど ん な 種 類 の フ ァ イ ル の 更 新 に も 使 え ま す 。
•
RCS フ ァ イ ル の 更 新 は 、 個 々 の タ グ と 差 分 の 転 送 お よ び 、 こ れ ら の ク ラ イ ア ン ト 側 の フ ァ イ ル へ の マ ー ジ に よ っ て 行 わ れ ま す 。
•
通 常 フ ァ イ ル は 、 可 能 で あ れ ば rsync ア ル ゴ リ ズ ム を 使 っ て 更 新 さ れ ま す 。 rsync ア ル ゴ リ ズ ム が 無 効 に さ れ て い る 場 合 、 追 加 さ れ た デ ー タ を 持 つ サ ー バ 上 の フ ァ イ ル (例 : ロ グ フ ァ イ ル )は 、 新 し く 加 わ っ た 末 尾 の 部 分 だ け を 受 け 取 り ま す 。 他 の 通 常 フ ァ イ ル は ま る ご と 置 き 換 え ら れ ま す 。
•
空 の デ ィ レ ク ト リ は 残 さ れ ま す 。
•
シ ン ボ リ ッ ク リ ン ク は 、 サ ー バ の 設 定 フ ァ イ ル 内 で symlink と rsymlink コ マ ン ド が 指 定 さ れ て い る と 更 新 さ れ ま す 。 詳 し く は cvsupd (8) を ご 覧 く だ さ い 。
•
ハ ー ド リ ン ク は そ れ ぞ れ の コ レ ク シ ョ ン 内 で は 保 存 さ れ ま す が 、 コ レ ク シ ョ ン 間 で は 保 存 さ れ ま せ ん 。
•
デ バ イ ス ノ ー ド は メ ジ ャ ー 番 号 と マ イ ナ ー 番 号 を 使 っ て 更 新 さ れ ま す 。 ク ラ イ ア ン ト の ホ ス ト と サ ー バ の ホ ス ト で 異 な る オ ペ レ ー テ ィ ン グ シ ス テ ム が 動 作 し て い る と 、 こ れ は 望 ま し い 結 果 と な ら な い こ と が あ り ま す 。
CVSup と 防 火 壁
は 、 様 々 な 設 定 の 防 火 壁 を 超 え る た め に 数 多 く の モ ー ド を 用 意 し て い ま す 。 こ れ ら の モ ー ド は -P オ プ シ ョ ン か 、 m3socks コ マ ン ド を 使 っ て 制 御 で き ま す 。 を 使 え る よ う に す る に は 、 防 火 壁 は サ ー バ ホ ス ト の 5999 番 ポ ー ト へ の 外 向 き の 接 続 を 最 低 限 許 可 し な け れ ば な り ま せ ん 。 こ の 条 件 が 満 た さ れ て い れ ば 、 SOCKS の 有 無 に 関 わ ら ず 多 重 モ ー ド ( -P m ) が 動 作 す る は ず で す 。
も う 少 し 防 火 壁 の 制 限 が 緩 け れ ば 、 passive モ ー ド や 他 の モ ー ド の 一 つ を 使 っ て 、 効 率 を 少 し 上 げ る こ と が で き ま す 。 詳 し く は -P オ プ シ ョ ン の 説 明 を ご 覧 く だ さ い 。
特 定 の 種 類 の 防 火 壁 と CVSup を 組 み 合 わ せ て 使 う 際 の 情 報 に つ い て は 、 ⟨ http://www.polstra.com/projects/freeware/CVSup/⟩ に あ る CVSup FAQ を ご 覧 く だ さ い 。
SOCKS と 組 み 合 わ せ て の CVSup の 利 用
SOCKS プ ロ キ シ サ ー バ 経 由 で の 通 信 は 、 現 在 は FreeBSD 上 で し か サ ポ ー ト さ れ て い ま せ ん 。 こ れ を 用 い る た め に は 、 port と し て 用 意 さ れ て い る 修 正 版 の Modula-3 の 実 行 時 シ ス テ ム ( lang/modula-3-lib )と ア ド オ ン の SOCKS ラ イ ブ ラ リ ( lang/modula-3-socks )が 必 要 で す 。 ま た 、 SOCKS ラ イ ブ ラ リ は 動 的 リ ン ク 技 術 を 使 う の で 、 の 実 行 フ ァ イ ル は 完 全 に 動 的 リ ン ク さ れ て い る 必 要 が あ り ま す 。 FreeBSD の port の net/cvsup は 、 必 要 に 応 じ て を 完 全 に 動 的 に リ ン ク し ま す 。
SOCKS の 動 作 を 有 効 に す る に は 、 単 に lang/modula-3-socks パ ッ ケ ー ジ に 含 ま れ る m3socks と 組 み 合 わ せ て を 実 行 し て く だ さ い 。 詳 細 に つ い て は m3socks (1) を ご 覧 く だ さ い 。
ssh を 使 っ た ポ ー ト 転 送
防 火 壁 の 内 側 の ユ ー ザ は 、 SOCKS の 代 替 品 と し て 、 Secure Shell パ ッ ケ ー ジ の ssh が 持 っ て い る TCP ポ ー ト 転 送 機 能 を 使 っ て 防 火 壁 を 通 過 で き ま す 。 こ れ を 行 う た め に は 、 ユ ー ザ は CVSup の サ ー バ ホ ス ト に ロ グ イ ン ア カ ウ ン ト が 必 要 で す 。 手 順 を 以 下 に 示 し ま す :
1.
以 下 の よ う に し て 、 ssh を 使 っ て サ ー バ ホ ス ト と の 接 続 を 確 立 し ま す :
ssh -f -x -L 5999:localhost:5999 serverhost sleep 60
普 通 は serverhost を CVSup サ ー バ の ホ ス ト 名 に 置 き 換 え る の で す が 、 こ こ で は ‘localhost’ を 入 力 し ま す 。 こ れ に よ り 、 ポ ー ト 転 送 に 必 要 な 設 定 が で き ま す 。 60 秒 経 っ て sleep が 終 わ る ま で に を 起 動 し な け れ ば な り ま せ ん 。 い っ た ん 更 新 が 始 ま る と 、 ssh は 必 要 な 間 、 転 送 チ ャ ネ ル を オ ー プ ン し た 状 態 を 保 ち ま す 。
2.
ロ ー カ ル ホ ス ト で を 実 行 し ま す 。 コ マ ン ド ラ イ ン に は 以 下 の 行 を 含 め ま す : ‘-h localhost -P m’
フ ァ イ
ル
/usr/local/etc/cvsup
デ フ ォ ル ト の base デ ィ レ ク ト リ 。
sup
デ フ ォ ル ト の collDir サ ブ デ ィ レ ク ト リ 。
base/collDir/collection/checkouts*
リ ス ト フ ァ イ ル 。
base/collDir/refuse
グ ロ ー バ ル の refuse フ ァ イ ル 。
base/collDir/collection/refuse*
コ レ ク シ ョ ン 別 の refuse フ ァ イ ル と 、 リ リ ー ス と タ グ 別 の refuse フ ァ イ ル 。
$ HOME /.cvsup/auth
認 証 用 の パ ス ワ ー ド フ ァ イ ル 。
関 連 項 目
ctm (1), cvpasswd (1), cvs (1), cvsupd (8), m3socks (1), rcsintro (1), ssh (1)
http://www.polstra.com/projects/freeware/CVSup/
作 者
John Polstra <jdp@polstra.com>
バ グ
RCS フ ァ イ ル は ‘,v’ で 終 わ っ て い な け れ ば RCS フ ァ イ ル と 認 識 さ れ ま せ ん 。
‘Attic’ と い う 名 前 の デ ィ レ ク ト リ は CVS Attic と し て 特 別 扱 い さ れ ま す 。
SOCKS ラ イ ブ ラ リ ま た は サ ー バ の バ グ の た め 、 大 部 分 の 形 式 の -P オ プ シ ョ ン は SOCKS で は 使 え ま せ ん 。 多 重 モ ー ド ( -P m ) を 使 え ま す が 、 他 の 形 式 の -P オ プ シ ョ ン は 受 け 付 け ら れ ま せ ん 。
GUI と 一 部 の ウ ィ ン ド ウ マ ネ ー ジ ャ (特 に FVWM)の 相 性 が 良 く あ り ま せ ん 。 FVWM の バ ー ジ ョ ン 1, 2 の ど ち ら で も 問 題 が 起 こ る の で す が 、 バ ー ジ ョ ン 2 の 方 が ま だ ま し の よ う で す 。
Style "cvsup" ClickToFocus
と い う 行 を FVWM2 の .fvwmrc に 追 加 す る と か な り よ く な り ま す 。 こ の 問 題 は ど う や ら ウ ィ ン ド ウ マ ネ ー ジ ャ の バ グ が 原 因 ら し く 、 GUI が ‘WM_TAKE_FOCUS’ プ ロ ト コ ル を 使 う と 起 こ る よ う で す 。 回 避 策 と し て は 、 -g オ プ シ ョ ン を 使 っ て 、 GUI を 完 全 に 無 効 に す る と よ い で し ょ う 。 FreeBSD August 31, 1999 CVSUP (1)