net-sftp 1.1.1 → 2.0.0

data/lib/net/sftp/protocol/01/services.rb

@@ -1,47 +0,0 @@
-#--
-# =============================================================================
-# Copyright (c) 2004, Jamis Buck (jamis@37signals.com)
-# All rights reserved.
-#
-# This source file is distributed as part of the Net::SFTP Secure FTP 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::SFTP
-# distribution for the texts of these licenses.
-# -----------------------------------------------------------------------------
-# net-sftp website: http://net-ssh.rubyforge.org/sftp
-# project website : http://rubyforge.org/projects/net-ssh
-# =============================================================================
-#++
-
-module Net ; module SFTP ; module Protocol ; module V_01
-
-  def register_services( container )
-    container.namespace_define :v_01 do |ns|
-
-      # The packet assistant to use for formatting SFTP packets.
-      ns.packet_assistant do |c,|
-        require 'net/sftp/protocol/01/packet-assistant'
-        PacketAssistant.new( c[:transport][:buffers],
-                             c[:driver] )
-      end
-
-      # The attribute factory to use to obtain attribute object instances.
-      ns.attr_factory do |c,|
-        require 'net/sftp/protocol/01/attributes'
-        Attributes.init( c[:transport][:buffers] )
-      end
-
-      # The version implementation to use.
-      ns.impl do |c,|
-        require 'net/sftp/protocol/01/impl'
-        Impl.new( c[:transport][:buffers],
-                  c[:driver], c[:packet_assistant],
-                  c[:attr_factory] )
-      end
-
-    end
-  end
-  module_function :register_services
-
-end ; end ; end ; end

data/lib/net/sftp/protocol/02/impl.rb

@@ -1,39 +0,0 @@
-#--
-# =============================================================================
-# Copyright (c) 2004, Jamis Buck (jamis@37signals.com)
-# All rights reserved.
-#
-# This source file is distributed as part of the Net::SFTP Secure FTP 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::SFTP
-# distribution for the texts of these licenses.
-# -----------------------------------------------------------------------------
-# net-sftp website: http://net-ssh.rubyforge.org/sftp
-# project website : http://rubyforge.org/projects/net-ssh
-# =============================================================================
-#++
-
-require 'net/sftp/protocol/01/impl'
-
-module Net ; module SFTP ; module Protocol ; module V_02
-
-  # The implementation of the operations defined by version 2 of the SFTP
-  # protocol. This simply adds support for the RENAME operation, otherwise
-  # extending the version 1 implementation, unaltered.
-  class Impl < V_01::Impl
-
-    operation :rename
-
-    alias :rename_raw :rename
-
-    # This operation is special since a later version of the protocol adds
-    # support for flags. In this version, the flags parameter is ignored,
-    # but it exists for compatibility with later versions.
-    def rename( id, name, new_name, flags=nil )
-      rename_raw id, name, new_name
-    end
-
-  end
-
-end ; end ; end ; end

data/lib/net/sftp/protocol/02/packet-assistant.rb

@@ -1,32 +0,0 @@
-#--
-# =============================================================================
-# Copyright (c) 2004, Jamis Buck (jamis@37signals.com)
-# All rights reserved.
-#
-# This source file is distributed as part of the Net::SFTP Secure FTP 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::SFTP
-# distribution for the texts of these licenses.
-# -----------------------------------------------------------------------------
-# net-sftp website: http://net-ssh.rubyforge.org/sftp
-# project website : http://rubyforge.org/projects/net-ssh
-# =============================================================================
-#++
-
-require 'net/sftp/protocol/01/packet-assistant'
-
-module Net ; module SFTP ; module Protocol ; module V_02
-
-  # The packet assistant, used to format packets for version 2 of the SFTP
-  # protocol. This simply adds support for the RENAME packet:
-  #
-  # * rename( id, old, new )
-  class PacketAssistant < V_01::PacketAssistant
-
-    packet :rename,   :string, # old name
-                      :string  # new name
-
-  end
-
-end ; end ; end ; end

