|
|
1.1 root 1: .TH RSH 1C "17 March 1982"
2: .UC 4
3: .SH NAME
4: rsh \- remote shell
5: .SH SYNOPSIS
6: .B rsh
7: host
8: [
9: .B \-l
10: username
11: ] [
12: .B \-n
13: ] command
14: .br
15: host
16: [
17: .B \-l
18: username
19: ] [
20: .B \-n
21: ] command
22: .SH DESCRIPTION
23: .I Rsh
24: connects to the specified
25: .I host,
26: and executes the specified \fIcommand\fR.
27: .I Rsh
28: copies its standard input to the remote command, the standard
29: output of the remote command to its standard output, and the
30: standard error of the remote command to its standard error.
31: Interrupt, quit and terminate signals are propagated to the remote
32: command; \fIrsh\fP normally terminates when the remote command does.
33: .PP
34: The remote username used is the same as your local username,
35: unless you specify a different remote name with the
36: .B \-l
37: option.
38: This remote name must be
39: .I equivalent
40: (in the sense of
41: .IR rlogin (1C))
42: to the originating account; no provision
43: is made for specifying a password with a command.
44: .PP
45: If you omit
46: .I command,
47: then instead of executing a single command, you will be logged in
48: on the remote host using
49: .IR rlogin (1C).
50: .PP
51: Shell metacharacters which are not quoted are interpreted
52: on local machine, while quoted metacharacters are interpreted on
53: the remote machine.
54: Thus the command
55: .PP
56: \ \ \ rsh otherhost cat remotefile >> localfile
57: .PP
58: appends the remote file
59: .I remotefile
60: to the localfile
61: .I localfile,
62: while
63: .PP
64: \ \ \ rsh otherhost cat remotefile ">>" otherremotefile
65: .PP
66: appends
67: .I remotefile
68: to
69: .I otherremotefile.
70: For another example, the command
71: .PP
72: \ \ \ cat localfile | rsh otherhost lpr
73: .PP
74: prints the file
75: .I localfile
76: at the line printer of the remote host
77: .I otherhost.
78: .PP
79: Host names are given in the file
80: .I /etc/hosts.
81: Each host
82: has one standard name (the first name given in the file), which
83: is rather long and unambiguous, and optionally one or more nicknames.
84: The host names for local machines are also commands in the directory
85: .I /usr/hosts;
86: if you put this directory in your search path then the
87: .B rsh
88: can be omitted from the command line. That is, the command in the
89: previous example can be given as
90: .PP
91: \ \ \ cat localfile | otherhost lpr
92: .PP
93: .SH FILES
94: .ta 2i
95: /etc/hosts
96: .br
97: /usr/hosts/*
98: .DT
99: .SH SEE ALSO
100: rlogin(1C)
101:
102: rshd(8C) on how a system validates a remote user.
103:
104: .SH BUGS
105: If you are using
106: .IR csh (1)
107: and put a
108: .IR rsh (1C)
109: in the background without redirecting its input
110: away from the terminal, it will block even if no reads
111: are posted by the remote command. If no input is desired
112: you should redirect the input of
113: .I rsh
114: to /dev/null using the
115: .B \-n
116: option.
117: .PP
118: You cannot run an interactive command
119: (like
120: .IR rogue (6)
121: or
122: .IR vi (1));
123: use
124: .IR rlogin (1C).
125: .PP
126: Stop signals stop the local \fIrsh\fP process only; this is arguably
127: wrong, but currently hard to fix for reasons too complicated to
128: explain here.
129: See also
130: .I .rlogin.1c
131: for the bugs on parsing the equivalence list in
132: .I /etc/hosts.equiv
133: or
134: .I .rhosts
135: in the user's home directory.
136: .PP
137: Users might be confused by any output generated by commands in a
138: \&.login, \&.profile, or \&.cshrc file on the remote host. Particularly,
139: commands setting terminal attributes in the shell startup files
140: of remote accounts might fail
141: since the remote shell is not associated with terminals.
142: .PP
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.