# cp
- [命令功能](#section01)
- [命令格式](#section02)
- [参数说明](#section03)
- [使用指南](#section04)
- [使用实例](#section05)
- [输出说明](#section06)
## 命令功能
拷贝文件，创建一份副本。
## 命令格式
cp \[_SOURCEFILE_\] \[_DESTFILE_\]
## 参数说明
**表 1** 参数说明
参数
|
参数说明
|
取值范围
|
|---|
--help
|
使用帮助。
|
N/A
|
SOURCEFILE
|
源文件路径。
|
目前只支持文件,不支持目录；支持多文件同时拷贝。
|
DESTFILE
|
目的文件路径。
|
支持目录以及文件。
|
## 使用指南
- 同一路径下，源文件与目的文件不能重名。
- 源文件必须存在，且不为目录。
- 源文件路径支持“\*”和“？”通配符，“\*”代表任意多个字符，“？”代表任意单个字符。目的路径不支持通配符。当源路径可匹配多个文件时，目的路径必须为目录。
- 目的路径为目录时，该目录必须存在。此时目的文件以源文件命名。
- 目的路径为文件时，所在目录必须存在。此时拷贝文件的同时为副本重命名。
- 目的文件不存在时创建新文件，已存在则覆盖。
>  **须知：**
>
> 拷贝系统重要资源时，会对系统造成死机等重大未知影响，如用于拷贝/dev/uartdev-1 文件时，会产生系统卡死现象。
## 使用实例
举例：cp hello-OHOS.txt hello-harmony.txt ./tmp/
## 输出说明
**示例** 同时拷贝两个文件至指定目录
```shell
OHOS:/$ ls
bin hello-OHOS.txt proc system vendor
dev hello-harmony.txt sdcard userdata
etc lib storage usr
OHOS:/$ mkdir tmp
OHOS:/$ cp hello-OHOS.txt hello-harmony.txt tmp/
OHOS:/$ ll tmp
total 0
-rwxrwxrwx 1 0 0 0 1979-12-31 00:00 hello-OHOS.txt*
-rwxrwxrwx 1 0 0 0 1979-12-31 00:00 hello-harmony.txt*
```