cp(1)

名称

cp ― ファイルおよびディレクトリサブツリーのコピー

構文

cp [-f|-i] [-p] [-S] [-e extarg] file1 new_file

cp [-f|-i] [-p] [-S] [-e extarg] file1 [file2 ...] dest_directory

cp [-f|-i] [-p] [-S] [-R|-r] [-e extarg] directory1 [directory2 ...] dest_directory

cp -R|-r [-H|-L|-P ] [-f|-i] [-p] [-S] [-e extarg] file1|directory1 [file2|directory2 ...] dest_directory

説明

cp は次のようなコピーを行います。

file1 を新規または既存のファイル new_file にコピーする。
file1 を既存の dest_directory にコピーする。
file1、 file2、 ... を既存の dest_directory にコピーする。
ディレクトリのサブツリー directory1 を新規または既存のディレクトリ dest_directory にコピーする。
複数のディレクトリサブツリー directory1、 directory2、 ... を新規または既存のディレクトリ dest_directory にコピーする。

file1 と new_file に同じファイルを指定すると、 cp は異常終了します (シェルのメタキャラクタを使用するときは注意してください)。宛先がディレクトリの場合、 1 つ以上のファイルがそのディレクトリにコピーされます。複数のファイルをコピーする場合は、宛先にディレクトリを指定しなければなりません。 1 つのファイルを新規ファイルにコピーするときに、 new_file が既存の場合は、その内容が破壊されます。

宛先ディレクトリ dest_directory 、または既存の宛先ファイル new_file で書き込みが禁止されている場合、 cp は打ち切られ、エラーメッセージ "cannot create file " が出力されます。

1 つ以上のディレクトリサブツリーを別のディレクトリにコピーする場合は、 -r オプションが必要になります。 -r オプションは、あるファイルを別のファイルにコピーする場合、または複数のファイルをディレクトリにコピーする場合には無視されます。

new_file が既存のファイルに対するリンクになっており、その既存ファイルにさらに別のリンクが含まれている場合、 cp により既存ファイルはオーバライトされますが、設定されたリンクはすべてそのまま保持されます。あるファイルを既存のファイルにコピーする場合、 cp により、既存ファイルのアクセスパーミッションビット、オーナー、またはグループが変更されることはありません。

ディレクトリまたはまだ存在していない新規ファイルにファイルをコピーする場合、 cp は file1 と同じファイルパーミッションビットを持つファイルを新たに作成します。その際、 -p オプションが指定されていなければユーザーの作成マスクで修正し、その後 S_IRWXU との論理和を取ります。新規ファイルのオーナーとグループはユーザーのオーナーとグループになります。 new_file の最終修正時刻 (new_file が存在しない場合は最後のアクセス時刻) およびソースファイル file1 の最終アクセス時刻は、コピーの実行時刻にセットされます。

オプション

-i

(対話型のコピー) cp は標準エラー出力にプロンプトを送り、ユーザーによる応答を確認してから、既存ファイルへのオーバライトを行います。標準入力から肯定応答があると、コピー操作が許可されていれば、ファイルがコピーされます。

-f

( 強制コピー ) 宛先ファイルが存在し、ユーザーが書込み許可を持っていない場合、このオプションは、コピー操作で新たに作成されるファイルの名前とディレクトリの存在位置が既存ファイルのものと何らかの矛盾があっても、既存ファイルを壊し、置き換えを行います。

-p

(パーミッションの保持) コピー操作の間に、 cp はパーミッションで許可されている限り、修正時刻、アクセス時刻、ファイルモード、ユーザー ID 、およびグループ ID を保持するようになります。

-r

