TLA  Line data    Source code

       1                 : //
       2                 : // Copyright (c) 2026 Steve Gerbino
       3                 : //
       4                 : // Distributed under the Boost Software License, Version 1.0. (See accompanying
       5                 : // file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
       6                 : //
       7                 : // Official repository: https://github.com/cppalliance/corosio
       8                 : //
       9                 : 
      10                 : #ifndef BOOST_COROSIO_TCP_HPP
      11                 : #define BOOST_COROSIO_TCP_HPP
      12                 : 
      13                 : #include <boost/corosio/detail/config.hpp>
      14                 : 
      15                 : namespace boost::corosio {
      16                 : 
      17                 : class tcp_socket;
      18                 : class tcp_acceptor;
      19                 : 
      20                 : /** Encapsulate the TCP protocol for socket creation.
      21                 : 
      22                 :     This class identifies the TCP protocol and its address family
      23                 :     (IPv4 or IPv6). It is used to parameterize socket and acceptor
      24                 :     `open()` calls with a self-documenting type.
      25                 : 
      26                 :     The `family()`, `type()`, and `protocol()` members are
      27                 :     implemented in the compiled library to avoid exposing
      28                 :     platform socket headers. For an inline variant that includes
      29                 :     platform headers, use @ref native_tcp.
      30                 : 
      31                 :     @par Example
      32                 :     @code
      33                 :     tcp_acceptor acc( ioc );
      34                 :     acc.open( tcp::v6() );  // IPv6 socket
      35                 :     acc.set_option( socket_option::reuse_address( true ) );
      36                 :     acc.bind( endpoint( ipv6_address::any(), 8080 ) );
      37                 :     acc.listen();
      38                 :     @endcode
      39                 : 
      40                 :     @see native_tcp, tcp_socket, tcp_acceptor
      41                 : */
      42                 : class BOOST_COROSIO_DECL tcp
      43                 : {
      44                 :     bool v6_;
      45 HIT        7864 :     explicit constexpr tcp( bool v6 ) noexcept : v6_( v6 ) {}
      46                 : 
      47                 : public:
      48                 :     /// Construct an IPv4 TCP protocol.
      49            7838 :     static constexpr tcp v4() noexcept { return tcp( false ); }
      50                 : 
      51                 :     /// Construct an IPv6 TCP protocol.
      52              26 :     static constexpr tcp v6() noexcept { return tcp( true ); }
      53                 : 
      54                 :     /// Return true if this is IPv6.
      55                 :     constexpr bool is_v6() const noexcept { return v6_; }
      56                 : 
      57                 :     /// Return the address family (AF_INET or AF_INET6).
      58                 :     int family() const noexcept;
      59                 : 
      60                 :     /// Return the socket type (SOCK_STREAM).
      61                 :     static int type() noexcept;
      62                 : 
      63                 :     /// Return the IP protocol (IPPROTO_TCP).
      64                 :     static int protocol() noexcept;
      65                 : 
      66                 :     /// The associated socket type.
      67                 :     using socket = tcp_socket;
      68                 : 
      69                 :     /// The associated acceptor type.
      70                 :     using acceptor = tcp_acceptor;
      71                 : 
      72                 :     friend constexpr bool operator==( tcp a, tcp b ) noexcept
      73                 :     {
      74                 :         return a.v6_ == b.v6_;
      75                 :     }
      76                 : 
      77                 :     friend constexpr bool operator!=( tcp a, tcp b ) noexcept
      78                 :     {
      79                 :         return a.v6_ != b.v6_;
      80                 :     }
      81                 : };
      82                 : 
      83                 : } // namespace boost::corosio
      84                 : 
      85                 : #endif // BOOST_COROSIO_TCP_HPP