rcmdsh
- return a stream to a remote command without superuser
SYNOPSIS
#include <unistd.h> int
Fo rcmdsh
Fa char **ahost
Fa int inport
Fa const char *locuser
Fa const char *remuser
Fa const char *cmd
Fa const char *rshprog
Fc
DESCRIPTION
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
Fa rshprog
(if
non- NULL
The
rcmdsh ();
function
looks up the host
Fa *ahost
using
gethostbyname(3),
returning -1 if the host does not exist.
Otherwise
Fa *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
Fa rshprog ) .
The
Fa 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
RETURN VALUES
The
rcmdsh ();
function
returns a valid socket descriptor on success.
Otherwise, -1 is returned
and a diagnostic message is printed on the standard error.
