![[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 / foreign / src / rsh|
Return to rsh.1 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / foreign / src / 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.1.1 (Berkeley) 10/21/90
19: .\"
20: .Dd October 21, 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 Kdn
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
83: .Pp
84: If no
85: .Ar command
86: is specified, you will be logged in on the remote host using
87: .Xr rlogin 1 .
88: .Pp
89: Shell metacharacters which are not quoted are interpreted on local machine,
90: while quoted metacharacters are interpreted on the remote machine.
91: For example, the command
92: .Pp
93: .Dl rsh otherhost cat remotefile >> localfile
94: .Pp
95: appends the remote file
96: .Ar remotefile
97: to the local file
98: .Ar localfile ,
99: while
100: .Pp
101: .Dl rsh otherhost cat remotefile \&">>\&" other_remotefile
102: .Pp
103: appends
104: .Ar remotefile
105: to
106: .Ar other_remotefile .
107: .\" .Pp
108: .\" Many sites specify a large number of host names as commands in the
109: .\" directory /usr/hosts.
110: .\" If this directory is included in your search path, you can use the
111: .\" shorthand ``host command'' for the longer form ``rsh host command''.
112: .Sh FILES
113: .Dw /etc/hosts
114: .Di L
115: .Dp Pa /etc/hosts
116: .Dp
117: .Sh SEE ALSO
118: .Xr rlogin 1 ,
119: .Xr kerberos 3 ,
120: .Xr krb_sendauth 3 ,
121: .Xr krb_realmofhost 3
122: .Sh HISTORY
123: .Nm Rsh
124: appeared in 4.2 BSD
125: .Sh BUGS
126: If you are using
127: .Xr csh 1
128: and put a
129: .Nm rsh
130: in the background without redirecting its input away from the terminal,
131: it will block even if no reads are posted by the remote command.
132: If no input is desired you should redirect the input of
133: .Nm rsh
134: to
135: .Pa /dev/null
136: using the
137: .Fl n
138: option.
139: .Pp
140: You cannot run an interactive command
141: (like
142: .Xr rogue 6
143: or
144: .Xr vi 1 )
145: using
146: .Nm rsh ;
147: use
148: .Xr rlogin 1
149: instead.
150: .Pp
151: Stop signals stop the local
152: .Nm rsh
153: process only; this is arguably wrong, but currently hard to fix for reasons
154: too complicated to explain here.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.