net-ssh 2.7.0 → 7.3.0

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

@@ -1,178 +1,180 @@
-module Net; module SSH; module Connection
-      
-  # These constants are used when requesting a pseudo-terminal (via
-  # Net::SSH::Connection::Channel#request_pty). The descriptions for each are
-  # taken directly from RFC 4254 ("The Secure Shell (SSH) Connection Protocol"),
-  # http://tools.ietf.org/html/rfc4254.
-  module Term
-    # Interrupt character; 255 if none. Similarly for the other characters.
-    # Not all of these characters are supported on all systems.
-    VINTR = 1
+module Net
+  module SSH
+    module Connection
+      # These constants are used when requesting a pseudo-terminal (via
+      # Net::SSH::Connection::Channel#request_pty). The descriptions for each are
+      # taken directly from RFC 4254 ("The Secure Shell (SSH) Connection Protocol"),
+      # http://tools.ietf.org/html/rfc4254.
+      module Term
+        # Interrupt character; 255 if none. Similarly for the other characters.
+        # Not all of these characters are supported on all systems.
+        VINTR = 1
 
-    # The quit character (sends SIGQUIT signal on POSIX systems).
-    VQUIT = 2
+        # The quit character (sends SIGQUIT signal on POSIX systems).
+        VQUIT = 2
 
-    # Erase the character to left of the cursor.
-    VERASE = 3
+        # Erase the character to left of the cursor.
+        VERASE = 3
 
-    # Kill the current input line.
-    VKILL = 4
+        # Kill the current input line.
+        VKILL = 4
 
-    # End-of-file character (sends EOF from the terminal).
-    VEOF = 5
+        # End-of-file character (sends EOF from the terminal).
+        VEOF = 5
 
-    # End-of-line character in addition to carriage return and/or linefeed.
-    VEOL = 6
+        # End-of-line character in addition to carriage return and/or linefeed.
+        VEOL = 6
 
-    # Additional end-of-line character.
-    VEOL2 = 7
+        # Additional end-of-line character.
+        VEOL2 = 7
 
-    # Continues paused output (normally control-Q).
-    VSTART = 8
+        # Continues paused output (normally control-Q).
+        VSTART = 8
 
-    # Pauses output (normally control-S).
-    VSTOP = 9
+        # Pauses output (normally control-S).
+        VSTOP = 9
 
-    # Suspends the current program.
-    VSUSP = 10
+        # Suspends the current program.
+        VSUSP = 10
 
-    # Another suspend character.
-    VDSUSP = 11
+        # Another suspend character.
+        VDSUSP = 11
 
-    # Reprints the current input line.
-    VREPRINT = 12
+        # Reprints the current input line.
+        VREPRINT = 12
 
-    # Erases a word left of cursor.
-    VWERASE = 13
+        # Erases a word left of cursor.
+        VWERASE = 13
 
-    # Enter the next character typed literally, even if it is a special
-    # character.
-    VLNEXT = 14
+        # Enter the next character typed literally, even if it is a special
+        # character.
+        VLNEXT = 14
 
-    # Character to flush output.
-    VFLUSH = 15
+        # Character to flush output.
+        VFLUSH = 15
 
-    # Switch to a different shell layer.
-    VSWITCH = 16
+        # Switch to a different shell layer.
+        VSWITCH = 16
 
-    # Prints system status line (load, command, pid, etc).
-    VSTATUS = 17
+        # Prints system status line (load, command, pid, etc).
+        VSTATUS = 17
 
-    # Toggles the flushing of terminal output.
-    VDISCARD = 18
+        # Toggles the flushing of terminal output.
+        VDISCARD = 18
 
-    # The ignore parity flag. The parameter SHOULD be 0 if this flag is FALSE,
-    # and 1 if it is TRUE.
-    IGNPAR = 30
+        # The ignore parity flag. The parameter SHOULD be 0 if this flag is FALSE,
+        # and 1 if it is TRUE.
+        IGNPAR = 30
 
-    # Mark parity and framing errors.
-    PARMRK = 31
+        # Mark parity and framing errors.
+        PARMRK = 31
 
