bin/rcp/rcp.1

   1 .\" Copyright (c) 1983, 1990, 1993
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. All advertising materials mentioning features or use of this software
  13 .\"    must display the following acknowledgement:
  14 .\"     This product includes software developed by the University of
  15 .\"     California, Berkeley and its contributors.
  16 .\" 4. Neither the name of the University nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\"     @(#)rcp.1       8.1 (Berkeley) 5/31/93
  33 .\" $FreeBSD$
  34 .\"
  35 .Dd May 31, 1993
  36 .Dt RCP 1
  37 .Os BSD 4.3r
  38 .Sh NAME
  39 .Nm rcp
  40 .Nd remote file copy
  41 .Sh SYNOPSIS
  42 .Nm rcp
  43 .Op Fl Kpx
  44 .Op Fl k Ar realm
  45 .Ar file1 file2
  46 .Nm rcp
  47 .Op Fl Kprx
  48 .Op Fl k Ar realm
  49 .Ar file ...
  50 .Ar directory
  51 .Sh DESCRIPTION
  52 .Nm Rcp
  53 copies files between machines.  Each
  54 .Ar file
  55 or
  56 .Ar directory
  57 argument is either a remote file name of the
  58 form
  59 .Dq rname@rhost:path ,
  60 or a local file name (containing no `:' characters,
  61 or a `/' before any `:'s).
  62 .Pp
  63 The following options are available:
  64 .Bl -tag -width indent
  65 .It Fl K
  66 Turn off all Kerberos authentication.
  67 .It Fl k
  68 Request
  69 .Nm
  70 to obtain tickets
  71 for the remote host in realm
  72 .Ar realm
  73 instead of the remote host's realm as determined by
  74 .Xr krb_realmofhost 3 .
  75 .It Fl p
  76 Cause
  77 .Nm
  78 to attempt to preserve (duplicate) in its copies the modification
  79 times and modes of the source files, ignoring the
  80 .Ar umask  .
  81 By default, the mode and owner of
  82 .Ar file2
  83 are preserved if it already existed; otherwise the mode of the source file
  84 modified by the
  85 .Xr umask  2
  86 on the destination host is used.
  87 .It Fl r
  88 If any of the source files are directories,
  89 .Nm
  90 copies each subtree rooted at that name; in this case
  91 the destination must be a directory.
  92 .It Fl x
  93 Turn on
  94 .Tn DES
  95 encryption for all data passed by
  96 .Nm Ns .
  97 This may impact response time and
  98 .Tn CPU
  99 utilization, but provides
 100 increased security.
 101 .El
 102 .Pp
 103 If
 104 .Ar path
 105 is not a full path name, it is interpreted relative to
 106 the login directory of the specified user
 107 .Ar ruser
 108 on
 109 .Ar rhost  ,
 110 or your current user name if no other remote user name is specified.
 111 A
 112 .Ar path
 113 on a remote host may be quoted (using \e, ", or \(aa)
 114 so that the metacharacters are interpreted remotely.
 115 .Pp
 116 .Nm Rcp
 117 does not prompt for passwords; it performs remote execution
 118 via
 119 .Xr rsh  1  ,
 120 and requires the same authorization.
 121 .Pp
 122 .Nm Rcp
 123 handles third party copies, where neither source nor target files
 124 are on the current machine.
 125 .Sh FILES
 126 .Bl -tag -width /etc/auth.conf -compact
 127 .It Pa /etc/auth.conf
 128 configure authentication services
 129 .El
 130 .Sh SEE ALSO
 131 .Xr cp 1 ,
 132 .Xr ftp 1 ,
 133 .Xr rlogin 1 ,
 134 .Xr rsh 1 ,
 135 .Xr auth.conf 5 ,
 136 .Xr hosts.equiv 5 .
 137 .Sh HISTORY
 138 The
 139 .Nm
 140 command appeared in
 141 .Bx 4.2 .
 142 The version of
 143 .Nm
 144 described here
 145 has been reimplemented with Kerberos in
 146 .Bx 4.3 Reno .
 147 .Sh BUGS
 148 Doesn't detect all cases where the target of a copy might
 149 be a file in cases where only a directory should be legal.
 150 .Pp
 151 Is confused by any output generated by commands in a
 152 .Pa \&.login ,
 153 .Pa \&.profile ,
 154 or
 155 .Pa \&.cshrc
 156 file on the remote host.
 157 .Pp
 158 The destination user and hostname may have to be specified as
 159 .Dq rhost.rname
 160 when the destination machine is running the
 161 .Bx 4.2
 162 version of
 163 .Nm Ns  .