2
0
mirror of https://gitlab.isc.org/isc-projects/bind9 synced 2025-08-22 18:19:42 +00:00
bind/lib/isc/uv.c

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

161 lines
3.8 KiB
C
Raw Normal View History

/*
* Copyright (C) Internet Systems Consortium, Inc. ("ISC")
*
* SPDX-License-Identifier: MPL-2.0
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, you can obtain one at https://mozilla.org/MPL/2.0/.
*
* See the COPYRIGHT file distributed with this work for additional
* information regarding copyright ownership.
*/
#include <unistd.h>
#include <isc/mem.h>
#include <isc/util.h>
#include <isc/uv.h>
/*%
* Convert a libuv error value into an isc_result_t. The
* list of supported error values is not complete; new users
* of this function should add any expected errors that are
* not already there.
*/
isc_result_t
isc__uverr2result(int uverr, bool dolog, const char *file, unsigned int line,
const char *func) {
switch (uverr) {
case 0:
return ISC_R_SUCCESS;
case UV_ENOTDIR:
case UV_ELOOP:
case UV_EINVAL: /* XXX sometimes this is not for files */
case UV_ENAMETOOLONG:
case UV_EBADF:
return ISC_R_INVALIDFILE;
case UV_ENOENT:
return ISC_R_FILENOTFOUND;
case UV_EAGAIN:
return ISC_R_NOCONN;
case UV_EACCES:
case UV_EPERM:
return ISC_R_NOPERM;
case UV_EEXIST:
return ISC_R_FILEEXISTS;
case UV_EIO:
return ISC_R_IOERROR;
case UV_ENOMEM:
return ISC_R_NOMEMORY;
case UV_ENFILE:
case UV_EMFILE:
return ISC_R_TOOMANYOPENFILES;
case UV_ENOSPC:
return ISC_R_DISCFULL;
case UV_EPIPE:
case UV_ECONNRESET:
case UV_ECONNABORTED:
return ISC_R_CONNECTIONRESET;
case UV_ENOTCONN:
return ISC_R_NOTCONNECTED;
case UV_ETIMEDOUT:
return ISC_R_TIMEDOUT;
case UV_ENOBUFS:
return ISC_R_NORESOURCES;
case UV_EAFNOSUPPORT:
return ISC_R_FAMILYNOSUPPORT;
case UV_ENETDOWN:
return ISC_R_NETDOWN;
case UV_EHOSTDOWN:
return ISC_R_HOSTDOWN;
case UV_ENETUNREACH:
return ISC_R_NETUNREACH;
case UV_EHOSTUNREACH:
return ISC_R_HOSTUNREACH;
case UV_EADDRINUSE:
return ISC_R_ADDRINUSE;
case UV_EADDRNOTAVAIL:
return ISC_R_ADDRNOTAVAIL;
case UV_ECONNREFUSED:
return ISC_R_CONNREFUSED;
case UV_ECANCELED:
return ISC_R_CANCELED;
Refactor netmgr and add more unit tests This is a part of the works that intends to make the netmgr stable, testable, maintainable and tested. It contains a numerous changes to the netmgr code and unfortunately, it was not possible to split this into smaller chunks as the work here needs to be committed as a complete works. NOTE: There's a quite a lot of duplicated code between udp.c, tcp.c and tcpdns.c and it should be a subject to refactoring in the future. The changes that are included in this commit are listed here (extensively, but not exclusively): * The netmgr_test unit test was split into individual tests (udp_test, tcp_test, tcpdns_test and newly added tcp_quota_test) * The udp_test and tcp_test has been extended to allow programatic failures from the libuv API. Unfortunately, we can't use cmocka mock() and will_return(), so we emulate the behaviour with #define and including the netmgr/{udp,tcp}.c source file directly. * The netievents that we put on the nm queue have variable number of members, out of these the isc_nmsocket_t and isc_nmhandle_t always needs to be attached before enqueueing the netievent_<foo> and detached after we have called the isc_nm_async_<foo> to ensure that the socket (handle) doesn't disappear between scheduling the event and actually executing the event. * Cancelling the in-flight TCP connection using libuv requires to call uv_close() on the original uv_tcp_t handle which just breaks too many assumptions we have in the netmgr code. Instead of using uv_timer for TCP connection timeouts, we use platform specific socket option. * Fix the synchronization between {nm,async}_{listentcp,tcpconnect} When isc_nm_listentcp() or isc_nm_tcpconnect() is called it was waiting for socket to either end up with error (that path was fine) or to be listening or connected using condition variable and mutex. Several things could happen: 0. everything is ok 1. the waiting thread would miss the SIGNAL() - because the enqueued event would be processed faster than we could start WAIT()ing. In case the operation would end up with error, it would be ok, as the error variable would be unchanged. 2. the waiting thread miss the sock->{connected,listening} = `true` would be set to `false` in the tcp_{listen,connect}close_cb() as the connection would be so short lived that the socket would be closed before we could even start WAIT()ing * The tcpdns has been converted to using libuv directly. Previously, the tcpdns protocol used tcp protocol from netmgr, this proved to be very complicated to understand, fix and make changes to. The new tcpdns protocol is modeled in a similar way how tcp netmgr protocol. Closes: #2194, #2283, #2318, #2266, #2034, #1920 * The tcp and tcpdns is now not using isc_uv_import/isc_uv_export to pass accepted TCP sockets between netthreads, but instead (similar to UDP) uses per netthread uv_loop listener. This greatly reduces the complexity as the socket is always run in the associated nm and uv loops, and we are also not touching the libuv internals. There's an unfortunate side effect though, the new code requires support for load-balanced sockets from the operating system for both UDP and TCP (see #2137). If the operating system doesn't support the load balanced sockets (either SO_REUSEPORT on Linux or SO_REUSEPORT_LB on FreeBSD 12+), the number of netthreads is limited to 1. * The netmgr has now two debugging #ifdefs: 1. Already existing NETMGR_TRACE prints any dangling nmsockets and nmhandles before triggering assertion failure. This options would reduce performance when enabled, but in theory, it could be enabled on low-performance systems. 2. New NETMGR_TRACE_VERBOSE option has been added that enables extensive netmgr logging that allows the software engineer to precisely track any attach/detach operations on the nmsockets and nmhandles. This is not suitable for any kind of production machine, only for debugging. * The tlsdns netmgr protocol has been split from the tcpdns and it still uses the old method of stacking the netmgr boxes on top of each other. We will have to refactor the tlsdns netmgr protocol to use the same approach - build the stack using only libuv and openssl. * Limit but not assert the tcp buffer size in tcp_alloc_cb Closes: #2061
2020-11-12 10:32:18 +01:00
case UV_EOF:
return ISC_R_EOF;
case UV_EMSGSIZE:
return ISC_R_MAXSIZE;
case UV_ENOTSUP:
return ISC_R_FAMILYNOSUPPORT;
case UV_ENOPROTOOPT:
case UV_EPROTONOSUPPORT:
return ISC_R_INVALIDPROTO;
default:
if (dolog) {
UNEXPECTED_ERROR("unable to convert libuv error code "
"in %s (%s:%d) to isc_result: %d: %s",
func, file, line, uverr,
uv_strerror(uverr));
}
return ISC_R_UNEXPECTED;
}
}
#if UV_VERSION_HEX >= UV_VERSION(1, 38, 0)
static isc_mem_t *isc__uv_mctx = NULL;
static void *
isc__uv_malloc(size_t size) {
return isc_mem_allocate(isc__uv_mctx, size);
}
static void *
isc__uv_realloc(void *ptr, size_t size) {
return isc_mem_reallocate(isc__uv_mctx, ptr, size);
}
static void *
isc__uv_calloc(size_t count, size_t size) {
return isc_mem_callocate(isc__uv_mctx, count, size);
}
static void
isc__uv_free(void *ptr) {
if (ptr == NULL) {
return;
}
isc_mem_free(isc__uv_mctx, ptr);
}
#endif /* UV_VERSION_HEX >= UV_VERSION(1, 38, 0) */
void
isc__uv_initialize(void) {
#if UV_VERSION_HEX >= UV_VERSION(1, 38, 0)
int r;
isc_mem_create(&isc__uv_mctx);
isc_mem_setname(isc__uv_mctx, "uv");
isc_mem_setdestroycheck(isc__uv_mctx, false);
r = uv_replace_allocator(isc__uv_malloc, isc__uv_realloc,
isc__uv_calloc, isc__uv_free);
UV_RUNTIME_CHECK(uv_replace_allocator, r);
#endif /* UV_VERSION_HEX >= UV_VERSION(1, 38, 0) */
}
void
isc__uv_shutdown(void) {
#if UV_VERSION_HEX >= UV_VERSION(1, 38, 0)
uv_library_shutdown();
isc_mem_detach(&isc__uv_mctx);
#endif /* UV_VERSION_HEX < UV_VERSION(1, 38, 0) */
}
void
isc__uv_setdestroycheck(bool check) {
#if UV_VERSION_HEX >= UV_VERSION(1, 38, 0)
isc_mem_setdestroycheck(isc__uv_mctx, check);
#else
UNUSED(check);
#endif /* UV_VERSION_HEX >= UV_VERSION(1, 6, 0) */
}