cp(1)

名前 | 形式 | 機能説明 | オプション | オペランド | 使用法 | 使用例 | 環境 | 終了ステータス | 属性 | 関連項目 | 注意事項

名前

cp- ファイルのコピー

形式

/usr/bin/cp [-fip] source_file target_file
/usr/bin/cp [-fip] source_file... target
/usr/bin/cp -r -R [-fip] source_dir... target
/usr/xpg4/bin/cp [-fip] source_file target_file
/usr/xpg4/bin/cp [-fip] source_file... target
/usr/xpg4/bin/cp -r -R [-fip] source_dir... target

機能説明

上記「形式」の項で示す第 1 の形式では、 source_file も target_file もディレクトリファイルであってはならず、また両者は同じ名前であってはなりません。 cp ユーティリティは、 source_file が示すファイルの内容を、 target_file が示す宛先パスにコピーします。 target_file がすでに存在していると、 cp はその内容を上書きしますが、 ファイルのモード (さらに ACL が有効な場合は ACL)、所有者、およびグループは変更しません。 target_file の最新更新時刻および source_file の最新アクセス時刻の値は、コピーが行われた時刻に設定されます。 target_file が存在しなければ、 cp は target_file という名のファイルを作成します。 このファイルのモードは source_file と同じになります。 ただしコマンドを発行したユーザーがスーパーユーザーでない限り、 スティッキビットは設定されません。 target_file の所有者とグループは、ユーザーのものが用いられます。 target_file が、リンクを持つ他のファイルへのリンクである場合、 他のリンクはそのまま残り target_file が新たなファイルとなります。

第 2 の形式の cp は、 source_file が示す 1 つ以上のファイルを、 target が示すディレクトリにコピーします。 個々の source_file に対して、同じモード (さらに ACL が有効な場合は同じ ACL ) の新たなファイルが target 中に作成されます。所有者とグループは、このコマンドを 発行したユーザーのものが用いられます。 source_file がディレクトリの場合、 target が存在しない場合、および target がディレクトリでない場合は、いずれもエラーとなります。

第 3 の形式の cp は、 source_dir が示す 1 つ以上のディレクトリを、 target が示すディレクトリにコピーします。 -r または -R のどちらかを指定しなければなりません。個々の source_dir に関して、 cp はその中のすべてのファイルとサブディレクトリをコピーします。

オプション

以下のオプションは、 /usr/bin/cp と /usr/xpg4/bin/cp で指定できます。

-f

リンク解除。宛先ファイルのファイル記述子が得られない場合、 宛先ファイルのリンクを解除して処理を続けようとします。

-i

対話型。宛先ファイルとして指定した target がすでに存在している場合、上書きしてもよいかどうかを問い合わせる 確認メッセージを出力します。そのメッセージに対して y と応答すると、コピー処理が続行されます。 他の文字で応答すると上書きは実行されません。

-r

再帰。 cp はそのディレクトリ全体、つまりディレクトリ内 の全ファイルをコピーするだけでなく、ディレクトリ にあるすべてのサブディレクトリとそのサブディレクトリ 中の全ファイルも target にコピーします。

-R

パイプが読まれるのではなく複写される、という点を 除いて -r と同じです。

/usr/bin/cp

以下のオプションは /usr/bin/cp でのみ指定できます。

-p

保持。 cp は source_file で示したファイルの内容をコピーするだけでなく、出力側ファイルの 所有者とグループの ID、アクセス権モード、更新時刻およびアクセス時刻、さらに ACL が有効な場合は ACL の値として入力側ファイルの値をそのまま設定します。 ACL をサポートしていないファイルシステムに ACL をコピーすると、 このコマンドは、失敗する可能性があります。 このコマンドは、更新時刻およびアクセス時刻、またはアクセス権モードを設定することができない場合には、失敗しません。また、所有者とグループの ID を設定できない場合も、 cp は失敗しないで、出力側ファイルの S_ISUID と S_ISGID ビット をクリアします。 cp は、これらのビットをクリアできない場合には、 標準エラー出力に診断メッセージを表示し、ゼロ以外の終了ステータスを返します。

