=====Command cp=====

This command is part of the [[CommandsPosix posix]] extensions and needs to be imported to be available to the shell.
See [[CommandsPosix Posix Commands]]

====Name====
**cp** copies files


====Synopsis====
cp [options] file [file ...] target


===Options===

||-f,-force|| Force copy even if target exists or is readonly.||
||-r,-recurse|| recursive copy ||


====Description====

If there are 2 or more source files or the target is a directory then files are copied to the target directory.
If there are exactly 2 arguments and the target does not exist or is not a directory then the source ("file") is copied to the target file.

if -r is specified and any of the source files are directories they are copied recursively to the target.

====Return Value====
Returns 0 if the command executed successfully, 1 if there was an error.
----
[[Commands]]
[[CategoryCommands]]
[[CommandsPosix]]