folly: build with -Wunused-parameter
[folly.git] / folly / io / async / AsyncSSLSocket.cpp
1 /*
2  * Copyright 2015 Facebook, Inc.
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *   http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16
17 #include <folly/io/async/AsyncSSLSocket.h>
18
19 #include <folly/io/async/EventBase.h>
20
21 #include <boost/noncopyable.hpp>
22 #include <errno.h>
23 #include <fcntl.h>
24 #include <netinet/in.h>
25 #include <netinet/tcp.h>
26 #include <openssl/err.h>
27 #include <openssl/asn1.h>
28 #include <openssl/ssl.h>
29 #include <sys/types.h>
30 #include <sys/socket.h>
31 #include <unistd.h>
32 #include <chrono>
33
34 #include <folly/Bits.h>
35 #include <folly/SocketAddress.h>
36 #include <folly/SpinLock.h>
37 #include <folly/io/IOBuf.h>
38 #include <folly/io/Cursor.h>
39
40 using folly::SocketAddress;
41 using folly::SSLContext;
42 using std::string;
43 using std::shared_ptr;
44
45 using folly::Endian;
46 using folly::IOBuf;
47 using folly::SpinLock;
48 using folly::SpinLockGuard;
49 using folly::io::Cursor;
50 using std::unique_ptr;
51 using std::bind;
52
53 namespace {
54 using folly::AsyncSocket;
55 using folly::AsyncSocketException;
56 using folly::AsyncSSLSocket;
57 using folly::Optional;
58 using folly::SSLContext;
59
60 // We have one single dummy SSL context so that we can implement attach
61 // and detach methods in a thread safe fashion without modifying opnessl.
62 static SSLContext *dummyCtx = nullptr;
63 static SpinLock dummyCtxLock;
64
65 // Numbers chosen as to not collide with functions in ssl.h
66 const uint8_t TASYNCSSLSOCKET_F_PERFORM_READ = 90;
67 const uint8_t TASYNCSSLSOCKET_F_PERFORM_WRITE = 91;
68
69 // If given min write size is less than this, buffer will be allocated on
70 // stack, otherwise it is allocated on heap
71 const size_t MAX_STACK_BUF_SIZE = 2048;
72
73 // This converts "illegal" shutdowns into ZERO_RETURN
74 inline bool zero_return(int error, int rc) {
75   return (error == SSL_ERROR_ZERO_RETURN || (rc == 0 && errno == 0));
76 }
77
78 class AsyncSSLSocketConnector: public AsyncSocket::ConnectCallback,
79                                 public AsyncSSLSocket::HandshakeCB {
80
81  private:
82   AsyncSSLSocket *sslSocket_;
83   AsyncSSLSocket::ConnectCallback *callback_;
84   int timeout_;
85   int64_t startTime_;
86
87  protected:
88   ~AsyncSSLSocketConnector() override {}
89
90  public:
91   AsyncSSLSocketConnector(AsyncSSLSocket *sslSocket,
92                            AsyncSocket::ConnectCallback *callback,
93                            int timeout) :
94       sslSocket_(sslSocket),
95       callback_(callback),
96       timeout_(timeout),
97       startTime_(std::chrono::duration_cast<std::chrono::milliseconds>(
98                    std::chrono::steady_clock::now().time_since_epoch()).count()) {
99   }
100
101   void connectSuccess() noexcept override {
102     VLOG(7) << "client socket connected";
103
104     int64_t timeoutLeft = 0;
105     if (timeout_ > 0) {
106       auto curTime = std::chrono::duration_cast<std::chrono::milliseconds>(
107         std::chrono::steady_clock::now().time_since_epoch()).count();
108
109       timeoutLeft = timeout_ - (curTime - startTime_);
110       if (timeoutLeft <= 0) {
111         AsyncSocketException ex(AsyncSocketException::TIMED_OUT,
112                                 "SSL connect timed out");
113         fail(ex);
114         delete this;
115         return;
116       }
117     }
118     sslSocket_->sslConn(this, timeoutLeft);
119   }
120
121   void connectErr(const AsyncSocketException& ex) noexcept override {
122     LOG(ERROR) << "TCP connect failed: " <<  ex.what();
123     fail(ex);
124     delete this;
125   }
126
127   void handshakeSuc(AsyncSSLSocket* /* sock */) noexcept override {
128     VLOG(7) << "client handshake success";
129     if (callback_) {
130       callback_->connectSuccess();
131     }
132     delete this;
133   }
134
135   void handshakeErr(AsyncSSLSocket* /* socket */,
136                     const AsyncSocketException& ex) noexcept override {
137     LOG(ERROR) << "client handshakeErr: " << ex.what();
138     fail(ex);
139     delete this;
140   }
141
142   void fail(const AsyncSocketException &ex) {
143     // fail is a noop if called twice
144     if (callback_) {
145       AsyncSSLSocket::ConnectCallback *cb = callback_;
146       callback_ = nullptr;
147
148       cb->connectErr(ex);
149       sslSocket_->closeNow();
150       // closeNow can call handshakeErr if it hasn't been called already.
151       // So this may have been deleted, no member variable access beyond this
152       // point
153       // Note that closeNow may invoke writeError callbacks if the socket had
154       // write data pending connection completion.
155     }
156   }
157 };
158
159 // XXX: implement an equivalent to corking for platforms with TCP_NOPUSH?
160 #ifdef TCP_CORK // Linux-only
161 /**
162  * Utility class that corks a TCP socket upon construction or uncorks
163  * the socket upon destruction
164  */
165 class CorkGuard : private boost::noncopyable {
166  public:
167   CorkGuard(int fd, bool multipleWrites, bool haveMore, bool* corked):
168     fd_(fd), haveMore_(haveMore), corked_(corked) {
169     if (*corked_) {
170       // socket is already corked; nothing to do
171       return;
172     }
173     if (multipleWrites || haveMore) {
174       // We are performing multiple writes in this performWrite() call,
175       // and/or there are more calls to performWrite() that will be invoked
176       // later, so enable corking
177       int flag = 1;
178       setsockopt(fd_, IPPROTO_TCP, TCP_CORK, &flag, sizeof(flag));
179       *corked_ = true;
180     }
181   }
182
183   ~CorkGuard() {
184     if (haveMore_) {
185       // more data to come; don't uncork yet
186       return;
187     }
188     if (!*corked_) {
189       // socket isn't corked; nothing to do
190       return;
191     }
192
193     int flag = 0;
194     setsockopt(fd_, IPPROTO_TCP, TCP_CORK, &flag, sizeof(flag));
195     *corked_ = false;
196   }
197
198  private:
199   int fd_;
200   bool haveMore_;
201   bool* corked_;
202 };
203 #else
204 class CorkGuard : private boost::noncopyable {
205  public:
206   CorkGuard(int, bool, bool, bool*) {}
207 };
208 #endif
209
210 void setup_SSL_CTX(SSL_CTX *ctx) {
211 #ifdef SSL_MODE_RELEASE_BUFFERS
212   SSL_CTX_set_mode(ctx,
213                    SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER |
214                    SSL_MODE_ENABLE_PARTIAL_WRITE
215                    | SSL_MODE_RELEASE_BUFFERS
216                    );
217 #else
218   SSL_CTX_set_mode(ctx,
219                    SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER |
220                    SSL_MODE_ENABLE_PARTIAL_WRITE
221                    );
222 #endif
223 // SSL_CTX_set_mode is a Macro
224 #ifdef SSL_MODE_WRITE_IOVEC
225   SSL_CTX_set_mode(ctx,
226                    SSL_CTX_get_mode(ctx)
227                    | SSL_MODE_WRITE_IOVEC);
228 #endif
229
230 }
231
232 BIO_METHOD eorAwareBioMethod;
233
234 void* initEorBioMethod(void) {
235   memcpy(&eorAwareBioMethod, BIO_s_socket(), sizeof(eorAwareBioMethod));
236   // override the bwrite method for MSG_EOR support
237   eorAwareBioMethod.bwrite = AsyncSSLSocket::eorAwareBioWrite;
238
239   // Note that the eorAwareBioMethod.type and eorAwareBioMethod.name are not
240   // set here. openssl code seems to be checking ".type == BIO_TYPE_SOCKET" and
241   // then have specific handlings. The eorAwareBioWrite should be compatible
242   // with the one in openssl.
243
244   // Return something here to enable AsyncSSLSocket to call this method using
245   // a function-scoped static.
246   return nullptr;
247 }
248
249 } // anonymous namespace
250
251 namespace folly {
252
253 SSLException::SSLException(int sslError, int errno_copy):
254     AsyncSocketException(
255       AsyncSocketException::SSL_ERROR,
256       ERR_error_string(sslError, msg_),
257       sslError == SSL_ERROR_SYSCALL ? errno_copy : 0), error_(sslError) {}
258
259 /**
260  * Create a client AsyncSSLSocket
261  */
262 AsyncSSLSocket::AsyncSSLSocket(const shared_ptr<SSLContext> &ctx,
263                                EventBase* evb, bool deferSecurityNegotiation) :
264     AsyncSocket(evb),
265     ctx_(ctx),
266     handshakeTimeout_(this, evb) {
267   init();
268   if (deferSecurityNegotiation) {
269     sslState_ = STATE_UNENCRYPTED;
270   }
271 }
272
273 /**
274  * Create a server/client AsyncSSLSocket
275  */
276 AsyncSSLSocket::AsyncSSLSocket(const shared_ptr<SSLContext>& ctx,
277                                EventBase* evb, int fd, bool server,
278                                bool deferSecurityNegotiation) :
279     AsyncSocket(evb, fd),
280     server_(server),
281     ctx_(ctx),
282     handshakeTimeout_(this, evb) {
283   init();
284   if (server) {
285     SSL_CTX_set_info_callback(ctx_->getSSLCtx(),
286                               AsyncSSLSocket::sslInfoCallback);
287   }
288   if (deferSecurityNegotiation) {
289     sslState_ = STATE_UNENCRYPTED;
290   }
291 }
292
293 #if OPENSSL_VERSION_NUMBER >= 0x1000105fL && !defined(OPENSSL_NO_TLSEXT)
294 /**
295  * Create a client AsyncSSLSocket and allow tlsext_hostname
296  * to be sent in Client Hello.
297  */
298 AsyncSSLSocket::AsyncSSLSocket(const shared_ptr<SSLContext> &ctx,
299                                  EventBase* evb,
300                                const std::string& serverName,
301                                bool deferSecurityNegotiation) :
302     AsyncSSLSocket(ctx, evb, deferSecurityNegotiation) {
303   tlsextHostname_ = serverName;
304 }
305
306 /**
307  * Create a client AsyncSSLSocket from an already connected fd
308  * and allow tlsext_hostname to be sent in Client Hello.
309  */
310 AsyncSSLSocket::AsyncSSLSocket(const shared_ptr<SSLContext>& ctx,
311                                  EventBase* evb, int fd,
312                                const std::string& serverName,
313                                bool deferSecurityNegotiation) :
314     AsyncSSLSocket(ctx, evb, fd, false, deferSecurityNegotiation) {
315   tlsextHostname_ = serverName;
316 }
317 #endif
318
319 AsyncSSLSocket::~AsyncSSLSocket() {
320   VLOG(3) << "actual destruction of AsyncSSLSocket(this=" << this
321           << ", evb=" << eventBase_ << ", fd=" << fd_
322           << ", state=" << int(state_) << ", sslState="
323           << sslState_ << ", events=" << eventFlags_ << ")";
324 }
325
326 void AsyncSSLSocket::init() {
327   // Do this here to ensure we initialize this once before any use of
328   // AsyncSSLSocket instances and not as part of library load.
329   static const auto eorAwareBioMethodInitializer = initEorBioMethod();
330   (void)eorAwareBioMethodInitializer;
331
332   setup_SSL_CTX(ctx_->getSSLCtx());
333 }
334
335 void AsyncSSLSocket::closeNow() {
336   // Close the SSL connection.
337   if (ssl_ != nullptr && fd_ != -1) {
338     int rc = SSL_shutdown(ssl_);
339     if (rc == 0) {
340       rc = SSL_shutdown(ssl_);
341     }
342     if (rc < 0) {
343       ERR_clear_error();
344     }
345   }
346
347   if (sslSession_ != nullptr) {
348     SSL_SESSION_free(sslSession_);
349     sslSession_ = nullptr;
350   }
351
352   sslState_ = STATE_CLOSED;
353
354   if (handshakeTimeout_.isScheduled()) {
355     handshakeTimeout_.cancelTimeout();
356   }
357
358   DestructorGuard dg(this);
359
360   invokeHandshakeErr(
361       AsyncSocketException(
362         AsyncSocketException::END_OF_FILE,
363         "SSL connection closed locally"));
364
365   if (ssl_ != nullptr) {
366     SSL_free(ssl_);
367     ssl_ = nullptr;
368   }
369
370   // Close the socket.
371   AsyncSocket::closeNow();
372 }
373
374 void AsyncSSLSocket::shutdownWrite() {
375   // SSL sockets do not support half-shutdown, so just perform a full shutdown.
376   //
377   // (Performing a full shutdown here is more desirable than doing nothing at
378   // all.  The purpose of shutdownWrite() is normally to notify the other end
379   // of the connection that no more data will be sent.  If we do nothing, the
380   // other end will never know that no more data is coming, and this may result
381   // in protocol deadlock.)
382   close();
383 }
384
385 void AsyncSSLSocket::shutdownWriteNow() {
386   closeNow();
387 }
388
389 bool AsyncSSLSocket::good() const {
390   return (AsyncSocket::good() &&
391           (sslState_ == STATE_ACCEPTING || sslState_ == STATE_CONNECTING ||
392            sslState_ == STATE_ESTABLISHED || sslState_ == STATE_UNENCRYPTED));
393 }
394
395 // The TAsyncTransport definition of 'good' states that the transport is
396 // ready to perform reads and writes, so sslState_ == UNINIT must report !good.
397 // connecting can be true when the sslState_ == UNINIT because the AsyncSocket
398 // is connected but we haven't initiated the call to SSL_connect.
399 bool AsyncSSLSocket::connecting() const {
400   return (!server_ &&
401           (AsyncSocket::connecting() ||
402            (AsyncSocket::good() && (sslState_ == STATE_UNINIT ||
403                                      sslState_ == STATE_CONNECTING))));
404 }
405
406 std::string AsyncSSLSocket::getApplicationProtocol() noexcept {
407   const unsigned char* protoName = nullptr;
408   unsigned protoLength;
409   if (getSelectedNextProtocolNoThrow(&protoName, &protoLength)) {
410     return std::string(reinterpret_cast<const char*>(protoName), protoLength);
411   }
412   return "";
413 }
414
415 bool AsyncSSLSocket::isEorTrackingEnabled() const {
416   if (ssl_ == nullptr) {
417     return false;
418   }
419   const BIO *wb = SSL_get_wbio(ssl_);
420   return wb && wb->method == &eorAwareBioMethod;
421 }
422
423 void AsyncSSLSocket::setEorTracking(bool track) {
424   BIO *wb = SSL_get_wbio(ssl_);
425   if (!wb) {
426     throw AsyncSocketException(AsyncSocketException::INVALID_STATE,
427                               "setting EOR tracking without an initialized "
428                               "BIO");
429   }
430
431   if (track) {
432     if (wb->method != &eorAwareBioMethod) {
433       // only do this if we didn't
434       wb->method = &eorAwareBioMethod;
435       BIO_set_app_data(wb, this);
436       appEorByteNo_ = 0;
437       minEorRawByteNo_ = 0;
438     }
439   } else if (wb->method == &eorAwareBioMethod) {
440     wb->method = BIO_s_socket();
441     BIO_set_app_data(wb, nullptr);
442     appEorByteNo_ = 0;
443     minEorRawByteNo_ = 0;
444   } else {
445     CHECK(wb->method == BIO_s_socket());
446   }
447 }
448
449 size_t AsyncSSLSocket::getRawBytesWritten() const {
450   BIO *b;
451   if (!ssl_ || !(b = SSL_get_wbio(ssl_))) {
452     return 0;
453   }
454
455   return BIO_number_written(b);
456 }
457
458 size_t AsyncSSLSocket::getRawBytesReceived() const {
459   BIO *b;
460   if (!ssl_ || !(b = SSL_get_rbio(ssl_))) {
461     return 0;
462   }
463
464   return BIO_number_read(b);
465 }
466
467
468 void AsyncSSLSocket::invalidState(HandshakeCB* callback) {
469   LOG(ERROR) << "AsyncSSLSocket(this=" << this << ", fd=" << fd_
470              << ", state=" << int(state_) << ", sslState=" << sslState_ << ", "
471              << "events=" << eventFlags_ << ", server=" << short(server_) << "): "
472              << "sslAccept/Connect() called in invalid "
473              << "state, handshake callback " << handshakeCallback_ << ", new callback "
474              << callback;
475   assert(!handshakeTimeout_.isScheduled());
476   sslState_ = STATE_ERROR;
477
478   AsyncSocketException ex(AsyncSocketException::INVALID_STATE,
479                          "sslAccept() called with socket in invalid state");
480
481   handshakeEndTime_ = std::chrono::steady_clock::now();
482   if (callback) {
483     callback->handshakeErr(this, ex);
484   }
485
486   // Check the socket state not the ssl state here.
487   if (state_ != StateEnum::CLOSED || state_ != StateEnum::ERROR) {
488     failHandshake(__func__, ex);
489   }
490 }
491
492 void AsyncSSLSocket::sslAccept(HandshakeCB* callback, uint32_t timeout,
493       const SSLContext::SSLVerifyPeerEnum& verifyPeer) {
494   DestructorGuard dg(this);
495   assert(eventBase_->isInEventBaseThread());
496   verifyPeer_ = verifyPeer;
497
498   // Make sure we're in the uninitialized state
499   if (!server_ || (sslState_ != STATE_UNINIT &&
500                    sslState_ != STATE_UNENCRYPTED) ||
501       handshakeCallback_ != nullptr) {
502     return invalidState(callback);
503   }
504
505   // Cache local and remote socket addresses to keep them available
506   // after socket file descriptor is closed.
507   if (cacheAddrOnFailure_ && -1 != getFd()) {
508     cacheLocalPeerAddr();
509   }
510
511   handshakeStartTime_ = std::chrono::steady_clock::now();
512   // Make end time at least >= start time.
513   handshakeEndTime_ = handshakeStartTime_;
514
515   sslState_ = STATE_ACCEPTING;
516   handshakeCallback_ = callback;
517
518   if (timeout > 0) {
519     handshakeTimeout_.scheduleTimeout(timeout);
520   }
521
522   /* register for a read operation (waiting for CLIENT HELLO) */
523   updateEventRegistration(EventHandler::READ, EventHandler::WRITE);
524 }
525
526 #if OPENSSL_VERSION_NUMBER >= 0x009080bfL
527 void AsyncSSLSocket::attachSSLContext(
528   const std::shared_ptr<SSLContext>& ctx) {
529
530   // Check to ensure we are in client mode. Changing a server's ssl
531   // context doesn't make sense since clients of that server would likely
532   // become confused when the server's context changes.
533   DCHECK(!server_);
534   DCHECK(!ctx_);
535   DCHECK(ctx);
536   DCHECK(ctx->getSSLCtx());
537   ctx_ = ctx;
538
539   // In order to call attachSSLContext, detachSSLContext must have been
540   // previously called which sets the socket's context to the dummy
541   // context. Thus we must acquire this lock.
542   SpinLockGuard guard(dummyCtxLock);
543   SSL_set_SSL_CTX(ssl_, ctx->getSSLCtx());
544 }
545
546 void AsyncSSLSocket::detachSSLContext() {
547   DCHECK(ctx_);
548   ctx_.reset();
549   // We aren't using the initial_ctx for now, and it can introduce race
550   // conditions in the destructor of the SSL object.
551 #ifndef OPENSSL_NO_TLSEXT
552   if (ssl_->initial_ctx) {
553     SSL_CTX_free(ssl_->initial_ctx);
554     ssl_->initial_ctx = nullptr;
555   }
556 #endif
557   SpinLockGuard guard(dummyCtxLock);
558   if (nullptr == dummyCtx) {
559     // We need to lazily initialize the dummy context so we don't
560     // accidentally override any programmatic settings to openssl
561     dummyCtx = new SSLContext;
562   }
563   // We must remove this socket's references to its context right now
564   // since this socket could get passed to any thread. If the context has
565   // had its locking disabled, just doing a set in attachSSLContext()
566   // would not be thread safe.
567   SSL_set_SSL_CTX(ssl_, dummyCtx->getSSLCtx());
568 }
569 #endif
570
571 #if OPENSSL_VERSION_NUMBER >= 0x1000105fL && !defined(OPENSSL_NO_TLSEXT)
572 void AsyncSSLSocket::switchServerSSLContext(
573   const std::shared_ptr<SSLContext>& handshakeCtx) {
574   CHECK(server_);
575   if (sslState_ != STATE_ACCEPTING) {
576     // We log it here and allow the switch.
577     // It should not affect our re-negotiation support (which
578     // is not supported now).
579     VLOG(6) << "fd=" << getFd()
580             << " renegotation detected when switching SSL_CTX";
581   }
582
583   setup_SSL_CTX(handshakeCtx->getSSLCtx());
584   SSL_CTX_set_info_callback(handshakeCtx->getSSLCtx(),
585                             AsyncSSLSocket::sslInfoCallback);
586   handshakeCtx_ = handshakeCtx;
587   SSL_set_SSL_CTX(ssl_, handshakeCtx->getSSLCtx());
588 }
589
590 bool AsyncSSLSocket::isServerNameMatch() const {
591   CHECK(!server_);
592
593   if (!ssl_) {
594     return false;
595   }
596
597   SSL_SESSION *ss = SSL_get_session(ssl_);
598   if (!ss) {
599     return false;
600   }
601
602   if(!ss->tlsext_hostname) {
603     return false;
604   }
605   return (tlsextHostname_.compare(ss->tlsext_hostname) ? false : true);
606 }
607
608 void AsyncSSLSocket::setServerName(std::string serverName) noexcept {
609   tlsextHostname_ = std::move(serverName);
610 }
611
612 #endif
613
614 void AsyncSSLSocket::timeoutExpired() noexcept {
615   if (state_ == StateEnum::ESTABLISHED &&
616       (sslState_ == STATE_CACHE_LOOKUP ||
617        sslState_ == STATE_RSA_ASYNC_PENDING)) {
618     sslState_ = STATE_ERROR;
619     // We are expecting a callback in restartSSLAccept.  The cache lookup
620     // and rsa-call necessarily have pointers to this ssl socket, so delay
621     // the cleanup until he calls us back.
622   } else {
623     assert(state_ == StateEnum::ESTABLISHED &&
624            (sslState_ == STATE_CONNECTING || sslState_ == STATE_ACCEPTING));
625     DestructorGuard dg(this);
626     AsyncSocketException ex(AsyncSocketException::TIMED_OUT,
627                            (sslState_ == STATE_CONNECTING) ?
628                            "SSL connect timed out" : "SSL accept timed out");
629     failHandshake(__func__, ex);
630   }
631 }
632
633 int AsyncSSLSocket::getSSLExDataIndex() {
634   static auto index = SSL_get_ex_new_index(
635       0, (void*)"AsyncSSLSocket data index", nullptr, nullptr, nullptr);
636   return index;
637 }
638
639 AsyncSSLSocket* AsyncSSLSocket::getFromSSL(const SSL *ssl) {
640   return static_cast<AsyncSSLSocket *>(SSL_get_ex_data(ssl,
641       getSSLExDataIndex()));
642 }
643
644 void AsyncSSLSocket::failHandshake(const char* /* fn */,
645                                    const AsyncSocketException& ex) {
646   startFail();
647   if (handshakeTimeout_.isScheduled()) {
648     handshakeTimeout_.cancelTimeout();
649   }
650   invokeHandshakeErr(ex);
651   finishFail();
652 }
653
654 void AsyncSSLSocket::invokeHandshakeErr(const AsyncSocketException& ex) {
655   handshakeEndTime_ = std::chrono::steady_clock::now();
656   if (handshakeCallback_ != nullptr) {
657     HandshakeCB* callback = handshakeCallback_;
658     handshakeCallback_ = nullptr;
659     callback->handshakeErr(this, ex);
660   }
661 }
662
663 void AsyncSSLSocket::invokeHandshakeCB() {
664   handshakeEndTime_ = std::chrono::steady_clock::now();
665   if (handshakeTimeout_.isScheduled()) {
666     handshakeTimeout_.cancelTimeout();
667   }
668   if (handshakeCallback_) {
669     HandshakeCB* callback = handshakeCallback_;
670     handshakeCallback_ = nullptr;
671     callback->handshakeSuc(this);
672   }
673 }
674
675 void AsyncSSLSocket::cacheLocalPeerAddr() {
676   SocketAddress address;
677   try {
678     getLocalAddress(&address);
679     getPeerAddress(&address);
680   } catch (const std::system_error& e) {
681     // The handle can be still valid while the connection is already closed.
682     if (e.code() != std::error_code(ENOTCONN, std::system_category())) {
683       throw;
684     }
685   }
686 }
687
688 void AsyncSSLSocket::connect(ConnectCallback* callback,
689                               const folly::SocketAddress& address,
690                               int timeout,
691                               const OptionMap &options,
692                               const folly::SocketAddress& bindAddr)
693                               noexcept {
694   assert(!server_);
695   assert(state_ == StateEnum::UNINIT);
696   assert(sslState_ == STATE_UNINIT);
697   AsyncSSLSocketConnector *connector =
698     new AsyncSSLSocketConnector(this, callback, timeout);
699   AsyncSocket::connect(connector, address, timeout, options, bindAddr);
700 }
701
702 void AsyncSSLSocket::applyVerificationOptions(SSL * ssl) {
703   // apply the settings specified in verifyPeer_
704   if (verifyPeer_ == SSLContext::SSLVerifyPeerEnum::USE_CTX) {
705     if(ctx_->needsPeerVerification()) {
706       SSL_set_verify(ssl, ctx_->getVerificationMode(),
707         AsyncSSLSocket::sslVerifyCallback);
708     }
709   } else {
710     if (verifyPeer_ == SSLContext::SSLVerifyPeerEnum::VERIFY ||
711         verifyPeer_ == SSLContext::SSLVerifyPeerEnum::VERIFY_REQ_CLIENT_CERT) {
712       SSL_set_verify(ssl, SSLContext::getVerificationMode(verifyPeer_),
713         AsyncSSLSocket::sslVerifyCallback);
714     }
715   }
716 }
717
718 void AsyncSSLSocket::sslConn(HandshakeCB* callback, uint64_t timeout,
719         const SSLContext::SSLVerifyPeerEnum& verifyPeer) {
720   DestructorGuard dg(this);
721   assert(eventBase_->isInEventBaseThread());
722
723   // Cache local and remote socket addresses to keep them available
724   // after socket file descriptor is closed.
725   if (cacheAddrOnFailure_ && -1 != getFd()) {
726     cacheLocalPeerAddr();
727   }
728
729   verifyPeer_ = verifyPeer;
730
731   // Make sure we're in the uninitialized state
732   if (server_ || (sslState_ != STATE_UNINIT && sslState_ !=
733                   STATE_UNENCRYPTED) ||
734       handshakeCallback_ != nullptr) {
735     return invalidState(callback);
736   }
737
738   handshakeStartTime_ = std::chrono::steady_clock::now();
739   // Make end time at least >= start time.
740   handshakeEndTime_ = handshakeStartTime_;
741
742   sslState_ = STATE_CONNECTING;
743   handshakeCallback_ = callback;
744
745   try {
746     ssl_ = ctx_->createSSL();
747   } catch (std::exception &e) {
748     sslState_ = STATE_ERROR;
749     AsyncSocketException ex(AsyncSocketException::INTERNAL_ERROR,
750                            "error calling SSLContext::createSSL()");
751     LOG(ERROR) << "AsyncSSLSocket::sslConn(this=" << this << ", fd="
752             << fd_ << "): " << e.what();
753     return failHandshake(__func__, ex);
754   }
755
756   applyVerificationOptions(ssl_);
757
758   SSL_set_fd(ssl_, fd_);
759   if (sslSession_ != nullptr) {
760     SSL_set_session(ssl_, sslSession_);
761     SSL_SESSION_free(sslSession_);
762     sslSession_ = nullptr;
763   }
764 #if OPENSSL_VERSION_NUMBER >= 0x1000105fL && !defined(OPENSSL_NO_TLSEXT)
765   if (tlsextHostname_.size()) {
766     SSL_set_tlsext_host_name(ssl_, tlsextHostname_.c_str());
767   }
768 #endif
769
770   SSL_set_ex_data(ssl_, getSSLExDataIndex(), this);
771
772   if (timeout > 0) {
773     handshakeTimeout_.scheduleTimeout(timeout);
774   }
775
776   handleConnect();
777 }
778
779 SSL_SESSION *AsyncSSLSocket::getSSLSession() {
780   if (ssl_ != nullptr && sslState_ == STATE_ESTABLISHED) {
781     return SSL_get1_session(ssl_);
782   }
783
784   return sslSession_;
785 }
786
787 void AsyncSSLSocket::setSSLSession(SSL_SESSION *session, bool takeOwnership) {
788   sslSession_ = session;
789   if (!takeOwnership && session != nullptr) {
790     // Increment the reference count
791     CRYPTO_add(&session->references, 1, CRYPTO_LOCK_SSL_SESSION);
792   }
793 }
794
795 void AsyncSSLSocket::getSelectedNextProtocol(
796     const unsigned char** protoName,
797     unsigned* protoLen,
798     SSLContext::NextProtocolType* protoType) const {
799   if (!getSelectedNextProtocolNoThrow(protoName, protoLen, protoType)) {
800     throw AsyncSocketException(AsyncSocketException::NOT_SUPPORTED,
801                               "NPN not supported");
802   }
803 }
804
805 bool AsyncSSLSocket::getSelectedNextProtocolNoThrow(
806     const unsigned char** protoName,
807     unsigned* protoLen,
808     SSLContext::NextProtocolType* protoType) const {
809   *protoName = nullptr;
810   *protoLen = 0;
811 #if OPENSSL_VERSION_NUMBER >= 0x1000200fL && !defined(OPENSSL_NO_TLSEXT)
812   SSL_get0_alpn_selected(ssl_, protoName, protoLen);
813   if (*protoLen > 0) {
814     if (protoType) {
815       *protoType = SSLContext::NextProtocolType::ALPN;
816     }
817     return true;
818   }
819 #endif
820 #ifdef OPENSSL_NPN_NEGOTIATED
821   SSL_get0_next_proto_negotiated(ssl_, protoName, protoLen);
822   if (protoType) {
823     *protoType = SSLContext::NextProtocolType::NPN;
824   }
825   return true;
826 #else
827   return false;
828 #endif
829 }
830
831 bool AsyncSSLSocket::getSSLSessionReused() const {
832   if (ssl_ != nullptr && sslState_ == STATE_ESTABLISHED) {
833     return SSL_session_reused(ssl_);
834   }
835   return false;
836 }
837
838 const char *AsyncSSLSocket::getNegotiatedCipherName() const {
839   return (ssl_ != nullptr) ? SSL_get_cipher_name(ssl_) : nullptr;
840 }
841
842 const char *AsyncSSLSocket::getSSLServerName() const {
843 #ifdef SSL_CTRL_SET_TLSEXT_SERVERNAME_CB
844   return (ssl_ != nullptr) ? SSL_get_servername(ssl_, TLSEXT_NAMETYPE_host_name)
845         : nullptr;
846 #else
847   throw AsyncSocketException(AsyncSocketException::NOT_SUPPORTED,
848                             "SNI not supported");
849 #endif
850 }
851
852 const char *AsyncSSLSocket::getSSLServerNameNoThrow() const {
853   try {
854     return getSSLServerName();
855   } catch (AsyncSocketException& ex) {
856     return nullptr;
857   }
858 }
859
860 int AsyncSSLSocket::getSSLVersion() const {
861   return (ssl_ != nullptr) ? SSL_version(ssl_) : 0;
862 }
863
864 const char *AsyncSSLSocket::getSSLCertSigAlgName() const {
865   X509 *cert = (ssl_ != nullptr) ? SSL_get_certificate(ssl_) : nullptr;
866   if (cert) {
867     int nid = OBJ_obj2nid(cert->sig_alg->algorithm);
868     return OBJ_nid2ln(nid);
869   }
870   return nullptr;
871 }
872
873 int AsyncSSLSocket::getSSLCertSize() const {
874   int certSize = 0;
875   X509 *cert = (ssl_ != nullptr) ? SSL_get_certificate(ssl_) : nullptr;
876   if (cert) {
877     EVP_PKEY *key = X509_get_pubkey(cert);
878     certSize = EVP_PKEY_bits(key);
879     EVP_PKEY_free(key);
880   }
881   return certSize;
882 }
883
884 bool AsyncSSLSocket::willBlock(int ret, int *errorOut) noexcept {
885   int error = *errorOut = SSL_get_error(ssl_, ret);
886   if (error == SSL_ERROR_WANT_READ) {
887     // Register for read event if not already.
888     updateEventRegistration(EventHandler::READ, EventHandler::WRITE);
889     return true;
890   } else if (error == SSL_ERROR_WANT_WRITE) {
891     VLOG(3) << "AsyncSSLSocket(fd=" << fd_
892             << ", state=" << int(state_) << ", sslState="
893             << sslState_ << ", events=" << eventFlags_ << "): "
894             << "SSL_ERROR_WANT_WRITE";
895     // Register for write event if not already.
896     updateEventRegistration(EventHandler::WRITE, EventHandler::READ);
897     return true;
898 #ifdef SSL_ERROR_WANT_SESS_CACHE_LOOKUP
899   } else if (error == SSL_ERROR_WANT_SESS_CACHE_LOOKUP) {
900     // We will block but we can't register our own socket.  The callback that
901     // triggered this code will re-call handleAccept at the appropriate time.
902
903     // We can only get here if the linked libssl.so has support for this feature
904     // as well, otherwise SSL_get_error cannot return our error code.
905     sslState_ = STATE_CACHE_LOOKUP;
906
907     // Unregister for all events while blocked here
908     updateEventRegistration(EventHandler::NONE,
909                             EventHandler::READ | EventHandler::WRITE);
910
911     // The timeout (if set) keeps running here
912     return true;
913 #endif
914 #ifdef SSL_ERROR_WANT_RSA_ASYNC_PENDING
915   } else if (error == SSL_ERROR_WANT_RSA_ASYNC_PENDING) {
916     // Our custom openssl function has kicked off an async request to do
917     // modular exponentiation.  When that call returns, a callback will
918     // be invoked that will re-call handleAccept.
919     sslState_ = STATE_RSA_ASYNC_PENDING;
920
921     // Unregister for all events while blocked here
922     updateEventRegistration(
923       EventHandler::NONE,
924       EventHandler::READ | EventHandler::WRITE
925     );
926
927     // The timeout (if set) keeps running here
928     return true;
929 #endif
930   } else {
931     // SSL_ERROR_ZERO_RETURN is processed here so we can get some detail
932     // in the log
933     long lastError = ERR_get_error();
934     VLOG(6) << "AsyncSSLSocket(fd=" << fd_ << ", "
935             << "state=" << state_ << ", "
936             << "sslState=" << sslState_ << ", "
937             << "events=" << std::hex << eventFlags_ << "): "
938             << "SSL error: " << error << ", "
939             << "errno: " << errno << ", "
940             << "ret: " << ret << ", "
941             << "read: " << BIO_number_read(SSL_get_rbio(ssl_)) << ", "
942             << "written: " << BIO_number_written(SSL_get_wbio(ssl_)) << ", "
943             << "func: " << ERR_func_error_string(lastError) << ", "
944             << "reason: " << ERR_reason_error_string(lastError);
945     if (error != SSL_ERROR_SYSCALL) {
946       if (error == SSL_ERROR_SSL) {
947         *errorOut = lastError;
948       }
949       if ((unsigned long)lastError < 0x8000) {
950         errno = ENOSYS;
951       } else {
952         errno = lastError;
953       }
954     }
955     ERR_clear_error();
956     return false;
957   }
958 }
959
960 void AsyncSSLSocket::checkForImmediateRead() noexcept {
961   // openssl may have buffered data that it read from the socket already.
962   // In this case we have to process it immediately, rather than waiting for
963   // the socket to become readable again.
964   if (ssl_ != nullptr && SSL_pending(ssl_) > 0) {
965     AsyncSocket::handleRead();
966   }
967 }
968
969 void
970 AsyncSSLSocket::restartSSLAccept()
971 {
972   VLOG(3) << "AsyncSSLSocket::restartSSLAccept() this=" << this << ", fd=" << fd_
973           << ", state=" << int(state_) << ", "
974           << "sslState=" << sslState_ << ", events=" << eventFlags_;
975   DestructorGuard dg(this);
976   assert(
977     sslState_ == STATE_CACHE_LOOKUP ||
978     sslState_ == STATE_RSA_ASYNC_PENDING ||
979     sslState_ == STATE_ERROR ||
980     sslState_ == STATE_CLOSED
981   );
982   if (sslState_ == STATE_CLOSED) {
983     // I sure hope whoever closed this socket didn't delete it already,
984     // but this is not strictly speaking an error
985     return;
986   }
987   if (sslState_ == STATE_ERROR) {
988     // go straight to fail if timeout expired during lookup
989     AsyncSocketException ex(AsyncSocketException::TIMED_OUT,
990                            "SSL accept timed out");
991     failHandshake(__func__, ex);
992     return;
993   }
994   sslState_ = STATE_ACCEPTING;
995   this->handleAccept();
996 }
997
998 void
999 AsyncSSLSocket::handleAccept() noexcept {
1000   VLOG(3) << "AsyncSSLSocket::handleAccept() this=" << this
1001           << ", fd=" << fd_ << ", state=" << int(state_) << ", "
1002           << "sslState=" << sslState_ << ", events=" << eventFlags_;
1003   assert(server_);
1004   assert(state_ == StateEnum::ESTABLISHED &&
1005          sslState_ == STATE_ACCEPTING);
1006   if (!ssl_) {
1007     /* lazily create the SSL structure */
1008     try {
1009       ssl_ = ctx_->createSSL();
1010     } catch (std::exception &e) {
1011       sslState_ = STATE_ERROR;
1012       AsyncSocketException ex(AsyncSocketException::INTERNAL_ERROR,
1013                              "error calling SSLContext::createSSL()");
1014       LOG(ERROR) << "AsyncSSLSocket::handleAccept(this=" << this
1015                  << ", fd=" << fd_ << "): " << e.what();
1016       return failHandshake(__func__, ex);
1017     }
1018     SSL_set_fd(ssl_, fd_);
1019     SSL_set_ex_data(ssl_, getSSLExDataIndex(), this);
1020
1021     applyVerificationOptions(ssl_);
1022   }
1023
1024   if (server_ && parseClientHello_) {
1025     SSL_set_msg_callback(ssl_, &AsyncSSLSocket::clientHelloParsingCallback);
1026     SSL_set_msg_callback_arg(ssl_, this);
1027   }
1028
1029   errno = 0;
1030   int ret = SSL_accept(ssl_);
1031   if (ret <= 0) {
1032     int error;
1033     if (willBlock(ret, &error)) {
1034       return;
1035     } else {
1036       sslState_ = STATE_ERROR;
1037       SSLException ex(error, errno);
1038       return failHandshake(__func__, ex);
1039     }
1040   }
1041
1042   handshakeComplete_ = true;
1043   updateEventRegistration(0, EventHandler::READ | EventHandler::WRITE);
1044
1045   // Move into STATE_ESTABLISHED in the normal case that we are in
1046   // STATE_ACCEPTING.
1047   sslState_ = STATE_ESTABLISHED;
1048
1049   VLOG(3) << "AsyncSSLSocket " << this << ": fd " << fd_
1050           << " successfully accepted; state=" << int(state_)
1051           << ", sslState=" << sslState_ << ", events=" << eventFlags_;
1052
1053   // Remember the EventBase we are attached to, before we start invoking any
1054   // callbacks (since the callbacks may call detachEventBase()).
1055   EventBase* originalEventBase = eventBase_;
1056
1057   // Call the accept callback.
1058   invokeHandshakeCB();
1059
1060   // Note that the accept callback may have changed our state.
1061   // (set or unset the read callback, called write(), closed the socket, etc.)
1062   // The following code needs to handle these situations correctly.
1063   //
1064   // If the socket has been closed, readCallback_ and writeReqHead_ will
1065   // always be nullptr, so that will prevent us from trying to read or write.
1066   //
1067   // The main thing to check for is if eventBase_ is still originalEventBase.
1068   // If not, we have been detached from this event base, so we shouldn't
1069   // perform any more operations.
1070   if (eventBase_ != originalEventBase) {
1071     return;
1072   }
1073
1074   AsyncSocket::handleInitialReadWrite();
1075 }
1076
1077 void
1078 AsyncSSLSocket::handleConnect() noexcept {
1079   VLOG(3) <<  "AsyncSSLSocket::handleConnect() this=" << this
1080           << ", fd=" << fd_ << ", state=" << int(state_) << ", "
1081           << "sslState=" << sslState_ << ", events=" << eventFlags_;
1082   assert(!server_);
1083   if (state_ < StateEnum::ESTABLISHED) {
1084     return AsyncSocket::handleConnect();
1085   }
1086
1087   assert(state_ == StateEnum::ESTABLISHED &&
1088          sslState_ == STATE_CONNECTING);
1089   assert(ssl_);
1090
1091   errno = 0;
1092   int ret = SSL_connect(ssl_);
1093   if (ret <= 0) {
1094     int error;
1095     if (willBlock(ret, &error)) {
1096       return;
1097     } else {
1098       sslState_ = STATE_ERROR;
1099       SSLException ex(error, errno);
1100       return failHandshake(__func__, ex);
1101     }
1102   }
1103
1104   handshakeComplete_ = true;
1105   updateEventRegistration(0, EventHandler::READ | EventHandler::WRITE);
1106
1107   // Move into STATE_ESTABLISHED in the normal case that we are in
1108   // STATE_CONNECTING.
1109   sslState_ = STATE_ESTABLISHED;
1110
1111   VLOG(3) << "AsyncSSLSocket %p: fd %d successfully connected; "
1112           << "state=" << int(state_) << ", sslState=" << sslState_
1113           << ", events=" << eventFlags_;
1114
1115   // Remember the EventBase we are attached to, before we start invoking any
1116   // callbacks (since the callbacks may call detachEventBase()).
1117   EventBase* originalEventBase = eventBase_;
1118
1119   // Call the handshake callback.
1120   invokeHandshakeCB();
1121
1122   // Note that the connect callback may have changed our state.
1123   // (set or unset the read callback, called write(), closed the socket, etc.)
1124   // The following code needs to handle these situations correctly.
1125   //
1126   // If the socket has been closed, readCallback_ and writeReqHead_ will
1127   // always be nullptr, so that will prevent us from trying to read or write.
1128   //
1129   // The main thing to check for is if eventBase_ is still originalEventBase.
1130   // If not, we have been detached from this event base, so we shouldn't
1131   // perform any more operations.
1132   if (eventBase_ != originalEventBase) {
1133     return;
1134   }
1135
1136   AsyncSocket::handleInitialReadWrite();
1137 }
1138
1139 void AsyncSSLSocket::setReadCB(ReadCallback *callback) {
1140 #ifdef SSL_MODE_MOVE_BUFFER_OWNERSHIP
1141   // turn on the buffer movable in openssl
1142   if (ssl_ != nullptr && !isBufferMovable_ &&
1143       callback != nullptr && callback->isBufferMovable()) {
1144     SSL_set_mode(ssl_, SSL_get_mode(ssl_) | SSL_MODE_MOVE_BUFFER_OWNERSHIP);
1145     isBufferMovable_ = true;
1146   }
1147 #endif
1148
1149   AsyncSocket::setReadCB(callback);
1150 }
1151
1152 void AsyncSSLSocket::prepareReadBuffer(void** buf, size_t* buflen) noexcept {
1153   CHECK(readCallback_);
1154   if (isBufferMovable_) {
1155     *buf = nullptr;
1156     *buflen = 0;
1157   } else {
1158     // buf is necessary for SSLSocket without SSL_MODE_MOVE_BUFFER_OWNERSHIP
1159     readCallback_->getReadBuffer(buf, buflen);
1160   }
1161 }
1162
1163 void
1164 AsyncSSLSocket::handleRead() noexcept {
1165   VLOG(5) << "AsyncSSLSocket::handleRead() this=" << this << ", fd=" << fd_
1166           << ", state=" << int(state_) << ", "
1167           << "sslState=" << sslState_ << ", events=" << eventFlags_;
1168   if (state_ < StateEnum::ESTABLISHED) {
1169     return AsyncSocket::handleRead();
1170   }
1171
1172
1173   if (sslState_ == STATE_ACCEPTING) {
1174     assert(server_);
1175     handleAccept();
1176     return;
1177   }
1178   else if (sslState_ == STATE_CONNECTING) {
1179     assert(!server_);
1180     handleConnect();
1181     return;
1182   }
1183
1184   // Normal read
1185   AsyncSocket::handleRead();
1186 }
1187
1188 ssize_t
1189 AsyncSSLSocket::performRead(void** buf, size_t* buflen, size_t* offset) {
1190   VLOG(4) << "AsyncSSLSocket::performRead() this=" << this
1191           << ", buf=" << *buf << ", buflen=" << *buflen;
1192
1193   if (sslState_ == STATE_UNENCRYPTED) {
1194     return AsyncSocket::performRead(buf, buflen, offset);
1195   }
1196
1197   errno = 0;
1198   ssize_t bytes = 0;
1199   if (!isBufferMovable_) {
1200     bytes = SSL_read(ssl_, *buf, *buflen);
1201   }
1202 #ifdef SSL_MODE_MOVE_BUFFER_OWNERSHIP
1203   else {
1204     bytes = SSL_read_buf(ssl_, buf, (int *) offset, (int *) buflen);
1205   }
1206 #endif
1207
1208   if (server_ && renegotiateAttempted_) {
1209     LOG(ERROR) << "AsyncSSLSocket(fd=" << fd_ << ", state=" << int(state_)
1210                << ", sslstate=" << sslState_ << ", events=" << eventFlags_
1211                << "): client intitiated SSL renegotiation not permitted";
1212     // We pack our own SSLerr here with a dummy function
1213     errno = ERR_PACK(ERR_LIB_USER, TASYNCSSLSOCKET_F_PERFORM_READ,
1214                      SSL_CLIENT_RENEGOTIATION_ATTEMPT);
1215     ERR_clear_error();
1216     return READ_ERROR;
1217   }
1218   if (bytes <= 0) {
1219     int error = SSL_get_error(ssl_, bytes);
1220     if (error == SSL_ERROR_WANT_READ) {
1221       // The caller will register for read event if not already.
1222       if (errno == EWOULDBLOCK || errno == EAGAIN) {
1223         return READ_BLOCKING;
1224       } else {
1225         return READ_ERROR;
1226       }
1227     } else if (error == SSL_ERROR_WANT_WRITE) {
1228       // TODO: Even though we are attempting to read data, SSL_read() may
1229       // need to write data if renegotiation is being performed.  We currently
1230       // don't support this and just fail the read.
1231       LOG(ERROR) << "AsyncSSLSocket(fd=" << fd_ << ", state=" << int(state_)
1232                  << ", sslState=" << sslState_ << ", events=" << eventFlags_
1233                  << "): unsupported SSL renegotiation during read",
1234       errno = ERR_PACK(ERR_LIB_USER, TASYNCSSLSOCKET_F_PERFORM_READ,
1235                        SSL_INVALID_RENEGOTIATION);
1236       ERR_clear_error();
1237       return READ_ERROR;
1238     } else {
1239       // TODO: Fix this code so that it can return a proper error message
1240       // to the callback, rather than relying on AsyncSocket code which
1241       // can't handle SSL errors.
1242       long lastError = ERR_get_error();
1243
1244       VLOG(6) << "AsyncSSLSocket(fd=" << fd_ << ", "
1245               << "state=" << state_ << ", "
1246               << "sslState=" << sslState_ << ", "
1247               << "events=" << std::hex << eventFlags_ << "): "
1248               << "bytes: " << bytes << ", "
1249               << "error: " << error << ", "
1250               << "errno: " << errno << ", "
1251               << "func: " << ERR_func_error_string(lastError) << ", "
1252               << "reason: " << ERR_reason_error_string(lastError);
1253       ERR_clear_error();
1254       if (zero_return(error, bytes)) {
1255         return bytes;
1256       }
1257       if (error != SSL_ERROR_SYSCALL) {
1258         if ((unsigned long)lastError < 0x8000) {
1259           errno = ENOSYS;
1260         } else {
1261           errno = lastError;
1262         }
1263       }
1264       return READ_ERROR;
1265     }
1266   } else {
1267     appBytesReceived_ += bytes;
1268     return bytes;
1269   }
1270 }
1271
1272 void AsyncSSLSocket::handleWrite() noexcept {
1273   VLOG(5) << "AsyncSSLSocket::handleWrite() this=" << this << ", fd=" << fd_
1274           << ", state=" << int(state_) << ", "
1275           << "sslState=" << sslState_ << ", events=" << eventFlags_;
1276   if (state_ < StateEnum::ESTABLISHED) {
1277     return AsyncSocket::handleWrite();
1278   }
1279
1280   if (sslState_ == STATE_ACCEPTING) {
1281     assert(server_);
1282     handleAccept();
1283     return;
1284   }
1285
1286   if (sslState_ == STATE_CONNECTING) {
1287     assert(!server_);
1288     handleConnect();
1289     return;
1290   }
1291
1292   // Normal write
1293   AsyncSocket::handleWrite();
1294 }
1295
1296 int AsyncSSLSocket::interpretSSLError(int rc, int error) {
1297   if (error == SSL_ERROR_WANT_READ) {
1298     // TODO: Even though we are attempting to write data, SSL_write() may
1299     // need to read data if renegotiation is being performed.  We currently
1300     // don't support this and just fail the write.
1301     LOG(ERROR) << "AsyncSSLSocket(fd=" << fd_ << ", state=" << int(state_)
1302                << ", sslState=" << sslState_ << ", events=" << eventFlags_
1303                << "): " << "unsupported SSL renegotiation during write",
1304       errno = ERR_PACK(ERR_LIB_USER, TASYNCSSLSOCKET_F_PERFORM_WRITE,
1305                        SSL_INVALID_RENEGOTIATION);
1306     ERR_clear_error();
1307     return -1;
1308   } else {
1309     // TODO: Fix this code so that it can return a proper error message
1310     // to the callback, rather than relying on AsyncSocket code which
1311     // can't handle SSL errors.
1312     long lastError = ERR_get_error();
1313     VLOG(3) << "ERROR: AsyncSSLSocket(fd=" << fd_ << ", state=" << int(state_)
1314             << ", sslState=" << sslState_ << ", events=" << eventFlags_ << "): "
1315             << "SSL error: " << error << ", errno: " << errno
1316             << ", func: " << ERR_func_error_string(lastError)
1317             << ", reason: " << ERR_reason_error_string(lastError);
1318     if (error != SSL_ERROR_SYSCALL) {
1319       if ((unsigned long)lastError < 0x8000) {
1320         errno = ENOSYS;
1321       } else {
1322         errno = lastError;
1323       }
1324     }
1325     ERR_clear_error();
1326     if (!zero_return(error, rc)) {
1327       return -1;
1328     } else {
1329       return 0;
1330     }
1331   }
1332 }
1333
1334 ssize_t AsyncSSLSocket::performWrite(const iovec* vec,
1335                                       uint32_t count,
1336                                       WriteFlags flags,
1337                                       uint32_t* countWritten,
1338                                       uint32_t* partialWritten) {
1339   if (sslState_ == STATE_UNENCRYPTED) {
1340     return AsyncSocket::performWrite(
1341       vec, count, flags, countWritten, partialWritten);
1342   }
1343   if (sslState_ != STATE_ESTABLISHED) {
1344     LOG(ERROR) << "AsyncSSLSocket(fd=" << fd_ << ", state=" << int(state_)
1345                << ", sslState=" << sslState_
1346                << ", events=" << eventFlags_ << "): "
1347                << "TODO: AsyncSSLSocket currently does not support calling "
1348                << "write() before the handshake has fully completed";
1349       errno = ERR_PACK(ERR_LIB_USER, TASYNCSSLSOCKET_F_PERFORM_WRITE,
1350                        SSL_EARLY_WRITE);
1351       return -1;
1352   }
1353
1354   bool cork = isSet(flags, WriteFlags::CORK) || persistentCork_;
1355   CorkGuard guard(fd_, count > 1, cork, &corked_);
1356
1357 #if 0
1358 //#ifdef SSL_MODE_WRITE_IOVEC
1359   if (ssl_->expand == nullptr &&
1360       ssl_->compress == nullptr &&
1361       (ssl_->mode & SSL_MODE_WRITE_IOVEC)) {
1362     return performWriteIovec(vec, count, flags, countWritten, partialWritten);
1363   }
1364 #endif
1365
1366   // Declare a buffer used to hold small write requests.  It could point to a
1367   // memory block either on stack or on heap. If it is on heap, we release it
1368   // manually when scope exits
1369   char* combinedBuf{nullptr};
1370   SCOPE_EXIT {
1371     // Note, always keep this check consistent with what we do below
1372     if (combinedBuf != nullptr && minWriteSize_ > MAX_STACK_BUF_SIZE) {
1373       delete[] combinedBuf;
1374     }
1375   };
1376
1377   *countWritten = 0;
1378   *partialWritten = 0;
1379   ssize_t totalWritten = 0;
1380   size_t bytesStolenFromNextBuffer = 0;
1381   for (uint32_t i = 0; i < count; i++) {
1382     const iovec* v = vec + i;
1383     size_t offset = bytesStolenFromNextBuffer;
1384     bytesStolenFromNextBuffer = 0;
1385     size_t len = v->iov_len - offset;
1386     const void* buf;
1387     if (len == 0) {
1388       (*countWritten)++;
1389       continue;
1390     }
1391     buf = ((const char*)v->iov_base) + offset;
1392
1393     ssize_t bytes;
1394     errno = 0;
1395     uint32_t buffersStolen = 0;
1396     if ((len < minWriteSize_) && ((i + 1) < count)) {
1397       // Combine this buffer with part or all of the next buffers in
1398       // order to avoid really small-grained calls to SSL_write().
1399       // Each call to SSL_write() produces a separate record in
1400       // the egress SSL stream, and we've found that some low-end
1401       // mobile clients can't handle receiving an HTTP response
1402       // header and the first part of the response body in two
1403       // separate SSL records (even if those two records are in
1404       // the same TCP packet).
1405
1406       if (combinedBuf == nullptr) {
1407         if (minWriteSize_ > MAX_STACK_BUF_SIZE) {
1408           // Allocate the buffer on heap
1409           combinedBuf = new char[minWriteSize_];
1410         } else {
1411           // Allocate the buffer on stack
1412           combinedBuf = (char*)alloca(minWriteSize_);
1413         }
1414       }
1415       assert(combinedBuf != nullptr);
1416
1417       memcpy(combinedBuf, buf, len);
1418       do {
1419         // INVARIANT: i + buffersStolen == complete chunks serialized
1420         uint32_t nextIndex = i + buffersStolen + 1;
1421         bytesStolenFromNextBuffer = std::min(vec[nextIndex].iov_len,
1422                                              minWriteSize_ - len);
1423         memcpy(combinedBuf + len, vec[nextIndex].iov_base,
1424                bytesStolenFromNextBuffer);
1425         len += bytesStolenFromNextBuffer;
1426         if (bytesStolenFromNextBuffer < vec[nextIndex].iov_len) {
1427           // couldn't steal the whole buffer
1428           break;
1429         } else {
1430           bytesStolenFromNextBuffer = 0;
1431           buffersStolen++;
1432         }
1433       } while ((i + buffersStolen + 1) < count && (len < minWriteSize_));
1434       bytes = eorAwareSSLWrite(
1435         ssl_, combinedBuf, len,
1436         (isSet(flags, WriteFlags::EOR) && i + buffersStolen + 1 == count));
1437
1438     } else {
1439       bytes = eorAwareSSLWrite(ssl_, buf, len,
1440                            (isSet(flags, WriteFlags::EOR) && i + 1 == count));
1441     }
1442
1443     if (bytes <= 0) {
1444       int error = SSL_get_error(ssl_, bytes);
1445       if (error == SSL_ERROR_WANT_WRITE) {
1446         // The caller will register for write event if not already.
1447         *partialWritten = offset;
1448         return totalWritten;
1449       }
1450       int rc = interpretSSLError(bytes, error);
1451       if (rc < 0) {
1452         return rc;
1453       } // else fall through to below to correctly record totalWritten
1454     }
1455
1456     totalWritten += bytes;
1457
1458     if (bytes == (ssize_t)len) {
1459       // The full iovec is written.
1460       (*countWritten) += 1 + buffersStolen;
1461       i += buffersStolen;
1462       // continue
1463     } else {
1464       bytes += offset; // adjust bytes to account for all of v
1465       while (bytes >= (ssize_t)v->iov_len) {
1466         // We combined this buf with part or all of the next one, and
1467         // we managed to write all of this buf but not all of the bytes
1468         // from the next one that we'd hoped to write.
1469         bytes -= v->iov_len;
1470         (*countWritten)++;
1471         v = &(vec[++i]);
1472       }
1473       *partialWritten = bytes;
1474       return totalWritten;
1475     }
1476   }
1477
1478   return totalWritten;
1479 }
1480
1481 #if 0
1482 //#ifdef SSL_MODE_WRITE_IOVEC
1483 ssize_t AsyncSSLSocket::performWriteIovec(const iovec* vec,
1484                                           uint32_t count,
1485                                           WriteFlags flags,
1486                                           uint32_t* countWritten,
1487                                           uint32_t* partialWritten) {
1488   size_t tot = 0;
1489   for (uint32_t j = 0; j < count; j++) {
1490     tot += vec[j].iov_len;
1491   }
1492
1493   ssize_t totalWritten = SSL_write_iovec(ssl_, vec, count);
1494
1495   *countWritten = 0;
1496   *partialWritten = 0;
1497   if (totalWritten <= 0) {
1498     return interpretSSLError(totalWritten, SSL_get_error(ssl_, totalWritten));
1499   } else {
1500     ssize_t bytes = totalWritten, i = 0;
1501     while (i < count && bytes >= (ssize_t)vec[i].iov_len) {
1502       // we managed to write all of this buf
1503       bytes -= vec[i].iov_len;
1504       (*countWritten)++;
1505       i++;
1506     }
1507     *partialWritten = bytes;
1508
1509     VLOG(4) << "SSL_write_iovec() writes " << tot
1510             << ", returns " << totalWritten << " bytes"
1511             << ", max_send_fragment=" << ssl_->max_send_fragment
1512             << ", count=" << count << ", countWritten=" << *countWritten;
1513
1514     return totalWritten;
1515   }
1516 }
1517 #endif
1518
1519 int AsyncSSLSocket::eorAwareSSLWrite(SSL *ssl, const void *buf, int n,
1520                                       bool eor) {
1521   if (eor && SSL_get_wbio(ssl)->method == &eorAwareBioMethod) {
1522     if (appEorByteNo_) {
1523       // cannot track for more than one app byte EOR
1524       CHECK(appEorByteNo_ == appBytesWritten_ + n);
1525     } else {
1526       appEorByteNo_ = appBytesWritten_ + n;
1527     }
1528
1529     // 1. It is fine to keep updating minEorRawByteNo_.
1530     // 2. It is _min_ in the sense that SSL record will add some overhead.
1531     minEorRawByteNo_ = getRawBytesWritten() + n;
1532   }
1533
1534   n = sslWriteImpl(ssl, buf, n);
1535   if (n > 0) {
1536     appBytesWritten_ += n;
1537     if (appEorByteNo_) {
1538       if (getRawBytesWritten() >= minEorRawByteNo_) {
1539         minEorRawByteNo_ = 0;
1540       }
1541       if(appBytesWritten_ == appEorByteNo_) {
1542         appEorByteNo_ = 0;
1543       } else {
1544         CHECK(appBytesWritten_ < appEorByteNo_);
1545       }
1546     }
1547   }
1548   return n;
1549 }
1550
1551 void AsyncSSLSocket::sslInfoCallback(const SSL* ssl, int where, int /* ret */) {
1552   AsyncSSLSocket *sslSocket = AsyncSSLSocket::getFromSSL(ssl);
1553   if (sslSocket->handshakeComplete_ && (where & SSL_CB_HANDSHAKE_START)) {
1554     sslSocket->renegotiateAttempted_ = true;
1555   }
1556 }
1557
1558 int AsyncSSLSocket::eorAwareBioWrite(BIO *b, const char *in, int inl) {
1559   int ret;
1560   struct msghdr msg;
1561   struct iovec iov;
1562   int flags = 0;
1563   AsyncSSLSocket *tsslSock;
1564
1565   iov.iov_base = const_cast<char *>(in);
1566   iov.iov_len = inl;
1567   memset(&msg, 0, sizeof(msg));
1568   msg.msg_iov = &iov;
1569   msg.msg_iovlen = 1;
1570
1571   tsslSock =
1572     reinterpret_cast<AsyncSSLSocket*>(BIO_get_app_data(b));
1573   if (tsslSock &&
1574       tsslSock->minEorRawByteNo_ &&
1575       tsslSock->minEorRawByteNo_ <= BIO_number_written(b) + inl) {
1576     flags = MSG_EOR;
1577   }
1578
1579   errno = 0;
1580   ret = sendmsg(b->num, &msg, flags);
1581   BIO_clear_retry_flags(b);
1582   if (ret <= 0) {
1583     if (BIO_sock_should_retry(ret))
1584       BIO_set_retry_write(b);
1585   }
1586   return(ret);
1587 }
1588
1589 int AsyncSSLSocket::sslVerifyCallback(int preverifyOk,
1590                                        X509_STORE_CTX* x509Ctx) {
1591   SSL* ssl = (SSL*) X509_STORE_CTX_get_ex_data(
1592     x509Ctx, SSL_get_ex_data_X509_STORE_CTX_idx());
1593   AsyncSSLSocket* self = AsyncSSLSocket::getFromSSL(ssl);
1594
1595   VLOG(3) <<  "AsyncSSLSocket::sslVerifyCallback() this=" << self << ", "
1596           << "fd=" << self->fd_ << ", preverifyOk=" << preverifyOk;
1597   return (self->handshakeCallback_) ?
1598     self->handshakeCallback_->handshakeVer(self, preverifyOk, x509Ctx) :
1599     preverifyOk;
1600 }
1601
1602 void AsyncSSLSocket::enableClientHelloParsing()  {
1603     parseClientHello_ = true;
1604     clientHelloInfo_.reset(new ClientHelloInfo());
1605 }
1606
1607 void AsyncSSLSocket::resetClientHelloParsing(SSL *ssl)  {
1608   SSL_set_msg_callback(ssl, nullptr);
1609   SSL_set_msg_callback_arg(ssl, nullptr);
1610   clientHelloInfo_->clientHelloBuf_.clear();
1611 }
1612
1613 void AsyncSSLSocket::clientHelloParsingCallback(int written,
1614                                                 int /* version */,
1615                                                 int contentType,
1616                                                 const void* buf,
1617                                                 size_t len,
1618                                                 SSL* ssl,
1619                                                 void* arg) {
1620   AsyncSSLSocket *sock = static_cast<AsyncSSLSocket*>(arg);
1621   if (written != 0) {
1622     sock->resetClientHelloParsing(ssl);
1623     return;
1624   }
1625   if (contentType != SSL3_RT_HANDSHAKE) {
1626     return;
1627   }
1628   if (len == 0) {
1629     return;
1630   }
1631
1632   auto& clientHelloBuf = sock->clientHelloInfo_->clientHelloBuf_;
1633   clientHelloBuf.append(IOBuf::wrapBuffer(buf, len));
1634   try {
1635     Cursor cursor(clientHelloBuf.front());
1636     if (cursor.read<uint8_t>() != SSL3_MT_CLIENT_HELLO) {
1637       sock->resetClientHelloParsing(ssl);
1638       return;
1639     }
1640
1641     if (cursor.totalLength() < 3) {
1642       clientHelloBuf.trimEnd(len);
1643       clientHelloBuf.append(IOBuf::copyBuffer(buf, len));
1644       return;
1645     }
1646
1647     uint32_t messageLength = cursor.read<uint8_t>();
1648     messageLength <<= 8;
1649     messageLength |= cursor.read<uint8_t>();
1650     messageLength <<= 8;
1651     messageLength |= cursor.read<uint8_t>();
1652     if (cursor.totalLength() < messageLength) {
1653       clientHelloBuf.trimEnd(len);
1654       clientHelloBuf.append(IOBuf::copyBuffer(buf, len));
1655       return;
1656     }
1657
1658     sock->clientHelloInfo_->clientHelloMajorVersion_ = cursor.read<uint8_t>();
1659     sock->clientHelloInfo_->clientHelloMinorVersion_ = cursor.read<uint8_t>();
1660
1661     cursor.skip(4); // gmt_unix_time
1662     cursor.skip(28); // random_bytes
1663
1664     cursor.skip(cursor.read<uint8_t>()); // session_id
1665
1666     uint16_t cipherSuitesLength = cursor.readBE<uint16_t>();
1667     for (int i = 0; i < cipherSuitesLength; i += 2) {
1668       sock->clientHelloInfo_->
1669         clientHelloCipherSuites_.push_back(cursor.readBE<uint16_t>());
1670     }
1671
1672     uint8_t compressionMethodsLength = cursor.read<uint8_t>();
1673     for (int i = 0; i < compressionMethodsLength; ++i) {
1674       sock->clientHelloInfo_->
1675         clientHelloCompressionMethods_.push_back(cursor.readBE<uint8_t>());
1676     }
1677
1678     if (cursor.totalLength() > 0) {
1679       uint16_t extensionsLength = cursor.readBE<uint16_t>();
1680       while (extensionsLength) {
1681         TLSExtension extensionType = static_cast<TLSExtension>(
1682             cursor.readBE<uint16_t>());
1683         sock->clientHelloInfo_->
1684           clientHelloExtensions_.push_back(extensionType);
1685         extensionsLength -= 2;
1686         uint16_t extensionDataLength = cursor.readBE<uint16_t>();
1687         extensionsLength -= 2;
1688
1689         if (extensionType == TLSExtension::SIGNATURE_ALGORITHMS) {
1690           cursor.skip(2);
1691           extensionDataLength -= 2;
1692           while (extensionDataLength) {
1693             HashAlgorithm hashAlg = static_cast<HashAlgorithm>(
1694                 cursor.readBE<uint8_t>());
1695             SignatureAlgorithm sigAlg = static_cast<SignatureAlgorithm>(
1696                 cursor.readBE<uint8_t>());
1697             extensionDataLength -= 2;
1698             sock->clientHelloInfo_->
1699               clientHelloSigAlgs_.emplace_back(hashAlg, sigAlg);
1700           }
1701         } else {
1702           cursor.skip(extensionDataLength);
1703           extensionsLength -= extensionDataLength;
1704         }
1705       }
1706     }
1707   } catch (std::out_of_range& e) {
1708     // we'll use what we found and cleanup below.
1709     VLOG(4) << "AsyncSSLSocket::clientHelloParsingCallback(): "
1710       << "buffer finished unexpectedly." << " AsyncSSLSocket socket=" << sock;
1711   }
1712
1713   sock->resetClientHelloParsing(ssl);
1714 }
1715
1716 } // namespace