net-ssh 0.9.0 → 1.0.0

data/doc/manual/manual.rb

@@ -13,7 +13,7 @@ require 'yaml'
 require 'redcloth'
 require 'syntax/convertors/html'
 
-module Needle
+module Net ; module SSH
   module Manual
 
     class Manual
@@ -250,7 +250,7 @@ if __FILE__ == $0
   FileUtils.mkdir_p File.join( output_path, "stylesheets" )
 
   log_action "Loading manual.yml..."
-  manual = Needle::Manual::Manual.load( 'manual.yml' )
+  manual = Net::SSH::Manual::Manual.load( 'manual.yml' )
 
   # force these to be defined at the TOPLEVEL_BINDING
   object = nil

data/doc/manual/parts/intro_what_is.txt

@@ -1,7 +1,5 @@
 Net::SSH is a pure-Ruby implementation of the SSH2 client protocol. It supports the following features:
 
 * User authentication via explicit username/password, or using a public-key/private-key pair.
-
 * Port forwarding, both from the local host to a remote computer via the remote host, and from the remote host to the local host.
-
 * Execute processes on the remote machine, both interactively and non-interactively ("batch").

data/lib/net/ssh/connection/channel.rb

@@ -48,6 +48,12 @@ module Net
         # The maximum data window size for this channel
         attr_reader :window_size
 
+        # The maximum packet size that may be sent over this channel
+        attr_reader :local_maximum_packet_size
+
+        # The maximum data window size for this channel
+        attr_reader :local_window_size
+
         #--
         # ====================================================================
         # FACTORY METHODS
@@ -66,7 +72,8 @@ module Net
           msg.write_byte CHANNEL_OPEN
           msg.write_string type
           msg.write_long channel.local_id
-          msg.write_long 0x7FFFFFFF, 0x7FFFFFFF
+          msg.write_long channel.local_window_size
+          msg.write_long channel.local_maximum_packet_size
           msg.write data.to_s if data
 
           connection.send_message msg
@@ -101,6 +108,8 @@ module Net
           @buffers = buffers
           @type = type
           @local_id = @connection.allocate_channel_id
+          @local_window_size = 0x20000
+          @local_maximum_packet_size = 0x10000
         end
 
         #--
@@ -255,6 +264,17 @@ module Net
           self
         end
 
+        # Send a "window adjust" message to the server for this channel,
+        # informing it that it may send this many more bytes over the
+        # channel.
+        def send_window_adjust( size )
+          msg = @buffers.writer
+          msg.write_byte CHANNEL_WINDOW_ADJUST
+          msg.write_long @remote_id
+          msg.write_long size
+          @connection.send_message msg
+        end
+
         # Send a data packet to the server, over the channel.
         def send_data( data )
           @connection.register_data_request( self, data )
@@ -422,11 +442,17 @@ module Net
 
         # Invoked when the server sends a data packet. This in turn calls the
         # "on_data" callback.
-        event :data, :data
+        def do_data( data )
+          update_local_window_size data
+          callback :data, self, data
+        end
 
         # Invoked when the server sends an extended data packet. This in turn
         # calls the "on_extended_data" callback.
-        event :extended_data, :type, :data
+        def do_extended_data( type, data )
+          update_local_window_size data
+          callback :extended_data, self, type, data
+        end
 
         # Invoked when the server sends an EOF packet. This in turn calls the
         # "on_eof" callback.
@@ -450,6 +476,19 @@ module Net
         # ====================================================================
         #++
 
+        # Updates the window size for this channel based on the size of the
+        # data that was receieved. If no more space in the window is left,
+        # a message is sent to the server indicating that the window size
+        # is increased.
+        def update_local_window_size( data )
+          @local_window_size -= data.length
+          if @local_window_size < 4096
+            @local_window_size += 0x20000
+            send_window_adjust 0x20000
+          end
+        end
+        private :update_local_window_size
+
         # A convenience utility method for invoking a named callback with a
         # set of arguments.
         def callback( which, *args )

data/lib/net/ssh/service/forward/driver.rb

@@ -248,7 +248,7 @@ module Net
             forward = @local_forwards[ key ]
             @local_forwards.delete key
 
-            forward[ :socket ].shutdown
+            forward[ :socket ].close
             forward[ :thread ].terminate
 
             true

