Import sources from 2011-03-30 iso image - sys/man

1 files changed, 130 insertions, 0 deletions

diff --git a/sys/man/1/cp b/sys/man/1/cp
new file mode 100755
index 000000000..ba84be3a3
--- /dev/null
+++ b/sys/man/1/cp
@@ -0,0 +1,130 @@
+.TH CP 1 
+.SH NAME
+cp, fcp, mv  \- copy, move files
+.SH SYNOPSIS
+.B cp
+[
+.B -gux
+]
+.I file1 file2
+.br
+.B cp
+[
+.B -gux
+]
+.I file ... directory
+.PP
+.B fcp
+[
+.B -gux
+]
+.I file1 file2
+.br
+.B fcp
+[
+.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 Fcp
+behaves like
+.I cp
+but transfers multiple blocks in parallel while copying;
+it is noticeably faster than
+.I cp
+when the files involved are stored on servers connected over long-distance lines.
+It is only appropriate to use
+.I fcp
+with file servers that respect the
+.I offset
+in
+.IR read (5)
+and
+.I write
+messages.
+This includes the disk-based file systems and ramfs
+but excludes most device file systems.
+.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/fcp.c
+.br
+.B /sys/src/cmd/mv.c
+.SH "SEE ALSO"
+.IR cat (1),
+.I dircp
+in
+.IR tar (1),
+.IR stat (2),
+.IR read (5)
+.SH DIAGNOSTICS
+.IR Cp ,
+.IR fcp ,
+and
+.I mv
+refuse to copy or move files onto themselves.