hcpコマンド設定項目
設定項目一覧#
hcpコマンドの設定項目（クライアントコマンド共通設定項目を除く）は以下の通りです。
通信再開機能
| 説明 | 項目名 |
|---|---|
| 自動再開試行回数 | AutoResumeTrials |
| 自動再開試行間隔（秒） | AutoResumeTrialInterval |
システム動作環境設定
| 説明 | 項目名 |
|---|---|
| 設定ファイルのインクルード | Include |
| cp/rsyncに近いコピー（同期）動作の指定 | UseProperCopyAndSync |
通信再開機能#
AutoResumeTrials#
=========================================================================対応OS : Linux / Windows書式 : AutoResumeTrials <num-trials>-------------------------------------------------------------------------num-trials既定値 : -1値の範囲 : 符号付き整数=========================================================================再開を自動的に試行する回数を設定します。-1を指定すると回数の制限なく再開を試行します。0を指定した場合、再開を行わずに停止します（再開試行回数0回）。
--例：AutoResumeTrials 5--AutoResumeTrialInterval#
=========================================================================対応OS : Linux / Windows書式 : AutoResumeTrialInterval <trial-interval>-------------------------------------------------------------------------trial-interval既定値 : 30値の範囲 : 符号なし整数=========================================================================再開を自動的に試行するまでの待機時間間隔を設定します（秒単位）。
--例：AutoResumeTrialInterval 10--システム動作環境設定#
Include#
=========================================================================対応OS : Linux / Windows書式 : Include <file-path>-------------------------------------------------------------------------file-path既定値 : なし値の範囲 : ファイルシステムのパス文字列=========================================================================クライアントコマンドに共通して指定できる設定を記述したファイルをインクルードします。インクルードは、hcp.confの任意の位置に記述できます。インクルードの記述の前に設定された同じ項目の値は上書きされます。インクルードはネストできません。
--例：Include /etc/hcp/hcp-common.conf--UseProperCopyAndSync#
=========================================================================対応OS : Linux / Windows書式 : UseProperCopyAndSync <flag-available>-------------------------------------------------------------------------flag-available既定値 : no値の範囲 : yes, no=========================================================================コピー動作及び同期動作をそれぞれcpコマンド、rsyncコマンドの動作に合わせるように指示をします。
コピー動作は、主に次の様に動作が変更されます。
- 転送元にディレクトリを指定し、かつ宛先のパスがディレクトリとして存在する場合は、宛先のディレクトリに転送元のディレクトリ名でディレクトリを作成し、その配下にファイルをコピーします
- 転送元にディレクトリを指定し、かつ宛先のパスが存在しない場合は、宛先のパス名でディレクトリを作成し、その配下にファイルをコピーします（転送元のディレクトリ名でディレクトリは作成されません）
- ファイルもしくはディレクトリの上書きでファイル種別が異なる場合（例：転送元はファイル、転送先はディレクトリ）は、理由コード(CANNOT_OVERWRITE_DIR, CANNOT_OVERWRITE_NON_DIR)でエラーになります
- 転送元にディレクトリを指定し、かつ-R（再帰コピー）オプションを指定しない場合は、理由コード(OMIT_DIR)でエラーになります
- 転送元に複数のパスを指定し、かつ宛先のパスがディレクトリでない場合は、理由コード(DEST_IS_NON_DIR)でコマンドの実行を停止します
- 転送元が複数のファイルを含む可能性があり（ディレクトリ、正規表現オプション指定、ワイルドカード）、かつ宛先のパスが存在しディレクトリでない場合は、理由コード(CANNOT_OVERWRITE_NON_DIR)でコマンドの実行を停止します
同期動作は、主に次の様に動作が変更されます。
- 転送元にディレクトリを指定し、かつこのパス指定の末尾がスラッシュ(/)でなければ、宛先パスのディレクトリ（存在しない場合は作成）に転送元のディレクトリ名でディレクトリを作成し、その配下にファイルをコピーします
- 転送元にディレクトリを指定し、かつこのパス指定の末尾がスラッシュ(/)の場合は、宛先パスのディレクトリ（存在しない場合は作成）の配下にファイルをコピーします
- ファイルもしくはディレクトリの上書きでファイル種別が異なる場合（例：転送元はファイル、転送先はディレクトリ）は、転送先のファイルもしくはディレクトリを削除してからコピーを行います
- 転送元にディレクトリを指定し、かつ-R（再帰コピー）オプションを指定しない場合は、理由コード(OMIT_DIR)で処理をスキップし、コマンドの実行結果はエラーとして評価しません（終了ステータスが0で返る）
- 転送元が複数のファイルを含む可能性があり（ディレクトリ、正規表現オプション指定、ワイルドカード）、かつ宛先のパスが存在しディレクトリでない場合は、理由コード(CANNOT_OVERWRITE_NON_DIR)でコマンドの実行を停止します
本オプションのデフォルト値は、バージョン1.3.0からyesに変更される予定です。
--例：UseProperCopyAndSync yes--