Introduction

Provide access to remote hosts using ssh.

Configuration

SectionOptionValueDescription
toolexecpathPath to alternative program to launch on remote host to support the connection/tunnel. Default is /usr/bin/rutuns for tunnel type, /usr/bin/rutunsr for tunnelr type, and /usr/bin/rudial for dial type.
typestringType tool to use: tunnel, tunnelr, or dial (deprecated). Default is dial (which will be change to tunnel in future releases).

Usage

Normal relay (ssh):

Provides access to remote host using ssh.

/[<user>@]<host>[:<port>][<options>]/... <args>
    Connect to service ... at <user>@<host>:<port> using ssh.

    Options:
    ?controlpersist=<seconds>
        Set ControlPersist time in seconds. Default is 1.
    ?controltag=<tag>
        Used to generate a ControlPath. Required to set up control
        master functionality (if available).

Clean relay (sshr):

Provides access to remote host using ssh.

Running as a clean relay.

/[<user>@]<host>[:<port>][<options>]/... <args>
    Connect to service ... at <user>@<host>:<port> using ssh.

    Options:
    ?controlpersist=<seconds>
        Set ControlPersist time in seconds. Default is 1.
    ?controltag=<tag>
        Used to generate a ControlPath. Required to set up control
        master functionality (if available).

Examples

The following requires that your ~/.ssh/config is configured with:

StrictHostKeyChecking no

Note: disabling host key checking reduces security by not failing on mismatched host keys. In a controlled, private network this is rarely a concern.

Execute a local command:

ruexec +/exec/simple /bin/hostname

Execute the same command on a remote machine:

ruexec +/ssh/mach1/+/exec/simple /bin/hostname

Execute through multiple hops:

ruexec +/ssh/mach1/+/ssh/mach2/+/ssh/mach3/+/exec/simple /bin/hostname

Get service help through multiple hops:

ruhelp +/ssh/mach1/+/ssh/mach2/+/exec

Use a symlink to reduce the service path:

ln -s +/ssh/mach1/+/ssh/mach2/+/ssh/mach3 mach3
ruexec mach3/+/exec/simple /bin/hostname

or make it even shorter:

ln -s +/ssh/mach1/+/ssh/mach2/+/ssh/mach3/+/exec/simple m3s
ruexec m3s /bin/hostname