-    # Enable checking of parity errors.
-    INPCK = 32
+        # Enable checking of parity errors.
+        INPCK = 32
 
-    # Strip 8th bit off characters.
-    ISTRIP = 33
+        # Strip 8th bit off characters.
+        ISTRIP = 33
 
-    # Map NL into CR on input.
-    INCLR = 34
+        # Map NL into CR on input.
+        INCLR = 34
 
-    # Ignore CR on input.
-    IGNCR = 35
+        # Ignore CR on input.
+        IGNCR = 35
 
-    # Map CR to NL on input.
-    ICRNL = 36
+        # Map CR to NL on input.
+        ICRNL = 36
 
-    # Translate uppercase characters to lowercase.
-    IUCLC = 37
+        # Translate uppercase characters to lowercase.
+        IUCLC = 37
 
-    # Enable output flow control.
-    IXON = 38
+        # Enable output flow control.
+        IXON = 38
 
-    # Any char will restart after stop.
-    IXANY = 39
+        # Any char will restart after stop.
+        IXANY = 39
 
-    # Enable input flow control.
-    IXOFF = 40
+        # Enable input flow control.
+        IXOFF = 40
 
-    # Ring bell on input queue full.
-    IMAXBEL = 41
+        # Ring bell on input queue full.
+        IMAXBEL = 41
 
-    # Enable signals INTR, QUIT, [D]SUSP.
-    ISIG = 50
+        # Enable signals INTR, QUIT, [D]SUSP.
+        ISIG = 50
 
-    # Canonicalize input lines.
-    ICANON = 51
+        # Canonicalize input lines.
+        ICANON = 51
 
-    # Enable input and output of uppercase characters by preceding their
-    # lowercase equivalents with "\".
-    XCASE = 52
+        # Enable input and output of uppercase characters by preceding their
+        # lowercase equivalents with "\".
+        XCASE = 52
 
-    # Enable echoing.
-    ECHO = 53
+        # Enable echoing.
+        ECHO = 53
 
-    # Visually erase chars.
-    ECHOE = 54
+        # Visually erase chars.
+        ECHOE = 54
 
-    # Kill character discards current line.
-    ECHOK = 55
+        # Kill character discards current line.
+        ECHOK = 55
 
-    # Echo NL even if ECHO is off.
-    ECHONL = 56
+        # Echo NL even if ECHO is off.
+        ECHONL = 56
 
-    # Don't flush after interrupt.
-    NOFLSH = 57
+        # Don't flush after interrupt.
+        NOFLSH = 57
 
-    # Stop background jobs from output.
-    TOSTOP= 58
+        # Stop background jobs from output.
+        TOSTOP = 58
 
-    # Enable extensions.
-    IEXTEN = 59
+        # Enable extensions.
+        IEXTEN = 59
 
-    # Echo control characters as ^(Char).
-    ECHOCTL = 60
+        # Echo control characters as ^(Char).
+        ECHOCTL = 60
 
-    # Visual erase for line kill.
-    ECHOKE = 61
+        # Visual erase for line kill.
+        ECHOKE = 61
 
-    # Retype pending input.
-    PENDIN = 62
+        # Retype pending input.
+        PENDIN = 62
 
-    # Enable output processing.
-    OPOST = 70
+        # Enable output processing.
+        OPOST = 70
 
-    # Convert lowercase to uppercase.
-    OLCUC = 71
+        # Convert lowercase to uppercase.
+        OLCUC = 71
 
-    # Map NL to CR-NL.
-    ONLCR = 72
+        # Map NL to CR-NL.
+        ONLCR = 72
 
-    # Translate carriage return to newline (output).
-    OCRNL = 73
+        # Translate carriage return to newline (output).
+        OCRNL = 73
 
-    # Translate newline to carriage return-newline (output).
-    ONOCR = 74
+        # Translate newline to carriage return-newline (output).
+        ONOCR = 74
 
-    # Newline performs a carriage return (output).
-    ONLRET = 75
+        # Newline performs a carriage return (output).
+        ONLRET = 75
 
-    # 7 bit mode.
-    CS7 = 90
+        # 7 bit mode.
+        CS7 = 90
 