所有者とグループの ID 、アクセス権モード、更新時刻およびアクセス時刻を保存するためには、 ユーザーが、適切なファイルのアクセス権を持っている必要があります。 つまり、スーパーユーザーであることや、 目的のファイルと同じ所有者 ID であることが必要です。

/usr/xpg4/bin/cp

以下のオプションは /usr/xpg4/bin/cp でのみ指定できます。

-p

保持。 cp は source_file で示したファイルの内容をコピーするだけでなく、出力側ファイルの 所有者とグループの ID 、アクセス権モード、更新時刻およびアクセス時刻、さらに ACL が有効な場合は ACL の値として入力側ファイルの値をそのまま設定します。 ACL をサポートしていないファイルシステムに ACL をコピーすると、 このコマンドは、失敗する可能性があります。 更新時刻とアクセス時刻、またはアクセス権モードを設定できない場合、 cp は 標準エラー出力に診断メッセージを表示し、ゼロ以外の終了ステータスを返します。 所有者とグループの ID を設定できない場合は、 cp は失敗しないで、出力側ファイルの S_ISUID と S_ISGID ビット をクリアします。 cp はこれらのビットがクリアできなければ、 標準エラー出力に診断メッセージを表示し、ゼロ以外の終了ステータスを返します。

所有者とグループの ID 、アクセス権モード、更新時刻およびアクセス時刻を保存するためには、 ユーザーが、適切なファイルのアクセス権を持っている必要があります。 つまり、スーパーユーザーであることや、 目的のファイルと同じ所有者 ID であることが必要です。

オペランド

以下のオペランドを指定できます。

source_file

コピーされる通常ファイルのパス名

source_dir

コピーされるディレクトリのパス名

target_file

1 つのファイルをコピーする際に出力として用いられるファイルのパス名。 既存のファイルでも存在していないファイルでもよい

target

コピーしたファイルを出力するディレクトリのパス名

使用法

ファイルが 2 ギガバイト ( 2³¹ バイト) 以上ある場合の cp の動作については、 largefile(5) を参照してください。

使用例

---

例 1




1 つのファイルをコピーする例です。

example% cp goodies goodies.old example% ls goodies* goodies goodies.old

---

---

例 2




一群のファイルをディレクトリにコピーする例です。

example% cp ‾/src/* /tmp

---

---

例 3




あるディレクトリを、最初に新たなディレクトリへ、 次に既存のディレクトリへコピーする例です。

example% ls ‾/bkup /usr/example/fred/bkup not found example% cp -r ‾/src ‾/bkup example% ls -R ‾/bkup x.c y.c z.sh example% cp -r ‾/src ‾/bkup example% ls -R ‾/bkup src x.c y.c z.sh src: x.c y.c z.sh

---

環境

cp の実行に影響を与える環境変数 LC_COLLATE、 LC_CTYPE、 LC_MESSAGES、 NLSPATH についての詳細は、 environ(5) を参照してください。

終了ステータス

以下の終了ステータスが返されます。

0

ファイルはすべて正常にコピーされた

>0

エラーが発生した

属性

次の属性については attributes(5) のマニュアルページを参照してください。

/usr/bin/cp

属性タイプ	属性値
使用条件	SUNWcsu
CSI	対応済み

/usr/xpg4/bin/cp

属性タイプ	属性値
使用条件	SUNWxcu4
CSI	対応済み

関連項目

chmod(1), chown(1), setfacl(1), utime(2), attributes(5), environ(5), largefile(5), XPG4(5)

注意事項

ソースファイルのアクセス権モードは、 コピー時にそのまま保存されます。

ユーザーはハイフンを 2 つ連続して記述 (--) することにより、 コマンド行オプションの終わりを明確に指定する ことができます。この方法を用いれば、ハイフンで始まるファイル名を filename 引数として指定したとき、それがファイル名であることを cp に伝えることができます。 -- と - の両方がコマンド行上に記述されている場合、 cp は 2 番目のハイフンはファイル名指定であると解釈します。

SunOS 5.7  最終更新日 1998年8月17日

名前 | 形式 | 機能説明 | オプション | オペランド | 使用法 | 使用例 | 環境 | 終了ステータス | 属性 | 関連項目 | 注意事項