View on
Salvador Fandiño García > Net-OpenSSH-Compat-0.06 > Net::OpenSSH::Compat::Perl



Annotate this POD


Open  0
View/Report Bugs
Module Version: 0.06   Source   Latest Release: Net-OpenSSH-Compat-0.09


Net::OpenSSH::Compat::Perl - Net::OpenSSH adapter for Net::SSH::Perl API compatibility


  use Net::OpenSSH::Compat::Perl qw(:supplant);

  use Net::SSH::Perl;

  my $ssh = Net::SSH::Perl->new('host');
  $ssh->login($user, $passwd);

  my ($out, $err, $rc) = $ssh->cmd($cmd);


This module implements a subset of Net::SSH::Perl API on top of Net::OpenSSH.

After the module is loaded as...

  use Net::OpenSSH::Compat::Perl qw(:supplant);

... it supplants the Net::SSH::Perl module as if it were installed on the machine using Net::OpenSSH under the hood to handle SSH operations.

Setting defaults

The hash %Net::OpenSSH::Compat::Perl::DEFAULTS can be used to set default values for Net::OpenSSH and other modules called under the hood and otherwise not accesible through the Net::SSH::Perl API.

The entries currently supported are:

connection => [ %opts ]

Extra options passed to Net::OpenSSH::new constructor.


  $Net::OpenSSH::Compat::SSH::Perl::DEFAULTS{connection} =
    [ ssh_path => "/opt/SSH/bin/ssh" ];


This is a work in progress.

register_handler method is not supported.

Net::SSH::Perl submodules (i.e. Net::SSH::Perl::Channel) are not emulated.

Anyway, if your Net::SSH::Perl script fails, fill a bug report at the CPAN RT bugtracker ( or just send me an e-mail with the details.

Include at least:

1 - The full source of the script
2 - A description of what happens in your machine
3 - What you thing it should be happening
4 - What happens when you use the real Net::SSH::Perl
5 - The version and name of your operating system
6 - The version of the OpenSSH ssh client installed on your machine (ssh -V)
7 - The Perl version (perl -V)
8 - The versions of the Perl packages Net::OpenSSH, IO::Pty and this Net::OpenSSH::Compat.

Git repository

The source code repository is at

My wishlist

If you like this module and you're feeling generous, take a look at my Amazon Wish List:

Also consider contributing to the OpenSSH project this module builds upon:


Copyright (C) 2011 by Salvador Fandiño (

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.0 or, at your option, any later version of Perl 5 you may have available.

syntax highlighting: