socket_ops.hpp 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385
  1. //
  2. // detail/socket_ops.hpp
  3. // ~~~~~~~~~~~~~~~~~~~~~
  4. //
  5. // Copyright (c) 2003-2021 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, socket_addr_type* addr,
  50. std::size_t* addrlen, boost::system::error_code& ec);
  51. BOOST_ASIO_DECL socket_type sync_accept(socket_type s,
  52. state_type state, socket_addr_type* addr,
  53. std::size_t* addrlen, boost::system::error_code& ec);
  54. #if defined(BOOST_ASIO_HAS_IOCP)
  55. BOOST_ASIO_DECL void complete_iocp_accept(socket_type s,
  56. void* output_buffer, DWORD address_length,
  57. socket_addr_type* addr, std::size_t* addrlen,
  58. socket_type new_socket, boost::system::error_code& ec);
  59. #else // defined(BOOST_ASIO_HAS_IOCP)
  60. BOOST_ASIO_DECL bool non_blocking_accept(socket_type s,
  61. state_type state, socket_addr_type* addr, std::size_t* addrlen,
  62. boost::system::error_code& ec, socket_type& new_socket);
  63. #endif // defined(BOOST_ASIO_HAS_IOCP)
  64. BOOST_ASIO_DECL int bind(socket_type s, const socket_addr_type* addr,
  65. std::size_t addrlen, boost::system::error_code& ec);
  66. BOOST_ASIO_DECL int close(socket_type s, state_type& state,
  67. bool destruction, boost::system::error_code& ec);
  68. BOOST_ASIO_DECL bool set_user_non_blocking(socket_type s,
  69. state_type& state, bool value, boost::system::error_code& ec);
  70. BOOST_ASIO_DECL bool set_internal_non_blocking(socket_type s,
  71. state_type& state, bool value, boost::system::error_code& ec);
  72. BOOST_ASIO_DECL int shutdown(socket_type s,
  73. int what, boost::system::error_code& ec);
  74. BOOST_ASIO_DECL int connect(socket_type s, const socket_addr_type* addr,
  75. std::size_t addrlen, boost::system::error_code& ec);
  76. BOOST_ASIO_DECL void sync_connect(socket_type s, const socket_addr_type* addr,
  77. std::size_t addrlen, boost::system::error_code& ec);
  78. #if defined(BOOST_ASIO_HAS_IOCP)
  79. BOOST_ASIO_DECL void complete_iocp_connect(socket_type s,
  80. boost::system::error_code& ec);
  81. #endif // defined(BOOST_ASIO_HAS_IOCP)
  82. BOOST_ASIO_DECL bool non_blocking_connect(socket_type s,
  83. boost::system::error_code& ec);
  84. BOOST_ASIO_DECL int socketpair(int af, int type, int protocol,
  85. socket_type sv[2], boost::system::error_code& ec);
  86. BOOST_ASIO_DECL bool sockatmark(socket_type s, boost::system::error_code& ec);
  87. BOOST_ASIO_DECL size_t available(socket_type s, boost::system::error_code& ec);
  88. BOOST_ASIO_DECL int listen(socket_type s,
  89. int backlog, boost::system::error_code& ec);
  90. #if defined(BOOST_ASIO_WINDOWS) || defined(__CYGWIN__)
  91. typedef WSABUF buf;
  92. #else // defined(BOOST_ASIO_WINDOWS) || defined(__CYGWIN__)
  93. typedef iovec buf;
  94. #endif // defined(BOOST_ASIO_WINDOWS) || defined(__CYGWIN__)
  95. BOOST_ASIO_DECL void init_buf(buf& b, void* data, size_t size);
  96. BOOST_ASIO_DECL void init_buf(buf& b, const void* data, size_t size);
  97. BOOST_ASIO_DECL signed_size_type recv(socket_type s, buf* bufs,
  98. size_t count, int flags, boost::system::error_code& ec);
  99. BOOST_ASIO_DECL signed_size_type recv1(socket_type s,
  100. void* data, size_t size, int flags, boost::system::error_code& ec);
  101. BOOST_ASIO_DECL size_t sync_recv(socket_type s, state_type state, buf* bufs,
  102. size_t count, int flags, bool all_empty, boost::system::error_code& ec);
  103. BOOST_ASIO_DECL size_t sync_recv1(socket_type s, state_type state,
  104. void* data, size_t size, int flags, boost::system::error_code& ec);
  105. #if defined(BOOST_ASIO_HAS_IOCP)
  106. BOOST_ASIO_DECL void complete_iocp_recv(state_type state,
  107. const weak_cancel_token_type& cancel_token, bool all_empty,
  108. boost::system::error_code& ec, size_t bytes_transferred);
  109. #else // defined(BOOST_ASIO_HAS_IOCP)
  110. BOOST_ASIO_DECL bool non_blocking_recv(socket_type s,
  111. buf* bufs, size_t count, int flags, bool is_stream,
  112. boost::system::error_code& ec, size_t& bytes_transferred);
  113. BOOST_ASIO_DECL bool non_blocking_recv1(socket_type s,
  114. void* data, size_t size, int flags, bool is_stream,
  115. boost::system::error_code& ec, size_t& bytes_transferred);
  116. #endif // defined(BOOST_ASIO_HAS_IOCP)
  117. BOOST_ASIO_DECL signed_size_type recvfrom(socket_type s, buf* bufs,
  118. size_t count, int flags, socket_addr_type* addr,
  119. std::size_t* addrlen, boost::system::error_code& ec);
  120. BOOST_ASIO_DECL signed_size_type recvfrom1(socket_type s, void* data,
  121. size_t size, int flags, socket_addr_type* addr,
  122. std::size_t* addrlen, boost::system::error_code& ec);
  123. BOOST_ASIO_DECL size_t sync_recvfrom(socket_type s, state_type state,
  124. buf* bufs, size_t count, int flags, socket_addr_type* addr,
  125. std::size_t* addrlen, boost::system::error_code& ec);
  126. BOOST_ASIO_DECL size_t sync_recvfrom1(socket_type s, state_type state,
  127. void* data, size_t size, int flags, socket_addr_type* addr,
  128. std::size_t* addrlen, boost::system::error_code& ec);
  129. #if defined(BOOST_ASIO_HAS_IOCP)
  130. BOOST_ASIO_DECL void complete_iocp_recvfrom(
  131. const weak_cancel_token_type& cancel_token,
  132. boost::system::error_code& ec);
  133. #else // defined(BOOST_ASIO_HAS_IOCP)
  134. BOOST_ASIO_DECL bool non_blocking_recvfrom(socket_type s,
  135. buf* bufs, size_t count, int flags,
  136. socket_addr_type* addr, std::size_t* addrlen,
  137. boost::system::error_code& ec, size_t& bytes_transferred);
  138. BOOST_ASIO_DECL bool non_blocking_recvfrom1(socket_type s,
  139. void* data, size_t size, int flags,
  140. socket_addr_type* addr, std::size_t* addrlen,
  141. boost::system::error_code& ec, size_t& bytes_transferred);
  142. #endif // defined(BOOST_ASIO_HAS_IOCP)
  143. BOOST_ASIO_DECL signed_size_type recvmsg(socket_type s, buf* bufs,
  144. size_t count, int in_flags, int& out_flags,
  145. boost::system::error_code& ec);
  146. BOOST_ASIO_DECL size_t sync_recvmsg(socket_type s, state_type state,
  147. buf* bufs, size_t count, int in_flags, int& out_flags,
  148. boost::system::error_code& ec);
  149. #if defined(BOOST_ASIO_HAS_IOCP)
  150. BOOST_ASIO_DECL void complete_iocp_recvmsg(
  151. const weak_cancel_token_type& cancel_token,
  152. boost::system::error_code& ec);
  153. #else // defined(BOOST_ASIO_HAS_IOCP)
  154. BOOST_ASIO_DECL bool non_blocking_recvmsg(socket_type s,
  155. buf* bufs, size_t count, int in_flags, int& out_flags,
  156. boost::system::error_code& ec, size_t& bytes_transferred);
  157. #endif // defined(BOOST_ASIO_HAS_IOCP)
  158. BOOST_ASIO_DECL signed_size_type send(socket_type s, const buf* bufs,
  159. size_t count, int flags, boost::system::error_code& ec);
  160. BOOST_ASIO_DECL signed_size_type send1(socket_type s,
  161. const void* data, size_t size, int flags, boost::system::error_code& ec);
  162. BOOST_ASIO_DECL size_t sync_send(socket_type s, state_type state,
  163. const buf* bufs, size_t count, int flags,
  164. bool all_empty, boost::system::error_code& ec);
  165. BOOST_ASIO_DECL size_t sync_send1(socket_type s, state_type state,
  166. const void* data, size_t size, int flags, boost::system::error_code& ec);
  167. #if defined(BOOST_ASIO_HAS_IOCP)
  168. BOOST_ASIO_DECL void complete_iocp_send(
  169. const weak_cancel_token_type& cancel_token,
  170. boost::system::error_code& ec);
  171. #else // defined(BOOST_ASIO_HAS_IOCP)
  172. BOOST_ASIO_DECL bool non_blocking_send(socket_type s,
  173. const buf* bufs, size_t count, int flags,
  174. boost::system::error_code& ec, size_t& bytes_transferred);
  175. BOOST_ASIO_DECL bool non_blocking_send1(socket_type s,
  176. const void* data, size_t size, int flags,
  177. boost::system::error_code& ec, size_t& bytes_transferred);
  178. #endif // defined(BOOST_ASIO_HAS_IOCP)
  179. BOOST_ASIO_DECL signed_size_type sendto(socket_type s, const buf* bufs,
  180. size_t count, int flags, const socket_addr_type* addr,
  181. std::size_t addrlen, boost::system::error_code& ec);
  182. BOOST_ASIO_DECL signed_size_type sendto1(socket_type s, const void* data,
  183. size_t size, int flags, const socket_addr_type* addr,
  184. std::size_t addrlen, boost::system::error_code& ec);
  185. BOOST_ASIO_DECL size_t sync_sendto(socket_type s, state_type state,
  186. const buf* bufs, size_t count, int flags, const socket_addr_type* addr,
  187. std::size_t addrlen, boost::system::error_code& ec);
  188. BOOST_ASIO_DECL size_t sync_sendto1(socket_type s, state_type state,
  189. const void* data, size_t size, int flags, const socket_addr_type* addr,
  190. std::size_t addrlen, boost::system::error_code& ec);
  191. #if !defined(BOOST_ASIO_HAS_IOCP)
  192. BOOST_ASIO_DECL bool non_blocking_sendto(socket_type s,
  193. const buf* bufs, size_t count, int flags,
  194. const socket_addr_type* addr, std::size_t addrlen,
  195. boost::system::error_code& ec, size_t& bytes_transferred);
  196. BOOST_ASIO_DECL bool non_blocking_sendto1(socket_type s,
  197. const void* data, size_t size, int flags,
  198. const socket_addr_type* addr, std::size_t addrlen,
  199. boost::system::error_code& ec, size_t& bytes_transferred);
  200. #endif // !defined(BOOST_ASIO_HAS_IOCP)
  201. BOOST_ASIO_DECL socket_type socket(int af, int type, int protocol,
  202. boost::system::error_code& ec);
  203. BOOST_ASIO_DECL int setsockopt(socket_type s, state_type& state,
  204. int level, int optname, const void* optval,
  205. std::size_t optlen, boost::system::error_code& ec);
  206. BOOST_ASIO_DECL int getsockopt(socket_type s, state_type state,
  207. int level, int optname, void* optval,
  208. size_t* optlen, boost::system::error_code& ec);
  209. BOOST_ASIO_DECL int getpeername(socket_type s, socket_addr_type* addr,
  210. std::size_t* addrlen, bool cached, boost::system::error_code& ec);
  211. BOOST_ASIO_DECL int getsockname(socket_type s, socket_addr_type* addr,
  212. std::size_t* addrlen, boost::system::error_code& ec);
  213. BOOST_ASIO_DECL int ioctl(socket_type s, state_type& state,
  214. int cmd, ioctl_arg_type* arg, boost::system::error_code& ec);
  215. BOOST_ASIO_DECL int select(int nfds, fd_set* readfds, fd_set* writefds,
  216. fd_set* exceptfds, timeval* timeout, boost::system::error_code& ec);
  217. BOOST_ASIO_DECL int poll_read(socket_type s,
  218. state_type state, int msec, boost::system::error_code& ec);
  219. BOOST_ASIO_DECL int poll_write(socket_type s,
  220. state_type state, int msec, boost::system::error_code& ec);
  221. BOOST_ASIO_DECL int poll_error(socket_type s,
  222. state_type state, int msec, boost::system::error_code& ec);
  223. BOOST_ASIO_DECL int poll_connect(socket_type s,
  224. int msec, boost::system::error_code& ec);
  225. #endif // !defined(BOOST_ASIO_WINDOWS_RUNTIME)
  226. BOOST_ASIO_DECL const char* inet_ntop(int af, const void* src, char* dest,
  227. size_t length, unsigned long scope_id, boost::system::error_code& ec);
  228. BOOST_ASIO_DECL int inet_pton(int af, const char* src, void* dest,
  229. unsigned long* scope_id, boost::system::error_code& ec);
  230. BOOST_ASIO_DECL int gethostname(char* name,
  231. int namelen, boost::system::error_code& ec);
  232. #if !defined(BOOST_ASIO_WINDOWS_RUNTIME)
  233. BOOST_ASIO_DECL boost::system::error_code getaddrinfo(const char* host,
  234. const char* service, const addrinfo_type& hints,
  235. addrinfo_type** result, boost::system::error_code& ec);
  236. BOOST_ASIO_DECL boost::system::error_code background_getaddrinfo(
  237. const weak_cancel_token_type& cancel_token, const char* host,
  238. const char* service, const addrinfo_type& hints,
  239. addrinfo_type** result, boost::system::error_code& ec);
  240. BOOST_ASIO_DECL void freeaddrinfo(addrinfo_type* ai);
  241. BOOST_ASIO_DECL boost::system::error_code getnameinfo(
  242. const socket_addr_type* addr, std::size_t addrlen,
  243. char* host, std::size_t hostlen, char* serv,
  244. std::size_t servlen, int flags, boost::system::error_code& ec);
  245. BOOST_ASIO_DECL boost::system::error_code sync_getnameinfo(
  246. const socket_addr_type* addr, std::size_t addrlen,
  247. char* host, std::size_t hostlen, char* serv,
  248. std::size_t servlen, int sock_type, boost::system::error_code& ec);
  249. BOOST_ASIO_DECL boost::system::error_code background_getnameinfo(
  250. const weak_cancel_token_type& cancel_token,
  251. const socket_addr_type* addr, std::size_t addrlen,
  252. char* host, std::size_t hostlen, char* serv,
  253. std::size_t servlen, int sock_type, boost::system::error_code& ec);
  254. #endif // !defined(BOOST_ASIO_WINDOWS_RUNTIME)
  255. BOOST_ASIO_DECL u_long_type network_to_host_long(u_long_type value);
  256. BOOST_ASIO_DECL u_long_type host_to_network_long(u_long_type value);
  257. BOOST_ASIO_DECL u_short_type network_to_host_short(u_short_type value);
  258. BOOST_ASIO_DECL u_short_type host_to_network_short(u_short_type value);
  259. } // namespace socket_ops
  260. } // namespace detail
  261. } // namespace asio
  262. } // namespace boost
  263. #include <boost/asio/detail/pop_options.hpp>
  264. #if defined(BOOST_ASIO_HEADER_ONLY)
  265. # include <boost/asio/detail/impl/socket_ops.ipp>
  266. #endif // defined(BOOST_ASIO_HEADER_ONLY)
  267. #endif // BOOST_ASIO_DETAIL_SOCKET_OPS_HPP