Class: Async::IO::SSLSocket
- Includes:
- Peer
- Defined in:
- lib/async/io/ssl_socket.rb
Overview
Asynchronous TCP socket wrapper.
Constant Summary
Constants inherited from Generic
Instance Attribute Summary
Attributes inherited from Generic
Class Method Summary collapse
Instance Method Summary collapse
-
#accept ⇒ Object
Invokes ‘accept_nonblock` on the underlying io.
- #close_read ⇒ Object
- #close_write ⇒ Object
-
#connect ⇒ Object
Invokes ‘connect_nonblock` on the underlying io.
-
#initialize(socket, context) ⇒ SSLSocket
constructor
A new instance of SSLSocket.
- #local_address ⇒ Object
- #remote_address ⇒ Object
- #shutdown(how) ⇒ Object
Methods included from Peer
#connected?, #eof, #eof?, #protocol, #sync, #sync=, #type
Methods inherited from Generic
#<<, #connected?, #dup, #nonblock, #nonblock=, #nonblock?, #read, #sysread, #syswrite, #wait, wrap, wrap_blocking_method, wraps, #write
Constructor Details
#initialize(socket, context) ⇒ SSLSocket
Returns a new instance of SSLSocket.
66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 |
# File 'lib/async/io/ssl_socket.rb', line 66 def initialize(socket, context) if socket.is_a?(self.class.wrapped_klass) super else io = self.class.wrapped_klass.new(socket.to_io, context) super(io, socket.reactor) # We detach the socket from the reactor, otherwise it's possible to add the file descriptor to the selector twice, which is bad. socket.reactor = nil # This ensures that when the internal IO is closed, it also closes the internal socket: io.sync_close = true @timeout = socket.timeout end end |
Class Method Details
.connect(socket, context, hostname = nil, &block) ⇒ Object
38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 |
# File 'lib/async/io/ssl_socket.rb', line 38 def self.connect(socket, context, hostname = nil, &block) client = self.new(socket, context) # Used for SNI: if hostname client.hostname = hostname end begin client.connect rescue # If the connection fails (e.g. certificates are invalid), the caller never sees the socket, so we close it and raise the exception up the chain. client.close raise end return client unless block_given? begin yield client ensure client.close end end |
Instance Method Details
#accept ⇒ Object
Invokes ‘accept_nonblock` on the underlying io. If the operation would block, the current task is paused until the operation can succeed, at which point it’s resumed and the operation is completed.
35 |
# File 'lib/async/io/ssl_socket.rb', line 35 wrap_blocking_method :accept, :accept_nonblock |
#close_read ⇒ Object
96 97 98 |
# File 'lib/async/io/ssl_socket.rb', line 96 def close_read @io.to_io.shutdown(Socket::SHUT_RD) end |
#close_write ⇒ Object
91 92 93 94 |
# File 'lib/async/io/ssl_socket.rb', line 91 def close_write # Invokes SSL_shutdown, which sends a close_notify message to the peer. @io.__send__(:stop) end |
#connect ⇒ Object
Invokes ‘connect_nonblock` on the underlying io. If the operation would block, the current task is paused until the operation can succeed, at which point it’s resumed and the operation is completed.
36 |
# File 'lib/async/io/ssl_socket.rb', line 36 wrap_blocking_method :connect, :connect_nonblock |
#local_address ⇒ Object
83 84 85 |
# File 'lib/async/io/ssl_socket.rb', line 83 def local_address @io.to_io.local_address end |
#remote_address ⇒ Object
87 88 89 |
# File 'lib/async/io/ssl_socket.rb', line 87 def remote_address @io.to_io.remote_address end |
#shutdown(how) ⇒ Object
100 101 102 103 |
# File 'lib/async/io/ssl_socket.rb', line 100 def shutdown(how) @io.flush @io.to_io.shutdown(how) end |