data/lib/net/ssh/service/forward/local-network-handler.rb

@@ -50,20 +50,17 @@ module Net
           # Called to process the channel in a loop. It will repeatedly read
           # from the client and send the results across the channel.
           def process( channel )
-            begin
-              loop do
-                break if channel[:eof]
-                data = @client.recv( @block_size )
-                break if data.nil? || data.length < 1
-                channel.send_data data
-              end
-
-              channel.close
-            rescue StandardError, Exception => e
-              @log.error "error processing connection: " +
-                "#{e.class} (#{e.message})\n  " +
-                e.backtrace.join("\n  ")
+            loop do
+              break if channel[:eof]
+              data = @client.recv(@block_size) or break
+              channel.send_data data unless data.empty?
             end
+
+            channel.close
+          rescue StandardError, Exception => e
+            @log.error "error processing connection: " +
+              "#{e.class} (#{e.message})\n  " +
+              e.backtrace.join("\n  ")
           end
 
         end

data/lib/net/ssh/service/forward/remote-network-handler.rb

@@ -44,9 +44,11 @@ module Net
               begin
                 loop do
                   break if channel[:eof]
-                  data = @client.recv( @block_size )
-                  break if data.nil? or data.length < 1
-                  channel.send_data data
+                  data = ""
+                  while IO.select([@client],nil,nil,0.01)
+                    data << @client.recv(@block_size)
+                  end
+                  channel.send_data data unless data.empty?
                 end
               rescue Exception => e
                 @log.error "error while forwarding remote port: " +

data/lib/net/ssh/transport/packet-stream.rb

@@ -149,13 +149,8 @@ module Net
             if @log.debug?
               @log.debug "reading #{@cipher.block_size} bytes from socket..."
             end
-            data = @socket.recv( @cipher.block_size )
 
-            # if the data is empty, then the socket was closed
-            if data.length < 1
-              raise Net::SSH::Transport::Disconnect,
-                "connection closed by remote host"
-            end
+            data = read( @cipher.block_size )
 
             # decipher it
             reader = @buffers.reader( @cipher.update( data ) )
@@ -169,11 +164,7 @@ module Net
             end
 
             # read the remainder of the packet and decrypt it.
-            data = ""
-            loop do
-              data << @socket.recv( remaining_to_read - data.length )
-              break if data.length >= remaining_to_read
-            end
+            data = read( remaining_to_read )
 
             reader.append @cipher.update( data )
             reader.append @cipher.final
@@ -203,6 +194,29 @@ module Net
           end
         end
 
+        def read( length )
+          if IO === @socket
+            data = ""
+            while data.length < length
+              break if @socket.closed?
+              if ( IO.select([@socket],nil,nil,0.01) rescue nil )
+                data << @socket.sysread(length-data.length)
+              end
+            end
+          else
+            data = @socket.recv(length)
+          end
+
+          # if the data is less than expected, the socket was closed
+          if data.nil? || data.length < length
+            raise Net::SSH::Transport::Disconnect,
+              "connection closed by remote host"
+          end
+
+          data
+        end
+        private :read
+
       end
 
     end

data/lib/net/ssh/transport/session.rb

@@ -103,7 +103,15 @@ module Net
             @hostname =
               Socket.getnameinfo( sockaddr, Socket::NI_NAMEREQD ).first
           rescue
-            @hostname = Socket.getnameinfo( sockaddr ).first
+            begin
+              @hostname = Socket.getnameinfo( sockaddr ).first
+            rescue
+              begin
+                @hostname = Socket.gethostbyname( Socket.gethostname ).first
+              rescue
+                @logger.error "the client ipaddr/name could not be determined"
+              end
+            end
           end
 
           return @hostname
@@ -124,7 +132,7 @@ module Net
         # Closes the connection.
         def close
           # TODO: send a DISCONNECT message to the server to close gracefully
-          @socket.shutdown
+          @socket.close
         end
 
         def get_kex_byte_requirement

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

@@ -47,6 +47,7 @@ module Net
           @methods = methods
           @on_banner = proc { |msg,lang| puts msg }
           @order = order.dup
+          @allowed_auth_methods = nil
         end
 
         # Causes the set of on-disk key files to be used to be set to the