data/lib/net/sftp/protocol/02/services.rb

@@ -1,44 +0,0 @@
-#--
-# =============================================================================
-# Copyright (c) 2004, Jamis Buck (jamis@37signals.com)
-# All rights reserved.
-#
-# This source file is distributed as part of the Net::SFTP Secure FTP 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::SFTP
-# distribution for the texts of these licenses.
-# -----------------------------------------------------------------------------
-# net-sftp website: http://net-ssh.rubyforge.org/sftp
-# project website : http://rubyforge.org/projects/net-ssh
-# =============================================================================
-#++
-
-module Net ; module SFTP ; module Protocol ; module V_02
-
-  def register_services( container )
-    container.namespace_define :v_02 do |ns|
-
-      ns.packet_assistant do |c,|
-        require 'net/sftp/protocol/02/packet-assistant'
-        PacketAssistant.new( c[:transport][:buffers],
-                             c[:driver] )
-      end
-
-      ns.attr_factory do |c,|
-        require 'net/sftp/protocol/01/attributes'
-        V_01::Attributes.init( c[:transport][:buffers] )
-      end
-
-      ns.impl do |c,|
-        require 'net/sftp/protocol/02/impl'
-        Impl.new( c[:transport][:buffers],
-                  c[:driver], c[:packet_assistant],
-                  c[:attr_factory] )
-      end
-
-    end
-  end
-  module_function :register_services
-
-end ; end ; end ; end

data/lib/net/sftp/protocol/03/impl.rb

@@ -1,42 +0,0 @@
-#--
-# =============================================================================
-# Copyright (c) 2004, Jamis Buck (jamis@37signals.com)
-# All rights reserved.
-#
-# This source file is distributed as part of the Net::SFTP Secure FTP 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::SFTP
-# distribution for the texts of these licenses.
-# -----------------------------------------------------------------------------
-# net-sftp website: http://net-ssh.rubyforge.org/sftp
-# project website : http://rubyforge.org/projects/net-ssh
-# =============================================================================
-#++
-
-require 'net/sftp/protocol/02/impl'
-
-module Net ; module SFTP ; module Protocol ; module V_03
-
-  # The implementation of the operations for version 3 of the SFTP protocol.
-  # This adds support for the readlink and symlink operations.
-  class Impl < V_02::Impl
-
-    operation :readlink,
-              :symlink
-
-    # The #status message changed in this version. It adds +message+ and
-    # +language+ fields, so the callback now receives +driver+, +id+, +code+,
-    # +message+, and +language+ as parameters.
-    def do_status( channel, content )
-      return unless has_on_status?
-      id = content.read_long
-      code = content.read_long
-      message = content.read_string
-      language = content.read_string
-      call_on_status( driver, id, code, message, language )
-    end
-    
-  end
-
-end ; end ; end ; end

data/lib/net/sftp/protocol/03/packet-assistant.rb

@@ -1,35 +0,0 @@
-#--
-# =============================================================================
-# Copyright (c) 2004, Jamis Buck (jamis@37signals.com)
-# All rights reserved.
-#
-# This source file is distributed as part of the Net::SFTP Secure FTP 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::SFTP
-# distribution for the texts of these licenses.
-# -----------------------------------------------------------------------------
-# net-sftp website: http://net-ssh.rubyforge.org/sftp
-# project website : http://rubyforge.org/projects/net-ssh
-# =============================================================================
-#++
-
-require 'net/sftp/protocol/02/packet-assistant'
-
-module Net ; module SFTP ; module Protocol ; module V_03
-
-  # The packet assistant which formats packets for version 3 of the SFTP
-  # protocol. This adds support for the readlink and symlink packets:
-  #
-  # * readlink( id, path )
-  # * symlink( id, link, target )
-  class PacketAssistant < V_02::PacketAssistant
-
-    packet :readlink, :string  # path
-
-    packet :symlink,  :string, # link-path
-                      :string  # target-path
-
-  end
-
-end ; end ; end ; end