-    # 8 bit mode.
-    CS8 = 91
+        # 8 bit mode.
+        CS8 = 91
 
-    # Parity enable.
-    PARENB = 92
+        # Parity enable.
+        PARENB = 92
 
-    # Odd parity, else even.
-    PARODD = 93
+        # Odd parity, else even.
+        PARODD = 93
 
-    # Specifies the input baud rate in bits per second.
-    TTY_OP_ISPEED = 128
+        # Specifies the input baud rate in bits per second.
+        TTY_OP_ISPEED = 128
 
-    # Specifies the output baud rate in bits per second.
-    TTY_OP_OSPEED = 129
+        # Specifies the output baud rate in bits per second.
+        TTY_OP_OSPEED = 129
+      end
+    end
   end
-
-end; end; end
+end

data/lib/net/ssh/errors.rb

@@ -1,100 +1,106 @@
-module Net; module SSH
-  # A general exception class, to act as the ancestor of all other Net::SSH
-  # exception classes.
-  class Exception < ::RuntimeError; end
-
-  # This exception is raised when authentication fails (whether it be
-  # public key authentication, password authentication, or whatever).
-  class AuthenticationFailed < Exception; end
-
-  # This exception is raised when a connection attempt times out.
-  class ConnectionTimeout < Exception; end
-
-  # This exception is raised when the remote host has disconnected
-  # unexpectedly.
-  class Disconnect < Exception; end
-
-  # This exception is primarily used internally, but if you have a channel
-  # request handler (see Net::SSH::Connection::Channel#on_request) that you
-  # want to fail in such a way that the server knows it failed, you can
-  # raise this exception in the handler and Net::SSH will translate that into
-  # a "channel failure" message.
-  class ChannelRequestFailed < Exception; end
-
-  # This is exception is primarily used internally, but if you have a channel
-  # open handler (see Net::SSH::Connection::Session#on_open_channel) and you
-  # want to fail in such a way that the server knows it failed, you can
-  # raise this exception in the handler and Net::SSH will translate that into
-  # a "channel open failed" message.
-  class ChannelOpenFailed < Exception
-    attr_reader :code, :reason
-
-    def initialize(code, reason)
-      @code, @reason = code, reason
-      super "#{reason} (#{code})"
-    end
-  end
-
-  # Base class for host key exceptions. When rescuing this exception, you can
-  # inspect the key fingerprint and, if you want to proceed anyway, simply call
-  # the remember_host! method on the exception, and then retry.
-  class HostKeyError < Exception
-    # the callback to use when #remember_host! is called
-    attr_writer :callback #:nodoc:
-
-    # situation-specific data describing the host (see #host, #port, etc.)
-    attr_writer :data #:nodoc:
-
-    # An accessor for getting at the data that was used to look up the host
-    # (see also #fingerprint, #host, #port, #ip, and #key).
-    def [](key)
-      @data && @data[key]
-    end
-
-    # Returns the fingerprint of the key for the host, which either was not
-    # found or did not match.
-    def fingerprint
-      @data && @data[:fingerprint]
+module Net
+  module SSH
+    # A general exception class, to act as the ancestor of all other Net::SSH
+    # exception classes.
+    class Exception < ::RuntimeError; end
+
+    # This exception is raised when authentication fails (whether it be
+    # public key authentication, password authentication, or whatever).
+    class AuthenticationFailed < Net::SSH::Exception; end
+
+    # This exception is raised when a connection attempt times out.
+    class ConnectionTimeout < Net::SSH::Exception; end
+
+    # This exception is raised when the remote host has disconnected
+    # unexpectedly.
+    class Disconnect < Net::SSH::Exception; end
+
+    # This exception is raised when the remote host has disconnected/
+    # timeouted unexpectedly.
+    class Timeout < Disconnect; end
+
+    # This exception is primarily used internally, but if you have a channel
+    # request handler (see Net::SSH::Connection::Channel#on_request) that you
+    # want to fail in such a way that the server knows it failed, you can
+    # raise this exception in the handler and Net::SSH will translate that into
+    # a "channel failure" message.
+    class ChannelRequestFailed < Net::SSH::Exception; end
+
+    # This is exception is primarily used internally, but if you have a channel
+    # open handler (see Net::SSH::Connection::Session#on_open_channel) and you
+    # want to fail in such a way that the server knows it failed, you can
+    # raise this exception in the handler and Net::SSH will translate that into
+    # a "channel open failed" message.
+    class ChannelOpenFailed < Net::SSH::Exception
+      attr_reader :code, :reason
+
+      def initialize(code, reason)
+        @code, @reason = code, reason
+        super "#{reason} (#{code})"
+      end
     end
 
