net::sftp::foreign::compat(3pm) [debian man page]

Net::SFTP::Foreign::Compat(3pm) 			User Contributed Perl Documentation			   Net::SFTP::Foreign::Compat(3pm)

NAME

       Net::SFTP::Foreign::Compat - Adaptor for Net::SFTP compatibility

SYNOPSIS

	   use Net::SFTP::Foreign::Compat;
	   my $sftp = Net::SFTP::Foreign::Compat->new($host);
	   $sftp->get("foo", "bar");
	   $sftp->put("bar", "baz");

	   use Net::SFTP::Foreign::Compat ':supplant';
	   my $sftp = Net::SFTP->new($host);

DESCRIPTION

       This package is a wrapper around Net::SFTP::Foreign that provides an API (mostly) compatible with that of Net::SFTP.

       Methods on this package are identical to those in Net::SFTP except that Net::SFTP::Foreign::Attributes::Compat objects have to be used
       instead of Net::SFTP::Attributes.

       If the ":supplant" tag is used, this module installs also wrappers on the "Net::SFTP" and Net::SFTP::Attributes packages so no other parts
       of the program have to modified in order to move from Net::SFTP to Net::SFTP::Foreign.

   Setting defaults
       The hash %Net::SFTP::Foreign::DEFAULTS can be used to set default values for Net::SFTP::Foreign methods called under the hood and otherwise
       not accesible through the Net::SFTP API.

       The entries currently supported are:

       new => @opts
	   extra options passed to Net::SFTP::Foreign constructor.

       get => @opts
	   extra options passed to Net::SFTP::Foreign::get method.

       put => @opts
	   extra options passed to Net::SFTP::Foreign::put method.

       ls  => @opts
	   extra options passed to Net::SFTP::Foreign::ls method.

COPYRIGHT

       Copyright (c) 2006-2008, 2011 Salvador Fandin~o

       All rights reserved.  This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.14.2							    2012-05-04					   Net::SFTP::Foreign::Compat(3pm)

Net::OpenSSH::Compat::Perl(3pm) 			User Contributed Perl Documentation			   Net::OpenSSH::Compat::Perl(3pm)

NAME

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

SYNOPSIS

	 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);

DESCRIPTION

       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.

	   Example:

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

BUGS AND SUPPORT

       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
       (https://rt.cpan.org/Ticket/Create.html?Queue=Net-OpenSSH-Compat <https://rt.cpan.org/Ticket/Create.html?Queue=Net-OpenSSH-Compat>) 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 https://github.com/salva/p5-Net-OpenSSH-Compat <https://github.com/salva/p5-Net-OpenSSH-Compat>.

   My wishlist
       If you like this module and you're feeling generous, take a look at my Amazon Wish List: <http://amzn.com/w/1WU1P6IR5QZ42>

       Also consider contributing to the OpenSSH project this module builds upon: <http://www.openssh.org/donations.html>.

COPYRIGHT AND LICENSE

       Copyright (C) 2011 by Salvador Fandin~o (sfandino@yahoo.com)

       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.

perl v5.14.2							    2012-02-24					   Net::OpenSSH::Compat::Perl(3pm)