data/lib/net/sftp/protocol/03/services.rb

@@ -1,44 +0,0 @@
-#--
-# =============================================================================
-# Copyright (c) 2004, Jamis Buck (jamis@37signals.com)
-# All rights reserved.
-#
-# This source file is distributed as part of the Net::SFTP Secure FTP 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::SFTP
-# distribution for the texts of these licenses.
-# -----------------------------------------------------------------------------
-# net-sftp website: http://net-ssh.rubyforge.org/sftp
-# project website : http://rubyforge.org/projects/net-ssh
-# =============================================================================
-#++
-
-module Net ; module SFTP ; module Protocol ; module V_03
-
-  def register_services( container )
-    container.namespace_define :v_03 do |ns|
-
-      ns.packet_assistant do |c,|
-        require 'net/sftp/protocol/03/packet-assistant'
-        PacketAssistant.new( c[:transport][:buffers],
-                             c[:driver] )
-      end
-
-      ns.attr_factory do |c,|
-        require 'net/sftp/protocol/01/attributes'
-        V_01::Attributes.init( c[:transport][:buffers] )
-      end
-
-      ns.impl do |c,|
-        require 'net/sftp/protocol/03/impl'
-        Impl.new( c[:transport][:buffers],
-                  c[:driver], c[:packet_assistant],
-                  c[:attr_factory] )
-      end
-
-    end
-  end
-  module_function :register_services
-
-end ; end ; end ; end

data/lib/net/sftp/protocol/04/impl.rb

@@ -1,86 +0,0 @@
-#--
-# =============================================================================
-# Copyright (c) 2004, Jamis Buck (jamis@37signals.com)
-# All rights reserved.
-#
-# This source file is distributed as part of the Net::SFTP Secure FTP 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::SFTP
-# distribution for the texts of these licenses.
-# -----------------------------------------------------------------------------
-# net-sftp website: http://net-ssh.rubyforge.org/sftp
-# project website : http://rubyforge.org/projects/net-ssh
-# =============================================================================
-#++
-
-require 'net/sftp/protocol/03/impl'
-
-module Net ; module SFTP ; module Protocol ; module V_04
-
-  # The implementation of the operations available to version 4 of the SFTP
-  # protocol.
-  class Impl < V_03::Impl
- 
-    # In version 4, stat accepts a flags parameter. If flags is +nil+, it
-    # will default to returning all attributes. Otherwise, the flags parameter
-    # should be a bitwise combination of the F_xxx constants of
-    # Net::SFTP::Protocol::V_04::Attributes.
-    def stat( id, filename, flags=nil )
-      stat_raw id, filename, convert_flags( flags )
-    end
-
-    # In version 4, lstat accepts a flags parameter. If flags is +nil+, it
-    # will default to returning all attributes. Otherwise, the flags parameter
-    # should be a bitwise combination of the F_xxx constants of
-    # Net::SFTP::Protocol::V_04::Attributes.
-    def lstat( id, filename, flags=nil )
-      lstat_raw id, filename, convert_flags( flags )
-    end
-
-    # In version 4, fstat accepts a flags parameter. If flags is +nil+, it
-    # will default to returning all attributes. Otherwise, the flags parameter
-    # should be a bitwise combination of the F_xxx constants of
-    # Net::SFTP::Protocol::V_04::Attributes.
-    def fstat( id, handle, flags=nil )
-      fstat_raw id, handle, convert_flags( flags )
-    end
-
-    # In version 4, rename accepts a flags parameter. The valid flags are a
-    # combination of the following:
-    #
-    # * FXP_RENAME_OVERWRITE (0x01)
-    # * FXP_RENAME_ATOMIC (0x02)
-    # * FXP_RENAME_NATIVE (0x04)
-    #
-    # Please refer to the SSH2 specification for the description of these flags.
-    def rename( id, name, new_name, flags=0 )
-      rename_raw id, name, new_name, flags
-    end
-
-    # A convenience method for converting the (stat) flags parameter into a
-    # value acceptible to the SFTP protocol.
-    def convert_flags( flags )
-      return 0x800001FD if flags.nil?
-      flags
-    end
-    private :convert_flags
-
-    # Used internally to handle +name+ packets. The +on_name+ callback is
-    # invoked, if registered, with the driver, id, and array of items. The v4
-    # version of this method sets the 'longname' member of the Name object to
-    # +nil+ (it is not used in this version).
-    def do_name( channel, content )
-      return unless has_on_name?
-      id = content.read_long
-      items = []
-      content.read_long.times do
-        items.push( Name.new( content.read_string, nil,
-          @attr_factory.from_buffer( content ) ) )
-      end
-      call_on_name( driver, id, items )
-    end
-
-  end
-
-end ; end ; end ; end

