![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to rsh.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / rsh|
Return to rsh.1 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / rsh |
1.1 root 1: .\" Copyright (c) 1983, 1990 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted provided
5: .\" that: (1) source distributions retain this entire copyright notice and
6: .\" comment, and (2) distributions including binaries display the following
7: .\" acknowledgement: ``This product includes software developed by the
8: .\" University of California, Berkeley and its contributors'' in the
9: .\" documentation or other materials provided with the distribution and in
10: .\" all advertising materials mentioning features or use of this software.
11: .\" Neither the name of the University nor the names of its contributors may
12: .\" be used to endorse or promote products derived from this software without
13: .\" specific prior written permission.
14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
17: .\"
18: .\" @(#)rsh.1 6.8 (Berkeley) 7/24/90
19: .\"
20: .Dd July 24, 1990
21: .Dt RSH 1
22: .Os BSD 4.2
23: .Sh NAME
24: .Nm rsh
25: .Nd remote shell
26: .Sh SYNOPSIS
27: .Ar rsh
28: .Op Fl Kdnx
29: .Op Fl k Ar realm
30: .Op Fl l Ar username
31: .Ar host
32: .Op command
33: .Sh DESCRIPTION
34: .Nm Rsh
35: executes
36: .Ar command
37: on
38: .Ar host .
39: .Pp
40: .Nm Rsh
41: copies its standard input to the remote command, the standard
42: output of the remote command to its standard output, and the
43: standard error of the remote command to its standard error.
44: Interrupt, quit and terminate signals are propagated to the remote
45: command;
46: .Nm rsh
47: normally terminates when the remote command does.
48: The options are as follows:
49: .Tp Fl K
50: The
51: .Fl K
52: option turns off all Kerberos authentication.
53: .Tp Fl d
54: The
55: .Fl d
56: option turns on socket debugging (using
57: .Xr setsockopt 2 )
58: on the TCP sockets used for communication with the remote host.
59: .Tp Fl k
60: The
61: .Fl k
62: option causes
63: .Nm rsh
64: to obtain tickets for the remote host in
65: .Ar realm
66: instead of the remote host's realm as determined by
67: .Xr krb_realmofhost 3 .
68: .Tp Fl l
69: By default, the remote username is the same as the local username.
70: The
71: .Fl l
72: option allows the remote name to be specified.
73: Kerberos authentication is used, and authorization is determined
74: as in
75: .Xr rlogin 1 .
76: .Tp Fl n
77: The
78: .Fl n
79: option redirects input from the special device
80: .Pa /dev/null
81: (see the BUGS section of this manual page).
82: .Tp Fl x
83: The
84: .Fl x
85: option turns on DES encryption for all data exchange.
86: This may introduce a significant delay in response time.
87: .Tp
88: .Pp
89: If no
90: .Ar command
91: is specified, you will be logged in on the remote host using
92: .Xr rlogin 1 .
93: .Pp
94: Shell metacharacters which are not quoted are interpreted on local machine,
95: while quoted metacharacters are interpreted on the remote machine.
96: For example, the command
97: .Pp
98: .Dl rsh otherhost cat remotefile >> localfile
99: .Pp
100: appends the remote file
101: .Ar remotefile
102: to the local file
103: .Ar localfile ,
104: while
105: .Pp
106: .Dl rsh otherhost cat remotefile \&">>\&" other_remotefile
107: .Pp
108: appends
109: .Ar remotefile
110: to
111: .Ar other_remotefile .
112: .\" .Pp
113: .\" Many sites specify a large number of host names as commands in the
114: .\" directory /usr/hosts.
115: .\" If this directory is included in your search path, you can use the
116: .\" shorthand ``host command'' for the longer form ``rsh host command''.
117: .Sh FILES
118: .Dw /etc/hosts
119: .Di L
120: .Dp Pa /etc/hosts
121: .Dp
122: .Sh SEE ALSO
123: .Xr rlogin 1 ,
124: .Xr kerberos 3 ,
125: .Xr krb_sendauth 3 ,
126: .Xr krb_realmofhost 3
127: .Sh HISTORY
128: .Nm Rsh
129: appeared in 4.2 BSD
130: .Sh BUGS
131: If you are using
132: .Xr csh 1
133: and put a
134: .Nm rsh
135: in the background without redirecting its input away from the terminal,
136: it will block even if no reads are posted by the remote command.
137: If no input is desired you should redirect the input of
138: .Nm rsh
139: to
140: .Pa /dev/null
141: using the
142: .Fl n
143: option.
144: .Pp
145: You cannot run an interactive command
146: (like
147: .Xr rogue 6
148: or
149: .Xr vi 1 )
150: using
151: .Nm rsh ;
152: use
153: .Xr rlogin 1
154: instead.
155: .Pp
156: Stop signals stop the local
157: .Nm rsh
158: process only; this is arguably wrong, but currently hard to fix for reasons
159: too complicated to explain here.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.