Apple Xsan 1.0 - Manual (Page 88)

88 Appendix B Using the Command Line
Copying Files or Folders (cvcp)
You can use the cvcp command to perform high-speed file copies to or from an Xsan
volume. You can use this command to:
• Copy files or directories
• Copy tar-formatted data to a directory
• Copy a file or directory to a tar-formatted data stream
$ cvcp [options] source destination
cvcp Command Options
Examples
Copy the file friday to /datasets/data1/july:
$ cvcp friday /datasets/data1/july
Copy directory /data1 and all sub-directories to /datasets/data1, retaining all
permissions and ownerships and displaying files as they are copied:
$ cvcp -vxy data1 /datasets/data1
Parameter Description
options See “cvcp Command Options,” below.
source The file or folder (directory) to be copied.
destination Where the copy is created.
Option Description
-A Turn off pre-allocation.
-b buffers Set the number of I/O buffers to use.
buffers – the number of buffers to use for the copy
-k size Set the copy buffer size.
size – the buffer size (bytes)
-l Copy the targets of symbolic links, not the links.
-n Do not apply command to sub-directories.
-p prefix Only copy files with names that start with the specified prefix.
prefix – characters to match with the beginning of the file name
-s Allocate on storage pool block boundaries.
-t Specify the number of copy threads.
-v Report all information about file copied.
-x Retain original file permissions in the copy.
-y Retain ownership and group information in the copy. Works only if
the root user is performing the copy.
-z Retain original modification times in the copy.
LL0192.book Page 88 Thursday, July 29, 2004 5:20 PM