@@ -104,6 +105,7 @@ module Net
 
               when USERAUTH_FAILURE
                 authentications = buffer.read_string
+                @allowed_auth_methods = authentications.split(/,/)
                 partial_success = buffer.read_bool
                 return OpenStruct.new( :message_type    => type,
                                        :authentications => authentications,
@@ -151,6 +153,11 @@ module Net
                    :key_manager => @key_manager }
 
           @order.each do |auth_method|
+            # if the server has reported a list of auth methods that are
+            # allowed to continue, only consider those auth methods.
+            next if @allowed_auth_methods &&
+              !@allowed_auth_methods.include?( auth_method )
+
             @log.debug "trying #{auth_method.inspect}" if @log.debug?
 
             impl = @methods[ auth_method.downcase.gsub(/-/,"_").intern ]

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

@@ -44,16 +44,21 @@ module Net
 
             b.keyboard_interactive_callback do |c,p|
               proc do |req|
-                responses = []
-                puts req.name unless req.name.empty?
-                puts req.instruction unless req.instruction.empty?
-                req.prompts.each do |prompt|
-                  response = prompt.echo ?
-                    gets.chomp :
-                    c[:keyboard_interactive_prompter].password( prompt.prompt )
-                  responses << response
+                if req.password
+                  [ req.password ] * req.prompts.length
+                else
+                  responses = []
+                  puts req.name unless req.name.empty?
+                  puts req.instruction unless req.instruction.empty?
+                  req.prompts.each do |prompt|
+                    response = prompt.echo ?
+                      gets.chomp :
+                      c[:keyboard_interactive_prompter].
+                        password( prompt.prompt )
+                    responses << response
+                  end
+                  responses
                 end
-                responses
               end
             end
 

data/lib/net/ssh/version.rb

@@ -18,8 +18,8 @@ module Net
   module SSH
     module Version
 
-      MAJOR = 0
-      MINOR = 9
+      MAJOR = 1
+      MINOR = 0
       TINY  = 0
 
       STRING = [ MAJOR, MINOR, TINY ].join( "." )

data/test/connection/tc_channel.rb

@@ -65,7 +65,7 @@ class TC_Channel < Test::Unit::TestCase
     channel = Net::SSH::Connection::Channel.open( @connection, Log.new,
       Buffers.new, "test" )
     assert_equal [ :allocate_channel_id,
-      "\132\0\0\0\4test\0\0\4\xd2\x7f\xff\xff\xff\x7f\xff\xff\xff" ],
+      "\132\0\0\0\4test\0\0\4\xd2\x00\x02\x00\x00\x00\x01\x00\x00" ],
       @connection.events
     assert_equal "test", channel.type
   end
@@ -74,7 +74,7 @@ class TC_Channel < Test::Unit::TestCase
     channel = Net::SSH::Connection::Channel.open( @connection, Log.new,
       Buffers.new, "test", "some data" )
     assert_equal [ :allocate_channel_id,
-      "\132\0\0\0\4test\0\0\4\xd2\x7f\xff\xff\xff\x7f\xff\xff\xffsome data" ],
+      "\132\0\0\0\4test\0\0\4\xd2\x00\x02\x00\x00\x00\x01\x00\x00some data" ],
       @connection.events
     assert_equal "test", channel.type
   end

data/test/proxy/tc_http.rb

@@ -56,7 +56,7 @@ class TC_Proxy_HTTP < Test::Unit::TestCase
     end
 
     def shutdown
-      @socket.shutdown
+      @socket.close
     end
   end
 

data/test/proxy/tc_socks4.rb

@@ -57,7 +57,7 @@ class TC_Proxy_SOCKS4 < Test::Unit::TestCase
     end
 
     def shutdown
-      @socket.shutdown
+      @socket.close
     end
   end
 

data/test/proxy/tc_socks5.rb

@@ -81,7 +81,7 @@ class TC_Proxy_SOCKS5 < Test::Unit::TestCase
     end
 
     def shutdown
-      @socket.shutdown
+      @socket.close
     end
   end
 

data/test/service/forward/tc_remote_network_handler.rb

