Refactor all examples:

fix #575, fix #604, fix #608, fix #634, fix #712 All examples are rewritten: * Using Best Practices * Mostly self-contained * New examples to complete the feature matrix * The server-framework example is removed
2017-08-07 20:53:11 -07:00
parent 20a8f7d75b
commit dd71b0f94d
187 changed files with 11759 additions and 7098 deletions
@@ -0,0 +1,11 @@
+#
+# Copyright (c) 2013-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+add_subdirectory (client)
+add_subdirectory (server)
@@ -0,0 +1,11 @@
+#
+# Copyright (c) 2013-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+build-project client ;
+build-project server ;
@@ -0,0 +1,18 @@
+#
+# Copyright (c) 2013-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+add_subdirectory (async)
+add_subdirectory (coro)
+add_subdirectory (sync)
+
+if (OPENSSL_FOUND)
+    add_subdirectory (async-ssl)
+    add_subdirectory (coro-ssl)
+    add_subdirectory (sync-ssl)
+endif()
@@ -0,0 +1,17 @@
+#
+# Copyright (c) 2013-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+build-project async ;
+build-project coro ;
+build-project sync ;
+
+# VFALCO How do I make this work on Windows and if OpenSSL is not available?
+#build-project async-ssl ;
+#build-project coro-ssl ;
+#build-project sync-ssl ;
@@ -0,0 +1,23 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+GroupSources(include/boost/beast beast)
+GroupSources(example/common common)
+GroupSources(example/websocket/client/async-ssl "/")
+
+add_executable (websocket-client-async-ssl
+    ${BOOST_BEAST_INCLUDES}
+    ${PROJECT_SOURCE_DIR}/example/common/root_certificates.hpp
+    Jamfile
+    websocket_client_async_ssl.cpp
+)
+
+target_link_libraries (websocket-client-async-ssl
+    ${OPENSSL_LIBRARIES}
+    )
@@ -0,0 +1,21 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+project
+    : requirements
+    <library>ssl
+    <library>crypto
+    ;
+
+exe websocket-client-async-ssl :
+    websocket_client_async_ssl.cpp
+    :
+    <variant>coverage:<build>no
+    <variant>ubasan:<build>no
+    ;
@@ -0,0 +1,219 @@
+//
+// Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// Official repository: https://github.com/boostorg/beast
+//
+
+//------------------------------------------------------------------------------
+//
+// Example: WebSocket SSL client, asynchronous
+//
+//------------------------------------------------------------------------------
+
+#include "example/common/root_certificates.hpp"
+
+#include <boost/beast/core.hpp>
+#include <boost/beast/websocket.hpp>
+#include <boost/beast/websocket/ssl.hpp>
+#include <boost/asio/connect.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <boost/asio/ssl/stream.hpp>
+#include <cstdlib>
+#include <functional>
+#include <iostream>
+#include <memory>
+#include <string>
+
+using tcp = boost::asio::ip::tcp;               // from <boost/asio/ip/tcp.hpp>
+namespace ssl = boost::asio::ssl;               // from <boost/asio/ssl.hpp>
+namespace websocket = boost::beast::websocket;  // from <boost/beast/websocket.hpp>
+
+//------------------------------------------------------------------------------
+
+// Report a failure
+void
+fail(boost::system::error_code ec, char const* what)
+{
+    std::cerr << what << ": " << ec.message() << "\n";
+}
+
+// Sends a WebSocket message and prints the response
+class session : public std::enable_shared_from_this<session>
+{
+    tcp::resolver resolver_;
+    websocket::stream<ssl::stream<tcp::socket>> ws_;
+    boost::beast::multi_buffer buffer_;
+    std::string host_;
+    std::string text_;
+
+public:
+    // Resolver and socket require an io_service
+    explicit
+    session(boost::asio::io_service& ios, ssl::context& ctx)
+        : resolver_(ios)
+        , ws_(ios, ctx)
+    {
+    }
+
+    // Start the asynchronous operation
+    void
+    run(
+        char const* host,
+        char const* port,
+        char const* text)
+    {
+        // Save these for later
+        host_ = host;
+        text_ = text;
+
+        // Look up the domain name
+        resolver_.async_resolve({host, port},
+            std::bind(
+                &session::on_resolve,
+                shared_from_this(),
+                std::placeholders::_1,
+                std::placeholders::_2));
+    }
+
+    void
+    on_resolve(
+        boost::system::error_code ec,
+        tcp::resolver::iterator result)
+    {
+        if(ec)
+            return fail(ec, "resolve");
+
+        // Make the connection on the IP address we get from a lookup
+        boost::asio::async_connect(
+            ws_.next_layer().next_layer(),
+            result,
+            std::bind(
+                &session::on_connect,
+                shared_from_this(),
+                std::placeholders::_1));
+    }
+
+    void
+    on_connect(boost::system::error_code ec)
+    {
+        if(ec)
+            return fail(ec, "connect");
+
+        // Perform the SSL handshake
+        ws_.next_layer().async_handshake(
+            ssl::stream_base::client,
+            std::bind(
+                &session::on_ssl_handshake,
+                shared_from_this(),
+                std::placeholders::_1));
+    }
+
+    void
+    on_ssl_handshake(boost::system::error_code ec)
+    {
+        if(ec)
+            return fail(ec, "ssl_handshake");
+
+        // Perform the websocket handshake
+        ws_.async_handshake(host_, "/",
+            std::bind(
+                &session::on_handshake,
+                shared_from_this(),
+                std::placeholders::_1));
+    }
+
+    void
+    on_handshake(boost::system::error_code ec)
+    {
+        if(ec)
+            return fail(ec, "handshake");
+        
+        // Send the message
+        ws_.async_write(
+            boost::asio::buffer(text_),
+            std::bind(
+                &session::on_write,
+                shared_from_this(),
+                std::placeholders::_1));
+    }
+
+    void
+    on_write(boost::system::error_code ec)
+    {
+        if(ec)
+            return fail(ec, "write");
+        
+        // Read a message into our buffer
+        ws_.async_read(
+            buffer_,
+            std::bind(
+                &session::on_read,
+                shared_from_this(),
+                std::placeholders::_1));
+    }
+
+    void
+    on_read(boost::system::error_code ec)
+    {
+        if(ec)
+            return fail(ec, "read");
+
+        // Close the WebSocket connection
+        ws_.async_close(websocket::close_code::normal,
+            std::bind(
+                &session::on_close,
+                shared_from_this(),
+                std::placeholders::_1));
+    }
+
+    void
+    on_close(boost::system::error_code ec)
+    {
+        if(ec)
+            return fail(ec, "close");
+
+        // If we get here then the connection is closed gracefully
+
+        // The buffers() function helps print a ConstBufferSequence
+        std::cout << boost::beast::buffers(buffer_.data()) << std::endl;
+    }
+};
+
+//------------------------------------------------------------------------------
+
+int main(int argc, char** argv)
+{
+    // Check command line arguments.
+    if(argc != 4)
+    {
+        std::cerr <<
+            "Usage: websocket-client-async-ssl <host> <port> <text>\n" <<
+            "Example:\n" <<
+            "    websocket-client-async-ssl echo.websocket.org 443 \"Hello, world!\"\n";
+        return EXIT_FAILURE;
+    }
+    auto const host = argv[1];
+    auto const port = argv[2];
+    auto const text = argv[3];
+
+    // The io_service is required for all I/O
+    boost::asio::io_service ios;
+
+    // The SSL context is required, and holds certificates
+    ssl::context ctx{ssl::context::sslv23_client};
+
+    // This holds the root certificate used for verification
+    load_root_certificates(ctx);
+
+    // Launch the asynchronous operation
+    std::make_shared<session>(ios, ctx)->run(host, port, text);
+
+    // Run the I/O service. The call will return when
+    // the get operation is complete.
+    ios.run();
+
+    return EXIT_SUCCESS;
+}
@@ -0,0 +1,17 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+GroupSources(include/boost/beast beast)
+GroupSources(example/websocket/client/async "/")
+
+add_executable (websocket-client-async
+    ${BOOST_BEAST_INCLUDES}
+    Jamfile
+    websocket_client_async.cpp
+)
@@ -0,0 +1,15 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+exe websocket-client-async :
+    websocket_client_async.cpp
+    :
+    <variant>coverage:<build>no
+    <variant>ubasan:<build>no
+    ;
@@ -0,0 +1,193 @@
+//
+// Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// Official repository: https://github.com/boostorg/beast
+//
+
+//------------------------------------------------------------------------------
+//
+// Example: WebSocket client, asynchronous
+//
+//------------------------------------------------------------------------------
+
+#include <boost/beast/core.hpp>
+#include <boost/beast/websocket.hpp>
+#include <boost/asio/connect.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <cstdlib>
+#include <functional>
+#include <iostream>
+#include <memory>
+#include <string>
+
+using tcp = boost::asio::ip::tcp;               // from <boost/asio/ip/tcp.hpp>
+namespace websocket = boost::beast::websocket;  // from <boost/beast/websocket.hpp>
+
+//------------------------------------------------------------------------------
+
+// Report a failure
+void
+fail(boost::system::error_code ec, char const* what)
+{
+    std::cerr << what << ": " << ec.message() << "\n";
+}
+
+// Sends a WebSocket message and prints the response
+class session : public std::enable_shared_from_this<session>
+{
+    tcp::resolver resolver_;
+    websocket::stream<tcp::socket> ws_;
+    boost::beast::multi_buffer buffer_;
+    std::string host_;
+    std::string text_;
+
+public:
+    // Resolver and socket require an io_service
+    explicit
+    session(boost::asio::io_service& ios)
+        : resolver_(ios)
+        , ws_(ios)
+    {
+    }
+
+    // Start the asynchronous operation
+    void
+    run(
+        char const* host,
+        char const* port,
+        char const* text)
+    {
+        // Save these for later
+        host_ = host;
+        text_ = text;
+
+        // Look up the domain name
+        resolver_.async_resolve({host, port},
+            std::bind(
+                &session::on_resolve,
+                shared_from_this(),
+                std::placeholders::_1,
+                std::placeholders::_2));
+    }
+
+    void
+    on_resolve(
+        boost::system::error_code ec,
+        tcp::resolver::iterator result)
+    {
+        if(ec)
+            return fail(ec, "resolve");
+
+        // Make the connection on the IP address we get from a lookup
+        boost::asio::async_connect(
+            ws_.next_layer(),
+            result,
+            std::bind(
+                &session::on_connect,
+                shared_from_this(),
+                std::placeholders::_1));
+    }
+
+    void
+    on_connect(boost::system::error_code ec)
+    {
+        if(ec)
+            return fail(ec, "connect");
+
+        // Perform the websocket handshake
+        ws_.async_handshake(host_, "/",
+            std::bind(
+                &session::on_handshake,
+                shared_from_this(),
+                std::placeholders::_1));
+    }
+
+    void
+    on_handshake(boost::system::error_code ec)
+    {
+        if(ec)
+            return fail(ec, "handshake");
+        
+        // Send the message
+        ws_.async_write(
+            boost::asio::buffer(text_),
+            std::bind(
+                &session::on_write,
+                shared_from_this(),
+                std::placeholders::_1));
+    }
+
+    void
+    on_write(boost::system::error_code ec)
+    {
+        if(ec)
+            return fail(ec, "write");
+        
+        // Read a message into our buffer
+        ws_.async_read(
+            buffer_,
+            std::bind(
+                &session::on_read,
+                shared_from_this(),
+                std::placeholders::_1));
+    }
+
+    void
+    on_read(boost::system::error_code ec)
+    {
+        if(ec)
+            return fail(ec, "read");
+
+        // Close the WebSocket connection
+        ws_.async_close(websocket::close_code::normal,
+            std::bind(
+                &session::on_close,
+                shared_from_this(),
+                std::placeholders::_1));
+    }
+
+    void
+    on_close(boost::system::error_code ec)
+    {
+        if(ec)
+            return fail(ec, "close");
+
+        // If we get here then the connection is closed gracefully
+
+        // The buffers() function helps print a ConstBufferSequence
+        std::cout << boost::beast::buffers(buffer_.data()) << std::endl;
+    }
+};
+
+//------------------------------------------------------------------------------
+
+int main(int argc, char** argv)
+{
+    // Check command line arguments.
+    if(argc != 4)
+    {
+        std::cerr <<
+            "Usage: websocket-client-async <host> <port> <text>\n" <<
+            "Example:\n" <<
+            "    websocket-client-async echo.websocket.org 80 \"Hello, world!\"\n";
+        return EXIT_FAILURE;
+    }
+    auto const host = argv[1];
+    auto const port = argv[2];
+    auto const text = argv[3];
+
+    // The io_service is required for all I/O
+    boost::asio::io_service ios;
+
+    // Launch the asynchronous operation
+    std::make_shared<session>(ios)->run(host, port, text);
+
+    // Run the I/O service. The call will return when
+    // the get operation is complete.
+    ios.run();
+
+    return EXIT_SUCCESS;
+}
@@ -0,0 +1,23 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+GroupSources(include/boost/beast beast)
+GroupSources(example/common common)
+GroupSources(example/websocket/client/coro-ssl "/")
+
+add_executable (websocket-client-coro-ssl
+    ${BOOST_BEAST_INCLUDES}
+    ${PROJECT_SOURCE_DIR}/example/common/root_certificates.hpp
+    Jamfile
+    websocket_client_coro_ssl.cpp
+)
+
+target_link_libraries (websocket-client-coro-ssl
+    ${OPENSSL_LIBRARIES}
+    )
@@ -0,0 +1,21 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+project
+    : requirements
+    <library>ssl
+    <library>crypto
+    ;
+
+exe websocket-client-coro-ssl :
+    websocket_client_coro_ssl.cpp
+    :
+    <variant>coverage:<build>no
+    <variant>ubasan:<build>no
+    ;
@@ -0,0 +1,144 @@
+//
+// Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// Official repository: https://github.com/boostorg/beast
+//
+
+//------------------------------------------------------------------------------
+//
+// Example: WebSocket SSL client, coroutine
+//
+//------------------------------------------------------------------------------
+
+#include "example/common/root_certificates.hpp"
+
+#include <boost/beast/core.hpp>
+#include <boost/beast/websocket.hpp>
+#include <boost/beast/websocket/ssl.hpp>
+#include <boost/asio/connect.hpp>
+#include <boost/asio/spawn.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <boost/asio/ssl/stream.hpp>
+#include <cstdlib>
+#include <functional>
+#include <iostream>
+#include <string>
+
+using tcp = boost::asio::ip::tcp;               // from <boost/asio/ip/tcp.hpp>
+namespace ssl = boost::asio::ssl;               // from <boost/asio/ssl.hpp>
+namespace websocket = boost::beast::websocket;  // from <boost/beast/websocket.hpp>
+
+//------------------------------------------------------------------------------
+
+// Report a failure
+void
+fail(boost::system::error_code ec, char const* what)
+{
+    std::cerr << what << ": " << ec.message() << "\n";
+}
+
+// Sends a WebSocket message and prints the response
+void
+do_session(
+    std::string const& host,
+    std::string const& port,
+    std::string const& text,
+    boost::asio::io_service& ios,
+    ssl::context& ctx,
+    boost::asio::yield_context yield)
+{
+    boost::system::error_code ec;
+
+    // These objects perform our I/O
+    tcp::resolver resolver{ios};
+    websocket::stream<ssl::stream<tcp::socket>> ws{ios, ctx};
+
+    // Look up the domain name
+    auto const lookup = resolver.async_resolve({host, port}, yield[ec]);
+    if(ec)
+        return fail(ec, "resolve");
+
+    // Make the connection on the IP address we get from a lookup
+    boost::asio::async_connect(ws.next_layer().next_layer(), lookup, yield[ec]);
+    if(ec)
+        return fail(ec, "connect");
+
+    // Perform the SSL handshake
+    ws.next_layer().async_handshake(ssl::stream_base::client, yield[ec]);
+    if(ec)
+        return fail(ec, "ssl_handshake");
+
+    // Perform the websocket handshake
+    ws.async_handshake(host, "/", yield[ec]);
+    if(ec)
+        return fail(ec, "handshake");
+
+    // Send the message
+    ws.async_write(boost::asio::buffer(std::string(text)), yield[ec]);
+    if(ec)
+        return fail(ec, "write");
+
+    // This buffer will hold the incoming message
+    boost::beast::multi_buffer b;
+
+    // Read a message into our buffer
+    ws.async_read(b, yield[ec]);
+    if(ec)
+        return fail(ec, "read");
+
+    // Close the WebSocket connection
+    ws.async_close(websocket::close_code::normal, yield[ec]);
+    if(ec)
+        return fail(ec, "close");
+
+    // If we get here then the connection is closed gracefully
+
+    // The buffers() function helps print a ConstBufferSequence
+    std::cout << boost::beast::buffers(b.data()) << std::endl;
+}
+
+//------------------------------------------------------------------------------
+
+int main(int argc, char** argv)
+{
+    // Check command line arguments.
+    if(argc != 4)
+    {
+        std::cerr <<
+            "Usage: websocket-client-coro-ssl <host> <port> <text>\n" <<
+            "Example:\n" <<
+            "    websocket-client-coro-ssl echo.websocket.org 443 \"Hello, world!\"\n";
+        return EXIT_FAILURE;
+    }
+    auto const host = argv[1];
+    auto const port = argv[2];
+    auto const text = argv[3];
+
+    // The io_service is required for all I/O
+    boost::asio::io_service ios;
+
+    // The SSL context is required, and holds certificates
+    ssl::context ctx{ssl::context::sslv23_client};
+
+    // This holds the root certificate used for verification
+    load_root_certificates(ctx);
+
+    // Launch the asynchronous operation
+    boost::asio::spawn(ios, std::bind(
+        &do_session,
+        std::string(host),
+        std::string(port),
+        std::string(text),
+        std::ref(ios),
+        std::ref(ctx),
+        std::placeholders::_1));
+
+    // Run the I/O service. The call will return when
+    // the get operation is complete.
+    ios.run();
+
+    return EXIT_SUCCESS;
+}
@@ -0,0 +1,17 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+GroupSources(include/boost/beast beast)
+GroupSources(example/websocket/client/coro "/")
+
+add_executable (websocket-client-coro
+    ${BOOST_BEAST_INCLUDES}
+    Jamfile
+    websocket_client_coro.cpp
+)
@@ -0,0 +1,15 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+exe websocket-client-coro :
+    websocket_client_coro.cpp
+    :
+    <variant>coverage:<build>no
+    <variant>ubasan:<build>no
+    ;
@@ -0,0 +1,126 @@
+//
+// Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// Official repository: https://github.com/boostorg/beast
+//
+
+//------------------------------------------------------------------------------
+//
+// Example: WebSocket client, coroutine
+//
+//------------------------------------------------------------------------------
+
+#include <boost/beast/core.hpp>
+#include <boost/beast/websocket.hpp>
+#include <boost/asio/connect.hpp>
+#include <boost/asio/spawn.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <cstdlib>
+#include <functional>
+#include <iostream>
+#include <string>
+
+using tcp = boost::asio::ip::tcp;               // from <boost/asio/ip/tcp.hpp>
+namespace websocket = boost::beast::websocket;  // from <boost/beast/websocket.hpp>
+
+//------------------------------------------------------------------------------
+
+// Report a failure
+void
+fail(boost::system::error_code ec, char const* what)
+{
+    std::cerr << what << ": " << ec.message() << "\n";
+}
+
+// Sends a WebSocket message and prints the response
+void
+do_session(
+    std::string const& host,
+    std::string const& port,
+    std::string const& text,
+    boost::asio::io_service& ios,
+    boost::asio::yield_context yield)
+{
+    boost::system::error_code ec;
+
+    // These objects perform our I/O
+    tcp::resolver resolver{ios};
+    websocket::stream<tcp::socket> ws{ios};
+
+    // Look up the domain name
+    auto const lookup = resolver.async_resolve({host, port}, yield[ec]);
+    if(ec)
+        return fail(ec, "resolve");
+
+    // Make the connection on the IP address we get from a lookup
+    boost::asio::async_connect(ws.next_layer(), lookup, yield[ec]);
+    if(ec)
+        return fail(ec, "connect");
+
+    // Perform the websocket handshake
+    ws.async_handshake(host, "/", yield[ec]);
+    if(ec)
+        return fail(ec, "handshake");
+
+    // Send the message
+    ws.async_write(boost::asio::buffer(std::string(text)), yield[ec]);
+    if(ec)
+        return fail(ec, "write");
+
+    // This buffer will hold the incoming message
+    boost::beast::multi_buffer b;
+
+    // Read a message into our buffer
+    ws.async_read(b, yield[ec]);
+    if(ec)
+        return fail(ec, "read");
+
+    // Close the WebSocket connection
+    ws.async_close(websocket::close_code::normal, yield[ec]);
+    if(ec)
+        return fail(ec, "close");
+
+    // If we get here then the connection is closed gracefully
+
+    // The buffers() function helps print a ConstBufferSequence
+    std::cout << boost::beast::buffers(b.data()) << std::endl;
+}
+
+//------------------------------------------------------------------------------
+
+int main(int argc, char** argv)
+{
+    // Check command line arguments.
+    if(argc != 4)
+    {
+        std::cerr <<
+            "Usage: websocket-client-coro <host> <port> <text>\n" <<
+            "Example:\n" <<
+            "    websocket-client-coro echo.websocket.org 80 \"Hello, world!\"\n";
+        return EXIT_FAILURE;
+    }
+    auto const host = argv[1];
+    auto const port = argv[2];
+    auto const text = argv[3];
+
+    // The io_service is required for all I/O
+    boost::asio::io_service ios;
+
+    // Launch the asynchronous operation
+    boost::asio::spawn(ios, std::bind(
+        &do_session,
+        std::string(host),
+        std::string(port),
+        std::string(text),
+        std::ref(ios),
+        std::placeholders::_1));
+
+    // Run the I/O service. The call will return when
+    // the get operation is complete.
+    ios.run();
+
+    return EXIT_SUCCESS;
+}
@@ -0,0 +1,23 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+GroupSources(include/boost/beast beast)
+GroupSources(example/common common)
+GroupSources(example/websocket/client/sync-ssl "/")
+
+add_executable (websocket-client-sync-ssl
+    ${BOOST_BEAST_INCLUDES}
+    ${PROJECT_SOURCE_DIR}/example/common/root_certificates.hpp
+    Jamfile
+    websocket_client_sync_ssl.cpp
+)
+
+target_link_libraries (websocket-client-sync-ssl
+    ${OPENSSL_LIBRARIES}
+    )
@@ -0,0 +1,21 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+project
+    : requirements
+    <library>ssl
+    <library>crypto
+    ;
+
+exe websocket-client-sync-ssl :
+    websocket_client_sync_ssl.cpp
+    :
+    <variant>coverage:<build>no
+    <variant>ubasan:<build>no
+    ;
@@ -0,0 +1,98 @@
+//
+// Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// Official repository: https://github.com/boostorg/beast
+//
+
+//------------------------------------------------------------------------------
+//
+// Example: WebSocket SSL client, synchronous
+//
+//------------------------------------------------------------------------------
+
+#include "example/common/root_certificates.hpp"
+
+#include <boost/beast/core.hpp>
+#include <boost/beast/websocket.hpp>
+#include <boost/beast/websocket/ssl.hpp>
+#include <boost/asio/connect.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <boost/asio/ssl/stream.hpp>
+#include <cstdlib>
+#include <iostream>
+#include <string>
+
+using tcp = boost::asio::ip::tcp;               // from <boost/asio/ip/tcp.hpp>
+namespace ssl = boost::asio::ssl;       // from <boost/asio/ssl.hpp>
+namespace websocket = boost::beast::websocket;  // from <boost/beast/websocket.hpp>
+
+// Sends a WebSocket message and prints the response
+int main(int argc, char** argv)
+{
+    try
+    {
+        // Check command line arguments.
+        if(argc != 4)
+        {
+            std::cerr <<
+                "Usage: websocket-client-sync-ssl <host> <port> <text>\n" <<
+                "Example:\n" <<
+                "    websocket-client-sync-ssl echo.websocket.org 443 \"Hello, world!\"\n";
+            return EXIT_FAILURE;
+        }
+        auto const host = argv[1];
+        auto const port = argv[2];
+        auto const text = argv[3];
+
+        // The io_service is required for all I/O
+        boost::asio::io_service ios;
+
+        // The SSL context is required, and holds certificates
+        ssl::context ctx{ssl::context::sslv23_client};
+
+        // This holds the root certificate used for verification
+        load_root_certificates(ctx);
+
+        // These objects perform our I/O
+        tcp::resolver resolver{ios};
+        websocket::stream<ssl::stream<tcp::socket>> ws{ios, ctx};
+
+        // Look up the domain name
+        auto const lookup = resolver.resolve({host, port});
+
+        // Make the connection on the IP address we get from a lookup
+        boost::asio::connect(ws.next_layer().next_layer(), lookup);
+
+        // Perform the SSL handshake
+        ws.next_layer().handshake(ssl::stream_base::client);
+
+        // Perform the websocket handshake
+        ws.handshake(host, "/");
+
+        // Send the message
+        ws.write(boost::asio::buffer(std::string(text)));
+
+        // This buffer will hold the incoming message
+        boost::beast::multi_buffer b;
+
+        // Read a message into our buffer
+        ws.read(b);
+
+        // Close the WebSocket connection
+        ws.close(websocket::close_code::normal);
+
+        // If we get here then the connection is closed gracefully
+
+        // The buffers() function helps print a ConstBufferSequence
+        std::cout << boost::beast::buffers(b.data()) << std::endl;
+    }
+    catch(std::exception const& e)
+    {
+        std::cerr << "Error: " << e.what() << std::endl;
+        return EXIT_FAILURE;
+    }
+    return EXIT_SUCCESS;
+}
@@ -0,0 +1,17 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+GroupSources(include/boost/beast beast)
+GroupSources(example/websocket/client/sync "/")
+
+add_executable (websocket-client-sync
+    ${BOOST_BEAST_INCLUDES}
+    Jamfile
+    websocket_client_sync.cpp
+)
@@ -0,0 +1,15 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+exe websocket-client-sync :
+    websocket_client_sync.cpp
+    :
+    <variant>coverage:<build>no
+    <variant>ubasan:<build>no
+    ;
@@ -0,0 +1,88 @@
+//
+// Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// Official repository: https://github.com/boostorg/beast
+//
+
+//------------------------------------------------------------------------------
+//
+// Example: WebSocket client, synchronous
+//
+//------------------------------------------------------------------------------
+
+//[example_websocket_client
+
+#include <boost/beast/core.hpp>
+#include <boost/beast/websocket.hpp>
+#include <boost/asio/connect.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <cstdlib>
+#include <iostream>
+#include <string>
+
+using tcp = boost::asio::ip::tcp;               // from <boost/asio/ip/tcp.hpp>
+namespace websocket = boost::beast::websocket;  // from <boost/beast/websocket.hpp>
+
+// Sends a WebSocket message and prints the response
+int main(int argc, char** argv)
+{
+    try
+    {
+        // Check command line arguments.
+        if(argc != 4)
+        {
+            std::cerr <<
+                "Usage: websocket-client-sync <host> <port> <text>\n" <<
+                "Example:\n" <<
+                "    websocket-client-sync echo.websocket.org 80 \"Hello, world!\"\n";
+            return EXIT_FAILURE;
+        }
+        auto const host = argv[1];
+        auto const port = argv[2];
+        auto const text = argv[3];
+
+        // The io_service is required for all I/O
+        boost::asio::io_service ios;
+
+        // These objects perform our I/O
+        tcp::resolver resolver{ios};
+        websocket::stream<tcp::socket> ws{ios};
+
+        // Look up the domain name
+        auto const lookup = resolver.resolve({host, port});
+
+        // Make the connection on the IP address we get from a lookup
+        boost::asio::connect(ws.next_layer(), lookup);
+
+        // Perform the websocket handshake
+        ws.handshake(host, "/");
+
+        // Send the message
+        ws.write(boost::asio::buffer(std::string(text)));
+
+        // This buffer will hold the incoming message
+        boost::beast::multi_buffer buffer;
+
+        // Read a message into our buffer
+        ws.read(buffer);
+
+        // Close the WebSocket connection
+        ws.close(websocket::close_code::normal);
+
+        // If we get here then the connection is closed gracefully
+
+        // The buffers() function helps print a ConstBufferSequence
+        std::cout << boost::beast::buffers(buffer.data()) << std::endl;
+    }
+    catch(std::exception const& e)
+    {
+        std::cerr << "Error: " << e.what() << std::endl;
+        return EXIT_FAILURE;
+    }
+    return EXIT_SUCCESS;
+}
+
+//]
@@ -0,0 +1,21 @@
+#
+# Copyright (c) 2013-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+add_subdirectory (async)
+add_subdirectory (coro)
+add_subdirectory (fast)
+add_subdirectory (stackless)
+add_subdirectory (sync)
+
+if (OPENSSL_FOUND)
+    add_subdirectory (async-ssl)
+    add_subdirectory (coro-ssl)
+    add_subdirectory (stackless-ssl)
+    add_subdirectory (sync-ssl)
+endif()
@@ -0,0 +1,20 @@
+#
+# Copyright (c) 2013-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+build-project async ;
+build-project coro ;
+build-project fast ;
+build-project stackless ;
+build-project sync ;
+
+# VFALCO How do I make this work on Windows and if OpenSSL is not available?
+#build-project async-ssl ;
+#build-project coro-ssl ;
+#build-project stackless-ssl ;
+#build-project sync-ssl ;
@@ -0,0 +1,23 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+GroupSources(include/boost/beast beast)
+GroupSources(example/common common)
+GroupSources(example/websocket/server/async-ssl "/")
+
+add_executable (websocket-server-async-ssl
+    ${BOOST_BEAST_INCLUDES}
+    ${PROJECT_SOURCE_DIR}/example/common/server_certificate.hpp
+    Jamfile
+    websocket_server_async_ssl.cpp
+)
+
+target_link_libraries (websocket-server-async-ssl
+    ${OPENSSL_LIBRARIES}
+    )
@@ -0,0 +1,21 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+project
+    : requirements
+    <library>ssl
+    <library>crypto
+    ;
+
+exe websocket-server-async-ssl :
+    websocket_server_async_ssl.cpp
+    :
+    <variant>coverage:<build>no
+    <variant>ubasan:<build>no
+    ;
@@ -0,0 +1,273 @@
+//
+// Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// Official repository: https://github.com/boostorg/beast
+//
+
+//------------------------------------------------------------------------------
+//
+// Example: WebSocket SSL server, asynchronous
+//
+//------------------------------------------------------------------------------
+
+#include "example/common/server_certificate.hpp"
+
+#include <boost/beast/core.hpp>
+#include <boost/beast/websocket.hpp>
+#include <boost/beast/websocket/ssl.hpp>
+#include <boost/asio/strand.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <boost/asio/ssl/stream.hpp>
+#include <algorithm>
+#include <cstdlib>
+#include <functional>
+#include <iostream>
+#include <memory>
+#include <string>
+#include <thread>
+#include <vector>
+
+using tcp = boost::asio::ip::tcp;               // from <boost/asio/ip/tcp.hpp>
+namespace ssl = boost::asio::ssl;               // from <boost/asio/ssl.hpp>
+namespace websocket = boost::beast::websocket;  // from <boost/beast/websocket.hpp>
+
+//------------------------------------------------------------------------------
+
+// Report a failure
+void
+fail(boost::system::error_code ec, char const* what)
+{
+    std::cerr << what << ": " << ec.message() << "\n";
+}
+
+// Echoes back all received WebSocket messages
+class session : public std::enable_shared_from_this<session>
+{
+    tcp::socket socket_;
+    websocket::stream<ssl::stream<tcp::socket&>> ws_;
+    boost::asio::io_service::strand strand_;
+    boost::beast::multi_buffer buffer_;
+
+public:
+    // Take ownership of the socket
+    session(tcp::socket socket, ssl::context& ctx)
+        : socket_(std::move(socket))
+        , ws_(socket_, ctx)
+        , strand_(ws_.get_io_service())
+    {
+    }
+
+    // Start the asynchronous operation
+    void
+    run()
+    {
+        // Perform the SSL handshake
+        ws_.next_layer().async_handshake(
+            ssl::stream_base::server,
+            strand_.wrap(std::bind(
+                &session::on_handshake,
+                shared_from_this(),
+                std::placeholders::_1)));
+    }
+
+    void
+    on_handshake(boost::system::error_code ec)
+    {
+        if(ec)
+            return fail(ec, "handshake");
+
+        // Accept the websocket handshake
+        ws_.async_accept(
+            strand_.wrap(std::bind(
+                &session::on_accept,
+                shared_from_this(),
+                std::placeholders::_1)));
+    }
+
+    void
+    on_accept(boost::system::error_code ec)
+    {
+        if(ec)
+            return fail(ec, "accept");
+
+        // Read a message
+        do_read();
+    }
+
+    void
+    do_read()
+    {
+        // Read a message into our buffer
+        ws_.async_read(
+            buffer_,
+            strand_.wrap(std::bind(
+                &session::on_read,
+                shared_from_this(),
+                std::placeholders::_1)));
+    }
+
+    void
+    on_read(boost::system::error_code ec)
+    {
+        // This indicates that the session was closed
+        if(ec == websocket::error::closed)
+            return;
+
+        if(ec)
+            fail(ec, "read");
+
+        // Echo the message
+        ws_.text(ws_.got_text());
+        ws_.async_write(
+            buffer_.data(),
+            strand_.wrap(std::bind(
+                &session::on_write,
+                shared_from_this(),
+                std::placeholders::_1)));
+    }
+
+    void
+    on_write(boost::system::error_code ec)
+    {
+        if(ec)
+            return fail(ec, "write");
+
+        // Clear the buffer
+        buffer_.consume(buffer_.size());
+
+        // Do another read
+        do_read();
+    }
+};
+
+//------------------------------------------------------------------------------
+
+// Accepts incoming connections and launches the sessions
+class listener : public std::enable_shared_from_this<listener>
+{
+    ssl::context& ctx_;
+    boost::asio::io_service::strand strand_;
+    tcp::acceptor acceptor_;
+    tcp::socket socket_;
+
+public:
+    listener(
+        boost::asio::io_service& ios,
+        ssl::context& ctx,
+        tcp::endpoint endpoint)
+        : ctx_(ctx)
+        , strand_(ios)
+        , acceptor_(ios)
+        , socket_(ios)
+    {
+        boost::system::error_code ec;
+
+        // Open the acceptor
+        acceptor_.open(endpoint.protocol(), ec);
+        if(ec)
+        {
+            fail(ec, "open");
+            return;
+        }
+
+        // Bind to the server address
+        acceptor_.bind(endpoint, ec);
+        if(ec)
+        {
+            fail(ec, "bind");
+            return;
+        }
+
+        // Start listening for connections
+        acceptor_.listen(
+            boost::asio::socket_base::max_connections, ec);
+        if(ec)
+        {
+            fail(ec, "listen");
+            return;
+        }
+    }
+
+    // Start accepting incoming connections
+    void
+    run()
+    {
+        if(! acceptor_.is_open())
+            return;
+        do_accept();
+    }
+
+    void
+    do_accept()
+    {
+        acceptor_.async_accept(
+            socket_,
+            std::bind(
+                &listener::on_accept,
+                shared_from_this(),
+                std::placeholders::_1));
+    }
+
+    void
+    on_accept(boost::system::error_code ec)
+    {
+        if(ec)
+        {
+            fail(ec, "accept");
+        }
+        else
+        {
+            // Create the session and run it
+            std::make_shared<session>(std::move(socket_), ctx_)->run();
+        }
+
+        // Accept another connection
+        do_accept();
+    }
+};
+
+//------------------------------------------------------------------------------
+
+int main(int argc, char* argv[])
+{
+    // Check command line arguments.
+    if (argc != 4)
+    {
+        std::cerr <<
+            "Usage: websocket-server-async-ssl <address> <port> <threads>\n" <<
+            "Example:\n" <<
+            "    websocket-server-async-ssl 0.0.0.0 8080 1\n";
+        return EXIT_FAILURE;
+    }
+    auto const address = boost::asio::ip::address::from_string(argv[1]);
+    auto const port = static_cast<unsigned short>(std::atoi(argv[2]));
+    auto const threads = std::max<std::size_t>(1, std::atoi(argv[3]));
+
+    // The io_service is required for all I/O
+    boost::asio::io_service ios{threads};
+    
+    // The SSL context is required, and holds certificates
+    ssl::context ctx{ssl::context::sslv23};
+
+    // This holds the self-signed certificate used by the server
+    load_server_certificate(ctx);
+
+    // Create and launch a listening port
+    std::make_shared<listener>(ios, ctx, tcp::endpoint{address, port})->run();
+
+    // Run the I/O service on the requested number of threads
+    std::vector<std::thread> v;
+    v.reserve(threads - 1);
+    for(auto i = threads - 1; i > 0; --i)
+        v.emplace_back(
+        [&ios]
+        {
+            ios.run();
+        });
+    ios.run();
+
+    return EXIT_SUCCESS;
+}
@@ -0,0 +1,17 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+GroupSources(include/boost/beast beast)
+GroupSources(example/websocket/server/async "/")
+
+add_executable (websocket-server-async
+    ${BOOST_BEAST_INCLUDES}
+    Jamfile
+    websocket_server_async.cpp
+)
@@ -0,0 +1,15 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+exe websocket-server-async :
+    websocket_server_async.cpp
+    :
+    <variant>coverage:<build>no
+    <variant>ubasan:<build>no
+    ;
@@ -0,0 +1,243 @@
+//
+// Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// Official repository: https://github.com/boostorg/beast
+//
+
+//------------------------------------------------------------------------------
+//
+// Example: WebSocket server, asynchronous
+//
+//------------------------------------------------------------------------------
+
+#include <boost/beast/core.hpp>
+#include <boost/beast/websocket.hpp>
+#include <boost/asio/strand.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <algorithm>
+#include <cstdlib>
+#include <functional>
+#include <iostream>
+#include <memory>
+#include <string>
+#include <thread>
+#include <vector>
+
+using tcp = boost::asio::ip::tcp;               // from <boost/asio/ip/tcp.hpp>
+namespace websocket = boost::beast::websocket;  // from <boost/beast/websocket.hpp>
+
+//------------------------------------------------------------------------------
+
+// Report a failure
+void
+fail(boost::system::error_code ec, char const* what)
+{
+    std::cerr << what << ": " << ec.message() << "\n";
+}
+
+// Echoes back all received WebSocket messages
+class session : public std::enable_shared_from_this<session>
+{
+    websocket::stream<tcp::socket> ws_;
+    boost::asio::io_service::strand strand_;
+    boost::beast::multi_buffer buffer_;
+
+public:
+    // Take ownership of the socket
+    explicit
+    session(tcp::socket socket)
+        : ws_(std::move(socket))
+        , strand_(ws_.get_io_service())
+    {
+    }
+
+    // Start the asynchronous operation
+    void
+    run()
+    {
+        // Accept the websocket handshake
+        ws_.async_accept(
+            strand_.wrap(std::bind(
+                &session::on_accept,
+                shared_from_this(),
+                std::placeholders::_1)));
+    }
+
+    void
+    on_accept(boost::system::error_code ec)
+    {
+        if(ec)
+            return fail(ec, "accept");
+
+        // Read a message
+        do_read();
+    }
+
+    void
+    do_read()
+    {
+        // Read a message into our buffer
+        ws_.async_read(
+            buffer_,
+            strand_.wrap(std::bind(
+                &session::on_read,
+                shared_from_this(),
+                std::placeholders::_1)));
+    }
+
+    void
+    on_read(boost::system::error_code ec)
+    {
+        // This indicates that the session was closed
+        if(ec == websocket::error::closed)
+            return;
+
+        if(ec)
+            fail(ec, "read");
+
+        // Echo the message
+        ws_.text(ws_.got_text());
+        ws_.async_write(
+            buffer_.data(),
+            strand_.wrap(std::bind(
+                &session::on_write,
+                shared_from_this(),
+                std::placeholders::_1)));
+    }
+
+    void
+    on_write(boost::system::error_code ec)
+    {
+        if(ec)
+            return fail(ec, "write");
+
+        // Clear the buffer
+        buffer_.consume(buffer_.size());
+
+        // Do another read
+        do_read();
+    }
+};
+
+//------------------------------------------------------------------------------
+
+// Accepts incoming connections and launches the sessions
+class listener : public std::enable_shared_from_this<listener>
+{
+    boost::asio::io_service::strand strand_;
+    tcp::acceptor acceptor_;
+    tcp::socket socket_;
+
+public:
+    listener(
+        boost::asio::io_service& ios,
+        tcp::endpoint endpoint)
+        : strand_(ios)
+        , acceptor_(ios)
+        , socket_(ios)
+    {
+        boost::system::error_code ec;
+
+        // Open the acceptor
+        acceptor_.open(endpoint.protocol(), ec);
+        if(ec)
+        {
+            fail(ec, "open");
+            return;
+        }
+
+        // Bind to the server address
+        acceptor_.bind(endpoint, ec);
+        if(ec)
+        {
+            fail(ec, "bind");
+            return;
+        }
+
+        // Start listening for connections
+        acceptor_.listen(
+            boost::asio::socket_base::max_connections, ec);
+        if(ec)
+        {
+            fail(ec, "listen");
+            return;
+        }
+    }
+
+    // Start accepting incoming connections
+    void
+    run()
+    {
+        if(! acceptor_.is_open())
+            return;
+        do_accept();
+    }
+
+    void
+    do_accept()
+    {
+        acceptor_.async_accept(
+            socket_,
+            strand_.wrap(std::bind(
+                &listener::on_accept,
+                shared_from_this(),
+                std::placeholders::_1)));
+    }
+
+    void
+    on_accept(boost::system::error_code ec)
+    {
+        if(ec)
+        {
+            fail(ec, "accept");
+        }
+        else
+        {
+            // Create the session and run it
+            std::make_shared<session>(std::move(socket_))->run();
+        }
+
+        // Accept another connection
+        do_accept();
+    }
+};
+
+//------------------------------------------------------------------------------
+
+int main(int argc, char* argv[])
+{
+    // Check command line arguments.
+    if (argc != 4)
+    {
+        std::cerr <<
+            "Usage: websocket-server-async <address> <port> <threads>\n" <<
+            "Example:\n" <<
+            "    websocket-server-async 0.0.0.0 8080 1\n";
+        return EXIT_FAILURE;
+    }
+    auto const address = boost::asio::ip::address::from_string(argv[1]);
+    auto const port = static_cast<unsigned short>(std::atoi(argv[2]));
+    auto const threads = std::max<std::size_t>(1, std::atoi(argv[3]));
+
+    // The io_service is required for all I/O
+    boost::asio::io_service ios{threads};
+
+    // Create and launch a listening port
+    std::make_shared<listener>(ios, tcp::endpoint{address, port})->run();
+
+    // Run the I/O service on the requested number of threads
+    std::vector<std::thread> v;
+    v.reserve(threads - 1);
+    for(auto i = threads - 1; i > 0; --i)
+        v.emplace_back(
+        [&ios]
+        {
+            ios.run();
+        });
+    ios.run();
+
+    return EXIT_SUCCESS;
+}
@@ -0,0 +1,23 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+GroupSources(include/boost/beast beast)
+GroupSources(example/common common)
+GroupSources(example/websocket/server/coro-ssl "/")
+
+add_executable (websocket-server-coro-ssl
+    ${BOOST_BEAST_INCLUDES}
+    ${PROJECT_SOURCE_DIR}/example/common/server_certificate.hpp
+    Jamfile
+    websocket_server_coro_ssl.cpp
+)
+
+target_link_libraries (websocket-server-coro-ssl
+    ${OPENSSL_LIBRARIES}
+    )
@@ -0,0 +1,21 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+project
+    : requirements
+    <library>ssl
+    <library>crypto
+    ;
+
+exe websocket-server-coro-ssl :
+    websocket_server_coro_ssl.cpp
+    :
+    <variant>coverage:<build>no
+    <variant>ubasan:<build>no
+    ;
@@ -0,0 +1,181 @@
+//
+// Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// Official repository: https://github.com/boostorg/beast
+//
+
+//------------------------------------------------------------------------------
+//
+// Example: WebSocket SSL server, coroutine
+//
+//------------------------------------------------------------------------------
+
+#include "example/common/server_certificate.hpp"
+
+#include <boost/beast/core.hpp>
+#include <boost/beast/websocket.hpp>
+#include <boost/beast/websocket/ssl.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <boost/asio/spawn.hpp>
+#include <boost/asio/ssl/stream.hpp>
+#include <algorithm>
+#include <cstdlib>
+#include <functional>
+#include <iostream>
+#include <memory>
+#include <string>
+#include <thread>
+#include <vector>
+
+using tcp = boost::asio::ip::tcp;               // from <boost/asio/ip/tcp.hpp>
+namespace ssl = boost::asio::ssl;               // from <boost/asio/ssl.hpp>
+namespace websocket = boost::beast::websocket;  // from <boost/beast/websocket.hpp>
+
+//------------------------------------------------------------------------------
+
+// Report a failure
+void
+fail(boost::system::error_code ec, char const* what)
+{
+    std::cerr << what << ": " << ec.message() << "\n";
+}
+
+// Echoes back all received WebSocket messages
+void
+do_session(
+    tcp::socket& socket,
+    ssl::context& ctx,
+    boost::asio::yield_context yield)
+{
+    boost::system::error_code ec;
+
+    // Construct the stream by moving in the socket
+    websocket::stream<ssl::stream<tcp::socket&>> ws{socket, ctx};
+
+    // Perform the SSL handshake
+    ws.next_layer().async_handshake(ssl::stream_base::server, yield[ec]);
+    if(ec)
+        return fail(ec, "handshake");
+
+    // Accept the websocket handshake
+    ws.async_accept(yield[ec]);
+    if(ec)
+        return fail(ec, "accept");
+
+    for(;;)
+    {
+        // This buffer will hold the incoming message
+        boost::beast::multi_buffer buffer;
+
+        // Read a message
+        ws.async_read(buffer, yield[ec]);
+
+        // This indicates that the session was closed
+        if(ec == websocket::error::closed)
+            break;
+
+        if(ec)
+            return fail(ec, "read");
+
+        // Echo the message back
+        ws.text(ws.got_text());
+        ws.async_write(buffer.data(), yield[ec]);
+        if(ec)
+            return fail(ec, "write");
+    }
+}
+
+//------------------------------------------------------------------------------
+
+// Accepts incoming connections and launches the sessions
+void
+do_listen(
+    boost::asio::io_service& ios,
+    ssl::context& ctx,
+    tcp::endpoint endpoint,
+    boost::asio::yield_context yield)
+{
+    boost::system::error_code ec;
+
+    // Open the acceptor
+    tcp::acceptor acceptor(ios);
+    acceptor.open(endpoint.protocol(), ec);
+    if(ec)
+        return fail(ec, "open");
+
+    // Bind to the server address
+    acceptor.bind(endpoint, ec);
+    if(ec)
+        return fail(ec, "bind");
+
+    // Start listening for connections
+    acceptor.listen(boost::asio::socket_base::max_connections, ec);
+    if(ec)
+        return fail(ec, "listen");
+
+    for(;;)
+    {
+        tcp::socket socket(ios);
+        acceptor.async_accept(socket, yield[ec]);
+        if(ec)
+            fail(ec, "accept");
+        else
+            boost::asio::spawn(
+                acceptor.get_io_service(),
+                std::bind(
+                    &do_session,
+                    std::move(socket),
+                    std::ref(ctx),
+                    std::placeholders::_1));
+    }
+}
+
+int main(int argc, char* argv[])
+{
+    // Check command line arguments.
+    if (argc != 4)
+    {
+        std::cerr <<
+            "Usage: websocket-server-coro-ssl <address> <port> <threads>\n" <<
+            "Example:\n" <<
+            "    websocket-server-coro-ssl 0.0.0.0 8080 1\n";
+        return EXIT_FAILURE;
+    }
+    auto const address = boost::asio::ip::address::from_string(argv[1]);
+    auto const port = static_cast<unsigned short>(std::atoi(argv[2]));
+    auto const threads = std::max<std::size_t>(1, std::atoi(argv[3]));
+
+    // The io_service is required for all I/O
+    boost::asio::io_service ios{threads};
+
+    // The SSL context is required, and holds certificates
+    ssl::context ctx{ssl::context::sslv23};
+
+    // This holds the self-signed certificate used by the server
+    load_server_certificate(ctx);
+
+    // Spawn a listening port
+    boost::asio::spawn(ios,
+        std::bind(
+            &do_listen,
+            std::ref(ios),
+            std::ref(ctx),
+            tcp::endpoint{address, port},
+            std::placeholders::_1));
+
+    // Run the I/O service on the requested number of threads
+    std::vector<std::thread> v;
+    v.reserve(threads - 1);
+    for(auto i = threads - 1; i > 0; --i)
+        v.emplace_back(
+        [&ios]
+        {
+            ios.run();
+        });
+    ios.run();
+
+    return EXIT_SUCCESS;
+}
@@ -0,0 +1,17 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+GroupSources(include/boost/beast beast)
+GroupSources(example/websocket/server/coro "/")
+
+add_executable (websocket-server-coro
+    ${BOOST_BEAST_INCLUDES}
+    Jamfile
+    websocket_server_coro.cpp
+)
@@ -0,0 +1,15 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+exe websocket-server-coro :
+    websocket_server_coro.cpp
+    :
+    <variant>coverage:<build>no
+    <variant>ubasan:<build>no
+    ;
@@ -0,0 +1,159 @@
+//
+// Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// Official repository: https://github.com/boostorg/beast
+//
+
+//------------------------------------------------------------------------------
+//
+// Example: WebSocket server, coroutine
+//
+//------------------------------------------------------------------------------
+
+#include <boost/beast/core.hpp>
+#include <boost/beast/websocket.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <boost/asio/spawn.hpp>
+#include <algorithm>
+#include <cstdlib>
+#include <functional>
+#include <iostream>
+#include <memory>
+#include <string>
+#include <thread>
+#include <vector>
+
+using tcp = boost::asio::ip::tcp;               // from <boost/asio/ip/tcp.hpp>
+namespace websocket = boost::beast::websocket;  // from <boost/beast/websocket.hpp>
+
+//------------------------------------------------------------------------------
+
+// Report a failure
+void
+fail(boost::system::error_code ec, char const* what)
+{
+    std::cerr << what << ": " << ec.message() << "\n";
+}
+
+// Echoes back all received WebSocket messages
+void
+do_session(tcp::socket& socket, boost::asio::yield_context yield)
+{
+    boost::system::error_code ec;
+
+    // Construct the stream by moving in the socket
+    websocket::stream<tcp::socket> ws{std::move(socket)};
+
+    // Accept the websocket handshake
+    ws.async_accept(yield[ec]);
+    if(ec)
+        return fail(ec, "accept");
+
+    for(;;)
+    {
+        // This buffer will hold the incoming message
+        boost::beast::multi_buffer buffer;
+
+        // Read a message
+        ws.async_read(buffer, yield[ec]);
+
+        // This indicates that the session was closed
+        if(ec == websocket::error::closed)
+            break;
+
+        if(ec)
+            return fail(ec, "read");
+
+        // Echo the message back
+        ws.text(ws.got_text());
+        ws.async_write(buffer.data(), yield[ec]);
+        if(ec)
+            return fail(ec, "write");
+    }
+}
+
+//------------------------------------------------------------------------------
+
+// Accepts incoming connections and launches the sessions
+void
+do_listen(
+    boost::asio::io_service& ios,
+    tcp::endpoint endpoint,
+    boost::asio::yield_context yield)
+{
+    boost::system::error_code ec;
+
+    // Open the acceptor
+    tcp::acceptor acceptor(ios);
+    acceptor.open(endpoint.protocol(), ec);
+    if(ec)
+        return fail(ec, "open");
+
+    // Bind to the server address
+    acceptor.bind(endpoint, ec);
+    if(ec)
+        return fail(ec, "bind");
+
+    // Start listening for connections
+    acceptor.listen(boost::asio::socket_base::max_connections, ec);
+    if(ec)
+        return fail(ec, "listen");
+
+    for(;;)
+    {
+        tcp::socket socket(ios);
+        acceptor.async_accept(socket, yield[ec]);
+        if(ec)
+            fail(ec, "accept");
+        else
+            boost::asio::spawn(
+                acceptor.get_io_service(),
+                std::bind(
+                    &do_session,
+                    std::move(socket),
+                    std::placeholders::_1));
+    }
+}
+
+int main(int argc, char* argv[])
+{
+    // Check command line arguments.
+    if (argc != 4)
+    {
+        std::cerr <<
+            "Usage: websocket-server-coro <address> <port> <threads>\n" <<
+            "Example:\n" <<
+            "    websocket-server-coro 0.0.0.0 8080 1\n";
+        return EXIT_FAILURE;
+    }
+    auto const address = boost::asio::ip::address::from_string(argv[1]);
+    auto const port = static_cast<unsigned short>(std::atoi(argv[2]));
+    auto const threads = std::max<std::size_t>(1, std::atoi(argv[3]));
+
+    // The io_service is required for all I/O
+    boost::asio::io_service ios{threads};
+
+    // Spawn a listening port
+    boost::asio::spawn(ios,
+        std::bind(
+            &do_listen,
+            std::ref(ios),
+            tcp::endpoint{address, port},
+            std::placeholders::_1));
+
+    // Run the I/O service on the requested number of threads
+    std::vector<std::thread> v;
+    v.reserve(threads - 1);
+    for(auto i = threads - 1; i > 0; --i)
+        v.emplace_back(
+        [&ios]
+        {
+            ios.run();
+        });
+    ios.run();
+
+    return EXIT_SUCCESS;
+}
@@ -0,0 +1,17 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+GroupSources(include/boost/beast beast)
+GroupSources(example/websocket/server/fast "/")
+
+add_executable (websocket-server-fast
+    ${BOOST_BEAST_INCLUDES}
+    Jamfile
+    websocket_server_fast.cpp
+)
@@ -0,0 +1,15 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+exe websocket-server-fast :
+    websocket_server_fast.cpp
+    :
+    <variant>coverage:<build>no
+    <variant>ubasan:<build>no
+    ;
@@ -0,0 +1,449 @@
+//
+// Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// Official repository: https://github.com/boostorg/beast
+//
+
+//------------------------------------------------------------------------------
+//
+// Example: WebSocket server, fast
+//
+//------------------------------------------------------------------------------
+
+/*  This server contains the following ports:
+
+    Synchronous     <base port + 0>
+    Asynchronous    <base port + 1>
+    Coroutine       <base port + 2>
+
+    This program is optimized for the Autobahn|Testsuite
+    benchmarking and WebSocket compliants testing program.
+
+    See:
+    https://github.com/crossbario/autobahn-testsuite
+*/
+
+#include <boost/beast/core.hpp>
+#include <boost/beast/http.hpp>
+#include <boost/beast/version.hpp>
+#include <boost/beast/websocket.hpp>
+#include <boost/asio/spawn.hpp>
+#include <boost/asio/strand.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <algorithm>
+#include <cstdlib>
+#include <functional>
+#include <iostream>
+#include <memory>
+#include <string>
+#include <thread>
+#include <vector>
+
+using tcp = boost::asio::ip::tcp;               // from <boost/asio/ip/tcp.hpp>
+namespace http = boost::beast::http;            // from <boost/beast/http.hpp>
+namespace websocket = boost::beast::websocket;  // from <boost/beast/websocket.hpp>
+
+//------------------------------------------------------------------------------
+
+// Report a failure
+void
+fail(boost::system::error_code ec, char const* what)
+{
+    std::cerr << (std::string(what) + ": " + ec.message() + "\n");
+}
+
+// Adjust settings on the stream
+template<class NextLayer>
+void
+setup_stream(websocket::stream<NextLayer>& ws)
+{
+    // These values are tuned for Autobahn|Testsuite, and
+    // should also be generally helpful for increased performance.
+
+    websocket::permessage_deflate pmd;
+    pmd.client_enable = true;
+    pmd.server_enable = true;
+    pmd.compLevel = 3;
+    ws.set_option(pmd);
+
+    ws.auto_fragment(false);
+
+    // Autobahn|Testsuite needs this
+    ws.read_message_max(64 * 1024 * 1024);
+}
+
+//------------------------------------------------------------------------------
+
+void
+do_sync_session(tcp::socket& socket)
+{
+    boost::system::error_code ec;
+
+    websocket::stream<tcp::socket> ws{std::move(socket)};
+    setup_stream(ws);
+
+    ws.accept_ex(
+        [](websocket::response_type& res)
+        {
+            res.set(http::field::server,
+                "Boost.Beast.sync/" + std::to_string(BOOST_BEAST_VERSION));
+        },
+        ec);
+    if(ec)
+        return fail(ec, "accept");
+
+    for(;;)
+    {
+        boost::beast::multi_buffer buffer;
+        
+        ws.read(buffer, ec);
+        if(ec == websocket::error::closed)
+            break;
+        if(ec)
+            return fail(ec, "read");
+
+        ws.text(ws.got_text());
+        ws.write(buffer.data(), ec);
+        if(ec)
+            return fail(ec, "write");
+    }
+}
+
+void
+do_sync_listen(
+    boost::asio::io_service& ios,
+    tcp::endpoint endpoint)
+{
+    boost::system::error_code ec;
+    tcp::acceptor acceptor{ios, endpoint};
+    for(;;)
+    {
+        tcp::socket socket{ios};
+
+        acceptor.accept(socket, ec);
+        if(ec)
+            return fail(ec, "accept");
+
+        std::thread{std::bind(
+            &do_sync_session,
+            std::move(socket))}.detach();
+    }
+}
+
+//------------------------------------------------------------------------------
+
+// Echoes back all received WebSocket messages
+class async_session : public std::enable_shared_from_this<async_session>
+{
+    websocket::stream<tcp::socket> ws_;
+    boost::asio::io_service::strand strand_;
+    boost::beast::multi_buffer buffer_;
+
+public:
+    // Take ownership of the socket
+    explicit
+    async_session(tcp::socket socket)
+        : ws_(std::move(socket))
+        , strand_(ws_.get_io_service())
+    {
+        setup_stream(ws_);
+    }
+
+    // Start the asynchronous operation
+    void
+    run()
+    {
+        // Accept the websocket handshake
+        ws_.async_accept_ex(
+            [](websocket::response_type& res)
+            {
+                res.set(http::field::server,
+                    "Boost.Beast.async/" + std::to_string(BOOST_BEAST_VERSION));
+            },
+            strand_.wrap(std::bind(
+                &async_session::on_accept,
+                shared_from_this(),
+                std::placeholders::_1)));
+    }
+
+    void
+    on_accept(boost::system::error_code ec)
+    {
+        if(ec)
+            return fail(ec, "accept");
+
+        // Read a message
+        do_read();
+    }
+
+    void
+    do_read()
+    {
+        // Read a message into our buffer
+        ws_.async_read(
+            buffer_,
+            strand_.wrap(std::bind(
+                &async_session::on_read,
+                shared_from_this(),
+                std::placeholders::_1)));
+    }
+
+    void
+    on_read(boost::system::error_code ec)
+    {
+        // This indicates that the async_session was closed
+        if(ec == websocket::error::closed)
+            return;
+
+        if(ec)
+            fail(ec, "read");
+
+        // Echo the message
+        ws_.text(ws_.got_text());
+        ws_.async_write(
+            buffer_.data(),
+            strand_.wrap(std::bind(
+                &async_session::on_write,
+                shared_from_this(),
+                std::placeholders::_1)));
+    }
+
+    void
+    on_write(boost::system::error_code ec)
+    {
+        if(ec)
+            return fail(ec, "write");
+
+        // Clear the buffer
+        buffer_.consume(buffer_.size());
+
+        // Do another read
+        do_read();
+    }
+};
+
+// Accepts incoming connections and launches the sessions
+class async_listener : public std::enable_shared_from_this<async_listener>
+{
+    boost::asio::io_service::strand strand_;
+    tcp::acceptor acceptor_;
+    tcp::socket socket_;
+
+public:
+    async_listener(
+        boost::asio::io_service& ios,
+        tcp::endpoint endpoint)
+        : strand_(ios)
+        , acceptor_(ios)
+        , socket_(ios)
+    {
+        boost::system::error_code ec;
+
+        // Open the acceptor
+        acceptor_.open(endpoint.protocol(), ec);
+        if(ec)
+        {
+            fail(ec, "open");
+            return;
+        }
+
+        // Bind to the server address
+        acceptor_.bind(endpoint, ec);
+        if(ec)
+        {
+            fail(ec, "bind");
+            return;
+        }
+
+        // Start listening for connections
+        acceptor_.listen(
+            boost::asio::socket_base::max_connections, ec);
+        if(ec)
+        {
+            fail(ec, "listen");
+            return;
+        }
+    }
+
+    // Start accepting incoming connections
+    void
+    run()
+    {
+        if(! acceptor_.is_open())
+            return;
+        do_accept();
+    }
+
+    void
+    do_accept()
+    {
+        acceptor_.async_accept(
+            socket_,
+            strand_.wrap(std::bind(
+                &async_listener::on_accept,
+                shared_from_this(),
+                std::placeholders::_1)));
+    }
+
+    void
+    on_accept(boost::system::error_code ec)
+    {
+        if(ec)
+        {
+            fail(ec, "accept");
+        }
+        else
+        {
+            // Create the async_session and run it
+            std::make_shared<async_session>(std::move(socket_))->run();
+        }
+
+        // Accept another connection
+        do_accept();
+    }
+};
+
+//------------------------------------------------------------------------------
+
+void
+do_coro_session(tcp::socket& socket, boost::asio::yield_context yield)
+{
+    boost::system::error_code ec;
+
+    websocket::stream<tcp::socket> ws{std::move(socket)};
+    setup_stream(ws);
+
+    ws.async_accept_ex(
+        [&](websocket::response_type& res)
+        {
+            res.set(http::field::server,
+                "Boost.Beast.coro/" + std::to_string(BOOST_BEAST_VERSION));
+        },
+        yield[ec]);
+    if(ec)
+        return fail(ec, "accept");
+
+    for(;;)
+    {
+        boost::beast::multi_buffer buffer;
+
+        ws.async_read(buffer, yield[ec]);
+        if(ec == websocket::error::closed)
+            break;
+        if(ec)
+            return fail(ec, "read");
+
+        ws.text(ws.got_text());
+        ws.async_write(buffer.data(), yield[ec]);
+        if(ec)
+            return fail(ec, "write");
+    }
+}
+
+void
+do_coro_listen(
+    boost::asio::io_service& ios,
+    tcp::endpoint endpoint,
+    boost::asio::yield_context yield)
+{
+    boost::system::error_code ec;
+
+    tcp::acceptor acceptor(ios);
+    acceptor.open(endpoint.protocol(), ec);
+    if(ec)
+        return fail(ec, "open");
+
+    acceptor.bind(endpoint, ec);
+    if(ec)
+        return fail(ec, "bind");
+
+    acceptor.listen(boost::asio::socket_base::max_connections, ec);
+    if(ec)
+        return fail(ec, "listen");
+
+    for(;;)
+    {
+        tcp::socket socket(ios);
+
+        acceptor.async_accept(socket, yield[ec]);
+        if(ec)
+        {
+            fail(ec, "accept");
+            continue;
+        }
+
+        boost::asio::spawn(
+            acceptor.get_io_service(),
+            std::bind(
+                &do_coro_session,
+                std::move(socket),
+                std::placeholders::_1));
+    }
+}
+
+//------------------------------------------------------------------------------
+
+int main(int argc, char* argv[])
+{
+    // Check command line arguments.
+    if (argc != 4)
+    {
+        std::cerr <<
+            "Usage: websocket-server-fast <address> <starting-port> <threads>\n" <<
+            "Example:\n"
+            "    websocket-server-fast 0.0.0.0 8080 1\n"
+            "  Connect to:\n"
+            "    starting-port+0 for synchronous,\n"
+            "    starting-port+1 for asynchronous,\n"
+            "    starting-port+2 for coroutine.\n";
+        return EXIT_FAILURE;
+    }
+    auto const address = boost::asio::ip::address::from_string(argv[1]);
+    auto const port = static_cast<unsigned short>(std::atoi(argv[2]));
+    auto const threads = std::max<std::size_t>(1, std::atoi(argv[3]));
+
+    // The io_service is required for all I/O
+    boost::asio::io_service ios{threads};
+
+    // Create sync port
+    std::thread(std::bind(
+        &do_sync_listen,
+        std::ref(ios),
+        tcp::endpoint{
+            address,
+            static_cast<unsigned short>(port + 0u)}
+                )).detach();
+
+    // Create async port
+    std::make_shared<async_listener>(
+        ios,
+        tcp::endpoint{
+            address,
+            static_cast<unsigned short>(port + 1u)})->run();
+
+    // Create coro port
+    boost::asio::spawn(ios,
+        std::bind(
+            &do_coro_listen,
+            std::ref(ios),
+            tcp::endpoint{
+                address,
+                static_cast<unsigned short>(port + 2u)},
+            std::placeholders::_1));
+
+    // Run the I/O service on the requested number of threads
+    std::vector<std::thread> v;
+    v.reserve(threads - 1);
+    for(auto i = threads - 1; i > 0; --i)
+        v.emplace_back(
+        [&ios]
+        {
+            ios.run();
+        });
+    ios.run();
+
+    return EXIT_SUCCESS;
+}
@@ -0,0 +1,23 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+GroupSources(include/boost/beast beast)
+GroupSources(example/common common)
+GroupSources(example/websocket/server/stackless-ssl "/")
+
+add_executable (websocket-server-stackless-ssl
+    ${BOOST_BEAST_INCLUDES}
+    ${PROJECT_SOURCE_DIR}/example/common/server_certificate.hpp
+    Jamfile
+    websocket_server_stackless_ssl.cpp
+)
+
+target_link_libraries (websocket-server-stackless-ssl
+    ${OPENSSL_LIBRARIES}
+    )
@@ -0,0 +1,21 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+project
+    : requirements
+    <library>ssl
+    <library>crypto
+    ;
+
+exe websocket-server-stackless-ssl :
+    websocket_server_stackless_ssl.cpp
+    :
+    <variant>coverage:<build>no
+    <variant>ubasan:<build>no
+    ;
@@ -0,0 +1,263 @@
+//
+// Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// Official repository: https://github.com/boostorg/beast
+//
+
+//------------------------------------------------------------------------------
+//
+// Example: WebSocket SSL server, stackless coroutine
+//
+//------------------------------------------------------------------------------
+
+#include "example/common/server_certificate.hpp"
+
+#include <boost/beast/core.hpp>
+#include <boost/beast/websocket.hpp>
+#include <boost/beast/websocket/ssl.hpp>
+#include <boost/asio/coroutine.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <boost/asio/ssl/stream.hpp>
+#include <boost/asio/strand.hpp>
+#include <algorithm>
+#include <cstdlib>
+#include <functional>
+#include <iostream>
+#include <memory>
+#include <string>
+#include <thread>
+#include <vector>
+
+using tcp = boost::asio::ip::tcp;               // from <boost/asio/ip/tcp.hpp>
+namespace ssl = boost::asio::ssl;               // from <boost/asio/ssl.hpp>
+namespace websocket = boost::beast::websocket;  // from <boost/beast/websocket.hpp>
+
+//------------------------------------------------------------------------------
+
+// Report a failure
+void
+fail(boost::system::error_code ec, char const* what)
+{
+    std::cerr << what << ": " << ec.message() << "\n";
+}
+
+// Echoes back all received WebSocket messages
+class session
+    : public boost::asio::coroutine
+    , public std::enable_shared_from_this<session>
+{
+    tcp::socket socket_;
+    websocket::stream<ssl::stream<tcp::socket&>> ws_;
+    boost::asio::io_service::strand strand_;
+    boost::beast::multi_buffer buffer_;
+
+public:
+    // Take ownership of the socket
+    session(tcp::socket socket, ssl::context& ctx)
+        : socket_(std::move(socket))
+        , ws_(socket_, ctx)
+        , strand_(ws_.get_io_service())
+    {
+    }
+
+    // Start the asynchronous operation
+    void
+    run()
+    {
+        loop();
+    }
+
+#include <boost/asio/yield.hpp>
+    void
+    loop(boost::system::error_code ec = {})
+    {
+        reenter(*this)
+        {
+            // Perform the SSL handshake
+            yield ws_.next_layer().async_handshake(
+                ssl::stream_base::server,
+                strand_.wrap(std::bind(
+                    &session::loop,
+                    shared_from_this(),
+                    std::placeholders::_1)));
+            if(ec)
+                return fail(ec, "handshake");
+
+            // Accept the websocket handshake
+            yield ws_.async_accept(
+                strand_.wrap(std::bind(
+                    &session::loop,
+                    shared_from_this(),
+                    std::placeholders::_1)));
+            if(ec)
+                return fail(ec, "accept");
+
+            for(;;)
+            {
+                // Read a message into our buffer
+                yield ws_.async_read(
+                    buffer_,
+                    strand_.wrap(std::bind(
+                        &session::loop,
+                        shared_from_this(),
+                        std::placeholders::_1)));
+                if(ec == websocket::error::closed)
+                {
+                    // This indicates that the session was closed
+                    return;
+                }
+                if(ec)
+                    fail(ec, "read");
+
+                // Echo the message
+                ws_.text(ws_.got_text());
+                yield ws_.async_write(
+                    buffer_.data(),
+                    strand_.wrap(std::bind(
+                        &session::loop,
+                        shared_from_this(),
+                        std::placeholders::_1)));
+                if(ec)
+                    return fail(ec, "write");
+
+                // Clear the buffer
+                buffer_.consume(buffer_.size());
+            }
+        }
+    }
+#include <boost/asio/unyield.hpp>
+};
+
+//------------------------------------------------------------------------------
+
+// Accepts incoming connections and launches the sessions
+class listener
+    : public boost::asio::coroutine
+    , public std::enable_shared_from_this<listener>
+{
+    ssl::context& ctx_;
+    boost::asio::io_service::strand strand_;
+    tcp::acceptor acceptor_;
+    tcp::socket socket_;
+
+public:
+    listener(
+        boost::asio::io_service& ios,
+        ssl::context& ctx,
+        tcp::endpoint endpoint)
+        : ctx_(ctx)
+        , strand_(ios)
+        , acceptor_(ios)
+        , socket_(ios)
+    {
+        boost::system::error_code ec;
+
+        // Open the acceptor
+        acceptor_.open(endpoint.protocol(), ec);
+        if(ec)
+        {
+            fail(ec, "open");
+            return;
+        }
+
+        // Bind to the server address
+        acceptor_.bind(endpoint, ec);
+        if(ec)
+        {
+            fail(ec, "bind");
+            return;
+        }
+
+        // Start listening for connections
+        acceptor_.listen(
+            boost::asio::socket_base::max_connections, ec);
+        if(ec)
+        {
+            fail(ec, "listen");
+            return;
+        }
+    }
+
+    // Start accepting incoming connections
+    void
+    run()
+    {
+        if(! acceptor_.is_open())
+            return;
+        loop();
+    }
+
+#include <boost/asio/yield.hpp>
+    void
+    loop(boost::system::error_code ec = {})
+    {
+        reenter(*this)
+        {
+            for(;;)
+            {
+                yield acceptor_.async_accept(
+                    socket_,
+                    std::bind(
+                        &listener::loop,
+                        shared_from_this(),
+                        std::placeholders::_1));
+                if(ec)
+                {
+                    fail(ec, "accept");
+                }
+                else
+                {
+                    // Create the session and run it
+                    std::make_shared<session>(std::move(socket_), ctx_)->run();
+                }
+            }
+        }
+    }
+#include <boost/asio/unyield.hpp>
+};
+
+//------------------------------------------------------------------------------
+
+int main(int argc, char* argv[])
+{
+    // Check command line arguments.
+    if (argc != 4)
+    {
+        std::cerr <<
+            "Usage: websocket-server-async-ssl <address> <port> <threads>\n" <<
+            "Example:\n" <<
+            "    websocket-server-async-ssl 0.0.0.0 8080 1\n";
+        return EXIT_FAILURE;
+    }
+    auto const address = boost::asio::ip::address::from_string(argv[1]);
+    auto const port = static_cast<unsigned short>(std::atoi(argv[2]));
+    auto const threads = std::max<std::size_t>(1, std::atoi(argv[3]));
+
+    // The io_service is required for all I/O
+    boost::asio::io_service ios{threads};
+    
+    // The SSL context is required, and holds certificates
+    ssl::context ctx{ssl::context::sslv23};
+
+    // This holds the self-signed certificate used by the server
+    load_server_certificate(ctx);
+
+    // Create and launch a listening port
+    std::make_shared<listener>(ios, ctx, tcp::endpoint{address, port})->run();
+
+    // Run the I/O service on the requested number of threads
+    std::vector<std::thread> v;
+    v.reserve(threads - 1);
+    for(auto i = threads - 1; i > 0; --i)
+        v.emplace_back(
+        [&ios]
+        {
+            ios.run();
+        });
+    ios.run();
+
+    return EXIT_SUCCESS;
+}
@@ -0,0 +1,17 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+GroupSources(include/boost/beast beast)
+GroupSources(example/websocket/server/stackless "/")
+
+add_executable (websocket-server-stackless
+    ${BOOST_BEAST_INCLUDES}
+    Jamfile
+    websocket_server_stackless.cpp
+)
@@ -0,0 +1,15 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+exe websocket-server-stackless :
+    websocket_server_stackless.cpp
+    :
+    <variant>coverage:<build>no
+    <variant>ubasan:<build>no
+    ;
@@ -0,0 +1,238 @@
+//
+// Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// Official repository: https://github.com/boostorg/beast
+//
+
+//------------------------------------------------------------------------------
+//
+// Example: WebSocket server, stackless coroutine
+//
+//------------------------------------------------------------------------------
+
+#include <boost/beast/core.hpp>
+#include <boost/beast/websocket.hpp>
+#include <boost/asio/coroutine.hpp>
+#include <boost/asio/strand.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <algorithm>
+#include <cstdlib>
+#include <functional>
+#include <iostream>
+#include <memory>
+#include <string>
+#include <thread>
+#include <vector>
+
+using tcp = boost::asio::ip::tcp;               // from <boost/asio/ip/tcp.hpp>
+namespace websocket = boost::beast::websocket;  // from <boost/beast/websocket.hpp>
+
+//------------------------------------------------------------------------------
+
+// Report a failure
+void
+fail(boost::system::error_code ec, char const* what)
+{
+    std::cerr << what << ": " << ec.message() << "\n";
+}
+
+// Echoes back all received WebSocket messages
+class session
+    : public boost::asio::coroutine
+    , public std::enable_shared_from_this<session>
+{
+    websocket::stream<tcp::socket> ws_;
+    boost::asio::io_service::strand strand_;
+    boost::beast::multi_buffer buffer_;
+
+public:
+    // Take ownership of the socket
+    explicit
+    session(tcp::socket socket)
+        : ws_(std::move(socket))
+        , strand_(ws_.get_io_service())
+    {
+    }
+
+    // Start the asynchronous operation
+    void
+    run()
+    {
+        loop();
+    }
+
+#include <boost/asio/yield.hpp>
+    void
+    loop(boost::system::error_code ec = {})
+    {
+        reenter(*this)
+        {
+            // Accept the websocket handshake
+            yield ws_.async_accept(
+                strand_.wrap(std::bind(
+                    &session::loop,
+                    shared_from_this(),
+                    std::placeholders::_1)));
+            if(ec)
+                return fail(ec, "accept");
+
+            for(;;)
+            {
+                // Read a message into our buffer
+                yield ws_.async_read(
+                    buffer_,
+                    strand_.wrap(std::bind(
+                        &session::loop,
+                        shared_from_this(),
+                        std::placeholders::_1)));
+                if(ec == websocket::error::closed)
+                {
+                    // This indicates that the session was closed
+                    return;
+                }
+                if(ec)
+                    fail(ec, "read");
+
+                // Echo the message
+                ws_.text(ws_.got_text());
+                yield ws_.async_write(
+                    buffer_.data(),
+                    strand_.wrap(std::bind(
+                        &session::loop,
+                        shared_from_this(),
+                        std::placeholders::_1)));
+                if(ec)
+                    return fail(ec, "write");
+
+                // Clear the buffer
+                buffer_.consume(buffer_.size());
+            }
+        }
+    }
+#include <boost/asio/unyield.hpp>
+};
+
+//------------------------------------------------------------------------------
+
+// Accepts incoming connections and launches the sessions
+class listener
+    : public boost::asio::coroutine
+    , public std::enable_shared_from_this<listener>
+{
+    boost::asio::io_service::strand strand_;
+    tcp::acceptor acceptor_;
+    tcp::socket socket_;
+
+public:
+    listener(
+        boost::asio::io_service& ios,
+        tcp::endpoint endpoint)
+        : strand_(ios)
+        , acceptor_(ios)
+        , socket_(ios)
+    {
+        boost::system::error_code ec;
+
+        // Open the acceptor
+        acceptor_.open(endpoint.protocol(), ec);
+        if(ec)
+        {
+            fail(ec, "open");
+            return;
+        }
+
+        // Bind to the server address
+        acceptor_.bind(endpoint, ec);
+        if(ec)
+        {
+            fail(ec, "bind");
+            return;
+        }
+
+        // Start listening for connections
+        acceptor_.listen(
+            boost::asio::socket_base::max_connections, ec);
+        if(ec)
+        {
+            fail(ec, "listen");
+            return;
+        }
+    }
+
+    // Start accepting incoming connections
+    void
+    run()
+    {
+        if(! acceptor_.is_open())
+            return;
+        loop();
+    }
+
+#include <boost/asio/yield.hpp>
+    void
+    loop(boost::system::error_code ec = {})
+    {
+        reenter(*this)
+        {
+            for(;;)
+            {
+                yield acceptor_.async_accept(
+                    socket_,
+                    std::bind(
+                        &listener::loop,
+                        shared_from_this(),
+                        std::placeholders::_1));
+                if(ec)
+                {
+                    fail(ec, "accept");
+                }
+                else
+                {
+                    // Create the session and run it
+                    std::make_shared<session>(std::move(socket_))->run();
+                }
+            }
+        }
+    }
+#include <boost/asio/unyield.hpp>
+};
+
+//------------------------------------------------------------------------------
+
+int main(int argc, char* argv[])
+{
+    // Check command line arguments.
+    if (argc != 4)
+    {
+        std::cerr <<
+            "Usage: websocket-server-stackless <address> <port> <threads>\n" <<
+            "Example:\n" <<
+            "    websocket-server-stackless 0.0.0.0 8080 1\n";
+        return EXIT_FAILURE;
+    }
+    auto const address = boost::asio::ip::address::from_string(argv[1]);
+    auto const port = static_cast<unsigned short>(std::atoi(argv[2]));
+    auto const threads = std::max<std::size_t>(1, std::atoi(argv[3]));
+
+    // The io_service is required for all I/O
+    boost::asio::io_service ios{threads};
+
+    // Create and launch a listening port
+    std::make_shared<listener>(ios, tcp::endpoint{address, port})->run();
+
+    // Run the I/O service on the requested number of threads
+    std::vector<std::thread> v;
+    v.reserve(threads - 1);
+    for(auto i = threads - 1; i > 0; --i)
+        v.emplace_back(
+        [&ios]
+        {
+            ios.run();
+        });
+    ios.run();
+
+    return EXIT_SUCCESS;
+}
@@ -0,0 +1,23 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+GroupSources(include/boost/beast beast)
+GroupSources(example/common common)
+GroupSources(example/websocket/server/sync-ssl "/")
+
+add_executable (websocket-server-sync-ssl
+    ${BOOST_BEAST_INCLUDES}
+    ${PROJECT_SOURCE_DIR}/example/common/server_certificate.hpp
+    Jamfile
+    websocket_server_sync_ssl.cpp
+)
+
+target_link_libraries (websocket-server-sync-ssl
+    ${OPENSSL_LIBRARIES}
+    )
@@ -0,0 +1,21 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+project
+    : requirements
+    <library>ssl
+    <library>crypto
+    ;
+
+exe websocket-server-sync-ssl :
+    websocket_server_sync_ssl.cpp
+    :
+    <variant>coverage:<build>no
+    <variant>ubasan:<build>no
+    ;
@@ -0,0 +1,124 @@
+//
+// Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// Official repository: https://github.com/boostorg/beast
+//
+
+//------------------------------------------------------------------------------
+//
+// Example: WebSocket SSL server, synchronous
+//
+//------------------------------------------------------------------------------
+
+#include "example/common/server_certificate.hpp"
+
+#include <boost/beast/core.hpp>
+#include <boost/beast/websocket.hpp>
+#include <boost/beast/websocket/ssl.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <boost/asio/ssl/stream.hpp>
+#include <cstdlib>
+#include <functional>
+#include <iostream>
+#include <string>
+#include <thread>
+
+using tcp = boost::asio::ip::tcp;               // from <boost/asio/ip/tcp.hpp>
+namespace ssl = boost::asio::ssl;               // from <boost/asio/ssl.hpp>
+namespace websocket = boost::beast::websocket;  // from <boost/beast/websocket.hpp>
+
+//------------------------------------------------------------------------------
+
+// Echoes back all received WebSocket messages
+void
+do_session(tcp::socket& socket, ssl::context& ctx)
+{
+    try
+    {
+        // Construct the websocket stream around the socket
+        websocket::stream<ssl::stream<tcp::socket&>> ws{socket, ctx};
+
+        // Perform the SSL handshake
+        ws.next_layer().handshake(ssl::stream_base::server);
+
+        // Accept the websocket handshake
+        ws.accept();
+
+        for(;;)
+        {
+            // This buffer will hold the incoming message
+            boost::beast::multi_buffer buffer;
+
+            // Read a message
+            ws.read(buffer);
+
+            // Echo the message back
+            ws.text(ws.got_text());
+            ws.write(buffer.data());
+        }
+    }
+    catch(boost::system::system_error const& se)
+    {
+        // This indicates that the session was closed
+        if(se.code() != websocket::error::closed)
+            std::cerr << "Error: " << se.code().message() << std::endl;
+    }
+    catch(std::exception const& e)
+    {
+        std::cerr << "Error: " << e.what() << std::endl;
+    }
+}
+
+//------------------------------------------------------------------------------
+
+int main(int argc, char* argv[])
+{
+    try
+    {
+        // Check command line arguments.
+        if (argc != 3)
+        {
+            std::cerr <<
+                "Usage: websocket-server-sync-ssl <address> <port>\n" <<
+                "Example:\n" <<
+                "    websocket-server-sync-ssl 0.0.0.0 8080\n";
+            return EXIT_FAILURE;
+        }
+        auto const address = boost::asio::ip::address::from_string(argv[1]);
+        auto const port = static_cast<unsigned short>(std::atoi(argv[2]));
+
+        // The io_service is required for all I/O
+        boost::asio::io_service ios{1};
+
+        // The SSL context is required, and holds certificates
+        ssl::context ctx{ssl::context::sslv23};
+
+        // This holds the self-signed certificate used by the server
+        load_server_certificate(ctx);
+
+        // The acceptor receives incoming connections
+        tcp::acceptor acceptor{ios, {address, port}};
+        for(;;)
+        {
+            // This will receive the new connection
+            tcp::socket socket{ios};
+
+            // Block until we get a connection
+            acceptor.accept(socket);
+
+            // Launch the session, transferring ownership of the socket
+            std::thread{std::bind(
+                &do_session,
+                std::move(socket),
+                std::ref(ctx))}.detach();
+        }
+    }
+    catch (const std::exception& e)
+    {
+        std::cerr << "Error: " << e.what() << std::endl;
+        return EXIT_FAILURE;
+    }
+}
@@ -0,0 +1,17 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+GroupSources(include/boost/beast beast)
+GroupSources(example/websocket/server/sync "/")
+
+add_executable (websocket-server-sync
+    ${BOOST_BEAST_INCLUDES}
+    Jamfile
+    websocket_server_sync.cpp
+)
@@ -0,0 +1,15 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+exe websocket-server-sync :
+    websocket_server_sync.cpp
+    :
+    <variant>coverage:<build>no
+    <variant>ubasan:<build>no
+    ;
@@ -0,0 +1,109 @@
+//
+// Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// Official repository: https://github.com/boostorg/beast
+//
+
+//------------------------------------------------------------------------------
+//
+// Example: WebSocket server, synchronous
+//
+//------------------------------------------------------------------------------
+
+#include <boost/beast/core.hpp>
+#include <boost/beast/websocket.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <cstdlib>
+#include <functional>
+#include <iostream>
+#include <string>
+#include <thread>
+
+using tcp = boost::asio::ip::tcp;               // from <boost/asio/ip/tcp.hpp>
+namespace websocket = boost::beast::websocket;  // from <boost/beast/websocket.hpp>
+
+//------------------------------------------------------------------------------
+
+// Echoes back all received WebSocket messages
+void
+do_session(tcp::socket& socket)
+{
+    try
+    {
+        // Construct the stream by moving in the socket
+        websocket::stream<tcp::socket> ws{std::move(socket)};
+
+        // Accept the websocket handshake
+        ws.accept();
+
+        for(;;)
+        {
+            // This buffer will hold the incoming message
+            boost::beast::multi_buffer buffer;
+
+            // Read a message
+            ws.read(buffer);
+
+            // Echo the message back
+            ws.text(ws.got_text());
+            ws.write(buffer.data());
+        }
+    }
+    catch(boost::system::system_error const& se)
+    {
+        // This indicates that the session was closed
+        if(se.code() != websocket::error::closed)
+            std::cerr << "Error: " << se.code().message() << std::endl;
+    }
+    catch(std::exception const& e)
+    {
+        std::cerr << "Error: " << e.what() << std::endl;
+    }
+}
+
+//------------------------------------------------------------------------------
+
+int main(int argc, char* argv[])
+{
+    try
+    {
+        // Check command line arguments.
+        if (argc != 3)
+        {
+            std::cerr <<
+                "Usage: websocket-server-sync <address> <port>\n" <<
+                "Example:\n" <<
+                "    websocket-server-sync 0.0.0.0 8080\n";
+            return EXIT_FAILURE;
+        }
+        auto const address = boost::asio::ip::address::from_string(argv[1]);
+        auto const port = static_cast<unsigned short>(std::atoi(argv[2]));
+
+        // The io_service is required for all I/O
+        boost::asio::io_service ios{1};
+
+        // The acceptor receives incoming connections
+        tcp::acceptor acceptor{ios, {address, port}};
+        for(;;)
+        {
+            // This will receive the new connection
+            tcp::socket socket{ios};
+
+            // Block until we get a connection
+            acceptor.accept(socket);
+
+            // Launch the session, transferring ownership of the socket
+            std::thread{std::bind(
+                &do_session,
+                std::move(socket))}.detach();
+        }
+    }
+    catch (const std::exception& e)
+    {
+        std::cerr << "Error: " << e.what() << std::endl;
+        return EXIT_FAILURE;
+    }
+}