socket_ops.hpp 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377
  1. //
  2. // detail/socket_ops.hpp
  3. // ~~~~~~~~~~~~~~~~~~~~~
  4. //
  5. // Copyright (c) 2003-2024 Christopher M. Kohlhoff (chris at kohlhoff dot com)
  6. //
  7. // Distributed under the Boost Software License, Version 1.0. (See accompanying
  8. // file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
  9. //
  10. #ifndef BOOST_ASIO_DETAIL_SOCKET_OPS_HPP
  11. #define BOOST_ASIO_DETAIL_SOCKET_OPS_HPP
  12. #if defined(_MSC_VER) && (_MSC_VER >= 1200)
  13. # pragma once
  14. #endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
  15. #include <boost/asio/detail/config.hpp>
  16. #include <boost/system/error_code.hpp>
  17. #include <boost/asio/detail/memory.hpp>
  18. #include <boost/asio/detail/socket_types.hpp>
  19. #include <boost/asio/detail/push_options.hpp>
  20. namespace boost {
  21. namespace asio {
  22. namespace detail {
  23. namespace socket_ops {
  24. // Socket state bits.
  25. enum
  26. {
  27. // The user wants a non-blocking socket.
  28. user_set_non_blocking = 1,
  29. // The socket has been set non-blocking.
  30. internal_non_blocking = 2,
  31. // Helper "state" used to determine whether the socket is non-blocking.
  32. non_blocking = user_set_non_blocking | internal_non_blocking,
  33. // User wants connection_aborted errors, which are disabled by default.
  34. enable_connection_aborted = 4,
  35. // The user set the linger option. Needs to be checked when closing.
  36. user_set_linger = 8,
  37. // The socket is stream-oriented.
  38. stream_oriented = 16,
  39. // The socket is datagram-oriented.
  40. datagram_oriented = 32,
  41. // The socket may have been dup()-ed.
  42. possible_dup = 64
  43. };
  44. typedef unsigned char state_type;
  45. struct noop_deleter { void operator()(void*) {} };
  46. typedef shared_ptr<void> shared_cancel_token_type;
  47. typedef weak_ptr<void> weak_cancel_token_type;
  48. #if !defined(BOOST_ASIO_WINDOWS_RUNTIME)
  49. BOOST_ASIO_DECL socket_type accept(socket_type s, void* addr,
  50. std::size_t* addrlen, boost::system::error_code& ec);
  51. BOOST_ASIO_DECL socket_type sync_accept(socket_type s, state_type state,
  52. void* addr, std::size_t* addrlen, boost::system::error_code& ec);
  53. #if defined(BOOST_ASIO_HAS_IOCP)
  54. BOOST_ASIO_DECL void complete_iocp_accept(socket_type s, void* output_buffer,
  55. DWORD address_length, void* addr, std::size_t* addrlen,
  56. socket_type new_socket, boost::system::error_code& ec);
  57. #else // defined(BOOST_ASIO_HAS_IOCP)
  58. BOOST_ASIO_DECL bool non_blocking_accept(socket_type s,
  59. state_type state, void* addr, std::size_t* addrlen,
  60. boost::system::error_code& ec, socket_type& new_socket);
  61. #endif // defined(BOOST_ASIO_HAS_IOCP)
  62. BOOST_ASIO_DECL int bind(socket_type s, const void* addr,
  63. std::size_t addrlen, boost::system::error_code& ec);
  64. BOOST_ASIO_DECL int close(socket_type s, state_type& state,
  65. bool destruction, boost::system::error_code& ec);
  66. BOOST_ASIO_DECL bool set_user_non_blocking(socket_type s,
  67. state_type& state, bool value, boost::system::error_code& ec);
  68. BOOST_ASIO_DECL bool set_internal_non_blocking(socket_type s,
  69. state_type& state, bool value, boost::system::error_code& ec);
  70. BOOST_ASIO_DECL int shutdown(socket_type s,
  71. int what, boost::system::error_code& ec);
  72. BOOST_ASIO_DECL int connect(socket_type s, const void* addr,
  73. std::size_t addrlen, boost::system::error_code& ec);
  74. BOOST_ASIO_DECL void sync_connect(socket_type s, const void* addr,
  75. std::size_t addrlen, boost::system::error_code& ec);
  76. #if defined(BOOST_ASIO_HAS_IOCP)
  77. BOOST_ASIO_DECL void complete_iocp_connect(socket_type s,
  78. boost::system::error_code& ec);
  79. #endif // defined(BOOST_ASIO_HAS_IOCP)
  80. BOOST_ASIO_DECL bool non_blocking_connect(socket_type s,
  81. boost::system::error_code& ec);
  82. BOOST_ASIO_DECL int socketpair(int af, int type, int protocol,
  83. socket_type sv[2], boost::system::error_code& ec);
  84. BOOST_ASIO_DECL bool sockatmark(socket_type s, boost::system::error_code& ec);
  85. BOOST_ASIO_DECL size_t available(socket_type s, boost::system::error_code& ec);
  86. BOOST_ASIO_DECL int listen(socket_type s,
  87. int backlog, boost::system::error_code& ec);
  88. #if defined(BOOST_ASIO_WINDOWS) || defined(__CYGWIN__)
  89. typedef WSABUF buf;
  90. #else // defined(BOOST_ASIO_WINDOWS) || defined(__CYGWIN__)
  91. typedef iovec buf;
  92. #endif // defined(BOOST_ASIO_WINDOWS) || defined(__CYGWIN__)
  93. BOOST_ASIO_DECL void init_buf(buf& b, void* data, size_t size);
  94. BOOST_ASIO_DECL void init_buf(buf& b, const void* data, size_t size);
  95. BOOST_ASIO_DECL signed_size_type recv(socket_type s, buf* bufs,
  96. size_t count, int flags, boost::system::error_code& ec);
  97. BOOST_ASIO_DECL signed_size_type recv1(socket_type s,
  98. void* data, size_t size, int flags, boost::system::error_code& ec);
  99. BOOST_ASIO_DECL size_t sync_recv(socket_type s, state_type state, buf* bufs,
  100. size_t count, int flags, bool all_empty, boost::system::error_code& ec);
  101. BOOST_ASIO_DECL size_t sync_recv1(socket_type s, state_type state,
  102. void* data, size_t size, int flags, boost::system::error_code& ec);
  103. #if defined(BOOST_ASIO_HAS_IOCP)
  104. BOOST_ASIO_DECL void complete_iocp_recv(state_type state,
  105. const weak_cancel_token_type& cancel_token, bool all_empty,
  106. boost::system::error_code& ec, size_t bytes_transferred);
  107. #else // defined(BOOST_ASIO_HAS_IOCP)
  108. BOOST_ASIO_DECL bool non_blocking_recv(socket_type s,
  109. buf* bufs, size_t count, int flags, bool is_stream,
  110. boost::system::error_code& ec, size_t& bytes_transferred);
  111. BOOST_ASIO_DECL bool non_blocking_recv1(socket_type s,
  112. void* data, size_t size, int flags, bool is_stream,
  113. boost::system::error_code& ec, size_t& bytes_transferred);
  114. #endif // defined(BOOST_ASIO_HAS_IOCP)
  115. BOOST_ASIO_DECL signed_size_type recvfrom(socket_type s,
  116. buf* bufs, size_t count, int flags, void* addr,
  117. std::size_t* addrlen, boost::system::error_code& ec);
  118. BOOST_ASIO_DECL signed_size_type recvfrom1(socket_type s,
  119. void* data, size_t size, int flags, void* addr,
  120. std::size_t* addrlen, boost::system::error_code& ec);
  121. BOOST_ASIO_DECL size_t sync_recvfrom(socket_type s, state_type state,
  122. buf* bufs, size_t count, int flags, void* addr,
  123. std::size_t* addrlen, boost::system::error_code& ec);
  124. BOOST_ASIO_DECL size_t sync_recvfrom1(socket_type s, state_type state,
  125. void* data, size_t size, int flags, void* addr,
  126. std::size_t* addrlen, boost::system::error_code& ec);
  127. #if defined(BOOST_ASIO_HAS_IOCP)
  128. BOOST_ASIO_DECL void complete_iocp_recvfrom(
  129. const weak_cancel_token_type& cancel_token,
  130. boost::system::error_code& ec);
  131. #else // defined(BOOST_ASIO_HAS_IOCP)
  132. BOOST_ASIO_DECL bool non_blocking_recvfrom(socket_type s, buf* bufs,
  133. size_t count, int flags, void* addr, std::size_t* addrlen,
  134. boost::system::error_code& ec, size_t& bytes_transferred);
  135. BOOST_ASIO_DECL bool non_blocking_recvfrom1(socket_type s, void* data,
  136. size_t size, int flags, void* addr, std::size_t* addrlen,
  137. boost::system::error_code& ec, size_t& bytes_transferred);
  138. #endif // defined(BOOST_ASIO_HAS_IOCP)
  139. BOOST_ASIO_DECL signed_size_type recvmsg(socket_type s, buf* bufs,
  140. size_t count, int in_flags, int& out_flags,
  141. boost::system::error_code& ec);
  142. BOOST_ASIO_DECL size_t sync_recvmsg(socket_type s, state_type state,
  143. buf* bufs, size_t count, int in_flags, int& out_flags,
  144. boost::system::error_code& ec);
  145. #if defined(BOOST_ASIO_HAS_IOCP)
  146. BOOST_ASIO_DECL void complete_iocp_recvmsg(
  147. const weak_cancel_token_type& cancel_token,
  148. boost::system::error_code& ec);
  149. #else // defined(BOOST_ASIO_HAS_IOCP)
  150. BOOST_ASIO_DECL bool non_blocking_recvmsg(socket_type s,
  151. buf* bufs, size_t count, int in_flags, int& out_flags,
  152. boost::system::error_code& ec, size_t& bytes_transferred);
  153. #endif // defined(BOOST_ASIO_HAS_IOCP)
  154. BOOST_ASIO_DECL signed_size_type send(socket_type s, const buf* bufs,
  155. size_t count, int flags, boost::system::error_code& ec);
  156. BOOST_ASIO_DECL signed_size_type send1(socket_type s,
  157. const void* data, size_t size, int flags, boost::system::error_code& ec);
  158. BOOST_ASIO_DECL size_t sync_send(socket_type s, state_type state,
  159. const buf* bufs, size_t count, int flags,
  160. bool all_empty, boost::system::error_code& ec);
  161. BOOST_ASIO_DECL size_t sync_send1(socket_type s, state_type state,
  162. const void* data, size_t size, int flags, boost::system::error_code& ec);
  163. #if defined(BOOST_ASIO_HAS_IOCP)
  164. BOOST_ASIO_DECL void complete_iocp_send(
  165. const weak_cancel_token_type& cancel_token,
  166. boost::system::error_code& ec);
  167. #else // defined(BOOST_ASIO_HAS_IOCP)
  168. BOOST_ASIO_DECL bool non_blocking_send(socket_type s,
  169. const buf* bufs, size_t count, int flags,
  170. boost::system::error_code& ec, size_t& bytes_transferred);
  171. BOOST_ASIO_DECL bool non_blocking_send1(socket_type s,
  172. const void* data, size_t size, int flags,
  173. boost::system::error_code& ec, size_t& bytes_transferred);
  174. #endif // defined(BOOST_ASIO_HAS_IOCP)
  175. BOOST_ASIO_DECL signed_size_type sendto(socket_type s,
  176. const buf* bufs, size_t count, int flags, const void* addr,
  177. std::size_t addrlen, boost::system::error_code& ec);
  178. BOOST_ASIO_DECL signed_size_type sendto1(socket_type s,
  179. const void* data, size_t size, int flags, const void* addr,
  180. std::size_t addrlen, boost::system::error_code& ec);
  181. BOOST_ASIO_DECL size_t sync_sendto(socket_type s, state_type state,
  182. const buf* bufs, size_t count, int flags, const void* addr,
  183. std::size_t addrlen, boost::system::error_code& ec);
  184. BOOST_ASIO_DECL size_t sync_sendto1(socket_type s, state_type state,
  185. const void* data, size_t size, int flags, const void* addr,
  186. std::size_t addrlen, boost::system::error_code& ec);
  187. #if !defined(BOOST_ASIO_HAS_IOCP)
  188. BOOST_ASIO_DECL bool non_blocking_sendto(socket_type s, const buf* bufs,
  189. size_t count, int flags, const void* addr, std::size_t addrlen,
  190. boost::system::error_code& ec, size_t& bytes_transferred);
  191. BOOST_ASIO_DECL bool non_blocking_sendto1(socket_type s, const void* data,
  192. size_t size, int flags, const void* addr, std::size_t addrlen,
  193. boost::system::error_code& ec, size_t& bytes_transferred);
  194. #endif // !defined(BOOST_ASIO_HAS_IOCP)
  195. BOOST_ASIO_DECL socket_type socket(int af, int type, int protocol,
  196. boost::system::error_code& ec);
  197. BOOST_ASIO_DECL int setsockopt(socket_type s, state_type& state,
  198. int level, int optname, const void* optval,
  199. std::size_t optlen, boost::system::error_code& ec);
  200. BOOST_ASIO_DECL int getsockopt(socket_type s, state_type state,
  201. int level, int optname, void* optval,
  202. size_t* optlen, boost::system::error_code& ec);
  203. BOOST_ASIO_DECL int getpeername(socket_type s, void* addr,
  204. std::size_t* addrlen, bool cached, boost::system::error_code& ec);
  205. BOOST_ASIO_DECL int getsockname(socket_type s, void* addr,
  206. std::size_t* addrlen, boost::system::error_code& ec);
  207. BOOST_ASIO_DECL int ioctl(socket_type s, state_type& state,
  208. int cmd, ioctl_arg_type* arg, boost::system::error_code& ec);
  209. BOOST_ASIO_DECL int select(int nfds, fd_set* readfds, fd_set* writefds,
  210. fd_set* exceptfds, timeval* timeout, boost::system::error_code& ec);
  211. BOOST_ASIO_DECL int poll_read(socket_type s,
  212. state_type state, int msec, boost::system::error_code& ec);
  213. BOOST_ASIO_DECL int poll_write(socket_type s,
  214. state_type state, int msec, boost::system::error_code& ec);
  215. BOOST_ASIO_DECL int poll_error(socket_type s,
  216. state_type state, int msec, boost::system::error_code& ec);
  217. BOOST_ASIO_DECL int poll_connect(socket_type s,
  218. int msec, boost::system::error_code& ec);
  219. #endif // !defined(BOOST_ASIO_WINDOWS_RUNTIME)
  220. BOOST_ASIO_DECL const char* inet_ntop(int af, const void* src, char* dest,
  221. size_t length, unsigned long scope_id, boost::system::error_code& ec);
  222. BOOST_ASIO_DECL int inet_pton(int af, const char* src, void* dest,
  223. unsigned long* scope_id, boost::system::error_code& ec);
  224. BOOST_ASIO_DECL int gethostname(char* name,
  225. int namelen, boost::system::error_code& ec);
  226. #if !defined(BOOST_ASIO_WINDOWS_RUNTIME)
  227. BOOST_ASIO_DECL boost::system::error_code getaddrinfo(const char* host,
  228. const char* service, const addrinfo_type& hints,
  229. addrinfo_type** result, boost::system::error_code& ec);
  230. BOOST_ASIO_DECL boost::system::error_code background_getaddrinfo(
  231. const weak_cancel_token_type& cancel_token, const char* host,
  232. const char* service, const addrinfo_type& hints,
  233. addrinfo_type** result, boost::system::error_code& ec);
  234. BOOST_ASIO_DECL void freeaddrinfo(addrinfo_type* ai);
  235. BOOST_ASIO_DECL boost::system::error_code getnameinfo(const void* addr,
  236. std::size_t addrlen, char* host, std::size_t hostlen, char* serv,
  237. std::size_t servlen, int flags, boost::system::error_code& ec);
  238. BOOST_ASIO_DECL boost::system::error_code sync_getnameinfo(const void* addr,
  239. std::size_t addrlen, char* host, std::size_t hostlen, char* serv,
  240. std::size_t servlen, int sock_type, boost::system::error_code& ec);
  241. BOOST_ASIO_DECL boost::system::error_code background_getnameinfo(
  242. const weak_cancel_token_type& cancel_token,
  243. const void* addr, std::size_t addrlen,
  244. char* host, std::size_t hostlen, char* serv,
  245. std::size_t servlen, int sock_type, boost::system::error_code& ec);
  246. #endif // !defined(BOOST_ASIO_WINDOWS_RUNTIME)
  247. BOOST_ASIO_DECL u_long_type network_to_host_long(u_long_type value);
  248. BOOST_ASIO_DECL u_long_type host_to_network_long(u_long_type value);
  249. BOOST_ASIO_DECL u_short_type network_to_host_short(u_short_type value);
  250. BOOST_ASIO_DECL u_short_type host_to_network_short(u_short_type value);
  251. } // namespace socket_ops
  252. } // namespace detail
  253. } // namespace asio
  254. } // namespace boost
  255. #include <boost/asio/detail/pop_options.hpp>
  256. #if defined(BOOST_ASIO_HEADER_ONLY)
  257. # include <boost/asio/detail/impl/socket_ops.ipp>
  258. #endif // defined(BOOST_ASIO_HEADER_ONLY)
  259. #endif // BOOST_ASIO_DETAIL_SOCKET_OPS_HPP