Asynchronously connect to the application server through a SOCKS5 server.

Synopsis

Defined in header <boost/socks/connect.hpp>

template<
    class AsyncStream,
    class CompletionToken>
DEDUCED
async_connect(
    AsyncStream& s,
    endpoint const& ep,
    auth_options const& opt,
    CompletionToken&& token);

Description

This function establishes a connection to the application server through a SOCKS5 server. This composed operation includes the greeting, sub-negotiation, and connect steps of the SOCKS5 protocol. After this operation, the client can communicate with SOCKS5 proxy as if the talking to the application server.

Preconditions

The AsyncStream should be connected to a SOCKS5 server. The endpoint might contain IPv4 or IPv6 address.

Example

boost::asio::connect(s, resolver.resolve(socks_host, socks_service));
socks_io::async_connect(
    s, app_host_endpoint, "username", ec,
    [](error_code ec, endpoint ep)
{
    if (!ec.failed())
    {
        // write to the application host
        do_write();
    }
});

Parameters

References

Convenience header <boost/socks.hpp>