Subversion Repositories planix.SVN

Rev

Rev 2 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 - 1 
.TH CP 1
2 
.SH NAME
3 
cp, fcp, mv  \- copy, move files
4 
.SH SYNOPSIS
5 
.B cp
6 
[
7 
.B -gux
8 
]
9 
.I file1 file2
10 
.br
11 
.B cp
12 
[
13 
.B -gux
14 
]
15 
.I file ... directory
16 
.PP
17 
.B fcp
18 
[
19 
.B -gux
20 
]
21 
.I file1 file2
22 
.br
23 
.B fcp
24 
[
25 
.B -gux
26 
]
27 
.I file ... directory
28 
.PP
29 
.B mv
30 
.I file1 file2
31 
.br
32 
.B mv
33 
.I file ... directory
34 
.SH DESCRIPTION
35 
In the first form
36 
.I file1
37 
is any name and
38 
.I file2
39 
is any name except an existing directory.
40 
In the second form the commands
41 
copy or move one or more
42 
.I files
43 
into a
44 
.I directory
45 
under their original file names, as if by a sequence of
46 
commands in the first form.
47 
Thus
48 
.L "cp f1 f2 dir
49 
is equivalent to
50 
.LR "cp f1 dir/f1; cp f2 dir/f2" .
51 
.PP
52 
.I Cp
53 
copies the contents of plain
54 
.I file1
55 
to
56 
.IR file2 .
57 
The mode and owner of
58 
.I file2
59 
are preserved if it already
60 
exists; the mode of
61 
.I file1
62 
is used otherwise.
63 
The
64 
.B -x
65 
option sets the mode and modified time of
66 
.I file2
67 
from
68 
.IR file1 ;
69 
.B -g
70 
sets the group id; and
71 
.B -u
72 
sets the group id and user id (which is usually only possible if the file server is in an administrative mode).
73 
.PP
74 
.I Fcp
75 
behaves like
76 
.I cp
77 
but transfers multiple blocks in parallel while copying;
78 
it is noticeably faster than
79 
.I cp
80 
when the files involved are stored on servers connected over long-distance lines.
81 
It is only appropriate to use
82 
.I fcp
83 
with file servers that respect the
84 
.I offset
85 
in
86 
.IR read (5)
87 
and
88 
.I write
89 
messages.
90 
This includes the disk-based file systems and ramfs
91 
but excludes most device file systems.
92 
.PP
93 
.I Mv
94 
moves
95 
.I file1
96 
to
97 
.IR file2 .
98 
If the files are in the same directory,
99 
.I file1
100 
is just renamed;
101 
otherwise
102 
.I mv
103 
behaves like
104 
.I cp
105 
.B -x
106 
followed by
107 
.B rm
108 
.IR file1 .
109 
.I Mv
110 
will rename directories,
111 
but it refuses to move a directory into another directory.
112 
.SH SOURCE
113 
.B /sys/src/cmd/cp.c
114 
.br
115 
.B /sys/src/cmd/fcp.c
116 
.br
117 
.B /sys/src/cmd/mv.c
118 
.SH "SEE ALSO"
119 
.IR cat (1),
120 
.I dircp
121 
in
122 
.IR tar (1),
123 
.IR stat (2),
124 
.IR read (5)
125 
.SH DIAGNOSTICS
126 
.IR Cp ,
127 
.IR fcp ,
128 
and
129 
.I mv
130 
refuse to copy or move files onto themselves.