@@ -70,8 +70,11 @@ class TC_RemoteNetworkHandler < Test::Unit::TestCase
       @thread = Thread.new {
         server = TCPServer.new( HOST, PORT )
         client = server.accept
-        client.send @script.shift, 0 until @script.empty?
-        server.shutdown
+        until @script.empty?
+          client.send @script.shift, 0
+          sleep 0.1
+        end
+        server.shutdown rescue nil
       }
     end
 

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.8.4
 specification_version: 1
 name: net-ssh
 version: !ruby/object:Gem::Version 
-  version: 0.9.0
-date: 2005-01-11
+  version: 1.0.0
+date: 2005-02-06
 summary: Net::SSH is a pure-Ruby implementation of the SSH2 client protocol.
 require_paths: 
   - lib
@@ -28,21 +28,9 @@ authors:
   - Jamis Buck
 files: 
   - doc/LICENSE-RUBY
-  - doc/manual-html
   - doc/LICENSE-BSD
   - doc/LICENSE-GPL
   - doc/manual
-  - doc/manual-html/stylesheets
-  - doc/manual-html/chapter-1.html
-  - doc/manual-html/chapter-2.html
-  - doc/manual-html/chapter-3.html
-  - doc/manual-html/chapter-4.html
-  - doc/manual-html/chapter-5.html
-  - doc/manual-html/chapter-6.html
-  - doc/manual-html/chapter-7.html
-  - doc/manual-html/index.html
-  - doc/manual-html/stylesheets/manual.css
-  - doc/manual-html/stylesheets/ruby.css
   - doc/manual/manual.yml
   - doc/manual/stylesheets
   - doc/manual/tutorial.erb

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

