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.
49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 |
# File 'lib/async/io/ssl_socket.rb', line 49 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
21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 |
# File 'lib/async/io/ssl_socket.rb', line 21 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.
18 |
# File 'lib/async/io/ssl_socket.rb', line 18 wrap_blocking_method :accept, :accept_nonblock |
#close_read ⇒ Object
79 80 81 |
# File 'lib/async/io/ssl_socket.rb', line 79 def close_read @io.to_io.shutdown(Socket::SHUT_RD) end |
#close_write ⇒ Object
74 75 76 77 |
# File 'lib/async/io/ssl_socket.rb', line 74 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.
19 |
# File 'lib/async/io/ssl_socket.rb', line 19 wrap_blocking_method :connect, :connect_nonblock |
#local_address ⇒ Object
66 67 68 |
# File 'lib/async/io/ssl_socket.rb', line 66 def local_address @io.to_io.local_address end |
#remote_address ⇒ Object
70 71 72 |
# File 'lib/async/io/ssl_socket.rb', line 70 def remote_address @io.to_io.remote_address end |
#shutdown(how) ⇒ Object
83 84 85 86 |
# File 'lib/async/io/ssl_socket.rb', line 83 def shutdown(how) @io.flush @io.to_io.shutdown(how) end |