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