Creates a socket host object.

This patch moves the logic of many common socket operations into
its own class lldb_private::Socket.  It then modifies the
ConnectionFileDescriptor class, and a few users of that class,
to use this new Socket class instead of hardcoding socket logic
directly.

Finally, this patch creates a common interface called IOObject for
any objects that support reading and writing, so that endpoints
such as sockets and files can be treated the same.

Differential Revision: http://reviews.llvm.org/D4641

Reviewed by: Todd Fiala, Greg Clayton

llvm-svn: 214984
diff --git a/lldb/source/Host/common/CMakeLists.txt b/lldb/source/Host/common/CMakeLists.txt
index 0141071..2e355ee 100644
--- a/lldb/source/Host/common/CMakeLists.txt
+++ b/lldb/source/Host/common/CMakeLists.txt
@@ -7,6 +7,7 @@
   File.cpp
   FileSpec.cpp
   Host.cpp
+  IOObject.cpp
   Mutex.cpp
   NativeBreakpoint.cpp
   NativeBreakpointList.cpp
@@ -15,6 +16,7 @@
   OptionParser.cpp
   Pipe.cpp
   ProcessRunLock.cpp
+  Socket.cpp
   SocketAddress.cpp
   SoftwareBreakpoint.cpp
   Symbols.cpp
diff --git a/lldb/source/Host/common/File.cpp b/lldb/source/Host/common/File.cpp
index 500b03c..50513af 100644
--- a/lldb/source/Host/common/File.cpp
+++ b/lldb/source/Host/common/File.cpp
@@ -24,6 +24,7 @@
 
 #include "lldb/Core/DataBufferHeap.h"
 #include "lldb/Core/Error.h"
+#include "lldb/Core/Log.h"
 #include "lldb/Host/Config.h"
 #include "lldb/Host/FileSpec.h"
 
@@ -77,11 +78,11 @@
 FILE * File::kInvalidStream = NULL;
 
 File::File(const char *path, uint32_t options, uint32_t permissions) :
+    IOObject(eFDTypeFile, false),
     m_descriptor (kInvalidDescriptor),
     m_stream (kInvalidStream),
     m_options (),
     m_own_stream (false),
-    m_own_descriptor (false),
     m_is_interactive (eLazyBoolCalculate),
     m_is_real_terminal (eLazyBoolCalculate)
 {
@@ -91,11 +92,11 @@
 File::File (const FileSpec& filespec,
             uint32_t options,
             uint32_t permissions) :
+    IOObject(eFDTypeFile, false),
     m_descriptor (kInvalidDescriptor),
     m_stream (kInvalidStream),
     m_options (0),
     m_own_stream (false),
-    m_own_descriptor (false),
     m_is_interactive (eLazyBoolCalculate),
     m_is_real_terminal (eLazyBoolCalculate)
 
@@ -107,11 +108,11 @@
 }
 
 File::File (const File &rhs) :
+    IOObject(eFDTypeFile, false),
     m_descriptor (kInvalidDescriptor),
     m_stream (kInvalidStream),
     m_options (0),
     m_own_stream (false),
-    m_own_descriptor (false),
     m_is_interactive (eLazyBoolCalculate),
     m_is_real_terminal (eLazyBoolCalculate)
 {
@@ -148,13 +149,20 @@
     return kInvalidDescriptor;
 }
 
+IOObject::WaitableHandle
+File::GetWaitableHandle()
+{
+    return m_descriptor;
+}
+
+
 void
 File::SetDescriptor (int fd, bool transfer_ownership)
 {
     if (IsValid())
         Close();
     m_descriptor = fd;
-    m_own_descriptor = transfer_ownership;
+    m_should_close_fd = transfer_ownership;
 }
 
 
@@ -168,7 +176,7 @@
             const char *mode = GetStreamOpenModeFromOptions (m_options);
             if (mode)
             {
-                if (!m_own_descriptor)
+                if (!m_should_close_fd)
                 {
                     // We must duplicate the file descriptor if we don't own it because
                     // when you call fdopen, the stream will own the fd
@@ -177,7 +185,7 @@
 #else
                     m_descriptor = ::fcntl(GetDescriptor(), F_DUPFD);
 #endif
-                    m_own_descriptor = true;
+                    m_should_close_fd = true;
                 }
 
                 do
@@ -191,7 +199,7 @@
                 if (m_stream)
                 {
                     m_own_stream = true;
-                    m_own_descriptor = false;
+                    m_should_close_fd = false;
                 }
             }
         }