(サブツリーの再帰的コピー) cp は各ソースディレクトリを出発点とするサブツリーを dest_directory にコピーします。 dest_directory が既存の場合は、この指定がディレクトリでなければなりません。この場合、 cp は dest_directory 中に file1 と同じ名前のディレクトリを作成し、 file1 を出発点とするサブツリーを dest_directory/file1 にコピーします。 dest_directory/file1 が既存の場合、エラーになります。また、 dest_directory が存在していない場合は、 cp によりこれが作成され、 file1 を出発点とするサブツリーが dest_directory にコピーされます。 cp -r では、サブツリーはマージされません。

一般には、通常のファイルおよびディレクトリがコピーされます。キャラクター型特殊デバイス、ブロック型特殊デバイス、ネットワーク特殊ファイル、名前付きパイプ、シンボリックリンク、およびソケットがコピーされるのは、ユーザーにファイルに対するアクセス権がある場合です。それ以外の場合は、ファイルのコピーができないことを示す警告が表示され、そのファイルは抜かされます。

dest_directory が directory1 の中に存在したり、また directory1 が循環ディレクトリ構造になっていたりしてはなりません。いずれの場合も、 cp によりデータが無限にコピーされるからです。

UNIX 標準環境 ( standards(5) 参照 ) では、複数のファイルを存在しないディレクトリにコピーしようとすると、 cp はエラーで終了します。

-R

(サブツリーの再帰的コピー) -R オプションは -r オプションと等価です。

-R および -r オプションを指定すると、 cp は、通常のファイルおよびディレクトリに加えて、 FIFO、キャラクタ型およびブロック型デバイスファイル、およびシンボリックリンクもコピーします。デバイスファイルをコピーできるのはスーパーユーザーだけです。その他のユーザーはエラーを受け取ります。シンボリックリンクについては、ターゲットがソースと同じ位置を指すように、コピーが行われます。

警告: デバイス特殊ファイルのあるディレクトリツリーをコピーするときは、 -r オプションを使用してください。そうでないと、デバイス特殊ファイルからデータが無限に読み取られ、そのデータが宛先ディレクトリ中に特殊ファイルとして重複してコピーされるので、ファイルシステムスペースを大きく占有します。

-H

cp は、オペランドに指定されたシンボリックリンクを追い、宛先にコピーします。

-L

cp は、オペランドに指定されたシンボリックリンクや、ファイル階層を追っている時に見つかったシンボリックリンクを追い、宛先にコピーします。

-P

cp は、オペランドに指定されたシンボリックリンクや、ファイル階層を追っている時に見つかったシンボリックリンクにコピーします。このオプションはシンボリックリンクを追いません。

-e extarg

コピーするファイルのエクステント属性の処理方法を指定します。 extarg には、以下の値のいずれか 1 つを指定します。

`warn`		エクステント属性がコピーできず、ファイルのみコピーした場合に、警告メッセージを発行します。
`ignore`		エクステント属性をコピーしません。
`force`		エクステント属性がコピーできない場合、ファイルのコピーを取り止めます。

エクステント属性がコピーできないのは、エクステント属性をサポートしていないファイルシステムにファイルをコピーしようとした場合、またはファイルシステムのブロックサイズが元のと異なる場合です。 -e が指定されない場合、 extarg のデフォルト値は warn です。

-S

セーフモードを指定します。 O_DSYNC フラグを設定して対象ファイルをオープンし、システム性能への cp の影響を最小限に抑えます。コピーする総サイズ (個々のファイルのサイズではない) が、システムのバッファーキャッシュのサイズの大部分を占めるような場合に 推奨 されます。このオプションを指定すると、コピーの所要時間が長くなります。

１つ以上の相互に排他的なオプション -H, -L, や -P を指定しても、エラーにはなりません。最後に指定されているオプションに従います。

アクセス制御リスト (ACL)

new_file が新規ファイルの場合、または dest_directory 中にファイルを新たに作成する場合は、もとの file1、 file2 などのアクセス制御リストを継承して、両ファイルに見られる所有権の違いを反映するように変更されます ( acl(5) と aclv(5) 参照)。 JFS ファイルシステムでは、 cp で作られる新しいファイルは、親ディレクトリのデフォルト ACL エントリーを受け継ぎません。しかし、代わりにコピーされるファイルの ACL に従います。JFS ファイルシステムから HFS ファイルシステムへコピーする場合、もしくはその逆の場合、オプションの ACL エントリーは失われます。

