|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
User Commands cp(1)
NAME
cp - copy files
SYNOPSIS
/usr/bin/cp [-fip@] source_file target_file
/usr/bin/cp [-fip@] source_file... target
/usr/bin/cp -r | -R [-H | -L | -P] [-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 [-H | -L | -P] [-fip@]
source_dir... target
DESCRIPTION
In the first synopsis form, neither source_file nor
target_file are directory files, nor can they have the same
name. The cp utility copies the contents of source_file to
the destination path named by target_file. If target_file
exists, cp overwrites its contents, but the mode (and ACL if
applicable), owner, and group associated with it are not
changed. The last modification time of target_file and the
last access time of source_file are set to the time the copy
was made. If target_file does not exist, cp creates a new
file named target_file that has the same mode as source_file
except that the sticky bit is not set unless the user is
super-user. In this case, the owner and group of target_file
are those of the user, unless the setgid bit is set on the
directory containing the newly created file. If the
directory's setgid bit is set, the newly created file has
the group of the containing directory rather than of the
creating user. If target_file is a link to another file, cp
overwrites the link destination with the contents of
source_file; the link(s) from target_file remains.
In the second synopsis form, one or more source_files are
copied to the directory specified by target. It is an error
if any source_file is a file of type directory, if target
either does not exist or is not a directory.
In the third synopsis form, one or more directories speci-
fied by source_dir are copied to the directory specified by
target. Either -r or -R must be specified. For each
source_dir, cp copies all files and subdirectories.
OPTIONS
The following options are supported for both /usr/bin/cp and
/usr/xpg4/bin/cp:
SunOS 5.10 Last change: 13 May 2004 1
User Commands cp(1)
-f Unlink. If a file descriptor for a destination file
cannot be obtained, this option attempts to unlink
the destination file and proceed.
-H Takes actions based on the type and contents of the
file referenced by any symbolic link specified as a
source_file operand.
-i Interactive. cp prompts for confirmation whenever
the copy would overwrite an existing target. A y
answer means that the copy should proceed. Any
other answer prevents cp from overwriting target.
-L Takes actions based on the type and contents of the
file referenced by any symbolic link specified as a
source_file operand or any symbolic links encoun-
tered during traversal of a file hierarchy.
-P Takes actions on any symbolic link specified as a
source_file operand or any symbolic link encoun-
tered during traversal of a file hierarchy.
-r Recursive. cp copies the directory and all its
files, including any subdirectories and their files
to target. Unless the -H, -L, or -P option is
specified, the -L option is used as the default
mode.
-R Same as -r, except pipes are replicated, not read
from.
-@ Preserves extended attributes. cp attempts to copy
all of the source file's extended attributes along
with the file data to the destination file.
SunOS 5.10 Last change: 13 May 2004 2
User Commands cp(1)
Specifying more than one of the mutually-exclusive options
-H, -L, and -P is not considered an error. The last option
specified determines the behavior of the utility.
/usr/bin/cp
The following option is supported for /usr/bin/cp only:
-p Preserve. cp duplicates not only the contents of
source_file, but also preserves the owner and group
id, permission modes, modification and access time,
ACLs, and extended attributes, if applicable. The
command can fail if ACLs are copied to a file sys-
tem without appropriate support. The command does
not fail if unable to preserve extended attributes,
modification and access time, or permission modes.
If unable to preserve owner and group id, cp does
not fail, and it clearsS_ISUID and S_ISGID bits in
the target. cp prints a diagnostic message to
stderr and return a non-zero exit status if unable
to clear these bits.
In order to preserve the owner and group id, per-
mission modes, and modification and access times,
users must have the appropriate file access permis-
sions. This includes being superuser or the same
owner id as the destination file.
When both -p and -@ options are specified, the -p
option determines the behavior. However, the com-
mand can fail if unable to preserve extended attri-
butes.
/usr/xpg4/bin/cp
The following option is supported for /usr/xpg4/bin/cp only:
-p Preserve. cp duplicates not only the contents of
source_file, but also preserves the owner and group
id, permission modes, modification and access time,
ACLs, and extended attributes, if applicable. The
command can fail if ACLs are copied to a file sys-
tem without appropriate support. The command does
not fail if unable to preserve extended attributes.
If unable to duplicate the modification and access
time or the permission modes, cp prints a diagnos-
tic message to stderr and return a non-zero exit
status. If unable to preserve owner and group id,
cp does not fail, and it clearsS_ISUID and S_ISGID
bits in the target. cp prints a diagnostic message
to stderr and return a non-zero exit status if
unable to clear these bits.
SunOS 5.10 Last change: 13 May 2004 3
User Commands cp(1)
In order to preserve the owner and group id, per-
mission modes, and modification and access times,
users must have the appropriate file access permis-
sions. This includes being superuser or the same
owner id as the destination file.
When both -p and -@ options are specified, the last
specified -p or -@ option determines the behavior.
OPERANDS
The following operands are supported:
source_file A pathname of a regular file to be copied.
source_dir A pathname of a directory to be copied.
target_file A pathname of an existing or non-existing
file, used for the output when a single file
is copied.
target A pathname of a directory to contain the
copied files.
USAGE
See largefile(5) for the description of the behavior of cp
when encountering files greater than or equal to 2 Gbyte ( 2
**31 bytes).
EXAMPLES
Example 1: Copying a File
The following example copies a file:
example% cp goodies goodies.old
example% ls goodies*
goodies goodies.old
Example 2: Copying a List of Files
The following example copies a list of files to a destina-
tion directory:
SunOS 5.10 Last change: 13 May 2004 4
User Commands cp(1)
example% cp ~/src/* /tmp
Example 3: Copying a Directory
The following example copies a directory, first to a new,
and then to an existing destination directory
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.s
ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment
variables that affect the execution of cp: LANG, LC_ALL,
LC_COLLATE, LC_CTYPE, LC_MESSAGES, and NLSPATH.
EXIT STATUS
The following exit values are returned:
0 All files were copied successfully.
>0 An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
/usr/bin/cp
SunOS 5.10 Last change: 13 May 2004 5
User Commands cp(1)
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWcsu |
|_____________________________|_____________________________|
| CSI | Enabled |
|_____________________________|_____________________________|
| Interface Stability | Stable |
|_____________________________|_____________________________|
/usr/xpg4/bin/cp
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWxcu4 |
|_____________________________|_____________________________|
| CSI | Enabled |
|_____________________________|_____________________________|
| Interface Stability | Standard |
|_____________________________|_____________________________|
SEE ALSO
chmod(1), chown(1), setfacl(1), utime(2), attributes(5),
environ(5), fsattr(5), largefile(5), standards(5)
NOTES
The permission modes of the source file are preserved in the
copy.
A -- permits the user to mark the end of any command line
options explicitly, thus allowing cp to recognize filename
arguments that begin with a -.
SunOS 5.10 Last change: 13 May 2004 6
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:24:31 GMT 2007
|
Your favourite pages:
No pages logged yet.
Trying to save cookie... Top 10 most popular pages:
sqlite3 man page (4766 hits)
(openSUSE 10.2)
adv_cap_autoneg man page (4617 hits)
(Solaris 10 11_06)
CPAN man page (4352 hits)
(Suse Linux 10.1)
ssh man page (4196 hits)
(Suse Linux 10.1)
svn man page (3410 hits)
(FreeBSD 6.2)
startproc man page (1957 hits)
(Suse Linux 10.1)
pprosetup man page (1745 hits)
(Solaris 10 11_06)
netcat man page (1697 hits)
(Suse Linux 10.1)
signal man page (1686 hits)
(Suse Linux 10.1)
ssh-socks5-proxy-connect man page (1661 hits)
(Solaris 10 11_06)
|
Man Pages 