@@ -1,368 +0,0 @@
-<html>
-  <head>
-    <title>Net::SSH Manual :: Chapter 1: Introduction</title>
-    <link type="text/css" rel="stylesheet" href="stylesheets/manual.css" />
-  </head>
-  
-  <body>
-    <div id="banner">
-      <table border='0' cellpadding='0' cellspacing='0' width='100%'>
-        <tr><td valign='top' align='left'>
-          <div class="title">
-            <span class="product">Net::SSH&mdash;</span><br />
-            <span class="tagline">Secure Shell for Ruby</span>
-          </div>
-        </td><td valign='middle' align='right'>
-          <div class="info">
-            Net::SSH Version: <strong>0.9.0</strong><br />
-            Manual Last Updated: <strong>2005-01-11 21:39 GMT</strong>
-          </div>
-        </td></tr>
-      </table>
-    </div>
-
-    <table border='0' width='100%' cellpadding='0' cellspacing='0'>
-      <tr><td valign='top'>
-
-        <div id="navigation">
-          <h1>Net::SSH Manual</h1>
-
-          <h2>Chapters</h2>
-          <ol type="I">
-          
-            <li><strong>
-                <a href="chapter-1.html">
-                Introduction
-                </a>
-                </strong> <big>&larr;</big>
-              <ol type="1">
-                
-                  <li><a href="chapter-1.html#s1">What is Net::SSH?</a></li>
-                
-                  <li><a href="chapter-1.html#s2">What isn&#8217;t Net::SSH?</a></li>
-                
-                  <li><a href="chapter-1.html#s3">Getting Net::SSH</a></li>
-                
-                  <li><a href="chapter-1.html#s4">License Information</a></li>
-                
-                  <li><a href="chapter-1.html#s5">Support</a></li>
-                
-                  <li><a href="chapter-1.html#s6">About the Author</a></li>
-                
-              </ol>
-            </li>
-          
-            <li>
-                <a href="chapter-2.html">
-                Starting a Session
-                </a>
-                
-              <ol type="1">
-                
-                  <li><a href="chapter-2.html#s1">Using Net::SSH.start</a></li>
-                
-                  <li><a href="chapter-2.html#s2">Using a Public/Private Key</a></li>
-                
-                  <li><a href="chapter-2.html#s3">Options</a></li>
-                
-                  <li><a href="chapter-2.html#s4">Using Net::SSH::Session</a></li>
-                
-              </ol>
-            </li>
-          
-            <li>
-                <a href="chapter-3.html">
-                Channels
-                </a>
-                
-              <ol type="1">
-                
-                  <li><a href="chapter-3.html#s1">What are Channels?</a></li>
-                
-                  <li><a href="chapter-3.html#s2">Session.loop</a></li>
-                
-                  <li><a href="chapter-3.html#s3">Channel Types</a></li>
-                
-                  <li><a href="chapter-3.html#s4">Opening a Channel</a></li>
-                
-                  <li><a href="chapter-3.html#s5">Callbacks</a></li>
-                
-                  <li><a href="chapter-3.html#s6">Channel Operations</a></li>
-                
-              </ol>
-            </li>
-          
-            <li>
-                <a href="chapter-4.html">
-                Executing Commands
-                </a>
-                
-              <ol type="1">
-                
-                  <li><a href="chapter-4.html#s1">Using Channels</a></li>
-                
-                  <li><a href="chapter-4.html#s2">Using #process.open</a></li>
-                
-                  <li><a href="chapter-4.html#s3">Using #process.popen3</a></li>
-                
-              </ol>
-            </li>
-          
-            <li>
-                <a href="chapter-5.html">
-                User Shells
-                </a>
-                
-              <ol type="1">
-                
-                  <li><a href="chapter-5.html#s1">Introduction</a></li>
-                
-                  <li><a href="chapter-5.html#s2">Using Channels</a></li>
-                
-                  <li><a href="chapter-5.html#s3">Shell Service</a></li>
-                
-                  <li><a href="chapter-5.html#s4">SyncShell Service</a></li>
-                
-                  <li><a href="chapter-5.html#s5">Terminal Clients</a></li>
-                
-              </ol>
-            </li>
-          
-            <li>
-                <a href="chapter-6.html">
-                Port Forwarding
-                </a>
-                
-              <ol type="1">
-                
-                  <li><a href="chapter-6.html#s1">Introduction</a></li>
-                
-                  <li><a href="chapter-6.html#s2">Local-to-Remote</a></li>
-                
-                  <li><a href="chapter-6.html#s3">Remote-to-Local</a></li>
-                
-                  <li><a href="chapter-6.html#s4">Direct Channels</a></li>
-                
-                  <li><a href="chapter-6.html#s5">Remote-to-Local Handlers</a></li>
-                
-              </ol>
-            </li>
-          
-            <li>
-                <a href="chapter-7.html">
-                Using Proxies
-                </a>
-                
-              <ol type="1">
-                
-                  <li><a href="chapter-7.html#s1">Introduction</a></li>
-                
-                  <li><a href="chapter-7.html#s2"><span class="caps">HTTP</span></a></li>
-                
-                  <li><a href="chapter-7.html#s3"><span class="caps">SOCKS</span></a></li>
-                
-              </ol>
-            </li>
-          
-          </ol>
-
-          <h2>Other Documentation</h2>
-
-          <ul>
-            <li><a href="http://net-ssh.rubyforge.org/api/index.html">Net::SSH API</a></li>
-            <li><a href="http://rubyforge.org/tracker/?atid=1842&group_id=274&func=browse">Net::SSH FAQ</a></li>
-          </ul>
-
-          <h2>Tutorials</h2>
-          <ol>
-          
-          </ol>
-
-          <p align="center"><strong>More To Come...</strong></p>
-
-          <div class="license">
-            <a href="http://creativecommons.org/licenses/by-sa/2.0/"><img alt="Creative Commons License" border="0" src="http://creativecommons.org/images/public/somerights" /></a><br />
-            This manual is licensed under a <a href="http://creativecommons.org/licenses/by-sa/2.0/">Creative Commons License</a>.
-          </div>
-        </div>
-
-      </td><td valign='top' width="100%">
-
-        <div id="content">
-
-           <div class="top"><div class="prevnext">
-  
-  <a href="index.html">Up</a>
-  
-    | <a href="chapter-2.html">Next (2. Starting a Session)</a>
-  
-</div></div>
-
-<h1>1. Introduction</h1>
-
-
-
-     <h2>
-       <a name="s1"></a>
-       1.1. What is Net::SSH?
-     </h2>
-
-   
-
-   <div class="section">
-     <p>Net::SSH is a pure-Ruby implementation of the <span class="caps">SSH2</span> client protocol. It supports the following features:</p>
-	<ul>
-	<li>User authentication via explicit username/password, or using a public-key/private-key pair.
-</li>
-		<li>Port forwarding, both from the local host to a remote computer via the remote host, and from the remote host to the local host.
-</li>
-		<li>Execute processes on the remote machine, both interactively and non-interactively (&#8220;batch&#8221;).</li>
-	</ul>
-   </div>
-
-
-
-     <h2>
-       <a name="s2"></a>
-       1.2. What isn&#8217;t Net::SSH?
-     </h2>
-
-   
-
-   <div class="section">
-     <p>Net::SSH is only a <em>client</em> implementation, not a server. Given sufficient motivation and encouragement from the community, perhaps it will someday include an <span class="caps">SSH</span> server, but as of right now, it does not.</p>
-
-	<p>Furthermore, it is only an <em><span class="caps">SSH2</span></em> client. This means that it cannot connect to <span class="caps">SSH</span> servers that only understand the older <span class="caps">SSH1</span> protocol.</p>
-   </div>
-
-
-
-     <h2>
-       <a name="s3"></a>
-       1.3. Getting Net::SSH
-     </h2>
-
-   
-
-   <div class="section">
-     <h3>Prerequisites:</h3>
-
-	<p>In order to use Net::SSH, you must be using a supported version of Ruby&#8217;s OpenSSL module. The version distributed with Ruby 1.8.1 and earlier is not sufficient, and is lacking several features that Net::SSH relies on. If you are using Ruby 1.8.1 (or earlier), you should either upgrade to 1.8.2, or download and install an updated version of the OpenSSL module. You can download a usable snapshot from the <a href="http://rubyforge.org/projects/net-ssh">Net::SSH downloads page</a>.</p>
-
-	<p>Furthermore, you must make sure that Ruby&#8217;s OpenSSL module has been compiled against <em>at least</em> version 0.9.7 of the OpenSSL library. Prior versions lacked functionality that Net::SSH depends on (notably, the &#8216;padding&#8217; property of ciphers).</p>
-
-	<p>Optionally, you can install the <a href="http://raa.ruby-lang.org/project/ruby-termios">ruby-termios</a> and <a href="http://raa.ruby-lang.org/project/ruby-password">ruby-password</a> modules. If you do, then the ruby-password module will be used when prompting you for the passphrases needed to load your keys (if your keys have passphrases).</p>
-
-	<h3>Using <a href="http://rubygems.rubyforge.org">RubyGems</a></h3>
-
-	<p>If you have <a href="http://rubygems.rubyforge.org">RubyGems</a> installed, installing Net::SSH is simple:</p>
-
-	<div class='figure'>
-<span class='caption'>Using Rubygems to install Net::SSH [shell]</span>
-<div class='body'><link rel='stylesheet' type='text/css' href='stylesheets/shell.css' /><div class='shell'><pre>gem install net-ssh</pre></div></div></div>
-
-	<p>You still need to make sure you have a working version of Ruby&#8217;s OpenSSL module, but other than that, you should be good to go!</p>
-
-	<h3>Using <a href="http://rpa-base.rubyforge.org">rpa-base</a></h3>
-
-	<p>If you have <a href="http://rpa-base.rubyforge.org">rpa-base</a> installed:</p>
-
-	<div class='figure'>
-<span class='caption'>Using RPA to install Net::SSH [shell]</span>
-<div class='body'><link rel='stylesheet' type='text/css' href='stylesheets/shell.css' /><div class='shell'><pre>rpa install net-ssh</pre></div></div></div>
-
-	<p>As with the gem install, you still need to make sure you have a working version of Ruby&#8217;s OpenSSL module, but other than that, you should be good to go!</p>
-
-	<h3>Doing it the hard way</h3>
-
-	<p>If you don&#8217;t have <a href="http://rubygems.rubyforge.org">RubyGems</a> or <a href="http://rpa-base.rubyforge.org">rpa-base</a>, or if you just prefer to install things by hand, you can always go to the <a href="http://rubyforge.org/projects/net-ssh">Net::SSH downloads page</a> and grab the package of your choice: <code>tar.gz</code>, <code>tar.bz2</code>, or <code>zip</code>.</p>
-
-	<p>Then, unpack the archive and run the <code>setup.rb</code> script:</p>
-
-	<div class='figure'>
-<span class='caption'>Using setup.rb to install Net::SSH [shell]</span>
-<div class='body'><link rel='stylesheet' type='text/css' href='stylesheets/shell.css' /><div class='shell'><pre>ruby setup.rb config
-ruby setup.rb setup
-ruby setup.rb install</pre></div></div></div>
-   </div>
-
-
-
-     <h2>
-       <a name="s4"></a>
-       1.4. License Information
-     </h2>
-
-   
-
-   <div class="section">
-     <p>Net::SSH is made available under either the <span class="caps">BSD</span> license, or the same license Ruby (which, by extension, also allows the <span class="caps">GPL</span> as a permissable license as well). You can view the full text of any of these licenses in the <code>doc</code> subdirectory of the Net::SSH distrubtion. The texts of the <span class="caps">BSD</span> and <span class="caps">GPL</span> licenses are also available online: <a href="http://www.opensource.org/licenses/bsd-license.php">BSD</a> and <a href="http://www.opensource.org/licenses/gpl-license.php">GPL</a>.</p>
-
-	<p>This manual (in any form, be it source or otherwise) and the scripts and templates used to generate it, are all distributed under the <a href="http://creativecommons.org">Creative Commons</a> <a href="http://creativecommons.org/licenses/by-sa/2.0">Attribution-ShareAlike</a> license.</p>
-
-	<p>If you desire permission to use either Net::SSH or the manual in a manner incompatible with these licenses, please contact the copyright holder (<a href="mailto:jgb3@email.byu.edu">Jamis Buck</a>) in order to negotiate a more compatible license.</p>
-   </div>
-
-
-
-     <h2>
-       <a name="s5"></a>
-       1.5. Support
-     </h2>
-
-   
-
-   <div class="section">
-     <p>Mailing lists, bug trackers, feature requests, and public forums are all available (courtesty of <a href="http://rubyforge.org">RubyForge</a>) at the <a href="http://rubyforge.org/projects/net-ssh">Net::SSH project page</a>.</p>
-
-	<h3>Mailing Lists</h3>
-
-	<table>
-		<tr>
-			<th><strong>List Name</strong> </th>
-			<th>&#8212;</th>
-			<th><strong>Description</strong> </th>
-		</tr>
-		<tr>
-			<td style="vertical-align:top;text-align:center;"><a href="http://rubyforge.org/pipermail/net-ssh-users">net-ssh-users</a></td>
-			<td style="vertical-align:top;text-align:center;"><a href="http://rubyforge.org/mailman/listinfo/net-ssh-users">subscribe / unsubscribe</a></td>
-			<td> The Net::SSH users list is devoted to the discussion of and questions about the usage of the Net::SSH module. If you can&#8217;t quite figure out how to get a feature of Net::SSH to work, this is the list you would go to in order to ask your questions.</td>
-		</tr>
-		<tr>
-			<td style="vertical-align:top;text-align:center;"><a href="http://rubyforge.org/pipermail/net-ssh-devel">net-ssh-devel</a></td>
-			<td style="vertical-align:top;text-align:center;"><a href="http://rubyforge.org/mailman/listinfo/net-ssh-devel">subscribe / unsubscribe</a></td>
-			<td> The Net::SSH developers list is devoted to the discussion of Net::SSH&#8217;s implementation. If you have created a patch that you would like to discuss, or if you would like to discuss a new feature, this is the list for you.</td>
-		</tr>
-	</table>
-   </div>
-
-
-
-     <h2>
-       <a name="s6"></a>
-       1.6. About the Author
-     </h2>
-
-   
-
-   <div class="section">
-     <p>Net::SSH was written by <a href="mailto:jgb3@email.byu.edu">Jamis Buck</a>. Feel free to send him compliments, candy, money, praise, or new feature patches&#8212;he likes all those things. You can send him questions and suggestions, too, if you really want to. However, for bug reports and general feature requests, please use the trackers on the <a href="http://rubyforge.org/projects/net-ssh">Net::SSH project page</a>.</p>
-   </div>
-
-
-
-<div class="bottom"><div class="prevnext">
-  
-  <a href="index.html">Up</a>
-  
-    | <a href="chapter-2.html">Next (2. Starting a Session)</a>
-  
-</div></div>
-
-
-        </div>
-
-      </td></tr>
-    </table>
-  </body>
-</html>