app_and_runtime_options¶

Under the hood, this method just wraps Net::OpenSSH "make_remote_command" method.

Supported attributes:

master

Reference to the Net::OpenSSH object wrapping the SSH master connection.

opts

Optional hash of extra options to be forwarded to Net::OpenSSH "make_remote_command" method.

shell_cmd

Remote command to start the shell. Can be a single string or an array reference.

The default is to pass nothing which on conforming SSH implementations starts the shell configured for the user.

Examples:

  # interact with default user shell:
  $s->new({
     # ...other parameters to new()...
     connect_options => { master => $ssh },
  });

  # interact with csh:
  $s->new({
     # ...other parameters to new()...
     connect_options => {
         master => $ssh,
         shell_cmd => ['csh', '-i'],
     },
  });
    

reap

Only used on Unix platforms, this installs a signal handler which attempts to reap the "ssh" child process. Pass a true value to enable this feature only if you notice zombie processes are being left behind after use.