-    # Returns the host name for the remote host, as reported by the socket.
-    def host
-      @data && @data[:peer] && @data[:peer][:host]
+    # Base class for host key exceptions. When rescuing this exception, you can
+    # inspect the key fingerprint and, if you want to proceed anyway, simply call
+    # the remember_host! method on the exception, and then retry.
+    class HostKeyError < Net::SSH::Exception
+      # the callback to use when #remember_host! is called
+      attr_writer :callback # :nodoc:
+
+      # situation-specific data describing the host (see #host, #port, etc.)
+      attr_writer :data # :nodoc:
+
+      # An accessor for getting at the data that was used to look up the host
+      # (see also #fingerprint, #host, #port, #ip, and #key).
+      def [](key)
+        @data && @data[key]
+      end
+
+      # Returns the fingerprint of the key for the host, which either was not
+      # found or did not match.
+      def fingerprint
+        @data && @data[:fingerprint]
+      end
+
+      # Returns the host name for the remote host, as reported by the socket.
+      def host
+        @data && @data[:peer] && @data[:peer][:host]
+      end
+
+      # Returns the port number for the remote host, as reported by the socket.
+      def port
+        @data && @data[:peer] && @data[:peer][:port]
+      end
+
+      # Returns the IP address of the remote host, as reported by the socket.
+      def ip
+        @data && @data[:peer] && @data[:peer][:ip]
+      end
+
+      # Returns the key itself, as reported by the remote host.
+      def key
+        @data && @data[:key]
+      end
+
+      # Tell Net::SSH to record this host and key in the known hosts file, so
+      # that subsequent connections will remember them.
+      def remember_host!
+        @callback.call
+      end
     end
 
-    # Returns the port number for the remote host, as reported by the socket.
-    def port
-      @data && @data[:peer] && @data[:peer][:port]
-    end
-
-    # Returns the IP address of the remote host, as reported by the socket.
-    def ip
-      @data && @data[:peer] && @data[:peer][:ip]
-    end
-
-    # Returns the key itself, as reported by the remote host.
-    def key
-      @data && @data[:key]
-    end
-
-    # Tell Net::SSH to record this host and key in the known hosts file, so
-    # that subsequent connections will remember them.
-    def remember_host!
-      @callback.call
-    end
+    # Raised when the cached key for a particular host does not match the
+    # key given by the host, which can be indicative of a man-in-the-middle
+    # attack. When rescuing this exception, you can inspect the key fingerprint
+    # and, if you want to proceed anyway, simply call the remember_host!
+    # method on the exception, and then retry.
+    class HostKeyMismatch < HostKeyError; end
+
+    # Raised when there is no cached key for a particular host, which probably
+    # means that the host has simply not been seen before.
+    # When rescuing this exception, you can inspect the key fingerprint and, if
+    # you want to proceed anyway, simply call the remember_host! method on the
+    # exception, and then retry.
+    class HostKeyUnknown < HostKeyError; end
   end
-
-  # Raised when the cached key for a particular host does not match the
-  # key given by the host, which can be indicative of a man-in-the-middle
-  # attack. When rescuing this exception, you can inspect the key fingerprint
-  # and, if you want to proceed anyway, simply call the remember_host!
-  # method on the exception, and then retry.
-  class HostKeyMismatch < HostKeyError; end
-
-  # Raised when there is no cached key for a particular host, which probably
-  # means that the host has simply not been seen before.
-  # When rescuing this exception, you can inspect the key fingerprint and, if
-  # you want to proceed anyway, simply call the remember_host! method on the
-  # exception, and then retry.
-  class HostKeyUnknown < HostKeyError; end
-end; end
+end