This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

Rrcmd()

Execute a command on a remote host (via a SOCKS server)

Synopsis:

int Rrcmd( char ** ahost, 
           int inport, 
           const char * locuser, 
           const char * remuser, 
           const char * cmd, 
           int * fd2p );

Arguments:

ahost

The name of the host that you want to execute the command on. If the function can find the host, it sets *ahost to the standard name of the host.

inport

The well-known Internet port on the host, where the server resides.

locuser

The user ID on the local machine.

remuser

The user ID on the remote machine.

cmd

The command that you want to execute.

fd2p

See rcmd().

Library:

libsocks

Use the -l socks option to qcc to link against this library.

Description:

The Rrcmd() function is a cover function for rcmd() -- the difference is that Rrcmd() does its job via a SOCKS server.

For more information about SOCKS and its libraries, see the appendix, SOCKS -- A Basic Firewall.

Returns:

A valid socket descriptor; or -1 if an error occurs and a message is printed to standard error.

Classification:

SOCKS

See also:

Raccept(), Rbind(), rcmd() Rconnect(), Rgetsockname(), Rlisten(), Rselect(), SOCKSinit()

SOCKS -- A Basic Firewall