管理解説書

up

目的

送信元ディレクトリーの内容をあて先ディレクトリーに再帰的にコピーします。

構文

up [-v]  [-1]  [-f]  [-r]  [-x]  <source directory>  <destination directory>

このコマンドは、AFS コマンド・セットの構文規則に準拠していません。コマンド名およびすべてのオプション名は省略せずにすべて指定してください。

構文

up コマンドは、指定された送信元ディレクトリーのファイルおよびサブディレクトリーを、指定されたあて先ディレクトリーに繰り返しコピーします。コマンド・インタープリターは、次の方法で、あて先ディレクトリーおよびあて先ディレクトリーのファイルおよびサブディレクトリーを変更します。

• 送信元ディレクトリーのアクセス制御リスト (ACL) をあて先ディレクトリーまたはそのサブディレクトリーにコピーします。このとき、既存の ACL は上書きされます。
• 発行側がローカル・スーパーユーザー root としてログオンし、 system:administrators グループのメンバーとしての AFS トークンを持つ場合は、送信元ディレクトリーの所有者 (ls -ld コマンドで表示される)は、あて先ディレクトリーおよびあて先ディレクトリーのすべてのファイルおよびサブディレクトリーの所有者になります。そうでない場合には、発行側のユーザー名は所有者として記録されます。
• ファイルまたはディレクトリーが、送信元とあて先の両方のディレクトリーに存在する場合、送信元のバージョンであて先のバージョンが上書きされます。上書きオペレーションは、-f フラグが指定されていなければ、最初 (ユーザー) の w (write) モード・ビットが、あて先ディレクトリーのバージョンでオフになると失敗します。
• 送信元ディレクトリーにあるファイルの修正タイム・スタンプ (ls -l コマンドで表示される) は、あて先ディレクトリーにある同名のファイルのタイム・スタンプを上書きしますが、あて先ディレクトリーに存在するサブディレクトリーのタイム・スタンプは変更されません。このコマンドであて先ディレクトリーに新規サブディレクトリーを作成する場合、新規サブディレクトリーのタイム・スタンプには、コピー操作ではなく、送信元ディレクトリーのサブディレクトリーのタイム・スタンプが設定されます。

up コマンドは再現性があります。コマンドの実行中にネットワーク、サーバー・マシン、またはプロセスが停止して中断すると、次にコマンドを発行したときに、中断した地点から処理が再開されます。これにより、類似する機能を持つ UNIX コマンドと比較して、時間を節約することができ、ネットワーク通信量を削減できます。

up コマンドは、成功した場合にのみ 0 (ゼロ) を戻します。そうでない場合は、状況コード 1 を戻します。

オプション

-v

コマンド実行時に、標準出力ストリームに詳細トレースを出力します。

-1

最上位の送信元ディレクトリーのファイルだけをあて先ディレクトリーにコピーします。サブディレクトリーのファイルはコピーされません。送信元ディレクトリーの ACL は、あて先ディレクトリー 1 の ACL を上書きします。 (これは番号の 1 であり、文字の l ではありません。)

-f

最初 (ユーザー) の w (write) モード・ビットが、あて先ディレクトリーのバージョンでオフであっても、既存のディレクトリー、サブディレクトリー、およびファイルを上書きします。

-r

あて先ディレクトリーおよびサブディレクトリーに上書きされたすべてのファイルのバックアップ・コピーを作成し、ファイル名に .old という拡張子を追加します。

-x

各ファイルの修正タイム・スタンプにコピー操作の時間を設定します。

source directory

再帰的コピーをするディレクトリー名を指定します。

destination directory

コピーするディレクトリー名を指定します。既存のものである必要はありません。

例

次のコマンドで、ディレクトリー dir1 の内容をディレクトリー dir2 にコピーします。

   % up dir1 dir2
   

必要となる特権

発行側は、送信元とあて先の両方のディレクトリーの ACL で a (管理) のアクセス権を所有している必要があります。