Class Socket

3rdparty/libprocess/include/process/socket.hpp:258–461

 */
template <typename AddressType>
class Socket
{
public:
  static_assert(
      std::is_convertible<AddressType, network::Address>::value,
      "Requires type convertible to `network::Address`");

  /**
   * Returns an instance of a `Socket` using the specified kind of
   * implementation.
   *
   * @param s Optional.  The file descriptor to wrap with the `Socket`.
   * @param kind Optional. The desired `Socket` implementation.
   *
   * @return An instance of a `Socket`.
   */
  static Try<Socket> create(
      int_fd s,
      SocketImpl::Kind kind = SocketImpl::DEFAULT_KIND())
  {
    Try<std::shared_ptr<SocketImpl>> impl = SocketImpl::create(s, kind);
    if (impl.isError()) {
      return Error(impl.error());
    }
    return Socket(impl.get());
  }

  /**
   * Returns an instance of a `Socket` using `AddressType` to determine
   * the address family to use. An optional implementation kind can be
   * specified. The NONBLOCK and CLOEXEC options will be set on the
   * underlying file descriptor for the socket.
   *
   * @param kind Optional. The desired `Socket` implementation.
   *
   * @return An instance of a `Socket`.
   */
  // TODO(josephw): MESOS-5729: Consider making the CLOEXEC option
  // configurable by the caller of the interface.
  static Try<Socket> create(SocketImpl::Kind kind = SocketImpl::DEFAULT_KIND());

  /**
   * Returns an instance of a `Socket` using the specified
   * `Address::Family` to determine the address family to use. An
   * optional implementation kind can be specified. The NONBLOCK and
   * CLOEXEC options will be set on the underlying file descriptor for
   * the socket.
   *
   * NOTE: this is only defined for `AddressType` of
   * `network::Address`, all others are explicitly deleted.
   *
   * @param kind Optional. The desired `Socket` implementation.
   *
   * @return An instance of a `Socket`.
   */
  static Try<Socket> create(
      Address::Family family,
      SocketImpl::Kind kind = SocketImpl::DEFAULT_KIND());