diff options
Diffstat (limited to 'src/lib/libc/net/rcmd.3')
-rw-r--r-- | src/lib/libc/net/rcmd.3 | 38 |
1 files changed, 18 insertions, 20 deletions
diff --git a/src/lib/libc/net/rcmd.3 b/src/lib/libc/net/rcmd.3 index c68a3338a0..d086e875bf 100644 --- a/src/lib/libc/net/rcmd.3 +++ b/src/lib/libc/net/rcmd.3 | |||
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: rcmd.3,v 1.12 1999/05/23 14:11:02 aaron Exp $ | 1 | .\" $OpenBSD: rcmd.3,v 1.13 1999/07/05 04:41:00 aaron Exp $ |
2 | .\" | 2 | .\" |
3 | .\" Copyright (c) 1983, 1991, 1993 | 3 | .\" Copyright (c) 1983, 1991, 1993 |
4 | .\" The Regents of the University of California. All rights reserved. | 4 | .\" The Regents of the University of California. All rights reserved. |
@@ -56,15 +56,15 @@ The | |||
56 | function | 56 | function |
57 | is used by the super-user to execute a command on a remote | 57 | is used by the super-user to execute a command on a remote |
58 | machine using an authentication scheme based on reserved | 58 | machine using an authentication scheme based on reserved |
59 | port numbers. If the calling process is not setuid and the | 59 | port numbers. If the calling process is not setuid, the |
60 | .Li RSH | 60 | .Ev RSH |
61 | environment variable is set and | 61 | environment variable is set, and |
62 | .Fa inport | 62 | .Fa inport |
63 | is | 63 | is |
64 | .Li shell/tcp , | 64 | .Dq shell/tcp , |
65 | .Xr rcmdsh 3 | 65 | .Xr rcmdsh 3 |
66 | is called instead with the value of | 66 | is called instead with the value of |
67 | .Li RSH . | 67 | .Ev RSH . |
68 | Alternately, if the user is not the super-user, | 68 | Alternately, if the user is not the super-user, |
69 | .Fn rcmd | 69 | .Fn rcmd |
70 | will invoke | 70 | will invoke |
@@ -103,17 +103,14 @@ and a connection is established to a server | |||
103 | residing at the well-known Internet port | 103 | residing at the well-known Internet port |
104 | .Fa inport . | 104 | .Fa inport . |
105 | If the user is not the super-user, the only valid port is | 105 | If the user is not the super-user, the only valid port is |
106 | .Li shell/tcp , | 106 | .Dq shell/tcp |
107 | (usually port 514). | 107 | (usually port 514). |
108 | .Pp | 108 | .Pp |
109 | If the connection succeeds, | 109 | If the connection succeeds, |
110 | a socket in the Internet domain of type | 110 | a socket in the Internet domain of type |
111 | .Dv SOCK_STREAM | 111 | .Dv SOCK_STREAM |
112 | is returned to the caller, and given to the remote | 112 | is returned to the caller, and given to the remote |
113 | command as | 113 | command as stdin and stdout. |
114 | .Em stdin | ||
115 | and | ||
116 | .Em stdout . | ||
117 | If | 114 | If |
118 | .Fa fd2p | 115 | .Fa fd2p |
119 | is non-zero, then an auxiliary channel to a control | 116 | is non-zero, then an auxiliary channel to a control |
@@ -128,10 +125,10 @@ signal numbers, to be | |||
128 | forwarded to the process group of the command. | 125 | forwarded to the process group of the command. |
129 | If | 126 | If |
130 | .Fa fd2p | 127 | .Fa fd2p |
131 | is 0, then the | 128 | is 0, then the |
132 | .Em stderr | 129 | .Em stderr |
133 | (unit 2 of the remote | 130 | (unit 2 of the remote |
134 | command) will be made the same as the | 131 | command) will be made the same as the |
135 | .Em stdout | 132 | .Em stdout |
136 | and no | 133 | and no |
137 | provision is made for sending arbitrary signals to the remote process, | 134 | provision is made for sending arbitrary signals to the remote process, |
@@ -147,7 +144,7 @@ The | |||
147 | .Fn rresvport | 144 | .Fn rresvport |
148 | function is used to obtain a socket with a privileged | 145 | function is used to obtain a socket with a privileged |
149 | address bound to it. This socket is suitable for use | 146 | address bound to it. This socket is suitable for use |
150 | by | 147 | by |
151 | .Fn rcmd | 148 | .Fn rcmd |
152 | and several other functions. Privileged Internet ports are those | 149 | and several other functions. Privileged Internet ports are those |
153 | in the range 0 to 1023. Only the super-user | 150 | in the range 0 to 1023. Only the super-user |
@@ -164,7 +161,7 @@ functions take a remote host's IP address or name, respectively, | |||
164 | two user names and a flag indicating whether the local user's | 161 | two user names and a flag indicating whether the local user's |
165 | name is that of the super-user. | 162 | name is that of the super-user. |
166 | Then, if the user is | 163 | Then, if the user is |
167 | .Em NOT | 164 | .Em not |
168 | the super-user, it checks the | 165 | the super-user, it checks the |
169 | .Pa /etc/hosts.equiv | 166 | .Pa /etc/hosts.equiv |
170 | file. | 167 | file. |
@@ -177,9 +174,9 @@ If this file does not exist, is not a regular file, is owned by anyone | |||
177 | other than the user or the super-user, or is writeable by anyone other | 174 | other than the user or the super-user, or is writeable by anyone other |
178 | than the owner, the check automatically fails. | 175 | than the owner, the check automatically fails. |
179 | Zero is returned if the machine name is listed in the | 176 | Zero is returned if the machine name is listed in the |
180 | .Dq Pa hosts.equiv | 177 | .Pa hosts.equiv |
181 | file, or the host and remote user name are found in the | 178 | file, or the host and remote user name are found in the |
182 | .Dq Pa .rhosts | 179 | .Pa .rhosts |
183 | file; otherwise | 180 | file; otherwise |
184 | .Fn iruserok | 181 | .Fn iruserok |
185 | and | 182 | and |
@@ -209,8 +206,9 @@ It returns \-1 on error with the global value | |||
209 | .Va errno | 206 | .Va errno |
210 | set according to the reason for failure. | 207 | set according to the reason for failure. |
211 | The error code | 208 | The error code |
212 | .Dv EAGAIN | 209 | .Er EAGAIN |
213 | is overloaded to mean ``All network ports in use.'' | 210 | is overloaded to mean |
211 | .Dq all network ports in use . | ||
214 | .Sh SEE ALSO | 212 | .Sh SEE ALSO |
215 | .Xr rlogin 1 , | 213 | .Xr rlogin 1 , |
216 | .Xr rsh 1 , | 214 | .Xr rsh 1 , |
@@ -223,5 +221,5 @@ is overloaded to mean ``All network ports in use.'' | |||
223 | .Xr rshd 8 | 221 | .Xr rshd 8 |
224 | .Sh HISTORY | 222 | .Sh HISTORY |
225 | These | 223 | These |
226 | functions appeared in | 224 | functions appeared in |
227 | .Bx 4.2 . | 225 | .Bx 4.2 . |