12745 man page typos
1 CP(1) User Commands CP(1) 2 3 4 5 NAME 6 cp - copy files 7 8 SYNOPSIS 9 /usr/bin/cp [-afip@/] source_file target_file 10 11 12 /usr/bin/cp [-afip@/] source_file... target 13 14 15 /usr/bin/cp [-r | -R [-H | -L | -P]] [-afip@/] source_dir... target 16 17 18 /usr/bin/cp [-R | -R [-H | -L | -P]] [-afip@/] source_dir... target 19 20 21 /usr/xpg4/bin/cp [-afip@/] source_file target_file 22 23 24 /usr/xpg4/bin/cp [-afip@/] source_file... target 25 26 27 /usr/xpg4/bin/cp [-r | -R [-H | -L | -P]] [-afip@/] source_dir... target 28 29 30 /usr/xpg4/bin/cp [-R | -R [-H | -L | -P]] [-afip@/] source_dir... target 31 32 33 DESCRIPTION 34 In the first synopsis form, neither source_file nor target_file are 35 directory files, nor can they have the same name. The cp utility copies 36 the contents of source_file to the destination path named by 37 target_file. If target_file exists, cp overwrites its contents, but the 38 mode (and ACL if applicable), owner, and group associated with it are 39 not changed. The last modification time of target_file and the last 40 access time of source_file are set to the time the copy was made. If 41 target_file does not exist, cp creates a new file named target_file 42 that has the same mode as source_file except that the sticky bit is not 43 set unless the user is super-user. In this case, the owner and group of 44 target_file are those of the user, unless the setgid bit is set on the 45 directory containing the newly created file. If the directory's setgid 46 bit is set, the newly created file has the group of the containing 47 directory rather than of the creating user. If target_file is a link to 48 another file, cp overwrites the link destination with the contents of 49 source_file; the link(s) from target_file remains. 50 51 52 In the second synopsis form, one or more source_files are copied to the 53 directory specified by target. It is an error if any source_file is a 54 file of type directory, if target either does not exist or is not a 55 directory. 56 57 58 In the third or fourth synopsis forms, one or more directories 59 specified by source_dir are copied to the directory specified by 60 target. Either the -r or -R must be specified. For each source_dir, cp 61 copies all files and subdirectories. 62 63 OPTIONS 64 The following options are supported for both /usr/bin/cp and 65 /usr/xpg4/bin/cp: 66 67 -a 68 Archive mode. Same as -RpP. 69 70 71 -f 72 Unlink. If a file descriptor for a destination file cannot be 73 obtained, this option attempts to unlink the destination file and 74 proceed. 75 76 77 -H 78 Takes actions based on the type and contents of the file 79 referenced by any symbolic link specified as a source_file 80 operand. 81 82 If the source_file operand is a symbolic link, then cp copies the 83 file referenced by the symbolic link for the source_file operand. 84 All other symbolic links encountered during traversal of a file 85 hierarchy are preserved. 86 87 88 -i 89 Interactive. cp prompts for confirmation whenever the copy would 90 overwrite an existing target. An affirmative response means that 91 the copy should proceed. Any other answer prevents cp from 92 overwriting target. 93 94 95 -L 96 Takes actions based on the type and contents of the file 97 referenced by any symbolic link specified as a source_file 98 operand or any symbolic links encountered during traversal of a 99 file hierarchy. 100 101 Copies files referenced by symbolic links. Symbolic links 102 encountered during traversal of a file hierarchy are not 103 preserved. 104 105 106 -p 107 Preserve. The cp utility duplicates not only the contents of 108 source_file, but also attempts to preserve its ACL, access and 109 modification times, extended attributes, extended system 110 attributes, file mode, and owner and group ids. 111 112 If cp is unable to preserve the access and modification times, 113 extended attributes, or the file mode, cp does not consider it a 114 failure. If cp is unable to preserve the owner and group id, the 115 copy does not fail, but cp silently clears the S_ISUID and 116 S_ISGID bits from the file mode of the target. The copy fails if 117 cp is unable to clear these bits. If cp is unable to preserve the 118 ACL or extended system attributes, the copy fails. If the copy 119 fails, then a diagnostic message is written to stderr and (after 120 processing any remaining operands) cp exits with a non-zero exit 121 status. 122 123 124 -P 125 Takes actions on any symbolic link specified as a source_file 126 operand or any symbolic link encountered during traversal of a 127 file hierarchy. 128 129 Copies symbolic links. Symbolic links encountered during 130 traversal of a file hierarchy are preserved. 131 132 133 -r 134 Recursive. cp copies the directory and all its files, including 135 any subdirectories and their files to target. Unless the -H, -L, 136 or -P option is specified, the -L option is used as the default 137 mode. 138 139 140 -R 141 Same as -r, except pipes are replicated, not read from. 142 143 144 -@ 145 Preserves extended attributes. cp attempts to copy all of the 146 source file's extended attributes along with the file data to the 147 destination file. 148 149 150 -/ 151 Preserves extended attributes and extended system attributes. 152 Along with the file's data, the cp utility attempts to copy 153 extended attributes and extended system attributes from each 154 source file, and extended system attributes associated with 155 extended attributes to the destination file. If cp is unable to 156 copy extended attributes or extended system attributes, then a 157 diagnostic message is written to stderr and (after processing any 158 remaining operands) exits with a non-zero exit status. 159 160 161 162 Specifying more than one of the mutually-exclusive options -H, -L, and 163 -P is not considered an error. The last option specified determines the 164 behavior of the utility. 165 166 /usr/bin/cp 167 If the -p option is specified with either the -@ option or the -/ 168 option, /usr/bin/cp behaves as follows 169 170 o When both -p and -@ are specified in any order, the copy 171 fails if extended attributes cannot be copied. 172 173 o When both -p and -/ are specified in any order, the copy 174 fails if extended system attributes cannot be copied. 175 176 /usr/xpg4/bin/cp 177 If the -p option is specified with either the -@ option or the -/ 178 option, /usr/xpg4/bin/cp behaves as follows: 179 180 o When both -p and -@ are specified, the last option specified 181 determines whether the copy fails if extended attributes 182 cannot be preserved. 183 184 o When both -p and -/ are specified, the last option specified 185 determines whether the copy fails if extended system 186 attributes cannot be preserved. 187 188 OPERANDS 189 The following operands are supported: 190 191 source_file 192 A pathname of a regular file to be copied. 193 194 195 source_dir 196 A pathname of a directory to be copied. 197 198 199 target_file 200 A pathname of an existing or non-existing file, used for 201 the output when a single file is copied. 202 203 204 target 205 A pathname of a directory to contain the copied files. 206 207 208 USAGE 209 See largefile(5) for the description of the behavior of cp when 210 encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). 211 212 EXAMPLES 213 Example 1 Copying a File 214 215 216 The following example copies a file: 217 218 219 example% cp goodies goodies.old 220 221 example% ls goodies* 222 goodies goodies.old 223 224 225 226 Example 2 Copying a List of Files 227 228 229 The following example copies a list of files to a destination 230 directory: 231 232 233 example% cp ~/src/* /tmp 234 235 236 237 Example 3 Copying a Directory 238 239 240 The following example copies a directory, first to a new, and then to 241 an existing destination directory 242 243 244 example% ls ~/bkup 245 /usr/example/fred/bkup not found 246 247 example% cp -r ~/src ~/bkup 248 249 example% ls -R ~/bkup 250 x.c y.c z.sh 251 252 example% cp -r ~/src ~/bkup 253 254 example% ls -R ~/bkup 255 src x.c y.c z.sh 256 src: 257 x.c y.c z.s 258 259 260 261 Example 4 Copying Extended File System Attributes 262 263 264 The following example copies extended file system attributes: 265 266 267 $ ls -/ c file1 268 -rw-r--r-- 1 foo staff 0 Oct 29 20:04 file1 269 {AH-----m--} 270 271 $ cp -/ file1 file2 272 $ ls -/c file2 273 -rw-r--r-- 1 foo staff 0 Oct 29 20:17 file2 274 {AH-----m--} 275 276 277 278 Example 5 Failing to Copy Extended System Attributes 279 280 281 The following example fails to copy extended system attributes: 282 283 284 $ ls -/c file1 285 -rw-r--r-- 1 foo staff 0 Oct 29 20:04 file1 286 {AH-----m--} 287 288 $ cp -/ file1 /tmp 289 cp: Failed to copy extended system attributes from file1 to /tmp/file1 290 291 292 $ ls -/c /tmp/file1 293 -rw-r--r-- 1 foo staff 0 Oct 29 20:09 /tmp/file1 294 {} 295 296 297 298 ENVIRONMENT VARIABLES 299 See environ(5) for descriptions of the following environment variables 300 that affect the execution of cp: LANG, LC_ALL, LC_COLLATE, LC_CTYPE, 301 LC_MESSAGES, and NLSPATH. 302 303 304 Affirmative responses are processed using the extended regular 305 expression defined for the yesexpr keyword in the LC_MESSAGES category 306 of the user's locale. The locale specified in the LC_COLLATE category 307 defines the behavior of ranges, equivalence classes, and multi- 308 character collating elements used in the expression defined for 309 yesexpr. The locale specified in LC_CTYPE determines the locale for 310 interpretation of sequences of bytes of text data a characters, the 311 behavior of character classes used in the expression defined for the 312 yesexpr. See locale(5). 313 314 EXIT STATUS 315 The following exit values are returned: 316 317 0 318 All files were copied successfully. 319 320 321 >0 322 An error occurred. 323 324 325 ATTRIBUTES 326 See attributes(5) for descriptions of the following attributes: 327 328 /usr/bin/cp 329 330 331 332 +--------------------+-----------------+ 333 | ATTRIBUTE TYPE | ATTRIBUTE VALUE | 334 +--------------------+-----------------+ 335 |CSI | Enabled | 336 +--------------------+-----------------+ 337 |Interface Stability | Committed | 338 +--------------------+-----------------+ 339 340 /usr/xpg4/bin/cp 341 342 343 344 +--------------------+-----------------+ 345 | ATTRIBUTE TYPE | ATTRIBUTE VALUE | 346 +--------------------+-----------------+ 347 |CSI | Enabled | 348 +--------------------+-----------------+ 349 |Interface Stability | Committed | 350 +--------------------+-----------------+ 351 352 SEE ALSO 353 chmod(1), chown(1), setfacl(1), utime(2), fgetattr(3C), attributes(5), 354 environ(5), fsattr(5), largefile(5), locale(5), standards(5) 355 356 NOTES 357 The permission modes of the source file are preserved in the copy. 358 359 360 A -- permits the user to mark the end of any command line options 361 explicitly, thus allowing cp to recognize filename arguments that begin 362 with a -. 363 364 365 366 April 15, 2013 CP(1) --- EOF ---