Rrcmd()

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

Synopsis:

#include <unistd.h>

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

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	No
Thread	No