多言語化対応

UNIX 標準環境については、 standards(5) を参照ください。

環境変数

LC_CTYPE により、テキストをシングルバイト、またはマルチバイトのいずれの文字で解釈するかを決定します。

LANG および LC_CTYPE により、y (肯定応答/否定応答の確認) に対応する母国語を決定します。

LANG により、メッセージの表示に使用する言語を決定します。

環境に LC_CTYPE を指定していない場合、または空の文字列にセットされている場合は、未指定の変数、または空の変数に対するデフォルトとして、 LANG の値が使用されます。また、 LANG を指定していない場合、または空の文字列にセットされている場合は、 LANG の代わりに "C" (lang(5) 参照) がデフォルトとして使用されます。インターナショナル変数に無効な値がセットされていると、 cp はインターナショナル変数がすべて "C" にセットされているものとして動作します。 environ(5) を参照してください。

サポートされるコードセット

シングル/マルチバイトの文字コードセットがサポートされています。

例

以下のコマンドでは、ディレクトリ sourcedir とその内容がファイルシステム中の別の位置 ( targetdir) にコピーされます。 cp は新たにディレクトリが作成するので、宛先ディレクトリ targetdir が既存であってはいけません。

cp -r sourcedir targetdir && rm -rf sourcedir

-r オプションでは、ディレクトリ sourcedir 下にあるサブツリー (ファイルとサブディレクトリ) がディレクトリ targetdir にコピーされます。アンパサンドを 2 つ続ける (&&) ことにより、条件付きで動作を実行させることができます。 && の左辺が正しく実行されれば、右辺が実行されます (古いディレクトリが削除されます)。一方、 && の左辺が異常終了の場合は、古いディレクトリは削除されません。

この例は、次のコマンドと等価になります。

mv sourcedir targetdir

現在のディレクトリにあるファイルとディレクトリサブツリーをすべて、既存ディレクトリ targetdir にコピーする場合は、次のコマンドを使用します。

cp -r * targetdir

sourcedir にあるファイルとディレクトリサブツリーをすべて targetdir にコピーする場合は、次のコマンドを使用します。

cp -r sourcedir/* targetdir

sourcedir と targetdir の前に、ディレクトリのパス名を置くこともできます。

長さゼロのファイルを作成する場合は、次のいずれかを使用します。

cat /dev/null >file
cp /dev/null file
touch file

制約

NFS

ネットワーク上に分散したファイルのアクセス制御リストはまとめられます (stat() によって st_mode の中に戻されます) が新たなファイルとしてコピーされることはありません。この種のファイルに mv または ln 使用すると、ファイルの上書きに関するパーミッションを確認してきた時点で、モード値の後に + 文字はプリントされなくなります。

著者

cp は AT&T、カリフォルニア大学バークレー校、および HP で開発されました。

参照

cpio(1), ln(1), mv(1), rm(1), link(1M), lstat(2), readlink(2), stat(2), symlink(2), symlink(4), acl(5), aclv(5), standards(5)

標準準拠

cp: SVID2, SVID3, XPG2, XPG3, XPG4, POSIX.2

cp(1)

テクニカルドキュメント

≫ 目次

≫ 索引

名称

構文

説明

オプション

アクセス制御リスト (ACL)

多言語化対応

環境変数

サポートされるコードセット

例

制約

NFS

著者

参照

標準準拠

cp(1)

テクニカル ドキュメント

≫ 目次

≫ 索引

名称

構文

説明

オプション

アクセス制御リスト (ACL)

多言語化対応

環境変数

サポートされるコードセット

例

制約

NFS

著者

参照

標準準拠

テクニカルドキュメント