CP

Section: ユーザーコマンド (1)
Updated: 2025/09
Index JM Home Page roff page
 

名前

cp - ファイルやディレクトリのコピーを行う  

書式

cp [,OPTION/]... [,-T/] ,SOURCE DEST/
cp [,OPTION/]... ,SOURCE/... ,DIRECTORY/
cp [,OPTION/]... ,-t DIRECTORY SOURCE/...  

説明

SOURCE から DEST へのコピー、または複数の SOURCE の DIRECTORY へのコピーを行います。

長いオプションで必須となっている引数は短いオプションでも必須です。

-a, --archive
 -dR --preserve=,all/ と同じです。
--attributes-only
ファイルのデータをコピーせず、ファイルの属性のみコピーします。
--backup[=,CONTROL/]
コピー先ファイルが存在する時にバックアップを作成します。
-b

 --backup と同じですが引数を受けとりません。
--copy-contents
再帰時に特殊ファイルの内容をコピーします。
-d

 --no-dereference --preserve=,links/ と同じです。
--debug
どのファイルがコピーされているかを表示します。-v を仮定します。
-f, --force
コピー先にファイルが存在し、開けない場合、削除してから再度試みます。 (-n オプションも指定した場合はこのオプションは無視されます)
-i, --interactive
上書きする前に確認します。 (前に指定した -n オプションを上書きします)
-H
SOURCE にあるコマンド行のシンボリックリンクをたどります。
-l, --link
コピーの代わりにファイルのハードリンクを作成します。
-L, --dereference
SOURCE にあるシンボリックリンクを常にたどります。
-n, --no-clobber
(非推奨)単に存在するファイルをスキップします。 --update を参照してください。
-P, --no-dereference
SOURCE にあるシンボリックリンクを決してたどりません。
-p
--preserve=,mode/,ownership,timestamps と同じです。
--preserve[=,ATTR_LIST/]
指定した属性を保持します。
--no-preserve=,ATTR_LIST/
指定した属性を保持しません。
--parents
DIRECTORY 配下で SOURCE ファイルのフルパス名を使用します。
-R, -r, --recursive
再帰的にディレクトリをコピーします。
--reflink[=,WHEN/]
clone/CoW コピーを制御します。下記を参照。
--remove-destination
コピー先にファイルが存在する場合、開く前に削除します。 (--force と反対の動作になります)
--sparse=,WHEN/
スパースファイル作成を制御します。下記を参照。
--strip-trailing-slashes
各 SOURCE 引数から末尾のスラッシュを全て削除します。
-s, --symbolic-link
コピーの代わりにシンボリックリンクを作成します。
-S, --suffix=,SUFFIX/
通常のバックアップ接尾辞を上書きします。
-t, --target-directory=,DIRECTORY/
全ての SOURCE 引数を DIRECTORY にコピーします。
-T, --no-target-directory
DEST を通常ファイルとして扱います。
--update[=,UPDATE/]
既存のファイルをアップデートするかを制御します。 UPDATE={all,none,none-fail,older(デフォルト)}
-u, --update
--update[=,older/] と同じです。下記を参照。
-v, --verbose
何を実行しているかを表示します。
--keep-directory-symlink
存在するシンボリックリンクをディレクトリまでたどります。
-x, --one-file-system
このファイルシステムだけで実行します。
-Z
コピー先ファイルの SELinux セキュリティコンテキストを デフォルトタイプに設定します。
--context[=,CTX/]
-Z と同じですが、 CTX が指定された場合は、 SELinux や SMACK のセキュリティコンテキストを CTX に設定します。
--help
使い方を表示して終了します。
--version
バージョン情報を表示して終了します。

ATTR_LISTは、属性をコンマで区切ったリストです。属性は、アクセス権 (ACL および xattr アクセス権を含む)の 'mode'、ユーザーおよび グループの'ownership'、ファイルのタイムスタンプの 'timestamps'、 ハードリンクの 'links'、セキュリティコンテキストの 'context'、 拡張属性の 'xattr'、およびすべての属性の 'all' です。

デフォルトでは、SOURCE スパースファイルは発見的手法で検出され、対応する DEST ファイルはスパースファイルとして作成されます。これは --sparse=,auto/ が選択されたときの動作です。 --sparse=always を指定した場合、SOURCE ファイルに、十分な長さの値が 0 のバイトが含まれている場合には DEST がスパースファイルとして作成されます。 スパースファイルの作成を禁止する場合は --sparse=,never/ を使用してください。

UPDATEは、置換先の既存のファイルを制御します。 --update オプションが指定されていない場合、'all' がデフォルトの操作となり、 置換先の既存のファイルがすべて置換されます。 'none' は --no-clobber オプションと同様、置換先のファイルを置換せず、 ファイルをスキップしても失敗しません。 'none-fail' はまた、コピー先でファイルが置換されないようにしますが、 スキップされたファイルは診断され、失敗が発生します。 --update が指定されている場合、'older' が既定の操作となり、 ファイルが対応するソースファイルより古い場合は置換されます。

デフォルトか、--reflink=,auto/ が指定された場合、 cp はデータブロックが変更された場合にのみコピーされ軽量コピーの実行を試みますが、 それが不可能な場合、通常のコピーに切り換えます。 --reflink[=,always/] が指定された場合では、 CoW がサポートされていない場合に cp が失敗しますが、 --reflink=,never/ が指定された場合、通常のコピーが必ず実行されます。

--suffix も環境変数 SIMPLE_BACKUP_SUFFIX も設定されていない場合、 バックアップ接尾辞は '~' になります。 バージョン管理方法は --backup オプションや VERSION_CONTROL 環境変数で 選択できます。以下の値を指定できます:

none, off
バックアップを作成しません。 (--backup を付けた時でも)
numbered, t
番号付きバックアップを作成します。
existing, nil
番号付きバックアップがあれば番号付き、 そうでなければ、simple で作成します。
simple, never
常に簡易バックアップを作成します。

特別な場合として、cp は force と backup オプションが与えられ、SOURCE と DEST が 同一ファイルである時は、SOURCE のバックアップを作成します。  

作者

作者 Torbjorn Granlund、 David MacKenzie、および Jim Meyering。  

バグのレポートについて

バグのレポートは bug-coreutils@gnu.org までお寄せ下さい。
GNU coreutils のホームページ: <https://www.gnu.org/software/coreutils/>
一般的な GNU ソフトウェア使用に関するヘルプは <https://www.gnu.org/gethelp/> です。
翻訳に関するバグは <https://translationproject.org/team/ja.html> に連絡してください。  

著作権

Copyright © 2025 Free Software Foundation, Inc. ライセンス GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.  

関連項目


完全なマニュアルは <https://www.gnu.org/software/coreutils/cp> か、
ローカルで有効になっていれば info '(coreutils) cp invocation' です。  

日本語訳

対応バージョン:9.8 翻訳日:2025-11-10 翻訳者:ribbon


 

Index

名前
書式
説明
作者
バグのレポートについて
著作権
関連項目
日本語訳

This document was created by man2html, using the manual pages.