diff options
| author | aaron <> | 1999-07-05 04:41:00 +0000 |
|---|---|---|
| committer | aaron <> | 1999-07-05 04:41:00 +0000 |
| commit | c47037b066169c61c5eefad3368f2da73ca4be54 (patch) | |
| tree | fa80157fecd0fbb57811f82d8f3ce1366b44a203 /src/lib/libc/net/rcmd.3 | |
| parent | 5f78a44df1a8e524a82445f2fedb382128869a2a (diff) | |
| download | openbsd-c47037b066169c61c5eefad3368f2da73ca4be54.tar.gz openbsd-c47037b066169c61c5eefad3368f2da73ca4be54.tar.bz2 openbsd-c47037b066169c61c5eefad3368f2da73ca4be54.zip | |
repairs; better English, formatting, etc.
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 . |
