date and time created 88/12/12 20:32:14 by kfall
[unix-history] / usr / src / old / berknet / netcp.1
CommitLineData
29eb4d49
KM
1.\" Copyright (c) 1980 Regents of the University of California.
2.\" All rights reserved. The Berkeley software License Agreement
3.\" specifies the terms and conditions for redistribution.
4.\"
cfc0904e 5.\" @(#)netcp.1 6.1 (Berkeley) %G%
29eb4d49 6.\"
cfc0904e 7.TH NETCP 1 "%G%"
29eb4d49
KM
8.UC 4
9.ds s 1
10.ds o 1
11.SH NAME
12netcp \- remote copy of files through the net
13.SH SYNOPSIS
14.B netcp
15[
16.B \-l
17login ] [
18.B \-p
19password ]
20[
21.B \-f
22] [
23.B \-n
24] [
25.B \-q
26] fromfile tofile
27.SH DESCRIPTION
28.I Netcp
29copies files between machines and is similar to
30.IR cp (\*o).
31At least one of
32.I fromfile
33and
34.I tofile
35must be remote.
36The
37.B \-l,
38.B \-p,
39.B \-f,
40.B \-q,
41and
42.B \-n
43behave exactly as in
44.IR net (\*s).
45.PP
46.I Fromfile
47and
48.I tofile
49follow these conventions:
50.TP 4
511.
52A simple filename is assumed to be local and from the current directory.
53.TP 4
542.
55A filename preceded by a machine designator (see below)
56is a reference to a file on the specified remote machine.
57If a full pathname is not given, it is assumed to be from the login directory.
58.PP
59Examples:
60.IP " grades.p" 20
61file in the current directory on local machine
62.IP " C:junk" 20
63file in your login directory on C
64.IP " /usr/lib/pq" 20
65file on local machine
66.IP " C:comp/c2.c" 20
67file in a subdirectory on C machine
68.PP
69When files are being ``fetched'', that is, the
70.I fromfile
71is remote and the
72.I tofile
73is local, the
74.I tofile
75is created zero-length mode 600.
76For security reasons, when the ``fetched'' file's contents
77arrive at the local machine, the file must still be zero-length
78and mode 0600.
79No confirmation is sent to the user that the file has been ``fetched'';
80a non-zero file length indicates completion.
81.PP
82.I Netcp
83executes the
84.IR net (\*s)
85command.
86.SH "SEE ALSO"
87net(\*s), netrm(\*s), netq(\*s), netlog(\*s),
88netlpr(\*s), netmail(\*s), netlogin(\*s), cp(\*o), mail(\*o)
89.SH AUTHOR
90Eric Schmidt
91.SH BUGS
92The second filename may not be defaulted to a directory name as in
93.IR cp (\*o),
94it must be given explicitly.
95.br
96The file mode may or may not be set correctly.