data/lib/net/sftp/protocol/04/packet-assistant.rb

@@ -1,45 +0,0 @@
-#--
-# =============================================================================
-# Copyright (c) 2004, Jamis Buck (jamis@37signals.com)
-# All rights reserved.
-#
-# This source file is distributed as part of the Net::SFTP Secure FTP 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::SFTP
-# distribution for the texts of these licenses.
-# -----------------------------------------------------------------------------
-# net-sftp website: http://net-ssh.rubyforge.org/sftp
-# project website : http://rubyforge.org/projects/net-ssh
-# =============================================================================
-#++
-
-require 'net/sftp/protocol/03/packet-assistant'
-
-module Net ; module SFTP ; module Protocol ; module V_04
-
-  # Version 4 of the SFTP protocol changed the number of parameters to several
-  # different packet types:
-  #
-  # * rename( id, old, new, flags )
-  # * stat( id, path, flags )
-  # * lstat( id, path, flags )
-  # * fstat( id, handle, flags )
-  class PacketAssistant < V_03::PacketAssistant
-
-    packet :rename,   :string, # old name
-                      :string, # new name
-                      :long    # flags
-
-    packet :stat,     :string, # path
-                      :long    # flags
-
-    packet :lstat,    :string, # path
-                      :long    # flags
-
-    packet :fstat,    :string, # handle
-                      :long    # flags
-
-  end
-
-end ; end ; end ; end

data/lib/net/sftp/protocol/04/services.rb

@@ -1,44 +0,0 @@
-#--
-# =============================================================================
-# Copyright (c) 2004, Jamis Buck (jamis@37signals.com)
-# All rights reserved.
-#
-# This source file is distributed as part of the Net::SFTP Secure FTP 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::SFTP
-# distribution for the texts of these licenses.
-# -----------------------------------------------------------------------------
-# net-sftp website: http://net-ssh.rubyforge.org/sftp
-# project website : http://rubyforge.org/projects/net-ssh
-# =============================================================================
-#++
-
-module Net ; module SFTP ; module Protocol ; module V_04
-
-  def register_services( container )
-    container.namespace_define :v_04 do |ns|
-
-      ns.packet_assistant do |c,|
-        require 'net/sftp/protocol/04/packet-assistant'
-        PacketAssistant.new( c[:transport][:buffers],
-                             c[:driver] )
-      end
-
-      ns.attr_factory do |c,|
-        require 'net/sftp/protocol/04/attributes'
-        Attributes.init( c[:transport][:buffers] )
-      end
-
-      ns.impl do |c,|
-        require 'net/sftp/protocol/04/impl'
-        Impl.new( c[:transport][:buffers],
-                  c[:driver], c[:packet_assistant],
-                  c[:attr_factory] )
-      end
-
-    end
-  end
-  module_function :register_services
-
-end ; end ; end ; end