Net::CLI::Interact::Transport::SSH - SSH based CLI connection
version 2.143070
This module provides a wrapped instance of an SSH client for use by Net::CLI::Interact.
On Windows platforms you must download the plink.exe program, and pass its location to the library in this parameter. On other platforms, this defaults to ssh (openssh).
plink.exe
ssh
Based on the connect_options hash provided to Net::CLI::Interact on construction, selects and formats parameters to provide to app on the command line. Supported attributes:
connect_options
app
Host name or IP address of the host to which the SSH application is to connect. Alternatively you can pass a value of the form user@host, but it's probably better to use the separate username parameter instead.
user@host
username
Optionally pass in the username for the SSH connection, otherwise the SSH client defaults to the current user's username. When using this option, you should obviously only pass the host name to host.
host
Under normal interactive use openssh tracks the identity of connected hosts and verifies these identities upon each connection. In automation this behaviour can be irritating because it is interactive.
openssh
This option, enabled by default, causes openssh to skip or ignore this host identity verification. This means the default setting is less secure, but also less likely to trip you up. It is equivalent to the following:
StrictHostKeyChecking=no UserKnownHostsFile=/dev/null CheckHostIP=no
Pass a false value to this option to disable the above and return openssh to its default configured settings.
If you want to pass any other options to openssh on its command line, then use this option, which should be an array reference. Each item in the list will be passed to openssh, separated by a single space character. For example:
$s->new({ # ...other parameters to new()... connect_options => { opts => [ '-p', '222', # connect to non-standard port on remote host '-o', 'CheckHostIP=no', # don't check host IP in known_hosts file ], }, });
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.
See the following for further interface details:
Net::CLI::Interact::Transport::Base
Oliver Gorwits <oliver@cpan.org>
This software is copyright (c) 2014 by Oliver Gorwits.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Net::CLI::Interact, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Net::CLI::Interact
CPAN shell
perl -MCPAN -e shell install Net::CLI::Interact
For more information on module installation, please visit the detailed CPAN module installation guide.