1 .\" Copyright (c) 1983, 1990, 1993
2 .\" The Regents of the University of California. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
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 .\" 4. Neither the name of the University nor the names of its contributors
13 .\" may be used to endorse or promote products derived from this software
14 .\" without specific prior written permission.
16 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 .\" @(#)rsh.1 8.1 (Berkeley) 6/6/93
44 .Sh DEPRECATION NOTICE
46 is deprecated and will be removed from future versions of the
51 is still required, it can be installed from ports or packages
63 utility copies its standard input to the remote command, the standard
64 output of the remote command to its standard output, and the
65 standard error of the remote command to its standard error.
66 Interrupt, quit and terminate signals are propagated to the remote
69 normally terminates when the remote command does.
70 The options are as follows:
73 Use IPv4 addresses only.
75 Use IPv6 addresses only.
77 Turn on socket debugging (using
81 sockets used for communication with the remote host.
86 By default, the remote username is the same as the local username.
87 Authorization is determined
93 option: do not send the "end of file" (EOF) indication for input stream
94 to the remote host. This option makes the
96 utility compatible with protocol implementations confused by receiving
97 EOF, like some Cisco IOS versions. Disables
100 Redirect input from the special device
104 section of this manual page). Disables
109 to be specified (in seconds).
111 data is sent or received in this time,
118 is specified, you will be logged in on the remote host using
121 Shell metacharacters which are not quoted are interpreted on local machine,
122 while quoted metacharacters are interpreted on the remote machine.
123 For example, the command
125 .Dl rsh otherhost cat remotefile >> localfile
127 appends the remote file
133 .Dl rsh otherhost cat remotefile \&">>\&" other_remotefile
138 .Ar other_remotefile .
140 .\" Many sites specify a large number of host names as commands in the
141 .\" directory /usr/hosts.
142 .\" If this directory is included in your search path, you can use the
143 .\" shorthand ``host command'' for the longer form ``rsh host command''.
145 .Bl -tag -width /etc/hosts -compact
167 in the background without redirecting its input away from the terminal,
168 it will block even if no reads are posted by the remote command.
169 If no input is desired you should redirect the input of
177 You cannot run an interactive command
188 Stop signals stop the local
190 process only; this is arguably wrong, but currently hard to fix for reasons
191 too complicated to explain here.