Skip to end of metadata
Go to start of metadata

Contents

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