net-ssh 0.5.0 → 0.6.0

data/doc/manual-html/chapter-1.html

@@ -14,8 +14,8 @@
           </div>
         </td><td valign='middle' align='right'>
           <div class="info">
-            Net::SSH Version: <strong>0.5.0</strong><br />
-            Manual Last Updated: <strong>2004-11-23 20:18 GMT</strong>
+            Net::SSH Version: <strong>0.6.0</strong><br />
+            Manual Last Updated: <strong>2004-12-02 05:13 GMT</strong>
           </div>
         </td></tr>
       </table>

data/doc/manual-html/chapter-2.html

@@ -14,8 +14,8 @@
           </div>
         </td><td valign='middle' align='right'>
           <div class="info">
-            Net::SSH Version: <strong>0.5.0</strong><br />
-            Manual Last Updated: <strong>2004-11-23 20:18 GMT</strong>
+            Net::SSH Version: <strong>0.6.0</strong><br />
+            Manual Last Updated: <strong>2004-12-02 05:13 GMT</strong>
           </div>
         </td></tr>
       </table>
@@ -303,9 +303,11 @@
 
 	<p>The benefit of this is what is known as <em>single sign-on</em>. If any of your keys have a passphrase, this allows you to enter the passphrase <em>once</em> (when the key is loaded by the agent), and then any <span class="caps">SSH</span> program you use will never prompt you for that passphrase again.</p>
 
-	<p>Net::SSH includes support for interfacing with an <span class="caps">SSH</span> agent. Currently, only Unix-ish systems are supported (due to issues with interprocess communication on Windows). Eventually, perhaps an interface will be created to the <a href="http://www.chiark.greenend.org.uk/~sgtatham/putty/" title="pageant">PuTTY agent</a>, but don&#8217;t hold your breath. (It&#8217;s not very easy to interface with.)</p>
+	<p>Net::SSH includes support for interfacing with an <span class="caps">SSH</span> agent. This includes support for the <a href="http://www.chiark.greenend.org.uk/~sgtatham/putty/" title="pageant">PuTTY agent</a> on Windows systems.</p>
 
