/bin/rcp/rcp.1
https://bitbucket.org/freebsd/freebsd-head/ · Unknown · 151 lines · 151 code · 0 blank · 0 comment · 0 complexity · 05d01a39add8fd4bc5218cf36eb19d31 MD5 · raw file
- .\"-
- .\" Copyright (c) 1983, 1990, 1993
- .\" The Regents of the University of California. All rights reserved.
- .\"
- .\" Redistribution and use in source and binary forms, with or without
- .\" modification, are permitted provided that the following conditions
- .\" are met:
- .\" 1. Redistributions of source code must retain the above copyright
- .\" notice, this list of conditions and the following disclaimer.
- .\" 2. Redistributions in binary form must reproduce the above copyright
- .\" notice, this list of conditions and the following disclaimer in the
- .\" documentation and/or other materials provided with the distribution.
- .\" 4. Neither the name of the University nor the names of its contributors
- .\" may be used to endorse or promote products derived from this software
- .\" without specific prior written permission.
- .\"
- .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
- .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
- .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
- .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
- .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
- .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
- .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
- .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
- .\" SUCH DAMAGE.
- .\"
- .\" @(#)rcp.1 8.1 (Berkeley) 5/31/93
- .\" $FreeBSD$
- .\"
- .Dd October 16, 2002
- .Dt RCP 1
- .Os
- .Sh NAME
- .Nm rcp
- .Nd remote file copy
- .Sh SYNOPSIS
- .Nm
- .Op Fl 46p
- .Ar file1 file2
- .Nm
- .Op Fl 46pr
- .Ar
- .Ar directory
- .Sh DESCRIPTION
- The
- .Nm
- utility copies files between machines.
- Each
- .Ar file
- or
- .Ar directory
- argument is either a remote file name of the
- form
- .Dq ruser@rhost:path ,
- or a local file name (containing no
- .Ql :\&
- characters,
- or a
- .Ql /
- before any
- .Ql :\& Ns
- s).
- .Pp
- The following options are available:
- .Bl -tag -width indent
- .It Fl 4
- Use IPv4 addresses only.
- .It Fl 6
- Use IPv6 addresses only.
- .It Fl p
- Cause
- .Nm
- to attempt to preserve (duplicate) in its copies the modification
- times and modes of the source files, ignoring the
- .Xr umask 2 .
- By default, the mode and owner of
- .Ar file2
- are preserved if it already existed; otherwise the mode of the source file
- modified by the
- .Xr umask 2
- on the destination host is used.
- .It Fl r
- If any of the source files are directories,
- .Nm
- copies each subtree rooted at that name; in this case
- the destination must be a directory.
- .El
- .Pp
- If
- .Ar path
- is not a full path name, it is interpreted relative to
- the login directory of the specified user
- .Ar ruser
- on
- .Ar rhost ,
- or your current user name if no other remote user name is specified.
- A
- .Ar path
- on a remote host may be quoted (using
- .Ql \e ,
- .Ql \&" ,
- or
- .Ql \(aa )
- so that the metacharacters are interpreted remotely.
- .Pp
- The
- .Nm
- utility does not prompt for passwords; it performs remote execution
- via
- .Xr rsh 1 ,
- and requires the same authorization.
- .Pp
- The
- .Nm
- utility handles third party copies, where neither source nor target files
- are on the current machine.
- .Sh SEE ALSO
- .Xr cp 1 ,
- .Xr ftp 1 ,
- .Xr rlogin 1 ,
- .Xr rsh 1 ,
- .Xr hosts.equiv 5
- .Sh HISTORY
- The
- .Nm
- command appeared in
- .Bx 4.2 .
- The version of
- .Nm
- described here
- has been reimplemented with Kerberos in
- .Bx 4.3 Reno .
- .Sh BUGS
- Does not detect all cases where the target of a copy might
- be a file in cases where only a directory should be legal.
- .Pp
- Is confused by any output generated by commands in a
- .Pa .login ,
- .Pa .profile ,
- or
- .Pa .cshrc
- file on the remote host.
- .Pp
- The destination user and hostname may have to be specified as
- .Dq rhost.ruser
- when the destination machine is running the
- .Bx 4.2
- version of
- .Nm .