@@ -228,7 +236,7 @@
         else
         {
             m_options = rhs.m_options;
-            m_own_descriptor = true;
+            m_should_close_fd = true;
         }
     }
     else
@@ -307,7 +315,7 @@
         error.SetErrorToErrno();
     else
     {
-        m_own_descriptor = true;
+        m_should_close_fd = true;
         m_options = options;
     }
     
@@ -371,7 +379,7 @@
             error.SetErrorToErrno();
     }
     
-    if (DescriptorIsValid() && m_own_descriptor)
+    if (DescriptorIsValid() && m_should_close_fd)
     {
         if (::close (m_descriptor) != 0)
             error.SetErrorToErrno();
@@ -380,7 +388,7 @@
     m_stream = kInvalidStream;
     m_options = 0;
     m_own_stream = false;
-    m_own_descriptor = false;
+    m_should_close_fd = false;
     m_is_interactive = eLazyBoolCalculate;
     m_is_real_terminal = eLazyBoolCalculate;
     return error;
@@ -669,6 +677,7 @@
         num_bytes = 0;
         error.SetErrorString("invalid file handle");
     }
+
     return error;
 }
 
diff --git a/lldb/source/Host/common/IOObject.cpp b/lldb/source/Host/common/IOObject.cpp
new file mode 100644
index 0000000..6f7de44
--- /dev/null
+++ b/lldb/source/Host/common/IOObject.cpp
@@ -0,0 +1,14 @@
+//===-- IOObject.cpp --------------------------------------------*- C++ -*-===//
+//
+//                     The LLVM Compiler Infrastructure
+//
+// This file is distributed under the University of Illinois Open Source
+// License. See LICENSE.TXT for details.
+//
+//===----------------------------------------------------------------------===//
+
+#include "lldb/Host/IOObject.h"
+
+using namespace lldb_private;
+
+const IOObject::WaitableHandle IOObject::kInvalidHandleValue = -1;
diff --git a/lldb/source/Host/common/Socket.cpp b/lldb/source/Host/common/Socket.cpp
new file mode 100644
index 0000000..86bea42
--- /dev/null
+++ b/lldb/source/Host/common/Socket.cpp
@@ -0,0 +1,661 @@
+//===-- Socket.cpp ----------------------------------------------*- C++ -*-===//
+//
+//                     The LLVM Compiler Infrastructure
+//
+// This file is distributed under the University of Illinois Open Source
+// License. See LICENSE.TXT for details.
+//
+//===----------------------------------------------------------------------===//
+
+#include "lldb/Host/Socket.h"
+
+#include "lldb/Core/Log.h"
+#include "lldb/Core/RegularExpression.h"
+#include "lldb/Host/Config.h"
+#include "lldb/Host/Host.h"
+#include "lldb/Host/SocketAddress.h"
+#include "lldb/Host/TimeValue.h"
+#include "lldb/Interpreter/Args.h"
+
+#ifndef LLDB_DISABLE_POSIX
+#include <arpa/inet.h>
+#include <netdb.h>
+#include <netinet/in.h>
+#include <netinet/tcp.h>
+#include <sys/socket.h>
+#include <sys/un.h>
+#endif
+
+using namespace lldb;
+using namespace lldb_private;
+
+#if defined(_WIN32)
+typedef const char * set_socket_option_arg_type;
+typedef char * get_socket_option_arg_type;
+const NativeSocket Socket::kInvalidSocketValue = INVALID_SOCKET;
+#else // #if defined(_WIN32)
+typedef const void * set_socket_option_arg_type;
+typedef void * get_socket_option_arg_type;
+const NativeSocket Socket::kInvalidSocketValue = -1;
+#endif // #if defined(_WIN32)
+
+Socket::Socket(NativeSocket socket, SocketProtocol protocol, bool should_close)
+    : IOObject(eFDTypeSocket, should_close)
+    , m_protocol(protocol)
+    , m_socket(socket)
+{
+
+}
+
+Socket::~Socket()
+{
+    Close();
+}
+
+Error Socket::TcpConnect(llvm::StringRef host_and_port, Socket *&socket)
+{
+    // Store the result in a unique_ptr in case we error out, the memory will get correctly freed.
+    std::unique_ptr<Socket> final_socket;
+    NativeSocket sock = kInvalidSocketValue;
+    Error error;
+
+    Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_HOST));
+    if (log)
+        log->Printf ("Socket::TcpConnect (host/port = %s)", host_and_port.data());
+
+    std::string host_str;
+    std::string port_str;
+    int32_t port = INT32_MIN;
+    if (!DecodeHostAndPort (host_and_port, host_str, port_str, port, &error))
+        return error;
+
+    // Create the socket
+    sock = ::socket (AF_INET, SOCK_STREAM, IPPROTO_TCP);
+    if (sock == kInvalidSocketValue)
+    {
+        // TODO: On Windows, use WSAGetLastError().
+        error.SetErrorToErrno();
+        return error;
+    }
+
+    // Since they both refer to the same socket descriptor, arbitrarily choose the send socket to
+    // be the owner.
+    final_socket.reset(new Socket(sock, ProtocolTcp, true));
+
+    // Enable local address reuse
+    final_socket->SetOption(SOL_SOCKET, SO_REUSEADDR, 1);
+
+    struct sockaddr_in sa;
+    ::memset (&sa, 0, sizeof (sa));
+    sa.sin_family = AF_INET;
+    sa.sin_port = htons (port);
+
+    int inet_pton_result = ::inet_pton (AF_INET, host_str.c_str(), &sa.sin_addr);
+
+    if (inet_pton_result <= 0)
+    {
+        struct hostent *host_entry = gethostbyname (host_str.c_str());
+        if (host_entry)
+            host_str = ::inet_ntoa (*(struct in_addr *)*host_entry->h_addr_list);
+        inet_pton_result = ::inet_pton (AF_INET, host_str.c_str(), &sa.sin_addr);
+        if (inet_pton_result <= 0)
+        {
+            // TODO: On Windows, use WSAGetLastError()
+            if (inet_pton_result == -1)
+                error.SetErrorToErrno();
+            else
+                error.SetErrorStringWithFormat("invalid host string: '%s'", host_str.c_str());
+
+            return error;
+        }
+    }
+
+    if (-1 == ::connect (sock, (const struct sockaddr *)&sa, sizeof(sa)))
+    {
+        // TODO: On Windows, use WSAGetLastError()
+        error.SetErrorToErrno();
+        return error;
+    }
+
+    // Keep our TCP packets coming without any delays.
+    final_socket->SetOption(IPPROTO_TCP, TCP_NODELAY, 1);
+    error.Clear();
+    socket = final_socket.release();
+    return error;
+}
+
+Error Socket::TcpListen(llvm::StringRef host_and_port, Socket *&socket, Predicate<uint16_t>* predicate)
+{
+    std::unique_ptr<Socket> listen_socket;
+    NativeSocket listen_sock = kInvalidSocketValue;
+    Error error;
+
+    const sa_family_t family = AF_INET;
+    const int socktype = SOCK_STREAM;
+    const int protocol = IPPROTO_TCP;
+    listen_sock = ::socket (family, socktype, protocol);
+    if (listen_sock == kInvalidSocketValue)
+    {
+        error.SetErrorToErrno();
+        return error;
+    }
+
+    listen_socket.reset(new Socket(listen_sock, ProtocolTcp, true));
+
+    // enable local address reuse
+    listen_socket->SetOption(SOL_SOCKET, SO_REUSEADDR, 1);
+
+    Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_CONNECTION));
+    if (log)
+        log->Printf ("ConnectionFileDescriptor::SocketListen (%s)", host_and_port.data());
+
+    std::string host_str;
+    std::string port_str;
+    int32_t port = INT32_MIN;
+    if (!DecodeHostAndPort (host_and_port, host_str, port_str, port, &error))
+        return error;
+
+    SocketAddress anyaddr;
+    if (anyaddr.SetToAnyAddress (family, port))
+    {
+        int err = ::bind (listen_sock, anyaddr, anyaddr.GetLength());
+        if (err == -1)
+        {
+            // TODO: On Windows, use WSAGetLastError()
+            error.SetErrorToErrno();
+            return error;
+        }
+
+        err = ::listen (listen_sock, 1);
+        if (err == -1)
+        {
+            // TODO: On Windows, use WSAGetLastError()
+            error.SetErrorToErrno();
+            return error;
+        }
+
+        // We were asked to listen on port zero which means we
+        // must now read the actual port that was given to us
+        // as port zero is a special code for "find an open port
+        // for me".
+        if (port == 0)
+            port = listen_socket->GetPortNumber();
+
+        // Set the port predicate since when doing a listen://<host>:<port>
+        // it often needs to accept the incoming connection which is a blocking
+        // system call. Allowing access to the bound port using a predicate allows
+        // us to wait for the port predicate to be set to a non-zero value from
+        // another thread in an efficient manor.
+        if (predicate)
+            predicate->SetValue(port, eBroadcastAlways);
+
+        socket = listen_socket.release();
+    }
+
+    return error;
+}
+
+Error Socket::BlockingAccept(llvm::StringRef host_and_port, Socket *&socket)
+{
+    Error error;
+    std::string host_str;
+    std::string port_str;
+    int32_t port;
+    if (!DecodeHostAndPort(host_and_port, host_str, port_str, port, &error))
+        return error;
+
+    const sa_family_t family = AF_INET;
+    const int socktype = SOCK_STREAM;
+    const int protocol = IPPROTO_TCP;
+    SocketAddress listen_addr;
+    if (host_str.empty())
+        listen_addr.SetToLocalhost(family, port);
+    else if (host_str.compare("*") == 0)
+        listen_addr.SetToAnyAddress(family, port);
+    else
+    {
+        if (!listen_addr.getaddrinfo(host_str.c_str(), port_str.c_str(), family, socktype, protocol))
+        {
+            error.SetErrorStringWithFormat("unable to resolve hostname '%s'", host_str.c_str());
+            return error;
+        }
+    }
+
+    bool accept_connection = false;
+    std::unique_ptr<Socket> accepted_socket;
+
+    // Loop until we are happy with our connection
+    while (!accept_connection)
+    {
+        struct sockaddr_in accept_addr;
+        ::memset (&accept_addr, 0, sizeof accept_addr);
+#if !(defined (__linux__) || defined(_WIN32))
+        accept_addr.sin_len = sizeof accept_addr;
+#endif
+        socklen_t accept_addr_len = sizeof accept_addr;
+
+        int sock = ::accept (this->GetNativeSocket(), (struct sockaddr *)&accept_addr, &accept_addr_len);
+            
+        if (sock == kInvalidSocketValue)
+        {
+            // TODO: On Windows, use WSAGetLastError()
+            error.SetErrorToErrno();
+            break;
+        }
+    
+        bool is_same_addr = true;
+#if !(defined(__linux__) || (defined(_WIN32)))
+        is_same_addr = (accept_addr_len == listen_addr.sockaddr_in().sin_len);
+#endif
+        if (is_same_addr)
+            is_same_addr = (accept_addr.sin_addr.s_addr == listen_addr.sockaddr_in().sin_addr.s_addr);
+
+        if (is_same_addr || (listen_addr.sockaddr_in().sin_addr.s_addr == INADDR_ANY))
+        {
+            accept_connection = true;
+            // Since both sockets have the same descriptor, arbitrarily choose the send
+            // socket to be the owner.
+            accepted_socket.reset(new Socket(sock, ProtocolTcp, true));
+        }
+        else
+        {
+            const uint8_t *accept_ip = (const uint8_t *)&accept_addr.sin_addr.s_addr;
+            const uint8_t *listen_ip = (const uint8_t *)&listen_addr.sockaddr_in().sin_addr.s_addr;
+            ::fprintf (stderr, "error: rejecting incoming connection from %u.%u.%u.%u (expecting %u.%u.%u.%u)\n",
+                        accept_ip[0], accept_ip[1], accept_ip[2], accept_ip[3],
+                        listen_ip[0], listen_ip[1], listen_ip[2], listen_ip[3]);
+            accepted_socket.reset();
+        }
+    }
+
+    if (!accepted_socket)
+        return error;
+
+    // Keep our TCP packets coming without any delays.
+    accepted_socket->SetOption (IPPROTO_TCP, TCP_NODELAY, 1);
+    error.Clear();
+    socket = accepted_socket.release();
+    return error;
+
+}
+
+Error Socket::UdpConnect(llvm::StringRef host_and_port, Socket *&send_socket, Socket *&recv_socket)
+{
+    std::unique_ptr<Socket> final_send_socket;
+    std::unique_ptr<Socket> final_recv_socket;
+    NativeSocket final_send_fd = kInvalidSocketValue;
+    NativeSocket final_recv_fd = kInvalidSocketValue;
+
+    Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_CONNECTION));
+    if (log)
+        log->Printf ("Socket::UdpConnect (host/port = %s)", host_and_port.data());
+
+    Error error;
+    std::string host_str;
+    std::string port_str;
+    int32_t port = INT32_MIN;
+    if (!DecodeHostAndPort (host_and_port, host_str, port_str, port, &error))
+        return error;
+
+    // Setup the receiving end of the UDP connection on this localhost
+    // on port zero. After we bind to port zero we can read the port.
+    final_recv_fd = ::socket (AF_INET, SOCK_DGRAM, 0);
+    if (final_recv_fd == kInvalidSocketValue)
+    {
+        // Socket creation failed...
+        // TODO: On Windows, use WSAGetLastError().
+        error.SetErrorToErrno();
+    }
+    else
+    {
+        final_recv_socket.reset(new Socket(final_recv_fd, ProtocolUdp, true));
+
+        // Socket was created, now lets bind to the requested port
+        SocketAddress addr;
+        addr.SetToAnyAddress (AF_INET, 0);
+
+        if (::bind (final_recv_fd, addr, addr.GetLength()) == -1)
+        {
+            // Bind failed...
+            // TODO: On Windows use WSAGetLastError()
+            error.SetErrorToErrno();
+        }
+    }
+
+    assert(error.Fail() == !(final_recv_socket && final_recv_socket->IsValid()));
+    if (error.Fail())
+        return error;
+
+    // At this point we have setup the receive port, now we need to 
+    // setup the UDP send socket
+
+    struct addrinfo hints;
+    struct addrinfo *service_info_list = NULL;
+
+    ::memset (&hints, 0, sizeof(hints)); 
+    hints.ai_family = AF_INET; 
+    hints.ai_socktype = SOCK_DGRAM;
+    int err = ::getaddrinfo (host_str.c_str(), port_str.c_str(), &hints, &service_info_list);
+    if (err != 0)
+    {
+        error.SetErrorStringWithFormat("getaddrinfo(%s, %s, &hints, &info) returned error %i (%s)", 
+                                       host_str.c_str(), 
+                                       port_str.c_str(),
+                                       err,
+                                       gai_strerror(err));
+        return error;        
+    }
+
+    for (struct addrinfo *service_info_ptr = service_info_list; 
+         service_info_ptr != NULL; 
+         service_info_ptr = service_info_ptr->ai_next) 
+    {
+        final_send_fd = ::socket (service_info_ptr->ai_family, 
+                                  service_info_ptr->ai_socktype,
+                                  service_info_ptr->ai_protocol);
+
+        if (final_send_fd != kInvalidSocketValue)
+        {
+            final_send_socket.reset(new Socket(final_send_fd, ProtocolUdp, true));
+            final_send_socket->m_udp_send_sockaddr = service_info_ptr;
+            break;
+        }
+        else
+            continue;
+    }
+
+    :: freeaddrinfo (service_info_list);
+
+    if (final_send_fd == kInvalidSocketValue)
+    {
+        // TODO: On Windows, use WSAGetLastError().
+        error.SetErrorToErrno();
+        return error;
+    }
+
+    send_socket = final_send_socket.release();
+    recv_socket = final_recv_socket.release();
+    error.Clear();
+    return error;
+}
+
+Error Socket::UnixDomainConnect(llvm::StringRef name, Socket *&socket)
+{
+    Error error;
+#ifndef LLDB_DISABLE_POSIX
+    std::unique_ptr<Socket> final_socket;
+
+    // Open the socket that was passed in as an option
+    struct sockaddr_un saddr_un;
+    int fd = ::socket (AF_UNIX, SOCK_STREAM, 0);
+    if (fd == kInvalidSocketValue)
+    {
+        error.SetErrorToErrno();
+        return error;
+    }
+
+    final_socket.reset(new Socket(fd, ProtocolUnixDomain, true));
+
+    saddr_un.sun_family = AF_UNIX;
+    ::strncpy(saddr_un.sun_path, name.data(), sizeof(saddr_un.sun_path) - 1);
+    saddr_un.sun_path[sizeof(saddr_un.sun_path) - 1] = '\0';
+#if defined(__APPLE__) || defined(__FreeBSD__) || defined(__NetBSD__)
+    saddr_un.sun_len = SUN_LEN (&saddr_un);
+#endif
+
+    if (::connect (fd, (struct sockaddr *)&saddr_un, SUN_LEN (&saddr_un)) < 0) 
+    {
+        error.SetErrorToErrno();
+        return error;
+    }
+
+    socket = final_socket.release();
+#else
+    error.SetErrorString("Unix domain sockets are not supported on this platform.");
+#endif
+    return error;
+}
+
+Error Socket::UnixDomainAccept(llvm::StringRef name, Socket *&socket)
+{
+    Error error;
+#ifndef LLDB_DISABLE_POSIX
+    struct sockaddr_un saddr_un;
+    std::unique_ptr<Socket> listen_socket;
+    std::unique_ptr<Socket> final_socket;
+    NativeSocket listen_fd = kInvalidSocketValue;
+    NativeSocket socket_fd = kInvalidSocketValue;
+    
+    listen_fd = ::socket (AF_UNIX, SOCK_STREAM, 0);
+    if (listen_fd == kInvalidSocketValue)
+    {
+        error.SetErrorToErrno();
+        return error;
+    }
+
+    listen_socket.reset(new Socket(listen_fd, ProtocolUnixDomain, true));
+
+    saddr_un.sun_family = AF_UNIX;
+    ::strncpy(saddr_un.sun_path, name.data(), sizeof(saddr_un.sun_path) - 1);
+    saddr_un.sun_path[sizeof(saddr_un.sun_path) - 1] = '\0';
+#if defined(__APPLE__) || defined(__FreeBSD__) || defined(__NetBSD__)
+    saddr_un.sun_len = SUN_LEN (&saddr_un);
+#endif
+
+    Host::Unlink (name.data());
+    bool success = false;
+    if (::bind (listen_fd, (struct sockaddr *)&saddr_un, SUN_LEN (&saddr_un)) == 0) 
+    {
+        if (::listen (listen_fd, 5) == 0) 
+        {
+            socket_fd = ::accept (listen_fd, NULL, 0);
+            if (socket_fd > 0)
+            {
+                final_socket.reset(new Socket(socket_fd, ProtocolUnixDomain, true));
+                success = true;
+            }
+        }
+    }
+    
+    if (!success)
+    {
+        error.SetErrorToErrno();
+        return error;
+    }
+    // We are done with the listen port
+    listen_socket.reset();
+
+    socket = final_socket.release();
+#else
+    error.SetErrorString("Unix domain sockets are not supported on this platform.");
+#endif
+    return error;
+}
+
+bool
+Socket::DecodeHostAndPort(llvm::StringRef host_and_port,
+                          std::string &host_str,
+                          std::string &port_str,
+                          int32_t& port,
+                          Error *error_ptr)
+{
+    static RegularExpression g_regex ("([^:]+):([0-9]+)");
+    RegularExpression::Match regex_match(2);
+    if (g_regex.Execute (host_and_port.data(), &regex_match))
+    {
+        if (regex_match.GetMatchAtIndex (host_and_port.data(), 1, host_str) &&
+            regex_match.GetMatchAtIndex (host_and_port.data(), 2, port_str))
+        {
+            port = Args::StringToSInt32 (port_str.c_str(), INT32_MIN);
+            if (port != INT32_MIN)
+            {
+                if (error_ptr)
+                    error_ptr->Clear();
+                return true;
+            }
+        }
+    }
+
+    // If this was unsuccessful, then check if it's simply a signed 32-bit integer, representing
+    // a port with an empty host.
+    host_str.clear();
+    port_str.clear();
+    port = Args::StringToSInt32(host_and_port.data(), INT32_MIN);
+    if (port != INT32_MIN)
+    {
+        port_str = host_and_port;
+        return true;
+    }
+
+    if (error_ptr)
+        error_ptr->SetErrorStringWithFormat("invalid host:port specification: '%s'", host_and_port.data());
+    return false;
+}
+
+IOObject::WaitableHandle Socket::GetWaitableHandle()
+{
+    // TODO: On Windows, use WSAEventSelect
+    return m_socket;
+}
+
+Error Socket::Read (void *buf, size_t &num_bytes)
+{
+    Error error;
+    int bytes_received = 0;
+    do
+    {
+        bytes_received = ::recv (m_socket, static_cast<char *>(buf), num_bytes, 0);
+        // TODO: Use WSAGetLastError on windows.
+    } while (bytes_received < 0 && errno == EINTR);
+
+    if (bytes_received < 0)
+    {
+        error.SetErrorToErrno();
+        num_bytes = 0;
+    }
+    else
+        num_bytes = bytes_received;
+
+    Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_HOST | LIBLLDB_LOG_COMMUNICATION)); 
+    if (log)
+    {
+        log->Printf ("%p Socket::Read() (socket = %" PRIu64 ", src = %p, src_len = %" PRIu64 ", flags = 0) => %" PRIi64 " (error = %s)",
+                     static_cast<void*>(this), 
+                     static_cast<uint64_t>(m_socket),
+                     buf,
+                     static_cast<uint64_t>(num_bytes),
+                     static_cast<int64_t>(bytes_received),
+                     error.AsCString());
+    }
+
+    return error;
+}
+
+Error Socket::Write (const void *buf, size_t &num_bytes)
+{
+    Error error;
+    int bytes_sent = 0;
+    do
+    {
+        if (m_protocol == ProtocolUdp)
+        {
+            bytes_sent = ::sendto (m_socket, 
+                                    static_cast<const char*>(buf), 
+                                    num_bytes, 
+                                    0, 
+                                    m_udp_send_sockaddr,
+                                    m_udp_send_sockaddr.GetLength());
+        }
+        else
+            bytes_sent = ::send (m_socket, static_cast<const char *>(buf), num_bytes, 0);
+        // TODO: Use WSAGetLastError on windows.
+    } while (bytes_sent < 0 && errno == EINTR);
+
+    if (bytes_sent < 0)
+    {
+        // TODO: On Windows, use WSAGEtLastError.
+        error.SetErrorToErrno();
+        num_bytes = 0;
+    }
+    else
+        num_bytes = bytes_sent;
+
+    Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_HOST));
+    if (log)
+    {
+        log->Printf ("%p Socket::Write() (socket = %" PRIu64 ", src = %p, src_len = %" PRIu64 ", flags = 0) => %" PRIi64 " (error = %s)",
+                        static_cast<void*>(this), 
+                        static_cast<uint64_t>(m_socket),
+                        buf,
+                        static_cast<uint64_t>(num_bytes),
+                        static_cast<int64_t>(bytes_sent),
+                        error.AsCString());
+    }
+
+    return error;
+}
+
+Error Socket::PreDisconnect()
+{
+    Error error;
+    return error;
+}
+
+Error Socket::Close()
+{
+    Error error;
+    if (!IsValid() || !m_should_close_fd)
+        return error;
+
+    Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_CONNECTION));
+    if (log)
+        log->Printf ("%p Socket::Close (fd = %i)", static_cast<void*>(this), m_socket);
+
+#if defined(_WIN32)
+    bool success = !!closesocket(m_socket);
+#else
+    bool success = !!::close (m_socket);
+#endif
+    // A reference to a FD was passed in, set it to an invalid value
+    m_socket = kInvalidSocketValue;
+    if (!success)
+    {
+        // TODO: On Windows, use WSAGetLastError().
+        error.SetErrorToErrno();
+    }
+
+    return error;
+}
+
+
+int Socket::GetOption(int level, int option_name, int &option_value)
+{
+    get_socket_option_arg_type option_value_p = reinterpret_cast<get_socket_option_arg_type>(&option_value);
+    socklen_t option_value_size = sizeof(int);
+	return ::getsockopt(m_socket, level, option_name, option_value_p, &option_value_size);
+}
+
+int Socket::SetOption(int level, int option_name, int option_value)
+{
+    set_socket_option_arg_type option_value_p = reinterpret_cast<get_socket_option_arg_type>(&option_value);
+	return ::setsockopt(m_socket, level, option_name, option_value_p, sizeof(option_value));
+}
+
+uint16_t Socket::GetPortNumber(const NativeSocket& socket)
+{
+    // We bound to port zero, so we need to figure out which port we actually bound to
+    if (socket >= 0)
+    {
+        SocketAddress sock_addr;
+        socklen_t sock_addr_len = sock_addr.GetMaxLength ();
+        if (::getsockname (socket, sock_addr, &sock_addr_len) == 0)
+            return sock_addr.GetPort ();
+    }
+    return 0;
+}
+
+// Return the port number that is being used by the socket.
+uint16_t Socket::GetPortNumber() const
+{
+    return GetPortNumber(m_socket);
+}