usr/src/old/berknet/netcp.1

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