Add on_open_failed callback hook for multi channel

Author: jamis

CHANGELOG.rdoc

@@ -1,3 +1,8 @@
+=== unreleased
+
+* Add Channel#on_open_failed callback hook [Jamis Buck]
+
+
 === 1.0.0 / 1 May 2008
 
 * (no changes since the last preview release)

lib/net/ssh/multi/channel.rb

@@ -199,6 +199,20 @@ def on_eof(&block)
       self
     end
 
+    # Registers a callback on all component channels, to be invoked when the
+    # remote server is unable to open the channel. The callback will be
+    # invoked with three arguments: the channel object that couldn't be
+    # opened, a description of the error (as a string), and an integer code
+    # representing the error.
+    #
+    #   channel.on_open_failed do |ch, description, code|
+    #     # ...
+    #   end
+    def on_open_failed(&block)
+      channels.each { |channel| channel.on_open_failed(&block) }
+      self
+    end
+
     # Registers a callback on all component channels, to be invoked when the
     # remote server sends a channel request of the given +type+. The callback
     # will be invoked with two arguments: the specific channel object receiving