The
rcmdsh()
function
is used by normal users to execute a command on
a remote machine using an authentication scheme based
on reserved port numbers using
rshd(8)
or the value of
rshprog
(if
non-
NULL).
The
rcmdsh()
function
looks up the host
*ahost
using
gethostbyname(3),
returning -1 if the host does not exist.
Otherwise
*ahost
is set to the standard name of the host
and a connection is established to a server
residing at the well-known Internet port
"shell/tcp"
(or whatever port is used by
rshprog).
The
inport
argument
is ignored; it is only included to provide an interface similar to
rcmd(3).
If the connection succeeds,
a socket in the
Unix
domain of type
SOCK_STREAM
is returned to the caller, and given to the remote
command as
stdin, stdout,
and
stderr.
