summaryrefslogtreecommitdiff
path: root/static/plan9-4e/man1/cp.1
diff options
context:
space:
mode:
Diffstat (limited to 'static/plan9-4e/man1/cp.1')
-rw-r--r--static/plan9-4e/man1/cp.192
1 files changed, 92 insertions, 0 deletions
diff --git a/static/plan9-4e/man1/cp.1 b/static/plan9-4e/man1/cp.1
new file mode 100644
index 00000000..dc1d50ce
--- /dev/null
+++ b/static/plan9-4e/man1/cp.1
@@ -0,0 +1,92 @@
+.TH CP 1
+.SH NAME
+cp, mv \- copy, move files
+.SH SYNOPSIS
+.B cp
+[
+.B -gux
+]
+.I file1 file2
+.br
+.B cp
+[
+.B -gux
+]
+.I file ... directory
+.PP
+.B mv
+.I file1 file2
+.br
+.B mv
+.I file ... directory
+.SH DESCRIPTION
+In the first form
+.I file1
+is any name and
+.I file2
+is any name except an existing directory.
+In the second form the commands
+copy or move one or more
+.I files
+into a
+.I directory
+under their original file names, as if by a sequence of
+commands in the first form.
+Thus
+.L "cp f1 f2 dir
+is equivalent to
+.LR "cp f1 dir/f1; cp f2 dir/f2" .
+.PP
+.I Cp
+copies the contents of plain
+.I file1
+to
+.IR file2 .
+The mode and owner of
+.I file2
+are preserved if it already
+exists; the mode of
+.I file1
+is used otherwise.
+The
+.B -x
+option sets the mode and modified time of
+.I file2
+from
+.IR file1 ;
+.B -g
+sets the group id; and
+.B -u
+sets the group id and user id (which is usually only possible if the file server is in an administrative mode).
+.PP
+.I Mv
+moves
+.I file1
+to
+.IR file2 .
+If the files are in the same directory,
+.I file1
+is just renamed;
+otherwise
+.I mv
+behaves like
+.I cp
+.B -x
+followed by
+.B rm
+.IR file1 .
+.I Mv
+will rename directories,
+but it refuses to move a directory into another directory.
+.SH SOURCE
+.B /sys/src/cmd/cp.c
+.br
+.B /sys/src/cmd/mv.c
+.SH "SEE ALSO"
+.IR cat (1),
+.IR stat (2)
+.SH DIAGNOSTICS
+.I Cp
+and
+.I mv
+refuse to copy or move files onto themselves.