-	<p>To allow your Net::SSH programs to interface with a running agent, simply make sure that the <code>SSH_AGENT_SOCK</code> environment variable is set to the location of the Unix domain socket that the agent is listening to. Also, make sure you have added all of your keys to the agent (typically by running the <code>ssh-add</code> utility.</p>
+	<p>On Unixish systems, you allow your Net::SSH programs to interface with a running agent by making sure that the <code>SSH_AGENT_SOCK</code> environment variable is set to the location of the Unix domain socket that the agent is listening to. Also, make sure you have added all of your keys to the agent (typically by running the <code>ssh-add</code> utility.</p>
+
+	<p>On Windows, the pageant process will be detected automatically, if it is running.</p>
 
 	<p>A future version of Net::SSH may include it&#8217;s own agent implementation as well, to make using an agent on a variety of platforms simpler.</p>
    </div>

data/doc/manual-html/chapter-3.html

@@ -14,8 +14,8 @@
           </div>
         </td><td valign='middle' align='right'>
           <div class="info">
-            Net::SSH Version: <strong>0.5.0</strong><br />
-            Manual Last Updated: <strong>2004-11-23 20:18 GMT</strong>
+            Net::SSH Version: <strong>0.6.0</strong><br />
+            Manual Last Updated: <strong>2004-12-02 05:13 GMT</strong>
           </div>
         </td></tr>
       </table>

data/doc/manual-html/chapter-4.html

@@ -14,8 +14,8 @@
           </div>
         </td><td valign='middle' align='right'>
           <div class="info">
-            Net::SSH Version: <strong>0.5.0</strong><br />
-            Manual Last Updated: <strong>2004-11-23 20:18 GMT</strong>
+            Net::SSH Version: <strong>0.6.0</strong><br />
+            Manual Last Updated: <strong>2004-12-02 05:13 GMT</strong>
           </div>
         </td></tr>
       </table>

data/doc/manual-html/chapter-5.html

@@ -14,8 +14,8 @@
           </div>
         </td><td valign='middle' align='right'>
           <div class="info">
-            Net::SSH Version: <strong>0.5.0</strong><br />
-            Manual Last Updated: <strong>2004-11-23 20:18 GMT</strong>
+            Net::SSH Version: <strong>0.6.0</strong><br />
+            Manual Last Updated: <strong>2004-12-02 05:13 GMT</strong>
           </div>
         </td></tr>
       </table>

data/doc/manual-html/chapter-6.html

@@ -14,8 +14,8 @@
           </div>
         </td><td valign='middle' align='right'>
           <div class="info">
-            Net::SSH Version: <strong>0.5.0</strong><br />
-            Manual Last Updated: <strong>2004-11-23 20:18 GMT</strong>
+            Net::SSH Version: <strong>0.6.0</strong><br />
+            Manual Last Updated: <strong>2004-12-02 05:13 GMT</strong>
           </div>
         </td></tr>
       </table>

data/doc/manual-html/index.html

@@ -14,8 +14,8 @@
           </div>
         </td><td valign='middle' align='right'>
           <div class="info">
-            Net::SSH Version: <strong>0.5.0</strong><br />
-            Manual Last Updated: <strong>2004-11-23 20:18 GMT</strong>
+            Net::SSH Version: <strong>0.6.0</strong><br />
+            Manual Last Updated: <strong>2004-12-02 05:13 GMT</strong>
           </div>
         </td></tr>
       </table>

data/doc/manual/parts/session_key.txt

@@ -59,8 +59,10 @@ Most SSH clients come with what is called an _agent_. This is a program that is
 
 The benefit of this is what is known as _single sign-on_. If any of your keys have a passphrase, this allows you to enter the passphrase _once_ (when the key is loaded by the agent), and then any SSH program you use will never prompt you for that passphrase again.
 
-Net::SSH includes support for interfacing with an SSH agent. Currently, only Unix-ish systems are supported (due to issues with interprocess communication on Windows). Eventually, perhaps an interface will be created to the "PuTTY agent (pageant)":http://www.chiark.greenend.org.uk/~sgtatham/putty/, but don't hold your breath. (It's not very easy to interface with.)
+Net::SSH includes support for interfacing with an SSH agent. This includes support for the "PuTTY agent (pageant)":http://www.chiark.greenend.org.uk/~sgtatham/putty/ on Windows systems.
 
-To allow your Net::SSH programs to interface with a running agent, simply make sure that the @SSH_AGENT_SOCK@ environment variable is set to the location of the Unix domain socket that the agent is listening to. Also, make sure you have added all of your keys to the agent (typically by running the @ssh-add@ utility.
+On Unixish systems, you allow your Net::SSH programs to interface with a running agent by making sure that the @SSH_AGENT_SOCK@ environment variable is set to the location of the Unix domain socket that the agent is listening to. Also, make sure you have added all of your keys to the agent (typically by running the @ssh-add@ utility.
+
+On Windows, the pageant process will be detected automatically, if it is running.
 
 A future version of Net::SSH may include it's own agent implementation as well, to make using an agent on a variety of platforms simpler.

data/examples/channel-demo.rb

@@ -1,81 +1,81 @@
-#--
-# =============================================================================
-# Copyright (c) 2004, Jamis Buck (jgb3@email.byu.edu)
-# All rights reserved.
-#
-# This source file is distributed as part of the Net::SSH Secure Shell Client
-# library for Ruby. This file (and the library as a whole) may be used only as
-# allowed by either the BSD license, or the Ruby license (or, by association
-# with the Ruby license, the GPL). See the "doc" subdirectory of the Net::SSH
-# distribution for the texts of these licenses.
-# -----------------------------------------------------------------------------
-# net-ssh website : http://net-ssh.rubyforge.org
-# project website: http://rubyforge.org/projects/net-ssh
-# =============================================================================
-#++
-
-$:.unshift "../lib"
-require 'net/ssh'
-
-# This assumes three things:
-#
-# 1) That you have an SSH server running on your local machine,
-# 2) That the USER environment variable is set to your user name, and
-# 3) That you have public and private keys conigured so that you can log into
-#    your machine via SSH without being prompted for a password.
-#
-# If #2 or #3 are not true, you can add your user-name and password as the
-# second and third parameters (respectively) to Net::SSH.start.
-
-Net::SSH.start( 'localhost' ) do |session|
-
-  # Note: two things here,
-  #
-  # 1) open_channel does not immediately invoke the associated block. It only
-  #    calls the block after the server has confirmed that the channel is valid.
-  # 2) channel.exec does not block--it just sends the request to the server and
-  #    returns.
-  #
-  # For these two reasons, you MUST call session.loop, so that packets get
-  # processed and dispatched to the appropriate channel for handling.
-
-  def exec( command )
-    lambda do |channel|
-      channel.exec command
-      channel.on_data do |ch,data|
-        ch[:data] ||= ""
-        ch[:data] << data
-      end
-      channel.on_extended_data do |ch,type,data|
-        ch[:extended_data] ||= []
-        ch[:extended_data][type] ||= ""
-        ch[:extended_data][type] << data
-      end
-    end
-  end
-
-  channels = []
-  channels.push session.open_channel( &exec( "echo $HOME" ) )
-  channels.push session.open_channel( &exec( "ls -la /" ) )
-  channels.push session.open_channel( &exec( "bogus-command" ) )
-
-  # Process packets from the server and route them to the appropriate channel
-  # for handling.
-
-  session.loop
-
-  # Display the results.
-
-  channels.each do |c|
-    puts "----------------------------------"
-    if c.valid?
-      puts c[:data]
-      if c[:extended_data] && c[:extended_data][1]
-        puts "-- stderr: --"
-        puts c[:extended_data][1]
-      end
-    else
-      puts "channel was not opened: #{c.reason} (#{c.reason_code})"
-    end
-  end
-end
+#--
+# =============================================================================
+# Copyright (c) 2004, Jamis Buck (jgb3@email.byu.edu)
+# All rights reserved.
+#
+# This source file is distributed as part of the Net::SSH Secure Shell Client
+# library for Ruby. This file (and the library as a whole) may be used only as
+# allowed by either the BSD license, or the Ruby license (or, by association
+# with the Ruby license, the GPL). See the "doc" subdirectory of the Net::SSH
+# distribution for the texts of these licenses.
+# -----------------------------------------------------------------------------
+# net-ssh website : http://net-ssh.rubyforge.org
+# project website: http://rubyforge.org/projects/net-ssh
+# =============================================================================
+#++
+
+$:.unshift "../lib"
+require 'net/ssh'
+
+# This assumes three things:
+#
+# 1) That you have an SSH server running on your local machine,
+# 2) That the USER environment variable is set to your user name, and
+# 3) That you have public and private keys conigured so that you can log into
+#    your machine via SSH without being prompted for a password.
+#
+# If #2 or #3 are not true, you can add your user-name and password as the
+# second and third parameters (respectively) to Net::SSH.start.
+
+Net::SSH.start( 'localhost' ) do |session|
+
+  # Note: two things here,
+  #
+  # 1) open_channel does not immediately invoke the associated block. It only
+  #    calls the block after the server has confirmed that the channel is valid.
+  # 2) channel.exec does not block--it just sends the request to the server and
+  #    returns.
+  #
+  # For these two reasons, you MUST call session.loop, so that packets get
+  # processed and dispatched to the appropriate channel for handling.
+
+  def exec( command )
+    lambda do |channel|
+      channel.exec command
+      channel.on_data do |ch,data|
+        ch[:data] ||= ""
+        ch[:data] << data
+      end
+      channel.on_extended_data do |ch,type,data|
+        ch[:extended_data] ||= []
+        ch[:extended_data][type] ||= ""
+        ch[:extended_data][type] << data
+      end
+    end
+  end
+
+  channels = []
+  channels.push session.open_channel( &exec( "echo $HOME" ) )
+  channels.push session.open_channel( &exec( "ls -la /" ) )
+  channels.push session.open_channel( &exec( "bogus-command" ) )
+
+  # Process packets from the server and route them to the appropriate channel
+  # for handling.
+
+  session.loop
+
+  # Display the results.
+
+  channels.each do |c|
+    puts "----------------------------------"
+    if c.valid?
+      puts c[:data]
+      if c[:extended_data] && c[:extended_data][1]
+        puts "-- stderr: --"
+        puts c[:extended_data][1]
+      end
+    else
+      puts "channel was not opened: #{c.reason} (#{c.reason_code})"
+    end
+  end
+end

data/lib/net/ssh.rb

@@ -48,5 +48,20 @@ module Net
     end
     module_function :start
 
+    # A registry of external (i.e., third-party) services that should be made
+    # available to any SSH session.
+    EXTERNAL_SERVICES = Hash.new
+
+    # Used by third-parties to register a service that should be made available
+    # to any SSH session when the session is constructed. The block should take
+    # a two parameters--the dependency injection container that should contain
+    # the services, and the service-point for the service being registered.
+    #
+    # The +name+ parameter should be a symbol.
+    def register_service( name, &block )
+      EXTERNAL_SERVICES[ name ] = block
+    end
+    module_function :register_service
+
   end
 end

data/lib/net/ssh/service/services.rb

@@ -14,6 +14,8 @@
 # =============================================================================
 #++
 
+require 'net/ssh'
+
 module Net
   module SSH
     module Service
@@ -36,6 +38,16 @@ module Net
         # Add the services to the services hash.
         container.services[ :forward ] = container.service.forward.driver
         container.services[ :process ] = container.service.process.driver
+
+        # Register the external services and add them to the collection of
+        # known services.
+        EXTERNAL_SERVICES.each do |name, block|
+          container.service.register( name,
+            :model => :singleton_deferred,
+            &block )
+          container.services[ name ] = container.service[ name ]
+        end
+
       end
       module_function :register_services
 

data/lib/net/ssh/session.rb

@@ -94,6 +94,10 @@ module Net
           b.userauth_host_keys { @host_keys }
           b.userauth_method_order { @auth_methods }
 
+          # Register myself with the registry, so that other services may
+          # access me.
+          b.session( :pipeline => [] ) { self }
+
           b.prompter do
             require 'net/ssh/util/prompter'
             Net::SSH::Util::Prompter.new
@@ -169,7 +173,7 @@ module Net
       # and allowing polymorphic argument lists. (See #initialize).
       def process_arguments( *args )
         @options = {}
-        @username = ENV['USER']
+        @username = ENV['USER'] || ENV['USERNAME']
 
         raise ArgumentError,
           "you must specify the host to connect to" if args.length < 1

data/lib/net/ssh/userauth/agent.rb

@@ -30,13 +30,6 @@ module Net
       #
       # This means that although it behaves like a SSH1 client, it also has
       # some SSH2 functionality (like signing data).
-      #
-      # Also, this class relies on there being a UNIXSocket that the active
-      # ssh-agent is listening on. It expects that socket to exist at the
-      # location described by the SSH_AUTH_SOCK environment variable. Because
-      # of the dependency on UNIXSocket, the agent is not available under
-      # Windows, and I have no immediate plans to implement support for
-      # PuTTy's "pageant" utility.
       class Agent
         SSH2_AGENT_REQUEST_VERSION    = 1
         SSH2_AGENT_REQUEST_IDENTITIES = 11

data/lib/net/ssh/userauth/pageant.rb

@@ -0,0 +1,197 @@
+#--
+# =============================================================================
+# Copyright (c) 2004, Guillaume Mar�ais (guillaume.marcais@free.fr),
+#   Jamis Buck (jgb3@email.byu.edu)
+# All rights reserved.
+#
+# This source file is distributed as part of the Net::SSH Secure Shell Client
+# library for Ruby. This file (and the library as a whole) may be used only as
+# allowed by either the BSD license, or the Ruby license (or, by association
+# with the Ruby license, the GPL). See the "doc" subdirectory of the Net::SSH
+# distribution for the texts of these licenses.
+# -----------------------------------------------------------------------------
+# net-ssh website : http://net-ssh.rubyforge.org
+# project website: http://rubyforge.org/projects/net-ssh
+# =============================================================================
+#++
+
+require 'dl/import'
+require 'dl/struct'
+
+require 'net/ssh/errors'
+
+module Net
+  module SSH
+    module UserAuth
+
+      # This module encapsulates the implementation of a socket factory that
+      # uses the PuTTY "pageant" utility to obtain information about SSH
+      # identities.
+      #
+      # This code is a slightly modified version of the original implementation
+      # by Guillaume Mar�ais (guillaume.marcais@free.fr). It is used and
+      # relicensed by permission.
+      module Pageant
+
+        # From Putty pageant.c
+        AGENT_MAX_MSGLEN = 8192
+        AGENT_COPYDATA_ID = 0x804e50ba
+        
+        # The definition of the Windows methods and data structures used in
+        # communicating with the pageant process.
+        module Win
+          extend DL::Importable
+          
+          dlload 'user32'
+          dlload 'kernel32'
+          
+          typealias("LPCTSTR", "char *")         # From winnt.h
+          typealias("LPVOID", "void *")          # From winnt.h
+          typealias("LPCVOID", "const void *")   # From windef.h
+          typealias("LRESULT", "long")           # From windef.h
+          typealias("WPARAM", "unsigned int *")  # From windef.h
+          typealias("LPARAM", "long *")          # From windef.h
+          typealias("PDWORD_PTR", "long *")      # From basetsd.h
+
+          # From winbase.h, winnt.h
+          INVALID_HANDLE_VALUE = -1
+          NULL = nil
+          PAGE_READWRITE = 0x0004
+          FILE_MAP_WRITE = 2
+          WM_COPYDATA = 74
+
+          SMTO_NORMAL = 0   # From winuser.h
+
+          # args: lpClassName, lpWindowName
+          extern 'HWND FindWindow(LPCTSTR, LPCTSTR)'
+
+          # args: none
+          extern 'DWORD GetCurrentThreadId()'
+
+          # args: hFile, (ignored), flProtect, dwMaximumSizeHigh,
+          #           dwMaximumSizeLow, lpName
+          extern 'HANDLE CreateFileMapping(HANDLE, void *, DWORD, DWORD, ' +
+                                          'DWORD, LPCTSTR)'
+
+          # args: hFileMappingObject, dwDesiredAccess, dwFileOffsetHigh, 
+          #           dwfileOffsetLow, dwNumberOfBytesToMap
+          extern 'LPVOID MapViewOfFile(HANDLE, DWORD, DWORD, DWORD, DWORD)'
+
+          # args: lpBaseAddress
+          extern 'BOOL UnmapViewOfFile(LPCVOID)'
+
+          # args: hObject
+          extern 'BOOL CloseHandle(HANDLE)'
+
+          # args: hWnd, Msg, wParam, lParam, fuFlags, uTimeout, lpdwResult
+          extern 'LRESULT SendMessageTimeout(HWND, UINT, WPARAM, LPARAM, ' +
+                                            'UINT, UINT, PDWORD_PTR)'
+        end
+
+        # This is the pseudo-socket implementation that mimics the interface of
+        # a socket, translating each request into a Windows messaging call to
+        # the pageant daemon. This allows pageant support to be implemented
+        # simply by replacing the socket factory used by the Agent class.
+        class Socket
+
+          private_class_method :new
+
+          # The factory method for creating a new Socket instance. The location
+          # parameter is ignored, and is only needed for compatibility with
+          # the general Socket interface.
+          def self.open( location=nil )
+            new
+          end
+
+          # Create a new instance that communicates with the running pageant 
+          # instance. If no such instance is running, this will cause an error.
+          def initialize
+            @win = Win.findWindow( "Pageant", "Pageant" )
+
+            if @win == 0
+              raise Net::SSH::Exception,
+                "pageant process not running"
+            end
+
+            @res = nil
+            @pos = 0
+          end
+          
+          # Forwards the data to #send_query, ignoring any arguments after
+          # the first. Returns 0.
+          def send( data, *args )
+            @res = send_query( data )
+            @pos = 0
+          end
+
+          # Packages the given query string and sends it to the pageant
+          # process via the Windows messaging subsystem. The result is
+          # cached, to be returned piece-wise when #read is called.
+          def send_query( query )
+            res = nil
+            filemap = 0
+            ptr = nil
+            id = DL::PtrData.malloc( DL.sizeof("L") )
+
+            mapname = "PageantRequest%08x\000" % Win.getCurrentThreadId()
+            filemap = Win.createFileMapping(Win::INVALID_HANDLE_VALUE, 
+                                            Win::NULL,
+                                            Win::PAGE_READWRITE, 0, 
+                                            AGENT_MAX_MSGLEN, mapname)
+            if filemap == 0
+              raise Net::SSH::Exception,
+                "Creation of file mapping failed"
+            end
+
+            ptr = Win.mapViewOfFile( filemap, Win::FILE_MAP_WRITE, 0, 0, 
+                                    AGENT_MAX_MSGLEN )
+
+            if ptr.nil? || ptr.null?
+              raise Net::SSH::Exception, "Mapping of file failed"
+            end
+
+            ptr[0] = query
+            
+            cds = [AGENT_COPYDATA_ID, mapname.size + 1, mapname].
+              pack("LLp").to_ptr
+            succ = Win.sendMessageTimeout( @win, Win::WM_COPYDATA, Win::NULL,
+              cds, Win::SMTO_NORMAL, 5000, id )
+
+            if succ > 0
+              retlen = 4 + ptr.to_s(4).unpack("N")[0]
+              res = ptr.to_s(retlen)
+            end        
+
+            return res
+          ensure
+            Win.unmapViewOfFile( ptr ) unless ptr.nil? || ptr.null?
+            Win.closeHandle( filemap ) if filemap != 0
+          end
+
+          # Conceptually close the socket. This doesn't really do anthing
+          # significant, but merely complies with the Socket interface.
+          def close
+            @res = nil
+            @pos = 0
+          end
+
+          # Reads +n+ bytes from the cached result of the last query. If +n+
+          # is +nil+, returns all remaining data from the last query.
+          def read(n = nil)
+            return nil unless @res
+            if n.nil?
+              start, @pos = @pos, @res.size
+              return @res[start..-1]
+            else
+              start, @pos = @pos, @pos + n
+              return @res[start, n]
+            end
+          end
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/net/ssh/userauth/services.rb

@@ -24,8 +24,13 @@ module Net
           b.require 'net/ssh/userauth/methods/services', "#{self}::Methods"
 
           b.agent_socket_factory do
-            require 'socket'
-            defined?( UNIXSocket ) ? UNIXSocket : nil
+            if File::ALT_SEPARATOR
+              require 'net/ssh/userauth/pageant'
+              Pageant::Socket
+            else
+              require 'socket'
+              defined?( UNIXSocket ) ? UNIXSocket : nil
+            end
           end
 
           b.default_agent_socket_name { ENV['SSH_AUTH_SOCK'] }

data/lib/net/ssh/util/openssl.rb

@@ -122,7 +122,7 @@ module OpenSSL
         return verify(OpenSSL::Digest::DSS1.new, a1sig.to_der, data)
       end
 
-      # Sigs the given data.
+      # Signs the given data.
       def ssh_do_sign( data )
         sig = sign( OpenSSL::Digest::DSS1.new, data)
         a1sig = OpenSSL::ASN1.decode( sig )

data/lib/net/ssh/version.rb

@@ -19,7 +19,7 @@ module Net
     module Version
 
       MAJOR = 0
-      MINOR = 5
+      MINOR = 6
       TINY  = 0
 
       STRING = [ MAJOR, MINOR, TINY ].join( "." )

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.8.1
 specification_version: 1
 name: net-ssh
 version: !ruby/object:Gem::Version 
-  version: 0.5.0
-date: 2004-11-23
+  version: 0.6.0
+date: 2004-12-01
 summary: Net::SSH is a pure-Ruby implementation of the SSH2 client protocol.
 require_paths: 
   - lib
@@ -26,7 +26,6 @@ required_ruby_version: !ruby/object:Gem::Version::Requirement
   version: 
 platform: ruby
 files: 
-  - doc/README
   - doc/LICENSE-RUBY
   - doc/manual-html
   - doc/LICENSE-BSD
@@ -150,6 +149,7 @@ files:
   - lib/net/ssh/userauth/agent.rb
   - lib/net/ssh/userauth/driver.rb
   - lib/net/ssh/userauth/userkeys.rb
+  - lib/net/ssh/userauth/pageant.rb
   - lib/net/ssh/userauth/methods
   - lib/net/ssh/userauth/constants.rb
   - lib/net/ssh/userauth/services.rb

data/doc/README

@@ -1,13 +0,0 @@
-= Net::SSH
-
-<b><em>A pure Ruby module that emulates an SSH client.</em></b>
-
-<em>Author: Jamis Buck (jgb3@email.byu.edu)</em>
-
-This is an alpha release of Net::SSH. It absolutely WILL NOT work with the version of Ruby's OpenSSL module currently shipped with Ruby versions < 1.8.2. You must get a patched version of the OpenSSL module and install it (and remove the old module) before using Net::SSH.
-
-The current release of Net::SSH supports:
-
-* the execution of processes on the remote host (interactively, or non-interactively)
-* port forwarding, both from a local port to a remote port, and vice versa
-* HTTP and SOCKS proxy support (and support for creation of additional proxy types)