Bitcoin Core 29.99.0
P2P Digital Currency
netbase.cpp
Go to the documentation of this file.
1// Copyright (c) 2009-2010 Satoshi Nakamoto
2// Copyright (c) 2009-2022 The Bitcoin Core developers
3// Distributed under the MIT software license, see the accompanying
4// file COPYING or http://www.opensource.org/licenses/mit-license.php.
5
6#include <bitcoin-build-config.h> // IWYU pragma: keep
7
8#include <netbase.h>
9
10#include <compat/compat.h>
11#include <logging.h>
12#include <sync.h>
13#include <tinyformat.h>
14#include <util/sock.h>
15#include <util/strencodings.h>
16#include <util/string.h>
17#include <util/time.h>
18
19#include <atomic>
20#include <chrono>
21#include <cstdint>
22#include <functional>
23#include <limits>
24#include <memory>
25
26#ifdef HAVE_SOCKADDR_UN
27#include <sys/un.h>
28#endif
29
31
32// Settings
35static Proxy nameProxy GUARDED_BY(g_proxyinfo_mutex);
38
39// Need ample time for negotiation for very slow proxies such as Tor
40std::chrono::milliseconds g_socks5_recv_timeout = 20s;
42
44
45std::vector<CNetAddr> WrappedGetAddrInfo(const std::string& name, bool allow_lookup)
46{
47 addrinfo ai_hint{};
48 // We want a TCP port, which is a streaming socket type
49 ai_hint.ai_socktype = SOCK_STREAM;
50 ai_hint.ai_protocol = IPPROTO_TCP;
51 // We don't care which address family (IPv4 or IPv6) is returned
52 ai_hint.ai_family = AF_UNSPEC;
53
54 // If we allow lookups of hostnames, use the AI_ADDRCONFIG flag to only
55 // return addresses whose family we have an address configured for.
56 //
57 // If we don't allow lookups, then use the AI_NUMERICHOST flag for
58 // getaddrinfo to only decode numerical network addresses and suppress
59 // hostname lookups.
60 ai_hint.ai_flags = allow_lookup ? AI_ADDRCONFIG : AI_NUMERICHOST;
61
62 addrinfo* ai_res{nullptr};
63 const int n_err{getaddrinfo(name.c_str(), nullptr, &ai_hint, &ai_res)};
64 if (n_err != 0) {
65 if ((ai_hint.ai_flags & AI_ADDRCONFIG) == AI_ADDRCONFIG) {
66 // AI_ADDRCONFIG on some systems may exclude loopback-only addresses
67 // If first lookup failed we perform a second lookup without AI_ADDRCONFIG
68 ai_hint.ai_flags = (ai_hint.ai_flags & ~AI_ADDRCONFIG);
69 const int n_err_retry{getaddrinfo(name.c_str(), nullptr, &ai_hint, &ai_res)};
70 if (n_err_retry != 0) {
71 return {};
72 }
73 } else {
74 return {};
75 }
76 }
77
78 // Traverse the linked list starting with ai_trav.
79 addrinfo* ai_trav{ai_res};
80 std::vector<CNetAddr> resolved_addresses;
81 while (ai_trav != nullptr) {
82 if (ai_trav->ai_family == AF_INET) {
83 assert(ai_trav->ai_addrlen >= sizeof(sockaddr_in));
84 resolved_addresses.emplace_back(reinterpret_cast<sockaddr_in*>(ai_trav->ai_addr)->sin_addr);
85 }
86 if (ai_trav->ai_family == AF_INET6) {
87 assert(ai_trav->ai_addrlen >= sizeof(sockaddr_in6));
88 const sockaddr_in6* s6{reinterpret_cast<sockaddr_in6*>(ai_trav->ai_addr)};
89 resolved_addresses.emplace_back(s6->sin6_addr, s6->sin6_scope_id);
90 }
91 ai_trav = ai_trav->ai_next;
92 }
93 freeaddrinfo(ai_res);
94
95 return resolved_addresses;
96}
97
99
100enum Network ParseNetwork(const std::string& net_in) {
101 std::string net = ToLower(net_in);
102 if (net == "ipv4") return NET_IPV4;
103 if (net == "ipv6") return NET_IPV6;
104 if (net == "onion") return NET_ONION;
105 if (net == "tor") {
106 LogPrintf("Warning: net name 'tor' is deprecated and will be removed in the future. You should use 'onion' instead.\n");
107 return NET_ONION;
108 }
109 if (net == "i2p") {
110 return NET_I2P;
111 }
112 if (net == "cjdns") {
113 return NET_CJDNS;
114 }
115 return NET_UNROUTABLE;
116}
117
118std::string GetNetworkName(enum Network net)
119{
120 switch (net) {
121 case NET_UNROUTABLE: return "not_publicly_routable";
122 case NET_IPV4: return "ipv4";
123 case NET_IPV6: return "ipv6";
124 case NET_ONION: return "onion";
125 case NET_I2P: return "i2p";
126 case NET_CJDNS: return "cjdns";
127 case NET_INTERNAL: return "internal";
128 case NET_MAX: assert(false);
129 } // no default case, so the compiler can warn about missing cases
130
131 assert(false);
132}
133
134std::vector<std::string> GetNetworkNames(bool append_unroutable)
135{
136 std::vector<std::string> names;
137 for (int n = 0; n < NET_MAX; ++n) {
138 const enum Network network{static_cast<Network>(n)};
139 if (network == NET_UNROUTABLE || network == NET_INTERNAL) continue;
140 names.emplace_back(GetNetworkName(network));
141 }
142 if (append_unroutable) {
143 names.emplace_back(GetNetworkName(NET_UNROUTABLE));
144 }
145 return names;
146}
147
148static std::vector<CNetAddr> LookupIntern(const std::string& name, unsigned int nMaxSolutions, bool fAllowLookup, DNSLookupFn dns_lookup_function)
149{
150 if (!ContainsNoNUL(name)) return {};
151 {
152 CNetAddr addr;
153 // From our perspective, onion addresses are not hostnames but rather
154 // direct encodings of CNetAddr much like IPv4 dotted-decimal notation
155 // or IPv6 colon-separated hextet notation. Since we can't use
156 // getaddrinfo to decode them and it wouldn't make sense to resolve
157 // them, we return a network address representing it instead. See
158 // CNetAddr::SetSpecial(const std::string&) for more details.
159 if (addr.SetSpecial(name)) return {addr};
160 }
161
162 std::vector<CNetAddr> addresses;
163
164 for (const CNetAddr& resolved : dns_lookup_function(name, fAllowLookup)) {
165 if (nMaxSolutions > 0 && addresses.size() >= nMaxSolutions) {
166 break;
167 }
168 /* Never allow resolving to an internal address. Consider any such result invalid */
169 if (!resolved.IsInternal()) {
170 addresses.push_back(resolved);
171 }
172 }
173
174 return addresses;
175}
176
177std::vector<CNetAddr> LookupHost(const std::string& name, unsigned int nMaxSolutions, bool fAllowLookup, DNSLookupFn dns_lookup_function)
178{
179 if (!ContainsNoNUL(name)) return {};
180 std::string strHost = name;
181 if (strHost.empty()) return {};
182 if (strHost.front() == '[' && strHost.back() == ']') {
183 strHost = strHost.substr(1, strHost.size() - 2);
184 }
185
186 return LookupIntern(strHost, nMaxSolutions, fAllowLookup, dns_lookup_function);
187}
188
189std::optional<CNetAddr> LookupHost(const std::string& name, bool fAllowLookup, DNSLookupFn dns_lookup_function)
190{
191 const std::vector<CNetAddr> addresses{LookupHost(name, 1, fAllowLookup, dns_lookup_function)};
192 return addresses.empty() ? std::nullopt : std::make_optional(addresses.front());
193}
194
195std::vector<CService> Lookup(const std::string& name, uint16_t portDefault, bool fAllowLookup, unsigned int nMaxSolutions, DNSLookupFn dns_lookup_function)
196{
197 if (name.empty() || !ContainsNoNUL(name)) {
198 return {};
199 }
200 uint16_t port{portDefault};
201 std::string hostname;
202 SplitHostPort(name, port, hostname);
203
204 const std::vector<CNetAddr> addresses{LookupIntern(hostname, nMaxSolutions, fAllowLookup, dns_lookup_function)};
205 if (addresses.empty()) return {};
206 std::vector<CService> services;
207 services.reserve(addresses.size());
208 for (const auto& addr : addresses)
209 services.emplace_back(addr, port);
210 return services;
211}
212
213std::optional<CService> Lookup(const std::string& name, uint16_t portDefault, bool fAllowLookup, DNSLookupFn dns_lookup_function)
214{
215 const std::vector<CService> services{Lookup(name, portDefault, fAllowLookup, 1, dns_lookup_function)};
216
217 return services.empty() ? std::nullopt : std::make_optional(services.front());
218}
219
220CService LookupNumeric(const std::string& name, uint16_t portDefault, DNSLookupFn dns_lookup_function)
221{
222 if (!ContainsNoNUL(name)) {
223 return {};
224 }
225 // "1.2:345" will fail to resolve the ip, but will still set the port.
226 // If the ip fails to resolve, re-init the result.
227 return Lookup(name, portDefault, /*fAllowLookup=*/false, dns_lookup_function).value_or(CService{});
228}
229
230bool IsUnixSocketPath(const std::string& name)
231{
232#ifdef HAVE_SOCKADDR_UN
233 if (!name.starts_with(ADDR_PREFIX_UNIX)) return false;
234
235 // Split off "unix:" prefix
236 std::string str{name.substr(ADDR_PREFIX_UNIX.length())};
237
238 // Path size limit is platform-dependent
239 // see https://manpages.ubuntu.com/manpages/xenial/en/man7/unix.7.html
240 if (str.size() + 1 > sizeof(((sockaddr_un*)nullptr)->sun_path)) return false;
241
242 return true;
243#else
244 return false;
245#endif
246}
247
249enum SOCKSVersion: uint8_t {
250 SOCKS4 = 0x04,
251 SOCKS5 = 0x05
253
255enum SOCKS5Method: uint8_t {
256 NOAUTH = 0x00,
257 GSSAPI = 0x01,
258 USER_PASS = 0x02,
260};
261
263enum SOCKS5Command: uint8_t {
264 CONNECT = 0x01,
265 BIND = 0x02,
266 UDP_ASSOCIATE = 0x03
268
270enum SOCKS5Reply: uint8_t {
271 SUCCEEDED = 0x00,
272 GENFAILURE = 0x01,
273 NOTALLOWED = 0x02,
276 CONNREFUSED = 0x05,
277 TTLEXPIRED = 0x06,
288};
289
291enum SOCKS5Atyp: uint8_t {
292 IPV4 = 0x01,
294 IPV6 = 0x04,
295};
296
298enum class IntrRecvError {
299 OK,
300 Timeout,
304};
305
322static IntrRecvError InterruptibleRecv(uint8_t* data, size_t len, std::chrono::milliseconds timeout, const Sock& sock)
323{
324 auto curTime{Now<SteadyMilliseconds>()};
325 const auto endTime{curTime + timeout};
326 while (len > 0 && curTime < endTime) {
327 ssize_t ret = sock.Recv(data, len, 0); // Optimistically try the recv first
328 if (ret > 0) {
329 len -= ret;
330 data += ret;
331 } else if (ret == 0) { // Unexpected disconnection
333 } else { // Other error or blocking
334 int nErr = WSAGetLastError();
335 if (nErr == WSAEINPROGRESS || nErr == WSAEWOULDBLOCK || nErr == WSAEINVAL) {
336 // Only wait at most MAX_WAIT_FOR_IO at a time, unless
337 // we're approaching the end of the specified total timeout
338 const auto remaining = std::chrono::milliseconds{endTime - curTime};
339 const auto timeout = std::min(remaining, std::chrono::milliseconds{MAX_WAIT_FOR_IO});
340 if (!sock.Wait(timeout, Sock::RECV)) {
342 }
343 } else {
345 }
346 }
347 if (g_socks5_interrupt) {
349 }
350 curTime = Now<SteadyMilliseconds>();
351 }
352 return len == 0 ? IntrRecvError::OK : IntrRecvError::Timeout;
353}
354
356static std::string Socks5ErrorString(uint8_t err)
357{
358 switch(err) {
360 return "general failure";
362 return "connection not allowed";
364 return "network unreachable";
366 return "host unreachable";
368 return "connection refused";
370 return "TTL expired";
372 return "protocol error";
374 return "address type not supported";
376 return "onion service descriptor can not be found";
378 return "onion service descriptor is invalid";
380 return "onion service introduction failed";
382 return "onion service rendezvous failed";
384 return "onion service missing client authorization";
386 return "onion service wrong client authorization";
388 return "onion service invalid address";
390 return "onion service introduction timed out";
391 default:
392 return strprintf("unknown (0x%02x)", err);
393 }
394}
395
396bool Socks5(const std::string& strDest, uint16_t port, const ProxyCredentials* auth, const Sock& sock)
397{
398 try {
399 IntrRecvError recvr;
400 LogDebug(BCLog::NET, "SOCKS5 connecting %s\n", strDest);
401 if (strDest.size() > 255) {
402 LogError("Hostname too long\n");
403 return false;
404 }
405 // Construct the version identifier/method selection message
406 std::vector<uint8_t> vSocks5Init;
407 vSocks5Init.push_back(SOCKSVersion::SOCKS5); // We want the SOCK5 protocol
408 if (auth) {
409 vSocks5Init.push_back(0x02); // 2 method identifiers follow...
410 vSocks5Init.push_back(SOCKS5Method::NOAUTH);
411 vSocks5Init.push_back(SOCKS5Method::USER_PASS);
412 } else {
413 vSocks5Init.push_back(0x01); // 1 method identifier follows...
414 vSocks5Init.push_back(SOCKS5Method::NOAUTH);
415 }
417 uint8_t pchRet1[2];
419 LogPrintf("Socks5() connect to %s:%d failed: InterruptibleRecv() timeout or other failure\n", strDest, port);
420 return false;
421 }
422 if (pchRet1[0] != SOCKSVersion::SOCKS5) {
423 LogError("Proxy failed to initialize\n");
424 return false;
425 }
426 if (pchRet1[1] == SOCKS5Method::USER_PASS && auth) {
427 // Perform username/password authentication (as described in RFC1929)
428 std::vector<uint8_t> vAuth;
429 vAuth.push_back(0x01); // Current (and only) version of user/pass subnegotiation
430 if (auth->username.size() > 255 || auth->password.size() > 255) {
431 LogError("Proxy username or password too long\n");
432 return false;
433 }
434 vAuth.push_back(auth->username.size());
435 vAuth.insert(vAuth.end(), auth->username.begin(), auth->username.end());
436 vAuth.push_back(auth->password.size());
437 vAuth.insert(vAuth.end(), auth->password.begin(), auth->password.end());
439 LogDebug(BCLog::PROXY, "SOCKS5 sending proxy authentication %s:%s\n", auth->username, auth->password);
440 uint8_t pchRetA[2];
442 LogError("Error reading proxy authentication response\n");
443 return false;
444 }
445 if (pchRetA[0] != 0x01 || pchRetA[1] != 0x00) {
446 LogError("Proxy authentication unsuccessful\n");
447 return false;
448 }
449 } else if (pchRet1[1] == SOCKS5Method::NOAUTH) {
450 // Perform no authentication
451 } else {
452 LogError("Proxy requested wrong authentication method %02x\n", pchRet1[1]);
453 return false;
454 }
455 std::vector<uint8_t> vSocks5;
456 vSocks5.push_back(SOCKSVersion::SOCKS5); // VER protocol version
457 vSocks5.push_back(SOCKS5Command::CONNECT); // CMD CONNECT
458 vSocks5.push_back(0x00); // RSV Reserved must be 0
459 vSocks5.push_back(SOCKS5Atyp::DOMAINNAME); // ATYP DOMAINNAME
460 vSocks5.push_back(strDest.size()); // Length<=255 is checked at beginning of function
461 vSocks5.insert(vSocks5.end(), strDest.begin(), strDest.end());
462 vSocks5.push_back((port >> 8) & 0xFF);
463 vSocks5.push_back((port >> 0) & 0xFF);
465 uint8_t pchRet2[4];
466 if ((recvr = InterruptibleRecv(pchRet2, 4, g_socks5_recv_timeout, sock)) != IntrRecvError::OK) {
467 if (recvr == IntrRecvError::Timeout) {
468 /* If a timeout happens here, this effectively means we timed out while connecting
469 * to the remote node. This is very common for Tor, so do not print an
470 * error message. */
471 return false;
472 } else {
473 LogError("Error while reading proxy response\n");
474 return false;
475 }
476 }
477 if (pchRet2[0] != SOCKSVersion::SOCKS5) {
478 LogError("Proxy failed to accept request\n");
479 return false;
480 }
481 if (pchRet2[1] != SOCKS5Reply::SUCCEEDED) {
482 // Failures to connect to a peer that are not proxy errors
484 "Socks5() connect to %s:%d failed: %s\n", strDest, port, Socks5ErrorString(pchRet2[1]));
485 return false;
486 }
487 if (pchRet2[2] != 0x00) { // Reserved field must be 0
488 LogError("Error: malformed proxy response\n");
489 return false;
490 }
491 uint8_t pchRet3[256];
492 switch (pchRet2[3]) {
493 case SOCKS5Atyp::IPV4: recvr = InterruptibleRecv(pchRet3, 4, g_socks5_recv_timeout, sock); break;
494 case SOCKS5Atyp::IPV6: recvr = InterruptibleRecv(pchRet3, 16, g_socks5_recv_timeout, sock); break;
496 recvr = InterruptibleRecv(pchRet3, 1, g_socks5_recv_timeout, sock);
497 if (recvr != IntrRecvError::OK) {
498 LogError("Error reading from proxy\n");
499 return false;
500 }
501 int nRecv = pchRet3[0];
502 recvr = InterruptibleRecv(pchRet3, nRecv, g_socks5_recv_timeout, sock);
503 break;
504 }
505 default: {
506 LogError("Error: malformed proxy response\n");
507 return false;
508 }
509 }
510 if (recvr != IntrRecvError::OK) {
511 LogError("Error reading from proxy\n");
512 return false;
513 }
515 LogError("Error reading from proxy\n");
516 return false;
517 }
518 LogDebug(BCLog::NET, "SOCKS5 connected %s\n", strDest);
519 return true;
520 } catch (const std::runtime_error& e) {
521 LogError("Error during SOCKS5 proxy handshake: %s\n", e.what());
522 return false;
523 }
524}
525
526std::unique_ptr<Sock> CreateSockOS(int domain, int type, int protocol)
527{
528 // Not IPv4, IPv6 or UNIX
529 if (domain == AF_UNSPEC) return nullptr;
530
531 // Create a socket in the specified address family.
532 SOCKET hSocket = socket(domain, type, protocol);
533 if (hSocket == INVALID_SOCKET) {
534 return nullptr;
535 }
536
537 auto sock = std::make_unique<Sock>(hSocket);
538
539 if (domain != AF_INET && domain != AF_INET6 && domain != AF_UNIX) {
540 return sock;
541 }
542
543 // Ensure that waiting for I/O on this socket won't result in undefined
544 // behavior.
545 if (!sock->IsSelectable()) {
546 LogPrintf("Cannot create connection: non-selectable socket created (fd >= FD_SETSIZE ?)\n");
547 return nullptr;
548 }
549
550#ifdef SO_NOSIGPIPE
551 int set = 1;
552 // Set the no-sigpipe option on the socket for BSD systems, other UNIXes
553 // should use the MSG_NOSIGNAL flag for every send.
554 if (sock->SetSockOpt(SOL_SOCKET, SO_NOSIGPIPE, (void*)&set, sizeof(int)) == SOCKET_ERROR) {
555 LogPrintf("Error setting SO_NOSIGPIPE on socket: %s, continuing anyway\n",
557 }
558#endif
559
560 // Set the non-blocking option on the socket.
561 if (!sock->SetNonBlocking()) {
562 LogPrintf("Error setting socket to non-blocking: %s\n", NetworkErrorString(WSAGetLastError()));
563 return nullptr;
564 }
565
566#ifdef HAVE_SOCKADDR_UN
567 if (domain == AF_UNIX) return sock;
568#endif
569
570 if (protocol == IPPROTO_TCP) {
571 // Set the no-delay option (disable Nagle's algorithm) on the TCP socket.
572 const int on{1};
573 if (sock->SetSockOpt(IPPROTO_TCP, TCP_NODELAY, &on, sizeof(on)) == SOCKET_ERROR) {
574 LogDebug(BCLog::NET, "Unable to set TCP_NODELAY on a newly created socket, continuing anyway\n");
575 }
576 }
577
578 return sock;
579}
580
581std::function<std::unique_ptr<Sock>(int, int, int)> CreateSock = CreateSockOS;
582
583template<typename... Args>
584static void LogConnectFailure(bool manual_connection, util::ConstevalFormatString<sizeof...(Args)> fmt, const Args&... args)
585{
586 std::string error_message = tfm::format(fmt, args...);
587 if (manual_connection) {
588 LogPrintf("%s\n", error_message);
589 } else {
590 LogDebug(BCLog::NET, "%s\n", error_message);
591 }
592}
593
594static bool ConnectToSocket(const Sock& sock, struct sockaddr* sockaddr, socklen_t len, const std::string& dest_str, bool manual_connection)
595{
596 // Connect to `sockaddr` using `sock`.
597 if (sock.Connect(sockaddr, len) == SOCKET_ERROR) {
598 int nErr = WSAGetLastError();
599 // WSAEINVAL is here because some legacy version of winsock uses it
600 if (nErr == WSAEINPROGRESS || nErr == WSAEWOULDBLOCK || nErr == WSAEINVAL)
601 {
602 // Connection didn't actually fail, but is being established
603 // asynchronously. Thus, use async I/O api (select/poll)
604 // synchronously to check for successful connection with a timeout.
605 const Sock::Event requested = Sock::RECV | Sock::SEND;
606 Sock::Event occurred;
607 if (!sock.Wait(std::chrono::milliseconds{nConnectTimeout}, requested, &occurred)) {
608 LogPrintf("wait for connect to %s failed: %s\n",
609 dest_str,
611 return false;
612 } else if (occurred == 0) {
613 LogPrintLevel(BCLog::NET, BCLog::Level::Debug, "connection attempt to %s timed out\n", dest_str);
614 return false;
615 }
616
617 // Even if the wait was successful, the connect might not
618 // have been successful. The reason for this failure is hidden away
619 // in the SO_ERROR for the socket in modern systems. We read it into
620 // sockerr here.
621 int sockerr;
622 socklen_t sockerr_len = sizeof(sockerr);
623 if (sock.GetSockOpt(SOL_SOCKET, SO_ERROR, (sockopt_arg_type)&sockerr, &sockerr_len) ==
624 SOCKET_ERROR) {
625 LogPrintf("getsockopt() for %s failed: %s\n", dest_str, NetworkErrorString(WSAGetLastError()));
626 return false;
627 }
628 if (sockerr != 0) {
629 LogConnectFailure(manual_connection,
630 "connect() to %s failed after wait: %s",
631 dest_str,
632 NetworkErrorString(sockerr));
633 return false;
634 }
635 }
636#ifdef WIN32
637 else if (WSAGetLastError() != WSAEISCONN)
638#else
639 else
640#endif
641 {
642 LogConnectFailure(manual_connection, "connect() to %s failed: %s", dest_str, NetworkErrorString(WSAGetLastError()));
643 return false;
644 }
645 }
646 return true;
647}
648
649std::unique_ptr<Sock> ConnectDirectly(const CService& dest, bool manual_connection)
650{
651 auto sock = CreateSock(dest.GetSAFamily(), SOCK_STREAM, IPPROTO_TCP);
652 if (!sock) {
653 LogPrintLevel(BCLog::NET, BCLog::Level::Error, "Cannot create a socket for connecting to %s\n", dest.ToStringAddrPort());
654 return {};
655 }
656
657 // Create a sockaddr from the specified service.
658 struct sockaddr_storage sockaddr;
659 socklen_t len = sizeof(sockaddr);
660 if (!dest.GetSockAddr((struct sockaddr*)&sockaddr, &len)) {
661 LogPrintf("Cannot get sockaddr for %s: unsupported network\n", dest.ToStringAddrPort());
662 return {};
663 }
664
665 if (!ConnectToSocket(*sock, (struct sockaddr*)&sockaddr, len, dest.ToStringAddrPort(), manual_connection)) {
666 return {};
667 }
668
669 return sock;
670}
671
672std::unique_ptr<Sock> Proxy::Connect() const
673{
674 if (!IsValid()) return {};
675
676 if (!m_is_unix_socket) return ConnectDirectly(proxy, /*manual_connection=*/true);
677
678#ifdef HAVE_SOCKADDR_UN
679 auto sock = CreateSock(AF_UNIX, SOCK_STREAM, 0);
680 if (!sock) {
681 LogPrintLevel(BCLog::NET, BCLog::Level::Error, "Cannot create a socket for connecting to %s\n", m_unix_socket_path);
682 return {};
683 }
684
685 const std::string path{m_unix_socket_path.substr(ADDR_PREFIX_UNIX.length())};
686
687 struct sockaddr_un addrun;
688 memset(&addrun, 0, sizeof(addrun));
689 addrun.sun_family = AF_UNIX;
690 // leave the last char in addrun.sun_path[] to be always '\0'
691 memcpy(addrun.sun_path, path.c_str(), std::min(sizeof(addrun.sun_path) - 1, path.length()));
692 socklen_t len = sizeof(addrun);
693
694 if(!ConnectToSocket(*sock, (struct sockaddr*)&addrun, len, path, /*manual_connection=*/true)) {
695 return {};
696 }
697
698 return sock;
699#else
700 return {};
701#endif
702}
703
704bool SetProxy(enum Network net, const Proxy &addrProxy) {
705 assert(net >= 0 && net < NET_MAX);
706 if (!addrProxy.IsValid())
707 return false;
709 proxyInfo[net] = addrProxy;
710 return true;
711}
712
713bool GetProxy(enum Network net, Proxy &proxyInfoOut) {
714 assert(net >= 0 && net < NET_MAX);
716 if (!proxyInfo[net].IsValid())
717 return false;
718 proxyInfoOut = proxyInfo[net];
719 return true;
720}
721
722bool SetNameProxy(const Proxy &addrProxy) {
723 if (!addrProxy.IsValid())
724 return false;
726 nameProxy = addrProxy;
727 return true;
728}
729
730bool GetNameProxy(Proxy &nameProxyOut) {
732 if(!nameProxy.IsValid())
733 return false;
734 nameProxyOut = nameProxy;
735 return true;
736}
737
740 return nameProxy.IsValid();
741}
742
743bool IsProxy(const CNetAddr &addr) {
745 for (int i = 0; i < NET_MAX; i++) {
746 if (addr == static_cast<CNetAddr>(proxyInfo[i].proxy))
747 return true;
748 }
749 return false;
750}
751
758{
759public:
762 }
763
766 ProxyCredentials auth;
767 auth.username = auth.password = strprintf("%s%i", m_prefix, m_counter);
768 ++m_counter;
769 return auth;
770 }
771
773 static constexpr size_t PREFIX_BYTE_LENGTH = 8;
774private:
775 const std::string m_prefix;
776 std::atomic<uint64_t> m_counter;
777
782 static std::string GenerateUniquePrefix() {
783 std::array<uint8_t, PREFIX_BYTE_LENGTH> prefix_bytes;
784 GetRandBytes(prefix_bytes);
785 return HexStr(prefix_bytes) + "-";
786 }
787};
788
789std::unique_ptr<Sock> ConnectThroughProxy(const Proxy& proxy,
790 const std::string& dest,
791 uint16_t port,
792 bool& proxy_connection_failed)
793{
794 // first connect to proxy server
795 auto sock = proxy.Connect();
796 if (!sock) {
797 proxy_connection_failed = true;
798 return {};
799 }
800
801 // do socks negotiation
802 if (proxy.m_tor_stream_isolation) {
804 ProxyCredentials random_auth{generator.Generate()};
805 if (!Socks5(dest, port, &random_auth, *sock)) {
806 return {};
807 }
808 } else {
809 if (!Socks5(dest, port, nullptr, *sock)) {
810 return {};
811 }
812 }
813 return sock;
814}
815
816CSubNet LookupSubNet(const std::string& subnet_str)
817{
818 CSubNet subnet;
819 assert(!subnet.IsValid());
820 if (!ContainsNoNUL(subnet_str)) {
821 return subnet;
822 }
823
824 const size_t slash_pos{subnet_str.find_last_of('/')};
825 const std::string str_addr{subnet_str.substr(0, slash_pos)};
826 std::optional<CNetAddr> addr{LookupHost(str_addr, /*fAllowLookup=*/false)};
827
828 if (addr.has_value()) {
829 addr = static_cast<CNetAddr>(MaybeFlipIPv6toCJDNS(CService{addr.value(), /*port=*/0}));
830 if (slash_pos != subnet_str.npos) {
831 const std::string netmask_str{subnet_str.substr(slash_pos + 1)};
832 uint8_t netmask;
833 if (ParseUInt8(netmask_str, &netmask)) {
834 // Valid number; assume CIDR variable-length subnet masking.
835 subnet = CSubNet{addr.value(), netmask};
836 } else {
837 // Invalid number; try full netmask syntax. Never allow lookup for netmask.
838 const std::optional<CNetAddr> full_netmask{LookupHost(netmask_str, /*fAllowLookup=*/false)};
839 if (full_netmask.has_value()) {
840 subnet = CSubNet{addr.value(), full_netmask.value()};
841 }
842 }
843 } else {
844 // Single IP subnet (<ipv4>/32 or <ipv6>/128).
845 subnet = CSubNet{addr.value()};
846 }
847 }
848
849 return subnet;
850}
851
852bool IsBadPort(uint16_t port)
853{
854 /* Don't forget to update doc/p2p-bad-ports.md if you change this list. */
855
856 switch (port) {
857 case 1: // tcpmux
858 case 7: // echo
859 case 9: // discard
860 case 11: // systat
861 case 13: // daytime
862 case 15: // netstat
863 case 17: // qotd
864 case 19: // chargen
865 case 20: // ftp data
866 case 21: // ftp access
867 case 22: // ssh
868 case 23: // telnet
869 case 25: // smtp
870 case 37: // time
871 case 42: // name
872 case 43: // nicname
873 case 53: // domain
874 case 69: // tftp
875 case 77: // priv-rjs
876 case 79: // finger
877 case 87: // ttylink
878 case 95: // supdup
879 case 101: // hostname
880 case 102: // iso-tsap
881 case 103: // gppitnp
882 case 104: // acr-nema
883 case 109: // pop2
884 case 110: // pop3
885 case 111: // sunrpc
886 case 113: // auth
887 case 115: // sftp
888 case 117: // uucp-path
889 case 119: // nntp
890 case 123: // NTP
891 case 135: // loc-srv /epmap
892 case 137: // netbios
893 case 139: // netbios
894 case 143: // imap2
895 case 161: // snmp
896 case 179: // BGP
897 case 389: // ldap
898 case 427: // SLP (Also used by Apple Filing Protocol)
899 case 465: // smtp+ssl
900 case 512: // print / exec
901 case 513: // login
902 case 514: // shell
903 case 515: // printer
904 case 526: // tempo
905 case 530: // courier
906 case 531: // chat
907 case 532: // netnews
908 case 540: // uucp
909 case 548: // AFP (Apple Filing Protocol)
910 case 554: // rtsp
911 case 556: // remotefs
912 case 563: // nntp+ssl
913 case 587: // smtp (rfc6409)
914 case 601: // syslog-conn (rfc3195)
915 case 636: // ldap+ssl
916 case 989: // ftps-data
917 case 990: // ftps
918 case 993: // ldap+ssl
919 case 995: // pop3+ssl
920 case 1719: // h323gatestat
921 case 1720: // h323hostcall
922 case 1723: // pptp
923 case 2049: // nfs
924 case 3659: // apple-sasl / PasswordServer
925 case 4045: // lockd
926 case 5060: // sip
927 case 5061: // sips
928 case 6000: // X11
929 case 6566: // sane-port
930 case 6665: // Alternate IRC
931 case 6666: // Alternate IRC
932 case 6667: // Standard IRC
933 case 6668: // Alternate IRC
934 case 6669: // Alternate IRC
935 case 6697: // IRC + TLS
936 case 10080: // Amanda
937 return true;
938 }
939 return false;
940}
941
943{
944 CService ret{service};
945 if (ret.IsIPv6() && ret.HasCJDNSPrefix() && g_reachable_nets.Contains(NET_CJDNS)) {
946 ret.m_net = NET_CJDNS;
947 }
948 return ret;
949}
int ret
ArgsManager & args
Definition: bitcoind.cpp:277
Network address.
Definition: netaddress.h:112
bool SetSpecial(const std::string &addr)
Parse a Tor or I2P address and set this object to it.
Definition: netaddress.cpp:211
A combination of a network address (CNetAddr) and a (TCP) port.
Definition: netaddress.h:531
sa_family_t GetSAFamily() const
Get the address family.
Definition: netaddress.cpp:826
bool GetSockAddr(struct sockaddr *paddr, socklen_t *addrlen) const
Obtain the IPv4/6 socket address this represents.
Definition: netaddress.cpp:866
std::string ToStringAddrPort() const
Definition: netaddress.cpp:907
bool IsValid() const
A helper class for interruptible sleeps.
Different type to mark Mutex at global scope.
Definition: sync.h:140
Definition: netbase.h:59
std::unique_ptr< Sock > Connect() const
Definition: netbase.cpp:672
bool IsValid() const
Definition: netbase.h:70
bool m_tor_stream_isolation
Definition: netbase.h:68
bool m_is_unix_socket
Definition: netbase.h:67
CService proxy
Definition: netbase.h:65
std::string m_unix_socket_path
Definition: netbase.h:66
List of reachable networks.
Definition: netbase.h:101
bool Contains(Network net) const EXCLUSIVE_LOCKS_REQUIRED(!m_mutex)
Definition: netbase.h:124
RAII helper class that manages a socket and closes it automatically when it goes out of scope.
Definition: sock.h:27
static constexpr Event SEND
If passed to Wait(), then it will wait for readiness to send to the socket.
Definition: sock.h:148
virtual bool Wait(std::chrono::milliseconds timeout, Event requested, Event *occurred=nullptr) const
Wait for readiness for input (recv) or output (send).
Definition: sock.cpp:139
virtual void SendComplete(std::span< const unsigned char > data, std::chrono::milliseconds timeout, CThreadInterrupt &interrupt) const
Send the given data, retrying on transient errors.
Definition: sock.cpp:245
uint8_t Event
Definition: sock.h:138
static constexpr Event RECV
If passed to Wait(), then it will wait for readiness to read from the socket.
Definition: sock.h:143
virtual int GetSockOpt(int level, int opt_name, void *opt_val, socklen_t *opt_len) const
getsockopt(2) wrapper.
Definition: sock.cpp:96
virtual int Connect(const sockaddr *addr, socklen_t addr_len) const
connect(2) wrapper.
Definition: sock.cpp:55
virtual ssize_t Recv(void *buf, size_t len, int flags) const
recv(2) wrapper.
Definition: sock.cpp:50
Generate unique credentials for Tor stream isolation.
Definition: netbase.cpp:758
std::atomic< uint64_t > m_counter
Definition: netbase.cpp:776
ProxyCredentials Generate()
Return the next unique proxy credentials.
Definition: netbase.cpp:765
static std::string GenerateUniquePrefix()
Generate a random prefix for each of the credentials returned by this generator.
Definition: netbase.cpp:782
static constexpr size_t PREFIX_BYTE_LENGTH
Size of session prefix in bytes.
Definition: netbase.cpp:773
#define INVALID_SOCKET
Definition: compat.h:56
#define WSAEWOULDBLOCK
Definition: compat.h:50
#define WSAEINVAL
Definition: compat.h:49
#define SOCKET_ERROR
Definition: compat.h:57
#define WSAGetLastError()
Definition: compat.h:48
unsigned int SOCKET
Definition: compat.h:46
void * sockopt_arg_type
Definition: compat.h:82
#define WSAEINPROGRESS
Definition: compat.h:54
std::string HexStr(const std::span< const uint8_t > s)
Convert a span of bytes to a lower-case hexadecimal string.
Definition: hex_base.cpp:29
#define LogPrintLevel(category, level,...)
Definition: logging.h:272
#define LogError(...)
Definition: logging.h:263
#define LogDebug(category,...)
Definition: logging.h:280
#define LogPrintf(...)
Definition: logging.h:266
@ PROXY
Definition: logging.h:58
@ NET
Definition: logging.h:43
void format(std::ostream &out, FormatStringCheck< sizeof...(Args)> fmt, const Args &... args)
Format list of arguments to the stream according to given format string.
Definition: tinyformat.h:1079
bool ContainsNoNUL(std::string_view str) noexcept
Check if a string does not contain any embedded NUL (\0) characters.
Definition: string.h:221
Network
A network type.
Definition: netaddress.h:32
@ NET_I2P
I2P.
Definition: netaddress.h:46
@ NET_CJDNS
CJDNS.
Definition: netaddress.h:49
@ NET_MAX
Dummy value to indicate the number of NET_* constants.
Definition: netaddress.h:56
@ NET_ONION
TOR (v2 or v3)
Definition: netaddress.h:43
@ NET_IPV6
IPv6.
Definition: netaddress.h:40
@ NET_IPV4
IPv4.
Definition: netaddress.h:37
@ NET_UNROUTABLE
Addresses from these networks are not publicly routable on the global Internet.
Definition: netaddress.h:34
@ NET_INTERNAL
A set of addresses that represent the hash of a string or FQDN.
Definition: netaddress.h:53
IntrRecvError
Status codes that can be returned by InterruptibleRecv.
Definition: netbase.cpp:298
SOCKS5Atyp
Values defined for ATYPE in RFC1928.
Definition: netbase.cpp:291
@ DOMAINNAME
Definition: netbase.cpp:293
@ IPV4
Definition: netbase.cpp:292
@ IPV6
Definition: netbase.cpp:294
CSubNet LookupSubNet(const std::string &subnet_str)
Parse and resolve a specified subnet string into the appropriate internal representation.
Definition: netbase.cpp:816
SOCKS5Command
Values defined for CMD in RFC1928.
Definition: netbase.cpp:263
@ UDP_ASSOCIATE
Definition: netbase.cpp:266
@ CONNECT
Definition: netbase.cpp:264
@ BIND
Definition: netbase.cpp:265
static void LogConnectFailure(bool manual_connection, util::ConstevalFormatString< sizeof...(Args)> fmt, const Args &... args)
Definition: netbase.cpp:584
std::unique_ptr< Sock > ConnectDirectly(const CService &dest, bool manual_connection)
Create a socket and try to connect to the specified service.
Definition: netbase.cpp:649
std::vector< CNetAddr > LookupHost(const std::string &name, unsigned int nMaxSolutions, bool fAllowLookup, DNSLookupFn dns_lookup_function)
Resolve a host string to its corresponding network addresses.
Definition: netbase.cpp:177
static Proxy proxyInfo[NET_MAX] GUARDED_BY(g_proxyinfo_mutex)
std::chrono::milliseconds g_socks5_recv_timeout
Definition: netbase.cpp:40
std::string GetNetworkName(enum Network net)
Definition: netbase.cpp:118
static IntrRecvError InterruptibleRecv(uint8_t *data, size_t len, std::chrono::milliseconds timeout, const Sock &sock)
Try to read a specified number of bytes from a socket.
Definition: netbase.cpp:322
CThreadInterrupt g_socks5_interrupt
Interrupt SOCKS5 reads or writes.
Definition: netbase.cpp:41
SOCKSVersion
SOCKS version.
Definition: netbase.cpp:249
@ SOCKS4
Definition: netbase.cpp:250
@ SOCKS5
Definition: netbase.cpp:251
bool HaveNameProxy()
Definition: netbase.cpp:738
bool SetNameProxy(const Proxy &addrProxy)
Set the name proxy to use for all connections to nodes specified by a hostname.
Definition: netbase.cpp:722
enum Network ParseNetwork(const std::string &net_in)
Definition: netbase.cpp:100
SOCKS5Method
Values defined for METHOD in RFC1928.
Definition: netbase.cpp:255
@ GSSAPI
GSSAPI.
Definition: netbase.cpp:257
@ NOAUTH
No authentication required.
Definition: netbase.cpp:256
@ USER_PASS
Username/password.
Definition: netbase.cpp:258
@ NO_ACCEPTABLE
No acceptable methods.
Definition: netbase.cpp:259
bool Socks5(const std::string &strDest, uint16_t port, const ProxyCredentials *auth, const Sock &sock)
Connect to a specified destination service through an already connected SOCKS5 proxy.
Definition: netbase.cpp:396
static std::string Socks5ErrorString(uint8_t err)
Convert SOCKS5 reply to an error message.
Definition: netbase.cpp:356
bool SetProxy(enum Network net, const Proxy &addrProxy)
Definition: netbase.cpp:704
std::vector< CService > Lookup(const std::string &name, uint16_t portDefault, bool fAllowLookup, unsigned int nMaxSolutions, DNSLookupFn dns_lookup_function)
Resolve a service string to its corresponding service.
Definition: netbase.cpp:195
static std::vector< CNetAddr > LookupIntern(const std::string &name, unsigned int nMaxSolutions, bool fAllowLookup, DNSLookupFn dns_lookup_function)
Definition: netbase.cpp:148
SOCKS5Reply
Values defined for REP in RFC1928 and https://spec.torproject.org/socks-extensions....
Definition: netbase.cpp:270
@ TTLEXPIRED
RFC1928: TTL expired.
Definition: netbase.cpp:277
@ CMDUNSUPPORTED
RFC1928: Command not supported.
Definition: netbase.cpp:278
@ TOR_HS_WRONG_CLIENT_AUTH
Tor: Onion service wrong client authorization.
Definition: netbase.cpp:285
@ TOR_HS_DESC_INVALID
Tor: Onion service descriptor is invalid.
Definition: netbase.cpp:281
@ NETUNREACHABLE
RFC1928: Network unreachable.
Definition: netbase.cpp:274
@ GENFAILURE
RFC1928: General failure.
Definition: netbase.cpp:272
@ TOR_HS_MISSING_CLIENT_AUTH
Tor: Onion service missing client authorization.
Definition: netbase.cpp:284
@ CONNREFUSED
RFC1928: Connection refused.
Definition: netbase.cpp:276
@ TOR_HS_BAD_ADDRESS
Tor: Onion service invalid address.
Definition: netbase.cpp:286
@ SUCCEEDED
RFC1928: Succeeded.
Definition: netbase.cpp:271
@ ATYPEUNSUPPORTED
RFC1928: Address type not supported.
Definition: netbase.cpp:279
@ NOTALLOWED
RFC1928: Connection not allowed by ruleset.
Definition: netbase.cpp:273
@ TOR_HS_INTRO_FAILED
Tor: Onion service introduction failed.
Definition: netbase.cpp:282
@ TOR_HS_DESC_NOT_FOUND
Tor: Onion service descriptor can not be found.
Definition: netbase.cpp:280
@ HOSTUNREACHABLE
RFC1928: Network unreachable.
Definition: netbase.cpp:275
@ TOR_HS_INTRO_TIMEOUT
Tor: Onion service introduction timed out.
Definition: netbase.cpp:287
@ TOR_HS_REND_FAILED
Tor: Onion service rendezvous failed.
Definition: netbase.cpp:283
CService MaybeFlipIPv6toCJDNS(const CService &service)
If an IPv6 address belongs to the address range used by the CJDNS network and the CJDNS network is re...
Definition: netbase.cpp:942
static GlobalMutex g_proxyinfo_mutex
Definition: netbase.cpp:33
ReachableNets g_reachable_nets
Definition: netbase.cpp:43
std::unique_ptr< Sock > CreateSockOS(int domain, int type, int protocol)
Create a real socket from the operating system.
Definition: netbase.cpp:526
bool fNameLookup
Definition: netbase.cpp:37
bool GetProxy(enum Network net, Proxy &proxyInfoOut)
Definition: netbase.cpp:713
int nConnectTimeout
Definition: netbase.cpp:36
static bool ConnectToSocket(const Sock &sock, struct sockaddr *sockaddr, socklen_t len, const std::string &dest_str, bool manual_connection)
Definition: netbase.cpp:594
std::unique_ptr< Sock > ConnectThroughProxy(const Proxy &proxy, const std::string &dest, uint16_t port, bool &proxy_connection_failed)
Connect to a specified destination service through a SOCKS5 proxy by first connecting to the SOCKS5 p...
Definition: netbase.cpp:789
std::function< std::unique_ptr< Sock >(int, int, int)> CreateSock
Socket factory.
Definition: netbase.cpp:581
bool IsUnixSocketPath(const std::string &name)
Check if a string is a valid UNIX domain socket path.
Definition: netbase.cpp:230
bool GetNameProxy(Proxy &nameProxyOut)
Definition: netbase.cpp:730
CService LookupNumeric(const std::string &name, uint16_t portDefault, DNSLookupFn dns_lookup_function)
Resolve a service string with a numeric IP to its first corresponding service.
Definition: netbase.cpp:220
bool IsProxy(const CNetAddr &addr)
Definition: netbase.cpp:743
bool IsBadPort(uint16_t port)
Determine if a port is "bad" from the perspective of attempting to connect to a node on that port.
Definition: netbase.cpp:852
std::vector< CNetAddr > WrappedGetAddrInfo(const std::string &name, bool allow_lookup)
Wrapper for getaddrinfo(3).
Definition: netbase.cpp:45
DNSLookupFn g_dns_lookup
Definition: netbase.cpp:98
std::vector< std::string > GetNetworkNames(bool append_unroutable)
Return a vector of publicly routable Network names; optionally append NET_UNROUTABLE.
Definition: netbase.cpp:134
static const int DEFAULT_NAME_LOOKUP
-dns default
Definition: netbase.h:28
const std::string ADDR_PREFIX_UNIX
Prefix for unix domain socket addresses (which are local filesystem paths)
Definition: netbase.h:31
std::function< std::vector< CNetAddr >(const std::string &, bool)> DNSLookupFn
Definition: netbase.h:192
static const int DEFAULT_CONNECT_TIMEOUT
-timeout default
Definition: netbase.h:26
void GetRandBytes(std::span< unsigned char > bytes) noexcept
Generate random data via the internal PRNG.
Definition: random.cpp:676
const char * name
Definition: rest.cpp:49
@ OK
The message verification was successful.
std::string NetworkErrorString(int err)
Return readable error string for a network error code.
Definition: sock.cpp:422
static constexpr auto MAX_WAIT_FOR_IO
Maximum time to wait for I/O readiness.
Definition: sock.h:21
Credentials for proxy authentication.
Definition: netbase.h:93
std::string username
Definition: netbase.h:94
std::string password
Definition: netbase.h:95
A wrapper for a compile-time partially validated format string.
Definition: string.h:92
#define LOCK(cs)
Definition: sync.h:257
#define strprintf
Format arguments and return the string or write to given std::ostream (see tinyformat::format doc for...
Definition: tinyformat.h:1172
bool ParseUInt8(std::string_view str, uint8_t *out)
Convert decimal string to unsigned 8-bit integer with strict parse error feedback.
bool SplitHostPort(std::string_view in, uint16_t &portOut, std::string &hostOut)
Splits socket address string into host string and port value.
std::string ToLower(std::string_view str)
Returns the lowercase equivalent of the given string.
assert(!tx.IsCoinBase())